fix(miniapp): 小程序界面全量中文化，消除英文/非中文枚举码上屏
- 新增 miniapp/constants/profileLabels.js 作为「枚举码→中文简体」唯一字典 （婚姻/子女/学历/职业/吸烟饮酒/择偶子女/红娘状态），覆盖表单值与种子 实际值两套并集，保证详情页无论后端返回哪种码都显示中文 - 修复「择偶条件-子女」下拉英文选项（any/accept/reject→不限/可接受/不接受）， 改用 value/label 数组 + range-key="label" - 修复 recommend-card / user-card / profile-detail / profile-confirm 直接渲染 后端枚举码（educationCode/maritalStatus/occupationCode…）的问题，改由 observers 派生中文 label 上屏 - 清理残留英文文案：Required 条件→必须符合的条件、喜欢TA/向Ta→喜欢对方/向对方、 U51 服务预约→服务预约、U64 公益服务记录→公益服务记录 - 修复 7 个英文窗口标题与 3 个英文占位页正文 - matchmaker 历史服务状态消除原始码兜底，统一走字典 - 加固 scripts/audit-miniapp-language.mjs（A 整行先剥离 mustache、B 排除 bind:action 处理器、F 窗口标题、JPG/PNG 入白名单） - 新增 ui-tests/miniapp-language-contracts.mjs 语种守卫（复用审计脚本，断言 0 命中）， UI 契约门禁 MIN_GUARDS 21→22；已做负向注入验证判别力
This commit is contained in:
WorkBuddy
@@ -0,0 +1,201 @@
|
||||
#!/usr/bin/env node
|
||||
/**
|
||||
* 小程序文案语种审计：找出「会显示给用户、但不是中文简体」的文本。
|
||||
*
|
||||
* 为什么需要它：小程序里最典型的一类缺陷是**后端枚举码直接当展示值**——
|
||||
* 例如某个 <picker range="{{['any','accept','reject']}}"> 的下拉里出现
|
||||
* any / accept / reject，而同一行的选中值却是「不限」。静态类型检查、
|
||||
* WXSS/WXML 编译、结构守卫全都不会报，只有人眼在真机上才发现。
|
||||
*
|
||||
* 检查项：
|
||||
* A 文本节点里的 ASCII 单词（剥掉注释与 {{ }} 表达式后仍有英文）
|
||||
* B 中文属性（placeholder/title/label/subtitle/action/desc…）里的 ASCII 单词
|
||||
* C <picker range="{{[...]}}"> 字面量选项里出现纯英文
|
||||
* D JS 里 label: 'English' 这类未汉化的文案字段
|
||||
* E 繁体字（与简体异形的常用字表）——「其他非中文简体」里的常见一类
|
||||
* F 页面 .json 的 navigationBarTitleText 为英文
|
||||
*
|
||||
* 用法：node scripts/audit-miniapp-language.mjs [--json] [--out=file]
|
||||
* 退出码：有命中 → 1；干净 → 0。（可直接当守卫用）
|
||||
*/
|
||||
import { readFileSync, readdirSync, statSync, writeFileSync } from 'node:fs'
|
||||
import { join, relative, resolve } from 'node:path'
|
||||
|
||||
const STACK_FILE = 'E:/develop/公益婚恋服务平台/.workbuddy/audit_stack.txt'
|
||||
|
||||
try {
|
||||
main()
|
||||
} catch (e) {
|
||||
try { writeFileSync(STACK_FILE, 'AUDIT_CRASH:\n' + ((e && e.stack) || String(e)), 'utf8') } catch (_) {}
|
||||
console.error((e && e.stack) || e)
|
||||
process.exit(3)
|
||||
}
|
||||
|
||||
function main() {
|
||||
const root = resolve(import.meta.dirname, '..')
|
||||
const MINIAPP = join(root, 'miniapp')
|
||||
const AS_JSON = process.argv.includes('--json')
|
||||
const outArg = process.argv.find((a) => a.startsWith('--out='))
|
||||
|
||||
/** 允许出现在界面上的非中文片段（单位、专名缩写等），按需增补并写清理由 */
|
||||
const ASCII_ALLOW = new Set([
|
||||
'cm', 'kg', 'ml', 'km', 'm', // 计量单位
|
||||
'ID', 'id', // 证件/编号类专名
|
||||
'APP', 'App', // 平台专名
|
||||
'VIP',
|
||||
'AI',
|
||||
'OK',
|
||||
'Lv', 'LV',
|
||||
'MB', 'GB', 'KB', // 体积
|
||||
'TEL',
|
||||
'URL',
|
||||
'el', // 个别组件前缀（如 el-tag 为历史遗留 Web 组件，不在小程序渲染路径）
|
||||
// 图片/文档格式专名（与 cm/kg 同理，属技术缩写而非「其他语言」）
|
||||
'JPG', 'PNG', 'GIF', 'PDF', 'WEBP',
|
||||
])
|
||||
|
||||
/**
|
||||
* 与简体**异形**的常用繁体字。只收录「简体写法不同」的字，
|
||||
* 简繁同形的字（如 趣/域/婚/子/女/定/案 等）绝不能放进来，否则全是误报。
|
||||
*/
|
||||
const TRADITIONAL_CHARS = new Set(
|
||||
'個們這來時說對開關聯繫預約資標準確認興學歷職業區狀況選擇設檔訊報幫隱權註銷帳號審過實證齡體車產戶現電話碼驗動參簽紅薦發務條詳細臺灣門網絡軟機腦錄簡無線藍員會構團隊義誌願評價滿歡適檢醫療護飲當還讓給與從麼樣為長愛見覺點種問間東風雲視圖書課師圓場園館廳營記軍農極變層屬歲廣慶應處養雙頁頂項順顧題額類頻飛飯飽餓鮮藥衛親眾優傳偉傷兒'
|
||||
)
|
||||
|
||||
/** 需要审计的用户可见属性 */
|
||||
const TEXT_ATTRS = [
|
||||
'placeholder', 'title', 'subtitle', 'action', 'label', 'desc', 'description',
|
||||
'content', 'text', 'tip', 'tips', 'confirm-text', 'cancel-text', 'empty-text',
|
||||
'hint', 'notice', 'caption', 'unit',
|
||||
]
|
||||
|
||||
const findings = []
|
||||
const add = (level, file, line, kind, detail) => {
|
||||
findings.push({ level, file: relative(root, file).replace(/\\/g, '/'), line, kind, detail })
|
||||
}
|
||||
|
||||
function walk(dir, filter, out = []) {
|
||||
for (const name of readdirSync(dir)) {
|
||||
if (name === 'node_modules' || name === '.git' || name === 'dist') continue
|
||||
const p = join(dir, name)
|
||||
const st = statSync(p)
|
||||
if (st.isDirectory()) walk(p, filter, out)
|
||||
else if (filter(name)) out.push(p)
|
||||
}
|
||||
return out
|
||||
}
|
||||
|
||||
/** 把 <!-- --> 注释替换成等长空白，保持行号不变 */
|
||||
function stripWxmlComments(src) {
|
||||
return src.replace(/<!--[\s\S]*?-->/g, (m) => m.replace(/[^\n]/g, ' '))
|
||||
}
|
||||
|
||||
/** 剥离 {{ }} 表达式（表达式里出现英文是正常的：变量名/枚举判断） */
|
||||
function stripMustache(src) {
|
||||
return src.replace(/\{\{[\s\S]*?\}\}/g, (m) => ' '.repeat(m.length))
|
||||
}
|
||||
|
||||
function linesOf(src) {
|
||||
return src.split(/\r?\n/)
|
||||
}
|
||||
|
||||
function asciiWords(text) {
|
||||
const words = text.match(/[A-Za-z][A-Za-z0-9_'-]*/g) || []
|
||||
return words.filter((w) => !ASCII_ALLOW.has(w))
|
||||
}
|
||||
|
||||
/* ---------------- A/B/C：WXML ---------------- */
|
||||
for (const file of walk(join(MINIAPP, 'pages'), (n) => n.endsWith('.wxml'))
|
||||
.concat(walk(join(MINIAPP, 'components'), (n) => n.endsWith('.wxml')))) {
|
||||
const src = stripWxmlComments(readFileSync(file, 'utf8'))
|
||||
const lines = linesOf(src)
|
||||
|
||||
// A 文本节点
|
||||
lines.forEach((line, i) => {
|
||||
// 先在整行上剥离 {{ }}，否则 mustache 内的 > / <（如 minlength > 0 && x < y）
|
||||
// 会破坏「>文本<」的提取，把比较运算符误判为文本节点。
|
||||
const strippedLine = stripMustache(line)
|
||||
const texts = [...strippedLine.matchAll(/>([^<>]*)</g)].map((m) => m[1])
|
||||
for (const raw of texts) {
|
||||
const text = stripMustache(raw).trim()
|
||||
if (!text) continue
|
||||
const words = asciiWords(text)
|
||||
if (words.length) add('error', file, i + 1, 'A-文本节点', `"${text.trim()}" → ${words.join(', ')}`)
|
||||
}
|
||||
})
|
||||
|
||||
// B 中文属性
|
||||
// 负向环视：排除 bind:action / catch:action / data-action 等事件绑定——
|
||||
// 它们的取值是处理器标识（onXxx），不是界面可见文案。
|
||||
const attrRe = new RegExp(`(?<![:\\w-])(${TEXT_ATTRS.join('|')})="([^"]*)"`, 'g')
|
||||
lines.forEach((line, i) => {
|
||||
for (const m of line.matchAll(attrRe)) {
|
||||
const value = stripMustache(m[2])
|
||||
if (!value.trim() || value.includes('{{')) continue
|
||||
const words = asciiWords(value)
|
||||
if (words.length) add('error', file, i + 1, 'B-属性', `${m[1]}="${value}" → ${words.join(', ')}`)
|
||||
}
|
||||
})
|
||||
|
||||
// C picker 字面量选项
|
||||
lines.forEach((line, i) => {
|
||||
for (const m of line.matchAll(/range="\{\{\s*\[([^\]]*)\]\s*\}\}"/g)) {
|
||||
const items = m[1].split(',').map((s) => s.trim().replace(/^['"]|['"]$/g, '')).filter(Boolean)
|
||||
const bad = items.filter((s) => s && !/[\u4e00-\u9fa5]/.test(s))
|
||||
if (bad.length) add('error', file, i + 1, 'C-picker 选项', `纯英文/非中文选项: ${bad.join(', ')}`)
|
||||
}
|
||||
})
|
||||
}
|
||||
|
||||
/* ---------------- D：JS/TS 未汉化文案字段 ---------------- */
|
||||
const LABEL_KEYS = '(label|title|subtitle|text|placeholder|desc|description|name|tip|notice)'
|
||||
for (const file of walk(MINIAPP, (n) => /\.(js|ts)$/.test(n))) {
|
||||
const src = readFileSync(file, 'utf8')
|
||||
const lines = linesOf(src)
|
||||
lines.forEach((line, i) => {
|
||||
// 跳过注释行
|
||||
if (/^\s*(\/\/|\*|\/\*)/.test(line)) return
|
||||
const re = new RegExp(`${LABEL_KEYS}\\s*:\\s*(['"])([A-Za-z][A-Za-z0-9 _'-]*)\\1`, 'g')
|
||||
for (const m of line.matchAll(re)) {
|
||||
if (ASCII_ALLOW.has(m[3])) continue
|
||||
add('error', file, i + 1, 'D-文案字段', `${m[1]}: '${m[3]}'`)
|
||||
}
|
||||
})
|
||||
}
|
||||
|
||||
/* ---------------- E：繁体字 ---------------- */
|
||||
for (const file of walk(MINIAPP, (n) => /\.(wxml|js|ts|json)$/.test(n))) {
|
||||
const src = file.endsWith('.wxml') ? stripWxmlComments(readFileSync(file, 'utf8')) : readFileSync(file, 'utf8')
|
||||
linesOf(src).forEach((line, i) => {
|
||||
const hits = [...new Set([...line].filter((ch) => TRADITIONAL_CHARS.has(ch)))]
|
||||
if (hits.length) add('error', file, i + 1, 'E-繁体字', hits.join(''))
|
||||
})
|
||||
}
|
||||
|
||||
/* ---------------- F：页面 .json navigationBarTitleText 英文 ---------------- */
|
||||
for (const file of walk(join(MINIAPP, 'pages'), (n) => n.endsWith('.json'))) {
|
||||
let json
|
||||
try { json = JSON.parse(readFileSync(file, 'utf8')) } catch (_) { continue }
|
||||
const t = json && json.navigationBarTitleText
|
||||
if (typeof t === 'string' && t.trim() && /[A-Za-z]/.test(t) && !/[\u4e00-\u9fa5]/.test(t)) {
|
||||
add('error', file, 1, 'F-窗口标题', `navigationBarTitleText="${t}"`)
|
||||
}
|
||||
}
|
||||
|
||||
/* ---------------- 输出 ---------------- */
|
||||
if (outArg) {
|
||||
writeFileSync(outArg.slice('--out='.length), JSON.stringify(findings, null, 2), 'utf8')
|
||||
}
|
||||
if (AS_JSON) {
|
||||
console.log(JSON.stringify(findings, null, 2))
|
||||
} else {
|
||||
const byKind = {}
|
||||
for (const f of findings) (byKind[f.kind] ||= []).push(f)
|
||||
for (const [kind, list] of Object.entries(byKind)) {
|
||||
console.log(`\n【${kind}】${list.length} 处`)
|
||||
for (const f of list) console.log(` ${f.file}:${f.line} ${f.detail}`)
|
||||
}
|
||||
console.log(`\n合计命中：${findings.length}`)
|
||||
}
|
||||
process.exit(findings.length ? 1 : 0)
|
||||
}
|
||||
Reference in New Issue
Block a user