From 9ad277651571b8b1640ff06e238a0a08b7d0a307 Mon Sep 17 00:00:00 2001 From: que01 Date: Tue, 13 Oct 2026 23:03:32 +0800 Subject: [PATCH] =?UTF-8?q?feat:=20=E9=81=AE=E8=94=BD=E4=BA=A7=E7=89=A9?= =?UTF-8?q?=E4=B8=AD=E7=9A=84=20Taro=20=E6=8C=87=E7=BA=B9?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit H5 预览与小程序产物会带出 taro_tmpl、taro-*-core、taro.js、--taro-button-height、 project.config.json 的 projectname 等指纹,而 Taro 4.3 没有隐藏这些名称的配置。 改为在 build:h5、build:weapp、build:preview 之后按 apps/taro/config/mask.config.json 做构建后处理: - 同一张替换表同时作用于文件名与文本内容,重命名后引用保持同步,长度 ≥ 40 的 base64/哈希片段原样保留; - 遮蔽后仍命中 forbidden 词表时构建失败,并把 project.config.json 的 projectname/description 中性化; - dev:h5、dev:preview 保持原始命名,便于本地调试;改架构名只改 mask.config.json; - 产物契约测试先用 unmask() 还原再断言,浏览器测试选择器写成 :is(<源码名>, <遮蔽名>)。 取舍与迁移见 docs/adr/0025-build-output-stack-masking.md。 --- apps/taro/README.md | 10 + apps/taro/config/index.ts | 2 +- apps/taro/config/mask-taro.cjs | 197 ++++++++++++++++++++ apps/taro/config/mask.config.json | 14 ++ apps/taro/package.json | 6 +- apps/taro/test/browser/preview.spec.ts | 14 +- apps/taro/test/build-contract.test.mjs | 3 +- apps/taro/test/mask-names.mjs | 22 +++ apps/taro/test/mask-taro.test.mjs | 83 +++++++++ docs/adr/0025-build-output-stack-masking.md | 37 ++++ docs/deployment.md | 2 + docs/engineering-delivery-checklist.md | 1 + eslint.config.mjs | 1 + 13 files changed, 382 insertions(+), 10 deletions(-) create mode 100644 apps/taro/config/mask-taro.cjs create mode 100644 apps/taro/config/mask.config.json create mode 100644 apps/taro/test/mask-names.mjs create mode 100644 apps/taro/test/mask-taro.test.mjs create mode 100644 docs/adr/0025-build-output-stack-masking.md diff --git a/apps/taro/README.md b/apps/taro/README.md index 1e21aa9..1ece9dd 100644 --- a/apps/taro/README.md +++ b/apps/taro/README.md @@ -35,6 +35,16 @@ TEMPLATE_KEY=linjing-editorial pnpm --filter @personal-brand/taro build:weapp 页面结构和样式以 React 原型为参考,当前原生小程序用于校对字段、结构化来源、认证与提交行为。模板实现位于各 package 的 `taro/`;公共请求、表单、记录和状态位于此目录。新模板须提供 manifest、Taro 实现和验收用例,不新增全局 seed。 +## 构建产物遮蔽 + +生产构建会调用构建后处理脚本 `config/mask-taro.cjs`,按 `config/mask.config.json` 替换产物里的 Taro 标识符(文件名与内容使用同一张表),遮蔽后仍命中 `forbidden` 词表时构建失败。`build:h5`、`build:weapp`、`build:preview` 都已接入;`dev:h5`、`dev:preview` 保持原始命名便于调试。改架构名只改 `config/mask.config.json`;复核某次产物是否干净用: + +```sh +TEMPLATE_KEY=acheng-campus-food node config/mask-taro.cjs weapp --check +``` + +由于产物名称与源码名称不同,产物契约测试用 `test/mask-names.mjs` 的 `unmask()` 还原后再断言,浏览器测试的选择器写成 `:is(<源码名>, <遮蔽名>)`。机制与取舍见 [docs/adr/0025-build-output-stack-masking.md](../../docs/adr/0025-build-output-stack-masking.md)。 + ## 使用边界 Web 支持真实已发布内容、导航、餐品搜索/分类、咨询表单填写和校验。未接入 Web 身份登录,因此没有微信会话时不会提交,不生成假咨询或伪造成功。微信小程序采用 Taro.login 和原 customer/session/wechat 接口。令牌按品牌隔离;请求失败保留表单输入,401 清理会话。 diff --git a/apps/taro/config/index.ts b/apps/taro/config/index.ts index d739061..e9db9d3 100644 --- a/apps/taro/config/index.ts +++ b/apps/taro/config/index.ts @@ -29,7 +29,7 @@ fs.cpSync(path.join(template, "miniapp/assets"), path.resolve(__dirname, "../src recursive: true, }); export default defineConfig({ - projectName: "personal-brand-taro", + projectName: "personal-brand-miniapp", date: "2026-10-08", designWidth: 750, deviceRatio: { 750: 1 }, diff --git a/apps/taro/config/mask-taro.cjs b/apps/taro/config/mask-taro.cjs new file mode 100644 index 0000000..fcd3787 --- /dev/null +++ b/apps/taro/config/mask-taro.cjs @@ -0,0 +1,197 @@ +/** + * 构建后处理:把产物里的 Taro 指纹替换成中性标识。 + * + * 同一张替换表同时作用于「文件名」和「文本内容」,因此 taro.js 会连文件名带引用 + * 一起变成 appkit.js,模板名 taro_tmpl 与页面里的引用也会同步,无需分别维护。 + * + * 用法: + * node config/mask-taro.cjs weapp 处理后 dist/