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/resources.md
+++ b/zh/resources.md
@@ -0,0 +1,248 @@
+<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 文档 | Claude Code 官方文档 | [code.claude.com/docs/en/overview](https://code.claude.com/docs/en/overview) |
+| Anthropic 文档 | Anthropic 完整文档 | [docs.anthropic.com](https://docs.anthropic.com) |
+| MCP Protocol | Model Context Protocol 规范 | [modelcontextprotocol.io](https://modelcontextprotocol.io) |
+| MCP Servers | 官方 MCP server 实现 | [github.com/modelcontextprotocol/servers](https://github.com/modelcontextprotocol/servers) |
+| Anthropic Cookbook | 代码示例和教程 | [github.com/anthropics/anthropic-cookbook](https://github.com/anthropics/anthropic-cookbook) |
+| Claude Code Skills | 社区技能仓库 | [github.com/anthropics/skills](https://github.com/anthropics/skills) |
+| Agent Teams | 多 agent 协作与协调 | [code.claude.com/docs/en/agent-teams](https://code.claude.com/docs/en/agent-teams) |
+| Scheduled Tasks | 使用 `/loop` 和 cron 的周期性任务 | [code.claude.com/docs/en/scheduled-tasks](https://code.claude.com/docs/en/scheduled-tasks) |
+| Chrome Integration | 浏览器自动化 | [code.claude.com/docs/en/chrome](https://code.claude.com/docs/en/chrome) |
+| Keybindings | 键盘快捷键自定义 | [code.claude.com/docs/en/keybindings](https://code.claude.com/docs/en/keybindings) |
+| Desktop App | 原生桌面应用 | [code.claude.com/docs/en/desktop](https://code.claude.com/docs/en/desktop) |
+| Remote Control | 远程会话控制 | [code.claude.com/docs/en/remote-control](https://code.claude.com/docs/en/remote-control) |
+| Auto Mode | 自动权限管理 | [code.claude.com/docs/en/permissions](https://code.claude.com/docs/en/permissions) |
+| Channels | 多通道通信 | [code.claude.com/docs/en/channels](https://code.claude.com/docs/en/channels) |
+| Voice Dictation | Claude Code 语音输入 | [code.claude.com/docs/en/voice-dictation](https://code.claude.com/docs/en/voice-dictation) |
+
+## Anthropic Engineering Blog
+
+| 文章 | 说明 | 链接 |
+|---------|-------------|------|
+| Code Execution with MCP | 如何通过代码执行解决 MCP 上下文膨胀问题，Token 数量减少 98.7% | [anthropic.com/engineering/code-execution-with-mcp](https://www.anthropic.com/engineering/code-execution-with-mcp) |
+
+---
+
+## 30 分钟掌握 Claude Code
+
+_视频_: https://www.youtube.com/watch?v=6eBSHbLKuN0
+
+_**全部技巧**_
+- **探索高级功能和快捷键**
+  - 定期查看 Claude 发布说明中的新代码编辑与上下文功能。
+  - 学习键盘快捷键，在聊天、文件和编辑器视图之间快速切换。
+
+- **高效设置**
+  - 为项目创建带有清晰名称和描述的会话，便于之后查找。
+  - 将最常用的文件或文件夹固定住，让 Claude 随时可访问。
+  - 配置 Claude 的集成，例如 GitHub 和常见 IDE，以简化你的编码流程。
+
+- **高效的代码库问答**
+  - 向 Claude 询问架构、设计模式和具体模块的细节问题。
+  - 在问题里使用文件和行号引用，例如：“`app/models/user.py` 里的逻辑是在做什么？”
+  - 对于大型代码库，提供摘要或清单，帮助 Claude 聚焦。
+  - **示例提示词**：_“你能解释一下 `src/auth/AuthService.ts:45-120` 里实现的认证流程吗？它是如何与 `src/middleware/auth.ts` 里的中间件集成的？”_
+
+- **代码编辑与重构**
+  - 使用代码块中的内联注释或请求来获得更聚焦的编辑结果（例如：“把这个函数重构得更清晰一些”）。
+  - 让 Claude 给出并排的修改前后对比。
+  - 在重大修改后，让 Claude 生成测试或文档，以保证质量。
+  - **示例提示词**：_“把 `api/users.js` 里的 `getUserData` 函数从 promises 改成 async/await。给我一个修改前后对比，并为重构后的版本生成单元测试。”_
+
+- **上下文管理**
+  - 只粘贴当前任务真正需要的代码和上下文。
+  - 使用结构化提示词（“这里是文件 A，这里是函数 B，我的问题是 X”）通常效果最好。
+  - 在提示窗口里移除或折叠大文件，避免超出上下文限制。
+  - **示例提示词**：_“这里是 `models/User.js` 里的 User 模型，以及 `utils/validation.js` 里的 `validateUser` 函数。我的问题是：如何在保持向后兼容的前提下添加邮箱验证？”_
+
+- **接入团队工具**
+  - 将 Claude 会话连接到你们团队的代码仓库和文档。
+  - 使用内置模板，或为重复出现的工程任务创建自定义模板。
+  - 通过和队友共享会话记录与提示词来协作。
+
+- **提升性能**
+  - 给 Claude 清晰、面向目标的指令，例如：“用五个要点总结这个类”。
+  - 从上下文窗口中删掉不必要的注释和样板代码。
+  - 如果 Claude 的输出跑偏了，重置上下文或重新表述问题，以获得更好的对齐。
+  - **示例提示词**：_“用五个要点总结 `src/db/Manager.ts` 里的 `DatabaseManager` 类，重点说明它的核心职责和关键方法。”_
+
+- **实用场景示例**
+  - 调试：粘贴错误和堆栈信息，然后询问可能的原因和修复方式。
+  - 生成测试：为复杂逻辑请求属性测试、单元测试或集成测试。
+  - 代码审查：请 Claude 识别风险变更、边界情况或代码异味。
+  - **示例提示词**：
+    - _“我遇到这个错误：`TypeError: Cannot read property 'map' of undefined at line 42 in components/UserList.jsx`。这是堆栈信息和相关代码。是什么原因导致的？我该怎么修复？”_
+    - _“为 `PaymentProcessor` 类生成完整的单元测试，包括失败交易、超时和无效输入等边界情况。”_
+    - _“审查这个 pull request diff，找出潜在的安全问题、性能瓶颈和代码异味。”_
+
+- **工作流自动化**
+  - 用 Claude 提示词为格式化、清理、批量重命名等重复任务编写脚本。
+  - 用 Claude 基于代码 diff 起草 PR 描述、发布说明或文档。
+  - **示例提示词**：_“根据 git diff，生成一份详细的 PR 描述，包含变更摘要、修改文件列表、测试步骤和潜在影响。同时为 2.3.0 版本生成发布说明。”_
+
+**提示**：想要获得最佳效果，可以把这些实践组合起来使用。先固定关键文件并总结目标，再使用聚焦的提示词和 Claude 的重构工具，逐步改进你的代码库和自动化流程。
+
+
+**与 Claude Code 配合使用的推荐工作流**
+
+### Claude Code 推荐工作流
+
+#### 新仓库场景
+
+1. **初始化仓库并接入 Claude**
+   - 建立新仓库的基础结构：`README`、`LICENSE`、`.gitignore`、根配置文件。
+   - 创建 `CLAUDE.md`，说明架构、高层目标和编码规范。
+   - 安装 Claude Code，并将其连接到仓库，用于代码建议、测试脚手架和工作流自动化。
+
+2. **使用计划模式和规格说明**
+   - 在实现功能之前，使用计划模式（`shift-tab` 或 `/plan`）先写详细规格。
+   - 让 Claude 给出架构建议和初始项目布局。
+   - 保持清晰、面向目标的提示词序列，依次询问组件轮廓、主要模块和职责。
+
+3. **迭代开发与审查**
+   - 把核心功能拆成小块逐步实现，并在过程中请求 Claude 生成代码、重构和文档。
+   - 每增加一小步，都请求单元测试和示例。
+   - 在 `CLAUDE.md` 中维护持续更新的任务列表。
+
+4. **自动化 CI/CD 和部署**
+   - 用 Claude 搭建 GitHub Actions、npm/yarn 脚本或部署工作流。
+   - 通过更新 `CLAUDE.md` 并请求对应命令/脚本，轻松调整流水线。
+
+```mermaid
+graph TD
+    A[Start New Repository] --> B[Initialize Repository Structure]
+    B --> C[Create README, LICENSE, .gitignore]
+    C --> D[Create CLAUDE.md]
+    D --> E[Document Architecture & Guidelines]
+    E --> F[Install & Link Claude Code]
+
+    F --> G[Enter Plan Mode]
+    G --> H[Draft Feature Specification]
+    H --> I[Get Architecture Suggestions]
+    I --> J[Define Components & Modules]
+
+    J --> K[Implement Feature Chunk]
+    K --> L[Generate Code with Claude]
+    L --> M[Request Unit Tests]
+    M --> N[Review & Refactor]
+    N --> O{More Features?}
+    O -->|Yes| K
+    O -->|No| P[Update Task List in CLAUDE.md]
+
+    P --> Q[Setup CI/CD Pipeline]
+    Q --> R[Scaffold GitHub Actions]
+    R --> S[Create Deployment Scripts]
+    S --> T[Test Automation]
+    T --> U[Repository Ready]
+
+    style A fill:#e1f5ff
+    style G fill:#fff4e1
+    style K fill:#f0ffe1
+    style Q fill:#ffe1f5
+    style U fill:#90EE90
+```
+
+#### 现有仓库场景
+
+1. **仓库与上下文准备**
+   - 添加或更新 `CLAUDE.md`，记录仓库结构、编码模式和关键文件。对于旧仓库，可以使用 `CLAUDE_LEGACY.md`，其中涵盖框架、版本映射、说明、已知问题和升级笔记。
+   - 固定或高亮 Claude 应该用来作为上下文的主文件。
+
+2. **上下文驱动的代码问答**
+   - 让 Claude 基于具体文件/函数，回答代码审查、 bug 解释、重构或迁移计划。
+   - 给 Claude 明确边界，例如“只修改这些文件”或者“不要新增依赖”。
+
+3. **分支、工作区和多会话管理**
+   - 使用多个 git worktree 做隔离的功能开发或 bug 修复，并为每个 worktree 启动独立的 Claude 会话。
+   - 通过终端标签页/窗口按分支或功能组织并行工作。
+
+4. **团队工具和自动化**
+   - 通过 `.claude/commands/` 同步自定义命令，保持团队一致性。
+   - 用 Claude 的 slash commands 或 hooks 自动化重复任务、PR 创建和代码格式化。
+   - 与团队成员共享会话和上下文，便于协作排障和审查。
+
+```mermaid
+graph TD
+    A[Start with Existing Repository] --> B{Legacy Codebase?}
+    B -->|Yes| C[Create CLAUDE_LEGACY.md]
+    B -->|No| D[Create/Update CLAUDE.md]
+    C --> E[Document Frameworks & Version Maps]
+    D --> F[Document Structure & Patterns]
+    E --> G[Pin Key Files for Context]
+    F --> G
+
+    G --> H[Identify Task Type]
+    H --> I{Task Category}
+    I -->|Bug Fix| J[Ask Claude for Bug Analysis]
+    I -->|Code Review| K[Request Code Review]
+    I -->|Refactor| L[Plan Refactoring Strategy]
+    I -->|Migration| M[Create Migration Plan]
+
+    J --> N[Set Explicit Boundaries]
+    K --> N
+    L --> N
+    M --> N
+
+    N --> O{Multiple Features?}
+    O -->|Yes| P[Create Git Worktrees]
+    O -->|No| Q[Work on Main Branch]
+    P --> R[Launch Separate Claude Sessions]
+    R --> S[Organize Terminal Tabs]
+    Q --> S
+
+    S --> T[Setup Team Automation]
+    T --> U[Sync .claude/commands/]
+    U --> V[Configure Slash Commands]
+    V --> W[Setup Hooks for Automation]
+    W --> X[Share Session Context with Team]
+
+    X --> Y{More Tasks?}
+    Y -->|Yes| H
+    Y -->|No| Z[Workflow Complete]
+
+    style A fill:#e1f5ff
+    style C fill:#ffecec
+    style D fill:#fff4e1
+    style P fill:#f0ffe1
+    style T fill:#ffe1f5
+    style Z fill:#90EE90
+```
+
+**提示**：
+- 每个新功能或修复都从规格和计划模式提示词开始。
+- 对于旧仓库和复杂仓库，把更详细的指导存放在 `CLAUDE.md` / `CLAUDE_LEGACY.md` 中。
+- 给出清晰、聚焦的指令，把复杂工作拆成多阶段计划。
+- 定期清理会话、裁剪上下文，并删除已完成的工作区，避免堆积混乱。
+
+这些步骤概括了在新旧代码库中更顺畅使用 Claude Code 的核心建议。
+
+---
+
+## 2026 年 3 月新增功能与能力
+
+### 关键功能资源
+
+| 功能 | 说明 | 了解更多 |
+|---------|-------------|------------|
+| **Auto Memory** | Claude 会自动学习并记住你跨会话的偏好 | [记忆指南](02-memory/README.md) |
+| **Remote Control** | 通过外部工具和脚本以编程方式控制 Claude Code 会话 | [高级功能](09-advanced-features/README.md) |
+| **Web Sessions** | 通过基于浏览器的界面访问 Claude Code，实现远程开发 | [CLI 参考](10-cli/README.md) |
+| **Desktop App** | Claude Code 的原生桌面应用，界面更强大 | [Claude Code 文档](https://code.claude.com/docs/en/desktop) |
+| **Extended Thinking** | 通过 `Alt+T` / `Option+T` 或 `MAX_THINKING_TOKENS` 环境变量切换深度推理 | [高级功能](09-advanced-features/README.md) |
+| **Permission Modes** | 精细权限控制：default、acceptEdits、plan、auto、dontAsk、bypassPermissions | [高级功能](09-advanced-features/README.md) |
+| **7-Tier Memory** | Managed Policy、Project、Project Rules、User、User Rules、Local、Auto Memory | [记忆指南](02-memory/README.md) |
+| **Hook Events** | 25 个事件：PreToolUse、PostToolUse、PostToolUseFailure、Stop、StopFailure、SubagentStart、SubagentStop、Notification、Elicitation 等 | [Hooks 指南](06-hooks/README.md) |
+| **Agent Teams** | 协调多个 agent 共同处理复杂任务 | [Subagents 指南](04-subagents/README.md) |
+| **Scheduled Tasks** | 用 `/loop` 和 cron 工具设置周期性任务 | [高级功能](09-advanced-features/README.md) |
+| **Chrome Integration** | 使用无头 Chromium 做浏览器自动化 | [高级功能](09-advanced-features/README.md) |
+| **Keyboard Customization** | 自定义按键绑定，包括组合键序列 | [高级功能](09-advanced-features/README.md) |