@restregular/dsh-memory 0.20.0 → 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,20 @@
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
+
5
19
  ## 0.20.0 — 写入护栏、真实失败原因、默认记忆范围、按钮边框表达限制等级
6
20
 
7
21
  - **默认记忆范围(新会话)**:以前没有显式覆盖 = 完全不限制;现在没有显式覆盖时按默认设置生效:**当前会话 + 当前项目 + global** 三个作用域 + **普通限制**。`visibilityPolicy()` 因此永远返回一份策略,并带 `source: 'explicit' | 'inherited' | 'default'`。
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` 同一套排序);记忆树展示作用域、类型与修正链;设置改完即存;导入导出 |
@@ -90,10 +91,10 @@ JSONL 落盘 · 本机向量检索 · 五个模型工具 · 自动召回 · 硬
90
91
  - **搜索与批量**:顶部可搜索作用域,支持「全选 / 取消全选」;列表最大高度受限,作用域多时在浮窗内滚动。
91
92
  - **限制等级**:
92
93
  - **绝对限制**:可见域外的记忆一律查不到(`memory_get` 按 id 取也取不到,`memory_search` / `memory_list` 不返回、也不告诉模型"被挡住");范围外也写不进去,删除范围外记录按"不存在"处理。
93
- - **普通限制**(默认):可见域内正常返回;命中范围外记忆时,工具会暂停并向用户发起一次审批,展示 Agent 的查询关键词与范围外记忆摘要。用户拒绝 / 5 分钟未回答时,工具结果里会明确写出真实原因(「用户拒绝了本次访问」/「审批超时」),模型不会误以为记忆不存在。范围外写入 / 删除同样走审批。
94
+ - **普通限制**(默认):可见域内正常返回;命中范围外记忆时,工具会暂停并在**该会话**的输入框上方显示审批卡,展示 Agent 的查询关键词与范围外记忆摘要;读审批可以逐条勾选,只允许其中一条或多条。用户拒绝 / 5 分钟未回答时,工具结果里会明确写出真实原因(「用户拒绝了本次访问」/「审批超时」),模型不会误以为记忆不存在。范围外写入 / 删除同样走审批。
94
95
  - **无限制**:不启用范围白名单,可以读写任意作用域(选择仍会保存,供下次切换)。
95
96
  - **不再按记忆类型收窄**:0.19.1 起只按作用域限制;旧配置里的 `kinds` 会被忽略,同一作用域下的事实 / 规则 / 流程等都可读。
96
- - **审批浮窗**:普通限制下的待审批会出现在界面底部,按动作分为「记忆读取审批 / 记忆写入审批 / 记忆删除审批」。记忆 ID 悬浮 350ms 后显示完整内容 / 类型 / 作用域 / 重要度 / 标签浮窗(与审计详情同一套行为与样式);点击记忆 ID 跳到「记录」页并展开对应卡片。提供「拒绝」与「允许一次」:允许一次只对本次工具调用生效;拒绝、超时或无法发起审批都会把原因告诉模型。
97
+ - **审批卡(0.21.0)**:注册在会话内的 `conversation.input.dock`,**只在发起审批的那个会话里显示**,切到别的会话看不到;视觉与系统自带的权限审批弹窗一致(警告色 strip、卡片、右对齐动作行,同一批主题 token)。按动作分为「记忆读取 / 写入 / 删除审批」。读审批默认全部勾选:可取消其中几条后点「允许选中的 N 条」,工具只放行勾选的 id、其余写入 `withheld.reason='partial'`;全选时等价于原来的「允许一次」。写 / 删审批是单条,隐藏勾选框。拒绝、超时或无法发起审批都会把原因告诉模型。Enter = 允许、Esc = 拒绝(焦点在卡片内时)。
97
98
  - 子 Agent 自动继承父会话 / 根会话的设置;在子 Agent 自己的会话里再设置,只影响那一个会话。
98
99
  - 保存后,下一次 Agent 步骤会通过注入的上下文消息收到「可见域已更新」通知(包含可见范围与限制等级),不需要重启会话。
99
100
  - 「恢复默认」清除覆盖,回到默认设置(会话 + 项目 + global + 普通限制)。
@@ -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,与行严格对齐;重分配列宽,行内预算改紧凑条。