@restregular/dsh-memory 0.19.2 → 0.21.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,38 @@
2
2
 
3
3
  本项目的版本记录。安装 id 与 npm 版本一一对应。
4
4
 
5
+ ## 0.21.0 — 审批卡进会话内、逐条允许;memory_search / memory_list 上下文去重
6
+
7
+ - **范围外审批卡重做(行为 + 样式对齐系统权限审批弹窗)**:
8
+ - 注册位置从 `shell.overlay`(全局 fixed 浮层)改为 `conversation.input.dock`(会话作用域的输入框上方)。审批**只在发起它的那个会话里显示**:切到别的会话看不到,也不会盖住设置页 / 别的会话;组件按标准 `sessionId` prop 轮询 `/memory/api/approvals?session=…`。
9
+ - 版式照抄宿主 `dsh-client-ui-approval` 的审批卡:警告色 strip(「等待审批」+ 工具名)、`mem-approval-body` 标题 / 查询语句、右对齐的「拒绝 / 允许」动作行;卡片宽度、圆角、底色、阴影、strip 配色都使用与系统审批卡同一批主题 token(`state-warn-secondary` / `state-warn-tertiary` / `dsw-radius-xl` / `specific-input-major` / `dsw-shadow-lv2`,缺变量时带同色回退)。Enter = 允许、Esc = 拒绝(焦点在卡片内)。
10
+ - **逐条允许**:读审批默认全选,可以取消其中一条或多条,按钮变成「允许选中的 N 条」;全选时仍是「允许一次」。工具侧按 `{ outcome: 'allowed-once', allowedIds }` 只放行勾选的 id,其余条目计入 `withheld: { count, reason: 'partial' }` 并渲染真实原因;写 / 删审批是单条,不显示勾选框。
11
+ - provider:`requestOutOfScope()` 返回 `{ outcome, allowedIds? }`(老的字符串返回仍兼容);`answerVisibilityApproval(id, outcome, allowedIds?)` 会丢弃不属于本次请求的 id;全选退化为不带 `allowedIds`(= 全部允许,包括超过浮层展示上限的条目);空勾选按拒绝处理。面板 `POST /memory/api/approvals` 接受 `allowedIds`,非数组报 `APPROVAL_IDS_INVALID`。
12
+ - **memory_search / memory_list 的上下文去重**:
13
+ - 注入半边的会话去重状态新增 `summary_injected`(`memory_search` 返回摘要 / `memory_list` 返回正文分别记 `summary_injected` / `content_injected`),持久化状态 code = 3;`markHint` 不再把摘要 / 正文降级成标签。
14
+ - 注入半边新增 `memoryContextDedup` 服务(`ctx.provide`):`seen` / `markSummary` / `markContent`。工具半边在**每次执行时**惰性 `ctx.get`(不在 apply 里取样),拿不到就自然退化为不去重。
15
+ - 规则:同一条记忆、同一 `updatedAt` 版本已经以摘要或正文进入过上下文 → `memory_search` / `memory_list` 只回记忆 ID;内容更新(版本变化)→ 照常返回摘要 / 正文并记住新版本。
16
+ - 返回文本在去重发生时追加固定提示:「本次请求部分记忆摘要因上下文去重机制被省略,若要获取完整内容请使用 memory_get」。`memory_get` 不去重(显式取正文)。系统提示策略段同步说明这条口径。
17
+ - **测试**:InjectionState 的 summary/seen/降级保护;工具层 search/list 的二次去重、版本更新重新返回、逐条允许与 `partial`;面板 `allowedIds`(部分 / 全选 / 空);客户端审批卡按会话过滤 + 逐条勾选 + 提交 `allowedIds` + 样式 token 断言。全套 429 通过 / 1 跳过。
18
+
19
+ ## 0.20.0 — 写入护栏、真实失败原因、默认记忆范围、按钮边框表达限制等级
20
+
21
+ - **默认记忆范围(新会话)**:以前没有显式覆盖 = 完全不限制;现在没有显式覆盖时按默认设置生效:**当前会话 + 当前项目 + global** 三个作用域 + **普通限制**。`visibilityPolicy()` 因此永远返回一份策略,并带 `source: 'explicit' | 'inherited' | 'default'`。
22
+ - 默认策略下普通检索只搜这三个作用域,不会每次都弹审批;显式 `scope:'all'` 或 `memory_get` 命中范围外记录时才发起审批。
23
+ - `visibleScopes()` 语义不变(只代表**显式**覆盖),注入半边的 `inject.extraScopes` / fork 父会话召回不受默认策略影响。
24
+ - **写入护栏(可见范围 = 可操作范围)**:`memory_save` / `memory_forget` 与读取共用同一份可见域。
25
+ - `absolute`:范围外写入报「作用域 … 不存在或不可写」,范围外 id 删除按「不存在」处理,范围外按 query 删除静默无匹配 —— 都不暴露可见域配置。
26
+ - `normal`:范围外写入 / 删除先向用户发一次审批(浮层区分读 / 写 / 删);拒绝、超时、无法审批各自返回真实原因(`VISIBILITY_REJECTED` / `VISIBILITY_TIMEOUT` / `VISIBILITY_UNAVAILABLE`)。
27
+ - `none`:不限制。没有会话上下文的调用(老宿主 / 无 `exec`)不启用护栏。
28
+ - provider 层同样守一道:有 `agent` 且未审批时 `save` 直接拒绝(`SCOPE_NOT_WRITABLE` / `VISIBILITY_APPROVAL_REQUIRED`);面板写入不带 agent,仍是用户本人的操作。
29
+ - **失败信息讲真实原因**:工具结果里的 `withheld` 改为 `{ count, reason: 'rejected' | 'timeout' | 'unavailable' }`,渲染层把原因写进模型可见文本(「用户拒绝了本次访问」「审批在 5 分钟内没有得到答复」「当前环境无法发起审批」)。
30
+ - `absolute` 不再产生 `withheld`,也不再把显式询问范围外 scope 变成 `SCOPE_NOT_VISIBLE` 报错 —— 一律视为不存在。
31
+ - 审批超时与用户主动拒绝已区分:provider 的超时返回 `'timeout'`(以前和拒绝一样)。
32
+ - **记忆范围按钮**:数字 = 生效作用域数量;边框样式 = 限制等级:**绝对限制 = 橙黄(`state-warn-primary`)实线**、**普通限制 = 蓝色(`state-business-primary`)实线**、**无限制 = 灰色虚线**;`title` 里写明「已设置 / 使用默认 / 继承父会话 + 数量 + 等级」。
33
+ - **审批浮层**:区分读取 / 写入 / 删除三种动作(标题、说明文案),写入审批直接展示将被写入的内容。
34
+ - **可见域通知**:恢复默认的注入文案改成「默认 = 会话 + 项目 + global + 普通限制」,并说明写入 / 删除也受同一份可见域约束。
35
+ - 测试:默认策略与默认检索不弹审批、显式 all 的审批 / 拒绝 / 超时、写入与删除护栏(三档 × 工具层与 provider 层)、`withheld` 渲染文案、按钮三档边框与数字。
36
+
5
37
  ## 0.19.2 — 深色模式下勾选框 / 保存按钮配色修正,浮窗再收紧
