升级时间范围: 从 commit fe4db49 到 6be2b85

本次升级为增量优化升级，主要聚焦于记忆检索增强、工具系统完善与架构精简。

主要架构变更

1. Telegram 适配层重构

• 重构 telegram/ 适配器模块边界，精简 ownership
• 合并 telegram app runtime 模块
• 提取 prompt 时间格式化辅助函数
• 优化 bot 消息格式

2. 上下文事件系统统一

• 移除: 旧的 system flow

• 新增: 统一的上下文事件持久化机制

  • 定时任务触发持久化到会话上下文
  • 工具调用结果持久化到 context window

核心功能增强

1. 记忆检索系统重构

新增多阶检索能力

• 向量辅助摘要召回 (vector-assisted summary recall): 当 FTS5 关键词结果稀疏时，补充向量召回的 summary 候选
• 混合语言 n-gram 回退 (mixed-language n-gram fallback): 当 query 含中文/日文/混合脚本时，自动切换到更稳健的 n-gram 搜索路径
• 加权融合 (weighted fusion): 对 summary 与 conversation 结果综合关键词与向量信号进行统一排序
• 可选 Rerank: 对粗排后的小规模候选做精排（可选配置）

新增搜索控制参数

• session-aware search targets: 支持指定只搜索当前会话或历史会话
• search_target="summaries" | "conversations" | "all": 指定搜索目标类型
• 新增 start_date / end_date 日期范围过滤
• 支持 role='user' 或 role='assistant' 角色过滤

排序信号增强

当前融合排序考量以下信号：

• keyword_origin: 关键词命中来源
• token_coverage: query token 在结果中的覆盖比例
• exact_match: 完整子串匹配
• lexical_overlap: 基于混合语言搜索单元的词法重叠度
• vector_similarity: 向量相似度
• recency: 时间新鲜度

2. 工具系统增强

新增内置工具

• Tool Trace: query_tool_history - 查询最近的工具执行历史
• File Send: 支持将生成的文件直接发送给当前用户

人机协作 (HITL)

• 新增危险操作人工批准机制 (/approve 命令)
• 危险 Shell 命令执行前需要用户确认

MCP 改进

• 启动时预热 MCP tool runtime
• 限制 MCP 响应长度，避免超长输出

3. Seele 长期记忆增强

• 新增 LLM-based memory compaction: 使用 LLM 对 seele 记忆进行压缩整理
• 新增 user location 到 Seele schema
• 优化 memorable_events 结构
• 修复 seele migration/repair 逻辑
• 保留摘要中的消息时间戳

4. 文件处理增强

• 支持使用文件 caption 生成合成 embedding
• 文件上传通过系统事件管道处理
• 优化消息中的代码块渲染

数据库结构变更

新增表/字段

• 上下文事件表 (context_events): 存储会话中的系统事件、定时任务触发、工具调用结果

启动方式变更

无变更，延续 v0.9.1 启动方式。

代码质量改进

重构

• 统一 async-first 内存检索流程
• 精简 Telegram adapter ownership
• 合并 telegram app runtime 模块
• 重构架构与模块边界

稳定性修复

• 修复 Telegram allowed_updates 序列化问题
• 修复 Telegram 启动循环与超时处理
• 修复 MCP tool call 丢失问题
• 修复审批流程阻塞问题
• 改进网络错误处理

优化

• 使用 XML 风格优化 prompts
• 优化 chat prompt
• 减少不必要消息
• 更好的代码块渲染

文档更新

新增/更新文档

• docs/SEARCH_EXAMPLES.md - 扩展搜索示例，包含混合语言搜索与排序规则说明
• AGENTS.md - 扩展 async-first 重构指南

总结

本次升级是一次增量优化升级，主要变化包括：

1. 记忆检索大幅增强: 向量辅助召回、混合语言支持、加权融合、可选 rerank
2. 工具系统完善: 新增 tool trace、file send、HITL 审批机制
3. Seele 记忆增强: LLM compaction、位置信息、事件结构优化
4. 架构精简: 统一上下文事件系统、精简 adapter ownership
5. 稳定性提升: 多个 bug 修复与网络处理改进

这些改进使 Seelenmaschine 在记忆检索的准确性与灵活性方面有显著提升，同时增强了工具系统的可用性与安全性。