Overview
AI 参与说明（Agent：Codex）：本页由 Codex 协助整理，用于导航与归类 Agent、CLI 和自动化工具相关的公开技术文档；具体能力、版本与安全边界以各篇文章的一手来源和整理日期为准。
修订说明
导航补充（2026-10-28，Agent：Codex）：加入 Continue 的 IDE / CLI 架构、Agent Loop、FIM Autocomplete、代码修改应用与旧 Codebase 检索分析，使用 Context7 核对官方文档。执行入口 Codex Desktop；完整模型标识与 reasoning effort 未取得可核验的任务级运行记录。
导航修订（2026-10-28，Agent：Cursor）：DeepSeek Harness 条目不再指向已撤下的 Anatomy 交互图。执行入口 Cursor Cloud。模型
grok-4.7-high-fast，提供方 xAI。reasoning effort 未作为独立字段取得运行记录。
导航补充（2026-10-27，Agent：Codex）：加入 DeepSeek Harness 的 Cordis 插件架构、生命周期实测与 Anatomy 交互图解。执行入口 Codex Desktop；完整模型标识与 reasoning effort 未取得可核验的任务级运行记录。
导航补充（2026-10-27，Agent：Cursor）：加入 Cindy 当前提交的输入路径分析，从
maker:input:enqueue追到 Claude Code、Codex 与 Pi 的传输差异。执行入口 Cursor Cloud。模型grok-4.7-high-fast；reasoning effort 未作为独立字段取得。提供方 xAI。
导航补充（2026-10-26，Agent：Cursor）：加入 Railway Cloud Agents 与 OpenCode 的连接说明，区分个人开发 VM、Service 部署和 OpenCode Console。执行入口 Cursor Cloud。模型
grok-4.7-high-fast；reasoning effort 未作为独立字段取得。提供方 xAI。
导航补充（2026-10-23，Agent：Codex）：加入 Cloudflare Agents SDK 独立指南，说明持久业务对象、事件处理、实时同步与模型 SDK 的分工。执行入口 Codex Desktop；完整模型标识与 reasoning effort 未取得任务级运行记录。
导航补充（2026-10-23，Agent：Codex）：加入 TanStack AI 1.0 与 AI SDK 7 的机制和能力对比，区分工具循环、界面事件与持久执行。执行入口 Codex Desktop；完整模型标识与 reasoning effort 未取得任务级运行记录。
导航补充（2026-10-22，Agent：Codex）：加入 Hive 源码分析，解释 Queen/Worker 共用循环、Tracker 状态、Playbook 收敛及恢复边界。执行入口 Codex Desktop；完整模型标识与 reasoning effort 未取得任务级运行记录。
导航补充（2026-10-22，Agent：Codex）：加入 OpenUI 概念与使用研究，区分 Generative UI、Agentic UI、A2UI 和 AG-UI，并比较组件描述、事件连接及工具界面交付；shadcn 作为 integration 案例。运行记录：模型
gpt-6.1-sol，reasoning effortultra，执行入口 Codex Desktop。
导航修订（2026-10-22，Agent：Codex）：更新 REA 条目的源码基线与阅读重点，补充 6.7.0 全面源码分析、Worker/Provider 生命周期及本地构建运行指南。运行记录：模型
gpt-6.1-sol，reasoning effortultra，执行入口 Codex Desktop。
导航补充（2026-10-21，Agent：Grok Bot (Blog)、Cursor）：在 CoAI.Dev 条目旁加入 New API 与前端技术栈 LLM Gateway 的选型对照，文章在 App 栏目。执行入口 Cursor Cloud。模型与 reasoning effort 未取得运行记录。
导航补充（2026-10-20，Agent：Codex）：加入 Ruflo 的 Agent 协调、实际执行、记忆窗口和反馈学习分析。执行入口 Codex Desktop；模型与 reasoning effort 未取得任务级运行记录。
导航补充（2026-10-20，Agent：Codex）：加入 Rakazo 源码分析，沿消息受理、后台执行、审批恢复与多端同步定位实现。执行入口 Codex Desktop；模型标识与 reasoning effort 未取得任务级运行记录。
导航补充（2026-10-17，Agent：Codex）：加入 Sign in with ChatGPT 的订阅额度授权说明，区分 Devin 的 ChatGPT plan usage、应用周上限与 credits 开关。运行记录：模型
gpt-6.1-sol，reasoning effortultra，执行入口 Codex Desktop，提供方openai；CLI 版本0.163.0-alpha.10.2（不代表桌面 App 版本）。
导航补充（2026-10-17，Agent：Codex）：更新 Mastra 条目的使用入口，覆盖空项目创建、业务 Tool / Agent、Studio 调试、Client 与审批 Workflow 接入。运行记录：模型
gpt-6.1-sol，reasoning effortultra，执行入口 Codex Desktop，提供方openai。
导航补充（2026-10-16，Agent：Codex）：加入 Mastra 的功能源码地图、Agent Loop、Workflow 与暂停恢复原理分析，并提供正文内 Snapshot 与恢复数据实验。运行记录：模型
gpt-6.1-sol，reasoning effortultra，执行入口 Codex Desktop，提供方openai。
导航修订（2026-10-16，Agent：Codex）：更新 REA 条目的 MDX 来源和阅读重点，补充核心调用链、CLI/MCP 使用及 IPC 配对说明。运行记录：模型
gpt-6.1-sol，reasoning effortultra，执行入口 Codex Desktop，提供方openai。
导航补充（2026-10-13，Agent：Codex）：加入 HeroUI Agents 的托管助手、Generative UI、Client Tools、商业边界与产品形式研究，说明工具数据、组件约束与增量描述的关系。运行记录：模型
gpt-6.1-sol，reasoning effortultra，执行入口 Codex Desktop，提供方openai。
目录调整（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 的安装、调用步骤与运行边界。
- Railway Cloud Agents 与 OpenCode：连接云端开发机：OpenCode 2 连上一台持久 Railway VM 的安装、命令和 sleep 计费，并和 Service 部署、OpenCode Console、Cursor Cloud Agents 分开。
- CLI 栏目：面向 Agent 的命令行工具，重点是授权、预览和确认机制：
- Agently Mail CLI：安装、授权与邮件工作流实践：授权后让 Agent 查、读、发邮件的完整流程。
Harness 与工作流
- DeepSeek Harness：为什么一切皆插件：Cordis 的持续依赖、资源回收、能力接缝与双端 UI 组合，附源码实验。
- Cloudflare Agents SDK：使用方式、业务场景与运行机制：理解具名 Agent、持久状态、RPC、实时同步和调度，以及何时需要接入模型 SDK。
- Hive 源码分析：Queen、Tracker 与 Playbook 如何组织长期 Agent 工作：从试跑、Skill 到共享 SQLite 台账和批量派工，附无需模型的收敛实验与恢复边界。
- Ruflo 项目分析：Agent 编排、记忆学习与执行边界：追踪 CLI、MCP、实际执行器与反馈学习，并交互观察 Memory 的候选窗口和混合评分。
- Rakazo 源码分析：持久 Agent、任务恢复与多端协作：从
threads.send追踪持久状态、Worker、Pi 与 ExternalEffect，解释保存的审批记录如何约束恢复动作。 - Mastra 项目原理：Agent Loop、Workflow 与状态恢复：从创建项目、Studio 调试与应用接入开始，再追踪模型调用、工具结果、Snapshot 与 Step 恢复。
- Cindy 源码分析：一次用户输入如何进入 Harness：沿 2026-10-27 固定提交，看输入队列、lazy-create 和 Claude Code、Codex、Pi 三种传输。
- Cindy 项目调研：多 Harness 工作台、Orca 与本地执行边界：已有 Claude Code、Codex、Pi 怎样接入统一工作台，以及完整 Worker、手机控制与本地执行的实际边界。
- ZCode 项目分析：GLM 官方 Agent Harness 的架构与执行机制：重点看 Context 压缩、Goal 完成检查、可恢复的动态工作流，以及权限与 OS 隔离的实际边界。
- Continue 源码分析：IDE、Agent Loop 与 FIM Autocomplete 如何协作：区分 IDE 与 CLI 循环，追踪 Context、工具结果反馈、补全与代码应用，并说明旧 Codebase 检索的弃用边界。
- 从两个 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 如何连接反编译器、静态分析与运行观察：基于 6.7.0 固定源码，追踪 CLI/MCP、四类原生 Provider、Worker 与 Evidence 的完整链路，并按实测步骤本地构建、运行静态 CLI 和连接 MCP。
- 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 的渠道路由、计费与聊天界面。
- New API 与前端技术栈 LLM 网关开源选型：对照 New API 与 Node.js / TypeScript 为主的开源 LLM Gateway，并标出高星但不同品类的项目。
概念与产品研究
- TanStack AI 1.0 与 AI SDK 7：机制、能力与工程选型：比较模型接口、工具执行、前端状态和恢复机制，附两套离线工具循环示例。
- OpenUI：概念、使用方式与 Generative UI 方案比较：组件包装、流式渲染、业务操作边界，以及 A2UI、AG-UI、json-render 等方案的分工。
- Sign in with ChatGPT：Devin 如何使用订阅额度与 credits：登录、订阅用量和 credits 的三层权限，以及官方开发者接入入口。
- HeroUI Agents 产品研究：托管助手、Generative UI 与产品交付形式：区分组件资产、应用生成与应用内助手，分析 Catalog、工具桥接、运营与 beta 采用边界。
- 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。