zh-cn-setup

1# zh-cn-setup：中文本地化增强安装
2 
3本 skill 是 `claude-code-zh-cn` 插件的首次增强安装入口。在用户通过 `claude plugin marketplace add` + `claude plugin install` 装好插件后，运行本 skill 可补齐以下"装插件本身不会自动完成"的步骤。
4 
5## 何时使用
6 
7当用户表达以下意图时主动触发：
8 
9- "spinner 还是英文" / "转圈的文字没翻译"
10- "怎么完整启用中文" / "安装完后还要做什么"
11- 在 Windows / macOS / Linux 上刚装好插件，想确认中文化是否完整
12 
13## 执行步骤
14 
15运行跨平台安装脚本（macOS / Linux / Windows 通用，需 Node.js）：
16 
17```bash
18node "${CLAUDE_PLUGIN_ROOT}/skills/zh-cn-setup/scripts/setup.js"
19```
20 
21脚本会自动完成：
22 
231. **合并 spinner 中文化配置**到 `~/.claude/settings.json`（从插件内置的 verbs/tips 数据构建，只补齐缺失项，不覆盖用户已有配置；带备份 + 原子写）
242. **检测 CC Switch**：若检测到 CC Switch 的通用配置缺少中文设置，脚本会输出需要用户确认的提示——因为是交互式安装，**请把脚本输出的指令原文转达给用户**，让用户决定是否授权同步
253. **报告 patch 状态**并提示是否需要重启
264. **输出 skill 描述汉化的只读扫描、翻译和恢复命令**；CC Switch skill 位于 `~/.claude` 外时，使用 `ZH_CN_SKILL_I18N_EXTRA_ROOTS` 指定真实目录
275. **检测 CC Switch 数据库 skill 描述**：若 `~/.cc-switch/cc-switch.db` 的 `skills` 表中描述仍为英文、但对应 `SKILL.md` 已翻译为中文，脚本会提示运行可选工具 `cc-switch-descriptions.js`（默认只读预览，`--apply` 才写入并先备份数据库，输出还原命令）
28 
29## 重要约束
30 
31- **不要**在 skill 里调用 `claude plugin install` / `claude plugin update`：插件本体的安装/更新由用户手动或 Claude plugin manager 负责，避免"插件装自己/更新自己"的循环
32- **CLI patch（npm cli.js / native exe）由 session-start hook 自动维护**，不在本 skill 内手动 patch。native exe 更新后需要用户关闭所有 Claude Code 窗口再重开，脚本会提示
33- **CC Switch 数据库写入必须由用户主动授权**：`cc-switch-descriptions.js` 的 `--apply` 只在用户主动运行时执行，skill 只输出命令，不在进程内替用户写数据库
34- 脚本所有写操作都带备份和失败回滚，不会让机器配置损坏
35 
36## CC Switch skill 描述同步工具
37…