stratagate-dsh 0.3.42 → 0.3.43

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.zh-CN.md CHANGED
@@ -8,7 +8,7 @@
8
8
 
9
9
  ### 近期对话保留细节,远期记忆逐渐简化。
10
10
 
11
- StrataGate 是 DeepSeek Harness 的跨会话记忆插件。近期对话保留细节,较早对话逐渐简化,需要时可以找回原文;重要信息整理为长期事件,知识图谱表达当前状态,主题目录帮助 Agent 了解记过哪些内容,并按需查找来源。
11
+ StrataGate 是 DeepSeek Harness 的跨会话记忆插件。每日笔记帮助接续近期工作,分层会话保留可展开的历史细节,长期事件与主题目录保存重要信息并帮助查找来源。知识图谱、向量检索和结果精排可按需启用。
12
12
 
13
13
  <p align="center">
14
14
  <a href="https://github.com/diqierjia/StrataGate-AgentMemory/actions/workflows/ci.yml"><img src="https://github.com/diqierjia/StrataGate-AgentMemory/actions/workflows/ci.yml/badge.svg" alt="CI" /></a>
@@ -55,33 +55,35 @@ StrataGate 是 DeepSeek Harness 的跨会话记忆插件。近期对话保留细
55
55
 
56
56
  ## 为什么选择 StrataGate?
57
57
 
58
- 1. **会话记忆:随对话推进逐渐模糊,需要时重新展开。**
58
+ 1. **近期工作有笔记,历史对话可展开。**
59
59
 
