Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。
TypeScript agentai-agentai-assistantandroidclaude-codecodexelectroniosllmmacosreact-nativetypescriptwindows
docs(provider-group): 记下换不换电脑统一成一个判定与各路径对齐后的规则
Lizi49f671187b47
diff --git a/docs/dev-rules/protocol-compatibility.md b/docs/dev-rules/protocol-compatibility.mdindex 421d8d317b..13521ef9f8 100644--- a/docs/dev-rules/protocol-compatibility.md+++ b/docs/dev-rules/protocol-compatibility.md@@ -119,6 +119,12 @@ Claude Code 终态 error 事件可带 `usageResetAt`(unix ms)。服务端无`autoResumeInfo` 新增可选字段 `agentReconnect: { computer }`(读不到名称时为空串),新 Desktop 与 Mobile 显示「已重新连上 {电脑},继续运行」;旧客户端忽略该字段,显示「用量已恢复,已自动继续」(与 `agentSwitch` 相同)。同样只改投影与记录内容,服务端无需改动。+换不换统一成一个判定(2026-10-11,`provider-group/failurePolicy.ts`):`agentSwitch.cause` / `groupSwitch.cause` /+`groupSwitchPending.cause` 新增取值 `failed`(那台出了别的问题,如 Agent 意外退出、服务报错且重试用尽),新 Desktop 与 Mobile+显示「{from} 出了问题,已换到 {to} 继续」;旧客户端不认识的原因整条忽略,活动行显示「用量已恢复,已自动继续」,进行中行按普通+「重新连接中」显示。`provider-group:remote` 的 `cool` 仍只报那台账号的问题(`usage-limit` / `auth` / `overload`),不变。+本机远程 Agent 任务连续拉不到那台而结束时,终态 error 的 `reason` 由 `remote_agent_closed` 改为 `remote_agent_lost`(只在本机+与它的控制端之间流转,用于判定「只是连接断了」;渲染端两者都按错误码给文案,旧端不受影响)。## Agent 跨设备历史发现与搜索@@ -854,6 +860,11 @@ G 重新打开时换一台。G 与 O 之间新增四项可选内容,O 与 MO 读完即去掉,不交给 Agent、不转给 M;旧 O 丢弃这个字段(手动重试仍沿用旧的一轮,直到正常结束或 30 分钟)。它只影响这个受邀者自己这个任务的换电脑记录,不扩大任何权限。组设置关掉了自动换电脑时 O 照常冷却出问题的那台,但不发凭证。- G 只在持有凭证时才换电脑:分享暂停、删除、撤权等来自 O 本身的错误没有凭证,照旧交回原有处理。+- **续接回到原来那台、那台接不下时同样发凭证**(2026-10-11):G 续接一个经组运行过的任务(带 `resumeSessionId`),O 只能回到+ 当初那台(会话在那台上);那台接不下、且按同一个判定是那台的问题时,O 在 `start-failed` **之前**追加同一条凭证状态。G 的+ `startRemote` 在任务开始之前也会取走凭证(`takeGroupSwitchState`),随后的打开失败按「没送出去」交给同一条自动交接,+ 带凭证作为全新任务重新打开。没有新字段;旧 G 只看到原来的启动失败。组为受邀者的全新任务选中 O 本机、O 的 Agent 却没能+ 启动时,O 与组内电脑接不下一样在启动阶段换下一台(受邀者无感,旧 G 同样享受)。- 不改 relay、服务器与数据库。实现:`remote-agent/host/runHost.ts`(暂存与发凭证、校验凭证)、`host/groupRelay.ts`、`provider-group/guestRelay.ts`(运行中失败的冷却)、`provider-group/guestSwitch.ts` 与 `provider-group/service.ts`(G 侧凭证与自动交接)、`maker-ipc/sessionAgentSwitchHandler.ts`(仅内部可用的 `forceRelocation`);回归见diff --git a/docs/product-rules/provider-groups.md b/docs/product-rules/provider-groups.mdindex 123318ce20..6f7fd8c62d 100644--- a/docs/product-rules/provider-groups.md+++ b/docs/product-rules/provider-groups.md@@ -22,6 +22,9 @@> 2026-10-11 用户要求:「用量」块**按人**列——第一行是自己(当前登录账号的头像与昵称),和下面分享的人一样显示;> 自己 = 本机与同账号其他电脑经这个供应商(组)的用量总和,同账号其他电脑经组在别的组内电脑上运行的部分由它们报告给> 组所在电脑;每人收起时是总量,展开后按组内每台电脑分开、每台下面列模型,见 §7。+> 2026-10-11 用户确认:**换不换电脑统一成一个判定**——新建任务、工作中、发送前、协同、分享的人、手机都问同一处+> (`provider-group/failurePolicy.ts`);**默认出问题就换**,只有换到哪台都一样、或不是那台电脑的问题时不换;本机的操作不打断+> 进行中的远程一轮。见 §6.1「怎么判断换不换」。> 实现进度见 §12:P1 已实现;P2 全部已实现:同账号直连与模型列表只显示组(P2a)、分享的人经组中转与启动阶段换电脑(P2b)、> 分享的人运行中换电脑与申请弹窗新说法(P2c);P3 已做按人用量与按组内电脑展开(§7)。> 交互设计稿见 [`docs/design-previews/provider-groups/index.html`](../design-previews/provider-groups/index.html)。@@ -164,6 +167,9 @@都还没有时照旧等全部读完,不会因为慢就误报都不能用。组里都不能用时直接提示「供应商组里的电脑现在都不能运行这个任务」。- 冷却按账号存在组所在电脑本机(`provider-group-cooling.json`),重启后照样避开撞了上限的那台。- 已知局限:组所在电脑读不出来的问题(例如那台目录读得到、Agent 却起不来)不在状态里,每个任务仍会先试到它再换下一台。+ - 分享来的组员与自己的电脑同一套(2026-10-11):分享者拒绝(关了远程控制或这个供应商的「允许被远程调用」)按不可用,不当离线+ 去等;离线已久(分享没有最后在线时刻,按本机第一次看到离线算,只会少算)与同账号电脑一样不再等它恢复。+ - 本机的组给本机任务选电脑时,选中的同一步就记上临时占用(到那个任务开始运行一轮为止),同时开的几个任务不会全落到同一台。- 组里所有电脑都失败才报错,见 §6 自动换电脑。## 6. 任务与组内电脑的绑定@@ -179,6 +185,11 @@确认它在组里。- 纳入的时机:启动 Agent 时(问组所在电脑最多等 3 秒,问不到就照常启动);当时没纳入的(一直开着没重新启动、或启动时问不到)在因 §6.1 的原因失败时先纳入,再照常换电脑,所以已经开着的老任务点重试也会换。+ - 问组所在电脑超时只算「读不到」,不算组已删除:组所在电脑慢一点不会把已归组的任务移出组(2026-10-11)。+- **有原生会话要续接的任务不在启动阶段换电脑**(2026-10-11):会话在原来那台上,别处认不出它的会话 id,会悄悄开一个没有上下文的+ 新会话。重新打开(重启 Cindy、会话被回收后)时原电脑不能用,由发送前检查(§6.1「发送前」)先等或带交接换过去;打开时 Agent 没能+ 启动、或链路已断请求根本没发出去的,这条已保存的消息交给与运行中失败同一条自动换电脑流程(带交接,换过去后重发)。没有原生会话+ 要续接的(从没运行过、回退或清空后)仍在启动阶段直接换下一台。- 不纳入:直接选组里某台电脑或分享来的供应商的任务(用的不是组那一项,§4);因组内电脑被移出、或组被删除而解除过这个组的任务(§9.4,任务所在的电脑按组记下,之后同一台重新加入、或重建同一个组也不纳入)。- **在模型选择里把任务换到组那一项、要换电脑时由组选电脑**(2026-10-11 用户反馈:此前直接落到组所在电脑本身,它撞了周上限,@@ -194,14 +205,23 @@供应商组的目的就是多个账号一起用、出问题自动换,所以**因电脑本身的原因失败时,自动换到组里下一台可用的电脑继续,组里所有电脑都失败了才报错**。-- **会触发换电脑的失败**(问题出在那台电脑或它的账号上):- - 撞到用量上限、额度或余额用完、请求频率限制;- - 那台电脑的供应商登录失效、被拒绝或被停用;- - 那台电脑离线、不可达、关闭了远程控制或远程调用、分享被暂停或删除,或已被移出组、暂停分配;- - 那台电脑上 Agent 启动失败;- - 供应商服务报错、过载或超时(同一台连续失败才算,偶发一次先按现有重试处理)。-- **不换电脑的失败**(换到哪台都一样):用户停止、权限确认被拒绝、上下文超出模型上限、请求本身无效、- 内容被模型拒绝、工具执行出错。这些照现有方式报错。+- **怎么判断换不换**(2026-10-11 用户确认:统一成一个判定,默认出问题就换):所有路径——新任务启动失败、运行中的终态错误、+ 发送前与换电脑途中换不过去、组所在电脑替分享的人中转、协同 Worker——都问同一个判定(`provider-group/failurePolicy.ts`),+ 路径只负责拿到这次失败和执行决定。每次失败记一行决定日志(只带错误码与结构化字段,不带错误原文)。+ - **不换**:换到哪台都一样——上下文超出模型上限、请求本身无效、内容被拒、工具循环被拦、权限确认被拒、工具执行出错、本机准入+ (模型停用等);或不是那台电脑的问题——用户停止或已接手、本机主动关掉了会话、任务此刻的状态不允许(在运行、已删除等)、组里+ 已经都不能用。这些照现有方式报错。+ - **其余一律换**,不再只认列出来的错误:用量上限、额度或余额用完、请求频率限制;登录失效、被拒绝或被停用;那台离线、不可达、+ 关闭了远程控制或远程调用、分享被暂停或删除、不提供这个模型、版本太旧、没装这个 Agent;Agent 启动失败、一轮中途意外退出;+ 服务报错、过载或超时(偶发一次先由中断自愈在同一台重试,重试用尽才到这里,即「同一台连续失败才算」);以及其他认不出的失败+ (活动记录写「{原电脑} 出了问题,已换到 {新电脑} 继续」)。+ - **换时先不先等**:只是连接断了(连续拉不到那台、对方 Cindy 重启后会话没了)先等它恢复,恢复了留在原电脑;可能连不上+ (读取放弃、分享连不上、太忙)先现读一次,确实连不上才等,连得上就直接换;其余不等。见下面「连不上先等它恢复」。+ - **记不记进组的状态**:只有那台账号的问题(用量上限、登录失效、服务繁忙)记进组的状态(冷却);连不上、起不来、其他失败只在+ 这一轮不再试,不影响别人(§5「组内状态以组所在电脑为准」)。+- **本机的操作不打断进行中的远程一轮**(2026-10-11):切换侧栏焦点时插件 Library 只读目录的同步、改附加目录、改思考档位等本机的+ 控制操作,不会因为 Agent 所在那台暂时连不上就把正在跑的一轮杀掉:没有要改的不去碰运行中的会话;要改而那台回不来时,这一轮结束后+ 再按已保存的设置重建。本机主动关掉会话不是那台电脑的问题,不触发换电脑。- **怎么换**:- **还没开始运行**(打开任务、Agent 启动阶段)失败:直接换下一台,没有可感知的中断。- **运行中失败**:把这台标为不可用(用量上限进入冷却,§5),复用现有的跨电脑交接,把任务交接到组策略选出的@@ -247,12 +267,14 @@- 新建的 Worker 跟普通新任务一样按组策略选电脑。Worker 跟着 Lead(没另选位置,或选的就是 Lead 现在所在那台)而 Lead 用的是组那一项时,Worker 跟的是这个组,不是 Lead 这次落到的那台;组那一项不提供所选模型时照旧跟 Lead所在那台。Lead 的 `list_available_models` 不指定位置时同样列组那一项所在电脑的模型。- - Worker 换电脑期间这一轮还没有结局,不把「异常终止」回报给 Lead:换成了,续跑那一轮结束时照常把结果回报给 Lead;- 没换成(组里都不能用、交接失败、久久没有结局、中途有人接手)才把这次异常终止回报给 Lead,与没有供应商组时一致。+ - Worker 换电脑期间这一轮还没有结局,不把「异常终止」回报给 Lead:换成了、续跑真正派发出去后,续跑那一轮结束时照常把结果+ 回报给 Lead;没换成(组里都不能用、交接失败、续跑没派发出去、中途有人接手)才把这次异常终止回报给 Lead,与没有供应商组时+ 一致。久久没有结局(3 分钟)先回报给 Lead 时,这一趟换电脑就此停下,不再换过去续跑(Lead 已据此重新安排,不能再收到第二份+ 结果);普通任务照旧先放出错误、换成了照常续跑。- Worker 换电脑后不做「等额度恢复后自动继续」:组里都不能用时失败照常交给 Lead 重新安排([用量上限自动继续](usage-limit-auto-continue.md) 不覆盖 Worker 的口径不变)。- 换电脑途中 Lead 给 Worker 发来消息、或 Worker 的回报到达正在换电脑的 Lead,按亲自接手处理:这一趟换电脑停下,- 那条消息开始新的一轮(发送前发现原电脑在冷却时照常先换电脑)。+ 那条消息开始新的一轮(这一轮试过的电脑与等待次数清零;发送前发现原电脑在冷却时照常先换电脑)。- 换过去的会话照常带着协同身份、提示词与协同工具;唤醒空闲 Worker 与换电脑互斥,不会在换电脑的空档里按旧位置把它拉起来。- **何时停止**:同一轮里每台组内电脑最多试一次;全部试过仍失败才报错,并提供换模型。@@ -266,9 +288,9 @@- 交接会关闭旧会话;交接前先登记这次错误的重试入口,交接完成后凭它重新挂上续跑。用户在换电脑途中亲自接手(发消息、重试、换模型)或那次错误已被新的一轮接管时,后续每一步都停下:不再交接、不冷却任何电脑、不续跑,也不再交回原有处理。- - 交接失败只有在问题出在目标电脑本身(连不上、分享暂停、Agent 起不来、登录失效等)时才把那台记为试过并冷却,- 换下一台再试;任务正在运行、已被删除等与目标无关的失败直接结束本次换电脑。都不行时交回原有的报错与额度重置后- 自动继续。+ - 交接失败按同一个判定:问题出在目标电脑本身(连不上、分享暂停、Agent 起不来、登录失效等)时把那台记为试过(账号的问题+ 才冷却),换下一台再试;任务正在运行、已被删除等与目标无关的失败直接结束本次换电脑。换过去的那台交接成功、Agent 却没能+ 启动时同样按换不过去处理、换下一台,不把续跑交给起不来的电脑。都不行时交回原有的报错与额度重置后自动继续。- **代价与告知**:每换一次电脑都是一次交接——原会话的提示缓存失效,新会话按交接上下文继续,细节可能比原会话少,也会多消耗一些 token。自动换电脑默认开启,组设置里可以关掉;关掉后照现有方式报错,用户可以在模型选择里手动换到另一台电脑。@@ -297,6 +319,11 @@- 凭证只认发给的那个受邀者的那个任务,用过、过期(10 分钟)即作废;组内电脑转来的同名状态一律丢弃,组内电脑不能替组所在电脑发凭证。同一轮每台组内电脑最多试一次;那台上一轮正常结束,或距上次换电脑超过 30 分钟,算新的一轮。+ - 判定与组所在电脑自己的任务同一个(`failurePolicy`):启动阶段换到哪台都一样的不再逐台试;组选中组所在电脑本机、本机+ Agent 却起不来时与组内电脑接不下一样换下一台;**续接回到原来那台、那台接不下时同样发凭证**,受邀者交接(带上下文)后+ 作为全新任务重新打开,组换一台(2026-10-11)。旧版受邀者的任务在组所在电脑本机运行时撞上限同样冷却那台。+ - 已知差异:受邀者那边与组内电脑之间隔着组所在电脑的中转,中转断了(组所在电脑连续 2 分钟拉不到组内电脑)不能在原来那台+ 接着跑,直接发凭证换一台;自己的任务会先现读、恢复了留在原电脑。- **不续接的打开**(第一次运行、交接后的新会话)优先回到原电脑;原电脑不可用或满载时换一台,绑定改到新电脑,旧电脑上的会话不能再续接。- **模型**:组对外提供组内电脑模型的并集;新任务只分给提供所选模型的电脑。任务中途换模型时在当前组内电脑上核对,@@ -445,6 +472,8 @@照组所在电脑的状态显示,不拖住整个组的状态。实现见`apps/desktop/src/main/provider-group/ipc.ts` 的 `markMembersUnreachableHere`。- 手机端本期不收起(手机只显示任务实际运行的电脑)。+ - 手机输入框上方的状态与桌面一致(2026-10-11):换电脑、重新连接期间显示「正在换一台电脑继续」「重新连接中 n/5」,不显示+ 「请求失败」。- Light 与 Dark 两种模式都要实现。## 11. 与现有规则的关系@@ -478,7 +507,9 @@2. 组所在电脑、同账号其他电脑、分享的人三种使用都按组策略分配,组内电脑离线、冷却、暂停分配、满载或不提供所选模型时不会被选中。3. 正常运行的任务固定在原电脑;原电脑因 §6.1 列出的原因失败时,自动交接到组内另一台继续这一轮,消息流显示换电脑的活动记录;同一轮每台最多试一次,全部失败才报错并逐台列出原因;其中有撞上限的,等最早恢复的一台自动继续。-4. 用户停止、权限被拒、上下文超限、请求无效、内容被拒、工具出错时不换电脑。+4. 用户停止、权限被拒、上下文超限、请求无效、内容被拒、工具出错时不换电脑;其余失败都换(含认不出的)。「故障 × 阶段」的判定表+ 见 `provider-group/__tests__/failurePolicy.test.ts`,所有路径用同一个判定。本机的操作(切换焦点、改目录、改档位)不打断进行中的+ 远程一轮;组所在电脑慢一点不把任务移出组;有原生会话要续接的任务换电脑都带交接。5. 经组转发到组内电脑的任务不会再进入那台电脑的供应商组。6. 两个使用方用相同的任务或会话标识也不能读到、续接或关闭对方的任务。7. 关闭或删除对某人的分享后,此人的任务立即停止且不换电脑;移出组内电脑后不再给它分新任务,已在它上面的任务留在那台。