docs: 文档大重组,对齐 README 入口

以 README 为单一事实来源,重构整个 docs/ 目录。

最终结构(3 大组、15 篇文档):
- 开始: installation / quickstart / model-providers
- 核心功能: pipes-and-lan、acp、channels、chrome-control、computer-use、
  voice-mode、web-browser-tool、auto-dream、remote-control-self-hosting、
  langfuse-monitoring
- 内部机制: growthbook-adapter、sentry-setup

主要变更:
- 删除 56 个 README 未提及的文档(architecture 全部 / guides 全部 /
  features 中未在 README 出现的 20 篇 / internals 中的 5 篇)
- 合并 6 组重复文档(pipes-and-lan、chrome-control、acp、computer-use、
  auto-dream、coordinator-mode 简化为入口)
- features 子组从 5 → 4,ui/ 合并入 tools/
- 所有保留文档加上人性化 frontmatter(title/description/keywords)
- docs.json navigation 简化为 3 大组,redirects 重新过滤为 7 条合并跳转
- 新增 docs.md 工作大纲与验证脚本(verify-docs / check-docs-orphans /
  dump-docs-outline)

总计 130 文件改动,从约 35000 行精简到约 2000 行。

Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win>
This commit is contained in:
claude-code-best
2026-06-14 20:42:51 +08:00
parent 2714bbf812
commit 37dac682b9
130 changed files with 2074 additions and 33533 deletions

232
docs.json
View File

@@ -1,153 +1,14 @@
{
"$schema": "https://mintlify.com/docs.json",
"theme": "mint",
"name": "Claude Code Architecture",
"name": "Claude Code Best",
"description": "Anthropic Claude Code 的开源复原版本 — 完整架构原理、功能文档与使用指南。",
"colors": {
"primary": "#D97706",
"primary": "#D77757",
"light": "#F59E0B",
"dark": "#B45309"
},
"favicon": "/docs/favicon.svg",
"navigation": {
"groups": [
{
"group": "开始",
"pages": [
{
"group": "介绍",
"pages": [
"docs/introduction/what-is-claude-code",
"docs/introduction/why-this-whitepaper",
"docs/introduction/architecture-overview"
]
}
]
},
{
"group": "对话是如何运转的",
"pages": [
"docs/conversation/the-loop",
"docs/conversation/streaming",
"docs/conversation/multi-turn"
]
},
{
"group": "工具AI 的双手",
"pages": [
"docs/tools/what-are-tools",
"docs/tools/file-operations",
"docs/tools/shell-execution",
"docs/tools/search-and-navigation",
"docs/tools/task-management"
]
},
{
"group": "上下文工程",
"pages": [
"docs/context/system-prompt",
"docs/context/project-memory",
"docs/context/compaction",
"docs/context/token-budget"
]
},
{
"group": "多 Agent 协作",
"pages": [
"docs/agent/sub-agents",
"docs/agent/worktree-isolation",
"docs/agent/coordinator-and-swarm"
]
},
{
"group": "可扩展性",
"pages": [
"docs/extensibility/mcp-protocol",
"docs/extensibility/hooks",
"docs/extensibility/skills",
"docs/extensibility/custom-agents"
]
},
{
"group": "安全与权限",
"pages": [
"docs/safety/why-safety-matters",
"docs/safety/permission-model",
"docs/safety/sandbox",
"docs/safety/plan-mode",
"docs/safety/auto-mode"
]
},
{
"group": "揭秘:隐藏功能与内部机制",
"pages": [
"docs/internals/three-tier-gating",
"docs/internals/feature-flags",
"docs/internals/growthbook-ab-testing",
"docs/internals/growthbook-adapter",
"docs/internals/sentry-setup",
"docs/internals/hidden-features",
"docs/internals/ant-only-world",
"docs/internals/session-transcript-persistence",
"docs/features/debug-mode",
"docs/features/buddy"
]
},
{
"group": "隐藏功能详解",
"pages": [
{
"group": "Agent 与协作",
"pages": [
"docs/features/coordinator-mode",
"docs/features/fork-subagent",
"docs/features/daemon",
"docs/features/teammem"
]
},
{
"group": "运行模式",
"pages": [
"docs/features/kairos",
"docs/features/voice-mode",
"docs/features/bridge-mode",
"docs/features/remote-control-self-hosting",
"docs/features/proactive",
"docs/features/ultraplan"
]
},
{
"group": "工具增强",
"pages": [
"docs/features/mcp-skills",
"docs/features/tree-sitter-bash",
"docs/features/bash-classifier",
"docs/features/web-browser-tool",
"docs/features/experimental-skill-search"
]
},
{
"group": "上下文与自动化",
"pages": [
"docs/features/token-budget",
"docs/features/context-collapse",
"docs/features/workflow-scripts",
"docs/features/auto-dream"
]
},
"docs/features/tier3-stubs"
]
},
{
"group": "基础设施与依赖",
"pages": [
"docs/auto-updater",
"docs/lsp-integration",
"docs/external-dependencies",
"docs/telemetry-remote-config-audit"
]
}
]
},
"logo": {
"light": "/docs/logo/light.svg",
"dark": "/docs/logo/dark.svg"
@@ -165,7 +26,7 @@
}
},
"search": {
"prompt": "搜索 Claude Code 架构文档..."
"prompt": "搜索 CCB 文档..."
},
"seo": {
"metatags": {
@@ -177,13 +38,90 @@
},
"footer": {
"socials": {
"github": "https://github.com/anthropics/claude-code"
"github": "https://github.com/claude-code-best/claude-code",
"discord": "https://discord.gg/uApuzJWGKX"
}
},
"redirects": [
{
"source": "/docs/introduction",
"destination": "/docs/introduction/what-is-claude-code"
"source": "/docs/features/agents/uds-inbox",
"destination": "/docs/features/agents/pipes-and-lan"
},
{
"source": "/docs/features/agents/lan-pipes",
"destination": "/docs/features/agents/pipes-and-lan"
},
{
"source": "/docs/features/agents/acp-link",
"destination": "/docs/features/agents/acp"
},
{
"source": "/docs/features/agents/acp-zed",
"destination": "/docs/features/agents/acp"
},
{
"source": "/docs/features/external/chrome-use-mcp",
"destination": "/docs/features/external/chrome-control"
},
{
"source": "/docs/features/external/claude-in-chrome-mcp",
"destination": "/docs/features/external/chrome-control"
},
{
"source": "/docs/features/external/computer-use-tools-reference",
"destination": "/docs/features/external/computer-use"
}
]
],
"navigation": {
"groups": [
{
"group": "开始",
"pages": [
"docs/getting-started/installation",
"docs/getting-started/quickstart",
"docs/getting-started/model-providers"
]
},
{
"group": "核心功能",
"pages": [
{
"group": "协作与多 Agent",
"pages": [
"docs/features/agents/pipes-and-lan",
"docs/features/agents/acp"
]
},
{
"group": "外部接入",
"pages": [
"docs/features/external/channels",
"docs/features/external/chrome-control",
"docs/features/external/computer-use",
"docs/features/external/voice-mode",
"docs/features/external/web-browser-tool"
]
},
{
"group": "运行模式",
"pages": [
"docs/features/modes/auto-dream",
"docs/features/modes/remote-control-self-hosting"
]
},
{
"group": "工具与体验",
"pages": ["docs/features/tools/langfuse-monitoring"]
}
]
},
{
"group": "内部机制",
"pages": [
"docs/internals/growthbook-adapter",
"docs/internals/sentry-setup"
]
}
]
}
}