云端代理适配器

云端与后台代理——Claude Code 远程任务、OpenAI Codex 云端、Jules 类代理及类似的异步执行环境——在设计上是临时性的：一次会话启动、运行有限时长，然后终止。DWP 将这一限制转化为优势，使计划成为持久产物，而非会话。

核心洞察

代码仓库的 .dwp/ 目录是持久的规范与状态层。云端会话是临时的执行者。计划告诉执行者该做什么；state.json 告诉它从哪里续行。会话可以是任何东西——不同的模型、不同的提供商、全新的容器——计划将从上次离开的确切位置继续。

支持级别

完整（已文档化）—— 云端代理平台读取 AGENTS.md 或原生指令，并通过其终端或容器环境执行命令。

唤醒-续行-让出循环

每次云端代理轮次遵循以下模式：

1. 唤醒 —— 会话启动（由 cron 计划、CI 事件或用户操作触发）。
2. 运行 DWP 恢复协议 —— 读取计划 README，定位检查点，通过 ledger.py project 从 journal.ndjson 重构状态，检查接缝，运行冒烟测试。参见 DWP specification。
3. 检查阻塞状态 —— 若 state.json.blocked 已设置，报告原因并让出，不执行任何操作。
4. 执行下一个原子任务 —— 一项任务，通过其完整的验证关卡。
5. 记录至日志 —— 通过 ledger.py 动词（start、gate、complete）向 journal.ndjson 追加事件；ledger.py project 原子性更新派生的 state.json 快照投影。在旧版 v5 计划中，保留直接的状态文件更新方式。
6. 让出 —— 会话干净地终止；下一轮次从更新后的状态继续。

要求

• 计划 MUST 携带机器可读状态层（manifest.json + state.json）。没有它，临时会话将无法可靠地确定续行位置。参见 Plan state。
• 在任何无人值守的云端轮次之前，计划 MUST 已由人类审批。计划审批是控制点。
• 代理在受限权限范围内运作：它 MUST NOT 扩展范围，不得执行计划未明确授权的破坏性或对外操作，也不得将任务的指令延伸以涵盖已发现但未计划的工作——已发现的工作应记录以备下次 refine，而非即兴发挥。参见 Agent protocol。

备注

云端代理会话是无人值守执行配置文件的极端情形：零会话连续性，计划持久性最大化。DWP 的 .dwp/ 目录正是专为此而设计的——代理开始、继续和完成一项工作所需的全部状态，均以任何会话都能从全新检出读取的纯 Markdown 与 JSON 文件的形式存在。