# Docs

- [AI 编程教程矩阵](/docs): Codex、Claude Code、Cursor、Copilot 等 10 个 AI 编程工具的官方文档中文版总索引，588 篇按工具分组排好，每页底部给官方原文链接。
- 使用指南
  - [使用指南](/docs/how-to-use): 把 588 篇 AI 编程文档当中文素材库，让 AI 用你喜欢的讲解风格讲透——四步流程加双层架构加 20 条提示词。
  - 20 条讲解风格提示词
    - [20 条讲解风格提示词](/docs/how-to-use/prompts): 费曼、窦文涛、金庸、乔布斯、马斯克……20 个名家风格的讲解提示词，每条独立 1 页可整段复制。
    - [01 · 费曼](/docs/how-to-use/prompts/feynman): 物理学家费曼学习法：能用最简单的话讲给 6 岁小孩听才算真懂。整段复制提示词扔给 AI 即可开聊。
    - [02 · 窦文涛](/docs/how-to-use/prompts/doumen): 圆桌派三人闲聊风：好概念是聊出来的不是教出来的。整段复制提示词扔给 AI 即可开聊。
    - [03 · 霍金](/docs/how-to-use/prompts/hawking): 时间简史风极简物理普及：日常短句加画面感加零公式。整段复制提示词扔给 AI 即可开聊。
    - [04 · 金庸](/docs/how-to-use/prompts/jinyong): 武侠门派演义：每个工具都有绝技、命门，最后华山论剑见高下。整段复制提示词扔给 AI 即可开聊。
    - [05 · 大卫·爱登堡](/docs/how-to-use/prompts/attenborough): BBC 自然纪录片旁白：把工具当物种沉静观察。整段复制提示词扔给 AI 即可开聊。
    - [06 · 道金斯](/docs/how-to-use/prompts/dawkins): 自私的基因风进化论视角：能复制扩散的就是模因，看复制策略。整段复制提示词扔给 AI 即可开聊。
    - [07 · 萨尔·可汗](/docs/how-to-use/prompts/khan): 可汗学院黑板讲课：拆成 5 分钟小步骤每步动手。整段复制提示词扔给 AI 即可开聊。
    - [08 · 肯·罗宾逊爵士](/docs/how-to-use/prompts/robinson): TED 温暖演讲风：从意想不到的小故事起手加金句收。整段复制提示词扔给 AI 即可开聊。
    - [09 · 西蒙·西涅克](/docs/how-to-use/prompts/sinek): TED 黄金圈：Why 到 How 到 What 三层展开。整段复制提示词扔给 AI 即可开聊。
    - [10 · 尤瓦尔·赫拉利](/docs/how-to-use/prompts/harari): 人类简史风宏大史诗：把工具放回 1 万年的故事里。整段复制提示词扔给 AI 即可开聊。
    - [11 · 樊登](/docs/how-to-use/prompts/fandeng): 樊登读书风：浓缩三个核心结论加联系工作生活。整段复制提示词扔给 AI 即可开聊。
    - [12 · 丹尼尔·卡尼曼](/docs/how-to-use/prompts/kahneman): 思考快与慢风：让你看清自己直觉错在哪。整段复制提示词扔给 AI 即可开聊。
    - [13 · 罗翔](/docs/how-to-use/prompts/luoxiang): B 站法律科普段子手：虚构小人物加严肃论述加金句。整段复制提示词扔给 AI 即可开聊。
    - [14 · 罗振宇](/docs/how-to-use/prompts/luozhenyu): 罗辑思维 60 秒：金句压缩加意外角度加可转发。整段复制提示词扔给 AI 即可开聊。
    - [15 · 易中天](/docs/how-to-use/prompts/yizhongtian): 百家讲坛品三国：用三国人物对照工具。整段复制提示词扔给 AI 即可开聊。
    - [16 · 吴晓波](/docs/how-to-use/prompts/wuxiaobo): 激荡三十年财经史叙事：缘起到演进到关键节点。整段复制提示词扔给 AI 即可开聊。
    - [17 · 李永乐](/docs/how-to-use/prompts/liyongle): 中学物理老师 B 站科普：黑板提问到推导到示意图。整段复制提示词扔给 AI 即可开聊。
    - [18 · 乔布斯](/docs/how-to-use/prompts/jobs): 苹果发布会三幕式：问题加拒绝现有加揭幕新东西。整段复制提示词扔给 AI 即可开聊。
    - [19 · 马斯克](/docs/how-to-use/prompts/musk): 第一性原理加黑色幽默：拆到底层再加锐评。整段复制提示词扔给 AI 即可开聊。
    - [20 · 巴菲特](/docs/how-to-use/prompts/buffett): 致股东信平实自嘲：第一人称复盘加真实数字。整段复制提示词扔给 AI 即可开聊。
- Claude Code
  - [Claude Code 中文教程](/docs/claude-code): 基于 Anthropic 官方文档、源码和发布记录重写的 Claude Code 中文教程，连接翔宇工作流的真实项目实践。
  - 从原理到实战
    - [Claude Code 从原理到实战](/docs/claude-code/understanding): 12 篇翔宇深度讲解的阅读地图：从 Claude Code 是什么，到上下文、记忆、命令文件、SubAgents、MCP、权限和插件。
    - [01 · Claude Code 是什么](/docs/claude-code/understanding/01-what-is-claude-code): 解释 Claude Code 为什么不是聊天框，而是能进入本机项目、读文件、改代码、跑命令并围绕任务规划的编程 Agent。
    - [02 · 一次能看多少代码](/docs/claude-code/understanding/02-context-window): 上下文窗口不是记忆，是一张会满的工作台。100 万 token 听起来巨大，但用了 78% 你就会觉察 Claude 变笨——理解这张桌子怎么运作、怎么管，操作上的困惑就全解开了。
    - [03 · 怎么记住你的习惯](/docs/claude-code/understanding/03-memory): 上下文是一次性的，关机就清空。Claude Code 怎么跨会话记住你的项目、习惯、偏好？答案是双轨记忆——你写的 CLAUDE.md 持久指令 + 它自己写的 Auto Memory 工作笔记。
    - [04 · 怎么和 AI 说话](/docs/claude-code/understanding/04-prompting): 提示词不是模板游戏，是信息密度游戏。同样意思不同表达，AI 输出天差地别——不是因为语气，是因为信息量。理解信息四件套（目标 / 上下文 / 边界 / 验收），你给的每条指令都会立刻不一样。
    - [05 · AI 怎么决定想多深](/docs/claude-code/understanding/05-thinking-depth): 思考深度不是把 AI 变聪明，而是决定回答前走多少步推理。变量改名用 low，架构决策用 xhigh，关键迁移再考虑 max。
    - [06 · 把重复的话写成文件](/docs/claude-code/understanding/06-command-files): Skills 不是给 Claude 装新能力，而是把你反复说的流程写成文件。description 决定何时触发，正文决定怎么做。
    - [07 · 派助手去干活](/docs/claude-code/understanding/07-subagents): SubAgents 的核心不是并行，而是把会污染主对话的搜索、日志和改动放进独立上下文，只把结论带回来。
    - [08 · 多个 AI 怎么协作](/docs/claude-code/understanding/08-multi-agent): Agent Teams 不是更多 SubAgents，而是让多个 Claude Code 会话带着共享任务列表和消息系统协作，适合跨模块、多假设、需要对齐的任务。
    - [09 · 怎么连外部服务](/docs/claude-code/understanding/09-mcp): MCP 不是给 Claude Code 加脑子，而是让它够到 GitHub、Sentry、数据库这些外部系统的标准接口。
    - [10 · 怎么让操作 100% 执行](/docs/claude-code/understanding/10-operation-control): Hooks 不是提醒 Claude Code 记得做事，而是在工具调用、提示提交、停止前后设置确定性检查点。能容忍遗漏写 CLAUDE.md，不能容忍就用 Hook。
    - [11 · 该给 AI 多少权限](/docs/claude-code/understanding/11-permissions): Claude Code 权限不是安全感按钮，而是把读、写、运行命令、联网和成本拆成不同信任层级。学会用六种模式、Allow/Ask/Deny、沙盒和预算边界。
    - [12 · 怎么给 AI 装插件](/docs/claude-code/understanding/12-plugins): Claude Code Plugin 不是单个新功能，而是把 Skills、Agents、Hooks、MCP、LSP、主题和监控打包成可安装、可更新、可分发的能力包。
  - 官方教程中文版
    - [Claude Code 官方教程中文版](/docs/claude-code/official): 基于 Anthropic 官方文档重写的 Claude Code 中文教程入口，覆盖入门、配置、权限、MCP、Skills、Subagents、Hooks 和 SDK。
    - 入门与安装
      - [入门与安装](/docs/claude-code/official/00-getting-started): Claude Code 入门与安装：用 4 章完成产品定位、安装更新、登录认证、平台入口选择，先把终端、桌面应用、IDE、网页和云供应商边界理清。
      - [Claude Code 是什么](/docs/claude-code/official/00-getting-started/overview): Claude Code 不是聊天框，而是能读项目、改文件、跑命令、验证结果的智能体式编程工具。先理解它进入工程现场的工作方式，再开始安装。
      - [安装和更新 Claude Code](/docs/claude-code/official/00-getting-started/install): Claude Code 安装不要只复制一条命令。先选原生安装器、Homebrew、WinGet 或 Linux 包管理器，再验证 PATH、doctor 和更新策略。
      - [登录与认证](/docs/claude-code/official/00-getting-started/authentication): Claude Code 登录不是只有订阅账号。个人用 Claude.ai，团队可用 Teams、Enterprise、Console、Bedrock、Vertex AI 或 Microsoft Foundry。
      - [选择平台与集成](/docs/claude-code/official/00-getting-started/platforms): Claude Code 同一套智能体循环可以跑在 CLI、Desktop、IDE、Web、Mobile、Slack 和 CI/CD。选入口先看项目在哪里、任务要不要长跑、你需不需要视觉审查。
    - 核心配置与能力
      - [核心配置与能力](/docs/claude-code/official/01-core-capabilities): Claude Code 核心配置与能力：设置、权限、记忆、MCP 四章串起配置作用域、工具权限、长期记忆和外部连接边界。
      - [配置 Claude Code](/docs/claude-code/official/01-core-capabilities/settings): Claude Code 配置不是只改一个 settings.json。先分清 managed、user、project、local 四个作用域，再决定权限、环境变量、Hooks、MCP、插件和记忆放哪里。
      - [管理权限](/docs/claude-code/official/01-core-capabilities/permissions): Claude Code 权限不是一个总开关，而是控制 Bash、Read、Edit、WebFetch、MCP、Subagents 等工具调用的边界。学会六种模式、deny/ask/allow、路径规则和 sandbox（沙盒）配合。
      - [使用记忆机制](/docs/claude-code/official/01-core-capabilities/memory): Claude Code 的记忆分成 CLAUDE.md 和 auto memory（自动记忆）。学会文件位置、加载顺序、@import、.claude/rules、/memory、claudeMdExcludes 和排障边界。
      - [连接 MCP](/docs/claude-code/official/01-core-capabilities/mcp): Claude Code 通过 MCP 连接外部工具、数据库和 API。学会 HTTP、SSE、stdio、作用域、OAuth、输出限制、Tool Search、权限和 managed MCP 的边界。
    - 扩展与自动化
      - [扩展与自动化](/docs/claude-code/official/02-extensions-automation): Claude Code 扩展与自动化：从扩展能力地图开始，逐章掌握 Skills、Subagents、Hooks、Commands 和 Agent SDK 的分工与组合。
      - [查看扩展能力地图](/docs/claude-code/official/02-extensions-automation/extension-map): Claude Code 扩展不是越多越好。用一张决策地图分清 CLAUDE.md、Rules、Skills、MCP、Subagents、Hooks、Commands、Plugins 和 Agent SDK。
      - [使用 Skills](/docs/claude-code/official/02-extensions-automation/skills): Claude Code Skills 用 SKILL.md 沉淀重复流程和参考资料。学会作用域、frontmatter、动态上下文、allowed-tools、context fork 和权限控制。
      - [配置 Subagents](/docs/claude-code/official/02-extensions-automation/subagents): Claude Code Subagents 用隔离上下文处理专门任务。学会内置 agents、自定义 frontmatter、工具边界、MCP 限域、skills 预加载、memory、background 和 worktree。
      - [使用 Hooks](/docs/claude-code/official/02-extensions-automation/hooks): Claude Code Hooks 在生命周期事件上执行确定性自动化。学会事件、matcher、if、exit code、JSON 输出、command/prompt/agent/HTTP hooks 和安全边界。
      - [使用 Commands](/docs/claude-code/official/02-extensions-automation/commands): 说明 Claude Code slash commands、Skill commands、legacy commands、MCP prompts 和常用命令分组。
      - [使用 Agent SDK](/docs/claude-code/official/02-extensions-automation/agent-sdk): 用 Claude Agent SDK 调用 Claude Code agent loop，覆盖认证、权限、会话、MCP、Hooks、Subagents 和部署边界。
- OpenAI Codex
  - [OpenAI Codex 中文教程](/docs/codex): 基于 OpenAI 官方资料重写的 Codex 中文教程，覆盖 App、IDE、CLI、Cloud 和安全边界。
  - 从原理到实战
    - [Codex 从原理到实战](/docs/codex/understanding): 面向新手的 Codex 理解路线：先理解任务、上下文、边界和验证，再进入官方教程中的命令与配置。
    - [01 · Codex 是什么](/docs/codex/understanding/what-is-codex): 把 Codex 从会写代码的聊天框，重新理解成能进入项目现场的工程协作 Agent。
    - [02 · 一次任务是怎么完成的](/docs/codex/understanding/how-a-task-completes): 把 Codex 的一次任务理解成从目标、上下文、计划、执行到验证交付的工程管线。
    - [03 · Codex 看到的上下文从哪里来](/docs/codex/understanding/context-engineering): 理解任务、项目、代码、规则和反馈五层上下文，减少 Codex 凭空猜测和无关改动。
    - [04 · 为什么 AGENTS.md 能改变 Codex 行为](/docs/codex/understanding/agents-md-guide): 面向新手解释 AGENTS.md 为什么能让 Codex 更稳定：它是项目和 Agent 的协作接口。
    - [05 · Codex 为什么需要审批和沙箱](/docs/codex/understanding/sandbox-approval): 用工程边界理解 sandbox 和 approval：一个管能不能做，一个管要不要问你。
    - [06 · App、IDE、CLI、Cloud 怎么选](/docs/codex/understanding/cli-app-ide-cloud): 按任务场景选择 Codex 入口：本地终端、编辑器、桌面任务中心或云端异步环境。
    - [07 · 如何让 Codex 调用工具和访问数据](/docs/codex/understanding/mcp-tools-guide): 理解 Codex 的内置工具、浏览器能力、MCP 外部系统接入和 skills 复用边界。
    - [08 · Skills、Subagents、Hooks 解决什么问题](/docs/codex/understanding/skills-subagents-hooks): 区分三种进阶机制：skills 复用流程，subagents 拆分工作，hooks 自动检查关键事件。
    - [09 · 如何控制模型、速度、成本和质量](/docs/codex/understanding/model-cost-speed): 按任务复杂度选择模型、推理强度、速度档位和上下文策略，避免把高成本配置当默认值。
    - [10 · 团队协作和生产环境怎么落地](/docs/codex/understanding/team-production): 把个人 Codex 使用升级成团队可治理流程：共识、边界、集成、自动化和审计。
    - [11 · 从理解到实战场景](/docs/codex/understanding/from-theory-to-practice): 把模糊需求改写成 Codex 能执行、能验证、能交付的工程任务。
    - [12 · 一句话复盘 Codex 全貌](/docs/codex/understanding/complete-overview): 把 Codex 的入口、上下文、工具、边界、验证和团队落地压成一条新手能复用的决策链。
  - 官方教程中文版
    - [Codex 官方教程中文版](/docs/codex/official): 基于 OpenAI 官方资料，按入口、配置、安全、扩展、Cloud、团队和实战场景重写的 Codex 中文查询手册。
    - 新手必读
      - [新手必读](/docs/codex/official/00-getting-started): 从定位、快速开始、登录认证、术语和安全检查开始，建立 Codex 的第一条安全使用闭环。
      - [理解 Codex 定位](/docs/codex/official/00-getting-started/00-codex-positioning): 说明 Codex 在 OpenAI 产品体系里的定位、适合解决的问题，以及新手第一次使用前要理解的基本边界。
      - [快速上手 Codex](/docs/codex/official/00-getting-started/01-quickstart): 基于 OpenAI 官方 Quickstart，帮助新手选择 Codex 入口，并完成第一次安全、可验证的使用。
      - [完成登录和认证](/docs/codex/official/00-getting-started/02-auth): 区分 ChatGPT 登录、API key 登录、云端认证、凭据缓存和受管理环境中的认证控制。
      - [新手术语速查表](/docs/codex/official/00-getting-started/glossary): 给第一次使用 Codex 的中文开发者快速查词，先知道概念在哪些场景出现，再去读对应章节。
      - [第一次安全使用清单](/docs/codex/official/00-getting-started/first-safe-use-checklist): 基于官方 Codex 快速开始和安全教程，讲清第一次把 Codex 放进真实项目时怎么先读懂、再小改、最后验证。
    - 产品入口
      - [产品入口](/docs/codex/official/01-products): 基于官方 Codex 产品教程，帮新手分清 CLI、IDE、App、Web、Windows 和自动化入口各自适合什么任务。
      - [使用命令行版 Codex](/docs/codex/official/01-products/03-cli): Codex CLI 是 OpenAI 的本地 coding agent，可以在终端里读取代码、修改代码、运行命令，并把结果交给你审查。
      - [使用桌面版 Codex](/docs/codex/official/01-products/04-app): 从安装、登录、选择项目、启动本地线程到审查 diff，完成 Codex App 的第一天使用闭环。
      - [使用网页版 Codex](/docs/codex/official/01-products/17-web): 介绍 Codex web 入口如何读取代码、修改代码和运行验证，适合不想先配置本地环境的新手。
      - [安装和使用 IDE 扩展](/docs/codex/official/01-products/20-ide-install): 说明如何安装 Codex IDE extension，并理解它和本地项目、编辑器上下文、登录方式的关系。
      - [掌握 IDE 扩展功能](/docs/codex/official/01-products/21-ide-features): 梳理 Codex IDE extension 的核心功能，包括编辑器上下文、local/cloud 模式、图片输入和代码审查。
      - [调整 IDE 扩展设置](/docs/codex/official/01-products/22-ide-settings): Codex IDE extension settings 用来调整 IDE 里的 Codex 使用体验。
      - [使用 IDE 命令](/docs/codex/official/01-products/23-ide-commands): 整理 Codex IDE extension command palette 命令，以及适合绑定快捷键的常用操作。
      - [使用 IDE 斜杠命令](/docs/codex/official/01-products/24-ide-slash): 说明 IDE slash commands 如何在聊天输入框里切换模式、查看状态和提交反馈。
      - [使用 CLI 斜杠命令](/docs/codex/official/01-products/25-cli-slash): 理解 Codex CLI slash commands 的控制面：会话、模型、权限、上下文、审查和分支探索。
      - [掌握 CLI 功能](/docs/codex/official/01-products/26-cli-features): 按交互、自动化、远程连接、审查和扩展五类能力理解 Codex CLI，而不是背完整命令清单。
      - [CLI 参数怎么用](/docs/codex/official/01-products/27-cli-args): 把 Codex CLI 参数按任务入口、权限控制和自动化场景拆开，避免把会随版本变化的命令清单写死。
      - [跑非交互任务](/docs/codex/official/01-products/28-non-interactive): 基于官方 non-interactive mode，讲清 codex exec 适合什么自动化任务、权限怎么给、输出怎么验收。
      - [连接 Codex App Server](/docs/codex/official/01-products/32-app-server): 理解 Codex App Server 适合远程 TUI 和富客户端集成，不要把它误用成普通 CI 自动化入口。
      - [掌握 App 核心功能](/docs/codex/official/01-products/33-app-core): 按 projects、threads、worktrees、automations、Git、terminal 和 browser 理解 Codex App 的桌面工作台能力。
      - [调整 App 设置](/docs/codex/official/01-products/34-app-settings): Codex App 的 settings panel 用来调整 App 行为、文件打开方式，以及外部工具连接方式。
      - [设置 App 自动化任务](/docs/codex/official/01-products/35-app-automation): 基于官方 Codex App Automations 教程，讲清 automations 适合什么重复任务、worktree 怎么选、权限怎么控。
      - [用内置浏览器验收页面](/docs/codex/official/01-products/36-app-browser): 说明 in-app browser 如何让 Codex 共享网页视图、预览页面，并在同一 thread 中接收视觉反馈。
      - [使用 App 命令](/docs/codex/official/01-products/37-app-commands): 这篇整理 Codex App 中常用 commands、keyboard shortcuts、slash commands 和 deeplinks。
      - [让 Codex 操作电脑](/docs/codex/official/01-products/38-computer-use): 说明 Computer Use 如何让 Codex 操作本地 Mac app，并处理必须通过 GUI 完成的任务。
      - [配置本地运行环境](/docs/codex/official/01-products/39-local-runtime): Local environments 用来为 worktrees 配置 setup steps，也可以为 project 配置常用 actions。
      - [在 App 中审查改动](/docs/codex/official/01-products/40-app-review): Review pane 帮你理解 Codex 改了什么、给出针对性反馈，并决定哪些改动要保留。
      - [排查 App 问题](/docs/codex/official/01-products/41-app-troubleshoot): 这篇整理 Codex App 常见问题、日志位置和恢复方式。
      - [使用 Windows 版 App](/docs/codex/official/01-products/42-windows-app): 讲清 Codex 在 Windows 上的三种运行方式、sandbox 边界、WSL 选择和常见排错。
      - [用 Worktrees 并行开发](/docs/codex/official/01-products/43-worktrees): 理解 Codex App 中 worktree 的用途：隔离并行任务、保护当前工作树，并安全地 handoff 回本地。
      - [在 Windows 上使用 Codex](/docs/codex/official/01-products/120-windows-codex): 按 native Windows、WSL2、App、CLI 和 IDE extension 的边界选择 Windows 上的 Codex 运行方式。
    - 规则、安全与配置
      - [规则、安全与配置](/docs/codex/official/02-config-security): 理解 Codex 项目规则、配置、安全审批、沙箱边界和 Security 相关能力。
      - [编写项目规则文件](/docs/codex/official/02-config-security/05-project-rules): 基于官方 Codex AGENTS.md 和 Rules 教程，讲清全局规则、项目规则、嵌套覆盖、fallback 文件名和排障方式。
      - [配置 Codex 基础选项](/docs/codex/official/02-config-security/06-basic-config): 梳理 Codex config.toml 的加载顺序、权限边界和新手最该先改的基础项。
      - [设置审批和安全边界](/docs/codex/official/02-config-security/07-approval-security): 理解 Codex 的 sandbox、approval、network access 和自动审批审查，给本地与云端任务设置正确边界。
      - [高级配置怎么读](/docs/codex/official/02-config-security/29-advanced-config): 把 Codex 高级配置按使用场景和风险边界拆开，而不是复制一整张会随版本变化的配置表。
      - [查询完整配置项](/docs/codex/official/02-config-security/30-all-config-options): 用官方 Configuration Reference 和 JSON schema 查询 Codex 配置项，不把高频变化的长表硬搬进教程。
      - [参考配置样例](/docs/codex/official/02-config-security/31-config-samples): 用少量 config.toml 配置让 Codex 行为稳定，而不是复制一整份巨型配置。
      - [定制 Codex 行为](/docs/codex/official/02-config-security/48-customize-behavior): 把 AGENTS.md、Memories、Skills、MCP 和 Subagents 放到同一张行为定制地图里。
      - [理解沙箱边界](/docs/codex/official/02-config-security/49-sandbox-boundaries): Sandbox 是让 Codex 能自主行动、但不获得机器 unrestricted access 的边界。
      - [理解网络安全边界](/docs/codex/official/02-config-security/50-network-security): 这些 safeguards 包括训练模型拒绝明显 malicious requests，例如窃取 credentials。
      - [迁移自定义提示到新机制](/docs/codex/official/02-config-security/52-migrate-prompts): 说明 custom prompts 弃用后，如何把可复用 instructions 迁移到 Codex skills。
      - [用 Rules 控制命令边界](/docs/codex/official/02-config-security/53-rules-command-control): Rules 用来控制 Codex 可以在 sandbox 外运行哪些 commands。
      - [理解 Codex 安全模型](/docs/codex/official/02-config-security/72-security-model): 介绍 Codex Security 的模型：如何在连接的 GitHub repositories 中发现、验证和修复潜在漏洞。
      - [配置安全运行环境](/docs/codex/official/02-config-security/73-secure-runtime): 说明 Codex Security 从授权接入到 reviewed findings、remediation pull request 的基本流程。
      - [排查安全常见问题](/docs/codex/official/02-config-security/74-security-troubleshoot): 用 FAQ 方式理解 Codex Security 的定位、扫描流程、隔离边界、验证结果和人工审查责任。
      - [改进威胁模型](/docs/codex/official/02-config-security/75-threat-model): 这页说明 threat model 是什么，以及编辑它如何改善 Codex Security 的 suggestions。
    - 扩展能力
      - [扩展能力](/docs/codex/official/03-extensions): 理解 Codex 扩展能力：MCP、skills、subagents、hooks、memory、plugins 和 workflows。
      - [接入 MCP 工具和上下文](/docs/codex/official/03-extensions/08-mcp-integration): Model Context Protocol 把 Codex 连接到外部工具、文档、数据源和可执行动作。
      - [用 Skills 复用能力](/docs/codex/official/03-extensions/09-skills-reuse): 理解 agent skills 如何把 instructions、resources 和 scripts 打包成可复用的 Codex 工作流。
      - [用 Subagents 拆分任务](/docs/codex/official/03-extensions/10-subagents-split): 判断什么时候该用 Codex subagents 并行拆任务，什么时候保持单 agent，并控制上下文、权限和成本。
      - [用 Hooks 接入自动检查](/docs/codex/official/03-extensions/11-hooks-checks): 基于官方 Codex Hooks 教程，讲清 hooks 能做什么、不能做什么，以及如何从低风险检查开始。
      - [用 Workflows 编排任务](/docs/codex/official/03-extensions/12-workflows-orchestration): 把 Codex 任务组织成可复用 workflow：使用场景、上下文、步骤、验证和交付标准。
      - [理解 Subagents 的分工模型](/docs/codex/official/03-extensions/51-subagents-model): 说明 Codex subagents 如何并行探索、实现或分析任务，以及什么时候应该拆分给子 Agent。
      - [使用记忆能力](/docs/codex/official/03-extensions/64-memory): Memories 默认关闭。launch 时，European Economic Area、United Kingdom 和 Switzerland 不可用。
      - [了解 Chronicle 记忆](/docs/codex/official/03-extensions/65-chronicle-memory): Chronicle 是 opt-in research preview，用屏幕上下文帮助 Codex 构建 memories。
      - [安装和管理插件](/docs/codex/official/03-extensions/68-plugins-manage): Plugins 会把 skills、app integrations 和 MCP servers 打包成 Codex 可复用的工作流。
      - [构建自己的插件](/docs/codex/official/03-extensions/69-build-plugins): 区分 skill、plugin、marketplace 的职责，并用最小分发单元安全发布第一版 Codex plugin。
    - 模型、价格与效率
      - [模型、价格与效率](/docs/codex/official/04-model-pricing): 理解 Codex 模型选择、价格、用量、速度档位和提示词效率，避免把高成本配置用在低复杂度任务上。
      - [写好 Codex 提示词](/docs/codex/official/04-model-pricing/13-prompting): Prompt 描述你希望 Codex 做什么，好的提示词会写清目标、上下文、边界和验证方式。
      - [选择 Codex 模型](/docs/codex/official/04-model-pricing/14-model-selection): 说明 Codex 模型选择思路：按入口、任务复杂度、速度、成本和验证要求做取舍。
      - [理解价格和用量](/docs/codex/official/04-model-pricing/15-pricing-usage): 解释 Codex 价格、用量、credits、ChatGPT 订阅和 API key 的关系；具体价格和额度以官方页面为准。
      - [提升 Codex 响应速度](/docs/codex/official/04-model-pricing/16-speed-up): 说明 Codex Fast mode 和 Codex-Spark 的区别：一个是加速支持模型，一个是独立的低延迟模型选择。
      - [判断功能成熟度](/docs/codex/official/04-model-pricing/57-feature-maturity): 说明 Codex feature maturity label 的含义，以及如何判断实验功能是否适合生产流程。
      - [阅读使用经验和实践建议](/docs/codex/official/04-model-pricing/63-best-practices): 把 OpenAI 的 Codex best practices 整理成稳定工作法：上下文、规则、配置、验证、MCP、skills 和自动化。
    - 云端与远程环境
      - [云端与远程环境](/docs/codex/official/05-cloud-remote): 基于官方 Codex 教程，帮新手分清 Cloud、联网权限和远程开发环境各自解决什么问题。
      - [配置云端运行环境](/docs/codex/official/05-cloud-remote/18-cloud-runtime): Cloud environments 用来控制 Codex 在执行 cloud tasks 时安装什么、运行什么、能访问哪些网络和 secrets。
      - [管理 Agent 联网权限](/docs/codex/official/05-cloud-remote/19-network-permissions): 基于 OpenAI 官方 Agent internet access 文档，学习新手什么时候该给 Codex 联网权限，以及如何降低风险。
      - [连接远程开发环境](/docs/codex/official/05-cloud-remote/70-remote-dev): SSH remote connections 当前处于 alpha。
    - 团队与集成
      - [团队与集成](/docs/codex/official/06-team-integration): 理解 Codex 在团队协作中的接入方式：CI、GitHub Action、Slack、Linear、governance 和 SDK。
      - [在 CI/CD 中维护认证](/docs/codex/official/06-team-integration/44-cicd-auth): 基于官方 Codex CI/CD 认证教程，讲清 API key 默认路线、ChatGPT-managed auth 高级路线和 auth.json 的安全边界。
      - [用 GitHub Action 跑 Codex](/docs/codex/official/06-team-integration/45-github-action): 基于官方 Codex GitHub Action 教程，讲清 openai/codex-action@v1 适合什么 CI/CD 任务、权限怎么给、结果怎么验收。
      - [在开源项目中使用 Codex](/docs/codex/official/06-team-integration/46-open-source-use): 开源维护者经常在幕后承担关键工作，让整个软件生态保持健康。
      - [了解开源项目条款](/docs/codex/official/06-team-integration/47-open-source-terms): 梳理 Codex for OSS program terms 的核心结构，帮助开源项目理解申请和使用边界。
      - [做企业管理员初始化](/docs/codex/official/06-team-integration/54-enterprise-admin): 为 Enterprise workspace 推出 Codex 前，先确定 owner、入口范围、RBAC、managed configuration 和治理边界。
      - [下发托管配置](/docs/codex/official/06-team-integration/55-managed-config): 基于官方 Codex managed configuration 教程，面向新手讲清 requirements、managed defaults、cloud-managed requirements 和企业安全边界。
      - [做治理和可观测](/docs/codex/official/06-team-integration/56-governance-observability): Codex 为 enterprise teams 提供两类能力：
      - [将 Codex 接入 Agents SDK](/docs/codex/official/06-team-integration/58-agents-sdk): 把 Codex 作为 MCP server 暴露给 OpenAI Agents SDK，用于可编排的软件工作流。
      - [建设 AI 原生工程团队](/docs/codex/official/06-team-integration/59-ai-native-team): 把 OpenAI 的 AI-native engineering guide 转成可执行的团队落地框架：哪些交给 agent，哪些仍由工程师负责。
      - [用 Codex 做 GitHub 代码审查](/docs/codex/official/06-team-integration/60-github-code-review): Codex code review 可以为 GitHub pull requests 增加一轮 high-signal review。
      - [从 Linear 使用 Codex](/docs/codex/official/06-team-integration/61-linear-integration): 你可以在 Linear 中使用 Codex，把 issues 里的工作交给它处理。
      - [从 Slack 使用 Codex](/docs/codex/official/06-team-integration/62-slack-integration): 你可以在 Slack 中使用 Codex，从 channels 和 threads 直接启动 coding tasks。
      - [了解开源入口](/docs/codex/official/06-team-integration/67-open-source-entry): OpenAI 会以 open 的方式开发 Codex 的关键部分。
      - [用 Codex SDK 集成 Agent](/docs/codex/official/06-team-integration/71-codex-sdk): 判断什么时候该用 Codex SDK，什么时候先用 codex exec，并为团队自动化设计权限、结构化输出和失败处理。
    - 学习路线
      - [学习路线](/docs/codex/official/07-learning-paths): 按 Web、生产代码库、原生 App、游戏和效率场景选择 Codex 学习路径。
      - [游戏开发路线](/docs/codex/official/07-learning-paths/76-game-dev-path): Codex 结合 image generation，用来创建 browser-based games 和其他类型 games 会很有用。
      - [原生应用开发路线](/docs/codex/official/07-learning-paths/77-native-app-path): 当每一次 pass 都配有 build、run 或 simulator loop 时，Codex 很适合 Apple platform projects。
      - [生产系统路线](/docs/codex/official/07-learning-paths/78-production-path): 整理生产级代码库里的 Codex 用法：在 history、tests、owners 和 production constraints 中推进任务。
      - [效率与协作路线](/docs/codex/official/07-learning-paths/79-productivity-path): Codex 可以帮助你跨多个 apps 和 files 管理工作，并与团队协作。
      - [Web 开发路线](/docs/codex/official/07-learning-paths/80-web-dev-path): 整理 Codex 在 Web 开发中的典型用法，包括设计系统、视觉输入、响应式 UI 和浏览器验证。
      - [按场景选择学习路线](/docs/codex/official/07-learning-paths/118-scenario-paths): 整理 Codex use cases 的场景集合、筛选项和学习路径，方便按任务类型选阅读顺序。
    - 实战场景
      - [实战场景](/docs/codex/official/08-scenarios): 按真实使用场景查 Codex 用法：数据清洗、代码迁移、Bug triage、UI、移动端、QA 和团队流程。
      - [实战场景总览](/docs/codex/official/08-scenarios/81-scenarios-overview): 这页是 Codex use cases 总索引。
      - [让 Codex 能调用你的命令行工具](/docs/codex/official/08-scenarios/82-cli-tool-use): 把重复访问 API、日志、数据库或团队脚本的动作封装成 agent-friendly CLI，并配套 skill 固化调用方法。
      - [用 Codex 查询表格数据](/docs/codex/official/08-scenarios/83-tabular-data): 说明如何让 Codex 读取 CSV、电子表格或 dashboard export，回答明确问题并生成可视化页面。
      - [用 Codex 升级 API 接入](/docs/codex/official/08-scenarios/84-api-upgrade): 说明 OpenAI API 升级时如何用 Codex 盘点现状、做最小迁移，并用 evals 验证行为没有退化。
      - [用 Codex 做 Bug 分诊](/docs/codex/official/08-scenarios/85-bug-triage): 说明如何让 Codex 只读扫查 Sentry、Slack、Linear、GitHub 和 logs 中的 bug 信号。
      - [用 Codex 做浏览器游戏](/docs/codex/official/08-scenarios/86-browser-game): 说明如何用 Codex 开发可玩的浏览器游戏，并在 controls、timing、UI feel 和素材上持续验证。
      - [把你的应用接入 ChatGPT](/docs/codex/official/08-scenarios/87-chatgpt-integration): 说明如何把产品接入 ChatGPT：先选明确用户结果，再设计少量 tools、MCP server 和可选 widget。
      - [整理脏数据并生成可用数据集](/docs/codex/official/08-scenarios/88-data-cleaning): 用 Codex 清洗 CSV 或 spreadsheet 数据：先保留原文件，再生成可审查的清洗副本和 data-quality note。
      - [让 Codex 执行代码迁移](/docs/codex/official/08-scenarios/89-code-migration): 说明如何用 Codex 做代码迁移：先盘点 legacy system，再按 checkpoint 验证 parity。
      - [让 Codex 快速读懂大型代码库](/docs/codex/official/08-scenarios/90-large-codebase): 说明如何让 Codex 给陌生 repo 建立可编辑地图，找出 request flow、模块职责和下一步阅读路径。
      - [把聊天消息转成可交付任务](/docs/codex/official/08-scenarios/91-chat-to-task): 说明如何让 Computer Use 从 Messages thread 识别待办，跨应用完成任务并起草回复。
      - [从数据集到分析报告](/docs/codex/official/08-scenarios/92-data-to-report): 说明如何让 Codex 把数据分析产出成可复查、可重跑、可交付的报告 artifact。
      - [发布应用或网站](/docs/codex/official/08-scenarios/93-deploy-app): 说明如何让 Codex 从 repo、screenshot、design brief 或 API doc 出发构建网站并部署 preview。
      - [把用户反馈变成开发任务](/docs/codex/official/08-scenarios/94-feedback-to-task): 说明如何让 Codex 把分散在 Slack、survey、GitHub、Linear 和研究笔记里的反馈整理成可 review 任务。
      - [把 Figma 设计落成前端代码](/docs/codex/official/08-scenarios/95-figma-to-code): 说明如何让 Codex 从 Figma 拉取设计上下文和 assets，并用浏览器验证实现是否贴合参考图。
      - [构建适配多端的前端界面](/docs/codex/official/08-scenarios/96-multi-platform-ui): 说明如何让 Codex 根据 screenshots、design brief 或视觉参考生成 responsive UI，并在真实浏览器中迭代。
      - [生成汇报幻灯片](/docs/codex/official/08-scenarios/97-report-slides): 说明如何让 Codex 用 slides 和 imagegen skills 创建或修改 PowerPoint deck。
      - [让 Codex 审查 GitHub PR](/docs/codex/official/08-scenarios/98-pr-review): 说明 Codex code review 如何在 GitHub PR 上补充 regression、missing tests 和 risky behavior signals。
      - [为 iOS App 增加系统动作入口](/docs/codex/official/08-scenarios/99-ios-app-intents): 说明如何用 Codex 设计和实现 App Intents，让 iOS app 动作暴露给 Shortcuts、Siri、Spotlight 和 widgets。
      - [适配 Apple Liquid Glass 视觉体系](/docs/codex/official/08-scenarios/100-apple-liquid-glass): 说明如何把 SwiftUI app 迁移到 Liquid Glass，并用小步审计和验证降低重设计风险。
      - [在 iOS 模拟器里复现和修 Bug](/docs/codex/official/08-scenarios/101-ios-simulator-bug): 说明用 Codex 调试 iOS bug 时，如何建立 simulator loop、收集证据、修改代码并复现验证。
      - [重构 SwiftUI 界面](/docs/codex/official/08-scenarios/102-swiftui-refactor): 说明如何让 Codex 拆分过大的 SwiftUI screen，在不改行为的前提下降低后续维护成本。
      - [用 Codex 反复攻克难题](/docs/codex/official/08-scenarios/103-iterate-on-problems): 说明如何把 Codex 用作可评分的改进循环，处理视觉、体验和主观质量类任务。
      - [用 Codex 学会新概念](/docs/codex/official/08-scenarios/104-learn-concepts): 说明如何用 Codex 学习论文、课程和新概念，重点建立可工作的 mental model，而不是只要摘要。
      - [搭建 Mac 应用基础壳](/docs/codex/official/08-scenarios/105-mac-app-skeleton): 基于 OpenAI 官方 Mac app shell use case，学习如何让 Codex 先搭出真正像桌面应用的 SwiftUI 外壳。
      - [给 Mac 应用补遥测能力](/docs/codex/official/08-scenarios/106-mac-telemetry): 基于官方 Codex macOS telemetry 场景教程，面向新手讲清什么时候加 OSLog、怎么控制范围、怎么从日志证明问题。
      - [精修界面细节](/docs/codex/official/08-scenarios/107-ui-polish): 说明如何用 Codex-Spark 做短循环 UI polish：视觉 note、focused edit、browser check、再迭代。
      - [整理收件箱和待办入口](/docs/codex/official/08-scenarios/108-inbox-cleanup): 说明如何用 Codex 整理 Gmail inbox，参考写作样例起草回复，并在上下文不足时补充外部资料。
      - [构建 iOS 应用](/docs/codex/official/08-scenarios/109-ios-app): 说明用 Codex 做 iOS app 时的 CLI-first 路线，以及什么时候引入 XcodeBuildMCP、skills 或插件。
      - [构建 macOS 应用](/docs/codex/official/08-scenarios/110-macos-app): 说明用 Codex 构建 macOS app 时，如何从 scene、window、menus、settings 和 desktop UX 出发。
      - [用 Codex 协调新人入职](/docs/codex/official/08-scenarios/111-onboarding): 说明如何用 Codex 处理新员工入职流程：只读盘点、stage updates、准备账号和团队空间。
      - [为队友初始化工作环境](/docs/codex/official/08-scenarios/112-team-setup): 说明如何把 Slack、Gmail、calendar、trackers、docs 和 code 接入 Codex，建立团队级 signal loop。
      - [用 Computer Use 做应用验收](/docs/codex/official/08-scenarios/113-computer-use-qa): 说明用 Computer Use 做真实产品流程 QA：复现 user journeys、记录失败点并输出 triage summary。
      - [让 Codex 重构代码库](/docs/codex/official/08-scenarios/114-codebase-refactor): 说明如何用 Codex 小步清理工程债，包括 unused code、duplicated logic、stale abstractions 和 legacy patterns。
      - [把常用流程沉淀成 Skills](/docs/codex/official/08-scenarios/115-flow-to-skills): 说明如何把反复有效的 Codex thread、review rules、test commands 和 release checklist 沉淀成 skill。
      - [从 Slack 派发编码任务](/docs/codex/official/08-scenarios/116-slack-dispatch): 说明如何从 Slack thread 启动 Codex cloud task，并把结果带回线程或 Codex cloud 审查。
      - [让 Codex 操作本机应用](/docs/codex/official/08-scenarios/117-local-app-control): 说明 Computer Use 如何让 Codex 操作本地 Mac app，适合没有专用 plugin 的 GUI 任务。
    - 版本与迁移
      - [版本与迁移](/docs/codex/official/09-versions): 跟踪 Codex 迁移、演示视频和 changelog，判断版本变化对使用方式的影响。
      - [迁移到 Codex](/docs/codex/official/09-versions/66-migrate-to-codex): 说明如何用 Codex import flow 迁移其他 agent 的 instructions、configuration、skills、MCP servers 和 sessions。
      - [看官方演示视频](/docs/codex/official/09-versions/119-demo-videos): 这一页整理 Codex 官方视频入口。它适合做两件事：
      - [查看版本更新脉络](/docs/codex/official/09-versions/121-changelog): 用 Codex changelog 核验版本、模型、入口、集成和安全能力的当前状态，而不是复制静态更新表。
