dsh-plain-memory 1.0.1 → 1.1.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/LICENSE +21 -21
- package/README.en.md +76 -72
- package/README.md +155 -147
- package/cards.js +69 -69
- package/cordis.patch.yml +5 -5
- package/git.js +119 -119
- package/index.js +149 -20
- package/locale/en.json +6 -6
- package/locale/zh.json +6 -6
- package/memory.js +417 -396
- package/package.json +49 -48
- package/prompts/daily-consolidate.md +29 -28
- package/template/README.md +40 -39
- package/template/self.md +15 -15
package/package.json
CHANGED
|
@@ -1,48 +1,49 @@
|
|
|
1
|
-
{
|
|
2
|
-
"name": "dsh-plain-memory",
|
|
3
|
-
"version": "1.0
|
|
4
|
-
"description": "原味记忆(plain memory):DSH 原生的轻记忆。记忆是纯 Markdown,放在你自己的 Git 仓库;多窗口状态卡(实验性,默认关闭);需要时想得起来。零运行时依赖、零模型调用、零周期定时器。",
|
|
5
|
-
"type": "module",
|
|
6
|
-
"main": "index.js",
|
|
7
|
-
"exports": {
|
|
8
|
-
".": "./index.js",
|
|
9
|
-
"./package.json": "./package.json"
|
|
10
|
-
},
|
|
11
|
-
"files": [
|
|
12
|
-
"index.js",
|
|
13
|
-
"memory.js",
|
|
14
|
-
"git.js",
|
|
15
|
-
"cards.js",
|
|
16
|
-
"locale",
|
|
17
|
-
"template",
|
|
18
|
-
"prompts",
|
|
19
|
-
"cordis.patch.yml",
|
|
20
|
-
"README.md"
|
|
21
|
-
],
|
|
22
|
-
"repository": {
|
|
23
|
-
"type": "git",
|
|
24
|
-
"url": "git+https://github.com/simin-yuan/dsh-plain-memory.git"
|
|
25
|
-
},
|
|
26
|
-
"homepage": "https://github.com/simin-yuan/dsh-plain-memory#readme",
|
|
27
|
-
"author": "Simin Yuan",
|
|
28
|
-
"dsh": {
|
|
29
|
-
"bundle": {
|
|
30
|
-
"patch": "./cordis.patch.yml"
|
|
31
|
-
}
|
|
32
|
-
},
|
|
33
|
-
"keywords": ["dsh", "dsh-plugin", "deepseek-harness", "memory"],
|
|
34
|
-
"peerDependencies": {
|
|
35
|
-
"@deepseek-ai/cordis": ">=4.1.0",
|
|
36
|
-
"@deepseek-ai/dsh-tools": ">=0.2.2-rc.1",
|
|
37
|
-
"@deepseek-ai/dsh-llm": ">=0.2.2-rc.1"
|
|
38
|
-
},
|
|
39
|
-
"peerDependenciesMeta": {
|
|
40
|
-
"@deepseek-ai/cordis": { "optional": true },
|
|
41
|
-
"@deepseek-ai/dsh-tools": { "optional": true },
|
|
42
|
-
"@deepseek-ai/dsh-llm": { "optional": true }
|
|
43
|
-
},
|
|
44
|
-
"engines": {
|
|
45
|
-
"node": ">=22"
|
|
46
|
-
},
|
|
47
|
-
"license": "MIT"
|
|
48
|
-
}
|
|
1
|
+
{
|
|
2
|
+
"name": "dsh-plain-memory",
|
|
3
|
+
"version": "1.1.0",
|
|
4
|
+
"description": "原味记忆(plain memory):DSH 原生的轻记忆。记忆是纯 Markdown,放在你自己的 Git 仓库;多窗口状态卡(实验性,默认关闭);需要时想得起来。零运行时依赖、零模型调用、零周期定时器。",
|
|
5
|
+
"type": "module",
|
|
6
|
+
"main": "index.js",
|
|
7
|
+
"exports": {
|
|
8
|
+
".": "./index.js",
|
|
9
|
+
"./package.json": "./package.json"
|
|
10
|
+
},
|
|
11
|
+
"files": [
|
|
12
|
+
"index.js",
|
|
13
|
+
"memory.js",
|
|
14
|
+
"git.js",
|
|
15
|
+
"cards.js",
|
|
16
|
+
"locale",
|
|
17
|
+
"template",
|
|
18
|
+
"prompts",
|
|
19
|
+
"cordis.patch.yml",
|
|
20
|
+
"README.md"
|
|
21
|
+
],
|
|
22
|
+
"repository": {
|
|
23
|
+
"type": "git",
|
|
24
|
+
"url": "git+https://github.com/simin-yuan/dsh-plain-memory.git"
|
|
25
|
+
},
|
|
26
|
+
"homepage": "https://github.com/simin-yuan/dsh-plain-memory#readme",
|
|
27
|
+
"author": "Simin Yuan",
|
|
28
|
+
"dsh": {
|
|
29
|
+
"bundle": {
|
|
30
|
+
"patch": "./cordis.patch.yml"
|
|
31
|
+
}
|
|
32
|
+
},
|
|
33
|
+
"keywords": ["dsh", "dsh-plugin", "deepseek-harness", "memory"],
|
|
34
|
+
"peerDependencies": {
|
|
35
|
+
"@deepseek-ai/cordis": ">=4.1.0",
|
|
36
|
+
"@deepseek-ai/dsh-tools": ">=0.2.2-rc.1",
|
|
37
|
+
"@deepseek-ai/dsh-llm": ">=0.2.2-rc.1"
|
|
38
|
+
},
|
|
39
|
+
"peerDependenciesMeta": {
|
|
40
|
+
"@deepseek-ai/cordis": { "optional": true },
|
|
41
|
+
"@deepseek-ai/dsh-tools": { "optional": true },
|
|
42
|
+
"@deepseek-ai/dsh-llm": { "optional": true }
|
|
43
|
+
},
|
|
44
|
+
"engines": {
|
|
45
|
+
"node": ">=22"
|
|
46
|
+
},
|
|
47
|
+
"license": "MIT"
|
|
48
|
+
}
|
|
49
|
+
|
|
@@ -1,28 +1,29 @@
|
|
|
1
|
-
#
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
你要为我的记忆仓做一次每日巩固。仓库路径:`<MEMORY_REPO_PATH>`(若不确定,先 `git -C <路径> rev-parse --show-toplevel` 确认)。
|
|
8
|
-
|
|
9
|
-
**闸门(先做这一步)**:看 `.state/last-consolidate` 里记的上次巩固时间;再数 `episodic/` 下修改时间晚于它的文件。
|
|
10
|
-
如果**没有新增**,只回一行「无新经历,今日不巩固」然后结束——不要 pull、不要提交、不要读别的文件。
|
|
11
|
-
如果有新增,把这次时间写进 `.state/last-consolidate`,继续下面步骤。
|
|
12
|
-
|
|
13
|
-
**保密(硬规则,优先于其它所有步骤)**:`self.md` 里标为商业机密的范围(例如某条「不写入记忆」的约束),其具体内容一律不提炼、不概括、不写进任何一层记忆;已经存在的直接删掉。只允许保留不含细节的事实,例如「讨论过某个主题」。宁可不记,也不要留可推断的细节。
|
|
14
|
-
|
|
15
|
-
1. **同步**:`git pull --ff-only`。若失败(离线/冲突),停下并在结论里说明,不要强推。
|
|
16
|
-
2. **读**:读 `self.md`、上次巩固之后新增的 `episodic/*.md`、以及 `semantic/` 下所有文件的标题与 `cues` 行。
|
|
17
|
-
3. **合并**:把重复或高度重叠的语义条目合并成一条(保留最早日期,`related` 取并集,保留较新的正文)。情景记忆不合并,只删掉完全是噪声的条目。
|
|
18
|
-
4. **冲突**:两条记忆互相矛盾时,以更新的、且能追溯到具体会话的那条为准;被推翻的那条删掉并在新条目正文里写一句「推翻了 X(YYYY-MM-DD)」。
|
|
19
|
-
5. **遗忘**:删掉已经过期、或被后来事实否定、或只对一次性任务有意义的条目。宁可少,不要留噪声。
|
|
20
|
-
6. **提炼线索词**:这是跨领域唤起的主要手段,概念桥只是兜底。每条语义/自我记忆的 `cues` 控制在 3–8 个,写法是「我以后会怎么问这件事」,不是「这条记忆里出现了哪些词」:
|
|
21
|
-
- 抽象概念优先:可复现、降低验证成本、评审、信任、卡住、并发;
|
|
22
|
-
- 带上口语说法:转圈、换电脑、同时、一直等;
|
|
23
|
-
- 跨领域的条目补一条 `related` 指向最相关的另一条。
|
|
24
|
-
- 不要靠往插件词表里加近义词解决召回——词表有上限。
|
|
25
|
-
7. **自我层**:只有当最近的情景记忆里出现了稳定的偏好或约束(至少两次),才提议改 `self.md`。把提议原文列在结论里,**等我确认**;不要自己直接改。
|
|
26
|
-
8. **提交**:`git add -A && git commit -m "consolidate: YYYY-MM-DD" && git push`。推送失败就保留本地提交并说明。
|
|
27
|
-
|
|
28
|
-
结论用不超过 8 行汇报:合并了几条、删了几条、改了哪些 `cues`、有没有需要我确认的自我层提议、推送是否成功。
|
|
1
|
+
# 巩固(可选、手动跑)
|
|
2
|
+
|
|
3
|
+
想把记忆仓整理一遍时,把下面整段贴进一次普通会话即可。不需要建定时任务,也不需要记忆插件参与任何代码路径——插件只负责平时的读写,巩固是模型加文件工具的活。
|
|
4
|
+
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
你要为我的记忆仓做一次每日巩固。仓库路径:`<MEMORY_REPO_PATH>`(若不确定,先 `git -C <路径> rev-parse --show-toplevel` 确认)。
|
|
8
|
+
|
|
9
|
+
**闸门(先做这一步)**:看 `.state/last-consolidate` 里记的上次巩固时间;再数 `episodic/` 下修改时间晚于它的文件。
|
|
10
|
+
如果**没有新增**,只回一行「无新经历,今日不巩固」然后结束——不要 pull、不要提交、不要读别的文件。
|
|
11
|
+
如果有新增,把这次时间写进 `.state/last-consolidate`,继续下面步骤。
|
|
12
|
+
|
|
13
|
+
**保密(硬规则,优先于其它所有步骤)**:`self.md` 里标为商业机密的范围(例如某条「不写入记忆」的约束),其具体内容一律不提炼、不概括、不写进任何一层记忆;已经存在的直接删掉。只允许保留不含细节的事实,例如「讨论过某个主题」。宁可不记,也不要留可推断的细节。
|
|
14
|
+
|
|
15
|
+
1. **同步**:`git pull --ff-only`。若失败(离线/冲突),停下并在结论里说明,不要强推。
|
|
16
|
+
2. **读**:读 `self.md`、上次巩固之后新增的 `episodic/*.md`、以及 `semantic/` 下所有文件的标题与 `cues` 行。
|
|
17
|
+
3. **合并**:把重复或高度重叠的语义条目合并成一条(保留最早日期,`related` 取并集,保留较新的正文)。情景记忆不合并,只删掉完全是噪声的条目。
|
|
18
|
+
4. **冲突**:两条记忆互相矛盾时,以更新的、且能追溯到具体会话的那条为准;被推翻的那条删掉并在新条目正文里写一句「推翻了 X(YYYY-MM-DD)」。
|
|
19
|
+
5. **遗忘**:删掉已经过期、或被后来事实否定、或只对一次性任务有意义的条目。宁可少,不要留噪声。
|
|
20
|
+
6. **提炼线索词**:这是跨领域唤起的主要手段,概念桥只是兜底。每条语义/自我记忆的 `cues` 控制在 3–8 个,写法是「我以后会怎么问这件事」,不是「这条记忆里出现了哪些词」:
|
|
21
|
+
- 抽象概念优先:可复现、降低验证成本、评审、信任、卡住、并发;
|
|
22
|
+
- 带上口语说法:转圈、换电脑、同时、一直等;
|
|
23
|
+
- 跨领域的条目补一条 `related` 指向最相关的另一条。
|
|
24
|
+
- 不要靠往插件词表里加近义词解决召回——词表有上限。
|
|
25
|
+
7. **自我层**:只有当最近的情景记忆里出现了稳定的偏好或约束(至少两次),才提议改 `self.md`。把提议原文列在结论里,**等我确认**;不要自己直接改。
|
|
26
|
+
8. **提交**:`git add -A && git commit -m "consolidate: YYYY-MM-DD" && git push`。推送失败就保留本地提交并说明。
|
|
27
|
+
|
|
28
|
+
结论用不超过 8 行汇报:合并了几条、删了几条、改了哪些 `cues`、有没有需要我确认的自我层提议、推送是否成功。
|
|
29
|
+
|
package/template/README.md
CHANGED
|
@@ -1,39 +1,40 @@
|
|
|
1
|
-
# 我的记忆仓
|
|
2
|
-
|
|
3
|
-
这是「原味记忆」(dsh-plain-memory)的记忆资产:纯 Markdown,放在你自己的**私有** Git 仓库里。
|
|
4
|
-
插件在会话开始拉取、在写完记忆后提交;推送在后台跑,不挡对话。拔掉插件,这个仓库仍然是普通 Markdown,DSH 一点没变。
|
|
5
|
-
|
|
6
|
-
## 目录
|
|
7
|
-
|
|
8
|
-
| 路径 | 层 | 放什么 |
|
|
9
|
-
|---|---|---|
|
|
10
|
-
| `self.md` | 自我 | 身份、偏好、长期约束。只有你明确确认过的内容才会写进来。 |
|
|
11
|
-
| `episodic/<日期>-<标题>-<短id>.md` | 情景 | 哪一天做了什么、结论是什么、哪里卡住了。 |
|
|
12
|
-
| `semantic/<日期>-<标题>-<短id>.md` | 语义 | 跨会话可复用的事实与方法。 |
|
|
13
|
-
| `.state/` | 运行时 | 每个窗口一张状态卡、待确认的自我层提案、健康日志。已被忽略,不进版本库。 |
|
|
14
|
-
|
|
15
|
-
**一条记忆一个文件**:两个窗口同时写不同记忆时不会互相覆盖;同一天同标题重复写入会覆盖同一个文件,不会堆出重复条目。
|
|
16
|
-
|
|
17
|
-
## 一条记忆长什么样
|
|
18
|
-
|
|
19
|
-
```md
|
|
20
|
-
### 缓存与注入
|
|
21
|
-
- id: semantic-20261113-k3f9a
|
|
22
|
-
- date: 2026-11-13
|
|
23
|
-
- session: 2026-11-13T10:00:00Z/ab12cd34
|
|
24
|
-
- cues: 注入, pre-step, 卡住, 提示缓存
|
|
25
|
-
- related: semantic-20261110-x1y2z
|
|
26
|
-
|
|
27
|
-
pre-step 瀑布里追加 user message,只追加不改前缀,所以提示缓存不失效。
|
|
28
|
-
```
|
|
29
|
-
|
|
30
|
-
`cues` 是线索词:以后你换一种说法提到它,这条记忆会被本地匹配到并注入,最多 3 条,标注为不可信任的背景。
|
|
31
|
-
写 `cues` 时想的是「我以后会怎么问」,不是「这条记忆里出现了哪些词」:优先写抽象概念(可复现、降低验证成本、信任、卡住)和口语说法(转圈、换电脑、同时)。
|
|
32
|
-
|
|
33
|
-
`related` 指向另一条记忆的 `id`,命中时允许再带一跳关联。
|
|
34
|
-
|
|
35
|
-
## 建议
|
|
36
|
-
|
|
37
|
-
- 仓库保持**私有**。这里会有你的工作习惯和项目判断。
|
|
38
|
-
-
|
|
39
|
-
- 想手动改就直接改,提交前看一眼 diff 就行;插件下次拉取会尊重你的改动。
|
|
1
|
+
# 我的记忆仓
|
|
2
|
+
|
|
3
|
+
这是「原味记忆」(dsh-plain-memory)的记忆资产:纯 Markdown,放在你自己的**私有** Git 仓库里。
|
|
4
|
+
插件在会话开始拉取、在写完记忆后提交;推送在后台跑,不挡对话。拔掉插件,这个仓库仍然是普通 Markdown,DSH 一点没变。
|
|
5
|
+
|
|
6
|
+
## 目录
|
|
7
|
+
|
|
8
|
+
| 路径 | 层 | 放什么 |
|
|
9
|
+
|---|---|---|
|
|
10
|
+
| `self.md` | 自我 | 身份、偏好、长期约束。只有你明确确认过的内容才会写进来。 |
|
|
11
|
+
| `episodic/<日期>-<标题>-<短id>.md` | 情景 | 哪一天做了什么、结论是什么、哪里卡住了。 |
|
|
12
|
+
| `semantic/<日期>-<标题>-<短id>.md` | 语义 | 跨会话可复用的事实与方法。 |
|
|
13
|
+
| `.state/` | 运行时 | 每个窗口一张状态卡、待确认的自我层提案、健康日志。已被忽略,不进版本库。 |
|
|
14
|
+
|
|
15
|
+
**一条记忆一个文件**:两个窗口同时写不同记忆时不会互相覆盖;同一天同标题重复写入会覆盖同一个文件,不会堆出重复条目。
|
|
16
|
+
|
|
17
|
+
## 一条记忆长什么样
|
|
18
|
+
|
|
19
|
+
```md
|
|
20
|
+
### 缓存与注入
|
|
21
|
+
- id: semantic-20261113-k3f9a
|
|
22
|
+
- date: 2026-11-13
|
|
23
|
+
- session: 2026-11-13T10:00:00Z/ab12cd34
|
|
24
|
+
- cues: 注入, pre-step, 卡住, 提示缓存
|
|
25
|
+
- related: semantic-20261110-x1y2z
|
|
26
|
+
|
|
27
|
+
pre-step 瀑布里追加 user message,只追加不改前缀,所以提示缓存不失效。
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
`cues` 是线索词:以后你换一种说法提到它,这条记忆会被本地匹配到并注入,最多 3 条,标注为不可信任的背景。
|
|
31
|
+
写 `cues` 时想的是「我以后会怎么问」,不是「这条记忆里出现了哪些词」:优先写抽象概念(可复现、降低验证成本、信任、卡住)和口语说法(转圈、换电脑、同时)。
|
|
32
|
+
|
|
33
|
+
`related` 指向另一条记忆的 `id`,命中时允许再带一跳关联。
|
|
34
|
+
|
|
35
|
+
## 建议
|
|
36
|
+
|
|
37
|
+
- 仓库保持**私有**。这里会有你的工作习惯和项目判断。
|
|
38
|
+
- 想整理时手动跑一次巩固:读最近的情景记忆,合并重复、解决冲突,再提炼一轮线索词。提示词见插件仓库的 `prompts/daily-consolidate.md`。不做定时任务。
|
|
39
|
+
- 想手动改就直接改,提交前看一眼 diff 就行;插件下次拉取会尊重你的改动。
|
|
40
|
+
|
package/template/self.md
CHANGED
|
@@ -1,15 +1,15 @@
|
|
|
1
|
-
# 自我
|
|
2
|
-
|
|
3
|
-
长期有效的身份、偏好与约束。只有用户明确确认过的内容才能写在这里。
|
|
4
|
-
|
|
5
|
-
<!--
|
|
6
|
-
格式与其它记忆相同:
|
|
7
|
-
|
|
8
|
-
### 偏好:先结论后证据
|
|
9
|
-
- id: self-20261113-a1b2c
|
|
10
|
-
- date: 2026-11-13
|
|
11
|
-
- session: 2026-11-13T10:00:00Z/ab12cd34
|
|
12
|
-
- cues: 表达, 汇报, 结论
|
|
13
|
-
|
|
14
|
-
汇报时先说结论,再给证据;不确定的标出来。
|
|
15
|
-
-->
|
|
1
|
+
# 自我
|
|
2
|
+
|
|
3
|
+
长期有效的身份、偏好与约束。只有用户明确确认过的内容才能写在这里。
|
|
4
|
+
|
|
5
|
+
<!--
|
|
6
|
+
格式与其它记忆相同:
|
|
7
|
+
|
|
8
|
+
### 偏好:先结论后证据
|
|
9
|
+
- id: self-20261113-a1b2c
|
|
10
|
+
- date: 2026-11-13
|
|
11
|
+
- session: 2026-11-13T10:00:00Z/ab12cd34
|
|
12
|
+
- cues: 表达, 汇报, 结论
|
|
13
|
+
|
|
14
|
+
汇报时先说结论,再给证据;不确定的标出来。
|
|
15
|
+
-->
|