指南总览

指南按能力域组织，是当前 Cody 3.0 公共行为的查阅入口。历史迭代文档不作为 API 规范。

Runtime 与生产运行

Canonical RuntimeRun 生命周期、Workflow、审批、恢复、多 Agent、Quality Gate 与 Store。

生产部署SQLite/PostgreSQL、S3/MinIO、进程模型、安全边界和上线清单。

观测与故障处理Timeline、metrics、checkpoint、artifact、audit 与恢复决策。

产品入口

Python SDK客户端、Builder、流式、事件、工具、会话和高级注入点。

CLI单次任务、交互会话、Runtime 控制、审批、Artifact 和 Timeline。

TUI全屏终端界面、快捷键、流式显示与会话恢复。

HTTP / WebSocketAgent、Runtime、会话、审批和实时事件端点。

配置、安全与扩展

配置参考加载优先级、环境变量、权限、安全、重试和上下文压缩。

Sandbox后端选择、文件/网络策略、secret、资源限制与恢复。

SkillsAgent Skills 开放格式、加载优先级、验证、分发和 SDK 使用。

架构组件职责、canonical data flow、依赖方向和信任边界。

功能清单当前能力、安装方式、完整工具表与明确边界。

如何判断一项能力是否适合生产

不要只看类名是否存在。至少确认：

1. 执行是否经过 canonical Runtime，而非旁路调用。
2. 状态是否写入 durable store，服务重启后能否恢复。
3. 外部副作用是否有幂等键或收据。
4. secret 是否留在可信宿主且不会进入 event/artifact/audit。
5. 目标部署环境是否真实演练过 Sandbox、数据库和对象存储。

想边做边学？

从教程路线开始。教程会把这些能力组合成可验证的端到端场景。