feat: 遮蔽产物中的 Taro 指纹

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。
This commit is contained in:
que01 committed 2026-10-13 23:03:32 +08:00
1 parent 53713e5935
commit 9ad2776515
13 files changed
+382 -10

No files matched your search

+1
View File
@@ -39,6 +39,7 @@
`TEMPLATE_KEY=<template-key> API_BASE_URL=<production-api> WEAPP_APP_ID=<appid> pnpm --filter @personal-brand/taro build:weapp`;
- 小程序和 H5 必须分别构建并归档到 `apps/taro/dist/<templateKey>/weapp` 与 `apps/taro/dist/<templateKey>/h5`;产物契约测试通过;
- 产物检查必须覆盖:`project.config.json` 的 AppID、请求内嵌的 `API_BASE_URL`、`/media/` 相对地址补全结果、`common.wxss` 中的按钮规则;
- 产物不得出现 Taro 指纹:`build:weapp`、`build:h5`、`build:preview` 必须走包内脚本(构建后处理失败会中断构建),必要时用 `node config/mask-taro.cjs <weapp|h5> --check` 复核;改名规则只改 `apps/taro/config/mask.config.json`;
- 涉及 `Button`、`Input`、`Textarea`、`Picker` 等原生控件时,源码和产物都要核对;禁止只依据 H5 预览判定小程序样式;
- 按页面角色检查视觉点,不按模板名称写专用清单,并记录截图或说明未改动原因:
- 首页:媒体加载、横向间距、标签换行、整卡点击;