# Claude Code 文档站章节重构方案

> 按功能域重新组织，专有名词保留英文，其余简化为中文。

---

## 一、导航结构

```
开始使用
├── 项目介绍
├── 项目动机
└── 架构总览

核心机制
├── Agent Loop
├── 流式响应
├── 多轮对话
├── 系统提示词
└── 深度规划

上下文管理
├── 令牌预算
├── 上下文压缩
├── 项目记忆
├── 自动记忆整理
└── 穷鬼模式

工具系统
├── 工具总览
├── 文件操作
├── 命令执行
├── 搜索导航
├── 任务管理
├── 网页搜索
├── 桌面自动化
└── 浏览器控制

多智能体
├── 子智能体
├── 自定义智能体
├── 工作树隔离
├── 协调模式
├── 团队记忆
└── 后台会话

MCP
└── MCP 详解

Hook 与 Plugin
├── Hook 钩子
├── 插件市场
└── LSP 集成

Skills
├── Skill 技能系统
├── Workflow 脚本
└── Skill 搜索

远程控制
├── 远程控制
├── ACP 接入
├── 消息通道
├── 本地通信
└── 常驻助手

安全机制
├── 安全概述
├── 权限模型
├── 沙箱
├── Bash 检查
├── 规划模式
└── 自动模式

额外功能
├── 特性开关
├── A/B 测试与配置
├── 错误追踪
├── 隐藏功能
├── Buddy 助手
├── 命令分类
└── 语音模式

开发人员
├── 可观测性
├── 调试模式
└── 专属特性

基础设施
├── 守护进程
└── 自动更新

附录
├── 任务追踪
├── 测试计划
└── 设计文档
```

---

## 二、标题映射

| 导航标题 | 新文件路径 | 合并来源 |
|---------|-----------|---------|
| 项目介绍 | docs/introduction/what-is-claude-code | （不变） |
| 项目动机 | docs/introduction/why-this-whitepaper | （不变） |
| 架构总览 | docs/introduction/architecture-overview | （不变） |
| Agent Loop | docs/conversation/the-loop | （不变） |
| 流式响应 | docs/conversation/streaming | （不变） |
| 多轮对话 | docs/conversation/multi-turn | （不变） |
| 系统提示词 | docs/context/system-prompt | （不变） |
| 语音模式 | docs/features/voice-mode | （不变） |
| 深度规划 | docs/features/ultraplan | （不变） |
| 令牌预算 | docs/context/token-budget | （不变） |
| 上下文压缩 | docs/context/compaction | （不变） |
| 项目记忆 | docs/context/project-memory | （不变） |
| 自动记忆整理 | docs/features/auto-dream | （不变） |
| 穷鬼模式 | （新写） | — |
| 工具总览 | docs/tools/what-are-tools | （不变） |
| 文件操作 | docs/tools/file-operations | （不变） |
| 命令执行 | docs/tools/shell-execution | （不变） |
| 搜索导航 | docs/tools/search-and-navigation | （不变） |
| 任务管理 | docs/tools/task-management | （不变） |
| 网页搜索 | docs/features/web-search-tool | （不变） |
| 桌面自动化 | docs/features/computer-use | （不变） |
| 浏览器控制 | docs/features/claude-in-chrome-mcp | （不变） |
| 子智能体 | docs/agent/sub-agents | ← sub-agents + features/fork-subagent |
| 自定义智能体 | docs/extensibility/custom-agents | （不变） |
| 工作树隔离 | docs/agent/worktree-isolation | （不变） |
| 协调模式 | docs/agent/coordinator-and-swarm | （不变） |
| 团队记忆 | docs/features/teammem | （不变） |
| 后台会话 | docs/features/pipes-and-lan | （不变） |
| MCP 详解 | docs/extensibility/mcp | ← extensibility/mcp-protocol + extensibility/mcp-configuration + features/mcp-skills |
| 插件市场 | （新写） | — |
| Hook 钩子 | docs/extensibility/hooks | （不变） |
| Skill 技能系统 | docs/extensibility/skills | （不变） |
| Workflow 脚本 | docs/features/workflow-scripts | （不变） |
| Skill 搜索 | docs/features/experimental-skill-search | （不变） |
| 远程控制 | docs/features/remote-control | ← features/bridge-mode + features/remote-control-self-hosting |
| ACP 接入 | docs/features/acp-link | （不变） |
| 消息通道 | docs/features/channels | （不变） |
| 本地通信 | docs/features/proactive | （不变） |
| 常驻助手 | docs/features/kairos | ← features/proactive + features/kairos |
| 安全概述 | docs/safety/why-safety-matters | （不变） |
| 权限模型 | docs/safety/permission-model | （不变） |
| 沙箱 | docs/safety/sandbox | （不变） |
| Bash 检查 | docs/features/tree-sitter-bash | ← features/tree-sitter-bash + features/bash-classifier |
| 规划模式 | docs/safety/plan-mode | （不变） |
| 自动模式 | docs/safety/auto-mode | （不变） |
| 特性开关 | docs/internals/feature-flags | （不变） |
| A/B 测试与配置 | docs/internals/growthbook | ← internals/growthbook-ab-testing + internals/growthbook-adapter |
| 错误追踪 | docs/internals/sentry-setup | （不变） |
| 隐藏功能 | docs/internals/hidden-features | （不变） |
| 专属特性 | docs/internals/ant-only-world | （不变，移至开发人员） |
| 调试模式 | docs/features/debug-mode | （不变，移至开发人员） |
| Buddy 助手 | docs/features/buddy | （不变） |
| 命令分类 | docs/features/bash-classifier | （不变） |
| 可观测性 | docs/features/langfuse-monitoring | （不变） |
| 守护进程 | docs/features/daemon | （不变） |
| 自动更新 | docs/auto-updater | （不变） |
| LSP 集成 | docs/lsp-integration | （不变） |