@max-null/dsh-memory 0.6.0 → 0.6.1
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 +112 -101
- package/client.js +3 -3
- package/docs/shots/memory-settings-1.png +0 -0
- package/package.json +2 -3
package/README.md
CHANGED
|
@@ -1,101 +1,112 @@
|
|
|
1
|
-
# dsh-memory
|
|
2
|
-
|
|
3
|
-
本插件属于 **`@max-null/*` 插件系列**——这一系列共同构成 **[SSID（思灵 · Seek Soul in Darkness）](https://github.com/Max-Null/seek-soul-in-darkness)** 桌面体验。SSID 是整合它们的盒：`dsh-capture` · `dsh-chat-rail` · `dsh-chinese-thinking` · `dsh-draft-polish` · `dsh-guardian` · `dsh-habit` · `dsh-
|
|
4
|
-
|
|
5
|
-
This plugin belongs to the **`@max-null/*` family** — a set of plugins that together form the **[SSID (思灵 · Seek Soul in Darkness)](https://github.com/Max-Null/seek-soul-in-darkness)** desktop experience.
|
|
6
|
-
|
|
7
|
-
一个面向 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 的**跨会话明文记忆插件**。遵循「一切皆插件」——它不修改 DSH 源码，声明 `name`/`inject`/`apply`，由 Loader 从 `cordis.yml` 加载。
|
|
8
|
-
|
|
9
|
-
## 设计原则
|
|
10
|
-
|
|
11
|
-
1. **人是所有者**：模型只能写入 `suggested` 状态的记忆，绝不自我提升；只有人工确认（`setStatus`）才能让记忆生效。
|
|
12
|
-
2. **可观测先于精准**：每条记忆是明文，`memory_list` 随时可见、`memory_forget` 随时删除——不存在"静默暗礁"。
|
|
13
|
-
3. **明文是人机共享的审计窗口**：记忆是可读文本，模型可自检其是否过期或出错（规划中的 v2）。
|
|
14
|
-
4. **确定性且缓存安全**：BM25 关键词检索是存储的纯函数、无 LLM 调用；固定指引进 system-prompt section，`approved + injected` 记忆进 recall context（global 全量 + 当前会话工作区），逐条为单行摘要并按注入预算截断（超预算按最近使用优先，省略数在面板可见）。
|
|
15
|
-
|
|
16
|
-
##
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
##
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
1
|
+
# dsh-memory
|
|
2
|
+
|
|
3
|
+
本插件属于 **`@max-null/*` 插件系列**——这一系列共同构成 **[SSID（思灵 · Seek Soul in Darkness）](https://github.com/Max-Null/seek-soul-in-darkness)** 桌面体验。SSID 是整合它们的盒：`dsh-capture` · `dsh-chat-rail` · `dsh-chinese-thinking` · `dsh-draft-polish` · `dsh-guardian` · `dsh-habit` · `dsh-memory` · `dsh-node-appearance` · `dsh-plugin-center` · `dsh-quick-toolbar` · `dsh-skill-mcp-center` · `dsh-ssid-panels` · `dsh-ssid-zh-ui` · `dsh-achievements`。
|
|
4
|
+
|
|
5
|
+
This plugin belongs to the **`@max-null/*` family** — a set of plugins that together form the **[SSID (思灵 · Seek Soul in Darkness)](https://github.com/Max-Null/seek-soul-in-darkness)** desktop experience.
|
|
6
|
+
|
|
7
|
+
一个面向 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 的**跨会话明文记忆插件**。遵循「一切皆插件」——它不修改 DSH 源码，声明 `name`/`inject`/`apply`，由 Loader 从 `cordis.yml` 加载。
|
|
8
|
+
|
|
9
|
+
## 设计原则
|
|
10
|
+
|
|
11
|
+
1. **人是所有者**：模型只能写入 `suggested` 状态的记忆，绝不自我提升；只有人工确认（`setStatus`）才能让记忆生效。
|
|
12
|
+
2. **可观测先于精准**：每条记忆是明文，`memory_list` 随时可见、`memory_forget` 随时删除——不存在"静默暗礁"。
|
|
13
|
+
3. **明文是人机共享的审计窗口**：记忆是可读文本，模型可自检其是否过期或出错（规划中的 v2）。
|
|
14
|
+
4. **确定性且缓存安全**：BM25 关键词检索是存储的纯函数、无 LLM 调用；固定指引进 system-prompt section，`approved + injected` 记忆进 recall context（global 全量 + 当前会话工作区），逐条为单行摘要并按注入预算截断（超预算按最近使用优先，省略数在面板可见）。
|
|
15
|
+
|
|
16
|
+
## 截图
|
|
17
|
+
|
|
18
|
+
装完后在设置里多出「记忆」一项，可查看与管理跨会话记忆：
|
|
19
|
+
|
|
20
|
+
**入口：** 设置 → 记忆
|
|
21
|
+
|
|
22
|
+
| 设置入口与面板 |
|
|
23
|
+
|---|
|
|
24
|
+
|  |
|
|
25
|
+
|
|
26
|
+
|
|
27
|
+
## 用法
|
|
28
|
+
|
|
29
|
+
```bash
|
|
30
|
+
npm install @max-null/dsh-memory
|
|
31
|
+
```
|
|
32
|
+
|
|
33
|
+
在你的 `cordis.yml` 加一条（其余 storage / system-prompt / tools 由宿主已有；记忆的存储后端由插件自己注册）：
|
|
34
|
+
|
|
35
|
+
```yaml
|
|
36
|
+
- id: memory
|
|
37
|
+
name: '@max-null/dsh-memory'
|
|
38
|
+
```
|
|
39
|
+
|
|
40
|
+
## 提供的服务与工具
|
|
41
|
+
|
|
42
|
+
- **服务** `ctx.memory`：`remember` / `list` / `search` / `forget` / `setStatus`
|
|
43
|
+
- **工具**：`memory_save`、`memory_list`、`memory_search`、`memory_confirm`、`memory_forget`、`memory_update`
|
|
44
|
+
- **注入**：`tool:memory` 指引 section + `memory:recall` 召回 context（global 的 `approved + injected` + 当前会话工作区的 `approved + injected`，带 `[memory:<id>:<namespace>]` 来源标记；摘要化 + 预算截断）
|
|
45
|
+
- **检索**：BM25（CJK 单字 + 2-gram，content 与 keywords 字段分离加权；中文多字查询精度显著优于单字切分）；可选语义融合（见「可选配置」）
|
|
46
|
+
|
|
47
|
+
## 两层存储（global / project）
|
|
48
|
+
|
|
49
|
+
记忆按 `namespace` 分两层物理存储，各落在独立的明文 JSON：
|
|
50
|
+
|
|
51
|
+
| namespace | 默认位置 | 用途 |
|
|
52
|
+
|---|---|---|
|
|
53
|
+
| `global` | `$DSH_HOME/storages/memory.json` | 跨项目的个人偏好 |
|
|
54
|
+
| `project` | `<cwd>/.dsh/storages/memory_project_<hash>.json` | 跟随仓库的项目共识，可 git 分享 |
|
|
55
|
+
|
|
56
|
+
两个根都可用 config 覆盖（`globalRoot` / `projectRoot`）。`memory_list` / `memory_search` 不带 `namespace` 过滤时会同时查两层。旧版双重前缀文件名（`memory_project_memory_project_<hash>.json`）在打开时自动迁移为规范名。
|
|
57
|
+
|
|
58
|
+
## 使用流程（人工确认闸门）
|
|
59
|
+
|
|
60
|
+
提示词模板库（0.6.0）：`prompt_search / prompt_get / prompt_list / prompt_add` 四个工具管理**模板库**——
|
|
61
|
+
md 文件是唯一事实源（`~/.dsh/prompt-library/*.md` 为 global；`<workspace>/.dsh/prompt-library/` 随工作区分享），
|
|
62
|
+
前端（记忆面板「模板」tab / 模型工具）检索同一份索引；模板存在即生效（`source: agent` 角标标识模型新增），
|
|
63
|
+
**永不注入 system prompt**。
|
|
64
|
+
|
|
65
|
+
```
|
|
66
|
+
模型 memory_save → status: suggested（只是建议，未生效）
|
|
67
|
+
人 memory_confirm → status: approved（已审核；是否常驻注入由独立开关 injected 决定）
|
|
68
|
+
人（面板/开关） → injected: true（每轮注入：global + 当前会话工作区，摘要化 + 预算截断）
|
|
69
|
+
memory_search → 关键词/语义召回任意状态的记忆（命中标记 lastUsedAt 冷热追踪）
|
|
70
|
+
memory_forget → 随时删除
|
|
71
|
+
```
|
|
72
|
+
|
|
73
|
+
模型**永远不能自我提升**一条记忆——`memory_save` 只写 `suggested`，只有人在明确要求时（`memory_confirm`）才能让它生效。这保证了记忆不是黑盒：人随时能看、能改、能删。
|
|
74
|
+
|
|
75
|
+
## 为什么明文 + BM25，而不是向量检索
|
|
76
|
+
|
|
77
|
+
向量检索的记忆本体是一串不可读的数字，过期信息会成为**无法观测、无法修复的静默暗礁**；BM25 + 明文让每一次召回都可解释、每一条记忆都可见可删。语义（向量）检索作为**可插拔的可选项**（0.5.2，见「可选配置」）——记忆本体仍是明文，向量仅作为检索辅助字段（`vector`，明文可读），且以"可观测 + 可修复"为门槛。
|
|
78
|
+
|
|
79
|
+
明文还有一层**跟随仓库分享**的好处：`project` 命名空间的记忆落在项目文件夹内（`<cwd>/.dsh/storages/memory_project_<hash>.json`），随 `git` 提交、分享给所有协作者；`global` 命名空间的记忆留在本地 `$DSH_HOME`。团队的共识（"本项目统一用 Vue3 `<script setup>`"）能沉淀进仓库，而不是散落在每个人的本地。FTS5 的 SQLite 二进制无法这样"跟着仓库走"。
|
|
80
|
+
|
|
81
|
+
## 可选配置
|
|
82
|
+
|
|
83
|
+
在 `cordis.yml` 的 `config` 里传给插件（均可省略）：
|
|
84
|
+
|
|
85
|
+
```yaml
|
|
86
|
+
- id: memory
|
|
87
|
+
name: '@max-null/dsh-memory'
|
|
88
|
+
config:
|
|
89
|
+
injectionBudget: 1500 # 常驻注入预算（字符；null = 不限制）
|
|
90
|
+
summaryChars: 80 # 单条注入摘要截断上限（字符）
|
|
91
|
+
semanticTopK: 5 # 语义侧参与融合的 topK（仅配置 embeddings 时生效）
|
|
92
|
+
# 混合语义检索（可插拔；缺省 = 纯 BM25）
|
|
93
|
+
# embeddings: { embed: '...' 提供 embed(texts) 的宿主函数 或 插件名 ... }
|
|
94
|
+
```
|
|
95
|
+
|
|
96
|
+
`embeddings` 接受 `{ embed(texts): Promise<number[][]>, similarity? }` 对象——由宿主装配层提供嵌入实现（如 DeepSeek 嵌入端点）；配置后 `memory_search` 以 BM25 + 语义 RRF 融合，向量增量生成并持久化，嵌入调用失败自动降级为纯 BM25。
|
|
97
|
+
|
|
98
|
+
## SSID 系列
|
|
99
|
+
|
|
100
|
+
## 开发
|
|
101
|
+
|
|
102
|
+
```bash
|
|
103
|
+
npm install
|
|
104
|
+
npm run typecheck # tsc 严格类型检查
|
|
105
|
+
npm test # vitest 单测
|
|
106
|
+
npm run build # 产出 dist/
|
|
107
|
+
node scripts/verify-loader.mjs # 用 Loader 端到端验证插件可加载
|
|
108
|
+
```
|
|
109
|
+
|
|
110
|
+
## 依赖（peerDependencies，由宿主提供）
|
|
111
|
+
|
|
112
|
+
`@deepseek-ai/cordis`、`@deepseek-ai/dsh-storage`、`@deepseek-ai/dsh-storage-domain`、`@deepseek-ai/dsh-storage-json`、`@deepseek-ai/dsh-system-prompt`、`@deepseek-ai/dsh-tools`
|
package/client.js
CHANGED
|
@@ -94,11 +94,11 @@ var BRAIN_PATHS = [
|
|
|
94
94
|
];
|
|
95
95
|
function brainIcon() {
|
|
96
96
|
return (0, import_react.createElement)("svg", {
|
|
97
|
-
width:
|
|
98
|
-
height:
|
|
97
|
+
width: 22,
|
|
98
|
+
height: 22,
|
|
99
99
|
viewBox: "0 0 24 24",
|
|
100
100
|
fill: "none",
|
|
101
|
-
stroke: "
|
|
101
|
+
stroke: "#8b5cf6",
|
|
102
102
|
strokeWidth: 2,
|
|
103
103
|
strokeLinecap: "round",
|
|
104
104
|
strokeLinejoin: "round"
|
|
Binary file
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@max-null/dsh-memory",
|
|
3
|
-
"version": "0.6.
|
|
3
|
+
"version": "0.6.1",
|
|
4
4
|
"description": "Cross-session plaintext memory plugin for the DeepSeek Harness — deterministic BM25 recall, human-owned, no embeddings",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"publishConfig": {
|
|
@@ -22,8 +22,7 @@
|
|
|
22
22
|
"client.js",
|
|
23
23
|
"cordis.patch.yml",
|
|
24
24
|
"README.md",
|
|
25
|
-
"LICENSE"
|
|
26
|
-
],
|
|
25
|
+
"LICENSE", "docs/shots"],
|
|
27
26
|
"dsh": {
|
|
28
27
|
"bundle": {
|
|
29
28
|
"patch": "./cordis.patch.yml"
|