LLMSkillHub
mirroredCopied from taekchef/claude-code-zh-cn under MIT. taekchef has not claimed this page, and is not affiliated with LLM SkillHub.

taekchef / zh-cn-setup

完成 Claude Code 中文本地化的首次增强安装——把 spinner/界面中文化配置合并进 settings.json、检测并同步 CC Switch 通用配置、提示重启让 CLI patch 生效。中文用户安装本插件后如发现 spinner 动词/提示仍是英文，或想完整启用中文化，请使用本 skill。

0
SKILL.md
4.3 KB

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"

脚本会自动完成：

  1. 合并 spinner 中文化配置到 ~/.claude/settings.json（从插件内置的 verbs/tips 数据构建，只补齐缺失项，不覆盖用户已有配置；带备份 + 原子写）
  2. 检测 CC Switch：若检测到 CC Switch 的通用配置缺少中文设置，脚本会输出需要用户确认的提示——因为是交互式安装，请把脚本输出的指令原文转达给用户，让用户决定是否授权同步
  3. 报告 patch 状态并提示是否需要重启
  4. 输出 skill 描述汉化的只读扫描、翻译和恢复命令；CC Switch skill 位于 ~/.claude 外时，使用 ZH_CN_SKILL_I18N_EXTRA_ROOTS 指定真实目录
  5. 检测 CC Switch 数据库 skill 描述：若 ~/.cc-switch/cc-switch.db 的 skills 表中描述仍为英文、但对应 SKILL.md 已翻译为中文，脚本会提示运行可选工具 cc-switch-descriptions.js（默认只读预览，--apply 才写入并先备份数据库，输出还原命令）

重要约束

  • 不要在 skill 里调用 claude plugin install / claude plugin update：插件本体的安装/更新由用户手动或 Claude plugin manager 负责，避免"插件装自己/更新自己"的循环
  • CLI patch（npm cli.js / native exe）由 session-start hook 自动维护，不在本 skill 内手动 patch。native exe 更新后需要用户关闭所有 Claude Code 窗口再重开，脚本会提示
  • CC Switch 数据库写入必须由用户主动授权：cc-switch-descriptions.js 的 --apply 只在用户主动运行时执行，skill 只输出命令，不在进程内替用户写数据库
  • 脚本所有写操作都带备份和失败回滚，不会让机器配置损坏

CC Switch skill 描述同步工具

ZH_CN_SKILL_I18N_EXTRA_ROOTS 只翻译 SKILL.md 文件本体，不会写 CC Switch 数据库。若脚本检测到 ~/.cc-switch/cc-switch.db 的 skills 表描述仍为英文，把以下命令原文转达给用户：

# 只读预览（默认，不写入）
node "${CLAUDE_PLUGIN_ROOT}/skills/zh-cn-setup/scripts/cc-switch-descriptions.js"
# 确认后写入（先备份数据库，输出还原命令）
node "${CLAUDE_PLUGIN_ROOT}/skills/zh-cn-setup/scripts/cc-switch-descriptions.js" --apply

同一份 description 同时用于 CC Switch 管理界面、Claude Code /skills 面板和 model 自动触发，所以默认只读、由用户决定是否 --apply。

给用户的最终提示

脚本跑完后，根据其输出告诉用户：

  • 如果提示"请重启 Claude Code"：说明 CLI patch 已由 hook 处理，重启后生效
  • 如果提示 CC Switch 同步：把脚本给出的手动步骤或授权命令转给用户
  • 如果提示 Windows 需手动运行 install.ps1 -UpdateOnly：确认用户已完全退出所有 Claude Code 窗口后，把脚本输出的两行命令原文转给用户（Set-Location '<目录>' + powershell ... -File .\install.ps1 -UpdateOnly）。务必提醒扩展名必须是 .ps1（末尾的 1 不能漏），否则 PowerShell 会报 the file does not have a '.ps1' extension。