build(extension): 分发用压缩产物(esbuild minify,不混淆)
MV3 没有编译产物,桌面安装包会把插件源码装在 <安装目录>\extension,用户能直接看到
带注释的代码并随手改。这里加一层「压缩」:去注释、压空白、缩短标识符,体积 71KB → 30KB。
- backend/scripts/deploy/build-extension.cjs(新):esbuild 逐文件 minify 输出 extension/dist,
不做 bundle(importScripts('lib/rules.js') 与各处路径原样有效),无 eval/Function,
满足 MV3 的 CSP 与商店「代码可读」要求;
- publish-extension.cjs:打包/压缩包一律从 dist 取源;商店 zip 改用自写的
zip-util.cjs —— PowerShell 5.1 的 Compress-Archive 会把条目名写成 `src\x.js`,
8.3 短路径下还会多出前导 `/`,商店会当成怪文件名;
- desktop csproj 改为打 ..\extension\dist\**,installer/build.ps1 在 dotnet publish 前
自动跑一次 bundle(找不到 node/esbuild 明确报错,避免打进上次的旧 dist);
- extension:rules.js 的兜底 urlTemplate/fallback 从 localhost:7301 改为线上站点
(和服务端默认值保持一致),版本 1.1.2;
- backend 增加 esbuild devDependency 与 npm run extension:bundle;文档同步。
验证:5 个 js 全部 node --check 通过;dist 里 manifest 引用的 14 个文件都在;
Chrome --pack-extension 成功(扩展 ID 不变);zip 条目全部是标准 `/` 且 manifest.json 在根目录、
可正常解压;desktop Debug 编译 0 警告 0 错误,输出目录里是指向 dist 的压缩版(无 keys/README/test)。
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
This commit is contained in:
parent
6e52f82cde
commit
6818da707e
2
.gitignore
vendored
2
.gitignore
vendored
@ -96,5 +96,7 @@ video_split/
|
||||
|
||||
# Chrome 插件打包产物(.crx / updates.xml,由 npm run extension:build 生成)
|
||||
extension/out/
|
||||
# Chrome 插件的压缩产物(npm run extension:bundle 生成,桌面安装包与 CRX 都用它)
|
||||
extension/dist/
|
||||
# 注意:extension/keys/key.pem **是入库的**(决定扩展 ID,丢了就换 ID)。
|
||||
# 它绝不能随安装包发给客户 —— desktop/YuncangTrace.LocalService.csproj 已显式排除 keys\ 与 out\。
|
||||
|
||||
@ -340,11 +340,17 @@ npm run desktop:publish -- --target=Msi # 只出 MSI(不发 EXE)
|
||||
|
||||
```bash
|
||||
cd backend
|
||||
npm run extension:build # 只打包(dry-run),产物在 extension/out
|
||||
npm run extension:publish # 打包 + 上传 + 刷新 nginx
|
||||
npm run extension:bundle # 只压缩源码 → extension/dist(esbuild,体积约 1/3)
|
||||
npm run extension:build # 压缩 + 打包(dry-run),产物在 extension/out
|
||||
npm run extension:publish # 压缩 + 打包 + 上传 + 刷新 nginx
|
||||
npm run extension:zip # 压缩 + 出商店上传包(extension/out/*.zip)
|
||||
npm run extension:publish -- --version=1.2.0 --skip-nginx
|
||||
```
|
||||
|
||||
- **打进去的是 `extension/dist`(压缩产物)**,不是源码:`build-extension.cjs` 用 esbuild 逐文件 minify
|
||||
(不合并文件,`importScripts('lib/rules.js')` 与各处路径原样有效);桌面端 `build.ps1` 在
|
||||
`dotnet publish` 前也会自动跑一遍,csproj 打的同样是 `dist`;
|
||||
- 只做 minify、不做混淆:MV3 的 CSP 禁止 `eval`/`new Function`,Chrome/Edge 商店也要求代码可读;
|
||||
- 用本机 Chrome/Edge 的 `--pack-extension` 打包(找不到浏览器时用 `--browser=<路径>` 指定);
|
||||
- 产物:`YuncangTraceExtension-<version>.crx`、`updates.xml`、`extension-id.txt`;
|
||||
- 上传到 `deployRoot/download/extension/`;nginx 对 **`updates.xml` 关缓存**(浏览器靠它自动升级),
|
||||
|
||||
487
backend/package-lock.json
generated
487
backend/package-lock.json
generated
@ -24,7 +24,8 @@
|
||||
},
|
||||
"devDependencies": {
|
||||
"egg-bin": "^6.13.0",
|
||||
"egg-mock": "^5.15.2"
|
||||
"egg-mock": "^5.15.2",
|
||||
"esbuild": "^0.28.2"
|
||||
},
|
||||
"engines": {
|
||||
"node": ">=18.0.0"
|
||||
@ -205,6 +206,448 @@
|
||||
"dev": true,
|
||||
"license": "MIT"
|
||||
},
|
||||
"node_modules/@esbuild/aix-ppc64": {
|
||||
"version": "0.28.2",
|
||||
"resolved": "https://registry.npmjs.org/@esbuild/aix-ppc64/-/aix-ppc64-0.28.2.tgz",
|
||||
"integrity": "sha512-XExcO+dvLKvVtNTibSTBej1NCAbaGhWn9Ww1ZPx80qsahhPFe/8jgWP0IchNe0F3HwkU7n8ejhH8bjonqht8mQ==",
|
||||
"cpu": [
|
||||
"ppc64"
|
||||
],
|
||||
"dev": true,
|
||||
"license": "MIT",
|
||||
"optional": true,
|
||||
"os": [
|
||||
"aix"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">=18"
|
||||
}
|
||||
},
|
||||
"node_modules/@esbuild/android-arm": {
|
||||
"version": "0.28.2",
|
||||
"resolved": "https://registry.npmjs.org/@esbuild/android-arm/-/android-arm-0.28.2.tgz",
|
||||
"integrity": "sha512-kXXoiPVVGQcnIYGOeaovwOURpniDBpSq4A03qkQ+BMQqtGG6HYap3xne9C1O1yo4TR3qxlCX5IqqmX6fFo2Lqg==",
|
||||
"cpu": [
|
||||
"arm"
|
||||
],
|
||||
"dev": true,
|
||||
"license": "MIT",
|
||||
"optional": true,
|
||||
"os": [
|
||||
"android"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">=18"
|
||||
}
|
||||
},
|
||||
"node_modules/@esbuild/android-arm64": {
|
||||
"version": "0.28.2",
|
||||
"resolved": "https://registry.npmjs.org/@esbuild/android-arm64/-/android-arm64-0.28.2.tgz",
|
||||
"integrity": "sha512-5YfKeeI8qWfBZIX+u2xZC3Zlb3Os/gLS2sbEKM+I4ZOcsWmHS2WLysCcQZDAFRslDUU5Oiq44gf6PYN1vGwG5A==",
|
||||
"cpu": [
|
||||
"arm64"
|
||||
],
|
||||
"dev": true,
|
||||
"license": "MIT",
|
||||
"optional": true,
|
||||
"os": [
|
||||
"android"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">=18"
|
||||
}
|
||||
},
|
||||
"node_modules/@esbuild/android-x64": {
|
||||
"version": "0.28.2",
|
||||
"resolved": "https://registry.npmjs.org/@esbuild/android-x64/-/android-x64-0.28.2.tgz",
|
||||
"integrity": "sha512-O387ite7SzUyCcy3JQX4P4bLtEA7bLLkx+esve5JHnyYfNTxcVpXZo9jhdB0lTKN44gztELTdU7nS8Nr16Fs1Q==",
|
||||
"cpu": [
|
||||
"x64"
|
||||
],
|
||||
"dev": true,
|
||||
"license": "MIT",
|
||||
"optional": true,
|
||||
"os": [
|
||||
"android"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">=18"
|
||||
}
|
||||
},
|
||||
"node_modules/@esbuild/darwin-arm64": {
|
||||
"version": "0.28.2",
|
||||
"resolved": "https://registry.npmjs.org/@esbuild/darwin-arm64/-/darwin-arm64-0.28.2.tgz",
|
||||
"integrity": "sha512-n4KqkOQrraxHJcgjM1RvwbigfQKIKJVpM7xp+KsxiyUSrRdIXnt73VhrPAx0fV44hgfmIVKjxMN9J1t5jySVkw==",
|
||||
"cpu": [
|
||||
"arm64"
|
||||
],
|
||||
"dev": true,
|
||||
"license": "MIT",
|
||||
"optional": true,
|
||||
"os": [
|
||||
"darwin"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">=18"
|
||||
}
|
||||
},
|
||||
"node_modules/@esbuild/darwin-x64": {
|
||||
"version": "0.28.2",
|
||||
"resolved": "https://registry.npmjs.org/@esbuild/darwin-x64/-/darwin-x64-0.28.2.tgz",
|
||||
"integrity": "sha512-uq6suIWYP37qzGddBKPw5QEQPi6HiLGsO7UmkpfyaYNQ3D+rN6w6WfwH+nuqcGXWvawGwxOEroO4YGnFh95azw==",
|
||||
"cpu": [
|
||||
"x64"
|
||||
],
|
||||
"dev": true,
|
||||
"license": "MIT",
|
||||
"optional": true,
|
||||
"os": [
|
||||
"darwin"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">=18"
|
||||
}
|
||||
},
|
||||
"node_modules/@esbuild/freebsd-arm64": {
|
||||
"version": "0.28.2",
|
||||
"resolved": "https://registry.npmjs.org/@esbuild/freebsd-arm64/-/freebsd-arm64-0.28.2.tgz",
|
||||
"integrity": "sha512-n+I0BTSRIoy+d6RPKnEVwql5UwBJolytvY4mAOIEJorKlqgPII8ix6slVVrfZ5Tnj7glIZvloylbB/EJPMWEXw==",
|
||||
"cpu": [
|
||||
"arm64"
|
||||
],
|
||||
"dev": true,
|
||||
"license": "MIT",
|
||||
"optional": true,
|
||||
"os": [
|
||||
"freebsd"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">=18"
|
||||
}
|
||||
},
|
||||
"node_modules/@esbuild/freebsd-x64": {
|
||||
"version": "0.28.2",
|
||||
"resolved": "https://registry.npmjs.org/@esbuild/freebsd-x64/-/freebsd-x64-0.28.2.tgz",
|
||||
"integrity": "sha512-78XJTJkvPs0kz2w61301PJjXl4g7q3JqiYMZ/M/yVI73EHBrCRTgkhu9oqG7vPqq+a/yadEW8aD+agKlk5xrmg==",
|
||||
"cpu": [
|
||||
"x64"
|
||||
],
|
||||
"dev": true,
|
||||
"license": "MIT",
|
||||
"optional": true,
|
||||
"os": [
|
||||
"freebsd"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">=18"
|
||||
}
|
||||
},
|
||||
"node_modules/@esbuild/linux-arm": {
|
||||
"version": "0.28.2",
|
||||
"resolved": "https://registry.npmjs.org/@esbuild/linux-arm/-/linux-arm-0.28.2.tgz",
|
||||
"integrity": "sha512-XlDnu2q5yoqems+xay6wSAcg9DDD7K9RLKZEBOMZm3ckNpJBvOX20tSfby8KfrrhINDyv9V2YVZKY/SpoGJI8w==",
|
||||
"cpu": [
|
||||
"arm"
|
||||
],
|
||||
"dev": true,
|
||||
"license": "MIT",
|
||||
"optional": true,
|
||||
"os": [
|
||||
"linux"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">=18"
|
||||
}
|
||||
},
|
||||
"node_modules/@esbuild/linux-arm64": {
|
||||
"version": "0.28.2",
|
||||
"resolved": "https://registry.npmjs.org/@esbuild/linux-arm64/-/linux-arm64-0.28.2.tgz",
|
||||
"integrity": "sha512-pW4AC0P3it8c7do9MVM4p51FzHzdM/TZrerurgRcHJ2WTa1VQ1CIq18xncfpBJw4ojkiZZrKW2yIBWBP92j6Ug==",
|
||||
"cpu": [
|
||||
"arm64"
|
||||
],
|
||||
"dev": true,
|
||||
"license": "MIT",
|
||||
"optional": true,
|
||||
"os": [
|
||||
"linux"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">=18"
|
||||
}
|
||||
},
|
||||
"node_modules/@esbuild/linux-ia32": {
|
||||
"version": "0.28.2",
|
||||
"resolved": "https://registry.npmjs.org/@esbuild/linux-ia32/-/linux-ia32-0.28.2.tgz",
|
||||
"integrity": "sha512-CYbnj78HsIeA+DhgUKgFCfvNsTHFhMMrinUrMZpDXJXKN8T3XViTZ/+wtHeVxEWY8ewSzTFN+nRmSwO2tZaLUQ==",
|
||||
"cpu": [
|
||||
"ia32"
|
||||
],
|
||||
"dev": true,
|
||||
"license": "MIT",
|
||||
"optional": true,
|
||||
"os": [
|
||||
"linux"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">=18"
|
||||
}
|
||||
},
|
||||
"node_modules/@esbuild/linux-loong64": {
|
||||
"version": "0.28.2",
|
||||
"resolved": "https://registry.npmjs.org/@esbuild/linux-loong64/-/linux-loong64-0.28.2.tgz",
|
||||
"integrity": "sha512-buwkd8nsph4R+ajRvw0qM5Hja/TXQow3ptzWO2EbG/cqcIkHloRrdlBtQlshyYGTNFvfkfJ5tpPLVkY4DtsPfQ==",
|
||||
"cpu": [
|
||||
"loong64"
|
||||
],
|
||||
"dev": true,
|
||||
"license": "MIT",
|
||||
"optional": true,
|
||||
"os": [
|
||||
"linux"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">=18"
|
||||
}
|
||||
},
|
||||
"node_modules/@esbuild/linux-mips64el": {
|
||||
"version": "0.28.2",
|
||||
"resolved": "https://registry.npmjs.org/@esbuild/linux-mips64el/-/linux-mips64el-0.28.2.tgz",
|
||||
"integrity": "sha512-ZVykbDyk7519VwiNb9Lcj9m8XM6v5V9uKPvrEMkkEedVewf+0itkhahp4HDpgERXhwLRpWFypsGbG/J8s0QjJA==",
|
||||
"cpu": [
|
||||
"mips64el"
|
||||
],
|
||||
"dev": true,
|
||||
"license": "MIT",
|
||||
"optional": true,
|
||||
"os": [
|
||||
"linux"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">=18"
|
||||
}
|
||||
},
|
||||
"node_modules/@esbuild/linux-ppc64": {
|
||||
"version": "0.28.2",
|
||||
"resolved": "https://registry.npmjs.org/@esbuild/linux-ppc64/-/linux-ppc64-0.28.2.tgz",
|
||||
"integrity": "sha512-CAXl+Dtd9UUuJd8pKKdwh6MLm3MUMiqMPmhZ3tTSXPqfyQ3vDl6R5hZdZ/kYojK4ofXtdfSv1tFq8XzWx3heNQ==",
|
||||
"cpu": [
|
||||
"ppc64"
|
||||
],
|
||||
"dev": true,
|
||||
"license": "MIT",
|
||||
"optional": true,
|
||||
"os": [
|
||||
"linux"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">=18"
|
||||
}
|
||||
},
|
||||
"node_modules/@esbuild/linux-riscv64": {
|
||||
"version": "0.28.2",
|
||||
"resolved": "https://registry.npmjs.org/@esbuild/linux-riscv64/-/linux-riscv64-0.28.2.tgz",
|
||||
"integrity": "sha512-GeXCej4IQtU1B+QlDV8W/RRvbzI3O/Stss+/bCXv4lZls5WGRtu2a+3JkA3i4qIUlMXpcHebWpF8AkJhATowuA==",
|
||||
"cpu": [
|
||||
"riscv64"
|
||||
],
|
||||
"dev": true,
|
||||
"license": "MIT",
|
||||
"optional": true,
|
||||
"os": [
|
||||
"linux"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">=18"
|
||||
}
|
||||
},
|
||||
"node_modules/@esbuild/linux-s390x": {
|
||||
"version": "0.28.2",
|
||||
"resolved": "https://registry.npmjs.org/@esbuild/linux-s390x/-/linux-s390x-0.28.2.tgz",
|
||||
"integrity": "sha512-3H1weTYZPxt/WOhByszQZybS9w5lKzUn1FDMsgEChbHWQwHYQQRfBxgCcZvPhjHfKyJjIievvMmEUawJrdY9Dg==",
|
||||
"cpu": [
|
||||
"s390x"
|
||||
],
|
||||
"dev": true,
|
||||
"license": "MIT",
|
||||
"optional": true,
|
||||
"os": [
|
||||
"linux"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">=18"
|
||||
}
|
||||
},
|
||||
"node_modules/@esbuild/linux-x64": {
|
||||
"version": "0.28.2",
|
||||
"resolved": "https://registry.npmjs.org/@esbuild/linux-x64/-/linux-x64-0.28.2.tgz",
|
||||
"integrity": "sha512-4xTZr1FUmSoQW4XIWmit3tzQrUTZM+N3P0XV8xROKYF50XfI7xeO90+1bZvNwxIufQ9hDQVRJH5YhgPVF8A/HQ==",
|
||||
"cpu": [
|
||||
"x64"
|
||||
],
|
||||
"dev": true,
|
||||
"license": "MIT",
|
||||
"optional": true,
|
||||
"os": [
|
||||
"linux"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">=18"
|
||||
}
|
||||
},
|
||||
"node_modules/@esbuild/netbsd-arm64": {
|
||||
"version": "0.28.2",
|
||||
"resolved": "https://registry.npmjs.org/@esbuild/netbsd-arm64/-/netbsd-arm64-0.28.2.tgz",
|
||||
"integrity": "sha512-sSATRjPeDBg3pdgHoQfoYBob11Kk1FGa9lui5RIHZCoCkJa9QKlvl3/vKz2usCmYYjs7ymJR/2Nnsqe+Hjt5nw==",
|
||||
"cpu": [
|
||||
"arm64"
|
||||
],
|
||||
"dev": true,
|
||||
"license": "MIT",
|
||||
"optional": true,
|
||||
"os": [
|
||||
"netbsd"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">=18"
|
||||
}
|
||||
},
|
||||
"node_modules/@esbuild/netbsd-x64": {
|
||||
"version": "0.28.2",
|
||||
"resolved": "https://registry.npmjs.org/@esbuild/netbsd-x64/-/netbsd-x64-0.28.2.tgz",
|
||||
"integrity": "sha512-lqnzCV+mM0gIADaKihiCg6ifgfU2L3h5E33rNQBN1Y4MaVGnzryzmvvf7UHxprpQdE8hpqLolJ9Rl+SkIRDpyw==",
|
||||
"cpu": [
|
||||
"x64"
|
||||
],
|
||||
"dev": true,
|
||||
"license": "MIT",
|
||||
"optional": true,
|
||||
"os": [
|
||||
"netbsd"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">=18"
|
||||
}
|
||||
},
|
||||
"node_modules/@esbuild/openbsd-arm64": {
|
||||
"version": "0.28.2",
|
||||
"resolved": "https://registry.npmjs.org/@esbuild/openbsd-arm64/-/openbsd-arm64-0.28.2.tgz",
|
||||
"integrity": "sha512-AL2qJILH7lNjrDmCQDvdxMfAUIv8KMNZOvrwAQ8i8//ntL9FflhOyMJ8OZSMBb8/AWXe3/5v5S20y3zCoZWKoQ==",
|
||||
"cpu": [
|
||||
"arm64"
|
||||
],
|
||||
"dev": true,
|
||||
"license": "MIT",
|
||||
"optional": true,
|
||||
"os": [
|
||||
"openbsd"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">=18"
|
||||
}
|
||||
},
|
||||
"node_modules/@esbuild/openbsd-x64": {
|
||||
"version": "0.28.2",
|
||||
"resolved": "https://registry.npmjs.org/@esbuild/openbsd-x64/-/openbsd-x64-0.28.2.tgz",
|
||||
"integrity": "sha512-QtiuPytchRyC4rwUKhexJdQKvDuZ6hWloi3igqPQNUJCS1/v9EiO3UTOXR6A3FoMo4fnAKbWJdqaIwhOzh8qEw==",
|
||||
"cpu": [
|
||||
"x64"
|
||||
],
|
||||
"dev": true,
|
||||
"license": "MIT",
|
||||
"optional": true,
|
||||
"os": [
|
||||
"openbsd"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">=18"
|
||||
}
|
||||
},
|
||||
"node_modules/@esbuild/openharmony-arm64": {
|
||||
"version": "0.28.2",
|
||||
"resolved": "https://registry.npmjs.org/@esbuild/openharmony-arm64/-/openharmony-arm64-0.28.2.tgz",
|
||||
"integrity": "sha512-WkhYDmpTjLvGlScA1rwjRUmhl4k8oXR3cIbtqWmELgU/dFeHHlEllxDvdWcNJV9rbzCexB5vz8gtNewWLgCT7Q==",
|
||||
"cpu": [
|
||||
"arm64"
|
||||
],
|
||||
"dev": true,
|
||||
"license": "MIT",
|
||||
"optional": true,
|
||||
"os": [
|
||||
"openharmony"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">=18"
|
||||
}
|
||||
},
|
||||
"node_modules/@esbuild/sunos-x64": {
|
||||
"version": "0.28.2",
|
||||
"resolved": "https://registry.npmjs.org/@esbuild/sunos-x64/-/sunos-x64-0.28.2.tgz",
|
||||
"integrity": "sha512-GPMSkTOtMnv2U2F8gxe4Io6qmVs+YKyp832Etqqxr0hFngmXQ3rzwytelm3GIn7T4VviRUlf3sOgBOiTdvaf7g==",
|
||||
"cpu": [
|
||||
"x64"
|
||||
],
|
||||
"dev": true,
|
||||
"license": "MIT",
|
||||
"optional": true,
|
||||
"os": [
|
||||
"sunos"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">=18"
|
||||
}
|
||||
},
|
||||
"node_modules/@esbuild/win32-arm64": {
|
||||
"version": "0.28.2",
|
||||
"resolved": "https://registry.npmjs.org/@esbuild/win32-arm64/-/win32-arm64-0.28.2.tgz",
|
||||
"integrity": "sha512-PIhhEkE9uPBleRBrQEJpUn7MBnibZzbGzYWPmY3x+YoVg/95zbjB4CxPPOQ8l5tYYM4mMaCthF8/1DIfBQQyWQ==",
|
||||
"cpu": [
|
||||
"arm64"
|
||||
],
|
||||
"dev": true,
|
||||
"license": "MIT",
|
||||
"optional": true,
|
||||
"os": [
|
||||
"win32"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">=18"
|
||||
}
|
||||
},
|
||||
"node_modules/@esbuild/win32-ia32": {
|
||||
"version": "0.28.2",
|
||||
"resolved": "https://registry.npmjs.org/@esbuild/win32-ia32/-/win32-ia32-0.28.2.tgz",
|
||||
"integrity": "sha512-YmJbfTlvU7Sdn9BB+4PRES4oB6pxgS37MAONj+hBr/cpXS1aBPKXxNnDbu+QCWPj0o9dgyxeq79g6c5P8KeuYA==",
|
||||
"cpu": [
|
||||
"ia32"
|
||||
],
|
||||
"dev": true,
|
||||
"license": "MIT",
|
||||
"optional": true,
|
||||
"os": [
|
||||
"win32"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">=18"
|
||||
}
|
||||
},
|
||||
"node_modules/@esbuild/win32-x64": {
|
||||
"version": "0.28.2",
|
||||
"resolved": "https://registry.npmjs.org/@esbuild/win32-x64/-/win32-x64-0.28.2.tgz",
|
||||
"integrity": "sha512-5ebpxr3nWMzrL/rnUI755Jkuee0bHL/Gq0WTF9lvcpv73wAp5eu8MfBUgWK9bhWvZjj7yX8etf/8tI8Ney695g==",
|
||||
"cpu": [
|
||||
"x64"
|
||||
],
|
||||
"dev": true,
|
||||
"license": "MIT",
|
||||
"optional": true,
|
||||
"os": [
|
||||
"win32"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">=18"
|
||||
}
|
||||
},
|
||||
"node_modules/@fastify/busboy": {
|
||||
"version": "2.1.1",
|
||||
"resolved": "https://registry.npmjs.org/@fastify/busboy/-/busboy-2.1.1.tgz",
|
||||
@ -4169,6 +4612,48 @@
|
||||
"node": ">= 0.4"
|
||||
}
|
||||
},
|
||||
"node_modules/esbuild": {
|
||||
"version": "0.28.2",
|
||||
"resolved": "https://registry.npmjs.org/esbuild/-/esbuild-0.28.2.tgz",
|
||||
"integrity": "sha512-HKVLS8dvII+xoKW9kmqxbRKrnWEXfJJr/FZhhJmiqIB0e053QNYFqOBouTMO/k5sID4MvCiUCvv8b9M4h32wIA==",
|
||||
"dev": true,
|
||||
"hasInstallScript": true,
|
||||
"license": "MIT",
|
||||
"bin": {
|
||||
"esbuild": "bin/esbuild"
|
||||
},
|
||||
"engines": {
|
||||
"node": ">=18"
|
||||
},
|
||||
"optionalDependencies": {
|
||||
"@esbuild/aix-ppc64": "0.28.2",
|
||||
"@esbuild/android-arm": "0.28.2",
|
||||
"@esbuild/android-arm64": "0.28.2",
|
||||
"@esbuild/android-x64": "0.28.2",
|
||||
"@esbuild/darwin-arm64": "0.28.2",
|
||||
"@esbuild/darwin-x64": "0.28.2",
|
||||
"@esbuild/freebsd-arm64": "0.28.2",
|
||||
"@esbuild/freebsd-x64": "0.28.2",
|
||||
"@esbuild/linux-arm": "0.28.2",
|
||||
"@esbuild/linux-arm64": "0.28.2",
|
||||
"@esbuild/linux-ia32": "0.28.2",
|
||||
"@esbuild/linux-loong64": "0.28.2",
|
||||
"@esbuild/linux-mips64el": "0.28.2",
|
||||
"@esbuild/linux-ppc64": "0.28.2",
|
||||
"@esbuild/linux-riscv64": "0.28.2",
|
||||
"@esbuild/linux-s390x": "0.28.2",
|
||||
"@esbuild/linux-x64": "0.28.2",
|
||||
"@esbuild/netbsd-arm64": "0.28.2",
|
||||
"@esbuild/netbsd-x64": "0.28.2",
|
||||
"@esbuild/openbsd-arm64": "0.28.2",
|
||||
"@esbuild/openbsd-x64": "0.28.2",
|
||||
"@esbuild/openharmony-arm64": "0.28.2",
|
||||
"@esbuild/sunos-x64": "0.28.2",
|
||||
"@esbuild/win32-arm64": "0.28.2",
|
||||
"@esbuild/win32-ia32": "0.28.2",
|
||||
"@esbuild/win32-x64": "0.28.2"
|
||||
}
|
||||
},
|
||||
"node_modules/escalade": {
|
||||
"version": "3.2.0",
|
||||
"resolved": "https://registry.npmjs.org/escalade/-/escalade-3.2.0.tgz",
|
||||
|
||||
@ -23,7 +23,8 @@
|
||||
},
|
||||
"devDependencies": {
|
||||
"egg-bin": "^6.13.0",
|
||||
"egg-mock": "^5.15.2"
|
||||
"egg-mock": "^5.15.2",
|
||||
"esbuild": "^0.28.2"
|
||||
},
|
||||
"engines": {
|
||||
"node": ">=18.0.0"
|
||||
@ -62,6 +63,7 @@
|
||||
"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:bundle": "node ./scripts/deploy/build-extension.cjs",
|
||||
"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",
|
||||
|
||||
148
backend/scripts/deploy/build-extension.cjs
Normal file
148
backend/scripts/deploy/build-extension.cjs
Normal file
@ -0,0 +1,148 @@
|
||||
'use strict';
|
||||
|
||||
/**
|
||||
* 打包 Chrome 插件到 `extension/dist`(**只压缩,不混淆**)
|
||||
*
|
||||
* 为什么要这一步:
|
||||
* - MV3 没有编译产物,浏览器直接执行明文 JS;桌面安装包把 `extension/` 整个装在
|
||||
* `<安装目录>\extension`,用户打开就能看到带注释的源码,也能随手改掉跳转地址;
|
||||
* - 压缩(去注释、压空白、合并冗余)后体积约为源码的 1/3,逆向和篡改成本明显上升,
|
||||
* 而且**不需要** eval / Function(MV3 的 CSP 禁止),符合 Chrome 商店「代码必须可读」的要求;
|
||||
* - 真正需要保密的东西不在这里:识别前缀 / 正则 / 生效站点全部由服务端下发,
|
||||
* 扩展 ID 的私钥 `extension/keys/key.pem` 也从不进包(见 csproj 的 Exclude)。
|
||||
*
|
||||
* 产物目录结构**与源码一致**(manifest 里的路径不用改):
|
||||
* dist/manifest.json 原样拷贝
|
||||
* dist/icons/… 原样拷贝
|
||||
* dist/src/… 的 .js 文件 esbuild 压缩
|
||||
* dist/src/… 的 .html / .css 原样拷贝(HTML 里引用的 js 路径不变)
|
||||
*
|
||||
* ⚠️ `background.js` 用 `importScripts('lib/rules.js')`、`content_scripts` 也各自按路径加载,
|
||||
* 所以这里**不做 bundle**(不合并文件),只逐文件压缩 —— 语义零变化。
|
||||
*
|
||||
* 用法:
|
||||
* node scripts/deploy/build-extension.cjs
|
||||
* npm run extension:bundle
|
||||
*/
|
||||
|
||||
const fs = require('node:fs');
|
||||
const path = require('node:path');
|
||||
|
||||
let esbuild;
|
||||
try {
|
||||
// devDependency:只在开发和发版机器上装(服务器跑的是已构建产物,不需要)
|
||||
esbuild = require('esbuild');
|
||||
} catch {
|
||||
throw new Error('缺少 esbuild:先执行 `cd backend && npm install`(它是 devDependency,压缩插件要用)');
|
||||
}
|
||||
|
||||
const ROOT = __dirname;
|
||||
const REPO_ROOT = path.resolve(ROOT, '..', '..', '..');
|
||||
const EXT_DIR = path.join(REPO_ROOT, 'extension');
|
||||
const OUT_DIR = path.join(EXT_DIR, 'dist');
|
||||
|
||||
/** 进包的内容(README / test / tools / keys / out / dist 自身都不进) */
|
||||
const INCLUDE = [ 'manifest.json', 'icons', 'src' ];
|
||||
|
||||
/** manifest 里声明的最低 Chrome 版本,压缩目标跟着它走 */
|
||||
const JS_TARGET = 'chrome96';
|
||||
|
||||
/** 递归列出目录下所有文件 */
|
||||
function walk(dir, files = []) {
|
||||
for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
|
||||
const full = path.join(dir, entry.name);
|
||||
if (entry.isDirectory()) {
|
||||
walk(full, files);
|
||||
} else if (entry.isFile()) {
|
||||
files.push(full);
|
||||
}
|
||||
}
|
||||
return files;
|
||||
}
|
||||
|
||||
/** 压缩单个 js 文件 */
|
||||
async function minifyJs(from, to) {
|
||||
const source = fs.readFileSync(from, 'utf8');
|
||||
const result = await esbuild.transform(source, {
|
||||
loader: 'js',
|
||||
target: JS_TARGET,
|
||||
minify: true,
|
||||
// 保留 'use strict' 等语义;去掉 @license 之类注释(我们的注释都是给人看的)
|
||||
legalComments: 'none',
|
||||
// 中文提示语保持原样(默认会转成 \uXXXX,体积更大)
|
||||
charset: 'utf8',
|
||||
});
|
||||
|
||||
fs.writeFileSync(to, result.code);
|
||||
return { bytesBefore: Buffer.byteLength(source), bytesAfter: Buffer.byteLength(result.code) };
|
||||
}
|
||||
|
||||
/**
|
||||
* 生成 dist
|
||||
* @param {{ log?: boolean }} [options]
|
||||
* @returns {Promise<Array<{ file: string, bytesBefore: number, bytesAfter: number }>>}
|
||||
*/
|
||||
async function build(options = {}) {
|
||||
const log = options.log !== false;
|
||||
|
||||
if (!fs.existsSync(path.join(EXT_DIR, 'manifest.json'))) {
|
||||
throw new Error(`找不到扩展源码目录:${EXT_DIR}`);
|
||||
}
|
||||
|
||||
fs.rmSync(OUT_DIR, { recursive: true, force: true });
|
||||
fs.mkdirSync(OUT_DIR, { recursive: true });
|
||||
|
||||
const stats = [];
|
||||
|
||||
for (const item of INCLUDE) {
|
||||
const source = path.join(EXT_DIR, item);
|
||||
if (!fs.existsSync(source)) {
|
||||
throw new Error(`扩展缺少 ${item}:${source}`);
|
||||
}
|
||||
|
||||
if (!fs.statSync(source).isDirectory()) {
|
||||
fs.copyFileSync(source, path.join(OUT_DIR, item));
|
||||
continue;
|
||||
}
|
||||
|
||||
for (const file of walk(source)) {
|
||||
const relative = path.relative(EXT_DIR, file);
|
||||
const target = path.join(OUT_DIR, relative);
|
||||
fs.mkdirSync(path.dirname(target), { recursive: true });
|
||||
|
||||
if (path.extname(file).toLowerCase() === '.js') {
|
||||
const result = await minifyJs(file, target);
|
||||
stats.push({ file: relative.replace(/\\/g, '/'), ...result });
|
||||
} else {
|
||||
fs.copyFileSync(file, target);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
if (log) {
|
||||
const pad = Math.max(...stats.map(item => item.file.length), 8);
|
||||
let before = 0;
|
||||
let after = 0;
|
||||
for (const item of stats) {
|
||||
before += item.bytesBefore;
|
||||
after += item.bytesAfter;
|
||||
console.log(
|
||||
` ${item.file.padEnd(pad)} ${(item.bytesBefore / 1024).toFixed(1).padStart(6)} KB → ` +
|
||||
`${(item.bytesAfter / 1024).toFixed(1).padStart(5)} KB`,
|
||||
);
|
||||
}
|
||||
console.log(` ${'合计'.padEnd(pad)} ${(before / 1024).toFixed(1).padStart(6)} KB → ${(after / 1024).toFixed(1).padStart(5)} KB`);
|
||||
console.log(`插件已打包: ${path.relative(REPO_ROOT, OUT_DIR)}(${INCLUDE.join(' / ')})`);
|
||||
}
|
||||
|
||||
return stats;
|
||||
}
|
||||
|
||||
module.exports = { build, EXT_DIR, OUT_DIR, INCLUDE };
|
||||
|
||||
if (require.main === module) {
|
||||
build().catch(err => {
|
||||
console.error(`打包插件失败:${err.message}`);
|
||||
process.exit(1);
|
||||
});
|
||||
}
|
||||
@ -42,15 +42,19 @@ const {
|
||||
runScp,
|
||||
runSsh,
|
||||
} = require('./deploy-lib.cjs');
|
||||
const { build: buildExtension } = require('./build-extension.cjs');
|
||||
const { zipDirectory } = require('./zip-util.cjs');
|
||||
|
||||
/** 仓库根(backend 的上一级) */
|
||||
const REPO_ROOT = path.resolve(ROOT, '..');
|
||||
const EXT_DIR = path.join(REPO_ROOT, 'extension');
|
||||
/** 正式包一律用压缩后的产物(`npm run extension:bundle` 生成,体积约为源码 1/3) */
|
||||
const DIST_DIR = path.join(EXT_DIR, 'dist');
|
||||
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 不进包) */
|
||||
/** 打进 crx 的内容(其余 README/test/tools/out/keys/dist 不进包) */
|
||||
const INCLUDE = [ 'manifest.json', 'icons', 'src' ];
|
||||
|
||||
function parseArgs(argv) {
|
||||
@ -127,8 +131,8 @@ 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}`);
|
||||
const from = path.join(DIST_DIR, name);
|
||||
if (!fs.existsSync(from)) throw new Error(`插件打包产物缺少:${from}(先跑 npm run extension:bundle)`);
|
||||
fs.cpSync(from, path.join(target, name), { recursive: true });
|
||||
}
|
||||
return target;
|
||||
@ -204,7 +208,7 @@ function uploadFile(config, localPath, remoteDir, name, stamp) {
|
||||
].join('\n'));
|
||||
}
|
||||
|
||||
function main() {
|
||||
async function main() {
|
||||
const options = parseArgs(process.argv.slice(2));
|
||||
const config = loadDeployConfig(options.envName);
|
||||
|
||||
@ -222,7 +226,8 @@ function main() {
|
||||
// 打包在临时目录里做,仓库里只留 out/ 产物
|
||||
const workDir = fs.mkdtempSync(path.join(os.tmpdir(), 'yuncang-ext-'));
|
||||
try {
|
||||
console.log(`打包 Chrome 插件 ${version}(${path.relative(REPO_ROOT, EXT_DIR)})`);
|
||||
console.log(`打包 Chrome 插件 ${version}(${path.relative(REPO_ROOT, DIST_DIR)},已压缩)`);
|
||||
await buildExtension({ log: true });
|
||||
const srcDir = stageSources(workDir);
|
||||
|
||||
// 商店上传用的是 zip(manifest.json 必须在压缩包根目录)
|
||||
@ -231,10 +236,11 @@ function main() {
|
||||
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' });
|
||||
// 条目名一律 `/`(PowerShell 的 Compress-Archive 会写反斜杠,商店不认)
|
||||
const result = zipDirectory(srcDir, zipPath);
|
||||
|
||||
console.log(`商店上传包: ${zipPath}(${result.files} 个文件,${(result.bytes / 1024).toFixed(0)} KB)`);
|
||||
return;
|
||||
|
||||
console.log(`商店上传包: ${zipPath}(${(fs.statSync(zipPath).size / 1024).toFixed(0)} KB)`);
|
||||
return;
|
||||
@ -289,4 +295,7 @@ function main() {
|
||||
}
|
||||
}
|
||||
|
||||
main();
|
||||
main().catch(err => {
|
||||
console.error(err.message);
|
||||
process.exit(1);
|
||||
});
|
||||
|
||||
136
backend/scripts/deploy/zip-util.cjs
Normal file
136
backend/scripts/deploy/zip-util.cjs
Normal file
@ -0,0 +1,136 @@
|
||||
'use strict';
|
||||
|
||||
/**
|
||||
* 极简 ZIP 打包(deflate,无第三方依赖)
|
||||
*
|
||||
* 为什么不用 PowerShell 的 `Compress-Archive` / `ZipFile::CreateFromDirectory`:
|
||||
* - PowerShell 5.1(.NET Framework)写出来的条目名是**反斜杠**(`src\content.js`),
|
||||
* 而 ZIP 规范要求 `/`,商店上传/解压工具会把它当成带 \ 的怪文件名;
|
||||
* - 走 8.3 短路径(`C:\Users\LFMING~1\...`)时,`FullName.Substring($src.Length + 1)`
|
||||
* 算出来的相对路径还会多一个前导 `/`,manifest.json 就不在根目录了。
|
||||
*
|
||||
* 这里自己写:条目名一律 `/`、无前导斜杠、UTF-8 文件名、Deflate 压缩。
|
||||
* 只支持「单文件 < 4GB、总长 < 4GB」的普通包(插件包够用,不需要 ZIP64)。
|
||||
*/
|
||||
|
||||
const fs = require('node:fs');
|
||||
const path = require('node:path');
|
||||
const zlib = require('node:zlib');
|
||||
|
||||
const CRC_TABLE = (() => {
|
||||
const table = new Int32Array(256);
|
||||
for (let index = 0; index < 256; index++) {
|
||||
let value = index;
|
||||
for (let bit = 0; bit < 8; bit++) {
|
||||
value = value & 1 ? 0xedb88320 ^ (value >>> 1) : value >>> 1;
|
||||
}
|
||||
table[index] = value;
|
||||
}
|
||||
return table;
|
||||
})();
|
||||
|
||||
function crc32(buffer) {
|
||||
let crc = -1;
|
||||
for (let index = 0; index < buffer.length; index++) {
|
||||
crc = CRC_TABLE[(crc ^ buffer[index]) & 0xff] ^ (crc >>> 8);
|
||||
}
|
||||
return (crc ^ -1) >>> 0;
|
||||
}
|
||||
|
||||
/** 递归列出文件(返回相对路径,统一用 `/`) */
|
||||
function listFiles(dir, base = dir, files = []) {
|
||||
for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
|
||||
const full = path.join(dir, entry.name);
|
||||
if (entry.isDirectory()) {
|
||||
listFiles(full, base, files);
|
||||
} else if (entry.isFile()) {
|
||||
files.push({ full, name: path.relative(base, full).split(path.sep).join('/') });
|
||||
}
|
||||
}
|
||||
return files;
|
||||
}
|
||||
|
||||
/** 转成 DOS 时间(ZIP 头里是 1980 起的本地时间) */
|
||||
function toDosTime(date) {
|
||||
const year = Math.max(date.getFullYear(), 1980);
|
||||
return {
|
||||
time: (date.getHours() << 11) | (date.getMinutes() << 5) | (date.getSeconds() >> 1),
|
||||
date: ((year - 1980) << 9) | ((date.getMonth() + 1) << 5) | date.getDate(),
|
||||
};
|
||||
}
|
||||
|
||||
/**
|
||||
* 把目录打成 zip
|
||||
* @param {string} dir 源目录
|
||||
* @param {string} zipPath 目标 zip(不存在会自动创建父目录)
|
||||
* @returns {{ files: number, bytes: number }} 条目数与压缩包大小
|
||||
*/
|
||||
function zipDirectory(dir, zipPath) {
|
||||
const files = listFiles(dir).sort((a, b) => a.name.localeCompare(b.name));
|
||||
|
||||
const localParts = [];
|
||||
const centralParts = [];
|
||||
let offset = 0;
|
||||
|
||||
for (const file of files) {
|
||||
const data = fs.readFileSync(file.full);
|
||||
const deflated = zlib.deflateRawSync(data, { level: 9 });
|
||||
const name = Buffer.from(file.name, 'utf8');
|
||||
const crc = crc32(data);
|
||||
const { time, date } = toDosTime(fs.statSync(file.full).mtime);
|
||||
|
||||
const local = Buffer.alloc(30);
|
||||
local.writeUInt32LE(0x04034b50, 0); // 局部文件头签名
|
||||
local.writeUInt16LE(20, 4); // 解压所需版本
|
||||
local.writeUInt16LE(0x0800, 6); // 文件名 UTF-8
|
||||
local.writeUInt16LE(8, 8); // Deflate
|
||||
local.writeUInt16LE(time, 10);
|
||||
local.writeUInt16LE(date, 12);
|
||||
local.writeUInt32LE(crc, 14);
|
||||
local.writeUInt32LE(deflated.length, 18);
|
||||
local.writeUInt32LE(data.length, 22);
|
||||
local.writeUInt16LE(name.length, 26);
|
||||
local.writeUInt16LE(0, 28); // 无扩展字段
|
||||
localParts.push(local, name, deflated);
|
||||
|
||||
const central = Buffer.alloc(46);
|
||||
central.writeUInt32LE(0x02014b50, 0); // 中央目录签名
|
||||
central.writeUInt16LE(20, 4); // 打包者版本
|
||||
central.writeUInt16LE(20, 6); // 解压所需版本
|
||||
central.writeUInt16LE(0x0800, 8); // 文件名 UTF-8
|
||||
central.writeUInt16LE(8, 10); // Deflate
|
||||
central.writeUInt16LE(time, 12);
|
||||
central.writeUInt16LE(date, 14);
|
||||
central.writeUInt32LE(crc, 16);
|
||||
central.writeUInt32LE(deflated.length, 20);
|
||||
central.writeUInt32LE(data.length, 24);
|
||||
central.writeUInt16LE(name.length, 28);
|
||||
central.writeUInt16LE(0, 30); // 扩展字段长度
|
||||
central.writeUInt16LE(0, 32); // 注释长度
|
||||
central.writeUInt16LE(0, 34); // 起始磁盘号
|
||||
central.writeUInt16LE(0, 36); // 内部属性
|
||||
central.writeUInt32LE(0, 38); // 外部属性
|
||||
central.writeUInt32LE(offset, 42); // 局部头偏移
|
||||
centralParts.push(central, name);
|
||||
|
||||
offset += local.length + name.length + deflated.length;
|
||||
}
|
||||
|
||||
const centralBuffer = Buffer.concat(centralParts);
|
||||
const end = Buffer.alloc(22);
|
||||
end.writeUInt32LE(0x06054b50, 0); // 目录结束签名
|
||||
end.writeUInt16LE(0, 4); // 本磁盘号
|
||||
end.writeUInt16LE(0, 6); // 中央目录起始磁盘
|
||||
end.writeUInt16LE(files.length, 8);
|
||||
end.writeUInt16LE(files.length, 10);
|
||||
end.writeUInt32LE(centralBuffer.length, 12);
|
||||
end.writeUInt32LE(offset, 16);
|
||||
end.writeUInt16LE(0, 20); // 注释长度
|
||||
|
||||
fs.mkdirSync(path.dirname(zipPath), { recursive: true });
|
||||
fs.writeFileSync(zipPath, Buffer.concat([ ...localParts, centralBuffer, end ]));
|
||||
|
||||
return { files: files.length, bytes: fs.statSync(zipPath).size };
|
||||
}
|
||||
|
||||
module.exports = { zipDirectory };
|
||||
@ -98,16 +98,22 @@
|
||||
</Content>
|
||||
|
||||
<!--
|
||||
谷歌浏览器插件(仓库根目录 extension\):随程序输出到 native 同级的 extension\,
|
||||
谷歌浏览器插件(仓库根目录 extension\dist\):随程序输出到 native 同级的 extension\,
|
||||
安装后位于 <安装目录>\extension,菜单「工具 → 复制插件路径(开发者模式)」给出该 Windows 路径;
|
||||
正式分发走企业策略(菜单「工具 → 安装谷歌插件」),crx/updates.xml 由 npm run extension:publish 发布。
|
||||
|
||||
⚠️ 打进安装包的是**压缩后的 dist**(`npm run extension:bundle` 生成,体积约源码 1/3,
|
||||
已去注释、压空白;不做混淆 —— MV3 的 CSP 禁止 eval,商店也要求代码可读)。
|
||||
桌面端 build.ps1 在 dotnet publish 之前会自动跑一次;本地单独编译时先执行
|
||||
`cd backend && npm run extension:bundle`,否则会打到上一次的 dist。
|
||||
|
||||
⚠️ 这些**绝对不能**打进安装包:
|
||||
· keys\ 扩展签名私钥(泄漏 = 别人能签一个"官方更新"推给我们的客户)
|
||||
· out\ 打包产物(crx/updates.xml,客户端从服务器拉)
|
||||
· test\ tools\ 开发调试文件
|
||||
· test\ tools\ 开发调试文件(bundle 时已被排除,不在 dist 里)
|
||||
-->
|
||||
<Content Include="..\extension\**\*"
|
||||
Exclude="..\extension\test\**;..\extension\tools\**;..\extension\keys\**;..\extension\out\**">
|
||||
<Content Include="..\extension\dist\**\*"
|
||||
Exclude="..\extension\dist\keys\**;..\extension\dist\out\**">
|
||||
<Link>extension\%(RecursiveDir)%(Filename)%(Extension)</Link>
|
||||
<CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
|
||||
<CopyToPublishDirectory>PreserveNewest</CopyToPublishDirectory>
|
||||
|
||||
@ -1,18 +1,19 @@
|
||||
#requires -Version 5.1
|
||||
#requires -Version 5.1
|
||||
<#
|
||||
.SYNOPSIS
|
||||
打「云仓视频溯源软件」的安装包(MSI 和/或 EXE),并生成本机自动更新用的 version.json。
|
||||
|
||||
.DESCRIPTION
|
||||
1. 按 -Environment 从 package.config.json 取该环境的域名(开发 / 生产);
|
||||
2. dotnet publish(自包含单文件,不依赖 .NET 运行时);
|
||||
3. wix build 生成 MSI;Inno Setup(ISCC)生成 EXE;
|
||||
4. 计算 MD5 → 写 version.json(version / downloadUrl / md5 / size / publishedAt / buildId;
|
||||
2. 打包 Chrome 插件:源码压缩到 extension\dist(esbuild,只压缩不混淆);
|
||||
3. dotnet publish(自包含单文件,不依赖 .NET 运行时;csproj 打的是 extension\dist);
|
||||
4. wix build 生成 MSI;Inno Setup(ISCC)生成 EXE;
|
||||
5. 计算 MD5 → 写 version.json(version / downloadUrl / md5 / size / publishedAt / buildId;
|
||||
EXE 版另有 downloadUrlExe / md5Exe / sizeExe);
|
||||
5. 把 version.json + 安装包复制到后端目录(安装包 → backend/app/public/download/desktop/、
|
||||
6. 把 version.json + 安装包复制到后端目录(安装包 → backend/app/public/download/desktop/、
|
||||
version.json → backend/app/public/version/desktop/),供软件启动时
|
||||
GET /download/version.json 检测更新;
|
||||
6. 本地 out/ 与后端目录各只保留最近 keepVersions(默认 5)个安装包。
|
||||
7. 本地 out/ 与后端目录各只保留最近 keepVersions(默认 5)个安装包。
|
||||
|
||||
.PARAMETER Environment
|
||||
Development(默认,连本机 7300)/ Production(用正式域名)。
|
||||
@ -87,6 +88,7 @@ if (-not (Get-Command $dotnetExe -ErrorAction SilentlyContinue)) {
|
||||
}
|
||||
|
||||
$desktop = Split-Path -Parent $PSScriptRoot # desktop\
|
||||
$repoRoot = Split-Path -Parent $desktop # 仓库根(backend\ / extension\ 在这里)
|
||||
$project = Join-Path $desktop 'YuncangTrace.LocalService.csproj'
|
||||
$publishDir = Join-Path $desktop 'publish'
|
||||
$outDir = Join-Path $PSScriptRoot 'out'
|
||||
@ -148,7 +150,16 @@ $buildMsi = $Target -ne 'Exe'
|
||||
$buildExe = $Target -ne 'Msi'
|
||||
Write-Host "安装包:$Target"
|
||||
|
||||
# ---------------- 3. 发布 ----------------
|
||||
# ---------------- 3. 插件打包(压缩源码 → extension\dist,csproj 打的是 dist) ----------------
|
||||
# 用 backend 的 node_modules 里的 esbuild;没装就明确报错,别静默打到上一次的旧 dist
|
||||
$bundleScript = Join-Path $repoRoot 'backend\scripts\deploy\build-extension.cjs'
|
||||
if (-not (Test-Path $bundleScript)) { throw "找不到插件打包脚本:$bundleScript" }
|
||||
$nodeExe = (Get-Command node -ErrorAction SilentlyContinue).Source
|
||||
if (-not $nodeExe) { throw "找不到 node,无法打包谷歌插件(先装 Node.js,再 cd backend; npm install)" }
|
||||
& $nodeExe $bundleScript
|
||||
if ($LASTEXITCODE -ne 0) { throw "插件打包失败($LASTEXITCODE):先 cd backend; npm install" }
|
||||
|
||||
# ---------------- 4. 发布 ----------------
|
||||
Push-Location $desktop
|
||||
try {
|
||||
& $dotnetExe publish $project -c Release -r win-x64 `
|
||||
@ -176,7 +187,7 @@ if (-not (Test-Path $ffmpeg)) {
|
||||
}
|
||||
Write-Host "ffmpeg:$([math]::Round((Get-Item $ffmpeg).Length / 1MB, 1)) MB"
|
||||
|
||||
# ---------------- 4. 打安装包 ----------------
|
||||
# ---------------- 5. 打安装包 ----------------
|
||||
New-Item -ItemType Directory -Force -Path $outDir | Out-Null
|
||||
|
||||
# 4a. MSI(WiX)
|
||||
@ -235,7 +246,7 @@ if ($buildExe) {
|
||||
Write-Host "EXE:$([math]::Round((Get-Item $setupExe).Length / 1MB, 1)) MB"
|
||||
}
|
||||
|
||||
# ---------------- 5. version.json ----------------
|
||||
# ---------------- 6. version.json ----------------
|
||||
$now = Get-Date
|
||||
|
||||
$msiHash = $null
|
||||
@ -284,7 +295,7 @@ $versionJson = $versionJson | ConvertTo-Json
|
||||
|
||||
$versionFile = Join-Path $outDir 'version.json'
|
||||
Write-Utf8NoBom $versionFile $versionJson
|
||||
# ---------------- 6. 复制到后端 ----------------
|
||||
# ---------------- 7. 复制到后端 ----------------
|
||||
# MSI → app/public/download/desktop/(/download/desktop/xxx.msi,长缓存)
|
||||
# version.json → app/public/version/desktop/(/download/version.json 由路由提供,绝不能缓存)
|
||||
$skipVersionJson = $false
|
||||
@ -343,7 +354,7 @@ else {
|
||||
Write-Host "(该环境 copyToServer=false,跳过复制到后端)"
|
||||
}
|
||||
|
||||
# ---------------- 7. 只保留最近 N 个安装包 ----------------
|
||||
# ---------------- 8. 只保留最近 N 个安装包 ----------------
|
||||
function Remove-OldPackages([string]$dir, [int]$keep, [string]$pattern) {
|
||||
if (-not (Test-Path $dir)) { return }
|
||||
|
||||
@ -371,7 +382,7 @@ foreach ($pattern in @('YuncangTraceSetup-*.msi', 'YuncangTraceSetup-*.exe')) {
|
||||
if ($downloadDir) { Remove-OldPackages $downloadDir $Keep $pattern }
|
||||
}
|
||||
|
||||
# ---------------- 8. 摘要 ----------------
|
||||
# ---------------- 9. 摘要 ----------------
|
||||
Write-Host ""
|
||||
if ($msi) { Write-Host "MSI:$msi" -ForegroundColor Green }
|
||||
if ($setupExe) { Write-Host "EXE:$setupExe" -ForegroundColor Green }
|
||||
|
||||
@ -41,10 +41,20 @@ Chrome / Edge 扩展(**Manifest V3 + 原生 JS,零构建**)。
|
||||
|
||||
```powershell
|
||||
cd backend
|
||||
npm run extension:build # 只打包(extension/out/ 下产出 .crx / updates.xml / extension-id.txt)
|
||||
npm run extension:publish # 打包 + 上传到服务器 /download/extension/ + 刷新 nginx
|
||||
npm run extension:bundle # 只压缩源码 → extension/dist(esbuild minify,去注释压空白,约 1/3 体积)
|
||||
npm run extension:build # 压缩 + 打包(extension/out/ 下产出 .crx / updates.xml / extension-id.txt)
|
||||
npm run extension:publish # 压缩 + 打包 + 上传到服务器 /download/extension/ + 刷新 nginx
|
||||
npm run extension:zip # 压缩 + 出商店上传包(extension/out/*.zip,条目名是标准 `/`)
|
||||
```
|
||||
|
||||
**分发用的都是 `extension/dist`(压缩产物),开发调试仍用源码目录**:
|
||||
|
||||
- `extension/` = 源码(带完整注释),`chrome://extensions`「加载已解压」时选这个目录;
|
||||
- `extension/dist/` = 压缩产物(`dist/` 已 gitignore,随时可重新生成),桌面端安装包和 `.crx` 都只用它;
|
||||
- 只做 minify、**不做混淆**:MV3 的 CSP 禁止 `eval`/`new Function`(`debugProtection` 之类直接报错),
|
||||
而且 Chrome/Edge 商店要求提交的代码可读;压缩后已经去掉全部注释、缩短了标识符,
|
||||
真正需要保密的东西也不在插件里(前缀/正则/站点全部由服务端下发,私钥从不进包)。
|
||||
|
||||
- 私钥 `extension/keys/key.pem`(首次运行自动生成,**务必单独备份**):它决定**扩展 ID**,
|
||||
换了私钥 = 换了 ID = 已经下发到客户机的策略全部失效;
|
||||
- 服务器上:`/download/extension/updates.xml`(**不缓存**,浏览器靠它自动升级)、
|
||||
@ -57,16 +67,16 @@ npm run extension:publish # 打包 + 上传到服务器 /download/extension/
|
||||
重启浏览器即自动装好(`chrome://extensions` 里显示「由你的组织管理」)。
|
||||
「工具 → 卸载谷歌插件」只会删掉值里带 `/download/extension/` 的那几条,不动别的策略。
|
||||
|
||||
没有管理员权限的机器仍可用「工具 → 复制插件路径(开发者模式)」手动加载。
|
||||
没有管理员权限的机器仍可用「工具 → 复制插件路径(开发者模式)」手动加载(拿到的是安装目录里的压缩版)。
|
||||
|
||||
## 1. 安装
|
||||
|
||||
### 客户机:从桌面端安装包直接加载(推荐)
|
||||
|
||||
桌面端安装包(MSI / EXE)已经把这个 `extension/` 目录一起装好,路径固定为
|
||||
`%LOCALAPPDATA%\Programs\YuncangTrace\extension`:
|
||||
桌面端安装包(MSI / EXE)已经把插件的**压缩产物**装到固定路径
|
||||
`%LOCALAPPDATA%\Programs\YuncangTrace\extension`(源码、私钥都不进包):
|
||||
|
||||
1. 桌面端软件菜单「**工具 → 复制谷歌插件地址**」(复制的是 Windows 路径,可直接粘进选择框)。
|
||||
1. 桌面端软件菜单「**工具 → 复制插件路径(开发者模式)**」(复制的是 Windows 路径,可直接粘进选择框)。
|
||||
2. 打开 `chrome://extensions`(Edge 是 `edge://extensions`)→ 右上角打开 **开发者模式**。
|
||||
3. 点 **加载已解压的扩展程序**,把刚复制的路径粘进去。
|
||||
4. 刷新一下已经打开的 WMS 页面(扩展只对**安装之后**加载的页面生效)。
|
||||
@ -93,14 +103,19 @@ extension/
|
||||
│ ├── background.js # service worker:打开目标地址 + **每 5 分钟拉取服务器配置**
|
||||
│ ├── popup.html/.css/.js # 工具栏弹窗:配置版本、本页命中清单、重新扫描、立即同步
|
||||
│ └── options.html/.js # ★ 只读状态页:同步状态 / 生效站点 / 前缀(不可编辑)
|
||||
├── dist/ # 压缩产物(npm run extension:bundle 生成,不进仓库)
|
||||
├── test/wms-mock.html # 自测页:按真实结构复刻的表格
|
||||
└── tools/make-icons.ps1 # 生成图标(纯 ASCII,见文件头说明)
|
||||
```
|
||||
|
||||
**没有构建步骤**:`rules.js` 挂在 `globalThis.PSTRules` 上,content script / popup / options 各自
|
||||
**开发没有构建步骤**:`rules.js` 挂在 `globalThis.PSTRules` 上,content script / popup / options 各自
|
||||
用 `<script src>` 或 `manifest.content_scripts.js` 按顺序加载它。改完代码在 `chrome://extensions` 点一下
|
||||
刷新即可(改 `manifest.json` 才需要重装)。
|
||||
|
||||
**分发才有打包步骤**:`npm run extension:bundle` 用 esbuild 逐文件压缩(**不合并文件**,
|
||||
所以 `importScripts('lib/rules.js')` 和各处路径原样有效)输出到 `extension/dist`;
|
||||
桌面端安装包与 `.crx` 都只打 `dist`。改了 `src/` 之后记得重跑一次(`build.ps1` 会自动跑)。
|
||||
|
||||
## 3. 匹配方式 × 加工方式
|
||||
|
||||
**匹配(怎么找)**
|
||||
|
||||
@ -1,7 +1,7 @@
|
||||
{
|
||||
"manifest_version": 3,
|
||||
"name": "云仓视频溯源 · 单号注入",
|
||||
"version": "1.1.1",
|
||||
"version": "1.1.2",
|
||||
"description": "在第三方 WMS / 后台页面里识别单号,就地加工成可点击的溯源入口;识别前缀与生效站点由管理员在后台统一维护,插件每 5 分钟自动同步。",
|
||||
"minimum_chrome_version": "96",
|
||||
|
||||
|
||||
@ -14,14 +14,16 @@
|
||||
*/
|
||||
(function (root) {
|
||||
const STORAGE_KEY = 'pstConfig';
|
||||
// 网页模板(openMode = window / tab 时用):打开本机软件的公共页
|
||||
const DEFAULT_URL_TEMPLATE = 'http://localhost:7301/local?code={code}';
|
||||
// 网页模板(openMode = window / tab 时用):打开官网的单号页
|
||||
// ⚠️ 只是**兜底默认值**:正常情况由服务端配置下发(平台管理 → 插件配置)。
|
||||
// 绝不能写成 localhost —— 插件装在员工浏览器里,那会打开他们自己的机器。
|
||||
const DEFAULT_URL_TEMPLATE = 'https://pack.wms.gztbyc.com/local?code={code}';
|
||||
// 协议模板(openMode = app 时用):**直接唤起本机软件**并带上单号
|
||||
// ⚠️ 自定义协议拿不到任何结果(成功/没装/用户点取消在网页侧一模一样),
|
||||
// 所以 content script 必须配合超时兜底(弹「下载安装 / 在网页中查看」)。
|
||||
const DEFAULT_APP_URL_TEMPLATE = 'yuncang://open?code={code}';
|
||||
/** 兜底页:协议唤不起时「去网页看看」(页面里会提示下载安装、并能在浏览器里直接查) */
|
||||
const DEFAULT_FALLBACK_URL = 'http://localhost:7301/local?code={code}';
|
||||
const DEFAULT_FALLBACK_URL = 'https://pack.wms.gztbyc.com/local?code={code}';
|
||||
/** 点击后的打开方式:app = 协议唤起本机软件;window = 独立小窗;tab = 新标签页 */
|
||||
const OPEN_MODES = ['app', 'window', 'tab'];
|
||||
const DEFAULT_BUTTON_TEXT = '查看打包视频';
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user