@restregular/dsh-memory 0.21.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 +10 -0
- package/README.md +15 -9
- package/lib/client.js +43 -2
- package/lib/inject/policy.js +2 -0
- package/lib/provider/index.js +7 -0
- package/lib/tools/index.js +69 -7
- package/lib/tools/render.js +11 -7
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -2,6 +2,16 @@
|
|
|
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
|
+
|
|
5
15
|
## 0.21.0 — 审批卡进会话内、逐条允许;memory_search / memory_list 上下文去重
|
|
6
16
|
|
|
7
17
|
- **范围外审批卡重做(行为 + 样式对齐系统权限审批弹窗)**:
|
package/README.md
CHANGED
|
@@ -39,15 +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` 按需取;同一会话里已出现过的条目只回 id |
|
|
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
|
-
| **范围外审批** |
|
|
50
|
-
| **上下文去重** | `memory_search` / `memory_list` 返回过的条目记进会话上下文状态;同一版本再次命中只回记忆 ID
|
|
49
|
+
| **范围外审批** | 普通限制下,工具命中可见域外的记忆时会在**对应会话的输入框上方**出现审批卡(样式与系统权限审批一致):展示工具、Agent 说明、查询关键词与范围外记忆摘要,支持逐条勾选 / 全选 / 取消全选(「允许选中的 N 条」或整单「允许一次」)或「拒绝」;点记忆 ID 直接跳到面板「记录」页并展开该条 |
|
|
50
|
+
| **上下文去重** | `memory_search` / `memory_list` 返回过的条目记进会话上下文状态;同一版本再次命中只回记忆 ID(`memory_search` 的裸 ID 与带摘要条目之间空一行),并提示用 `memory_get` 取全文(内容更新后重新给摘要) |
|
|
51
51
|
| **状态记忆** | `kind: state` 默认 7 天 TTL;注入带「状态,使用前验证」;过期后默认不进检索 / 摘要 / 召回,但 `memory_get` 与面板仍可取 |
|
|
52
52
|
| **流程索引** | `kind: procedure` 的目录进系统提示:按当前工作区 + 触发词(工具名 / 关键词)列 `id · 触发词 → 标题`,需要时再用 `memory_get` 取全文 |
|
|
53
53
|
| **可视化管理** | 记录浏览 / 搜索 / 新建 / 编辑 / 删除;**记录页可主动做语义检索**(与 `memory_search` 同一套排序);记忆树展示作用域、类型与修正链;设置改完即存;导入导出 |
|
|
@@ -94,7 +94,7 @@ JSONL 落盘 · 本机向量检索 · 五个模型工具 · 自动召回 · 硬
|
|
|
94
94
|
- **普通限制**(默认):可见域内正常返回;命中范围外记忆时,工具会暂停并在**该会话**的输入框上方显示审批卡,展示 Agent 的查询关键词与范围外记忆摘要;读审批可以逐条勾选,只允许其中一条或多条。用户拒绝 / 5 分钟未回答时,工具结果里会明确写出真实原因(「用户拒绝了本次访问」/「审批超时」),模型不会误以为记忆不存在。范围外写入 / 删除同样走审批。
|
|
95
95
|
- **无限制**:不启用范围白名单,可以读写任意作用域(选择仍会保存,供下次切换)。
|
|
96
96
|
- **不再按记忆类型收窄**:0.19.1 起只按作用域限制;旧配置里的 `kinds` 会被忽略,同一作用域下的事实 / 规则 / 流程等都可读。
|
|
97
|
-
- **审批卡(0.21.0)**:注册在会话内的 `conversation.input.dock`,**只在发起审批的那个会话里显示**,切到别的会话看不到;视觉与系统自带的权限审批弹窗一致(警告色 strip、卡片、右对齐动作行,同一批主题 token)。按动作分为「记忆读取 / 写入 /
|
|
97
|
+
- **审批卡(0.21.0 / 0.22.0)**:注册在会话内的 `conversation.input.dock`,**只在发起审批的那个会话里显示**,切到别的会话看不到;视觉与系统自带的权限审批弹窗一致(警告色 strip、卡片、右对齐动作行,同一批主题 token)。按动作分为「记忆读取 / 写入 / 删除审批」。读审批默认全部勾选:可逐条取消、用「全选 / 取消全选」批量操作,再点「允许选中的 N 条」,工具只放行勾选的 id、其余写入 `withheld.reason='partial'`;全选时等价于原来的「允许一次」。写 / 删审批是单条,隐藏勾选框。**0.22.0 起**卡片展示工具调用的 `description`(普通限制下工具层强制模型提供),点记忆 ID 会打开记忆面板的「记录」标签页、选中并滚动到该条、自动展开。拒绝、超时或无法发起审批都会把原因告诉模型。Enter = 允许、Esc = 拒绝(焦点在卡片内时)。
|
|
98
98
|
- 子 Agent 自动继承父会话 / 根会话的设置;在子 Agent 自己的会话里再设置,只影响那一个会话。
|
|
99
99
|
- 保存后,下一次 Agent 步骤会通过注入的上下文消息收到「可见域已更新」通知(包含可见范围与限制等级),不需要重启会话。
|
|
100
100
|
- 「恢复默认」清除覆盖,回到默认设置(会话 + 项目 + global + 普通限制)。
|
|
@@ -186,13 +186,13 @@ memory_save({
|
|
|
186
186
|
### 3. 检索、取全文、列出、忘记
|
|
187
187
|
|
|
188
188
|
```jsonc
|
|
189
|
-
memory_search({ "query": "pnpm 装依赖", "topK": 5 })
|
|
190
|
-
memory_search({ "query": "旧的发布流程", "includeSuperseded": true }) // 默认隐藏被修正/覆盖的旧版本
|
|
191
|
-
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
|
|
192
192
|
memory_get({ "ids": ["3f2a9c1d"], "fields": ["summary", "updatedAt"] })
|
|
193
193
|
memory_get({ "ids": ["3f2a9c1d"], "fields": ["content"] }) // 只要正文
|
|
194
194
|
memory_list({ "limit": 20 })
|
|
195
|
-
memory_forget({ "id": "3f2a9c1d" })
|
|
195
|
+
memory_forget({ "id": "3f2a9c1d", "description": "删除过期的临时结论" }) // 按内容删:memory_forget({ query, scope })
|
|
196
196
|
```
|
|
197
197
|
|
|
198
198
|
`memory_search` 不再返回正文:每条只有 8 位 id、作用域、类型、标签和摘要(默认 160 字,
|
|
@@ -209,7 +209,12 @@ memory_forget({ "id": "3f2a9c1d" }) // 按内容删:memory_forget({ q
|
|
|
209
209
|
**上下文去重(0.21.0)**:同一会话里已经由 `memory_search` / `memory_list`(或摘要 / 召回 / `memory_get`)
|
|
210
210
|
放进上下文的条目,再次命中且 `updatedAt` 未变时,`memory_search` / `memory_list` 只回记忆 ID,并附一句
|
|
211
211
|
「本次请求部分记忆摘要因上下文去重机制被省略,若要获取完整内容请使用 memory_get」;内容更新(版本变化)
|
|
212
|
-
|
|
212
|
+
后会重新返回摘要。`memory_search` 里这些裸 ID 单独成块,与带摘要的条目之间**空一行**,不会看起来像
|
|
213
|
+
上一条的续行。状态与召回/摘要共用同一份会话去重记录(`summary_injected` / `content_injected`)。
|
|
214
|
+
|
|
215
|
+
**`description`(0.22.0)**:五个工具都新增 `description` 参数 —— 一句话说明这次调用要做什么。
|
|
216
|
+
本会话「记忆范围」为**普通限制**(默认)时**必填**,漏了会被 `DESCRIPTION_REQUIRED` 拒绝;
|
|
217
|
+
绝对限制 / 无限制下可省略。它只用于范围外访问的审批卡(展示给用户判断是否放行),不写进记忆。
|
|
213
218
|
|
|
214
219
|
### 4. 作用域怎么选
|
|
215
220
|
|
|
@@ -527,6 +532,7 @@ npm run verify # 构建到 .verify/,不落 packages/
|
|
|
527
532
|
|
|
528
533
|
## 更新日志
|
|
529
534
|
|
|
535
|
+
- **0.22.0** —— 审批卡支持「全选 / 取消全选」,展示工具调用的 `description`,点记忆 ID 跳到面板「记录」页并展开;`memory_*` 新增 `description`(普通限制下必填);`memory_search` 的去重裸 ID 与带摘要条目之间空一行。
|
|
530
536
|
- **0.21.0** —— 范围外审批卡改为会话内展示(对齐系统权限审批的样式与行为),读审批支持逐条勾选允许;`memory_search` / `memory_list` 引入会话上下文去重,已出现过的条目只回记忆 ID 并提示用 `memory_get`(内容更新后重新给摘要)。
|
|
531
537
|
- **0.12.7** —— 审计详情可完整滚到底;ID 浮窗改为按气泡位置固定显示,延迟 hover 显示、可移入浮窗,点击气泡或浮窗都直接跳转。
|
|
532
538
|
- **0.12.6** —— 审计详情分类展示选中/新增/标签/省略/去重 ID;记忆与会话 ID 支持 hover 浮窗和点击跳转;详情独立滚动可到底。
|
package/lib/client.js
CHANGED
|
@@ -558,7 +558,14 @@ window.__ModuleLoader__.load({
|
|
|
558
558
|
'.mem-approval-item.is-off{opacity:.62}',
|
|
559
559
|
'.mem-approval-item-body{display:flex;flex-direction:column;gap:4px;min-width:0;flex:1}',
|
|
560
560
|
'.mem-approval-row{display:flex;align-items:center;gap:6px;flex-wrap:wrap}',
|
|
561
|
-
'.mem-approval-id{font-family:var(--ds-font-family-code,ui-monospace,SFMono-Regular,Consolas,monospace);font-size:11px;color:var(--dsw-alias-label-secondary)}',
|
|
561
|
+
'.mem-approval-id{font-family:var(--ds-font-family-code,ui-monospace,SFMono-Regular,Consolas,monospace);font-size:11px;color:var(--dsw-alias-label-secondary);padding:0;border:none;background:transparent;text-align:left;line-height:1.4;cursor:pointer;border-radius:4px}',
|
|
562
|
+
'.mem-approval-id:hover{color:var(--dsw-alias-state-business-primary,#4176e6);text-decoration:underline}',
|
|
563
|
+
'.mem-approval-id:focus-visible{outline:1px solid var(--dsw-focus-ring-color,var(--dsw-alias-state-business-primary));outline-offset:2px}',
|
|
564
|
+
'.mem-approval-desc{color:var(--dsw-alias-label-primary);font-size:12.5px;line-height:1.55;word-break:break-word;white-space:pre-wrap;max-height:90px;overflow:auto}',
|
|
565
|
+
'.mem-approval-bulk{display:flex;align-items:center;gap:8px;font-size:11.5px;color:var(--dsw-alias-label-secondary)}',
|
|
566
|
+
'.mem-approval-bulk button{padding:0;border:none;background:transparent;color:var(--dsw-alias-state-business-primary,#4176e6);font-size:11.5px;cursor:pointer}',
|
|
567
|
+
'.mem-approval-bulk button:hover:not(:disabled){text-decoration:underline}',
|
|
568
|
+
'.mem-approval-bulk button:disabled{color:var(--dsw-alias-label-secondary);opacity:.55;cursor:default;text-decoration:none}',
|
|
562
569
|
'.mem-approval-summary{color:var(--dsw-alias-label-secondary);font-size:11.5px;line-height:1.5;word-break:break-word}',
|
|
563
570
|
'.mem-approval-check{display:inline-flex;align-items:center;justify-content:center;width:18px;height:18px;margin-top:1px;padding:0;border:none;background:transparent;flex:none;cursor:pointer}',
|
|
564
571
|
'.mem-approval-check .box{display:flex;align-items:center;justify-content:center;width:16px;height:16px;border:1.5px solid color-mix(in srgb,var(--dsw-alias-label-secondary) 52%,var(--dsw-alias-border-l1));border-radius:5px;background:color-mix(in srgb,var(--dsw-alias-label-primary) 5%,transparent);color:var(--dsw-alias-label-primary-foreground);transition:background .12s ease,border-color .12s ease}',
|
|
@@ -4859,6 +4866,8 @@ window.__ModuleLoader__.load({
|
|
|
4859
4866
|
? 'Agent 想删除可见域外的记忆。允许只对本次调用生效;拒绝则不删除。'
|
|
4860
4867
|
: '以下记忆不在本会话的可见域内。勾选要允许的条目(默认全选);允许只对本次调用生效,其余条目不会返回。'
|
|
4861
4868
|
const items = Array.isArray(pending.items) ? pending.items : []
|
|
4869
|
+
// 模型写的用途说明(0.22.0;普通限制下工具层强制提供)。
|
|
4870
|
+
const description = typeof pending.description === 'string' ? pending.description.trim() : ''
|
|
4862
4871
|
const allIds = items.map((item) => item.id)
|
|
4863
4872
|
// 只有"读 + 多条"才有逐条勾选的意义:写/删是单条,允许就是允许。
|
|
4864
4873
|
const selectable = action === 'read' && allIds.length > 1
|
|
@@ -4875,6 +4884,10 @@ window.__ModuleLoader__.load({
|
|
|
4875
4884
|
})
|
|
4876
4885
|
}
|
|
4877
4886
|
|
|
4887
|
+
// 逐条勾选之外的批量操作:全选 / 取消全选(0.22.0)。
|
|
4888
|
+
const selectAll = () => setPicked((prev) => ({ ...prev, [pending.id]: [...allIds] }))
|
|
4889
|
+
const clearAll = () => setPicked((prev) => ({ ...prev, [pending.id]: [] }))
|
|
4890
|
+
|
|
4878
4891
|
const answer = (outcome, ids) => {
|
|
4879
4892
|
if (busy === pending.id) return
|
|
4880
4893
|
setBusy(pending.id)
|
|
@@ -4943,6 +4956,25 @@ window.__ModuleLoader__.load({
|
|
|
4943
4956
|
h('div', { className: 'mem-approval-headline' }, `工具 ${pending.tool || 'memory'} 请求${actionLabel}可见域外的记忆`),
|
|
4944
4957
|
h('div', { className: 'mem-approval-hint' }, actionHint),
|
|
4945
4958
|
h('div', { className: 'mem-approval-command' }, `Agent 查询:${pending.query || '(未提供)'}`),
|
|
4959
|
+
description !== ''
|
|
4960
|
+
? h('div', { className: 'mem-approval-desc', title: description }, `Agent 说明:${description}`)
|
|
4961
|
+
: null,
|
|
4962
|
+
selectable
|
|
4963
|
+
? h('div', { className: 'mem-approval-bulk' },
|
|
4964
|
+
h('span', null, `已选 ${selectedCount} / ${allIds.length}`),
|
|
4965
|
+
h('span', { className: 'spacer' }),
|
|
4966
|
+
h('button', {
|
|
4967
|
+
type: 'button',
|
|
4968
|
+
disabled: busy === pending.id || selectedCount === allIds.length,
|
|
4969
|
+
onClick: selectAll,
|
|
4970
|
+
}, '全选'),
|
|
4971
|
+
h('button', {
|
|
4972
|
+
type: 'button',
|
|
4973
|
+
disabled: busy === pending.id || selectedCount === 0,
|
|
4974
|
+
onClick: clearAll,
|
|
4975
|
+
}, '取消全选'),
|
|
4976
|
+
)
|
|
4977
|
+
: null,
|
|
4946
4978
|
h('div', { className: 'mem-approval-list' },
|
|
4947
4979
|
items.map((item) => {
|
|
4948
4980
|
const checked = !selectable || selectedSet.has(item.id)
|
|
@@ -4959,7 +4991,16 @@ window.__ModuleLoader__.load({
|
|
|
4959
4991
|
: null,
|
|
4960
4992
|
h('div', { className: 'mem-approval-item-body' },
|
|
4961
4993
|
h('div', { className: 'mem-approval-row' },
|
|
4962
|
-
|
|
4994
|
+
action === 'read'
|
|
4995
|
+
? h('button', {
|
|
4996
|
+
type: 'button',
|
|
4997
|
+
className: 'mem-approval-id',
|
|
4998
|
+
title: '在记忆面板中查看并展开这条记忆',
|
|
4999
|
+
'aria-label': `在记忆面板中查看记忆 ${item.id}`,
|
|
5000
|
+
// 点击 → 主面板「记录」页:切 tab、定位、展开并滚到这条(0.22.0)。
|
|
5001
|
+
onClick: () => openMemoryRecordPanel(item.id, item.scope, item),
|
|
5002
|
+
}, String(item.id).length > 12 ? `${item.id.slice(0, 8)}…${item.id.slice(-4)}` : String(item.id))
|
|
5003
|
+
: h('span', { className: 'mem-approval-id', title: item.id }, String(item.id).length > 12 ? `${item.id.slice(0, 8)}…${item.id.slice(-4)}` : String(item.id)),
|
|
4963
5004
|
h('span', { className: 'audit-pill mute' }, item.scope),
|
|
4964
5005
|
h('span', { className: 'audit-pill mute' }, item.kind ? kindMeta(item.kind).label : '未知'),
|
|
4965
5006
|
item.reason === 'kind'
|
package/lib/inject/policy.js
CHANGED
|
@@ -10,6 +10,8 @@ memory_search 只返回印象(ID、作用域、类型、标签和少量摘要
|
|
|
10
10
|
|
|
11
11
|
同一会话里已经出现过的记忆,memory_search / memory_list 只回 ID 并注明“摘要因上下文去重被省略”;那不是没找到,需要正文时直接用 memory_get 取。
|
|
12
12
|
|
|
13
|
+
本会话「记忆范围」为普通限制时(默认),调用任一 memory_* 工具都必须带 description 字段:用一句话说明这次调用要做什么(例如「查发布流程的坑」)。它只用于范围外访问的审批弹窗,不写进记忆;漏了会被工具直接拒绝。绝对限制 / 无限制下可省略。
|
|
14
|
+
|
|
13
15
|
遇到以下情况先查记忆,不要凭猜测开始:
|
|
14
16
|
- 不确定这个项目以前怎么做、有没有既定约定、某个坑是否踩过;
|
|
15
17
|
- 用户的话里出现「上次 / 之前 / 还是那样」这类指代。
|
package/lib/provider/index.js
CHANGED
|
@@ -543,6 +543,8 @@ export function resolveConfig(config = {}) {
|
|
|
543
543
|
|
|
544
544
|
|
|
545
545
|
|
|
546
|
+
|
|
547
|
+
|
|
546
548
|
|
|
547
549
|
|
|
548
550
|
|
|
@@ -1655,6 +1657,8 @@ export class LocalMemoryService {
|
|
|
1655
1657
|
|
|
1656
1658
|
|
|
1657
1659
|
|
|
1660
|
+
|
|
1661
|
+
|
|
1658
1662
|
|
|
1659
1663
|
|
|
1660
1664
|
,
|
|
@@ -1665,6 +1669,7 @@ export class LocalMemoryService {
|
|
|
1665
1669
|
const id = `vis-${Date.now().toString(36)}-${++this.approvalSeq}`
|
|
1666
1670
|
const createdAt = Date.now()
|
|
1667
1671
|
const expiresAt = createdAt + VISIBILITY_APPROVAL_TTL_MS
|
|
1672
|
+
const description = typeof input.description === 'string' ? input.description.replace(/\s+/g, ' ').trim().slice(0, 500) : ''
|
|
1668
1673
|
return new Promise((resolve) => {
|
|
1669
1674
|
let timer
|
|
1670
1675
|
const onAbort = () => finish({ outcome: 'rejected' })
|
|
@@ -1684,6 +1689,7 @@ export class LocalMemoryService {
|
|
|
1684
1689
|
tool: input.tool,
|
|
1685
1690
|
action: input.action ?? 'read',
|
|
1686
1691
|
query: input.query,
|
|
1692
|
+
...(description !== '' ? { description } : {}),
|
|
1687
1693
|
items: input.items.slice(0, VISIBILITY_APPROVAL_MAX_ITEMS).map((item) => ({
|
|
1688
1694
|
...item,
|
|
1689
1695
|
tags: [...item.tags],
|
|
@@ -1708,6 +1714,7 @@ export class LocalMemoryService {
|
|
|
1708
1714
|
tool: pending.tool,
|
|
1709
1715
|
action: pending.action,
|
|
1710
1716
|
query: pending.query,
|
|
1717
|
+
...(pending.description !== undefined ? { description: pending.description } : {}),
|
|
1711
1718
|
// 轮询载荷保持轻量:正文截到 1200 字,悬浮需要全文时面板再按 id 取一次。
|
|
1712
1719
|
items: pending.items.map((item) => ({
|
|
1713
1720
|
...item,
|
package/lib/tools/index.js
CHANGED
|
@@ -112,7 +112,8 @@ import { canonicalWorkspacePath, normalizeScopeInput, resolveScopeRef } from '..
|
|
|
112
112
|
|
|
113
113
|
|
|
114
114
|
/** 只有这一层需要的能力子集(provider 在宿主里提供,测试里可以 mock)。 */
|
|
115
|
-
|
|
115
|
+
|
|
116
|
+
|
|
116
117
|
|
|
117
118
|
|
|
118
119
|
|
|
@@ -138,8 +139,9 @@ import { canonicalWorkspacePath, normalizeScopeInput, resolveScopeRef } from '..
|
|
|
138
139
|
|
|
139
140
|
|
|
140
141
|
|
|
142
|
+
|
|
141
143
|
|
|
142
|
-
|
|
144
|
+
|
|
143
145
|
|
|
144
146
|
|
|
145
147
|
|
|
@@ -270,6 +272,38 @@ function outsideReason(policy , scope )
|
|
|
270
272
|
return scopeInPolicy(policy, scope) ? 'kind' : 'scope'
|
|
271
273
|
}
|
|
272
274
|
|
|
275
|
+
/** memory_* 的 description 参数说明(模型可见)。 */
|
|
276
|
+
const DESCRIPTION_PARAM_DESCRIPTION =
|
|
277
|
+
'本次调用要做什么(一句话,给用户看)。本会话「记忆范围」为普通限制时必填:审批范围外记忆时,弹窗会把它展示给用户。'
|
|
278
|
+
|
|
279
|
+
/**
|
|
280
|
+
* 把模型的 description 收拾成一行(审批弹窗里展示)。
|
|
281
|
+
* 省略/空白 = undefined(是否合法由 requireDescription 按限制等级判断)。
|
|
282
|
+
*/
|
|
283
|
+
function descriptionOf(raw ) {
|
|
284
|
+
if (typeof raw !== 'string') return undefined
|
|
285
|
+
const value = raw.replace(/\s+/g, ' ').trim()
|
|
286
|
+
return value === '' ? undefined : value.slice(0, 500)
|
|
287
|
+
}
|
|
288
|
+
|
|
289
|
+
/**
|
|
290
|
+
* 「记忆范围」为普通限制时,memory_* 必须写 description:审批弹窗要把 Agent 的
|
|
291
|
+
* 意图展示给用户,只有工具名 + 查询词不够判断该不该放行。
|
|
292
|
+
*
|
|
293
|
+
* 拿不到会话(老宿主 / 测试 mock / 面板直调)时不强制 —— 没有会话就没有审批弹窗;
|
|
294
|
+
* absolute / none 也不强制(前者范围外一律视为不存在,后者不需要审批)。
|
|
295
|
+
*/
|
|
296
|
+
function requireDescription(service , agent , raw ) {
|
|
297
|
+
if (agent === undefined) return
|
|
298
|
+
const policy = visibilityPolicy(service, agent)
|
|
299
|
+
if (policy === undefined || policy.level !== 'normal') return
|
|
300
|
+
if (descriptionOf(raw) !== undefined) return
|
|
301
|
+
throw new MemoryToolError(
|
|
302
|
+
'DESCRIPTION_REQUIRED',
|
|
303
|
+
'本会话「记忆范围」为普通限制:调用 memory_* 工具时必须提供 description 字段,用一句话说明这次调用要做什么(审批范围外记忆时弹窗会展示给用户)。',
|
|
304
|
+
)
|
|
305
|
+
}
|
|
306
|
+
|
|
273
307
|
function recordsToApprovalItems(
|
|
274
308
|
policy ,
|
|
275
309
|
records ,
|
|
@@ -310,6 +344,7 @@ async function askOutOfScope(
|
|
|
310
344
|
records ,
|
|
311
345
|
action ,
|
|
312
346
|
signal ,
|
|
347
|
+
description ,
|
|
313
348
|
) {
|
|
314
349
|
if (records.length === 0) return { outcome: 'allowed-once' }
|
|
315
350
|
if (typeof service.requestOutOfScope !== 'function') return { outcome: 'unavailable' }
|
|
@@ -319,6 +354,7 @@ async function askOutOfScope(
|
|
|
319
354
|
tool,
|
|
320
355
|
action,
|
|
321
356
|
query,
|
|
357
|
+
...(description !== undefined ? { description } : {}),
|
|
322
358
|
items: recordsToApprovalItems(policy, records),
|
|
323
359
|
...(signal !== undefined ? { signal } : {}),
|
|
324
360
|
})
|
|
@@ -447,6 +483,8 @@ function resolveScope(
|
|
|
447
483
|
|
|
448
484
|
|
|
449
485
|
|
|
486
|
+
|
|
487
|
+
|
|
450
488
|
|
|
451
489
|
|
|
452
490
|
|
|
@@ -485,9 +523,12 @@ export function memorySaveTool(opts )
|
|
|
485
523
|
expiresAt: { type: 'number', description: '过期时间(毫秒时间戳)。kind=state 不传时按设置里的默认 TTL(7 天)' },
|
|
486
524
|
ttlMs: { type: 'number', description: '相对有效期(毫秒)。与 expiresAt 二选一,expiresAt 优先' },
|
|
487
525
|
triggers: { type: 'array', items: { type: 'string' }, description: '流程触发词(kind=procedure):工具名/关键词/路径;缺省用 tags' },
|
|
526
|
+
description: { type: 'string', description: DESCRIPTION_PARAM_DESCRIPTION },
|
|
488
527
|
},
|
|
489
528
|
async execute(args , exec ) {
|
|
490
529
|
const service = svc(opts)
|
|
530
|
+
const agent = agentOf(exec)
|
|
531
|
+
requireDescription(service, agent, args.description)
|
|
491
532
|
if (typeof args.content !== 'string' || args.content.trim().length === 0) {
|
|
492
533
|
throw new MemoryToolError('CONTENT_EMPTY', 'content must be a non-empty string')
|
|
493
534
|
}
|
|
@@ -499,7 +540,6 @@ export function memorySaveTool(opts )
|
|
|
499
540
|
// project)。默认值的最终权威是 provider 的 `save` —— 省略时干脆不带 scope 字段,
|
|
500
541
|
// 但要把会话上下文(exec.agent)带过去,否则它没法知道"当前会话"是谁。
|
|
501
542
|
const requested = args.scope?.trim()
|
|
502
|
-
const agent = agentOf(exec)
|
|
503
543
|
const pathArg = typeof args.path === 'string' ? args.path.trim() : ''
|
|
504
544
|
|
|
505
545
|
let explicit
|
|
@@ -554,6 +594,7 @@ export function memorySaveTool(opts )
|
|
|
554
594
|
[draft],
|
|
555
595
|
'write',
|
|
556
596
|
(exec )?.signal,
|
|
597
|
+
descriptionOf(args.description),
|
|
557
598
|
)
|
|
558
599
|
if (!verdictAllows(verdict, draft.id)) {
|
|
559
600
|
throw visibilityError(verdict.outcome === 'allowed-once' ? 'rejected' : verdict.outcome, 'write', target)
|
|
@@ -633,6 +674,8 @@ function applySummaryDedupe(opts , exec , records
|
|
|
633
674
|
|
|
634
675
|
|
|
635
676
|
|
|
677
|
+
|
|
678
|
+
|
|
636
679
|
|
|
637
680
|
|
|
638
681
|
|
|
@@ -670,14 +713,16 @@ export function memorySearchTool(opts )
|
|
|
670
713
|
topK: { type: 'number', description: '1~20' },
|
|
671
714
|
includeSuperseded: { type: 'boolean', description: '默认 false;true 时把已被 supersede 的旧版本也返回(历史核对)' },
|
|
672
715
|
summaryChars: { type: 'number', description: `每条摘要的字数上限(默认 ${DEFAULT_SUMMARY_CHARS},20~2000)` },
|
|
716
|
+
description: { type: 'string', description: DESCRIPTION_PARAM_DESCRIPTION },
|
|
673
717
|
},
|
|
674
718
|
async execute(args , exec ) {
|
|
675
719
|
const service = svc(opts)
|
|
720
|
+
const agent = agentOf(exec)
|
|
721
|
+
requireDescription(service, agent, args.description)
|
|
676
722
|
if (typeof args.query !== 'string' || args.query.trim().length === 0) {
|
|
677
723
|
throw new MemoryToolError('QUERY_EMPTY', 'query must be a non-empty string')
|
|
678
724
|
}
|
|
679
725
|
const resolved = resolveScope(opts, service, exec, args.scope, 'read')
|
|
680
|
-
const agent = agentOf(exec)
|
|
681
726
|
const policy = visibilityPolicy(service, agent)
|
|
682
727
|
const level = policy?.level ?? 'none'
|
|
683
728
|
// level=none 时策略里的 scopes 只是偏好,不参与限制(等价于没有可见域)。
|
|
@@ -724,6 +769,7 @@ export function memorySearchTool(opts )
|
|
|
724
769
|
outside.map((hit) => hit.record),
|
|
725
770
|
'read',
|
|
726
771
|
(exec )?.signal,
|
|
772
|
+
descriptionOf(args.description),
|
|
727
773
|
)
|
|
728
774
|
}
|
|
729
775
|
// verdict 为空 = 没有发起审批(绝对限制 / 没有范围外命中):范围外一律不放行。
|
|
@@ -768,6 +814,8 @@ export function memorySearchTool(opts )
|
|
|
768
814
|
|
|
769
815
|
|
|
770
816
|
|
|
817
|
+
|
|
818
|
+
|
|
771
819
|
|
|
772
820
|
|
|
773
821
|
|
|
@@ -783,12 +831,14 @@ export function memoryForgetTool(opts )
|
|
|
783
831
|
id: { type: 'string', description: 'Exact record id' },
|
|
784
832
|
query: { type: 'string', description: 'Substring match; by default only the current session scope' },
|
|
785
833
|
scope: { type: 'string', description: "省略=当前会话;显式指定只删那一个作用域。'all' 不能与 query 同用(防批量误删)。" },
|
|
834
|
+
description: { type: 'string', description: DESCRIPTION_PARAM_DESCRIPTION },
|
|
786
835
|
},
|
|
787
836
|
async execute(args , exec ) {
|
|
788
837
|
const service = svc(opts)
|
|
838
|
+
const agent = agentOf(exec)
|
|
839
|
+
requireDescription(service, agent, args.description)
|
|
789
840
|
if (!args.id && !args.query) throw new MemoryToolError('TARGET_REQUIRED', 'provide id or query')
|
|
790
841
|
if (args.id && args.query) throw new MemoryToolError('TARGET_AMBIGUOUS', 'provide id or query, not both')
|
|
791
|
-
const agent = agentOf(exec)
|
|
792
842
|
// 没有会话就不判断可见域:护栏只对"本会话的 Agent"生效(与 provider 一致)。
|
|
793
843
|
const policy = agent === undefined ? undefined : visibilityPolicy(service, agent)
|
|
794
844
|
const level = policy?.level ?? 'none'
|
|
@@ -813,6 +863,7 @@ export function memoryForgetTool(opts )
|
|
|
813
863
|
blocked,
|
|
814
864
|
'delete',
|
|
815
865
|
signal,
|
|
866
|
+
descriptionOf(args.description),
|
|
816
867
|
)
|
|
817
868
|
if (!verdictAllows(verdict, args.id)) {
|
|
818
869
|
throw visibilityError(verdict.outcome === 'allowed-once' ? 'rejected' : verdict.outcome, 'delete', blocked[0] .scope)
|
|
@@ -859,6 +910,7 @@ export function memoryForgetTool(opts )
|
|
|
859
910
|
}],
|
|
860
911
|
'delete',
|
|
861
912
|
signal,
|
|
913
|
+
descriptionOf(args.description),
|
|
862
914
|
)
|
|
863
915
|
if (!verdictAllows(verdict, `query:${scope}`)) {
|
|
864
916
|
throw visibilityError(verdict.outcome === 'allowed-once' ? 'rejected' : verdict.outcome, 'delete', scope)
|
|
@@ -883,6 +935,8 @@ export function memoryForgetTool(opts )
|
|
|
883
935
|
|
|
884
936
|
|
|
885
937
|
|
|
938
|
+
|
|
939
|
+
|
|
886
940
|
|
|
887
941
|
|
|
888
942
|
|
|
@@ -904,11 +958,13 @@ export function memoryListTool(opts )
|
|
|
904
958
|
scope: { type: 'string', description: "省略=当前会话;'all'=所有作用域;其他值只列该作用域。" },
|
|
905
959
|
kind: { type: 'string' },
|
|
906
960
|
limit: { type: 'number', description: '1~200' },
|
|
961
|
+
description: { type: 'string', description: DESCRIPTION_PARAM_DESCRIPTION },
|
|
907
962
|
},
|
|
908
963
|
async execute(args , exec ) {
|
|
909
964
|
const service = svc(opts)
|
|
910
|
-
const resolved = resolveScope(opts, service, exec, args.scope, 'read')
|
|
911
965
|
const agent = agentOf(exec)
|
|
966
|
+
requireDescription(service, agent, args.description)
|
|
967
|
+
const resolved = resolveScope(opts, service, exec, args.scope, 'read')
|
|
912
968
|
const policy = visibilityPolicy(service, agent)
|
|
913
969
|
const level = policy?.level ?? 'none'
|
|
914
970
|
// level=none 时策略里的 scopes 只是偏好,不参与限制(等价于没有可见域)。
|
|
@@ -950,6 +1006,7 @@ export function memoryListTool(opts )
|
|
|
950
1006
|
outside,
|
|
951
1007
|
'read',
|
|
952
1008
|
(exec )?.signal,
|
|
1009
|
+
descriptionOf(args.description),
|
|
953
1010
|
)
|
|
954
1011
|
}
|
|
955
1012
|
const approvedOutside = verdict === undefined
|
|
@@ -1032,6 +1089,8 @@ export const DEFAULT_GET_FIELDS = ['content', 'scope', 'kind', 'tags
|
|
|
1032
1089
|
|
|
1033
1090
|
|
|
1034
1091
|
|
|
1092
|
+
|
|
1093
|
+
|
|
1035
1094
|
|
|
1036
1095
|
|
|
1037
1096
|
|
|
@@ -1114,9 +1173,12 @@ export function memoryGetTool(opts )
|
|
|
1114
1173
|
description: `只取这些字段,省略=${DEFAULT_GET_FIELDS.join('+')};可选:${GET_FIELDS.join(' / ')}(id 始终返回)`,
|
|
1115
1174
|
},
|
|
1116
1175
|
summaryChars: { type: 'number', description: `summary 字段的字数上限(默认 ${DEFAULT_SUMMARY_CHARS},20~2000)` },
|
|
1176
|
+
description: { type: 'string', description: DESCRIPTION_PARAM_DESCRIPTION },
|
|
1117
1177
|
},
|
|
1118
1178
|
async execute(args , exec ) {
|
|
1119
1179
|
const service = svc(opts)
|
|
1180
|
+
const agent = agentOf(exec)
|
|
1181
|
+
requireDescription(service, agent, args.description)
|
|
1120
1182
|
const ids = Array.isArray(args.ids)
|
|
1121
1183
|
? [...new Set(args.ids.map(String).filter((id) => id.trim() !== ''))].slice(0, 50)
|
|
1122
1184
|
: []
|
|
@@ -1129,7 +1191,6 @@ export function memoryGetTool(opts )
|
|
|
1129
1191
|
try {
|
|
1130
1192
|
const all = service.getByIds(ids)
|
|
1131
1193
|
// 可见域是白名单:即使知道 id,也不能直接读别的范围/别的类型的正文。
|
|
1132
|
-
const agent = agentOf(exec)
|
|
1133
1194
|
const policy = visibilityPolicy(service, agent)
|
|
1134
1195
|
const level = policy?.level ?? 'none'
|
|
1135
1196
|
const inside = all.filter((record) => recordAllowed(policy, record.scope, record.kind))
|
|
@@ -1146,6 +1207,7 @@ export function memoryGetTool(opts )
|
|
|
1146
1207
|
outside,
|
|
1147
1208
|
'read',
|
|
1148
1209
|
(exec )?.signal,
|
|
1210
|
+
descriptionOf(args.description),
|
|
1149
1211
|
)
|
|
1150
1212
|
}
|
|
1151
1213
|
// verdict 为空 = 没有发起审批(绝对限制):范围外一律按不存在处理。
|
package/lib/tools/render.js
CHANGED
|
@@ -60,17 +60,21 @@ export function renderSearchResult(value , label )
|
|
|
60
60
|
return `没有找到可见范围内的相关记忆。\n${note}`
|
|
61
61
|
}
|
|
62
62
|
// 已出现过的条目(上下文去重)只回 id:不带作用域/类型/标签/摘要。
|
|
63
|
-
|
|
64
|
-
|
|
63
|
+
// 它们单独成块、与带摘要的条目之间空一行 —— 否则一串裸 id 看起来像上一条的
|
|
64
|
+
// 续行,模型分不清哪些条目「这次有摘要」哪些「只是占位 id」(0.22.0)。
|
|
65
|
+
const shown = []
|
|
66
|
+
const bare = []
|
|
67
|
+
for (const hit of value.records) {
|
|
65
68
|
if (hit.deduped === true) {
|
|
66
|
-
|
|
67
|
-
|
|
69
|
+
bare.push(shortId(hit.id))
|
|
70
|
+
continue
|
|
68
71
|
}
|
|
69
72
|
const tags = joinList(hit.tags)
|
|
70
73
|
const meta = `${label(hit.scope)}/${hit.kind}${tags === '' ? '' : ` · ${tags}`}`
|
|
71
|
-
|
|
72
|
-
}
|
|
73
|
-
const
|
|
74
|
+
shown.push(`[${hit.score.toFixed(3)}] ${shortId(hit.id)} (${meta}) ${hit.summary}`)
|
|
75
|
+
}
|
|
76
|
+
const body = [shown.join('\n'), bare.join('\n')].filter((part) => part !== '').join('\n\n')
|
|
77
|
+
const tail = [bare.length > 0 ? DEDUPE_NOTE : '', note].filter((part) => part !== '').join('\n\n')
|
|
74
78
|
return tail === '' ? body : `${body}\n\n${tail}`
|
|
75
79
|
}
|
|
76
80
|
|