- Gemini CLI
  - [Gemini CLI 中文教程](/docs/gemini-cli): 基于 Google 官方文档、Google Cloud 文档和 google-gemini/gemini-cli 官方仓库重写的 Gemini CLI 中文教程。
  - 从原理到实战
    - [Gemini CLI 从原理到实战](/docs/gemini-cli/understanding): 从定位、终端任务循环、项目上下文、工具权限、MCP、Skills、模型配额、Code Assist 和真实项目实战理解 Gemini CLI。
    - [Gemini CLI 是什么](/docs/gemini-cli/understanding/01-what-is-gemini-cli): 从定位理解 Gemini CLI：它是终端里的 Google 系 AI coding agent，不是普通聊天框，也不只是 Gemini Code Assist 的命令行壳。
    - [安装、认证和第一次启动](/docs/gemini-cli/understanding/02-install-auth-first-run): Gemini CLI 起步流程：安装方式、认证选择、第一次运行和低风险只读任务。
    - [Gemini CLI 怎么完成一个任务](/docs/gemini-cli/understanding/03-how-gemini-cli-works): 理解 Gemini CLI 的任务循环：上下文装载、计划、工具调用、观察、迭代和人工确认。
    - [GEMINI.md、记忆和项目上下文](/docs/gemini-cli/understanding/04-project-context-gemini-md): 用 GEMINI.md、settings.json、memory 和 .geminiignore 管理 Gemini CLI 的项目上下文。
    - [工具、Shell 和权限边界](/docs/gemini-cli/understanding/05-tools-shell-permissions): 理解 Gemini CLI 的工具系统、Shell 执行、文件写入、web 工具、sandbox 和人工确认边界。
    - [MCP 和 Extensions](/docs/gemini-cli/understanding/06-mcp-extensions): 理解 Gemini CLI 如何通过 MCP 和 extensions 连接外部工具、数据源和团队工作流。
    - [Skills、Subagents、Hooks](/docs/gemini-cli/understanding/07-skills-subagents-hooks): 理解 Gemini CLI 的三层扩展：Skills 负责专门流程，Subagents 负责分工，Hooks 负责生命周期拦截。
    - [Plan mode、Checkpoint、Headless](/docs/gemini-cli/understanding/08-plan-checkpoint-headless): 用 Plan mode、checkpoint 和 headless mode 控制 Gemini CLI 的风险、回退和自动化。
    - [模型、配额和成本](/docs/gemini-cli/understanding/09-models-quota-cost): 理解 Gemini CLI 的模型选择、认证入口、配额、token caching 和成本控制。
    - [Code Assist、Cloud 和 GitHub Action](/docs/gemini-cli/understanding/10-code-assist-cloud-github): 理解 Gemini CLI 在 Google Code Assist、Cloud Shell、Vertex AI 和 GitHub Action 工作流里的位置。
    - [Gemini CLI vs Codex CLI vs Claude Code vs OpenCode](/docs/gemini-cli/understanding/11-gemini-cli-vs-codex-claude-opencode): 横向比较 Gemini CLI、Codex CLI、Claude Code、OpenCode 和 Cursor：定位、优势、短板和适合承担的工作流角色。
    - [真实项目贯穿实战](/docs/gemini-cli/understanding/12-real-project-walkthrough): 用一个真实项目流程串起 Gemini CLI：只读扫描、上下文沉淀、计划、修改、验证、checkpoint、headless 和 GitHub Action。
  - 官方教程中文版
    - [Gemini CLI 官方教程中文版](/docs/gemini-cli/official): 基于 Google 官方文档和 google-gemini/gemini-cli 官方仓库重写的中文查询手册，覆盖安装、认证、CLI、工具、MCP、配置、模型、安全、企业和自动化。
    - 入门
      - [Gemini CLI 入门](/docs/gemini-cli/official/00-getting-started): Gemini CLI 入门目录：定位、安装、认证、Quickstart、Cloud Shell、发布通道、配额费用和术语表。
      - [Gemini CLI 定位](/docs/gemini-cli/official/00-getting-started/00-positioning): 解释 Gemini CLI 是什么、它和 Gemini Code Assist / Google Cloud / IDE agent mode 的关系，以及为什么它不只是命令行聊天框。
      - [安装 Gemini CLI](/docs/gemini-cli/official/00-getting-started/01-installation): Gemini CLI 安装方式：npm、npx、Homebrew、Docker / Podman sandbox、源码运行，以及安装后的第一轮验收。
      - [认证方式](/docs/gemini-cli/official/00-getting-started/02-authentication): Gemini CLI 认证方式：Google OAuth、Gemini API Key、Vertex AI、Workspace/组织账号、Google Cloud Project 和 headless 场景怎么选。
      - [Quickstart](/docs/gemini-cli/official/00-getting-started/03-quickstart): Gemini CLI 第一次使用流程：安装、认证、启动、只读解释项目、处理文件、运行测试和查看配额。
      - [Cloud Shell 入口](/docs/gemini-cli/official/00-getting-started/04-cloud-shell): Gemini CLI 在 Google Cloud Shell 和 Cloud Workstations 中的使用边界，以及什么时候优先用 Cloud Shell。
      - [发布通道](/docs/gemini-cli/official/00-getting-started/05-release-channels): Gemini CLI stable、preview、nightly 三个发布通道的区别，以及普通用户、测试用户、贡献者应该怎么选。
      - [配额与费用](/docs/gemini-cli/official/00-getting-started/06-quota-and-pricing): Gemini CLI 配额与费用：Google 账号、Google AI Pro/Ultra、Gemini API Key、Vertex AI、Workspace 和 Code Assist 版本怎么理解。
      - [Gemini CLI 术语表](/docs/gemini-cli/official/00-getting-started/glossary): Gemini CLI 常见术语：ReAct、MCP、GEMINI.md、checkpoint、headless、Code Assist、Vertex AI、Cloud Shell、policy engine。
    - CLI 工作流
      - [CLI 工作流](/docs/gemini-cli/official/01-cli-workflow): Gemini CLI 日常使用入口：CLI 参数、slash commands、快捷键、文件管理、Shell、Web、会话、任务规划、checkpoint 和 plan mode。
      - [CLI reference](/docs/gemini-cli/official/01-cli-workflow/10-cli-reference): Gemini CLI 常用启动方式、参数、非交互式调用、session resume、model、sandbox、approval mode 和输出格式。
      - [命令系统](/docs/gemini-cli/official/01-cli-workflow/11-commands): Gemini CLI 命令系统：slash commands、@ 文件引用、! Shell 命令，以及常用 /help、/memory、/mcp、/commands、/chat、/restore。
      - [快捷键](/docs/gemini-cli/official/01-cli-workflow/12-keyboard-shortcuts): Gemini CLI 快捷键和交互习惯：清屏、退出 Shell mode、复制输出、恢复会话和降低命令行操作成本。
      - [文件管理](/docs/gemini-cli/official/01-cli-workflow/13-file-management): Gemini CLI 文件管理：@ 文件引用、目录上下文、查找文件、修改文件、创建文件、diff 确认和 .geminiignore。
      - [Shell 命令](/docs/gemini-cli/official/01-cli-workflow/14-shell-commands): Gemini CLI Shell 命令使用方式：! 前缀、Shell mode、运行测试、后台进程、确认提示和 sandbox。
      - [Web search / fetch](/docs/gemini-cli/official/01-cli-workflow/15-web-search-fetch): Gemini CLI Web search 和 Web fetch：搜索最新资料、读取指定 URL、比较多个来源，并把网页知识应用到代码。
      - [会话与历史](/docs/gemini-cli/official/01-cli-workflow/16-session-history): Gemini CLI 会话管理：resume、list sessions、delete session、/chat save、/chat resume、/chat share 和项目作用域。
      - [任务规划](/docs/gemini-cli/official/01-cli-workflow/17-task-planning): Gemini CLI 任务规划：todos、planning 工具、复杂任务拆分、执行前计划、执行中检查和完成标准。
      - [Checkpoint 与 rewind](/docs/gemini-cli/official/01-cli-workflow/18-checkpointing-rewind): Gemini CLI checkpointing、/restore、rewind 的作用：修改前保存状态、恢复文件、恢复会话和降低实验风险。
      - [Plan mode](/docs/gemini-cli/official/01-cli-workflow/19-plan-mode): Gemini CLI plan mode 的用途：只读规划、复杂修改前方案设计、降低误改风险，以及和 approval mode 的关系。
    - 上下文与配置
      - [上下文与配置](/docs/gemini-cli/official/02-context-config): Gemini CLI 上下文与配置入口：settings、GEMINI.md、memory、.geminiignore、自定义命令、生成参数、system prompt、themes 和 trusted folders。
      - [Settings](/docs/gemini-cli/official/02-context-config/20-settings): Gemini CLI settings.json 的职责、用户级和项目级配置边界，以及模型、工具、MCP、checkpoint、权限等配置应该怎么放。
      - [GEMINI.md](/docs/gemini-cli/official/02-context-config/21-gemini-md): Gemini CLI GEMINI.md 项目上下文文件的用途：长期规则、项目结构、测试命令、代码风格、禁止事项和层级管理。
      - [Memory management](/docs/gemini-cli/official/02-context-config/22-memory-management): Gemini CLI memory management、auto memory、/memory reload 的用途，以及记忆、上下文文件和临时 prompt 的边界。
      - [.geminiignore](/docs/gemini-cli/official/02-context-config/23-gemini-ignore): .geminiignore 的用途：排除敏感文件、大文件、构建产物、本地数据库和不希望 Gemini CLI 读取的项目内容。
      - [Custom commands](/docs/gemini-cli/official/02-context-config/24-custom-commands): Gemini CLI custom commands：把重复任务沉淀成 slash command，用户级、项目级和 extension 命令的使用边界。
      - [Generation settings](/docs/gemini-cli/official/02-context-config/25-generation-settings): Gemini CLI generation settings：模型生成参数、temperature、thinking budget 等配置应该怎么理解和使用。
      - [System prompt override](/docs/gemini-cli/official/02-context-config/26-system-prompt): Gemini CLI system prompt override 的用途和风险：什么时候需要替换系统指令，什么时候应该只用 GEMINI.md 或 custom command。
      - [Themes](/docs/gemini-cli/official/02-context-config/27-themes): Gemini CLI themes 的用途：终端 UI 个性化、可读性和团队教程截图一致性。
      - [Trusted folders](/docs/gemini-cli/official/02-context-config/28-trusted-folders): Gemini CLI trusted folders 的用途：信任当前 workspace、跳过 folder trust check 的风险，以及真实项目如何设置边界。
    - 工具与 MCP
      - [工具与 MCP](/docs/gemini-cli/official/03-tools-mcp): Gemini CLI 工具与 MCP 入口：内置工具、文件系统、Shell、Web、todos、planning、MCP server/resources 和 extensions。
      - [工具总览](/docs/gemini-cli/official/03-tools-mcp/30-tools-overview): Gemini CLI 工具系统总览：内置工具、MCP、extensions、policy engine 和权限确认的关系。
      - [文件系统工具](/docs/gemini-cli/official/03-tools-mcp/31-file-system-tool): Gemini CLI 文件系统工具的使用边界：读取、搜索、写入、替换、diff 确认、.geminiignore 和敏感文件排除。
      - [Shell 工具](/docs/gemini-cli/official/03-tools-mcp/32-shell-tool): Gemini CLI Shell 工具的使用边界：运行测试、构建、Git、后台进程、确认提示、sandbox 和危险命令。
      - [Web 工具](/docs/gemini-cli/official/03-tools-mcp/33-web-tools): Gemini CLI Web search 和 web fetch 工具的职责边界：搜索最新资料、读取指定 URL、引用官方来源和避免社区误导。
      - [Todos / Planning 工具](/docs/gemini-cli/official/03-tools-mcp/34-todos-planning-tools): Gemini CLI todos 和 planning 工具的用途：拆解复杂任务、跟踪进度、避免长任务失控。
      - [MCP 设置](/docs/gemini-cli/official/03-tools-mcp/35-mcp-setup): Gemini CLI MCP 设置方式：settings.json、环境变量、stdio/HTTP/SSE server、认证和最小权限原则。
      - [MCP server](/docs/gemini-cli/official/03-tools-mcp/36-mcp-server): Gemini CLI MCP server 管理：stdio、HTTP、SSE、header、环境变量、启停、reload、OAuth auth 和工具列表。
      - [MCP resources](/docs/gemini-cli/official/03-tools-mcp/37-mcp-resources): Gemini CLI MCP resources 的用途：让外部系统提供可读资源、上下文和工具元数据，并和普通工具调用区分。
      - [Extensions](/docs/gemini-cli/official/03-tools-mcp/38-extensions): Gemini CLI extensions：安装、启用、禁用、更新、link、本地开发、验证和与 MCP/Skills 的边界。
    - Agents & Skills
      - [Agents & Skills](/docs/gemini-cli/official/04-agents-skills): Gemini CLI Agents & Skills 入口：Agent Skills、创建 skill、最佳实践、激活 skill、subagents 和 remote agents。
      - [Agent Skills](/docs/gemini-cli/official/04-agents-skills/40-agent-skills): Gemini CLI Agent Skills 的用途：为特定任务加载专门能力、流程、约束和上下文。
      - [创建 Skills](/docs/gemini-cli/official/04-agents-skills/41-create-skills): Gemini CLI 创建 Agent Skill 的判断标准：什么时候应该沉淀、结构如何保持小、如何避免把一次性任务过度工程化。
      - [Skills 最佳实践](/docs/gemini-cli/official/04-agents-skills/42-skills-best-practices): Gemini CLI Agent Skills 最佳实践：触发清晰、输入输出固定、少依赖、避免硬编码凭据、失败路径明确。
      - [激活 Skill](/docs/gemini-cli/official/04-agents-skills/43-activate-skill): Gemini CLI 激活 Agent Skill 的方式、技能发现、reload、enable/disable 和验证是否真正生效。
      - [Subagents](/docs/gemini-cli/official/04-agents-skills/44-subagents): Gemini CLI Subagents 的用途：专门角色、任务分工、模型配置、启用禁用和适用边界。
      - [Remote agents](/docs/gemini-cli/official/04-agents-skills/45-remote-agents): Gemini CLI Remote agents 的用途：连接远程 agent、跨环境协作、远程能力边界和安全注意事项。
    - 模型与运行时
      - [模型与运行时](/docs/gemini-cli/official/05-models-runtime): Gemini CLI 模型与运行时入口：Gemini 3、模型选择、模型路由、本地模型、token caching 和 ACP mode。
      - [Gemini 3](/docs/gemini-cli/official/05-models-runtime/50-gemini-3): Gemini CLI 中 Gemini 3 支持的定位、上下文、推理能力和使用注意事项。
      - [模型选择](/docs/gemini-cli/official/05-models-runtime/51-model-selection): Gemini CLI 模型选择：--model、auto/pro/flash/flash-lite alias，以及按任务复杂度选择模型。
      - [模型路由](/docs/gemini-cli/official/05-models-runtime/52-model-routing): Gemini CLI model routing 的用途：自动 fallback、提升稳定性、处理模型不可用或预览模型变化。
      - [本地模型路由](/docs/gemini-cli/official/05-models-runtime/53-local-model-routing): Gemini CLI local model routing 的使用场景：本地模型、隐私、离线/半离线环境、性能和能力边界。
      - [Token caching](/docs/gemini-cli/official/05-models-runtime/54-token-caching): Gemini CLI token caching 的作用：减少重复上下文成本、提升长任务性能，以及使用前需要理解的边界。
      - [ACP mode](/docs/gemini-cli/official/05-models-runtime/55-acp-mode): Gemini CLI ACP mode 的定位：实验性 agent/editor 协议模式、适用场景和风险边界。
    - 安全与企业
      - [安全与企业](/docs/gemini-cli/official/06-security-enterprise): Gemini CLI 安全与企业入口：sandbox、policy engine、企业配置、企业控制、telemetry、terms/privacy 和 Google Cloud 安全合规。
      - [Sandbox](/docs/gemini-cli/official/06-security-enterprise/60-sandbox): Gemini CLI sandbox 的用途：隔离工具执行、降低不可信代码风险、Docker sandbox 和 --sandbox 使用边界。
      - [Policy engine](/docs/gemini-cli/official/06-security-enterprise/61-policy-engine): Gemini CLI policy engine 的用途：细粒度控制工具执行、替代简单 allowed tools、适合团队和企业治理。
      - [Enterprise config](/docs/gemini-cli/official/06-security-enterprise/62-enterprise-config): Gemini CLI enterprise configuration：组织账号、Cloud project、Vertex AI、许可、固定策略和团队默认配置。
      - [Enterprise controls](/docs/gemini-cli/official/06-security-enterprise/63-enterprise-controls): Gemini CLI enterprise controls：企业控制项、管理员策略、团队使用边界和落地前检查清单。
      - [Telemetry](/docs/gemini-cli/official/06-security-enterprise/64-telemetry): Gemini CLI telemetry 的用途：使用和性能指标、团队可观测性、隐私边界和企业环境检查。
      - [Terms and privacy](/docs/gemini-cli/official/06-security-enterprise/65-terms-privacy): Gemini CLI terms and privacy：不同认证方式、Google 账号、API Key、Vertex AI、Code Assist 下的数据和条款边界。
      - [Cloud security/privacy/compliance](/docs/gemini-cli/official/06-security-enterprise/66-cloud-security-privacy): Gemini CLI 在 Google Cloud 与 Gemini Code Assist Standard/Enterprise 场景下的安全、隐私和合规边界。
    - 集成与自动化
      - [集成与自动化](/docs/gemini-cli/official/07-integrations-automation): Gemini CLI 集成与自动化入口：IDE companion、hooks、headless mode、脚本自动化、GitHub Action、Issue/PR 自动化和本地开发。
      - [IDE 集成](/docs/gemini-cli/official/07-integrations-automation/70-ide-integration): Gemini CLI IDE 集成：VS Code companion extension、/ide 命令、原生 diff、ACP 与 JetBrains/Zed 这类 ACP 客户端。
      - [Hooks](/docs/gemini-cli/official/07-integrations-automation/71-hooks): Gemini CLI hooks 的事件、配置、JSON I/O、退出码、安全边界和管理命令。
      - [Headless mode](/docs/gemini-cli/official/07-integrations-automation/72-headless-mode): Gemini CLI headless mode：用 -p/--prompt、非 TTY、JSON/JSONL 输出和退出码把 CLI 接入脚本。
      - [自动化脚本](/docs/gemini-cli/official/07-integrations-automation/73-automation): Gemini CLI 自动化脚本：管道输入、批量生成文档、JSON 提取和 smart commit 这类 shell 封装。
      - [GitHub Action](/docs/gemini-cli/official/07-integrations-automation/74-github-action): run-gemini-cli GitHub Action：在仓库里接入 Gemini CLI，支持 PR review、issue triage、按评论触发和定时任务。
      - [Issue 与 PR 自动化](/docs/gemini-cli/official/07-integrations-automation/75-issue-pr-automation): Gemini CLI 官方仓库自动化流程：issue triage、CI、PR label sync、scheduled triage、release automation。
      - [本地开发](/docs/gemini-cli/official/07-integrations-automation/76-local-development): Gemini CLI 本地开发入口：源码安装、monorepo package、NPM workspace、build/test 与发布相关概念。
    - 故障排查与参考
      - [故障排查与参考](/docs/gemini-cli/official/08-troubleshooting-reference): Gemini CLI 故障排查与参考入口：FAQ、登录错误、常见报错、卸载、release notes 和 npm package 结构。
      - [FAQ](/docs/gemini-cli/official/08-troubleshooting-reference/80-faq): Gemini CLI 常见问题：第三方 OAuth piggyback 风险、429 配额、ESM 错误、缓存 token、版本检查和安全存储 API key。
      - [故障排查](/docs/gemini-cli/official/08-troubleshooting-reference/81-troubleshooting): Gemini CLI 常见故障排查：认证错误、地区限制、证书、PATH、MCP 端口、sandbox 权限、CI 环境和退出码。
      - [卸载](/docs/gemini-cli/official/08-troubleshooting-reference/82-uninstall): Gemini CLI 卸载方式：npx cache、npm global、Homebrew 和 MacPorts。
      - [Release notes](/docs/gemini-cli/official/08-troubleshooting-reference/83-release-notes): Gemini CLI release notes：stable、preview、nightly 三个渠道，以及如何根据风险选择版本。
      - [NPM package](/docs/gemini-cli/official/08-troubleshooting-reference/84-npm-package): Gemini CLI NPM package 结构：@google/gemini-cli、@google/gemini-cli-core、workspace 与发布包边界。
