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。

Merge upstream/main into cindy/epic-wozniak(解冲突:并集保留 update_worker 与远程供应商能力)

Zhang Yunjin4c53b5e69238
diff --cc apps/desktop/src/main/maker-ipc/register.ts
index 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 { assertPluginWorkerDirectorySco
import { 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 @@@ import
storedCustomProviderId,
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.tsx
index 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, useRe
import { 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.ts
index 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.md
index 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 报终止型 err
10. **远端 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.ts
index 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 @@@ import
registerIdleWorkerTool,
registerEndTeamTool,
registerArchiveWorkerTool,
+ registerUpdateWorkerTool,
registerListAvailableModelsTool,
- type ModelDescriptor,
+ type ListAvailableModelsDeps,
type OrcaMessageDelivery,
type QueuedMessageControlErrorCode,
type QueuedMessageSteerReason,
@@@ -258,26 -259,8 +260,20 @@@ export interface OrcaMcpDeps
archiveWorker: (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.ts
index 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 MobileAgentCapabilitie
supportsSessionAgentSwitch?: 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 normalizeMobileAgentCap
supportsSessionAgentSwitch: value.supportsSessionAgentSwitch === true,
supportsModelWindowSwitchGuard: value.supportsModelWindowSwitchGuard === true,
supportsOrcaWorkerPermissionMode: value.supportsOrcaWorkerPermissionMode === true,
+ supportsOrcaWorkerUpdate: value.supportsOrcaWorkerUpdate === true,
+ supportsOrcaWorkerAgentDevice: value.supportsOrcaWorkerAgentDevice === true,
};
}