Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。
供应商分享:把远程供应商分享给其他 Cindy 用户
产品裁决:2026-10-07(用户确认)。本文是功能设计与产品规则;客户端与服务端已实现(2026-10-08),跨区域分享由服务端开关控制、默认关闭。 实现与本文的差异以实施计划 §0「实施记录」为准。 交互设计稿见
docs/design-previews/provider-sharing/index.html(2026-10-07 已确认); 客户端与服务端的工作拆分见docs/provider-sharing-implementation-plan.md。 2026-10-27 新目标:跨账号分享经供应商组分配后,受邀者优先连接实际执行电脑,并以 30 分钟为 离线授权上限;详见受邀者与执行电脑直连。该目标未上线时仍按本文现行授权和中转规则运行。 读取时机:新增或修改供应商分享、分享链接、分享申请与审批、分享管理页,或受邀者使用 分享供应商的任何路径之前。 分享出去的供应商建了供应商组时,§1 的运行位置、§7.2 管理页、§7.4 用量 与 §9 安全不变量按该文调整:受邀者的任务按组分配与中转、运行中自动换电脑已实现(2026-10-10,P2b / P2c), 按组的用量(§7.4)在 P3。§4.1 第 3 步的告知不论有没有组都已改用该文 §8 的说法(2026-10-10)。 2026-10-15 用户要求:受邀者把分享来的供应商放进自己的供应商组再分享给第三人时,必须由原分享者逐人同意;原分享者 删除对他的分享后,他与他分享的人都不再能用到它,见 §4.3、§9 第 8 条。
1. 定位
远程供应商已经支持同账号使用:任务、项目文件和命令留在发起任务的电脑,Agent 在另一台电脑上
用那台电脑的 Agent 程序、登录、供应商与网络运行(协议见
docs/dev-rules/protocol-compatibility.md「远程 Agent」)。
供应商分享把这项能力开放给其他 Cindy 账号:分享者把自己电脑上的某个供应商分享给指定的人, 对方在自己的任务里选用它。
- 借出的是 Agent 运行能力与模型额度,不是电脑。 受邀者的文件读写与命令仍在受邀者自己的 电脑上执行,由受邀者自己的任务权限把关;分享者不审批受邀者的工具调用。
- 分享者实时掌控。 分享者能看到分享给了谁、每个人按模型的用量,并能随时关闭或删除。
与共享任务的区别:
| 共享任务 | 供应商分享 | |
|---|---|---|
| 对方进入的是 | 房主的某个任务 | 对方自己的任务 |
| 文件与命令在 | 房主电脑 | 受邀者电脑 |
| 借出的是 | 任务上下文与 Agent | 供应商(模型额度与 Agent 运行能力) |
| 加入方式 | 邀请即授权,可转发 | 一次性链接 + 双方确认 |
两者是独立的授权关系:共享任务的访客仍然不能使用远程 Agent 通道(现状不变);供应商分享的 受邀者也不因此获得任何任务、文件或其他设备互联能力。
2. 术语
- 分享者:提供供应商的一方,即供应商所在电脑的账号。
- 受邀者:拿到分享链接、申请并被同意后使用供应商的一方。
- 分享链接:分享者为某个供应商生成的一次性链接。
- 分享申请:受邀者点开链接并确认后发给分享者的请求。
- 分享:分享者同意申请后建立的关系,粒度为「一个供应商 × 一个受邀者账号」。
文案中用「分享」,不用「共享」,避免与共享任务混淆;「供应商」按 i18n/GLOSSARY.md 使用。
实现时在 i18n/glossary.json 为「供应商分享」相关新词登记 proposed 条目。
3. 前提与范围
- 所有供应商都能分享:API Key、订阅登录、本机 CLI 账号、组织发放的供应商一视同仁。 凡是能被远程调用的供应商,分享者自己的其他电脑能用,也都能分享给他人。
- 分享人数不限,链接也可以无限生成。分享者电脑上同时运行的受邀者任务沿用远程 Agent 的 数量保护,这不是人数限制。提供方可在任一供应商的「远程与分享」页设置整台电脑共用的额度: 每台使用设备默认 16 个,所有设备合计默认 64 个;两项均为 1~1000 的整数,单设备不得高于合计。 同账号其他电脑与分享设备都计入,同一设备跨供应商、分享入口合并计数;本机直接运行的任务不计入。 已回答完但尚未关闭释放的任务、协同成员与中转任务仍占名额,关闭清理完成后才释放。 闲置收回由提供方决定(2026-10-22 用户确认):同一处设置「闲置收回(分钟)」,0~1440 的整数, 默认 30,0 表示不收回;对所有使用设备统一生效,包括同账号其他电脑。任务不忙且闲置满这个时长, 提供方结束它的 Agent 进程、释放名额;在跑或在准备的回合、后台任务、待唤醒续跑、等使用方回答的确认、 执行中的调用、待生效的回退都算忙,使用方报告本机仍有进行中的工作(Codex 经执行环境在使用方电脑起的进程) 时也不收回。新版使用方无感接回:本机部分(含后台命令)保留,下次发消息带原来的会话 id 连回同一段对话; 旧版使用方静默收起任务,下次发消息时重建并接回原来的对话,本机正在跑的后台命令会结束。使用方不再有 自己的「闲置释放」设置。旧版提供方不收回,行为不变。 修改立即生效,降低上限不终止已有任务;恢复默认清除本账号在这台电脑的覆盖设置。 供应商组中转每一跳按直接连接的设备计数,不按中转声明的受邀者额外分配额度;转分享同意规则不变。 页面显示合计占用、使用设备数及单设备最大占用;只有本机主人及其同账号电脑可以查看、修改。
- 只能在电脑上申请和使用:手机打开分享链接时,只提示到电脑上的 Cindy 打开,不提供申请。
- 能力逐级开启:
- 电脑打开「允许远程控制」,才能提供远程供应商;
- 供应商打开「允许被远程调用」,才成为远程供应商;
- 成为远程供应商后,才能分享给他人。
- 前两级任一未开启时,「允许被远程调用」一行仍然显示,但开关不可点击,并提示先开启 上一级(不再像现在这样整行隐藏)。这一行的「远程与分享」入口仍可进入(供应商组不依赖远程调用,§7.1), 分享一块在管理页里置灰并说明先开启哪一级。
- 关闭任一级时,该供应商的全部分享暂时不可用,但不删除;重新开启后恢复。受邀者看到 「暂时不可用」而不是「已被删除」。
4. 建立分享:一次性链接与双方确认
4.1 流程
分享者生成链接:在管理页点「生成分享链接」。链接只能用一次,生成后 5 分钟内有效, 过期后随时再生成,不限次数;不需要也不提供「未使用链接」的管理与撤回。口令为 256 位随机值, 只放在链接
#之后,不进入网页请求;服务端只保存口令摘要,口令不进日志。受邀者打开链接:网页唤起电脑上已安装的 Cindy(复用共享任务邀请页的唤起方式)。未登录时 先登录,登录后继续。在手机上打开时,网页与手机端都只提示「请在电脑上打开这个链接」。
受邀者确认并申请:Cindy 弹窗展示:
- 分享者是谁(见 §6 身份展示);
- 分享的是什么:供应商名称(不写分享者的电脑名,见 §6);
- 运行方式:Agent 在分享者的电脑或分享者安排的其他电脑上运行(分享者可能建了供应商组; 不论有没有组都这样写,之后建组不需要再提醒),受邀者的文件和命令仍在自己电脑上执行;
- 隐私:对话内容和 Agent 读到的文件内容会经过分享者的电脑,并保存在实际运行任务的那台电脑上;
- 身份:受邀者的昵称和头像会展示给分享者,以及需要同意他使用的其他电脑主人(分享者把别人分享来的电脑放进了 供应商组,§4.3),不展示邮箱、手机号等其他信息。
受邀者点「发送申请」后才真正提交;取消不提交,链接在 5 分钟有效期内保持未使用。 提交后受邀者看到本次申请的配对码(见 §6.1),等待分享者同意。
分享者审批:分享者在供应商所在的电脑上收到弹窗(应用在后台时同时发系统通知),展示申请人 的昵称和头像(见 §6)、申请的供应商与同一个配对码,选择「同意分享」或「拒绝」。 分享的是 Claude 订阅登录时,弹窗另写一句:受邀者使用时,Agent 能看到分享者登录 Claude 用的邮箱 (Claude Code 自己会把它交给模型,Cindy 目前挡不住;2026-10-10 裁决先告知分享者)。 这个供应商建了组时,同意说明写「由供应商组选一台电脑运行 Agent」,不说在这台电脑上运行(供应商组 §8)。
- 弹窗跟着生成链接的电脑(2026-10-14 用户裁决):同账号另一台电脑可以从「远程与分享」为供应商组生成链接 (供应商组 §10 同账号管理)。这时审批弹窗与系统通知出现在生成链接的那台电脑上, 供应商所在电脑与其他电脑都不弹,只在管理页「待处理」和入口提示点里显示;同意、拒绝转交供应商所在电脑执行。 理由:链接只能用一次、5 分钟内有效,申请基本在生成后几分钟内到达,那时人就在生成链接的电脑前、能当面核对配对码; 不在每台电脑上都弹,也不弹在可能无人值守的建组电脑上。
- 判定窗口为生成链接后 7 分钟(5 分钟有效期加拉取余量),两台电脑用同一时长,按具体链接区分: 窗口内供应商所在电脑只对这条链接的申请静默,生成链接的电脑只弹这条链接的申请。后来在本机或第三台电脑 生成的链接各自归属,不清除或接管其它链接的窗口;窗口过后才发现的申请照旧由供应商所在电脑弹。 窗口按当前账号保存,完整应用重启后恢复。错过弹窗(生成链接的电脑已关闭等)时,在任意一台电脑的 「远程与分享」页都能处理。精确关联需要服务端和两台电脑支持链接标识;旧服务端仍可本机生成,跨电脑生成提示更新。
建立:同意后分享立即生效,受邀者收到通知,模型列表里出现该供应商。
4.2 链接与申请的状态
| 状态 | 说明 | 下一步 |
|---|---|---|
| 未使用 | 已生成,尚无人申请 | 5 分钟内无人申请即过期 |
| 待审批 | 第一个提交的申请锁定了链接 | 他人再打开同一链接,提示「链接已被使用」 |
| 已同意 | 分享建立 | 链接失效 |
| 已拒绝 | 分享者拒绝 | 链接作废,要分享需重新生成 |
| 已撤回 | 受邀者撤回申请 | 链接作废 |
| 已过期 | 链接 5 分钟内无人申请,或申请提交后 24 小时内未处理 | 链接作废 |
- 一个链接只能用一次:只有第一个提交的申请有效;同意、拒绝、撤回、过期都会让链接作废, 不会放回去再用。
- 5 分钟只限制「打开链接到发送申请」;申请发出后等待分享者处理,24 小时内有效。
- 分享者不在线时,申请由服务端暂存,分享者那台电脑上线后再弹出(链接由同账号另一台电脑生成时按 §4.1 第 4 步); 受邀者看到「已发送申请,等待对方同意」,可以撤回。
- 分享者打开自己的链接:提示「这是你自己的供应商,你的其他电脑可以直接使用」,不进入申请流程。
- 同一受邀者已拥有该供应商的分享时再次申请:提示已在使用,不重复建立。跨区域链接在预览或
发送申请时由服务端确认「已是成员」后,自动恢复这台电脑的分享列表、专用连接与区域记录;
断网后沿现有退避和启动恢复路径重试,换账号后的迟到结果不生效。链接已用或过期本身不能
作为恢复依据。实现与回归见
providerShareCrossRegion.ts与providerShareCrossRegion.test.ts。
4.3 转分享:分享来的供应商再给别人用(2026-10-15 用户裁决)
受邀者 B 可以把 A 分享来的供应商加进自己的供应商组;这只扩大 B 自己的用法(A 已同意 B 使用), 不需要再问 A。但 B 把这个组又分享给别人(C)时,C 的任务会经组跑到 A 的电脑上,等于把 A 的供应商转给了 C,必须由 A 逐人同意:
- 按人同意(用户裁决:每个新受邀者都要 A 单独同意,不是同意一次就对 B 的所有受邀者有效)。按 C 的账号计,C 从哪台 电脑来都是同一个人。A 没同意的人,任务不会分到 A 的电脑;B 分享出去照常进行,C 用组里其他电脑。
- 不用 B 手动发起:B 的组所在电脑在组里有分享来的电脑、而组所在的供应商又分享给了别人时,自动把分享的人报给那台 电脑;B 新分享给一个人、或把分享来的电脑加进已分享的组时随之报上。B 不能替 A 同意。
- A 处理:A 的「远程与分享」页「待处理」一栏出现「{C} 想经 {B} 的供应商组使用」,可同意或拒绝;处理过的人列在 「已分享的人」里 B 那一行下方,已同意的可以撤回,拒绝的可以改为同意。新请求在应用不在前台时发系统通知,设置页入口 亮提示点;不另弹审批弹窗(不是新的分享申请)。A 看到的 C 的昵称与头像由 B 的电脑转述,A 无法另行核实(§6 已知局限同理); 同意后 C 的用量算在 B 名下(A 那边看到的仍是 B 在用)。
- 生效与撤回:同意后下一次分配起生效;撤回或拒绝立即结束 C 经组跑在 A 电脑上的任务,之后不再分给 A 的电脑。 B 删除 C、或把 A 的电脑移出组时,A 那边的这条请求随之消失;A 删除对 B 的分享(或 B 退出)时,B 名下的全部同意一并作废, 之后重新分享给 B 也要重新同意。
- 原分享删除即不再有:A 删除对 B 的分享或 B 退出后,B 自己与 B 分享的人都用不到 A 的电脑——B 的组在确认分享已不在后 自动把那台移出组(只在拿到完整可信的已收到分享名单时才判断,见供应商组 §3)。A 只是暂停分享时保留, 恢复后照旧(同意也保留)。
- B 那边看到什么:组内电脑那一行的状态写「分享的人可以用」「N 位分享的人等待 {A} 同意」或「{A} 未同意 N 位分享的人」; 展开这一行逐人列出。A 的 Cindy 太旧给不出同意时写「{A} 的 Cindy 更新后才能同意给分享的人用」,这台不分给分享的人。 C 在「分享给我的供应商」的匿名状态里看到这台「暂不可用」(或「需要更新」),与实际分配一致。
- 协议见
docs/dev-rules/protocol-compatibility.md「供应商组:转分享需原主人逐人同意」;同意记录只存在 A 的电脑上 (provider-share-reshare.json),不经服务端。分享来的供应商本身仍不能生成分享链接,只能经组转给别人。 转分享名单单次最多传 256 人;超过时由支持reshareBatch的新版电脑分片发送,每片回报当前片的状态,接收端收齐后才整体替换审批名单, 批次数不按人数设置固定上限而受接收端字节预算保护。完成片段的重发保持幂等;旧版电脑显示需要更新并保持原有名单,不发送部分名单。
5. 受邀者使用
5.1 模型列表
模型列表整体结构不变:分享来的供应商与同账号的远程供应商放在同一个远程供应商区域,沿用现有的 左侧图标(带远程角标)与分组方式,只在分组标题多写一句来源:
- 同账号的远程供应商:
Anthropic · Magi's Mac Mini(现状不变) - 分享来的供应商:
Anthropic · 来自 Magi 的分享,不写分享者的电脑名(§6,2026-10-10 用户裁决)。 同一位分享者的同一个供应商分享了不止一份时,后面的按列表顺序加序号:来自 Magi 的分享 (2)。 - 分享者把这个供应商建成了供应商组时:标题后加台数,
Anthropic · 来自 Magi 的分享 · 供应商组 · 3 台电脑。标题显示台数,匿名状态在详情查看(§5.2),不显示是哪几台。手机端本期不显示组信息 (与供应商组 §10 手机端口径一致),只沿用前两条的标题写法。
Desktop 与 Mobile 使用同一写法。
同账号的桌面远控中,已建任务、新建任务与 Worker 的模型菜单都应列出可用分享,不以任务已经选用
该分享为前提。Desktop 复用控制端的已收到列表与分享读取通道,并通过既有
maker:provider-share:received-catalogs 核对任务所在电脑也已加载且未暂停该分享;跨区域连接的启用
标记保存在各电脑本地,不能仅凭控制端名单认定被控端可用,也不自动替被控端开启跨区连接。
同账号供应商组是已加入分享的另一条有效来源:任务所在电脑从组所在电脑的 view / pick 回包或
manage-group 组视图确认分享引用后,可自行向另一区域的官方分享服务核验已有授权并恢复连接,无需再次申请;不从 Renderer
自报的分享 ID 或收藏恢复联网资格。名单仍由服务端裁决,暂停、撤销与账号切换照常生效。
本区和跨区名单独立可用:返回名单里已加载且有效的分享立即参与候选筛选;仍有区域尚未就绪时,
控制端继续有上限地退避查询,补上稍后加载的分享,不让单一区域故障阻塞另一区域。
查询失败或旧主机不支持时不新增分享候选,当前 / 待切换位置仍保留。模型选择和执行仍由任务所在电脑校验;
手机沿用被控电脑代读目录。暂停或已移除的分享只为当前 / 待切换位置保留,供用户查看状态并换走。
Desktop 模型列表底部的「配置模型」在看分享来的供应商时同样显示,点开直接进入设置里这条分享的详情 (§5.2;2026-10-15 用户确认)。同账号其他电脑上的远程供应商与远程控制的电脑上的任务不显示,它们的设置 要到那台电脑上改。
Desktop 模型选择器「全部」「收藏」里,分享来的模型每行第二行沿用上面的来源写法(含供应商组台数),
分享的是内置 Cindy AI 时也一样,写 Cindy AI · 来自 Magi 的分享;只有受邀者自己电脑上的 Cindy AI 在这里
显示模型简介(#6110,口径见模型目录运行时)。行内同样不写分享者的
电脑名(§6)。
5.2 供应商设置
IM bot 的渠道默认模型,以及官方 Slack / Telegram / X 的工作目录模型配置,沿用同一个
模型选择器展示已收到的分享。选择同时保存引擎、模型、供应商和 share:<id> 执行位置;
切回本机清除执行位置。个人渠道各自独立,官方目录偏好仍按渠道、team、目录隔离,不发给 hook server。
新建、/new、冷启动恢复、通知回复和接管已有任务均保留执行位置;跟随渠道默认的任务在
下一条消息时按既有切换流程交接,手动改过的任务不跟随。个人渠道 /model 对已使用分享的任务读取
该分享的授权目录,换执行位置仍在 Cindy 的模型配置中进行。
分享模型不要求发起电脑有同名供应商或登录;暂停、撤销、离线或模型不可用时拒绝执行,
不回退到本机同名账号。权限确认、分享凭证确认和工具执行沿用现有远程 Agent 通道,不扩大
IM 发言者或分享者的权限。手机查看已有任务时沿用主机保存的执行位置。
官方 bot 的显式权限档必须属于本机已知档位,且分享方声明支持该档;不支持时拒绝启动,
不按分享方返回顺序选择回退档位。未显式设置时保留官方 bot 既有默认。
实现见 im/remoteProviderRoute.ts、im/shared/turnRunner.ts 与 hook-control/session-runner.ts
(相对 apps/desktop/src/main/);回归覆盖各自同目录的 __tests__。
Desktop「设置 → 模型供应商」的左栏(2026-10-08 用户裁决):
- 自己其他电脑上能用的供应商也列在左栏,接在本机供应商后面(不参与拖动排序):图标右上角带与模型
列表同一个远程角标,行式与本机供应商相同,所在电脑只写在悬停提示里;点开在右栏只读地看所在电脑、状态与开放的模型,修改要到那台
电脑上去。只列在线、允许远程控制的同账号电脑上已开「允许被远程调用」且已连接的供应商,与模型列表
能选的范围一致。
2026-10-22(用户裁决):右栏同时只读显示那台电脑上该账号的剩余额度,与本机详情复用同一张额度卡;
仅订阅类连接读到数据时显示,不提供重置或打开用量网页等管理操作,也不受分享的「允许查看剩余额度」开关控制。
供应商组只在成员里分别显示,不在顶层合并或代取某一台的额度。
同账号电脑上的 Codex 额度经已有
maker:usage:codex-rate-limits实时读取,按电脑与供应商账号共享缓存和在途请求。 详情、模型选择器左栏和模型行打开且页面可见时约每 60 秒复查,关闭或隐藏后停止;换账号丢弃旧结果。 详情与左栏取账号通用额度,模型行按模型选择额度桶;ChatGPT 网页额度仍读原有 WHAM 槽。 旧电脑不支持实时通道或读取失败时回退原快照,回退也失败时保留已有数据;「数据更新于」保留数据实际读取的时间。 快照通道成功返回空账号时清除已有额度(例如远端退出账号),不把明确清空当成读取失败。 分享来源仍按 §7.5 的独立授权读取。实现见 useRemoteDeviceUsage.ts,回归见 useDeviceProviderSubscriptionCard.test.ts。 实现见 OwnRemoteProviders.tsx, 回归见 OwnRemoteProviders.test.tsx。 - 我分享的供应商(2026-10-29 用户裁决)单独一组,接在普通供应商之后、「分享给我的供应商」之前;
本机和自己其他电脑上已建立分享关系的供应商(含供应商组)都归这里,不与普通供应商组混排。
只生成链接或仍在等待同意不算已分享;暂停分享仍保留,删除最后一位分享成员后回到普通列表。
每项只显示一次,原有选中、详情与「远程与分享」管理入口不变;本机供应商可在各自分区内排序。
读取暂时失败时保留上次分类,换账号不沿用;没有已分享的供应商时整组不显示。
实现见
ProvidersSection.tsx与useOwnedProviderShares.ts。 - 分享给我的供应商单独一组「分享给我的供应商」,没有分享时整组不显示:每条用分享者头像标明来自谁, 带状态点;点开在右栏看来源、状态、对方开放的模型(只读,开关由分享者决定),并可「退出」。来源只写 「来自 Magi 的分享」,不写分享者的电脑名;分享者建了供应商组时补「供应商组 · N 台电脑」。 2026-10-12:详情可查看「电脑 1、电脑 2…」的匿名状态,以判断离线、冷却、暂停或不支持接收分享任务等情况; 不显示真实名称、设备标识、来源或用量。状态刷新与旧版本回退见供应商组 §10。 2026-10-15(用户裁决):详情里说明段下方有一行「信任 {分享者}」开关,默认关闭、只存在这台电脑上;打开后用 这个分享的任务不再弹 §9 第 7 条的凭证确认卡(运行中的任务从下一步起生效),与本机任务一致。退出分享或分享被 删除时一起清掉。文案(2026-10-15 用户反馈原「凭证操作不再确认」太技术):标题写「信任 {分享者}」——信任的是 分享给我的人;说明只一句「读取密钥等敏感信息时不再弹窗确认,和用自己的供应商一样」,再加「只对这台电脑生效」, 不写文件名、命令与同步细节。分享者建了供应商组时,不论任务被分到组里哪台电脑都同样生效:确认在受邀者自己的电脑上 判断,按这条分享记,组里换电脑不改变分享。
- 输入分享链接:页面右上角一个「输入分享链接…」按钮,点开弹窗输入链接,之后进入同一个申请弹窗。 网页唤起 Cindy 失败时,加入页指引用户到这里输入。
5.3 不可用时
以下情况下,受邀者已选用该供应商的任务在发送时给出明确原因,并提供「换成其他模型」(复用已建 任务换 Agent 所在电脑的能力):
- 分享者的电脑离线或未运行 Cindy;
- 分享者关闭了「允许远程控制」或该供应商的「允许被远程调用」(暂时不可用);
- 分享者关闭了对你的分享(已暂停);
- 分享者删除了对你的分享(该供应商从模型列表移除)。
受邀者也可以随时主动退出某个分享;退出后需要分享者重新生成链接才能再次使用。
6. 身份展示
- 只展示昵称和头像(2026-10-07 裁决)。邮箱、手机号一律不展示,脱敏后也不展示;组织、区域 也不展示。服务端不收集、不保存这些信息。
- 不展示分享者的电脑名(2026-10-10 用户裁决)。受邀者只知道是谁分享的、分享的是哪个供应商;分享者
建了供应商组时可以知道台数并查看匿名状态(§5.2,2026-10-12),不知道是哪几台;台数与匿名状态按电脑,
看不出一台上有几个账号(2026-10-15)。分享者的订阅账号
(登录邮箱)在每一跳都去掉(§9)。具体做法:
- 生成链接时分享者电脑不再上传电脑名,
deviceName填固定占位(字段必填,旧版受邀者按必填解析); 服务端仍存着旧链接里的电脑名,新版本的界面一律不显示它,转给手机时也换成占位; - 申请弹窗、模型列表、「分享给我的供应商」、换电脑的分隔条都不写电脑名;
- 分享来的电脑加进供应商组后,组所在电脑的主人也只看到分享者的昵称(「Magi 的电脑」), 组摘要里这类组员不带名字,换电脑的活动记录写分享者昵称。同一个人从同一台电脑分享的几个账号收在同一个 「Magi 的电脑」下面(按分享里本来就有的设备 id 判断,不显示电脑名,2026-10-15)。
- 已知差异:旧版本受邀者看到的是占位名(新链接)或原来的电脑名(旧链接),更新后才不显示。
- 生成链接时分享者电脑不再上传电脑名,
- 展示的昵称和头像必须来自对方本人的账号、由服务端核实,不能来自客户端自报或消息内容。
- 身份名片:没有任何「查看别人资料」的接口,也不新增。每一方只在自己操作时(分享者生成链接、 受邀者发送申请)用自己的登录凭证向本区域账号服务换取一张短期签名的身份名片,内容只有昵称和 头像(另含验签所需的账号标识、用途与绑定信息,不展示)。名片由账号服务签名,客户端无法伪造或修改; 有效期很短,并绑定本次链接或申请,不能挪作他用。服务端验签后保存为快照,只展示给这次分享的另一方。 同区域与跨区域使用同一种名片,跨区时由对方区域用本区域公钥验签。
- 已知局限:昵称和头像任何人都能改。拿到链接的人若把昵称改成你同事的名字来申请,界面上无法 分辨。由 5 分钟一次性链接(泄露窗口小)、分享者主动发出链接的场景,以及 §6.1 的配对码兜底。
6.1 配对码(2026-10-07 用户确认)
用来核对「发申请的人就是我发链接的那个人」,不暴露任何个人信息。
- 受邀者发送申请时,服务端为这次申请生成一个 4 位数字配对码,与申请绑定保存;不同申请的配对码相互独立。
- 配对码只出现在两处:受邀者发出申请后的「等待同意」界面,以及分享者的审批弹窗与管理页待处理一栏。 系统通知、链接、加入网页、日志里都不出现。
- 分享者同意前可以通过发链接时用的聊天渠道问对方一句「你看到的配对码是多少」,一致再同意。核对是 可选的,不强制;审批弹窗用一句话提示可以这样核对。
- 冒用者能看到的只是自己那次申请的配对码;真正的同事这时打开链接只会看到「链接已被使用」,说不出 一致的号码,分享者据此拒绝即可。配对码不是密钥,不需要对申请人保密,也不参与任何鉴权。
7. 分享管理
7.1 入口
供应商设置详情中「允许被远程调用」一行,开关左侧是「远程与分享」入口按钮,点击进入该供应商的管理页 (供应商组 §10 的「远程与分享」页)。2026-10-11 用户反馈详情因供应商组多出一行而太长: 原来的分享图标与「供应商组」一行合并成这一个按钮——有组时写「供应商组 · N 台电脑」,没有组时写「远程与分享」。 有待审批申请时按钮右上角带提示点,Tip 与无障碍名称写明有几个申请待处理。入口始终可点:供应商组不依赖 「允许被远程调用」;分享未开启时由管理页说明需先开启哪一级(§3)。
同账号另一台电脑上的供应商组,在设置页左栏组那一项的详情里有同一个入口,进入同一页管理那台电脑上的组与分享 (供应商组 §10)。这个入口的提示点只数这台电脑生成的链接带来、由这台电脑弹窗的申请(§4.1 第 4 步); 那台电脑上的全部待处理申请在页面「待处理」里。
7.2 管理页内容
管理页按供应商划分,标题为「{供应商} · 远程与分享」,从设置页进入、可返回:
- 生成分享链接:主操作,放在页面标题一行的右侧(2026-10-16 用户反馈放在页面底部太难找)。页面不再单设「分享」块和 分享说明:Agent 在哪运行、用量算谁的,由审批时的同意说明(§4.1 第 4 步)讲清;未开启分享时的原因提示紧跟标题(§3)。
- 待处理:待审批的申请(同意/拒绝),以及转分享请求(§4.3,同意/拒绝);紧跟标题、排在供应商组之前,为空时整块隐藏。 链接 5 分钟即过期,不列出未使用的链接。
- 已分享的人(2026-10-16 起不再单列,并进页面上方的「用量」块,与这个人的用量同一行,见供应商组 §7;
用户要求同一个人不在两处出现):显示头像、昵称、加入时间、最近使用、当前状态(正常/已暂停)与是否有任务正在运行;关闭与删除在
这一行行尾的
···里;这个人经自己的供应商组转给别人用、已处理过的请求列在这一行下方(已同意的可撤回,拒绝的可改为同意,§4.3)。 - 用户备注(2026-10-19 用户要求):这一行的
···可设置或修改备注,最多 80 个 UTF-16 单元;留空保存即清除。 有备注时按人列表与使用方筛选优先显示备注,列表另保留原用户名,关闭、删除等操作也用备注称呼;没有备注时沿用原昵称。 备注只属于分享者的这个成员关系,保存在供应商所在电脑、按账号隔离,同账号其他电脑经现有管理通道读写;不修改对方的昵称, 不交给分享服务、受邀者或其他账号,也不改变分享权限。旧电脑不支持保存时明确提示更新,不退到控制端保存。 本机与同账号跨电脑保存均先刷新成员名单,刷新后成员已不在名单中或账号已切换时拒绝保存。 - 用量(2026-10-11 起移到页面上方的「用量」块;2026-10-17 起与设置 → 用量同一套,见供应商组 §7): 标题同一行右侧筛选使用方、当前组内电脑、时间范围与日期,默认是所有人的合计;概览、活跃热力图、明细、近 30 天每日 token。 2026-10-19 起明细合为一张卡,切换按人 / 按电脑(有组时) / 按模型(含估算金额),默认按人(第一行是自己即当前登录账号, 之后是分享的人,只显示昵称与头像,§6)。已移出的电脑不再单独列出,历史合计保留。时间范围与设置页相同: 所有时间/最近 30 天/最近 7 天/今天/选某一天。
- 操作:
- 关闭:暂停对此人的分享,可随时恢复;
- 删除:永久移除,需要重新生成链接才能再次分享;删除前二次确认。
7.3 生效时机
- 关闭与删除立即生效:此人正在运行的任务当场停止,之后发送的消息被拒绝。迟到的响应、缓存或 重连都不能恢复已撤销的访问。
- 恢复后从下一条消息开始可用。
7.4 用量统计
- 用量在分享者电脑上按受邀者与模型统计:Agent 在那里运行,数据最准,也不经过服务端。
- 订阅类供应商没有逐次扣费,按本地单价估算并明确标注「估算」,不代表供应商实际账单。
- 管理页按天明细经同账号远程管理回传时最多 5,000 行,按最新日期的行优先保留;最新一天可以只保留部分,
超出 UTF-8 JSON 字节预算时继续从较早的行裁剪,
coverageStart标出保留下来的最早日期。报告行的日期按接收端时区的lastAt重新计算,跨时区边界由前后两天的增量缓冲覆盖。 - 受邀者自己的运行数(2026-10-10):分享者电脑在给受邀者的供应商目录里带上这个受邀者账号(它的每台电脑) 此刻在这个分享上正在运行一轮的任务数,供受邀者的供应商组 §5 统计。只是受邀者自己的数, 不含分享者本人和其他受邀者,不泄露分享者电脑上的其他使用情况;不是用量;受邀者查看历史用量须由分享者另外开放,见 §7.5。
7.5 剩余额度与用量明细的可见性(2026-10-19)
- 当前供应商的「远程与分享」详情提供「允许查看剩余额度」「允许查看用量明细」两个独立开关,默认关闭。 设置按账号、电脑与供应商保存,对当前和未来所有受邀者统一生效;同账号其他电脑经既有管理通道写入供应商所在电脑。 关闭查看权限不关闭模型调用、不终止任务,不承诺追回已读取的数据。
- 受邀者在对应分享详情查看获准的数据。2026-10-22 用户裁决:Desktop 模型选择器左栏在分享者开放额度、且返回单账号每周窗口时, 沿用本机供应商的每周剩余额度细条与悬停提示;供应商组、多账号、余额或不可用时不显示。只在列表打开、格位挂载且页面可见时查询, 列表内切换目录重挂载时复用五秒内的结果与在途请求,按剩余时间复核权限,只取额度,不读用量历史;关闭、隐藏、换账号或分享关系变化清除旧值,丢弃迟到结果。模型行不读取分享的订阅额度;模型行第二行、任务额度条、手机端与组调度仍不扩展。 分享详情中的额度是账号共用额度,复用已有订阅窗口、个人 Cindy AI 余额池或组织/网关周期额度及对应只读展示;已知总额用进度条,未知值不推算成零或百分比。 不显示充值、重置次数等管理操作信息。 组内自有账号匿名逐项显示,不相加百分比、不声称同账号多设备可合并;从他人借来的账号不继续公开额度。 页面说明可能只显示部分账号、同一账号多设备可能分列;不可读取、不支持、离线、旧端、未开放分别显示。
- 用量明细默认收起;未打开对应分享详情或模型列表时不发本功能查询。打开但未展开时只取权限和获准的额度,不读取、汇总、投影或传输用量历史(包括缓存)。 主动展开才立即读取明细,并在页面可见期间刷新,显示筛选、概览、图表和明细,避免遮挡模型列表。 再次收起停止后续明细请求,保留有效额度;离页或隐藏停止全部本功能查询。已发出的调用不做跨端取消,但迟到结果不得回填。 轮询不自动展开,换分享或账号、重新进入详情均默认收起,不保存偏好。 用量复用现有账本、时间范围与图表,开放分享者本人和当前成员昵称/头像、按人/模型/时间的历史统计,金额标为估算。 已删除成员沿用现有不展示规则;经同账号组转来的用量汇入匿名「转来的用量」,不暴露设备、不归入分享者本人。 私人备注、真实设备身份、凭证、登录邮箱、任务/文件内容与转分享审批细节不进入展示 DTO。
- 分享者电脑按验证过的分享身份决定供应商,前后核对账号、关系与两个开关的代次;最终发送与背压重发再次校验。
关闭后重开不恢复旧回包。专用只读结果不进入通用完成缓存,不启动/接回远程 Agent。
页面可见时最多每五秒复核,隐藏/换分享/账号/关系变化或查询失败清除旧展示;额度和用量失败分别处理。
本机历史缓存十五秒、额度读取短缓存并合并在途查询,按账号隔离。
最终只读回包的字节预算包含额度、所有人的昵称/头像和历史行;超限时继续优先保留较新的历史行,并更新
coverageStart。 不静默删掉人员或把未返回的历史当作零用量;人员资料本身或一条历史都无法容纳时,用量显示不可用,额度仍独立返回。 额度本身超过回包预算时也只标额度不可用,不影响能够返回的用量。
实现:device-link/providerShareInsights.ts、providerShareQuota.ts、providerShareVisibility.ts 与 renderer 同名功能组件;
模型左栏实现:renderer/components/new-chat/{UnifiedModelRail,ModelSelector,ModelSourceDetails}.tsx、renderer/features/provider-share/useProviderShareWeeklyQuota.ts;
回归:renderer/__tests__/{providerRailWeeklyQuota,modelSourceDetails}.test.tsx、device-link/__tests__/providerShareInsights.test.ts、providerShareDispatch.test.ts、providerShareQuota.test.ts、providerShareVisibility.test.ts。
8. 跨区域分享
中国大陆版与 Global 之间必须能互相分享。两个区域的账号与设备互联服务是两套独立系统,因此:
- 分享属于分享者所在区域:成员关系与授权保存在分享者区域的服务端。受邀者连接分享者区域的 设备互联服务,同区域分享时就是自己平时连接的服务,两种情况走同一套逻辑。
- 只认两个官方区域:两个版本都内置对方区域的官方地址;分享链接只能在这两个官方区域中选择, 不能把客户端引导到任意地址。
- 跨区身份核实:使用 §6 的身份名片。受邀者所在区域的账号服务签发,分享者区域的服务用对方 区域公钥验签后,才把申请交给分享者;分享者看到的身份与同区域一样经过核实。
- 专用凭证:分享建立后,分享者区域的服务为受邀者签发只限这个分享的凭证,只能用于远程 Agent, 不能访问分享者区域的其他服务或能力。
- 同账号换电脑:另一台电脑使用已建供应商组时,组中获准使用的跨区分享必须可正常连接。
本机没有区域标记时,以同账号组的有效回包触发核验,复用既有身份名片与分享连接凭证,不重新申请。
标记仍只保存区域;加载期间或查询失败不得误报「分享已移除」,已加载区域的分享仍可独立使用。
实现与回归见
providerShareGuest.ts、providerShareCrossRegion.ts、provider-group/remoteClient.ts、provider-group/ipc.ts、device-link/__tests__/providerShareCrossRegion.test.ts与provider-group/__tests__/ipc.test.ts(2026-10-26)。 - 合规开关:跨区会让用户内容跨境流动,并让一方用户通过分享使用另一区域的模型。跨区分享须经 公司合规确认后,由服务端开关开启;开关关闭时跨区链接提示暂不支持,同区域分享不受影响。
- 网络:跨区连接质量不能保证时,需要服务端评估区域间转发;客户端对跨区连接的断线与重试沿用 远程 Agent 的恢复规则。
这是对共享任务「两区域独立,不默认跨区域加入」的有意区分,仅适用于供应商分享;区域仍是构建期
维度,用户不在产品内选择自己属于哪个版本(region-and-editions.md §2.4)。
9. 安全不变量
- 只开放远程 Agent:来自受邀者的请求,分享者电脑只放行远程 Agent 运行、按该受邀者权限过滤后 的供应商列表,以及 Agent 能力查询、按 §7.5 独立授权的额度/用量只读查询;其他设备互联能力一律拒绝,绝不降级为整台电脑的远程控制。
- 凭证不出分享者电脑:模型请求只由分享者电脑上的 Agent 用分享者的登录与供应商发出。
- 权威划分:服务端是成员关系的权威(谁是成员、是否已删除);分享者电脑是使用范围与用量的 权威,在开启运行、发送消息和换模型时逐次核对,是最终裁决方。
- 受邀者请求不可信:受邀者发来的启动参数按白名单校验,不能沿用同账号设备之间的信任; 每次操作前重新核对成员有效性。
- 分享者电脑上不留可利用的本机能力:Agent 在分享者电脑上运行时,不加载分享者的个人配置、
hooks、插件、扩展和本机 MCP(Claude Code 现状已满足,Codex 与 Pi 须补到同等水平),也不执行受邀者
随项目带来的 hooks、扩展等可执行配置。受邀者同步来的所有 Markdown(说明、规则、命令、子代理、Skill
与
@导入的文件)里指向会话目录之外的@引用一律断开,不能借 Claude Code 读进分享者电脑上的文件;@导入的文件只收 Markdown 与纯文本(2026-10-10)。 Agent 自带工具按白名单开放(2026-10-10 裁决,取代 2026-10-07「联网工具不单独处理」):Agent 程序以分享者的系统用户在分享者电脑上运行,受邀者会话只开放不作用于分享者电脑、分享者电脑上的其他 会话和分享者账号的自带工具;文件与命令仍回到受邀者电脑执行。Agent 升级新增的工具不会自动开放, 须评估后加入白名单。因此给其他会话发消息、发布到分享者账号(如 Claude 的 Artifact、云端定时任务、 设计项目)、在分享者电脑上读文件或跑命令都不可用;自带的 WebFetch 会从分享者的网络发出请求、能访问 分享者的内网,对受邀者关闭,Claude Code 的 WebFetch 改由受邀者电脑提供、用受邀者的网络抓取(同日补充; 受邀者电脑上的 Cindy 较旧时没有):本机、内网与云 metadata 地址须受邀者在确认卡上批准,跳到其他网站 时交回 Agent 重新调用;联网搜索由模型服务方执行,保持可用。同账号远程供应商不受影响。 实现:Claude Code 用 SDKtools白名单,Codex 按功能清单关闭白名单之外的功能,Pi 只放行 Cindy 扩展注册的工具(packages/maker-core/src/agents/{shared/device-hosted,codex/device-hosted-guest,pi/cindy-bridge-source}.ts); 受邀者电脑上的 WebFetch 见apps/desktop/src/main/remote-agent/executor/webFetch.ts。 重建同样保持隔离(2026-10-27):Codex 原生thread/fork会重新加载进程默认配置,不能 假定它继承源线程的覆盖项。回退/编辑重发必须和正常启动、恢复一样带上任务的执行环境、远程 MCP 路由与完整能力隔离配置。受邀者复制历史的一次性 fork 不接入任何本机 MCP 或连接器,不能检查 功能清单时拒绝创建子线程,用后关闭独立进程;子线程正式恢复时再接入受邀者工具。 回归:packages/maker-core/src/agents/codex/__tests__/device-hosted-guest{,.native}.test.ts, 覆盖回退后续发、历史复制与功能检查失败;真实 Codex 0.159.2 验证本机默认能力不会重新进入受邀者线程。 - 受邀者隐私:申请前明确告知对话与文件内容会经过分享者的电脑,并保存在实际运行任务的那台电脑上 (有供应商组时可能是分享者安排的其他电脑)。运行中疑似工具循环时,与分享者自己的任务一样,由运行任务 那台电脑的辅助模型复核:用户目标与最新要求、主模型已有的公开行动说明,以及最近十余次工具调用的 脱敏摘要会发给那台电脑设置的辅助模型(可能不是分享的 供应商,也不计入受邀者用量;2026-10-13 用户裁决);分享被删除或受邀者退出后,分享者电脑清理该受邀者的 Agent 会话记录与镜像文件,并请接过它任务的组内电脑清理(供应商组 §4)。
- 受邀者自己的权限:受邀者电脑上的文件与命令操作仍由受邀者自己的任务权限档把关,分享不放宽
受邀者本机的任何限制。
凭证类再收紧一档(2026-10-10 裁决):对话与 Agent 读到的内容会经过分享者的电脑,因此
- 凭证类文件(密钥、
.env、云与工具的登录凭证,规则同本机任务;Claude Code / Codex 配置目录里的 Skill、子代理、命令与说明文字不算)不随项目说明与个人配置在启动时同步,链接按真实目标判断; - 任务中读写凭证类文件、执行读取或打出凭证的命令,不论权限档(含完全访问)都要受邀者在本机确认卡上
允许,默认只放行这一次。确认卡同时提供「本任务总是允许」(2026-10-12 用户确认):受邀者明确选择后,
当前任务不再额外确认凭证操作,Pi 的搜索结果也可包含凭证内容。授权按「任务 + 分享」只记在本机
主进程内存里(2026-10-13 用户裁决):Agent 实例被系统回收后重建(如 Orca Worker 一轮结束后释放进程)
时,原始权限档与计划模式都和授权时相同才沿用(不按归并后的档位比,
default改ask也算变化); 切换权限档或计划模式、退出应用后恢复确认,不扩展到其他任务或供应商分享。回收期间在 Desktop / 手机 远控的权限入口切走又切回,同样作废;Agent 正在重建、任务尚未对外可见时改权限档,已恢复到新执行器 的授权也一并收回。已知代价:归档后恢复的任务在本次应用运行期间沿用之前的授权; 回收期间经 IM 切走又切回原档位不会被识别(最终档位与授权时相同)。原权限档的其他限制仍然生效, 启动同步仍排除凭证文件。确认卡说明内容会经过分享者或其安排的电脑,以及这项授权的范围与失效时机。 确认卡与 Agent 的确认走同一通道,手机远控与 IM 也能处理; 按分享关掉确认(2026-10-15 用户裁决):受邀者可在「设置 → 模型供应商 → 分享给我的供应商」某个分享的 详情里打开「信任 {分享者}」。粒度是一个分享(分享者 × 供应商),只对这台电脑生效,按账号保存在本机 (userData/owners/<账号>/provider-share-guest-prefs.json,只存显式打开的项,只含分享 id 与分享所属区域)。 打开后该分享的任务不论权限档都不再弹这张卡,Pi 的搜索结果也可包含凭证内容,与本机任务和同账号远程供应商 一致;门禁每次操作前重读,运行中的任务从下一步起生效,关掉即恢复确认。启动同步仍排除凭证类文件;退出分享 或分享从已确认区域的权威名单里消失时偏好一起清掉。它放宽的只是这一个分享;「本任务总是允许」仍只限当前任务, 其他分享与本机任务的判定不变; - 命令只能按命令文本识别(脚本里读的、编码后再解开的认不出来),是防误发,不是防恶意;
- 减少误弹(2026-10-12 用户裁决)。以下几条只用于这张分享任务的确认卡,本机任务、同账号远程供应商与
自动审查的判定都不变:
- 普通编辑脚本不因超过模型审阅的 4096 字符预算就算凭证读取。凭证检查在独立的 256 KiB 输入上限内扫描完整命令,前序命令副作用按段累积,不为每段重新扫描全部前序段;超过输入 上限或解析深度上限时仍要求确认,长脚本尾部实际读取密钥时也仍要求确认;
.env.example/.env.sample/.env.template与公钥*.pub按惯例不含密钥,不算凭证类文件 (读取、启动时同步都照普通文件);放在凭证目录里(如~/.ssh/id_rsa.pub)时仍算。命令中读取 文件时,执行前按该命令段的实际目录核对原始路径与链接的真实目标;模板、公钥与配置目录里的说明 路径不能借链接指向凭证。目标不存在、链接断开、目录或展开认不出、前段可能改动链接或环境时, 都保留确认,不用改写后的文件名或上次核实的链接目标放行;- 按扩展名缩小范围的搜索不算读取凭证:rg 的
-g '*.ts'、grep 的--include='*.md'这类只选中源码 与文档文件的写法,字面上能选中.env.ts、id_rsa.ts,但这类名字是代码模块。直接写出像凭证的 文件名、*.json/*.txt/*.sh这类可能存放凭证的格式、扩展名不确定的写法(*.ts*)仍要确认。 搜索启用跟随符号链接(如 rg 的--follow/-L、grep 的-R/--dereference-recursive)时, 源码扩展名不能证明链接目标非敏感,保留确认;短选项组合与可接受的长选项缩写同样处理; 宿主设置了RIPGREP_CONFIG_PATH、命令里对它赋值时,也不能只凭源码扩展名豁免。 配置可能注入跟随链接或其它扩大读取范围的选项;只在 rg 后第一个参数明确为--no-config时 才继续按其它既有规则核实,不把搜索词、选项取值或--后的同名文本当成禁用配置的标志; rg 命令出现预处理器--pre(含分离、附着参数及可能的选项缩写)时,外部程序可以把本机凭证 当成源码内容输出,源码扩展名不能证明结果非敏感,保留确认。无法完整解析的写法同样如此, 不靠--no-config、--no-pre、空值或限制预处理文件的--pre-glob抵销已出现的预处理器; - git 查看内容的命令(
git diff、git show、git log -p、git grep)只看命令文本时按可能读到 提交进仓库的凭证处理,执行前先在受邀者电脑上核实,读不到凭证类文件就不弹卡:仓库所有分支、标签、 stash 与 reflog 的历史和暂存区里从没有凭证类文件;或命令用--限定的路径碰不到这些文件;或 (git diff/git show/git log)按原命令只列出会显示的文件,其中没有凭证类文件。认不出 git 在哪个仓库里跑、仓库带子模块、比较仓库外的文件、核实超过 8 秒,都照旧弹卡;仓库的扫描结果留在 内存里给后面的命令用。 核实预算由整条命令共用:shell 启动状态、目录、所有内容与配置命令段共享同一 8 秒期限, 本次查询子进程只使用剩余时间;文件状态检查不返回、取消或超过总期限时失败关闭,先弹确认。 已开始的历史后台扫描仍按既有缓存流程继续,不影响确认卡及时出现; 指定的对象必须能解析为提交且已在扫描范围内,否则改按实际显示的文件 核对;无法证明为提交的底层对象(如git show <blob-id>,含-s/--name-only等输出选项及隐式HEAD)保留确认,不能按干净历史放行。所有 历史与内容探针禁用 replacement refs;仓库有refs/replace或宿主设置了GIT_REPLACE_REF_BASE时不授予内容豁免,避免探针与实际命令使用不同对象; 仓库或生效配置中有 textconv / external diff 驱动、或继承了GIT_EXTERNAL_DIFF时不能只凭文件名 豁免,除非能确定该调用已禁用相应驱动;历史与文件列表探针始终禁用这些外部 helper。 - 打出 git 配置的命令(
git remote -v/get-url/show -n、读git config、git var -l)按受邀者 电脑上生效的 git 配置核实:要打出的那些项里没有密钥(地址里嵌的令牌或密码、http.extraHeader、 密码与令牌类配置项)就不弹卡,有才确认;显式切换配置文件、blob 或配置作用域(含附着参数、短选项 组合与长选项缩写)不授予豁免,以免核实的是另一套配置;带取值的选项与单键隐式读取也要核实, 不能把选项的取值计入写配置的参数数目而绕过确认。只有确定的单键读取才缩小核实范围,查询模式、 缩写或键名认不准时按全部配置核实,不能把正则查询的模式当成单个键名放行;git remote show没有在动作后明确用-n禁用远端查询时不授予豁免,避免 SSH / proxy 等传输 helper(含配置、继承环境及系统 SSH 设置)把本机凭证打印到 stdout / stderr;只核对地址不能证明安全。 - 上述 Git 核实仅用于命令段直接调用 PATH 中的裸
git,且沿用宿主环境、PATH 各项为绝对目录时。 显式执行文件路径(如./git)、git.exe、任何命令包装器(包括env、command、exec),以及 环境变量的赋值、移除或清空(含 PATH、加载器与 Git 配置来源)都无法与探针证明一致,照旧弹卡; 宿主继承了BASH_ENV/ENV/ZDOTDIR或导出的 Bash 函数时,同样无法证明 shell 启动后仍调用 探针使用的 Git,不授予内容与配置读取豁免; shell 可执行文件本身也要核实:Bash 仅接受固定系统路径的二进制,以及 Windows 标准 Program Files 安装目录里的 Git Bash(核实实际路径没有重定向)。自定义 Bash、Windows 显式CLAUDE_CODE_GIT_BASH_PATH、 未知安装目录或其他 shell 无法与探针证明一致,保留内容、配置和静态只读调用的凭证确认; 实际执行器选择 zsh 时,即使没有ZDOTDIR,也要核实系统级zshenv与HOME/.zshenv(含各自.zwc缓存)均不存在;发现文件、核实文件状态失败或超时、HOME 不明确、或自定义 zsh 的启动目录 无法核实,都保留确认。此核实每次执行前重做,不读取或运行启动脚本,不沿用仓库历史的缓存; Git 内容读取前还要按当次生效的配置核实filter.<driver>.clean/.process。标准 Git LFS 配置filter.lfs.clean=git-lfs clean -- %f与filter.lfs.process=git-lfs filter-process按正常工具使用,不因安装 LFS 就要求普通 Git 查看命令确认;其它非空过滤命令仍保留确认, 探针不运行这些自定义过滤器。即使指定--no-textconv/--no-ext-diff也要核实过滤配置, 不沿用旧配置结论。此处沿用防误发的边界:信任正常安装的 Git / Git LFS,不校验二进制是否被 故意替换;凭证文件、直接写在命令里的密钥与保存的登录凭证仍按原规则确认; 配置中出现core.fsmonitor时同样保留确认(不假设不同 Git 版本对布尔取值的解释一致), 在读取 index 前拦下它,避免 hook 经 stderr 带出凭证。git status、git ls-files、只列文件名的 diff 等静态只读调用也要核实运行期 helper;无 helper 时仍可豁免,不改变本机任务默认判定; 静态只读调用同样不能略过子模块检查:公共 Git 目录存在modules、index 包含 gitlink, 或核实目录状态失败时保留确认;即使旧式子模块把自己的.git留在工作目录里也不豁免, 避免git status进入子模块后执行其独立配置的 helper 或 hook; 配置中出现core.hooksPath时同样保留确认;未配置时,每次核实仓库公共 Git 目录里的默认post-index-changehook(含 Windows 可执行文件后缀)不存在。发现 hook 或无法核实文件状态 都不授予内容与静态只读豁免,避免git status刷新 index 时执行 hook、经 stderr 带出凭证; 签名验证也可能启动外部程序:配置了gpg.program/gpg.<format>.program、启用了log.showSignature、命令请求--show-signature或%G验证格式、配置中的 pretty 格式或别名 含%G时均保留确认,不假设验证器不会读取或输出凭证;历史与文件列表探针始终禁用签名展示; 重合并历史(--remerge-diff、--diff-merges=remerge或配置选择的 remerge 模式)可能运行 自定义merge.<driver>.driver,非空时先保留确认。内部历史/文件列表探针固定逐父提交比较, 不继承重合并配置、不运行 merge driver;普通 Git 查看不因仅存在 merge driver 就额外确认;git diff/log/show --check的空白错误诊断会输出出错的源码行,因此同样按内容读取核实涉及的 文件;与统计等输出选项组合时也不直接豁免,限定到普通源码的检查仍可免确认; log/show/whatchanged/blame 中的姓名映射也核对来源:.mailmap的真实目标、mailmap.file或mailmap.blob指向凭据路径时保留确认,无法确定路径的 blob 同样确认;普通映射仍可豁免, 不因无关的姓名映射配置让 diff/status 增加确认;git var -l与单个逻辑变量查询按实际输出检查,包含环境中的 editor/pager 及派生值,不能 仅凭 Git 配置没有密钥就豁免;检查结果留在本机内存,不记录原始输出;--bare这类改变仓库上下文的选项、前面的命令段可能修改 Git 状态、运行环境,或写法认不出时也不能豁免。 已知会读取 Git 内容的调用遇到未识别的全局选项、或不能归为静态只读命令时(如--ext-diff/--textconv)也保留凭证确认,不能因为未进入核实路径就当成不读取凭证;本机默认判定仍不变。
- 再收紧(2026-10-12 用户裁决),同样只用于分享任务:命令里直接写着密钥(
https://用户:密码@、 地址里的令牌、Authorization头的取值、常见服务的令牌格式与私钥)、用<提交>:<路径>写出凭证类文件 (git show HEAD:.aws/credentials)、git credential fill这类打出保存的登录凭证的命令都要确认。 同账号远程供应商不受影响:与本机一致,项目与个人配置里的符号链接一律跟随,不额外确认。 实现:apps/desktop/src/main/remote-agent/{credentials.ts,executor/gate.ts,executor/executor.ts,executor/gitCredentials.ts,executor/credentialGrants.ts,controller/projectFiles.ts}; 按分享关掉确认的偏好在apps/desktop/src/main/device-link/providerShareGuestPrefs.ts,开关在apps/desktop/src/renderer/features/provider-share/ProviderShareReceivedRail.tsx; 命令判定复用packages/maker-core/src/agents/shared/auto-review.ts的shellCommandReadsCredentials, 上面的命令放宽与 git 核实通过它只有分享任务才传的选项(CredentialCommandOptions)实现,不传时判定不变。
- 凭证类文件(密钥、
- 不能借组转分享(2026-10-15):受邀者的供应商组替它分享的人转来的任务,分享者电脑只在主人同意过那个人时运行 (§4.3);没同意、已撤回或认不出是谁的一律拒绝,受邀者自己的任务不受影响。组所在电脑分配时同样先排除,分享者电脑 是最终裁决方。分享者电脑只能按组所在电脑自报的中转标记认出被转来的任务:这是防误分享,不防被改过的客户端 (与「默认信任分享对象」一致)。
10. 与现有规则的关系
docs/dev-rules/protocol-compatibility.md「远程 Agent」写明远程 Agent 通道「只进同账号 allowlist,不进共享任务清单」。本功能为它新增「供应商分享」授权范围;共享任务访客仍被拒绝。 实现时须同步修订该节。docs/product-rules/shared-task-mode.md不变;本功能复用其服务端成员、链接唤起与撤权的模式, 但使用独立的授权类型和数据,不塞进共享任务。- 「允许被远程调用」的说明文字需改为同时覆盖自己的其他电脑与分享的人。
11. 验收
- 未开启「允许远程控制」或「允许被远程调用」时,管理入口可见但不可点击,并提示先开启哪一级。
- 链接只能用一次、5 分钟内有效:第二个人打开已被申请的链接时被拒绝;拒绝、撤回、过期后链接不能 再用;手机打开链接只提示到电脑上打开。
- 受邀者未点「发送申请」时不产生任何申请;分享者未点「同意分享」时受邀者不能使用。
- 双方弹窗与管理页只显示对方的昵称和头像,取自对方本人账号、经服务端核实;任何位置都不出现 邮箱、手机号(含脱敏形式)、组织或区域,服务端也不保存这些信息。
- 受邀者「等待同意」界面与分享者审批弹窗、管理页待处理一栏显示同一个配对码;系统通知与日志里没有。 受邀者模型列表结构不变,分享来的供应商标题带「来自 {分享者} 的分享」。
- 关闭或删除后,受邀者正在运行的任务立即停止,下一条消息被拒并提示原因与换模型入口。
- 管理页按人、按模型显示用量,订阅类标注估算。
- 受邀者无法通过分享调用分享者电脑上的任何非远程 Agent 能力,随项目带来的 hooks、扩展不会在 分享者电脑上执行;Agent 自带工具里作用于分享者电脑、其他会话或分享者账号的都不可用(§9 第 5 条)。
- 中国大陆版与 Global 账号之间能完成同样的申请、审批、使用与撤销;合规开关关闭时跨区链接给出 明确提示,同区域分享不受影响。
- 受邀者任务启动时不带凭证类文件;任务中读写凭证类文件或执行读取凭证的命令,即使在完全访问下也
要受邀者在本机确认后才执行(§9 第 7 条)。
rg -g '*.ts'这类只按源码扩展名缩小范围的搜索、读 实际目标已核实为非凭证的.env.example与*.pub、在没有凭证类文件的仓库里(或只涉及普通文件时)跑git diff/git log -p、 配置里没有密钥时跑git remote -v都不弹确认卡;命令里直接写着密钥、git credential fill要确认; 本机任务与同账号远程供应商的确认不受影响。受邀者对这个分享打开了「信任 {分享者}」时,这些确认都不再弹, 启动同步仍不带凭证类文件;关掉后下一步起恢复确认,其他分享不受影响。 - Light 与 Dark 两种模式都已实现。
- 受邀者 B 把分享来的供应商加进组、又把组分享给 C 后:分享者 A 没同意 C 时,C 的任务不会分到 A 的电脑(B 的电脑直接转过去 也被 A 拒绝);A 同意后下一次分配起可用,撤回后 C 正在 A 电脑上的任务立即停止;A 同意 C 不代表同意 B 分享的其他人。A 删除对 B 的分享后,A 的电脑从 B 的组里移出,B 与 C 都用不到;A 只是暂停时保留。A 的 Cindy 较旧时 C 的任务不分给 A 的电脑(§4.3)。
12. 远程模型范围
「远程与分享」为每个供应商提供「允许远程调用的模型」,可选择全部模型(包括以后新增的模型)或明确勾选模型。 此范围只约束远程 Agent,包括同账号其他电脑、分享受邀者与经供应商组转来的调用;本机使用与同账号远控下的本机模型配置保持独立。
分享管理页中,每个人的行尾菜单提供「可用模型」。默认跟随供应商范围,也可指定个人子集;实际权限始终取供应商范围与个人范围的交集。
取消全部模型表示不开放任何模型,不能解释为恢复默认。个人转分享的调用继续受该个人范围约束。
普通模型与 [1m] 作为独立目录条目存在时,授权分别按各自 ID 校验,不能通过后缀归一借用另一档的权限。
模型范围弹窗按统一选择器的逻辑模型标识合并引擎别名(如 gpt-6.1-sol 与
chatgpt/gpt-6.1-sol),一行的勾选同时保存当前目录中允许选择的全部实际 ID,取消则移除该行全部已选 ID。
运行时仍按精确 ID 校验,保留 Pi / Claude Code 的桥接路由;个人选择不超出供应商开放范围。
旧配置只选了部分引擎时显示部分勾选,打开或直接保存不补授权;暂时不在目录里的已选 ID 保留且可取消。
模型范围存于提供方电脑,按账号隔离。旧配置默认跟随全部模型;读取损坏配置时拒绝调用,不能恢复为全部开放。 远程目录只提供可用模型;提供方还必须在创建、切换模型、发送下一轮消息及供应商组转发时校验权限,不能信任控制端传来的目录或模型 id。 已开始的一轮不因修改勾选主动中断,下一轮或切换模型时按最新范围校验;同账号远程任务及受邀者经本机代理发出的后续模型请求(含子代理)也按实际供应商与模型复核最新范围。 同账号子代理可使用已开放的其他供应商,不因父任务的来源而被固定到同一家;受邀者仍只能使用分享的供应商及个人授权范围。 受邀者执行端交给 Agent 与子代理的可选目录也只包含启动时获准的模型,不把供应商完整目录交给它们。 经供应商组转发后,每次实际模型请求仍由组所在电脑按原成员的最新范围复核,并与执行电脑本地权限取交集; 撤权、断连或无法完成复核时拒绝该请求。目录过滤不能替代请求校验;已运行任务中的旧目录也不能延续已撤销的权限。 Pi 的 API Key 直连保留原生 SDK,由既有原生适配器在打开每条流前经本任务隧道复核,不依赖是否经过 HTTP 代理。 同账号远程任务也启用此检查:按原生运行时对应的实际供应商和模型解析目录 ID,再核对最新远程授权; 初始化、模型热刷新及子代理继承的适配器均保留检查,本机自用不启用远程授权门。 受限任务不分给缺少这项复核能力的旧电脑;原本不限模型的旧电脑任务在新增限制时结束,重新分配到支持复核的电脑。
13. 成员模型占比上限
在成员的「可用模型」面板按当前供应商目录设置单模型占比上限与推荐模型;模型授权和占比规则一次保存。 规则默认关闭,仅约束该供应商的受邀成员,不影响机主、本机或同账号远控。
占比为该成员在该供应商今天及之前六个本地自然日的已记录输入+输出 token 中,此模型所占的比例, 不含缓存,也不是订阅周额度百分比。没有记录显示未知并允许建立首笔记录;达到上限暂停后续准入, 其他模型用量增加或旧记录退出窗口后可以恢复。已发出的请求不截断,不自动重试或切换推荐模型。 不同运行通道的检查粒度、数据缺失与并发边界见成员模型占比上限。
14. 后续可选
以下不在首版范围,需要时另行裁决:
- 在手机上审批申请与管理分享;
- 按人设置总用量上限(与已实现的单模型占比上限不同);
- 分享有效期;
- 按人定制额度与用量可见范围(当前按供应商对全部受邀者统一开放,见 §7.5)。