From 11ebb33966d64b06db226f64c9286faecf7aa6fb Mon Sep 17 00:00:00 2001 From: liufumingren Date: Sun, 1 Nov 2026 03:16:26 +0800 Subject: [PATCH] =?UTF-8?q?feat(extension):=20=E6=8F=92=E4=BB=B6=E9=85=8D?= =?UTF-8?q?=E7=BD=AE=E9=9B=86=E4=B8=AD=E7=AE=A1=E7=90=86=20+=20=E6=A1=8C?= =?UTF-8?q?=E9=9D=A2=E7=AB=AF=E7=AD=96=E7=95=A5=E5=AE=89=E8=A3=85=20+=20?= =?UTF-8?q?=E8=B7=A8=E7=BD=91=E4=B8=8B=E8=BD=BD=E4=BF=AE=E5=A4=8D?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 后端:sys_config 存插件配置(识别前缀/生效站点/模板),平台管理员 GET/PUT /api/web/admin/extension; 插件读取 GET /api/web/extension/config(Redis 缓存 1 小时,保存即失效) - 前端:平台管理 → 插件配置页(只维护前缀,单号正则由服务端生成) - 插件:改为只拉取执行(每 5 分钟 + 手动同步),移除规则编辑/试跑/导入导出;安装包地址自动取最新发布 - 桌面端:工具 → 安装/卸载谷歌插件(生成 .reg + reg import 写 HKLM 策略,读注册表验证); 跨网下载改走云端中转;局域网探测补排障日志;自动更新按包类型取 md5Exe/sizeExe - 发布:npm run extension:publish(crx + updates.xml)、extension:zip(商店上传包), nginx 对 /download/extension/updates.xml 关缓存 Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- .gitignore | 7 +- backend/README.md | 69 ++- backend/app/controller/web/admin_extension.js | 34 ++ backend/app/controller/web/extension.js | 34 ++ backend/app/router.js | 8 + backend/app/service/extension_config.js | 236 +++++++++ backend/config/config.default.js | 9 + backend/config/deploy.config.example.cjs | 3 + backend/package.json | 3 + backend/scripts/deploy/deploy-lib.cjs | 15 +- backend/scripts/deploy/publish-desktop.cjs | 96 +++- backend/scripts/deploy/publish-extension.cjs | 292 ++++++++++ desktop/MainWindow.xaml | 6 +- desktop/MainWindow.xaml.cs | 154 +++++- desktop/README.md | 94 +++- desktop/Services/Agent/ServiceInstaller.cs | 18 +- desktop/Services/ApiClient.cs | 18 +- desktop/Services/Edge/EdgeDiscoveryClient.cs | 85 ++- desktop/Services/Edge/StreamGateway.cs | 9 +- desktop/Services/ExtensionInstaller.cs | 393 ++++++++++++++ desktop/Services/PlaybackDownloadService.cs | 20 + desktop/Services/UpdateChecker.cs | 43 +- desktop/UpdateWindow.xaml.cs | 41 +- desktop/YuncangTrace.LocalService.csproj | 12 +- extension/README.md | 123 +++-- extension/keys/README.md | 36 ++ extension/keys/key.pem | 28 + extension/manifest.json | 9 +- extension/src/background.js | 172 ++++++ extension/src/lib/rules.js | 60 +++ extension/src/options.css | 208 -------- extension/src/options.html | 438 ++++++--------- extension/src/options.js | 499 ++++-------------- extension/src/popup.html | 8 +- extension/src/popup.js | 48 +- frontend/src/api/extension.ts | 46 ++ frontend/src/components/AppLayout.vue | 9 +- frontend/src/router/index.ts | 7 + frontend/src/views/AdminExtensionView.vue | 394 ++++++++++++++ 39 files changed, 2722 insertions(+), 1062 deletions(-) create mode 100644 backend/app/controller/web/admin_extension.js create mode 100644 backend/app/controller/web/extension.js create mode 100644 backend/app/service/extension_config.js create mode 100644 backend/scripts/deploy/publish-extension.cjs create mode 100644 desktop/Services/ExtensionInstaller.cs create mode 100644 extension/keys/README.md create mode 100644 extension/keys/key.pem delete mode 100644 extension/src/options.css create mode 100644 frontend/src/api/extension.ts create mode 100644 frontend/src/views/AdminExtensionView.vue diff --git a/.gitignore b/.gitignore index bd16388..07726b1 100644 --- a/.gitignore +++ b/.gitignore @@ -1,4 +1,4 @@ -# ============================================================ +# ============================================================ # 仓库根忽略规则(backend / frontend / extension 通用) # 只在这一处维护;各子项目不必再各写一份(不带斜杠的规则对任意层级都生效) # ============================================================ @@ -93,3 +93,8 @@ desktop/native/ffmpeg/*.exe # ---------- 调试用的视频拆帧产物(video_split/frame_*.jpg,别提交) ---------- video_split/ + +# Chrome 插件打包产物(.crx / updates.xml,由 npm run extension:build 生成) +extension/out/ +# 注意:extension/keys/key.pem **是入库的**(决定扩展 ID,丢了就换 ID)。 +# 它绝不能随安装包发给客户 —— desktop/YuncangTrace.LocalService.csproj 已显式排除 keys\ 与 out\。 diff --git a/backend/README.md b/backend/README.md index 349809b..bc278dd 100644 --- a/backend/README.md +++ b/backend/README.md @@ -1,4 +1,4 @@ -# 云仓视频溯源系统(pack-service) +# 云仓视频溯源系统(pack-service) > 中文名(前端页面/邮件里显示的那个)在 **`config.siteName`** 里,默认「云仓视频溯源系统」,可用环境变量 `SITE_NAME` 覆盖 —— > 要改名只改这一处(邮件用 `app.config.siteName`)。 @@ -37,6 +37,8 @@ packService/backend │ │ │ ├── admin_member.js # /api/web/admin/members[/:id]、/me 平台管理员名单(❗需平台管理员) │ │ │ ├── admin_subject.js # /api/web/admin/subjects[/:id] 所有主体 + 改授权到期时间 │ │ │ ├── admin_order.js # /api/web/admin/orders[/:orderNo/confirm] 所有订单 + 确认订单 +│ │ │ ├── admin_extension.js # /api/web/admin/extension Chrome 插件集中配置(❗需平台管理员) +│ │ │ ├── extension.js # /api/web/extension/config 插件读取的配置(公开只读,无令牌) │ │ │ └── test.js # /api/web/test/{device-login,scan} 前端测试页的模拟接口(仅非生产环境注册) │ │ ├── internal/ # 运维/内部(❗需内部令牌,挂在 middleware.internalAuth() 后面) │ │ │ ├── user.js # /api/users* 用户 CRUD(含缓存) @@ -218,7 +220,7 @@ npm run db:deploy:prod # 基线表 + 全部未执行迁移(幂等,可反 ├── frontend.prev/ # 上一版前端(回退用) ├── download/ # 安装包分发(nginx 直接托管) │ ├── version.json # 桌面端版本信息(不缓存,客户端写死这个地址) - │ ├── desktop/ # 桌面端 MSI(长缓存) + │ ├── desktop/ # 桌面端 MSI + EXE(长缓存) │ └── android_client/ # Android APK + version.json ├── shared-config/ # 服务端私有配置(不随发布包走) │ └── env.prod.sh # 启动前 source 的环境变量 @@ -291,6 +293,10 @@ npm run db:deploy:prod # 基线表 + 全部未执行迁移(幂等,可反 发布说明: +> ⚠️ `npm run deploy` **只发后端 + 前端 + nginx**:桌面端安装包(`npm run desktop:publish`)和 +> Chrome 插件(`npm run extension:publish`)是**两条独立命令**,不会跟着 deploy 走。 +> 三者的远端目录互不重叠(`/download/desktop/`、`/download/extension/`),可以各自单独发布。 + - 前端构建产物单独上传到 `deployRoot/frontend`,由 **nginx 直接托管**(SPA 回退到 `index.html`);上一版保留在 `frontend.prev`,`npm run rollback` 会连前端一起切回。 nginx 前端/反代配置由发布脚本写入 `deployRoot/front.conf`;Egg 只提供 `/api`、`/health`(`FRONTEND_ENABLE=false`)。 `buildFrontend: false` 时跳过前端构建与发布(适合前端完全独立部署)。 @@ -311,19 +317,46 @@ npm run desktop:build # 只构建(dry-run),产物在 deskt npm run desktop:publish # 构建 + 上传 + 刷新 nginx npm run desktop:publish -- --version=1.0.90 --notes="修复 xxx" npm run desktop:publish -- --skip-nginx +npm run desktop:publish -- --target=Msi # 只出 MSI(不发 EXE) ``` +- `--target=Both|Msi|Exe` 直接透传给 `desktop/installer/build.ps1 -Target`; + ⚠️ 客户端版本 `≤ 1.0.151` 有个 bug:优先下载 EXE,却拿 version.json 里的 `md5`(**MSI 的**)去校验, + 必然报「安装包 MD5 不一致」。**给这些客户端发的第一个修复版必须只出 MSI** + (`--target=Msi`,此时 version.json 里没有 `downloadUrlExe`,老客户端会回落到 MSI + `md5`,能正常升级), + 等它们升上来之后再恢复 `Both`。 + - 版本默认取本地已有最高版本 + 1(补丁号),也可用 `--version=` 指定; - 构建复用 `desktop/installer/build.ps1 -Environment Production`; -- 上传到 `deployRoot/download/desktop/`(MSI),`version.json` 传到 `deployRoot/download/` - (路径不能改:老客户端写死 `/download/version.json`;先传 MSI,再原子替换 `version.json`); -- nginx 的 `/download/` 静态托管该目录:`version.json` 不缓存,MSI 长缓存; +- 上传到 `deployRoot/download/desktop/`(MSI + EXE),`version.json` 传到 `deployRoot/download/` + (路径不能改:老客户端写死 `/download/version.json`;先传安装包,再原子替换 `version.json`); +- nginx 的 `/download/` 静态托管该目录:`version.json` 不缓存,安装包长缓存; - `desktop/installer/package.config.json` 的 Production `serverBaseUrl` 必须是 `https://`,安装包内嵌的接口 / 下载地址会跟着变; -- **谷歌插件一起打进包**:`extension/` 发布到 `<安装目录>\extension`,菜单「工具 → 复制谷歌插件地址」给出该 Windows 路径; +- **谷歌插件一起打进包**:`extension/` 发布到 `<安装目录>\extension`;正式分发走企业策略 + (`npm run extension:publish` + 菜单「工具 → 安装谷歌插件」,见下节); - 不会重启 Egg、不会重新发布后端、不会跑数据库迁移; -- 前置:.NET 8 SDK、WiX 5.0.2(`dotnet tool install --global wix --version 5.0.2`)、`desktop/native/ffmpeg/ffmpeg.exe`。 -下载地址:`/download/desktop/YuncangTraceSetup-<版本>.msi` +### Chrome 插件正式包(.crx + updates.xml) + +```bash +cd backend +npm run extension:build # 只打包(dry-run),产物在 extension/out +npm run extension:publish # 打包 + 上传 + 刷新 nginx +npm run extension:publish -- --version=1.2.0 --skip-nginx +``` + +- 用本机 Chrome/Edge 的 `--pack-extension` 打包(找不到浏览器时用 `--browser=<路径>` 指定); +- 产物:`YuncangTraceExtension-.crx`、`updates.xml`、`extension-id.txt`; +- 上传到 `deployRoot/download/extension/`;nginx 对 **`updates.xml` 关缓存**(浏览器靠它自动升级), + `.crx` 文件名带版本号、走长缓存; +- 扩展 ID 由 `extension/keys/key.pem` 决定(首次运行自动生成,**必须备份**,换了 ID 就变, + 已下发到客户机的策略全部失效); +- 客户机侧:桌面端「工具 → 安装谷歌插件」写 `ExtensionInstallForcelist` + `ExtensionInstallSources` + (Chrome 与 Edge 各一份,HKLM),重启浏览器即自动安装; +- 前置:.NET 8 SDK、WiX 5.0.2(`dotnet tool install --global wix --version 5.0.2`)、Inno Setup 6(`winget install --id JRSoftware.InnoSetup`,出 EXE 用)、`desktop/native/ffmpeg/ffmpeg.exe`。 + +下载地址:`/download/desktop/YuncangTraceSetup-<版本>.exe`(新客户端优先) + `/download/desktop/YuncangTraceSetup-<版本>.msi`(老客户端只认这个) 更新信息:`/download/version.json` ### Android 设备端正式包(单独发布,不动后端) @@ -350,7 +383,7 @@ npm run android:publish -- --skip-nginx 网页端**所有页面**的右上角都有两个下载按钮(`frontend/src/components/AppLayout.vue`,**与权限无关**,登录后就能看到): -- 「桌面端 vX.Y.Z」→ `version.json` 里的 `downloadUrl`(MSI) +- 「桌面端 vX.Y.Z」→ `version.json` 里的 `downloadUrlExe`(EXE)/ `downloadUrl`(MSI,老客户端) - 「Android 扫码台 vX.Y.Z」→ `version.json` 里的 `downloadUrl`(APK) 版本信息由 `frontend/src/api/download.ts` 直接 `fetch` 两个 `version.json`(**注意:这两个路径返回的是 @@ -979,6 +1012,24 @@ await this.ctx.service.cache.remember('user:1', 60, () => loadFromMysql()); 改授权到期时间后必须失效主体状态缓存(`subjectState.invalidate`),否则设备心跳 / 上报最多要等一个 TTL 才看到新期限 —— `service/subject.js#setExpireAt()` 已经做了。 +### Chrome 插件配置(集中下发) + +插件**只拉取执行**,配置存在 `sys_config`(`group='extension'`, `config_key='config'`, `value_type=json`),不新建表。 + +| 方法 | 路径 | 鉴权 | 说明 | +|---|---|---|---| +| GET | `/api/web/admin/extension` | 平台管理员 | 当前配置(含 `version` / `updatedAt` / 已生成的正则 `pattern`) | +| PUT | `/api/web/admin/extension` | 平台管理员 | 保存 `{ enabled, hosts, prefixes, minDigits, maxDigits, urlTemplate, appUrlTemplate, downloadUrl }`;**不收 `pattern`**,正则由服务端拼;成功后 `version + 1` | +| GET | `/api/web/extension/config` | 公开(可选 `?key=`) | 插件读的副本;`config.extension.appKey`(env `EXTENSION_APP_KEY`)非空时要求 key 一致 | + +- 单号正则 = `\b(?:<前缀用 \| 连接>)\d{min,max}\b`(`service/extension_config.js#buildPattern`),前缀只允许大写字母/数字、1~8 位、最多 50 个; +- `hosts` 是插件生效站点(glob,支持 `*.abc.com`);留空按 `['*']` 处理; +- 插件每 **5 分钟**拉一次,靠 `version` 判断要不要更新(版本没变不写存储);`GET /api/web/extension/config` 的返回在 Redis 缓存 **1 小时**(`extension:config:public`),后台 `PUT` 保存时立刻删缓存 —— 提交即生效,平时又不会每 5 分钟回源一次; +- **发布新安装包不用清缓存**:安装包地址由插件每次直接读 nginx 的 `/download/version.json`(nginx 对这个路径是 no-cache),不进这份 1 小时缓存;`service/extensionConfig.invalidate()` 留给运维/发布脚本需要时手工调用; +- `downloadUrl` **不用配**:插件同步时优先读 `GET /download/version.json`,永远用最新发布版本 + (后台页面已不提供这个输入框;配置里的值只在 version.json 拉不到时兜底); +- 生产若配了 `CORS_ORIGINS` 白名单,记得把 `chrome-extension://<扩展ID>` 加进去(默认 `*` 不用管)。 + ### 前端(`frontend/`) 左侧菜单在**平台管理员**登录后会多出一组「平台管理」(`components/AppLayout.vue`): diff --git a/backend/app/controller/web/admin_extension.js b/backend/app/controller/web/admin_extension.js new file mode 100644 index 0000000..42cabc5 --- /dev/null +++ b/backend/app/controller/web/admin_extension.js @@ -0,0 +1,34 @@ +'use strict'; + +const { Controller } = require('egg'); + +/** + * 平台管理:Chrome 插件配置(`/api/web/admin/extension`) + * + * 鉴权:`middleware.apiAuth()` + `middleware.platformAdmin()`。 + * + * - `GET /api/web/admin/extension` 当前配置(含 version / updatedAt) + * - `PUT /api/web/admin/extension` 保存(只收 enabled / hosts / prefixes / 位数 / 模板 / 下载地址, + * **正则由服务端生成**,不接受前端传 pattern) + * + * 保存成功后 `version + 1`,插件端每小时拉一次,靠 version 判断要不要更新。 + */ +class WebAdminExtensionController extends Controller { + /** GET /api/web/admin/extension */ + async show() { + const { ctx } = this; + const data = await ctx.service.extensionConfig.read(); + ctx.body = { ok: true, data }; + } + + /** PUT /api/web/admin/extension */ + async update() { + const { ctx } = this; + const data = await ctx.service.extensionConfig.save(ctx.request.body || {}); + ctx.logger.info('[extension] 插件配置已更新:v%s,站点 %s,前缀 %s', + data.version, data.hosts.join(','), data.prefixes.join(',')); + ctx.body = { ok: true, data }; + } +} + +module.exports = WebAdminExtensionController; diff --git a/backend/app/controller/web/extension.js b/backend/app/controller/web/extension.js new file mode 100644 index 0000000..7c14664 --- /dev/null +++ b/backend/app/controller/web/extension.js @@ -0,0 +1,34 @@ +'use strict'; + +const { Controller } = require('egg'); + +/** + * Chrome 插件读取配置(`GET /api/web/extension/config`) + * + * **公开只读**:插件装在员工浏览器里,没有用户令牌;下发的只有 + * 识别前缀 / 生效站点 / 跳转模板 / 安装包地址,不含任何账号或业务数据。 + * + * 两道保护: + * - `config.extension.appKey` 非空时要求 `?key=` 一致(env `EXTENSION_APP_KEY`), + * 避免站点清单被随便抓走;不设就完全公开(内网部署的常见做法); + * - 响应 `Cache-Control: no-cache`:配置改了要能马上生效,别被 nginx/浏览器缓存一小时。 + */ +class WebExtensionController extends Controller { + /** GET /api/web/extension/config */ + async config() { + const { ctx, app } = this; + + const expected = (app.config.extension && app.config.extension.appKey) || ''; + if (expected && String(ctx.query.key || '') !== expected) { + ctx.throw(403, '插件配置需要正确的 key'); + } + + const data = await ctx.service.extensionConfig.publicView(); + + ctx.set('Cache-Control', 'no-cache, max-age=0'); + ctx.set('X-Config-Version', String(data.version)); + ctx.body = { ok: true, data }; + } +} + +module.exports = WebExtensionController; diff --git a/backend/app/router.js b/backend/app/router.js index 62b9c79..0d54626 100644 --- a/backend/app/router.js +++ b/backend/app/router.js @@ -77,6 +77,14 @@ module.exports = (app) => { router.get('/api/web/admin/orders', apiAuth, platformAdmin, controller.web.adminOrder.index); // 确认订单 = 支付回调的后续动作(同一套 payNotify:标记已支付 + 主体顺延 + 失效缓存) router.post('/api/web/admin/orders/:orderNo/confirm', apiAuth, platformAdmin, controller.web.adminOrder.confirm); + // Chrome 插件的集中配置:只维护「前缀 / 生效站点 / 模板」,单号正则由服务端生成 + router.get('/api/web/admin/extension', apiAuth, platformAdmin, controller.web.adminExtension.show); + router.put('/api/web/admin/extension', apiAuth, platformAdmin, controller.web.adminExtension.update); + + // ---------- Chrome 插件读取(公开只读,无令牌) ---------- + // 只下发:前缀 + 生成好的正则 + 生效站点 + 跳转模板 + 安装包地址;不含任何账号/业务数据。 + // 生产若配了 CORS_ORIGINS,记得把 `chrome-extension://<扩展ID>` 加进去(默认 `*` 不用管)。 + router.get('/api/web/extension/config', controller.web.extension.config); // ---------- 主体(租户):不输主体 id,靠「当前用户是否是成员」判定 ---------- // 除这几个以外的业务接口都要额外带 `X-Subject-Id`(middleware/subjectAuth) diff --git a/backend/app/service/extension_config.js b/backend/app/service/extension_config.js new file mode 100644 index 0000000..6596abc --- /dev/null +++ b/backend/app/service/extension_config.js @@ -0,0 +1,236 @@ +'use strict'; + +const { Service } = require('egg'); + +/** + * Chrome 插件的**集中配置**(平台管理员维护,插件只拉取执行) + * + * 存 `sys_config`(group=extension, key=config, valueType=json),不新建表: + * 配置是「一套全局值」,读写频率极低,且有 Redis 缓存(见 service/config.js)。 + * + * 设计要点: + * - 后台**只维护前缀**(`YT` / `SF` / `32`…),单号正则由这里拼出来(`pattern`), + * 插件端不再自己拼正则、也不展示正则; + * - `hosts` 是插件允许工作的站点(glob:`*.abc.com`、`192.168.11.206`、`*`); + * - 每次保存 `version + 1`:插件靠它判断"配置变没变",没变就不重写 storage(避免整页重扫); + * - `pattern` 一并下发:服务端生成一次,所有客户端行为一致,不会各拼各的。 + */ + +/** sys_config 位置 */ +const GROUP = 'extension'; +const KEY = 'config'; + +/** 默认前缀(和老版插件内置的快递规则一致) */ +const DEFAULT_PREFIXES = [ 'YT', 'SF', 'JD', 'ZTO', 'YTO', 'STO', 'EMS', 'DBL', '32', '77' ]; + +const DEFAULT_URL_TEMPLATE = 'http://localhost:7301/local?code={code}'; +const DEFAULT_APP_URL_TEMPLATE = 'yuncang://open?code={code}'; + +/** 前缀:字母/数字,1~8 位(`32` / `77` 这种数字前缀也要支持) */ +const PREFIX_RE = /^[A-Z0-9]{1,8}$/; + +/** + * 插件读取结果的服务端缓存 + * + * 插件每 5 分钟拉一次,几百台机器就是每小时上万次请求 —— 但配置几乎不变, + * 所以服务端算一次缓存 **1 小时**;后台保存配置时立刻删掉(`save()` → `invalidate()`), + * 保证「提交新版本」马上生效。 + * + * 安装包地址不参与这份缓存:插件自己读 nginx 的 `/download/version.json`(那边是 no-cache), + * 所以打包上传新安装包**天然即时**,不需要清这里的缓存。 + */ +const PUBLIC_CACHE_KEY = 'extension:config:public'; +const PUBLIC_CACHE_TTL_SECONDS = 3600; + +/** 没配置过时的默认值 */ +function defaults() { + return { + version: 0, + enabled: true, + hosts: [ '*' ], + prefixes: DEFAULT_PREFIXES.slice(), + minDigits: 10, + maxDigits: 16, + urlTemplate: DEFAULT_URL_TEMPLATE, + appUrlTemplate: DEFAULT_APP_URL_TEMPLATE, + downloadUrl: '', + updatedAt: null, + pattern: buildPattern(DEFAULT_PREFIXES, 10, 16), + flags: 'g', + }; +} + +/** + * 由前缀生成单号正则:`\b(?:YT|SF|…)\d{10,16}\b` + * + * 用 `g`(不带 `i`):前缀统一存成大写,避免把 `yt` 这类普通词误判成单号。 + */ +function buildPattern(prefixes, minDigits, maxDigits) { + const list = prefixes.map(item => String(item).replace(/[.*+?^${}()|[\]\\]/g, '\\$&')); + if (list.length === 0) return ''; + return '\\b(?:' + list.join('|') + ')\\d{' + minDigits + ',' + maxDigits + '}\\b'; +} + +/** 数组去空去重(保持顺序) */ +function uniq(list) { + const seen = new Set(); + const out = []; + for (const item of list) { + if (seen.has(item)) continue; + seen.add(item); + out.push(item); + } + return out; +} + +/** 生效站点:glob 字符串;留空 = 不限制(`*`) */ +function normalizeHosts(value) { + const list = (Array.isArray(value) ? value : []) + .map(item => String(item == null ? '' : item).trim()) + .filter(Boolean); + return list.length > 0 ? uniq(list) : [ '*' ]; +} + +/** 前缀:转大写、校验字符集、去重、限制数量 */ +function normalizePrefixes(value) { + const list = (Array.isArray(value) ? value : []) + .map(item => String(item == null ? '' : item).trim().toUpperCase()) + .filter(Boolean); + + const bad = list.find(item => !PREFIX_RE.test(item)); + if (bad) { + const error = new Error(`单号前缀「${bad}」不合法:只能是大写字母或数字,1~8 位`); + error.status = 422; + throw error; + } + + const out = uniq(list); + if (out.length > 50) { + const error = new Error('单号前缀最多 50 个'); + error.status = 422; + throw error; + } + return out; +} + +/** 数字位数:4~24,且 min ≤ max */ +function normalizeDigits(min, max) { + const toInt = (value, fallback) => { + const parsed = Number.parseInt(value, 10); + return Number.isInteger(parsed) ? parsed : fallback; + }; + + let minDigits = Math.min(Math.max(toInt(min, 10), 4), 24); + let maxDigits = Math.min(Math.max(toInt(max, 16), 4), 24); + if (minDigits > maxDigits) [ minDigits, maxDigits ] = [ maxDigits, minDigits ]; + return { minDigits, maxDigits }; +} + +/** 模板:必须含 `{code}`,否则回落到默认值(空串也算没填) */ +function normalizeTemplate(value, fallback) { + const text = String(value == null ? '' : value).trim() || fallback; + return text.includes('{code}') ? text : fallback; +} + +/** 把任意输入整理成合法配置(不含 version / updatedAt) */ +function normalize(input) { + const source = input && typeof input === 'object' ? input : {}; + + const prefixes = normalizePrefixes(source.prefixes); + const { minDigits, maxDigits } = normalizeDigits(source.minDigits, source.maxDigits); + + return { + enabled: source.enabled !== false, + hosts: normalizeHosts(source.hosts), + prefixes, + minDigits, + maxDigits, + urlTemplate: normalizeTemplate(source.urlTemplate, DEFAULT_URL_TEMPLATE), + appUrlTemplate: normalizeTemplate(source.appUrlTemplate, DEFAULT_APP_URL_TEMPLATE), + // 留空 = 插件同步时自己读 /download/version.json(永远用最新发布版本); + // 只有要指到内网镜像之类才需要填,后台页面已经不提供这个输入框。 + downloadUrl: String(source.downloadUrl == null ? '' : source.downloadUrl).trim(), + pattern: buildPattern(prefixes, minDigits, maxDigits), + flags: 'g', + }; +} + +class ExtensionConfigService extends Service { + /** + * 读当前配置(给管理员看,含默认值) + * + * 存量数据可能是旧结构(例如手改过 sys_config),这里统一过一遍 normalize, + * 保证返回给前端 / 插件的字段永远齐全。 + */ + async read() { + const stored = await this.ctx.service.config.get(GROUP, KEY, null); + if (!stored || typeof stored !== 'object') return defaults(); + + const config = normalize(stored); + return { + ...config, + version: Number(stored.version) || 0, + updatedAt: stored.updatedAt || null, + }; + } + + /** 保存(管理端):校验 → version 自增 → 写 sys_config(带缓存失效) */ + async save(input) { + const previous = await this.read(); + const next = normalize(input); + + next.version = (Number(previous.version) || 0) + 1; + next.updatedAt = new Date().toISOString(); + + await this.ctx.service.config.set({ + groupName: GROUP, + configKey: KEY, + configValue: next, + valueType: 'json', + remark: 'Chrome 插件集中配置(识别前缀 / 生效站点 / 跳转模板)', + }); + + // 提交即生效:插件下次(最多 5 分钟)来拉的时候就能拿到新配置 + await this.invalidate(); + + return next; + } + + /** + * 插件读取用的公开视图(Redis 缓存 1 小时) + * + * 只给插件执行所需字段,**不含任何内部信息**(主体、账号、密钥一概没有)。 + */ + async publicView() { + const cached = await this.ctx.service.cache.get(PUBLIC_CACHE_KEY); + if (cached) return cached; + + const view = this.buildPublicView(await this.read()); + await this.ctx.service.cache.set(PUBLIC_CACHE_KEY, view, PUBLIC_CACHE_TTL_SECONDS); + return view; + } + + /** 主动失效(保存配置时调用;发布脚本/内部运维需要时也能用) */ + async invalidate() { + await this.ctx.service.cache.del(PUBLIC_CACHE_KEY); + } + + buildPublicView(config) { + return { + version: config.version, + enabled: config.enabled, + hosts: config.hosts, + prefixes: config.prefixes, + minDigits: config.minDigits, + maxDigits: config.maxDigits, + pattern: config.pattern, + flags: config.flags, + urlTemplate: config.urlTemplate, + appUrlTemplate: config.appUrlTemplate, + downloadUrl: config.downloadUrl, + updatedAt: config.updatedAt, + }; + } +} + +module.exports = ExtensionConfigService; diff --git a/backend/config/config.default.js b/backend/config/config.default.js index 4883446..f44d969 100644 --- a/backend/config/config.default.js +++ b/backend/config/config.default.js @@ -56,6 +56,15 @@ module.exports = (appInfo) => { buffer: false, // MSI / APK 几十 MB,流式发送 }; + // ==================== Chrome 插件(集中配置) ==================== + // 插件只拉取执行:`GET /api/web/extension/config`(公开只读,内容由平台管理员在 + // `/api/web/admin/extension` 维护,存 sys_config 的 group=extension)。 + // `appKey` 非空时要求 `?key=` 一致(env `EXTENSION_APP_KEY`),防止站点清单被随便抓走; + // 不设就完全公开(内网部署的常见做法)。 + config.extension = { + appKey: env.EXTENSION_APP_KEY || '', + }; + // ==================== 前端入口(页面不在后端渲染) ==================== // 开发(env=local):页面请求(非 /api、/health)反代到前端 dev server(frontend/ 里 npm run dev) // 生产:直接托管前端构建产物 dist(SPA 深链回退到 index.html) diff --git a/backend/config/deploy.config.example.cjs b/backend/config/deploy.config.example.cjs index 86af47d..4308588 100644 --- a/backend/config/deploy.config.example.cjs +++ b/backend/config/deploy.config.example.cjs @@ -76,6 +76,9 @@ module.exports = { desktopBaseUrl: 'https://pack.example.com', desktopKeepVersions: 5, desktopOwner: 'www:www', + // Chrome 插件(npm run extension:publish):.crx + updates.xml 放这里 + // nginx 对 /download/extension/updates.xml 关缓存,浏览器靠它自动升级 + extensionDownloadDir: '/www/wwwroot/packService/download/extension', // Android 设备端发布(npm run android:publish):同样只构建/上传 APK androidBuildScript: 'android_client/build.ps1', diff --git a/backend/package.json b/backend/package.json index 0100ee1..c9e5e0f 100644 --- a/backend/package.json +++ b/backend/package.json @@ -62,6 +62,9 @@ "version:history": "node ./scripts/deploy/version-history.cjs --limit=50", "desktop:build": "node ./scripts/deploy/publish-desktop.cjs production --dry-run", "desktop:publish": "node ./scripts/deploy/publish-desktop.cjs production", + "extension:build": "node ./scripts/deploy/publish-extension.cjs production --dry-run", + "extension:zip": "node ./scripts/deploy/publish-extension.cjs production --zip", + "extension:publish": "node ./scripts/deploy/publish-extension.cjs production", "android:build": "node ./scripts/deploy/publish-android.cjs production --dry-run", "android:publish": "node ./scripts/deploy/publish-android.cjs production", "guard:git": "node ./scripts/deploy/git-safety-check.cjs", diff --git a/backend/scripts/deploy/deploy-lib.cjs b/backend/scripts/deploy/deploy-lib.cjs index d7d6637..ee898b5 100644 --- a/backend/scripts/deploy/deploy-lib.cjs +++ b/backend/scripts/deploy/deploy-lib.cjs @@ -213,6 +213,9 @@ function normalizeDeployConfig(config, envName) { desktopDownloadDir: config.desktopDownloadDir || `${deployRoot}/download/desktop`, // version.json 不放安装包目录里:nginx 对 /download/version.json 单独关缓存,安装包目录走长缓存 desktopVersionDir: config.desktopVersionDir || `${deployRoot}/download`, + // Chrome 插件(.crx + updates.xml):npm run extension:publish + // updates.xml 必须不缓存(浏览器靠它判断有没有新版本),.crx 文件名带版本号可以长缓存 + extensionDownloadDir: config.extensionDownloadDir || `${deployRoot}/download/extension`, desktopBaseUrl: config.desktopBaseUrl || (config.serverName ? `http://${config.serverName}` : ''), desktopKeepVersions: Number(config.desktopKeepVersions || 5), desktopOwner: config.desktopOwner || 'www:www', @@ -460,7 +463,7 @@ function buildFrontConf(config) { : [ '# nginxUpstreamFile 未配置,跳过 /api、/health 反代' ]), '', '# 桌面端 / Android 安装包:由 nginx 直接托管 deployRoot/download', - '# download/desktop/*.msi、download/android_client/*.apk 长缓存;', + '# download/desktop/*.exe、*.msi、download/android_client/*.apk 长缓存;', '# version.json 一律不缓存(客户端靠它判断有没有新版本)。', 'location = /download/version.json {', ` root ${config.deployRoot};`, @@ -471,6 +474,16 @@ function buildFrontConf(config) { ' expires 0;', '}', '', + '# Chrome 插件更新清单:浏览器每次启动都会来问,必须不缓存(策略安装 + 自动升级都靠它)', + 'location = /download/extension/updates.xml {', + ` root ${config.deployRoot};`, + ' default_type text/xml;', + ' add_header Cache-Control "no-store, no-cache, must-revalidate, max-age=0";', + ' add_header Pragma "no-cache";', + hsts, + ' expires 0;', + '}', + '', 'location = /download/android_client/version.json {', ` root ${config.deployRoot};`, ' default_type application/json;', diff --git a/backend/scripts/deploy/publish-desktop.cjs b/backend/scripts/deploy/publish-desktop.cjs index ea8cda6..76f153c 100644 --- a/backend/scripts/deploy/publish-desktop.cjs +++ b/backend/scripts/deploy/publish-desktop.cjs @@ -1,15 +1,18 @@ 'use strict'; /** - * 桌面端正式包:构建 MSI + version.json,并单独发布到 nginx 静态目录 + * 桌面端正式包:构建 MSI + EXE + version.json,并单独发布到 nginx 静态目录 * * 特点: * - 只动桌面端产物,不重新发布后端、不重启 Egg、不跑数据库迁移; - * - 构建复用 desktop/installer/build.ps1(Production 环境); + * - 构建复用 desktop/installer/build.ps1(Production 环境,默认同时出 MSI 和 EXE); * - 安装包上传到 deploy.config.local.cjs 里的 desktopDownloadDir(deployRoot/download/desktop); * - version.json 上传到 desktopVersionDir(默认 deployRoot/download,nginx 对 /download/version.json 关缓存); * - 同时刷新 front.conf 里的 /download/ 静态托管配置并 reload nginx。 * + * 为什么两个包都要传:老客户端只认 downloadUrl(MSI);新客户端优先 downloadUrlExe(EXE, + * 不依赖 Windows Installer,现场装不了 MSI 的机器靠它)。少传任何一个都会让对应客户端 404。 + * * 用法: * npm run desktop:publish # 自动递增补丁版本并发布 * npm run desktop:publish -- --version=1.0.90 @@ -38,6 +41,7 @@ function parseArgs(argv) { version: '', notes: '', keep: 0, + target: '', dryRun: false, skipNginx: false, }; @@ -59,6 +63,12 @@ function parseArgs(argv) { options.notes = item.slice('--notes='.length); } else if (item.startsWith('--keep=')) { options.keep = Number(item.slice('--keep='.length)) || 0; + } else if (item.startsWith('--target=')) { + options.target = item.slice('--target='.length).trim(); + const allowed = [ 'Both', 'Msi', 'Exe' ]; + if (!allowed.includes(options.target)) { + throw new Error(`--target 只能是 ${allowed.join(' / ')}:${options.target}`); + } } } @@ -77,13 +87,13 @@ function compareVersion(a, b) { return 0; } -/** 取本地已有 MSI / version.json 中最高的版本,并默认 +1 补丁号 */ +/** 取本地已有安装包 / version.json 中最高的版本,并默认 +1 补丁号 */ function nextVersion(outDir) { const versions = []; if (fs.existsSync(outDir)) { for (const name of fs.readdirSync(outDir)) { - const match = name.match(/^YuncangTraceSetup-(\d+\.\d+\.\d+)\.msi$/); + const match = name.match(/^YuncangTraceSetup-(\d+\.\d+\.\d+)\.(?:msi|exe)$/); if (match) versions.push(match[1]); } } @@ -107,7 +117,7 @@ function nextVersion(outDir) { } /** 用 build.ps1 构建 Production 包 */ -function buildDesktop(config, { version, notes, baseUrl }) { +function buildDesktop(config, { version, notes, baseUrl, target }) { const buildScript = path.resolve(ROOT, config.desktopBuildScript); if (!fs.existsSync(buildScript)) { throw new Error(`找不到桌面端构建脚本: ${buildScript}`); @@ -125,6 +135,10 @@ function buildDesktop(config, { version, notes, baseUrl }) { if (notes) { args.push('-ReleaseNotes', notes); } + // 只出某一种包(例如老客户端 MD5 校验有 bug 时,先发一个「只有 MSI」的版本把它们拉上来) + if (target) { + args.push('-Target', target); + } console.log(`构建桌面端正式包: ${version}(${baseUrl})`); runCommand(shell, args, { cwd: path.dirname(buildScript), stdio: 'inherit' }); @@ -150,23 +164,41 @@ function main() { throw new Error('未配置 desktopVersionDir(version.json 发布目录)。'); } - buildDesktop(config, { version, notes: options.notes, baseUrl }); + buildDesktop(config, { version, notes: options.notes, baseUrl, target: options.target }); const msiName = `YuncangTraceSetup-${version}.msi`; + const exeName = `YuncangTraceSetup-${version}.exe`; const msiPath = path.join(outDir, msiName); + const exePath = path.join(outDir, exeName); const versionPath = path.join(outDir, 'version.json'); - if (!fs.existsSync(msiPath)) { - throw new Error(`构建完成但 MSI 不存在: ${msiPath}`); - } if (!fs.existsSync(versionPath)) { throw new Error(`构建完成但 version.json 不存在: ${versionPath}`); } const versionJson = JSON.parse(fs.readFileSync(versionPath, 'utf8')); - console.log(`安装包: ${msiPath}(${(fs.statSync(msiPath).size / 1024 / 1024).toFixed(1)} MB)`); + + // version.json 里有 downloadUrlExe 就必须把 EXE 一起传上去,否则新客户端拿到的是 404 + const packages = []; + if (fs.existsSync(msiPath)) packages.push(msiPath); + if (versionJson.downloadUrlExe) { + if (!fs.existsSync(exePath)) { + throw new Error(`version.json 指向 EXE,但文件不存在: ${exePath}`); + } + packages.push(exePath); + } + if (!packages.length) { + throw new Error(`构建完成但没找到安装包(${msiName} / ${exeName})`); + } + + for (const pkg of packages) { + console.log(`安装包: ${pkg}(${(fs.statSync(pkg).size / 1024 / 1024).toFixed(1)} MB)`); + } console.log(`版本文件: ${versionPath}`); console.log(`下载地址: ${versionJson.downloadUrl}`); + if (versionJson.downloadUrlExe) { + console.log(`下载地址(EXE): ${versionJson.downloadUrlExe}`); + } console.log(`发布目录: ${config.username}@${config.host}:${remoteDir}`); console.log(`版本目录: ${config.username}@${config.host}:${remoteVersionDir}`); @@ -179,7 +211,6 @@ function main() { ensureCommandAvailable('scp', '请先安装 OpenSSH Client 并确保 scp 在 PATH 中。'); const stamp = getNowStamp(); - const remoteMsiTmp = `${remoteDir}/.${msiName}.upload-${stamp}`; const remoteVersionTmp = `${remoteVersionDir}/.version.json.upload-${stamp}`; runSsh(config, [ @@ -191,22 +222,26 @@ function main() { 'find "$DIR" "$VDIR" -maxdepth 1 -type f -name ".*.upload-*" -delete', ].join('\n'), { stdio: 'pipe' }); - console.log(`上传安装包(${(fs.statSync(msiPath).size / 1024 / 1024).toFixed(1)} MB)…`); - runScp(config, msiPath, remoteMsiTmp); + for (const pkg of packages) { + const name = path.basename(pkg); + const remoteTmp = `${remoteDir}/.${name}.upload-${stamp}`; - runSsh(config, [ - 'set -euo pipefail', - `DIR=${quoteForBash(remoteDir)}`, - `TMP=${quoteForBash(remoteMsiTmp)}`, - `FINAL=${quoteForBash(`${remoteDir}/${msiName}`)}`, - 'mv "$TMP" "$FINAL"', - 'chmod 644 "$FINAL"', - `chown ${quoteForBash(config.desktopOwner || 'www:www')} "$FINAL" || true`, - 'echo "MSI_UPLOADED"', - ].join('\n'), { stdio: 'pipe' }); - console.log(`安装包已发布: ${remoteDir}/${msiName}`); + console.log(`上传安装包 ${name}(${(fs.statSync(pkg).size / 1024 / 1024).toFixed(1)} MB)…`); + runScp(config, pkg, remoteTmp); - // MSI 就位后再更新 version.json,避免客户端拿到指向不存在文件的版本信息 + runSsh(config, [ + 'set -euo pipefail', + `TMP=${quoteForBash(remoteTmp)}`, + `FINAL=${quoteForBash(`${remoteDir}/${name}`)}`, + 'mv "$TMP" "$FINAL"', + 'chmod 644 "$FINAL"', + `chown ${quoteForBash(config.desktopOwner || 'www:www')} "$FINAL" || true`, + `echo "PACKAGE_UPLOADED ${name}"`, + ].join('\n'), { stdio: 'pipe' }); + console.log(`安装包已发布: ${remoteDir}/${name}`); + } + + // 所有安装包就位后再更新 version.json,避免客户端拿到指向不存在文件的版本信息 runScp(config, versionPath, remoteVersionTmp); runSsh(config, [ 'set -euo pipefail', @@ -217,12 +252,17 @@ function main() { 'chmod 644 "$VDIR/version.json"', `chown ${quoteForBash(config.desktopOwner || 'www:www')} "$VDIR/version.json" || true`, 'echo "VERSION_JSON_UPLOADED"', - // 只保留最近 N 个安装包 + // 只保留最近 N 个安装包(MSI / EXE 分别计算) 'COUNT=0', `for FILE in $(ls -1t "$DIR"/YuncangTraceSetup-*.msi 2>/dev/null || true); do`, ' COUNT=$((COUNT + 1))', ` if [ "$COUNT" -gt ${Number(keep)} ]; then rm -f "$FILE"; fi`, 'done', + 'COUNT=0', + `for FILE in $(ls -1t "$DIR"/YuncangTraceSetup-*.exe 2>/dev/null || true); do`, + ' COUNT=$((COUNT + 1))', + ` if [ "$COUNT" -gt ${Number(keep)} ]; then rm -f "$FILE"; fi`, + 'done', 'ls -1t "$DIR" | head -20', ].join('\n'), { stdio: 'pipe' }); @@ -233,7 +273,9 @@ function main() { console.log(''); console.log('桌面端发布完成:'); console.log(` 版本: ${version}`); - console.log(` 安装包: ${baseUrl}/download/desktop/${msiName}`); + for (const pkg of packages) { + console.log(` 安装包: ${baseUrl}/download/desktop/${path.basename(pkg)}`); + } console.log(` 更新信息: ${baseUrl}/download/version.json`); } diff --git a/backend/scripts/deploy/publish-extension.cjs b/backend/scripts/deploy/publish-extension.cjs new file mode 100644 index 0000000..901fc56 --- /dev/null +++ b/backend/scripts/deploy/publish-extension.cjs @@ -0,0 +1,292 @@ +'use strict'; + +/** + * Chrome 插件正式包:打包 .crx + 生成 updates.xml,并发布到 nginx 静态目录 + * + * 为什么需要它: + * - 浏览器只认**已签名**的扩展包,`chrome://extensions` 里「加载已解压」没法被策略/安装包注入; + * - 企业策略 `ExtensionInstallForcelist` 只接受 `<扩展ID>;`,update_url 必须是一个 + * 可访问的 XML(不是本地目录); + * - 所以这里把仓库里的 `extension/` 打成 `.crx`,连同 `updates.xml` 一起放到 + * `deployRoot/download/extension/`(nginx 对 updates.xml 关缓存,.crx 长缓存)。 + * + * 产物(extension/out/): + * - `YuncangTraceExtension-.crx` 扩展包(文件名带版本号,可以长缓存) + * - `updates.xml` 更新清单(`` 就是扩展 ID) + * - `extension-id.txt` 扩展 ID(给安装/排障用) + * + * 扩展 ID 由**私钥**决定:`extension/keys/key.pem`(首次运行自动生成,**务必备份**; + * 换私钥 = 换 ID = 已下发到客户机的策略全部失效)。 + * + * 用法: + * npm run extension:publish # 打包 + 上传 + 刷新 nginx + * npm run extension:publish -- --dry-run # 只打包,不上传 + * npm run extension:publish -- --version=1.2.0 + * npm run extension:publish -- --skip-nginx # 不改 nginx + * npm run extension:publish -- --browser="C:\Program Files\Microsoft\Edge\Application\msedge.exe" + */ + +const crypto = require('node:crypto'); +const fs = require('node:fs'); +const os = require('node:os'); +const path = require('node:path'); + +const { + ROOT, + ensureCommandAvailable, + getNowStamp, + loadDeployConfig, + quoteForBash, + refreshNginx, + runCommand, + runScp, + runSsh, +} = require('./deploy-lib.cjs'); + +/** 仓库根(backend 的上一级) */ +const REPO_ROOT = path.resolve(ROOT, '..'); +const EXT_DIR = path.join(REPO_ROOT, 'extension'); +const KEY_FILE = path.join(EXT_DIR, 'keys', 'key.pem'); +const OUT_DIR = path.join(EXT_DIR, 'out'); +const PACKAGE_NAME = 'YuncangTraceExtension'; + +/** 打进 crx 的内容(其余 README/test/tools/out/keys 不进包) */ +const INCLUDE = [ 'manifest.json', 'icons', 'src' ]; + +function parseArgs(argv) { + const options = { + envName: 'production', + version: '', + baseUrl: '', + browser: '', + dryRun: false, + zipOnly: false, + skipNginx: false, + }; + + for (const item of argv) { + if (!item) continue; + if (!item.startsWith('--') && !options.envNameExplicit) { + options.envName = item; + options.envNameExplicit = true; + continue; + } + if (item === '--dry-run') { + options.dryRun = true; + } else if (item === '--zip') { + // 只打「商店上传用的 zip」,不打包 crx、不上传 + options.zipOnly = true; + } else if (item === '--skip-nginx') { + options.skipNginx = true; + } else if (item.startsWith('--version=')) { + options.version = item.slice('--version='.length).trim().replace(/^v/i, ''); + } else if (item.startsWith('--base-url=')) { + options.baseUrl = item.slice('--base-url='.length).trim(); + } else if (item.startsWith('--browser=')) { + options.browser = item.slice('--browser='.length).trim(); + } + } + + if (options.version && !/^\d+(\.\d+){1,3}$/.test(options.version)) { + throw new Error(`版本号格式应为 x.y.z:${options.version}`); + } + return options; +} + +/** 读 manifest 里的版本号(没传 --version 时用) */ +function manifestVersion() { + const data = JSON.parse(fs.readFileSync(path.join(EXT_DIR, 'manifest.json'), 'utf8')); + const version = String(data.version || '').trim(); + if (!/^\d+(\.\d+){1,3}$/.test(version)) { + throw new Error(`manifest.json 里的 version 不合法:${version}`); + } + return version; +} + +/** 找本机可用的 Chromium 内核浏览器(打包用;Chrome/Edge 都支持 --pack-extension) */ +function resolveBrowser(explicit) { + const candidates = [ + explicit, + process.env.CHROME_PATH, + process.env.EDGE_PATH, + 'C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe', + 'C:\\Program Files (x86)\\Google\\Chrome\\Application\\chrome.exe', + process.env.LOCALAPPDATA && path.join(process.env.LOCALAPPDATA, 'Google', 'Chrome', 'Application', 'chrome.exe'), + 'C:\\Program Files (x86)\\Microsoft\\Edge\\Application\\msedge.exe', + 'C:\\Program Files\\Microsoft\\Edge\\Application\\msedge.exe', + ].filter(Boolean); + + for (const item of candidates) { + if (fs.existsSync(item)) return item; + } + throw new Error('找不到 chrome.exe / msedge.exe(打包 crx 要用)。可用 --browser=<路径> 指定。'); +} + +/** 把扩展源码复制到临时目录(只带 INCLUDE 里的东西) */ +function stageSources(workDir) { + const target = path.join(workDir, PACKAGE_NAME); + fs.mkdirSync(target, { recursive: true }); + for (const name of INCLUDE) { + const from = path.join(EXT_DIR, name); + if (!fs.existsSync(from)) throw new Error(`扩展源码缺少:${from}`); + fs.cpSync(from, path.join(target, name), { recursive: true }); + } + return target; +} + +/** + * 用浏览器命令行打包 crx + * + * - 不给 `--pack-extension-key` 时浏览器会在同级生成 `.pem`(第一次运行用这个拿私钥); + * - 必须给独立的 `--user-data-dir`:否则命令会被**已经在运行的 Chrome** 接走,不会真的打包。 + */ +function packCrx(browser, srcDir, keyPath, workDir) { + const baseArgs = [ + `--pack-extension=${srcDir}`, + `--user-data-dir=${path.join(workDir, 'profile')}`, + '--no-first-run', + '--no-default-browser-check', + '--disable-gpu', + ]; + + const crxPath = `${srcDir}.crx`; + const pemPath = `${srcDir}.pem`; + + if (!fs.existsSync(keyPath)) { + console.log('没有私钥,先生成一个(决定扩展 ID,生成后请备份):', keyPath); + runCommand(browser, baseArgs, { stdio: 'inherit' }); + if (!fs.existsSync(pemPath)) throw new Error('浏览器没有生成 .pem,打包失败'); + fs.mkdirSync(path.dirname(keyPath), { recursive: true }); + fs.copyFileSync(pemPath, keyPath); + if (fs.existsSync(crxPath)) fs.rmSync(crxPath); + } + + runCommand(browser, [ ...baseArgs, `--pack-extension-key=${keyPath}` ], { stdio: 'inherit' }); + if (!fs.existsSync(crxPath)) throw new Error(`打包失败:没有生成 ${crxPath}`); + return crxPath; +} + +/** + * 由私钥算扩展 ID + * + * Chrome 的规则:公钥 DER(SPKI)→ SHA256 → 取前 16 字节 → 每个十六进制位映射成 a~p。 + */ +function extensionIdFromKey(pem) { + const publicKey = crypto.createPublicKey(crypto.createPrivateKey(pem)); + const spki = publicKey.export({ type: 'spki', format: 'der' }); + const hex = crypto.createHash('sha256').update(spki).digest('hex').slice(0, 32); + return hex.split('').map(ch => String.fromCharCode(97 + parseInt(ch, 16))).join(''); +} + +/** updates.xml:浏览器靠它判断有没有新版本 */ +function writeUpdatesXml({ id, version, codebase }) { + return [ + '', + '', + ` `, + ` `, + ' ', + '', + '', + ].join('\n'); +} + +/** 上传一个文件到远端目录(先传临时名再 mv,避免中途被下到半个文件) */ +function uploadFile(config, localPath, remoteDir, name, stamp) { + const remoteTmp = `${remoteDir}/.${name}.upload-${stamp}`; + runScp(config, localPath, remoteTmp); + runSsh(config, [ + 'set -euo pipefail', + `mv ${quoteForBash(remoteTmp)} ${quoteForBash(`${remoteDir}/${name}`)}`, + `chmod 644 ${quoteForBash(`${remoteDir}/${name}`)}`, + ...(config.desktopOwner ? [ `chown ${quoteForBash(config.desktopOwner)} ${quoteForBash(`${remoteDir}/${name}`)}` ] : []), + `echo "UPLOADED ${name}"`, + ].join('\n')); +} + +function main() { + const options = parseArgs(process.argv.slice(2)); + const config = loadDeployConfig(options.envName); + + const version = options.version || manifestVersion(); + const baseUrl = String(options.baseUrl || config.desktopBaseUrl || (config.serverName ? `https://${config.serverName}` : '')) + .replace(/\/+$/, ''); + // --zip 只出商店上传包,不需要后端地址 + if (!options.zipOnly && !baseUrl) { + throw new Error('拿不到后端地址:请在 deploy.config.local.cjs 里配 desktopBaseUrl 或 serverName'); + } + + // --dry-run 也要真的打包(只是不上传):本机得有 Chrome/Edge;--zip 不需要浏览器 + const browser = options.zipOnly ? '' : resolveBrowser(options.browser); + + // 打包在临时目录里做,仓库里只留 out/ 产物 + const workDir = fs.mkdtempSync(path.join(os.tmpdir(), 'yuncang-ext-')); + try { + console.log(`打包 Chrome 插件 ${version}(${path.relative(REPO_ROOT, EXT_DIR)})`); + const srcDir = stageSources(workDir); + + // 商店上传用的是 zip(manifest.json 必须在压缩包根目录) + if (options.zipOnly) { + const zipName = `${PACKAGE_NAME}-${version}.zip`; + const zipPath = path.join(OUT_DIR, zipName); + fs.mkdirSync(OUT_DIR, { recursive: true }); + fs.rmSync(zipPath, { force: true }); + runCommand('powershell.exe', [ + '-NoProfile', '-Command', + `Compress-Archive -Path '${path.join(srcDir, '*')}' -DestinationPath '${zipPath}' -Force`, + ], { stdio: 'inherit' }); + + console.log(`商店上传包: ${zipPath}(${(fs.statSync(zipPath).size / 1024).toFixed(0)} KB)`); + return; + } + + const crxPath = packCrx(browser, srcDir, KEY_FILE, workDir); + + const id = extensionIdFromKey(fs.readFileSync(KEY_FILE, 'utf8')); + const crxName = `${PACKAGE_NAME}-${version}.crx`; + const codebase = `${baseUrl}/download/extension/${crxName}`; + const updateUrl = `${baseUrl}/download/extension/updates.xml`; + + fs.mkdirSync(OUT_DIR, { recursive: true }); + fs.copyFileSync(crxPath, path.join(OUT_DIR, crxName)); + fs.writeFileSync(path.join(OUT_DIR, 'updates.xml'), writeUpdatesXml({ id, version, codebase })); + fs.writeFileSync(path.join(OUT_DIR, 'extension-id.txt'), `${id}\n`); + + console.log(`扩展 ID : ${id}`); + console.log(`CRX : ${path.join(OUT_DIR, crxName)}`); + console.log(`更新清单: ${updateUrl}`); + + if (options.dryRun) { + console.log('--dry-run:只打包,不上传。'); + return; + } + + const remoteDir = config.extensionDownloadDir; + if (!remoteDir) throw new Error('未配置 extensionDownloadDir(插件发布目录)'); + + ensureCommandAvailable('ssh', '请先安装 OpenSSH Client 并确保 ssh 在 PATH 中。'); + ensureCommandAvailable('scp', '请先安装 OpenSSH Client 并确保 scp 在 PATH 中。'); + + const stamp = getNowStamp(); + runSsh(config, [ + 'set -euo pipefail', + `mkdir -p ${quoteForBash(remoteDir)}`, + `find ${quoteForBash(remoteDir)} -maxdepth 1 -type f -name ".upload-*" -delete`, + ].join('\n')); + + uploadFile(config, path.join(OUT_DIR, crxName), remoteDir, crxName, stamp); + // 最后传 updates.xml:新包先就位,浏览器再看到新版本号 + uploadFile(config, path.join(OUT_DIR, 'updates.xml'), remoteDir, 'updates.xml', stamp); + + if (!options.skipNginx) refreshNginx(config); + + console.log(''); + console.log('发布完成。客户机「工具 → 安装谷歌插件」会写入策略:'); + console.log(` ExtensionInstallForcelist = ${id};${updateUrl}`); + console.log(` ExtensionInstallSources = ${baseUrl}/download/extension/*`); + } finally { + fs.rmSync(workDir, { recursive: true, force: true }); + } +} + +main(); diff --git a/desktop/MainWindow.xaml b/desktop/MainWindow.xaml index 3b0d6f8..cccc3d0 100644 --- a/desktop/MainWindow.xaml +++ b/desktop/MainWindow.xaml @@ -25,7 +25,9 @@ - + + + @@ -110,7 +112,7 @@ - - -

