# Edge 加载项商店 · 上架材料包 > 结论:**国内只走 Edge 加载项商店**。Chrome 应用商店在这条网络里连不上 > (实测 `chromewebstore.google.com` 与 `clients2.google.com` 均超时),上架也装不了; > 而 `microsoftedge.microsoft.com/addons` 实测 200 / 0.43s,Edge 又是 Win10/11 自带。 > > 本文所有文案可直接复制到 Microsoft Partner Center。 ## 0. 为什么是 Edge(三条分发路线对比) | 路线 | 覆盖谁 | 国内可用 | 现状 | |---|---|---|---| | **Edge 加载项商店** | 所有 Edge 用户,**非受管/非开发者模式也能一键装** | ✅ | 待上架(免费) | | 企业策略 + 自建 CRX | 仅**受管设备**(加域 / Intune / 组策略) | ✅ | 已实现:菜单「安装谷歌插件」 | | 开发者模式手动加载 | 任何 Chromium 内核浏览器 | ✅ | 已实现:菜单「复制插件路径(开发者模式)」 | 非受管电脑上 `ExtensionInstallForcelist` 会被 Chrome/Edge 拒绝(`[BLOCKED]`,提示"此设备并非由你的组织管理"), 所以**普通员工电脑只有商店这条路**。 ## 1. 上架前检查清单 - [x] `manifest.json` 里**没有** `update_url`、**没有** `key`(商店会拒) - [x] `name` 13 字符、`description` 69 字符(限制:name ≤ 45 / description ≤ 132) - [x] `minimum_chrome_version: 96`(Edge 同内核,兼容) - [x] 权限最小化:`storage` + `alarms`,host 只有本机服务与本项目后端 - [x] 隐私政策页面已上线: (源码 `frontend/public/extension-privacy.html`,随前端一起发布) - [x] 商店上传包:`extension/out/YuncangTraceExtension-.zip` (`cd backend && npm run extension:zip`,条目名是标准 `/`,`manifest.json` 在根目录) - [ ] Microsoft Partner Center 账号(免费): - [ ] 截图 3~5 张(见第 4 节) - [x] 隐私政策里的联系邮箱已确认:`821298006@qq.com` ## 2. 商店字段(直接复制) **扩展名称(Name)** ``` 云仓视频溯源 · 单号注入 ``` **简短描述(Short description,≤132 字符)** ``` 在自家 WMS/后台页面识别运单号,一键打开打包视频溯源;识别规则与生效站点由管理员集中维护。 ``` **详细描述(Detailed description,Edge 限 1000 字符;下面 768 字符)** ``` 【它做什么】 在贵司自己的仓储管理系统(WMS)、打单后台等网页上,自动识别运单号(例如 YT1234567890123),在单号旁加上可点击的入口:点一下就打开这段录像的打包视频溯源页面;如果这台电脑装了「云仓视频溯源」桌面客户端,会直接唤起客户端播放,省去复制单号再查询的步骤。 【为什么需要"访问所有网站"】 不同客户使用的 WMS 来自不同供应商,域名和内网 IP 各不相同,无法在安装时预先枚举。扩展只把脚本加载到页面,实际匹配仅在管理员配置过的站点白名单内进行;其它站点上脚本立即退出,不读取、不修改页面内容。 【安全与隐私】 · 页面文本只在你的浏览器本地匹配,不上传页面内容、截图或浏览记录; · 识别到的运单号只交给同一台电脑上安装的桌面客户端(localhost),不经过互联网; · 只从服务器拉取只读配置(生效站点、单号前缀、跳转模板),不下发任何代码; · 不收集账号密码,不投放广告,不向第三方出售数据。 完整说明:https://pack.wms.gztbyc.com/extension-privacy.html 【怎么用】 1) 管理员在后台「插件配置」维护单号前缀与生效站点; 2) 员工在 WMS 页面正常操作,运单号会自动带上入口; 3) 点击运单号即可查看打包视频,配置每 5 分钟自动同步,改完无需重新安装。 【说明】 · 没装桌面客户端也能用:会按管理员配置的模板在浏览器里打开溯源页面; · 插件本身不含账号、密码或密钥,识别规则由管理员在后台统一维护; · 适用岗位:仓储打包台、发货复核、售后查件等需要"按运单号回看打包录像"的场景; · 支持与隐私问题请联系:821298006@qq.com 版本 1.1.2:识别前缀与生效站点改为服务端集中维护,登录后无需再手工配置。 ``` **English(可选,建议一起填)** ``` Name: Yuncang Trace · Tracking No. Link Short: Detect tracking numbers on your own WMS pages and open the packaging-video trace page in one click. Detail: This extension detects tracking numbers (e.g. YT1234567890123) on your company's WMS / shipping admin pages and turns them into clickable links that open the corresponding packaging-video trace, or launch the desktop client installed on the same PC. Why "read and change all your data on all websites": every customer uses a different WMS vendor with different domains or intranet IPs, so they cannot be pre-listed at install time. The content script only runs its matching logic when the current site is on an allow-list maintained by the administrator; on every other site it exits immediately and neither reads nor modifies the page. Privacy: page text is matched locally and never uploaded; a detected tracking number is handed to the desktop client on the same computer (localhost) only; the extension downloads read-only configuration (no remote code); no accounts, no ads, no data sold to third parties. Policy: https://pack.wms.gztbyc.com/extension-privacy.html ``` **其它字段** | 字段 | 填什么 | |---|---| | 类别(Category) | Productivity(效率) | | 语言 | 中文(简体)+ English | | 隐私政策 URL | `https://pack.wms.gztbyc.com/extension-privacy.html` | | 支持/主页 URL | `https://pack.wms.gztbyc.com/` | | 联系邮箱 | `821298006@qq.com` | | 定价 | 免费 | ## 3. 权限用途说明(审核问到时逐条贴) | 权限 | 给审核的说明(中) | Justification (EN) | |---|---|---| | `storage` | 在本机保存管理员下发的配置与同步状态,不上传。 | Stores the administrator-provided configuration and last-sync state locally. | | `alarms` | 每 5 分钟拉取一次配置,保证管理员改完尽快生效。 | Periodic (5 min) refresh of the read-only configuration. | | `content_scripts` 全站(`http://*/*`, `https://*/*`) | 客户的 WMS 域名/内网地址无法预知,需在页面上识别运单号;实际只在白名单站点工作,其它站点立即退出且不读取 DOM。 | Customers' WMS hosts cannot be enumerated in advance. Matching only runs on an allow-listed site; otherwise the script exits without reading the DOM. | | `host_permissions: https://pack.wms.gztbyc.com/*` | 只用于拉取只读配置与最新客户端版本信息。 | Fetches read-only configuration and the latest client version info. | | `host_permissions: http://localhost:17300/*`、`http://127.0.0.1:17300/*` | 与本机安装的桌面客户端通信(判断是否安装、传递运单号)。 | Talks to the desktop client installed on the same machine (availability probe and tracking-number hand-off). | **数据使用声明(Data usage 表单)**:全部选「不收集」—— 只做本地匹配;不收集浏览历史、页面内容、个人身份信息、位置、财务信息; 不用于广告或画像;不出售给第三方。 (如果表单强制要求勾选"处理网站内容",就选「仅在本地处理,不上传」。) ## 4. 需要的截图(1280×800 或 640×400,PNG/JPG) 1. **注入效果**:`extension/test/wms-mock.html` 里单号带下划线/按钮的样子(最能说明用途); 2. **点击后的溯源页面**:桌面客户端或网页端播放界面; 3. **扩展选项页**:同步状态(版本号、生效站点、前缀)——说明配置集中管理; 4. 可选:桌面端「工具」菜单(安装/卸载/复制路径)。 > 截图里**不要出现**真实客户名、真实运单号、真实手机号;用测试数据。 ## 5. 审核常见退回原因与应对 | 退回理由 | 应对 | |---|---| | "访问所有网站"权限过宽 | 贴第 3 节的说明 + 第 2 节的"为什么需要全站"段落;强调**运行时白名单**约束 | | 描述太笼统,看不出单一用途 | 用第 2 节的详细描述(单一用途:在 WMS 页面识别单号并跳转溯源) | | 缺少隐私政策 | 已经有:`https://pack.wms.gztbyc.com/extension-privacy.html`(上架前确认能打开) | | 疑似远程代码 | 说明只下发**配置数据**(JSON),用 `new RegExp(字符串)` 编译,无 eval / 无远程 JS | | 功能需要登录才可用 | 审核说明里写:功能依赖客户自有 WMS 与管理员配置;附带 `test/wms-mock.html` 的演示说明与截图 | ## 6. 上架之后要注意 1. **扩展 ID 会变**:商店用微软的密钥签名,ID 不再是 `lkeibbccgdddjamahnkibopcpidhgggk`(那是 `extension/keys/key.pem` 算出来的自建 ID)。 - 商店版:用户在 Edge 加载项页面点「获取」即可,**不需要**写策略; - 自建 CRX(受管设备):继续用现有 ID 与 `updates.xml`,两条线互不影响。 2. **升级流程**:改代码 → 改 `manifest.json` 的 `version` → `cd backend && npm run extension:zip` → 在 Partner Center 上传新 zip → 审核通过后用户自动升级(Edge 端的自建 CRX 仍走 `npm run extension:publish`)。 3. 商店版和自建 CRX 版**不能同时装**在同一浏览器(同一扩展名会冲突)——现场二选一。 ## 7. 现场操作对照 | 场景 | 操作 | |---|---| | 员工电脑(非受管)、用 Edge | 打开加载项商店页面 → 「获取」 | | 员工电脑(加域 / 受管) | 桌面端「工具 → 安装谷歌插件」(写 HKLM 策略 + 自建 CRX) | | 临时/无管理员权限 | 桌面端「工具 → 复制插件路径(开发者模式)」→ `edge://extensions` 加载已解压 | | 国产 Chromium 浏览器(360/QQ/搜狗) | 多数支持"加载已解压的扩展程序",用同一条路径 | ## 8. 提交时逐字段对照表(Package 上传之后) 上传包后,`Packages` 那张表应显示:`YuncangTraceExtension-.zip`、版本号、**Status = Complete**、 权限识别为 `storage, alarms, http://localhost:17300/*, http://127.0.0.1:17300/*, https://pack.wms.gztbyc.com/*`。 > `Languages in package:` 为空是**正常**的(包内没有 `_locales` 多语言资源);商店页面的语言在 > Store listing 里单独选,不影响审核。 | Partner Center 字段 | 填什么 | 限制 / 备注 | |---|---|---| | Display name(显示名称) | `云仓视频溯源 · 单号注入` | ≤ 45 字符 | | Short description(简短描述) | `在自家 WMS/后台页面识别运单号,一键打开打包视频溯源;识别规则与生效站点由管理员集中维护。` | ≤ 132 字符 | | Detailed description(详细描述) | 本文第 2 节的「详细描述」整段 | ≤ 10,000 字符 | | Store listing language | 中文(简体) | 可再加 English(用第 2 节的英文文案) | | Category(类别) | `Productivity`(效率) | | | Privacy policy URL | `https://pack.wms.gztbyc.com/extension-privacy.html` | 必填;已验证 200 | | Website / Support URL | `https://pack.wms.gztbyc.com/` | | | Support contact email | `821298006@qq.com` | 与隐私政策里保持一致 | | Store logo | 300×300 PNG | 可用 `extension/icons/icon128.png` 放大后导出 | | Small promotional tile | 440×280 PNG | 可选,建议做一张(带软件名) | | Screenshots(1–10 张) | 见第 4 节的 4 张 | 640×480 或 1280×800,PNG/JPG | | Search terms(搜索词) | `运单号;溯源;打包视频;WMS;快递单号` | 可选,别写"微信""淘宝"等他人商标 | | Pricing | 免费 | 不需要绑定付款方式 | | 版本 | 1.1.2 | 与 zip 内 manifest 一致 | 提交前最后确认三件事: 1. 隐私政策链接**能打开**(换网络/浏览器试一次); 2. 截图里**没有**真实客户名、真实运单号、手机号; 3. 详细描述里的「为什么需要访问所有网站」那段**保留**——审核最常见的退回理由就是权限过宽。