Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。
TypeScript agentai-agentai-assistantandroidclaude-codecodexelectroniosllmmacosreact-nativetypescriptwindows
Merge upstream/main into cindy/epic-wozniak(解冲突:并集保留 update_worker 与远程供应商能力)
Zhang Yunjin4c53b5e69238
diff --cc apps/desktop/src/main/maker-ipc/register.tsindex 583df4d18a,6bc8889d4f..399722ab64--- a/apps/desktop/src/main/maker-ipc/register.ts+++ b/apps/desktop/src/main/maker-ipc/register.ts@@@ -7,9 -9,13 +9,23 @@@ import { assertPluginWorkerDirectoryScoimport { PluginWriteAccessGate } from './pluginWriteAccessGate.js';import { pluginWorkerCompletedAt } from './pluginWorkerCompletion.js';import { createPluginTaskStore } from './pluginTaskStore.js';+ import { createPluginBackgroundTaskHandlers, revealAllPluginHiddenTasks } from './pluginHiddenTasks.js';+ import { setSessionHidden } from '../localDb/ipc/sessionHidden.js';+ import { isSessionHiddenSync } from '../localDb/hiddenSessionRegistry.js';+ import { ghostDeclaresHiddenTasks } from '../../shared/ghost.js';import { hasAcceptedUserTaskInput } from './pluginTaskInput.js';import { controlOwnedSessionExecution, isSameSessionExecution, withdrawOwnedSessionInputs } from './sessionExecutionOwnership.js';- import { showMobilePluginTaskPermission, setPluginTaskHandler, getPluginTaskSourceSessionId, setPluginTaskUninstaller, isPluginTaskAuthorized, findAvailableGhostForAuthorization, getPluginTaskInstallRevision, pluginTaskAuthorizationRevision } from '../cindy-brain/index.js';-import { showMobilePluginTaskPermission, setPluginTaskHandler, getPluginTaskSourceSessionId, setPluginTaskUninstaller, setPluginTaskRelocator, isPluginTaskAuthorized, getPluginTaskInstallRevision, pluginTaskAuthorizationRevision } from '../cindy-brain/index.js';++import {++ showMobilePluginTaskPermission,++ setPluginTaskHandler,++ getPluginTaskSourceSessionId,++ setPluginTaskUninstaller,++ setPluginTaskRelocator,++ isPluginTaskAuthorized,++ findAvailableGhostForAuthorization,++ getPluginTaskInstallRevision,++ pluginTaskAuthorizationRevision,++} from '../cindy-brain/index.js';import type { PluginTaskRoute, PluginTaskRequest } from '../../shared/pluginTasks.js';import { createHash as pluginTaskConfigHash } from 'node:crypto';import { finishCompanionEnvironmentRemoval } from '../bot-import/runtime.js';@@@ -120,15 -160,10 +170,16 @@@ importstoredCustomProviderId,isLocalOnlyProviderForAgent,isOrganizationManagedProvider,+ type ProviderView,} from '@cindy/model-providers';import { createId } from '@paralleldrive/cuid2';-import { redactSensitiveText } from '@cindy/maker-shared/error-redaction';+import {+ GATEWAY_PROXY_TOKEN_INVALID_REASON,+ isCindyGatewayProviderId,+ isGatewayProxyTokenInvalidError,+ redactSensitiveText,+} from '@cindy/maker-shared/error-redaction';+import { normalizeOrcaWorkerLabel } from '@cindy/maker-shared/orca-team';import { permissionModeOrAsk } from '@cindy/maker-shared/permission-mode';import {isProductTurnCompletionTailEvent,@@@ -2402,18 -2614,18 +2631,27 @@@ interface OrcaCollabService}) => Promise<{ ok: true; workerId?: string } | { ok: false; errorCode: string; message: string }>;+ updateWorker: (params: {+ callerLeadSessionId: string;+ workerId: string;+ role?: string;+ label?: string;+ }) => Promise<+ | { ok: true; workerId: string; role: string; label: string | null }+ | { ok: false; errorCode: string; message: string }+ >;- listAvailableModels: (params: { agent?: AgentKind; callerSessionId?: string }) => Promise<+ listAvailableModels: (params: {+ agent?: AgentKind;+ callerSessionId?: string;+ /** 列哪里的模型:缺省 = Lead 所在位置;null = 任务所在电脑;string = 那台电脑或分享。 */+ agentDeviceId?: string | null;+ }) => Promise<| {ok: true;+ /** 本次列出的位置(null = 任务所在电脑)。 */+ agentDeviceId?: string | null;+ /** 可以放 Worker Agent 的其他位置(同账号电脑与收到的分享)。 */+ locations?: Array<{ agentDeviceId: string; name: string }>;codex?: Array<{id: string;label: string;@@@ -14746,28 -16033,36 +16075,49 @@@ export function registerMakerIpc(maker};}},+ updateWorker: async ({ callerLeadSessionId, workerId, role, label }) => {+ try {+ const { assertCurrent } = await captureOrcaPluginAuthority(callerLeadSessionId);+ await assertCurrent();+ return await orcaTeamService.updateWorker({ callerLeadSessionId, workerId, role, label });+ } catch (err) {+ return {+ ok: false,+ errorCode: 'INTERNAL',+ message: err instanceof Error ? err.message : String(err),+ };+ }+ },- listAvailableModels: async ({ agent, callerSessionId }) => {+ listAvailableModels: async ({ agent, callerSessionId, agentDeviceId: requestedAgentDeviceId }) => {try {const agents: AgentKind[] = agent ? [agent] : ['codex', 'claude-code', 'pi'];- // Agent 在另一台电脑运行的任务:Worker 也在那台运行,列那台的模型与来源。- const agentDeviceId = callerSessionId ? await readSessionAgentDeviceId(callerSessionId) : null;+ // SSH Lead 的 Worker 在 SSH 主机上运行 Agent,不能放到别的电脑:不列可选位置。+ const sshLead = callerSessionId ? Boolean(await readSessionRemoteHostIdCached(callerSessionId)) : false;+ // 不指定位置时列 Lead 所在位置(Lead 的 Agent 在另一台电脑运行就列那台;Lead 归在供应商组里就列组那一项+ // 所在的电脑),与 create_worker 不指定位置时 Worker 跟 Lead 同一口径;指定了就列那里(null = 任务所在电脑)。+ const leadGroupEntry = callerSessionId && requestedAgentDeviceId === undefined && !sshLead+ ? readLeadProviderGroupEntry(callerSessionId, null).providerGroupEntry+ : undefined;+ const leadAgentDeviceId = leadGroupEntry+ ? leadGroupEntry.agentDeviceId+ : callerSessionId ? await readSessionAgentDeviceId(callerSessionId) : null;+ const agentDeviceId = requestedAgentDeviceId === undefined+ ? leadAgentDeviceId+ : requestedAgentDeviceId && requestedAgentDeviceId !== getSelfDeviceId()+ ? requestedAgentDeviceId+ : null;+ const locations = sshLead ? undefined : await listWorkerAgentLocations();if (agentDeviceId) {- const views = await readDeviceProviderViews(remoteBackgroundInvoke, agentDeviceId);+ let views: ProviderView[];+ try {+ views = await readDeviceProviderViews(remoteBackgroundInvoke, agentDeviceId);+ } catch (err) {+ return agentDeviceCatalogFailure(err);+ }return {ok: true,+ agentDeviceId,+ ...(locations ? { locations } : {}),...Object.fromEntries(agents.map((a) => [a === 'codex' ? 'codex' : a === 'pi' ? 'pi' : 'claude_code',deviceAvailableModels(views, a),diff --cc apps/desktop/src/renderer/features/cc-agent/OrcaWorkerPanel.tsxindex 779202abfb,748b540e2a..bc8626a90c--- a/apps/desktop/src/renderer/features/cc-agent/OrcaWorkerPanel.tsx+++ b/apps/desktop/src/renderer/features/cc-agent/OrcaWorkerPanel.tsx@@@ -10,8 -10,8 +10,9 @@@ import { useCallback, useEffect, useReimport { useTranslation } from 'react-i18next';import { useNavigate } from 'react-router-dom';+ import { Button } from '@/components/ui/button';import { isAgentIslandSupported } from '@/hooks/useAgentIslandSettings';+import { useAgentCapabilities } from '@/hooks/useAgentCapabilities';import { toast } from '@/lib/toast';import { isSidebarWindow } from '@/lib/sidebarWindow';import { CCAgentSessionView } from './CCAgentSessionView';@@@ -209,8 -209,7 +227,8 @@@ export function OrcaWorkerPanel(onOpenCreate={() => void handleOpenCreate()}onOpenSettings={isSidebarWindow() || deviceId !== null ? undefined : handleOpenSettings}onArchiveWorker={handleArchiveWorker}+ onEditWorker={canEditWorker ? handleOpenEditWorker : undefined}- clearAttentionWhenVisible={viewVisible}+ clearAttentionWhenVisible={workerConversationVisible}/></div><div className="chat-rail-compact min-h-0 flex-1">@@@ -250,13 -264,11 +283,17 @@@sshRemote={sshRemote}// 仅任务与 Agent 均已确认在本机的 Lead 可选择 Worker 运行设备,与主进程限制一致。executionDevicesEnabled={deviceId === null && agentDeviceId === null && !sshRemote}+ // Worker 的模型目录默认跟 Lead 的 Agent 所在电脑;可在面板里换到本机或其他电脑。控制端读不到+ // 那台目录时(见 useWorkerAgentDevices)维持被控电脑的目录,Worker 跟 Lead。+ leadAgentDeviceId={workerAgentDevices.leadAgentDeviceId}+ remoteAgentDevices={workerAgentDevices.devices}/>+ <EditWorkerPopover+ open={!!editWorker}+ worker={editWorker}+ onClose={handleCloseEditWorker}+ onSave={handleUpdateWorker}+ /></div>);}diff --cc apps/desktop/src/renderer/hooks/useAgentCapabilities.tsindex 49ffe3138c,c3cbd1f303..e4bc7b1d8c--- a/apps/desktop/src/renderer/hooks/useAgentCapabilities.ts+++ b/apps/desktop/src/renderer/hooks/useAgentCapabilities.ts@@@ -120,13 -122,13 +122,18 @@@ export interface AgentCapabilities* device-link 老被控端无此字段 → undefined,控制端必须阻止开启协同并提示升级。*/supportsOrcaWorkerPermissionMode?: boolean;+ /**+ * 被控端是否支持创建后修改 Worker 的角色名/标识(maker:worker:update)。+ * device-link 老被控端无此字段 → undefined,控制端对远程 Worker 隐藏编辑入口。+ */+ supportsOrcaWorkerUpdate?: boolean;/** 被控端支持把 UI initial_task 延后到 Lead 首条输入 accepted 后派发。 */supportsDeferredOrcaUiAssignment?: boolean;+ /**+ * 被控端支持给协同 Worker 单独指定 Agent 所在电脑(远程供应商,`agentDeviceId`)。+ * 老被控端无此字段 → undefined:Worker 面板不列远程供应商、不发这个字段(老端会静默丢掉)。+ */+ supportsOrcaWorkerAgentDevice?: boolean;/*** 手动压缩会话上下文能力(pi 原生 compact)。与 maker-core Capabilities.manualCompact* 同形;device-link 老被控端序列化的 capabilities 无此字段 → undefined = 不支持。@@@ -292,8 -295,8 +300,9 @@@ function parseAgentCapabilities(value:!isOptionalBoolean(value.supportsSessionAgentSwitch) ||!isOptionalBoolean(value.supportsSessionAgentSwitchCas) ||!isOptionalBoolean(value.supportsOrcaWorkerPermissionMode) ||+ !isOptionalBoolean(value.supportsOrcaWorkerUpdate) ||!isOptionalBoolean(value.supportsDeferredOrcaUiAssignment) ||+ !isOptionalBoolean(value.supportsOrcaWorkerAgentDevice) ||!isOptionalCapabilityStatus(value.writableDirs) ||!isOptionalCapabilityStatus(value.manualCompact)) {diff --cc docs/dev-rules/orca-team-architecture.mdindex bcddf5a631,7755f36e08..b9e7900ef8--- a/docs/dev-rules/orca-team-architecture.md+++ b/docs/dev-rules/orca-team-architecture.md@@@ -387,9 -388,23 +389,25 @@@ Worker turn 被 vendor 报终止型 err10. **远端 Worker 只在运行设备上跑(状态:不变量)**Worker 可以放到同账号另一台电脑(运行设备)上运行:真实任务在那台,本机只有一条不跑 Agent、`working_dir` 为空的代理任务行,`orca_workers.execution_device_id` / `remote_session_id` 记录位置。代理行承接计槽、状态机、auto-bridge 与归档,任何路径都不得在本机为它起 Agent(`bootstrapSession` 对远端 Worker 直接拒绝)、不得把它复制到其他电脑;派活、停止与存活查询经 `orcaRemoteWorkers.ts` 的 `wrapTeamDeps` 分流到运行设备,其余依赖原样透传,不另造状态机。回报靠轮询:派出的消息已进入对话(投递回执 accepted)且设备不在跑时,分页读取 user / assistant 历史,按派活 user 的 clientId 定位对应的最后一条 assistant 回复并按消息 id 去重;后续用户插话的回复和异常状态不得归给此前派活,历史读取期间的新派活不得被旧回报清除。每轮最多扫描 2000 行,预算不足时保留游标下一轮续读,不误判缺少回复;宿主 onAccepted / onAcceptedCommit 完成后才冻结回报身份并允许轮询收尾,accepted 回调失败恢复上一代等待状态,保存旧结果期间不得消费新派活身份或写入其捕获文本。同一远端 Worker 的 enqueue、accepted / commit 和身份确认复用现成 session 发送锁串行执行,避免并发回调与投递顺序错位。用户在运行设备上直接发的消息算插话,不触发回报。设备不可达只是运行期投影(`executionDevice.reachable`),不扩展 `OrcaWorkerStatus`;派活时不可达直接失败,不回退到本机。首版远端 Worker 没有 `send_to_lead` 桥,也不支持 steer / 队列编辑。界面:创建弹窗的「运行设备」只在本机 Lead 上出现(`CreateWorkerPopover` 的 `executionDevicesEnabled`),复用标准下拉列表,以有界滚动和键盘按名称定位应对多设备;选了其他电脑后,工作目录提供「对话 / 指定目录」,「对话」不传 `workingDir`、在运行设备创建不绑定项目的任务,「指定目录」只使用那台电脑上的绝对路径。手机版的新任务「开启协同」与 Lead「创建 Worker」共用设备下拉列表和两种目录模式;设备列表从 Lead 所在电脑读取,Agent、模型和供应商目录从所选运行设备读取。协同面板对远端 Worker 展示运行设备上的真实任务(`RemoteWorkerSessionPane`,先登记归属再读写)。实现指针:`orcaRemoteWorkerRuntime.ts`、`orcaRemoteWorkers.ts`、`orcaWorkerCreationService.ts` 的 `createRemoteWorkerInTeam`、运行设备侧 `orcaRemoteWorkerHost.ts`;协议见 `protocol-compatibility.md`「协同远端 Worker」。+11. **改名只改身份元数据,不重建执行单元(状态:不变量)**+ Worker 的展示角色名 `role`(1-32 字符)与 team 内唯一标识 `label`(slug,`/^[a-z0-9_-]+$/i`,≤32)在创建后可通过 `update_worker` / `maker:worker:update` 修改。改名不是换执行单元:Agent、模型、权限、工作目录与已发起的 turn 都不受影响,也**不允许**借改名实施中途换模型(见坑点 #6)。`label` 唯一性由 `uniq_orca_workers_team_label` 最终把关(约束范围含已归档 worker),冲突必须回 `DUPLICATE_LABEL` 且零副作用;空操作必须 idempotent。同一 Worker 的读-改-写必须按 worker id 串行化,避免 UI 改 role 与 Lead 改 label 的并发请求互相完整回写覆盖。插件 team plan 以 label 冻结 Worker 归属与委派自动授权且登记后整体不可变:未结算计划条目引用到的 label(旧值或新值)不允许改名,必须回 `WORKER_STATE_CHANGED`,role 改名不受影响;插件已卸载(任务归属确实撤销)后保留的收据不再构成锁;停用 / 未批准可恢复、重新启用后计划仍会继续,故仍保持锁定(fail closed)。当 worker session 标题仍是 `orcaWorkerSessionTitle` 生成形态(`Worker · role · label`,role 与 label 相同时去重为 `Worker · role`)时同步改写为新形态;用户自定义/重命名过的标题不得被覆盖。成功的改名必须广播 `ORCA_WORKER_CHANGED`,并同步 worker session 的 `local-db:sessions:patched`(若标题被改写)。实现指针:`orcaTeamService.ts` 的 `updateWorker`、`orcaTeamStore.ts` 的 `updateWorkerIdentity`、`pluginTaskService.ts` 的 `isTeamPlanLabelLocked` / `isTeamPlanLabelLockedByReceipt`、`orcaWorkerCreationService.ts` 的 `orcaWorkerTitle`、`packages/lizi-mcps/src/xdt-helper/update_worker.ts`。+ 11. **Worker 的 Agent 位置:远程供应商与本机供应商一视同仁(状态:不变量,2026-10-10 用户裁决)**+ 与上一条「运行设备」不同,这里任务、目录、命令与文件都留在 Lead 所在电脑,只有 Worker 的 Agent 在另一台同账号电脑或分享来的供应商上运行(与普通任务的远程 Agent 同一机制,`sessions.agent_device_id`)。每个 Worker 可以单独选位置:`OrcaWorkerCreateParams.agentDeviceId` 不传 = 跟 Lead(旧调用方、旧控制端与 MCP 省略时都走这里),`null` = 任务所在电脑,string = 那台电脑或 `share:<id>`;等于本机设备 id 时按 `null`。模型与来源按 Worker 自己的位置读目录(那台只列允许被远程调用的供应商),只有与 Lead 同一位置时才沿用 Lead 的来源(来源 id 在不同电脑上不是一回事);Agent 在另一台时不按本机的 Cindy AI key 判预算模型。那台读不到目录在占槽与启动前失败(`REMOTE_AGENT_DEVICE_UNREACHABLE` / `REMOTE_AGENT_SHARE_*`),不回退到本机。SSH Lead 与运行设备 Worker 不能再指定另一台(`INVALID_PARAMS`),插件任务只能跟 Lead 或留在任务所在电脑。入口一处一套:桌面「创建 Worker / 开启协同」弹窗与新建任务用同一个模型面板,任务所在电脑的供应商之后列其他电脑与分享(`useWorkerAgentDevices`),选中哪一行 Worker 的 Agent 就在哪运行,默认选中 Lead 的位置;选了远程就不提供运行设备,选了运行设备回到任务所在电脑。远程选择不写本机 Worker 偏好,档位记在本机为那台单独记的一份(`agentDeviceModelMemory`)。手机同口径(`useOrcaWorkerForm` 的 `agentDeviceId`,模型面板 `remote` 与新建任务同一份 `useRemoteAgentCatalogs`),被控电脑声明 `supportsOrcaWorkerAgentDevice` 时新建任务的远程供应商与协同不再互斥。Lead 的 `list_available_models` 可按 `agent_device_id` 列那里的模型并给出 `locations`,`create_worker` / `create_workers` 用同一个 `agent_device_id`。Worker 列表投影 `session.agentDeviceId`,桌面 Worker 头像叠与远程任务同款的单波纹 + 点;手机 Worker 行保持原来的状态圆点,不加远程标识(2026-10-11 用户要求维持原样)。已开始的 Lead 与 Worker 可以由用户在模型列表里换 Agent 位置(本机供应商、其他电脑、分享来的供应商一起列出),与普通任务同一套换电脑事务:选择先登记为意图,下一次发送边界全量交接后在新位置重建,协同身份不变(2026-10-16 用户裁决:任务都在本机,只换供应商所在电脑,不应排除)。运行设备 Worker 与 SSH 任务仍不开放;被控电脑上的协同任务暂不在控制端开放(旧版被控端会拒绝),手机端同样暂未开放。供应商组为任务换电脑见第 12 条。实现指针:`orcaWorkerCreationService.ts` 的 `resolveWorkerAgentDeviceId` / `agentDeviceCatalogFailure`,`register.ts` 的 `listWorkerAgentLocations` 与 `listAvailableModels`,renderer `CreateWorkerPopover.tsx`、`hooks/useWorkerAgentDevices.ts`;协议见 `protocol-compatibility.md`「协同 Worker 的 Agent 位置」。++ 12. **协同任务归供应商组,换电脑不丢回报(状态:不变量,2026-10-10 用户裁决)**+ Lead 与 Worker 与普通任务一样归供应商组分配、出问题时自动换电脑(产品口径见 `docs/product-rules/provider-groups.md` §6.1「协同任务」),只有审查任务仍排除(`readProviderGroupSessionRow`)。要点:+ - **新 Worker 也分配**:Worker 的任务记录由启动这一步写入,分配时还读不到,`applyProviderGroupAssignment` 用启动参数作为「从没运行过」的快照(`assignBeforeStart` 的 `startRow`);记录已存在时以记录为准。+ - **跟 Lead 就是跟 Lead 的组**:Lead 有组绑定、Worker 选的位置就是 Lead 现在所在且来源没另选(或选的就是 Lead 现在的来源 / 组那一项)、同一种 Agent 时,Worker 改用组那一项(本机的组:任务所在电脑 + 组的供应商;另一台电脑上的组:那台 + 组的供应商),再由组按策略选电脑;组那一项不提供该模型或读不到时照旧跟 Lead 所在那台。`list_available_models` 不指定位置时同口径。实现:`OrcaLeadSessionSnapshot.providerGroupEntry`、`leadProviderGroupFollowCandidate`。+ - **换位置的入口**:Lead 与本机 Worker 显式改变 `agentDeviceId` 与普通任务一样走 `performSessionAgentSwitch`(2026-10-16 起,见第 11 条)。点的是别处的供应商组、组在发送时又选回当前位置且引擎不变时,协同任务按交接重建,不走原地换模型:原地换模型要点选时核对过的窗口,而换位置点选不做这项核对,换到更小窗口的模型会一直卡在发送前;用户点选时已确认过按交接重新开始。运行设备 Worker(`orcaRemoteLead`)的显式 `agentDeviceId` 仍只接受 main 内部带 `providerGroupRelocation` 的 applyNow 调用,且引擎与模型都不变;该标记不从 IPC 读取。+ - **Lead 离开不可达的远程电脑**:Lead 的 Agent 在另一台电脑时,切换前要先关闭旧远程会话。关闭请求若因链路失败而没送到对方(`DeviceLinkError.code` 为 `DEVICE_OFFLINE`、`INVOKE_TIMEOUT`、`DEVICE_UNRESPONSIVE`、`NOT_CONNECTED`、`LINK_NOT_OPEN`、`PEER_RESET`、`BACKPRESSURE`,或消息里带对应的 `[DEVICE_LINK_*]` 前缀),`performSessionAgentSwitch` 记一条 warn 后仍提交新位置;权限、版本、业务类错误(如 `REMOTE_DISABLED`、`CHANNEL_NOT_ALLOWED`、`ACCESS_REVOKED`、`VERSION_MISMATCH`、无 code 的 `REMOTE_AGENT_UNAVAILABLE`)照旧中止,不写库。只对 Lead 生效,Worker 与普通任务的关闭失败语义不变。名单对应 `apps/desktop/src/main/device-link/ipc.ts` 的 `DEVICE_LINK_CODE_MAP`,改一处要看另一处。旧会话在本机已 finish,对方没收到 close 时由其 host 在 `REMOTE_AGENT_HOST_IDLE_MS`(3 分钟无 poll)后按 `controller-gone` 回收。未验证:未做实机 Orca 协同回归(Lead 离开不可达电脑后 team/Worker 回报链路)。+ - **换电脑资格与等额度恢复分开**:组的 `isFailoverEligible` 用 `isProviderGroupFailoverEligible`(Worker 可换),额度恢复后自动继续仍用 `isUsageLimitAutoResumeEligible`(Worker 不等,失败交给 Lead)。+ - **换过去仍是成员**:`bootstrapSwitchedSession` 对协同任务调 `synthesizeOrcaVendorOptionsFromDb`,新会话带着协同身份、提示词与 `cindy_orca` / `orca_worker_bridge`,不靠下一次发送二次重启。+ - **Worker 终态按换电脑那次登记结算**(与 5a 同一原则):输入协调器登记「先不呈现」期间,Worker 的终态不调 `handleWorkerTerminalTurn`,而是按登记 id 暂存(`provider-group/heldWorkerTerminals.ts`;error 事件随 error 行一起暂存,只以 done 收尾的失败在 terminal 末尾暂存)。换成了(续跑已发出)丢掉,auto-bridge pending 保留到续跑那一轮的产品终态再回报;没换成、迟迟没有结局或有人接手时恰好一次回报这次异常终止,账号已切换则不回报。迟到的旧结算只认自己那次登记。+ - **唤醒与换电脑互斥**:`resumeOrcaWorkerSessionIfMissing` 在会话发送锁内复查 live session 再启动,不会在「关闭 → 写库 → 启动」的空档里按旧记录在原来那台拉起 Worker。+ - **远端 Worker 回报**:`orcaRemoteWorkerRuntime.ts` 按历史收尾时跳过自动续跑的隐藏用户消息(`agentMeta.autoResume`),续跑之后的回复照常作为派活结果。+ - 换电脑途中 Lead 发给 Worker 的消息、到达 Lead 的 Worker 回报都按亲自接手处理(停下这一趟换电脑,那条消息开始新的一轮),不做插队或延后。+### 测试与回归清单远端回报身份在 enqueue 前保存于 `orca_workers.pending_remote_report`,恢复时重建 TeamService@@@ -443,10 -458,10 +461,10 @@@ Mobile 的入口读取和残留表单�- Auto-resume × auto-bridge:pending/deferred 的 vendor 终态不得 bridge / 置 `error`;失败轮随后的 unclaimed `done` 同样不得收口(含用户接手 force-flush 之后、无 persist-id 的零输出尾巴);无配对 `done` 的旧 tail 不得吞掉后续更大 generation 的产品 `done`;surface/exhaust 恰好一次收口;成功续跑保持 `running` 且 pending 仍在;手动 stop 仍不 bridge。见 `autoResumeBookkeeping.test.ts` 的 `shouldSkipOrcaWorkerTerminal` 与 `interruptedContinuationContract.test.ts`。- 空闲 live 直发:`orcaInterAgentDispatcher` 在 `session.send()` 前必须先 `prepareUnhealthySession`,再重新 `getLiveSession`;prepare 关闭旧 handle 后不得继续向旧对象 send。并发直发必须串行化到同一把 per-session 锁。- Worker 创建权限偏好:覆盖无保存偏好时默认 `bypassPermissions`、已保存的 `auto` / `bypassPermissions` 继续优先、MCP 显式 `auto → bypassPermissions` 必须先经用户确认且取消/超时零副作用、复用 Team 时省略不重置/显式才更新、首个与后续 Worker 都读取共享创建偏好、已有 Worker 权限不反写、renderer localStorage 启动同步与 tool 写回,以及旧 device-link 被控端被阻止开启协同并提示升级。-- MCP 工具:`cindy_orca` 20 工具(17 team + 3 只读诊断)的 role gate、ctx 缺失、worker/main 误调用、soft/hard limit、duplicate label、budget model API mode gate;`create_workers` 另覆盖默认 hard limit、配置 hard=3、部分成功、连续失败与 hard-limit 后不再调用 host;诊断工具的纯只读语义(无 active team 时返回空 workspace、不建 team);排队消息控制 6 工具的归属校验(跨 lead 拒绝)、完整 consuming 投影、非 lead 条目拒绝(`NOT_LEAD_MESSAGE`)、自身队列非协同条目拒绝(`NOT_ORCA_MESSAGE`)、steering 拒绝(`MESSAGE_CONSUMING`)、撤回结清 accepted 暂存、合并的连续性、冲突零修改与移除回调结清,以及转插话的原因回执与排序落点;`send_to_worker` / `send_to_lead` 的 `delivery` 缺省不透传、显式插话与各类 fallback 原因;`interrupt_worker` 另覆盖队首预留、暂停态、graceful-stop 全部 outcome、auto-bridge 抑制和 done 互斥。+- MCP 工具:`cindy_orca` 21 工具(18 team + 3 只读诊断)的 role gate、ctx 缺失、worker/main 误调用、soft/hard limit、duplicate label、budget model API mode gate;`create_workers` 另覆盖默认 hard limit、配置 hard=3、部分成功、连续失败与 hard-limit 后不再调用 host;`update_worker` 覆盖归属校验(跨 lead 拒绝)、role/label 归一、idempotent 空操作、duplicate label 与生成标题同步;诊断工具的纯只读语义(无 active team 时返回空 workspace、不建 team);排队消息控制 6 工具的归属校验(跨 lead 拒绝)、完整 consuming 投影、非 lead 条目拒绝(`NOT_LEAD_MESSAGE`)、自身队列非协同条目拒绝(`NOT_ORCA_MESSAGE`)、steering 拒绝(`MESSAGE_CONSUMING`)、撤回结清 accepted 暂存、合并的连续性、冲突零修改与移除回调结清,以及转插话的原因回执与排序落点;`send_to_worker` / `send_to_lead` 的 `delivery` 缺省不透传、显式插话与各类 fallback 原因;`interrupt_worker` 另覆盖队首预留、暂停态、graceful-stop 全部 outcome、auto-bridge 抑制和 done 互斥。- Codex MCP context:`CodexMcpThreadContextStore` 覆盖按 threadId 查 context、unknown / missing threadId fail-closed、unregister 后清理、`vendorOptions` 引用保持;`codexHttpBridge` 覆盖从 JSON-RPC `params._meta.threadId` 注入真实 session context。- Host 归属校验:`send_to_worker`、`interrupt_worker`、队列控制、`idle_worker`、`archive_worker` 经共享 `resolveWorkerRef`(同时接受 worker_id / session_id 两种 id)必须以 caller 自身 Lead 身份校验,拒绝跨 workflow worker id 与 ctx 缺失;即使模型传错 id 或换用另一种 id,也不能越权操作。- - UI route:Orca worker 不出现在 sidebar,Lead 自动进 split route,worker deep link 解析到 Lead split route;已有测试守住“不用 fork parentSessionId 或标题推断 Orca mapping”,见 `apps/desktop/src/renderer/__tests__/orcaWorkflowRoute.test.ts` 的 `does not use fork parentSessionId or title-linked worker lookup for Orca mapping`。+ - UI route:Orca worker 不出现在 sidebar,Lead 自动进 split route,worker deep link 解析到 Lead split route;对应行为由 `apps/desktop/src/renderer/features/cc-agent/__tests__/OrcaWorkflowRoute.navigation.test.tsx` 与 `OrcaWorkflowRoute.compat.test.tsx` 覆盖。- Fork / side_chat 底座:user fork、assistant fork、Codex `tailTurnsToDrop`、Claude turn-final assistant uuid、tool_use 拒绝。- Worktree:toggle off/on、非 git/已在 worktree 只 disable worktree toggle、不阻断 send;Lead close 后清 worktree。- 重启后 Lead↔Worker 互访(resume)回归矩阵:覆盖开启路径 `enableTeam` 自动首 worker / MCP `start_team` + `create_worker` / renderer `requestEnableCollab` → `SESSION_ENABLE_ORCA` → `enableTeam`,以及重启时机“对话中途”和“初始化完毕但未对话”;验收动作至少包含 `list_workers` 可见 worker、Lead 侧 `send_to_worker` 可投递或排队、Worker 侧 `send_to_lead` 可回传、focused / idle worker 可 resume。diff --cc packages/lizi-mcps/src/orca/server.tsindex 78571a0ab4,eceee25ead..076f8b4481--- a/packages/lizi-mcps/src/orca/server.ts+++ b/packages/lizi-mcps/src/orca/server.ts@@@ -56,9 -56,8 +56,9 @@@ importregisterIdleWorkerTool,registerEndTeamTool,registerArchiveWorkerTool,+ registerUpdateWorkerTool,registerListAvailableModelsTool,- type ModelDescriptor,+ type ListAvailableModelsDeps,type OrcaMessageDelivery,type QueuedMessageControlErrorCode,type QueuedMessageSteerReason,@@@ -258,26 -259,8 +260,20 @@@ export interface OrcaMcpDepsarchiveWorker: (params: { callerLeadSessionId: string; workerId: string }) => Promise<ControlResult<{ workerId: string }, 'WORKER_NOT_FOUND'>>;+ /** 修改已创建 worker 的角色名 / 标识。 */+ updateWorker: (params: {+ callerLeadSessionId: string;+ workerId: string;+ role?: string;+ label?: string;+ }) => Promise<+ ControlResult<+ { workerId: string; role: string; label: string | null },+ 'WORKER_NOT_FOUND' | 'INVALID_PARAMS' | 'DUPLICATE_LABEL' | 'WORKER_STATE_CHANGED'+ >+ >;/** 列出 agent 可用 model 清单。 */- listAvailableModels: (params: { agent?: ControlWorkerAgent; callerSessionId?: string }) => Promise<- ControlResult<{- codex?: ModelDescriptor[];- claude_code?: ModelDescriptor[];- pi?: ModelDescriptor[];- }>- >;+ listAvailableModels: ListAvailableModelsDeps['listAvailableModels'];/** 只读诊断:列出当前 Orca workflow 与 worker sessions。 */getWorkspaceInfo: (params: { leadSessionId: string }) => Promise<ControlResult<OrcaWorkspaceInfo, 'LEAD_NOT_SUPPORTED'>diff --cc packages/maker-shared/src/agentCapabilities.tsindex bb0ac4c67c,a52309ef34..d41cc33617--- a/packages/maker-shared/src/agentCapabilities.ts+++ b/packages/maker-shared/src/agentCapabilities.ts@@@ -29,8 -29,11 +29,13 @@@ export interface MobileAgentCapabilitiesupportsSessionAgentSwitch?: boolean;/** host 是否支持创建 Orca Worker 时显式选择 Worker 权限;旧 host 缺省 false(不得开启协同)。 */supportsOrcaWorkerPermissionMode?: boolean;+ /** host 是否支持创建后修改 Orca Worker 的角色名/标识(update_worker);旧 host 缺省 false。 */+ supportsOrcaWorkerUpdate?: boolean;+ /**+ * host 是否支持给 Orca Worker 单独指定 Agent 所在电脑(远程供应商,`agentDeviceId`);旧 host 缺省+ * false:Worker 表单不列远程供应商、不发这个字段(旧 host 会静默丢掉)。+ */+ supportsOrcaWorkerAgentDevice?: boolean;/** host 是否在 set-model 内执行强制模型窗口保护;旧 host 缺省 false。 */supportsModelWindowSwitchGuard?: boolean;}@@@ -164,7 -167,7 +169,8 @@@ export function normalizeMobileAgentCapsupportsSessionAgentSwitch: value.supportsSessionAgentSwitch === true,supportsModelWindowSwitchGuard: value.supportsModelWindowSwitchGuard === true,supportsOrcaWorkerPermissionMode: value.supportsOrcaWorkerPermissionMode === true,+ supportsOrcaWorkerUpdate: value.supportsOrcaWorkerUpdate === true,+ supportsOrcaWorkerAgentDevice: value.supportsOrcaWorkerAgentDevice === true,};}