@avantf/dsh-mem 0.6.4 → 0.7.0
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.md +15 -10
- package/lib/client.js +1146 -2300
- package/lib/dsh-build.json +5 -5
- package/lib/engine/mem/config/config_files.d.ts +1 -1
- package/lib/engine/mem/facts_io.d.ts +288 -0
- package/lib/engine/mem/index.d.ts +4 -0
- package/lib/engine/mem/maintenance_paths.d.ts +41 -0
- package/lib/engine/mem/runtime.d.ts +57 -3
- package/lib/engine/mem/store/facts_restore.d.ts +116 -0
- package/lib/engine/mem/store/memory.d.ts +16 -0
- package/lib/engine/mem-contract/tools.d.ts +55 -1
- package/lib/index.js +4301 -2614
- package/lib/types/command.d.ts +61 -0
- package/lib/types/command.d.ts.map +1 -0
- package/lib/types/index.d.ts.map +1 -1
- package/lib/types/interface_gate.d.ts +9 -9
- package/lib/types/remote.d.ts +9 -2
- package/lib/types/remote.d.ts.map +1 -1
- package/lib/types/render.d.ts +3 -3
- package/package.json +6 -6
package/README.md
CHANGED
|
@@ -1,20 +1,25 @@
|
|
|
1
1
|
# @avantf/dsh-mem
|
|
2
2
|
|
|
3
3
|
DSH（DeepSeek Harness）原生记忆插件：给 agent 一份可长期检索的**记忆**和一个**文档知识库**——
|
|
4
|
-
它跨会话记得你说过的事，也能把文档收进库里按语义查回来。装上后提供
|
|
4
|
+
它跨会话记得你说过的事，也能把文档收进库里按语义查回来。装上后提供 7 个模型工具、三段用法提示
|
|
5
5
|
和两个主窗口标签页（记忆 / 知识）。
|
|
6
6
|
|
|
7
7
|
## 主要功能
|
|
8
8
|
|
|
9
|
-
- **
|
|
10
|
-
- `mem_remember`：新增 / 改写 /
|
|
11
|
-
- `mem_recall`：混合检索（语义 + 全文 +
|
|
12
|
-
- `mem_admin`：列表 /
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
9
|
+
- **7 个模型工具**
|
|
10
|
+
- `mem_remember`：新增 / 改写 / 删除事实（写入后立刻做矛盾检测）
|
|
11
|
+
- `mem_recall`：混合检索（语义 + 全文 + 实体）、三元组方向问答、实体探查、多实体联合推理、矛盾查询
|
|
12
|
+
- `mem_admin`：列表 / **导出 / 导入 / 快照重建**。文件路径**只允许本次运行的数据根内**
|
|
13
|
+
（默认导出到 `<数据根>/backups/memory-YYYYMMDD-HHMMSS.json.br`，原子写，结果不含文档正文）；
|
|
14
|
+
`import` 按**文件头**自动识别 SQLite（只读合并另一份 `memory.db`，报告 `mode:'db'`）与 JSON 导出文档
|
|
15
|
+
（`mode:'json'`）；`restore_snapshot` 必须显式 `confirm: true`，且只接受**空 facts 表**，恢复后同一宿主
|
|
16
|
+
进程立即可检索。
|
|
17
|
+
- `kb_add` / `kb_list` / `kb_remove`：新增文档（文本 / 文件 / URL，或批量导入目录，同名拒绝）、
|
|
18
|
+
列表（带出受管 `.md` 的绝对路径与切片详情）、删除；
|
|
16
19
|
**改一篇既有文档就是改那份 `.md`**（用文件工具改，索引自动跟随）
|
|
17
20
|
- `kb_query`：跨「记忆事实 + 文档切片」的统一检索，结果带来源标注，可据此引用原文
|
|
21
|
+
- 诊断、策展（pin / 归档恢复 / 反馈 / 矛盾裁决）与索引修复（重建索引、向量修复）是**操作者动作**：
|
|
22
|
+
在「记忆」「知识」页与 CLI 里可用，不占用模型工具面。
|
|
18
23
|
- **记忆与知识一起检索**：对记忆事实与文档切片做统一排序，两类结果处在同一分数刻度上，
|
|
19
24
|
所以"我之前定过的约定"和"文档里怎么写的"能一次问出来。
|
|
20
25
|
- **记忆是活的**：按活跃使用结算，支持有效期、遗忘、去重与修订链；同一主题的改动会被识别成
|
|
@@ -69,10 +74,10 @@ dsh plugin --profile <PROFILE> add @avantf/dsh-mem@<version>
|
|
|
69
74
|
改一篇已经入库的文档：让模型"更新这篇文档"即可；也可以用任意文件工具直接编辑那份受管
|
|
70
75
|
`.md`（先用 `kb_list` 拿到路径），改完会自动同步，「知识」页的「重新摄入」是手动兜底。
|
|
71
76
|
|
|
72
|
-
|
|
77
|
+
常见维护动作（在「记忆」页或 CLI 里）：
|
|
73
78
|
|
|
74
79
|
```text
|
|
75
|
-
|
|
80
|
+
看看记忆库里已存了哪些事实。
|
|
76
81
|
把矛盾检测的积压扫一遍，逐条裁决。
|
|
77
82
|
```
|
|
78
83
|
|