文案体检报告
全库扫描 10498 条面向玩家的文本(i18n / 任务对话 / 引导 / 装备描述 / 界面硬编码 / 服务端提示), 用 60+ 词的三级词库找出所有还带西幻味的文字。 ⚠ 本报告只治「西幻中文词」这一种病。 「界面里还看得见英文」是另一种病(属性键名、Lv.、CD、MAX…)—— 它们没有中文词根, 词库扫不出来。所以第一版报告写着「残留 0」,玩家仍在装备 Tips 里看到agilityDamageAddRate。英文残留见第八章,工具是tools/_archive/scan-en.mjs+tools/check-ui-en.mjs(决策 D-099)。
一、扫描器
node tools/_archive/scan-l10n.mjs # 体检报告(按词统计 + 样例)
node tools/_archive/scan-l10n.mjs --json # 输出 JSON
node tools/_archive/scan-l10n.mjs --word 骑士 # 只看某个词
扫描范围:
| 来源 | 条数 | 说明 |
|---|---|---|
client/public/data/i18n.json | 7213 | 技能 / 物品 / 怪物 / 地图 / 界面 |
client/public/data/story.json | 2900 | 任务对话、引导、图鉴描述(固化长文本) |
village_layout.json / classes.json | 60 | 村庄 NPC 台词、职业名 |
client/src/**.js + index.html | ~300 | 界面硬编码字符串 |
server/src/**.js | ~25 | 面向玩家的提示语 |
词库分三级:hard(必改,明确西幻/音译)、soft(视语境)、keep(中文语境已通用的白名单)。
二、本轮清掉的(373 → 0)
| 轮次 | 处理对象 | 命中 | 做法 |
|---|---|---|---|
| 1 | i18n + 词典覆盖层 | 93 | 前几轮已改,剩 17 条补规则 |
| 2 | story.json 长文本 | 265 | 新增 tools/apply-story.mjs,把词根 + 专名级联应用到固化长文本(993 条改写) |
| 3 | 残余翻译腔 | 112 | 扩 18 组词:亡灵→亡魂、术士→术师、法术→术法、祭坛→法坛、传送门→界门、仪式→仪轨… |
| 4 | 代码硬编码 + 品阶体系 | 20 | 手工改 + 品阶统一 |
关键发现:story.json 从来没被处理过
前几轮的 apply-naming.mjs 只处理 i18n 的 key → 值,而 story.json 是已经固化成中文的长文本 (任务描述里直接写着"恶魔遗留的力量""达恩之森""地精""牧首")。
新增 tools/apply-story.mjs 直接对长文本做「词根规则 + 专名级联」改写, 一次处理 993 条,且与 i18n 用同一套词表,保证前后一致。
样例:
| 原 | 新 |
|---|---|
| 恶魔遗留的力量使得周遭的一切都发生了异变… | 邪祟遗留的力量使得周遭的一切都发生了异变… |
| 达恩之森在震颤,震颤的源头便来自那坍塌的洞窟深处 | 临渊之森在震颤,震颤的源头便来自那坍塌的洞窟深处 |
| 在那群地精当中竟然冒出了一个自称为"魔法老师"的家伙 | 在那群山魈当中竟然冒出了一个自称为"授法道人"的家伙 |
| 拉德纳在上,作为圣职者,我们本不该随意谈及金钱 | 赤霄在上,作为天师,我们本不该随意谈及金钱 |
| 各大王国与家族已经同意对我们的探索行动予以更多支持 | 各大国度与家族已经同意对我们的探索行动予以更多支持 |
三、品阶体系统一
原版品阶名混着西幻与通用词,现在统一成中式品阶:
| 原 | 新 | 原 | 新 |
|---|---|---|---|
| 普通 | 凡品 | 稀有 | 珍品 |
| 精良 | 良品 | 史诗(门客) | 绝品 |
| 术法(品阶) | 灵品 | 传说(门客) | 神品 |
| 套装 | 成套 | 手工 | 匠作 |
| 传世 | 传世 |
四、第四轮:通用奇幻术语 → 武侠修真术语
「魔法」清掉之后,还剩一批中文本身没问题、但明显偏西式奇幻的术语(灵力、术法、玄术、施法)。 玩家能感觉到"这不是武侠",所以整批换掉:
| 原 | 新 | 说明 |
|---|---|---|
| 灵力值 / 灵力 | 内力 | mp |
| 术法 | 道术 | 「火焰术法」→「火焰道术」 |
| 玄术(伤害/增强/穿透/吸收/减免) | 内伤 | 原版 magic damage,武侠对应「内伤」 |
| 物理(伤害/减免/吸收) | 外伤 | 与内伤成对 |
| 施法速度 | 运功速度 | 「施法」→「运功」 |
| 魔力 | 真元 | |
| 术法装备掉落 | 奇珍掉落 | magicFind |
| 奥术(伤害类型) | 内伤 | DMG_NAME 同步改 |
四维也统一成 臂力 / 身法 / 根骨 / 悟性(门客面板早就用了这套,这次把 i18n 的 78 条属性名对齐)。
属性名表(data/naming/lexicon-attrs.tsv,78 条)
1 臂力 2 身法 3 根骨 4 悟性
9 气血 10 内力 11 攻势 12 护体
13 招架率 14 会心率 18 出手速度 19 招架减伤
21 气血回复 22 内力回复 23 运功速度 24 银两掉落
34 内伤增强 39 内伤穿透 45 附加内伤 50/56 内伤吸收 62 内伤减免
40 外伤穿透 51/57 外伤吸收 63 外伤减免
117 受伤回内力 118 破防
品阶名第二次统一
第一轮改成 凡品/良品/灵品/珍品,但代码里还有 3 处数组写着「普通/精良/稀有/史诗/传说」 (门客卡片、图鉴筛选、品质提示),这次一并改成 凡品/良品/珍品/绝品/神品。
五、踩到的坑:长文本替换会叠字
apply-story.mjs 的规则里有些是新值包含旧值(钉皮甲 → 铆钉皮甲、甲 → 铠甲)。 直接 split/join 的话,每跑一次就再叠一层前缀 —— 实测跑出了「铆铆铆铆钉皮甲」。
修复:只要文本里已经出现新值就跳过该规则(to.includes(from) && v.includes(to) 时 return)。 修复后连跑两次,第二次改写 0 条,确认幂等。
顺带做了三连叠字检查(正则 ([一-龥])),全库 0 命中。
六、现在还剩什么(西幻中文词)
零。 10498 条文本对 60+ 西幻词扫描,命中 0。
唯一保留的英文是 DPS(已改成「秒伤」)和资源文件名(Sprite/SkillIcon/...,玩家看不到)。
但要小心:这一段只说明「没有西幻中文词」,不等于「界面上没有英文」。 真正的英文残留见第八章。
七、维护方式
改完词表后按顺序跑:
node tools/apply-naming.mjs # i18n 词典 → overlay(含等级写法统一)
node tools/build-data.mjs # 刷新客户端数据包(npm run build:data)
node tools/apply-story.mjs # 长文本(story / village_layout),读上一步的 i18n.json
node tools/rewrite-ui.mjs # 界面硬编码
node tools/_archive/scan-l10n.mjs # 西幻中文词体检
node tools/_archive/scan-en.mjs # 拉丁字母残留(源码层)
node tools/check-ui-en.mjs # 界面英文残留(渲染层,真兜底)
apply-story.mjs 会自动备份到 .backup/story-<时间戳>/,改坏了能回滚。
八、界面英文残留(第二批问题,D-099)
为什么上一轮没查出来
scan-l10n.mjs 的判据是「命中西幻词库」,而英文残留根本没有中文词根:
| 残留 | 为什么词库扫不到 |
|---|---|
agilityDamageAddRate | 属性键名,不是中文 |
Lv.13 / CD 3s / MAX / NEW | 拉丁缩写,不在词库里 |
持续 lv+20 秒 | 配置公式直接拼进了文案 |
所以「残留 0」是真的,但只覆盖了一种病。用户看到装备 Tips 里那串英文键名时, 体检报告是绿的 —— 这是判据不完备,不是执行不到位。
根因:属性键查不到译名就回退成键名
server/src/index.js 的 statLinesOf() 原来写的是:
const label = attrLabel(k, meta?.z || k); // ← 查不到就显示 k 本身
shared/items.js 会为敏捷系底材生成 agilityDamageAddRate,而 shared/attr-labels.js 与 server/src/attr_names.json 两张表都没有这个键 —— 于是玩家在装备 Tips 里看到原始键名。同理 slotName 有两处直接拼 it.slotName, 显示成 helm / weapon。
修法(三层一起)
- 补齐译名:
agilityDamageAddRate(身法伤害加成)、stunChance、freezeChance、reqReduce - 兜底改成空串:
attrLabel(k, meta?.z || ''),没有中文名的行宁可不显示 ——
漏一行属性没人发现,露出英文键人人都会看见
slotName统一走SLOT_CN,映射表没有的键直接略过
决策 D-099(用户确认,2026-10-26)
| 问题 | 结论 |
|---|---|
| 属性名译法 | 身法伤害加成 / 眩晕概率 / 冰冻概率 / 穿戴需求降低(与四维「臂力·身法·根骨·悟性」一致) |
| 等级写法 | 数字+级:13级、地图标题「13级 幽篁入口」、持续「等级+20」秒 |
| 三个死属性 | 不显示 —— stunChance/freezeChance/reqReduce 有数据但无任何战斗代码读取,显示等于告诉玩家一条不生效的属性 |
本轮清掉的
| 来源 | 数量 | 处理 |
|---|---|---|
| i18n 等级缩写 | 89 条 | apply-naming.mjs 新增「等级写法统一」批,正则 LV.76/Lv{0} → 76级/{0}级 |
| story 长文本 | 7 条 | apply-story.mjs 的 rewrite() 末尾过同一套规整 |
| 界面硬编码 | 20 组 | Lv.→N级、CD 3s→回气 3 秒、13s→13秒、/s→/秒、MAX→满、NEW→新 |
| 江湖舆图 | 3 处 | 节点 Lv1→1级、详情、跳转 toast(这层不在 10 个 TAB 里,探针一开始漏了) |
| 服务端提示语 | 4 处 | 修为/门客等级不足提示、释放 Lv1 → 释放 1级 |
| 战斗浮字 | 1 处 | MISS → 未命中 |
| 属性键 | 4 个 | 补译名 + 消灭英文回退 |
slotName | 2 处 | 走 SLOT_CN |
两个防回归工具
node tools/_archive/scan-en.mjs # 源码层:分 A 高置信 / B 中置信 / C 待复核 三档
node tools/_archive/scan-en.mjs --strict # A/B 有命中即退出码 1(可进门禁)
node tools/check-ui-en.mjs # 渲染层:无头浏览器点完 10 个 TAB + 江湖舆图 + 右键菜单
scan-en.mjs 有个反直觉的细节:它必须能抓到旧代码,否则「扫描通过」毫无意义。 验证方式是拿 .backup/ 里的旧版 ui.js 回测:
node tools/_archive/scan-en.mjs .backup/ui-2026-10-24T18-00-52/client/src/ui/ui.js
# 应报出 Lv / NEW / CD / s 共 10 处
开发过程中第一版扫描器因为「把任何单词都当标识符放行」+「把所有目标路径拼成一个字符串」 两次返回假的「未发现英文残留」。扫描器自己也要被回测验证。
已知遗留:两个探针的预期值过期(与本轮无关)
| 探针 | 失败项 | 原因 |
|---|---|---|
check-tabs.mjs | TAB 名称/子页断言 3 项 | 界面早已把「商铺→赌博」「丹房→合成」,探针 EXPECT 没跟着改 |
check-item-tips.mjs | 镶嵌相关 6 项 | 测试存档 p23test 里没有符箓、也没有带空孔的装备 |
已用 git stash 回到改动前跑同一批探针,失败项完全一致,确认是既有问题不是本轮引入。 要修的话属于另一件事(探针维护),不在文案修复范围。