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。

50.9 KB
Raw Blame

共享任务:远程连接的多人版本

产品裁决更新:2026-10-10。实现与验证进度见文末;本文不代表已上线。 产品、代码、协议与存储统一使用“共享任务 / SharedTask”,开发期旧协议不保留兼容别名。

定位

房主分享一个现有任务,其他已登录用户通过邀请进入同一个远程任务页面,共享完整历史、上下文和 Agent。复用现有远程连接、输入队列、附件、语音输入和断线恢复,不做独立会议产品或普通讨论频道。

用户明确要求减少复杂度:访客与房主触发的 Agent 调用使用相同任务权限。加入方式选择最简单方案,采用邀请即授权。

用户流程

  1. 房主在任务内点击“共享任务”,开启共享并复制邀请链接。
  2. 访客点击链接,通过网页唤起已安装的客户端;登录后直接加入并进入任务。两端也可在“加入共享任务”中粘贴链接或旧邀请码,无申请或批准步骤。
  3. 双方进入现有任务页面,查看全部历史、工具结果、上下文和附件,向同一个 Agent 发消息。
  4. 房主可复制新邀请、移除访客、停止共享;访客可退出。

不增加申请记录、审批通知、在线人数、正在输入、编辑标记或独立会议页面。成员列表和消息作者只用于识别参与者。

邀请链接第一步(2026-09-28)

  • 复用现有 device-link 服务提供公开页面,无需单独建立官网。链接为 <deviceLinkApiBaseUrl>/shared-task/join#<invitation>,凭据放 fragment,不进入网页 HTTP 请求;网页不展示任务内容或操作成员关系。
  • 页面尝试通过已有 URL Scheme 唤起桌面或移动端,居中展示品牌图、打开状态与一句提示,下方仅保留再次打开、复制邀请链接和下载三个文字入口。按浏览器语言支持简中、繁中、英、日、韩,并适配浅深色。浏览器限制自动唤起时由用户点击再次打开;应用内浏览器可转到系统浏览器或复制后粘贴。
  • Windows 协议注册时补齐协议专属的 Cindy 应用显示名,避免开发环境中的通用 Electron 名称出现在浏览器唤起提示中;不更改其他 Electron 应用或协议的名称与启动命令。
  • 链接默认唤起 Cindy;发起客户端按自身构建身份在 fragment 追加 ?app=cindycn 或 ?app=cindydev,网页据此选择移动端已有 Scheme,不让用户选择版本。
  • 客户端只向当前配置的服务提交邀请。链接中的 server 仅用于比较,不能覆盖请求目标;不同服务的邀请显示对应提示。仍接受旧的裸邀请码,REST 和 device-link 既有入参保持兼容。
  • 访客加入时直接使用已登录用户的账号昵称,不再要求填写自定义昵称。昵称只作为展示信息,成员身份仍由服务端的账号与成员关系决定。
  • 移动端不自动读取剪贴板识别邀请(2026-10-15 移除):iOS 读取剪贴板内容会弹出系统粘贴授权,启动或回到前台时自动检测会制造与用户操作无关的弹窗。手机只通过点击链接唤起加入,或由用户在“加入共享任务”弹框里自己粘贴(系统粘贴菜单不弹授权);邀请文案同步改为“打不开时在 Cindy 中点「加入共享任务」并粘贴链接”。显式点击邀请链接继续直接加入并进入任务。
  • 待处理邀请仍只在内存中暂存。旧版本按账号落盘的邀请去重摘要(cindy.mobile.shared-task.clipboard-history.v1.*)在应用启动时尽力删除,失败下次启动重试。链接邀请支持首次登录后继续,切换账号、关闭页面或过期后不自动沿用待处理邀请。
  • 两端“设置 → 共享任务”提供独立管理页,分为“我发起的 / 我加入的”,有共享和空状态均保留“加入共享任务”次要按钮。手动加入使用紧凑弹框,接受邀请链接和旧裸邀请码。2026-09-28 用户已确认交互 HTML 并授权实现:Desktop 设置项位于远程控制之后;Mobile 沿用实际设置分组,在语音词典与外观之间增加“共享任务 → 共享管理”。顶部、主菜单和移动端首页共享分组不提供加入入口;桌面端侧栏“共享任务”分组右侧保留“+”加入入口(2026-09-28 用户确认)。
  • 手动加入和显式链接成功后进入任务。共享结束提示返回任务列表,并说明重新加入需要房主的新邀请。管理页的移除、退出、关闭当前、关闭全部使用紧凑确认;取消保留原页面、页签和滚动位置。加载失败提供重试,不当作空列表;关闭或退出成功回到对应管理列表。
  • 本阶段不修改移动端原生配置或 runtime fingerprint;Universal Links / Android App Links 另行实施。先部署服务端页面,再发布客户端;旧客户端尚不能解析新链接,需更新。

