feat: 改善 seo

docs/agent/coordinator-and-swarm.mdx

@@ -1,6 +1,7 @@
 ---
-title: "协调者与蜂群"
-description: "从单兵作战到团队协作——多 Agent 的高级编排模式"
+title: "协调者与蜂群模式 - 多 Agent 高级编排"
+description: "详解 Claude Code 多 Agent 高级协作模式：Coordinator Mode 协调者模式和 Agent Swarms 蜂群模式的设计理念、调度策略和适用场景。"
+keywords: ["协调者模式", "蜂群模式", "Agent Swarm", "多 Agent 协作", "任务编排"]
 ---
 
 {/* 本章目标：介绍 Coordinator Mode 和 Agent Swarms */}

docs/agent/sub-agents.mdx

@@ -1,6 +1,7 @@
 ---
-title: "子 Agent：分身术"
-description: "当一个 AI 不够用时，它会召唤更多的自己"
+title: "子 Agent 机制 - AI 分身术与任务委派"
+description: "深入解析 Claude Code 子 Agent 机制：主 Agent 如何通过 AgentTool 委派子任务，子 Agent 的生命周期管理、工具继承和结果回传。"
+keywords: ["子 Agent", "Agent 分身", "任务委派", "AgentTool", "多 Agent"]
 ---
 
 {/* 本章目标：解释子 Agent 机制的设计和应用场景 */}

docs/agent/worktree-isolation.mdx

@@ -1,6 +1,7 @@
 ---
-title: "Worktree 隔离"
-description: "给子 Agent 一个独立的工作空间——用 git worktree 实现文件级隔离"
+title: "Worktree 隔离 - Git Worktree 实现文件级隔离"
+description: "揭秘 Claude Code 的 git worktree 隔离机制：子 Agent 如何获得独立工作空间，worktree 创建/销毁生命周期、路径命名规则和安全防护。"
+keywords: ["Worktree", "git worktree", "文件隔离", "多 Agent 隔离", "并行安全"]
 ---
 
 {/* 本章目标：揭示 worktree 的创建/销毁生命周期、路径命名规则、hook 机制和退出时的安全防护 */}

docs/context/compaction.mdx

@@ -1,6 +1,7 @@
 ---
-title: "上下文压缩"
-description: "对话太长怎么办——优雅地'遗忘'不重要的信息"
+title: "上下文压缩 - Compaction 优雅遗忘机制"
+description: "详解 Claude Code 上下文压缩策略：当对话 token 接近 200K 上限时，如何通过 Compaction 机制智能压缩历史消息，保留关键信息。"
+keywords: ["上下文压缩", "Compaction", "token 管理", "对话压缩", "上下文窗口"]
 ---
 
 {/* 本章目标：解释 Compaction 机制的设计和策略 */}

docs/context/project-memory.mdx

@@ -1,6 +1,7 @@
 ---
-title: "项目记忆"
-description: "让 AI 跨对话记住你的偏好和项目上下文"
+title: "项目记忆系统 - AI 跨对话记忆机制"
+description: "解析 Claude Code 项目记忆系统：CLAUDE.md 文件、用户偏好存储和上下文缓存如何让 AI 跨对话记住项目特性和个人偏好。"
+keywords: ["项目记忆", "CLAUDE.md", "AI 记忆", "跨对话", "上下文缓存"]
 ---
 
 {/* 本章目标：解释记忆系统如何让 AI 变得'有记忆' */}

docs/context/system-prompt.mdx

@@ -1,6 +1,7 @@
 ---
-title: "System Prompt 的动态组装"
-description: "AI 的'工作记忆'是如何在每次对话前被精心拼装的"
+title: "System Prompt 动态组装 - AI 工作记忆构建"
+description: "深入解析 Claude Code 的 System Prompt 动态组装过程：如何将 CLAUDE.md、项目上下文、工具定义和用户偏好拼装为 AI 的工作记忆。"
+keywords: ["System Prompt", "系统提示词", "动态组装", "CLAUDE.md", "上下文构建"]
 ---
 
 {/* 本章目标：解释 System Prompt 的组装过程和设计思想 */}

docs/context/token-budget.mdx

@@ -1,6 +1,7 @@
 ---