- GitHub Copilot
  - [GitHub Copilot 中文教程](/docs/github-copilot): 基于 GitHub Docs 和 VS Code 官方资料重写的 Copilot 中文教程，覆盖 IDE、CLI、Cloud Agent、MCP 和企业治理。
  - 从原理到实战
    - [GitHub Copilot 从原理到实战](/docs/github-copilot/understanding): 用 12 篇文章建立 GitHub Copilot 的完整认知，从入口地图、上下文、Agent Mode 到团队治理。
    - [01 · GitHub Copilot 是什么](/docs/github-copilot/understanding/01-what-is-github-copilot): 解释 Copilot 为什么不是单一补全插件，而是一套覆盖 IDE、GitHub、CLI、Cloud Agent 和团队治理的开发工作流。
    - [02 · Copilot 和 Claude Code、Codex、Cursor 怎么选](/docs/github-copilot/understanding/02-copilot-vs-claude-code-codex-cursor): 用工作位置、任务形态、团队治理和验收证据比较 GitHub Copilot、Claude Code、Codex 与 Cursor。
    - [03 · Copilot 的入口地图](/docs/github-copilot/understanding/03-copilot-surfaces-map): 梳理 GitHub Copilot 在 GitHub.com、VS Code、IDE Chat、Windows Terminal、CLI、Mobile 和 Cloud Agent 中的分工。
    - [04 · 从补全到 Agent Mode](/docs/github-copilot/understanding/04-from-autocomplete-to-agent): 解释 Copilot 如何从 inline suggestion 演进到 Chat、Agent Mode、Cloud Agent 和 PR 自动化。
    - [05 · Copilot 的上下文工程](/docs/github-copilot/understanding/05-context-engineering-for-copilot): 解释仓库索引、打开文件、选择上下文、Spaces、MCP 和自定义指令如何影响 Copilot 输出质量。
    - [06 · VS Code Agent Mode 怎么用](/docs/github-copilot/understanding/06-agent-mode-in-vscode): 讲清 VS Code Agent Mode 如何计划、改文件、调用工具、运行命令，并在本地工作区里接受审查。
    - [07 · Cloud Agent 到 PR 的闭环](/docs/github-copilot/understanding/07-cloud-agent-pr-loop): 解释 Cloud Agent 如何从 prompt 或 issue 出发，研究仓库、建分支、改代码、给出 diff 并进入 PR 审查。
    - [08 · Copilot CLI 工作流](/docs/github-copilot/understanding/08-copilot-cli-workflow): 说明 Copilot CLI 适合终端委派、远程 steering、回滚、自动化和与 Cloud Agent 协作的场景。
    - [09 · 指令、Skills、Hooks 怎么分工](/docs/github-copilot/understanding/09-custom-instructions-rules-skills-hooks): 解释个人、仓库、组织指令，prompt files、agent skills、hooks、plugins 在 Copilot 体系里的职责边界。
    - [10 · Copilot 和 MCP 怎么接](/docs/github-copilot/understanding/10-mcp-with-copilot): 解释 MCP 什么时候值得接入 Copilot，如何把 GitHub、数据库、文档、监控和内部工具变成上下文来源。
    - [11 · 团队上线前的安全和治理](/docs/github-copilot/understanding/11-security-admin-billing): 从内容排除、访问控制、模型策略、用量、计费、指标和审计角度解释 Copilot 团队 rollout。
    - [12 · 真实团队工作流](/docs/github-copilot/understanding/12-real-team-workflows): 给出 TDD、代码审查、PR 摘要、issue 到 PR、文档维护和迁移任务六种 Copilot 实战用法。
  - 官方教程中文版
    - [GitHub Copilot 官方教程中文版](/docs/github-copilot/official): 按 GitHub Docs 和 VS Code Docs 重写的中文查询手册，覆盖入门、IDE、Agent、CLI、MCP、治理和 SDK。
    - 入门与定位
      - [入门与定位](/docs/github-copilot/official/00-getting-started): GitHub Copilot 入门与定位中文查询手册，按官方事实整理关键入口、配置和边界。
      - [Copilot 是什么](/docs/github-copilot/official/00-getting-started/what-is-github-copilot): 从 GitHub 官方定义出发，解释 Copilot 的产品边界、入口、适用角色和第一天使用顺序。
      - [计划与可用功能](/docs/github-copilot/official/00-getting-started/plans): 说明 Copilot Free、Student、Pro、Pro+、Business、Enterprise 的选择边界，以及 2026 年注册和计费变更。
      - [功能总览](/docs/github-copilot/official/00-getting-started/features): 按 assistive、agentic、customization、administrator 四类梳理 Copilot 功能，并给出学习顺序。
      - [快速开始](/docs/github-copilot/official/00-getting-started/quickstart): 从账号计划、使用入口、第一次 Chat、第一次 inline suggestion 和低风险验收跑通 GitHub Copilot。
    - 入口与使用场景
      - [入口与使用场景](/docs/github-copilot/official/01-surfaces): 按 GitHub Copilot 官方入口梳理 GitHub.com、VS Code、IDE Chat、Windows Terminal、CLI 和 Cloud Agent 的使用边界。
      - [GitHub.com 上的 Copilot](/docs/github-copilot/official/01-surfaces/github-com): 说明 GitHub 网站中的 Copilot Chat 如何围绕仓库、文件、PR、issue、security alert、dashboard 和搜索框工作。
      - [VS Code 中的 Copilot](/docs/github-copilot/official/01-surfaces/vscode): 说明 VS Code Copilot 的 agents、Plan、Sessions、inline suggestions、inline chat、smart actions、customization 和安全边界。
      - [IDE Chat 工作流](/docs/github-copilot/official/01-surfaces/ide-chat): 解释 GitHub Copilot Chat 在 IDE 中的提示词、上下文关键词、Plan mode、Agent mode、MCP、模型和审查边界。
      - [Windows Terminal 中的 Copilot](/docs/github-copilot/official/01-surfaces/windows-terminal): 说明 Windows Terminal Chat 中 Copilot 的前提、命令解释、shell 上下文、插入命令、组织策略和安全边界。
    - 补全与 Chat
      - [补全与 Chat](/docs/github-copilot/official/02-code-suggestions-and-chat): 按 GitHub 官方文档梳理 Copilot 代码建议、代码引用、提示词写法和响应定制的使用边界。
      - [代码建议](/docs/github-copilot/official/02-code-suggestions-and-chat/code-suggestions): 解释 GitHub Copilot 在 IDE 中的 ghost text、next edit suggestions、替代建议、局部接受和模型边界。
      - [代码引用与匹配](/docs/github-copilot/official/02-code-suggestions-and-chat/code-referencing): 说明 GitHub Copilot 代码引用如何处理公开代码匹配、来源日志、许可证和团队审查边界。
      - [提示词写法](/docs/github-copilot/official/02-code-suggestions-and-chat/prompt-engineering): 把 GitHub Copilot Chat 提示词拆成目标、上下文、例子、约束、迭代和验收标准。
      - [响应定制](/docs/github-copilot/official/02-code-suggestions-and-chat/response-customization): 说明 GitHub Copilot custom instructions、prompt files、AGENTS.md 类文件和优先级如何影响回答。
    - VS Code Agent Mode
      - [VS Code Agent Mode](/docs/github-copilot/official/03-vscode-agent-mode): 按 VS Code 与 GitHub 官方文档梳理本地 agent、Plan、工具权限和代码修改审查。
      - [Agent Mode 总览](/docs/github-copilot/official/03-vscode-agent-mode/agents-overview): 说明 VS Code agents 的类型、Ask Plan Agent 分工、权限级别、handoff 和团队使用边界。
      - [计划模式](/docs/github-copilot/official/03-vscode-agent-mode/planning): 解释 VS Code Plan agent 如何在写代码前研究任务、提出计划、追问开放问题并交给 implementation agent。
      - [Agent 工具](/docs/github-copilot/official/03-vscode-agent-mode/agent-tools): 说明 VS Code agent 的 built-in tools、MCP tools、extension tools、工具选择、批准和信任边界。
      - [审查代码修改](/docs/github-copilot/official/03-vscode-agent-mode/review-code-edits): 说明 VS Code pending edits、inline review、Keep Undo、文件级批量操作和 Source Control 审查流程。
    - Cloud Agent
      - [Cloud Agent](/docs/github-copilot/official/04-cloud-agent): 按 GitHub 官方文档梳理 Copilot cloud agent 的启动、研究计划、迭代、PR 审查和 Actions 安全边界。
      - [Cloud Agent 是什么](/docs/github-copilot/official/04-cloud-agent/about-cloud-agent): 解释 Copilot cloud agent 的能力、临时开发环境、可用范围、适合任务和审查边界。
      - [启动任务](/docs/github-copilot/official/04-cloud-agent/kick-off-a-task): 说明从 issue、Agents tab、prompt、repository seed、IDE 和 Chat 启动 Copilot cloud agent 任务的方式。
      - [研究、计划和迭代](/docs/github-copilot/official/04-cloud-agent/research-plan-iterate): 说明 Copilot cloud agent 如何先研究仓库、生成计划、在 branch 上迭代代码，再创建 pull request。
      - [审查输出](/docs/github-copilot/official/04-cloud-agent/review-output): 说明如何审查 Copilot cloud agent 的 pull request、diff、Actions、merge conflicts 和 follow-up comments。
    - Copilot CLI
      - [Copilot CLI](/docs/github-copilot/official/05-copilot-cli): 按 GitHub 官方文档梳理 Copilot CLI 的安装认证、权限配置、任务委派、回滚和 PR 工作流。
      - [Copilot CLI 是什么](/docs/github-copilot/official/05-copilot-cli/about-copilot-cli): 说明 GitHub Copilot CLI 的交互和非交互模式、Plan、自动上下文、定制、模型和安全边界。
      - [安装、认证和配置](/docs/github-copilot/official/05-copilot-cli/install-auth-config): 把 GitHub Copilot CLI 安装、/login、trusted directories、tool allow-deny、path URL 权限和 LSP 接入串成闭环。
      - [委派任务](/docs/github-copilot/official/05-copilot-cli/delegate-tasks): 区分 GitHub Copilot CLI 的本地 autopilot 和 /delegate 到 cloud agent，并说明权限、checkpoint 和 PR 边界。
      - [回滚和 PR 管理](/docs/github-copilot/official/05-copilot-cli/rollback-pr): 说明 Copilot CLI snapshot、双 Esc、/undo、/rewind、验证回滚和 PR 审查链路。
    - 上下文与定制
      - [上下文与定制](/docs/github-copilot/official/06-context-customization): 按 GitHub 与 VS Code 官方文档梳理 Copilot instructions、prompt files、skills、hooks、plugins 和组织规则。
      - [仓库自定义指令](/docs/github-copilot/official/06-context-customization/repository-instructions): 说明 Copilot repository instructions、path-specific instructions、AGENTS.md 和 references 验证方式。
      - [个人和组织指令](/docs/github-copilot/official/06-context-customization/personal-org-instructions): 解释 Copilot personal、repository、organization instructions 的职责、优先级、适用范围和治理边界。
      - [Prompt Files](/docs/github-copilot/official/06-context-customization/prompt-files): 把重复的 Copilot Chat 任务沉淀成可调用、可审查、可维护的 .prompt.md 文件。
      - [Skills、Hooks、Plugins](/docs/github-copilot/official/06-context-customization/skills-hooks-plugins): 区分 Copilot skills、hooks 和 plugins：哪些是能力包，哪些是生命周期控制，哪些是分发载体。
    - MCP 与外部工具
      - [MCP 与外部工具](/docs/github-copilot/official/07-mcp): 把 GitHub MCP Server、IDE MCP 配置、toolsets、registry 和企业部署边界串成可落地流程。
      - [MCP 是什么](/docs/github-copilot/official/07-mcp/mcp-concept): 解释 Model Context Protocol 如何把外部系统接入 Copilot，并给出安全接入判断。
      - [GitHub MCP Server](/docs/github-copilot/official/07-mcp/github-mcp-server): 配置和使用 GitHub 官方维护的 MCP server，让 Copilot 读取和操作 GitHub 上下文。
      - [用 MCP 扩展 Chat](/docs/github-copilot/official/07-mcp/extend-chat-with-mcp): 在 IDE 中配置 MCP server，让 Copilot Agent mode 读取外部工具、资源和预设 prompts。
      - [企业 MCP 配置](/docs/github-copilot/official/07-mcp/enterprise-mcp): 说明 GHEC data residency、GHES、本地 server、toolsets、registry 和组织策略的 MCP 治理边界。
    - 安全、治理与计费
      - [安全、治理与计费](/docs/github-copilot/official/08-security-governance): 把 Copilot 内容排除、访问策略、模型控制、premium requests、用量指标和 rollout 复盘连成治理闭环。
      - [内容排除](/docs/github-copilot/official/08-security-governance/content-exclusion): 说明 GitHub Copilot 内容排除能保护什么、不能保护什么，以及如何配置、测试和审计。
      - [访问和策略](/docs/github-copilot/official/08-security-governance/access-policies): 解释组织和企业如何用 Copilot feature、privacy、model policies 控制功能、模型和成本边界。
      - [用量和计费](/docs/github-copilot/official/08-security-governance/usage-billing): 说明 request、premium request、allowance、budget、billing entity 和 GitHub 2026 usage-based billing 迁移边界。
      - [指标和采用情况](/docs/github-copilot/official/08-security-governance/metrics): 说明 Copilot usage metrics 的 adoption、engagement、acceptance、LoC、PR lifecycle 口径，以及 rollout 复盘方式。
    - SDK 与自定义 Agent
      - [SDK 与自定义 Agent](/docs/github-copilot/official/09-sdk-and-custom-agents): 按 GitHub 官方 SDK 文档梳理 Copilot SDK、custom agents、hooks 和 OpenTelemetry 可观测性。
      - [Copilot SDK 入门](/docs/github-copilot/official/09-sdk-and-custom-agents/sdk-getting-started): 说明 Copilot SDK 的 public preview 边界、认证方式、安装、session、sendAndWait 和 streaming。
      - [自定义 Agent](/docs/github-copilot/official/09-sdk-and-custom-agents/custom-agents): 解释 Copilot SDK custom agents、sub-agent delegation、工具隔离、MCP 绑定和失败处理。
      - [SDK Hooks](/docs/github-copilot/official/09-sdk-and-custom-agents/sdk-hooks): 说明 Copilot SDK hooks 如何控制工具执行、修改结果、注入上下文、处理错误和审计交互。
      - [可观测性](/docs/github-copilot/official/09-sdk-and-custom-agents/observability): 说明 Copilot SDK 的 OpenTelemetry 支持、trace context 传播、tool spans 和生产化观测清单。
    - 实战工作流
      - [实战工作流](/docs/github-copilot/official/10-practical-playbooks): 把 GitHub Copilot 的官方能力落成 TDD、代码审查、PR 摘要和团队上线的可复用剧本。
      - [TDD 工作流](/docs/github-copilot/official/10-practical-playbooks/tdd-with-copilot): 用 Copilot 辅助 Red / Green / Refactor：先写失败测试，再做最小实现，最后重构并保持测试通过。
      - [代码审查工作流](/docs/github-copilot/official/10-practical-playbooks/code-review): 用 GitHub Copilot 做 review 预筛、建议修复和风险归纳，同时保留人工 reviewer 的最终责任。
      - [PR 摘要工作流](/docs/github-copilot/official/10-practical-playbooks/pr-summary): 用 GitHub Copilot 生成 PR 摘要草稿，再由作者补齐背景、风险、测试和回滚。
      - [团队上线清单](/docs/github-copilot/official/10-practical-playbooks/team-rollout): 按目标、试点、策略、内容排除、计费、培训、指标和回滚推进 GitHub Copilot 团队 rollout。
- Cursor
  - [Cursor 中文教程](/docs/cursor): 基于 Cursor 官方文档、Help Center 和 llms.txt 重写的 Cursor 中文教程。
  - 从原理到实战
    - [Cursor 从原理到实战](/docs/cursor/understanding): 按中文开发者真实使用顺序组织的 Cursor 工作流教程。
    - [Cursor 是什么](/docs/cursor/understanding/01-what-is-cursor): 从产品定位理解 Cursor：AI editor、coding agent 和真实项目工作台。
    - [安装、迁移和第一个项目](/docs/cursor/understanding/02-install-migrate-first-project): 从下载安装到迁移 VS Code / JetBrains，再用低风险项目跑通 Cursor 第一天闭环。
    - [Cursor Agent 如何工作](/docs/cursor/understanding/03-how-cursor-agent-works): 理解 instructions、tools、model、checkpoints、queued messages 和模式选择。
    - [Agent、Plan、Ask、Debug、Tab 怎么分工](/docs/cursor/understanding/04-agent-plan-ask-debug-tab): 把 Cursor 的几类 AI 入口按风险和任务阶段分清，不把所有问题都丢给 Agent。
    - [上下文、索引和 Rules](/docs/cursor/understanding/05-context-indexing-rules): 让 Cursor 真的理解项目：索引负责事实，Rules 负责长期约束，prompt 负责本次目标。
    - [MCP、工具、浏览器和终端](/docs/cursor/understanding/06-mcp-tools-browser-terminal): 理解 Cursor Agent 的工具层：MCP 接外部系统，Browser 验 UI，Terminal 跑命令。
    - [Skills、Subagents、Hooks](/docs/cursor/understanding/07-skills-subagents-hooks): 把 Cursor 从一次性会话升级成可复用、可分工、可治理的工作流系统。
    - [Cursor CLI 与 Headless 自动化](/docs/cursor/understanding/08-cli-headless-automation): 把 Cursor Agent 从编辑器带到终端、脚本、CI 和受控自动化。
    - [Cloud Agent、Bugbot 和 Review](/docs/cursor/understanding/09-cloud-agent-bugbot-review): 把 Cursor 放进异步任务、PR 审查、安全审查和团队交付流程。
    - [模型、价格和用量](/docs/cursor/understanding/10-models-pricing-usage): 不要背模型表。按任务复杂度、上下文规模、速度、成本和团队策略选择 Cursor 模型。
    - [Cursor 和 Codex、Claude Code、Windsurf、Copilot 怎么选](/docs/cursor/understanding/11-cursor-vs-codex-claude-windsurf-copilot): 用工作流位置比较 AI 编程工具，不做空泛排名。
    - [一个真实项目里的 Cursor 工作流](/docs/cursor/understanding/12-real-project-workflow): 把 Cursor 用在真实项目：只读理解、计划、小步修改、验证、审查、沉淀规则。
  - 官方教程中文版
    - [Cursor 官方教程中文版](/docs/cursor/official): 按 Cursor 官方 Docs、Help Center、CLI 和企业文档重组的中文查询手册。
    - 入门、安装与模型
      - [入门、安装与模型](/docs/cursor/official/00-getting-started): Cursor 入门层：产品定位、快速开始、安装迁移、模型用量和插件边界。
      - [Cursor 产品定位](/docs/cursor/official/00-getting-started/00-cursor-positioning): 从 Cursor 官方文档理解它为什么是 AI editor and coding agent，而不是普通 IDE 插件。
      - [快速开始](/docs/cursor/official/00-getting-started/01-quickstart): 按 Cursor 官方 Quickstart，从安装登录到第一次解释代码库、小改动、diff review 和 Plan Mode。
      - [安装与迁移](/docs/cursor/official/00-getting-started/02-install-and-migrate): 从 Cursor 官方安装、VS Code 迁移和 JetBrains 迁移文档梳理安全迁移路径。
      - [模型、价格与用量](/docs/cursor/official/00-getting-started/03-models-pricing): 基于 Cursor 官方 Models & Pricing 文档解释 usage pools、Auto、Composer、API pool、Max Mode 和团队计费边界。
      - [插件与 Marketplace](/docs/cursor/official/00-getting-started/04-plugins-marketplace): 基于 Cursor 官方 Plugins 和 Extensions 文档解释插件、扩展、团队 marketplace、required 插件和安全边界。
    - Agent 工作流
      - [Agent 工作流](/docs/cursor/official/01-agent-workflow): Agent 工作流相关的 Cursor 官方教程中文版。
      - [Agent 总览](/docs/cursor/official/01-agent-workflow/10-agent-overview): 基于 Cursor 官方 Agent 文档解释 instructions、tools、model、checkpoints、queue 和模式选择。
      - [Agents Window](/docs/cursor/official/01-agent-workflow/11-agents-window): 基于 Cursor 官方 Agents Window 文档解释 agent-first 窗口、多工作区、并行 Agent、diff、cloud/local handoff 和 worktrees。
      - [Plan Mode](/docs/cursor/official/01-agent-workflow/12-plan-mode): 基于 Cursor 官方 Plan Mode 文档解释先研究、提问、生成计划、审查编辑，再批准构建的流程。
      - [Prompting](/docs/cursor/official/01-agent-workflow/13-prompting): 基于 Cursor 官方 Prompting Agents 文档解释 @ mentions、图片、语音、context ring、上下文压缩和模型切换。
      - [Debug Mode](/docs/cursor/official/01-agent-workflow/14-debug-mode): 基于 Cursor 官方 Debug Mode 文档解释假设、插桩、复现、日志分析、精准修复和清理流程。
      - [Agent Review](/docs/cursor/official/01-agent-workflow/15-agent-review): 基于 Cursor 官方 Agent Review 文档解释本地变更审查、自动触发、slash command、Source Control 和 review depth。
      - [Terminal Tool](/docs/cursor/official/01-agent-workflow/16-terminal-tool): 基于 Cursor 官方 Terminal 文档解释 Agent 运行 shell commands、sandbox、allowlist、平台要求和 sandbox.json。
      - [Browser Tool](/docs/cursor/official/01-agent-workflow/17-browser-tool): 基于 Cursor 官方 Browser 文档解释浏览器验证、console、network、设计侧栏、approval 和企业 allowlist。
      - [Search Tool](/docs/cursor/official/01-agent-workflow/18-search-tool): 基于 Cursor 官方 Semantic & Agentic Search 文档解释 Instant Grep、semantic search、indexing、privacy 和 Explore subagent。
      - [Canvas Tool](/docs/cursor/official/01-agent-workflow/19-canvas-tool): 基于 Cursor 官方 Canvases 文档解释交互式 artifact、打开方式、迭代方式和 Skill 打包。
      - [Worktrees](/docs/cursor/official/01-agent-workflow/20-worktrees): 基于 Cursor 官方 Worktrees 文档解释 Agents Window worktrees、.cursor/worktrees.json、清理和 /worktree /best-of-n。
      - [Agent 安全边界](/docs/cursor/official/01-agent-workflow/21-agent-security): 基于 Cursor 官方 Agent Security 和 Privacy 文档解释审批、.cursorignore、allowlist、MCP、网络、workspace trust 和 Privacy Mode。
    - 上下文与定制
      - [上下文与定制](/docs/cursor/official/02-context-customization): 上下文与定制相关的 Cursor 官方教程中文版。
      - [Rules](/docs/cursor/official/02-context-customization/20-rules): 基于 Cursor 官方 Rules 文档解释 Project、User、Team Rules、AGENTS.md、frontmatter、globs 和规则最佳实践。
      - [MCP](/docs/cursor/official/02-context-customization/21-mcp): 基于 Cursor 官方 MCP 文档解释 transports、mcp.json、OAuth、config interpolation、tool approval 和 Cloud Agents。
      - [Skills](/docs/cursor/official/02-context-customization/22-skills): 基于 Cursor 官方 Skills 文档解释 skill directories、SKILL.md、frontmatter、paths、scripts 和迁移到 skills。
      - [Subagents](/docs/cursor/official/02-context-customization/23-subagents): 基于 Cursor 官方 Subagents 文档解释上下文隔离、并行执行、内置 subagents、自定义文件、字段和调用方式。
      - [Hooks](/docs/cursor/official/02-context-customization/24-hooks): 基于 Cursor 官方 Hooks 文档解释 agent loop hook、事件、配置路径、command hooks、prompt hooks 和 exit code。
      - [Plugins](/docs/cursor/official/02-context-customization/25-plugins): 基于 Cursor 官方 Plugins 文档解释插件组件、Marketplace、团队分发、安装管理、本地测试和发布审查。
    - CLI 与自动化
      - [CLI 与自动化](/docs/cursor/official/03-cli-automation): CLI 与自动化相关的 Cursor 官方教程中文版。
      - [Cursor CLI 总览](/docs/cursor/official/03-cli-automation/30-cli-overview): 基于 Cursor 官方 CLI 文档解释交互模式、非交互模式、Cloud Agent handoff、session 恢复、sandbox 和上线验收边界。
      - [CLI 安装](/docs/cursor/official/03-cli-automation/31-cli-installation): 安装 Cursor CLI、处理 PATH、验证版本、更新 Agent，并给出团队和 CI 环境的上线检查。
      - [CLI 使用方式](/docs/cursor/official/03-cli-automation/32-cli-using): 解释 Cursor CLI 的模式切换、prompting、MCP、ACP、rules、快捷键、review、上下文选择、Cloud handoff、worktree、history 和非交互模式。
      - [Shell Mode](/docs/cursor/official/03-cli-automation/33-shell-mode): 基于 Cursor 官方 Shell Mode 文档解释命令执行、输出截断、30 秒超时、权限审批、适用场景和排障方式。
      - [Agent Client Protocol](/docs/cursor/official/03-cli-automation/34-acp): 基于 Cursor 官方 ACP 文档解释 agent acp、stdio JSON-RPC、认证、session 流程、permissions、MCP 限制和自定义客户端边界。
      - [Headless 模式](/docs/cursor/official/03-cli-automation/35-headless): 基于 Cursor 官方 Headless CLI 文档解释 print mode、--force、输出格式、脚本审查、stream-json、图片路径和自动化安全边界。
      - [GitHub Actions](/docs/cursor/official/03-cli-automation/36-github-actions): 基于 Cursor 官方 GitHub Actions 文档解释 CI 安装、CURSOR_API_KEY、full autonomy、restricted autonomy、permissions 和 secrets 配置。
      - [Slash Commands](/docs/cursor/official/03-cli-automation/37-slash-commands): 基于 Cursor 官方 Slash Commands 参考解释 /plan、/ask、/model、/auto-run、/sandbox、/mcp、/rules、/commands、/compress 等会话内命令。
      - [CLI 参数](/docs/cursor/official/03-cli-automation/38-parameters): 基于 Cursor 官方 Parameters 参考解释全局参数、commands、MCP 子命令、prompt 参数和常用组合。
      - [CLI 认证](/docs/cursor/official/03-cli-automation/39-authentication): 基于 Cursor 官方 Authentication 文档解释浏览器登录、API key、状态检查、登出、CI secrets 和认证排障。
      - [CLI 权限](/docs/cursor/official/03-cli-automation/40-permissions): 基于 Cursor 官方 Permissions 文档解释 Shell、Read、Write、WebFetch、MCP permission tokens、allow/deny 优先级和配置位置。
      - [CLI 配置](/docs/cursor/official/03-cli-automation/41-configuration): 基于 Cursor 官方 Configuration 文档解释 cli-config.json、项目配置限制、schema、Vim mode、permissions、proxy、HTTP/1.1 fallback 和排障。
      - [输出格式](/docs/cursor/official/03-cli-automation/42-output-format): 基于 Cursor 官方 Output Format 文档解释 text、json、stream-json、partial output、事件类型、失败行为和脚本消费边界。
      - [终端设置](/docs/cursor/official/03-cli-automation/43-terminal-setup): 基于 Cursor 官方 Terminal Setup 文档解释多行输入、Shift+Enter、Ctrl+J、tmux、Vim mode、主题检测和手动 keybinding 配置。
    - Cloud Agent 与后台任务
      - [云端 Agent](/docs/cursor/official/04-cloud-agents): 云端 Agent相关的 Cursor 官方教程中文版。
      - [Cloud Agent 总览](/docs/cursor/official/04-cloud-agents/50-cloud-agent): 基于 Cursor 官方 Cloud Agents 文档解释云端隔离环境、启动入口、GitHub/GitLab 分支流、MCP、hooks、artifacts、billing 和排障边界。
      - [Cloud Agent Setup](/docs/cursor/official/04-cloud-agents/51-setup): 配置 Cloud Agent 的 Ubuntu VM、environment.json、update/start、secrets、Docker 和 Tailscale。
      - [Cloud Agent Capabilities](/docs/cursor/official/04-cloud-agents/52-capabilities): 基于 Cursor 官方 Capabilities 文档解释 computer use、artifacts、remote desktop、MCP HTTP/stdio、安全差异和 CI failure autofix。
      - [My Machines](/docs/cursor/official/04-cloud-agents/53-my-machines): 基于 Cursor 官方 My Machines 文档解释本机 worker、worker= 路由、repo 匹配、artifacts、网络和 MCP 边界。
      - [Self-hosted Pool](/docs/cursor/official/04-cloud-agents/54-self-hosted-pool): 基于 Cursor 官方 Self-hosted Pool 文档解释企业 worker fleet、service account、pool labels、触发规则、监控和安全边界。
      - [Bugbot](/docs/cursor/official/04-cloud-agents/55-bugbot): 基于 Cursor 官方 Bugbot 文档解释自动 PR review、手动触发、rules、autofix、MCP、Admin API、定价和排障。
      - [Security Review](/docs/cursor/official/04-cloud-agents/56-security-review): 基于 Cursor 官方 Security Review 文档解释 PR 安全审查、Vulnerability Scanner、Automations、MCP、计费和 analytics。
      - [Automations](/docs/cursor/official/04-cloud-agents/57-automations): 基于 Cursor 官方 Automations 文档解释触发器、工具、权限范围、身份、计费、环境和提示词写法。
      - [Cloud Agent Best Practices](/docs/cursor/official/04-cloud-agents/58-best-practices): 基于 Cursor 官方 Best Practices 文档整理 Cloud Agent 环境、上下文、skills、MCP、工具设计和验收清单。
      - [Cloud Agent 网络安全](/docs/cursor/official/04-cloud-agents/59-security-network): 基于 Cursor 官方 Security & Network 文档解释 Privacy Mode、secret protection、signed commits、egress、artifact host 和 IP allowlist。
      - [Cloud Agent Settings](/docs/cursor/official/04-cloud-agents/60-settings): 基于 Cursor 官方 Cloud Agents Settings 文档解释默认模型、默认 repo、网络、summary、team follow-ups 和 lateral movement 风险。
      - [Cloud Agent API](/docs/cursor/official/04-cloud-agents/61-api-endpoints): 基于 Cursor 官方 Cloud Agents API v1 文档整理 agent、run、stream、artifacts、archive、worker tokens、models 和 repositories endpoints。
    - 集成与 SDK
      - [集成、API 与 SDK](/docs/cursor/official/05-integrations-sdk): 集成、API 与 SDK相关的 Cursor 官方教程中文版。
      - [GitHub 集成](/docs/cursor/official/05-integrations-sdk/70-github): 基于 Cursor 官方 GitHub integration 文档解释 GitHub App、GHES、IP allowlist、Advanced networking、权限和排障。
      - [GitLab 集成](/docs/cursor/official/05-integrations-sdk/71-gitlab): 基于 Cursor 官方 GitLab integration 文档解释 GitLab.com、Self-Hosted、paid plan、OAuth app、Sync Repos、网络和排障。
      - [Slack 集成](/docs/cursor/official/05-integrations-sdk/72-slack): 基于 Cursor 官方 Slack integration 文档解释 @Cursor 命令、repo 路由、channel settings、status handoff、privacy 和权限。
      - [Linear 集成](/docs/cursor/official/05-integrations-sdk/73-linear): 基于 Cursor 官方 Linear integration 文档解释 issue delegation、repo labels、triage rules 和 follow-up。
      - [JetBrains 集成](/docs/cursor/official/05-integrations-sdk/74-jetbrains): 基于 Cursor 官方 JetBrains integration 文档解释 ACP、AI Assistant、安装、认证、能力、定价和迁移边界。
      - [Xcode 集成](/docs/cursor/official/05-integrations-sdk/75-xcode): 基于 Cursor 官方 Xcode integration 文档解释 Xcode 26.3+ MCP bridge、xcrun mcpbridge、20 个 tools、CLI 和排障。
      - [TypeScript SDK](/docs/cursor/official/05-integrations-sdk/76-typescript-sdk): 基于 Cursor 官方 TypeScript SDK 文档解释 local/cloud runtimes、Agent/Run、streaming、MCP、subagents、hooks、artifacts 和 errors。
      - [Deep Links](/docs/cursor/official/05-integrations-sdk/77-deeplinks): 基于 Cursor 官方 Deeplinks 文档解释 prompt、command、rule 链接、web/app 格式、确认机制、URL 长度和敏感信息边界。
    - 团队与企业
      - [团队与企业治理](/docs/cursor/official/06-teams-enterprise): 团队与企业治理相关的 Cursor 官方教程中文版。
      - [Team Setup](/docs/cursor/official/06-teams-enterprise/80-team-setup): 基于 Cursor 官方 Teams setup 文档解释创建团队、邀请成员、domain matching、SSO、billing、Unpaid Admin、MDM 和代理兼容。
      - [成员、SSO 与 SCIM](/docs/cursor/official/06-teams-enterprise/81-members-sso-scim): 基于 Cursor 官方 Members、SSO、SCIM 文档解释角色、邀请、domain controls、SAML、JIT、directory groups 和 spend limits。
      - [Dashboard 与 Analytics](/docs/cursor/official/06-teams-enterprise/82-dashboard-analytics): 基于 Cursor 官方 Dashboard 和 Usage Analytics 文档解释团队设置、usage、AI code tracking、conversation insights、Cloud Agent metrics 和导出。
      - [Enterprise 总览](/docs/cursor/official/06-teams-enterprise/83-enterprise-overview): 用企业上线视角梳理 Cursor Enterprise 的安全、权限、隐私、模型、审计和成本治理。
      - [身份与访问管理](/docs/cursor/official/06-teams-enterprise/84-identity-access): 配置 Cursor 企业身份、SSO、SCIM、RBAC、MDM、扩展白名单和 Workspace Trust 的上线流程。
      - [隐私与数据治理](/docs/cursor/official/06-teams-enterprise/85-privacy-data-governance): 解释 Cursor 企业数据流、Privacy Mode、Cloud Agents、DPA、subprocessors、加密和 CMEK 的治理边界。
      - [网络配置](/docs/cursor/official/06-teams-enterprise/86-network-configuration): 配置 Cursor 在企业代理、防火墙、SSL inspection、streaming、allowlist 和 Cloud Agents 网络边界中的上线要求。
      - [LLM 安全与控制](/docs/cursor/official/06-teams-enterprise/87-llm-safety-controls): 区分 Cursor 中可强制执行的安全控制和非确定性的 LLM steering，并给出企业级 Agent 防护方案。
      - [模型与集成管理](/docs/cursor/official/06-teams-enterprise/88-model-integration-management): 管理 Cursor Enterprise 的模型访问、BYOK、MCP allowlist、仓库 blocklist，以及 Slack、GitHub、GitLab、Linear 集成权限。
      - [合规与监控](/docs/cursor/official/06-teams-enterprise/89-compliance-monitoring): 用 Audit Logs、Hooks、SIEM、Trust Center 和 AI code tracking 建立 Cursor Enterprise 合规监控闭环。
      - [服务账号与计费组](/docs/cursor/official/06-teams-enterprise/90-service-accounts-billing-groups): 用 Service Accounts 管理非真人自动化，用 Billing Groups 管理 Cursor Enterprise 成本归因和 chargeback。
    - Help Center 与排障
      - [帮助与排障](/docs/cursor/official/07-help-troubleshooting): 帮助与排障相关的 Cursor 官方教程中文版。
      - [安装和第一个项目排障](/docs/cursor/official/07-help-troubleshooting/100-install-first-project): 按官方 Help Center 把 Cursor 安装、登录、打开项目、首个 Agent 任务和迁移问题整理成可执行排障路径。
      - [AI 功能排障总览](/docs/cursor/official/07-help-troubleshooting/101-ai-features-overview): 把 Agent、Ask、Plan、Debug、Tab、Inline Edit 的官方入口整理成模式选择、验证和排障路径。
      - [自定义与上下文排障](/docs/cursor/official/07-help-troubleshooting/102-customization-help): 把 Rules、Context、MCP、Skills、Indexing、Ignore files 变成可排查的 Cursor 上下文治理路径。
      - [模型与用量排障](/docs/cursor/official/07-help-troubleshooting/103-models-usage-help): 按 Cursor 官方帮助梳理模型选择、Auto/Premium、API keys、usage limits、on-demand 和 token rate 的排障路径。
      - [安全与隐私排障](/docs/cursor/official/07-help-troubleshooting/104-security-privacy-help): 把 Cursor Privacy Mode、ZDR、BYOK 例外、Trust Center、合规文件、SSO 和 Marketplace security 整理成分诊路径。
      - [账号与账单排障](/docs/cursor/official/07-help-troubleshooting/105-account-billing-help): 把 Cursor billing cycle、included usage、on-demand、seat、invoice、payment、cancel、refund 整理成可转交的账务排障流程。
      - [Agent、Tab、网络和性能排障](/docs/cursor/official/07-help-troubleshooting/106-troubleshooting-agent-tab-network): 把 Cursor Agent、Tab、安装启动、网络代理、SSH/VPN、扩展冲突和性能问题整理成一套分诊树。
