# MMW工作台插件助手

这是当前可安装插件的源码根目录。插件保留网页资源识别与下载、罗盘跳转、抖音页面增强，以及按需打开的完整电商业务。

插件顶部快捷导航保留“用户后台”“下载页”和“使用教程”。“使用教程”读取服务端教程导航配置，并与用户后台顶部入口共用同一链接；后台未配置时入口显示为禁用状态。

## 电商工具

插件加载网页时不会自动展开电商工具栏。用户在悬浮面板点击“电商工具”后，才打开蓝白毛玻璃工具栏。

电商工具使用服务端账号权限控制：本功能上线前已有账号自动保留入口；后续新注册账号默认不显示，只能由管理员为账号开启或关闭，不设置充值、积分或会员自动解锁条件。权限关闭时，悬浮窗不显示入口，原版运行时、后台消息及电商/搬家接口同时拒绝调用；权限开放后仍继续执行原有会员与搬家计费校验。

电商工具恢复 4.15.1 已验证业务运行时，保留原操作窗口、原交互顺序及完整业务代码。当前工具栏仅展示批量搬家、采集工具和爆款裂变；诊断工具、下载工具、单品搬家、本地上货、运营工具仅移除可见入口，对应业务模块仍保留。批量搬家当前只开放淘宝、抖店、微信小店、快手四个目标平台，其他目标入口不显示，运行时也会拒绝执行。搬家窗口包含“采集宝贝、上传配置、搬家进度”三步面板，商品解析、店铺识别、类目/属性配置、运费模板和发布流程继续使用原业务实现；会员鉴权与搬家计费仍接入当前 MMW 协议。搬家按实际链接条数结算：每项搬家功能每日首条链接免费，后续每条按后台单条价格计费；批量搬家必须提交完整链接清单，由服务器核对条数后结算。

### 搬家流程监听（独立测试）

打开电商工具栏后，旁边会出现“搬家流程监听”。点击“开始监听”，再完整运行一次真实搬家流程；可在关键步骤点击“记录节点”，最后点击“结束并导出”保存 JSON 记录。监听器只做旁路记录，不触发搬家、不修改原业务结果。记录包含登录状态、会员/权限、用户与店铺业务字段、商品/类目/模板数据、页面交互、标签页跳转、插件服务调用及相关网络请求；密码、Cookie 值、Token、Authorization 和签名密钥不会写入记录。

## 安装测试

1. 打开 Chrome 或 Edge 扩展管理页。
2. 打开“开发者模式”。
3. 点击“加载已解压的扩展程序”。
4. 选择 `E:\mmw工作台\chajian\media-resource-picker`。
5. 刷新已打开的商家页面，在悬浮面板点击“电商工具”验证工具栏和业务窗口。

千川创建计划若提示网络确认或服务端结果校验失败，本批会在提交到千川前停止并保留页面设置。请先升级并重新加载最新版插件，再确认 MMW 服务可用后重试；不要连续重复提交。

千川全域窗口不会因点击窗口外部而关闭；需要退出时请使用窗口右上角的关闭按钮，避免误触中断当前配置与操作状态。

千川全域当前直接进入创建计划面板，不再显示无实际内容的“创建计划 / 计划记录 / 数据看板”顶部切换栏。

千川批量计划会动态识别当前官方素材归属组件；官方前端更新模块编号时，不再因旧模块误识别而让整批视频停在“素材归属绑定”。

千川标题支持拖入或选择多个 TXT 文本；每个文件可按行填写多条标题。每个商品最多使用 30 条标题，每条需符合千川 5–55 字要求；导入时会分别提示无效、重复和超过上限的标题数量。

千川图片素材只有完成上传并绑定进入当前广告主图片素材库后才会显示成功；入库失败会在对应商品素材中明确标红，不会继续作为可创建计划的成功素材。

## 打包

在 `E:\mmw工作台\chajian` 运行：

```powershell
.\build-extension-zip.ps1
```

发布包使用 `mmw-plugin-assistant_<版本号>.zip`，ZIP 根目录直接包含 `manifest.json`。测试、视觉审查、临时浏览器目录、备份和已归档旧业务不得进入安装包。

## 当前主要运行链路

- `manifest.json`
- `background.js`
- `floating-desktop.js`
- `content-script.js`
- `dist/update/js/index_start.js`
- `dist/update/js/index.js`
- `dist/contentScripts/*`
- `dist/background/original-commerce-runtime.js`
- `features/ecommerce-original/*`
- `features/ecommerce-flow-recorder/*`
- `assets/original-runtime-data/*`