6
38
 
7
39
  - **根因**:宿主深色主题里 `--dsw-alias-brand-primary` 是近白色;0.19.1 把它当填充色,导致选中的勾选框变成白块(勾不可见)、保存按钮变成白底白字。
package/README.md CHANGED
@@ -39,14 +39,15 @@ JSONL 落盘 · 本机向量检索 · 五个模型工具 · 自动召回 · 硬
39
39
 
40
40
  | 能力 | 说明 |
41
41
  | --- | --- |
42
- | **五个工具** | `memory_save` / `memory_search` / `memory_list` / `memory_get` / `memory_forget`。`memory_search` 只回印象(8 位 id / 作用域 / 类型 / 标签 / 短摘要),正文和元数据用 `memory_get` 的 `fields` 按需取 |
42
+ | **五个工具** | `memory_save` / `memory_search` / `memory_list` / `memory_get` / `memory_forget`。`memory_search` 只回印象(8 位 id / 作用域 / 类型 / 标签 / 短摘要),正文和元数据用 `memory_get` 的 `fields` 按需取;同一会话里已出现过的条目只回 id |
43
43
  | **四种作用域** | 会话 / 项目 / `global` / 自定义名。默认写进当前会话,读默认合并会话 + 项目 + global;项目作用域可起别名 |