- Antigravity
  - [Google Antigravity 中文教程](/docs/antigravity): 基于 Google 官方资料重写的 Antigravity 中文教程，覆盖 Agent Manager、Editor、Browser、Artifacts、Rules、Workflows、Skills、MCP 与权限治理。
  - 从原理到实战
    - [Antigravity 从原理到实战](/docs/antigravity/understanding): 按中文开发者学习顺序讲清 Antigravity：定位、安装、Agent Manager、Artifacts、Browser、Rules、Skills、MCP、权限、安全和真实项目实践。
  - 官方教程中文版
    - [Antigravity 官方教程中文版](/docs/antigravity/official): 按 Google 官方资料重组的 Antigravity 中文查询手册，覆盖安装、Agent Manager、Editor、Browser、Artifacts、Rules、Skills、MCP 与安全权限。
    - 00 · 入门
      - [安装与初始设置](/docs/antigravity/official/00-getting-started): Antigravity 入门安装、个人 Gmail 登录、setup flow、安全策略选择和第一次只读验证。
      - [Antigravity 是什么](/docs/antigravity/official/00-getting-started/00-product-overview): 从 Google 官方 Home 文档理解 Antigravity 的产品定位、核心界面、Agent、Artifacts、Editor 与 Browser 的职责边界。
      - [下载与基础导航](/docs/antigravity/official/00-getting-started/01-download-navigation): 根据 Google 官方 Getting Started 文档梳理 Antigravity 下载入口、平台要求、更新机制，以及 Editor 与 Agent Manager 的基础切换方式。
      - [Firebase Studio 项目迁移到 Antigravity](/docs/antigravity/official/00-getting-started/02-firebase-studio-migration): 基于 Google 官方迁移文档，梳理 Firebase Studio 项目导出、Antigravity 自动迁移、Firebase CLI 手动迁移、本地预览和发布路径。
    - 01 · Agent Manager
      - [Agent Manager](/docs/antigravity/official/01-agent-manager): 理解 Antigravity Agent Manager：workspace、conversation、Fast 与 Planning、Artifacts、异步多 agent 和人工反馈入口。
      - [Agent 核心工作方式](/docs/antigravity/official/01-agent-manager/00-agent-core): 根据 Google 官方 Agent 文档解释 Antigravity Agent 的组成：reasoning model、tools、artifacts、knowledge、并行 conversations 与删除边界。
      - [Agent Modes 与全局设置](/docs/antigravity/official/01-agent-manager/01-agent-modes-settings): 解释 Antigravity 的 Planning、Fast、Artifact Review、Terminal 自动执行和非 workspace 文件访问设置。
    - 02 · Editor
      - [Editor 工作流](/docs/antigravity/official/02-editor-workflow): Antigravity Editor View 的日常工作流：补全、Tab、inline command、terminal command、agent side panel、Problems 和上下文引用。
      - [Editor Surface 与工作分层](/docs/antigravity/official/02-editor-workflow/00-editor-surface): 基于官方 Editor 文档理解 Antigravity Editor 的 VS Code 基础、AI 入口、扩展能力和适用任务边界。
      - [Tab、Command 与 Review Changes](/docs/antigravity/official/02-editor-workflow/01-tab-command-review): 把官方 Tab、Command、Agent Side Panel 和 Review Changes 文档串成 Antigravity Editor 的日常编码闭环。
    - 03 · Browser & Artifacts
      - [Browser 与 Artifacts](/docs/antigravity/official/03-browser-artifacts): Antigravity Browser Subagent、浏览器扩展、截图、录屏、task list、implementation plan、walkthrough 和 diff review 的使用边界。
      - [Artifacts 与审查反馈](/docs/antigravity/official/03-browser-artifacts/00-artifacts-review): 基于官方 Artifacts、Task List、Implementation Plan、Walkthrough 与 Knowledge 文档，建立 Antigravity 任务证据和反馈审查流程。
      - [Browser Subagent 与视觉证据](/docs/antigravity/official/03-browser-artifacts/01-browser-subagent-evidence): 基于官方 Browser、Browser Subagent、Screenshots 和 Browser Recordings 文档，解释 Antigravity 浏览器验证、独立 Chrome profile 和证据审查边界。
    - 04 · Rules / Workflows / Skills
      - [Rules、Workflows 与 Skills](/docs/antigravity/official/04-rules-workflows-skills): Antigravity 自定义体系：Rules、Workflows、Skills 的分工、global/workspace 落点、Skill 结构和渐进加载原则。
      - [Rules 与 Workflows](/docs/antigravity/official/04-rules-workflows-skills/00-rules-workflows): 基于官方 Rules / Workflows 文档解释 Antigravity 全局规则、Workspace 规则、激活方式、@mentions 与可复用 workflow。
      - [Skills 与渐进加载](/docs/antigravity/official/04-rules-workflows-skills/01-skills-progressive-disclosure): 基于官方 Skills 文档解释 Antigravity Skill 的目录结构、SKILL.md、description、workspace/global scope 和 progressive disclosure。
    - 05 · MCP & Security
      - [MCP、权限与安全](/docs/antigravity/official/05-mcp-permissions-security): Antigravity MCP 与安全控制：Allow、Deny、Ask、terminal sandbox、workspace file access、browser allowlist 和 MCP 权限资源。
      - [MCP 集成与权限边界](/docs/antigravity/official/05-mcp-permissions-security/00-mcp-integration): 基于官方 MCP 文档解释 Antigravity MCP Store、自定义 server、mcp_config.json、OAuth、Google ADC、headers 和 disabledTools。
      - [Strict Mode、Sandbox 与 URL Allowlist](/docs/antigravity/official/05-mcp-permissions-security/01-strict-sandbox-allowlist): 基于官方文档解释 Antigravity Strict Mode、Sandbox、URL Allowlist 和文件访问边界。
    - 06 · Models & Pricing
      - [模型、定价与平台](/docs/antigravity/official/06-models-pricing-platforms): Antigravity 与 Gemini 3、模型可选性、个人预览、Mac/Windows/Linux 平台支持和 pricing 页面核验方法。
      - [模型选择器与系统模型](/docs/antigravity/official/06-models-pricing-platforms/00-models): 根据 Google 官方 Models 文档解释 Antigravity reasoning model、模型选择器、sticky 选择逻辑和不可自定义的系统模型。
      - [Plans、Quota 与 Overage](/docs/antigravity/official/06-models-pricing-platforms/01-plans-quota-overages): 解释 Antigravity 官方 Plans 文档中的 Google AI plan、baseline quota、AI credits、overage 设置和当前不支持项。
    - 07 · 用例与参考
      - [用例、排障与参考](/docs/antigravity/official/07-use-cases-reference): Antigravity 适合的真实用例、不适合的任务、排障顺序、反馈入口和官方参考链接。
      - [真实项目任务选择](/docs/antigravity/official/07-use-cases-reference/00-real-project-selection): 基于官方能力边界判断哪些任务适合交给 Antigravity，哪些任务需要拆分、人工确认或暂不交给 Agent。
      - [排障顺序与官方参考](/docs/antigravity/official/07-use-cases-reference/01-troubleshooting-reference): 整理 Antigravity 安装、workspace、权限、browser、MCP、模型额度和反馈提交的排障顺序。
- Windsurf
  - [Windsurf 中文教程](/docs/windsurf): 基于 Windsurf 官方文档、Cognition 官方公告和 MCP 规范重写的 Windsurf 中文教程。
  - 官方教程中文版
    - [Windsurf 官方教程中文版](/docs/windsurf/official): 按 Windsurf 官方文档能力域重组的中文查询手册，覆盖安装、Cascade、上下文、MCP、Skills、模型和团队控制。
    - [安装、登录与首次启动](/docs/windsurf/official/00-setup-onboarding): 按 Windsurf 官方文档跑通系统要求、下载、onboarding、VS Code/Cursor 导入、PATH、认证、更新、远程开发和第一轮安全验证。
    - [Cascade 核心能力](/docs/windsurf/official/01-cascade-core): 整理 Windsurf Cascade 的模式、工具调用、Todo、checkpoint、Agent Command Center 和多会话边界。
    - [上下文、规则与 AGENTS.md](/docs/windsurf/official/02-context-rules-agents): 区分 Windsurf 上下文检索、Memories、Rules、AGENTS.md、Workflows、Skills 与忽略规则。
    - [终端与命令控制](/docs/windsurf/official/03-terminal-command-control): 整理 Windsurf Terminal、Command 模式、Cascade 终端上下文、auto-execution、allow/deny list、团队控制和 dedicated terminal。
    - [MCP 集成](/docs/windsurf/official/04-mcp-integration): 按官方文档整理 Windsurf MCP Marketplace、mcp_config.json、HTTP/SSE、认证插值、100 tools 限制和企业 registry。
    - [Skills、Workflows 与 Hooks](/docs/windsurf/official/05-skills-workflows): 整理 Windsurf Skills、Workflows、Hooks、Rules、AGENTS.md 和 Memories 的团队沉淀边界。
    - [模型、Adaptive、BYOK 与用量](/docs/windsurf/official/06-models-usage): 按官方文档整理 Windsurf 模型选择、Adaptive、SWE 模型族、BYOK、quota、extra usage 和团队计费边界。
    - [团队控制与排障](/docs/windsurf/official/07-teams-troubleshooting): 整理 Windsurf Admin Portal、SSO/SCIM、RBAC、命令策略、MCP 准入、共享、日志和常见故障定位。
  - 从原理到实战
    - [Windsurf 从原理到实战](/docs/windsurf/understanding): 用 8 篇中文教程讲清 Windsurf 的定位、Cascade 工作模型、上下文治理、MCP/Skills/Workflows/Hooks、安全边界、模型用量和工具对比。
    - [Windsurf 是什么](/docs/windsurf/understanding/01-what-is-windsurf): 解释 Windsurf 作为 Cognition 旗下 agentic IDE 的定位，以及它和聊天框、补全工具、终端 agent 的根本差异。
    - [第一次项目闭环](/docs/windsurf/understanding/02-first-project-loop): 用只读理解、单文件修改、验证命令和 diff 检查四步，把 Windsurf 安全放进真实项目。
    - [Cascade 心智模型](/docs/windsurf/understanding/03-cascade-mental-model): 解释 Cascade 如何结合上下文、计划、工具、终端和 checkpoint 推进任务，避免把它当普通聊天机器人使用。
    - [上下文、Rules 与 AGENTS.md 怎么放](/docs/windsurf/understanding/04-context-rules-agents-md): 给出 Windsurf 项目规则落地模型，说明 Context Awareness、Memories、Rules、AGENTS.md、.windsurf/rules 和 .codeiumignore 的分工。
    - [MCP、Skills、Workflows 怎么分工](/docs/windsurf/understanding/05-mcp-skills-workflows): 解释 Windsurf 里外部工具、能力包、手动流程、Hooks 和项目规则的边界，避免把所有自动化都堆进 MCP。
    - [终端命令安全](/docs/windsurf/understanding/06-terminal-command-safety): 给 Windsurf Cascade 终端自动执行设置一个商业项目可用的安全策略，覆盖 allowlist、denylist、Turbo、团队上限和人工确认。
    - [模型与用量策略](/docs/windsurf/understanding/07-model-usage-strategy): 用任务风险、上下文规模、Adaptive 路由、quota 和团队治理来制定 Windsurf 模型使用策略。
    - [Windsurf vs Cursor、Claude Code、Codex 怎么选](/docs/windsurf/understanding/08-windsurf-vs-cursor-claude-code-codex): 从工作入口、上下文方式、自动化能力、团队治理和典型任务比较 Windsurf、Cursor、Claude Code 与 Codex。
- OpenCode
  - [OpenCode 中文教程](/docs/opencode): 基于 OpenCode 官方资料和源码重写的中文教程。
  - 从原理到实战
    - [OpenCode 从原理到实战](/docs/opencode/understanding): 从定位、终端工作流、配置、Agent、模型、工具和安全边界理解 OpenCode。
    - [01 · OpenCode 是什么](/docs/opencode/understanding/01-what-is-opencode): 理解 OpenCode 的定位：开源、终端优先、多模型可换、配置开放的 AI Coding Agent。
    - [02 · 安装、连接模型与第一次运行](/docs/opencode/understanding/02-install-first-run): 从安装 OpenCode 到连接 provider、启动 TUI，并完成第一轮只读和低风险写入。
    - [03 · 终端 TUI 工作流](/docs/opencode/understanding/03-terminal-workflow): 理解 OpenCode 的 TUI：文件引用、shell 命令、斜杠命令、Plan/Build 双模式、会话、压缩与 attach。
    - [04 · 配置、Rules 与自定义命令](/docs/opencode/understanding/04-config-rules-commands): 基于官方 OpenCode Config、Rules、Commands 教程，面向新手讲清配置、规则和命令各自沉淀什么经验。
    - [05 · Agents、Skills 与 Plugins](/docs/opencode/understanding/05-agents-skills-plugins): 区分 OpenCode 中的 agent、skill、plugin：角色边界、流程复用和运行时扩展不要混在一起。
    - [06 · 模型与供应商策略](/docs/opencode/understanding/06-model-provider-strategy): 在 OpenCode 中按任务风险、成本、速度和数据边界选择 provider、model、variant 与默认模型。
    - [07 · 工具、MCP、LSP 与格式化器](/docs/opencode/understanding/07-tools-mcp-lsp): 理解 OpenCode 如何连接文件系统、shell、MCP server、LSP 和 formatter。
    - [08 · 安全、分享与团队使用](/docs/opencode/understanding/08-security-share-team): 使用 OpenCode 时如何控制权限、网络、会话分享和团队配置边界。
  - 官方教程中文版
    - [OpenCode 官方教程中文版](/docs/opencode/official): 基于 OpenCode 官方资料重写的中文查询手册，按功能分类组织。
    - 入门
      - [入门](/docs/opencode/official/00-getting-started): 汇总 OpenCode 入门路径，按 CLI、TUI、分享和 IDE 入口建立第一条可运行闭环。
      - [使用 CLI](/docs/opencode/official/00-getting-started/cli): 整理 OpenCode CLI 的常用命令、启动参数和适合新手的最小验证流程。
      - [使用 TUI](/docs/opencode/official/00-getting-started/tui): 说明 OpenCode 终端界面的基本操作、常见状态和新手第一次使用的检查点。
      - [连接 IDE](/docs/opencode/official/00-getting-started/ide): 在 VS Code、Cursor、Windsurf、VSCodium 等 IDE 中使用 OpenCode。
      - [分享会话](/docs/opencode/official/00-getting-started/share): 说明 OpenCode 会话分享的用途、公开边界、撤销方式和团队默认策略。
    - 个性化
      - [切换主题](/docs/opencode/official/01-customization/themes): 选择内置主题，或用少量颜色定义自己的 OpenCode TUI 主题。
      - [配置快捷键](/docs/opencode/official/01-customization/keybinds): 用 tui.json 调整少数真正影响效率的 OpenCode TUI 快捷键。
      - [创建自定义命令](/docs/opencode/official/01-customization/commands): 用自定义命令把重复提示词沉淀成可复用入口。
      - [配置 OpenCode](/docs/opencode/official/01-customization/config): 理解 opencode.json、配置合并、加载优先级和新手最小配置策略。
    - Agents & Skills
      - [配置 Agents](/docs/opencode/official/02-agents-skills/agents): 理解 OpenCode 里的 Build、Plan、Explore、General，以及什么时候创建自己的 Agent。
      - [使用 Agent Skills](/docs/opencode/official/02-agents-skills/skills): 理解 OpenCode Agent Skills：放在哪里、怎么写、什么时候加载，以及权限如何控制。
      - [安装插件](/docs/opencode/official/02-agents-skills/plugins): 理解 OpenCode 插件什么时候该用，以及如何安全扩展运行行为。
      - [编写规则](/docs/opencode/official/02-agents-skills/rules): 基于 OpenCode 官方 Rules 文档，帮助新手理解 AGENTS.md、全局规则、Claude Code 兼容和外部指令文件。
    - 模型与供应商
      - [选择模型](/docs/opencode/official/03-models/models): 基于 OpenCode 官方 Models 文档，帮助新手理解 provider、model、variant 和默认模型的选择边界。
      - [配置模型供应商](/docs/opencode/official/03-models/providers): 理解 OpenCode provider、凭据、模型选择、本地模型和自定义 endpoint 的边界。
    - 工具与 MCP
      - [连接 MCP 服务器](/docs/opencode/official/04-tools-mcp/mcp-servers): 为 OpenCode 添加外部工具，并控制上下文和权限成本。
      - [创建自定义工具](/docs/opencode/official/04-tools-mcp/custom-tools): 在 OpenCode 里给模型提供可控、可复用的项目动作。
      - [管理工具](/docs/opencode/official/04-tools-mcp/tools): 说明 OpenCode 工具管理、LLM 可用工具范围、权限控制和排障思路。
      - [连接 LSP 服务器](/docs/opencode/official/04-tools-mcp/lsp): OpenCode 与你的 LSP 服务器集成。
      - [配置格式化工具](/docs/opencode/official/04-tools-mcp/formatters): OpenCode 使用特定语言的格式化工具。
    - 安全与网络
      - [管理权限](/docs/opencode/official/05-security/permissions): 理解 OpenCode 的 allow、ask、deny、外部目录和 Agent 级权限边界。
      - [配置网络](/docs/opencode/official/05-security/network): 理解 OpenCode 的代理变量、NO_PROXY 和企业自定义证书配置。
    - 集成
      - [接入 GitHub](/docs/opencode/official/06-integrations/github): 在 GitHub Issue 和 Pull Request 中安全地使用 OpenCode。
      - [接入 GitLab](/docs/opencode/official/06-integrations/gitlab): 在 GitLab Issue、Merge Request 和 CI/CD 中使用 OpenCode。
      - [了解生态系统](/docs/opencode/official/06-integrations/ecosystem): 基于 OpenCode 构建的项目与集成。
      - [配置企业版](/docs/opencode/official/06-integrations/enterprise): 在组织中安全试用和部署 OpenCode，覆盖数据边界、SSO、内部 AI 网关、分享禁用和私有 npm 注册表。
    - SDK & 服务
      - [使用 SDK](/docs/opencode/official/07-sdk/sdk): 基于官方 OpenCode SDK 教程，面向新手讲清 SDK 适合什么集成场景、server/client 怎么理解、结构化输出和错误处理怎么验收。
      - [启动服务器](/docs/opencode/official/07-sdk/server): 通过 HTTP 与 OpenCode server 交互，并理解 serve、web、TUI、SDK 和 OpenAPI 的关系。
      - [在 Web 中使用 OpenCode](/docs/opencode/official/07-sdk/web): 说明如何在浏览器中使用 OpenCode，并区分 Web 入口、SDK 和 server 的职责。
    - 平台与故障
      - [在 Windows WSL 中使用 OpenCode](/docs/opencode/official/08-platform/windows-wsl): 通过 WSL 在 Windows 上运行 OpenCode，处理文件系统、Desktop/Web 连接和安全边界。
      - [使用 Zen 模型列表](/docs/opencode/official/08-platform/zen): 理解 OpenCode Zen 的定位、接入流程、模型 ID、计费、隐私和团队治理边界。
      - [排查故障](/docs/opencode/official/08-platform/troubleshooting): 汇总 OpenCode 常见故障的排查顺序，覆盖安装、认证、模型、工具和终端问题。
      - [接入 ACP](/docs/opencode/official/08-platform/acp): 理解 Agent Client Protocol：如何把 OpenCode 接入 Zed、JetBrains 和 Neovim 等编辑器。
- OpenClaw 小龙虾
  - [OpenClaw 小龙虾中文教程](/docs/openclaw): 翔宇自研多 Agent 协作框架的中文教程，连接主站个人实践和开源内容源。
  - 从原理到实战
    - [OpenClaw 从原理到实战](/docs/openclaw/understanding): 10 篇 OpenClaw 深度讲解的阅读地图：从 AI 为什么需要一个家，到消息旅程、记忆、Workspace、多 Agent、心跳、安全和设计复盘。
    - [01 · 为什么 AI 需要一个家](/docs/openclaw/understanding/01-ai-home): 从无状态聊天出发，解释 OpenClaw 为什么需要 Gateway、Memory、Channel 和 Agent 这几个基础概念。
    - [02 · 一条消息的旅程](/docs/openclaw/understanding/02-message-journey): 拆解一条消息从渠道进入 OpenClaw 到 Agent 回复的完整链路，包括路由、session、队列、上下文、工具和回复分块。
    - [03 · Agent 的大脑是怎么工作的](/docs/openclaw/understanding/03-agent-brain): 理解 OpenClaw Agent runtime、Agent loop、Tools、Skills、Hooks 与权限边界如何组成一个可执行的大脑。
    - [04 · OpenClaw 的记忆系统：短期、长期、可检索记忆](/docs/openclaw/understanding/04-memory-system): 解释 OpenClaw 如何用 Markdown 文件、记忆搜索、压缩前保存和 Dreaming 组成可审查的记忆系统。
    - [05 · Context 管理：为什么 AI 会忘记、截断和压缩](/docs/openclaw/understanding/05-context-management): 理解 OpenClaw 如何组装上下文、统计 token、注入 workspace 文件，并通过 compaction 与 pruning 控制窗口压力。
    - [06 · Workspace：Agent 的工作空间和身份容器](/docs/openclaw/understanding/06-workspace): 讲清 OpenClaw workspace 的真实边界：它是默认 cwd 和项目上下文，不是配置库、凭据库或硬沙箱。
    - [07 · 多 Agent：什么时候拆、怎么协作](/docs/openclaw/understanding/07-multi-agent): 解释 OpenClaw 多 Agent 的真实边界：独立 workspace、agentDir、sessions、bindings、sub-agents 和 delegate 场景。
    - [08 · Session 与心跳：时间如何进入 Agent](/docs/openclaw/understanding/08-session-heartbeat): 解释 OpenClaw 的 Session、Heartbeat、Cron、Webhooks 与 Tasks：谁负责上下文，谁负责定时，谁只做台账。
    - [09 · Channel 与安全：谁能进来、能做什么](/docs/openclaw/understanding/09-channel-security): 从 OpenClaw 官方安全模型出发，拆清 Channel 路由、DM 配对、群组门控、工具权限、沙箱和 Gateway 暴露。
    - [10 · 设计复盘：OpenClaw 为什么这样设计](/docs/openclaw/understanding/10-design-review): 把 Gateway、Agent Loop、Workspace、Memory、Session、Channel、Automation 与 Security 收束成一张架构图。
  - 官方教程中文版
    - [OpenClaw 官方教程中文版](/docs/openclaw/official): 基于 OpenClaw 官方文档重写的中文教程：安装、Gateway、配置、workspace 和后续开发文档。
    - 入门与安装
      - [入门与安装](/docs/openclaw/official/00-getting-started): OpenClaw 入门与安装学习地图：先安装和 onboarding，再验证 Gateway、理解配置结构，最后整理 Agent Workspace。
      - [安装 OpenClaw](/docs/openclaw/official/00-getting-started/installation): 基于官方 OpenClaw 安装教程，面向新手讲清推荐安装、Node 要求、替代路径、源码安装和安装后验证。
      - [快速上手 OpenClaw](/docs/openclaw/official/00-getting-started/quickstart): 用 OpenClaw onboarding 跑通模型认证、Gateway、Dashboard 和第一条消息，确认最小闭环真的可用。
      - [理解配置结构](/docs/openclaw/official/00-getting-started/configuration): 理解 OpenClaw 配置结构：openclaw.json、JSON5、strict schema、热加载、last-known-good、环境变量和密钥边界。
      - [配置 Agent Workspace](/docs/openclaw/official/00-getting-started/workspace): 理解 OpenClaw Agent Workspace：长期工作现场、标准启动文件、sandbox 边界、私有 git 备份和迁移方式。
    - Gateway 运行时
      - [Gateway 运行时](/docs/openclaw/official/01-gateway-runtime): OpenClaw Gateway 运行时学习地图：理解 Gateway、配置、Agent、Channel、安全远程访问和自动化边界。
      - [理解 Gateway 架构](/docs/openclaw/official/01-gateway-runtime/architecture): 理解 OpenClaw Gateway 架构：长期控制面、WebSocket 协议、nodes、pairing、本机 loopback、远程访问和运行不变量。
      - [配置 Gateway](/docs/openclaw/official/01-gateway-runtime/gateway-configuration): 配置 OpenClaw Gateway：gateway.mode、strict schema、reload mode、Config RPC、health、doctor、安全重启和排障顺序。
      - [配置 Agent](/docs/openclaw/official/01-gateway-runtime/agents): 配置 OpenClaw Agent：workspace、repoRoot、bootstrap 注入、skills allowlist、agentDir、session、模型和多 Agent 路由边界。
      - [配置 Channel](/docs/openclaw/official/01-gateway-runtime/channels): 配置 OpenClaw Channel：DM policy、group policy、mention gating、pairing、access groups、多账号、model override 和 Agent binding。
      - [配置安全与远程访问](/docs/openclaw/official/01-gateway-runtime/security-remote): 理解 OpenClaw 安全与远程访问：个人助手信任模型、security audit、Control UI、Tailscale、SSH tunnel、sandbox 和共享入口风险。
      - [配置自动化](/docs/openclaw/official/01-gateway-runtime/automation): OpenClaw cron、tasks、task flow、standing orders、hooks 和 heartbeat 的选择边界。
- Hermes Agent
  - [Hermes Agent 中文教程](/docs/hermes): 基于 Nous Research Hermes Agent 官方资料重写的中文教程，作为开源 Agent 运行时的横向研究资料。
  - 从原理到实战
    - [Hermes Agent 从原理到实战](/docs/hermes/understanding): 面向中文开发者，用 8 篇文章建立 Hermes Agent 的定位、稳定闭环、配置、工具、记忆、技能、消息网关和自动化边界。
    - [01 · Hermes Agent 是什么](/docs/hermes/understanding/01-what-is-hermes-agent): 理解 Hermes Agent 的定位：CLI/TUI、provider、工具、记忆、skills、Gateway、terminal backends 和自动化组成的开源 agent runtime。
    - [02 · 先跑通第一个稳定闭环](/docs/hermes/understanding/02-first-stable-loop): 安装 Hermes 后先验证命令、provider、64K context、普通对话、session 恢复和低风险工具调用。
    - [03 · 配置、Provider 与目录结构](/docs/hermes/understanding/03-configuration-provider): 理解 Hermes 的 ~/.hermes 目录、config.yaml、.env、auth.json、SOUL.md、provider、timeout 和 terminal backend。
    - [04 · 工具系统与终端后端](/docs/hermes/understanding/04-tools-terminal-backends): 区分 Hermes toolsets、tools、terminal backends、后台进程、Nous Tool Gateway 和整体权限风险。
    - [05 · 记忆与召回](/docs/hermes/understanding/05-memory-and-recall): 区分 Hermes curated memory、USER.md、MEMORY.md、冻结快照、session_search、容量治理和外部 memory provider。
    - [06 · Skills 系统](/docs/hermes/understanding/06-skills-system): 理解 Hermes skill、prompt、tool、memory 的边界，以及本地正本、渐进加载、secure setup、Hub 安装和 agent-managed skills。
    - [07 · 消息网关](/docs/hermes/understanding/07-messaging-gateway): 理解 Hermes Gateway、平台入口、chat session、allowlist、DM pairing、slash commands、busy input 和 background session 的关系。
    - [08 · 自动化边界](/docs/hermes/understanding/08-automation-boundaries): 使用 Hermes cron、background、delegation、hooks 和消息投递前，先建立权限、日志、失败处理和人工确认边界。
  - 官方教程中文版
    - [Hermes Agent 官方教程中文版](/docs/hermes/official): 基于 Nous Research 官方 docs、llms.txt 和上游源码重写的 Hermes Agent 中文查询手册。
    - 入门
      - [安装 Hermes Agent](/docs/hermes/official/00-getting-started/installation): 用官方安装路径在 Linux、macOS、WSL2、原生 Windows（早期测试）或 Termux 上安装 Hermes Agent，并完成 PATH、目录、依赖和排障验收。
      - [快速上手 Hermes Agent](/docs/hermes/official/00-getting-started/quickstart): 从安装、provider、第一次对话、session 恢复到下一层能力，跑通 Hermes Agent 的最小稳定闭环。
      - [规划 Hermes Agent 学习路径](/docs/hermes/official/00-getting-started/learning-path): 按经验等级和使用场景选择 Hermes Agent 文档阅读顺序，先跑通基础闭环，再进入工具、记忆、消息网关和自动化。
    - 使用手册
      - [使用手册](/docs/hermes/official/01-user-guide): Hermes Agent 配置、工具系统、记忆、技能和消息网关的中文使用入口，按问题定位能力边界。
      - [配置 Hermes Agent](/docs/hermes/official/01-user-guide/configuration): 理解 Hermes 的 ~/.hermes 目录、config.yaml、.env、OAuth、配置优先级、环境变量替换和七类 terminal backend。
      - [接入消息网关和平台](/docs/hermes/official/01-user-guide/messaging): 理解 Hermes Messaging Gateway 的平台接入、session、allowlist、DM pairing、聊天命令、background session 和安全边界。
      - [配置工具系统和终端后端](/docs/hermes/official/01-user-guide/tools): 理解 Hermes tools、toolsets、Nous Tool Gateway、terminal backends、后台进程和权限边界。
      - [使用记忆系统](/docs/hermes/official/01-user-guide/memory): 理解 Hermes 的 MEMORY.md、USER.md、冻结快照、memory tool、session_search、容量限制、安全扫描和外部 memory provider。
      - [使用技能系统](/docs/hermes/official/01-user-guide/skills): 理解 Hermes skills 的渐进加载、本地正本、外部目录、Skills Hub、secure setup、agent-managed skills 和安装审查。

# Docs

- [AI 程式設計教程矩陣](/zh-Hant/docs): Codex、Claude Code、Cursor、Copilot 等 10 個 AI 程式設計工具的官方文件中文版總索引，588 篇按工具分組排好，每頁底部給官方原文連結。
- 使用指南
  - [使用指南](/zh-Hant/docs/how-to-use): 把 588 篇 AI 程式設計文件當中文素材庫，讓 AI 用你喜歡的講解風格講透——四步流程加雙層架構加 20 條提示詞。
  - 20 條講解風格提示詞
    - [20 條講解風格提示詞](/zh-Hant/docs/how-to-use/prompts): 費曼、竇文濤、金庸、喬布斯、馬斯克……20 個名家風格的講解提示詞，每條獨立 1 頁可整段複製。
    - [01 · 費曼](/zh-Hant/docs/how-to-use/prompts/feynman): 物理學家費曼學習法：能用最簡單的話講給 6 歲小孩聽才算真懂。整段複製提示詞扔給 AI 即可開聊。
    - [02 · 竇文濤](/zh-Hant/docs/how-to-use/prompts/doumen): 圓桌派三人閒聊風：好概念是聊出來的不是教出來的。整段複製提示詞扔給 AI 即可開聊。
    - [03 · 霍金](/zh-Hant/docs/how-to-use/prompts/hawking): 時間簡史風極簡物理普及：日常短句加畫面感加零公式。整段複製提示詞扔給 AI 即可開聊。
    - [04 · 金庸](/zh-Hant/docs/how-to-use/prompts/jinyong): 武俠門派演義：每個工具都有絕技、命門，最後華山論劍見高下。整段複製提示詞扔給 AI 即可開聊。
    - [05 · 大衛·愛登堡](/zh-Hant/docs/how-to-use/prompts/attenborough): BBC 自然紀錄片旁白：把工具當物種沉靜觀察。整段複製提示詞扔給 AI 即可開聊。
    - [06 · 道金斯](/zh-Hant/docs/how-to-use/prompts/dawkins): 自私的基因風進化論視角：能複製擴散的就是模因，看複製策略。整段複製提示詞扔給 AI 即可開聊。
    - [07 · 薩爾·可汗](/zh-Hant/docs/how-to-use/prompts/khan): 可汗學院黑板講課：拆成 5 分鐘小步驟每步動手。整段複製提示詞扔給 AI 即可開聊。
    - [08 · 肯·羅賓遜爵士](/zh-Hant/docs/how-to-use/prompts/robinson): TED 溫暖演講風：從意想不到的小故事起手加金句收。整段複製提示詞扔給 AI 即可開聊。
    - [09 · 西蒙·西涅克](/zh-Hant/docs/how-to-use/prompts/sinek): TED 黃金圈：Why 到 How 到 What 三層展開。整段複製提示詞扔給 AI 即可開聊。
    - [10 · 尤瓦爾·赫拉利](/zh-Hant/docs/how-to-use/prompts/harari): 人類簡史風宏大史詩：把工具放回 1 萬年的故事裡。整段複製提示詞扔給 AI 即可開聊。
    - [11 · 樊登](/zh-Hant/docs/how-to-use/prompts/fandeng): 樊登讀書風：濃縮三個核心結論加聯絡工作生活。整段複製提示詞扔給 AI 即可開聊。
    - [12 · 丹尼爾·卡尼曼](/zh-Hant/docs/how-to-use/prompts/kahneman): 思考快與慢風：讓你看清自己直覺錯在哪。整段複製提示詞扔給 AI 即可開聊。
    - [13 · 羅翔](/zh-Hant/docs/how-to-use/prompts/luoxiang): B 站法律科普段子手：虛構小人物加嚴肅論述加金句。整段複製提示詞扔給 AI 即可開聊。
    - [14 · 羅振宇](/zh-Hant/docs/how-to-use/prompts/luozhenyu): 羅輯思維 60 秒：金句壓縮加意外角度加可轉發。整段複製提示詞扔給 AI 即可開聊。
    - [15 · 易中天](/zh-Hant/docs/how-to-use/prompts/yizhongtian): 百家講壇品三國：用三國人物對照工具。整段複製提示詞扔給 AI 即可開聊。
    - [16 · 吳曉波](/zh-Hant/docs/how-to-use/prompts/wuxiaobo): 激盪三十年財經史敘事：緣起到演進到關鍵節點。整段複製提示詞扔給 AI 即可開聊。
    - [17 · 李永樂](/zh-Hant/docs/how-to-use/prompts/liyongle): 中學物理老師 B 站科普：黑板提問到推導到示意圖。整段複製提示詞扔給 AI 即可開聊。
    - [18 · 喬布斯](/zh-Hant/docs/how-to-use/prompts/jobs): 蘋果釋出會三幕式：問題加拒絕現有加揭幕新東西。整段複製提示詞扔給 AI 即可開聊。
    - [19 · 馬斯克](/zh-Hant/docs/how-to-use/prompts/musk): 第一性原理加黑色幽默：拆到底層再加銳評。整段複製提示詞扔給 AI 即可開聊。
    - [20 · 巴菲特](/zh-Hant/docs/how-to-use/prompts/buffett): 致股東信平實自嘲：第一人稱覆盤加真實數字。整段複製提示詞扔給 AI 即可開聊。
