Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。
Chat Server 本地接入测试
正式客户端统一通过端点清单的 chatApiBaseUrl 连接聊天服务器,WebSocket 从同一地址派生。国内与国际清单连接同一生产聊天数据源,支持跨区邀请;不再按打包形态选择本地群聊。下文的 loopback 配置仅供显式隔离测试,正式安装包不会读取。
已有账号的本地群先按稳定来源 ID 建立服务器群,按原消息顺序导入作者、时间、正文和附件。服务端保存导入水位;断线或重启从已提交位置继续,已提交记录不重复,导入不触发 Agent。成功后的群 ID/水位回执保存在账号目录 chat-upgrades/<端点及账号摘要>/,以后退出或转让群不再重新导入。旧本地数据保留为迁移源和 Agent 元数据,不作为另一套可发言群。单群导入失败时保留源数据和服务端水位,后台按群续传,界面提示尚有旧记录待上传;不阻塞云端群列表、其他群和建群。附件独立加载,失败不会阻断文字历史。
上线顺序:先部署服务端和持久数据库/对象存储,验证 https://chat.cindy.app/ready、两区登录与 WebSocket,再把两个区域的 CDN endpoint.json 发布为本仓清单,最后发布客户端。仅修改随包 JSON 不等于在线 CDN 已发布。服务端部署登记与操作说明见 cindy-server 的 docs/chat-server-production.md。
两个 DEV 接入同一聊天服务
在 cindy-server 的 chat-server 目录运行:
NODE_USE_ENV_PROXY=0 HTTP_PROXY= HTTPS_PROXY= ALL_PROXY= pnpm dev:local --cindy-auth
需要本机 PostgreSQL 的 pg_config、initdb、pg_ctl。真实账号模式使用仓库外 ~/.cindy/chat-server-dev/db 持久数据库,正常重启直接复用记录;不读取业务数据库配置,仅开放私有 Unix socket,API 只监听 127.0.0.1:3018。本模式同时使用真实 https://auth.cindy.app 和 https://auth.cindy.com.cn 的 RS256/JWKS、成员状态校验,不启动虚拟身份服务。
在两个隔离 profile 的 chat-server-dev.json 写入以下配置(不含凭证,不放入源码目录):
{"baseUrl":"http://127.0.0.1:3018","auth":"cindy"}
从两个独立 worktree 启动相同代码,各用独立命名 profile 和调试端口:
XDT_CDP_PORT=9238 pnpm restart:desktop:remote --region=global -- --isolated=chat-server --wait-ready
XDT_CDP_PORT=9239 pnpm restart:desktop:remote --region=global -- --isolated=chat-server-peer --wait-ready
每条命令须在对应 worktree 执行,成功须返回 DESKTOP_DEV_VERDICT=ready。数据目录分别是 CindyGlobal-dev2-chat-server 和 CindyGlobal-dev2-chat-server-peer。启动遵守当次用户授权;不从正式 profile 复制账户、数据库或模型凭证。
由用户通过正常界面登录两个不同账号。国内外、个人与企业账号均可互相邀请,不要求同一区域或同一组织。每个账号由自己的认证服务验证;服务端身份包含 issuer,防止不同认证域编号碰撞。两个独立 profile 拥有不同设备身份,但不能据此宣称已验证两台物理设备或手机直连。
操作路径
- 侧栏「伙伴」段头 → 加号 → 新建群聊。可以选择零到六位本机伙伴,建群后再邀请人。
- 群顶栏邀请按钮 → 生成邀请链接 → 复制。群主或管理员可以创建;按服务端响应显示规则:
expiresAt: null且reusable: true才是长期有效、多人重复使用,有到期时间的旧式链接仍按实际日期、单次使用展示。 - 另一账号:侧栏「伙伴」段头的加入按钮 → 粘贴链接 → 查看邀请 → 接受并加入。预览只展示群名和邀请者,不开放历史;加入后按群的历史策略读取。
- 每条消息下面可打开回复面板、添加/取消表情回应。消息显示回复数和回应人数,自己的回应有选中状态。伙伴回复 Thread 消息时,结果写回同一 Thread。
- 两个窗口分别发消息、回复和回应;检查实时刷新、不同作者名字及本人标记。退出其中一个 DEV 后,另一个仍能读取历史;重开 DEV 重新从服务器读取。
邀请有效期与单链接撤销验收
以下检查只在已授权的隔离测试环境或离线 fixture 中执行,不操作真实群或生产链接。新客户端可先发布;长期复用与撤销依赖服务端对应迁移及新版实例全部完成滚动更新,旧实例可能拒绝 expiresAt: null 的新链接。
- 新服务端返回
expiresAt: null, reusable: true:创建与预览都显示长期可重复使用;反复复制得到同一链接,不额外生成。用多个受邀测试身份接受同一链接,前一次接受不消耗链接;预览仍不开放群历史。 - 旧服务端省略
reusable、返回日期:显示实际到期时间和单次使用,撤销按钮禁用并提示不支持;新服务端返回的存量日期链接也保留到期、单次语义。日期到期后不再复制或接受,不能统一标为长期。 - 群主或管理员点击当前链接的撤销按钮:确认文字明确只撤销这一条;取消确认不发撤销请求,原链接仍可复制。普通成员或不属于当前群的链接应被服务端拒绝。
- 确认撤销仅发送当前 token 和操作标识;只有 HTTP 200 且
revoked: true才展示已撤销,禁用旧链接及复制。旧链接的预览或接受应失败,其他链接与已有成员保持有效;再次生成使用新操作标识并得到新的有效链接。 - 权限、网络或旧路由错误保留链接并显示准确错误,404 不能当作撤销成功;不支持撤销时明确降级。同一次不确定失败的重试沿用操作标识,不以客户端本地状态冒充服务端撤销。
数据与执行边界
现有群界面 → 受信 IPC → Main chatServer.ts → 清单配置的 HTTPS/WSS → PostgreSQL。账号令牌仅由 Main 从正常登录服务读取;不透传给 renderer,不写入测试配置。切换账号会废弃旧请求、连接及执行租约上下文,并重新注册当前账号的伙伴。
人和 Bot 使用同一成员、消息、回复、回应及邀请合同。Bot 通过稳定本地 ID 注册;服务器分发执行请求,Main 复用现有群专线、权限同步、输入队列和终态回传。成员资格不授予另一账号的电脑或工具权限。
本地数据库只保存执行所需的群成员元数据及 Agent 上下文,群时间线始终读服务器,不镜像写入 bot_group_messages。WebSocket 推动刷新:新打开的群从快照游标开始订阅,不回放整段变更日志;游标只在本进程内存里保留,断线重连从最后读取或确认的游标续订并重新读取,不持久化。打开群时,已订阅的群快照与消息、执行状态并行读取,新群先取快照游标再读其余部分;附件下载完成按群合并为一次刷新。执行每两秒领取,租约每十五秒续期。
终态回传遇到网络或临时服务错误时,当前进程保留同一份结果,每十五秒使用相同操作 ID 补交,不重新运行 Agent。收到成功收据或明确的过期/撤权等拒绝后结束;账号切换或退出会清理该账号的待发送结果。这是运行期重试,不是跨应用重启的持久 outbox。每次续租使用独立操作 ID,避免服务端幂等缓存导致租约无法延长;恢复只作用于该次执行,不重启共享远控连接。
已验证与限制
本地聊天恢复与待发消息
当前客户端在服务器历史之外保存账号隔离的显示快照,不将服务器群时间线写入旧的
bot_group_messages。手机复用现有 HistoryDiskStore 和 durableOutbox;桌面群历史、列表、
云端伙伴记录与待发消息写入当前账号的本地目录。历史按字节预算保留,未确认的用户待发
内容不参与历史淘汰。显示快照不能授予发送、读回执或远程控制权限;删除、退群、隐藏及
已确认的撤权会使相关快照失效,旧账号的迟到请求不能写入新账号。
首页先恢复已知伙伴、群和任务,后台按来源更新。可选电脑名称查询不阻挡云端伙伴列表; 局部错误只重试失败来源。通知命中当前账号保存的精确伙伴、电脑和任务关系时,直接挂载 原有聊天页面,由后台验证补齐状态;没有这层记录时保留首次进入检查。
Chat Server 群发送先保存本地待发消息,再交出输入框内容。同一条消息在重试和重启后使用 同一个 clientId,首次可能发送前冻结 HTTP 内容;收到回执后继续保留记录,直到读到实际 服务器消息。桌面附件继续使用原有媒体引用,手机群仍沿用当前支持的文本发送能力。 旧版电脑远程群入口补充了历史恢复,发送仍使用该电脑已有的在线能力;普通伙伴任务继续 复用其原有持久发送队列。
验收时使用仅测试账号参与的群:发送在线基线,阻断 HTTP 后通过实际输入框发送,确认 待发气泡与草稿交接;正常退出并重开应用,恢复网络后核对服务器中 clientId 对应消息只有 一份。再验证返回首页、重新进入、迟到磁盘读与实时删除竞争、切换账号及撤权。通知分别 检查前台、后台和新进程冷启动,重复同一个通知不能重复入栈。仅注入 HTTP 失败不等于 设备完全离线;本地系统通知只能验证点击链路,不能证明 APNs/FCM 投递成功。
2026-10-03:真实账号的 DEV 界面建群、生成邀请链接、文本消息、真实伙伴回复、Thread 内人和伙伴的回复、表情回应均已操作验证,回复面板亮暗模式已目检。自动集成测试覆盖不同账号的邀请预览/接受、未加入不可读取、一次使用、过期、封禁、入群历史边界,以及 Bot 作为群主/受邀成员。
本次两个真实 DEV 所登录账号分别来自中国大陆企业与 Global 个人身份,已在不切换账号的情况下完成:生成邀请 → 预览 → 接受加入;国内账号群消息实时出现在 Global 窗口,Global 的真实伙伴接话;Global 账号在同一 Thread 回复,国内窗口实时显示本人和伙伴两条回复;同一消息两人点 👍 后两端显示 2 人。真实窗口操作及 API 回读相互核对,不以伙伴自行宣称“连通”作为证据。
随后分别重启两个 DEV:明确确认被重启实例进程/调试端口关闭期间,另一实例仍从服务器读取同一 Thread 的人和伙伴回复;两端重新取得 ready 并恢复原消息、回复数和回应人数。已核对两个 profile 的设备 ID 不同。
2026-10-04 正式适配器已接入附件、历史及安排迁移、负责人/项目文件夹、继续讨论、分工的开始/继续/重试/编辑/停止及批注。删除群沿用服务器群主归档、其他成员退出的共享群语义。分工状态共享,计算仍在有对应授权的执行端;工作目录按账号和服务端隔离保存在电脑上。测试覆盖真实临时 PostgreSQL 的跨账号分工与租约、客户端隐藏伙伴和附件故障。未验证生产负载、真实 OSS 或完整离线恢复;持久本地 outbox、手机直接连 Chat Server 与云端执行器不在本次接线范围。
无 --cindy-auth 的 dev:local 仍可用于独立 API 自动化探索:它生成两个八小时有效的虚拟用户,测试身份服务只监听 127.0.0.1:3019。这类 fixture 不用于上述真实账号 DEV,不能混用两个身份模式。
退出客户端不会清除聊天服务器记录。真实账号模式的聊天服务正常停止和重启也保留数据库,fsync 开启;无 --cindy-auth 且未指定 --data-dir 的虚拟用户测试模式仍是可丢弃临时库。本环境用于开发联调,不能充当正式生产服务。首次迁入旧测试备份可加 --restore=/absolute/path/dev-backup.dump,仅允许恢复到空库;此后直接使用正常启动命令,不再传恢复参数。移除隔离 profile 中的 chat-server-dev.json 后,下次隔离测试客户端使用与正式客户端相同的清单端点。
群资料、成员与伙伴授权(2026-10-03)
点击群标题打开群设置。可以查看群主、管理员与每位伙伴的主人;群主/管理员修改名称、主题、简介和接话方式,管理成员、归档/取消归档。群主只可转让给已入群的真人,伙伴行不显示转让入口,主进程与服务端也拒绝非真人接任。伙伴入群前须确认其真人主人已在群内;真人退出、被移除或封禁时,已入群及待接受邀请的伙伴一起退出并撤权。存量群主是自己的伙伴时,主人仍可代其转让给真人,后台用该伙伴的既有角色鉴权。最后一位群主退出前须转让给真人或解散。
每人可修改自己的群昵称,留空使用账号显示名。「修改昵称与头像」复用 Cindy 既有账号资料编辑器,写入当前区域的账号服务,Chat Server 仅刷新经过认证的资料投影。头像使用现有公开 OSS 上传路径;伙伴本地媒体头像先通过统一媒体仓读取并上传,不能把本机路径发给另一台设备。名字/头像变化通过群事件刷新当前消息作者和成员列表。
其他成员使用伙伴有三档,由伙伴主人按群选择:仅主人、仅群内交流(默认)、工具与资料。群主/管理员不能替别人的伙伴授权;授权工具与资料前有明确确认,沿用伙伴原有操作审批。
- 服务端从消息请求者和伙伴的真实所有者计算执行权限,领取时写入租约,客户端不能自报授权。非主人请求要求执行器声明
accessPolicyVersion: 1,旧执行器不能领取;客户端遇到缺失或未知授权字段也拒绝启动。 - 默认交流使用独立群上下文,不装配主人的 SOUL、用户资料、私人记忆、Bot Home、已学 Skill、工具集及私人 MCP;保留公开名字与简介。每轮通过现有三种引擎的
toolsDisabled执行门禁关闭全部工具。 - 主人自己发起、获准工具的外部成员、只交流的外部成员分别使用独立专线。授权版本变化不复用旧版私人上下文。
- 撤回授权会取消旧执行、递增租约版本并通知客户端停止;服务器拒绝过期结果。已经完成的外部操作不可撤销。
- 人退出或被移除时,他带来的伙伴同时退出,清空群授权并停止相关执行。重新加入恢复默认角色和默认伙伴授权;重新订阅长连接,不能沿用被撤销的旧订阅。
定向验证覆盖群资料/角色/昵称、不能代授权、执行中撤回、过期结果拒绝、主人离群后的伙伴退出,以及三个引擎的工具禁用。两个真实 DEV 已验证群昵称推送、跨区域头像、个人资料入口、成员/管理员操作、群主在人与伙伴间转让(历史规则,2026-10-28 已改为仅转让给真人),以及未授权读取测试文件失败、授权后真实 Read 工具成功、执行中撤回后无结果发布。资料编辑入口已实际打开;未为验收修改用户的真实账号名字或头像。
服务器历史回拉(2026-10-03)
普通群默认共享既往历史,后来加入的人和伙伴均能读入群前消息与 Thread;每页 100 条是响应上限,不是保留上限。服务端回归覆盖 125 条历史跨页读取、旧 Thread、搜索和重连增量;持久库重启与覆盖恢复保护也已通过。实际将当前 24 张表迁入持久开发目录,逐表记录数/内容摘要一致,不带恢复参数重启后仍一致;两个真实账号 DEV 自动重连并能读取原群历史。生产负载和容灾仍未验收。
入群系统提示的兼容接线
Desktop 将服务端持久消息 origin: "system" 中的
card(namespace: "cindy.membership", schemaRevision: 1)、
data: { type: "member.joined", actorId, displayName } 映射为 member-joined 系统提示。
只有服务端 origin 可信;用户、伙伴或导入内容里同名 card 仍是普通消息。
使用入群时保存的显示名,不根据当前成员列表反推加入,也不因成员改名或退群改写历史。
未知系统事件版本保留普通系统文本回退,不猜测事件含义。
主消息流与侧栏摘要使用阅读者的界面语言(五种语言)。手机复用现有 Remote Resource
投影,noticeCode 是新增可选摘要字段;旧手机忽略它,时间线可读消息 fallback,
不支持群聊原语的旧手机保留 Markdown 回退。WebSocket 收到
message.system.created 时沿现有群 scope 刷新并重新读取相同的持久消息 ID,
客户端不插入临时消息或触发伙伴回复;“继续讨论”也不以入群事件作为来源。
入群提示不算他人回复,不推动 lastReplyAt 或未读摘要回退;已有待读回复仍保留,读位不变。
客户端可先发布,旧服务端不产生事件时保持现状。服务端对应修复负责真实加入事务、 事件去重、历史可见下界与系统记录保护;只发布本客户端不会补出入群记录。 建议先客户端后服务端,新服务端先发布时旧客户端仍可读取 card fallback,但会沿旧式 作者气泡呈现,不等于已获得本地化系统样式。旧加入历史不从成员现状补造。
本次客户端回归使用离线 HTTP/WebSocket fixture、桌面与手机组件测试;不代表安装版、 线上服务或真实双账号已经验收。普通项目任务与伙伴私聊不经过本次群提示投影。
伙伴群聊故障回归(#5604 / #5605 / #5606)
以下离线回归不代替含修复构建的现场验收:
| 场景 | 自动回归 | 现场预期 |
|---|---|---|
| 服务端安排卡署名为真人 | 双端 BotGroupChatView.test.tsx / BotGroupChatScreen.test.tsx |
卡片显示负责人、步骤和开始/不用了;旧安排只读。开始后完成第一步可继续,另一张安排可取消;运行中补充及等待时返工语义不变 |
| 群里同时有真人、本机与外来伙伴 | botGroupRemoteResourceProvider.test.ts、Mobile botGroupRemote.test.ts / BotGroupChatScreen.test.tsx |
添加/移出伙伴不被既有真人挡住;真人按 actor ID 单独移出;真人不进入负责人/步骤候选,外来活跃伙伴仍可分工;无管理权限失败且名单不变 |
| 附件准备、media POST、OSS PUT、complete 或消息提交失败 | botGroupAttachments.test.ts、chatServerMedia.test.ts、chatServer.test.ts、chatServerErrors.test.ts |
双端按原因显示提示;日志包含阶段、稳定错误码、可取得的 HTTP 状态,以及同次发送关联 trace。不得记录正文、文件名/路径、token、签名 URL |
| 发送超过 15 秒,回执丢失后重试 | chatServer.test.ts、device-link invokePolicy.test.ts、Mobile botGroupCopy.test.ts,保留现有 composer 重试用例 |
群发送单独等待最多 180 秒;超时提示结果未确认,刷新确认后再重试;同一内容沿用 clientId,当前主机进程内在途/已成功请求复用回执,不重复消耗手机上传或提交消息 |
现场使用无敏感内容的小 JPEG,分别验证电脑选图、手机 peer/OSS 引用、纯文字消息;
记录 Desktop/Mobile 的版本与 sourceCommit、发生时间、群 ID、发送 trace 及服务器消息 ID。
Chat group send confirmed 是主机收到提交回执,不能据它推断手机已经收到了回包。
失败时按阶段关联服务器的认证、media prepare、OSS 签名/上传、complete 和消息提交记录;
接口 /ready 正常或未认证 /me 返回 401 都不能证明对象存储已配置或附件链路正常。
老群升级另看下一次重试的错误码及对应请求/上传阶段,保留源历史与导入水位,不以新发图成功代替历史完整性验收。
回执缓存只在当前账号的主机进程内保留最近 128 次成功发送,进程重启/换账号后仍依赖服务器的 operationId 幂等合同,不宣称具备跨重启持久发件箱。检查 Windows + Android 原现场和 iOS 同源界面,分别记录 Light/Dark 是否目检;没有实际执行的项保持待验收。
伙伴补全与附件 DEV 验收(2026-10-08)
服务端启动加 --local-media --data-dir=<独立目录> 可启用磁盘对象存储:真实 PUT/GET
传输字节、校验大小/类型、封存后重启可读。短期地址限本机和短时有效;不是生产 OSS 替代品。
客户端只在未打包、显式隔离且 baseUrl 为 http://127.0.0.1:3018 时接受对应 HTTP 媒体地址,
正式包仍仅允许 HTTPS,不转发账号令牌到媒体地址。
隔离 DEV 已通过图片和文本文件发送、两位真实伙伴正确读取、分工开始/结果回流、等待换人继续、 不用了后恢复普通讨论、修改提议与重启读回。完整验收范围与剩余缺项见 功能对照。不据此声称生产对象存储故障已经修复。