Skip to content

armgit / cindy

Public Imported from GitHub
0

Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。

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.ts
index 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.md
index 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.md
index 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 的启动恢复幂等,不清空现有派活。
## 共享恢复与请求策略