- 两种匹配方式:
- · CSS 选择器:直接命中元素本身(例如 Element-Plus 表格里的 [title*="快递单号"]), - 取它的文本或某个属性(attr)当编号;属性里的值必须用这种 —— 文本扫描只走文本节点,拿不到属性。
- · 文本正则:遍历页面文本,把命中的子串包起来(原文照抄,页面读 textContent / 复制粘贴不受影响)。
- · 正则与模式的关系:文本模式下正则必填(用来找编号);选择器模式下正则可选, - 填了就用来从取到的属性值/文本里再抽一次编号。
- 例:<a href="javascript:MM_openTrace('../system/view-trace!viewTrace.jspb?postNum=202610101621&wareHouseId=5400')"> - → 选择器 a[href*="postNum="] + 属性 href + 正则 postNum=([0-9A-Za-z_-]+)。 -

- -

- 两种加工方式:
- · 在旁边加按钮(默认):宿主元素一个字都不改(不加类名、不改 title、不接管点击), - 只在它旁边插一个「查看打包视频」兄弟按钮 —— 页面自己原来的点击行为照旧。
- · 命中元素本身可点:元素自己变成可点(会加类名 / 改写 title / 接管点击), - 适合页面上本来就是个普通文字的场景。 -

- - - -
-

规则试跑 用当前还没保存的规则试,方便调正则

