@restregular/dsh-memory 0.18.0 → 0.19.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 CHANGED
@@ -2,6 +2,29 @@
2
2
 
3
3
  本项目的版本记录。安装 id 与 npm 版本一一对应。
4
4
 
5
+ ## 0.19.0 — 记忆可见域 2.0:按类型收窄 + 三档限制 + 范围外审批 + 浮窗重做
6
+
7
+ - **可见域从「作用域白名单」升级为「作用域 × 记忆类型 × 限制等级」**:每个作用域可以只允许部分 `kind`(例如 `global` 仅 `rule`、当前项目仅 `fact`);限制等级三档:
8
+ - `absolute` 绝对限制:范围外一律查不到,工具内部命中也不返回;
9
+ - `normal` 普通限制(新默认):范围外命中时由工具向用户发起一次审批;
10
+ - `none` 无限制:不做范围过滤(选择保留,供下次切换)。
11
+ - **会话级持久化保持并升级**:`<storeDir>/visibility/<session>.json` 改为 v2(`scopes: [{ scope, kinds? }] + level`);0.18 的 v1 文件按「绝对限制 + 全部类型」读取,升级不放开旧范围。「恢复默认」删除文件。
12
+ - **范围外访问审批**:
13
+ - `memory_search` / `memory_list` / `memory_get` 在普通限制下把范围外命中交给用户审批;工具等待期间会在界面底部显示审批浮窗(查询关键词、工具名、范围外记忆摘要)。
14
+ - 浮窗里的记忆 ID 悬浮 350ms 显示完整内容浮窗(复用审计详情的 `.audit-tip` 行为与样式);点击 ID 跳到「记录」页并展开卡片。
15
+ - 「拒绝 / 允许一次」二选一;允许一次只对本次调用生效;拒绝或 5 分钟超时按拒绝处理;调用被中止时立即释放,不留下悬浮的待审批。
16
+ - 工具结果新增 `withheld: { count, reason }`(不泄露正文),让模型知道有命中被可见域挡住。
17
+ - **可见域变更注入上下文**:面板保存后,下一次 `agent/pre-step` 以 user 消息注入「记忆可见域已更新」,列出作用域 / 类型 / 限制等级与后续行为要求;子 Agent 也会收到父会话的变更。
18
+ - **注入侧按类型收窄**:摘要、每轮召回、硬性规则、流程索引都按可见域的类型白名单过滤,避免「只允许 global 的 rule」之后又从别的类型召回正文。
19
+ - **浮窗面板 UI 重做**:
20
+ - 按钮在保存过范围后显示「记忆可见域 n」;
21
+ - 毛玻璃背景(半透明 + `backdrop-filter`,不支持时退回实心底),不再透出底下的输入框;
22
+ - 自定义勾选框与类型 chips(不再使用原生 checkbox);
23
+ - 作用域搜索、全选 / 取消全选;列表最大高度 `min(300px, 40vh)`,超出在浮窗内滚动;
24
+ - 「恢复默认」与「保存」按钮重新设计(次级描边 / 品牌渐变主按钮),并保留三档限制等级的说明文字。
25
+ - **面板 API**:`GET/POST /memory/api/visibility` 返回/接受 v2 结构(同时兼容 0.18 的 `{ scopes: string[] }`);新增 `GET /memory/api/approvals?session=` 与 `POST /memory/api/approvals { id, outcome }`;`GET /visibility` 额外返回每个作用域的类型统计与已知类型目录。
26
+ - 测试:v1→v2 兼容、按类型过滤(search / list / get / 注入)、三档限制(绝对 / 普通审批 / 无限制)、审批队列与回答幂等、可见域变更通知、浮窗按钮渲染与保存请求、审批浮层注册。
27
+
5
28
  ## 0.18.0 — 会话级「记忆可见范围」+ 规则注入带 ID / 摘要说明
6
29
 
7
30
  - **输入框新增「记忆范围」按钮**:挂在宿主 `conversation.input.right` 槽(会话输入框工具行右侧),点开按当前会话列出可选作用域(当前会话 / 当前项目 / global / 自定义),勾选后立即生效。有覆盖时按钮显示「记忆 N」并高亮。
package/README.md CHANGED
@@ -45,7 +45,8 @@ JSONL 落盘 · 本机向量检索 · 五个模型工具 · 自动召回 · 硬
45
45
  | **自动召回** | 每轮按用户问题召回;新会话第一步注入项目 / global 摘要;发布、部署、工具失败等行为按标签触发定向召回 |
46
46
  | **印象形态** | 每轮只给每条记忆的短摘要;模型判断相关但需要细节时再 `memory_get` 取全文,省 token 也不丢信息 |
47
47
  | **硬性规则** | `kind: rule` 进系统提示常驻段;行首带 8 位 id,注入的是摘要,需要全文时用 `memory_get`;旧会话会收到新增 / 编辑提醒;超预算有明确警告,不静默丢弃 |
48
- | **会话可见范围** | 输入框旁的「记忆范围」按钮设置本会话可读的作用域;Agent 及其子 Agent 都按这个白名单检索、注入与 `memory_get` |
48
+ | **会话可见域** | 输入框旁的「记忆范围」按钮设置本会话可读的作用域 + 每个作用域允许的记忆类型 + 限制等级(绝对 / 普通 / 无限制);Agent 及其子 Agent 都按它检索、注入与 `memory_get` |
49
+ | **范围外审批** | 普通限制下,工具命中可见域外的记忆时会在界面弹出审批:展示查询关键词与范围外记忆摘要(记忆 ID 可悬浮看全文、点击跳面板展开);用户选「拒绝」或「允许一次」 |
49
50
  | **状态记忆** | `kind: state` 默认 7 天 TTL;注入带「状态,使用前验证」;过期后默认不进检索 / 摘要 / 召回,但 `memory_get` 与面板仍可取 |
