stratagate-dsh 0.2.16 → 0.2.21
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/CHANGELOG.md +31 -0
- package/README.md +19 -4
- package/cordis.patch.yml +1 -0
- package/dist/client.js +399 -95
- package/dist/index.d.ts +1 -0
- package/dist/index.js +618 -89
- package/dist/index.js.map +1 -1
- package/docs/README.zh-CN.md +19 -4
- package/package.json +1 -1
package/docs/README.zh-CN.md
CHANGED
|
@@ -6,6 +6,16 @@
|
|
|
6
6
|
|
|
7
7
|
该插件负责将 DSH 会话事件接入现有的 StrataGate 记忆引擎，并不会实现另一套独立的记忆系统。
|
|
8
8
|
|
|
9
|
+
## 界面预览
|
|
10
|
+
|
|
11
|
+
### 分层短期记忆
|
|
12
|
+
|
|
13
|
+
|
|
14
|
+
|
|
15
|
+
### 记忆结构与诊断
|
|
16
|
+
|
|
17
|
+
|
|
18
|
+
|
|
9
19
|
## 它是怎么设计的
|
|
10
20
|
|
|
11
21
|
StrataGate 不把“记忆”当作一段不断改写的摘要，而是把**原始证据、派生记忆、检索判断和使用反馈**分开处理：
|
|
@@ -31,7 +41,7 @@ flowchart LR
|
|
|
31
41
|
4. **相关不代表足以回答。** Evidence Gate 会单独判断当前证据是否充分。证据不足时，Agent 必须继续搜索、展开来源或明确说明无法确认，而不能把相似结果直接当成答案。
|
|
32
42
|
5. **检索与强化彼此分离。** 搜到一条记忆不会自动提高它的权重；只有证据通过评估并真正用于回答后，才会记录使用情况。这样可以避免“越常被搜到，就越容易继续被搜到”的自我强化循环。
|
|
33
43
|
|
|
34
|
-
这条链路在本地完成持久化，并通过幂等写入回执防止 DSH
|
|
44
|
+
这条链路在本地完成持久化，并通过幂等写入回执防止 DSH 重放或重试造成重复记忆。Memory UI 展示的也是同一套来源、派生和使用审计关系。
|
|
35
45
|
|
|
36
46
|
## Agent 推荐指南
|
|
37
47
|
|
|
@@ -90,16 +100,16 @@ memory_record_use
|
|
|
90
100
|
|
|
91
101
|
提示词协议要求模型在依赖检索证据前完成评估。仅搜索不会强化记忆。非空的 `memory_record_use` 只接受最近一次“证据充分”评估中的证据，并使用 DSH 工具调用 ID 作为幂等回执。
|
|
92
102
|
|
|
93
|
-
##
|
|
103
|
+
## 记忆界面与使用审计
|
|
94
104
|
|
|
95
|
-
打开 DSH 设置并选择 **StrataGate
|
|
105
|
+
打开 DSH 设置并选择 **StrataGate-AgentMemory**。该页面提供：
|
|
96
106
|
|
|
97
107
|
- 命名空间健康状态和各类记忆数量；
|
|
98
108
|
- Events、Elements 和 Blocks 搜索；
|
|
99
109
|
- 从每条派生记忆展开查看来源消息；
|
|
100
110
|
- Usage Audit（使用审计）链路：从已记录的回答轮次出发，经由 Evidence Gate 的判断与选中的记忆，追溯到来源消息。
|
|
101
111
|
|
|
102
|
-
|
|
112
|
+
记忆数据仍然只读，界面不提供编辑、删除、批准或导入操作。唯一例外是“高级设置”中的全局 Block 衰减系数 λ：可按 `0.05` 步长调节，保存后立即应用到所有已有工作区，同时成为新工作区默认值，并在重启后保持。消息内容和结构化工具轨迹中的常见令牌及凭证格式，会在离开本地服务器前被脱敏。SQLite 数据库始终是唯一可信数据源。
|
|
103
113
|
|
|
104
114
|
## 配置
|
|
105
115
|
|
|
@@ -110,6 +120,7 @@ config:
|
|
|
110
120
|
namespacePrefix: dsh
|
|
111
121
|
globalNamespace: global
|
|
112
122
|
blockTurnSize: 6
|
|
123
|
+
blockDecayLambda: 0.3
|
|
113
124
|
ingestSubagents: false
|
|
114
125
|
maxOutputTokens: 10000
|
|
115
126
|
# 可选：为记忆处理指定专用模型。
|
|
@@ -117,10 +128,14 @@ config:
|
|
|
117
128
|
# model: deepseek-chat
|
|
118
129
|
```
|
|
119
130
|
|
|
131
|
+
配置文件中的 `blockDecayLambda` 是初始后备值；一旦在“高级设置”中修改，持久化的界面值优先生效。默认值为 `0.3`；数字越小，记忆遗忘越慢、消耗 token 越多，不建议大于 `0.4`。
|
|
132
|
+
|
|
120
133
|
`project` 会根据规范化后的会话工作目录生成稳定的命名空间；`session` 会隔离每个 DSH 会话；`global` 则让所有会话共享同一个命名空间。
|
|
121
134
|
|
|
122
135
|
`blockTurnSize` 控制每个 Block 封存多少个已完成的 DSH 轮次。插件默认值为 `6`，用于平衡模型调用成本与 Event 提取及时性；用户可以配置任意正整数。
|
|
123
136
|
|
|
137
|
+
`blockDecayLambda` 按当前 Block 锚点与同一 DSH 会话中最新已封存 Block 的距离控制衰减。默认值为 `0.3`；数字越小衰减越慢，不建议大于 `0.4`。open tail 中尚未封存的轮次不会增加 Block age。
|
|
138
|
+
|
|
124
139
|
如果省略 `provider` 和 `model`，记忆处理会优先使用会话最近一次请求的路由，并以 DSH 默认模型作为后备。这两个配置项必须同时设置。
|
|
125
140
|
|
|
126
141
|
## 隐私与故障处理
|