44
44
  | **双通道检索** | 词法(IDF + 中文 bigram)**+** 向量(本机 llama-server 的 OpenAI 兼容 `/v1/embeddings`)。向量缺席自动降级,不报错、不阻塞 |
45
45
  | **自动召回** | 每轮按用户问题召回;新会话第一步注入项目 / global 摘要;发布、部署、工具失败等行为按标签触发定向召回 |
46
46
  | **印象形态** | 每轮只给每条记忆的短摘要;模型判断相关但需要细节时再 `memory_get` 取全文,省 token 也不丢信息 |
47
47
  | **硬性规则** | `kind: rule` 进系统提示常驻段;行首带 8 位 id,注入的是摘要,需要全文时用 `memory_get`;旧会话会收到新增 / 编辑提醒;超预算有明确警告,不静默丢弃 |
48
48
  | **会话可见域** | 输入框旁的「记忆范围」按钮设置本会话可读的作用域 + 限制等级(绝对 / 普通 / 无限制);Agent 及其子 Agent 都按它检索、注入与 `memory_get` |
49
- | **范围外审批** | 普通限制下,工具命中可见域外的记忆时会在界面弹出审批:展示查询关键词与范围外记忆摘要(记忆 ID 可悬浮看全文、点击跳面板展开);用户选「拒绝」或「允许一次」 |
49
+ | **范围外审批** | 普通限制下,工具命中可见域外的记忆时会在**对应会话的输入框上方**出现审批卡(样式与系统权限审批一致):展示工具、查询关键词与范围外记忆摘要,可逐条勾选「允许选中的 N 条」或整单「允许一次」,也可以「拒绝」 |
50
+ | **上下文去重** | `memory_search` / `memory_list` 返回过的条目记进会话上下文状态;同一版本再次命中只回记忆 ID,并提示用 `memory_get` 取全文(内容更新后重新给摘要) |
50
51
  | **状态记忆** | `kind: state` 默认 7 天 TTL;注入带「状态,使用前验证」;过期后默认不进检索 / 摘要 / 召回,但 `memory_get` 与面板仍可取 |
51
52
  | **流程索引** | `kind: procedure` 的目录进系统提示:按当前工作区 + 触发词(工具名 / 关键词)列 `id · 触发词 → 标题`,需要时再用 `memory_get` 取全文 |
52
53
  | **可视化管理** | 记录浏览 / 搜索 / 新建 / 编辑 / 删除;**记录页可主动做语义检索**(与 `memory_search` 同一套排序);记忆树展示作用域、类型与修正链;设置改完即存;导入导出 |
@@ -84,22 +85,22 @@ JSONL 落盘 · 本机向量检索 · 五个模型工具 · 自动召回 · 硬
84
85
 
85
86
  ### 输入框的记忆范围
86
87
 
87
- 输入框工具行右侧有「记忆范围」按钮。**打开会话时就会读取这个会话的设置**,按钮只显示当前生效的作用域数量(不再显示「记忆可见域」文字);有显式覆盖时高亮。点开的浮窗使用毛玻璃背景,按当前会话列出可选作用域(当前会话 / 当前项目 / global / 已有自定义作用域):
88
+ 输入框工具行右侧有「记忆范围」按钮。**打开会话时就会读取这个会话的设置**,按钮上的数字是当前生效的作用域数量,边框样式表示限制等级(绝对限制 = 橙黄实线 / 普通限制 = 蓝色实线 / 无限制 = 灰色虚线;`title` 里写明「已设置 / 使用默认 / 继承父会话 + 数量 + 等级」)。点开的浮窗使用毛玻璃背景,按当前会话列出可选作用域(当前会话 / 当前项目 / global / 已有自定义作用域):
88
89
 
89
- - **默认范围**:还没有显式设置时,按「会话 + 项目 + global」预选,不会出现空面板。
90
+ - **默认范围**:没有显式设置时(新会话)按默认设置生效 —— **当前会话 + 当前项目 + global** 三个作用域 + **普通限制**;面板按同一份默认范围预选,不会出现空面板。
90
91
  - **搜索与批量**:顶部可搜索作用域,支持「全选 / 取消全选」;列表最大高度受限,作用域多时在浮窗内滚动。
91
92
  - **限制等级**:
