同一个 Agent 怎样服务 CLI、IDE 与桌面端？
教学案例：用户在桌面端发起登录超时修复，在 IDE 里检查 Diff，又在手机上批准是否继续运行耗时测试。三个入口看到的是同一任务，而不是三份互不相干的聊天。
多端产品应复用任务、事件、权限和终态，再按场景设计不同界面。入口是用户在哪儿看和操作，运行环境是代码与工具真正在哪台机器执行；两者必须分开。
能在手机上看到本地测试进度，不等于手机获得了项目文件或本机凭证。跨端同步状态，不应顺便复制能力。
稳定的双向协议把 Harness 的线程、事件和审批能力暴露给客户端。不同入口复用执行逻辑，同时针对终端效率、IDE Diff、桌面并行和 Web 长任务设计界面。
多个端怎样看到同一个任务事实？
任务线程（Thread）保存长期任务，工作回合（Turn）保存一次用户驱动的工作单元，事件项（Item）保存按序发生的消息、工具、审批与结果。客户端只是渲染这些事实。
- 事件项 01（Item）用户消息
- 事件项 02（Item）搜索工具调用
- 事件项 03（Item）搜索结果
- 事件项 04（Item）写入审批
- 事件项 05（Item）改动对比
- 事件项 06（Item）测试结果
- 客户端 A（Client A）
收到事件 128 后断线
- 运行环境（Runtime）
任务继续等待审批，没有重复启动
- 客户端 B（Client B）
提交事件项 04 的批准结果
- 任务服务（App Server）
持久化事件 129–135 与终态
- 客户端 A（Client A）
用游标 cursor=128 补取缺失事件并恢复
恢复结果：两个客户端看到同一工作回合（Turn）；工具没有重复执行。
核心语义一致，入口有意分工
CLI 强调快速输入和脚本组合，IDE 强调代码、Diff 和错误位置，桌面端适合监督多个任务，移动端适合轻量审批和查看结果。
同一 Item 在各端可以采用不同展示，但 completed、failed、awaiting_approval 等状态语义必须一致。
Runtime 决定任务真正在哪里发生
任务路由要检查数据位置、依赖、网络、时长、算力和合规。公司 VPN 内资料无法被任意云 Runtime 访问，本地依赖也不会因为线程可见而自动迁移。
身份、配置、历史、凭证和授权要分别定义同步边界。便利的跨端可见性不能默认为跨设备复制敏感能力。
一次登录超时修复的三个入口
桌面端接收任务并显示搜索过程；IDE 打开待改的两个文件，让用户逐行检查 Diff；移动端只展示“准备运行相关测试”的影响、预计时长和允许或拒绝。
项目文件和命令始终留在本地运行环境。手机同步的是审批事件和测试摘要，不下载源码，也不继承本机权限。
端能力协商与优雅降级
不同端不会永远同步升级。旧版移动端遇到新事件时可以忽略未知字段，不支持 Diff 的端可以退回文件级摘要；但完成、失败和等待批准的语义必须一致。
把这些约定写进验收清单，多端才算同一个产品：新增事件类型时旧端不崩溃；任何端展示的终态都与服务端事实一致；敏感数据只在授权的 Runtime 内流动，跨端同步的是状态，不附带能力。
实现对照 · DeepSeek Harness
为什么不能只保存聊天气泡？
这一设计让我们可以问：模型当时究竟拿到了哪些资料？一次失败是发生在工具执行前，还是结果回传后？取消的是本轮工作，还是整个会话？这些问题无法仅靠最后一句答案解释。
产品判断：让界面状态、可恢复记录与真实业务结果各自有清楚的含义。
固定源码观察 · 核验 2026-09-11。业务迁移为本站分析。
本课术语，放回情境理解
- Surface
- 用户与 Agent 协作的产品入口，例如 CLI、IDE、桌面、Web 或移动端。
- Runtime
- 工具和任务实际执行的计算环境，可以位于本地、企业网络或云端。
- 任务路由
- 根据数据、依赖、资源和风险把任务分配到合适 Runtime。
- 端能力协商
- 客户端与服务端声明各自支持的事件、控制和展示能力。
本课依据与证据边界
正文引用对应下面的具体结论。厂商资料、固定版本实现与本站解释分别标识。
- [1]
OpenAI 将 App Server 公开为让不同客户端复用 Codex Harness 能力的接口案例。
官方事实OPUnlocking the Codex harness: App Server官方工程文章 · 核验 2026-07-14 - [2]
OpenAI Codex 文档呈现 Codex 的具体产品入口与使用方式；这些入口属于 Codex 产品形态。
官方事实OPCodex CLI documentation官方文档 · 核验 2026-07-14 - [3]
本站的多端能力矩阵和 Runtime 路由规则是通用产品推演，不代表 OpenAI 内部完整架构。
本站推演OPUnlocking the Codex harness: App Server官方工程文章 · 核验 2026-07-14 - [4]
登录超时修复的三端协作情节为本站教学案例，用于演示核心状态复用与端侧分工，不来自 OpenAI 的产品文档。
本站推演OPUnlocking the Codex harness: App Server官方工程文章 · 核验 2026-07-14 - [5]
旧客户端忽略未知字段、终态语义跨端一致等验收条目是本站教学推演。
本站推演OPCodex CLI documentation官方文档 · 核验 2026-07-14
按需查阅的原始材料
- DeepSeek Harness：子任务、提供方与生命周期 ↗DeepSeek · 核验 2026-09-11
- Codex as a platform：把 Agent 放进业务产品 ↗OpenAI · 核验 2026-09-11
- Unlocking the Codex harness: how we built the App Server ↗OpenAI · 核验 2026-07-23
- Grok Build is Now Open Source ↗xAI · 核验 2026-07-16
- Grok Build repository map（固定提交） ↗xAI · 核验 2026-07-23
- Hermes Agent repository and architecture guidance ↗Nous Research · 核验 2026-07-23
- The evolution of agentic surfaces: building with Claude Managed Agents ↗Claude by Anthropic · 核验 2026-07-23
- Hermes Agent Sessions ↗Nous Research · 核验 2026-07-14
- Use Claude Code Desktop ↗Claude by Anthropic · 核验 2026-07-23