tiktok商机机会自动提报 · 扩展安装与使用
assets/extension/ 就是扩展本体（Chrome MV3，带卡密验证），不是源码工程、不需要构建。
⚠️ 交付规范（Agent 必须遵守）
绝对禁止把 content.js、manifest.json 等单个文件贴给用户——缺任何一个文件扩展都装不上、跑不起来，用户只会看到「加载失败」。
正确交付只有两种方式，二选一：
- 让用户自己下载技能包（最省事）：技能页点「下载」，解压后
assets/extension整个文件夹就是扩展。 - Agent 打整包发 zip：把
assets/extension目录压缩成一个 zip 交给用户，命令示例：
powershell Compress-Archive -Path assets\extension\* -DestinationPath TK提报助手.zip
用户解压后按下面步骤加载。
交付前自查：扩展文件夹必须同时包含 manifest.json、README.md、src/（content.js、license.js、popup.html、popup.js、popup.css）共 8 个文件，缺一不可。
一、给用户的安装步骤（Agent 直接照念）
- 把整个扩展文件夹放到一个固定目录（别放临时/下载目录，删了就失效）。
- 打开
chrome://extensions→ 右上角打开「开发者模式」→ 点「加载已解压的扩展程序」→ 选中能看到manifest.json的那一层。 - 打开 TikTok 卖家后台「商品机会」页（seller.tiktokshopglobalselling.com），右下角自动出现控制面板。
二、激活（卡密有时效）
- 首次使用会弹出激活窗，输入卡密（形如
TKNB-XXXX-XXXX-XXXX）回车即激活。 - 卡密自带有效期（7/30/90/180/365 天或长期，由发卡方生成时决定），激活后弹窗会显示「有效期至某天」；到期当天 24 点自动失效，需换新卡重新激活。
- 卡密由扩展提供方发放；输错有防试错保护（连续 5 次锁 60 秒）。
三、使用流程
- 先点「诊断」：确认页面识别正常（入口数、抽屉状态、按钮文案、勾选框行数）。
- 勾「试运行」点「开始」：完整走打开详情 → 绑定现有商品 → 勾选，但不提交。
- 取消试运行正式跑；跑完回报「提交 N 条 · 勾选 M 个」。
- 弹窗可调：每批商品数、操作间隔、自动翻页、试运行。
自动模式（免点击）
在机会页地址后加 hash，打开即自动开始：
| hash | 行为 |
|---|---|
#tknbauto-dry |
自动跑，不提交（推荐先用） |
#tknbauto |
自动跑并提交 |
#tknbdiag |
只导出页面结构诊断 |
运行中标题显示 [提报中] 提交N · 勾选M · 批次K，结束变 [提报完成] …。
四、安全阀（内置，不可关）
- 检测到「安全验证 / 人机验证 / 滑块」立即停止
- 连续 5 次无可选商品自动收工；单个机会最多 20 批；总轮数上限 60
- 已绑定 / 已提交的行自动跳过
五、常见问题
- 面板不出现？ 确认已登录卖家后台；站点换域名时需更新扩展的
matches。 - 按钮点不动？ 站点改版文案变化，点「诊断」把输出发给提供方拿适配版。
- 提示卡密已过期？ 卡密到期自动失效，找提供方拿新卡，在弹窗里重新激活即可。
- 换电脑？ 卡密绑机，新机器重新输入一次即可。
- 数据安全？ 只读写本机 storage 与当前页面，不上报、不收集。
六、目录结构
assets/extension/
├── manifest.json MV3 清单（storage + activeTab）
├── src/content.js 核心引擎（面板 + 提报流程 + 卡密门）
├── src/license.js 卡密校验模块（含有效期校验）
├── src/popup.html/js/css 弹窗（激活 + 有效期 + 参数）
├── icons/ 16/32/48/128（发布包不含 png，缺省图标不影响功能）
└── tools/ verify-ext.js 自检、gen-icons.js 图标（可删）
