Files
persionalBrand/apps/taro/config/mask-taro.cjs
T
que01 4f0b50c7f1 fix: 收口模板契约与安全门禁
统一模板包 visual 契约并补齐完成证据;修复 release 版本一致性、管理员 token 撤销、CORS 与默认品牌配置;收敛依赖安全风险并完成全量回归验证。
2026-10-18 22:05:31 +08:00

204 lines
7.1 KiB
JavaScript
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
/**
* 构建后处理:把产物里的 Taro 指纹替换成中性标识。
*
* 同一张替换表同时作用于「文件名」和「文本内容」,因此 taro.js 会连文件名带引用
* 一起变成 appkit.js,模板名 taro_tmpl 与页面里的引用也会同步,无需分别维护。
*
* 用法:
* node config/mask-taro.cjs weapp 处理后 dist/<template>/weapp
* node config/mask-taro.cjs h5 处理后 dist/<template>/h5
* node config/mask-taro.cjs h5 --preview 处理后 dist/template-preview/h5
* node config/mask-taro.cjs admin 处理后后台静态产物 apps/admin/dist
* node config/mask-taro.cjs weapp --check 只检查是否仍有指纹,不修改
*/
const fs = require("node:fs");
const path = require("node:path");
const taroRoot = path.resolve(__dirname, "..");
const configPath = path.join(__dirname, "mask.config.json");
/** 需要做文本替换的扩展名,二进制文件一律跳过。 */
const textExtensions = new Set([
".js",
".mjs",
".cjs",
".json",
".wxml",
".wxss",
".wxs",
".css",
".html",
]);
function loadConfig() {
return JSON.parse(fs.readFileSync(configPath, "utf8"));
}
/** 长键优先,避免 `@tarojs` 被 `taro` 抢先替换成 `@appkitjs` 这种半成品。 */
function orderedReplacements(replacements) {
return Object.entries(replacements ?? {}).sort(([a], [b]) => b.length - a.length);
}
function escapeRegExp(value) {
return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
}
/** 连续的长 base64/哈希片段:可能是内嵌图片、密钥或摘要,替换进去会损坏数据。 */
const opaqueRun = /[A-Za-z0-9+/=]{40,}/;
const opaqueRunSplit = /([A-Za-z0-9+/=]{40,})/;
/**
* 把内容切成「可替换区段」和「受保护区段」,只在前者做替换。
* 这样既能命中边界处的 `taro_tmpl`,也能命中 camelCase 的 `modifyTaroEvent`,
* 又不会动到内嵌的 base64 数据。
*/
function maskText(content, replacements) {
const entries = orderedReplacements(replacements);
return content
.split(opaqueRunSplit)
.map((segment) =>
opaqueRun.test(segment)
? segment
: entries.reduce(
(result, [from, to]) => result.replace(new RegExp(escapeRegExp(from), "g"), to),
segment,
),
)
.join("");
}
function maskFileName(name, replacements) {
return orderedReplacements(replacements).reduce(
(result, [from, to]) => result.replace(new RegExp(escapeRegExp(from), "g"), to),
name,
);
}
function resolveTargets(envType, preview) {
if (preview) return [path.join(taroRoot, "dist/template-preview/h5")];
// 后台静态产物同样对外可达,其中的模板 renderer 路径与按钮尺寸变量也会带出指纹。
if (envType === "admin") return [path.resolve(taroRoot, "../admin/dist")];
if (process.env.MINIAPP_OUTPUT_ROOT)
return [path.resolve(taroRoot, process.env.MINIAPP_OUTPUT_ROOT)];
// 单模板构建默认使用餐饮试点;多模板预览必须显式 --preview。
const templateKey = process.env.TEMPLATE_KEY ?? "acheng-campus-food";
if (!templateKey) throw new Error("TEMPLATE_KEY is required for non-preview masking");
return [path.join(taroRoot, "dist", templateKey, envType)];
}
function walk(directory) {
const files = [];
for (const entry of fs.readdirSync(directory, { withFileTypes: true })) {
const full = path.join(directory, entry.name);
if (entry.isDirectory()) files.push(...walk(full));
else if (entry.isFile()) files.push(full);
}
return files;
}
function maskProjectConfig(directory, config) {
const target = path.join(directory, "project.config.json");
if (!fs.existsSync(target)) return;
const current = JSON.parse(fs.readFileSync(target, "utf8"));
const next = { ...current, ...(config.project ?? {}) };
fs.writeFileSync(target, `${JSON.stringify(next, null, 2)}\n`);
}
function renameFiles(directory, files, replacements) {
const renamed = [];
for (const file of files) {
const currentName = path.basename(file);
const nextName = maskFileName(currentName, replacements);
if (nextName === currentName) continue;
const next = path.join(path.dirname(file), nextName);
if (fs.existsSync(next)) throw new Error(`遮蔽后文件名冲突:${next}`);
fs.renameSync(file, next);
renamed.push([currentName, nextName]);
}
return renamed;
}
function maskDirectory(directory, config, { check = false } = {}) {
if (!fs.existsSync(directory)) throw new Error(`产物目录不存在:${directory}`);
const replacements = config.replacements ?? {};
const files = walk(directory);
let rewritten = 0;
for (const file of files) {
if (!textExtensions.has(path.extname(file))) continue;
const content = fs.readFileSync(file, "utf8");
const masked = maskText(content, replacements);
if (masked === content) continue;
rewritten += 1;
if (!check) fs.writeFileSync(file, masked);
}
const renamed = check ? [] : renameFiles(directory, files, replacements);
if (!check) maskProjectConfig(directory, config);
return {
directory,
scanned: files.length,
rewritten,
renamed,
leaked: findLeaks(directory, config),
};
}
/** 扫描整个产物目录,返回仍然含有指纹的位置,用于守卫。 */
function findLeaks(directory, config) {
const forbidden = config.forbidden ?? [];
if (!forbidden.length) return [];
const leaks = [];
for (const file of walk(directory)) {
const name = path.basename(file);
if (forbidden.some((token) => name.includes(token))) {
leaks.push(`${path.relative(directory, file)} :: 文件名`);
continue;
}
if (!textExtensions.has(path.extname(file))) continue;
const content = fs.readFileSync(file, "utf8");
for (const token of forbidden) {
if (content.includes(token)) {
leaks.push(`${path.relative(directory, file)} :: 内容包含 ${token}`);
break;
}
}
}
return leaks;
}
function main() {
const args = process.argv.slice(2);
const envType = args.find((arg) => !arg.startsWith("--")) ?? "weapp";
const preview = args.includes("--preview");
const check = args.includes("--check");
const config = loadConfig();
if (!config.enabled && !check) {
console.log("[mask] 配置为 enabled: false,跳过遮蔽");
return;
}
let failed = false;
for (const directory of resolveTargets(envType, preview)) {
const result = maskDirectory(directory, config, { check });
const relative = path.relative(taroRoot, result.directory);
console.log(
`[mask] ${relative}:扫描 ${result.scanned} 个文件,改写 ${result.rewritten} 个` +
(result.renamed.length ? `,重命名 ${result.renamed.length} 个` : ""),
);
for (const [from, to] of result.renamed) console.log(`[mask] 重命名 ${from} -> ${to}`);
if (result.leaked.length) {
failed = true;
console.error(`[mask] ${relative} 仍存在技术栈指纹:`);
for (const leak of result.leaked.slice(0, 20)) console.error(` - ${leak}`);
}
}
if (failed) process.exit(1);
}
module.exports = { maskText, maskFileName, maskDirectory, findLeaks, loadConfig, resolveTargets };
if (require.main === module) main();