dsh-engramory 1.0.5 → 1.0.7
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.en.md +14 -2
- package/README.md +4 -2
- package/client.js +713 -655
- package/index.js +3112 -2753
- package/package.json +1 -1
package/README.en.md
CHANGED
|
@@ -24,8 +24,13 @@ which is general-purpose agent memory: Claude Code, Codex and others can use the
|
|
|
24
24
|
compact; compaction still passes. Details in [How the cap decides](#how-the-cap-decides).
|
|
25
25
|
- **The rules come with it.** What to save, how, and when to clean up: the rules
|
|
26
26
|
(a skill) are registered by the plugin, with no files to install.
|
|
27
|
+
- **A reminder to save before dsh compacts.** When a conversation grows long, dsh
|
|
28
|
+
compacts what came before into a summary, which need not keep what is worth
|
|
29
|
+
remembering later. As a conversation nears that point, the plugin reminds the AI to
|
|
30
|
+
save that first; the AI is reminded, not you.
|
|
27
31
|
- **A Memory page in the sidebar.** Read-only; it lists the notes by name and opens
|
|
28
|
-
one in your computer's default app
|
|
32
|
+
one in your computer's default app, with a check-up that flags broken links in the
|
|
33
|
+
index and notes left out of it.
|
|
29
34
|
|
|
30
35
|
## Install
|
|
31
36
|
|
|
@@ -138,7 +143,13 @@ owner, so a program forwarding other people's messages must leave it out.
|
|
|
138
143
|
- **Memory page:** *Memory* in the sidebar. It lists the global store and each
|
|
139
144
|
workspace's project store (with an absolute `indexPath`, that store alone; with a
|
|
140
145
|
relative one, none), with each index's size against the cap, its notes' names
|
|
141
|
-
by type, and its archive.
|
|
146
|
+
by type, and its archive. Each store comes with a check-up: the index's links to
|
|
147
|
+
files that are not there, the notes not in the index (recall starts from the index, so
|
|
148
|
+
the AI will not find them unless another note links to them), and notes with no type.
|
|
149
|
+
It goes by file names and the index's links alone, never through a symbolic link, and
|
|
150
|
+
is skipped when the index is over the cap, there is too much to check, or a file cannot
|
|
151
|
+
be read; `engramory_doctor.py` still does the full check.
|
|
152
|
+
Read-only, never a note's text; a name, *Open the index* and
|
|
142
153
|
*Open the folder* open on the machine dsh runs on; a machine with no desktop (a
|
|
143
154
|
headless server, a session over SSH) shows none of them. The switches at the top
|
|
144
155
|
(companion mode, and memory access once it is on) save as you flip them.
|
|
@@ -165,6 +176,7 @@ caps in force. A patch replaces the row's whole `config`, so list every key you
|
|
|
165
176
|
| `indexPath` | unset | The one index to use: absolute, or relative to the session's directory. Unset, a `MEMORY.md` in any project is capped as an index; a store outside the default places also needs it to be found. |
|
|
166
177
|
| `registerSkill` | `true` | `false` skips the built-in rules; the cap and the index in context stay. |
|
|
167
178
|
| `injectIndex` | `true` | `false` stops putting the index into context; the AI reads it instead. |
|
|
179
|
+
| `compactionReminder` | `true` | `false` stops the reminder to save before dsh compacts. The plugin works out where dsh will compact from dsh's own compaction settings (on dsh 0.2 with DeepSeek's defaults, about 69% of the window, not 80%) and reminds at 85% of that. A best effort: a conversation that grows past the gap in one step goes unreminded; with no compaction, or automatic compaction off, there is no reminder. |
|
|
168
180
|
| `language` | dsh's | `zh` (or `zh-CN` and other regional forms) writes the store in Chinese: note names, headings such as `## 用户`, the Why/How labels. Any other string is English; a value that is not a string, or is empty, counts as unset. Unset, it follows dsh's language; a change applies once dsh restarts. Frontmatter keys and `type:` values stay English, so every host reads the store. |
|
|
169
181
|
| `companion` | `false` | `true` turns companion mode on. |
|
|
170
182
|
| `audience` | `private` | With companion mode on, `social` turns social mode on. |
|
package/README.md
CHANGED
|
@@ -13,7 +13,8 @@
|
|
|
13
13
|
- **每轮自动带上记忆索引。** 索引 `MEMORY.md` 只列笔记名字,插件每一步都把它放进上下文,AI 不用先读文件就知道自己记过什么,要细节再打开那条笔记。写入后下一轮就能看到;超出上限的部分不带上,并提醒 AI 压缩。
|
|
14
14
|
- **索引有硬上限。** 默认 200 行 / 25 KB。AI 用 dsh 的文件工具写索引时,只要插件算得出写完的样子,会超上限就在写入前拒绝,让它先压缩;压缩照样放行。细节见[上限怎么判](#上限怎么判)。
|
|
15
15
|
- **自带记忆规则。** 记什么、怎么记、什么时候清理,这套规则(skill)随插件注册,不用另外装文件。
|
|
16
|
-
-
|
|
16
|
+
- **快压缩时提醒 AI 存记忆。** dsh 会在对话太长时把前面压缩成摘要,摘要不一定留得下以后还用得着的东西。对话快到 dsh 要压缩的地方时,插件提醒 AI 把值得长期记住的先存进记忆;提醒的是 AI,不打扰你。
|
|
17
|
+
- **侧栏多一个「记忆」页。** 只读,列出笔记名字,点名字用电脑上的默认程序打开;顺带体检,标出索引里的坏链接和没进索引的笔记。
|
|
17
18
|
|
|
18
19
|
## 安装
|
|
19
20
|
|
|
@@ -76,7 +77,7 @@ agent.followup(createUserMessage({
|
|
|
76
77
|

|
|
77
78
|
|
|
78
79
|
- **设置页**:dsh 的「插件」页里点开「Engramory 记忆」,能改大肥鱼模式、记忆权限和索引上限。保存走 dsh 自己的配置服务,写进你 profile 的 `cordis.patch.yml` 并重新加载插件。这个接口只有登录了的你能调,AI 没法调用它关掉社交模式。
|
|
79
|
-
- **记忆页**:左侧栏「记忆」。列出全局库和各工作区的项目库(设了绝对路径的 `indexPath`
|
|
80
|
+
- **记忆页**:左侧栏「记忆」。列出全局库和各工作区的项目库(设了绝对路径的 `indexPath` 时只列那一个,相对路径则列不出),显示索引离上限还有多远、按类型分组的笔记名字和归档。每个库附一段体检:索引里指向不存在的文件、不在索引里的笔记(AI 回忆从索引开始,除非别的笔记链到它们,否则通常找不到)、没写类型的笔记。体检只按文件名和索引里的链接判断,不顺着符号链接走;索引超上限、要核对的太多或有文件读不了时不做,完整检查仍用 `engramory_doctor.py`。只读,不显示正文;点名字、「打开索引」「打开文件夹」都在运行 dsh 的那台机器上打开;没有桌面的机器(无界面服务器、SSH 连过去的)不显示这些按钮。顶部的开关(大肥鱼模式,打开后还有记忆权限)拨了就保存。
|
|
80
81
|
|
|
81
82
|
## 配置
|
|
82
83
|
|
|
@@ -98,6 +99,7 @@ agent.followup(createUserMessage({
|
|
|
98
99
|
| `indexPath` | 不设 | 只认这一个索引:绝对路径,或相对会话目录。不设时,任何项目里叫 `MEMORY.md` 的文件都按索引卡上限;记忆库不在默认位置时也要设它,否则不会自动带上。 |
|
|
99
100
|
| `registerSkill` | `true` | `false`:不注册内置的记忆规则;上限和每轮带上索引照旧。 |
|
|
100
101
|
| `injectIndex` | `true` | `false`:不再每轮带上索引,改由 AI 自己读。 |
|
|
102
|
+
| `compactionReminder` | `true` | `false`:快压缩时不再提醒 AI 存记忆。插件照 dsh 的压缩设置算出它会在哪压缩(dsh 0.2 加 DeepSeek 默认约在窗口的 69%,不是 80%),到那一点的 85% 时提醒。尽力而为:一步就涨过这段余量的对话等不到提醒;没装压缩或关了自动压缩时不提醒。 |
|
|
101
103
|
| `language` | 跟随 dsh | `zh`(`zh-CN` 等也算)用中文写记忆(笔记名、`## 用户` 这类标题、**为什么:**/**怎么用:**),其他字符串用英文;不是字符串或为空,当作没设。不设就跟 dsh 的语言,改了要重启 dsh。frontmatter 的键和 `type:` 取值始终是英文,别的宿主照样能读。 |
|
|
102
104
|
| `companion` | `false` | `true` 打开大肥鱼模式。 |
|
|
103
105
|
| `audience` | `private` | 大肥鱼模式下设 `social` 打开社交模式。 |
|