@restregular/dsh-memory 0.13.2 → 0.14.1
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 +14 -0
- package/README.md +14 -0
- package/lib/client.js +823 -18
- package/lib/inject/apply.js +74 -6
- package/lib/inject/audit-types.js +6 -0
- package/lib/inject/signals.js +8 -0
- package/lib/panel.js +62 -2
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -2,6 +2,20 @@
|
|
|
2
2
|
|
|
3
3
|
本项目的版本记录。安装 id 与 npm 版本一一对应。
|
|
4
4
|
|
|
5
|
+
## 0.14.1 — 移除头部入口,记忆视图内滚,轨迹详情加审计页签
|
|
6
|
+
|
|
7
|
+
- **移除会话头部的「记忆审计」按钮**:入口收敛到会话内的「记忆」视图和轨迹详情页签,不再占用标题行。
|
|
8
|
+
- **记忆视图不再撑高外层**:视图声明 `data-conversation-composer-overlay`,与 Trajectory 用同一套壳层机制把 viewArea 压成固定高度;审计列表在自己的滚动容器里滚动,外层会话界面不需要跟着滚。底部为浮动 composer 预留高度。
|
|
9
|
+
- **轨迹详情新增「记忆审计」页签**:Trajectory 没有页签级 slot,所以页签按钮和面板放在 `shell.overlay` 里,用 fixed 定位贴着右侧详情面板(页签行预留 96px,不改 React 管理的 DOM)。点击后展示该记录的 callId 对应审计事件,底部按钮跳到本会话记忆审计面板;没有 callId 的记录明确提示无法精确过滤。选择器用 CSS Modules 稳定后缀(`_details` / `_detailTabs` / `_detailBody`),失配时静默隐藏。
|
|
10
|
+
|
|
11
|
+
## 0.14.0 — 记忆审计与会话轨迹互相精准跳转
|
|
12
|
+
|
|
13
|
+
- **审计可定位到轨迹**:审计详情新增「在轨迹中定位」。条目上的 `operationId`(记忆工具调用、触发召回的工具调用)直接作为 Trajectory 的 callId 深链;没有 `operationId` 的按轮/步事件请求新增的 `GET /memory/api/anchor`,由 Host 在会话事件窗口里找该 turn/step 的第一个 `tool/call`。找不到时只切到轨迹页,不伪造锚点。
|
|
14
|
+
- **轨迹行可回到审计**:新增 `shell.overlay` 徽标,只读观察 Trajectory 选中行的 `data-trajectory-row-key`,按 callId 查出相关审计并在行右侧显示「记忆 N」;点击打开记忆面板「审计」页并按 `op:<callId>` 过滤。会话标题行同时提供固定入口「记忆审计」。
|
|
15
|
+
- **会话内新增「记忆」视图**:与 Chat / 轨迹同一个 view ring,按当前会话展示审计;使用宿主传给每个 view 的 `openView` 完成跳转,属于官方扩展路径。主面板不在 view ring 内,通过 `conversation.session` 的 per-session store 调同一个 action(拿不到时退化为只打开会话/轨迹页)。
|
|
16
|
+
- **记忆工具调用入审计**:`memory_save/search/list/get/forget` 的每次调用都会记一条 `stage: tool_call` 的锚点(`operationId` = callId,带 turn/step),即使自动召回关闭也保留;信号事件同步写入 `operationId`、`turn`、`step` 与 `signal.callId`,便于把审计和轨迹对上。
|
|
17
|
+
- 新增 Host 纯函数 `findTrajectoryAnchor` 与回归测试;客户端新增锚点解析、焦点总线、主面板 store 桥、审计详情跳转的渲染测试。
|
|
18
|
+
|
|
5
19
|
## 0.13.2 — 修复检索分数全部相同
|
|
6
20
|
|
|
7
21
|
- **根因**:`search()` 组装最终分数时写成了 `c.id`,而候选对象只有 `c.record`,于是所有候选都落到
|
package/README.md
CHANGED
|
@@ -365,10 +365,24 @@ GET /memory/api/audit
|
|
|
365
365
|
|
|
366
366
|
GET /memory/api/audit/stats
|
|
367
367
|
GET /memory/api/audit/export?format=json|jsonl&<same filters>
|
|
368
|
+
|
|
369
|
+
GET /memory/api/anchor?session=<id>&turn=<n>&step=<n>&callId=<optional>
|
|
368
370
|
```
|
|
369
371
|
|
|
370
372
|
响应为 `{ ok: true, value: { entries, total, nextCursor?, stats, query } }`。旧调用 `GET /audit?session=<id>` 仍兼容;不带 `session` 时查询全部会话,`query.scope` 会标记为 `all`。
|
|
371
373
|
|
|
374
|
+
### 和会话轨迹互相跳转
|
|
375
|
+
|
|
376
|
+
DSH 自带的 Trajectory 面板是一个**纯投影**:它只声明 `conversation.trajectory.images` 一个子槽,没有行/列扩展点,选中状态也只存在组件内部。因此插件不能直接往轨迹表格里插审计行。当前采用的是一条不碰轨迹 React 树的组合:
|
|
377
|
+
|
|
378
|
+
- **轨迹 → 记忆审计**:Trajectory 的选中行带有稳定的 `data-trajectory-row-key`(工具行是 `kind\0call\0<callId>`)。一个 `shell.overlay` 徽标只读观察选中行,按 callId 查审计,在行右侧浮出「记忆 N」。点击后打开记忆面板的「审计」页,并按 `op:<callId>` 过滤。
|
|
379
|
+
- **轨迹详情页签**:点击轨迹里的任意记录后,右侧详情面板的页签行会多出一个「记忆审计」页签(用 `shell.overlay` 贴着详情面板,不改轨迹的 React 树)。它展示该记录 callId 对应的审计事件,底部按钮直接打开本会话的记忆审计面板;没有 callId 的记录明确提示无法精确过滤。
|
|
380
|
+
- **记忆审计 → 轨迹**:审计详情里的「在轨迹中定位」把条目上的 `operationId`(记忆工具调用、触发召回的工具调用)交给 Trajectory 的 `openView('trajectory', callId)`。没有 `operationId` 的按轮/步事件先请求 `/anchor`,由 Host 从会话事件窗口里找该 turn/step 的第一个 `tool/call`;找不到就只切到轨迹页,不伪造定位。
|
|
381
|
+
- **会话内的「记忆」视图**:与 Chat / 轨迹同一个 view ring,按当前会话展示审计;它直接使用宿主传给每个 view 的 `openView`,因此跳转是官方支持路径。它声明 `data-conversation-composer-overlay` 让壳层压住外层滚动,审计列表在自己的滚动容器里滚动,外层界面不需要跟着滚。主面板不在 view ring 内,通过 `conversation.session` 注册的 per-session store 调同一个 action;拿不到时退化为打开会话/轨迹页。
|
|
382
|
+
- 记忆工具调用(`memory_save/search/list/get/forget`)本身会额外留一条 `stage: tool_call` 的审计锚点:即使自动召回关闭,也能从这条记录精确跳回轨迹里的那次调用。
|
|
383
|
+
|
|
384
|
+
`/anchor` 只返回 `{ callId, tool?, turn?, step?, reason }`,不返回工具参数、消息正文或记忆内容;找不到会话/工具时 `callId` 为 `null` 并给出稳定 `reason`。
|
|
385
|
+
|
|
372
386
|
审计数据默认**只在内存**:容量 2000 条、每会话 200 条,超出时优先保留 digest / rules / delivery / error 等关键通道;`stats` 暴露 `entries / capacity / dropped / writeErrors / persistence`。重启后记录丢失,面板会明确提示。
|
|
373
387
|
|
|
374
388
|
写入前所有自由文本都经过统一 sanitizer:先限制扫描长度(4000 字符),再做凭据模式脱敏,最后截到 200 字;只保存 ID、计数、枚举原因、字符数和短 hash,不保存记忆正文、原始工具参数、异常堆栈。模式脱敏是保守匹配,不承诺覆盖所有秘密形状。
|