Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。
TypeScript agentai-agentai-assistantandroidclaude-codecodexelectroniosllmmacosreact-nativetypescriptwindows
test(orca): 补充多设备故障隔离与恢复契约
DavidShenbf01bb4cc1d4
diff --git a/apps/desktop/src/main/maker-ipc/__tests__/orcaRemoteWorkerRuntime.test.ts b/apps/desktop/src/main/maker-ipc/__tests__/orcaRemoteWorkerRuntime.test.tsindex 4213579008..c8277ac091 100644--- a/apps/desktop/src/main/maker-ipc/__tests__/orcaRemoteWorkerRuntime.test.ts+++ b/apps/desktop/src/main/maker-ipc/__tests__/orcaRemoteWorkerRuntime.test.ts@@ -568,4 +568,27 @@ describe('orca remote worker runtime', () => {expect(deps.onTurnEnded).not.toHaveBeenCalled();expect(deps.saveReport).not.toHaveBeenCalled();});++ it('keeps another peer reporting while one execution device is offline', async () => {+ const { runtime, deps, invoke, state } = setup();+ runtime.untrack('proxy-1');+ const pendingReport = { clientIds: ['c-1'], baselineMessageId: null };+ runtime.track({ ...ref, pendingReport });+ runtime.track({ ...ref, workerId: 'worker-2', proxySessionId: 'proxy-2', deviceId: 'other-pc',+ remoteSessionId: 'remote-2', pendingReport });+ state.receipts['c-1'] = 'accepted';+ state.assistant = { id: 'reply-1', content: 'Other peer result' };+ const original = invoke.getMockImplementation()!;+ invoke.mockImplementation(async (deviceId, channel, args) => {+ if (deviceId === 'mac-mini') throw new Error('[DEVICE_OFFLINE] disconnected');+ return original(deviceId, channel, args);+ });+ await runtime.pollNow();+ expect(runtime.isReachable('proxy-1')).toBe(false);+ expect(runtime.hasPendingReport('proxy-1')).toBe(true);+ expect(runtime.isReachable('proxy-2')).toBe(true);+ expect(runtime.hasPendingReport('proxy-2')).toBe(false);+ expect(deps.onTurnEnded).toHaveBeenCalledOnce();+ expect(deps.onTurnEnded).toHaveBeenCalledWith('proxy-2', { status: 'done', finalText: 'Other peer result' });+ });});diff --git a/docs/dev-rules/orca-team-architecture.md b/docs/dev-rules/orca-team-architecture.mdindex 836a08861f..827fd54ff5 100644--- a/docs/dev-rules/orca-team-architecture.md+++ b/docs/dev-rules/orca-team-architecture.md@@ -388,6 +388,14 @@ Worker turn 被 vendor 报终止型 error,但 interrupted-turn auto-resume 仍### 测试与回归清单+远端回报身份在 enqueue 前保存于 `orca_workers.pending_remote_report`,恢复时重建 TeamService+待回报身份;同一数据库 owner 的重复启动不清空派活。只有 Lead 接受回报或该捕获身份已被+结清/替换后,才原子更新去重游标与对应等待记录;拒收或落盘失败继续重试,不清掉新派活。+结束协同不依赖缓存 running:先确认停止并保存 `remote_stop_confirmed_at`,再解除协同标记;+清理单飞且读取最新阶段,后续只补未完成阶段。归档提交成功后才取消远端路由。+创建回执丢失时使用同一 sessionId 核对,未确认身份保存在 `orca_remote_opens`;孤儿清理与+Worker 关联共用任务锁,锁内复查后仅解除未关联标记,保留任务、文件及用户发起的工作。+当前文档要求保留以下回归方向:- Service 边界:`orcaLifecycleService`、`orcaWorkerCreationService`、`orcaTeamService` 的单测覆盖 start/enable/create/dispatch/idle/archive/auto-bridge 关键路径。diff --git a/docs/dev-rules/remote-and-mobile-adaptation.md b/docs/dev-rules/remote-and-mobile-adaptation.mdindex 04a6b0bd01..3b28ab1d09 100644--- a/docs/dev-rules/remote-and-mobile-adaptation.md+++ b/docs/dev-rules/remote-and-mobile-adaptation.md@@ -90,15 +90,20 @@ relay 以 close 1013 `inbound backpressure` 主动断连,此时任何「立即1. **故障层级**:单台运行设备的单个请求。轮询或派活失败只把这台设备标为「暂时无法获取状态」,Worker 不判失败、不重派;下一轮成功即恢复,并按消息 id 补报缺失的回报。派活时设备不可达直接失败,- 不排队、不重试;`enqueue` 回执丢失时只查一次投递回执,不盲重发。+ 不排队、不重试;`enqueue` 前保存派活身份,回执丢失时先核对投递回执,不盲重发。+ 重启后恢复待回报身份;unknown 回执须核对历史,有限轮次仍找不到时明确报告执行未确认。2. **动作层级**:只影响这台设备上的远端 Worker;不重建 link、不断开 relay,不影响其它设备与普通远控。- 结束通知(release)送不到时留待重连或 5 分钟后低频补发。+ 结束时先确认停止并落盘,再发 release;重连或 5 分钟补发只继续未完成的阶段。+ 清理共用单 Worker 入口并读最新阶段,不能因迟到快照重复停止用户后续的普通任务。+ open 丢回执时用相同 sessionId 核对一次;无法确认的创建身份落盘,恢复后只解除未关联任务的标记。+ 清理与 Worker 关联共用任务锁,锁内复查归属;公开写操作和迟到回调均核对数据库 owner。3. **多 peer 与负载**:每台设备每轮只发一次 `maker:list-active`,有待回报时 2s 一轮,否则 15s 一轮;按派活输入 clientId 读取对应回复(user / assistant 历史分页)与投递回执,只针对仍在等待回报的 Worker;每轮最多扫描 2000 行,预算用尽保留游标下轮续读,不累计“缺少回复”次数。后续插话的回复与 terminal状态不归给此前派活。宿主 accepted 生命周期完成后冻结回报身份,保存结果期间的新派活不被旧收尾消费;accepted 回调失败则恢复上一代等待状态并继续上抛原错误。同一 Worker 的派发及 accepted 生命周期复用现成 session 发送锁串行执行;其它 Worker 不受阻塞。多台控制端共享同一运行设备的回归仍需实机补测。+ 已有多设备单测覆盖一台离线时另一台仍能回报;同 owner 的启动恢复幂等,不清空现有派活。## 共享恢复与请求策略