-title: "Token 预算管理"
-description: "上下文窗口是 AI 的内存条——满了就得压缩"
+title: "Token 预算管理 - 上下文窗口动态计算"
+description: "从源码角度揭示 Claude Code token 预算管理：200K 上下文窗口的动态计算、截断机制、缓存优化和自动压缩的完整链路。"
+keywords: ["Token 预算", "上下文窗口", "token 计算", "截断机制", "缓存优化"]
 ---
 
 {/* 本章目标：从源码角度揭示 token 预算的动态计算、截断机制、缓存优化和自动压缩的完整链路 */}

docs/conversation/multi-turn.mdx

@@ -1,6 +1,7 @@
 ---
-title: "多轮对话管理"
-description: "一场跨越数小时的编程对话是如何被管理的"
+title: "多轮对话管理 - 会话编排、持久化与成本追踪"
+description: "详解 Claude Code 多轮对话管理机制：会话编排、持久化存储、成本追踪和上下文累积策略，理解跨小时级编程对话的状态管理。"
+keywords: ["多轮对话", "会话管理", "上下文累积", "对话持久化", "成本追踪"]
 ---
 
 {/* 本章目标：解释会话编排、持久化、成本追踪 */}

docs/conversation/streaming.mdx

@@ -1,6 +1,7 @@
 ---
-title: "流式响应：逐字呈现"
-description: "为什么 Claude Code 的回答是'打字机效果'而不是一整块弹出"
+title: "流式响应机制 - Claude Code 打字机效果原理"
+description: "解析 Claude Code 流式响应实现：如何通过 SSE 逐 token 接收 AI 输出，实现实时打字机效果，提升用户等待体验。"
+keywords: ["流式响应", "SSE", "streaming", "实时输出", "API streaming"]
 ---
 
 ## 为什么需要流式

docs/conversation/the-loop.mdx

@@ -1,6 +1,7 @@
 ---
-title: "Agentic Loop：对话的心跳"
-description: "AI 不只回答问题，它会反复思考-行动-观察，直到任务完成"
+title: "Agentic Loop：AI 自主循环的核心机制"
+description: "深入解析 Claude Code 的 Agentic Loop 机制——AI 如何通过思考-行动-观察的循环，自主决策工具调用链，直到任务完成。包含源码级流程分析。"
+keywords: ["Agentic Loop", "AI 循环", "工具调用", "自主决策", "ReAct 模式"]
 ---
 
 {/* 本章目标：解释 Agentic Loop 这个核心机制 */}

docs/extensibility/custom-agents.mdx

@@ -1,6 +1,7 @@
 ---
-title: "自定义 Agent"
-description: "定义你自己的 AI 角色——从 Markdown 文件到运行时注入的完整链路"
+title: "自定义 Agent - 从 Markdown 到运行时的完整链路"
+description: "揭秘 Claude Code 自定义 Agent 完整链路：Agent 定义的 Markdown 数据模型、三种加载来源、工具过滤策略和与 AgentTool 的联动机制。"
+keywords: ["自定义 Agent", "Agent 定义", "Markdown Agent", "Agent 配置", "角色定制"]
 ---
 
 {/* 本章目标：揭示 Agent 定义的完整数据模型、加载发现机制、工具过滤和与 AgentTool 的联动 */}

docs/extensibility/hooks.mdx

@@ -1,6 +1,7 @@
 ---
-title: "Hooks：生命周期钩子"
-description: "在 AI 的关键行为节点插入你自己的逻辑"
+title: "Hooks 生命周期钩子 - 自定义行为注入"
+description: "解析 Claude Code Hooks 系统：在 AI 工具调用的关键节点（PreToolUse、PostToolUse、Notification 等）插入自定义 shell 命令，实现行为定制。"
+keywords: ["Hooks", "生命周期钩子", "自定义 Hook", "行为注入", "PreToolUse"]
 ---
 
 {/* 本章目标：解释 Hooks 系统的设计和应用场景 */}

docs/extensibility/mcp-protocol.mdx

@@ -1,6 +1,7 @@
 ---
-title: "MCP：开放的工具生态"
-description: "通过标准协议对接任何外部能力——数据库、API、自定义服务"
+title: "MCP 协议 - 开放的工具生态扩展"
+description: "深入解析 Claude Code 的 MCP（Model Context Protocol）集成：通过标准协议对接数据库、API 和自定义服务，突破内置工具的能力边界。"
+keywords: ["MCP", "Model Context Protocol", "工具扩展", "外部集成", "API 对接"]
 ---
 
 {/* 本章目标：解释 MCP 协议如何扩展 AI 的能力边界 */}