60
- (1) **近期详细,远期简略。** 同一段对话保存为 L0–L5 六种详细程度的视图。随着后续对话积累,较早的记忆逐渐从完整对话变为关键事实、简短摘要和标题索引,减少历史内容对上下文的占用。→ [分层记忆](#layered-memory)
60
+ (1) **每日笔记接续工作。** Agent 按天记录进展、阶段结果、有效失败经验、阻塞和下一步。新会话默认带入最近三个有笔记日期的内容,减少重复交代背景。 → [每日笔记](#daily-notes)
61
61
 
62
- (2) **展示变简,原始记录保留。** 完整的 L5 原始消息与工具记录始终保存。需要核对细节时,Agent 可以按需展开,找回当时的原话和上下文。→ [分层记忆](#layered-memory)
62
+ (2) **会话记忆近期详细,远期简略。** 同一段对话保存为 L0–L5 六种详细程度的视图。随着后续对话积累,较早对话逐渐变为关键事实、简短摘要和标题索引,减少历史内容对上下文的占用。→ [分层会话记忆](#layered-memory)
63
+
64
+ (3) **展示变简,原始记录保留。** 完整的 L5 原始消息与工具记录仍然保存。需要核对细节时,Agent 可以按需展开,找回当时的原话和上下文。→ [分层会话记忆](#layered-memory)
63
65
 
64
66
  ![会话记忆动画:Block 从 L5 逐渐简化到 L0,留在上下文中,并在需要时展开](docs/assets/short-term-memory-explainer-zh.gif)
65
67
 
66
- 2. **长期记忆:事件保留历史,图谱整理现状,主题目录帮助查找。**
68
+ 2. **长期记忆保留重要信息,帮助查找来源和追溯变化。**
67
69
 
68
- (1) **事件记录“发生过什么”。** 对话中的重要决定、偏好、要求和变化会被提取为 Event,保留来源,并区分“什么时候提到”和“什么时候发生”,供后续会话查找和追溯。→ [事件卡](#event-cards)
70
+ (1) **事件记录“发生过什么”。** 重要决定、偏好、要求和变化会被整理为 Event,保留适用范围、时间和来源。重复候选由 AI 判断,难以确定的内容可交给用户复核,处理历史可以追溯。→ [事件记忆](#event-cards)
69
71
 
70
- (2) **知识图谱表达“当前是什么状态”。** 根据历史事件,整理人物、项目、组织、工具和地点的当前信息及关系。新事件可以补充或取代旧状态,历史事件及其来源仍然保留。→ [当前状态图谱](#current-state-graph)
72
+ (2) **主题目录说明“记过哪些内容”。** 相关事件整理为章节、小节和带来源的概览。Agent 可以先浏览主题,再查找具体事件;用户也可以启动 Dreaming,让专门的 Agent 检查和整理已有目录。→ [主题目录](#memory-topics)
71
73
 
72
- (3) **主题目录说明“记过哪些内容”。** 相关事件按长期主题整理为章节和小节。Agent 可以先查看目录,再按需展开主题概览,了解背景、决定、变化和待确认事项,并沿来源查找具体事件。→ [记忆目录与主题概览](docs/MEMORY_TOPICS.zh-CN.md)
74
+ (3) **知识图谱按需整理当前状态。** 开启后,图谱根据事件整理人物、项目、工具等实体的当前信息与关系,并保留来源。图谱默认关闭,不影响事件卡、主题目录和普通检索的使用。→ [当前状态图谱](#current-state-graph)
73
75
 
74
- (4) **长期权重也会衰减。** 随着对话推进,未被采用的记忆权重逐渐降低,影响检索与自动召回时的优先级;衰减后的记忆仍保留来源,可继续查证。→ [权重与采用强化](#use-only-reinforcement)
76
+ (4) **检索方式可以按需增强。** 默认使用关键词等检索机制;配置向量模型后,可以补充语义相近的事件。还可单独配置精排模型,调整自动召回结果的顺序。
75
77
 
76
- (5) **支持迁移其他 AI 的记忆。** 导入内容可以转换为可追溯的事件,并用于更新知识图谱;原始导入内容仍会保留。→ [外部记忆导入](#external-memory-import)
78
+ (5) **支持迁移其他 AI 的记忆。** 导入内容可以整理为可追溯的长期事件,原始导入内容仍会保留。→ [外部记忆导入](#external-memory-import)
77
79
 
78
80
  3. **证据门:回答前先检查检索到的证据是否够用。**
79
81
 
80
- 主题概览帮助定位内容,实际回答需要核对来源事件或原始记录。搜索结果相关,不代表足以回答当前问题。Agent 会判断证据是否充分;不足时继续搜索或展开,仍无法确认时明确说明不确定性。→ [证据门](#evidence-gate)
82
+ 每日笔记帮助接续工作,主题概览帮助定位内容;需要核实历史事实时,继续查找来源事件或原始记录。搜索结果相关,不代表足以回答当前问题。Agent 会判断证据是否充分,不足时继续搜索或展开,仍无法确认时明确说明不确定性。→ [证据门](#evidence-gate)
81
83
 
82
84
  4. **检索命中不会自动强化记忆。**
83
85
 
84
- 搜索命中、自动带入上下文和浏览主题目录都不会触发强化。在检索后的采用流程中,被记录为最终答案实际采用的 Event 才会增加采用计数、更新衰减起点;采用越多,之后衰减越慢。主动保存记忆时,确认重复的信息也可强化已有记录。→ [权重与采用强化](#use-only-reinforcement)
86
+ 搜索命中、自动带入上下文和浏览主题目录都不会触发强化。在检索后的采用流程中,只有被记录为最终答案实际采用的 Event,才会增加采用计数、更新衰减起点;采用越多,之后衰减越慢。主动保存记忆时,确认与已有有效事实完全重复的信息,也可强化已有记录。→ [权重与采用强化](#use-only-reinforcement)
85
87
 
86
88
  开始使用:→ [快速开始](#quick-start-deepseek-harness)
87
89
 
@@ -89,80 +91,97 @@ StrataGate 是 DeepSeek Harness 的跨会话记忆插件。近期对话保留细
89
91
 
90
92
  ## 快速开始:DeepSeek Harness
91
93
 
92
- 如果已经安装 DeepSeek Harness,请将 StrataGate 添加到你正在使用的 profile:
94
+ 已安装 DeepSeek Harness?可复制下面的提示词交给 Agent 安装:
93
95
 
94
- ```bash
95
- dsh plugin --profile web add stratagate-dsh
96
+ ```text
97
+ 请根据 https://github.com/diqierjia/StrataGate-AgentMemory/blob/main/docs/DSH.zh-CN.md,为我当前使用的 DeepSeek Harness profile 安装 StrataGate,检查版本兼容性并验证插件是否加载成功;需要重启或无法确定 profile 时请提示我。
96
98
  ```
97
99
 
98
- 支持的 DSH 版本为 `0.1.2-rc.1 || >=0.1.5-rc.1 <0.3.0-0`,覆盖完整的 `0.2.x` 版本族及其预发布版。关键宿主接口验证完成前,不支持 DSH `0.3.x`。
100
+ 也可以手动安装(将 `web` 替换为你使用的 profile 名称):
99
101
 
100
- 重启该 profile,之后照常使用 DSH 即可。StrataGate 会自动记录主 Agent 已完成的对话,在后台生成可搜索的记忆,并在 **DSH 设置 → StrataGate-AgentMemory** 中提供记忆界面。
101
-
102
- 数据库默认保存在:
103
-
104
- ```text
105
- DSH_HOME/stratagate/memory.db
102
+ ```bash
103
+ dsh plugin --profile web add stratagate-dsh
106
104
  ```
107
105
 
108
- 移除插件不会删除数据库。截图、配置项、记忆工具和自动记录规则见 [DeepSeek Harness 插件中文说明](docs/DSH.zh-CN.md)。
106
+ 重启对应 profile 后即可使用,插件会自动记录对话并整理记忆。查看记忆:**DSH 设置 → StrataGate-AgentMemory**。
109
107
 
110
- 上面的命令使用 `web` profile;如果使用其他 profile,请替换 `web`。开发者可直接查看[开发与文档](#code-entry-points)。
108
+ 配置、兼容版本和故障处理见[插件使用说明](docs/DSH.zh-CN.md)。
111
109
 
112
110
  <a id="how-stratagate-works"></a>
113
111
 
114
112
  ## 它如何工作
115
113
 
116
- ![图 1:StrataGate 整体处理流程——分层对话、事件、图谱与主题目录,以及检索和证据检查](docs/assets/stratagate-memory-workflow-zh-v030.jpg)
117
-
118
- 图中展示的是答案采用后的 Event 强化流程;主动保存重复信息也可强化已有 Event。Block 展开改变的是展示层,目录与概览本身不作为强化证据。常驻画像单独提供,见[常驻画像说明](#persistent-profile)。
114
+ ![图 1:StrataGate 整体流程——记忆形成、默认上下文、按需检索、证据评估和采用记录](docs/assets/stratagate-memory-workflow-zh-v2.png)
119
115
 
120
- 1. **保存对话。** 若干轮连续对话组成一个记忆块(Block),保存为从索引到原文的六种视图。旧 Block 默认展示的内容随对话推进逐渐变简,需要细节时可以重新展开。
121
- 2. **整理长期信息。** 有后续用途的事实、决定、偏好和要求被提取为事件(Event),保留时间、适用范围与来源。知识图谱据此整理当前状态,主题目录与概览把相关事件组织为章节和小节。
122
- 3. **回答时找回。** 插件默认提供当前对话、已设置的常驻画像、少量相关记忆和简短主题目录。信息不足时,Agent 可直接搜索事件、图谱或原文,也可先浏览目录、展开概览,再查找来源事件。
123
- 4. **检查证据并记录采用。** Agent 判断显式检索到的证据是否足以回答;不足时继续检索或展开,充分时据此回答,并记录实际采用的 Event,用于更新长期权重。
116
+ StrataGate 一边保存对话来源,一边整理近期工作与长期信息;回答时先使用已有上下文,缺少细节再检索。
124
117
 
125
- 自动召回最多带入 **4 条 Event 和 4 个图谱节点**,预算约 **900 tokens**;主题目录另有约 **400 tokens** 的预算,内容较多时提供分类和分页入口。常驻画像、分层 Block 和尚未封存的对话分别提供,不包含在上述两项预算中。
118
+ 1. **保存会话,保留原文。** 已完成的对话组成记忆块(Block),保存为 L0–L5 六种详细程度的视图。旧 Block 默认展示逐渐变简,需要时可以重新展开;完整原始记录仍然保留。
119
+ 2. **维护每日笔记,接续近期工作。** Agent 按需记录进展、阶段结果、有效失败经验、阻塞和下一步,每个记忆空间每天一份 Markdown。新会话默认带入最近三个有笔记日期的内容,帮助继续之前的工作。
120
+ 3. **整理长期信息,建立查找入口。** 有后续用途的事实、决定、偏好和要求被提取为事件(Event),保留时间、适用范围和来源。主题目录把相关事件组织为章节、小节和概览;开启知识图谱后,再根据事件整理当前状态与关系。
121
+ 4. **回答时使用上下文,按需补充细节。** 插件提供当前会话、已设置的常驻画像、近期笔记、少量相关记忆和简短主题目录。已有信息足够时直接回答;不足时,Agent 可以搜索事件或原文,也可以先浏览主题,再沿来源查找。开启图谱后,还可检索实体与关系。
122
+ 5. **核对证据,记录实际采用。** 对显式检索得到的证据,Agent 判断是否足以回答;不足时继续查找,充分时据此回答,并记录实际采用的 Event,用于更新记忆权重。仅搜索、浏览目录或读取笔记不会触发强化。
126
123
 
127
- 目录和概览在后台用已有事件分批整理。读取已有目录或概览本身不调用模型、不生成证据批次,也不强化记忆。→ [记忆目录与主题概览](docs/MEMORY_TOPICS.zh-CN.md)
124
+ 自动召回最多带入 **4 条 Event**;开启图谱后,还可带入最多 **4 个图谱节点**,共享约 **900 tokens** 的预算。主题目录另有约 **400 tokens** 的预算;每日笔记、常驻画像、分层会话和尚未封存的对话分别提供。
128
125
 
129
126
  ## 核心设计
130
127
 
131
- | 机制 | 变化的内容 | 保留的内容 |
128
+ 不同类型的记忆分别解决不同问题:
129
+
130
+ | 组成 | 保存什么 | 主要用途 |
132
131
  | --- | --- | --- |
133
- | 会话记忆简化 | 旧 Block 默认使用哪个 L0–L5 视图 | L5 原始对话与工具记录 |
134
- | 长期权重衰减 | Event 在后续召回中的优先级 | Event 历史及其来源 |
132
+ | **每日笔记** | 近期进展、结果、阻塞和下一步 | 新会话接续工作 |
133
+ | **会话记忆 Block** | 同一段对话从索引到原文的六层视图 | 减少默认历史内容,需要时找回细节 |
134
+ | **事件记忆 Event** | 有后续用途的信息及其时间、范围和来源 | 查找事实、决定与历史变化 |
135
+ | **主题目录 Topic** | 相关事件的章节、小节和带来源概览 | 从大概印象找到具体记忆 |
136
+ | **知识图谱 Graph(可选)** | 根据事件整理的当前状态和实体关系 | 查询当前情况及关联信息 |
137
+ | **常驻画像 Profile** | 每次对话都需要参考的用户信息 | 持续提供语言、称呼等已设置偏好 |
138
+
139
+ 每日笔记由 Agent 维护,Graph 和 Topic 从 Event 派生,Profile 单独保存。会话记忆的简化和 Event 的权重衰减都随对话进度推进,不按现实中经过的天数计算。
140
+
141
+ <a id="daily-notes"></a>
142
+
143
+ ### 1. 短期记忆:用每日笔记接续工作
144
+
145
+ Agent 按需把工作进展、阶段结果、有效失败经验、阻塞和下一步写成每日笔记。每个记忆空间每天保存一份 Markdown,帮助新会话快速了解“之前做到哪里,接下来做什么”。
146
+
147
+ 例如,一份项目笔记可以记录:
135
148
 
136
- 两者都随对话进度变化:短期按就绪 Block 距离计算,长期按对话轮次计算。放置几天本身不会触发这两种衰减。
149
+ ```text
150
+ 项目 X:依赖迁移
151
+
152
+ 已完成:项目改用 pnpm。
153
+ 待确认:迁移后的 CI 是否通过。
154
+ 下一步:运行 CI,检查构建与测试结果。
155
+ ```
156
+
157
+ **新会话默认参考近期笔记。** 默认带入最近三个有笔记日期的内容,可以在设置中调整为 1–30;更早的笔记仍可按日期或关键词查找。每个会话首次加载时固定一份笔记快照,后续写入不会反复改变这份上下文,需要时可重新读取最新内容。
137
158
 
138
- ### 短期记忆:最近三天的工作笔记
159
+ **笔记用于接续工作,历史事实仍可查证。** 笔记由 Agent 维护,不是完整对话记录。需要核实某项决定、时间或原因时,继续检索事件和原始消息;读取笔记不会触发记忆强化。
139
160
 
140
- Agent 自己维护工作进展、阶段结果、有效失败经验、阻塞和下一步,每个记忆空间每天一份 Markdown。最近三个有笔记的日期会注入新会话;可在“短期记忆”页只读查看近期及更早笔记。文件位于 `<数据库所在目录>/daily/<namespace 安全编码>/YYYY-MM-DD.md`(当前安全编码为 `ns-` 加 namespace 的 SHA-256 小写十六进制)。设置 `dailyNotesEnabled: false` 可关闭写入和注入,已有笔记保留。
161
+ 可在 **DSH 设置 → StrataGate-AgentMemory → 短期记忆** 中查看笔记。关闭每日笔记功能后,停止写入和自动带入,已有文件保留。
141
162
 
142
163
  <a id="layered-memory"></a>
143
164
 
144
- ### 1. 会话记忆:随对话推进逐渐简化,需要时重新展开
165
+ ### 2. 会话记忆:旧对话逐渐简化,需要时找回细节
145
166
 
146
- 近期讨论通常需要保留完整细节,较早的对话则可以先以简短形式留在上下文中。StrataGate 为同一段对话保存多种详细程度的视图,并随着后续对话积累,逐渐减少旧对话默认呈现的内容。
167
+ 每日笔记概括近期工作,会话记忆保留当时的讨论过程。StrataGate 为同一段对话保存多种详细程度的视图,随着后续对话积累,逐渐减少旧对话默认带入的内容。
147
168
 
148
- ![图 2:StrataGate 会话记忆——L0–L5 分层视图、展示衰减与按需展开](docs/assets/stratagate-short-term-memory-layers.png)
169
+ ![图 2:会话记忆——L0–L5 分层、展示简化、内容预览和应用所选层级](docs/assets/stratagate-conversation-memory-zh.png)
149
170
 
150
171
  **同一段对话,保存为六种详细程度。**
151
172
 
152
- DeepSeek Harness 插件默认每 **6 轮**完整对话封存一个 Block,一轮指一次用户提问和助手的完整回复。封块大小可以配置;核心库默认值为 12 轮。尚未达到边界的内容继续保留在当前对话中。
153
-
154
- 每个完成处理的 Block 包含以下视图:
173
+ DeepSeek Harness 插件默认每 **6 轮**完整对话封存一个记忆块(Block),一轮指一次用户提问和助手的完整回复。封块大小可以配置,尚未达到边界的内容继续保留在当前对话中。
155
174
 
156
175
  | 层级 | 保存的内容 | 主要用途 |
157
176
  | --- | --- | --- |
158
- | L0 | 标题和标签 | 用最少内容标识这段历史 |
159
- | L1 | 简短摘要 | 快速了解讨论主题 |
160
- | L2 | 关键事实 | 查看决定、约束、计划和结果 |
161
- | L3 | 确定性精简对话 | 删除固定白名单中的独立寒暄或确认;重复的长段落与代码只保留第一次;工具调用保留名称和结果摘要 |
162
- | L4 | 去除内部记录的近原文对话 | 过滤 system 消息;用户和助手正文只裁剪首尾空白并添加角色标签;可识别的工具记录保留名称和结果摘要 |
163
- | L5 | 原始消息与工具记录 | 查证来源及具体细节 |
177
+ | **L0** | 标题和标签 | 标识这段历史 |
178
+ | **L1** | 简短摘要 | 快速了解讨论主题 |
179
+ | **L2** | 关键事实 | 查看决定、约束、计划和结果 |
180
+ | **L3** | 按固定规则精简的对话 | 删除独立寒暄和重复长文本,精简工具记录 |
181
+ | **L4** | 接近原文的可读对话 | 保留用户和助手原话,精简可识别的工具记录 |
182
+ | **L5** | 原始消息与工具记录 | 核对原话、完整上下文和工具结果 |
164
183
 
165
- L0–L2 由模型概括;L3/L4 由固定规则生成:L3 删除独立寒暄和重复长文本,L4 则尽量保留原话;两者都会精简可识别的工具记录。具体规则见下方。短期衰减按后续就绪 Block 的数量推进,不按现实中经过的天数计算。
184
+ L0–L2 由模型概括;L3/L4 由固定规则生成。L3 会进一步删除冗余内容,L4 尽量保留原话。**这些视图都不会覆盖 L5 原始记录。**
166
185
 
167
186
  <details>
168
187
  <summary>具体精简规则、衰减公式与层级阈值</summary>
@@ -175,8 +194,6 @@ L0–L2 由模型概括生成;L3、L4 不调用模型改写,而是由程序
175
194
 
176
195
  原始记录先保存,摘要和事件处理随后进行。只有处理完成、进入就绪状态的 Block,才会替换对应的原生历史并参与衰减。
177
196
 
178
- **后续对话越多,旧 Block 默认展示得越简略。**
179
-
180
197
  Block 的展示变化由指数衰减控制:
181
198
 
182
199
  <p align="center"><strong>w<sub>block</sub>(age) = e<sup>−λ<sub>block</sub> · age</sup></strong></p>
@@ -200,98 +217,123 @@ Block 的展示变化由指数衰减控制:
200
217
 
201
218
  </details>
202
219
 
203
- **需要细节时,可以重新展开。**
220
+ **后续对话越多,旧 Block 默认展示得越简略。**
204
221
 
205
- 假设某段旧对话目前只显示:
222
+ 会话记忆按后续就绪 Block 的数量推进简化,不按现实中经过的天数计算。衰减参数决定详细内容保留多久,可以在设置中调整。
206
223
 
207
- > 讨论了项目技术方案与近期计划。
224
+ **需要细节时,Agent 可以展开来源,用户也可以手动选择。**
208
225
 
209
- 用户追问“当初为什么选择 pnpm”,Agent 可以展开关键事实、精简对话或完整原始记录,找到当时的原因。
226
+ 例如,旧对话目前只显示“讨论了项目技术方案”。用户追问“当初为什么选择 pnpm”,Agent 可以读取更详细的对话或原始记录,查找当时的理由。
210
227
 
211
- 展开既可以逐级进行,也可以直接指定更详细的层级。展开后,系统会以此次选定的层级和当前 Block 位置重新设置衰减起点;随着后续对话继续积累,它再逐渐变简。
228
+ 界面中的“分层内容预览”只用于查看;点击“让助手参考 L4”等按钮后,才会尝试把所选内容应用到会话。界面会区分已经生效、等待生效和无法应用的情况。
212
229
 
213
- 因此,旧对话日常可以保持轻量,需要时仍能恢复细节。**L0–L4 都是原始记录的派生视图,不会覆盖 L5。**
230
+ 用户手动选择的层级优先于自动压缩和 Agent 的证据读取。上下文放不下时,系统会先尝试简化其他自动管理的历史,保留其他手动选择;仍然不足时说明原因。手动选择会重设衰减起点,随着后续对话积累,仍可继续逐渐变简。
214
231
 
215
232
  <a id="event-cards"></a>
216
233
 
217
- ### 2. 长期记忆:事件保留历史,图谱整理现状,主题目录帮助查找
234
+ ### 3. 长期记忆:保留重要信息,查找来源与历史变化
218
235
 
219
- 会话记忆保留讨论上下文,长期记忆把有后续用途的信息整理出来。下面用项目从 npm 改用 pnpm 的示例,说明三种视图如何分工:
236
+ 长期记忆把有后续用途的信息整理为事件(Event),再通过主题目录帮助查找。知识图谱可按需开启,用于整理当前状态与关系;常驻画像 Profile 单独保存,为每次对话提供已设置的用户信息。
220
237
 
221
- ![图 3:长期记忆——Event 保留选型历史,Graph 展示当前使用 pnpm 和 CI 待验证的状态,Topic 整理主题脉络并链接来源](docs/assets/stratagate-long-term-memory-views-zh.png)
238
+ ![图 3:长期记忆——Event 保留历史、Topic 提供来源与 Dreaming 整理、可选 Graph 展示现状](docs/assets/stratagate-long-term-memory-views-zh-v2.png)
222
239
 
223
- **Event 记录发生过什么,Graph 整理当前状态,Topic 提供主题脉络和查找入口。** Graph 和 Topic 都从已有 Event 派生;具体结论仍需核对来源事件或原始记录。图中数据仅为示例。
240
+ 图中数据为示例,图谱部分表示开启后的功能。
224
241
 
225
- **事件记录发生过什么,并保留时间和来源。**
242
+ #### 3.1 事件记忆:记住有后续用途的信息
226
243
 
227
- 同一个 Block 可以产生多条 Event,也可以没有需要提取的信息。每条事件保留内容、适用范围、来源 Block 和消息,以及能够确定的时间信息。
244
+ 重要事实、决定、偏好、要求和变化可以保存为 Event。每条事件保留内容、适用范围、来源消息,以及能够确定的时间信息。同一个 Block 可以产生多条事件,也可以没有需要提取的内容。
228
245
 
229
246
  | 时间 | 表示什么 |
230
247
  | --- | --- |
231
248
  | 提及时间 | 这件事什么时候在对话中被说到 |
232
249
  | 发生时间 | 事情实际发生或计划发生的时间 |
233
250
 
234
- 例如,用户在 5 月 6 日说“下周完成原型”,5 月 6 日是提及时间,“下周”描述的是计划完成时间。这条记录应保留计划性质,不能当作“原型已经完成”的证据。无法确定的时间保留原始表达和不确定性。
251
+ 例如,用户在 5 月 6 日说“下周完成原型”,5 月 6 日是提及时间,“下周”描述计划完成时间。这条记录不能当作“原型已经完成”的证据;无法确定的时间保留原始表达和不确定性。
235
252
 
236
- **新版提取规则更重视有后续用途的用户信息。**
253
+ **保存有用的信息,而不是逐项记录执行步骤。** 用户的明确要求、纠正和改变决定,以及已确认的根因、平台限制、失败条件和重要结果,都可能值得保留。普通读文件、运行工具和重复测试不会仅因发生过就各自生成事件。
237
254
 
238
- 用户的明确要求、纠正、评价和改变决定,只要具有独立用途,就可以成为事件候选;普通的读文件、运行工具和重复测试不会仅因发生过就逐项记录。已经确认的根因、平台限制、失败条件和重要结果仍可保留。
255
+ 记录也需要区分适用范围。例如,“这张图的箭头要对齐”属于当前任务,不能自动扩大成永久审美偏好。Agent 还可通过主动记忆工具保存值得以后想起的信息,不必等待对话封块。
239
256
 
240
- 提取时需要明确适用范围:单次答复要求保留在会话范围,项目要求属于项目,稳定的用户信息或明确的长期指导才使用用户范围。例如,“这张图的箭头要对齐”不能自动扩大成永久审美偏好。范围缺失或不合法时,程序会有限重试,仍无法得到合法结果就不写入该次提取结果。
257
+ 具体判断规则见[事件提取说明](docs/event-extractor.md)。
241
258
 
242
- 新规则用于升级后的正常提取,不会重放旧对话或统一改写已有事件。具体判断规则见[事件提取说明](docs/event-extractor.md)。
259
+ #### 3.2 记忆更新:区分补充、变化、冲突和重复
243
260
 
244
- **新事件补充、取代或标记冲突,历史仍可追溯。**
261
+ 新信息可能带来不同的更新:
245
262
 
246
- 项目先决定“使用 npm”,后来改为“使用 pnpm”,旧决定保留为历史,新事件更新当前选择。“迁移后的 CI 待验证”则补充一项待确认事项,不改变包管理器。如果两种说法互相矛盾、又无法确定哪条有效,就保留冲突供后续核实。
263
+ | 新信息 | 如何理解 |
264
+ | --- | --- |
265
+ | “项目从 npm 改用 pnpm” | 更新当前选择,保留原来的决定及其来源 |
266
+ | “迁移后的 CI 待验证” | 补充待确认事项,不代表测试已经通过 |
267
+ | 两种说法矛盾,无法确定哪条有效 | 保留冲突,等待进一步核实 |
268
+ | 多条记录可能描述同一件事 | 检查完整内容与来源,再决定是否合并 |
269
+
270
+ **相似不等于重复,后续进展也不等于旧记录无用。** 程序发现重复候选后,由 AI 结合双方内容和来源判断;明确不同的事实可以同时保留,不确定或未完成的候选交给用户复核。
247
271
 
248
- 新事件不会覆盖旧事件的内容和来源,其有效状态和关系可以随新证据更新,便于回答“以前是什么样,后来发生了什么变化”。
272
+ 用户可以查看双方来源、编辑合并稿、保留其中一条或同时保留。处理过程保留历史,并提供撤销入口,便于追溯整理前后的变化。
249
273
 
250
274
  <a id="current-state-graph"></a>
251
275
 
252
- **知识图谱根据事件整理当前信息和关系。**
276
+ #### 3.3 知识图谱:按需了解当前状态和关系
253
277
 
254
- 图谱用节点表示人物、项目、组织、工具和地点,用关系表示“使用”“参与”“依赖”等联系,属性和关系都保留来源 Event。在上述例子中:
278
+ 知识图谱根据 Event 整理人物、项目、组织、工具和地点,以及“使用”“参与”“依赖”等关系。节点属性和关系保留来源,帮助回答“现在是什么情况”“这些事物有什么联系”。
255
279
 
256
- - 问“项目现在用什么”,可以先查当前图谱;
257
- - 问“什么时候改的”,可以查变更事件;
258
- - 问“为什么改”,可以展开事件并回查原始讨论。
280
+ 在示例中,“项目使用 pnpm”表示当前选择,“CI 待验证”表示尚未确认的结果;只有新的来源证据确认后,才更新相应状态。
259
281
 
260
- 图谱中的状态必须有来源支持。图中的“使用 pnpm”来自 Event ②,“CI 待验证”来自 Event ③;待验证不能当作已通过。只有新证据确认结果后,才更新相应状态。图谱更新失败时可以单独重试,已保存的事件和原文仍可查找。
282
+ **图谱默认关闭,其他记忆功能仍可使用。** 开启图谱会额外调用模型整理实体和关系。可以在 **更多 → 高级设置 → 记忆配置 → 启用知识图谱** 中操作;存在待补建的历史事件时,先显示处理数量,确认后开始。
283
+
284
+ 关闭图谱会停止相关处理、查询和自动召回,已有图谱数据及其来源保留。事件卡、主题目录、普通检索和常驻画像独立工作。
261
285
 
262
286
  <a id="memory-topics"></a>
263
287
 
264
- **主题目录帮助 Agent 知道有哪些记忆,再找到具体来源。**
288
+ #### 3.4 主题目录:从大概印象找到具体记忆
265
289
 
266
- 知道关键词时,可以直接检索;只记得大概聊过某件事时,可以先看目录。一个 Topic 对应长期章节,例如图中的“项目 X”;章内小节容纳持续相关的事项,例如“依赖与构建”。具体版本、bug 和处理进度放在小节内部,避免每次变化都新建章节。
290
+ 知道关键词时,可以直接检索;只记得“大概聊过某件事”时,可以先浏览主题目录。
267
291
 
268
- 目录提供主题名称和入口,按需展开的概览整理背景、进展、决定、变化和待确认问题,并保留事件来源。同名内容归入同一节,新增内容时尽量保持已有章节和小节的编号稳定。
292
+ 一个 Topic 对应持续存在的主题,例如“项目 X”;章内小节容纳“依赖与构建”等相关事项。按需展开的概览整理背景、进展、决定、变化和待确认问题,并链接来源事件。
269
293
 
270
- 例如,用户问“之前项目技术方案讨论到哪了”,Agent 可以先找到相应主题,查看概览,再检索来源事件,核对已经确定的方案、后续变更和待决定问题。
294
+ 例如,用户问“之前项目技术方案讨论到哪了”,Agent 可以先找到主题、查看概览,再查找具体事件,核对已确定的方案和待决定的问题。
271
295
 
272
- **概览用于导航,回答依据仍需从来源取得。** 浏览目录和概览不产生证据批次、不强化记忆;需要引用事实时,再检索事件或展开来源,并完成证据检查。目录未整理好时,普通事件、图谱和原文检索仍可使用。
296
+ **Dreaming 帮助整理已有目录。** 用户可以从目录页启动专门的 Agent,让它检查已有事件和概览,调整章节、小节、事件归属及概览内容。运行过程可以查看、暂停、继续或终止;已经保存的修改保留。
273
297
 
274
- 工具与后台整理细节见[记忆目录与主题整合](docs/MEMORY_TOPICS.zh-CN.md)。
298
+ Dreaming 整理的是目录与概览,不改写原始 Event 事实,也不因整理或读取而强化记忆。**目录帮助定位,具体事实仍需沿来源查证。**
275
299
 
276
300
  <a id="persistent-profile"></a>
277
301
 
278
- **常驻画像、长期事件和当前要求分别保存。**
302
+ #### 3.5 常驻画像:每次对话都需要知道的用户信息
303
+
304
+ 常驻画像保存需要持续参考的用户信息,与按相关性查找的事件、仅本次有效的要求分开:
279
305
 
280
306
  | 用户表达 | 保存位置 | 什么时候使用 |
281
307
  | --- | --- | --- |
282
308
  | “以后默认用中文回答” | 常驻画像 Profile | 设置后跨会话自动提供 |
283
309
  | “这个项目已经改用 pnpm” | 长期事件 Event | 在相关问题中召回或检索 |
284
- | “这次回答简短一点” | 当前对话 | 用于本次回答,无需写入长期记忆 |
310
+ | “这次回答简短一点” | 当前对话 | 用于本次回答 |
285
311
 
286
- “记住”一词本身不决定保存位置。明确的画像更新请求可以直接应用;由 Agent 推断的画像变化需要先说明拟修改的字段与内容,并取得用户同意。适合在相关情境中想起的信息,也可以通过主动记忆工具保存,不必等待对话封块。
312
+ “记住”一词本身不决定保存位置。用户明确要求修改画像时可以直接应用;由 Agent 推断的画像变化,需要先说明拟修改的字段与内容,并取得用户同意。
287
313
 
288
- 地点画像区分默认地点、常驻城市和当前城市。例如,常住哈尔滨、目前出差北京时,问天气会优先使用本次明确指定的地点;没有指定时参考当前城市,再参考默认地点。出差不会自动覆盖常驻城市,当前城市跨会话保留到用户修改或清空。使用说明见[插件指南](docs/DSH.zh-CN.md)。
314
+ 画像字段、地点选择和设置方式见[插件使用说明](docs/DSH.zh-CN.md)。
289
315
 
290
316
  <a id="evidence-gate"></a>
291
317
 
292
- ### 3. 证据门:检查检索结果是否足以回答当前问题
318
+ ### 4. 检索与证据门:找到相关内容,再确认是否足以回答
319
+
320
+ 已有上下文足够时,Agent 可以直接回答;需要历史信息时,再搜索事件、原始对话,或先浏览主题目录。开启知识图谱后,还可查找实体与关系。
321
+
322
+ **检索方式可以按需增强。**
323
+
324
+ | 方式 | 作用 |
325
+ | --- | --- |
326
+ | 默认检索 | 根据关键词等信息查找相关记录 |
327
+ | 向量检索(可选) | 补充说法不同、意思接近的事件 |
328
+ | 结果精排(可选) | 重新排列自动召回的候选,让更相关的记忆优先进入上下文 |
329
+
330
+ 向量检索与精排分别配置,未配置时不启用。精排只作用于自动召回,超时或出错时回退原顺序。**排序靠前、语义相似或权重较高,都不代表内容一定正确,也不代表足以回答当前问题。**
331
+
332
+ **没有搜到,不等于从未记录。**
293
333
 
294
- 找到相关记忆后,Agent 还需要判断它是否支持当前答案:证据够不够,还缺什么,应该直接回答还是继续查找。检索排序和记忆权重都不能当作事实正确率。
334
+ 空结果可能与当前记忆范围、关键词或筛选条件有关。Agent 应根据问题调整查找方式,不能仅凭一次空结果断言“你没有说过”。检索发生错误时,也应说明实际问题。
335
+
336
+ **证据门检查找到的内容是否回答了问题。**
295
337
 
296
338
  例如,用户问“为什么当初改用了 pnpm”:
297
339
 
@@ -299,13 +341,11 @@ Block 的展示变化由指数衰减控制:
299
341
  | --- | --- | --- |
300
342
  | 找到主题 | “项目技术选型”的概览提到换了包管理器 | 沿来源查找具体事件 |
301
343
  | 检索事件 | “项目已从 npm 改为 pnpm” | 只能确认变更,原因仍缺失,继续展开 |
302
- | 核对原文 | 示例原话:“安装更快,也更适合我们的多包结构” | 核对适用项目和时间后,按这段证据解释原因 |
344
+ | 核对原文 | 示例原话:“安装更快,也更适合我们的多包结构” | 核对项目和时间后,按来源解释原因 |
303
345
 
304
346
  这里的原话是演示用例。若来源没有说明原因,Agent 应明确无法确认,不能根据 pnpm 的一般优点推测当时的决定。
305
347
 
306
- 证据是否充分由模型判断,程序检查来源引用和检索流程。主题概览只提供导航线索;实际采用仍需来自经过检查的检索证据。已有上下文足以回答时,不必为了流程额外搜索。
307
-
308
- 显式检索批次在最终回答前需要完成证据评估和采用记录;未使用的批次也要记录为空采用。遗漏时,插件会先要求完成收尾,再生成完整的用户答案,避免以内部状态说明结束回复。模型仍可能误判证据,无法核实时应保留不确定性。
348
+ 证据是否充分由模型判断,程序检查来源引用和检索流程。显式检索结果需要完成证据评估,并记录实际采用的内容;没有采用的结果也需完成收尾。证据不足时继续查找,仍无法核实时说明不确定性。
309
349
 
310
350
  <details>
311
351
  <summary>证据评估字段与流程检查</summary>
@@ -324,33 +364,29 @@ Block 的展示变化由指数衰减控制:
324
364
 
325
365
  <a id="use-only-reinforcement"></a>
326
366
 
327
- ### 4. 检索命中不会自动强化记忆:采用越多,之后衰减越慢
367
+ ### 5. 记忆强化:检索不强化,实际采用后更新权重
328
368
 
329
- 长期记忆也会随对话推进而衰减。这里变化的是 Event 的权重,它参与后续召回和排序;与短期 Block 不同,Event 不会因此逐级切换 L0–L5 展示层。
369
+ Event 的权重参与后续召回和排序。未被采用时,权重随对话轮次逐渐降低,但事件及其来源仍然保留;这与会话 Block 的 L0–L5 展示简化是两种机制。
330
370
 
331
371
  ![图 4:StrataGate 长期记忆权重——自然衰减、仅检索不强化与采用后强化](docs/assets/stratagate-long-term-memory-weight.png)
332
372
 
333
- 未被用于答案的 Event 权重随对话轮次逐渐降低,可能影响后续召回的排序,但历史记录仍然保留。
373
+ **被搜索到或展示出来,不会触发强化。**
334
374
 
335
- **被搜索到,不会触发强化。**
375
+ 搜索命中、自动带入上下文、浏览目录、展开概览和读取每日笔记,都不会仅因内容出现而增加采用计数或重置衰减起点。
336
376
 
337
- 检索命中只说明一条记忆可能相关。系统可以记录它何时被检索,但不会因此增加采用计数,也不会重置衰减起点。
377
+ **实际用于回答的 Event 才获得本次采用强化。**
338
378
 
339
- 自动带入上下文、浏览主题目录和展开概览,同样不会因为内容被展示而强化记忆。这样可以避免某条记忆仅因偶然排在前面,就通过反复出现不断提高自身权重。
379
+ Agent 选定用于最终回答的证据后,提交采用记录。程序检查证据所属批次及评估结果,通过后增加对应 Event 的采用计数、更新衰减起点,并避免同一次操作重复执行。没有使用的结果不获得这次强化。
340
380
 
341
- **检索后的实际采用会更新权重。**
381
+ 采用次数越多,之后的衰减越慢,让持续帮助回答的记忆保持较高的召回优先级。
342
382
 
343
- Agent 确定用于最终回答的证据后,会提交采用回执。通过检查的 Event 增加采用计数,并把衰减起点更新到当前轮次。对于未被额外限制权重的普通活跃事件,此时权重回到 1。
383
+ **主动写入时,确认重复也可以强化已有事实。**
344
384
 
345
- 随着采用计数增加,公式中的衰减系数变小,同样经过一段对话后,它能保留更高的权重。因此,反复帮助回答的记忆会逐渐衰减得更慢。
385
+ 使用主动记忆工具保存信息时,规范化后全文一致的当前有效事实,可以直接强化已有记录。其他相似内容需要进一步判断,决定新增、合并、取代、标记冲突或忽略,不能仅凭文字相似直接强化。
346
386
 
347
- 采用依据来自 Agent 提交的证据选择。程序检查证据是否属于对应批次、是否经过充分性评估,并通过回执避免同一次操作被重复执行;没有使用的检索结果不获得这次强化。
387
+ 重复卡整理与回答采用也有区别:合并可以保留双方已有的采用信息,但不会把整理操作冒充一次新的回答采用。
348
388
 
349
- **主动保存重复信息,也可以强化已有记录。**
350
-
351
- 使用 `memory_remember` 主动保存信息时,程序确认与已有主动记忆完全或近似重复,可强化已有事件,而无需再创建一张重复卡片。这属于写入时的重复处理,与搜索命中不同。
352
-
353
- **不同重要程度的记忆,可以保留不同的最低权重。**
389
+ **不同类型的记忆保留不同的最低权重。**
354
390
 
355
391
  | 记忆类别 | 默认最低权重 |
356
392
  | --- | ---: |
@@ -359,9 +395,9 @@ Agent 确定用于最终回答的证据后,会提交采用回执。通过检
359
395
  | 身份信息 | 0.9 |
360
396
  | 安全信息 | 1.0 |
361
397
 
362
- 此外,置顶记忆的有效权重保持为 1;被取代的事件通常设置较低的权重上限,避免旧状态持续占据较高优先级。
398
+ 置顶记忆的有效权重保持为 1;被取代的事件通常设置较低的权重上限,减少旧状态继续优先出现的机会。
363
399
 
364
- 这些权重表达的是记忆管理策略,不能当作事实正确率。权重较高的信息仍需要结合当前问题、最新状态和原始来源进行判断。
400
+ 这些权重用于管理召回优先级,不是事实正确率。需要核实的内容仍应结合最新状态和来源判断。
365
401
 
366
402
  <details>
367
403
  <summary>长期权重公式与计数含义</summary>
@@ -384,6 +420,37 @@ Agent 确定用于最终回答的证据后,会提交采用回执。通过检
384
420
 
385
421
  </details>
386
422
 
423
+ <a id="model-configuration"></a>
424
+
425
+ ## 模型配置与升级
426
+
427
+ **聊天与记忆处理可以使用不同模型。**
428
+
429
+ | 模型用途 | 负责什么 | 如何选择 |
430
+ | --- | --- | --- |
431
+ | 聊天模型 | 与用户对话、回答问题 | 在 DSH 中选择 |
432
+ | 记忆处理模型 | 会话压缩、事件提取、目录整理和 Dreaming | 跟随聊天模型,或单独指定 |
433
+ | 向量模型(可选) | 按语义查找相关事件 | 单独配置 |
434
+ | 精排模型(可选) | 调整自动召回候选的顺序 | 单独配置,可独立于向量检索使用 |
435
+
436
+ 在 **更多 → 高级设置 → 宿主配置 → 记忆处理模型** 中,选择“跟随聊天模型”或“单独指定模型”,保存后用于后续记忆处理,聊天主模型保持原来的选择。已经运行的请求继续完成。
437
+
438
+ 记忆处理模型使用 DSH 已配置的服务商和模型。建议选择支持工具调用、上下文容量足够的模型;指定模型不可用时,任务会保留失败状态,不会自动改用聊天主模型。
439
+
440
+ **向量检索与精排分别开启。**
441
+
442
+ 在高级设置中,分别填写对应服务的 API 地址、密钥和模型,再保存设置。配置完整后才启用;清空地址并保存即可停用。
443
+
444
+ 向量模型负责补充语义匹配,精排模型负责调整自动召回顺序。它们不替代事件来源,也不替代证据门的判断。
445
+
446
+ 启用后,检索文本与事件标题、摘要(精排为候选事件内容)会发送到所选服务商,可能产生 API 费用。
447
+
448
+ **升级后重启对应的 DSH profile。**
449
+
450
+ 当前版本覆盖 DSH **0.2.x** 及其预发布版,并保留已支持的旧版适配;DSH **0.3.x** 暂不支持。完整版本范围、旧版修复和恢复方式见[插件使用说明](docs/DSH.zh-CN.md)。
451
+
452
+ 会话来源和长期记忆保存在本地 SQLite,每日笔记单独保存为 Markdown。卸载插件不会自动删除这些数据。
453
+
387
454
  <a id="external-memory-import"></a>
388
455
 
389
456
  ## 外部 AI 记忆迁移
@@ -394,17 +461,6 @@ DSH 管理界面提供导入预览:重复内容可以忽略,变化可以新
394
461
 
395
462
  导出格式、提示词与接入示例见[外部记忆导入说明](docs/EXTERNAL_MEMORY_IMPORT.zh-CN.md)。
396
463
 
397
- ## 一次真实的检索
398
-
399
- LoCoMo 中有一道题询问 Caroline 在什么时候进行了学校演讲。检索过程是:
400
-
401
- 1. 搜索事件,找到“学校演讲”事件卡,但没有具体日期。
402
- 2. Agent 判断证据部分充分,指出缺少发生日期,继续检索原始消息。
403
- 3. 找到 2023-06-09 的消息,其中写着“last week”。
404
- 4. 结合消息时间理解“上周”,得到足够的时间依据后回答。
405
-
406
- 事件卡帮助定位,原始消息和时间戳帮助核对;证据门要求 Agent 识别缺口,继续查证。
407
-
408
464
  <a id="实验结果"></a>
409
465
  <a id="experimental-results"></a>
410
466
 
@@ -412,7 +468,7 @@ LoCoMo 中有一道题询问 Caroline 在什么时候进行了学校演讲。检
412
468
 
413
469
  仓库公开的 R8 对比评测使用 LoCoMo 中的 `conv-26` 对话样本,包含 **419 条消息、35 个会话和 152 道问题**,覆盖 category 1–4。
414
470
 
415
- **以下成绩对应公开的 R8 实验配置,不是 0.3.0 主题目录或 0.3.2 新版事件提取的专项评测。** 不能据此推断这些更新的准确率、成本变化或独立收益。
471
+ **以下为仓库公开的 R8 评测结果,具体测试版本、模型和检索配置见[评测文档](docs/EVALUATION.md)。**
416
472
 
417
473
  两个系统分别生成答案,再对每道题的答案进行 **10 次独立 Judge 评审**。这里的十次指评审重复次数,不代表十次完整系统运行。
418
474
 
@@ -427,7 +483,7 @@ LoCoMo 中有一道题询问 Caroline 在什么时候进行了学校演讲。检
427
483
 
428
484
  两边使用相同的问题、顺序、答案模型、Judge 模型、评审提示词、解析器和评审次数,并分别重新构建记忆。记忆抽取、检索实现、embedding 使用方式和回答上下文存在差异,因此这里比较的是两套完整系统配置。
429
485
 
430
- 这组结果仅覆盖 `conv-26`,不代表完整 LoCoMo 成绩,也不能单独证明会话记忆衰减、知识图谱或证据门中某一项机制带来的收益。各组件的独立作用仍需通过消融实验检验。
486
+ 这组结果仅覆盖 `conv-26`,不代表完整 LoCoMo 成绩,也不能单独证明会话记忆的展示衰减、知识图谱或证据门中某一项机制带来的收益。各组件的独立作用仍需通过消融实验检验。
431
487
 
432
488
  完整协议、逐题结果及评审波动见 [评测文档](docs/EVALUATION.md),汇总数据见 [机器可读评测结果](benchmarks/locomo-conv26-r8-final.json)。
433
489
 
@@ -443,24 +499,6 @@ LoCoMo 中有一道题询问 Caroline 在什么时候进行了学校演讲。检
443
499
 
444
500
  R1–R8 的设计演变、逐题分析与后续验证方向见[完整评测](docs/EVALUATION.md)。
445
501
 
446
- ## 使用范围与成本
447
-
448
- **记忆空间决定哪些对话共享记忆。** DSH 默认按项目工作目录隔离;也可按会话隔离,或使用全局共享空间。主题目录只展示当前空间内可见的事件,常驻画像则跨会话、跨记忆空间提供。配置方式见[插件指南](docs/DSH.zh-CN.md)。
449
-
450
- **回答时的上下文预算,不等于全部模型开销。** 自动召回和主题目录各有预算,常驻画像、分层 Block、当前未封存对话及后续主动检索另行提供。900 tokens 和 400 tokens 分别是相关记忆与目录的预算,不能相加后当作整个请求的固定大小。
451
-
452
- | 环节 | 是否调用模型 | 成本来自哪里 |
453
- | --- | --- | --- |
454
- | 后台摘要、事件提取、图谱、主题与画像整理 | 会 | 对话、事件或画像输入、生成结果,以及有限重试 |
455
- | 读取已有目录、概览或搜索已有记录 | 读取本身不调用模型 | 结果带入后续模型上下文时仍占 tokens |
456
- | Agent 判断证据并生成答案 | 会 | 当前上下文、取回的证据和答案生成 |
457
-
458
- 分层视图减少的是回答时默认带入的历史内容。后台处理工具密集型对话时,会精简代码和过长工具记录的模型输入;完整记录仍保留在 L5。总费用需要结合后台处理、检索和回答的实际用量评估,不能由上下文变短直接推断。
459
-
460
- **升级后,历史目录逐步形成。** 已有事件在后台分批整理,目录可能暂时不完整;新增或变化的事件优先处理。失败或待整理的内容仍有事件入口,普通检索继续可用。历史整理有全库共享额度、有限重试和重启恢复,不承诺固定金额;额度与恢复细节见[主题整理说明](docs/MEMORY_TOPICS.zh-CN.md)。
461
-
462
- 目录与概览可根据有效来源重建。来源被修改、遗忘或归档后,过期派生内容先隐藏,再后台重建。新版事件提取规则用于后续正常提取,不统一重写旧事件。功能测试检查这些流程与约束,实际提取、归类和证据判断仍取决于模型。
463
-
464
502
  <a id="代码入口"></a>
465
503
  <a id="code-entry-points"></a>
466
504
 
@@ -487,6 +525,9 @@ npm run build
487
525
  | [DeepSeek Harness 使用说明](docs/DSH.zh-CN.md) | 安装、配置、界面、记忆工具和恢复机制 |
488
526
  | [记忆目录与主题概览](docs/MEMORY_TOPICS.zh-CN.md) | 章节与小节、来源追溯、后台整理、预算和恢复 |
489
527
  | [事件提取规则](docs/event-extractor.md) | 提取判断、适用范围、重复与历史关系,以及兼容边界 |
528
+ | [Dreaming 目录整理](https://github.com/diqierjia/StrataGate-AgentMemory/blob/main/docs/dreaming-agent.md) | 目录整理范围、运行控制、来源保护与恢复 |
529
+ | [可选知识图谱](https://github.com/diqierjia/StrataGate-AgentMemory/blob/main/docs/knowledge-graph.md) | 默认状态、开启、暂停、关闭及历史补建 |
530
+ | [手动层级选择](https://github.com/diqierjia/StrataGate-AgentMemory/blob/main/docs/user-operation-priority.md) | 内容预览、实际应用、容量不足与恢复操作 |
490
531
  | [架构文档](docs/ARCHITECTURE.md) | 分层规则、事件与图谱、检索、证据门、权重、存储和核心 API |
491
532
  | [外部记忆导入](docs/EXTERNAL_MEMORY_IMPORT.zh-CN.md) | 导出格式、导入流程和接入示例 |
492
533
  | [完整评测](docs/EVALUATION.md) | 实验协议、版本演变、失败分析和结果范围 |