@restregular/dsh-memory 0.18.0 → 0.19.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 CHANGED
@@ -2,6 +2,39 @@
2
2
 
3
3
  本项目的版本记录。安装 id 与 npm 版本一一对应。
4
4
 
5
+ ## 0.19.1 — 记忆范围按钮常驻数字、默认范围预选、取消类型限制、深色模式与阴影收敛
6
+
7
+ - **按钮只显示数字**:去掉「记忆可见域」文字,保存/继承后只显示当前生效的作用域数量;有显式覆盖时仍然高亮,完整说明放在 `title` 里。
8
+ - **打开会话就加载**:按钮挂载时(以及 `sessionId` 变化时)就请求 `GET /memory/api/visibility`,不再需要先点一次按钮才知道这个会话的范围。
9
+ - **默认范围预选**:没有显式覆盖时,面板按服务端返回的 `defaults`(会话 + 项目 + global)预选;服务端目录里缺这些 scope 时客户端会自己补齐,不会再出现「一打开什么都没选」。
10
+ - **取消记忆类型限制**:移除浮窗里的类型 chips;`POST /visibility` 不再写入 `kinds`,provider 在规范化 / 读取旧配置时也忽略 `kinds`。0.19.0 的 v2 文件仍可读,只是类型白名单不再生效;同一作用域下所有类型都可读。
11
+ - **深色模式**:浮窗、等级按钮、勾选框、类型说明、审批卡的背景 / 边框 / 文字全部走宿主主题 token;去掉只在浅色下协调的白色内阴影,深色主题下对比度正常。
12
+ - **阴影收敛**:浮窗与审批卡的投影从 `0 22px 60px` 级别收紧为 `0 10px 26~28px`,去掉明显的大面积阴影;面板宽度从 360 收到 340。
13
+ - **测试**:按钮挂载即加载、只显示数字、默认范围预选(含服务端目录缺失时的补齐)、保存只带 scope、后端忽略 kinds、类型限制取消后的 search/get 行为、旧配置兼容。
14
+
15
+ ## 0.19.0 — 记忆可见域 2.0:按类型收窄 + 三档限制 + 范围外审批 + 浮窗重做
16
+
17
+ - **可见域从「作用域白名单」升级为「作用域 × 记忆类型 × 限制等级」**:每个作用域可以只允许部分 `kind`(例如 `global` 仅 `rule`、当前项目仅 `fact`);限制等级三档:
18
+ - `absolute` 绝对限制:范围外一律查不到,工具内部命中也不返回;
19
+ - `normal` 普通限制(新默认):范围外命中时由工具向用户发起一次审批;
20
+ - `none` 无限制:不做范围过滤(选择保留,供下次切换)。
21
+ - **会话级持久化保持并升级**:`<storeDir>/visibility/<session>.json` 改为 v2(`scopes: [{ scope, kinds? }] + level`);0.18 的 v1 文件按「绝对限制 + 全部类型」读取,升级不放开旧范围。「恢复默认」删除文件。
22
+ - **范围外访问审批**:
23
+ - `memory_search` / `memory_list` / `memory_get` 在普通限制下把范围外命中交给用户审批;工具等待期间会在界面底部显示审批浮窗(查询关键词、工具名、范围外记忆摘要)。
24
+ - 浮窗里的记忆 ID 悬浮 350ms 显示完整内容浮窗(复用审计详情的 `.audit-tip` 行为与样式);点击 ID 跳到「记录」页并展开卡片。
25
+ - 「拒绝 / 允许一次」二选一;允许一次只对本次调用生效;拒绝或 5 分钟超时按拒绝处理;调用被中止时立即释放,不留下悬浮的待审批。
26
+ - 工具结果新增 `withheld: { count, reason }`(不泄露正文),让模型知道有命中被可见域挡住。
27
+ - **可见域变更注入上下文**:面板保存后,下一次 `agent/pre-step` 以 user 消息注入「记忆可见域已更新」,列出作用域 / 类型 / 限制等级与后续行为要求;子 Agent 也会收到父会话的变更。
28
+ - **注入侧按类型收窄**:摘要、每轮召回、硬性规则、流程索引都按可见域的类型白名单过滤,避免「只允许 global 的 rule」之后又从别的类型召回正文。
29
+ - **浮窗面板 UI 重做**:
30
+ - 按钮在保存过范围后显示「记忆可见域 n」;
31
+ - 毛玻璃背景(半透明 + `backdrop-filter`,不支持时退回实心底),不再透出底下的输入框;
32
+ - 自定义勾选框与类型 chips(不再使用原生 checkbox);
33
+ - 作用域搜索、全选 / 取消全选;列表最大高度 `min(300px, 40vh)`,超出在浮窗内滚动;
34
+ - 「恢复默认」与「保存」按钮重新设计(次级描边 / 品牌渐变主按钮),并保留三档限制等级的说明文字。
35
+ - **面板 API**:`GET/POST /memory/api/visibility` 返回/接受 v2 结构(同时兼容 0.18 的 `{ scopes: string[] }`);新增 `GET /memory/api/approvals?session=` 与 `POST /memory/api/approvals { id, outcome }`;`GET /visibility` 额外返回每个作用域的类型统计与已知类型目录。
36
+ - 测试:v1→v2 兼容、按类型过滤(search / list / get / 注入)、三档限制(绝对 / 普通审批 / 无限制)、审批队列与回答幂等、可见域变更通知、浮窗按钮渲染与保存请求、审批浮层注册。
37
+
5
38
  ## 0.18.0 — 会话级「记忆可见范围」+ 规则注入带 ID / 摘要说明