docs/extensibility/skills.mdx

@@ -1,6 +1,7 @@
 ---
-title: "Skills：预制的能力包"
-description: "把常用的工作流封装成可复用的技能"
+title: "Skills 技能系统 - 可复用的 AI 工作流封装"
+description: "详解 Claude Code Skills 系统：如何将常用工作流封装为可复用的技能包，Skills 与 Tools 的区别，以及技能定义和加载机制。"
+keywords: ["Skills", "技能系统", "工作流封装", "可复用技能", "AI 工作流"]
 ---
 
 {/* 本章目标：解释 Skills 系统的设计思想 */}

docs/internals/ant-only-world.mdx

@@ -1,6 +1,7 @@
 ---
-title: "Ant 的特权世界"
-description: "USER_TYPE === 'ant'——Anthropic 员工专属的工具、命令、API 和代号体系"
+title: "Ant 特权世界 - Anthropic 员工专属功能"
+description: "完整记录 Claude Code 身份门控层：USER_TYPE === 'ant' 时解锁的专属工具、命令、API 和代号体系，揭示内外部构建的差异。"
+keywords: ["Ant 特权", "USER_TYPE", "身份门控", "内部功能", "Anthropic 员工"]
 ---
 
 {/* 本章目标：完整记录身份门控层——ant 构建独享的一切 */}

docs/internals/feature-flags.mdx

@@ -1,6 +1,7 @@
 ---
-title: "88 面旗帜：构建时 Feature Flags 全解"
-description: "深入剖析 Claude Code 的 88+ 个构建时 feature flags，揭示被编译器"删除"的功能"
+title: "88 个 Feature Flags - 构建时特性门控全解"
+description: "深入剖析 Claude Code 的 88+ 个构建时 feature flags：bun:bundle 编译时门控机制，揭示被编译器删除的隐藏功能模块。"
+keywords: ["feature flags", "特性标志", "构建时门控", "bun:bundle", "条件编译"]
 ---
 
 {/* 本章目标：完整梳理构建时 feature flag 系统的机制和所有 flag 的分类 */}

docs/internals/growthbook-ab-testing.mdx

@@ -1,6 +1,7 @@
 ---
-title: "千面千人：GrowthBook A/B 测试体系"
-description: "揭秘 Claude Code 如何通过 GrowthBook 实现运行时 A/B 测试和渐进式功能发布"
+title: "GrowthBook A/B 测试体系 - 运行时功能发布"
+description: "揭秘 Claude Code 如何通过 GrowthBook 实现运行时 A/B 测试：用户定向、tengu 命名文化和渐进式功能发布策略。"
+keywords: ["GrowthBook", "A/B 测试", "运行时门控", "tengu", "渐进式发布"]
 ---
 
 {/* 本章目标：深入运行时 A/B 测试层——GrowthBook 的集成架构、用户定向、tengu 命名文化 */}

docs/internals/hidden-features.mdx

@@ -1,6 +1,7 @@
 ---
-title: "未公开功能巡礼"
-description: "深度解析 Claude Code 中 8 个最令人兴奋的隐藏功能——从永不下线的 AI 助手到 AI 吉祥物"
+title: "未公开功能巡礼 - 8 个隐藏功能深度解析"
+description: "深度解析 Claude Code 中 8 个最令人兴奋的隐藏功能：从永不下线的 AI 助手到 AI 吉祥物，揭示 88+ flags 中最具代表性的未公开特性。"
+keywords: ["隐藏功能", "未公开功能", "秘密功能", "Claude Code 彩蛋", "AI 助手"]
 ---
 
 {/* 本章目标：逐一展示 8 个最重要的隐藏功能，分析它们背后的产品方向 */}

docs/internals/three-tier-gating.mdx

@@ -1,6 +1,7 @@
 ---
-title: "三层门禁：功能是如何被藏起来的"
-description: "Claude Code 用三层独立的门禁系统控制功能的可见性——构建时、运行时、身份层"
+title: "三层门禁系统 - 功能可见性控制架构"
+description: "详解 Claude Code 三层门禁系统：构建时 feature()、运行时 GrowthBook 和身份层 USER_TYPE，如何控制功能的可见性和灰度发布。"
+keywords: ["门禁系统", "功能门控", "feature flag", "灰度发布", "可见性控制"]
 ---
 
 {/* 本章目标：建立对三层门禁系统的全局认知，为后续四篇深入文章奠定坐标系 */}