- Claude Code
  - [Claude Code 中文教程](/zh-Hant/docs/claude-code): 基於 Anthropic 官方文件、原始碼和釋出記錄重寫的 Claude Code 中文教程，連線翔宇工作流的真實專案實踐。
  - 從原理到實戰
    - [Claude Code 從原理到實戰](/zh-Hant/docs/claude-code/understanding): 12 篇翔宇深度講解的閱讀地圖：從 Claude Code 是什麼，到上下文、記憶、命令檔案、SubAgents、MCP、許可權和外掛。
    - [01 · Claude Code 是什麼](/zh-Hant/docs/claude-code/understanding/01-what-is-claude-code): 解釋 Claude Code 為什麼不是聊天框，而是能進入本機專案、讀檔案、改程式碼、跑命令並圍繞任務規劃的程式設計 Agent。
    - [02 · 一次能看多少程式碼](/zh-Hant/docs/claude-code/understanding/02-context-window): 上下文視窗不是記憶，是一張會滿的工作臺。100 萬 token 聽起來巨大，但用了 78% 你就會覺察 Claude 變笨——理解這張桌子怎麼運作、怎麼管，操作上的困惑就全解開了。
    - [03 · 怎麼記住你的習慣](/zh-Hant/docs/claude-code/understanding/03-memory): 上下文是一次性的，關機就清空。Claude Code 怎麼跨會話記住你的專案、習慣、偏好？答案是雙軌記憶——你寫的 CLAUDE.md 持久指令 + 它自己寫的 Auto Memory 工作筆記。
    - [04 · 怎麼和 AI 說話](/zh-Hant/docs/claude-code/understanding/04-prompting): 提示詞不是模板遊戲，是資訊密度遊戲。同樣意思不同表達，AI 輸出天差地別——不是因為語氣，是因為資訊量。理解資訊四件套（目標 / 上下文 / 邊界 / 驗收），你給的每條指令都會立刻不一樣。
    - [05 · AI 怎麼決定想多深](/zh-Hant/docs/claude-code/understanding/05-thinking-depth): 思考深度不是把 AI 變聰明，而是決定回答前走多少步推理。變數改名用 low，架構決策用 xhigh，關鍵遷移再考慮 max。
    - [06 · 把重複的話寫成檔案](/zh-Hant/docs/claude-code/understanding/06-command-files): Skills 不是給 Claude 裝新能力，而是把你反覆說的流程寫成檔案。description 決定何時觸發，正文決定怎麼做。
    - [07 · 派助手去幹活](/zh-Hant/docs/claude-code/understanding/07-subagents): SubAgents 的核心不是並行，而是把會汙染主對話的搜尋、日誌和改動放進獨立上下文，只把結論帶回來。
    - [08 · 多個 AI 怎麼協作](/zh-Hant/docs/claude-code/understanding/08-multi-agent): Agent Teams 不是更多 SubAgents，而是讓多個 Claude Code 會話帶著共享任務列表和訊息系統協作，適合跨模組、多假設、需要對齊的任務。
    - [09 · 怎麼連外部服務](/zh-Hant/docs/claude-code/understanding/09-mcp): MCP 不是給 Claude Code 加腦子，而是讓它夠到 GitHub、Sentry、資料庫這些外部系統的標準介面。
    - [10 · 怎麼讓操作 100% 執行](/zh-Hant/docs/claude-code/understanding/10-operation-control): Hooks 不是提醒 Claude Code 記得做事，而是在工具呼叫、提示提交、停止前後設定確定性檢查點。能容忍遺漏寫 CLAUDE.md，不能容忍就用 Hook。
    - [11 · 該給 AI 多少許可權](/zh-Hant/docs/claude-code/understanding/11-permissions): Claude Code 許可權不是安全感按鈕，而是把讀、寫、執行命令、聯網和成本拆成不同信任層級。學會用六種模式、Allow/Ask/Deny、沙盒和預算邊界。
    - [12 · 怎麼給 AI 裝外掛](/zh-Hant/docs/claude-code/understanding/12-plugins): Claude Code Plugin 不是單個新功能，而是把 Skills、Agents、Hooks、MCP、LSP、主題和監控打包成可安裝、可更新、可分發的能力包。
  - 官方教程中文版
    - [Claude Code 官方教程中文版](/zh-Hant/docs/claude-code/official): 基於 Anthropic 官方文件重寫的 Claude Code 中文教程入口，覆蓋入門、配置、許可權、MCP、Skills、Subagents、Hooks 和 SDK。
    - 入門與安裝
      - [入門與安裝](/zh-Hant/docs/claude-code/official/00-getting-started): Claude Code 入門與安裝：用 4 章完成產品定位、安裝更新、登入認證、平臺入口選擇，先把終端、桌面應用、IDE、網頁和雲供應商邊界理清。
      - [Claude Code 是什麼](/zh-Hant/docs/claude-code/official/00-getting-started/overview): Claude Code 不是聊天框，而是能讀專案、改檔案、跑命令、驗證結果的智慧體式程式設計工具。先理解它進入工程現場的工作方式，再開始安裝。
      - [安裝和更新 Claude Code](/zh-Hant/docs/claude-code/official/00-getting-started/install): Claude Code 安裝不要只複製一條命令。先選原生安裝器、Homebrew、WinGet 或 Linux 包管理器，再驗證 PATH、doctor 和更新策略。
      - [登入與認證](/zh-Hant/docs/claude-code/official/00-getting-started/authentication): Claude Code 登入不是隻有訂閱賬號。個人用 Claude.ai，團隊可用 Teams、Enterprise、Console、Bedrock、Vertex AI 或 Microsoft Foundry。
      - [選擇平臺與整合](/zh-Hant/docs/claude-code/official/00-getting-started/platforms): Claude Code 同一套智慧體迴圈可以跑在 CLI、Desktop、IDE、Web、Mobile、Slack 和 CI/CD。選入口先看專案在哪裡、任務要不要長跑、你需不需要視覺審查。
    - 核心配置與能力
      - [核心配置與能力](/zh-Hant/docs/claude-code/official/01-core-capabilities): Claude Code 核心配置與能力：設定、許可權、記憶、MCP 四章串起配置作用域、工具許可權、長期記憶和外部連線邊界。
      - [配置 Claude Code](/zh-Hant/docs/claude-code/official/01-core-capabilities/settings): Claude Code 配置不是隻改一個 settings.json。先分清 managed、user、project、local 四個作用域，再決定許可權、環境變數、Hooks、MCP、外掛和記憶放哪裡。
      - [管理許可權](/zh-Hant/docs/claude-code/official/01-core-capabilities/permissions): Claude Code 許可權不是一個總開關，而是控制 Bash、Read、Edit、WebFetch、MCP、Subagents 等工具呼叫的邊界。學會六種模式、deny/ask/allow、路徑規則和 sandbox（沙盒）配合。
      - [使用記憶機制](/zh-Hant/docs/claude-code/official/01-core-capabilities/memory): Claude Code 的記憶分成 CLAUDE.md 和 auto memory（自動記憶）。學會檔案位置、載入順序、@import、.claude/rules、/memory、claudeMdExcludes 和排障邊界。
      - [連線 MCP](/zh-Hant/docs/claude-code/official/01-core-capabilities/mcp): Claude Code 透過 MCP 連線外部工具、資料庫和 API。學會 HTTP、SSE、stdio、作用域、OAuth、輸出限制、Tool Search、許可權和 managed MCP 的邊界。
    - 擴充套件與自動化
      - [擴充套件與自動化](/zh-Hant/docs/claude-code/official/02-extensions-automation): Claude Code 擴充套件與自動化：從擴充套件能力地圖開始，逐章掌握 Skills、Subagents、Hooks、Commands 和 Agent SDK 的分工與組合。
      - [檢視擴充套件能力地圖](/zh-Hant/docs/claude-code/official/02-extensions-automation/extension-map): Claude Code 擴充套件不是越多越好。用一張決策地圖分清 CLAUDE.md、Rules、Skills、MCP、Subagents、Hooks、Commands、Plugins 和 Agent SDK。
      - [使用 Skills](/zh-Hant/docs/claude-code/official/02-extensions-automation/skills): Claude Code Skills 用 SKILL.md 沉澱重複流程和參考資料。學會作用域、frontmatter、動態上下文、allowed-tools、context fork 和許可權控制。
      - [配置 Subagents](/zh-Hant/docs/claude-code/official/02-extensions-automation/subagents): Claude Code Subagents 用隔離上下文處理專門任務。學會內建 agents、自定義 frontmatter、工具邊界、MCP 限域、skills 預載入、memory、background 和 worktree。
      - [使用 Hooks](/zh-Hant/docs/claude-code/official/02-extensions-automation/hooks): Claude Code Hooks 在生命週期事件上執行確定性自動化。學會事件、matcher、if、exit code、JSON 輸出、command/prompt/agent/HTTP hooks 和安全邊界。
      - [使用 Commands](/zh-Hant/docs/claude-code/official/02-extensions-automation/commands): 說明 Claude Code slash commands、Skill commands、legacy commands、MCP prompts 和常用命令分組。
      - [使用 Agent SDK](/zh-Hant/docs/claude-code/official/02-extensions-automation/agent-sdk): 用 Claude Agent SDK 呼叫 Claude Code agent loop，覆蓋認證、許可權、會話、MCP、Hooks、Subagents 和部署邊界。
- OpenAI Codex
  - [OpenAI Codex 中文教程](/zh-Hant/docs/codex): 基於 OpenAI 官方資料重寫的 Codex 中文教程，覆蓋 App、IDE、CLI、Cloud 和安全邊界。
  - 從原理到實戰
    - [Codex 從原理到實戰](/zh-Hant/docs/codex/understanding): 面向新手的 Codex 理解路線：先理解任務、上下文、邊界和驗證，再進入官方教程中的命令與配置。
    - [01 · Codex 是什麼](/zh-Hant/docs/codex/understanding/what-is-codex): 把 Codex 從會寫程式碼的聊天框，重新理解成能進入專案現場的工程協作 Agent。
    - [02 · 一次任務是怎麼完成的](/zh-Hant/docs/codex/understanding/how-a-task-completes): 把 Codex 的一次任務理解成從目標、上下文、計劃、執行到驗證交付的工程管線。
    - [03 · Codex 看到的上下文從哪裡來](/zh-Hant/docs/codex/understanding/context-engineering): 理解任務、專案、程式碼、規則和反饋五層上下文，減少 Codex 憑空猜測和無關改動。
    - [04 · 為什麼 AGENTS.md 能改變 Codex 行為](/zh-Hant/docs/codex/understanding/agents-md-guide): 面向新手解釋 AGENTS.md 為什麼能讓 Codex 更穩定：它是專案和 Agent 的協作介面。
    - [05 · Codex 為什麼需要審批和沙箱](/zh-Hant/docs/codex/understanding/sandbox-approval): 用工程邊界理解 sandbox 和 approval：一個管能不能做，一個管要不要問你。
    - [06 · App、IDE、CLI、Cloud 怎麼選](/zh-Hant/docs/codex/understanding/cli-app-ide-cloud): 按任務場景選擇 Codex 入口：本地終端、編輯器、桌面任務中心或雲端非同步環境。
    - [07 · 如何讓 Codex 呼叫工具和訪問資料](/zh-Hant/docs/codex/understanding/mcp-tools-guide): 理解 Codex 的內建工具、瀏覽器能力、MCP 外部系統接入和 skills 複用邊界。
    - [08 · Skills、Subagents、Hooks 解決什麼問題](/zh-Hant/docs/codex/understanding/skills-subagents-hooks): 區分三種進階機制：skills 複用流程，subagents 拆分工作，hooks 自動檢查關鍵事件。
    - [09 · 如何控制模型、速度、成本和質量](/zh-Hant/docs/codex/understanding/model-cost-speed): 按任務複雜度選擇模型、推理強度、速度檔位和上下文策略，避免把高成本配置當預設值。
    - [10 · 團隊協作和生產環境怎麼落地](/zh-Hant/docs/codex/understanding/team-production): 把個人 Codex 使用升級成團隊可治理流程：共識、邊界、整合、自動化和審計。
    - [11 · 從理解到實戰場景](/zh-Hant/docs/codex/understanding/from-theory-to-practice): 把模糊需求改寫成 Codex 能執行、能驗證、能交付的工程任務。
    - [12 · 一句話覆盤 Codex 全貌](/zh-Hant/docs/codex/understanding/complete-overview): 把 Codex 的入口、上下文、工具、邊界、驗證和團隊落地壓成一條新手能複用的決策鏈。
  - 官方教程中文版
    - [Codex 官方教程中文版](/zh-Hant/docs/codex/official): 基於 OpenAI 官方資料，按入口、配置、安全、擴充套件、Cloud、團隊和實戰場景重寫的 Codex 中文查詢手冊。
    - 新手必讀
      - [新手必讀](/zh-Hant/docs/codex/official/00-getting-started): 從定位、快速開始、登入認證、術語和安全檢查開始，建立 Codex 的第一條安全使用閉環。
      - [理解 Codex 定位](/zh-Hant/docs/codex/official/00-getting-started/00-codex-positioning): 說明 Codex 在 OpenAI 產品體系裡的定位、適合解決的問題，以及新手第一次使用前要理解的基本邊界。
      - [快速上手 Codex](/zh-Hant/docs/codex/official/00-getting-started/01-quickstart): 基於 OpenAI 官方 Quickstart，幫助新手選擇 Codex 入口，並完成第一次安全、可驗證的使用。
      - [完成登入和認證](/zh-Hant/docs/codex/official/00-getting-started/02-auth): 區分 ChatGPT 登入、API key 登入、雲端認證、憑據快取和受管理環境中的認證控制。
      - [新手術語速查表](/zh-Hant/docs/codex/official/00-getting-started/glossary): 給第一次使用 Codex 的中文開發者快速查詞，先知道概念在哪些場景出現，再去讀對應章節。
      - [第一次安全使用清單](/zh-Hant/docs/codex/official/00-getting-started/first-safe-use-checklist): 基於官方 Codex 快速開始和安全教程，講清第一次把 Codex 放進真實專案時怎麼先讀懂、再小改、最後驗證。
    - 產品入口
      - [產品入口](/zh-Hant/docs/codex/official/01-products): 基於官方 Codex 產品教程，幫新手分清 CLI、IDE、App、Web、Windows 和自動化入口各自適合什麼任務。
      - [使用命令列版 Codex](/zh-Hant/docs/codex/official/01-products/03-cli): Codex CLI 是 OpenAI 的本地 coding agent，可以在終端裡讀取程式碼、修改程式碼、執行命令，並把結果交給你審查。
      - [使用桌面版 Codex](/zh-Hant/docs/codex/official/01-products/04-app): 從安裝、登入、選擇專案、啟動本地執行緒到審查 diff，完成 Codex App 的第一天使用閉環。
      - [使用網頁版 Codex](/zh-Hant/docs/codex/official/01-products/17-web): 介紹 Codex web 入口如何讀取程式碼、修改程式碼和執行驗證，適合不想先配置本地環境的新手。
      - [安裝和使用 IDE 擴充套件](/zh-Hant/docs/codex/official/01-products/20-ide-install): 說明如何安裝 Codex IDE extension，並理解它和本地專案、編輯器上下文、登入方式的關係。
      - [掌握 IDE 擴充套件功能](/zh-Hant/docs/codex/official/01-products/21-ide-features): 梳理 Codex IDE extension 的核心功能，包括編輯器上下文、local/cloud 模式、圖片輸入和程式碼審查。
      - [調整 IDE 擴充套件設定](/zh-Hant/docs/codex/official/01-products/22-ide-settings): Codex IDE extension settings 用來調整 IDE 裡的 Codex 使用體驗。
      - [使用 IDE 命令](/zh-Hant/docs/codex/official/01-products/23-ide-commands): 整理 Codex IDE extension command palette 命令，以及適合繫結快捷鍵的常用操作。
      - [使用 IDE 斜槓命令](/zh-Hant/docs/codex/official/01-products/24-ide-slash): 說明 IDE slash commands 如何在聊天輸入框裡切換模式、檢視狀態和提交反饋。
      - [使用 CLI 斜槓命令](/zh-Hant/docs/codex/official/01-products/25-cli-slash): 理解 Codex CLI slash commands 的控制面：會話、模型、許可權、上下文、審查和分支探索。
      - [掌握 CLI 功能](/zh-Hant/docs/codex/official/01-products/26-cli-features): 按互動、自動化、遠端連線、審查和擴充套件五類能力理解 Codex CLI，而不是背完整命令清單。
      - [CLI 引數怎麼用](/zh-Hant/docs/codex/official/01-products/27-cli-args): 把 Codex CLI 引數按任務入口、許可權控制和自動化場景拆開，避免把會隨版本變化的命令清單寫死。
      - [跑非互動任務](/zh-Hant/docs/codex/official/01-products/28-non-interactive): 基於官方 non-interactive mode，講清 codex exec 適合什麼自動化任務、許可權怎麼給、輸出怎麼驗收。
      - [連線 Codex App Server](/zh-Hant/docs/codex/official/01-products/32-app-server): 理解 Codex App Server 適合遠端 TUI 和富客戶端整合，不要把它誤用成普通 CI 自動化入口。
      - [掌握 App 核心功能](/zh-Hant/docs/codex/official/01-products/33-app-core): 按 projects、threads、worktrees、automations、Git、terminal 和 browser 理解 Codex App 的桌面工作臺能力。
      - [調整 App 設定](/zh-Hant/docs/codex/official/01-products/34-app-settings): Codex App 的 settings panel 用來調整 App 行為、檔案開啟方式，以及外部工具連線方式。
      - [設定 App 自動化任務](/zh-Hant/docs/codex/official/01-products/35-app-automation): 基於官方 Codex App Automations 教程，講清 automations 適合什麼重複任務、worktree 怎麼選、許可權怎麼控。
      - [用內建瀏覽器驗收頁面](/zh-Hant/docs/codex/official/01-products/36-app-browser): 說明 in-app browser 如何讓 Codex 共享網頁檢視、預覽頁面，並在同一 thread 中接收視覺反饋。
      - [使用 App 命令](/zh-Hant/docs/codex/official/01-products/37-app-commands): 這篇整理 Codex App 中常用 commands、keyboard shortcuts、slash commands 和 deeplinks。
      - [讓 Codex 操作電腦](/zh-Hant/docs/codex/official/01-products/38-computer-use): 說明 Computer Use 如何讓 Codex 操作本地 Mac app，並處理必須透過 GUI 完成的任務。
      - [配置本地執行環境](/zh-Hant/docs/codex/official/01-products/39-local-runtime): Local environments 用來為 worktrees 配置 setup steps，也可以為 project 配置常用 actions。
      - [在 App 中審查改動](/zh-Hant/docs/codex/official/01-products/40-app-review): Review pane 幫你理解 Codex 改了什麼、給出針對性反饋，並決定哪些改動要保留。
      - [排查 App 問題](/zh-Hant/docs/codex/official/01-products/41-app-troubleshoot): 這篇整理 Codex App 常見問題、日誌位置和恢復方式。
      - [使用 Windows 版 App](/zh-Hant/docs/codex/official/01-products/42-windows-app): 講清 Codex 在 Windows 上的三種執行方式、sandbox 邊界、WSL 選擇和常見排錯。
      - [用 Worktrees 並行開發](/zh-Hant/docs/codex/official/01-products/43-worktrees): 理解 Codex App 中 worktree 的用途：隔離並行任務、保護當前工作樹，並安全地 handoff 回本地。
      - [在 Windows 上使用 Codex](/zh-Hant/docs/codex/official/01-products/120-windows-codex): 按 native Windows、WSL2、App、CLI 和 IDE extension 的邊界選擇 Windows 上的 Codex 執行方式。
    - 規則、安全與配置
      - [規則、安全與配置](/zh-Hant/docs/codex/official/02-config-security): 理解 Codex 專案規則、配置、安全審批、沙箱邊界和 Security 相關能力。
      - [編寫專案規則檔案](/zh-Hant/docs/codex/official/02-config-security/05-project-rules): 基於官方 Codex AGENTS.md 和 Rules 教程，講清全域性規則、專案規則、巢狀覆蓋、fallback 檔名和排障方式。
      - [配置 Codex 基礎選項](/zh-Hant/docs/codex/official/02-config-security/06-basic-config): 梳理 Codex config.toml 的載入順序、許可權邊界和新手最該先改的基礎項。
      - [設定審批和安全邊界](/zh-Hant/docs/codex/official/02-config-security/07-approval-security): 理解 Codex 的 sandbox、approval、network access 和自動審批審查，給本地與雲端任務設定正確邊界。
      - [高階配置怎麼讀](/zh-Hant/docs/codex/official/02-config-security/29-advanced-config): 把 Codex 高階配置按使用場景和風險邊界拆開，而不是複製一整張會隨版本變化的配置表。
      - [查詢完整配置項](/zh-Hant/docs/codex/official/02-config-security/30-all-config-options): 用官方 Configuration Reference 和 JSON schema 查詢 Codex 配置項，不把高頻變化的長表硬搬進教程。
      - [參考配置樣例](/zh-Hant/docs/codex/official/02-config-security/31-config-samples): 用少量 config.toml 配置讓 Codex 行為穩定，而不是複製一整份巨型配置。
      - [定製 Codex 行為](/zh-Hant/docs/codex/official/02-config-security/48-customize-behavior): 把 AGENTS.md、Memories、Skills、MCP 和 Subagents 放到同一張行為定製地圖裡。
      - [理解沙箱邊界](/zh-Hant/docs/codex/official/02-config-security/49-sandbox-boundaries): Sandbox 是讓 Codex 能自主行動、但不獲得機器 unrestricted access 的邊界。
      - [理解網路安全邊界](/zh-Hant/docs/codex/official/02-config-security/50-network-security): 這些 safeguards 包括訓練模型拒絕明顯 malicious requests，例如竊取 credentials。
      - [遷移自定義提示到新機制](/zh-Hant/docs/codex/official/02-config-security/52-migrate-prompts): 說明 custom prompts 棄用後，如何把可複用 instructions 遷移到 Codex skills。
      - [用 Rules 控制命令邊界](/zh-Hant/docs/codex/official/02-config-security/53-rules-command-control): Rules 用來控制 Codex 可以在 sandbox 外執行哪些 commands。
      - [理解 Codex 安全模型](/zh-Hant/docs/codex/official/02-config-security/72-security-model): 介紹 Codex Security 的模型：如何在連線的 GitHub repositories 中發現、驗證和修復潛在漏洞。
      - [配置安全執行環境](/zh-Hant/docs/codex/official/02-config-security/73-secure-runtime): 說明 Codex Security 從授權接入到 reviewed findings、remediation pull request 的基本流程。
      - [排查安全常見問題](/zh-Hant/docs/codex/official/02-config-security/74-security-troubleshoot): 用 FAQ 方式理解 Codex Security 的定位、掃描流程、隔離邊界、驗證結果和人工審查責任。
      - [改進威脅模型](/zh-Hant/docs/codex/official/02-config-security/75-threat-model): 這頁說明 threat model 是什麼，以及編輯它如何改善 Codex Security 的 suggestions。
    - 擴充套件能力
      - [擴充套件能力](/zh-Hant/docs/codex/official/03-extensions): 理解 Codex 擴充套件能力：MCP、skills、subagents、hooks、memory、plugins 和 workflows。
      - [接入 MCP 工具和上下文](/zh-Hant/docs/codex/official/03-extensions/08-mcp-integration): Model Context Protocol 把 Codex 連線到外部工具、文件、資料來源和可執行動作。
      - [用 Skills 複用能力](/zh-Hant/docs/codex/official/03-extensions/09-skills-reuse): 理解 agent skills 如何把 instructions、resources 和 scripts 打包成可複用的 Codex 工作流。
      - [用 Subagents 拆分任務](/zh-Hant/docs/codex/official/03-extensions/10-subagents-split): 判斷什麼時候該用 Codex subagents 並行拆任務，什麼時候保持單 agent，並控制上下文、許可權和成本。
      - [用 Hooks 接入自動檢查](/zh-Hant/docs/codex/official/03-extensions/11-hooks-checks): 基於官方 Codex Hooks 教程，講清 hooks 能做什麼、不能做什麼，以及如何從低風險檢查開始。
      - [用 Workflows 編排任務](/zh-Hant/docs/codex/official/03-extensions/12-workflows-orchestration): 把 Codex 任務組織成可複用 workflow：使用場景、上下文、步驟、驗證和交付標準。
      - [理解 Subagents 的分工模型](/zh-Hant/docs/codex/official/03-extensions/51-subagents-model): 說明 Codex subagents 如何並行探索、實現或分析任務，以及什麼時候應該拆分給子 Agent。
      - [使用記憶能力](/zh-Hant/docs/codex/official/03-extensions/64-memory): Memories 預設關閉。launch 時，European Economic Area、United Kingdom 和 Switzerland 不可用。
      - [瞭解 Chronicle 記憶](/zh-Hant/docs/codex/official/03-extensions/65-chronicle-memory): Chronicle 是 opt-in research preview，用螢幕上下文幫助 Codex 構建 memories。
      - [安裝和管理外掛](/zh-Hant/docs/codex/official/03-extensions/68-plugins-manage): Plugins 會把 skills、app integrations 和 MCP servers 打包成 Codex 可複用的工作流。
      - [構建自己的外掛](/zh-Hant/docs/codex/official/03-extensions/69-build-plugins): 區分 skill、plugin、marketplace 的職責，並用最小分發單元安全釋出第一版 Codex plugin。
    - 模型、價格與效率
      - [模型、價格與效率](/zh-Hant/docs/codex/official/04-model-pricing): 理解 Codex 模型選擇、價格、用量、速度檔位和提示詞效率，避免把高成本配置用在低複雜度任務上。
      - [寫好 Codex 提示詞](/zh-Hant/docs/codex/official/04-model-pricing/13-prompting): Prompt 描述你希望 Codex 做什麼，好的提示詞會寫清目標、上下文、邊界和驗證方式。
      - [選擇 Codex 模型](/zh-Hant/docs/codex/official/04-model-pricing/14-model-selection): 說明 Codex 模型選擇思路：按入口、任務複雜度、速度、成本和驗證要求做取捨。
      - [理解價格和用量](/zh-Hant/docs/codex/official/04-model-pricing/15-pricing-usage): 解釋 Codex 價格、用量、credits、ChatGPT 訂閱和 API key 的關係；具體價格和額度以官方頁面為準。
      - [提升 Codex 響應速度](/zh-Hant/docs/codex/official/04-model-pricing/16-speed-up): 說明 Codex Fast mode 和 Codex-Spark 的區別：一個是加速支援模型，一個是獨立的低延遲模型選擇。
      - [判斷功能成熟度](/zh-Hant/docs/codex/official/04-model-pricing/57-feature-maturity): 說明 Codex feature maturity label 的含義，以及如何判斷實驗功能是否適合生產流程。
      - [閱讀使用經驗和實踐建議](/zh-Hant/docs/codex/official/04-model-pricing/63-best-practices): 把 OpenAI 的 Codex best practices 整理成穩定工作法：上下文、規則、配置、驗證、MCP、skills 和自動化。
    - 雲端與遠端環境
      - [雲端與遠端環境](/zh-Hant/docs/codex/official/05-cloud-remote): 基於官方 Codex 教程，幫新手分清 Cloud、聯網許可權和遠端開發環境各自解決什麼問題。
      - [配置雲端執行環境](/zh-Hant/docs/codex/official/05-cloud-remote/18-cloud-runtime): Cloud environments 用來控制 Codex 在執行 cloud tasks 時安裝什麼、執行什麼、能訪問哪些網路和 secrets。
      - [管理 Agent 聯網許可權](/zh-Hant/docs/codex/official/05-cloud-remote/19-network-permissions): 基於 OpenAI 官方 Agent internet access 文件，學習新手什麼時候該給 Codex 聯網許可權，以及如何降低風險。
      - [連線遠端開發環境](/zh-Hant/docs/codex/official/05-cloud-remote/70-remote-dev): SSH remote connections 當前處於 alpha。
    - 團隊與整合
      - [團隊與整合](/zh-Hant/docs/codex/official/06-team-integration): 理解 Codex 在團隊協作中的接入方式：CI、GitHub Action、Slack、Linear、governance 和 SDK。
      - [在 CI/CD 中維護認證](/zh-Hant/docs/codex/official/06-team-integration/44-cicd-auth): 基於官方 Codex CI/CD 認證教程，講清 API key 預設路線、ChatGPT-managed auth 高階路線和 auth.json 的安全邊界。
      - [用 GitHub Action 跑 Codex](/zh-Hant/docs/codex/official/06-team-integration/45-github-action): 基於官方 Codex GitHub Action 教程，講清 openai/codex-action@v1 適合什麼 CI/CD 任務、許可權怎麼給、結果怎麼驗收。
      - [在開源專案中使用 Codex](/zh-Hant/docs/codex/official/06-team-integration/46-open-source-use): 開源維護者經常在幕後承擔關鍵工作，讓整個軟體生態保持健康。
      - [瞭解開源專案條款](/zh-Hant/docs/codex/official/06-team-integration/47-open-source-terms): 梳理 Codex for OSS program terms 的核心結構，幫助開源專案理解申請和使用邊界。
      - [做企業管理員初始化](/zh-Hant/docs/codex/official/06-team-integration/54-enterprise-admin): 為 Enterprise workspace 推出 Codex 前，先確定 owner、入口範圍、RBAC、managed configuration 和治理邊界。
      - [下發託管配置](/zh-Hant/docs/codex/official/06-team-integration/55-managed-config): 基於官方 Codex managed configuration 教程，面向新手講清 requirements、managed defaults、cloud-managed requirements 和企業安全邊界。
      - [做治理和可觀測](/zh-Hant/docs/codex/official/06-team-integration/56-governance-observability): Codex 為 enterprise teams 提供兩類能力：
      - [將 Codex 接入 Agents SDK](/zh-Hant/docs/codex/official/06-team-integration/58-agents-sdk): 把 Codex 作為 MCP server 暴露給 OpenAI Agents SDK，用於可編排的軟體工作流。
      - [建設 AI 原生工程團隊](/zh-Hant/docs/codex/official/06-team-integration/59-ai-native-team): 把 OpenAI 的 AI-native engineering guide 轉成可執行的團隊落地框架：哪些交給 agent，哪些仍由工程師負責。
      - [用 Codex 做 GitHub 程式碼審查](/zh-Hant/docs/codex/official/06-team-integration/60-github-code-review): Codex code review 可以為 GitHub pull requests 增加一輪 high-signal review。
      - [從 Linear 使用 Codex](/zh-Hant/docs/codex/official/06-team-integration/61-linear-integration): 你可以在 Linear 中使用 Codex，把 issues 裡的工作交給它處理。
      - [從 Slack 使用 Codex](/zh-Hant/docs/codex/official/06-team-integration/62-slack-integration): 你可以在 Slack 中使用 Codex，從 channels 和 threads 直接啟動 coding tasks。
      - [瞭解開源入口](/zh-Hant/docs/codex/official/06-team-integration/67-open-source-entry): OpenAI 會以 open 的方式開發 Codex 的關鍵部分。
      - [用 Codex SDK 整合 Agent](/zh-Hant/docs/codex/official/06-team-integration/71-codex-sdk): 判斷什麼時候該用 Codex SDK，什麼時候先用 codex exec，併為團隊自動化設計許可權、結構化輸出和失敗處理。
    - 學習路線
      - [學習路線](/zh-Hant/docs/codex/official/07-learning-paths): 按 Web、生產程式碼庫、原生 App、遊戲和效率場景選擇 Codex 學習路徑。
      - [遊戲開發路線](/zh-Hant/docs/codex/official/07-learning-paths/76-game-dev-path): Codex 結合 image generation，用來建立 browser-based games 和其他型別 games 會很有用。
      - [原生應用開發路線](/zh-Hant/docs/codex/official/07-learning-paths/77-native-app-path): 當每一次 pass 都配有 build、run 或 simulator loop 時，Codex 很適合 Apple platform projects。
      - [生產系統路線](/zh-Hant/docs/codex/official/07-learning-paths/78-production-path): 整理生產級程式碼庫裡的 Codex 用法：在 history、tests、owners 和 production constraints 中推進任務。
      - [效率與協作路線](/zh-Hant/docs/codex/official/07-learning-paths/79-productivity-path): Codex 可以幫助你跨多個 apps 和 files 管理工作，並與團隊協作。
      - [Web 開發路線](/zh-Hant/docs/codex/official/07-learning-paths/80-web-dev-path): 整理 Codex 在 Web 開發中的典型用法，包括設計系統、視覺輸入、響應式 UI 和瀏覽器驗證。
      - [按場景選擇學習路線](/zh-Hant/docs/codex/official/07-learning-paths/118-scenario-paths): 整理 Codex use cases 的場景集合、篩選項和學習路徑，方便按任務型別選閱讀順序。
    - 實戰場景
      - [實戰場景](/zh-Hant/docs/codex/official/08-scenarios): 按真實使用場景查 Codex 用法：資料清洗、程式碼遷移、Bug triage、UI、移動端、QA 和團隊流程。
      - [實戰場景總覽](/zh-Hant/docs/codex/official/08-scenarios/81-scenarios-overview): 這頁是 Codex use cases 總索引。
      - [讓 Codex 能呼叫你的命令列工具](/zh-Hant/docs/codex/official/08-scenarios/82-cli-tool-use): 把重複訪問 API、日誌、資料庫或團隊指令碼的動作封裝成 agent-friendly CLI，並配套 skill 固化呼叫方法。
      - [用 Codex 查詢表格資料](/zh-Hant/docs/codex/official/08-scenarios/83-tabular-data): 說明如何讓 Codex 讀取 CSV、電子表格或 dashboard export，回答明確問題並生成視覺化頁面。
      - [用 Codex 升級 API 接入](/zh-Hant/docs/codex/official/08-scenarios/84-api-upgrade): 說明 OpenAI API 升級時如何用 Codex 盤點現狀、做最小遷移，並用 evals 驗證行為沒有退化。
      - [用 Codex 做 Bug 分診](/zh-Hant/docs/codex/official/08-scenarios/85-bug-triage): 說明如何讓 Codex 只讀掃查 Sentry、Slack、Linear、GitHub 和 logs 中的 bug 訊號。
      - [用 Codex 做瀏覽器遊戲](/zh-Hant/docs/codex/official/08-scenarios/86-browser-game): 說明如何用 Codex 開發可玩的瀏覽器遊戲，並在 controls、timing、UI feel 和素材上持續驗證。
      - [把你的應用接入 ChatGPT](/zh-Hant/docs/codex/official/08-scenarios/87-chatgpt-integration): 說明如何把產品接入 ChatGPT：先選明確使用者結果，再設計少量 tools、MCP server 和可選 widget。
      - [整理髒資料並生成可用資料集](/zh-Hant/docs/codex/official/08-scenarios/88-data-cleaning): 用 Codex 清洗 CSV 或 spreadsheet 資料：先保留原檔案，再生成可審查的清洗副本和 data-quality note。
      - [讓 Codex 執行程式碼遷移](/zh-Hant/docs/codex/official/08-scenarios/89-code-migration): 說明如何用 Codex 做程式碼遷移：先盤點 legacy system，再按 checkpoint 驗證 parity。
      - [讓 Codex 快速讀懂大型程式碼庫](/zh-Hant/docs/codex/official/08-scenarios/90-large-codebase): 說明如何讓 Codex 給陌生 repo 建立可編輯地圖，找出 request flow、模組職責和下一步閱讀路徑。
      - [把聊天訊息轉成可交付任務](/zh-Hant/docs/codex/official/08-scenarios/91-chat-to-task): 說明如何讓 Computer Use 從 Messages thread 識別待辦，跨應用完成任務並起草回覆。
      - [從資料集到分析報告](/zh-Hant/docs/codex/official/08-scenarios/92-data-to-report): 說明如何讓 Codex 把資料分析產出成可複查、可重跑、可交付的報告 artifact。
      - [釋出應用或網站](/zh-Hant/docs/codex/official/08-scenarios/93-deploy-app): 說明如何讓 Codex 從 repo、screenshot、design brief 或 API doc 出發構建網站並部署 preview。
      - [把使用者反饋變成開發任務](/zh-Hant/docs/codex/official/08-scenarios/94-feedback-to-task): 說明如何讓 Codex 把分散在 Slack、survey、GitHub、Linear 和研究筆記裡的反饋整理成可 review 任務。
      - [把 Figma 設計落成前端程式碼](/zh-Hant/docs/codex/official/08-scenarios/95-figma-to-code): 說明如何讓 Codex 從 Figma 拉取設計上下文和 assets，並用瀏覽器驗證實現是否貼合參考圖。
      - [構建適配多端的前端介面](/zh-Hant/docs/codex/official/08-scenarios/96-multi-platform-ui): 說明如何讓 Codex 根據 screenshots、design brief 或視覺參考生成 responsive UI，並在真實瀏覽器中迭代。
      - [生成彙報幻燈片](/zh-Hant/docs/codex/official/08-scenarios/97-report-slides): 說明如何讓 Codex 用 slides 和 imagegen skills 建立或修改 PowerPoint deck。
      - [讓 Codex 審查 GitHub PR](/zh-Hant/docs/codex/official/08-scenarios/98-pr-review): 說明 Codex code review 如何在 GitHub PR 上補充 regression、missing tests 和 risky behavior signals。
      - [為 iOS App 增加系統動作入口](/zh-Hant/docs/codex/official/08-scenarios/99-ios-app-intents): 說明如何用 Codex 設計和實現 App Intents，讓 iOS app 動作暴露給 Shortcuts、Siri、Spotlight 和 widgets。
      - [適配 Apple Liquid Glass 視覺體系](/zh-Hant/docs/codex/official/08-scenarios/100-apple-liquid-glass): 說明如何把 SwiftUI app 遷移到 Liquid Glass，並用小步審計和驗證降低重設計風險。
      - [在 iOS 模擬器裡復現和修 Bug](/zh-Hant/docs/codex/official/08-scenarios/101-ios-simulator-bug): 說明用 Codex 除錯 iOS bug 時，如何建立 simulator loop、收集證據、修改程式碼並復現驗證。
      - [重構 SwiftUI 介面](/zh-Hant/docs/codex/official/08-scenarios/102-swiftui-refactor): 說明如何讓 Codex 拆分過大的 SwiftUI screen，在不改行為的前提下降低後續維護成本。
      - [用 Codex 反覆攻克難題](/zh-Hant/docs/codex/official/08-scenarios/103-iterate-on-problems): 說明如何把 Codex 用作可評分的改進迴圈，處理視覺、體驗和主觀質量類任務。
      - [用 Codex 學會新概念](/zh-Hant/docs/codex/official/08-scenarios/104-learn-concepts): 說明如何用 Codex 學習論文、課程和新概念，重點建立可工作的 mental model，而不是隻要摘要。
      - [搭建 Mac 應用基礎殼](/zh-Hant/docs/codex/official/08-scenarios/105-mac-app-skeleton): 基於 OpenAI 官方 Mac app shell use case，學習如何讓 Codex 先搭出真正像桌面應用的 SwiftUI 外殼。
      - [給 Mac 應用補遙測能力](/zh-Hant/docs/codex/official/08-scenarios/106-mac-telemetry): 基於官方 Codex macOS telemetry 場景教程，面向新手講清什麼時候加 OSLog、怎麼控制範圍、怎麼從日誌證明問題。
      - [精修介面細節](/zh-Hant/docs/codex/official/08-scenarios/107-ui-polish): 說明如何用 Codex-Spark 做短迴圈 UI polish：視覺 note、focused edit、browser check、再迭代。
      - [整理收件箱和待辦入口](/zh-Hant/docs/codex/official/08-scenarios/108-inbox-cleanup): 說明如何用 Codex 整理 Gmail inbox，參考寫作樣例起草回覆，並在上下文不足時補充外部資料。
      - [構建 iOS 應用](/zh-Hant/docs/codex/official/08-scenarios/109-ios-app): 說明用 Codex 做 iOS app 時的 CLI-first 路線，以及什麼時候引入 XcodeBuildMCP、skills 或外掛。
      - [構建 macOS 應用](/zh-Hant/docs/codex/official/08-scenarios/110-macos-app): 說明用 Codex 構建 macOS app 時，如何從 scene、window、menus、settings 和 desktop UX 出發。
      - [用 Codex 協調新人入職](/zh-Hant/docs/codex/official/08-scenarios/111-onboarding): 說明如何用 Codex 處理新員工入職流程：只讀盤點、stage updates、準備賬號和團隊空間。
      - [為隊友初始化工作環境](/zh-Hant/docs/codex/official/08-scenarios/112-team-setup): 說明如何把 Slack、Gmail、calendar、trackers、docs 和 code 接入 Codex，建立團隊級 signal loop。
      - [用 Computer Use 做應用驗收](/zh-Hant/docs/codex/official/08-scenarios/113-computer-use-qa): 說明用 Computer Use 做真實產品流程 QA：復現 user journeys、記錄失敗點並輸出 triage summary。
      - [讓 Codex 重構程式碼庫](/zh-Hant/docs/codex/official/08-scenarios/114-codebase-refactor): 說明如何用 Codex 小步清理工程債，包括 unused code、duplicated logic、stale abstractions 和 legacy patterns。
      - [把常用流程沉澱成 Skills](/zh-Hant/docs/codex/official/08-scenarios/115-flow-to-skills): 說明如何把反覆有效的 Codex thread、review rules、test commands 和 release checklist 沉澱成 skill。
      - [從 Slack 派發編碼任務](/zh-Hant/docs/codex/official/08-scenarios/116-slack-dispatch): 說明如何從 Slack thread 啟動 Codex cloud task，並把結果帶回執行緒或 Codex cloud 審查。
      - [讓 Codex 操作本機應用](/zh-Hant/docs/codex/official/08-scenarios/117-local-app-control): 說明 Computer Use 如何讓 Codex 操作本地 Mac app，適合沒有專用 plugin 的 GUI 任務。
    - 版本與遷移
      - [版本與遷移](/zh-Hant/docs/codex/official/09-versions): 跟蹤 Codex 遷移、演示影片和 changelog，判斷版本變化對使用方式的影響。
      - [遷移到 Codex](/zh-Hant/docs/codex/official/09-versions/66-migrate-to-codex): 說明如何用 Codex import flow 遷移其他 agent 的 instructions、configuration、skills、MCP servers 和 sessions。
      - [看官方演示影片](/zh-Hant/docs/codex/official/09-versions/119-demo-videos): 這一頁整理 Codex 官方影片入口。它適合做兩件事：
      - [檢視版本更新脈絡](/zh-Hant/docs/codex/official/09-versions/121-changelog): 用 Codex changelog 核驗版本、模型、入口、整合和安全能力的當前狀態，而不是複製靜態更新表。
