同一套运行系统，多个产品入口
CLI、IDE、桌面和 Web 可以复用同一套 Agent 核心，但客户端承担不同协作体验。
- 能解释多端复用 Harness 的架构
- 能区分本地与云端 Runtime
- 能设计配置、凭证与历史的同步边界
为什么不能为每个端各写一套 Agent Loop？
多端产品不应为每个入口重新写一套 Agent Loop，否则状态、权限和失败语义会逐渐分裂。更稳妥的做法是复用 Thread、事件、工具和策略等核心语义，再按使用场景设计不同信息密度和控制方式。
本地 Runtime 靠近文件、企业网络和设备凭证；云端 Runtime 适合长任务、弹性算力和离线执行。能在 Web 看见本地任务进度，不等于 Web 获得了本地文件权限。
先记住这句话稳定的双向协议把 Harness 的线程、事件和审批能力暴露给客户端。不同入口复用执行逻辑，同时针对终端效率、IDE Diff、桌面并行和 Web 长任务设计界面。
核心语义一致，入口有意分工
CLI 强调键盘效率和脚本组合，IDE 强调代码、Diff 和诊断位置，桌面端适合并行监督，Web 适合跨设备访问，移动端适合轻量审批和查看结果。
同一 Item 在各端可以采用不同展示，但 completed、failed、awaiting_approval 等状态语义必须一致。
Runtime 决定任务真正在哪里发生
任务路由要检查数据位置、依赖、网络、时长、算力和合规。公司 VPN 内资料无法被任意云 Runtime 访问，本地依赖也不会因为线程可见而自动迁移。
身份、配置、历史、凭证和授权要分别定义同步边界。便利的跨端可见性不能默认为跨设备复制敏感能力。
多端复用的是线程、事件、工具和策略等核心语义，不是复制同一界面。本地 Runtime 靠近工作区和凭证；云端 Runtime 适合长任务与弹性资源，但受网络、依赖和数据边界限制。
通过稳定双向协议提交 Turn、显示事件与响应审批
管理持久线程和每个 Core Session
根据数据、依赖、时长和算力选择本地或云端
分开管理同步配置、设备授权和运行时凭证
有术语没听懂？在这里用人话再看一遍4 个词＋
- Surface
- 用户与 Agent 协作的产品入口，例如 CLI、IDE、桌面、Web 或移动端。
- Runtime
- 工具和任务实际执行的计算环境，可以位于本地、企业网络或云端。
- 任务路由
- 根据数据、依赖、资源和风险把任务分配到合适 Runtime。
- 端能力协商
- 客户端与服务端声明各自支持的事件、控制和展示能力。
IDE 发起、桌面监督、手机批准
用户在 IDE 提交 Bug 修复，在桌面端观察三个并行任务，离开电脑后用移动端回应一次高风险审批。
- 01
线程与事件跨端同步
- 02
本地仓库任务仍由本机 Runtime 执行
- 03
移动端只发送审批决定，不获得本地凭证
不同端各自承担最擅长的协作时刻，而核心任务状态保持一致。
本章依据与证据边界3 条结论 · 5 份原始材料＋
正文已经把关键来源放在相关概念旁边。这里保留完整核验清单：每条材料能支持什么、不能支持什么；不要求离开本站才能继续学习。
- [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
查看全部一手材料与源码证据 5 条
这份材料说明 Codex App Server 如何以双向 JSON-RPC/JSONL 协议把同一 Harness 暴露给 CLI、IDE、桌面与 Web 客户端。它定义 Thread、Turn、Item 及流式事件、审批暂停、持久化和重连语义，是课程讲解 Agent 客户端协议与多端复用的直接实现依据。
固定提交源码 · 核验 2026-07-11Hermes Agent repository and architecture guidanceNous Research这份固定提交的仓库说明展示 Hermes Agent 如何用同一个窄腰核心服务 CLI、TUI、桌面与消息入口，并优先通过 Skills、Plugins 与 MCP 扩展。它还把 Prompt Cache、核心工具数量和扩展 Footprint 当成真实架构约束，说明工具越多并不自动更强。
官方产品实现 · 核验 2026-07-14The evolution of agentic surfaces: building with Claude Managed AgentsClaude by Anthropic这份官方材料定义 Agent、Environment 与 Session 三类生产资源，并说明 Brain/Hands 分离、持久事件、凭证代理、可恢复状态和自托管执行环境。
证据边界：官方自测延迟和客户案例不能直接外推为所有 Agent 产品的 ROI。官方产品实现 · 核验 2026-07-14Hermes Agent SessionsNous Research当前文档说明 Hermes 将完整消息与工具历史保存在 SQLite，会话可恢复和跨端检索，但恢复历史不等于把所有旧字节持续塞回模型上下文。
证据边界：持久会话不自动保证恢复无副作用，也不是隐私删除或长期语义记忆。一线课程案例 · 核验 2026-07-14Free Claude Code CourseFrontend Masters课程由 Claude Code 团队成员 Lydia Hallie 授课，覆盖 CLAUDE.md、权限、Skills、Hooks、Subagents、Plugins、MCP 和 Desktop 的操作语境。
证据边界：讲师身份与演示成功不等于 Anthropic 官方产品合同或普遍架构结论。