zh-fix

Claude Code 里改单个 .md / .html 的中文标点 —— 半角换全角，加盘古空格，跳过代码/URL/HTML。

before: 你好,世界.这是一个测试,带边界(英文),还有.
after:  你好，世界。这是一个测试，带边界 (英文)，还有。

需要 Claude Code —— 它装个 /zhfix skill，你说 /zhfix prd.md 或者 "把 prd.md 改成中文标点"，Claude 就会调它去改。不会自动改任何文件，只有你明说才动手。

安装

推荐直接让 AI 代劳 —— 把这句发给你的 Claude Code:

帮我装一下 zhfix(npm i -g zhfix 再 zhfix install)，装好告诉我怎么用

想自己敲也行，两条命令：

npm i -g zhfix     # 装命令 + 依赖
zhfix install      # 装 /zhfix skill 到 Claude Code

装完重启 Claude Code 生效。

怎么用

在 Claude Code 里：

/zhfix prd.md

或者自然语言触发，任何包含"标点 / 全角 / 半角"+ 单个文件名的话都会触发，例如：

• "把 prd.md 改成中文标点"
• "prd.md 全角化一下"
• "修一下 docs/api.md 的半角逗号"
• "把 prd.md 第三段的标点改成全角"(范围 + 文件)

改前自动备份，不满意：

zhfix restore prd.md     # 还原到最近一次 /zhfix 改之前

能改 / 不改什么

• ✅ .md .markdown .html .htm
• ✅ 补上 AutoCorrect 漏掉的 ; : 边界 ,
• ✅ 不碰 markdown 结构、代码块、URL、HTML 里的 JS 和属性值
• ❌ 不动纯英文、纯代码、纯数字
• ❌ 不把引号强行改成西式弯引号 ""，保留你自己的引号风格 (「」 "" 等)
• ❌ 不接受目录 / 通配符 / 批量，一次只改一个文件
• ❌ 不接受"把引号改成『』"这类指定非标准目标的改写 —— 不是 zh-fix 的职责

安全性

• 改前自动备份到 ~/.zhfix/backups/，zhfix restore <文件> 一键还原
• 出错时直接放行，不报错地中止
• 写文件用临时文件 + 原子替换，失败不会留下半个文件
• 拒绝可疑路径 (危险字符、网络路径、软链等)，跳过 100MB 以上的大文件
• 每次操作都记日志：~/.claude/zh-fix.log

不想让某个文件被处理：首行加 <!-- zh-fix: off -->。

从老版本升级

0.1.x / 0.2.0 时 zhfix 装的是 Claude Code hook，会在你写 md 时自动改半角。0.3.0 起取消自动 hook，只保留主动调的 /zhfix skill。

升级一行命令搞定：

zhfix update

它会：

1. npm i -g zhfix@latest 拉最新版
2. 自动清掉 ~/.claude/settings.json 里旧的 hook 注册
3. 删掉 ~/.claude/hooks/zh-fix-auto.sh bash 包装
4. 重装 /zhfix skill

跑完重启 Claude Code，不会再有"写完就被自动改"的行为，只有你主动 /zhfix 才改。

卸载

zhfix uninstall            # 清掉接入(config/skill + 旧 hook 残留)
npm uninstall -g zhfix     # 删本体(命令 + 依赖)

顺序别反 —— 卸了本体就没 zhfix 命令了。

排错

| 现象 | 怎么办 | |---|---| | 不确定有没有装好 | zhfix status | | /zhfix 不触发 | 确认重启过 Claude Code(skill 要重启才加载) | | zhfix 命令找不到 | 重开终端；还不行检查 npm 全局 bin 在不在 PATH | | 配置坏了 | zhfix init 重写 (同时清旧 hook 残留) | | 想紧急关掉 | zhfix uninstall |

命令清单

zhfix install                首次接入 Claude Code
zhfix init [tool 路径]       重新绑定 / 修复配置(同时清旧 hook 残留)
zhfix status                 看状态 + 今日活动 + 旧版残留检测
zhfix restore <文件>         还原文件到 /zhfix 改之前的备份
zhfix clear-backups [--yes]  清理备份
zhfix update                 升级到最新版并刷新接入
zhfix uninstall [--all]      卸载接入(本体另跑 npm uninstall -g zhfix)
zhfix help                   帮助

给维护者

• 本地开发：repo 根目录 node install/install.mjs，再 npm link 拿全局命令。
• 不要随便升级 autocorrect-node。补丁规则是按 2.14.0 的行为写死的，升级容易双改或反向破坏，升级前用真实样本验证残留。
• 不要手改 ~/.zhfix/config.json，zhfix init 会覆盖。
• 0.3.0 拆除了自动 hook(0.1.x PostToolUse / 0.2.0 PreToolUse)，只保留 skill 主动触发。架构、规则实现见 AGENTS.md 和 tool/ 源码。

License

MIT