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。

docs(companions): align authoritative context recovery rules

Chrisa0d3f6807f49
diff --git a/apps/desktop/src/main/maker-ipc/cindyContextCompression.ts b/apps/desktop/src/main/maker-ipc/cindyContextCompression.ts
index c3b222a2e4..0c2a59836e 100644
--- a/apps/desktop/src/main/maker-ipc/cindyContextCompression.ts
+++ b/apps/desktop/src/main/maker-ipc/cindyContextCompression.ts
@@ -21,7 +21,7 @@ export type CompressionBudgetState = 'ok' | 'violated' | 'unknown';
/**
* tokens='violated' 只允许这些证据(普通 timeout / 网络 / 鉴权不算):
* - 终态 context-overflow(含 PI prompt RPC 超时)
- * - 本机占用 ≥ 100%(伙伴主对话的发送边界提前至 90%)
+ * - Claude Code/Pi 本机占用 ≥ 100%(伙伴与普通 Session 相同;Codex token 压力交原生压缩)
* - 官方 compact 确定性失败(needsRollover,或伙伴已记录的压缩空摘要/invalid-request)
*
* bytes='violated':Codex 活尾巴可剥超大内联图(>8MB 且可剥 ≥ 一半且剥完 ≤8MB),
diff --git a/docs/dev-rules/im-turn-flow.md b/docs/dev-rules/im-turn-flow.md
index 4810c5de21..c5d4a0552f 100644
--- a/docs/dev-rules/im-turn-flow.md
+++ b/docs/dev-rules/im-turn-flow.md
@@ -109,8 +109,9 @@ Telegram / Slack / X)是同一件事的两套实现:把渠道里的一条消
6b. **发送前上下文体检同源**:个人 IM 的 `dispatchQueuedSend` 在伙伴守卫(`companion.prepareSend`)
之后、拿发送锁(`acquirePendingAgentSwitch`)之前调用 `deps.prepareUnhealthySession`(orchestrator 接
`register.prepareUnhealthySessionForSend`),与桌面直发、官方 hook 走同一个
- `contextOverflowRollover.prepareUnhealthySession`:伙伴对话(主任务 + channel / group 专线)的空闲
- 间隔刷新(≥12h)、90% 到线换窗、坏历史重建都在这里发生,IM 不另设换窗 / 换任务规则
+ `contextOverflowRollover.prepareUnhealthySession`:伙伴对话(主任务 + channel / group 专线)沿用
+ 普通 Session 的真实满窗、明确压缩失败和坏历史恢复;健康上下文交给原生压缩,不按空闲时长
+ 或 70%/90% 伙伴阈值提前换窗,正常压缩也不重启伙伴实例。IM 不另设换窗 / 换任务规则
([`cindy-bots-runtime.md` §3.2](../product-rules/cindy-bots-runtime.md))。体检关闭 live handle 的原因是
`runtime-refresh`,close 监听在有 `acquirePendingAgentSwitch` 时保住任务,新 handle 由
`refreshSessionAfterPendingAgentSwitch` 按最新 DB 行重建;体检抛错按直发口径让这条消息失败。
diff --git a/docs/dev-rules/maker-core-and-agent-behavior.md b/docs/dev-rules/maker-core-and-agent-behavior.md
index 52c058ec7f..f742dbdbfb 100644
--- a/docs/dev-rules/maker-core-and-agent-behavior.md
+++ b/docs/dev-rules/maker-core-and-agent-behavior.md
@@ -129,9 +129,11 @@ Cindy 保底压缩是**一套**交接重建流程。装得进当前约束就不
带调用关联的文本结果摘要,省略图片数据;伙伴主对话及显式重启也保留这些结果,其他交接沿用原规则。
可剥图不足一半的混合大尾巴有意不救。打开会话不触发;只在终态错误或下次发送时
由 main 侧 claim。SSH 不承诺。不确定 fail closed。救援摘要不得依赖额外模型调用。
-Claude Code/Pi 伙伴 canonical 主对话在发送边界达到已知窗口的 90%,或本地 Codex 图片活尾巴实测超限时,
-复用同一持久交接提前重建;保留有界工具结果、按输入取消恢复,后台原生工作未结束时不换窗。
-权限依据为有效 Bot link 与 active Profile;其它任务保留原来的满窗门槛。
+伙伴主对话、话题和 IM 专线与普通 Session 一样依赖原生压缩,不按空闲时长或 70%/90%
+伙伴阈值提前重建,也不在正常压缩后重启实例。Claude Code/Pi 保留普通 Session 共用的
+真实满窗保护;Codex 不按本地 token 占用提前重建,只在明确失败后检测历史并走恢复。
+实际恢复复用持久交接、保留有界工具结果、按输入取消;后台原生工作未结束时不换窗。
+伙伴权限依据仍为有效 Bot link 与 active Profile。
伙伴下一次发送也识别已记录、明确来自压缩的空摘要/invalid-request 错误;不扩大原生 latch
规则,不把普通空回复、网络、鉴权或额度错误当作压缩损坏。
Codex 图片历史重建后,普通用户任务和伙伴主对话可在同一任务内自动续接未完成工作。交接包含原请求
@@ -164,7 +166,7 @@ Codex 同引擎切模(包括自动任务、Orca、设备互联与 SSH)保留
这条目标模型原生压缩路径,不能因无法使用旧模型而提前拒绝切模。不得仅因目标窗口较小、占用到
90%/100% 或伙伴账本新鲜而抢先生成 Cindy 交接。窗口预算与用户 override 保持不变;重载模型
目录或凭证执行句柄不等于重建历史。Cindy 只在明确的上下文超限、原生压缩失败或历史字节超限后
-沿用既有兜底及副作用保护。跨引擎交接、显式重启和伙伴空闲间隔刷新仍按各自生命周期规则处理。
+沿用既有兜底及副作用保护。跨引擎交接和显式重启仍按各自生命周期规则处理;伙伴不再执行空闲间隔刷新。
真实 CLI 的同供应商、跨供应商与逐 thread 预算回归见
`apps/desktop/src/main/maker-host/__tests__/codexContextSwitch.native.test.ts`;逐 thread 回归在本机
模拟服务运行,不代表完成了真实 SSH 端到端验收。