| name | zh-cn-setup |
| description | 完成 Claude Code 中文本地化的首次增强安装——把 spinner/界面中文化配置合并进 settings.json、检测并同步 CC Switch 通用配置、提示重启让 CLI patch 生效。中文用户安装本插件后如发现 spinner 动词/提示仍是英文,或想完整启用中文化,请使用本 skill。 |
| allowed-tools | Bash(node:${CLAUDE_PLUGIN_ROOT}/skills/zh-cn-setup/scripts/setup.js:*), Bash(node:*skills/zh-cn-setup/scripts/setup.js*:*), Write, Read |
zh-cn-setup:中文本地化增强安装
本 skill 是 claude-code-zh-cn 插件的首次增强安装入口。在用户通过 claude plugin marketplace add + claude plugin install 装好插件后,运行本 skill 可补齐以下"装插件本身不会自动完成"的步骤。
何时使用
当用户表达以下意图时主动触发:
- "spinner 还是英文" / "转圈的文字没翻译"
- "怎么完整启用中文" / "安装完后还要做什么"
- 在 Windows / macOS / Linux 上刚装好插件,想确认中文化是否完整
执行步骤
运行跨平台安装脚本(macOS / Linux / Windows 通用,需 Node.js):
node "${CLAUDE_PLUGIN_ROOT}/skills/zh-cn-setup/scripts/setup.js"
脚本会自动完成:
- 合并 spinner 中文化配置到
~/.claude/settings.json(从插件内置的 verbs/tips 数据构建,只补齐缺失项,不覆盖用户已有配置;带备份 + 原子写)
- 检测 CC Switch:若检测到 CC Switch 的通用配置缺少中文设置,脚本会输出需要用户确认的提示——因为是交互式安装,请把脚本输出的指令原文转达给用户,让用户决定是否授权同步
- 报告 patch 状态并提示是否需要重启
- 输出 skill 描述汉化的只读扫描、翻译和恢复命令;CC Switch skill 位于
~/.claude 外时,使用 ZH_CN_SKILL_I18N_EXTRA_ROOTS 指定真实目录
- 检测 CC Switch 数据库 skill 描述:若
~/.cc-switch/cc-switch.db 的 skills 表中描述仍为英文、但对应 已翻译为中文,脚本会提示运行可选工具 (默认只读预览, 才写入并先备份数据库,输出还原命令)