- Gemini CLI
  - [Gemini CLI 中文教程](/zh-Hant/docs/gemini-cli): 基於 Google 官方文件、Google Cloud 文件和 google-gemini/gemini-cli 官方儲存庫重寫的 Gemini CLI 中文教程。
  - 從原理到實戰
    - [Gemini CLI 從原理到實戰](/zh-Hant/docs/gemini-cli/understanding): 從定位、終端任務迴圈、專案上下文、工具許可權、MCP、Skills、模型配額、Code Assist 和真實專案實戰理解 Gemini CLI。
    - [Gemini CLI 是什麼](/zh-Hant/docs/gemini-cli/understanding/01-what-is-gemini-cli): 從定位理解 Gemini CLI：它是終端裡的 Google 系 AI coding agent，不是普通聊天框，也不只是 Gemini Code Assist 的命令列殼。
    - [安裝、認證和第一次啟動](/zh-Hant/docs/gemini-cli/understanding/02-install-auth-first-run): Gemini CLI 起步流程：安裝方式、認證選擇、第一次執行和低風險只讀任務。
    - [Gemini CLI 怎麼完成一個任務](/zh-Hant/docs/gemini-cli/understanding/03-how-gemini-cli-works): 理解 Gemini CLI 的任務迴圈：上下文裝載、計劃、工具呼叫、觀察、迭代和人工確認。
    - [GEMINI.md、記憶和專案上下文](/zh-Hant/docs/gemini-cli/understanding/04-project-context-gemini-md): 用 GEMINI.md、settings.json、memory 和 .geminiignore 管理 Gemini CLI 的專案上下文。
    - [工具、Shell 和許可權邊界](/zh-Hant/docs/gemini-cli/understanding/05-tools-shell-permissions): 理解 Gemini CLI 的工具系統、Shell 執行、檔案寫入、web 工具、sandbox 和人工確認邊界。
    - [MCP 和 Extensions](/zh-Hant/docs/gemini-cli/understanding/06-mcp-extensions): 理解 Gemini CLI 如何透過 MCP 和 extensions 連線外部工具、資料來源和團隊工作流。
    - [Skills、Subagents、Hooks](/zh-Hant/docs/gemini-cli/understanding/07-skills-subagents-hooks): 理解 Gemini CLI 的三層擴充套件：Skills 負責專門流程，Subagents 負責分工，Hooks 負責生命週期攔截。
    - [Plan mode、Checkpoint、Headless](/zh-Hant/docs/gemini-cli/understanding/08-plan-checkpoint-headless): 用 Plan mode、checkpoint 和 headless mode 控制 Gemini CLI 的風險、回退和自動化。
    - [模型、配額和成本](/zh-Hant/docs/gemini-cli/understanding/09-models-quota-cost): 理解 Gemini CLI 的模型選擇、認證入口、配額、token caching 和成本控制。
    - [Code Assist、Cloud 和 GitHub Action](/zh-Hant/docs/gemini-cli/understanding/10-code-assist-cloud-github): 理解 Gemini CLI 在 Google Code Assist、Cloud Shell、Vertex AI 和 GitHub Action 工作流裡的位置。
    - [Gemini CLI vs Codex CLI vs Claude Code vs OpenCode](/zh-Hant/docs/gemini-cli/understanding/11-gemini-cli-vs-codex-claude-opencode): 橫向比較 Gemini CLI、Codex CLI、Claude Code、OpenCode 和 Cursor：定位、優勢、短板和適合承擔的工作流角色。
    - [真實專案貫穿實戰](/zh-Hant/docs/gemini-cli/understanding/12-real-project-walkthrough): 用一個真實專案流程串起 Gemini CLI：只讀掃描、上下文沉澱、計劃、修改、驗證、checkpoint、headless 和 GitHub Action。
  - 官方教程中文版
    - [Gemini CLI 官方教程中文版](/zh-Hant/docs/gemini-cli/official): 基於 Google 官方文件和 google-gemini/gemini-cli 官方儲存庫重寫的中文查詢手冊，覆蓋安裝、認證、CLI、工具、MCP、配置、模型、安全、企業和自動化。
    - 入門
      - [Gemini CLI 入門](/zh-Hant/docs/gemini-cli/official/00-getting-started): Gemini CLI 入門目錄：定位、安裝、認證、Quickstart、Cloud Shell、釋出通道、配額費用和術語表。
      - [Gemini CLI 定位](/zh-Hant/docs/gemini-cli/official/00-getting-started/00-positioning): 解釋 Gemini CLI 是什麼、它和 Gemini Code Assist / Google Cloud / IDE agent mode 的關係，以及為什麼它不只是命令列聊天框。
      - [安裝 Gemini CLI](/zh-Hant/docs/gemini-cli/official/00-getting-started/01-installation): Gemini CLI 安裝方式：npm、npx、Homebrew、Docker / Podman sandbox、原始碼執行，以及安裝後的第一輪驗收。
      - [認證方式](/zh-Hant/docs/gemini-cli/official/00-getting-started/02-authentication): Gemini CLI 認證方式：Google OAuth、Gemini API Key、Vertex AI、Workspace/組織賬號、Google Cloud Project 和 headless 場景怎麼選。
      - [Quickstart](/zh-Hant/docs/gemini-cli/official/00-getting-started/03-quickstart): Gemini CLI 第一次使用流程：安裝、認證、啟動、只讀解釋專案、處理檔案、執行測試和檢視配額。
      - [Cloud Shell 入口](/zh-Hant/docs/gemini-cli/official/00-getting-started/04-cloud-shell): Gemini CLI 在 Google Cloud Shell 和 Cloud Workstations 中的使用邊界，以及什麼時候優先用 Cloud Shell。
      - [釋出通道](/zh-Hant/docs/gemini-cli/official/00-getting-started/05-release-channels): Gemini CLI stable、preview、nightly 三個釋出通道的區別，以及普通使用者、測試使用者、貢獻者應該怎麼選。
      - [配額與費用](/zh-Hant/docs/gemini-cli/official/00-getting-started/06-quota-and-pricing): Gemini CLI 配額與費用：Google 賬號、Google AI Pro/Ultra、Gemini API Key、Vertex AI、Workspace 和 Code Assist 版本怎麼理解。
      - [Gemini CLI 術語表](/zh-Hant/docs/gemini-cli/official/00-getting-started/glossary): Gemini CLI 常見術語：ReAct、MCP、GEMINI.md、checkpoint、headless、Code Assist、Vertex AI、Cloud Shell、policy engine。
    - CLI 工作流
      - [CLI 工作流](/zh-Hant/docs/gemini-cli/official/01-cli-workflow): Gemini CLI 日常使用入口：CLI 引數、slash commands、快捷鍵、檔案管理、Shell、Web、會話、任務規劃、checkpoint 和 plan mode。
      - [CLI reference](/zh-Hant/docs/gemini-cli/official/01-cli-workflow/10-cli-reference): Gemini CLI 常用啟動方式、引數、非互動式呼叫、session resume、model、sandbox、approval mode 和輸出格式。
      - [命令系統](/zh-Hant/docs/gemini-cli/official/01-cli-workflow/11-commands): Gemini CLI 命令系統：slash commands、@ 檔案引用、! Shell 命令，以及常用 /help、/memory、/mcp、/commands、/chat、/restore。
      - [快捷鍵](/zh-Hant/docs/gemini-cli/official/01-cli-workflow/12-keyboard-shortcuts): Gemini CLI 快捷鍵和互動習慣：清屏、退出 Shell mode、複製輸出、恢復會話和降低命令列操作成本。
      - [檔案管理](/zh-Hant/docs/gemini-cli/official/01-cli-workflow/13-file-management): Gemini CLI 檔案管理：@ 檔案引用、目錄上下文、查詢檔案、修改檔案、建立檔案、diff 確認和 .geminiignore。
      - [Shell 命令](/zh-Hant/docs/gemini-cli/official/01-cli-workflow/14-shell-commands): Gemini CLI Shell 命令使用方式：! 字首、Shell mode、執行測試、後臺程序、確認提示和 sandbox。
      - [Web search / fetch](/zh-Hant/docs/gemini-cli/official/01-cli-workflow/15-web-search-fetch): Gemini CLI Web search 和 Web fetch：搜尋最新資料、讀取指定 URL、比較多個來源，並把網頁知識應用到程式碼。
      - [會話與歷史](/zh-Hant/docs/gemini-cli/official/01-cli-workflow/16-session-history): Gemini CLI 會話管理：resume、list sessions、delete session、/chat save、/chat resume、/chat share 和專案作用域。
      - [任務規劃](/zh-Hant/docs/gemini-cli/official/01-cli-workflow/17-task-planning): Gemini CLI 任務規劃：todos、planning 工具、複雜任務拆分、執行前計劃、執行中檢查和完成標準。
      - [Checkpoint 與 rewind](/zh-Hant/docs/gemini-cli/official/01-cli-workflow/18-checkpointing-rewind): Gemini CLI checkpointing、/restore、rewind 的作用：修改前儲存狀態、恢復檔案、恢復會話和降低實驗風險。
      - [Plan mode](/zh-Hant/docs/gemini-cli/official/01-cli-workflow/19-plan-mode): Gemini CLI plan mode 的用途：只讀規劃、複雜修改前方案設計、降低誤改風險，以及和 approval mode 的關係。
    - 上下文與配置
      - [上下文與配置](/zh-Hant/docs/gemini-cli/official/02-context-config): Gemini CLI 上下文與配置入口：settings、GEMINI.md、memory、.geminiignore、自定義命令、生成引數、system prompt、themes 和 trusted folders。
      - [Settings](/zh-Hant/docs/gemini-cli/official/02-context-config/20-settings): Gemini CLI settings.json 的職責、使用者級和專案級配置邊界，以及模型、工具、MCP、checkpoint、許可權等配置應該怎麼放。
      - [GEMINI.md](/zh-Hant/docs/gemini-cli/official/02-context-config/21-gemini-md): Gemini CLI GEMINI.md 專案上下文檔案的用途：長期規則、專案結構、測試命令、程式碼風格、禁止事項和層級管理。
      - [Memory management](/zh-Hant/docs/gemini-cli/official/02-context-config/22-memory-management): Gemini CLI memory management、auto memory、/memory reload 的用途，以及記憶、上下文檔案和臨時 prompt 的邊界。
      - [.geminiignore](/zh-Hant/docs/gemini-cli/official/02-context-config/23-gemini-ignore): .geminiignore 的用途：排除敏感檔案、大檔案、構建產物、本地資料庫和不希望 Gemini CLI 讀取的專案內容。
      - [Custom commands](/zh-Hant/docs/gemini-cli/official/02-context-config/24-custom-commands): Gemini CLI custom commands：把重複任務沉澱成 slash command，使用者級、專案級和 extension 命令的使用邊界。
      - [Generation settings](/zh-Hant/docs/gemini-cli/official/02-context-config/25-generation-settings): Gemini CLI generation settings：模型生成引數、temperature、thinking budget 等配置應該怎麼理解和使用。
      - [System prompt override](/zh-Hant/docs/gemini-cli/official/02-context-config/26-system-prompt): Gemini CLI system prompt override 的用途和風險：什麼時候需要替換系統指令，什麼時候應該只用 GEMINI.md 或 custom command。
      - [Themes](/zh-Hant/docs/gemini-cli/official/02-context-config/27-themes): Gemini CLI themes 的用途：終端 UI 個性化、可讀性和團隊教程截圖一致性。
      - [Trusted folders](/zh-Hant/docs/gemini-cli/official/02-context-config/28-trusted-folders): Gemini CLI trusted folders 的用途：信任當前 workspace、跳過 folder trust check 的風險，以及真實專案如何設定邊界。
    - 工具與 MCP
      - [工具與 MCP](/zh-Hant/docs/gemini-cli/official/03-tools-mcp): Gemini CLI 工具與 MCP 入口：內建工具、檔案系統、Shell、Web、todos、planning、MCP server/resources 和 extensions。
      - [工具總覽](/zh-Hant/docs/gemini-cli/official/03-tools-mcp/30-tools-overview): Gemini CLI 工具系統總覽：內建工具、MCP、extensions、policy engine 和許可權確認的關係。
      - [檔案系統工具](/zh-Hant/docs/gemini-cli/official/03-tools-mcp/31-file-system-tool): Gemini CLI 檔案系統工具的使用邊界：讀取、搜尋、寫入、替換、diff 確認、.geminiignore 和敏感檔案排除。
      - [Shell 工具](/zh-Hant/docs/gemini-cli/official/03-tools-mcp/32-shell-tool): Gemini CLI Shell 工具的使用邊界：執行測試、構建、Git、後臺程序、確認提示、sandbox 和危險命令。
      - [Web 工具](/zh-Hant/docs/gemini-cli/official/03-tools-mcp/33-web-tools): Gemini CLI Web search 和 web fetch 工具的職責邊界：搜尋最新資料、讀取指定 URL、引用官方來源和避免社群誤導。
      - [Todos / Planning 工具](/zh-Hant/docs/gemini-cli/official/03-tools-mcp/34-todos-planning-tools): Gemini CLI todos 和 planning 工具的用途：拆解複雜任務、跟蹤進度、避免長任務失控。
      - [MCP 設定](/zh-Hant/docs/gemini-cli/official/03-tools-mcp/35-mcp-setup): Gemini CLI MCP 設定方式：settings.json、環境變數、stdio/HTTP/SSE server、認證和最小許可權原則。
      - [MCP server](/zh-Hant/docs/gemini-cli/official/03-tools-mcp/36-mcp-server): Gemini CLI MCP server 管理：stdio、HTTP、SSE、header、環境變數、啟停、reload、OAuth auth 和工具列表。
      - [MCP resources](/zh-Hant/docs/gemini-cli/official/03-tools-mcp/37-mcp-resources): Gemini CLI MCP resources 的用途：讓外部系統提供可讀資源、上下文和工具後設資料，並和普通工具呼叫區分。
      - [Extensions](/zh-Hant/docs/gemini-cli/official/03-tools-mcp/38-extensions): Gemini CLI extensions：安裝、啟用、停用、更新、link、本地開發、驗證和與 MCP/Skills 的邊界。
    - Agents & Skills
      - [Agents & Skills](/zh-Hant/docs/gemini-cli/official/04-agents-skills): Gemini CLI Agents & Skills 入口：Agent Skills、建立 skill、最佳實踐、啟用 skill、subagents 和 remote agents。
      - [Agent Skills](/zh-Hant/docs/gemini-cli/official/04-agents-skills/40-agent-skills): Gemini CLI Agent Skills 的用途：為特定任務載入專門能力、流程、約束和上下文。
      - [建立 Skills](/zh-Hant/docs/gemini-cli/official/04-agents-skills/41-create-skills): Gemini CLI 建立 Agent Skill 的判斷標準：什麼時候應該沉澱、結構如何保持小、如何避免把一次性任務過度工程化。
      - [Skills 最佳實踐](/zh-Hant/docs/gemini-cli/official/04-agents-skills/42-skills-best-practices): Gemini CLI Agent Skills 最佳實踐：觸發清晰、輸入輸出固定、少依賴、避免硬編碼憑據、失敗路徑明確。
      - [啟用 Skill](/zh-Hant/docs/gemini-cli/official/04-agents-skills/43-activate-skill): Gemini CLI 啟用 Agent Skill 的方式、技能發現、reload、enable/disable 和驗證是否真正生效。
      - [Subagents](/zh-Hant/docs/gemini-cli/official/04-agents-skills/44-subagents): Gemini CLI Subagents 的用途：專門角色、任務分工、模型配置、啟用停用和適用邊界。
      - [Remote agents](/zh-Hant/docs/gemini-cli/official/04-agents-skills/45-remote-agents): Gemini CLI Remote agents 的用途：連線遠端 agent、跨環境協作、遠端能力邊界和安全注意事項。
    - 模型與執行時
      - [模型與執行時](/zh-Hant/docs/gemini-cli/official/05-models-runtime): Gemini CLI 模型與執行時入口：Gemini 3、模型選擇、模型路由、本地模型、token caching 和 ACP mode。
      - [Gemini 3](/zh-Hant/docs/gemini-cli/official/05-models-runtime/50-gemini-3): Gemini CLI 中 Gemini 3 支援的定位、上下文、推理能力和使用注意事項。
      - [模型選擇](/zh-Hant/docs/gemini-cli/official/05-models-runtime/51-model-selection): Gemini CLI 模型選擇：--model、auto/pro/flash/flash-lite alias，以及按任務複雜度選擇模型。
      - [模型路由](/zh-Hant/docs/gemini-cli/official/05-models-runtime/52-model-routing): Gemini CLI model routing 的用途：自動 fallback、提升穩定性、處理模型不可用或預覽模型變化。
      - [本地模型路由](/zh-Hant/docs/gemini-cli/official/05-models-runtime/53-local-model-routing): Gemini CLI local model routing 的使用場景：本地模型、隱私、離線/半離線環境、效能和能力邊界。
      - [Token caching](/zh-Hant/docs/gemini-cli/official/05-models-runtime/54-token-caching): Gemini CLI token caching 的作用：減少重複上下文成本、提升長任務效能，以及使用前需要理解的邊界。
      - [ACP mode](/zh-Hant/docs/gemini-cli/official/05-models-runtime/55-acp-mode): Gemini CLI ACP mode 的定位：實驗性 agent/editor 協議模式、適用場景和風險邊界。
    - 安全與企業
      - [安全與企業](/zh-Hant/docs/gemini-cli/official/06-security-enterprise): Gemini CLI 安全與企業入口：sandbox、policy engine、企業配置、企業控制、telemetry、terms/privacy 和 Google Cloud 安全合規。
      - [Sandbox](/zh-Hant/docs/gemini-cli/official/06-security-enterprise/60-sandbox): Gemini CLI sandbox 的用途：隔離工具執行、降低不可信程式碼風險、Docker sandbox 和 --sandbox 使用邊界。
      - [Policy engine](/zh-Hant/docs/gemini-cli/official/06-security-enterprise/61-policy-engine): Gemini CLI policy engine 的用途：細粒度控制工具執行、替代簡單 allowed tools、適合團隊和企業治理。
      - [Enterprise config](/zh-Hant/docs/gemini-cli/official/06-security-enterprise/62-enterprise-config): Gemini CLI enterprise configuration：組織賬號、Cloud project、Vertex AI、許可、固定策略和團隊預設配置。
      - [Enterprise controls](/zh-Hant/docs/gemini-cli/official/06-security-enterprise/63-enterprise-controls): Gemini CLI enterprise controls：企業控制項、管理員策略、團隊使用邊界和落地前檢查清單。
      - [Telemetry](/zh-Hant/docs/gemini-cli/official/06-security-enterprise/64-telemetry): Gemini CLI telemetry 的用途：使用和效能指標、團隊可觀測性、隱私邊界和企業環境檢查。
      - [Terms and privacy](/zh-Hant/docs/gemini-cli/official/06-security-enterprise/65-terms-privacy): Gemini CLI terms and privacy：不同認證方式、Google 賬號、API Key、Vertex AI、Code Assist 下的資料和條款邊界。
      - [Cloud security/privacy/compliance](/zh-Hant/docs/gemini-cli/official/06-security-enterprise/66-cloud-security-privacy): Gemini CLI 在 Google Cloud 與 Gemini Code Assist Standard/Enterprise 場景下的安全、隱私和合規邊界。
    - 整合與自動化
      - [整合與自動化](/zh-Hant/docs/gemini-cli/official/07-integrations-automation): Gemini CLI 整合與自動化入口：IDE companion、hooks、headless mode、指令碼自動化、GitHub Action、Issue/PR 自動化和本地開發。
      - [IDE 整合](/zh-Hant/docs/gemini-cli/official/07-integrations-automation/70-ide-integration): Gemini CLI IDE 整合：VS Code companion extension、/ide 命令、原生 diff、ACP 與 JetBrains/Zed 這類 ACP 客戶端。
      - [Hooks](/zh-Hant/docs/gemini-cli/official/07-integrations-automation/71-hooks): Gemini CLI hooks 的事件、配置、JSON I/O、退出碼、安全邊界和管理命令。
      - [Headless mode](/zh-Hant/docs/gemini-cli/official/07-integrations-automation/72-headless-mode): Gemini CLI headless mode：用 -p/--prompt、非 TTY、JSON/JSONL 輸出和退出碼把 CLI 接入指令碼。
      - [自動化指令碼](/zh-Hant/docs/gemini-cli/official/07-integrations-automation/73-automation): Gemini CLI 自動化指令碼：管道輸入、批次生成文件、JSON 提取和 smart commit 這類 shell 封裝。
      - [GitHub Action](/zh-Hant/docs/gemini-cli/official/07-integrations-automation/74-github-action): run-gemini-cli GitHub Action：在儲存庫裡接入 Gemini CLI，支援 PR review、issue triage、按評論觸發和定時任務。
      - [Issue 與 PR 自動化](/zh-Hant/docs/gemini-cli/official/07-integrations-automation/75-issue-pr-automation): Gemini CLI 官方儲存庫自動化流程：issue triage、CI、PR label sync、scheduled triage、release automation。
      - [本地開發](/zh-Hant/docs/gemini-cli/official/07-integrations-automation/76-local-development): Gemini CLI 本地開發入口：原始碼安裝、monorepo package、NPM workspace、build/test 與釋出相關概念。
    - 故障排查與參考
      - [故障排查與參考](/zh-Hant/docs/gemini-cli/official/08-troubleshooting-reference): Gemini CLI 故障排查與參考入口：FAQ、登入錯誤、常見報錯、解除安裝、release notes 和 npm package 結構。
      - [FAQ](/zh-Hant/docs/gemini-cli/official/08-troubleshooting-reference/80-faq): Gemini CLI 常見問題：第三方 OAuth piggyback 風險、429 配額、ESM 錯誤、快取 token、版本檢查和安全儲存 API key。
      - [故障排查](/zh-Hant/docs/gemini-cli/official/08-troubleshooting-reference/81-troubleshooting): Gemini CLI 常見故障排查：認證錯誤、地區限制、證書、PATH、MCP 埠、sandbox 許可權、CI 環境和退出碼。
      - [解除安裝](/zh-Hant/docs/gemini-cli/official/08-troubleshooting-reference/82-uninstall): Gemini CLI 解除安裝方式：npx cache、npm global、Homebrew 和 MacPorts。
      - [Release notes](/zh-Hant/docs/gemini-cli/official/08-troubleshooting-reference/83-release-notes): Gemini CLI release notes：stable、preview、nightly 三個渠道，以及如何根據風險選擇版本。
      - [NPM package](/zh-Hant/docs/gemini-cli/official/08-troubleshooting-reference/84-npm-package): Gemini CLI NPM package 結構：@google/gemini-cli、@google/gemini-cli-core、workspace 與釋出包邊界。