- -
- - -
- - - -
- - -
- -
-
- - -
-

导入 / 导出

- -
- - - -
-
- - -
-

使用说明

-
    -
  1. 打开 chrome://extensions → 右上角打开「开发者模式」→「加载已解压的扩展程序」→ 选择本项目的 extension/ 目录。
  2. -
  3. 进入 WMS 页面(https://wms.wms.gztbyc.com/order/orderManagement),运单号旁边会出现「查看打包视频」按钮。
  4. -
  5. 点这个按钮 → 直接用 yuncang://open?code=<运单号> 唤起本机软件并定位到这个单号(浏览器第一次会问「要打开吗」,点允许即可)。没安装或协议没注册时,约 8 秒后(探测不到本机服务)会在右下角弹出「在网页中查看 / 下载安装」的兜底提示。
  6. -
  7. 想让它在浏览器里看,把「目标地址模板」换成 http://…/local?code={code}(本机软件公共页,不需要登录:一次查询就能知道软件在不在、要不要唤起登录)。
  8. -
  9. 运单号本身(点击复制二维码)不受影响,点它还是原来的复制行为。
  10. -
  11. 调规则时优先用下面的「规则试跑」,不要反复刷页面。工具栏图标上的弹窗能看到「本页命中」清单,用来确认注入是否生效。
  12. -
-
- -
- - -
- - - - - +
+

单号识别

+

+ 只认这些前缀;正则与位数由服务器下发,本地不提供修改。 +

+
+
+ 单号位数 + — +
+
+ +
+

跳转

+
唤起软件—
+
网页查看—
+
+ + + + + + diff --git a/extension/src/options.js b/extension/src/options.js index 87fe627..92af190 100644 --- a/extension/src/options.js +++ b/extension/src/options.js @@ -1,425 +1,140 @@ 'use strict'; /** - * 云仓视频溯源 · 规则配置页 + * 云仓视频溯源 · 选项页(**只读状态页**) * - * 说明: - * - 页面上所有读写都围绕「配置对象」,最终由 PSTRules.normalizeConfig 兜底(缺字段/非法值都不会写坏)。 - * - 「试跑」用的是**当前表单里还没保存**的规则,方便边调正则边看结果。 - * - 试跑里渲染 HTML 一律走 PSTRules.escapeHtml,不把外来 HTML 直接 innerHTML 进本页(杜绝 onerror 之类)。 + * 插件不再提供规则编辑 / 试跑 / 导入导出 / 使用说明: + * 识别前缀、生效站点、跳转模板全部由后台「平台管理 → 插件配置」维护, + * 插件每小时自动同步(后台 background.js),这里只展示状态 + 提供「立即同步」。 */ (function () { const R = globalThis.PSTRules; const $ = id => document.getElementById(id); - /** 取样自 https://wms.wms.gztbyc.com/order/orderManagement 的一整行(已精简掉无关列) */ - const SAMPLE_HTML = [ - '', - ' ', - ' ', - ' ', - ' ', - ' ', - ' ', - '
JY2026101619599321408064481776', - ' E20261016000696930529169563286869已打包2026-10-16 13:26:22
', - ].join('\n'); + const SYNC_STATE_KEY = 'pstSyncState'; + const CONFIG_SOURCE = 'https://pack.wms.gztbyc.com/api/web/extension/config'; - let cfg = R.defaultConfig(); + init(); - boot(); - - async function boot() { - cfg = await R.loadConfig(); - fillBase(cfg); - renderRules(cfg.rules); - - $('testHost').value = 'wms.wms.gztbyc.com'; - $('testInput').value = SAMPLE_HTML; - - bind(); - updateUrlPreview(); - runTest(); + async function init() { + $('sync-now').addEventListener('click', onSyncNow); + $('download').addEventListener('click', onDownload); + await render(); } - /* ============================== 基本设置 ============================== */ - - function fillBase(c) { - $('enabled').value = String(c.enabled); - $('openMode').value = c.openMode; - $('actionMode').value = c.actionMode; - $('buttonText').value = c.buttonText; - $('markStyle').value = c.markStyle; - $('showIcon').value = String(c.showIcon); - $('hosts').value = (c.hosts || []).join('\n'); - $('urlTemplate').value = c.urlTemplate; - $('appUrlTemplate').value = c.appUrlTemplate || ''; - $('fallbackUrl').value = c.fallbackUrl || ''; - $('downloadUrl').value = c.downloadUrl || ''; - $('scanDelay').value = c.scanDelay; - $('maxMarks').value = c.maxMarks; - $('maxNodes').value = c.maxNodes; - updateBtnPreview(); - } - - function readBase() { - return { - enabled: $('enabled').value === 'true', - openMode: $('openMode').value, - actionMode: $('actionMode').value, - buttonText: $('buttonText').value, - markStyle: $('markStyle').value, - showIcon: $('showIcon').value === 'true', - hosts: $('hosts').value, - urlTemplate: $('urlTemplate').value, - appUrlTemplate: $('appUrlTemplate').value, - fallbackUrl: $('fallbackUrl').value, - downloadUrl: $('downloadUrl').value, - scanDelay: $('scanDelay').value, - maxMarks: $('maxMarks').value, - maxNodes: $('maxNodes').value, - }; - } - - /** 表单 → 合法配置对象(同时用于保存和试跑) */ - function readForm() { - return R.normalizeConfig(Object.assign(readBase(), { rules: readRules() })); - } - - /* ================================ 规则 ================================ */ - - const field = (card, name) => card.querySelector('[data-field="' + name + '"]'); - - function renderRules(rules) { - const box = $('rules'); - box.textContent = ''; - for (const rule of rules) box.appendChild(ruleCard(rule)); - } - - function ruleCard(rule) { - const card = $('rule-tpl').content.firstElementChild.cloneNode(true); - card.dataset.id = rule.id; - field(card, 'enabled').checked = !!rule.enabled; - field(card, 'name').value = rule.name; - field(card, 'match').value = rule.match; - field(card, 'actionMode').value = rule.actionMode || ''; - field(card, 'style').value = rule.style || ''; - field(card, 'pattern').value = rule.pattern; - field(card, 'flags').value = rule.flags; - field(card, 'exclude').value = rule.exclude; - field(card, 'selector').value = rule.selector; - field(card, 'attr').value = rule.attr; - field(card, 'hostPatterns').value = (rule.hostPatterns || []).join(' '); - field(card, 'urlTemplate').value = rule.urlTemplate; - card.querySelector('[data-id]').textContent = rule.id; - updateWhen(card); - updateOff(card); - return card; - } - - function readRules() { - return Array.prototype.slice.call($('rules').querySelectorAll('.rule')).map(card => ({ - id: card.dataset.id, - enabled: field(card, 'enabled').checked, - name: field(card, 'name').value.trim(), - match: field(card, 'match').value, - actionMode: field(card, 'actionMode').value, - style: field(card, 'style').value, - pattern: field(card, 'pattern').value, - flags: field(card, 'flags').value, - exclude: field(card, 'exclude').value, - selector: field(card, 'selector').value, - attr: field(card, 'attr').value.trim(), - hostPatterns: field(card, 'hostPatterns').value, - urlTemplate: field(card, 'urlTemplate').value.trim(), - })); - } - - /** 正则输入框的提示随匹配方式变:文本模式必填,选择器模式是可选的「再抽一次」 */ - const PATTERN_TIP = { - text: { - hint: '(必填:用来在页面文本里找编号;第 1 个捕获组 = 编号,没写就用整个匹配)', - placeholder: '\\b(?:YT|SF|JD)\\d{10,16}\\b', - }, - selector: { - hint: '(可选:填了就从上面取到的属性/文本里再抽一次编号;第 1 个捕获组 = 编号)', - placeholder: 'postNum=([0-9A-Za-z_-]+)', - }, - }; - - function updateWhen(card) { - const mode = field(card, 'match').value; - for (const el of card.querySelectorAll('[data-when]')) { - el.style.display = el.getAttribute('data-when') === mode ? '' : 'none'; + async function render() { + let cfg; + try { + cfg = await R.loadConfig(); + } catch (_) { + cfg = R.defaultConfig(); } - const tip = PATTERN_TIP[mode] || PATTERN_TIP.text; - field(card, 'pattern').placeholder = tip.placeholder; - const hint = card.querySelector('[data-hint="pattern"]'); - if (hint) hint.textContent = tip.hint; - } - function updateOff(card) { - card.classList.toggle('is-off', !field(card, 'enabled').checked); - } + const state = await readSyncState(); + const remote = cfg.remote || {}; - function newRule() { - // 借 normalizeRule 生成一个不重复的 id,顺便把字段补齐 - return R.normalizeRule({ - name: '新规则', - enabled: true, - match: 'text', - pattern: '\\b[A-Z]{2}\\d{10,16}\\b', - flags: 'gi', - hostPatterns: ['*'], - }); - } + $('version').textContent = 'v' + (remote.version || '—'); + $('source').textContent = CONFIG_SOURCE; - function onRulesClick(e) { - const btn = e.target.closest('button[data-act]'); - if (!btn) return; - const card = btn.closest('.rule'); - const rules = $('rules'); - const act = btn.dataset.act; + if (state.error) { + $('badge-error').style.display = ''; + $('error-row').style.display = ''; + $('sync-error').textContent = state.error; + } else { + $('badge-error').style.display = 'none'; + $('error-row').style.display = 'none'; + } - if (act === 'del') { - if (!confirm('删除规则「' + field(card, 'name').value + '」?(记得点保存才会生效)')) return; - card.remove(); - } else if (act === 'up' && card.previousElementSibling) { - rules.insertBefore(card, card.previousElementSibling); - } else if (act === 'down' && card.nextElementSibling) { - rules.insertBefore(card.nextElementSibling, card); - } else if (act === 'dup') { - const src = readRules().find(r => r.id === card.dataset.id); - if (!src) return; - const copy = R.normalizeRule(Object.assign({}, src, { - id: newRule().id, - name: (src.name || '规则') + ' 副本', - })); - rules.insertBefore(ruleCard(copy), card.nextElementSibling); + $('last-sync').textContent = remote.syncedAt + ? formatTime(remote.syncedAt) + (state.reason === 'manual' ? '(手动)' : '(自动)') + : '还没同步过(点「立即同步」)'; + + renderChips($('hosts'), cfg.hosts, 'host', '不限制(所有站点)'); + renderChips($('prefixes'), remote.prefixes && remote.prefixes.length ? remote.prefixes : [], '', '等待服务器下发'); + + $('digits').textContent = remote.minDigits + ? remote.minDigits + ' ~ ' + remote.maxDigits + ' 位' + : '—'; + + $('app-url').textContent = cfg.appUrlTemplate || '—'; + $('web-url').textContent = cfg.urlTemplate || '—'; + + const download = $('download'); + if (cfg.downloadUrl) { + download.style.display = ''; + download.title = cfg.downloadUrl; + } else { + download.style.display = 'none'; } } - /* ================================ 试跑 ================================ */ - - function runTest() { - const form = readForm(); - const compiled = R.compileRules(form.rules); - const simHost = $('testHost').value.trim(); - const mode = $('testMode').value; - const raw = $('testInput').value; - const box = $('testResult'); + function renderChips(box, list, extraClass, emptyText) { box.textContent = ''; - - if (!raw.trim()) { - box.appendChild(el('p', 'muted', '先粘一段 HTML / 文本再试跑。')); + if (!list || !list.length) { + const span = document.createElement('span'); + span.className = 'muted'; + span.textContent = emptyText; + box.appendChild(span); return; } + for (const item of list) { + const chip = document.createElement('span'); + chip.className = 'chip' + (extraClass ? ' ' + extraClass : ''); + chip.textContent = item; + box.appendChild(chip); + } + } - let items = []; - let marks = []; - let truncated = false; + async function onSyncNow() { + const button = $('sync-now'); + button.disabled = true; + button.textContent = '同步中…'; + try { + const result = await sendSync(); + if (result && result.ok) { + $('foot').className = 'ok'; + $('foot').textContent = result.unchanged + ? '已是最新配置(v' + result.version + ')' + : '已更新到 v' + result.version + ',页面会自动重新扫描'; + } else { + $('foot').className = 'err'; + $('foot').textContent = '同步失败:' + ((result && result.error) || '未知错误'); + } + } finally { + button.disabled = false; + button.textContent = '立即同步'; + await render(); + } + } - if (mode === 'html') { - const doc = new DOMParser().parseFromString(raw, 'text/html'); - const res = R.applyMarks(doc.body, compiled, { - markClass: 'pst-trace-mark', - maxNodes: 3000, - maxMarks: 200, - defaultStyle: form.markStyle, - defaultActionMode: form.actionMode, - buttonText: form.buttonText, - showIcon: form.showIcon, - urlTemplate: form.urlTemplate, - appUrlTemplate: form.appUrlTemplate, - openMode: form.openMode, - hostname: simHost, - host: simHost, + function sendSync() { + return new Promise(resolve => { + chrome.runtime.sendMessage({ type: 'pst:sync' }, res => { + const err = chrome.runtime.lastError; + resolve(err ? { ok: false, error: err.message } : res); }); - items = res.items; - marks = res.marks; - truncated = res.truncated; - } else { - for (const line of raw.split(/\r?\n/)) { - for (const m of R.matchText(line, compiled, 20)) { - items.push({ - ruleId: m.rule.id, - ruleName: m.rule.name, - code: m.code, - url: form.openMode === 'app' - ? R.buildUrl(form.appUrlTemplate, m.code, simHost) - : R.buildUrl(m.rule.urlTemplate || form.urlTemplate, m.code, simHost), - }); - } - } - } + }); + } - // ---- 概览 ---- - const head = el('p', 'muted'); - head.innerHTML = '启用规则 ' + compiled.rules.length + ' 条' - + ' · 命中 ' + items.length + ' 条' - + (truncated ? ' · 已达上限,可能有遗漏' : '') - + ' · 模拟站点 ' + R.escapeHtml(simHost || '(空)') + ''; - box.appendChild(head); + async function onDownload() { + const cfg = await R.loadConfig(); + if (!cfg.downloadUrl) return; + chrome.tabs.create({ url: cfg.downloadUrl }); + } - for (const err of compiled.errors) { - box.appendChild(el('p', 'bad', '规则「' + err.name + '」无效:' + err.message)); - } - - // ---- 命中表 ---- - if (items.length) { - const table = document.createElement('table'); - table.innerHTML = '规则提取的编号目标地址'; - const tbody = document.createElement('tbody'); - for (const it of items) { - const tr = document.createElement('tr'); - tr.innerHTML = '' + R.escapeHtml(it.ruleName || it.ruleId) + '' - + '' + R.escapeHtml(it.code) + '' - + '' + R.escapeHtml(it.url) + ''; - tbody.appendChild(tr); - } - table.appendChild(tbody); - box.appendChild(table); - } else { - // 0 命中时把「为什么没命中」说清楚:多半是生效站点把规则挡住了 - const enabled = form.rules.filter(r => r.enabled); - if (enabled.length) { - const box2 = el('div', 'snippet'); - box2.textContent = enabled.map(r => '· ' + r.name + ' 生效站点:' + r.hostPatterns.join(' / ') - + (r.match === 'selector' ? ' 选择器:' + r.selector : ' 正则:' + r.pattern)).join('\n') - + '\n(模拟站点不在「生效站点」里、或选择器/正则没命中,都会是 0 条)'; - box.appendChild(box2); - } - } - - // ---- 二次加工后的源码片段(转义显示,不执行)---- - if (marks.length) { - const snippet = el('div', 'snippet'); - snippet.textContent = marks.slice(0, 3) - .map(m => trim(m.el.outerHTML, 240)) - .join('\n\n'); - box.appendChild(el('p', 'muted', '二次加工后的 HTML(最多 3 段):')); - box.appendChild(snippet); + async function readSyncState() { + try { + const stored = await chrome.storage.local.get(SYNC_STATE_KEY); + return (stored && stored[SYNC_STATE_KEY]) || {}; + } catch (_) { + return {}; } } - /* ============================ 导入导出/重置 ============================ */ - - async function reset() { - if (!confirm('恢复为内置默认规则?当前配置会被覆盖。')) return; - await save(R.defaultConfig()); - } - - /* ================================ 保存 ================================ */ - - async function save(value) { - const res = await R.saveConfig(value || readForm()); - if (!res.ok) { - toast('保存失败:' + (res.message || ''), true); - return; - } - cfg = await R.loadConfig(); - fillBase(cfg); - renderRules(cfg.rules); - updateUrlPreview(); - $('savedAt').textContent = '最后保存 ' + new Date().toLocaleTimeString(); - toast(res.warning ? '已保存(' + res.warning + ')' : '已保存 —— 已打开的页面会自动重新扫描'); - } - - function updateUrlPreview() { - const host = $('testHost').value.trim() || 'wms.wms.gztbyc.com'; - $('urlPreview').textContent = '预览:' + R.buildUrl($('urlTemplate').value, '321408064481776', host); - } - - function updateBtnPreview() { - const text = $('buttonText').value.trim() || '查看打包视频'; - $('btnPreview').textContent = '预览:' + text + ' (加工方式 = ' + $('actionMode').value + ')'; - } - - /* ================================ 绑定 ================================ */ - - function bind() { - $('save').addEventListener('click', () => save()); - $('add-rule').addEventListener('click', () => { - $('rules').appendChild(ruleCard(newRule())); - }); - - const rulesBox = $('rules'); - rulesBox.addEventListener('click', onRulesClick); - rulesBox.addEventListener('change', e => { - const card = e.target.closest('.rule'); - if (!card) return; - const name = e.target.getAttribute('data-field'); - if (name === 'match') updateWhen(card); - if (name === 'enabled') updateOff(card); - // 规则改了就顺手重跑一遍试跑,$('testInput') 里没东西时不会报错 - if (name) runTest(); - }); - - $('run-test').addEventListener('click', runTest); - $('fill-sample').addEventListener('click', () => { - $('testMode').value = 'html'; - $('testInput').value = SAMPLE_HTML; - runTest(); - }); - - $('urlTemplate').addEventListener('input', updateUrlPreview); - $('testHost').addEventListener('input', updateUrlPreview); - $('buttonText').addEventListener('input', () => { updateBtnPreview(); runTest(); }); - $('actionMode').addEventListener('change', () => { updateBtnPreview(); runTest(); }); - $('testInput').addEventListener('input', debounce(runTest, 350)); - - $('export').addEventListener('click', () => { - $('json').value = JSON.stringify(readForm(), null, 2); - toast('已导出到下面的文本框,复制走即可'); - }); - $('import').addEventListener('click', async () => { - let parsed; - try { - parsed = JSON.parse($('json').value); - } catch (e) { - toast('JSON 解析失败:' + e.message, true); - return; - } - await save(parsed); - }); - $('reset').addEventListener('click', reset); - - window.addEventListener('keydown', e => { - if ((e.ctrlKey || e.metaKey) && e.key === 's') { - e.preventDefault(); - save(); - } - }); - } - - /* ================================ 小工具 ================================ */ - - function el(tag, cls, text) { - const node = document.createElement(tag); - if (cls) node.className = cls; - if (text != null) node.textContent = text; - return node; - } - - let toastTimer = null; - function toast(message, bad) { - const box = $('toast'); - box.textContent = message; - box.className = 'toast' + (bad ? ' bad' : ''); - box.hidden = false; - clearTimeout(toastTimer); - toastTimer = setTimeout(() => { box.hidden = true; }, bad ? 6000 : 2600); - } - - function trim(s, max) { - const t = String(s || ''); - return t.length > max ? t.slice(0, max) + ' …(' + t.length + ' 字符)' : t; - } - - function debounce(fn, ms) { - let t = null; - return function () { - clearTimeout(t); - t = setTimeout(fn, ms); - }; + function formatTime(iso) { + const date = new Date(iso); + if (Number.isNaN(date.getTime())) return iso; + const pad = n => String(n).padStart(2, '0'); + return date.getFullYear() + '-' + pad(date.getMonth() + 1) + '-' + pad(date.getDate()) + + ' ' + pad(date.getHours()) + ':' + pad(date.getMinutes()); } })(); diff --git a/extension/src/popup.html b/extension/src/popup.html index 158ec66..5768669 100644 --- a/extension/src/popup.html +++ b/extension/src/popup.html @@ -12,10 +12,7 @@

云仓视频溯源

—

- + v—
@@ -33,7 +30,8 @@
- + +
diff --git a/extension/src/popup.js b/extension/src/popup.js index a27bdc1..99c9306 100644 --- a/extension/src/popup.js +++ b/extension/src/popup.js @@ -22,10 +22,11 @@ } catch (_) { cfg = R.defaultConfig(); } - $('enabled').checked = !!cfg.enabled; + // 配置由服务器下发:这里只展示版本,不提供本地开关(避免每小时同步时被冲掉、两处打架) + $('version').textContent = 'v' + ((cfg.remote && cfg.remote.version) || '—'); - $('enabled').addEventListener('change', onToggle); $('rescan').addEventListener('click', onRescan); + $('sync').addEventListener('click', onSyncNow); $('open-options').addEventListener('click', () => chrome.runtime.openOptionsPage()); try { @@ -53,8 +54,8 @@ stateBox.innerHTML = '
未注入' + '这个页面还没有脚本,刷新一下即可
'; } else if (!status.enabled) { - stateBox.innerHTML = '
已关闭' - + '总开关处于关闭状态
'; + stateBox.innerHTML = '
已停用' + + '管理员在后台关闭了插件
'; } else if (!status.hostAllowed && !status.active) { stateBox.innerHTML = '
不在生效范围
' + '
生效站点:' + R.escapeHtml((status.hosts || []).join(' / ')) + '
'; @@ -98,20 +99,33 @@ /* ------------------------------------------------------------ 交互 */ - async function onToggle() { - const next = $('enabled').checked; - cfg.enabled = next; - const res = await R.saveConfig(cfg); - if (!res.ok) { - $('enabled').checked = !next; - $('state').innerHTML = '
保存失败' - + '' + R.escapeHtml(res.message || '') + '
'; - return; + /** 手动同步服务器配置(成功后 content script 会自己重扫,这里只刷展示) */ + async function onSyncNow() { + const button = $('sync'); + button.disabled = true; + button.textContent = '同步中…'; + try { + const res = await new Promise(resolve => { + chrome.runtime.sendMessage({ type: 'pst:sync' }, value => { + const err = chrome.runtime.lastError; + resolve(err ? { ok: false, error: err.message } : value); + }); + }); + + if (!res || !res.ok) { + $('state').innerHTML = '
同步失败' + + '' + R.escapeHtml(String((res && res.error) || '未知错误')) + '
'; + return; + } + + cfg = await R.loadConfig(); + $('version').textContent = 'v' + ((cfg.remote && cfg.remote.version) || '—'); + status = tab ? await send(tab.id, { type: 'pst:status' }) : null; + render(); + } finally { + button.disabled = false; + button.textContent = '立即同步'; } - cfg = await R.loadConfig(); - // content script 收到 storage 变更会自己重新扫描,这里刷一下展示 - status = tab ? await send(tab.id, { type: 'pst:status' }) : null; - render(); } async function onRescan() { diff --git a/frontend/src/api/extension.ts b/frontend/src/api/extension.ts new file mode 100644 index 0000000..4d67ea6 --- /dev/null +++ b/frontend/src/api/extension.ts @@ -0,0 +1,46 @@ +/** + * Chrome 插件集中配置(平台管理员维护) + * + * 后端: + * - `GET/PUT /api/web/admin/extension` —— 管理端(平台管理员) + * - `GET /api/web/extension/config` —— 插件读的公开只读接口(这里用不到) + * + * 后台**只维护单号前缀**(`YT` / `SF` / `32`…),单号正则由服务端拼好放在 `pattern` 里, + * 前端只做只读预览、不接受修改。 + */ +import { api } from '@/api/client'; + +export interface ExtensionConfig { + /** 每次保存 +1;插件靠它判断配置有没有变 */ + version: number; + enabled: boolean; + /** 插件允许工作的站点(glob:`*.abc.com`、`192.168.11.206`、`*`) */ + hosts: string[]; + /** 单号前缀(大写字母/数字) */ + prefixes: string[]; + minDigits: number; + maxDigits: number; + /** 网页跳转模板,必须含 `{code}` */ + urlTemplate: string; + /** 唤起本机软件的协议模板,必须含 `{code}` */ + appUrlTemplate: string; + /** 桌面端安装包地址;留空时插件回落到 /download/version.json */ + downloadUrl: string; + updatedAt?: string | null; + /** 服务端生成:`\b(?:YT|SF|…)\d{10,16}\b`(只读) */ + pattern: string; + flags: string; +} + +/** 保存时能改的字段(version / pattern / flags / updatedAt 由服务端算) */ +export type ExtensionConfigInput = Omit; + +/** 读当前配置 */ +export function fetchExtensionConfig(): Promise { + return api.get('/api/web/admin/extension'); +} + +/** 保存配置(成功后 version +1,插件下次拉取即生效) */ +export function saveExtensionConfig(body: ExtensionConfigInput): Promise { + return api.put('/api/web/admin/extension', body); +} diff --git a/frontend/src/components/AppLayout.vue b/frontend/src/components/AppLayout.vue index 6c52dd9..2bd62af 100644 --- a/frontend/src/components/AppLayout.vue +++ b/frontend/src/components/AppLayout.vue @@ -13,7 +13,7 @@ import { subjectsLoaded, } from '@/composables/useSubject'; import { clearPlatformAdmin, ensurePlatformAdmin, isPlatformAdmin } from '@/composables/usePlatformAdmin'; -import { fetchInstallerVersion, formatSize, type InstallerVersion } from '@/api/download'; +import { fetchInstallerVersion, formatSize, preferredDownloadUrl, type InstallerVersion } from '@/api/download'; /** * fill = true:列表页用 —— 内容区不滚动,卡片吃掉剩余高度,只有表格内部滚动(表头吸顶、分页贴底) @@ -61,6 +61,7 @@ const platformMenus = [ { to: '/admin/subjects', label: '主体管理' }, { to: '/admin/orders', label: '订单管理' }, { to: '/admin/members', label: '管理员' }, + { to: '/admin/extension', label: '插件配置' }, ]; /** 当前主体(用于右上角展示 / 过期提示) */ @@ -85,7 +86,7 @@ const androidPkg = ref(null); function packageTitle(label: string, pkg: InstallerVersion | null): string { if (!pkg) return `${label}:还没有发布过安装包`; const parts = [ `${label} v${pkg.version || '?'}` ]; - const size = formatSize(pkg.size); + const size = formatSize(pkg.sizeExe || pkg.size); if (size) parts.push(size); if (pkg.publishedAt) parts.push(`发布 ${pkg.publishedAt.slice(0, 10)}`); parts.push('点击下载'); @@ -94,7 +95,7 @@ function packageTitle(label: string, pkg: InstallerVersion | null): string { /** 还没发布时按钮置灰、点了给个提示(不让浏览器跳到 404) */ function guardDownload(event: MouseEvent, pkg: InstallerVersion | null, label: string) { - if (pkg && pkg.downloadUrl) return; + if (preferredDownloadUrl(pkg)) return; event.preventDefault(); window.alert(`${label}还没有发布安装包,请稍后再试。`); } @@ -165,7 +166,7 @@ onMounted(() => {
import('@/views/AdminMembersView.vue'), meta: { allowNoSubject: true, platformAdmin: true }, }, + // Chrome 插件:集中维护单号前缀 / 生效站点 / 跳转模板(插件只拉取执行) + { + path: '/admin/extension', + name: 'admin-extension', + component: () => import('@/views/AdminExtensionView.vue'), + meta: { allowNoSubject: true, platformAdmin: true }, + }, // 测试页只在开发构建里存在:生产包不包含该路由,也不会产出它的 chunk ...(import.meta.env.DEV ? [{ path: '/test', name: 'test', component: () => import('@/views/TestView.vue'), meta: { adminOnly: true } } as RouteRecordRaw] diff --git a/frontend/src/views/AdminExtensionView.vue b/frontend/src/views/AdminExtensionView.vue new file mode 100644 index 0000000..de83766 --- /dev/null +++ b/frontend/src/views/AdminExtensionView.vue @@ -0,0 +1,394 @@ + + + + +