docs/introduction/architecture-overview.mdx

@@ -1,6 +1,7 @@
 ---
-title: "架构全景"
-description: "五层架构，一条数据流"
+title: "架构全景 - Claude Code 五层架构详解"
+description: "从交互层到基础设施层，详解 Claude Code 的五层架构设计。涵盖 React/Ink UI、QueryEngine 编排、Agentic Loop 核心循环、Tool 系统和 API 层。"
+keywords: ["Claude Code 架构", "五层架构", "QueryEngine", "Agentic Loop", "系统设计"]
 ---
 
 {/* 本章目标：一张图讲清楚整体架构，为后续章节建立坐标系 */}

docs/introduction/what-is-claude-code.mdx

@@ -1,6 +1,8 @@
 ---
-title: "什么是 Claude Code"
-description: "terminal-native agentic system —— 不是 IDE 插件，不是 Web Chat"
+title: "什么是 Claude Code - Terminal Native Agentic Coding System"
+description: "Claude Code 是运行在终端中的 agentic coding system，直接在你的项目目录中读代码、改文件、跑命令、调试程序。了解它的技术定位、架构差异和核心能力。"
+keywords: ["Claude Code", "AI 编程助手", "Agentic Coding", "终端 AI", "CLI AI"]
+og:image: "https://ccb.agent-aura.top/docs/images/og-cover.png"
 ---
 
 ## 一句话定义

docs/introduction/why-this-whitepaper.mdx

@@ -1,6 +1,7 @@
 ---
-title: "为什么写这份白皮书"
-description: "对 Anthropic 官方 CLI 的逆向工程分析——不是官方文档"
+title: "为什么写这份白皮书 - Claude Code 逆向工程分析"
+description: "对 Anthropic 官方 Claude Code CLI 的逆向工程分析白皮书。通过反编译 TypeScript 单文件 bundle，深入解析运行时行为与源码结构。"
+keywords: ["Claude Code", "逆向工程", "白皮书", "反编译", "TypeScript"]
 ---
 
 ## 这份白皮书是什么

docs/safety/permission-model.mdx

@@ -1,6 +1,7 @@
 ---
-title: "权限模型"
-description: "三种行为 x 多级来源 = 灵活而严谨的权限体系"
+title: "权限模型 - Allow/Ask/Deny 三级权限体系"
+description: "详解 Claude Code 的三级权限模型：Allow 自动放行、Ask 确认对话框、Deny 直接拒绝。权限规则的层级来源与优先级机制。"
+keywords: ["权限模型", "Allow Ask Deny", "权限控制", "安全权限", "工具权限"]
 ---
 
 {/* 本章目标：详解权限系统的设计 */}

docs/safety/plan-mode.mdx

@@ -1,6 +1,7 @@
 ---
-title: "计划模式"
-description: "先看后做——给 AI 一个只读的探索阶段"
+title: "计划模式 - Plan Mode 先看后做的安全机制"
+description: "解析 Claude Code Plan Mode 设计：给 AI 一个只读探索阶段，先分析再执行，避免不可逆操作，让用户在 AI 行动前审查方案。"
+keywords: ["Plan Mode", "计划模式", "只读模式", "安全执行", "预览方案"]
 ---
 
 {/* 本章目标：解释 Plan Mode 的设计理念 */}

docs/safety/sandbox.mdx

@@ -1,6 +1,7 @@
 ---
-title: "沙箱机制"
-description: "即使命令被允许执行，也不意味着它可以为所欲为"
+title: "沙箱机制 - 权限之外的第二道防线"
+description: "深入 Claude Code 沙箱机制：文件系统隔离、网络限制和资源约束，即使命令通过权限审批，沙箱仍可限制其行为范围。"
+keywords: ["沙箱", "sandbox", "文件隔离", "安全沙箱", "命令隔离"]
 ---
 
 ## 权限之外的第二道防线

docs/safety/why-safety-matters.mdx

@@ -1,6 +1,7 @@
 ---
-title: "为什么安全至关重要"
-description: "当 AI 能操作你的电脑，信任的边界在哪里"
+title: "AI 安全至关重要 - Claude Code 安全设计哲学"
+description: "当 AI 能操作你的真实项目文件和命令，安全的边界在哪里？分析 Claude Code 的安全挑战、威胁模型和纵深防御策略。"
+keywords: ["AI 安全", "安全设计", "威胁模型", "纵深防御", "AI 风险"]
 ---
 
 ## AI 动手的代价

