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。

merge: retain read receipt and simulator migration contracts

Chrisb2eb6a8af694
diff --cc docs/dev-rules/protocol-compatibility.md
index 746308da63,3dbc5cbe96..35e04bc09f
--- a/docs/dev-rules/protocol-compatibility.md
+++ b/docs/dev-rules/protocol-compatibility.md
@@@ -1,15 -1,18 +1,28 @@@
# 跨端协议兼容
+## 手机经电脑确认群消息已读
+
+群 Remote Resource 投影新增可选 `supportsReadReceipts`,仅云端群声明。
+新手机通过现有 `maker:remote-resources:invoke` 的 `read` action 提交实际可见的
+`messageId`;宿主复核群可见性及账号代次,再复用 `chatServer.manage` 的读位确认,
+不信任客户端提供的序号、不读取或确认尚未显示的新消息。旧宿主没有能力标记时,
+手机保留原本地未读缓存行为;旧手机忽略新字段。`send.quote` 转交既有发送验证与水合入口。
+不增加 IPC 白名单、身份权限或原生依赖,不重置连接、不重放发送操作;单群读位失败
+留待该群下次可见或重连刷新,不影响其它设备连接。
+
+ ## 设备模拟器官方 ID 更新
+
+ 市场请求携带 `x-cindy-plugin-migrations: simulator-id-v1` 表示客户端支持这一次官方
+ `baguette-simulator` → `cindy-simulator` 安装身份迁移,不是权限或发布者凭证。
+ Server 保留原市场资源 ID 和不可变旧 Release;无能力声明的客户端继续获取旧 ID 包。
+ 有声明的客户端获取新 ID 包,列表、详情、下载的 ghostId 必须与选中包的 manifest.id 一致。
+ 新客户端访问旧 Server 时仍按旧 ID 运行。只有 Server 全量升级且客户端支持已发布后,
+ 才可审核上架新包;不能只靠引用改名宣称旧安装已迁移。
+ 回滚 Server 前须通过既有版本选择恢复旧 Release;不可在新包仍为 current 时回滚到不识别迁移的 Server。
+ 迁移过的客户端保留新安装和原数据键,不会自动降级成旧 ID 或再装一个旧副本。
+ 事务失败回滚是恢复尚未提交的旧安装,不是支持任意降级客户端二进制。迁移后不得退回不认识
+ 该 receipt 字段的客户端并重建注册表;回退应保留这段兼容读取能力,避免重新派生数据键。
+
## 手动对齐 worktree 源分支
`worktree:list-branches` 的 IPC 响应可选追加 `remoteDefaultBranch`