@kenz1117/dsh-engram 0.11.5 → 0.12.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/CHANGELOG.md +42 -2
- package/README.md +3 -0
- package/i18n/panel.ru.txt +6 -0
- package/i18n/ru.txt +4 -0
- package/lib/client.js +2 -2
- package/lib/client.js.map +1 -1
- package/lib/index.js +1352 -326
- package/package.json +6 -6
- package/registry/schema.json +5 -1
package/CHANGELOG.md
CHANGED
|
@@ -8,7 +8,45 @@
|
|
|
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
|
-
## [
|
|
11
|
+
## [0.12.0] - 2026-11-06
|
|
12
|
+
|
|
13
|
+
### Added
|
|
14
|
+
|
|
15
|
+
- **0.12.0 工程契约**:新增 `docs/engram-0.12.0.md`,冻结稳定身份/修订、统一写边界、曝光与有效反馈分离、session 隔离、持久作业、v13 数据迁移与回退、真实观测和分阶段验收口径。
|
|
16
|
+
- **稳定逻辑身份(schema v15)**:`MemoryRecord` 新增 `memoryId`;存量库 v14→v15 自动补齐 `memory_id=id`,更新继承稳定身份,`nodes.id` 保留为 revision id。新增 `getMemory(memoryId)` 解析当前修订,`updateMemory` 可按 revision id 或稳定身份定位;修订链按 `memory_id` 聚合,任一 revision 可看完整历史。归因与注入快照使用稳定身份,导出/导入保留 `memoryId`。同一稳定身份至多一个 active:restore 旧 revision 会先归档其余 active 兄弟并重建 supersedes 方向。升版快照改用 `VACUUM INTO` 生成一致性文件,不再直接拷贝可能缺 WAL 尾巴的主文件。
|
|
17
|
+
- **v13 全保真迁移演练**:新增真实 v13 形态 SQLite fixture(无 `memory_id`、无 `injection_snapshots`),覆盖全部业务域与状态键;验证升级后行数、稳定身份、修订链、FTS、时间线、画像版本、事实链、信念证据和 v14 快照写入,并演练 `.pre-migration` 原库回退。
|
|
18
|
+
- **本地评测基线**:新增 `src/evaluation/recall.ts` 与确定性 DSH 工作流 fixture,覆盖 Recall@k / Hit@k / MRR、知识更新返回当前修订、episode 时间线过滤与时间顺序、无关查询拒答和稳定身份 provenance;注入回放校验 API packet 与实际 packet 逐字一致。v15 关键词降级基线已记录在 `docs/evaluation-baseline-v15.md`。
|
|
19
|
+
- **Injection Snapshot(schema v14)**:新增 `injection_snapshots`,持久化实际交给宿主的最终注入包、SHA-256、入选记忆 ID、curated 标记、compaction 计数与时间;`GET /api/engram/injections` 只返回 head,`GET /api/engram/injection` 按 id 返回完整正文,为后续召回台和逐字回放提供事实源。
|
|
20
|
+
- **上下文回放工作面**:面板新增「上下文回放」页,按 scope 与 sessionId 过滤注入历史;列表只取 head(时间、session、包大小、短哈希、入选数、压缩数),详情按 id 按需读取完整最终包、完整 SHA-256 与稳定记忆 ID。UI 不重建相似文本,直接展示 `packet` 事实源;zh/en/ru 文案齐备。
|
|
21
|
+
- **召回台 provenance 与矛盾治理**:召回测试台命中行新增稳定身份、revision ID 和“查看铭牌”入口。新增治理队列 `GET/POST /api/engram/governance` 与 store 层 `listContradictions/resolveContradiction`:只列双侧 active 的 contradicts 边,支持「改判为相关」(保留两条并写 governance 审计)与「闭馆指定侧」(软删并触发证据死亡传播)。走廊页新增治理卡片,处置前完整展示两条记忆与稳定 ID;zh/en/ru 齐备。
|
|
22
|
+
- **Durable Jobs**:新增独立 `jobs.db` 与租约式作业队列(幂等入队、attempts、runAfter、checkpoint、dead-letter、过期租约恢复)。`reflect: 'auto'` 从 fire-and-forget 改为持久入队和串行 worker:120 秒执行预算、180 秒租约,启动时自动接管上一进程遗留/过期 running 作业,卸载时取消在途执行并保留可恢复状态;`suggest` 行为不变。作业 ID 带 dispose 事件水位,恢复会话的新内容不会因旧 done/dead 占用 ID 而丢失;损坏队首隔离为 dead;done/dead 与 injection snapshots 均按 366 天保留窗口清理。
|
|
23
|
+
|
|
24
|
+
### Changed
|
|
25
|
+
|
|
26
|
+
- **统一记忆更新命令**:工具 `engram_update` 与面板 `POST /update` 共用 application command,集中执行协议剥离、密钥脱敏、kind/importance 合并和重嵌。`UpdateInput.embedding` 新增 `null` 语义:内容变化但 embedder 不可用时作废旧向量,不再让旧正文语义继续命中。
|
|
27
|
+
- **检索曝光与有效反馈分离**:`search()` 不再修改 `confidence`、`accessCount` 或 `lastAccessedAt`,多查询不再形成自我强化环。每次检索只写一行 `search-exposure` 审计(去重命中 ID、scope、limit、degraded 与不可逆查询摘要);`reportOutcome` / `reinforce` 继续作为独立真实反馈通道。
|
|
28
|
+
- **注入状态按 session 隔离**:画像去重、compaction 计数、证据提醒和会话路由不再共享进程级单槽;会话销毁时清理对应状态,历史任务仅保留独立的最近路由视图。
|
|
29
|
+
|
|
30
|
+
### Fixed
|
|
31
|
+
|
|
32
|
+
- `injectProfile: false` 在自动摄取开启时不再意外注入画像;画像与摄取均关闭时,证据提醒仍可独立注册。选择理由和复习到期提示现在进入实际注入包,不再只参与 hash。
|
|
33
|
+
- 末轮摄取的空答案、不可解析输出和全候选异常失败统一落 pending;恢复后写 done,重复执行保持幂等。低活动、无内容等确定性跳过不误入重试队列。
|
|
34
|
+
|
|
35
|
+
### Security
|
|
36
|
+
|
|
37
|
+
- Jev endpoint override 仅允许与 provider 已配置 `baseURL` 同源的 http(s) 地址;跨 origin 明确拒绝,不再把宿主 Bearer 凭据发往面板调用方指定的任意服务。同源自定义路径保持可用,userinfo、异协议与异端口均在拒绝范围内。
|
|
38
|
+
|
|
39
|
+
## [0.11.6] - 2026-11-06
|
|
40
|
+
|
|
41
|
+
### Added
|
|
42
|
+
|
|
43
|
+
- **#49(面板访问面开关)**:新增配置 `panelAccess: 'loopback' | 'lan'`(默认 `loopback`,行为不变)。`lan` 档在宿主 webServer 绑定 `0.0.0.0` 时放行私网访问面板 API:peer 放行 RFC1918(10/8、172.16/12、192.168/16)、IPv6 ULA(fc/fd)与链路本地(fe80-febf)及 mapped 地址;Host/Origin 放宽到字面 IP、localhost、单标签名、`*.local`(多标签域名仍拒,防 DNS rebinding);公网 IP 任何档位都拒——公网暴露走反代到回环上游。附修:带方括号的 IPv6 Host(`[::1]:5655`)此前必被 403,现正确放行。API 无鉴权,LAN 档等于把记忆库读写在信任的局域网内公开,请勿在不可信网络开启。
|
|
44
|
+
- **#48(信念人工更正入口)**:新增 `POST /api/engram/observation-status`(active=确认维持 / refuted=否定 / stale=标待复核,404/400 纯英文错误与邻居路由同款);面板信念卡片按状态给操作——active 可「作废」(两次点击确认,同日志清理模式)、stale 可「作废/恢复」、refuted 可「恢复」,成功局部刷新 + Toast,中/英/俄三语齐备。
|
|
45
|
+
|
|
46
|
+
### Fixed
|
|
47
|
+
|
|
48
|
+
- **#48(信念层减法:证据死亡传播)**:源记忆被遗忘/取代/蒸馏归档/衰减归档时,以它为证据的信念此前永远保持 active、proof_count 不减——矛盾信念长期并存且注入每轮上下文(fgql 实测:错的名字信念 proofCount 2 > 正确的 1)。现在四条归档路径统一反查 `sources_json`:摘除死源并扣减 proof_count,证据耗尽置 refuted(刷 updated_at),尚有余证置 stale 待复核(不刷 updated_at,复核队列顺序语义不变);restore 有意不联动(节点复活,信念保持既有状态等下次复核确认)。
|
|
49
|
+
- **message 字典门禁红灯(v0.11.4 遗留,0.11.5 带红发版)**:#45 批次新增的 `tool.reflectDropped` 缺俄语翻译、`core.warnReflectBatchDropped` 有词条但从未被代码接线——`check-messages` 门禁自 0.11.4 起在 main 与 v0.11.5 tag 上都是红的。现在补齐 ru 词条、把丢弃计数接到会话结束后台巩固的告警处(此前 `dropped > 0` 时 console 完全沉默),门禁恢复绿。
|
|
12
50
|
|
|
13
51
|
## [0.11.5] - 2026-11-02
|
|
14
52
|
|
|
@@ -390,7 +428,9 @@
|
|
|
390
428
|
|
|
391
429
|
- 首个可用版本:`engram_*` 工具集、插件入口、画像注入、SQLite + FTS5 + 关系边 + op log 的本地存储。
|
|
392
430
|
|
|
393
|
-
[Unreleased]: https://github.com/kenz1117/dsh-engram/compare/v0.
|
|
431
|
+
[Unreleased]: https://github.com/kenz1117/dsh-engram/compare/v0.12.0...HEAD
|
|
432
|
+
[0.12.0]: https://github.com/kenz1117/dsh-engram/compare/v0.11.6...v0.12.0
|
|
433
|
+
[0.11.6]: https://github.com/kenz1117/dsh-engram/compare/v0.11.5...v0.11.6
|
|
394
434
|
[0.11.5]: https://github.com/kenz1117/dsh-engram/compare/v0.11.4...v0.11.5
|
|
395
435
|
[0.11.4]: https://github.com/kenz1117/dsh-engram/compare/v0.11.3...v0.11.4
|
|
396
436
|
[0.11.3]: https://github.com/kenz1117/dsh-engram/compare/v0.11.2...v0.11.3
|
package/README.md
CHANGED
|
@@ -241,6 +241,7 @@ DeepSeek Harness 跨会话长期记忆插件 —— 把记忆宫殿的**信息
|
|
|
241
241
|
queryRewrite: true # engram_search 用辅助 LLM 改写 ≤3 个查询做 RRF 融合(失败自动降级单查询)
|
|
242
242
|
autoSlot: true # 写入期自动排桩(按 kind 分房、钉「房间#桩位」坐标、登记巡游路线)
|
|
243
243
|
reviewScheduling: true # 写入期自动排入复习调度(1 天后首次到期;关则新条目不进 SM-2 队列)
|
|
244
|
+
panelAccess: 'loopback' # 面板 API 访问面:loopback 仅本机回环(默认)| lan 放行私网(见下方说明)
|
|
244
245
|
# 历史回填默认规则(面板/工具的初始值;总轮数上限是硬顶,按次只能调低)
|
|
245
246
|
historyBackfillDays: 7 # 默认时间窗天数,0 = 不限
|
|
246
247
|
historyBackfillMaxTurnsPerSession: 20 # 单个会话默认最多摄取轮数
|
|
@@ -263,6 +264,8 @@ DeepSeek Harness 跨会话长期记忆插件 —— 把记忆宫殿的**信息
|
|
|
263
264
|
# 以上 enabled/provider/model/endpoint/timeoutMs 五项可在管理面板「裁决」tab 覆盖(存 <dbDir>/jev-config.json,字段级覆盖,保存即时生效);三阈值仅此处可配。令牌不是插件设置:调用时从所选提供商的密钥库解析,插件手里没有可掩码、可同步、可轮换的副本。此处或覆盖文件中遗留的 apiKey/baseUrl 会被忽略,并给出一次性告警,指明字段与密钥的去处
|
|
264
265
|
```
|
|
265
266
|
|
|
267
|
+
**面板访问面(`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
|
+
|
|
266
269
|
## 工作原理
|
|
267
270
|
|
|
268
271
|
插件由宿主半(Node)与浏览器半(React)组成:
|
package/i18n/panel.ru.txt
CHANGED
|
@@ -55,3 +55,9 @@ Label written: {label} Метка записана: {label}
|
|
|
55
55
|
Could not write the base label Не удалось записать метку базы
|
|
56
56
|
bases do not exist yet: {n} — the author's code creates them баз ещё нет: {n} — их создаёт код автора
|
|
57
57
|
The schema declaration did not load: base states are unknown. Объявление схемы не прочитано: состояние баз неизвестно.
|
|
58
|
+
Action failed: {msg} Не удалось выполнить: {msg}
|
|
59
|
+
Refute Опровергнуть
|
|
60
|
+
Click again to refute Нажми ещё раз для опровержения
|
|
61
|
+
Restore Восстановить
|
|
62
|
+
Belief refuted Убеждение опровергнуто
|
|
63
|
+
Belief restored Убеждение восстановлено
|
package/i18n/ru.txt
CHANGED
|
@@ -46,6 +46,7 @@ embedding vector contains a non-finite component (NaN/∞); the write is refused
|
|
|
46
46
|
[dsh-engram] Automatic ingest of this turn failed (skipped, conversation unaffected): [dsh-engram] Автоматическое извлечение этого хода не удалось (пропущено, диалог не затронут):
|
|
47
47
|
[dsh-engram] History backfill failed: [dsh-engram] Заполнение истории не удалось:
|
|
48
48
|
[dsh-engram] Session-end finalisation threw (conversation unaffected): [dsh-engram] Ошибка завершающей обработки при закрытии сессии (диалог не затронут):
|
|
49
|
+
[dsh-engram] Could not persist the injection snapshot (conversation unaffected): [dsh-engram] Не удалось сохранить снимок внедрения (диалог не затронут):
|
|
49
50
|
[dsh-engram] Belief consolidation at session end threw ({scope}, conversation unaffected): [dsh-engram] Ошибка закрепления убеждений при закрытии сессии ({scope}, диалог не затронут):
|
|
50
51
|
[dsh-engram] Startup decay scheduling failed (skipped): [dsh-engram] Не удалось запустить затухание при старте (пропущено):
|
|
51
52
|
[dsh-engram] Periodic decay scheduling failed (skipped): [dsh-engram] Периодическое затухание не удалось (пропущено):
|
|
@@ -518,3 +519,6 @@ Jev: provider "{provider}" has no key (credential "{ref}" is empty) Jev: у пр
|
|
|
518
519
|
Jev: no provider — neither the panel, nor the plugin settings, nor the session route names one Jev: провайдер не назван — ни панель, ни настройки плагина, ни маршрут сессии его не указывают
|
|
519
520
|
Jev: provider "{provider}" has no JEV model in its DSH settings; name the model explicitly Jev: у провайдера «{provider}» нет JEV-модели в настройках DSH; назовите модель явно
|
|
520
521
|
invalid: jev.endpoint must be an http(s) URL некорректно: jev.endpoint должен быть http(s)-адресом
|
|
522
|
+
Jev: endpoint must share the origin of provider "{provider}" baseURL; refusing to send host credentials to another service Jev: endpoint должен иметь тот же origin, что и baseURL провайдера «{provider}»; отправка учётных данных хоста другому сервису запрещена
|
|
523
|
+
[dsh-engram] Belief consolidation dropped {count} candidates (output budget/parse failure; not consolidated, will be picked up next consolidation) [dsh-engram] Закрепление убеждений отбросило {count} кандидатов (бюджет вывода/сбой разбора; не закреплены, доберут при следующем закреплении)
|
|
524
|
+
Additionally, {count} candidates were dropped (output budget/parse failure; not consolidated, rerun to pick up). Кроме того, {count} кандидатов было отброшено (бюджет вывода/сбой разбора; не закреплены — перезапустите, чтобы добрать).
|