- GitHub Copilot
  - [GitHub Copilot 中文教程](/zh-Hant/docs/github-copilot): 基於 GitHub Docs 和 VS Code 官方資料重寫的 Copilot 中文教程，覆蓋 IDE、CLI、Cloud Agent、MCP 和企業治理。
  - 從原理到實戰
    - [GitHub Copilot 從原理到實戰](/zh-Hant/docs/github-copilot/understanding): 用 12 篇文章建立 GitHub Copilot 的完整認知，從入口地圖、上下文、Agent Mode 到團隊治理。
    - [01 · GitHub Copilot 是什麼](/zh-Hant/docs/github-copilot/understanding/01-what-is-github-copilot): 解釋 Copilot 為什麼不是單一補全外掛，而是一套覆蓋 IDE、GitHub、CLI、Cloud Agent 和團隊治理的開發工作流。
    - [02 · Copilot 和 Claude Code、Codex、Cursor 怎麼選](/zh-Hant/docs/github-copilot/understanding/02-copilot-vs-claude-code-codex-cursor): 用工作位置、任務形態、團隊治理和驗收證據比較 GitHub Copilot、Claude Code、Codex 與 Cursor。
    - [03 · Copilot 的入口地圖](/zh-Hant/docs/github-copilot/understanding/03-copilot-surfaces-map): 梳理 GitHub Copilot 在 GitHub.com、VS Code、IDE Chat、Windows Terminal、CLI、Mobile 和 Cloud Agent 中的分工。
    - [04 · 從補全到 Agent Mode](/zh-Hant/docs/github-copilot/understanding/04-from-autocomplete-to-agent): 解釋 Copilot 如何從 inline suggestion 演進到 Chat、Agent Mode、Cloud Agent 和 PR 自動化。
    - [05 · Copilot 的上下文工程](/zh-Hant/docs/github-copilot/understanding/05-context-engineering-for-copilot): 解釋儲存庫索引、開啟檔案、選擇上下文、Spaces、MCP 和自定義指令如何影響 Copilot 輸出質量。
    - [06 · VS Code Agent Mode 怎麼用](/zh-Hant/docs/github-copilot/understanding/06-agent-mode-in-vscode): 講清 VS Code Agent Mode 如何計劃、改檔案、呼叫工具、執行命令，並在本地工作區裡接受審查。
    - [07 · Cloud Agent 到 PR 的閉環](/zh-Hant/docs/github-copilot/understanding/07-cloud-agent-pr-loop): 解釋 Cloud Agent 如何從 prompt 或 issue 出發，研究儲存庫、建分支、改程式碼、給出 diff 並進入 PR 審查。
    - [08 · Copilot CLI 工作流](/zh-Hant/docs/github-copilot/understanding/08-copilot-cli-workflow): 說明 Copilot CLI 適合終端委派、遠端 steering、回復、自動化和與 Cloud Agent 協作的場景。
    - [09 · 指令、Skills、Hooks 怎麼分工](/zh-Hant/docs/github-copilot/understanding/09-custom-instructions-rules-skills-hooks): 解釋個人、儲存庫、組織指令，prompt files、agent skills、hooks、plugins 在 Copilot 體系裡的職責邊界。
    - [10 · Copilot 和 MCP 怎麼接](/zh-Hant/docs/github-copilot/understanding/10-mcp-with-copilot): 解釋 MCP 什麼時候值得接入 Copilot，如何把 GitHub、資料庫、文件、監控和內部工具變成上下文來源。
    - [11 · 團隊上線前的安全和治理](/zh-Hant/docs/github-copilot/understanding/11-security-admin-billing): 從內容排除、訪問控制、模型策略、用量、計費、指標和審計角度解釋 Copilot 團隊 rollout。
    - [12 · 真實團隊工作流](/zh-Hant/docs/github-copilot/understanding/12-real-team-workflows): 給出 TDD、程式碼審查、PR 摘要、issue 到 PR、文件維護和遷移任務六種 Copilot 實戰用法。
  - 官方教程中文版
    - [GitHub Copilot 官方教程中文版](/zh-Hant/docs/github-copilot/official): 按 GitHub Docs 和 VS Code Docs 重寫的中文查詢手冊，覆蓋入門、IDE、Agent、CLI、MCP、治理和 SDK。
    - 入門與定位
      - [入門與定位](/zh-Hant/docs/github-copilot/official/00-getting-started): GitHub Copilot 入門與定位中文查詢手冊，按官方事實整理關鍵入口、配置和邊界。
      - [Copilot 是什麼](/zh-Hant/docs/github-copilot/official/00-getting-started/what-is-github-copilot): 從 GitHub 官方定義出發，解釋 Copilot 的產品邊界、入口、適用角色和第一天使用順序。
      - [計劃與可用功能](/zh-Hant/docs/github-copilot/official/00-getting-started/plans): 說明 Copilot Free、Student、Pro、Pro+、Business、Enterprise 的選擇邊界，以及 2026 年註冊和計費變更。
      - [功能總覽](/zh-Hant/docs/github-copilot/official/00-getting-started/features): 按 assistive、agentic、customization、administrator 四類梳理 Copilot 功能，並給出學習順序。
      - [快速開始](/zh-Hant/docs/github-copilot/official/00-getting-started/quickstart): 從賬號計劃、使用入口、第一次 Chat、第一次 inline suggestion 和低風險驗收跑通 GitHub Copilot。
    - 入口與使用場景
      - [入口與使用場景](/zh-Hant/docs/github-copilot/official/01-surfaces): 按 GitHub Copilot 官方入口梳理 GitHub.com、VS Code、IDE Chat、Windows Terminal、CLI 和 Cloud Agent 的使用邊界。
      - [GitHub.com 上的 Copilot](/zh-Hant/docs/github-copilot/official/01-surfaces/github-com): 說明 GitHub 網站中的 Copilot Chat 如何圍繞儲存庫、檔案、PR、issue、security alert、dashboard 和搜尋框工作。
      - [VS Code 中的 Copilot](/zh-Hant/docs/github-copilot/official/01-surfaces/vscode): 說明 VS Code Copilot 的 agents、Plan、Sessions、inline suggestions、inline chat、smart actions、customization 和安全邊界。
      - [IDE Chat 工作流](/zh-Hant/docs/github-copilot/official/01-surfaces/ide-chat): 解釋 GitHub Copilot Chat 在 IDE 中的提示詞、上下文關鍵詞、Plan mode、Agent mode、MCP、模型和審查邊界。
      - [Windows Terminal 中的 Copilot](/zh-Hant/docs/github-copilot/official/01-surfaces/windows-terminal): 說明 Windows Terminal Chat 中 Copilot 的前提、命令解釋、shell 上下文、插入命令、組織策略和安全邊界。
    - 補全與 Chat
      - [補全與 Chat](/zh-Hant/docs/github-copilot/official/02-code-suggestions-and-chat): 按 GitHub 官方文件梳理 Copilot 程式碼建議、程式碼引用、提示詞寫法和響應定製的使用邊界。
      - [程式碼建議](/zh-Hant/docs/github-copilot/official/02-code-suggestions-and-chat/code-suggestions): 解釋 GitHub Copilot 在 IDE 中的 ghost text、next edit suggestions、替代建議、區域性接受和模型邊界。
      - [程式碼引用與匹配](/zh-Hant/docs/github-copilot/official/02-code-suggestions-and-chat/code-referencing): 說明 GitHub Copilot 程式碼引用如何處理公開程式碼匹配、來源日誌、許可證和團隊審查邊界。
      - [提示詞寫法](/zh-Hant/docs/github-copilot/official/02-code-suggestions-and-chat/prompt-engineering): 把 GitHub Copilot Chat 提示詞拆成目標、上下文、例子、約束、迭代和驗收標準。
      - [響應定製](/zh-Hant/docs/github-copilot/official/02-code-suggestions-and-chat/response-customization): 說明 GitHub Copilot custom instructions、prompt files、AGENTS.md 類檔案和優先順序如何影響回答。
    - VS Code Agent Mode
      - [VS Code Agent Mode](/zh-Hant/docs/github-copilot/official/03-vscode-agent-mode): 按 VS Code 與 GitHub 官方文件梳理本地 agent、Plan、工具許可權和程式碼修改審查。
      - [Agent Mode 總覽](/zh-Hant/docs/github-copilot/official/03-vscode-agent-mode/agents-overview): 說明 VS Code agents 的型別、Ask Plan Agent 分工、許可權級別、handoff 和團隊使用邊界。
      - [計劃模式](/zh-Hant/docs/github-copilot/official/03-vscode-agent-mode/planning): 解釋 VS Code Plan agent 如何在寫程式碼前研究任務、提出計劃、追問開放問題並交給 implementation agent。
      - [Agent 工具](/zh-Hant/docs/github-copilot/official/03-vscode-agent-mode/agent-tools): 說明 VS Code agent 的 built-in tools、MCP tools、extension tools、工具選擇、批准和信任邊界。
      - [審查程式碼修改](/zh-Hant/docs/github-copilot/official/03-vscode-agent-mode/review-code-edits): 說明 VS Code pending edits、inline review、Keep Undo、檔案級批次操作和 Source Control 審查流程。
    - Cloud Agent
      - [Cloud Agent](/zh-Hant/docs/github-copilot/official/04-cloud-agent): 按 GitHub 官方文件梳理 Copilot cloud agent 的啟動、研究計劃、迭代、PR 審查和 Actions 安全邊界。
      - [Cloud Agent 是什麼](/zh-Hant/docs/github-copilot/official/04-cloud-agent/about-cloud-agent): 解釋 Copilot cloud agent 的能力、臨時開發環境、可用範圍、適合任務和審查邊界。
      - [啟動任務](/zh-Hant/docs/github-copilot/official/04-cloud-agent/kick-off-a-task): 說明從 issue、Agents tab、prompt、repository seed、IDE 和 Chat 啟動 Copilot cloud agent 任務的方式。
      - [研究、計劃和迭代](/zh-Hant/docs/github-copilot/official/04-cloud-agent/research-plan-iterate): 說明 Copilot cloud agent 如何先研究儲存庫、生成計劃、在 branch 上迭代程式碼，再建立 pull request。
      - [審查輸出](/zh-Hant/docs/github-copilot/official/04-cloud-agent/review-output): 說明如何審查 Copilot cloud agent 的 pull request、diff、Actions、merge conflicts 和 follow-up comments。
    - Copilot CLI
      - [Copilot CLI](/zh-Hant/docs/github-copilot/official/05-copilot-cli): 按 GitHub 官方文件梳理 Copilot CLI 的安裝認證、許可權配置、任務委派、回復和 PR 工作流。
      - [Copilot CLI 是什麼](/zh-Hant/docs/github-copilot/official/05-copilot-cli/about-copilot-cli): 說明 GitHub Copilot CLI 的互動和非互動模式、Plan、自動上下文、定製、模型和安全邊界。
      - [安裝、認證和配置](/zh-Hant/docs/github-copilot/official/05-copilot-cli/install-auth-config): 把 GitHub Copilot CLI 安裝、/login、trusted directories、tool allow-deny、path URL 許可權和 LSP 接入串成閉環。
      - [委派任務](/zh-Hant/docs/github-copilot/official/05-copilot-cli/delegate-tasks): 區分 GitHub Copilot CLI 的本地 autopilot 和 /delegate 到 cloud agent，並說明許可權、checkpoint 和 PR 邊界。
      - [回復和 PR 管理](/zh-Hant/docs/github-copilot/official/05-copilot-cli/rollback-pr): 說明 Copilot CLI snapshot、雙 Esc、/undo、/rewind、驗證回復和 PR 審查鏈路。
    - 上下文與定製
      - [上下文與定製](/zh-Hant/docs/github-copilot/official/06-context-customization): 按 GitHub 與 VS Code 官方文件梳理 Copilot instructions、prompt files、skills、hooks、plugins 和組織規則。
      - [儲存庫自定義指令](/zh-Hant/docs/github-copilot/official/06-context-customization/repository-instructions): 說明 Copilot repository instructions、path-specific instructions、AGENTS.md 和 references 驗證方式。
      - [個人和組織指令](/zh-Hant/docs/github-copilot/official/06-context-customization/personal-org-instructions): 解釋 Copilot personal、repository、organization instructions 的職責、優先順序、適用範圍和治理邊界。
      - [Prompt Files](/zh-Hant/docs/github-copilot/official/06-context-customization/prompt-files): 把重複的 Copilot Chat 任務沉澱成可呼叫、可審查、可維護的 .prompt.md 檔案。
      - [Skills、Hooks、Plugins](/zh-Hant/docs/github-copilot/official/06-context-customization/skills-hooks-plugins): 區分 Copilot skills、hooks 和 plugins：哪些是能力包，哪些是生命週期控制，哪些是分發載體。
    - MCP 與外部工具
      - [MCP 與外部工具](/zh-Hant/docs/github-copilot/official/07-mcp): 把 GitHub MCP Server、IDE MCP 配置、toolsets、registry 和企業部署邊界串成可落地流程。
      - [MCP 是什麼](/zh-Hant/docs/github-copilot/official/07-mcp/mcp-concept): 解釋 Model Context Protocol 如何把外部系統接入 Copilot，並給出安全接入判斷。
      - [GitHub MCP Server](/zh-Hant/docs/github-copilot/official/07-mcp/github-mcp-server): 配置和使用 GitHub 官方維護的 MCP server，讓 Copilot 讀取和操作 GitHub 上下文。
      - [用 MCP 擴充套件 Chat](/zh-Hant/docs/github-copilot/official/07-mcp/extend-chat-with-mcp): 在 IDE 中配置 MCP server，讓 Copilot Agent mode 讀取外部工具、資源和預設 prompts。
      - [企業 MCP 配置](/zh-Hant/docs/github-copilot/official/07-mcp/enterprise-mcp): 說明 GHEC data residency、GHES、本地 server、toolsets、registry 和組織策略的 MCP 治理邊界。
    - 安全、治理與計費
      - [安全、治理與計費](/zh-Hant/docs/github-copilot/official/08-security-governance): 把 Copilot 內容排除、訪問策略、模型控制、premium requests、用量指標和 rollout 覆盤連成治理閉環。
      - [內容排除](/zh-Hant/docs/github-copilot/official/08-security-governance/content-exclusion): 說明 GitHub Copilot 內容排除能保護什麼、不能保護什麼，以及如何配置、測試和審計。
      - [訪問和策略](/zh-Hant/docs/github-copilot/official/08-security-governance/access-policies): 解釋組織和企業如何用 Copilot feature、privacy、model policies 控制功能、模型和成本邊界。
      - [用量和計費](/zh-Hant/docs/github-copilot/official/08-security-governance/usage-billing): 說明 request、premium request、allowance、budget、billing entity 和 GitHub 2026 usage-based billing 遷移邊界。
      - [指標和採用情況](/zh-Hant/docs/github-copilot/official/08-security-governance/metrics): 說明 Copilot usage metrics 的 adoption、engagement、acceptance、LoC、PR lifecycle 口徑，以及 rollout 覆盤方式。
    - SDK 與自定義 Agent
      - [SDK 與自定義 Agent](/zh-Hant/docs/github-copilot/official/09-sdk-and-custom-agents): 按 GitHub 官方 SDK 文件梳理 Copilot SDK、custom agents、hooks 和 OpenTelemetry 可觀測性。
      - [Copilot SDK 入門](/zh-Hant/docs/github-copilot/official/09-sdk-and-custom-agents/sdk-getting-started): 說明 Copilot SDK 的 public preview 邊界、認證方式、安裝、session、sendAndWait 和 streaming。
      - [自定義 Agent](/zh-Hant/docs/github-copilot/official/09-sdk-and-custom-agents/custom-agents): 解釋 Copilot SDK custom agents、sub-agent delegation、工具隔離、MCP 繫結和失敗處理。
      - [SDK Hooks](/zh-Hant/docs/github-copilot/official/09-sdk-and-custom-agents/sdk-hooks): 說明 Copilot SDK hooks 如何控制工具執行、修改結果、注入上下文、處理錯誤和審計互動。
      - [可觀測性](/zh-Hant/docs/github-copilot/official/09-sdk-and-custom-agents/observability): 說明 Copilot SDK 的 OpenTelemetry 支援、trace context 傳播、tool spans 和生產化觀測清單。
    - 實戰工作流
      - [實戰工作流](/zh-Hant/docs/github-copilot/official/10-practical-playbooks): 把 GitHub Copilot 的官方能力落成 TDD、程式碼審查、PR 摘要和團隊上線的可複用劇本。
      - [TDD 工作流](/zh-Hant/docs/github-copilot/official/10-practical-playbooks/tdd-with-copilot): 用 Copilot 輔助 Red / Green / Refactor：先寫失敗測試，再做最小實現，最後重構並保持測試透過。
      - [程式碼審查工作流](/zh-Hant/docs/github-copilot/official/10-practical-playbooks/code-review): 用 GitHub Copilot 做 review 預篩、建議修復和風險歸納，同時保留人工 reviewer 的最終責任。
      - [PR 摘要工作流](/zh-Hant/docs/github-copilot/official/10-practical-playbooks/pr-summary): 用 GitHub Copilot 生成 PR 摘要草稿，再由作者補齊背景、風險、測試和回復。
      - [團隊上線清單](/zh-Hant/docs/github-copilot/official/10-practical-playbooks/team-rollout): 按目標、試點、策略、內容排除、計費、培訓、指標和回復推進 GitHub Copilot 團隊 rollout。
- Cursor
  - [Cursor 中文教程](/zh-Hant/docs/cursor): 基於 Cursor 官方文件、Help Center 和 llms.txt 重寫的 Cursor 中文教程。
  - 從原理到實戰
    - [Cursor 從原理到實戰](/zh-Hant/docs/cursor/understanding): 按中文開發者真實使用順序組織的 Cursor 工作流教程。
    - [Cursor 是什麼](/zh-Hant/docs/cursor/understanding/01-what-is-cursor): 從產品定位理解 Cursor：AI editor、coding agent 和真實專案工作臺。
    - [安裝、遷移和第一個專案](/zh-Hant/docs/cursor/understanding/02-install-migrate-first-project): 從下載安裝到遷移 VS Code / JetBrains，再用低風險專案跑通 Cursor 第一天閉環。
    - [Cursor Agent 如何工作](/zh-Hant/docs/cursor/understanding/03-how-cursor-agent-works): 理解 instructions、tools、model、checkpoints、queued messages 和模式選擇。
    - [Agent、Plan、Ask、Debug、Tab 怎麼分工](/zh-Hant/docs/cursor/understanding/04-agent-plan-ask-debug-tab): 把 Cursor 的幾類 AI 入口按風險和任務階段分清，不把所有問題都丟給 Agent。
    - [上下文、索引和 Rules](/zh-Hant/docs/cursor/understanding/05-context-indexing-rules): 讓 Cursor 真的理解專案：索引負責事實，Rules 負責長期約束，prompt 負責本次目標。
    - [MCP、工具、瀏覽器和終端](/zh-Hant/docs/cursor/understanding/06-mcp-tools-browser-terminal): 理解 Cursor Agent 的工具層：MCP 接外部系統，Browser 驗 UI，Terminal 跑命令。
    - [Skills、Subagents、Hooks](/zh-Hant/docs/cursor/understanding/07-skills-subagents-hooks): 把 Cursor 從一次性會話升級成可複用、可分工、可治理的工作流系統。
    - [Cursor CLI 與 Headless 自動化](/zh-Hant/docs/cursor/understanding/08-cli-headless-automation): 把 Cursor Agent 從編輯器帶到終端、指令碼、CI 和受控自動化。
    - [Cloud Agent、Bugbot 和 Review](/zh-Hant/docs/cursor/understanding/09-cloud-agent-bugbot-review): 把 Cursor 放進非同步任務、PR 審查、安全審查和團隊交付流程。
    - [模型、價格和用量](/zh-Hant/docs/cursor/understanding/10-models-pricing-usage): 不要背模型表。按任務複雜度、上下文規模、速度、成本和團隊策略選擇 Cursor 模型。
    - [Cursor 和 Codex、Claude Code、Windsurf、Copilot 怎麼選](/zh-Hant/docs/cursor/understanding/11-cursor-vs-codex-claude-windsurf-copilot): 用工作流位置比較 AI 程式設計工具，不做空泛排名。
    - [一個真實專案裡的 Cursor 工作流](/zh-Hant/docs/cursor/understanding/12-real-project-workflow): 把 Cursor 用在真實專案：只讀理解、計劃、小步修改、驗證、審查、沉澱規則。
  - 官方教程中文版
    - [Cursor 官方教程中文版](/zh-Hant/docs/cursor/official): 按 Cursor 官方 Docs、Help Center、CLI 和企業文件重組的中文查詢手冊。
    - 入門、安裝與模型
      - [入門、安裝與模型](/zh-Hant/docs/cursor/official/00-getting-started): Cursor 入門層：產品定位、快速開始、安裝遷移、模型用量和外掛邊界。
      - [Cursor 產品定位](/zh-Hant/docs/cursor/official/00-getting-started/00-cursor-positioning): 從 Cursor 官方文件理解它為什麼是 AI editor and coding agent，而不是普通 IDE 外掛。
      - [快速開始](/zh-Hant/docs/cursor/official/00-getting-started/01-quickstart): 按 Cursor 官方 Quickstart，從安裝登入到第一次解釋程式碼庫、小改動、diff review 和 Plan Mode。
      - [安裝與遷移](/zh-Hant/docs/cursor/official/00-getting-started/02-install-and-migrate): 從 Cursor 官方安裝、VS Code 遷移和 JetBrains 遷移文件梳理安全遷移路徑。
      - [模型、價格與用量](/zh-Hant/docs/cursor/official/00-getting-started/03-models-pricing): 基於 Cursor 官方 Models & Pricing 文件解釋 usage pools、Auto、Composer、API pool、Max Mode 和團隊計費邊界。
      - [外掛與 Marketplace](/zh-Hant/docs/cursor/official/00-getting-started/04-plugins-marketplace): 基於 Cursor 官方 Plugins 和 Extensions 文件解釋外掛、擴充套件、團隊 marketplace、required 外掛和安全邊界。
    - Agent 工作流
      - [Agent 工作流](/zh-Hant/docs/cursor/official/01-agent-workflow): Agent 工作流相關的 Cursor 官方教程中文版。
      - [Agent 總覽](/zh-Hant/docs/cursor/official/01-agent-workflow/10-agent-overview): 基於 Cursor 官方 Agent 文件解釋 instructions、tools、model、checkpoints、queue 和模式選擇。
      - [Agents Window](/zh-Hant/docs/cursor/official/01-agent-workflow/11-agents-window): 基於 Cursor 官方 Agents Window 文件解釋 agent-first 視窗、多工作區、並行 Agent、diff、cloud/local handoff 和 worktrees。
      - [Plan Mode](/zh-Hant/docs/cursor/official/01-agent-workflow/12-plan-mode): 基於 Cursor 官方 Plan Mode 文件解釋先研究、提問、生成計劃、審查編輯，再批准構建的流程。
      - [Prompting](/zh-Hant/docs/cursor/official/01-agent-workflow/13-prompting): 基於 Cursor 官方 Prompting Agents 文件解釋 @ mentions、圖片、語音、context ring、上下文壓縮和模型切換。
      - [Debug Mode](/zh-Hant/docs/cursor/official/01-agent-workflow/14-debug-mode): 基於 Cursor 官方 Debug Mode 文件解釋假設、插樁、復現、日誌分析、精準修復和清理流程。
      - [Agent Review](/zh-Hant/docs/cursor/official/01-agent-workflow/15-agent-review): 基於 Cursor 官方 Agent Review 文件解釋本地變更審查、自動觸發、slash command、Source Control 和 review depth。
      - [Terminal Tool](/zh-Hant/docs/cursor/official/01-agent-workflow/16-terminal-tool): 基於 Cursor 官方 Terminal 文件解釋 Agent 執行 shell commands、sandbox、allowlist、平臺要求和 sandbox.json。
      - [Browser Tool](/zh-Hant/docs/cursor/official/01-agent-workflow/17-browser-tool): 基於 Cursor 官方 Browser 文件解釋瀏覽器驗證、console、network、設計側欄、approval 和企業 allowlist。
      - [Search Tool](/zh-Hant/docs/cursor/official/01-agent-workflow/18-search-tool): 基於 Cursor 官方 Semantic & Agentic Search 文件解釋 Instant Grep、semantic search、indexing、privacy 和 Explore subagent。
      - [Canvas Tool](/zh-Hant/docs/cursor/official/01-agent-workflow/19-canvas-tool): 基於 Cursor 官方 Canvases 文件解釋互動式 artifact、開啟方式、迭代方式和 Skill 打包。
      - [Worktrees](/zh-Hant/docs/cursor/official/01-agent-workflow/20-worktrees): 基於 Cursor 官方 Worktrees 文件解釋 Agents Window worktrees、.cursor/worktrees.json、清理和 /worktree /best-of-n。
      - [Agent 安全邊界](/zh-Hant/docs/cursor/official/01-agent-workflow/21-agent-security): 基於 Cursor 官方 Agent Security 和 Privacy 文件解釋審批、.cursorignore、allowlist、MCP、網路、workspace trust 和 Privacy Mode。
    - 上下文與定製
      - [上下文與定製](/zh-Hant/docs/cursor/official/02-context-customization): 上下文與定製相關的 Cursor 官方教程中文版。
      - [Rules](/zh-Hant/docs/cursor/official/02-context-customization/20-rules): 基於 Cursor 官方 Rules 文件解釋 Project、User、Team Rules、AGENTS.md、frontmatter、globs 和規則最佳實踐。
      - [MCP](/zh-Hant/docs/cursor/official/02-context-customization/21-mcp): 基於 Cursor 官方 MCP 文件解釋 transports、mcp.json、OAuth、config interpolation、tool approval 和 Cloud Agents。
      - [Skills](/zh-Hant/docs/cursor/official/02-context-customization/22-skills): 基於 Cursor 官方 Skills 文件解釋 skill directories、SKILL.md、frontmatter、paths、scripts 和遷移到 skills。
      - [Subagents](/zh-Hant/docs/cursor/official/02-context-customization/23-subagents): 基於 Cursor 官方 Subagents 文件解釋上下文隔離、並行執行、內建 subagents、自定義檔案、欄位和呼叫方式。
      - [Hooks](/zh-Hant/docs/cursor/official/02-context-customization/24-hooks): 基於 Cursor 官方 Hooks 文件解釋 agent loop hook、事件、配置路徑、command hooks、prompt hooks 和 exit code。
      - [Plugins](/zh-Hant/docs/cursor/official/02-context-customization/25-plugins): 基於 Cursor 官方 Plugins 文件解釋外掛元件、Marketplace、團隊分發、安裝管理、本地測試和釋出審查。
    - CLI 與自動化
      - [CLI 與自動化](/zh-Hant/docs/cursor/official/03-cli-automation): CLI 與自動化相關的 Cursor 官方教程中文版。
      - [Cursor CLI 總覽](/zh-Hant/docs/cursor/official/03-cli-automation/30-cli-overview): 基於 Cursor 官方 CLI 文件解釋互動模式、非互動模式、Cloud Agent handoff、session 恢復、sandbox 和上線驗收邊界。
      - [CLI 安裝](/zh-Hant/docs/cursor/official/03-cli-automation/31-cli-installation): 安裝 Cursor CLI、處理 PATH、驗證版本、更新 Agent，並給出團隊和 CI 環境的上線檢查。
      - [CLI 使用方式](/zh-Hant/docs/cursor/official/03-cli-automation/32-cli-using): 解釋 Cursor CLI 的模式切換、prompting、MCP、ACP、rules、快捷鍵、review、上下文選擇、Cloud handoff、worktree、history 和非互動模式。
      - [Shell Mode](/zh-Hant/docs/cursor/official/03-cli-automation/33-shell-mode): 基於 Cursor 官方 Shell Mode 文件解釋命令執行、輸出截斷、30 秒超時、許可權審批、適用場景和排障方式。
      - [Agent Client Protocol](/zh-Hant/docs/cursor/official/03-cli-automation/34-acp): 基於 Cursor 官方 ACP 文件解釋 agent acp、stdio JSON-RPC、認證、session 流程、permissions、MCP 限制和自定義客戶端邊界。
      - [Headless 模式](/zh-Hant/docs/cursor/official/03-cli-automation/35-headless): 基於 Cursor 官方 Headless CLI 文件解釋 print mode、--force、輸出格式、指令碼審查、stream-json、圖片路徑和自動化安全邊界。
      - [GitHub Actions](/zh-Hant/docs/cursor/official/03-cli-automation/36-github-actions): 基於 Cursor 官方 GitHub Actions 文件解釋 CI 安裝、CURSOR_API_KEY、full autonomy、restricted autonomy、permissions 和 secrets 配置。
      - [Slash Commands](/zh-Hant/docs/cursor/official/03-cli-automation/37-slash-commands): 基於 Cursor 官方 Slash Commands 參考解釋 /plan、/ask、/model、/auto-run、/sandbox、/mcp、/rules、/commands、/compress 等會話內命令。
      - [CLI 引數](/zh-Hant/docs/cursor/official/03-cli-automation/38-parameters): 基於 Cursor 官方 Parameters 參考解釋全域性引數、commands、MCP 子命令、prompt 引數和常用組合。
      - [CLI 認證](/zh-Hant/docs/cursor/official/03-cli-automation/39-authentication): 基於 Cursor 官方 Authentication 文件解釋瀏覽器登入、API key、狀態檢查、登出、CI secrets 和認證排障。
      - [CLI 許可權](/zh-Hant/docs/cursor/official/03-cli-automation/40-permissions): 基於 Cursor 官方 Permissions 文件解釋 Shell、Read、Write、WebFetch、MCP permission tokens、allow/deny 優先順序和配置位置。
      - [CLI 配置](/zh-Hant/docs/cursor/official/03-cli-automation/41-configuration): 基於 Cursor 官方 Configuration 文件解釋 cli-config.json、專案配置限制、schema、Vim mode、permissions、proxy、HTTP/1.1 fallback 和排障。
      - [輸出格式](/zh-Hant/docs/cursor/official/03-cli-automation/42-output-format): 基於 Cursor 官方 Output Format 文件解釋 text、json、stream-json、partial output、事件型別、失敗行為和指令碼消費邊界。
      - [終端設定](/zh-Hant/docs/cursor/official/03-cli-automation/43-terminal-setup): 基於 Cursor 官方 Terminal Setup 文件解釋多行輸入、Shift+Enter、Ctrl+J、tmux、Vim mode、主題檢測和手動 keybinding 配置。
    - Cloud Agent 與後臺任務
      - [雲端 Agent](/zh-Hant/docs/cursor/official/04-cloud-agents): 雲端 Agent相關的 Cursor 官方教程中文版。
      - [Cloud Agent 總覽](/zh-Hant/docs/cursor/official/04-cloud-agents/50-cloud-agent): 基於 Cursor 官方 Cloud Agents 文件解釋雲端隔離環境、啟動入口、GitHub/GitLab 分支流、MCP、hooks、artifacts、billing 和排障邊界。
      - [Cloud Agent Setup](/zh-Hant/docs/cursor/official/04-cloud-agents/51-setup): 配置 Cloud Agent 的 Ubuntu VM、environment.json、update/start、secrets、Docker 和 Tailscale。
      - [Cloud Agent Capabilities](/zh-Hant/docs/cursor/official/04-cloud-agents/52-capabilities): 基於 Cursor 官方 Capabilities 文件解釋 computer use、artifacts、remote desktop、MCP HTTP/stdio、安全差異和 CI failure autofix。
      - [My Machines](/zh-Hant/docs/cursor/official/04-cloud-agents/53-my-machines): 基於 Cursor 官方 My Machines 文件解釋本機 worker、worker= 路由、repo 匹配、artifacts、網路和 MCP 邊界。
      - [Self-hosted Pool](/zh-Hant/docs/cursor/official/04-cloud-agents/54-self-hosted-pool): 基於 Cursor 官方 Self-hosted Pool 文件解釋企業 worker fleet、service account、pool labels、觸發規則、監控和安全邊界。
      - [Bugbot](/zh-Hant/docs/cursor/official/04-cloud-agents/55-bugbot): 基於 Cursor 官方 Bugbot 文件解釋自動 PR review、手動觸發、rules、autofix、MCP、Admin API、定價和排障。
      - [Security Review](/zh-Hant/docs/cursor/official/04-cloud-agents/56-security-review): 基於 Cursor 官方 Security Review 文件解釋 PR 安全審查、Vulnerability Scanner、Automations、MCP、計費和 analytics。
      - [Automations](/zh-Hant/docs/cursor/official/04-cloud-agents/57-automations): 基於 Cursor 官方 Automations 文件解釋觸發器、工具、許可權範圍、身份、計費、環境和提示詞寫法。
      - [Cloud Agent Best Practices](/zh-Hant/docs/cursor/official/04-cloud-agents/58-best-practices): 基於 Cursor 官方 Best Practices 文件整理 Cloud Agent 環境、上下文、skills、MCP、工具設計和驗收清單。
      - [Cloud Agent 網路安全](/zh-Hant/docs/cursor/official/04-cloud-agents/59-security-network): 基於 Cursor 官方 Security & Network 文件解釋 Privacy Mode、secret protection、signed commits、egress、artifact host 和 IP allowlist。
      - [Cloud Agent Settings](/zh-Hant/docs/cursor/official/04-cloud-agents/60-settings): 基於 Cursor 官方 Cloud Agents Settings 文件解釋預設模型、預設 repo、網路、summary、team follow-ups 和 lateral movement 風險。
      - [Cloud Agent API](/zh-Hant/docs/cursor/official/04-cloud-agents/61-api-endpoints): 基於 Cursor 官方 Cloud Agents API v1 文件整理 agent、run、stream、artifacts、archive、worker tokens、models 和 repositories endpoints。
    - 整合與 SDK
      - [整合、API 與 SDK](/zh-Hant/docs/cursor/official/05-integrations-sdk): 整合、API 與 SDK相關的 Cursor 官方教程中文版。
      - [GitHub 整合](/zh-Hant/docs/cursor/official/05-integrations-sdk/70-github): 基於 Cursor 官方 GitHub integration 文件解釋 GitHub App、GHES、IP allowlist、Advanced networking、許可權和排障。
      - [GitLab 整合](/zh-Hant/docs/cursor/official/05-integrations-sdk/71-gitlab): 基於 Cursor 官方 GitLab integration 文件解釋 GitLab.com、Self-Hosted、paid plan、OAuth app、Sync Repos、網路和排障。
      - [Slack 整合](/zh-Hant/docs/cursor/official/05-integrations-sdk/72-slack): 基於 Cursor 官方 Slack integration 文件解釋 @Cursor 命令、repo 路由、channel settings、status handoff、privacy 和許可權。
      - [Linear 整合](/zh-Hant/docs/cursor/official/05-integrations-sdk/73-linear): 基於 Cursor 官方 Linear integration 文件解釋 issue delegation、repo labels、triage rules 和 follow-up。
      - [JetBrains 整合](/zh-Hant/docs/cursor/official/05-integrations-sdk/74-jetbrains): 基於 Cursor 官方 JetBrains integration 文件解釋 ACP、AI Assistant、安裝、認證、能力、定價和遷移邊界。
      - [Xcode 整合](/zh-Hant/docs/cursor/official/05-integrations-sdk/75-xcode): 基於 Cursor 官方 Xcode integration 文件解釋 Xcode 26.3+ MCP bridge、xcrun mcpbridge、20 個 tools、CLI 和排障。
      - [TypeScript SDK](/zh-Hant/docs/cursor/official/05-integrations-sdk/76-typescript-sdk): 基於 Cursor 官方 TypeScript SDK 文件解釋 local/cloud runtimes、Agent/Run、streaming、MCP、subagents、hooks、artifacts 和 errors。
      - [Deep Links](/zh-Hant/docs/cursor/official/05-integrations-sdk/77-deeplinks): 基於 Cursor 官方 Deeplinks 文件解釋 prompt、command、rule 連結、web/app 格式、確認機制、URL 長度和敏感資訊邊界。
    - 團隊與企業
      - [團隊與企業治理](/zh-Hant/docs/cursor/official/06-teams-enterprise): 團隊與企業治理相關的 Cursor 官方教程中文版。
      - [Team Setup](/zh-Hant/docs/cursor/official/06-teams-enterprise/80-team-setup): 基於 Cursor 官方 Teams setup 文件解釋建立團隊、邀請成員、domain matching、SSO、billing、Unpaid Admin、MDM 和代理相容。
      - [成員、SSO 與 SCIM](/zh-Hant/docs/cursor/official/06-teams-enterprise/81-members-sso-scim): 基於 Cursor 官方 Members、SSO、SCIM 文件解釋角色、邀請、domain controls、SAML、JIT、directory groups 和 spend limits。
      - [Dashboard 與 Analytics](/zh-Hant/docs/cursor/official/06-teams-enterprise/82-dashboard-analytics): 基於 Cursor 官方 Dashboard 和 Usage Analytics 文件解釋團隊設定、usage、AI code tracking、conversation insights、Cloud Agent metrics 和匯出。
      - [Enterprise 總覽](/zh-Hant/docs/cursor/official/06-teams-enterprise/83-enterprise-overview): 用企業上線視角梳理 Cursor Enterprise 的安全、許可權、隱私、模型、審計和成本治理。
      - [身份與訪問管理](/zh-Hant/docs/cursor/official/06-teams-enterprise/84-identity-access): 配置 Cursor 企業身份、SSO、SCIM、RBAC、MDM、擴充套件白名單和 Workspace Trust 的上線流程。
      - [隱私與資料治理](/zh-Hant/docs/cursor/official/06-teams-enterprise/85-privacy-data-governance): 解釋 Cursor 企業資料流、Privacy Mode、Cloud Agents、DPA、subprocessors、加密和 CMEK 的治理邊界。
      - [網路配置](/zh-Hant/docs/cursor/official/06-teams-enterprise/86-network-configuration): 配置 Cursor 在企業代理、防火牆、SSL inspection、streaming、allowlist 和 Cloud Agents 網路邊界中的上線要求。
      - [LLM 安全與控制](/zh-Hant/docs/cursor/official/06-teams-enterprise/87-llm-safety-controls): 區分 Cursor 中可強制執行的安全控制和非確定性的 LLM steering，並給出企業級 Agent 防護方案。
      - [模型與整合管理](/zh-Hant/docs/cursor/official/06-teams-enterprise/88-model-integration-management): 管理 Cursor Enterprise 的模型訪問、BYOK、MCP allowlist、儲存庫 blocklist，以及 Slack、GitHub、GitLab、Linear 整合許可權。
      - [合規與監控](/zh-Hant/docs/cursor/official/06-teams-enterprise/89-compliance-monitoring): 用 Audit Logs、Hooks、SIEM、Trust Center 和 AI code tracking 建立 Cursor Enterprise 合規監控閉環。
      - [服務賬號與計費組](/zh-Hant/docs/cursor/official/06-teams-enterprise/90-service-accounts-billing-groups): 用 Service Accounts 管理非真人自動化，用 Billing Groups 管理 Cursor Enterprise 成本歸因和 chargeback。
    - Help Center 與排障
      - [幫助與排障](/zh-Hant/docs/cursor/official/07-help-troubleshooting): 幫助與排障相關的 Cursor 官方教程中文版。
      - [安裝和第一個專案排障](/zh-Hant/docs/cursor/official/07-help-troubleshooting/100-install-first-project): 按官方 Help Center 把 Cursor 安裝、登入、開啟專案、首個 Agent 任務和遷移問題整理成可執行排障路徑。
      - [AI 功能排障總覽](/zh-Hant/docs/cursor/official/07-help-troubleshooting/101-ai-features-overview): 把 Agent、Ask、Plan、Debug、Tab、Inline Edit 的官方入口整理成模式選擇、驗證和排障路徑。
      - [自定義與上下文排障](/zh-Hant/docs/cursor/official/07-help-troubleshooting/102-customization-help): 把 Rules、Context、MCP、Skills、Indexing、Ignore files 變成可排查的 Cursor 上下文治理路徑。
      - [模型與用量排障](/zh-Hant/docs/cursor/official/07-help-troubleshooting/103-models-usage-help): 按 Cursor 官方幫助梳理模型選擇、Auto/Premium、API keys、usage limits、on-demand 和 token rate 的排障路徑。
      - [安全與隱私排障](/zh-Hant/docs/cursor/official/07-help-troubleshooting/104-security-privacy-help): 把 Cursor Privacy Mode、ZDR、BYOK 例外、Trust Center、合規檔案、SSO 和 Marketplace security 整理成分診路徑。
      - [賬號與賬單排障](/zh-Hant/docs/cursor/official/07-help-troubleshooting/105-account-billing-help): 把 Cursor billing cycle、included usage、on-demand、seat、invoice、payment、cancel、refund 整理成可轉交的賬務排障流程。
      - [Agent、Tab、網路和效能排障](/zh-Hant/docs/cursor/official/07-help-troubleshooting/106-troubleshooting-agent-tab-network): 把 Cursor Agent、Tab、安裝啟動、網路代理、SSH/VPN、擴充套件衝突和效能問題整理成一套分診樹。