92
- - **绝对限制**:可见域外的记忆一律查不到;即使工具内部命中,也不返回结果。
93
- - **普通限制**(默认):可见域内正常返回;命中范围外记忆时,工具会暂停并向用户发起一次审批,展示 Agent 的查询关键词与范围外记忆摘要。
94
- - **无限制**:不启用范围白名单,可以读取任意作用域(选择仍会保存,供下次切换)。
93
+ - **绝对限制**:可见域外的记忆一律查不到(`memory_get` 按 id 取也取不到,`memory_search` / `memory_list` 不返回、也不告诉模型"被挡住");范围外也写不进去,删除范围外记录按"不存在"处理。
94
+ - **普通限制**(默认):可见域内正常返回;命中范围外记忆时,工具会暂停并在**该会话**的输入框上方显示审批卡,展示 Agent 的查询关键词与范围外记忆摘要;读审批可以逐条勾选,只允许其中一条或多条。用户拒绝 / 5 分钟未回答时,工具结果里会明确写出真实原因(「用户拒绝了本次访问」/「审批超时」),模型不会误以为记忆不存在。范围外写入 / 删除同样走审批。
95
+ - **无限制**:不启用范围白名单,可以读写任意作用域(选择仍会保存,供下次切换)。
95
96
  - **不再按记忆类型收窄**:0.19.1 起只按作用域限制;旧配置里的 `kinds` 会被忽略,同一作用域下的事实 / 规则 / 流程等都可读。
96
- - **审批浮窗**:普通限制下的待审批会出现在界面底部。记忆 ID 悬浮 350ms 后显示完整内容 / 类型 / 作用域 / 重要度 / 标签浮窗(与审计详情同一套行为与样式);点击记忆 ID 跳到「记录」页并展开对应卡片。提供「拒绝」与「允许一次」:允许一次只对本次工具调用生效;拒绝或 5 分钟未回答则工具拿不到这些内容。
97
+ - **审批卡(0.21.0)**:注册在会话内的 `conversation.input.dock`,**只在发起审批的那个会话里显示**,切到别的会话看不到;视觉与系统自带的权限审批弹窗一致(警告色 strip、卡片、右对齐动作行,同一批主题 token)。按动作分为「记忆读取 / 写入 / 删除审批」。读审批默认全部勾选:可取消其中几条后点「允许选中的 N 条」,工具只放行勾选的 id、其余写入 `withheld.reason='partial'`;全选时等价于原来的「允许一次」。写 / 删审批是单条,隐藏勾选框。拒绝、超时或无法发起审批都会把原因告诉模型。Enter = 允许、Esc = 拒绝(焦点在卡片内时)。
97
98
  - 子 Agent 自动继承父会话 / 根会话的设置;在子 Agent 自己的会话里再设置,只影响那一个会话。
98
99
  - 保存后,下一次 Agent 步骤会通过注入的上下文消息收到「可见域已更新」通知(包含可见范围与限制等级),不需要重启会话。
99
- - 「恢复默认」清除覆盖,回到「会话 + 项目 + global」的默认读取集合。
100
+ - 「恢复默认」清除覆盖,回到默认设置(会话 + 项目 + global + 普通限制)。
100
101
  - 覆盖按会话落盘在 `<storeDir>/visibility/<session>.json`,浏览器刷新 / 插件重载后仍在;0.18 的旧文件按「绝对限制」兼容读取。
101
- - 浮窗与审批卡的半透明背景、边框、文字颜色全部走宿主主题 token;勾选框选中态、保存按钮、限制等级选中态使用 `--dsw-alias-state-business-primary` + `--dsw-alias-label-primary-foreground`,深色模式下不会出现白底白勾 / 白底白字;阴影已收敛为小范围投影,滚动列表高度收紧到 `min(220px, 32vh)`。
102
- - 只影响**读取**:`memory_save` 的落点仍由 `scope` 参数与默认写口径决定;面板管理页不受可见域限制。
102
+ - 浮窗与审批卡的半透明背景、边框、文字颜色全部走宿主主题 token;勾选框选中态、保存按钮、限制等级选中态使用 `--dsw-alias-state-business-primary` + `--dsw-alias-label-primary-foreground`,深色模式下不会出现白底白勾 / 白底白字;按钮三档边框用 `state-warn-primary`(橙黄)/ `state-business-primary`(蓝)/ 虚线灰;阴影已收敛为小范围投影,滚动列表高度收紧到 `min(220px, 32vh)`。
103
+ - **可见范围 = 可操作范围(0.20.0 起)**:`memory_search` / `memory_list` / `memory_get` 与 `memory_save` / `memory_forget` 共用同一份可见域;面板管理页仍是用户本人的操作,不受会话语义限制。
103
104
 
