feat(zh): add Chinese translations in zh/ directory

Add Chinese (Simplified) translations for all documentation, organized under a dedicated zh/ directory that mirrors the English folder structure. Co-authored-by: tanqingkuang <tanqingkuang@users.noreply.github.com> Translations originally contributed by @tanqingkuang in #45. Restructured from *-CN.md suffix pattern into zh/ directory to prevent the EPUB builder (scripts/build_epub.py collect_folder_files) from picking up Chinese files via glob("*.md") inside module folders.
2026-04-06 23:08:54 +02:00
parent 100c45eef2
commit 89e89d4aa3
100 changed files with 20487 additions and 1 deletions
--- a/zh/QUICK_REFERENCE.md
+++ b/zh/QUICK_REFERENCE.md
@@ -0,0 +1,506 @@
+<picture>
+  <source media="(prefers-color-scheme: dark)" srcset="resources/logos/claude-howto-logo-dark.svg">
+  <img alt="Claude How To" src="resources/logos/claude-howto-logo.svg">
+</picture>
+
+# Claude Code 示例 - 速查卡
+
+## 🚀 安装速命令
+
+### Slash Commands
+```bash
+# 安装全部
+cp 01-slash-commands/*.md .claude/commands/
+
+# 安装单个
+cp 01-slash-commands/optimize.md .claude/commands/
+```
+
+### Memory
+```bash
+# 项目 memory
+cp 02-memory/project-CLAUDE.md ./CLAUDE.md
+
+# 个人 memory
+cp 02-memory/personal-CLAUDE.md ~/.claude/CLAUDE.md
+```
+
+### Skills
+```bash
+# 个人 skills
+cp -r 03-skills/code-review ~/.claude/skills/
+
+# 项目 skills
+cp -r 03-skills/code-review .claude/skills/
+```
+
+### Subagents
+```bash
+# 安装全部
+cp 04-subagents/*.md .claude/agents/
+
+# 安装单个
+cp 04-subagents/code-reviewer.md .claude/agents/
+```
+
+### MCP
+```bash
+# 设置凭据
+export GITHUB_TOKEN="your_token"
+export DATABASE_URL="postgresql://..."
+
+# 安装配置（项目级）
+cp 05-mcp/github-mcp.json .mcp.json
+
+# 或者用户级：添加到 ~/.claude.json
+```
+
+### Hooks
+```bash
+# 安装 hooks
+mkdir -p ~/.claude/hooks
+cp 06-hooks/*.sh ~/.claude/hooks/
+chmod +x ~/.claude/hooks/*.sh
+
+# 在 settings 中配置（~/.claude/settings.json）
+```
+
+### Plugins
+```bash
+# 从示例安装（如果已发布）
+/plugin install pr-review
+/plugin install devops-automation
+/plugin install documentation
+```
+
+### Checkpoints
+```bash
+# 每次用户提示后都会自动创建 checkpoint
+# 回退：按两次 Esc 或使用：
+/rewind
+
+# 然后选择：恢复代码和对话、恢复对话、
+# 恢复代码、从这里开始总结，或算了
+```
+
+### Advanced Features
+```bash
+# 在 settings 中配置（.claude/settings.json）
+# 参见 09-advanced-features/config-examples.json
+
+# planning mode
+/plan 任务描述
+
+# 权限模式（使用 --permission-mode 参数）
+# default          - 风险操作需要审批
+# acceptEdits      - 自动接受文件编辑，其他操作仍需审批
+# plan             - 只读分析，不做修改
+# dontAsk          - 除危险操作外全部接受
+# auto             - 后台分类器自动决定权限
+# bypassPermissions - 全部接受（需要 --dangerously-skip-permissions）
+
+# 会话管理
+/resume                # 恢复之前的对话
+/rename "name"         # 命名当前会话
+/fork                  # 分叉当前会话
+claude -c              # 继续最近的对话
+claude -r "session"    # 按名称/ID 恢复会话
+```
+
+---
+
+## 📋 功能速览
+
+| 功能 | 安装路径 | 用法 |
+|------|----------|------|
+| **Slash Commands（55+）** | `.claude/commands/*.md` | `/command-name` |
+| **Memory** | `./CLAUDE.md` | 自动加载 |
+| **Skills** | `.claude/skills/*/SKILL.md` | 自动触发 |
+| **Subagents** | `.claude/agents/*.md` | 自动委派 |
+| **MCP** | `.mcp.json`（项目）或 `~/.claude.json`（用户） | `/mcp__server__action` |
+| **Hooks（25 个事件）** | `~/.claude/hooks/*.sh` | 事件触发（4 类） |
+| **Plugins** | 通过 `/plugin install` | 打包所有能力 |
+| **Checkpoints** | 内置 | `Esc+Esc` 或 `/rewind` |
+| **Planning Mode** | 内置 | `/plan <task>` |
+| **Permission Modes（6 种）** | 内置 | `--allowedTools`、`--permission-mode` |
+| **Sessions** | 内置 | `/session <command>` |
+| **Background Tasks** | 内置 | 在后台运行 |
+| **Remote Control** | 内置 | WebSocket API |
+| **Web Sessions** | 内置 | `claude web` |
+| **Git Worktrees** | 内置 | `/worktree` |
+| **Auto Memory** | 内置 | 自动保存到 `CLAUDE.md` |
+| **Task List** | 内置 | `/task list` |
+| **Bundled Skills（5 个）** | 内置 | `/simplify`、`/loop`、`/claude-api`、`/voice`、`/browse` |
+
+---
+
+## 🎯 常见使用场景
+
+### 代码审查
+```bash
+# 方法 1：slash command
+cp 01-slash-commands/optimize.md .claude/commands/
+# 使用：/optimize
+
+# 方法 2：subagent
+cp 04-subagents/code-reviewer.md .claude/agents/
+# 使用：自动委派
+
+# 方法 3：skill
+cp -r 03-skills/code-review ~/.claude/skills/
+# 使用：自动触发
+
+# 方法 4：插件（推荐）
+/plugin install pr-review
+# 使用：/review-pr
+```
+
+### 文档
+```bash
+# slash command
+cp 01-slash-commands/generate-api-docs.md .claude/commands/
+
+# subagent
+cp 04-subagents/documentation-writer.md .claude/agents/
+
+# skill
+cp -r 03-skills/doc-generator ~/.claude/skills/
+
+# 插件（完整方案）
+/plugin install documentation
+```
+
+### DevOps
+```bash
+# 完整插件
+/plugin install devops-automation
+
+# 命令：/deploy、/rollback、/status、/incident
+```
+
+### 团队规范
+```bash
+# 项目 memory
+cp 02-memory/project-CLAUDE.md ./CLAUDE.md
+
+# 按你的团队规范编辑
+vim CLAUDE.md
+```
+
+### 自动化与 Hooks
+```bash
+# 安装 hooks（25 个事件，4 类：command、http、prompt、agent）
+mkdir -p ~/.claude/hooks
+cp 06-hooks/*.sh ~/.claude/hooks/
+chmod +x ~/.claude/hooks/*.sh
+
+# 示例：
+# - 提交前测试：pre-commit.sh
+# - 自动格式化代码：format-code.sh
+# - 安全扫描：security-scan.sh
+
+# 用 Auto Mode 实现全自动工作流
+claude --enable-auto-mode -p "重构并测试 auth 模块"
+# 或者用 Shift+Tab 在模式间切换
+```
+
+### 安全重构
+```bash
+# 每次提示前都会自动创建 checkpoint
+# 试着重构
+# 如果成功：继续
+# 如果失败：按 Esc+Esc 或使用 /rewind 返回
+```
+
+### 复杂实现
+```bash
+# 使用 planning mode
+/plan 实现用户认证系统
+
+# Claude 会创建详细计划
+# 你可以审阅并批准
+# Claude 会系统化地执行实现
+```
+
+### CI/CD 集成
+```bash
+# 以 headless 模式运行（非交互）
+claude -p "运行所有测试并生成报告"
+
+# 在 CI 中搭配权限模式
+claude -p "运行测试" --permission-mode dontAsk
+
+# 使用 Auto Mode 实现完全自治的 CI 任务
+claude --enable-auto-mode -p "运行测试并修复失败项"
+
+# 结合 hooks 做自动化
+# 参见 09-advanced-features/README.md
+```
+
+### 学习与实验
+```bash
+# 用 plan mode 做安全分析
+claude --permission-mode plan
+
+# 安全实验 - checkpoint 会自动创建
+# 如果需要回退：按 Esc+Esc 或使用 /rewind
+```
+
+### Agent 团队
+```bash
+# 启用 agent 团队
+export CLAUDE_AGENT_TEAMS=1
+
+# 或者在 settings.json 中
+{ "agentTeams": { "enabled": true } }
+
+# 用这句话开始："使用团队方式实现功能 X"
+```
+
+### 定时任务
+```bash
+# 每 5 分钟运行一次命令
+/loop 5m /check-status
+
+# 一次性提醒
+/loop 30m "提醒我检查部署"
+```
+
+---
+
+## 📁 文件位置参考
+
+```text
+Your Project/
+├── .claude/
+│   ├── commands/              # Slash commands 放这里
+│   ├── agents/                # Subagents 放这里
+│   ├── skills/                # 项目 skills 放这里
+│   └── settings.json          # 项目设置（hooks 等）
+├── .mcp.json                  # MCP 配置（项目级）
+├── CLAUDE.md                  # 项目 memory
+└── src/
+    └── api/
+        └── CLAUDE.md          # 目录级 memory
+
+User Home/
+├── .claude/
+│   ├── commands/              # 个人命令
+│   ├── agents/                # 个人 agents
+│   ├── skills/                # 个人 skills
+│   ├── hooks/                 # hook 脚本
+│   ├── settings.json          # 用户设置
+│   ├── managed-settings.d/    # 托管设置（企业/组织）
+│   └── CLAUDE.md              # 个人 memory
+└── .claude.json               # 个人 MCP 配置（用户级）
+```
+
+---
+
+## 🔍 查找示例
+
+### 按分类
+- **Slash Commands**：`01-slash-commands/`
+- **Memory**：`02-memory/`
+- **Skills**：`03-skills/`
+- **Subagents**：`04-subagents/`
+- **MCP**：`05-mcp/`
+- **Hooks**：`06-hooks/`
+- **Plugins**：`07-plugins/`
+- **Checkpoints**：`08-checkpoints/`
+- **Advanced Features**：`09-advanced-features/`
+- **CLI**：`10-cli/`
+
+### 按使用场景
+- **性能**：`01-slash-commands/optimize.md`
+- **安全**：`04-subagents/secure-reviewer.md`
+- **测试**：`04-subagents/test-engineer.md`
+- **文档**：`03-skills/doc-generator/`
+- **DevOps**：`07-plugins/devops-automation/`
+
+### 按复杂度
+- **简单**：Slash commands
+- **中等**：Subagents、Memory
+- **高级**：Skills、Hooks
+- **完整**：Plugins
+
+---
+
+## 🎓 学习路径
+
+### 第 1 天
+```bash
+# 阅读总览
+cat README.md
+
+# 安装一个命令
+cp 01-slash-commands/optimize.md .claude/commands/
+
+# 试用
+/optimize
+```
+
+### 第 2-3 天
+```bash
+# 设置 memory
+cp 02-memory/project-CLAUDE.md ./CLAUDE.md
+vim CLAUDE.md
+
+# 安装 subagent
+cp 04-subagents/code-reviewer.md .claude/agents/
+```
+
+### 第 4-5 天
+```bash
+# 设置 MCP
+export GITHUB_TOKEN="your_token"
+cp 05-mcp/github-mcp.json .mcp.json
+
+# 试用 MCP 命令
+/mcp__github__list_prs
+```
+
+### 第 2 周
+```bash
+# 安装 skill
+cp -r 03-skills/code-review ~/.claude/skills/
+
+# 让它自动触发
+# 直接说：“Review this code for issues”
+```
+
+### 第 3 周及以后
+```bash
+# 安装完整插件
+/plugin install pr-review
+
+# 使用打包功能
+/review-pr
+/check-security
+/check-tests
+```
+
+---
+
+## 🆕 新功能（2026 年 3 月）
+
+| 功能 | 说明 | 用法 |
+|------|------|------|
+| **Auto Mode** | 通过后台分类器实现完全自治 | `--enable-auto-mode` 参数，`Shift+Tab` 切换模式 |
+| **Channels** | Discord 和 Telegram 集成 | `--channels` 参数，Discord / Telegram bot |
+| **Voice Dictation** | 对 Claude 说出命令和上下文 | `/voice` 命令 |
+| **Hooks（25 个事件）** | 扩展后的 hook 系统，包含 4 类 | command、http、prompt、agent hook 类型 |
+| **MCP Elicitation** | MCP server 可在运行时请求用户输入 | 当 server 需要澄清时自动提示 |
+| **WebSocket MCP** | MCP 的 WebSocket 传输 | 在 `.mcp.json` 中配置 `ws://` URL |
+| **Plugin LSP** | 插件支持 Language Server Protocol | `userConfig`、`${CLAUDE_PLUGIN_DATA}` 变量 |
+| **Remote Control** | 通过 WebSocket API 控制 Claude Code | `claude --remote` 用于外部集成 |
+| **Web Sessions** | 基于浏览器的 Claude Code 接口 | 使用 `claude web` 打开 |
+| **Desktop App** | 原生桌面应用 | 从 claude.ai/download 下载 |
+| **Task List** | 管理后台任务 | `/task list`、`/task status <id>` |
+| **Auto Memory** | 从对话中自动保存记忆 | Claude 会自动保存关键上下文到 `CLAUDE.md` |
+| **Git Worktrees** | 用于并行开发的隔离工作区 | 使用 `/worktree` 创建隔离空间 |
+| **Model Selection** | 在 Sonnet 4.6 和 Opus 4.6 之间切换 | `/model` 或 `--model` 参数 |
+| **Agent Teams** | 协调多个 agent 执行任务 | 通过环境变量 `CLAUDE_AGENT_TEAMS=1` 启用 |
+| **Scheduled Tasks** | 使用 `/loop` 运行周期任务 | `/loop 5m /command` 或 CronCreate 工具 |
+| **Chrome Integration** | 浏览器自动化 | `--chrome` 参数或 `/chrome` 命令 |
+| **Keyboard Customization** | 自定义按键绑定 | `/keybindings` 命令 |
+
+---
+
+## 💡 小技巧
+
+### 自定义
+- 先原样使用示例
+- 再按需求修改
+- 分享给团队前先测试
+- 对配置做版本控制
+
+### 最佳实践
+- 用 memory 保存团队规范
+- 用 plugins 做完整工作流
+- 用 subagents 处理复杂任务
+- 用 slash commands 处理快速任务
+
+### 故障排查
+```bash
+# 检查文件位置
+ls -la .claude/commands/
+ls -la .claude/agents/
+
+# 验证 YAML 语法
+head -20 .claude/agents/code-reviewer.md
+
+# 测试 MCP 连接
+echo $GITHUB_TOKEN
+```
+
+---
+
+## 📊 功能矩阵
+
+| 需求 | 用这个 | 示例 |
+|------|--------|------|
+| 快速快捷操作 | Slash Command（55+） | `01-slash-commands/optimize.md` |
+| 团队规范 | Memory | `02-memory/project-CLAUDE.md` |
+| 自动化工作流 | Skill | `03-skills/code-review/` |
+| 专门任务 | Subagent | `04-subagents/code-reviewer.md` |
+| 外部数据 | MCP（+ Elicitation、WebSocket） | `05-mcp/github-mcp.json` |
+| 事件自动化 | Hook（25 个事件、4 类） | `06-hooks/pre-commit.sh` |
+| 完整方案 | Plugin（+ LSP 支持） | `07-plugins/pr-review/` |
+| 安全实验 | Checkpoint | `08-checkpoints/checkpoint-examples.md` |
+| 完全自治 | Auto Mode | `--enable-auto-mode` 或 `Shift+Tab` |
+| 聊天集成 | Channels | `--channels`（Discord、Telegram） |
+| CI/CD 流水线 | CLI | `10-cli/README.md` |
+
+---
+
+## 🔗 快速链接
+
+- **主指南**：`README.md`
+- **完整索引**：`INDEX.md`
+- **速查卡**：`QUICK_REFERENCE.md`
+- **原始指南**：`claude_concepts_guide.md`
+
+---
+
+## 📞 常见问题
+
+**问：我应该先用哪个？**
+答：先从 slash commands 开始，按需逐步添加功能。
+
+**问：我可以混用多个功能吗？**
+答：可以！它们可以一起工作。Memory + Commands + MCP 很强大。
+
+**问：怎么分享给团队？**
+答：把 `.claude/` 目录提交到 git。
+
+**问：敏感信息怎么办？**
+答：用环境变量，不要硬编码。
+
+**问：我可以改这些示例吗？**
+答：当然可以！它们本来就是可定制的模板。
+
+---
+
+## ✅ 检查清单
+
+入门清单：
+
+- [ ] 阅读 `README.md`
+- [ ] 安装 1 个 slash command
+- [ ] 试用该命令
+- [ ] 创建项目 `CLAUDE.md`
+- [ ] 安装 1 个 subagent
+- [ ] 配置 1 个 MCP 集成
+- [ ] 安装 1 个 skill
+- [ ] 试用一个完整插件
+- [ ] 按你的需求定制
+- [ ] 与团队共享
+
+---
+
+**快速开始**：`cat README.md`
+
+**完整索引**：`cat INDEX.md`
+
+**这张卡片**：建议随手保留，方便快速查阅！