6
39
 
7
40
  - **输入框新增「记忆范围」按钮**:挂在宿主 `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,24 @@ 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
+ 输入框工具行右侧有「记忆范围」按钮。**打开会话时就会读取这个会话的设置**,按钮只显示当前生效的作用域数量(不再显示「记忆可见域」文字);有显式覆盖时高亮。点开的浮窗使用毛玻璃背景,按当前会话列出可选作用域(当前会话 / 当前项目 / global / 已有自定义作用域):
87
88
 
88
- - 这是**会话级**白名单:本会话的 Agent 及其子 Agent 只检索、只注入、只 `memory_get` 勾选范围内的记忆;未勾选的范围不会被 `memory_search` / `memory_list` 看到,`memory_get` 也取不到正文。
89
+ - **默认范围**:还没有显式设置时,按「会话 + 项目 + global」预选,不会出现空面板。
90
+ - **搜索与批量**:顶部可搜索作用域,支持「全选 / 取消全选」;列表最大高度受限,作用域多时在浮窗内滚动。
91
+ - **限制等级**:
92
+ - **绝对限制**:可见域外的记忆一律查不到;即使工具内部命中,也不返回结果。
93
+ - **普通限制**(默认):可见域内正常返回;命中范围外记忆时,工具会暂停并向用户发起一次审批,展示 Agent 的查询关键词与范围外记忆摘要。
94
+ - **无限制**:不启用范围白名单,可以读取任意作用域(选择仍会保存,供下次切换)。
95
+ - **不再按记忆类型收窄**:0.19.1 起只按作用域限制;旧配置里的 `kinds` 会被忽略,同一作用域下的事实 / 规则 / 流程等都可读。
96
+ - **审批浮窗**:普通限制下的待审批会出现在界面底部。记忆 ID 悬浮 350ms 后显示完整内容 / 类型 / 作用域 / 重要度 / 标签浮窗(与审计详情同一套行为与样式);点击记忆 ID 跳到「记录」页并展开对应卡片。提供「拒绝」与「允许一次」:允许一次只对本次工具调用生效;拒绝或 5 分钟未回答则工具拿不到这些内容。
89
97
  - 子 Agent 自动继承父会话 / 根会话的设置;在子 Agent 自己的会话里再设置,只影响那一个会话。
98
+ - 保存后,下一次 Agent 步骤会通过注入的上下文消息收到「可见域已更新」通知(包含可见范围与限制等级),不需要重启会话。
90
99
  - 「恢复默认」清除覆盖,回到「会话 + 项目 + global」的默认读取集合。
91
- - 覆盖按会话落盘在 `<storeDir>/visibility/<session>.json`,浏览器刷新 / 插件重载后仍在。
92
- - 只影响**读取**:`memory_save` 的落点仍由 `scope` 参数与默认写口径决定;面板管理页不受可见范围限制。
100
+ - 覆盖按会话落盘在 `<storeDir>/visibility/<session>.json`,浏览器刷新 / 插件重载后仍在;0.18 的旧文件按「绝对限制」兼容读取。
101
+ - 浮窗与审批卡的半透明背景、边框、文字颜色全部走宿主主题 token,深色模式自动适配;阴影已收敛为小范围投影,不再有大面积明显阴影。
102
+ - 只影响**读取**:`memory_save` 的落点仍由 `scope` 参数与默认写口径决定;面板管理页不受可见域限制。
93
103
 
94
104
  ### 向量服务
95
105
 
@@ -362,7 +372,7 @@ retrieval:
362
372
  | `<storeDir>/projects/<sha1(scope)>.vec` | 向量边车;首行 `#<model>\t<dims>\t<pooling>`,后面每行 `id\t<base64 向量>` |
363
373
  | `<storeDir>/settings.json` | 面板设置(覆盖配置文件里的默认值) |
364
374
  | `<storeDir>/scopes.json` | 项目作用域别名(显示名 → `project:<路径>`) |
365
- | `<storeDir>/visibility/<session>.json` | 会话「记忆可见范围」覆盖;没有文件 = 使用默认三路集合 |
375
+ | `<storeDir>/visibility/<session>.json` | 会话「记忆可见域」覆盖(作用域 + 限制等级);没有文件 = 使用默认三路集合 |
366
376
  | `<storeDir>/*.lock` | 跨进程写锁;陈旧锁(持有者已死或 10s 未动)会被接管 |
367
377
  | `<installRoot>/llamacpp/` | llama-server 运行时、依赖 dll、`llama-server.log` |
368
378
  | `<installRoot>/models/` | 下载的 GGUF 模型 |