@kenz1117/dsh-engram 0.13.6 → 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 CHANGED
@@ -8,6 +8,17 @@
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
+
11
22
  ## [0.13.6] - 2026-11-06
12
23
 
13
24
  ### 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 依赖声明):
@@ -268,6 +275,19 @@ DeepSeek Harness 跨会话长期记忆插件 —— 把记忆宫殿的**信息
268
275
 
269
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` 档等于把记忆库的读写向整个局域网公开,只应在信任的家庭/办公网开启。
270
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
+
271
291
  ## 工作原理
272
292
 
273
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; главнее выведенных фактов):