stratagate-dsh 0.2.97 → 0.3.0

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## 0.3.0 - Unreleased
+
+- 将同名总览归为同一节：`.0` 保留各段独立来源的总览，`.1~N` 按来源去重并集分页；节身份不随新段落变化，浏览不写库、不增加模型调用。
+- 小节按来源在章节成员中的最早位置排序，同位置由稳定节身份决定；模型把新总览放在前面时，已有小节编号仍保留，新事件形成的节追加。
+- 将主题明确为长期大章节，章内支持具名小节；候选匹配结合有界成员线索，同名候选复用，避免按单个子功能或事件不断建章。
+- 升级第 3 代主题整理器：节按长期类别归纳，同类缺陷、版本与处理状态进入同一节；第 2 代目录按历史额度重新整理，保留有效章的 ID、名称、成员顺序与创建时间，事件事实及全库预算不变。第 1 代碎章及无效旧派生语言仍退休。
+- 增加失败历史批次的定向“重新整理”入口，校验来源及目录版本，排队为新的有限重试周期；重启继续、重复点击不重复排队，仍遵守每 10 分钟最多 2 批的历史额度。
+
+- 升级长期记忆机制：默认提供精简的主题目录，支持按需展开主题概览，并通过 `memory_list_topics`、`memory_expand_topic` 和 `memory_search_events(topic_id)` 导航到真实事件。
+- 主题与概览是可重建的导航层，事实依据仍来自 Event 与原始消息；浏览目录不产生证据批次，也不强化记忆，实际使用仍经过原有证据评估与采用流程。
+- 兼容旧 schema-12 数据库。首次 writer 打开时冻结已有事件作为历史初始化集合，新命名空间立即完成空初始化；此后新增事件独立按增量整理，只读打开不迁移或写库。
+- 历史整理按批进行，全库共享每 10 分钟最多 2 个历史任务的持久预算；新增事件优先，重启后继续未完成历史任务，已完成批次不重复处理。
+- 校验所有生成来源的版本，来源修改、遗忘或归档后立即隐藏过期派生内容并拒绝迟到结果；稳定复用主题 ID，限制失败重试，避免失效主题或失败任务形成重复模型调用。
+
 ## 0.2.97 - 2026-10-05
 
 - 修复 #107：显式检索批次须在最终回答前完成证据评估与 `memory_record_use`；遗漏时先完成收尾，再生成完整用户答案，避免内部批次状态成为最后一条回答。

package/README.zh-CN.md

@@ -91,6 +91,8 @@ DSH_HOME/stratagate/memory.db
 
 自动召回目前最多带入 4 条 Event 和 4 个图谱节点，总预算约 900 tokens。当前会话另由分层 Block 和尚未封存的对话提供。
 
+同时提供约 400 词元的记忆目录，说明当前空间记过哪些主题；大目录可分类分页浏览。Agent 按需展开有来源的主题概览，再检索真实事件取证。主题在后台用已有事件分批整理，查看目录不调用模型、不强化记忆。→ [记忆目录与主题整合](docs/MEMORY_TOPICS.zh-CN.md)
+
 ## 核心设计
 
 | 机制 | 变化的内容 | 保留的内容 |