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: 同步 main 并保留两项协议兼容说明

liugaoweia140aad062e3
diff --cc docs/dev-rules/protocol-compatibility.md
index 70fe625ff7,ee87357cba..ee741abb71
--- a/docs/dev-rules/protocol-compatibility.md
+++ b/docs/dev-rules/protocol-compatibility.md
@@@ -11,18 -11,25 +11,37 @@@
> **增量适用原则**:wire protocol 兼容对所有跨端改动生效,不因是小改而豁免。
+## 支付宝已付下一期的升级拒绝
+
+升级报价和确认可返回 HTTP 409 `PLAN_CHANGE_RENEWAL_PREPAID`。Desktop Main 仅放行该
+明确错误码,仍脱敏服务端 message;Renderer 显示本地化提示“下一期费用已提前支付,请等待
+本期结束后再进行升级。”,不从错误文本反推业务状态。确认阶段收到该拒绝时也结束本次
+支付展示,不将其当作网络未知结果重新确认。具体实现和回归见
+`main/billing/index.ts`、`renderer/features/billing/usePlanChange.ts` 与对应测试。
+
+旧客户端仍按 HTTP 409 拒绝操作,显示通用冲突提示;新客户端连接旧服务端保持原行为。
+需服务端与客户端均更新才有完整限制和具体提示,不要求同步部署,也不新增订阅状态。
+支付宝恢复续订的截止资格由服务端下发 `resumable`,客户端不另算 24 小时规则。
+
+ ## Desktop 远程新建菜单
+
+ 同账号控制端通过新增只读 `ghosts:composer-list(workingDir?)` 异步取得执行主机的插件菜单。
+ 响应仅含名称、ID、指令、工具声明、图标、Skill 存在标记与目录过滤后的启用状态,不传安装路径、
+ 批准记录、配置或凭证。无项目时不传参数;共享任务访客不开放此通道。
+ 远程清单按序列化后的 UTF-8 字节限制为 1 MiB,为传输封装预留空间;保留所有插件的基础信息,
+ 先容纳工具声明、再容纳图标。超出剩余预算的可选字段整项省略,工具声明缺失时复用现有
+ `ghost_list` 按需查询,图标缺失时显示通用图标。基础信息本身超限则明确失败,不截断插件列表;
+ 本机清单不受此远程预算影响。
+ 切换设备、目录或账号后丢弃旧响应;打开菜单、重连或点击重试时重读,不阻塞菜单展开。
+ 旧主机拒绝未知通道时显示读取失败与重试入口,不用控制端清单替代;插件入口需要执行主机支持此通道。
+
+ 计划模式复用 `maker:create-session` 的既有可选 `planMode` 参数;新主机创建任务记录时将显式值
+ 与任务元数据一次写入既有 `planModeEnabled` 字段,写入失败复用创建清理路径,不在创建后另行补写。
+ 控制端临时镜像与首条消息采用同一选择。未携带参数的旧控制端
+ 保持原行为;旧主机虽接受启动参数,但不保证持久化初始选择,完整行为需更新执行主机。
+ 附件复用现有出站上传与接收落盘协议,上传完成后才发送远端引用;移除新建页的旧图片限定,
+ 不增加媒体协议字段、数据库迁移、服务端能力或 Mobile 原生改动。SSH 的附件限制保持原行为。
+
## 账号用量上限的自动继续
输入投影 `AgentInputProjection` 新增可选字段 `usageLimitWait: { resumeAt } | null`,与 `error`