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 upstream IM documentation without losing chat read contract

Chrisfabeddcc3f69
diff --cc docs/dev-rules/protocol-compatibility.md
index 42878ca2cb,b705b4b59c..4fe44e884a
--- a/docs/dev-rules/protocol-compatibility.md
+++ b/docs/dev-rules/protocol-compatibility.md
@@@ -1,15 -1,23 +1,33 @@@
# 跨端协议兼容
+## 手机经电脑确认群消息已读
+
+群 Remote Resource 投影新增可选 `supportsReadReceipts`,仅云端群声明。
+新手机通过现有 `maker:remote-resources:invoke` 的 `read` action 提交实际可见的
+`messageId`;宿主复核群可见性及账号代次,再复用 `chatServer.manage` 的读位确认,
+不信任客户端提供的序号、不读取或确认尚未显示的新消息。旧宿主没有能力标记时,
+手机保留原本地未读缓存行为;旧手机忽略新字段。`send.quote` 转交既有发送验证与水合入口。
+不增加 IPC 白名单、身份权限或原生依赖,不重置连接、不重放发送操作;单群读位失败
+留待该群下次可见或重连刷新,不影响其它设备连接。
+
+ ## IM 状态表情由客户端声明
+
+ 官方 Slack / Telegram 的 `hello` 新增可选 `statusReactions`:`queued`、`error` 为
+ 1–64 字符且不含空白的平台原生表情名称;`processing` 为 1–16 个名称,
+ `expressiveError` 为可选的 1–64 个名称。两仓 `slack-hook-protocol` 的类型、校验和
+ 有效/无效 fixture 同步维护。客户端 `hook-control/statusReactions.ts` 生成平台配置,
+ Telegram 复用个人 bot 的变体池;X 不发送该声明。
+
+ 服务端在已认证 hello 的同步段按设备登记,早于 welcome/派发;后续 hello 整体替换,
+ 省略字段清除旧声明。任务使用原路由设备的配置,断线保留最近声明供收口;进程重启后
+ 由重连恢复,在此之前使用兼容默认值。服务端继续负责状态生命周期、实际表情清理与
+ 平台 API 拒绝时的一次标准回落,成功和取消不新增表情。样式不能改变权限或消息归属。
+
+ 新客户端连旧 server:旧校验器忽略可选字段,照常使用旧样式;旧客户端连新 server:
+ 使用兼容默认值。无需新消息类型或协议版本,无数据库、环境变量、Mobile 原生配置变化,
+ 两仓可独立发布/回滚。完整效果要求两端支持,之后换肤色或表情池只需改客户端。
+ 本次声明仅包含状态表情;进度和终稿文案继续复用已有客户端渲染,服务端命令文案未迁移。
+
## 手机读取项目别名(#6916)
同账号 device-link 只读白名单增加 `local-db:project-aliases:list`,返回宿主现有的