104
105
  ### 向量服务
105
106
 
@@ -205,6 +206,11 @@ memory_forget({ "id": "3f2a9c1d" }) // 按内容删:memory_forget({ q
205
206
  `memory_search` 省略 `scope` 时合并**会话 + 项目 + global**(按来源标注、按 id 去重);
206
207
  `scope: "all"` 查所有已发现的作用域,写入路径会明确拒绝 `all`。
207
208
 
209
+ **上下文去重(0.21.0)**:同一会话里已经由 `memory_search` / `memory_list`(或摘要 / 召回 / `memory_get`)
210
+ 放进上下文的条目,再次命中且 `updatedAt` 未变时,`memory_search` / `memory_list` 只回记忆 ID,并附一句
211
+ 「本次请求部分记忆摘要因上下文去重机制被省略,若要获取完整内容请使用 memory_get」;内容更新(版本变化)
212
+ 后会重新返回摘要。状态与召回/摘要共用同一份会话去重记录(`summary_injected` / `content_injected`)。
213
+
208
214
  ### 4. 作用域怎么选
209
215
 
210
216
  | 写法 | 含义 |
@@ -261,6 +267,7 @@ memory_forget({ "id": "3f2a9c1d" }) // 按内容删:memory_forget({ q
261
267
  ### 去重与修正
262
268
 
263
269
  - 召回按 **sessionId + 记忆 id / 版本** 去重;只给过标签的记录,任务命中后可补正文;内容更新会重新评估。
270
+ - **工具结果也参与去重(0.21.0)**:`memory_search` 返回过的摘要记为 `summary_injected`,`memory_list` 返回过的正文记为 `content_injected`。同一会话再次命中同版本条目时只回记忆 ID 并提示用 `memory_get` 取全文;版本变化(`updatedAt`)后重新返回。标签索引(`hint_injected`)只给 id + tags,不算摘要已出现;`memory_get` 始终显式返回正文,不做去重。
264
271
  - `memory_get` 取到正文后,这条记忆会记成「正文已注入」;同一会话后续的普通召回 / 摘要 / 自动召回都不会再把同一段正文塞一遍。只取 `summary` / `tags` / 元数据不算正文,仍可被召回。
265
272
  - `memory_save` **保存成功**同样算「正文已在上下文里」:写入语句(`content`)就是模型自己产出的 tool/call 参数,因此这条记录会立刻记成「正文已注入」,本会话后续的召回 / 摘要不会把刚保存的记忆原样再注入一次(去重命中既有记录时也一样)。保存失败不标记;记录之后被更新(`updatedAt` 变化)仍会重新评估。审计里会留一条 `content_pinned / saved_in_context` 的 lifecycle 事件,说明后面的「去重跳过」从哪来。
266
273
  - **去重状态持久化**:状态写到会话工作区的插件目录
@@ -520,6 +527,7 @@ npm run verify # 构建到 .verify/,不落 packages/
520
527
 
521
528
  ## 更新日志
522
529
 
530
+ - **0.21.0** —— 范围外审批卡改为会话内展示(对齐系统权限审批的样式与行为),读审批支持逐条勾选允许;`memory_search` / `memory_list` 引入会话上下文去重,已出现过的条目只回记忆 ID 并提示用 `memory_get`(内容更新后重新给摘要)。
523
531
  - **0.12.7** —— 审计详情可完整滚到底;ID 浮窗改为按气泡位置固定显示,延迟 hover 显示、可移入浮窗,点击气泡或浮窗都直接跳转。
524
532
  - **0.12.6** —— 审计详情分类展示选中/新增/标签/省略/去重 ID;记忆与会话 ID 支持 hover 浮窗和点击跳转;详情独立滚动可到底。
525
533
  - **0.12.5** —— 审计表头移入滚动容器并 sticky,与行严格对齐;重分配列宽,行内预算改紧凑条。