@restregular/dsh-memory 0.25.9 → 0.25.11
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 +16 -0
- package/README.md +7 -5
- package/lib/client.js +5870 -5813
- package/lib/inject/digest.js +8 -2
- package/lib/panel.js +24 -18
- package/lib/provider/scope.js +35 -3
- package/lib/tools/apply.js +21 -23
- package/lib/tools/render.js +4 -1
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -2,6 +2,22 @@
|
|
|
2
2
|
|
|
3
3
|
本项目的版本记录。安装 id 与 npm 版本一一对应。
|
|
4
4
|
|
|
5
|
+
## 0.25.11 — 「记忆权限」浮窗里能直接看到真实键;摘要里的自定义作用域补 `custom:` 前缀
|
|
6
|
+
|
|
7
|
+
- **浮窗露出完整键**:显示名与真实键不一致时(项目别名 → 完整路径、会话短 id → 完整 uuid、自定义名 → 裸键),作用域行的名字下面多一行等宽小字,就是完整键。**不做手工截断**——键保持原样,放不下由 CSS 按容器宽度省略(`text-overflow:ellipsis`),窗口变宽就多显示几个字符。名义上相同(例如没有别名的项目作用域 `project:D:\w` 显示名就是键)则不再重复一行。
|
|
8
|
+
- **`title` 统一成「显示名 → 真实键」**:记录卡作用域徽标、记忆树节点、审批卡的作用域 pill、浮窗行名称的悬停提示都按这个格式(显示名与键相同时只给键)。项目作用域因此一眼能看出「别名是哪,路径是哪」。
|
|
9
|
+
- **摘要里的自定义作用域**:会话第一步注入的摘要 / 标签索引里,作用域是**紧凑分类词**(全局 / 项目 / 会话);自定义作用域以前直接吐裸名字(`· handbook`),和分类词混在一起分不清,现在是 `custom:handbook`。
|
|
10
|
+
- **不改真实键**:键仍是 `global` / `project:<路径>` / `session:<完整 uuid>` / 自定义裸名,存储、配置、授权、绑定与历史记忆都不迁移,无需重建向量。
|
|
11
|
+
- 测试:新增「只有显示名与键不同才渲染键行」「键行靠 CSS 省略、不手工截断」「`scopeTitle` 的显示名 → 键格式」用例与 `.mem-scope-key` 的 CSS 断言;摘要标签用例补 `custom:` 断言;全套 504 tests / 503 pass / 1 skipped。
|
|
12
|
+
|
|
13
|
+
## 0.25.10 — 作用域名字统一带类型前缀(`global:` / `project:` / `session:` / `custom:`)
|
|
14
|
+
|
|
15
|
+
- **背景**:作用域名此前是「裸名字」——项目显示成 cwd、会话显示成短 id、global 显示成「全局」、自定义作用域显示成它自己的名字。列表里几种作用域混在一起时看不出种类;尤其 `global:` 与 `custom:` 完全没有前缀可依,因为这两种 scope 的**键本身就不带前缀**(`global` 是个关键字,自定义就是裸名字)。
|
|
16
|
+
- **口径**:展示名一律 `<类型>:<名字>` —— `global:全局`、`project:D:\repositories\dsh-memory`、`session:session-1a2b3c4d`、`custom:handbook`。前缀由**类型**决定(`memory-local` 的 `scopeTypePrefix` / `scopeDisplayName`),不猜键的形状;别名与标题只替换冒号后面那一段:`project:<别名>`、`custom:<别名>`、`session:<标题>(session-1a2b3c4d)`。
|
|
17
|
+
- **覆盖范围**:`/status` 的 label(面板作用域下拉、记录卡作用域徽标、记忆树)、`/visibility` 与 `/grants` 的作用域标签、「记忆权限」浮窗的每一行(本会话那行现在是 `session:当前会话`)、审计页的会话筛选与锁定会话 pill、审批卡上的作用域 pill(精确键退到 `title`)、以及 `memory_save` / `memory_search` / `memory_list` / `memory_get` / `memory_scopes` 的工具输出(`memory_scopes` 目录里自定义作用域此前渲染成 `自定义「handbook」`,现在是 `custom:handbook`)。
|
|
18
|
+
- **保持不变**:注入摘要里的作用域分类标签仍是「全局 / 项目 / 会话」(那是紧凑分类而不是名字);面向 Agent 的「记忆权限已更新」通知仍用**真实 scope 键**(Agent 要拿它当键用)。
|
|
19
|
+
- 测试:新增 `scopeTypePrefix` / `scopeDisplayName` 的四类型单测(global 与自定义的键没有前缀、别名与标题只换名字段)、客户端 helper 用例;`/status` 的四种 label 断言与浮窗「当前会话」断言改成带前缀;全套 503 tests / 502 pass / 1 skipped。
|
|
20
|
+
|
|
5
21
|
## 0.25.9 — 会话作用域的短 id 改成前 16 位(以前全显示成「会话 session-」)
|
|
6
22
|
|
|
7
23
|
- **问题**:真机会话 id 以 `session-` 开头,那正好是 8 个字符。以前展示会话作用域时取「id 前 8 位」,于是每个会话作用域都渲染成同一个「会话 session-」——用户无法区分是哪个会话,等于没给 id。
|
package/README.md
CHANGED
|
@@ -47,7 +47,7 @@ JSONL 落盘 · 本机向量检索 · 五个模型工具 · 自动召回 · 硬
|
|
|
47
47
|
| **自动召回** | 每轮按用户问题召回;新会话第一步注入项目 / global 摘要;发布、部署、工具失败等行为按标签触发定向召回 |
|
|
48
48
|
| **印象形态** | 每轮只给每条记忆的短摘要;模型判断相关但需要细节时再 `memory_get` 取全文,省 token 也不丢信息 |
|
|
49
49
|
| **硬性规则** | `kind: rule` 进系统提示常驻段;行首带 8 位 id,注入的是摘要,需要全文时用 `memory_get`;旧会话会收到新增 / 编辑提醒;超预算有明确警告,不静默丢弃 |
|
|
50
|
-
| **记忆权限** | 输入框旁的「记忆权限」按钮设置本会话可读的作用域 + 限制等级(绝对 / 普通 / 无限制);每个作用域一行就是一条设置:**勾选**表示本会话可访问,行内**【绑定】/【可读】/【可写】**控制工作区默认可见与读写权限——绑定到当前工作区后新会话默认可见,可读 / 可写独立影响工具读写;Agent 通过 `memory_scopes request` 申请到的范围外授权**也用勾选呈现**(名称右边挂一个「AI」气泡,样式与你自己勾选的行区分开),取消勾选只是草稿,**点「保存」才真正撤销**(0.25.4 起),且按钮数字 / 「已选」都把 AI 授权算进去(0.25.5 起)并**实时轮询**——浮窗关着,Agent 刚拿到的授权也会让按钮数字自己变(0.25.6 起);**整张作用域卡片都能点选**,点名称 / 计数 / 留白等同点勾选框(0.25.7
|
|
50
|
+
| **记忆权限** | 输入框旁的「记忆权限」按钮设置本会话可读的作用域 + 限制等级(绝对 / 普通 / 无限制);每个作用域一行就是一条设置:**勾选**表示本会话可访问,行内**【绑定】/【可读】/【可写】**控制工作区默认可见与读写权限——绑定到当前工作区后新会话默认可见,可读 / 可写独立影响工具读写;Agent 通过 `memory_scopes request` 申请到的范围外授权**也用勾选呈现**(名称右边挂一个「AI」气泡,样式与你自己勾选的行区分开),取消勾选只是草稿,**点「保存」才真正撤销**(0.25.4 起),且按钮数字 / 「已选」都把 AI 授权算进去(0.25.5 起)并**实时轮询**——浮窗关着,Agent 刚拿到的授权也会让按钮数字自己变(0.25.6 起);**整张作用域卡片都能点选**,点名称 / 计数 / 留白等同点勾选框(0.25.7 起),本会话那一行直接叫「**session:当前会话**」(0.25.8 起,0.25.10 起带类型前缀);**所有作用域名都以 `global:` / `project:` / `session:` / `custom:` 开头**(0.25.10 起);浮窗挂在页面根层,不会被输入框上方的浮动按钮盖住(0.25.8 起);Agent 及其子 Agent 都按它检索、注入与 `memory_get` |
|
|
51
51
|
| **修正版编辑** | 面板里编辑一条记忆 = 新建一条修正版并通过 `supersedes` 指向旧记录,旧记录不原地修改;记录页「是否被修正」筛选默认隐藏旧版本,可切到全部 / 只看已修正 |
|
|
52
52
|
| **范围外审批** | 普通限制下,工具命中可见域外的记忆时会在**对应会话的输入框上方**出现审批卡(样式与系统权限审批一致):展示工具、Agent 说明、查询关键词与范围外记忆摘要,支持逐条勾选 / 全选 / 取消全选(「允许选中的 N 条」或整单「允许一次」)或「拒绝」;点记忆 ID 直接跳到面板「记录」页并展开该条 |
|
|
53
53
|
| **上下文去重** | `memory_search` / `memory_list` 返回过的条目记进会话上下文状态;同一版本再次命中只回记忆 ID(`memory_search` 的裸 ID 与带摘要条目之间空一行),并提示用 `memory_get` 取全文(内容更新后重新给摘要) |
|
|
@@ -88,11 +88,13 @@ JSONL 落盘 · 本机向量检索 · 五个模型工具 · 自动召回 · 硬
|
|
|
88
88
|
|
|
89
89
|
### 输入框的记忆权限
|
|
90
90
|
|
|
91
|
-
输入框工具行右侧有「记忆权限」按钮。**打开会话时就会读取这个会话的设置**,按钮上的数字是当前生效的作用域数量,边框样式表示限制等级(绝对限制 = 橙黄实线 / 普通限制 = 蓝色实线 / 无限制 = 灰色虚线;`title` 里写明「已设置 / 使用默认 / 继承父会话 + 数量 +
|
|
91
|
+
输入框工具行右侧有「记忆权限」按钮。**打开会话时就会读取这个会话的设置**,按钮上的数字是当前生效的作用域数量,边框样式表示限制等级(绝对限制 = 橙黄实线 / 普通限制 = 蓝色实线 / 无限制 = 灰色虚线;`title` 里写明「已设置 / 使用默认 / 继承父会话 + 数量 + 等级」)。点开的浮窗使用毛玻璃背景,按当前会话列出可选作用域(`session:当前会话` / `project:<当前项目>` / `global:全局` / `custom:<自定义作用域>`):
|
|
92
92
|
|
|
93
93
|
- **默认范围**:没有显式设置时(新会话)按默认设置生效 —— **当前会话 + 当前项目 + global + 已绑定的作用域** + **普通限制**;面板按同一份默认范围预选,不会出现空面板。
|
|
94
|
-
- **本会话那一行的名字**(0.25.8):本会话 `session:<id>`
|
|
95
|
-
-
|
|
94
|
+
- **本会话那一行的名字**(0.25.8):本会话 `session:<id>` 那一行固定显示「**当前会话**」(0.25.10 起叫 `session:当前会话`,原始 scope 键仍在 `title` 里),别的会话的 scope 仍按标题 / 短 id 显示;搜索也按显示名匹配,输入「当前会话」即可筛到这一行。
|
|
95
|
+
- **作用域名字带类型前缀**(0.25.10):所有展示名都以 `global:` / `project:` / `session:` / `custom:` 开头 —— `global:全局`、`project:D:\repositories\dsh-memory`、`session:session-1a2b3c4d`、`custom:handbook`。**global 与自定义作用域最容易被漏掉**:它们的 scope 键本身没有前缀(`global` 是个关键字、自定义就是裸名字),前缀必须按类型补。项目 / 自定义作用域有别名时是 `project:<别名>` / `custom:<别名>`,会话有标题时是 `session:<标题>(session-1a2b3c4d)`。
|
|
96
|
+
- **会话作用域的短 id**(0.25.9):会话 id 取**前 16 位**(`session-` + 8 位 uuid)。以前取前 8 位,而真机会话 id 恰好以 `session-` 开头(正好 8 个字符),结果所有会话作用域都显示成同一个名字——等于没给 id。
|
|
97
|
+
- **浮窗里能直接看到真实键**(0.25.11):显示名与真实键不一致时(项目别名 → 完整路径、会话短 id → 完整 uuid、自定义名 → 裸键),每行名称下面多一行等宽的完整键;**不做手工截断**,放不下就按容器宽度用 CSS 省略号收尾,窗口宽就多显示几个字符。键行是等宽小字、和勾选框左对齐。记录卡 / 记忆树 / 审批卡的作用域徽标都在 `title` 里给出「显示名 → 真实键」。
|
|
96
98
|
- **搜索与批量**:顶部可搜索作用域,支持「全选 / 取消全选」;列表最大高度受限,作用域多时在浮窗内滚动。**整张作用域卡片都能点**(0.25.7 起)——点名称、记录数或行内留白等同点勾选框,只有行内的按钮(勾选框 / 绑定 / 可读 / 可写)各管各的,点它们不会再多切换一次。
|
|
97
99
|
- **浮窗层级**(0.25.8):浮窗 portal 到 `document.body` 渲染,`z-index:900`,不会再被会话里的「回到底部」圆钮(z-index:8)之类浮动件盖住;同时仍低于宿主自己的对话框 / 提示层(1000 起)。
|
|
98
100
|
- **状态按钮(0.23.0 / 0.23.1)**:作用域列表每行有【绑定】、【可读】|【可写】。**默认范围自带的会话 + 项目 + global 显示为已绑定且不可取消**;**绑定**按钮用于把其它作用域额外并入当前工作区的默认范围(没有显式覆盖的新会话可见);**可读 / 可写**是会话级,独立控制该作用域的读取与写入(关掉可读 → 搜索 / 读取跳过并说明原因;关掉可写 → 保存 / 删除被拒绝并说明原因)。
|
|
@@ -291,7 +293,7 @@ memory_scopes({
|
|
|
291
293
|
| 层 | 触发 | 作用 |
|
|
292
294
|
| --- | --- | --- |
|
|
293
295
|
| `recall` | 每轮 `agent/pre-step` | 按本轮用户问题检索,按 topK / token 预算注入;默认只给每条 120 字摘要 + `memory_get` 指引 |
|
|
294
|
-
| `digest` | 会话第一步 | 注入项目 + global 概览:按重要度 × 新鲜度挑选;`kind=rule`
|
|
296
|
+
| `digest` | 会话第一步 | 注入项目 + global 概览:按重要度 × 新鲜度挑选;`kind=rule` 不进摘要(已常驻系统提示);正文超预算时附可检索的标签索引。每行末尾的作用域是**紧凑分类词**(全局 / 项目 / 会话),自定义作用域给 `custom:<名字>`(0.25.11 起,否则裸名字和分类词混在一起分不清) |
|
|
295
297
|
| `policy` | 系统提示常驻 | 什么时候查记忆、查到怎么复用、查不到时低风险推断 / 高风险先问用户 |
|
|
296
298
|
| `rules` | 系统提示常驻 | `kind: rule` 的硬性规则摘要;每行 `id · 正文`,需要全文时 `memory_get`;限量与预算;`mandatory` / `pinned` 排在最前 |
|
|
297
299
|
| `procedures` | 系统提示常驻 | `kind: procedure` 的目录:当前工作区 + 触发词命中的流程,每行 `id · 触发词 → 标题`;正文按需 `memory_get` |
|