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。

docs(provider-group): 记下换不换电脑统一成一个判定与各路径对齐后的规则

Lizi49f671187b47
diff --git a/docs/dev-rules/protocol-compatibility.md b/docs/dev-rules/protocol-compatibility.md
index 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 与 M
O 读完即去掉,不交给 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.md
index 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. 关闭或删除对某人的分享后,此人的任务立即停止且不换电脑;移出组内电脑后不再给它分新任务,已在它上面的任务留在那台。