远程 Agent 控制要定义执行协议与状态模型

更新于 2026-07-05

**做「手机/网页远程指挥服务器里的 Claude Code/Codex」这类产品，只画 App 页面是不够的。必须在 PRD 里定清两块：App 与服务器之间的「执行控制协议」，以及服务器要保存的「状态模型」。否则两端各写各的，后面接不起来。**

一、执行控制协议

规定 App 发什么、服务器回什么，而不是只说「发送消息」。要有明确的消息类型 + 字段 + 流程：

  • 怎么创建会话、怎么发送消息
  • 怎么表示运行开始、怎么流式返回内容（assistant_delta / tool_output）
  • 怎么表示完成/失败、怎么取消任务
  • 怎么请求文件树、出错时返回什么

二、服务器状态模型

规定服务器保存哪些实体及关系：

Session 会话
  └── Message 消息
  └── Run 执行任务
        └── Event 流式事件

一个 Session 有 workspace、activeRunId 等；一个 Run 是一次 Claude Code/Codex 执行，带 status、tool。

相关