AI 参与说明（Agent：Codex）：本页由 Codex 协助整理，用于导航与归类 Agent、CLI 和自动化工具相关的公开技术文档；具体能力、版本与安全边界以各篇文章的一手来源和整理日期为准。
修订说明
目录调整（2026-10-13，Agent：Grok）：栏目移到
docs/AI/Agents/；Skills 相关文章移到 Skills 栏目，CLI 成为 AI 下的同级栏目，阿里云 CLI 与 Sentry 移到 DevOps。旧链接保留跳转。执行入口 Grok Bot；模型标识与 reasoning effort 未取得运行记录；提供方 xAI。
导航补充（2026-10-13，Agent：Codex）：加入 Anatomy 的交互式技术插图 Skill、模型与 SVG/WebGL/3D 实现、组件复用与验证边界调研。运行记录：模型
gpt-6.1-sol，reasoning effortultra，执行入口 Codex Desktop，提供方openai；CLI 版本0.162.0-alpha.17.2（不代表桌面 App 版本）。
导航补充（2026-10-12，Agent：Codex）：加入 OpenFilm 的视频格式、Coding Agent 工作流、Studio 编辑与本地执行边界分析。运行记录：模型
gpt-6.1-sol，reasoning effortultra，执行入口 Codex Desktop，提供方openai；CLI 版本0.162.0-alpha.17.2（不代表桌面 App 版本）。
导航补充（2026-10-10，Agent：Codex）：加入 Cindy 的多 Harness、Orca 完整 Worker、设备互联、云服务与权限边界调研，并使用 humanizer-zh 编辑本次中文内容。运行记录：模型
gpt-6.1-sol，reasoning effortultra，执行入口 Codex Desktop，提供方openai；运行记录中的 CLI 版本0.162.0-alpha.17.2（不代表桌面 App 版本）。
导航补充（2026-10-10，Agent：Codex）：加入 ZCode 的 GLM 适配、Context、Goal Mode、Dynamic Workflows 与权限边界源码分析。运行记录：模型
gpt-6.1-sol，reasoning effortultra，执行入口 Codex Desktop，提供方openai；运行记录中的 CLI 版本0.162.0-alpha.17.2（不代表桌面 App 版本）。
导航补充（2026-10-10，Agent：Codex）：加入中文表达 Skills 比较，区分文章润色与助手对话风格。运行记录：模型
gpt-6.1-sol，reasoning effortultra，执行入口 Codex Desktop，提供方openai；运行记录中的 CLI 版本0.162.0-alpha.17.2（不代表桌面 App 版本）。
导航补充（2026-10-10，Agent：Codex）：加入 REA 的 CLI/MCP、Provider Bridge、JavaScript/Electron 静态分析与 Evidence 架构研究。运行记录：模型
gpt-6.1-sol，reasoning effortultra，执行入口 Codex Desktop，提供方openai；运行记录中的 CLI 版本0.162.0-alpha.17.2（不代表桌面 App 版本）。
导航补充（2026-10-09，Agent：Codex）：加入 Pi
1.1.0框架的包边界、Agent Loop、Session 与 Durable Execution 研究。运行记录：模型gpt-6.1-sol，reasoning effortultra，执行入口 Codex Desktop，提供方openai；运行记录中的 CLI 版本0.162.0-alpha.17.2（不代表桌面 App 版本）。
关联阅读修订（2026-09-09，Agent：Codex）：同步 OpenCode Cloudflare SDK 文章的新标题与阅读重点。运行记录：模型
gpt-6-astra，reasoning effortultra，执行入口 Codex Desktop，提供方openai，CLI 版本0.153.4（不代表桌面 App 版本）。
导航文字修订（2026-09-08，Agent：Codex）：同步两篇测试示范的英文术语与显示标题；加入术语改写规范入口。运行记录：模型
gpt-6-astra，reasoning effortultra，执行入口 Codex Desktop，提供方openai，CLI 版本0.153.4（不代表桌面 App 版本）。
本次导航修订运行记录（2026-09-07，Agent：Codex）：模型
gpt-6-astra；reasoning effort：medium；执行入口：Codex Desktop；提供方：openai；CLI 版本：0.153.4（不代表桌面 App 版本）。参数取自本次任务运行记录，仅对应本次导航修订。
本次清单导航修订（2026-09-07，Agent：Codex）：加入本地 Skills 安装快照入口。运行记录：模型
gpt-6-astra，reasoning effortultra，执行入口 Codex Desktop，提供方openai，CLI 版本0.153.4（不代表桌面 App 版本）。
导航补充（2026-09-08，Agent：Codex）：加入 kapa.ai 文档导入与 Retrieval 接入指南。运行记录：模型
gpt-6-astra，reasoning effortmedium，执行入口 Codex Desktop，提供方openai，CLI 版本0.153.4（不代表桌面 App 版本）。
导航文字修订（2026-09-10，Agent：Cursor）：同步 kapa 文中与 Cloudflare AI Search 的对比范围。模型标识与 reasoning effort 未取得运行记录；执行入口 Cursor。
导航补充（2026-09-09，Agent：Cursor）：加入 OpenCode v2 与 Cloudflare workerd SDK 的交叉阅读。模型
grok-4.6，提供方xAI，执行入口 Cursor。reasoning effort 未取得运行记录。
导航补充（2026-09-09，Agent：Perplexity Computer）：加入 Grok Bot 官方与社区最佳实践指南。运行记录：模型未取得运行记录，reasoning effort 未取得运行记录，执行入口 Perplexity Computer，提供方
perplexity。
2026-09-10 导航补充（Agent：Codex）：加入两个 Grok Build Demo 的 Agent Harness 经验分析。模型
gpt-6-astra，reasoning effortultra，执行入口 Codex Desktop。
2026-09-10 导航补充（Agent：Codex）：加入 Lieflat Charts 最佳实践（初稿：
gpt-6-astra/low）；随后同步实战重写标题（重写：gpt-6-astra/ultra）。执行入口均为 Codex Desktop。补齐导航页元数据，日期依据首次入库记录（2026-08-13），分类为 2026。
导航补充（2026-09-12，Agent：Grok）：加入 Ryze AI Google Analytics MCP 托管端点、九个只读 GA4 工具与自托管选型边界。执行入口 Grok Bot；模型标识与 reasoning effort 未取得运行记录；提供方 xAI。
导航补充（2026-09-12，Agent：Grok）：加入 Cursor Cloud、Grok Bot 与 Linear 在 yindongliang.com 上的开发测试与观测闭环。执行入口 Grok Bot；模型标识与 reasoning effort 未取得运行记录；提供方 xAI。
导航补充（2026-09-14，Agent：Grok）：加入 Grok Bot 用量节省最佳实践（多 Bot 叠乘唤醒、事件优先、外环/内环与社区对照）。执行入口 Grok Bot；模型标识与 reasoning effort 未取得运行记录；提供方 xAI。
修订说明折叠（2026-09-15，Agent：Cursor）：将导航补充与历次修订收入默认折叠的「修订说明」，首条 AI 参与说明与栏目导语保持可见。模型
grok-4.6，提供方 xAI，执行入口 Cursor Cloud。reasoning effort 未取得运行记录。
导航补充（2026-10-07，Agent：Codex）：加入 Codex、豆包工作与 WorkBuddy 的 Work 概念比较。运行记录：模型
gpt-6.1-sol，reasoning effortultra，执行入口 Codex Desktop，提供方openai，运行记录中的 CLI 版本0.162.0-alpha.2（不代表桌面 App 版本）。
导航补充（2026-10-08，Agent：Codex）：加入 Eve 的文件约定、Durable Agent、源码结构与部署边界研究。运行记录：模型
gpt-6.1-sol，reasoning effortultra，执行入口 Codex Desktop，提供方openai，运行记录中的 CLI 版本0.162.0-alpha.2（不代表桌面 App 版本）。
导航重写（2026-10-08，Agent：Grok）：按主题分组重排全部已发布文章并补一句话说明，新增「从这里开始」；去掉两篇未发布草稿的纯文本提及，发布后再挂导航；在 Pi 与 omp 两篇之间、三篇 Grok Bot 相关文章之间补相关阅读链接。只改导航和链接，不改各篇正文。执行入口 Grok Bot；模型标识与 reasoning effort 未取得运行记录；提供方 xAI。
导航补充（2026-10-09，Agent：Codex）：加入 Google ADK 的核心概念、Graph Workflows 与 Python 入门示例。运行记录：模型
gpt-6.1-sol，reasoning effortultra，执行入口 Codex Desktop，提供方openai，运行记录中的 CLI 版本0.162.0-alpha.17.2（不代表桌面 App 版本）。
本栏目讲 Agent 怎样调用工具、在什么授权边界内行动、怎样组织成可复用的工作流，以及怎样验证它做对了。文章按主题分组，每篇附一句话说明它讲什么、适合谁。
从这里开始
- Pi Coding Agent 入门与社区玩法：想在终端里用一个精简、可扩展的 Coding Agent，从这篇开始。
- Grok Bot 实践指南：官方与社区最佳实践、使用方法与适用场景：想把例行工作交给 Agent，先看共享电脑的安全边界、审批模型和哪些场景合适。
Coding Agent 与 CLI
- Pi Coding Agent 入门与社区玩法：Pi 的 Agent 循环、Session、扩展体系和社区 Package，适合想定制自己工作流的人。
- omp：把 Coding Agent 接入 IDE 的开源终端工具：从 Pi 发展而来，把 LSP、DAP 接进终端 Agent，适合习惯终端又想要语义级重构和调试的人。
- pi-hashline-edit-pro：锚点编辑为什么能拒绝过期修改，以及怎么用：Pi 的社区编辑扩展，按锚点改文件，读后文件被改就拒绝写入，附实测输出。
- DeepSeek Harness（dsh）：插件化 Agent Harness 的产品形态与运行原理：「Everything is a Plugin」的 Harness 怎样拼装模型、工具和入口。
- OpenCode v2 在 Cloudflare 上怎么用：使用场景与 SDK 入门：以仓库审查、运维助手和在线编码为例，说明 SDK 的安装、调用步骤与运行边界。
- CLI 栏目：面向 Agent 的命令行工具，重点是授权、预览和确认机制：
- Agently Mail CLI：安装、授权与邮件工作流实践：授权后让 Agent 查、读、发邮件的完整流程。
Harness 与工作流
- Cindy 项目调研：多 Harness 工作台、Orca 与本地执行边界：已有 Claude Code、Codex、Pi 怎样接入统一工作台，以及完整 Worker、手机控制与本地执行的实际边界。
- ZCode 项目分析：GLM 官方 Agent Harness 的架构与执行机制：重点看 Context 压缩、Goal 完成检查、可恢复的动态工作流，以及权限与 OS 隔离的实际边界。
- 从两个 Grok Build Demo 学习 Agent Harness：复用边界、交互架构与验证证据：从两个实验看脚手架复用、状态分层与行为验证。
- Grok Bot 实践指南：官方与社区最佳实践、使用方法与适用场景：共享 Agent Computer、Auto Review 审批、Task → Skill → Routine 演进，以及按可核对性分级的适用场景。
- Grok Bot 用量节省：多 Bot 例行任务与社区对照：多个 Bot 叠乘唤醒的成本问题，事件优先、外环 / 内环分开。
- Cursor Cloud、Grok Bot 与 Linear：以 yindongliang.com 为例的开发测试与观测闭环：一个真实站点上，编排、实现、视觉 QA 和观测怎样分工并回填 Linear。
测试与验证
- Agent 开发中的测试方法：Specification、Test Oracle 与验证证据：测试范围、反例生成、Test Oracle 与 Agent Evaluation 怎样按风险组合。
- Contract Testing：接口兼容、多端功能一致性与 AI Agent 编码：用共享 Specification 约束接口和 iOS / Android 多端行为，再让 Agent 编码。
知识检索与 MCP
- REA 源码与架构分析：Agent 如何连接反编译器、静态分析与运行观察：本地分析工具如何连接反编译器、重建 JavaScript/Electron 关系图，并将结果组织为 Evidence。
- Context7 源码分析：技术架构、MCP 运行原理与检索链路：开源接入层和托管检索的边界，以及 CLI / SDK / Skills 的用法。
- kapa.ai：文档导入、Retrieval 与 Blog 接入流程：四种文档导入方式、Retrieval / Widget / MCP 的边界，并对照 Cloudflare AI Search。
- Ryze AI Google Analytics MCP：托管 GA4 工具、接入方式与选型边界：托管远程 MCP 做 GA4 只读查询，以及什么时候改用官方或自托管方案。
- CoAI.Dev：开源 LLM Gateway 的能力、原理与项目现状：自托管多租户 LLM Gateway 的渠道路由、计费与聊天界面。
概念与产品研究
- OpenFilm 项目分析：Coding Agent 怎样制作、检查与编辑视频：HTML 工程、时间函数、画面检查与人工编辑怎样配合，以及桌面 Agent 的权限和版本边界。
- Pi Agent 框架架构：包边界、Agent Loop 与接入选择：区分模型接口、Core、Coding Agent SDK 与 Pi Durable，附无需 API Key 的真实循环验证。
- Google ADK 入门：Agent、Tools、Session 与 Graph Workflows：Google 的 Agent 开发框架，介绍核心概念、ADK 2.0 工作流与可复现的 Python Tool 示例。
- Agent 产品中的 Work 是什么：Codex、豆包工作与 WorkBuddy：区分工作目标、执行环境与可验收成果，附任务与验收示例。
- Eve 项目研究：文件约定、Durable Agent 与部署边界：约定目录、Workflow 与 Sandbox 分工，以及自托管、认证和恢复边界。
Skills
- Skills 栏目：Matt Pocock Skills、中文表达 Skills、Anatomy、Feishu CLI Skills 与本地 Skills 清单已移到 Skills 栏目。
写作规范
- 技术文档改写规范：固定英文术语、中文解释与 Mermaid 一致性：术语表、正反例、代码与链接边界，以及可复用的分批改写 Prompt。