Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。
TypeScript agentai-agentai-assistantandroidclaude-codecodexelectroniosllmmacosreact-nativetypescriptwindows
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.tsindex 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.mdindex 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.mdindex 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 端到端验收。