docs/tools/file-operations.mdx

@@ -1,6 +1,7 @@
 ---
-title: "文件操作"
-description: "AI 如何安全、高效地读写你的代码"
+title: "文件操作工具 - AI 如何安全读写代码"
+description: "解析 Claude Code 的文件操作工具设计：FileRead、FileEdit、FileWrite 三大工具的职责划分、安全策略和实现细节。"
+keywords: ["文件操作", "FileRead", "FileEdit", "FileWrite", "代码编辑"]
 ---
 
 {/* 本章目标：介绍文件类工具的设计理念 */}

docs/tools/search-and-navigation.mdx

@@ -1,6 +1,7 @@
 ---
-title: "搜索与导航"
-description: "AI 如何在百万行代码中精准定位目标"
+title: "搜索与导航工具 - 代码库精准定位"
+description: "解析 Claude Code 的搜索导航工具：Glob 文件匹配、Grep 内容搜索，基于 ripgrep 的高性能代码检索，帮助 AI 在百万行代码中精准定位。"
+keywords: ["代码搜索", "Glob", "Grep", "ripgrep", "文件搜索"]
 ---
 
 ## 两种搜索维度

docs/tools/shell-execution.mdx

@@ -1,6 +1,7 @@
 ---
-title: "命令执行"
-description: "让 AI 在你的终端里运行命令——安全地"
+title: "命令执行工具 - Bash Tool 安全设计与实现"
+description: "详解 Claude Code 的 Bash 工具：AI 如何安全地在终端执行命令，包含命令白名单、超时控制、沙箱隔离和输出截断策略。"
+keywords: ["Bash 工具", "命令执行", "Shell 执行", "安全命令", "AI 执行命令"]
 ---
 
 {/* 本章目标：介绍 Bash 工具的能力与安全设计 */}

docs/tools/task-management.mdx

@@ -1,6 +1,7 @@
 ---
-title: "任务管理"
-description: "从单机 Todo 到多 Agent 任务队列的演进"
+title: "任务管理系统 - TodoWrite 与 Tasks 双轨架构"
+description: "揭秘 Claude Code 任务管理系统的双轨架构：V1 内存 TodoWrite 与 V2 文件系统 Tasks，包含依赖管理、认领竞争和验证推动机制。"
+keywords: ["任务管理", "TodoWrite", "任务队列", "依赖管理", "多任务"]
 ---
 
 {/* 本章目标：揭示任务系统 V1（内存 TodoWrite）和 V2（文件系统 Task*）的双轨架构，以及依赖管理、认领竞争、验证推动的工程细节 */}

docs/tools/what-are-tools.mdx

@@ -1,6 +1,7 @@
 ---
-title: "工具：AI 的双手"
-description: "理解 Tool 这个核心抽象——AI 是怎么从'说'变成'做'的"
+title: "工具系统设计 - AI 如何从说到做"
+description: "深入理解 Claude Code 的 Tool 抽象设计。每个工具是标准化的能力单元，包含名称、描述、输入 Schema 和执行函数。了解工具注册与调用机制。"
+keywords: ["工具系统", "Tool 抽象", "AI 工具", "function calling", "工具调用"]
 ---
 
 {/* 本章目标：让读者理解 Tool 抽象的设计思想 */}

mint.json

@@ -15,13 +15,32 @@
       "light": "#FFFFFF"
     }
   },
+  "metadata": {
+    "og:image": "https://ccb.agent-aura.top/docs/images/og-cover.png",
+    "twitter:image": "https://ccb.agent-aura.top/docs/images/og-cover.png",
+    "twitter:card": "summary_large_image"
+  },
+  "search": {
+    "prompt": "搜索 Claude Code 架构文档..."
+  },
+  "redirects": [
+    {
+      "source": "/docs/introduction",
+      "destination": "/docs/introduction/what-is-claude-code"
+    }
+  ],
   "navigation": [
     {
       "group": "开始",
       "pages": [
-        "docs/introduction/what-is-claude-code",
-        "docs/introduction/why-this-whitepaper",
-        "docs/introduction/architecture-overview"
+        {
+          "group": "介绍",
+          "pages": [
+            "docs/introduction/what-is-claude-code",
+            "docs/introduction/why-this-whitepaper",
+            "docs/introduction/architecture-overview"
+          ]
+        }
       ]
     },
     {