- Antigravity
  - [Google Antigravity 中文教程](/zh-Hant/docs/antigravity): 基於 Google 官方資料重寫的 Antigravity 中文教程，覆蓋 Agent Manager、Editor、Browser、Artifacts、Rules、Workflows、Skills、MCP 與許可權治理。
  - 從原理到實戰
    - [Antigravity 從原理到實戰](/zh-Hant/docs/antigravity/understanding): 按中文開發者學習順序講清 Antigravity：定位、安裝、Agent Manager、Artifacts、Browser、Rules、Skills、MCP、許可權、安全和真實專案實踐。
  - 官方教程中文版
    - [Antigravity 官方教程中文版](/zh-Hant/docs/antigravity/official): 按 Google 官方資料重組的 Antigravity 中文查詢手冊，覆蓋安裝、Agent Manager、Editor、Browser、Artifacts、Rules、Skills、MCP 與安全許可權。
    - 00 · 入門
      - [安裝與初始設定](/zh-Hant/docs/antigravity/official/00-getting-started): Antigravity 入門安裝、個人 Gmail 登入、setup flow、安全策略選擇和第一次只讀驗證。
      - [Antigravity 是什麼](/zh-Hant/docs/antigravity/official/00-getting-started/00-product-overview): 從 Google 官方 Home 文件理解 Antigravity 的產品定位、核心介面、Agent、Artifacts、Editor 與 Browser 的職責邊界。
      - [下載與基礎導航](/zh-Hant/docs/antigravity/official/00-getting-started/01-download-navigation): 根據 Google 官方 Getting Started 文件梳理 Antigravity 下載入口、平臺要求、更新機制，以及 Editor 與 Agent Manager 的基礎切換方式。
      - [Firebase Studio 專案遷移到 Antigravity](/zh-Hant/docs/antigravity/official/00-getting-started/02-firebase-studio-migration): 基於 Google 官方遷移文件，梳理 Firebase Studio 專案匯出、Antigravity 自動遷移、Firebase CLI 手動遷移、本地預覽和釋出路徑。
    - 01 · Agent Manager
      - [Agent Manager](/zh-Hant/docs/antigravity/official/01-agent-manager): 理解 Antigravity Agent Manager：workspace、conversation、Fast 與 Planning、Artifacts、非同步多 agent 和人工反饋入口。
      - [Agent 核心工作方式](/zh-Hant/docs/antigravity/official/01-agent-manager/00-agent-core): 根據 Google 官方 Agent 文件解釋 Antigravity Agent 的組成：reasoning model、tools、artifacts、knowledge、並行 conversations 與刪除邊界。
      - [Agent Modes 與全域性設定](/zh-Hant/docs/antigravity/official/01-agent-manager/01-agent-modes-settings): 解釋 Antigravity 的 Planning、Fast、Artifact Review、Terminal 自動執行和非 workspace 檔案訪問設定。
    - 02 · Editor
      - [Editor 工作流](/zh-Hant/docs/antigravity/official/02-editor-workflow): Antigravity Editor View 的日常工作流：補全、Tab、inline command、terminal command、agent side panel、Problems 和上下文引用。
      - [Editor Surface 與工作分層](/zh-Hant/docs/antigravity/official/02-editor-workflow/00-editor-surface): 基於官方 Editor 文件理解 Antigravity Editor 的 VS Code 基礎、AI 入口、擴充套件能力和適用任務邊界。
      - [Tab、Command 與 Review Changes](/zh-Hant/docs/antigravity/official/02-editor-workflow/01-tab-command-review): 把官方 Tab、Command、Agent Side Panel 和 Review Changes 文件串成 Antigravity Editor 的日常編碼閉環。
    - 03 · Browser & Artifacts
      - [Browser 與 Artifacts](/zh-Hant/docs/antigravity/official/03-browser-artifacts): Antigravity Browser Subagent、瀏覽器擴充套件、截圖、錄屏、task list、implementation plan、walkthrough 和 diff review 的使用邊界。
      - [Artifacts 與審查反饋](/zh-Hant/docs/antigravity/official/03-browser-artifacts/00-artifacts-review): 基於官方 Artifacts、Task List、Implementation Plan、Walkthrough 與 Knowledge 文件，建立 Antigravity 任務證據和反饋審查流程。
      - [Browser Subagent 與視覺證據](/zh-Hant/docs/antigravity/official/03-browser-artifacts/01-browser-subagent-evidence): 基於官方 Browser、Browser Subagent、Screenshots 和 Browser Recordings 文件，解釋 Antigravity 瀏覽器驗證、獨立 Chrome profile 和證據審查邊界。
    - 04 · Rules / Workflows / Skills
      - [Rules、Workflows 與 Skills](/zh-Hant/docs/antigravity/official/04-rules-workflows-skills): Antigravity 自定義體系：Rules、Workflows、Skills 的分工、global/workspace 落點、Skill 結構和漸進載入原則。
      - [Rules 與 Workflows](/zh-Hant/docs/antigravity/official/04-rules-workflows-skills/00-rules-workflows): 基於官方 Rules / Workflows 文件解釋 Antigravity 全域性規則、Workspace 規則、啟用方式、@mentions 與可複用 workflow。
      - [Skills 與漸進載入](/zh-Hant/docs/antigravity/official/04-rules-workflows-skills/01-skills-progressive-disclosure): 基於官方 Skills 文件解釋 Antigravity Skill 的目錄結構、SKILL.md、description、workspace/global scope 和 progressive disclosure。
    - 05 · MCP & Security
      - [MCP、許可權與安全](/zh-Hant/docs/antigravity/official/05-mcp-permissions-security): Antigravity MCP 與安全控制：Allow、Deny、Ask、terminal sandbox、workspace file access、browser allowlist 和 MCP 許可權資源。
      - [MCP 整合與許可權邊界](/zh-Hant/docs/antigravity/official/05-mcp-permissions-security/00-mcp-integration): 基於官方 MCP 文件解釋 Antigravity MCP Store、自定義 server、mcp_config.json、OAuth、Google ADC、headers 和 disabledTools。
      - [Strict Mode、Sandbox 與 URL Allowlist](/zh-Hant/docs/antigravity/official/05-mcp-permissions-security/01-strict-sandbox-allowlist): 基於官方文件解釋 Antigravity Strict Mode、Sandbox、URL Allowlist 和檔案訪問邊界。
    - 06 · Models & Pricing
      - [模型、定價與平臺](/zh-Hant/docs/antigravity/official/06-models-pricing-platforms): Antigravity 與 Gemini 3、模型可選性、個人預覽、Mac/Windows/Linux 平臺支援和 pricing 頁面核驗方法。
      - [模型選擇器與系統模型](/zh-Hant/docs/antigravity/official/06-models-pricing-platforms/00-models): 根據 Google 官方 Models 文件解釋 Antigravity reasoning model、模型選擇器、sticky 選擇邏輯和不可自定義的系統模型。
      - [Plans、Quota 與 Overage](/zh-Hant/docs/antigravity/official/06-models-pricing-platforms/01-plans-quota-overages): 解釋 Antigravity 官方 Plans 文件中的 Google AI plan、baseline quota、AI credits、overage 設定和當前不支援項。
    - 07 · 用例與參考
      - [用例、排障與參考](/zh-Hant/docs/antigravity/official/07-use-cases-reference): Antigravity 適合的真實用例、不適合的任務、排障順序、反饋入口和官方參考連結。
      - [真實專案任務選擇](/zh-Hant/docs/antigravity/official/07-use-cases-reference/00-real-project-selection): 基於官方能力邊界判斷哪些任務適合交給 Antigravity，哪些任務需要拆分、人工確認或暫不交給 Agent。
      - [排障順序與官方參考](/zh-Hant/docs/antigravity/official/07-use-cases-reference/01-troubleshooting-reference): 整理 Antigravity 安裝、workspace、許可權、browser、MCP、模型額度和反饋提交的排障順序。
- Windsurf
  - [Windsurf 中文教程](/zh-Hant/docs/windsurf): 基於 Windsurf 官方文件、Cognition 官方公告和 MCP 規範重寫的 Windsurf 中文教程。
  - 官方教程中文版
    - [Windsurf 官方教程中文版](/zh-Hant/docs/windsurf/official): 按 Windsurf 官方文件能力域重組的中文查詢手冊，覆蓋安裝、Cascade、上下文、MCP、Skills、模型和團隊控制。
    - [安裝、登入與首次啟動](/zh-Hant/docs/windsurf/official/00-setup-onboarding): 按 Windsurf 官方文件跑通系統要求、下載、onboarding、VS Code/Cursor 匯入、PATH、認證、更新、遠端開發和第一輪安全驗證。
    - [Cascade 核心能力](/zh-Hant/docs/windsurf/official/01-cascade-core): 整理 Windsurf Cascade 的模式、工具呼叫、Todo、checkpoint、Agent Command Center 和多會話邊界。
    - [上下文、規則與 AGENTS.md](/zh-Hant/docs/windsurf/official/02-context-rules-agents): 區分 Windsurf 上下文檢索、Memories、Rules、AGENTS.md、Workflows、Skills 與忽略規則。
    - [終端與命令控制](/zh-Hant/docs/windsurf/official/03-terminal-command-control): 整理 Windsurf Terminal、Command 模式、Cascade 終端上下文、auto-execution、allow/deny list、團隊控制和 dedicated terminal。
    - [MCP 整合](/zh-Hant/docs/windsurf/official/04-mcp-integration): 按官方文件整理 Windsurf MCP Marketplace、mcp_config.json、HTTP/SSE、認證插值、100 tools 限制和企業 registry。
    - [Skills、Workflows 與 Hooks](/zh-Hant/docs/windsurf/official/05-skills-workflows): 整理 Windsurf Skills、Workflows、Hooks、Rules、AGENTS.md 和 Memories 的團隊沉澱邊界。
    - [模型、Adaptive、BYOK 與用量](/zh-Hant/docs/windsurf/official/06-models-usage): 按官方文件整理 Windsurf 模型選擇、Adaptive、SWE 模型族、BYOK、quota、extra usage 和團隊計費邊界。
    - [團隊控制與排障](/zh-Hant/docs/windsurf/official/07-teams-troubleshooting): 整理 Windsurf Admin Portal、SSO/SCIM、RBAC、命令策略、MCP 准入、共享、日誌和常見故障定位。
  - 從原理到實戰
    - [Windsurf 從原理到實戰](/zh-Hant/docs/windsurf/understanding): 用 8 篇中文教程講清 Windsurf 的定位、Cascade 工作模型、上下文治理、MCP/Skills/Workflows/Hooks、安全邊界、模型用量和工具對比。
    - [Windsurf 是什麼](/zh-Hant/docs/windsurf/understanding/01-what-is-windsurf): 解釋 Windsurf 作為 Cognition 旗下 agentic IDE 的定位，以及它和聊天框、補全工具、終端 agent 的根本差異。
    - [第一次專案閉環](/zh-Hant/docs/windsurf/understanding/02-first-project-loop): 用只讀理解、單檔案修改、驗證命令和 diff 檢查四步，把 Windsurf 安全放進真實專案。
    - [Cascade 心智模型](/zh-Hant/docs/windsurf/understanding/03-cascade-mental-model): 解釋 Cascade 如何結合上下文、計劃、工具、終端和 checkpoint 推進任務，避免把它當普通聊天機器人使用。
    - [上下文、Rules 與 AGENTS.md 怎麼放](/zh-Hant/docs/windsurf/understanding/04-context-rules-agents-md): 給出 Windsurf 專案規則落地模型，說明 Context Awareness、Memories、Rules、AGENTS.md、.windsurf/rules 和 .codeiumignore 的分工。
    - [MCP、Skills、Workflows 怎麼分工](/zh-Hant/docs/windsurf/understanding/05-mcp-skills-workflows): 解釋 Windsurf 裡外部工具、能力包、手動流程、Hooks 和專案規則的邊界，避免把所有自動化都堆進 MCP。
    - [終端命令安全](/zh-Hant/docs/windsurf/understanding/06-terminal-command-safety): 給 Windsurf Cascade 終端自動執行設定一個商業專案可用的安全策略，覆蓋 allowlist、denylist、Turbo、團隊上限和人工確認。
    - [模型與用量策略](/zh-Hant/docs/windsurf/understanding/07-model-usage-strategy): 用任務風險、上下文規模、Adaptive 路由、quota 和團隊治理來制定 Windsurf 模型使用策略。
    - [Windsurf vs Cursor、Claude Code、Codex 怎麼選](/zh-Hant/docs/windsurf/understanding/08-windsurf-vs-cursor-claude-code-codex): 從工作入口、上下文方式、自動化能力、團隊治理和典型任務比較 Windsurf、Cursor、Claude Code 與 Codex。
- OpenCode
  - [OpenCode 中文教程](/zh-Hant/docs/opencode): 基於 OpenCode 官方資料和原始碼重寫的中文教程。
  - 從原理到實戰
    - [OpenCode 從原理到實戰](/zh-Hant/docs/opencode/understanding): 從定位、終端工作流、配置、Agent、模型、工具和安全邊界理解 OpenCode。
    - [01 · OpenCode 是什麼](/zh-Hant/docs/opencode/understanding/01-what-is-opencode): 理解 OpenCode 的定位：開源、終端優先、多模型可換、配置開放的 AI Coding Agent。
    - [02 · 安裝、連線模型與第一次執行](/zh-Hant/docs/opencode/understanding/02-install-first-run): 從安裝 OpenCode 到連線 provider、啟動 TUI，並完成第一輪只讀和低風險寫入。
    - [03 · 終端 TUI 工作流](/zh-Hant/docs/opencode/understanding/03-terminal-workflow): 理解 OpenCode 的 TUI：檔案引用、shell 命令、斜槓命令、Plan/Build 雙模式、會話、壓縮與 attach。
    - [04 · 配置、Rules 與自定義命令](/zh-Hant/docs/opencode/understanding/04-config-rules-commands): 基於官方 OpenCode Config、Rules、Commands 教程，面向新手講清配置、規則和命令各自沉澱什麼經驗。
    - [05 · Agents、Skills 與 Plugins](/zh-Hant/docs/opencode/understanding/05-agents-skills-plugins): 區分 OpenCode 中的 agent、skill、plugin：角色邊界、流程複用和執行時擴充套件不要混在一起。
    - [06 · 模型與供應商策略](/zh-Hant/docs/opencode/understanding/06-model-provider-strategy): 在 OpenCode 中按任務風險、成本、速度和資料邊界選擇 provider、model、variant 與預設模型。
    - [07 · 工具、MCP、LSP 與格式化器](/zh-Hant/docs/opencode/understanding/07-tools-mcp-lsp): 理解 OpenCode 如何連線檔案系統、shell、MCP server、LSP 和 formatter。
    - [08 · 安全、分享與團隊使用](/zh-Hant/docs/opencode/understanding/08-security-share-team): 使用 OpenCode 時如何控制許可權、網路、會話分享和團隊配置邊界。
  - 官方教程中文版
    - [OpenCode 官方教程中文版](/zh-Hant/docs/opencode/official): 基於 OpenCode 官方資料重寫的中文查詢手冊，按功能分類組織。
    - 入門
      - [入門](/zh-Hant/docs/opencode/official/00-getting-started): 彙總 OpenCode 入門路徑，按 CLI、TUI、分享和 IDE 入口建立第一條可執行閉環。
      - [使用 CLI](/zh-Hant/docs/opencode/official/00-getting-started/cli): 整理 OpenCode CLI 的常用命令、啟動引數和適合新手的最小驗證流程。
      - [使用 TUI](/zh-Hant/docs/opencode/official/00-getting-started/tui): 說明 OpenCode 終端介面的基本操作、常見狀態和新手第一次使用的檢查點。
      - [連線 IDE](/zh-Hant/docs/opencode/official/00-getting-started/ide): 在 VS Code、Cursor、Windsurf、VSCodium 等 IDE 中使用 OpenCode。
      - [分享會話](/zh-Hant/docs/opencode/official/00-getting-started/share): 說明 OpenCode 會話分享的用途、公開邊界、撤銷方式和團隊預設策略。
    - 個性化
      - [切換主題](/zh-Hant/docs/opencode/official/01-customization/themes): 選擇內建主題，或用少量顏色定義自己的 OpenCode TUI 主題。
      - [配置快捷鍵](/zh-Hant/docs/opencode/official/01-customization/keybinds): 用 tui.json 調整少數真正影響效率的 OpenCode TUI 快捷鍵。
      - [建立自定義命令](/zh-Hant/docs/opencode/official/01-customization/commands): 用自定義命令把重複提示詞沉澱成可複用入口。
      - [配置 OpenCode](/zh-Hant/docs/opencode/official/01-customization/config): 理解 opencode.json、配置合併、載入優先順序和新手最小配置策略。
    - Agents & Skills
      - [配置 Agents](/zh-Hant/docs/opencode/official/02-agents-skills/agents): 理解 OpenCode 裡的 Build、Plan、Explore、General，以及什麼時候建立自己的 Agent。
      - [使用 Agent Skills](/zh-Hant/docs/opencode/official/02-agents-skills/skills): 理解 OpenCode Agent Skills：放在哪裡、怎麼寫、什麼時候載入，以及許可權如何控制。
      - [安裝外掛](/zh-Hant/docs/opencode/official/02-agents-skills/plugins): 理解 OpenCode 外掛什麼時候該用，以及如何安全擴充套件執行行為。
      - [編寫規則](/zh-Hant/docs/opencode/official/02-agents-skills/rules): 基於 OpenCode 官方 Rules 文件，幫助新手理解 AGENTS.md、全域性規則、Claude Code 相容和外部指令檔案。
    - 模型與供應商
      - [選擇模型](/zh-Hant/docs/opencode/official/03-models/models): 基於 OpenCode 官方 Models 文件，幫助新手理解 provider、model、variant 和預設模型的選擇邊界。
      - [配置模型供應商](/zh-Hant/docs/opencode/official/03-models/providers): 理解 OpenCode provider、憑據、模型選擇、本地模型和自定義 endpoint 的邊界。
    - 工具與 MCP
      - [連線 MCP 伺服器](/zh-Hant/docs/opencode/official/04-tools-mcp/mcp-servers): 為 OpenCode 新增外部工具，並控制上下文和許可權成本。
      - [建立自定義工具](/zh-Hant/docs/opencode/official/04-tools-mcp/custom-tools): 在 OpenCode 裡給模型提供可控、可複用的專案動作。
      - [管理工具](/zh-Hant/docs/opencode/official/04-tools-mcp/tools): 說明 OpenCode 工具管理、LLM 可用工具範圍、許可權控制和排障思路。
      - [連線 LSP 伺服器](/zh-Hant/docs/opencode/official/04-tools-mcp/lsp): OpenCode 與你的 LSP 伺服器整合。
      - [配置格式化工具](/zh-Hant/docs/opencode/official/04-tools-mcp/formatters): OpenCode 使用特定語言的格式化工具。
    - 安全與網路
      - [管理許可權](/zh-Hant/docs/opencode/official/05-security/permissions): 理解 OpenCode 的 allow、ask、deny、外部目錄和 Agent 級許可權邊界。
      - [配置網路](/zh-Hant/docs/opencode/official/05-security/network): 理解 OpenCode 的代理變數、NO_PROXY 和企業自定義證書配置。
    - 整合
      - [接入 GitHub](/zh-Hant/docs/opencode/official/06-integrations/github): 在 GitHub Issue 和 Pull Request 中安全地使用 OpenCode。
      - [接入 GitLab](/zh-Hant/docs/opencode/official/06-integrations/gitlab): 在 GitLab Issue、Merge Request 和 CI/CD 中使用 OpenCode。
      - [瞭解生態系統](/zh-Hant/docs/opencode/official/06-integrations/ecosystem): 基於 OpenCode 構建的專案與整合。
      - [配置企業版](/zh-Hant/docs/opencode/official/06-integrations/enterprise): 在組織中安全試用和部署 OpenCode，覆蓋資料邊界、SSO、內部 AI 閘道器、分享停用和私有 npm 登入檔。
    - SDK & 服務
      - [使用 SDK](/zh-Hant/docs/opencode/official/07-sdk/sdk): 基於官方 OpenCode SDK 教程，面向新手講清 SDK 適合什麼整合場景、server/client 怎麼理解、結構化輸出和錯誤處理怎麼驗收。
      - [啟動伺服器](/zh-Hant/docs/opencode/official/07-sdk/server): 透過 HTTP 與 OpenCode server 互動，並理解 serve、web、TUI、SDK 和 OpenAPI 的關係。
      - [在 Web 中使用 OpenCode](/zh-Hant/docs/opencode/official/07-sdk/web): 說明如何在瀏覽器中使用 OpenCode，並區分 Web 入口、SDK 和 server 的職責。
    - 平臺與故障
      - [在 Windows WSL 中使用 OpenCode](/zh-Hant/docs/opencode/official/08-platform/windows-wsl): 透過 WSL 在 Windows 上執行 OpenCode，處理檔案系統、Desktop/Web 連線和安全邊界。
      - [使用 Zen 模型列表](/zh-Hant/docs/opencode/official/08-platform/zen): 理解 OpenCode Zen 的定位、接入流程、模型 ID、計費、隱私和團隊治理邊界。
      - [排查故障](/zh-Hant/docs/opencode/official/08-platform/troubleshooting): 彙總 OpenCode 常見故障的排查順序，覆蓋安裝、認證、模型、工具和終端問題。
      - [接入 ACP](/zh-Hant/docs/opencode/official/08-platform/acp): 理解 Agent Client Protocol：如何把 OpenCode 接入 Zed、JetBrains 和 Neovim 等編輯器。
- OpenClaw 小龍蝦
  - [OpenClaw 小龍蝦中文教程](/zh-Hant/docs/openclaw): 翔宇自研多 Agent 協作框架的中文教程，連線主站個人實踐和開源內容源。
  - 從原理到實戰
    - [OpenClaw 從原理到實戰](/zh-Hant/docs/openclaw/understanding): 10 篇 OpenClaw 深度講解的閱讀地圖：從 AI 為什麼需要一個家，到訊息旅程、記憶、Workspace、多 Agent、心跳、安全和設計覆盤。
    - [01 · 為什麼 AI 需要一個家](/zh-Hant/docs/openclaw/understanding/01-ai-home): 從無狀態聊天出發，解釋 OpenClaw 為什麼需要 Gateway、Memory、Channel 和 Agent 這幾個基礎概念。
    - [02 · 一條訊息的旅程](/zh-Hant/docs/openclaw/understanding/02-message-journey): 拆解一條訊息從渠道進入 OpenClaw 到 Agent 回覆的完整鏈路，包括路由、session、佇列、上下文、工具和回覆分塊。
    - [03 · Agent 的大腦是怎麼工作的](/zh-Hant/docs/openclaw/understanding/03-agent-brain): 理解 OpenClaw Agent runtime、Agent loop、Tools、Skills、Hooks 與許可權邊界如何組成一個可執行的大腦。
    - [04 · OpenClaw 的記憶系統：短期、長期、可檢索記憶](/zh-Hant/docs/openclaw/understanding/04-memory-system): 解釋 OpenClaw 如何用 Markdown 檔案、記憶搜尋、壓縮前儲存和 Dreaming 組成可審查的記憶系統。
    - [05 · Context 管理：為什麼 AI 會忘記、截斷和壓縮](/zh-Hant/docs/openclaw/understanding/05-context-management): 理解 OpenClaw 如何組裝上下文、統計 token、注入 workspace 檔案，並透過 compaction 與 pruning 控制視窗壓力。
    - [06 · Workspace：Agent 的工作空間和身份容器](/zh-Hant/docs/openclaw/understanding/06-workspace): 講清 OpenClaw workspace 的真實邊界：它是預設 cwd 和專案上下文，不是配置庫、憑據庫或硬沙箱。
    - [07 · 多 Agent：什麼時候拆、怎麼協作](/zh-Hant/docs/openclaw/understanding/07-multi-agent): 解釋 OpenClaw 多 Agent 的真實邊界：獨立 workspace、agentDir、sessions、bindings、sub-agents 和 delegate 場景。
    - [08 · Session 與心跳：時間如何進入 Agent](/zh-Hant/docs/openclaw/understanding/08-session-heartbeat): 解釋 OpenClaw 的 Session、Heartbeat、Cron、Webhooks 與 Tasks：誰負責上下文，誰負責定時，誰只做臺賬。
    - [09 · Channel 與安全：誰能進來、能做什麼](/zh-Hant/docs/openclaw/understanding/09-channel-security): 從 OpenClaw 官方安全模型出發，拆清 Channel 路由、DM 配對、群組門控、工具許可權、沙箱和 Gateway 暴露。
    - [10 · 設計覆盤：OpenClaw 為什麼這樣設計](/zh-Hant/docs/openclaw/understanding/10-design-review): 把 Gateway、Agent Loop、Workspace、Memory、Session、Channel、Automation 與 Security 收束成一張架構圖。
  - 官方教程中文版
    - [OpenClaw 官方教程中文版](/zh-Hant/docs/openclaw/official): 基於 OpenClaw 官方文件重寫的中文教程：安裝、Gateway、配置、workspace 和後續開發文件。
    - 入門與安裝
      - [入門與安裝](/zh-Hant/docs/openclaw/official/00-getting-started): OpenClaw 入門與安裝學習地圖：先安裝和 onboarding，再驗證 Gateway、理解配置結構，最後整理 Agent Workspace。
      - [安裝 OpenClaw](/zh-Hant/docs/openclaw/official/00-getting-started/installation): 基於官方 OpenClaw 安裝教程，面向新手講清推薦安裝、Node 要求、替代路徑、原始碼安裝和安裝後驗證。
      - [快速上手 OpenClaw](/zh-Hant/docs/openclaw/official/00-getting-started/quickstart): 用 OpenClaw onboarding 跑通模型認證、Gateway、Dashboard 和第一條訊息，確認最小閉環真的可用。
      - [理解配置結構](/zh-Hant/docs/openclaw/official/00-getting-started/configuration): 理解 OpenClaw 配置結構：openclaw.json、JSON5、strict schema、熱載入、last-known-good、環境變數和金鑰邊界。
      - [配置 Agent Workspace](/zh-Hant/docs/openclaw/official/00-getting-started/workspace): 理解 OpenClaw Agent Workspace：長期工作現場、標準啟動檔案、sandbox 邊界、私有 git 備份和遷移方式。
    - Gateway 執行時
      - [Gateway 執行時](/zh-Hant/docs/openclaw/official/01-gateway-runtime): OpenClaw Gateway 執行時學習地圖：理解 Gateway、配置、Agent、Channel、安全遠端訪問和自動化邊界。
      - [理解 Gateway 架構](/zh-Hant/docs/openclaw/official/01-gateway-runtime/architecture): 理解 OpenClaw Gateway 架構：長期控制面、WebSocket 協議、nodes、pairing、本機 loopback、遠端訪問和執行不變數。
      - [配置 Gateway](/zh-Hant/docs/openclaw/official/01-gateway-runtime/gateway-configuration): 配置 OpenClaw Gateway：gateway.mode、strict schema、reload mode、Config RPC、health、doctor、安全重啟和排障順序。
      - [配置 Agent](/zh-Hant/docs/openclaw/official/01-gateway-runtime/agents): 配置 OpenClaw Agent：workspace、repoRoot、bootstrap 注入、skills allowlist、agentDir、session、模型和多 Agent 路由邊界。
      - [配置 Channel](/zh-Hant/docs/openclaw/official/01-gateway-runtime/channels): 配置 OpenClaw Channel：DM policy、group policy、mention gating、pairing、access groups、多賬號、model override 和 Agent binding。
      - [配置安全與遠端訪問](/zh-Hant/docs/openclaw/official/01-gateway-runtime/security-remote): 理解 OpenClaw 安全與遠端訪問：個人助手信任模型、security audit、Control UI、Tailscale、SSH tunnel、sandbox 和共享入口風險。
      - [配置自動化](/zh-Hant/docs/openclaw/official/01-gateway-runtime/automation): OpenClaw cron、tasks、task flow、standing orders、hooks 和 heartbeat 的選擇邊界。
- Hermes Agent
  - [Hermes Agent 中文教程](/zh-Hant/docs/hermes): 基於 Nous Research Hermes Agent 官方資料重寫的中文教程，作為開源 Agent 執行時的橫向研究資料。
  - 從原理到實戰
    - [Hermes Agent 從原理到實戰](/zh-Hant/docs/hermes/understanding): 面向中文開發者，用 8 篇文章建立 Hermes Agent 的定位、穩定閉環、配置、工具、記憶、技能、訊息閘道器和自動化邊界。
    - [01 · Hermes Agent 是什麼](/zh-Hant/docs/hermes/understanding/01-what-is-hermes-agent): 理解 Hermes Agent 的定位：CLI/TUI、provider、工具、記憶、skills、Gateway、terminal backends 和自動化組成的開源 agent runtime。
    - [02 · 先跑通第一個穩定閉環](/zh-Hant/docs/hermes/understanding/02-first-stable-loop): 安裝 Hermes 後先驗證命令、provider、64K context、普通對話、session 恢復和低風險工具呼叫。
    - [03 · 配置、Provider 與目錄結構](/zh-Hant/docs/hermes/understanding/03-configuration-provider): 理解 Hermes 的 ~/.hermes 目錄、config.yaml、.env、auth.json、SOUL.md、provider、timeout 和 terminal backend。
    - [04 · 工具系統與終端後端](/zh-Hant/docs/hermes/understanding/04-tools-terminal-backends): 區分 Hermes toolsets、tools、terminal backends、後臺程序、Nous Tool Gateway 和整體許可權風險。
    - [05 · 記憶與召回](/zh-Hant/docs/hermes/understanding/05-memory-and-recall): 區分 Hermes curated memory、USER.md、MEMORY.md、凍結快照、session_search、容量治理和外部 memory provider。
    - [06 · Skills 系統](/zh-Hant/docs/hermes/understanding/06-skills-system): 理解 Hermes skill、prompt、tool、memory 的邊界，以及本地正本、漸進載入、secure setup、Hub 安裝和 agent-managed skills。
    - [07 · 訊息閘道器](/zh-Hant/docs/hermes/understanding/07-messaging-gateway): 理解 Hermes Gateway、平臺入口、chat session、allowlist、DM pairing、slash commands、busy input 和 background session 的關係。
    - [08 · 自動化邊界](/zh-Hant/docs/hermes/understanding/08-automation-boundaries): 使用 Hermes cron、background、delegation、hooks 和訊息投遞前，先建立許可權、日誌、失敗處理和人工確認邊界。
  - 官方教程中文版
    - [Hermes Agent 官方教程中文版](/zh-Hant/docs/hermes/official): 基於 Nous Research 官方 docs、llms.txt 和上游原始碼重寫的 Hermes Agent 中文查詢手冊。
    - 入門
      - [安裝 Hermes Agent](/zh-Hant/docs/hermes/official/00-getting-started/installation): 用官方安裝路徑在 Linux、macOS、WSL2、原生 Windows（早期測試）或 Termux 上安裝 Hermes Agent，並完成 PATH、目錄、依賴和排障驗收。
      - [快速上手 Hermes Agent](/zh-Hant/docs/hermes/official/00-getting-started/quickstart): 從安裝、provider、第一次對話、session 恢復到下一層能力，跑通 Hermes Agent 的最小穩定閉環。
      - [規劃 Hermes Agent 學習路徑](/zh-Hant/docs/hermes/official/00-getting-started/learning-path): 按經驗等級和使用場景選擇 Hermes Agent 文件閱讀順序，先跑通基礎閉環，再進入工具、記憶、訊息閘道器和自動化。
    - 使用手冊
      - [使用手冊](/zh-Hant/docs/hermes/official/01-user-guide): Hermes Agent 配置、工具系統、記憶、技能和訊息閘道器的中文使用入口，按問題定位能力邊界。
      - [配置 Hermes Agent](/zh-Hant/docs/hermes/official/01-user-guide/configuration): 理解 Hermes 的 ~/.hermes 目錄、config.yaml、.env、OAuth、配置優先順序、環境變數替換和七類 terminal backend。
      - [接入訊息閘道器和平臺](/zh-Hant/docs/hermes/official/01-user-guide/messaging): 理解 Hermes Messaging Gateway 的平臺接入、session、allowlist、DM pairing、聊天命令、background session 和安全邊界。
      - [配置工具系統和終端後端](/zh-Hant/docs/hermes/official/01-user-guide/tools): 理解 Hermes tools、toolsets、Nous Tool Gateway、terminal backends、後臺程序和許可權邊界。
      - [使用記憶系統](/zh-Hant/docs/hermes/official/01-user-guide/memory): 理解 Hermes 的 MEMORY.md、USER.md、凍結快照、memory tool、session_search、容量限制、安全掃描和外部 memory provider。
      - [使用技能系統](/zh-Hant/docs/hermes/official/01-user-guide/skills): 理解 Hermes skills 的漸進載入、本地正本、外部目錄、Skills Hub、secure setup、agent-managed skills 和安裝審查。