@restregular/dsh-memory 0.20.0 → 0.22.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 +24 -0
- package/README.md +22 -8
- package/lib/client.js +5333 -5250
- package/lib/inject/apply.js +28 -0
- package/lib/inject/policy.js +4 -0
- package/lib/inject/session-state-store.js +3 -1
- package/lib/inject/state.js +51 -3
- package/lib/panel.js +9 -1
- package/lib/provider/apply.js +3 -3
- package/lib/provider/index.js +44 -10
- package/lib/tools/apply.js +45 -6
- package/lib/tools/index.js +250 -40
- package/lib/tools/render.js +45 -6
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -2,6 +2,30 @@
|
|
|
2
2
|
|
|
3
3
|
本项目的版本记录。安装 id 与 npm 版本一一对应。
|
|
4
4
|
|
|
5
|
+
## 0.22.0 — 审批卡全选/取消全选、点 ID 跳面板记录页、工具新增 description
|
|
6
|
+
|
|
7
|
+
- **审批卡支持批量勾选**:逐条勾选之外新增「全选 / 取消全选」,并显示「已选 N / 总数」;全选后按钮仍是「允许一次」(提交时不带 `allowedIds`),取消全选后允许按钮禁用(要拒绝请点「拒绝」)。
|
|
8
|
+
- **点记忆 ID 跳面板**:审批卡里的记忆 ID 变成按钮,点击后打开记忆面板「记录」标签页、选中并滚动到该条、自动展开(复用 `dsh-memory:record-focus` 焦点总线;列表里没有该条时用审批载荷里的快照补一张卡)。写 / 删审批的合成条目不是真实记录,ID 保持纯文本。
|
|
9
|
+
- **工具新增 `description`(普通限制下必填)**:五个 `memory_*` 工具都新增 `description` 参数(一句话说明这次调用要做什么)。当本会话生效的「记忆范围」限制等级为**普通限制**(默认)时,省略或空白会被 `DESCRIPTION_REQUIRED` 拒绝;绝对限制 / 无限制下可省略。拿不到会话上下文的调用(老宿主 / 面板直调)不强制。
|
|
10
|
+
- 审批弹窗展示 `Agent 说明:<description>`,与查询关键词一起给用户判断依据。
|
|
11
|
+
- `requestOutOfScope` 的输入与 pending 视图新增 `description`;`/memory/api/approvals` 原样返回;系统提示策略段同步说明这条口径。
|
|
12
|
+
- **`memory_search` 去重 ID 单独成块**:上下文去重导致只回记忆 ID 时,这些裸 ID 与带摘要的条目之间空一行(不再看起来像上一条的续行);末尾仍保留「摘要因上下文去重被省略」提示。
|
|
13
|
+
- **测试**:审批卡全选/取消全选、description 展示与 ID 跳转焦点;普通限制下缺 `description` 拒绝 / 提供后随审批载荷传递;绝对限制 / 无限制不强制;去重 ID 与摘要条目之间的空行。全套通过。
|
|
14
|
+
|
|
15
|
+
## 0.21.0 — 审批卡进会话内、逐条允许;memory_search / memory_list 上下文去重
|
|
16
|
+
|
|
17
|
+
- **范围外审批卡重做(行为 + 样式对齐系统权限审批弹窗)**:
|
|
18
|
+
- 注册位置从 `shell.overlay`(全局 fixed 浮层)改为 `conversation.input.dock`(会话作用域的输入框上方)。审批**只在发起它的那个会话里显示**:切到别的会话看不到,也不会盖住设置页 / 别的会话;组件按标准 `sessionId` prop 轮询 `/memory/api/approvals?session=…`。
|
|
19
|
+
- 版式照抄宿主 `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 = 拒绝(焦点在卡片内)。
|
|
20
|
+
- **逐条允许**:读审批默认全选,可以取消其中一条或多条,按钮变成「允许选中的 N 条」;全选时仍是「允许一次」。工具侧按 `{ outcome: 'allowed-once', allowedIds }` 只放行勾选的 id,其余条目计入 `withheld: { count, reason: 'partial' }` 并渲染真实原因;写 / 删审批是单条,不显示勾选框。
|
|
21
|
+
- provider:`requestOutOfScope()` 返回 `{ outcome, allowedIds? }`(老的字符串返回仍兼容);`answerVisibilityApproval(id, outcome, allowedIds?)` 会丢弃不属于本次请求的 id;全选退化为不带 `allowedIds`(= 全部允许,包括超过浮层展示上限的条目);空勾选按拒绝处理。面板 `POST /memory/api/approvals` 接受 `allowedIds`,非数组报 `APPROVAL_IDS_INVALID`。
|
|
22
|
+
- **memory_search / memory_list 的上下文去重**:
|
|
23
|
+
- 注入半边的会话去重状态新增 `summary_injected`(`memory_search` 返回摘要 / `memory_list` 返回正文分别记 `summary_injected` / `content_injected`),持久化状态 code = 3;`markHint` 不再把摘要 / 正文降级成标签。
|
|
24
|
+
- 注入半边新增 `memoryContextDedup` 服务(`ctx.provide`):`seen` / `markSummary` / `markContent`。工具半边在**每次执行时**惰性 `ctx.get`(不在 apply 里取样),拿不到就自然退化为不去重。
|
|
25
|
+
- 规则:同一条记忆、同一 `updatedAt` 版本已经以摘要或正文进入过上下文 → `memory_search` / `memory_list` 只回记忆 ID;内容更新(版本变化)→ 照常返回摘要 / 正文并记住新版本。
|
|
26
|
+
- 返回文本在去重发生时追加固定提示:「本次请求部分记忆摘要因上下文去重机制被省略,若要获取完整内容请使用 memory_get」。`memory_get` 不去重(显式取正文)。系统提示策略段同步说明这条口径。
|
|
27
|
+
- **测试**:InjectionState 的 summary/seen/降级保护;工具层 search/list 的二次去重、版本更新重新返回、逐条允许与 `partial`;面板 `allowedIds`(部分 / 全选 / 空);客户端审批卡按会话过滤 + 逐条勾选 + 提交 `allowedIds` + 样式 token 断言。全套 429 通过 / 1 跳过。
|
|
28
|
+
|
|
5
29
|
## 0.20.0 — 写入护栏、真实失败原因、默认记忆范围、按钮边框表达限制等级
|
|
6
30
|
|
|
7
31
|
- **默认记忆范围(新会话)**:以前没有显式覆盖 = 完全不限制;现在没有显式覆盖时按默认设置生效:**当前会话 + 当前项目 + 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。`description` 字段在普通限制下必填,审批卡会展示它 |
|
|
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
|
-
| **范围外审批** |
|
|
49
|
+
| **范围外审批** | 普通限制下,工具命中可见域外的记忆时会在**对应会话的输入框上方**出现审批卡(样式与系统权限审批一致):展示工具、Agent 说明、查询关键词与范围外记忆摘要,支持逐条勾选 / 全选 / 取消全选(「允许选中的 N 条」或整单「允许一次」)或「拒绝」;点记忆 ID 直接跳到面板「记录」页并展开该条 |
|
|
50
|
+
| **上下文去重** | `memory_search` / `memory_list` 返回过的条目记进会话上下文状态;同一版本再次命中只回记忆 ID(`memory_search` 的裸 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
|
-
-
|
|
94
|
+
- **普通限制**(默认):可见域内正常返回;命中范围外记忆时,工具会暂停并在**该会话**的输入框上方显示审批卡,展示 Agent 的查询关键词与范围外记忆摘要;读审批可以逐条勾选,只允许其中一条或多条。用户拒绝 / 5 分钟未回答时,工具结果里会明确写出真实原因(「用户拒绝了本次访问」/「审批超时」),模型不会误以为记忆不存在。范围外写入 / 删除同样走审批。
|
|
94
95
|
- **无限制**:不启用范围白名单,可以读写任意作用域(选择仍会保存,供下次切换)。
|
|
95
96
|
- **不再按记忆类型收窄**:0.19.1 起只按作用域限制;旧配置里的 `kinds` 会被忽略,同一作用域下的事实 / 规则 / 流程等都可读。
|
|
96
|
-
-
|
|
97
|
+
- **审批卡(0.21.0 / 0.22.0)**:注册在会话内的 `conversation.input.dock`,**只在发起审批的那个会话里显示**,切到别的会话看不到;视觉与系统自带的权限审批弹窗一致(警告色 strip、卡片、右对齐动作行,同一批主题 token)。按动作分为「记忆读取 / 写入 / 删除审批」。读审批默认全部勾选:可逐条取消、用「全选 / 取消全选」批量操作,再点「允许选中的 N 条」,工具只放行勾选的 id、其余写入 `withheld.reason='partial'`;全选时等价于原来的「允许一次」。写 / 删审批是单条,隐藏勾选框。**0.22.0 起**卡片展示工具调用的 `description`(普通限制下工具层强制模型提供),点记忆 ID 会打开记忆面板的「记录」标签页、选中并滚动到该条、自动展开。拒绝、超时或无法发起审批都会把原因告诉模型。Enter = 允许、Esc = 拒绝(焦点在卡片内时)。
|
|
97
98
|
- 子 Agent 自动继承父会话 / 根会话的设置;在子 Agent 自己的会话里再设置,只影响那一个会话。
|
|
98
99
|
- 保存后,下一次 Agent 步骤会通过注入的上下文消息收到「可见域已更新」通知(包含可见范围与限制等级),不需要重启会话。
|
|
99
100
|
- 「恢复默认」清除覆盖,回到默认设置(会话 + 项目 + global + 普通限制)。
|
|
@@ -185,13 +186,13 @@ memory_save({
|
|
|
185
186
|
### 3. 检索、取全文、列出、忘记
|
|
186
187
|
|
|
187
188
|
```jsonc
|
|
188
|
-
memory_search({ "query": "pnpm 装依赖", "topK": 5 })
|
|
189
|
-
memory_search({ "query": "旧的发布流程", "includeSuperseded": true }) // 默认隐藏被修正/覆盖的旧版本
|
|
190
|
-
memory_get({ "ids": ["3f2a9c1d"] })
|
|
189
|
+
memory_search({ "query": "pnpm 装依赖", "topK": 5, "description": "查装依赖的约定" }) // 只回 id / 作用域 / 类型 / 标签 / 摘要
|
|
190
|
+
memory_search({ "query": "旧的发布流程", "includeSuperseded": true, "description": "核对旧发布流程" }) // 默认隐藏被修正/覆盖的旧版本
|
|
191
|
+
memory_get({ "ids": ["3f2a9c1d"], "description": "取装依赖那条的全文" }) // 默认:正文 + scope + kind + tags
|
|
191
192
|
memory_get({ "ids": ["3f2a9c1d"], "fields": ["summary", "updatedAt"] })
|
|
192
193
|
memory_get({ "ids": ["3f2a9c1d"], "fields": ["content"] }) // 只要正文
|
|
193
194
|
memory_list({ "limit": 20 })
|
|
194
|
-
memory_forget({ "id": "3f2a9c1d" })
|
|
195
|
+
memory_forget({ "id": "3f2a9c1d", "description": "删除过期的临时结论" }) // 按内容删:memory_forget({ query, scope })
|
|
195
196
|
```
|
|
196
197
|
|
|
197
198
|
`memory_search` 不再返回正文:每条只有 8 位 id、作用域、类型、标签和摘要(默认 160 字,
|
|
@@ -205,6 +206,16 @@ 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
|
+
后会重新返回摘要。`memory_search` 里这些裸 ID 单独成块,与带摘要的条目之间**空一行**,不会看起来像
|
|
213
|
+
上一条的续行。状态与召回/摘要共用同一份会话去重记录(`summary_injected` / `content_injected`)。
|
|
214
|
+
|
|
215
|
+
**`description`(0.22.0)**:五个工具都新增 `description` 参数 —— 一句话说明这次调用要做什么。
|
|
216
|
+
本会话「记忆范围」为**普通限制**(默认)时**必填**,漏了会被 `DESCRIPTION_REQUIRED` 拒绝;
|
|
217
|
+
绝对限制 / 无限制下可省略。它只用于范围外访问的审批卡(展示给用户判断是否放行),不写进记忆。
|
|
218
|
+
|
|
208
219
|
### 4. 作用域怎么选
|
|
209
220
|
|
|
210
221
|
| 写法 | 含义 |
|
|
@@ -261,6 +272,7 @@ memory_forget({ "id": "3f2a9c1d" }) // 按内容删:memory_forget({ q
|
|
|
261
272
|
### 去重与修正
|
|
262
273
|
|
|
263
274
|
- 召回按 **sessionId + 记忆 id / 版本** 去重;只给过标签的记录,任务命中后可补正文;内容更新会重新评估。
|
|
275
|
+
- **工具结果也参与去重(0.21.0)**:`memory_search` 返回过的摘要记为 `summary_injected`,`memory_list` 返回过的正文记为 `content_injected`。同一会话再次命中同版本条目时只回记忆 ID 并提示用 `memory_get` 取全文;版本变化(`updatedAt`)后重新返回。标签索引(`hint_injected`)只给 id + tags,不算摘要已出现;`memory_get` 始终显式返回正文,不做去重。
|
|
264
276
|
- `memory_get` 取到正文后,这条记忆会记成「正文已注入」;同一会话后续的普通召回 / 摘要 / 自动召回都不会再把同一段正文塞一遍。只取 `summary` / `tags` / 元数据不算正文,仍可被召回。
|
|
265
277
|
- `memory_save` **保存成功**同样算「正文已在上下文里」:写入语句(`content`)就是模型自己产出的 tool/call 参数,因此这条记录会立刻记成「正文已注入」,本会话后续的召回 / 摘要不会把刚保存的记忆原样再注入一次(去重命中既有记录时也一样)。保存失败不标记;记录之后被更新(`updatedAt` 变化)仍会重新评估。审计里会留一条 `content_pinned / saved_in_context` 的 lifecycle 事件,说明后面的「去重跳过」从哪来。
|
|
266
278
|
- **去重状态持久化**:状态写到会话工作区的插件目录
|
|
@@ -520,6 +532,8 @@ npm run verify # 构建到 .verify/,不落 packages/
|
|
|
520
532
|
|
|
521
533
|
## 更新日志
|
|
522
534
|
|
|
535
|
+
- **0.22.0** —— 审批卡支持「全选 / 取消全选」,展示工具调用的 `description`,点记忆 ID 跳到面板「记录」页并展开;`memory_*` 新增 `description`(普通限制下必填);`memory_search` 的去重裸 ID 与带摘要条目之间空一行。
|
|
536
|
+
- **0.21.0** —— 范围外审批卡改为会话内展示(对齐系统权限审批的样式与行为),读审批支持逐条勾选允许;`memory_search` / `memory_list` 引入会话上下文去重,已出现过的条目只回记忆 ID 并提示用 `memory_get`(内容更新后重新给摘要)。
|
|
523
537
|
- **0.12.7** —— 审计详情可完整滚到底;ID 浮窗改为按气泡位置固定显示,延迟 hover 显示、可移入浮窗,点击气泡或浮窗都直接跳转。
|
|
524
538
|
- **0.12.6** —— 审计详情分类展示选中/新增/标签/省略/去重 ID;记忆与会话 ID 支持 hover 浮窗和点击跳转;详情独立滚动可到底。
|
|
525
539
|
- **0.12.5** —— 审计表头移入滚动容器并 sticky,与行严格对齐;重分配列宽,行内预算改紧凑条。
|