packServer/extension/STORE-SUBMISSION.md
liufumingren fe8c0d62a1 chore(ports): 本机服务与边缘代理端口整体迁出 173xx
- 桌面端本机 HTTP/WS:17300/17301 → 16000/16001(前端、浏览器扩展、文档同步)
- 后台服务局域网:UDP 17310/TCP 17311 → UDP 16100/TCP 16101(16010 被向日葵占用,统一避开 160xx)
- 防火墙规则随端口更新,安装/升级时清理旧 17xxx 规则,避免继续占用别人的端口
- 桌面端版本升到 1.0.162

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-18 15:51:41 +08:00

15 KiB
Raw Blame History

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 用户,非受管/非开发者模式也能一键装 ✅ 已上架(免费)
开发者模式手动加载 任何 Chromium 内核浏览器 ✅ 已实现:菜单「复制插件路径(Chrome / 开发者模式)」

非受管电脑上 ExtensionInstallForcelist 会被 Chrome/Edge 拒绝([BLOCKED],提示"此设备并非由你的组织管理"), 所以普通员工电脑只有商店这条路;受管设备同样直接装商店版(IT 也能统一下发商店扩展)。

企业策略 + 自建 CRX 这条路线已下线:桌面端的「安装/卸载浏览器插件(企业策略)」菜单 和 Services/ExtensionInstaller.cs 都已移除。

1. 上架前检查清单

  • manifest.json 里没有 update_url、没有 key(商店会拒)
  • name 13 字符、description 69 字符(限制:name ≤ 45 / description ≤ 132)
  • minimum_chrome_version: 96(Edge 同内核,兼容)
  • 权限最小化:storage + alarms,host 只有本机服务与本项目后端
  • 隐私政策页面已上线:https://pack.wms.gztbyc.com/extension-privacy.html (源码 frontend/public/extension-privacy.html,随前端一起发布)
  • 商店上传包:extension/out/YuncangTraceExtension-<version>.zip (cd backend && npm run extension:zip,条目名是标准 /,manifest.json 在根目录)
  • Microsoft Partner Center 账号(免费):https://partner.microsoft.com/dashboard/microsoftedge/
  • 截图 3~5 张(见第 4 节)
  • 隐私政策里的联系邮箱已确认: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:16000/*、http://127.0.0.1:16000/* 与本机安装的桌面客户端通信(判断是否安装、传递运单号)。 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:只保留给内网/离线分发(updates.xml 仍会发布),客户端不再提供一键安装入口。
  2. 升级流程:改代码 → 改 manifest.json 的 version → cd backend && npm run extension:zip → 在 Partner Center 上传新 zip → 审核通过后用户自动升级。
  3. 商店版和自建 CRX 版是两个不同 ID 的扩展,同一浏览器都装会同时注入、页面被标记两遍—— 用过旧版企业策略的机器要先手工清掉 HKLM 里那几条 ExtensionInstallForcelist / ExtensionInstallSources(见 desktop/README.md 的「浏览器插件」一节),再装商店版。

7. 现场操作对照

场景 操作
员工电脑(非受管)、用 Edge 打开加载项商店页面 → 「获取」
员工电脑(加域 / 受管) 同上,直接装商店版(也可由 IT 统一下发商店扩展)
临时/无管理员权限 桌面端「工具 → 复制插件路径(Chrome / 开发者模式)」→ chrome://extensions 加载已解压
国产 Chromium 浏览器(360/QQ/搜狗) 多数支持"加载已解压的扩展程序",用同一条路径

8. 提交时逐字段对照表(Package 上传之后)

上传包后,Packages 那张表应显示:YuncangTraceExtension-<version>.zip、版本号、Status = Complete、 权限识别为 storage, alarms, http://localhost:16000/*, http://127.0.0.1:16000/*, 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. 详细描述里的「为什么需要访问所有网站」那段保留——审核最常见的退回理由就是权限过宽。

9. 商店标识(提交创建后固定,别丢)

Partner Center 创建提交后给出的这套标识是永久的(以后每次更新包都不变):

项目 值
Store ID 0RDCKCT5L8FD
CRX ID(= 商店版扩展 ID) mgdonmkicojkabgalgekobaoohaohfcj
Product ID 3befdb70-2315-4ad1-bd72-bbda56275c42
安装页 URL(发布后才可用) https://microsoftedge.microsoft.com/addons/detail/mgdonmkicojkabgalgekobaoohaohfcj

商店公钥(SHA256(SPKI DER) 前 16 字节 → a~p 映射即可还原上面的 CRX ID):

MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAyfnsoBMQnp6lXEhfER2NyuH2EZUP8MBFY3FFbsrOoqsSxknUjy6n2NMRbSzvmUWM1tWCmglmCUqAnoXlgt7D
YfDtpg6AtFz69OH/M51iFuCKlx6dPsBQ5UbnaqNhjZtIG2utT/hxmUEkiiROpAyc
bG3T80VgAa9R175V+toVo9Qc1ZO/WW8Ul6GSg0DcpVsEcz0PvYvPDqtpaqtRyd9o
Bou0foKWFDVLpvl9S+9RWAhvdoBPP5igWKyfYVSI9TK8TbeWbkxjz0ROUvOHZMNu
JytfIrz/F7R1Xiw6mDsU6PxjE2xHuXGdTwN3ncs4ZPKHylmaTDYcLLPBkrxXoea0
PwIDAQAB

两个 ID 的关系(已实测核对)

版本 扩展 ID 由谁签名 装法
自建 CRX(内网/离线) lkeibbccgdddjamahnkibopcpidhgggk 我们的 extension/keys/key.pem 客户端不再提供入口(企业策略已下线)
Edge 商店版 mgdonmkicojkabgalgekobaoohaohfcj 微软密钥(上表公钥) 用户在加载项商店点「获取」
  • 用上面那把公钥实测推导,得到的正是 mgdon…,确认它就是商店的签名公钥;
  • CRX 的 ID 由签名密钥决定,别试图用 manifest 的 key 字段把两个 ID 统一(会与签名密钥冲突);
  • 两个 ID = 两个独立扩展(配置、注入各自一套)。老机器如果被旧版策略装过自建 CRX, 先按桌面端 README 的说明清掉 HKLM 策略再装商店版;
  • 目前自建 ID lkei… 只在开发机上装过(非受管电脑的策略安装本来就被浏览器拒绝),所以切到商店版几乎零成本;

发布后的接入动作(TODO)

  1. 把安装页 URL 填进桌面端「工具」菜单:新增「安装浏览器插件(商店)」→ 用默认浏览器打开该链接;
  2. 链接可用性自查:curl -I https://microsoftedge.microsoft.com/addons/detail/mgdonmkicojkabgalgekobaoohaohfcj 返回 200 即上线;
  3. 现场分发话术:统一走 Edge 商店(点「获取」);Chrome 用户走开发者模式。