权限与顺序

  • 任务由原桌面运行,模型费用沿用房主连接;同账号远控行为不变。
  • 访客可发消息、使用附件和语音输入、停止 Agent;Agent、模型和推理设置仅房主可修改(2026-10-10 用户裁决)。桌面与手机访客保留当前模型展示,但不可打开修改入口;房主端同时校验请求权限,旧版访客也不能绕过。
  • 房主登记的待生效模型选择可由访客的下一条消息触发生效(#7825):仅在应用主机登记的选择期间使用宿主身份,启动参数不取自访客;访客发送资格与任务归属在预检及变更准入时复核。变更已准入后允许完成提交或回滚,不能因撤权留下半次切换;后续消息仍保留访客来源,不能借该次准入修改模型。实现与回归见 sessionAgentSwitchHandler.ts、sharedTaskSetting.ts 及各自测试。
  • Agent 工具、shell、已有插件/MCP 沿用任务现有权限,Full Access 语义不变;任务内 Agent 的 permission、ask_user_question、plan_review 交互由房主和协作者都可决策,其他房主管理确认仍由房主处理。不添加访客专属沙箱、per-turn 权限或工具审批。邀请意味着房主信任访客使用该任务的 Agent 能力。
  • 房主保留共享管理、归档/删除/导出/分支、权限模式、工作目录、插件/MCP 配置和后台/定时任务管理权限。
  • 访客通过客户端接口只能直接访问共享任务及其资源,不能调用全局凭证、其他任务或任意主机文件接口。Agent 原生工具不承诺工作目录硬隔离。
  • 文件浏览器(2026-10-10 用户裁决):访客可在文件浏览器中浏览和编辑本任务工作目录,读写权限与房主一致:列目录、读取、搜索、缩略图、保存、新建、重命名、删除,以及文件变化监听。主机只认本机记录的任务工作目录与执行端点(本地或任务所属 SSH 主机),访客传入的路径只用于比对;读写前复核成员资格。文件导出/文件夹下载这类导出任务仍只限同账号(它们走房主的同账号中转路径),工作目录本身的管理(更换目录)仍归房主。实现见 sharedTaskDispatch.ts(通道与操作)、sharedTaskFileAccess.ts(目录绑定)与 file-browser/device-op.ts。
  • 任务关联的本机文件即使位于工作目录外,访客也可经原有取件通道只读访问(2026-10-19 修复):归属由房主端当前未回退且未被 /clear 隐藏的消息记录确认,包括主机已校验并接收的结构化附件(含访客上传)、房主/Agent 明确交付的文件链接及已完成且未报错的工具产出。文件引用及配对的工具调用、结果均须晚于任务的清空边界;清空前的记录即使仍在数据库中,也不再提供授权。访客自行粘贴的路径、代码示例、其他任务记录或仅前缀相同的路径不构成授权;仅放行关联的具体文件,不开放其父目录浏览或写入。取件继续检查成员资格、敏感路径和解析后的文件身份,不缓存历史授权结论。Desktop 与 Mobile 共用房主校验,无新增 wire 字段;SSH 的工作目录限界保持原规则,不以本机路径例外绕过。实现与回归见 sharedTaskFileReferences.ts、sharedTaskMediaAccess.ts 及 sharedTaskMediaAccess.test.ts、mediaFetch.test.ts。
  • 工具结果中的普通文本链接不构成外部文件交付,包括读取、搜索、网页或 shell 返回的内容。原生工具产出沿用调用中明确声明的输出路径;MCP/动态工具的结果只认既有结构化交付字段 xdt_media_produced、_xdt_model_files,并继续核对调用配对、成功状态及当前历史边界。原生读取和 shell 输出即使形似这些字段,也不按交付解释。房主/Agent 在消息中明确交付的链接仍按上述规则处理。
  • 工具结果外层 ok: true 仅代表调用包装成功,内层 result 的失败状态同样阻止文件授权,调用产出路径与结果交付字段使用相同判定。房主/Agent 消息中可解析为文件链接的正文路径和完整行内代码路径沿用界面已有的链接/文件卡片语义;代码块中的示例、普通代码表达式、链接标签中的路径不提供额外授权。正文路径分词由 Renderer 与房主共用 shared/bareFilePathTokens.ts,仍须完整匹配请求文件。
  • shell 命令中的输出路径及 MCP 输入中的输出路径(如 outPath)只是候选,不能仅凭调用成功就授权工作目录外的旧文件。取件时还须确认目标为普通文件,修改时间落在该调用到配对结果的执行时段内;无法读取元数据、缺少有效时间、未修改的旧目标或执行时段外的修改均不能使用该调用的输入路径作为授权依据。显式消息链接及结构化交付仍按各自规则处理。
  • 工具失败判定依据持久化失败标记及结构化失败字段/非零退出码,逐层检查已知的结果包装;旧纯文本结果保留首行错误诊断判断。正常交付文件名、stdout 或 stderr 中出现错误词/警告不单独构成失败,不把界面展示用的全文关键词启发式用于文件授权。
  • 消息按主机现有输入队列顺序处理,保留 clientId 幂等。访客仅编辑/撤回自己未处理消息,房主可处理全部未处理消息;直接更新内容,不显示“已编辑”。
  • 发言者身份来自经过验证的账号和成员关系,不能信任消息正文或客户端自报的身份。

邀请、成员和生命周期

  • 每个账号同时最多开启 5 个共享任务、最多加入 5 个共享任务;两个角色独立计数,可以同时开启 5 个并加入另外 5 个。各自跨设备统计,加入名额跨房主统计。开启与加入的名额均由服务端判定,客户端不维护固定数量。
  • 邀请可转发,持有邀请的登录用户即可加入;每个任务最多 2 位访客(加房主共 3 人),按账号计数。服务端在事务内强制校验,超额分别提示开启、加入或访客人数已满。
  • 已存在的超额共享及成员关系不自动关闭或踢出;只拒绝新增开启/加入,退出、移除、关闭或房主离线关闭后释放对应名额。访客临时断线不释放加入名额。
  • 同一账号重复加入幂等,多个设备不重复占用名额。邀请令牌只存摘要,不进入日志。
  • 房主使用自己的邀请不走访客加入流程,不创建访客或占用加入名额;服务端返回 HTTP 409 / SHARED_TASK_SELF_JOIN,两端提示“这是你发起的共享任务,无需加入。请从‘我发起的’打开”。同账号访问继续使用既有设备互联。旧服务端的通用 CONFLICT 仍显示兜底提示,不根据错误消息猜测是否为房主;旧客户端收到新错误码也沿用兜底提示。准确提示需服务端与客户端均升级,接口与成功响应结构不变。
  • 移除或退出立即撤权;原邀请不可重入,房主生成新邀请后才能再次加入。
  • 停止共享、归档、房主登出使旧邀请和成员关系失效。重新共享产生新的共享 ID。
  • Cindy Make 停用时,房主 Desktop 按本机原始任务来源关闭已有的制作任务共享(含 cindy-make-merge),不恢复访客访问、不允许重新开启。复用原有关闭账本与服务端关闭接口,离线先撤销本机授权,联网后重试关闭并从房主、访客目录移除,旧邀请随共享关闭失效;普通任务共享不受影响,任务历史与工作目录保留。新版控制端的账号共享目录也先按原始元数据确认任务来源;房主离线、旧版或读取失败而无法确认时,不展示标题、管理入口或合成首页行,确认普通来源后恢复显示。来源确认复用现有授权和元数据读取,不为目录发现申请整机远控或扩大访客权限。实现与回归见 sharedTaskHost.ts、sharedTaskHost.test.ts 和 sharedTaskRuntime.test.ts。
  • 访客通过旧邀请加入后,先通过已授权的单任务通道确认原始来源,再展示加入成功或进入任务;确认是已停用的制作任务时立即退出该共享,撤销成员资格并释放加入名额,关闭单任务连接并清理其镜像,不仅从界面隐藏。管理目录与冷启动恢复同样清理已确认的历史制作任务成员关系;退出失败时不展示任务、在后续刷新或加入重试中继续退出。单条隐藏任务的退出失败独立记录,不阻断同轮普通共享任务的目录发布;退出成功前保留重试所需的原始目录和元数据,不提前标记成员关系已清理。来源未知或账号已切换时不猜测来源、不撤销普通任务权限,普通任务共享与同账号远控不受影响。实现与回归见共享门禁、共享投影测试、Desktop 管理测试和Mobile 管理测试。
  • 归档后恢复为活动任务,可以显式重新开启共享;须先完成旧共享关闭,旧代次的请求仍然失效。
  • 房主设备的 relay 连接确认离线后有 60 秒重连宽限,期间重连保留共享、邀请与成员关系;持续离线超过宽限后由下一轮服务端扫描关闭(正常情况下确认离线后 60–90 秒)。关闭后重新上线不会恢复旧共享,需显式重新开启并发送新邀请。主动关闭与登出的显式关闭请求不等待宽限。已由新连接接管的旧连接退出不算离线;TTL 内短暂网络抖动不承诺立即判定。
  • 服务端是成员关系权威;主机保存恢复与关闭记录。迟到响应、旧快照、缓存和重连不能恢复已撤销访问。
  • 访客断线保留成员关系,重连后可继续访问仍有效的共享;不能影响其他访客或同账号远控。
  • 正常断开触发关闭;relay 崩溃、路由过期或关闭落库失败由服务端每 30 秒扫描补偿。服务端授权在关闭提交后立即失效。
  • 共享目录轮询(2026-10-22 起,降低空闲请求):Desktop 与 Mobile 的共享目录在窗口隐藏或 App 退到后台时暂停;目录为空时约 60 秒、有共享时约 30 秒读取一次;本机加入或退出共享、回到前台(距上次读取满 10 秒)、重新连上服务器时立即读取,Mobile 在本机开启或关闭共享后、Desktop 在访问被结束时也立即读取。这些事件发生在读取途中或后台时,补读留到当前读取结束且回到前台后进行,后台不发起读取。Desktop 只看窗口是否可见,不因窗口获得焦点而读取。另一台设备上加入的共享最长约 60 秒后出现;任务内容仍由房主实时推送,不受此间隔影响。Desktop 主进程内同时或 5 秒内的目录读取合并为一次;本机发出的共享写请求(开启、加入、退出、移除、关闭)会使之前的结果失效,其他设备的写入不在此列;由事件触发的读取(加入、退出、重连、访问被结束)和发起方的重连同步不复用此前的结果;缓存按账号、区域与服务端地址隔离,系统时间回拨时视为过期。
  • 不承诺撤回访客已经看到或下载的内容。

实现约束

  • 复用 packages/device-link;新增跨账号的单任务授权,禁止降级为旧版全设备远控。
  • 长标题不阻止开启共享(2026-09-22 用户确认):只在创建共享的请求边界,将去除首尾空白后的标题截短到服务端现有的 128 个 UTF-16 码元上限,避免截断代理对;共享列表/管理页可显示该短标题,原任务标题和历史不变。昵称与服务端响应仍沿用严格校验,不放宽服务端协议。
  • 同时校验 invoke、push、历史、附件、嵌套引用、离线补发与结果缓存的任务及成员归属。
  • 共享附件使用 cindy/device-link/shared-task/<sharedTaskId>/<uploaderAccountId>/<uuid.ext>,复用既有中转前缀的 OSS 授权与生命周期;共享路径仍按任务和当前成员校验,不回退为同账号对象权限。客户端与服务端同步升级,不保留未发布开发版顶层 cindy/shared-task/ 路径别名;普通远控附件路径不变。
  • Desktop 与 Mobile 复用现有任务页面;房主在手机上通过既有同账号远控管理共享。网页端和匿名访客不在范围内。
  • Agent/模型/推理设置的房主专属限制由房主 Desktop 执行,生效需要房主升级;新版访客界面也禁用修改入口。旧访客连接新版房主时,设置请求沿用现有权限错误返回;不修改 wire 格式、同账号 allowlist 或服务端成员关系。
  • 新协议以能力协商开放;缺少能力提示升级。两区域独立,不默认跨区域加入。
  • 关闭记录必须落入原 profile 的 journal 后才能释放数据库;本地同步撤权,服务端失败下次恢复重试。
  • 同一 profile 的非 relay 持有实例归档/删除任务,也必须写入该 profile 的共享关闭记录,并以操作开始时捕获的账号凭证尝试关闭服务端共享。Host 在既有 5 秒刷新周期先消化本地关闭记录、使现有授权捕获失效(只读本地数据库,不联网);relay 离线或服务端读取失败不能跳过本地撤权。服务端只在启动或每次 relay 重新连接(按连接代次判断)后读取一次,之后仅当本机有活跃或创建中的共享、有服务端尚未确认的关闭、或有创建请求失败(响应可能丢失)尚未被之后的列表核对时,每 30 秒读取一次;只有列表请求发出前已知的共享 ID 才会据该列表被视为已确认;访客连接、打开管理窗口与移除成员仍立即刷新对应共享。此机制只关闭对应共享,不重启 relay 或影响其他任务。
  • 覆盖式任务文件导入属于旧任务的终态变更:被替换的旧任务图及其共享关闭记录在同一数据库事务提交,失败一起回滚;成功后再通知本机共享运行时撤权。即使成功回执丢失或进程切换,持有 relay 的实例仍可从持久记录完成关闭,新导入任务不继承旧共享。
  • 登出时等待已发出的创建请求收尾,迟到的创建 ID 也必须先落关闭记录;在线关闭仅使用退出账号的固定凭证与端点,不刷新或影响新账号。
  • 移除请求未获确认前暂停该成员访问;网络失败须以服务端状态恢复。临时暂停或同账号新增设备造成的旧授权失效返回可重试错误,只有确认撤权才从访客端移除任务。
  • 本仓只改客户端;服务端实现位于独立 cindy-server 的本任务 worktree。两仓协议需一致。

开发期命名与发布顺序

2026-09-18 用户确认:功能仍在开发,不维护旧共享协议和存储命名兼容层。客户端和服务端各自维护本仓协议包并同步更新;独立 cindy-protocol 仓不再被当前 workspace 消费。

  • 类型与函数统一为 SharedTask / sharedTask,能力为 shared-task-v2,REST 为 /api/device-link/shared-tasks,标识字段为 sharedTaskId,IPC 为 maker:shared-task / shared-task:account。共享是原任务的状态与授权关系,原 sessionId 不变。

  • relay 的 src/dst 始终为真实设备 ID;可选 sharedTask 字段独立携带共享 ID 与目标角色/成员,来源角色/成员由服务端按已验证账号与设备重写。不带范围的帧沿用同账号远控,包括 ID 恰好带 shared-task~ 前缀的真实设备;非法范围直接拒绝,不能降级。

  • 客户端仅在 relay 声明 v2 后发送共享帧,服务端还检查双方能力、任务状态、成员与真实目标设备绑定。先升级全部 relay 再发布客户端;不兼容未发布的共享 v1 开发版,已发布普通远控协议不变。

  • 客户端缓存/IPC 使用包含共享范围的本地连接索引,长度大于物理设备 ID 的 128 字符上限,避免同设备普通连接与多个共享连接碰撞;索引不会进入 wire 的设备地址字段。请求、结果、ACK、重连与错误都按各自连接范围隔离,不扩大到其他任务或设备。实现与回归见 packages/device-link/src/sharedTaskEnvelope.ts、sharedTaskPeer.ts 及其测试。

  • SQLite 使用 shared_task_events / shared_task_id;Prisma 使用 SharedTask、SharedTaskGuest、SharedTaskInvitation。初版直接使用最终命名建表,不保留旧开发版搬迁脚本、旧接口、双写或别名。

  • 不支持新旧共享开发版本混用,也不自动转换旧开发数据库。旧开发沙箱保留原库,使用新的隔离数据库和沙箱验证新版,不修改现有验收数据。

  • 旧开发分支 migration 0108、0110 未进入 main,已与新主干编号冲突。基于 2026-09-20 的主干 0113 重新生成 0114_shared_task_events。旧分支沙箱保留原库备份,使用新的独立沙箱验收,禁止改写 schema_version 或强行打开不匹配库。0114 只新增最终命名的共享记录表,不读取或改写旧开发版记录、消息作者与队列作者。

  • 尚未部署共享功能的环境先执行服务端增量 migration,再升级全部 relay,最后发布客户端。运行旧开发版的隔离环境按上面的新库方案验收,不原地套用新迁移链。服务端不改写既有同账号设备关系;不能把缺少共享能力的 relay 当作已支持。

  • 新客户端连接旧 relay 时,普通同账号远控继续使用原协议;共享入口提示升级,Mobile 不轮询旧 relay 的共享 API。新 relay 连接旧房主时,房主缺少共享 channel 的错误也提示升级,不能降级为全设备访问。

  • 错误处理只把明确的能力缺失或版本不兼容映射为升级提示,断网或超时错误仍提示重试。Mobile 连接未建立时将能力视为未知,显示重试;重新连接后重新读取能力,升级后可恢复共享。

  • Desktop 的本地 SQLite migration 0114 为增量建表,但“可从旧版升级”不等于“可用旧版打开新库”。既有 migration manifest / schema 校验会拒绝旧程序打开已升级数据库;本功能不放宽该保护。

  • 发布前保留升级前数据库备份。需要回退时优先修复新版;如必须恢复旧程序,应使用升级前的对应备份,并明确接受备份之后的数据不会随之保留。不得通过降低 schema 版本、删表或改历史 migration 强行回退。服务端回退时保留增量表,不执行破坏性 down migration。

  • 新旧版本真实混合部署尚未端到端实测;能力协商与错误提示的自动化回归不能替代该发布验收。

UI review 与全部关闭(2026-09-18)

单文件交互原型仅保存在本地 artifacts/shared-task-design/index.html,不随仓库提交;仓库内的实现依据为本文记录的已确认方案。原型展示三种入口:A 任务顶部小面板与账号菜单;B 一个共享窗口,分当前任务与我发起的共享;C 侧栏入口与右侧管理面板。原型是设计展示,不是实际客户端或验收截图。Light/Dark、小屏及开启、加入、邀请、移除、全部关闭、离线结束一起评审。

已选定方案 B:“共享任务 → 我发起的 → 关闭全部共享”。范围为当前账号、当前区域内由我发起的共享(含其他主机),不退出加入别人的任务、不停止 Agent、不删除任务、不影响同账号远控。确认面板列出任务与主机,默认取消;失败保留未关闭项供重试。

实现状态(2026-09-20):已按方案 B 在 Desktop 落地统一共享任务窗口(SharedTaskButton.tsx),含「当前任务 / 我发起的」页签、确认面板(移除 / 退出 / 关闭当前 / 关闭全部,默认取消)与房主离线结束态;账号级 owned / close IPC(shared-task:account)支持跨主机关闭,失败保留未关闭项供重试。Mobile 仍沿用任务菜单内的共享入口。

验收

桌面共享任务入口修订(2026-09-20,用户确认)

  • 任务顶部不单独显示共享图标;共享入口收进标题旁的「…」菜单,并按下文三种状态切换。移除菜单前的弹性空白,恢复「标题 → 标签 → … → Git/PR 信息」顺序。访客菜单仅显示「退出共享」,不显示其他操作或空分组(2026-09-23,用户确认;访客菜单按 2026-09-24 最新澄清更新)。
  • 标题旁、左侧文字版与列表版共用菜单内容与顺序:置顶/重命名/移动/标签;复制链接/共享任务/导出;新窗口;归档(已归档时为取消归档)/删除。仍按任务状态隐藏不适用项;移除任务分支菜单入口。访客右键按下文 2026-09-24 裁决,仅保留退出共享。
  • 采用单一「共享任务」列表内分组:房主与访客任务按最近活动时间混排,不使用 Tab 或角色子分组。仅房主任务在 Agent 图标与标题之间显示金色皇冠(Desktop --warning-fg / Mobile warningFg,Light / Dark 均为 #F3A115);访客任务不渲染身份槽,标题起点与普通任务一致。皇冠不占用右侧时间、状态、PR、工作区或悬停操作槽。Desktop 共享分组只跟随主列表的文字版/列表版,不适配仅向置顶区开放的三态展示;Mobile 使用同一身份语义。分组不显示计数,且不受下方设备筛选影响(2026-09-22,用户确认;同日由中性色调整为金色)。
  • 共享不是常用功能:未开启且未加入共享任务时,整个分组隐藏,不保留空状态、加入按钮或分隔线;首次开启或加入后出现,最后一个共享关闭或退出后自动隐藏。首次加入继续使用原有菜单入口。
  • 设备菜单仅保留真实设备,不显示共享任务或内部 peer 标识。访客任务不再重复混入下方普通项目/任务列表。房主任务仍保留原项目归属,共享分组作为快捷入口。
  • 共享任务行沿用普通任务的 Agent 身份图标,按任务的 Agent 类型显示;不得因共享状态替换为人群图标。
  • 已加入任务直接打开既有任务页面,重复点击当前任务不重新连接、不清空页面。访客撤权继续使用现有结束提示与清理路径,不缓存已失效的可访问内容。
  • 「共享任务」分组标题和空白区域不提供右键菜单,也不触发侧栏空白处的整理菜单。房主任务右键菜单只替换原共享项:未共享为「共享任务」,进入共享管理;已共享为「共享管理」子菜单,内含「复制邀请码」「管理成员…」「取消共享」,成员管理打开既有管理面板,取消共享直接二次确认;其他选项、顺序与分组保留。访客菜单只显示「退出共享」,点击后二次确认;移除复制任务链接、所有不可用操作、标签和多余分隔线。房主保留归档快捷操作,归档或删除前先停止共享。左键折叠/展开与进入任务保持不变(2026-09-24,用户选择房主共享子菜单;最新澄清访客只保留退出共享,替代此前显示禁用项的方案)。
  • 当前任务管理页底部的“取消共享”与“我发起的”页底部的“取消全部共享”使用同一底部居中、全宽危险操作布局,避免同类操作出现左对齐差异。
  • 共享只是新增分组:任务行复用普通主列表的文字/列表显示模式、标题、最近消息预览、Agent 图标及状态信息,不使用“这台电脑/其他电脑/共享任务”替代预览。访客任务保留导航与退出共享入口,不开放重命名、归档、删除、拖拽等房主管理动作;房主任务沿用普通任务右键行为,但归档/删除必须先停止共享。尚未取得跨设备任务镜像时只显示已知标题和房主皇冠,仍可点击进入,不伪造预览、时间或 Agent 身份(2026-09-22,用户确认;访客交互按 2026-09-24 裁决更新)。
  • 加入弹窗此前的 C 方案和双页签方案由下方 2026-09-24 HTML 原型确认方案取代。
  • 本轮设计稿面向 Desktop;Mobile 仍遵循上文全屏主页面和平台确认控件规则。

Desktop 统一共享窗口(2026-09-24,用户确认 HTML 原型后落地)

  • 顶部「加入共享任务」打开统一窗口,标题固定为「共享任务」,包含「加入共享/我加入的/我发起的」三个页签。加入页只显示邀请码、昵称与加入说明,不再插入房主管理摘要或取消全部按钮;切页签保留输入。邀请码使用紧凑单行输入,邀请码与昵称分别校验、分别提示,焦点落到第一个错误字段。
  • 「我加入的」通过任务标题直接打开任务;逐项退出为次要操作,先确认,再清理该共享的连接与列表项。当前接口未提供房主昵称,不能用账号 ID 或虚构姓名替代;仅显示已知的角色和断连状态。已有任务镜像仍复用原连接。
  • 「我发起的」每个条目都提供管理入口,包括其他本机任务和其他电脑任务。管理目标以该条目的任务 ID、共享 ID、房主设备为准;同账号远端复用现有 device-link 连接和 host channel,不新增权限或协议。已过期条目不能静默切到重新开启的另一个共享。设备名称可确认时显示名称,否则显示这台电脑/其他电脑。
  • 任务菜单中的「共享任务/共享管理 → 管理成员」直接进入该任务详情;返回到「我发起的」。详情包含复制邀请码、成员、移除访客与取消共享。顶部加入入口与任务详情复用同一 SharedTaskDialog,不再维护两套管理布局。
  • 移除、退出、取消当前与取消全部均在原窗口内替换内容,默认聚焦保留操作;取消恢复原页面、表单和滚动位置,不叠加另一个管理弹窗。任务菜单直接退出/取消仍使用独立确认,因为该入口没有已打开的管理窗口。
  • 文案统一「取消共享/取消全部共享/退出共享」以及「邀请码」。取消确认列出操作目标,解释访客失去访问和邀请码失效,同时明确任务记录、Agent 工作保留。移除或退出不影响其他成员。
  • 取消全部的范围固定为确认时的当前账号、当前区域内已发起任务(包含其他电脑);迟到的列表刷新不能扩大范围。部分失败只保留失败项重试,账号切换或窗口卸载后不继续执行下一项。加载失败展示重试,未知列表不能显示为空;详情及列表响应均隔离账号和当前页面代次。
  • 菜单预查询共享状态时仍可立即进入管理窗口,由窗口呈现加载、错误与重试。取消其他电脑上的共享(菜单、单项及批量)必须经原房主设备已有的 host close 通路,先同步撤销本地访客授权、记录关闭,再等待服务端确认;连接或关闭失败保留目标供重试,不降级为仅关闭服务端记录。连接期间切换账号或卸载窗口不得继续发出关闭命令。
  • Light/Dark 共用语义 token 与标准 Button 的 primary/quiet/danger-solid 状态;页签可用左右方向键切换。HTML 原型保存在本地 artifacts/shared-task-design-v2/index.html,仅作设计演示,不算客户端黑盒验收。

手机版交互修订(2026-09-20,用户确认)

  • 用户实机验收后否定“任务背景+共享半屏+确认半屏”的叠层,并进一步澄清:共享主页面全屏,少量信息的确认使用弹窗。这项澄清替代早期手机底部面板和之后“所有确认也全屏”的实现;Desktop 仍采用统一共享窗口。
  • 手机保留“当前任务/我发起的”结构。加入、成员、成功、结束与空状态使用完整页面;移除、退出、关闭当前和关闭全部使用紧凑确认,不另开全屏页,不再叠加两个半屏。iOS 复用 showConfirm 系统 Alert;Android 默认绿色按钮 Alert 已被用户否定,改为语义 token 的 12px 圆角卡片、灰阶取消与红色实心胶囊确认按钮,长正文可滚动、操作按空间换行,不通过原生配置改色。
  • 已进入任务的手机访客,在“任务详情”直接看到“退出共享任务”,不再进入共享成功/管理页,也不再重复显示“进入任务”。点击后确认,取消保持当前任务、详情面板及消息位置;确认成功才退出并清理该共享连接,失败保留任务可重试。房主仍显示“共享任务”管理入口,首次加入后的成功页仍保留“进入任务”。
  • 取消保留原页签、表单与滚动位置,Android 系统返回只取消、遮罩不关闭;只有确认才执行。弹窗拦截背景交互,防止重复弹出;账号、页面或授权上下文已变更的旧确认不能继续执行。全部关闭保留确认时的任务清单与影响范围。
  • iOS 沿用 SimpleStackHeader 原生导航和系统 UIAlertController。液态玻璃、旧版回退、按钮排列、动态字体、长内容滚动与无障碍遵循系统;不新增原生依赖或改动 runtime fingerprint。HTML 补充平台说明和 iOS / Android 示意切换,原型模糊不等于原生玻璃实测。
  • 本地自包含 HTML 已同步全屏主页面+紧凑确认弹窗;原型与真实客户端截图分别记录,不混用作验收证据。

Android CN 本轮补充验证(2026-09-20)

  • 访客任务详情改为直接退出后,最新 Android 主题确认框已在 CN 模拟器检查浅色/深色外观,按钮取消及系统返回保留原详情与消息位置。定向回归 21 项、Mobile 类型检查通过;iOS 原生确认与动态大字体尚未实机验证。当前主题确认框的确认退出分支由单测覆盖,真实确认退出记录来自同一业务逻辑的较早原生确认版本。
  • 较早的原生确认版本曾完成 Android CN 浅色/深色的退出弹窗、系统返回取消、按钮取消及确认退出验证。该 Android Alert 外观随后被用户否定,不能作为当前主题确认框的视觉通过证据。iOS 液态玻璃、VoiceOver、动态大字体和长任务清单滚动尚未实机验证,不能将 HTML 示意当成通过证据。
  • 访客“进入任务”失败定位到设备级资源 manifest:共享访客不具备该权限。手机不再请求整机 manifest,保留当前共享任务已有范围;CN 模拟器连续三次进入正常,读取完整历史,并发送消息收到同一 Agent 的 PLAN_B_CN_OK。
  • 临时断网不当作撤权;确认关闭或移除后隐藏发送与失效操作,显示可重新加入的结束态。加入、成功、退出确认、取消与重新加入已完成真实回归。
  • 全屏修订后已验证房主开启、成员页、我发起的、关闭全部确认、返回取消、关闭后空状态,以及移除访客的取消/确认。Light 与 Dark 均有真实 Android 截图;未宣称每一子界面均完成双主题覆盖。
  • 全屏访客补测:正常邀请加入后两次进入同一任务均成功;退出确认顶部返回恢复成功页,确认退出后可用新邀请重新加入并第三次进入。房主关闭共享后显示全屏结束页,隐藏输入和失效操作;“使用新邀请加入”返回空白加入表单。上述步骤均通过真实客户端操作,关键步骤已发送 Android PNG 截图。
  • Mobile 定向回归 54 项、scope、smoke 与 Desktop/Mobile 类型检查通过;根相关单测门禁仍未通过,剩余失败涉及 Windows 内置 Skill 文件复制 EPERM、环境模块测试加载器及输入推荐测试,不将定向结果记作完整门禁通过。
  • 此记录不覆盖 iOS、多主机批量关闭、多个访客并发及标准软键盘避让;先前 Gboard 手写浮条不能替代标准键盘测试。

Desktop 方案 B 子界面与本轮验证(2026-09-20)

  • 统一窗口宽 440px;房主保留「当前任务 / 我发起的」页签。开启页使用任务卡片、权限说明、离线提示与全宽主按钮;成员页使用邀请卡片、头像、身份及移除入口。
  • 加入页使用多行邀请输入框、最长 32 字昵称、说明与加入按钮。加入成功先显示任务标题和「进入任务」,不跳过成功页;生产界面不包含原型的填入演示按钮。
  • 移除、退出、关闭当前及全部关闭使用独立确认层,原界面保留在后方。按用户选定设计,左侧取消、右侧确认,默认聚焦取消;该排列仅在共享任务显式启用,不改变其他确认框。
  • 结束提示由窗口级组件承接,避免离开失效任务时一起卸载;「使用新邀请加入」打开加入表单。沿用现有撤权和导航判定,不新增访问权限。没有明确离线原因时使用“当前已无法访问”的通用文案,不能把手动关闭或移除误称为房主离线。
  • 两个真实 Electron 隔离客户端、不同账号:已验证开启、复制邀请、加入成功、进入任务读取历史、移除取消与确认、退出确认、重新邀请、关闭当前、关闭全部、空状态及结束后重新打开加入表单。截图来自原生窗口;截图前激活目标窗口,防止后台窗口缓存旧画面。
  • 已通过设置界面切换 Light/Dark。浅色目检加入、成员、成功、结束和确认页;深色目检空状态和移除确认。未将这些结果记为所有子界面的双主题全覆盖。
  • 实际重启房主隔离沙盒:访客出现结束提示;房主重新启动返回 ready 后,「我发起的」为 0,共享没有自动恢复。两个沙盒保持运行,房主主题已恢复浅色。
  • 定向回归 22 项通过,Desktop 类型检查通过,i18n 与术语表检查通过(存量告警保留)。本轮未验证 Mobile、多个访客并发、跨主机批量关闭和新的 Agent 工具调用;不据此宣称完整功能黑盒验收已完成。
  • 后续排查顶部错误 Toast:后台自动化点击复制邀请时,邀请请求成功,但浏览器剪贴板因文档失焦返回 NotAllowedError。已把复制失败与共享请求失败分别提示;实际鼠标事件点击复制成功。新增两项回归后,共享窗口定向测试 9 项通过,类型和文案检查通过。该失败不应被之前的成功路径总结掩盖。

功能验收清单

  • 房主与两个不同账号访客进入同一任务,访客加入无需审批,完整历史可读,多人发言进入同一 Agent。
  • 原同账号远控、正常任务权限、Full Access、串行队列和重复输入幂等不退化。
  • 访客无法直接访问其他任务、伪造作者、改他人队列或响应房主管理确认;任务内 Agent 的 permission、ask_user_question、plan_review 交互可由访客决策。
  • 退出/移除/停止共享/归档/登出立即阻断后续访问,旧邀请和迟到响应不复活权限。
  • 访客重启恢复、房主离线关闭、断线补发、附件上传下载、SSH 工作区、Desktop/Mobile 和旧版拒绝有相应验证。
  • 一个访客停止 ACK 时其他访客和房主控制端仍可工作。
  • UI 使用语义 token 支持 Light/Dark,实际验证结果如实记录,不以类型检查代替联调。

本地联调

最小组合是一套测试服务、一个房主 Desktop 和一个访客客户端。验证多人并发时增加第二个访客,使用三个不同 Cindy 账号;同账号的两个实例走既有远控,不能用于验收跨账号共享。

  1. 在独立测试数据库和 Redis 上启动本任务版本的 device-link-server,并执行该服务的 Prisma migration。登录需使用同一测试区域的 auth-server;附件上传下载还需要可用的测试对象存储配置。不要把测试指向生产数据库。

  2. 两个 Desktop 使用不同 checkout、不同命名沙箱和独立端口。分别从各自 checkout 使用仓库根安全启动入口:

    pnpm restart:desktop:local --region=global --isolated=sharing-host
    pnpm restart:desktop:local --region=global --isolated=sharing-guest
    

    启动参数、端点与端口以 Desktop 开发规则 为准;包装脚本会停止当前 checkout 的旧开发实例,因此不要在同一个 checkout 连续执行两次来模拟双客户端。也可用 Desktop 房主加 Mobile 访客;手机端点必须是手机可达的测试服务地址。

  3. 房主打开已有任务,开启共享并复制邀请。访客从菜单加入,确认无需审批即可进入普通任务页,能够查看加入前的消息、工具结果和附件。

  4. 同时发送不同内容,确认两个客户端看到同一 Agent 输出及正确作者。Agent 忙时编辑或撤回自己的待发送消息;修改其他成员的待发送消息应失败。编辑带图片的消息,保留旧附件并增加新附件,确认发送后和重载后都可打开。

  5. 分别验证只有房主(含同账号远控)能切换 Agent、模型和推理设置,访客界面与直接请求均不可修改;访客仍可停止 Agent。普通权限与 Full Access 保持原有语义;任务内 Agent 弹出的 permission、ask_user_question、plan_review 交互由房主或访客选择后继续执行。

  6. 访客断网后重连,确认有效共享与历史恢复。房主断线后 60 秒内重连保留共享;持续离线超过宽限后共享关闭、旧邀请失效,上线后需重新开启。房主主动关闭或退出账号立即关闭共享。单个访客断线时,另一个访客及同账号远控继续工作。

  7. 验证移除、退出、停止共享、归档和登出。旧邀请不能恢复已退出或移除的身份,新邀请可以重新加入;未共享任务与主机全局设置不可经访客客户端访问。

  8. 验证本地工作区及 SSH 工作区的图片、音频、视频,检查 Light/Dark 和小屏。旧服务端或旧客户端应提示升级,不得退化成全设备控制。

兼容性补充验证(2026-09-17)

  • Desktop / Mobile 的旧主机错误提示、Mobile relay 能力状态与共享列表轮询相关 34 项自动化回归全部通过;覆盖断网不误报升级、升级后恢复、迟到旧账号响应不更新界面。
  • 根目录 pnpm test:unit:related 通过(退出码 0),Desktop / Mobile 类型检查通过。测试调度器 537 项通过、8 项按条件跳过;本地需将 Git Bash 加入测试进程 PATH,未修改或弱化测试。
  • 本轮未做新旧版本实机联调,无新增实机截图;上述自动化结果不计作 Mobile 实机或混合版本部署验收。

验证记录(2026-09-16)

以下保留当日实际结果。房主重启自动恢复的旧验收口径已被 2026-09-18 的“房主离线关闭共享”裁决取代,不再作为当前预期。

真实双账号 Desktop 联调

使用两个真实 Electron 开发客户端、不同账号和独立沙箱,连接隔离的 auth-server、device-link-server、PostgreSQL 与 Redis。Agent 使用真实模型并在房主执行工具;以下结果不是模拟 IPC 或 HTML 页面验证。

  • 房主开启共享并复制邀请;访客无需审批即可加入,能读取加入前历史并准确回答其中的测试暗号。
  • 访客发言进入同一个 Agent;房主和访客均显示访客作者、实时回复、工具活动和处理状态。
  • 访客触发真实 PowerShell 工具;Agent 忙时,访客编辑自己的待发送消息,撤回另一条待发送消息;最终只处理编辑后仍保留的消息,不显示编辑标记。
  • 房主移除访客后,访客立即离开任务、共享列表项消失;旧邀请被拒绝,房主生成新邀请后可以重新加入并读取历史。
  • 房主独立重启,访客窗口保持打开且未刷新;连接自动恢复,新消息收到 HOST_RESTART_RECOVERED。观察到可信连接来源代次从 1 递增到 2,房主进程代次从 2 回落到 1,推送仍正常接收。
  • 房主停止共享后,访客立即退出并看到远程任务已结束;原邀请无法重新加入。
  • 每个关键步骤均保存真实 PNG 截图,并通过手机可打开的文件图片链接发送。

本轮修复与自动化验证

  • 修复跨账号房主推送被同账号过滤器丢弃:绑定服务端已验证的房主身份,同时保留访客本地账号边界和房主来源代次校验。
  • 修复共享任务状态、工具活动和用量没有实时同步:仅向该任务的已授权访客补发对应事件,不授予全局任务订阅。
  • 修复同账号状态重新提交与房主重启后的恢复:退役旧授权捕获,按可信新连接更新来源代次,拒绝迟到旧帧,不重启其他成员的 relay。
  • 断线健康检查改为读取已授权的单个任务,不再调用访客无权访问的全局任务列表;Desktop 与 Mobile 共用检查逻辑。
  • 补齐任务内子 Agent 历史与后台活动只读查询的范围校验。
  • 服务端共享状态轮询不再消耗邀请等写操作的限流额度;写操作仍按账号独立限流。
  • 最终 pnpm test:unit:related 完整通过(退出码 0),覆盖 Desktop、Mobile、device-link、maker-core、maker-shared、lizi-mcps 与 orca-workflow;Desktop、Mobile 类型检查通过,device-link TypeScript 检查通过。
  • 服务端单测 182 项通过、类型检查通过;另有 1 项真实多实例集成测试按条件跳过,不视为通过。
  • 先前客户端 SQLite 全量 migration 回放及共享记录测试 17 项通过;附件上传/编辑、历史媒体归属、作者校验、撤权、关闭与恢复竞态已有自动化回归。
  • 独立复核发现并修复上下文用量查询的冷启动配置入口:访客参数不能控制 Agent 启动,配置与目录授权只从主机读取,关键副作用前复验成员有效性;相关 14 项回归通过。房主重启修复的定向检查通过(Client 229 项、Owner fence 8 项、文本批处理 178 项),复核未报告剩余 P0/P1。

尚未验证与已知限制

  • 真实 Mobile、两个访客同时在线、同账号控制端共存、单个访客停止 ACK、SSH 工作区与真实对象存储附件上传下载尚未完成端到端验证。Mobile 没有运行中的模拟器或匹配安装包;测试对象存储未配置。不能用单测或双 Desktop 结果替代这些验收。
  • 归档、登出、旧版能力拒绝等路径有自动化覆盖,未逐项做真实 UI 联调。
  • Light/Dark 和 390px 窄屏曾用真实 React 控件配合模拟账号/IPC 目检,仅证明控件展示;不计作完整 Electron 双主题或 Mobile 实机验收。
  • 无效、撤销或已停止共享的邀请会被拒绝,但当前错误提示笼统显示“未能更新共享状态,请检查连接后重试”,尚未区分邀请失效原因。
  • 未部署服务端或发布客户端。

三轮独立 Review 与逐轮修复(2026-09-16)

  • 第 1 轮:合法新增设备不再撤销原设备连接;移除请求尚未确认时只暂停访问。在线登出先保存关闭记录,再用固定的退出账号凭证关闭服务端共享,失败留待恢复重试。
  • 第 2 轮:请求准入、建链、订阅、执行完成和最终发包统一区分临时不可用与确认撤权。登出与创建共享并发时,迟到的创建 ID 仍先写入关闭记录,旧数据库等待这些请求收尾后才释放。
  • 第 3 轮:同账号、区域和数据库的运行实例重绑定保留未完成创建的清理记录;归档后恢复的任务可重新共享,旧请求和旧共享不能复活。
  • 最后一轮未发现剩余确认的 P0/P1;最终生命周期与 dispatch 定向回归 51 项通过,Desktop/Mobile 类型检查与 device-link TypeScript 检查通过。
  • 源码冻结后重新执行根目录 pnpm test:unit:related,退出码 0:Desktop、Mobile、device-link、lizi-mcps、maker-core、maker-shared、orca-workflow 均通过;测试调度器 534 项通过、8 项按条件跳过。
  • 本次增补的实机登出测试未完成:隔离启动命令的最终检查报 STARTUP_FAILED / Invalid array length,定位到已有 desktop-whoami 进程子树遍历。未用模拟界面代替实机截图,也不将此轮自动化回归记为 UI 验收。

设置共享管理 UI 验收(2026-09-28)

  • 按用户确认稿修正 Android 管理页:返回设置、大标题与右侧加入按钮、下划线页签、带内部分隔线的列表、列表下方说明和取消全部共享区;入口位于语音词典与外观之间。
  • CN Android 模拟器连接 dev 服务,使用真实跨账号共享验证:手动输入旧邀请码后直接进入任务;成员使用账号昵称;取消退出保留原页签;房主取消共享后显示结束态,返回任务列表。
  • 已目检浅色、深色的真实“我加入的”列表与浅色空状态;此模拟器账号无自己发起的共享,有内容的“我发起的”列表和 iOS 未实机目检,不能以组件测试替代。
  • Mobile 全量单测 7,525 项通过、11 项按条件跳过;后续空状态调整的定向回归 37 项通过。Desktop、Mobile 类型检查、i18n key 一致性和术语检查通过。测试共享已取消,原有其他共享保留。

模型修改权限验收(2026-10-10)

  • 基于 da77ac386 主干与本次修复,启动两个独立 checkout、独立 userData 的 CN Electron dev,使用两个真实账号完成开启共享、复制邀请与加入。
  • 访客显示当前模型但选择按钮禁用;访客正常发送消息并收到真实 Agent 回复。房主通过模型选择器选择 GPT-6.1-Sol,按既有“下条消息”行为发送后生效,访客同步显示新模型且仍不可修改。
  • 从真实访客客户端绕过界面,经 device-link 分别调用 maker:set-model、maker:set-effort、maker:set-fast-mode、maker:set-thinking-enabled、maker:switch-session-agent,五项均返回 PERMISSION_DENIED;前后读取房主任务配置,模型、Agent、effort、fastMode 均未改变。
  • 已目检真实访客任务页的 Light/Dark 模型展示与禁用状态,截图:Light、Dark。Desktop 定向测试 315 项(含提交前新增的实际模型变更入口回归)、Mobile 定向测试 58 项、device-link 权限测试 35 项及三个相关 package 类型检查通过。
  • 本轮未进行 Mobile 实机、旧版访客或同账号远控实机验收;不以双 Desktop 结果替代这些验证。
  • 验收结束后已取消本次测试共享,确认访客共享列表不再包含该任务,并恢复访客原有主题设置;隔离沙盒与测试任务记录保留。