proxycast/docs/iteration-notes/p0-context-management-implementation.md

P0: 上下文管理升级实施文档

当前状态分析

代码结构

1. session_context_service.rs (src-tauri/crates/services/src/)

   • 负责 general 模式的上下文管理
   • 使用本地关键词提取生成摘要（第 355-463 行）
   • 支持配置：max_messages、max_characters、summary_threshold

2. SessionConfigBuilder (src-tauri/crates/agent/src/aster_state_support.rs)

   • 用于构建 aster Agent 的会话配置
   • 当前字段：id、max_turns、system_prompt、include_context_trace
   • 缺少上下文压缩相关配置

3. AsterAgentWrapper (src-tauri/src/agent/aster_agent.rs)

   • 在第 48-50 行创建 SessionConfig
   • 只设置了 include_context_trace(true)

问题识别

1. 双轨制：

   • general 模式使用 session_context_service.rs
   • agent 模式使用 aster 框架
   • 两者的上下文管理策略不统一

2. 摘要质量差：

   • session_context_service.rs 使用硬编码关键词匹配
   • 无法理解语义，摘要质量低

3. aster 能力未接入：

   • 不清楚 aster 框架是否内置上下文压缩
   • SessionConfig 未暴露相关配置

实施策略

策略 A：利用 aster 内置能力（优先）

前提：aster 框架已内置上下文压缩和 AI 摘要

步骤：

1. 研究 aster 框架文档，确认内置能力
2. 扩展 SessionConfigBuilder，暴露配置接口
3. 在 AsterAgentWrapper 中配置上下文压缩参数
4. 将 general 模式迁移到 aster 框架（与 P1 任务关联）

优点：

• 复用 aster 的成熟实现
• 统一 agent 和 general 模式的上下文管理
• 减少维护成本

缺点：

• 依赖 aster 框架的能力
• 需要等待 P1 任务完成（general 模式迁移）

策略 B：在 Lime 层实现（备选）

前提：aster 框架不支持或支持不足

步骤：

1. 改造 session_context_service.rs，实现 AI 摘要
2. 创建 LLM Provider 抽象，调用 AI 模型生成摘要
3. 实现渐进式工具响应移除策略
4. 为 aster Agent 创建类似的上下文管理服务

优点：

• 完全可控，不依赖外部框架
• 可以针对 Lime 的场景优化

缺点：

• 需要自己实现和维护
• 代码量大，开发周期长
• 可能与 aster 框架的内置能力冲突

下一步行动

立即执行

1. 研究 aster 框架：

   • 查看 aster-rust GitHub 仓库文档
   • 搜索 context、compression、summary 相关代码
   • 确认是否有内置的上下文压缩能力

2. 决策路径：

   • 如果 aster 有内置能力 → 采用策略 A
   • 如果 aster 没有或不足 → 采用策略 B

待确认问题

1. aster 框架的 SessionConfig 支持哪些字段？
2. aster 是否有 context_mgmt 模块？（研究报告提到）
3. aster 的 AI 摘要是如何实现的？
4. aster 的渐进式工具响应移除是如何配置的？

验证计划

单元测试

• 测试 AI 摘要生成逻辑
• 测试摘要缓存机制
• 测试降级到本地摘要的逻辑

集成测试

• 发起 20+ 轮长对话
• 验证 AI 摘要在 80% token 使用率时触发
• 对比 AI 摘要与本地摘要的质量
• 验证工具响应的渐进式移除

性能测试

• 测试摘要生成的延迟
• 评估 API 调用成本
• 测试缓存命中率

风险与缓解

风险 1：aster 框架能力不足

缓解：准备策略 B 作为备选方案

风险 2：AI 摘要成本过高

缓解：

• 实现智能缓存策略
• 提供本地摘要作为降级方案
• 允许用户配置是否启用 AI 摘要

风险 3：与 P1 任务的依赖关系

缓解：

• P0 和 P1 可以并行推进
• P0 先在 agent 模式验证，P1 完成后再统一

参考资料

• 研究报告：Lime AI Agent 改进研究报告
• 当前内置路径：src-tauri/crates/aster-rust/
• 相关文件：
  • src-tauri/crates/services/src/session_context_service.rs
  • src-tauri/crates/agent/src/aster_state_support.rs
  • src-tauri/src/agent/aster_agent.rs