CJK Game Doctor

一个面向中、日、韩游戏文本的确定性发布前检查 CLI。无需账号、外部 API 或 AI 评分，项目文本默认不会离开本机。

快速开始

需要 Node.js 20 或更高版本。

npx cjk-game-doctor scan ./locales
cjk-game-doctor scan ./locales --json report.json --html report.html --sarif report.sarif

SARIF 2.1 报告可上传到 GitHub Code Scanning。

已有项目可以记录当前问题作为基线，让 CI 只阻止新增问题：

cjk-game-doctor scan ./locales --write-baseline cjk-baseline.json --fail-on never
cjk-game-doctor scan ./locales --baseline cjk-baseline.json --fail-on warning

当前检查项：

• 损坏或跨语言不一致的占位符
• CJK 文本中疑似残留的英文
• 日语中的可疑 ASCII 标点、全角字符和空格
• 单句中可能混用日语敬体与常体的保守启发式
• 项目实际使用的 CJK 字符清单
• 与可选字体字符清单比较，发现疑似缺字

支持 JSON、CSV、TSV、TXT、简单 YAML、Apple .strings 和简单 .po。本工具不会声称能够自动判断翻译质量、角色口吻或文化适配；这些仍需要人工审校。

在扫描目录放置 cjk-doctor.config.json，可以配置忽略路径、禁用规则、严重级别及源语言。详见英文 README、配置示例和扩展API。

MIT License。

相关规范、字体和游戏引擎资料整理在 Awesome CJK Game Development。