@restregular/dsh-memory 0.11.0 → 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 +44 -0
- package/README.md +47 -9
- package/lib/client.js +481 -1
- package/lib/inject/apply.js +406 -114
- package/lib/inject/audit-types.js +219 -0
- package/lib/inject/audit.js +298 -55
- package/lib/inject/inject.js +72 -10
- package/lib/inject/rules-delta.js +58 -33
- package/lib/inject/rules.js +43 -23
- package/lib/panel.js +206 -6
- package/lib/provider/apply.js +7 -0
- package/lib/provider/index.js +181 -8
- package/lib/provider/scope.js +61 -1
- package/lib/tools/index.js +4 -4
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -2,6 +2,50 @@
|
|
|
2
2
|
|
|
3
3
|
本项目的版本记录。安装 id 与 npm 版本一一对应。
|
|
4
4
|
|
|
5
|
+
## 0.12.0 — 注入审计 v2
|
|
6
|
+
|
|
7
|
+
- **审计 schema v2**:事件统一带 `schemaVersion / id / seq / at / kind / channel / stage / outcome / reasonCode`,
|
|
8
|
+
区分 `evaluation / delivery / signal / lifecycle / error`;新增 `filter`、`sourceLoad`、`limits`、`scopes`、
|
|
9
|
+
`delivery`、`rules.injectedIds/omittedIds` 等可核对字段。旧字段仍保留兼容。
|
|
10
|
+
- **评估与投递分离**:评估先收集,最终消息通过保护检查后再写 `delivery`。宿主没有回执时记
|
|
11
|
+
`delivery.status="unknown"`(面板显示“已准备(投递未确认)”),不把评估中的“选中”说成“已投递”;
|
|
12
|
+
被重复保护/格式保护拦下时记 `suppressed` / `rejected` 与原因。
|
|
13
|
+
- **失败与跳过可见**:摘要加载失败、规则加载失败、无候选、全部超预算、标签过滤、退役排除、同一 query 跳过、
|
|
14
|
+
关闭开关、空 query、compaction 都留下事件或明确计数,不再静默消失。
|
|
15
|
+
- **安全边界统一**:信号观察也走 `sanitizeAuditText`;先限制扫描长度再脱敏,最后截 200 字。审计不再保存原始
|
|
16
|
+
`signal.query`。面板仍只暴露脱敏后的文本/哈希/字符数。
|
|
17
|
+
- **有界存储**:全局容量 2000、每会话 200,优先保留 digest / rules / delivery / error;暴露
|
|
18
|
+
`capacity / dropped / writeErrors / persistence`,容量淘汰可解释。仍为内存模式,重启后丢失,文档与 UI 均明确提示。
|
|
19
|
+
- **类型化 sink / 生命周期**:provider 支持 `injectAuditPage / injectAuditStats / detachInjectAudit`;
|
|
20
|
+
注入半边 dispose 时按 sink 身份解绑,provider 退出时释放,避免面板读到已停止更新的旧 store。
|
|
21
|
+
- **面板 API**:`GET /audit` 支持 `session / trace / operation / memory / channel / trigger / outcome / problem /
|
|
22
|
+
since / until / limit / cursor`,稳定 `seq` 游标分页;新增 `/audit/stats` 与 `/audit/export`(JSON/JSONL,
|
|
23
|
+
导出当前筛选)。旧的 `?session=` 调用保持兼容。
|
|
24
|
+
- **独立「审计」标签页**:事件流、概览统计、筛选工具栏、分页、详情抽屉(作用域/限制/过滤/省略/预算/投递/错误/
|
|
25
|
+
原始 JSON)、复制 ID/JSON、导出、真实空状态与内存模式/丢弃/写入失败提示。
|
|
26
|
+
- **测试**:新增 apply 审计链路测试(stub 宿主 `createUserMessage`)、store v2 / 分页 / 副本 / 脱敏测试、
|
|
27
|
+
API v2 / 导出 / store 解耦测试、provider 解绑与透传测试、审计标签页渲染测试。全量 322 项中 321 通过(1 跳过)。
|
|
28
|
+
|
|
29
|
+
## 0.11.1 — 项目作用域路径写法统一
|
|
30
|
+
|
|
31
|
+
- **事故**:0.7.0 引入 `memory_save({ path })` 时只削掉末尾分隔符,于是 Windows 上 `D:/repo` 与
|
|
32
|
+
`D:\repo` 算成两个 `project:` 键、落成两个 scope 文件(sha1 不同)。写入用的是正斜杠,
|
|
33
|
+
而会话读路径用的是宿主给的 `header.cwd`(反斜杠),那份记忆在工作区里**永远读不到**,
|
|
34
|
+
面板/清单里还会出现两个同名绝对路径。
|
|
35
|
+
- **写路径统一**:`canonicalWorkspacePath()` 只做"绝不可能指向另一个目录"的改写 ——
|
|
36
|
+
Windows 绝对路径统一分隔符、消掉 `.`/`..` 与末尾分隔符、盘符大写;POSIX 路径原样;
|
|
37
|
+
非绝对路径不动(不拿 profile 目录去猜)。工具 `path` 参数、显式 `project:<路径>`、
|
|
38
|
+
宿主会话 cwd 三处都过这一遍,读写口径一致。
|
|
39
|
+
- **历史数据自愈**:启动(Cordis 装配)时 `reconcileScopes()` 按 `projectScopeIdentity()`
|
|
40
|
+
把"同一目录的不同写法"并到规范键:记录按 id 迁移(向量维度匹配时一起搬)、别名跟着走、
|
|
41
|
+
迁空的 scope 文件由 flush 删除。只有变体存在时也会改名,否则会话读规范键仍然看不到。
|
|
42
|
+
每进程只跑一次;多进程并发由 flush 的"锁内重读 + 只合并本进程增量"兜底。
|
|
43
|
+
- **读路径**:`listSync`(注入用)也过规范化,避免"工具读得到、注入读不到"。
|
|
44
|
+
- 新增 `scope-path-variants.test.ts`(写法归一、`path` 参数、历史分叉合并、`discoverScopes` 顺带合并)
|
|
45
|
+
并调整既有导入/导出测试到规范写法。
|
|
46
|
+
- 已知限制:仅大小写不同的项目键(`D:\Repo` vs `D:\repo`)不会在写入时折叠,按记录数归到同一个
|
|
47
|
+
scope 后,下次启动若出现新的写法差异仍会再合并一次;分隔符差异(本次事故)已完全统一。
|
|
48
|
+
|
|
5
49
|
## 0.11.0 — 更名「记忆系统」+ README 重写
|
|
6
50
|
|
|
7
51
|
- 插件显示名从「长期记忆」改为「记忆系统」(en: **Memory System**),覆盖插件列表、设置侧栏、左侧栏入口与面板标题。
|
package/README.md
CHANGED
|
@@ -16,7 +16,7 @@ JSONL 落盘 · 本机向量检索 · 五个模型工具 · 自动召回 · 硬
|
|
|
16
16
|
[npm 包](https://www.npmjs.com/package/@restregular/dsh-memory) · [问题反馈](https://github.com/RestRegular/dsh-memory/issues) · [更新日志](https://github.com/RestRegular/dsh-memory/blob/main/CHANGELOG.md)
|
|
17
17
|
|
|
18
18
|
> **它解决的不是「存一段文本」,而是「让模型在该记的时候记住、该用的时候用上」。**
|
|
19
|
-
>
|
|
19
|
+
> 记忆默认只落在本机;没有向量服务也能工作——检索自动退化为词法,不产生任何网络请求。
|
|
20
20
|
|
|
21
21
|

|
|
22
22
|
|
|
@@ -27,7 +27,7 @@ JSONL 落盘 · 本机向量检索 · 五个模型工具 · 自动召回 · 硬
|
|
|
27
27
|
| 新会话从零开始,换个窗口就问不出上次的结论 | 结论落成记忆;新会话第一步注入摘要,之后每轮按问题召回 |
|
|
28
28
|
| 同一个坑反复踩,上次查到的命令又要再查一遍 | 发布 / 部署 / 工具失败等行为会触发定向召回;查到的做法直接复用 |
|
|
29
29
|
| 写了规则没人执行,改过的规则旧会话不知道 | `kind: rule` 进系统提示常驻段;新增或编辑会补一条提醒 |
|
|
30
|
-
| 云端记忆不可控,敏感内容不敢写 | 全部本地 JSONL
|
|
30
|
+
| 云端记忆不可控,敏感内容不敢写 | 全部本地 JSONL;写入前过凭据扫描;检索默认不联网 |
|
|
31
31
|
|
|
32
32
|
它也不是「把聊天记录整段塞给模型」:每条记忆是一句自洽的话,按作用域、类型和重要度管理;
|
|
33
33
|
召回有 token 预算与去重,旧结论可以用 `supersedes` 标注修正,而不是悄悄覆盖。
|
|
@@ -64,8 +64,8 @@ JSONL 落盘 · 本机向量检索 · 五个模型工具 · 自动召回 · 硬
|
|
|
64
64
|
|
|
65
65
|
### 向量服务
|
|
66
66
|
|
|
67
|
-
在本机托管 `llama-server
|
|
68
|
-
|
|
67
|
+
在本机托管 `llama-server`,下载运行时与模型;内置清单为每个模型配好 `dims` 与 `pooling`,
|
|
68
|
+
避免维度写错导致向量通道静默失效。按硬件推荐,也支持自定义 GGUF。
|
|
69
69
|
|
|
70
70
|

|
|
71
71
|
|
|
@@ -86,12 +86,12 @@ npm i @restregular/dsh-memory
|
|
|
86
86
|
name: '@restregular/dsh-memory'
|
|
87
87
|
```
|
|
88
88
|
|
|
89
|
-
|
|
89
|
+
**不写任何配置就能用**:检索退化为词法,不产生任何网络请求。需要语义检索时,
|
|
90
90
|
在面板「服务 → 向量服务」里一键装本机后端即可。
|
|
91
91
|
|
|
92
92
|
> 宿主只允许**一个包名、一个解析源**,所以本插件是「一个包 + 一条 entry + 面板与服务端同包」。
|
|
93
93
|
> 拆成两个包会触发 `resolves from multiple active Loader sources`,客户端图组合失败,
|
|
94
|
-
>
|
|
94
|
+
> 桌面端直接起不来。这段设计约束写在下面的折叠块里,不影响使用。
|
|
95
95
|
|
|
96
96
|
<details>
|
|
97
97
|
<summary>为什么是一个包(给想改结构的人)</summary>
|
|
@@ -317,6 +317,37 @@ scope 键有三种形态:`global`、`project:<cwd>`、`session:<会话 id>`,
|
|
|
317
317
|
- 清空记忆是两步确认 + 接口要求显式 `confirm: "delete"`。
|
|
318
318
|
- 数据默认只在本机:JSONL 不加密,向量端点默认 loopback;请自行保护 store 目录,导出文件也是明文。
|
|
319
319
|
|
|
320
|
+
## 诊断与审计
|
|
321
|
+
|
|
322
|
+
面板顶部有独立的「审计」标签页,不需要手工请求 HTTP。它按事件流展示每次注入的评估、过滤、预算、投递与失败原因,并支持按会话 / 通道 / 结果 / 时间筛选、分页、详情抽屉和导出当前筛选。
|
|
323
|
+
|
|
324
|
+
审计严格区分三件事:
|
|
325
|
+
|
|
326
|
+
- **评估(evaluation)**:候选、选中、省略、预算、检索/加载结果;
|
|
327
|
+
- **投递(delivery)**:最终消息是否通过本地保护并被放进上下文;
|
|
328
|
+
- **使用/遵守**:Agent 后续是否引用或执行了记忆。当前系统无法可靠证明,面板不会声称已验证。
|
|
329
|
+
|
|
330
|
+
因此 `selected.contentIds` 只表示“评估选中”,不等于“已投递”。宿主没有向 middleware 回执最终采纳结果时,`delivery.status` 记为 `unknown`(面板显示“已准备(投递未确认)”),不会乐观写成 `appended`。
|
|
331
|
+
|
|
332
|
+
### API
|
|
333
|
+
|
|
334
|
+
```text
|
|
335
|
+
GET /memory/api/audit
|
|
336
|
+
?session=<id>&trace=<id>&operation=<id>&memory=<id>
|
|
337
|
+
&channel=digest|recall|rules|rules_delta|policy|nudge|signal|lifecycle
|
|
338
|
+
&trigger=<trigger>&outcome=success|failed|skipped|partial|unknown
|
|
339
|
+
&problem=1&since=<ms|ISO>&until=<ms|ISO>&limit=1..200&cursor=<seq>
|
|
340
|
+
|
|
341
|
+
GET /memory/api/audit/stats
|
|
342
|
+
GET /memory/api/audit/export?format=json|jsonl&<same filters>
|
|
343
|
+
```
|
|
344
|
+
|
|
345
|
+
响应为 `{ ok: true, value: { entries, total, nextCursor?, stats, query } }`。旧调用 `GET /audit?session=<id>` 仍兼容;不带 `session` 时查询全部会话,`query.scope` 会标记为 `all`。
|
|
346
|
+
|
|
347
|
+
审计数据默认**只在内存**:容量 2000 条、每会话 200 条,超出时优先保留 digest / rules / delivery / error 等关键通道;`stats` 暴露 `entries / capacity / dropped / writeErrors / persistence`。重启后记录丢失,面板会明确提示。
|
|
348
|
+
|
|
349
|
+
写入前所有自由文本都经过统一 sanitizer:先限制扫描长度(4000 字符),再做凭据模式脱敏,最后截到 200 字;只保存 ID、计数、枚举原因、字符数和短 hash,不保存记忆正文、原始工具参数、异常堆栈。模式脱敏是保守匹配,不承诺覆盖所有秘密形状。
|
|
350
|
+
|
|
320
351
|
## 卸载 / 迁移
|
|
321
352
|
|
|
322
353
|
```bash
|
|
@@ -371,15 +402,22 @@ npm run verify # 构建到 .verify/,不落 packages/
|
|
|
371
402
|
|
|
372
403
|
**记忆没有自动召回**
|
|
373
404
|
确认 `inject.recall` / `autoRecall` 已开、当前作用域在召回范围内(标签触发的自动召回只含 global + 当前会话 +
|
|
374
|
-
当前工作区,普通每轮召回按 `inject.extraScopes`
|
|
375
|
-
|
|
405
|
+
当前工作区,普通每轮召回按 `inject.extraScopes` 配置),并检查标签是否真的命中。打开面板顶部的「审计」标签页,
|
|
406
|
+
按会话/通道/问题筛选即可看到触发原因、候选、过滤、省略、预算和投递状态;也可以直接请求
|
|
407
|
+
`GET /memory/api/audit?session=<id>`。
|
|
408
|
+
|
|
409
|
+
**作用域列表里出现两个同名路径 / 用 `path` 存的记忆工作区里看不到**
|
|
410
|
+
0.11.0 及以前,`D:/repo` 与 `D:\repo` 会被当成两个项目作用域(写的人用正斜杠、会话读的是宿主给的反斜杠)。
|
|
411
|
+
0.11.1 起路径写法统一,首次启动会把历史分叉合并到规范键(记录、别名都跟着走,旧文件删除)。
|
|
376
412
|
|
|
377
413
|
**数据怎么备份**
|
|
378
414
|
复制整个 `<storeDir>`;或用面板导出 JSON。导入会按当前模型重新嵌入,不携带旧向量。
|
|
379
415
|
|
|
380
416
|
## 更新日志
|
|
381
417
|
|
|
382
|
-
- **0.
|
|
418
|
+
- **0.12.0** —— 注入审计 v2:评估/投递分离、失败与跳过可解释、统一脱敏、有界存储与容量统计、分页筛选 API、独立「审计」标签页与 JSON/JSONL 导出。
|
|
419
|
+
- **0.11.1** —— 修复项目作用域因路径写法不同而分叉:`D:/repo` 与 `D:\repo` 统一成同一个键,历史分叉首次启动自动合并。
|
|
420
|
+
- **0.11.0** —— 插件显示名改为「记忆系统」,重写 README 并更新截图;无 API / 配置 / 数据格式变更。
|
|
383
421
|
- **0.10.1** —— 深色模式开关跟随宿主 token,修复白点融进白轨道。
|
|
384
422
|
- **0.10.0** —— 多进程安全写入、向量身份加入 pooling、读路径能看到其它进程的新写入。
|
|
385
423
|
|