从电脑发出“继续整理这次构建的测试结果”,切到手机后看见一半输出。假设手机随后发出“先停止,别生成报告”,却恰好在按下发送后断网。恢复连接时,最难回答的不是消息有没有显示,而是:原来那次工作还活着吗?停止指令有没有被宿主接收?还有哪些动作已经发生,只是界面没收到结果?如果产品用同一个转圈图标回答这三个问题,用户就很难判断应该等、重试,还是先去检查已经生成的文件。
GitHub 工程团队在 2026 年 11 月 17 日介绍了 Agent Host Protocol(AHP),以及它如何用于 GitHub Copilot 的跨端会话。对自行开发智能体应用的团队,更有价值的是把三件常被混称为“续跑”的能力分开:恢复一个界面的视图、接上还活着的工作、在执行进程消失后重建工作。同一个会话 ID 可以出现在三种场景里,却不能替三种场景提供相同保证。
关掉编辑器以后,谁还拥有这次执行?
GitHub 的文章解释了旧有编辑器扩展的限制:当智能体的运行环境与某个编辑器窗口绑定,窗口关闭或编辑器升级重启时,换一个终端访问同一段历史并不能把旧窗口里的活跃任务接过来。把执行移到生命周期独立的宿主,视觉界面就可以更换,而队列、回合、状态和执行结果不必跟着某个窗口一起消失。这里的“独立”不是指必须上云。只要服务不随该窗口退出,同一台电脑上的独立进程也能做到这一点;但如果电脑休眠,远程设备仍不能指望它会继续处理。
AHP 把资源放在由 URI 标识的频道中。根频道是入口,会话和聊天频道承担不同粒度的状态,宿主对状态负责,客户端发送操作、接收宿主确认的状态变化。GitHub 的工程说明把状态更新描述为基于 reducer 的模型:客户端按宿主发出的操作更新视图,不能把本地刚显示出来的按钮变化当成宿主已经接收的证据。这使带有不同界面能力的设备能看到同一份会话状态,而不必复制每个客户端自己的工作流实现。它不是模型推理协议,也不决定模型何时该调用工具。
如果需求其实只是“另一台设备看完记录”,同步已经完成的会话记录即可。持久化转录加分页读接口不要求运行中任务能被查看或干预,技术和运维成本低很多。反过来,如果读者必须在设备 B 审核设备 A 发起的运行,或能临时终止它,那么只有历史记录不够:产品要明确连接哪个宿主、在操作中指明哪个回合,还要定义回合已结束时如何拒绝迟到的操作。把历史阅读和实时控制分开,可以在首版只交付前者,也不误导用户对后者的期待。
重连补回的是状态,不是执行能力
看 AHP 生命周期规范的重连章节,普通订阅的客户端断线后,会用客户端标识、曾见到的服务端序号和需要恢复的订阅发起重连。宿主还能覆盖缺口时,返回漏掉的操作;缓冲不够时,改发当前资源快照及其序号。若请求的资源已释放或无权再看,不能拿留在设备里的旧画面继续充当可控制的对象。对使用窗口化订阅的客户端,规范另有独立的游标与恢复路径,不应把普通订阅的连接级序号直接套过去。
短暂断网后恢复视图是一例:电脑已经看到序号 41,宿主继续发出 42 到 44,回来后客户端把这几个变更按宿主顺序应用,页面就追上了。另一个例子是客户端离线很久,内存只剩最后一小段操作。此时不必为一次掉线无止境保存全部中间输出,而应以有基线序号的新快照替换该频道的旧视图,再接后续动作。客户端也得重新读取会话列表:普通订阅上的临时通知不参与重放,别把“聊天内容回到了最新”当成“侧栏没有漏掉新增、删除或摘要变化”的依据。实际界面最好允许正文和侧栏各自完成同步,不要设一个全局的“已恢复”标志来替代它们。
快照还不是回执。它通常回答“这个资源当前是什么样”;如果界面上的文字变化来自另一个设备,单看结果相似,不足以证明本机刚才排队的操作被接受。反过来,临时的编辑或撤销也可能使动作的效果在快照里看不出来。实现时可让当前状态与待确认操作分开显示,在用户关心的动作上留出确认或对账手段。快照能不能消解某条待确认项,取决于产品有没有留下可关联记录,不能靠比对两个字符串碰运气。
从按下发送到操作生效,中间至少有两个问题
AHP 的 Swift 客户端指南 对出站队列的示例值得仔细读。它描述的是一种异步确认:发出的通知不是 RPC 成功响应,客户端可在后续实时或重放收到的操作信封中,以来源的客户端 ID 和客户端序号关联确认。应用可以维护自己的待发送队列,重连后按动作类型决定是否重发。指南将这层策略留给应用,因而不能据此声称任何工作都恰好执行一次。
在界面上,可以把用户输入拆成三步。第一步是本机已记录,手机断网时仍能显示该条内容,但给它一个明确的“待宿主确认”状态。第二步是宿主确认了对应操作,这时输入可以从出站队列移开;确认接收不等于智能体已经把它执行完。第三步是目标回合实际取消、完成或失败,这来自相应的宿主状态,不应由输入的发送回执推断。以“停止”举例,用户可能在得到接受回执之前看到回合已经结束,也可能在回合进入取消阶段时还看到先前已经产生的输出。比较可靠的界面要分别表达输入状态和回合状态。
并非所有操作都适合自动重发。终端视图的尺寸调整,晚来的旧值可能覆盖刚刚设置的新值,通常只保留最新意图更合适;聊天追加若可稳定关联到当前回合,仍需知道重复发出时宿主会怎样处理;会改变外部状态的操作,若只知道曾经发过请求但找不到接收或结果证据,则更适合先对账或请用户决定。一个直接的设计是为有实际后果的动作提供独立操作 ID 和可再次查询的结果,由执行端决定幂等语义,而不把传输层的序号当作外部操作结果的唯一证明。包括日志和提示在内,避免把不确定状态翻译成“没执行”。
还要考虑冲突:手机所见的任务仍在等待,电脑端已经修改了目标并启动了新的回合。手机这时点“停止”,如果消息只含会话 ID,宿主可能将旧意图应用到新的活跃回合。将指令绑定到观察时的具体目标和前置状态,让宿主校验后拒绝不匹配的请求,可以让旧客户端刷新后再操作。这是产品层的建议,不是说 AHP 对每种业务指令都规定了同一种并发控制。对审批也一样:两端不能分别把“按钮已点”算作两次有效批准,应该以宿主是否接受了针对同一目标的决定为准。
宿主进程退出后,先查证据再决定是否重跑
生命周期规范对意外退出给了不同的边界:宿主环境可以尝试重启服务,但进行中的回合应视为失败。客户端在重启后仍可按重连流程连接,并不意味着原执行从任意一行继续。一家产品若要额外保证从上个检查点恢复,需要单独建设恢复策略,包括另存执行阶段、持久化必要输入、处理上一次副作用,以及定义恢复后的回合身份。即使在产品上复用一个会话,执行上的新旧尝试也应能区分。
可以想象一个只生成本地报告的任务。前一回合在写完报告后、登记完成前退出。按“回合失败”刷新页面是正确的,但由此断定“报告没生成”就是另一回事。若维护者能根据操作 ID 找到已经存在的产物,并确认它对应正确输入,则可以让用户采用这份结果,而不是再生成同名文件;如果证据不全,给出明确的未知状态和检查路径,比展示一个自动重试按钮更负责任。读取记录的权限也要与发起控制的权限区分,不能因为设备能打开旧会话,就默认它能在新的宿主上继续发命令。
保持宿主独立也带来日常成本。团队得决定没有任何客户端在线时任务能跑多久,谁负责清理空闲会话,宿主重启如何通知订阅端,什么时候回收资源。当保留的操作包含细粒度输出时,容量更应按最忙频道的实际数据量估算,不是简单按会话数估算。对于只有一个本地界面、任务几秒内结束且失败可安全重做的产品,拆出长期运行宿主未必划算;对要持续几小时、会被多端接力查看的工作,则可把会话所有权和目标回合的证据优先设计出来,再考虑接哪种传输或客户端库。
用四个断点验证自己的产品语义
下面是一个无依赖 JavaScript 模型。它把宿主代次、服务端序号、当前回合和待确认输入分开,用长度为二的操作缓冲缩短实验。把代码保存为 ahp-model.js,可用 Node.js 运行;本文用独立 JavaScript 运行器实际执行了同一代码,四项断言通过。示例没有接入 AHP 实现、Copilot 或真实网络,不是对线上互通的测试。代次和按键去重是这个模型的设计,不是对 AHP 消息字段或生产幂等保证的描述。
let epoch = 1, seq = 0, turn = "running", recent = [];
const accepted = new Map();
function emit(kind) {
const entry = { seq: ++seq, kind };
recent.push(entry);
if (recent.length > 2) recent.shift();
return entry.seq;
}
function accept(clientId, clientSeq) {
const key = JSON.stringify([epoch, clientId, clientSeq]);
if (!accepted.has(key)) accepted.set(key, emit("accepted"));
return accepted.get(key);
}
function read(clientEpoch, cursor) {
if (clientEpoch !== epoch) return { kind: "new-host", turn };
if (cursor < seq - recent.length) return { kind: "snapshot", seq, turn };
return { kind: "replay", seqs: recent.filter(x => x.seq > cursor).map(x => x.seq) };
}
function check(pass, label) {
if (!pass) throw new Error(label);
console.log(label);
}
emit("delta");
const ack = accept("phone", 7);
check(ack === 2 && accept("phone", 7) === 2 && seq === 2, "same-host duplicate");
check(read(1, 1).seqs.join(",") === "2", "short gap replay");
emit("delta");
emit("delta");
check(read(1, 1).kind === "snapshot" && read(1, 1).seq === 4, "old cursor snapshot");
epoch++; seq = 0; recent = []; accepted.clear(); turn = "failed";
check(read(1, 4).kind === "new-host" && read(1, 4).turn === "failed", "unfinished turn failed");
第一项模拟手机错过确认后又尝试发送相同序号,本示例按当前宿主代次和客户端身份只记一次。第二项让客户端从序号 1 接回,只补到序号 2。连续推进到 4 以后,序号 1 的缺口超出保留范围,因此第三项不返回不完整的重放,而给快照。最后换宿主,旧序号不参与新宿主比较,示例只报告旧工作未完成,不暗中代用户开一个新回合。真实应用不能只照搬这个内存映射:要验收的另外两条是“快照没有相应回执时仍保留待确认项”和“宿主端返回目标已不存在时,设备不再展示可以重试的旧控制按钮”。
可以把这些断点直接转成一次上线前演练。第一轮不关闭宿主,只切断设备网络,然后用同一回合 ID 验证恢复结果。第二轮让输出超过缓冲、同时从另一端新建会话,观察聊天和会话列表是否分别赶上。第三轮只丢弃出站确认,确认待发送项不会被误标已完成。第四轮在一个无害、可核查的操作前后各终止一次宿主,比较页面看到的失败和外部看到的产物;记录两者什么时候各自确定,什么时候必须留为未知。一个流程只有在这些场景里都能让操作者知道下一步该做什么,才值得被称为可以跨端接续。跨端同步的第一条承诺应该是如实告诉用户工作在哪里、有没有继续,而不是让所有断线在界面上都显得没有发生。
评论
暂无评论。