stratagate-dsh 0.2.16 → 0.2.19

package/docs/README.zh-CN.md

@@ -31,7 +31,7 @@ flowchart LR
 4. **相关不代表足以回答。** Evidence Gate 会单独判断当前证据是否充分。证据不足时，Agent 必须继续搜索、展开来源或明确说明无法确认，而不能把相似结果直接当成答案。
 5. **检索与强化彼此分离。** 搜到一条记忆不会自动提高它的权重；只有证据通过评估并真正用于回答后，才会记录使用情况。这样可以避免“越常被搜到，就越容易继续被搜到”的自我强化循环。
 
-这条链路在本地完成持久化，并通过幂等写入回执防止 DSH 重放或重试造成重复记忆。只读 Memory UI 展示的也是同一套来源、派生和使用审计关系。
+这条链路在本地完成持久化，并通过幂等写入回执防止 DSH 重放或重试造成重复记忆。Memory UI 展示的也是同一套来源、派生和使用审计关系。
 
 ## Agent 推荐指南
 
@@ -90,16 +90,16 @@ memory_record_use
 
 提示词协议要求模型在依赖检索证据前完成评估。仅搜索不会强化记忆。非空的 `memory_record_use` 只接受最近一次“证据充分”评估中的证据，并使用 DSH 工具调用 ID 作为幂等回执。
 
-## 只读记忆界面与使用审计
+## 记忆界面与使用审计
 
-打开 DSH 设置并选择 **StrataGate Memory**。该页面提供：
+打开 DSH 设置并选择 **StrataGate-AgentMemory**。该页面提供：
 
 - 命名空间健康状态和各类记忆数量；
 - Events、Elements 和 Blocks 搜索；
 - 从每条派生记忆展开查看来源消息；
 - Usage Audit（使用审计）链路：从已记录的回答轮次出发，经由 Evidence Gate 的判断与选中的记忆，追溯到来源消息。
 
-浏览器界面特意设计为只读：其 API 仅接受 `GET` 请求，界面也不提供编辑、删除、批准或导入操作。消息内容和结构化工具轨迹中的常见令牌及凭证格式，会在离开本地服务器前被脱敏。SQLite 数据库始终是唯一可信数据源。
+记忆数据仍然只读，界面不提供编辑、删除、批准或导入操作。唯一例外是“高级设置”中的全局 Block 衰减系数 λ：可按 `0.05` 步长调节，保存后立即应用到所有已有工作区，同时成为新工作区默认值，并在重启后保持。消息内容和结构化工具轨迹中的常见令牌及凭证格式，会在离开本地服务器前被脱敏。SQLite 数据库始终是唯一可信数据源。
 
 ## 配置
 
@@ -110,6 +110,7 @@ config:
   namespacePrefix: dsh
   globalNamespace: global
   blockTurnSize: 6
+  blockDecayLambda: 0.3
   ingestSubagents: false
   maxOutputTokens: 10000
   # 可选：为记忆处理指定专用模型。
@@ -117,10 +118,14 @@ config:
   # model: deepseek-chat
 ```
 
+配置文件中的 `blockDecayLambda` 是初始后备值；一旦在“高级设置”中修改，持久化的界面值优先生效。默认值为 `0.3`；数字越小，记忆遗忘越慢、消耗 token 越多，不建议大于 `0.4`。
+
 `project` 会根据规范化后的会话工作目录生成稳定的命名空间；`session` 会隔离每个 DSH 会话；`global` 则让所有会话共享同一个命名空间。
 
 `blockTurnSize` 控制每个 Block 封存多少个已完成的 DSH 轮次。插件默认值为 `6`，用于平衡模型调用成本与 Event 提取及时性；用户可以配置任意正整数。
 
+`blockDecayLambda` 按当前 Block 锚点与同一 DSH 会话中最新已封存 Block 的距离控制衰减。默认值为 `0.3`；数字越小衰减越慢，不建议大于 `0.4`。open tail 中尚未封存的轮次不会增加 Block age。
+
 如果省略 `provider` 和 `model`，记忆处理会优先使用会话最近一次请求的路由，并以 DSH 默认模型作为后备。这两个配置项必须同时设置。
 
 ## 隐私与故障处理

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stratagate-dsh",
-  "version": "0.2.16",
+  "version": "0.2.19",
   "description": "Automatic local-first cross-session memory for DeepSeek Harness with source-traceable recall",
   "type": "module",
   "main": "./dist/index.js",