feat: 遮蔽后台静态产物中的 Taro 指纹

Traefik 把 wechat.app.que01.top 上除 /api、/media 以外的路径直接转发到 Admin 静态
服务器且没有鉴权,因此 /admin/assets/*.js 可以被任意下载。后台产物里的模板 renderer
glob 路径(packages/template-*/taro/index.tsx)与按钮尺寸令牌(--taro-button-height)
同样暴露技术栈,此前只遮蔽了 Taro 双端产物。

- mask-taro.cjs 增加 admin 目标,覆盖 apps/admin/dist,接入根脚本 build:admin:preview;
- deploy:package 在后台构建后校验 apps/admin/dist,命中指纹即中止打包;
- 补充遮蔽目标测试与文档(ADR 0025、README、部署说明、交付清单)。

验证:后台产物遮蔽后 glob key 与运行时查找同步改名;未遮蔽/已遮蔽产物用生产静态
服务器跑同一套后台浏览器测试,失败内容逐字节一致(既有失败与本改动无关);H5 预览
11 项浏览器回归全部通过;admin 构建、lint、typecheck、deploy 与 API 测试通过。
This commit is contained in:
que01 committed 2026-10-13 23:18:43 +08:00
1 parent 9ad2776515
commit 4d1cd8f365
8 files changed
+63 -8

No files matched your search

+28 -1
View File
@@ -7,7 +7,13 @@ import { createRequire } from "node:module";
import { maskConfig, masked, unmask } from "./mask-names.mjs";
const require = createRequire(import.meta.url);
const { maskText, maskFileName, maskDirectory, findLeaks } = require("../config/mask-taro.cjs");
const {
maskText,
maskFileName,
maskDirectory,
findLeaks,
resolveTargets,
} = require("../config/mask-taro.cjs");
const replacements = maskConfig.replacements;
/** 长度超过 40 的 base64/哈希片段,遮蔽时必须原样保留。 */
@@ -31,6 +37,27 @@ test("遮蔽表在测试与构建之间保持一致", () => {
);
});
test("遮蔽目标覆盖双端产物、预览与后台静态产物", () => {
const taroRoot = path.resolve(import.meta.dirname, "..");
const previous = process.env.TEMPLATE_KEY;
try {
process.env.TEMPLATE_KEY = "example-template";
assert.deepEqual(resolveTargets("weapp", false), [
path.join(taroRoot, "dist/example-template/weapp"),
]);
assert.deepEqual(resolveTargets("h5", false), [
path.join(taroRoot, "dist/example-template/h5"),
]);
assert.deepEqual(resolveTargets("h5", true), [path.join(taroRoot, "dist/template-preview/h5")]);
assert.deepEqual(resolveTargets("admin", false), [path.resolve(taroRoot, "../admin/dist")]);
delete process.env.TEMPLATE_KEY;
assert.throws(() => resolveTargets("weapp", false), /TEMPLATE_KEY/);
} finally {
if (previous === undefined) delete process.env.TEMPLATE_KEY;
else process.env.TEMPLATE_KEY = previous;
}
});
test("文本遮蔽改标识符但不损坏不透明数据段", () => {
const content = `var tmpl="taro_tmpl";var key="${opaqueRun}";const modifyTaroEvent=1;`;
const result = maskText(content, replacements);