50
51
  | **流程索引** | `kind: procedure` 的目录进系统提示:按当前工作区 + 触发词(工具名 / 关键词)列 `id · 触发词 → 标题`,需要时再用 `memory_get` 取全文 |
51
52
  | **可视化管理** | 记录浏览 / 搜索 / 新建 / 编辑 / 删除;**记录页可主动做语义检索**(与 `memory_search` 同一套排序);记忆树展示作用域、类型与修正链;设置改完即存;导入导出 |
@@ -81,15 +82,22 @@ JSONL 落盘 · 本机向量检索 · 五个模型工具 · 自动召回 · 硬
81
82
 
82
83
  ![记忆设置](https://raw.githubusercontent.com/RestRegular/dsh-memory/main/preview/memory-settings.png)
83
84
 
84
- ### 输入框的记忆可见范围
85
+ ### 输入框的记忆可见域
85
86
 
86
- 输入框工具行右侧有「记忆范围」按钮(有覆盖时显示「记忆 N」并高亮)。点开后按当前会话列出可选作用域:当前会话 / 当前项目 / global / 已有自定义作用域,勾选后保存。
87
+ 输入框工具行右侧有「记忆范围」按钮;保存过范围后按钮改为「记忆可见域 n」并高亮。点开的浮窗使用毛玻璃背景,按当前会话列出可选作用域(当前会话 / 当前项目 / global / 已有自定义作用域):
87
88
 
88
- - 这是**会话级**白名单:本会话的 Agent 及其子 Agent 只检索、只注入、只 `memory_get` 勾选范围内的记忆;未勾选的范围不会被 `memory_search` / `memory_list` 看到,`memory_get` 也取不到正文。
89
+ - **搜索与批量**:顶部可搜索作用域,支持「全选 / 取消全选」;列表最大高度受限,作用域多时在浮窗内滚动。
90
+ - **按类型收窄**:勾选一个作用域后会展开记忆类型 chips(事实 / 决策 / 偏好 / 流程 / 笔记 / 规则 / 状态)。例如只允许 `global` 的 `rule`,或只允许当前项目的 `fact`。
91
+ - **限制等级**:
92
+ - **绝对限制**:可见域外的记忆一律查不到;即使工具内部命中,也不返回结果。
93
+ - **普通限制**(默认):可见域内正常返回;命中范围外记忆时,工具会暂停并向用户发起一次审批,展示 Agent 的查询关键词与范围外记忆摘要。
94
+ - **无限制**:不启用范围白名单,可以读取任意作用域与类型(选择仍会保存,供下次切换)。
95
+ - **审批浮窗**:普通限制下的待审批会出现在界面底部。记忆 ID 悬浮 350ms 后显示完整内容 / 类型 / 作用域 / 重要度 / 标签浮窗(与审计详情同一套行为与样式);点击记忆 ID 跳到「记录」页并展开对应卡片。提供「拒绝」与「允许一次」:允许一次只对本次工具调用生效;拒绝或 5 分钟未回答则工具拿不到这些内容。
89
96
  - 子 Agent 自动继承父会话 / 根会话的设置;在子 Agent 自己的会话里再设置,只影响那一个会话。
97
+ - 保存后,下一次 Agent 步骤会通过注入的上下文消息收到「可见域已更新」通知(包含可见范围、类型与限制等级),不需要重启会话。
90
98
  - 「恢复默认」清除覆盖,回到「会话 + 项目 + global」的默认读取集合。
91
- - 覆盖按会话落盘在 `<storeDir>/visibility/<session>.json`,浏览器刷新 / 插件重载后仍在。
92
- - 只影响**读取**:`memory_save` 的落点仍由 `scope` 参数与默认写口径决定;面板管理页不受可见范围限制。
99
+ - 覆盖按会话落盘在 `<storeDir>/visibility/<session>.json`,浏览器刷新 / 插件重载后仍在;0.18 的旧文件按「绝对限制 + 全部类型」兼容读取。
100
+ - 只影响**读取**:`memory_save` 的落点仍由 `scope` 参数与默认写口径决定;面板管理页不受可见域限制。
93
101
 
94
102
  ### 向量服务
95
103
 
@@ -362,7 +370,7 @@ retrieval:
362
370
  | `<storeDir>/projects/<sha1(scope)>.vec` | 向量边车;首行 `#<model>\t<dims>\t<pooling>`,后面每行 `id\t<base64 向量>` |
363
371
  | `<storeDir>/settings.json` | 面板设置(覆盖配置文件里的默认值) |
364
372
  | `<storeDir>/scopes.json` | 项目作用域别名(显示名 → `project:<路径>`) |
365
- | `<storeDir>/visibility/<session>.json` | 会话「记忆可见范围」覆盖;没有文件 = 使用默认三路集合 |
373
+ | `<storeDir>/visibility/<session>.json` | 会话「记忆可见域」覆盖(作用域 + 每个作用域的类型白名单 + 限制等级);没有文件 = 使用默认三路集合 |
366
374
  | `<storeDir>/*.lock` | 跨进程写锁;陈旧锁(持有者已死或 10s 未动)会被接管 |
367
375
  | `<installRoot>/llamacpp/` | llama-server 运行时、依赖 dll、`llama-server.log` |
368
376
  | `<installRoot>/models/` | 下载的 GGUF 模型 |