# 云仓视频溯源 · 单号注入扩展
Chrome / Edge 扩展(**Manifest V3 + 原生 JS,零构建**)。
它注入到**第三方 WMS / 后台页面**里,按规则找到「运单号」这类字段,在它**旁边**渲染一个
「▶ 查看打包视频」按钮(宿主元素一个字都不改);点击按钮打开溯源页面,把编号作为关键词带过去。
> 首个取样站点:`https://wms.wms.gztbyc.com/order/orderManagement`
> 运单号长这样:
> ```html
> title="点击复制并查看快递单号二维码">321408064481776
> ```
> 扩展会在它后面插一个按钮(插在 `+1` 展开按钮之前):
> ```html
> 321408064481776
>
> ```
> 点按钮 → 小窗打开 `https://www.baidu.com/?keyword=321408064481776`。
> 原来的运单号仍保留 WMS 自带的「点击复制二维码」行为。
---
## 1. 安装
### 客户机:从桌面端安装包直接加载(推荐)
桌面端 MSI 已经把这个 `extension/` 目录一起装好,路径固定为
`%LOCALAPPDATA%\Programs\YuncangTrace\extension`:
1. 桌面端软件菜单「**工具 → 复制谷歌插件地址**」(复制的是 Windows 路径,可直接粘进选择框)。
2. 打开 `chrome://extensions`(Edge 是 `edge://extensions`)→ 右上角打开 **开发者模式**。
3. 点 **加载已解压的扩展程序**,把刚复制的路径粘进去。
4. 刷新一下已经打开的 WMS 页面(扩展只对**安装之后**加载的页面生效)。
### 开发:直接加载仓库目录
1. 打开 `chrome://extensions`(Edge 是 `edge://extensions`)。
2. 右上角打开 **开发者模式**。
3. 点 **加载已解压的扩展程序**,选择本目录 `extension/`。
4. 刷新一下已经打开的 WMS 页面(扩展只对**安装之后**加载的页面生效)。
图标缺失时重新生成:`powershell -ExecutionPolicy Bypass -File tools\make-icons.ps1`
## 2. 目录结构
```
extension/
├── manifest.json # MV3 声明;权限只有 "storage"
├── icons/ # 16/32/48/128,由 tools/make-icons.ps1 生成
├── src/
│ ├── lib/rules.js # ★ 规则引擎(配置归一化 / 正则编译 / DOM 加工 / 地址拼接)
│ ├── content.js # 注入脚本:扫描 + 加工 + 点击拦截 + MutationObserver 补标
│ ├── content.css # 注入样式(全部 .pst- 前缀 + !important)
│ ├── background.js # service worker:只负责把算好的地址打开(小窗 / 新标签页)
│ ├── popup.html/.css/.js # 工具栏弹窗:开关、本页命中清单、重新扫描
│ └── options.html/.css/.js # ★ 规则配置页:基本设置 / 规则编辑 / 试跑 / 导入导出
├── test/wms-mock.html # 自测页:按真实结构复刻的表格
└── tools/make-icons.ps1 # 生成图标(纯 ASCII,见文件头说明)
```
**没有构建步骤**:`rules.js` 挂在 `globalThis.PSTRules` 上,content script / popup / options 各自
用 `