@kenz1117/dsh-engram 0.13.5 → 0.13.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/CHANGELOG.md +19 -0
- package/README.md +23 -1
- package/i18n/ru.txt +7 -0
- package/lib/client.js +1 -1
- package/lib/client.js.map +1 -1
- package/lib/index.js +271 -6
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -8,6 +8,25 @@
|
|
|
8
8
|
|
|
9
9
|
> **v0.x 阶段的版本约定**:`0.MINOR.PATCH` 里的 `MINOR` 是**功能批次**而不是稳定性刻度——0.7.x 整批是「记忆宫殿信息架构」,0.8.x 整批是「面板重构」,0.9.x 整批是「稳定性与可审计」,0.10.x 整批是「多语言与数据驱动」。同一批次内的 `PATCH` 位通常是修复与加固。
|
|
10
10
|
|
|
11
|
+
## [0.13.7] - 2026-11-07
|
|
12
|
+
|
|
13
|
+
### Fixed
|
|
14
|
+
|
|
15
|
+
- **`reflect: 'suggest'` 的巩固循环是断的(#50)**:会话结束登记 `reflect-pending`,但没有任何机制提醒 agent 调用 `engram_reflect`——登记永远躺在库里,记忆只进不出整理。现在待巩固提醒骑画像包注入(与「今日到期」同法):会话开始与压缩重注时若存在登记,包尾附一行提示调用 `engram_reflect`;工具消费后计数归零,hash 变化自然触发重注撤掉提醒。新增配置 `reflectReminder`(默认 true)可关。提醒只数当前工作区的两个库(user + 当前项目库),其它项目库由它们自己的会话提醒。
|
|
16
|
+
|
|
17
|
+
### Added
|
|
18
|
+
|
|
19
|
+
- **「只摄取不整理」的组合守卫(#50)**:`ingest` 开启而 `reflect` 为 `off` 时——记忆只收集不蒸馏、读起来就是散的——启动日志明确告警,面板「系统 · 运行时」同步提示(`GET /api/engram/version` 现在带出 ingest/reflect 档位,旧客户端忽略未知字段)。
|
|
20
|
+
- **README 推荐组合表**:按使用方式(编程为主 / 写作文书 / 轻量试用 / 手动管理)各给一行可直接抄的 `ingest`+`reflect` 配置;「记忆散」的最常见成因(巩固没开、巩固路由用了轻量模型)写在表前。新增「升级」一节:市场/命令行的跨来源保护、「允许构建脚本」提示的真相(只影响可选 CUDA 件)、模型缓存跨升级持久。
|
|
21
|
+
|
|
22
|
+
## [0.13.6] - 2026-11-06
|
|
23
|
+
|
|
24
|
+
### Fixed
|
|
25
|
+
|
|
26
|
+
- **数据目录不再无视 `DSH_HOME`(#51)**:`dbDir` 默认值此前写死 `~/.dsh/engram`,而宿主把用户数据放在 `$DSH_HOME`(缺省 `~/.dsh`)。把 home 搬到别的盘之后,记忆库、词典与模型缓存仍然静默留在旧盘上——人以为在用新盘,插件读的是旧盘。现在默认值跟着 `$DSH_HOME` 走(契约与宿主的 `@deepseek-ai/dsh-home-paths` 一致:显式值 > `$DSH_HOME` > `~/.dsh`,空白视同未设置);显式写了 `dbDir` 的人不受影响。
|
|
27
|
+
- **旧目录收编,避免库静默分裂**:默认值改跟 home 之后,旧盘上还留着的库会变成「另一处的一份」——插件读新盘,人以为记忆丢了。插件启动时先把 `~/.dsh/engram` 收编过来:同盘直接改名,跨盘先复制到临时目录、逐个文件核对大小再改名并删旧;两边都有库时不自动合并(继续用旧目录并报出两个路径),搬运失败也继续用旧目录——数据看不见比数据待在新盘上更糟。每个结局都写进启动日志。`legacyMigration: conservative` 只报不动。
|
|
28
|
+
- **面板说清数据在哪儿**:「系统 · 存储」同时报出数据目录与宿主数据根,库不在 home 之下时明确提示(此前这件事完全静默,只能去读源码才知道)。
|
|
29
|
+
|
|
11
30
|
## [0.13.5] - 2026-11-06
|
|
12
31
|
|
|
13
32
|
### Fixed
|
package/README.md
CHANGED
|
@@ -64,6 +64,13 @@ dsh plugin --profile web add @kenz1117/dsh-engram
|
|
|
64
64
|
确认已注册 23 个 engram_* 工具。
|
|
65
65
|
```
|
|
66
66
|
|
|
67
|
+
## 升级
|
|
68
|
+
|
|
69
|
+
- **用哪个入口装,就用哪个入口升**:市场里装的就一直在市场里更新;命令行 `dsh plugin add` 装的就继续用命令行。两边混用会碰到市场的跨来源保护——它提示「先卸载,再从市场安装」时照做即可,这是防止把不同来源的同名插件互相覆盖的设计,记忆数据在数据目录里,不受卸载影响。
|
|
70
|
+
- **安装或更新时若出现「允许构建脚本并重试」**:pnpm 默认拦截依赖的构建脚本,本插件依赖树里唯一带构建脚本的是嵌入引擎的原生件(onnxruntime-node)——它只下载可选的 CUDA 加速件,插件实际使用的 CPU/DirectML 二进制随包分发。**点了能过;不点通常也不影响使用**。
|
|
71
|
+
- **模型缓存跨升级持久**(`<dbDir>/models`),升级不重复下载模型;0.13.6 起数据目录默认跟随 `$DSH_HOME`,换盘搬家不再把库留在旧盘。
|
|
72
|
+
- 升级后打开面板「系统 · 运行时」即可核对插件/面板版本是否一致(不一致会挂重启横幅)。
|
|
73
|
+
|
|
67
74
|
## 为什么是它
|
|
68
75
|
|
|
69
76
|
记忆插件不少,但多数要你先准备一整套基础设施。这里是三条主流路线与本插件的对照(对照对象为各项目公开 README 与 npm 依赖声明):
|
|
@@ -203,11 +210,13 @@ DeepSeek Harness 跨会话长期记忆插件 —— 把记忆宫殿的**信息
|
|
|
203
210
|
|
|
204
211
|
可选配置(cordis.yml):
|
|
205
212
|
|
|
213
|
+
> **数据目录跟宿主数据根走**:不写 `dbDir` 时,插件用宿主的数据根 `$DSH_HOME`(缺省 `~/.dsh`)下的 `engram/`——和会话、配置、其它插件的数据放在同一个根里。把 `DSH_HOME` 搬到别的盘,记忆库也跟着搬。若旧目录 `~/.dsh/engram` 里还留着库,插件启动时先把它收编过来(同盘直接改名、跨盘复制后校验再删旧),并把结果写进启动日志;显式写了 `dbDir` 的人不受影响,那一行说了算。面板「系统 · 存储」会同时报出数据目录与宿主数据根,库不在 home 之下时会明确提示。
|
|
214
|
+
|
|
206
215
|
```yaml
|
|
207
216
|
- id: dsh-engram
|
|
208
217
|
name: '@kenz1117/dsh-engram'
|
|
209
218
|
config:
|
|
210
|
-
dbDir: '~/.dsh/engram' #
|
|
219
|
+
dbDir: '~/.dsh/engram' # 分库与模型缓存根目录;不写则默认 $DSH_HOME/engram
|
|
211
220
|
injectProfile: true # 会话开始注入用户画像摘要
|
|
212
221
|
profileTopN: 8 # 注入条数上限(1-64)
|
|
213
222
|
injectTokenBudget: 1024 # 注入 token 预算(128-8192,中文按 1.5 token/字、其余按 4 字符/token 估算,装不下的条目降级为索引行)
|
|
@@ -266,6 +275,19 @@ DeepSeek Harness 跨会话长期记忆插件 —— 把记忆宫殿的**信息
|
|
|
266
275
|
|
|
267
276
|
**面板访问面(`panelAccess`,#49)**:面板 API 默认只接受本机回环(peer socket + Host 头双校验,写操作再校验 Origin 与 Content-Type)。手机或局域网其他设备要看记忆宫殿时,把 `panelAccess: 'lan'` 与宿主 webServer 的 `host: 0.0.0.0` 一起打开:私网 peer(RFC1918 / IPv6 ULA / 链路本地)即可访问,Host/Origin 接受字面 IP、localhost、单标签名与 `*.local`(多标签域名仍拒,防 DNS rebinding)。公网 IP 任何档位都拒绝——公网暴露请走反向代理到回环上游(此时无需改任何配置)。API 没有鉴权,`lan` 档等于把记忆库的读写向整个局域网公开,只应在信任的家庭/办公网开启。
|
|
268
277
|
|
|
278
|
+
### 推荐组合(按使用方式抄一行)
|
|
279
|
+
|
|
280
|
+
记忆的「成条」程度由摄取与巩固两段共同决定:**摄取**抓素材,**巩固**把素材蒸馏成规律。只开摄取不开巩固,一周后的记忆就是散的——这是最常见的失望来源。
|
|
281
|
+
|
|
282
|
+
| 使用方式 | 建议配置 | 说明 |
|
|
283
|
+
|---|---|---|
|
|
284
|
+
| **编程为主**(FastAPI/Vue 这类项目开发) | `ingest: 'eager'` + `reflect: 'auto'` | 每轮抓用户+助手消息(≤5 条),会话结束自动蒸馏成项目规律/决策;项目库按仓库隔离,跨会话续接 |
|
|
285
|
+
| **写作 / 文书整理** | `ingest: 'light'` + `reflect: 'auto'` | 只抓用户消息(≤2 条/轮),减少噪声;巩固把偏好与约定蒸馏成画像与信念 |
|
|
286
|
+
| **轻量试用** | `ingest: 'light'` + `reflect: 'suggest'` | suggest 在会话结束时登记待巩固并在下次会话开始提醒 agent 调用 `engram_reflect`——不想让后台自动跑 LLM 时用这个 |
|
|
287
|
+
| **只想手动管理** | `ingest: 'off'` + 工具调用 | 由 agent 用 `engram_save` / `engram_update` 显式写入;其余全关 |
|
|
288
|
+
|
|
289
|
+
巩固与蒸馏走辅助 LLM 路由(缺省从会话日志解析):**轻量档模型(如 flash 类)的蒸馏质量有限**,记忆散时先换强一点的模型跑几天 `reflect`,再评价插件。
|
|
290
|
+
|
|
269
291
|
## 工作原理
|
|
270
292
|
|
|
271
293
|
插件由宿主半(Node)与浏览器半(React)组成:
|
package/i18n/ru.txt
CHANGED
|
@@ -5,6 +5,8 @@
|
|
|
5
5
|
// \/ → косая черта в начале левой части. Строка с // в начале — комментарий.
|
|
6
6
|
|
|
7
7
|
// ==== core ====
|
|
8
|
+
\nConsolidation pending: {count} session registration(s) hold memories not yet distilled. Call engram_reflect to consolidate them — ingested memories stay scattered until reflected. Ожидает обобщения: {count} регистраций сессий с ещё не перегнанными воспоминаниями. Вызовите engram_reflect — без обобщения память остаётся разрозненной.
|
|
9
|
+
[dsh-engram] ingest is on but reflect is off — memories accumulate without consolidation (they read scattered). Set reflect: auto (or suggest), or run engram_reflect regularly. [dsh-engram] ingest включён, но reflect выключен — воспоминания копятся без обобщения (и читаются разрозненно). Включите reflect: auto (или suggest), либо регулярно вызывайте engram_reflect.
|
|
8
10
|
User memory profile (dsh-engram, cross-session) — Grand Hall (always present): Профиль памяти пользователя (dsh-engram, межсессионный) — Большой зал (присутствует всегда):
|
|
9
11
|
Use engram_search to recall details (pass room to search inside one room); use engram_save to persist new facts. Для подробностей используйте engram_search (room ищет внутри одной комнаты); для сохранения новых фактов — engram_save.
|
|
10
12
|
Curated profile (user-maintained via engram_profile_edit; authoritative over derived facts): Курируемый профиль (ведётся пользователем через engram_profile_edit; главнее выведенных фактов):
|
|
@@ -124,6 +126,11 @@ invalid: jev.timeoutMs must be an integer number of milliseconds between 1000 an
|
|
|
124
126
|
[dsh-engram] The model registry skipped {count} problem line(s): {sample} [dsh-engram] Реестр моделей: пропущено строк с замечаниями — {count}; {sample}
|
|
125
127
|
|
|
126
128
|
// ==== store ====
|
|
129
|
+
[dsh-engram] the data directory moved with the harness home to {to} (was {from}); memories, dictionaries and the model cache moved along. [dsh-engram] каталог данных переехал вместе с домом Harness в {to} (был {from}); воспоминания, словари и кэш моделей переехали тоже.
|
|
130
|
+
[dsh-engram] the data directory was copied to {to} (was {from}; a cross-device move cannot be a rename); the old directory was removed after verification. [dsh-engram] каталог данных скопирован в {to} (был {from}; перенос между дисками не может быть переименованием); старый каталог удалён после проверки.
|
|
131
|
+
[dsh-engram] conservative mode deferred the adoption: the data is still in {from}, and that directory is used for now. [dsh-engram] conservative-режим отложил перенос: данные всё ещё в {from}, пока используется этот каталог.
|
|
132
|
+
[dsh-engram] both locations hold memory databases ({from} and {to}); nothing was merged automatically, the old directory {from} is used for now — confirm and clean up by hand. [dsh-engram] в обоих местах есть базы памяти ({from} и {to}); автоматического слияния не было, пока используется старый каталог {from} — проверьте и уберите лишнее вручную.
|
|
133
|
+
[dsh-engram] the data directory adoption failed ({from} → {to}): {detail}; the old directory is used for now and no data was lost. [dsh-engram] не удалось перенести каталог данных ({from} → {to}): {detail}; пока используется старый каталог, данные не потеряны.
|
|
127
134
|
engram database schema version {found} is newer than the version supported by the plugin ({supported}): upgrade the plugin, or back up and delete the old database file ({path}) Версия schema базы engram {found} выше поддерживаемой плагином ({supported}): обновите плагин либо сделайте резервную копию и удалите старый файл базы ({path})
|
|
128
135
|
engram database schema version {found} cannot be upgraded to {supported} (migration step missing): back up and delete the old database file ({path}), then retry Версию schema базы engram {found} нельзя поднять до {supported} (нет шага миграции): сделайте резервную копию, удалите старый файл базы ({path}) и повторите
|
|
129
136
|
content must not be empty content не может быть пустым
|