Smart Context Manager

🧠 AI 智能压缩会话上下文,释放 70%+ token

dev-tools榜 #37

AI驱动的会话上下文压缩工具,通过智能摘要重置长会话,解决上下文窗口耗尽问题,实现70%+ token缩减

收藏
15.6k
安装
4.3k
版本
1.0.0-b
CLS 安全性认证2026-07-12
点击查看完整报告 >

使用说明

核心用法

Context Manager 是专为 Clawdbot/Moltbot 设计的 AI 驱动上下文管理技能,解决长会话中上下文窗口耗尽、响应变慢的问题。核心机制是让 AI 自我总结会话内容,生成压缩摘要后重置会话并注入摘要,实现 70%+ 的 token 缩减

主要命令

  • list / status [KEY] - 查看会话列表和详细状态
  • summarize [KEY] - 生成 AI 摘要(只读,安全)
  • summarize [KEY] --replace - 完整压缩流程:摘要 → 备份 → 重置 → 注入
  • set-threshold/set-depth - 配置压缩阈值和摘要深度

工作流程

1. AI 自总结:向 agent 发送特殊 prompt,要求其总结「已完成任务、关键决策、当前状态、待办事项、关键上下文」
2. 安全备份:原始 JSONL 会话文件保存至 memory/compressed/

3. 官方重置:删除 JSONL 文件(Moltbot 官方推荐的 reset 方法)

4. 上下文注入:将 AI 摘要作为新会话的第一条消息

5. 结果:相同 session key,新 session ID,大幅压缩的上下文

显著优点

  • 效率高:70k tokens → 16k tokens(77% 缩减)的实测效果
  • 智能性强:AI 自我总结比基于规则的提取(grep/正则)质量更高,能保留决策 rationale 和隐含上下文
  • 操作安全:支持「预览模式」(summarize 不带 --replace),压缩前可先验证摘要质量
  • 自动备份:每次压缩自动保存原始会话,支持完整恢复
  • 非侵入式:无需修改 agent 或 gateway 代码,纯 shell 脚本实现

潜在局限

  • 单点依赖:依赖 clawdbot/moltbot gateway 运行状态,gateway 不可用时无法操作
  • 外部工具依赖:需要预装 jq 进行 JSON 解析
  • 破坏性操作风险--replace 模式会永久删除原始 JSONL(虽有备份),误操作可能导致上下文丢失
  • 摘要质量不可控:AI 生成的摘要质量取决于原会话的清晰度,复杂多线程会话可能遗漏关键细节
  • 仅适用于特定生态:专为 Clawdbot/Moltbot 设计,无法直接用于其他 AI 平台

适合人群

  • 高频使用 Clawdbot/Moltbot 的专业用户:需要长时间维护同一会话进行复杂任务(代码开发、研究分析、内容创作)
  • 多会话管理者:同时运行多个会话(main + Slack channels + cron jobs)需要监控和优化资源
  • 追求响应速度的用户:上下文接近上限时模型响应变慢,需要 proactively 维护

常规风险

  • 误操作导致数据丢失--replace 模式不可逆,虽然有备份但恢复需要手动操作
  • Node 警告污染输出:脚本使用 2>/dev/null 屏蔽 Node deprecation warnings,可能掩盖真正的错误信息
  • 时区/静默时间配置set-quiet-hours 等高级功能需确保系统时区配置正确
  • 备份目录膨胀:频繁压缩会产生大量备份文件,需要定期清理 memory/compressed/
  • AI 幻觉风险:极端情况下 AI 可能生成不准确的摘要,导致新会话基于错误上下文继续

安全解读

核心用法

Context Manager 是一款专为 Clawdbot/Moltbot 设计的 AI 会话压缩工具,通过自举式 AI 摘要技术解决长会话的性能瓶颈。用户可通过 compress.sh 脚本执行四大核心操作:

  • `list` - 查看所有会话的 token 使用量
  • `status [KEY]` - 检查特定会话的详细状态
  • `summarize [KEY]` - 生成 AI 摘要(只读,安全)
  • `summarize [KEY] --replace` - 完整压缩流程:生成摘要 → 备份 → 重置 → 注入

AI 自举摘要机制

该工具的核心创新在于利用"AI 总结自身上下文":将完整会话历史发送给模型,要求其提炼关键信息(已完成任务、关键决策、当前状态、待办事项、重要上下文),生成结构化摘要后注入全新会话,实现 70%+ 的 token 压缩率。

显著优点

| 维度 | 优势 |
|------|------|
| **压缩效率** | 实测 70k tokens → 16k tokens(77% 缩减) |
| **智能程度** | AI 自主理解上下文,优于规则式摘要 |
| **安全保障** | 自动备份机制,误操作可恢复;支持只读预览 |
| **操作便捷** | 单命令完成,无需手动导出/导入 |
| **安全认证** | CLS-Certify S级评分(92分),无危险函数、无网络外泄 |

潜在缺点与局限性

1. 来源可信度 T3:个人开发者维护,无知名组织背书,存在长期维护风险
2. 破坏性操作--replace 模式会物理删除会话 JSONL 文件(虽有备份)

3. 依赖特定生态:仅兼容 Clawdbot/Moltbot,无法迁移至其他 AI 平台

4. 摘要质量波动:复杂多线程对话可能丢失细粒度上下文

5. Beta 版本:当前 1.0.0-b 版本,缺少正式版变更日志

适合人群

  • 高频 Clawdbot/Moltbot 用户:日活会话 token 消耗超过 5 万者
  • 长程项目协作者:单次会话持续数天、涉及多轮复杂决策的场景
  • 性能敏感用户:会话响应延迟明显时的主动优化
  • 技术型用户:能理解 bash 脚本、愿意审查代码的安全意识用户

常规风险与缓解

| 风险 | 缓解措施 |
|------|---------|

误删会话 | 自动备份至 memory/compressed/,支持手动恢复 |

| 摘要信息丢失 | 先执行 `summarize` 预览,确认质量后再 `--replace` |
| 依赖缺失 | 脚本内置 `jq` 和 `clawdbot` 检查,缺失时提示安装 |
| 来源不可信 | 代码 961 行全开放,经 CLS-Certify 静态+动态审计 |

认证亮点

  • 静态分析 95 分set -euo pipefail 安全模式,无 eval/exec/system
  • 动态分析 90 分:文件操作限定于 ~/.clawdbot/ 和用户可控目录
  • 网络 100 分:零外部 HTTP 请求,纯本地工具
  • 隐私 90 分:数据零外泄,摘要本地存储

Smart Context Manager 内容

手动下载zip · 11.0 kB
compress.shtext/x-shellscript
请选择文件