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/