@restregular/dsh-memory 0.28.0 → 0.30.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,26 @@
2
2
 
3
3
  本项目的版本记录。安装 id 与 npm 版本一一对应。
4
4
 
5
+ ## 0.30.0 — 会话作用域绑定会话生命周期(创建自动建 / 归档即冻结 / 恢复即复原)
6
+
7
+ - **问题**:会话作用域此前只在第一次写记忆时才懒创建,且与宿主的会话生命周期完全脱节 —— 会话归档后,它的 `session:<id>` 作用域与记忆仍然"存在",跨作用域检索、面板、`memory_get(id)` 都能碰到;恢复 / 归档也没有任何可见语义。用户想要的是:会话创建时作用域就已存在,归档时连同记忆一起冻结,恢复后原样回来。
8
+ - **创建**:`provider/apply.ts` 订阅宿主 `session/created`(顶层会话;子 Agent 沿用父会话作用域),调用新增的 `ensureSessionScope(sessionId)` —— 只写 `scope-meta`(用途:「会话作用域:仅本会话可见的过程记忆;随会话归档与恢复(系统自动创建)」/ `createdBy: system` / `status: ready`),**不写任何记忆**,幂等、不覆盖用户改过的用途。监听器全程 try/catch:`session/created` 抛错会回滚会话创建,记忆侧失败绝不能影响宿主。启动时 `ctx.inject(['sessions'])` 给已存在的会话补建。
9
+ - **归档 = 冻结(实时判定,不复制状态)**:`LocalMemoryService.setArchivedSessionLookup()` 注入对宿主 `workspaceRegistry.archivedSessionIds` 的**实时**读取(不缓存、不落盘)。`authorize()` 新增 `archivedScopes` 上下文:归档作用域 `discover` 仍允许(目录/面板要能看出「已归档」),`read` / `write` / `delete` 一律 `SCOPE_ARCHIVED`(`requestable=false`,没有审批放行路径)。`search` / `list` / `listSync` / `getByIds` 直接跳过归档作用域 —— 不是过滤结果,而是根本不加载它的 store,所以恢复时无需重建索引。
10
+ - **归档期间不清理**:小时级 housekeeping(过期记录清理 + 容量淘汰)与 dispose 时的清理都跳过归档作用域(新增 `runHousekeeping()` 作为定时器与测试共用的入口);数据文件 `.jsonl` / `.vec` 原样保留。
11
+ - **目录与面板**:`scopeCatalog` 每项新增 `archived?: boolean`,`accessStatus` 新增 `'archived'`;归档作用域的 `records` 仍返回(归档不是权限边界,条数可见),`readable/writable/canRequest*` 恒 false。`memory_scopes` 渲染成「N 条 · 已归档 · 恢复会话后自动恢复读写」;面板「记录 → 作用域」每行显示「已归档」徽标(`/status` 透传 `archived`)。
12
+ - **恢复**:宿主归档集合移除该 id 后,下一次判定就恢复正常 —— `search` / `list` / `getByIds` 立即可用,`memory_get` 按原 id 可取,`authorize` 回到普通策略。没有任何"恢复动作"需要执行。
13
+ - 测试:新增 `source/memory-local/test/session-archive.test.ts`(3 个用例:自动创建与幂等 / 归档冻结与恢复复原 / 冻结期间不清理),覆盖 `search`、`listSync`、`getByIds`、`authorize`、`scopeCatalog`、`save` 拒绝与数据文件保留;全套本地 / 工具 / 注入 / 面板测试通过(`multiprocess.test.ts` 需真起子进程,在受限沙箱里 EPERM,与本改动无关)。
14
+
15
+ ## 0.29.0 — 作用域用途 / 别名可编辑(用户 + Agent)
16
+
17
+ - **问题**:0.28.0 之后「作用域用途」成了检索范围外清单里唯一的信息来源,但它**只能写不能改**——Agent 想补一句用途只能靠 `memory_save` 的 `scopeDescription`(还要顺带写一条记忆),面板则完全没有编辑入口;别名更只在 `memory_save({ path })` 那一瞬间能设,设错了只能改文件。于是第一次随手写的用途会一直错下去。
18
+ - **Agent:`memory_scopes` 新增 `action="edit"`**:`scope` 必填,`scopeDescription` / `scopeName` 至少给一个(省略 = 这次不动它,空串 = 清空用途 / 移除别名)。写权限与写入记忆同一把锁(`write` 开关 / 绝对限制 / 范围外),**范围外不弹隐式审批**——编辑元数据不是一条可勾选的记忆,改为明确提示先用 `action="request", permissions:["write"]` 申请。结果只回「改成了什么」(`{ scope, description?, name? }`),渲染成「用途:… / 别名:…」,空串分别渲染成「已清空(回退到按类型的默认描述)」「已移除」。
19
+ - **用户:面板「记录 → 作用域」每行「编辑」**:用途 textarea + 别名输入框(global / session 不显示别名字段,并说明原因)+ 保存 / 取消;保存走新增的 `POST /memory/api/scope-meta`,成功后重新拉 `/status`(别名会影响展示名与下拉)。用途编辑框**只预填手写的那句**:`/status` 新增 `descriptionSource: 'custom' | 'default'`,按类型补的默认描述不预填(否则一保存就把默认文案固化成手写内容);别名留空保存即移除。
20
+ - **provider**:`describeScope` 的空白描述从「报错」改成「清空」(写空串,**保留 createdAt / generation / createdBy** —— 删元数据会让按 generation 绑定的会话授权失效);`scopeCatalog` 对空描述回退到按类型的默认描述,与「从没写过」展示一致。新增 `renameScope(scope, name)`:非空走 `ScopeNames.claim`(统一校验、重名 `SCOPE_NAME_TAKEN`),空串 / undefined = 移除;`global` / `session` 拒绝(`SCOPE_NAME_UNSUPPORTED`,显示名跟随类型与会话 id);别名仍可当作用域参数用(`scopeKeyForName`)。
21
+ - **接口**:`POST /memory/api/scope-meta { scope, description?, name? }`——只允许改目录里看得见的作用域(未知作用域 404,避免把用途写到一条永远读不到的元数据上),什么都没给 400,旧 provider 501;`/memory/api/status` 每项新增 `descriptionSource` 与 `name`(别名),「删光记录但写过用途」的行也带别名。
22
+ - **讲清楚**:注入的「记忆系统」常驻段新增一条「用途与别名可以改」;`memory_scopes` 的工具说明与三个 editing 参数的说明同步。
23
+ - 测试:新增 provider「清空保留 generation / 目录回退默认描述」「别名设置 / 移除 / 重名 / 非法名 / global、session 拒绝」、工具「edit 更新两项 / 只改一项 / 空串清空 / 两个都没给报错 / 范围外要求先申请写权限」、面板「POST /scope-meta 往返 / 404 / 400 / 501」「作用域页编辑保存与默认描述不预填」等用例;全套 533 tests / 532 pass / 1 skipped(`multiprocess.test.ts` 需真起子进程)。
24
+
5
25
  ## 0.28.0 — 范围外命中只列作用域;面板「记录」页拆成记忆 / 作用域两个子标签页
6
26
 
7
27
  - **问题(真机工具结果)**:0.27.0 的 `outOfScope` 给的是**条目索引**(id / score / 类型 / 标签 / 短摘要),于是 `memory_search` 的结果里会跟出一大段范围外记忆的摘要——它们既不是可见结果的延续,又长得跟普通命中一样,模型很容易把这段摘要当成「已经读到的内容」直接引用。同一段文字还出现两次:清单头写「范围外命中:…(各几条)」,末尾的 `withheld` 说明又写「另有 N 条…索引已列在**下方**」——实际它排在最后,结构和顺序都是乱的。
package/README.md CHANGED
@@ -39,9 +39,9 @@ JSONL 落盘 · 本机向量检索 · 五个模型工具 · 自动召回 · 硬
39
39
 
40
40
  | 能力 | 说明 |
41
41
  | --- | --- |
42
- | **六个工具** | `memory_save` / `memory_search` / `memory_list` / `memory_get` / `memory_forget` / `memory_scopes`。`memory_search` 只回印象(8 位 id / 作用域 / 类型 / 标签 / 短摘要),正文和元数据用 `memory_get` 的 `fields` 按需取;同一会话里已出现过的条目只回 id。范围外命中默认只给**作用域清单**(`outOfScope` 字段:名字 / 条数 / 用途,0.28.0 起不再带条目摘要),确认后带 `requestApproval: true` 重发才弹审批。`description` 字段在普通限制下必填,审批卡会展示它。`memory_scopes` 只读目录:给作用域名字 / 用途 / 当前可读可写状态,不返回任何正文。**作用域参数传裸名**(`handbook`):0.26.0 起工具输出里的展示名 `custom:handbook` 粘进参数会被自动归一,`project:` / `session:` 本来就直接可用 |
42
+ | **六个工具** | `memory_save` / `memory_search` / `memory_list` / `memory_get` / `memory_forget` / `memory_scopes`。`memory_search` 只回印象(8 位 id / 作用域 / 类型 / 标签 / 短摘要),正文和元数据用 `memory_get` 的 `fields` 按需取;同一会话里已出现过的条目只回 id。范围外命中默认只给**作用域清单**(`outOfScope` 字段:名字 / 条数 / 用途,0.28.0 起不再带条目摘要),确认后带 `requestApproval: true` 重发才弹审批。`description` 字段在普通限制下必填,审批卡会展示它。`memory_scopes` 管目录:`action="list"` 给作用域名字 / 用途 / 当前可读可写状态,`action="edit"` 编辑某个作用域的**用途 / 别名**(0.29.0),`action="request"` 申请范围外权限;目录本身不返回任何正文。**作用域参数传裸名**(`handbook`):0.26.0 起工具输出里的展示名 `custom:handbook` 粘进参数会被自动归一,`project:` / `session:` 本来就直接可用 |
43
43
  | **四种作用域** | 会话 / 项目 / `global` / 自定义名。默认写进当前会话,读默认合并会话 + 项目 + global;项目作用域可起别名。自定义作用域**首次由 Agent 创建时必须带 `scopeDescription`**(一句话用途),可选带 `scopeRule` 写一条初始规则;元数据存在 `<storeDir>/scope-meta/`,删光记录也不会丢 |
44
- | **作用域目录与绝对隔离** | `memory_scopes` 列出范围内 / 范围外的名字与用途;normal / none 下还带**初始化记录正文**(每个作用域最多 3 条,方便 Agent 直接读到“这个作用域主要放什么”)。绝对限制下范围外作用域**仍可发现**,但正文(含初始记录)永不可读、不可写、不可申请(没有任何审批放行路径);普通限制下范围外条目可申请,`memory_scopes request` 走审批后写入**本会话**授权(默认只读,写权限必须单独申请),子 Agent 沿父会话继承 |
44
+ | **作用域目录与绝对隔离** | `memory_scopes` 列出范围内 / 范围外的名字与用途(`action="edit"` 可改用途与别名);normal / none 下还带**初始化记录正文**(每个作用域最多 3 条,方便 Agent 直接读到“这个作用域主要放什么”)。绝对限制下范围外作用域**仍可发现**,但正文(含初始记录)永不可读、不可写、不可申请(没有任何审批放行路径);普通限制下范围外条目可申请,`memory_scopes request` 走审批后写入**本会话**授权(默认只读,写权限必须单独申请),子 Agent 沿父会话继承 |
45
45
  | **会话授权(grants)** | Agent 申请、用户批准的例外单独存在 `<storeDir>/grants/<session>.json`,不并入可见域策略;只读 / 可写独立、可撤销、只在本会话(及子 Agent)生效;`absolute` 下授权不生效,作用域被删除重建后按创建代次自动失效 |
46
46
  | **双通道检索** | 词法(IDF + 中文 bigram)**+** 向量(本机 llama-server 的 OpenAI 兼容 `/v1/embeddings`)。向量缺席自动降级,不报错、不阻塞 |
47
47
  | **自动召回** | 每轮按用户问题召回;新会话第一步注入项目 / global 摘要;发布、部署、工具失败等行为按标签触发定向召回 |
@@ -53,7 +53,7 @@ JSONL 落盘 · 本机向量检索 · 五个模型工具 · 自动召回 · 硬
53
53
  | **上下文去重** | `memory_search` / `memory_list` 返回过的条目记进会话上下文状态;同一版本再次命中只回记忆 ID(`memory_search` 的裸 ID 与带摘要条目之间空一行),并提示用 `memory_get` 取全文(内容更新后重新给摘要) |
54
54
  | **状态记忆** | `kind: state` 默认 7 天 TTL;注入带「状态,使用前验证」;过期后默认不进检索 / 摘要 / 召回,但 `memory_get` 与面板仍可取 |
55
55
  | **流程索引** | `kind: procedure` 的目录进系统提示:按当前工作区 + 触发词(工具名 / 关键词)列 `id · 触发词 → 标题`,需要时再用 `memory_get` 取全文 |
56
- | **可视化管理** | 记录页分「**记忆** / **作用域**」两个子标签页:记忆侧浏览 / 搜索 / 新建 / 编辑 / 删除(编辑生成修正版),并**可主动做语义检索**(与 `memory_search` 同一套排序)、有「是否被修正」筛选;作用域侧列出每个域的名称、**用途**、记忆条数与最近更新(与 `memory_scopes` 目录同源),可一键跳到该域的记忆列表;记忆树展示作用域、类型与修正链;设置改完即存;导入导出 |
56
+ | **可视化管理** | 记录页分「**记忆** / **作用域**」两个子标签页:记忆侧浏览 / 搜索 / 新建 / 编辑 / 删除(编辑生成修正版),并**可主动做语义检索**(与 `memory_search` 同一套排序)、有「是否被修正」筛选;作用域侧列出每个域的名称、**用途**、记忆条数与最近更新(与 `memory_scopes` 目录同源),**可直接编辑用途与别名**(0.29.0,别名可选、留空即移除),可一键跳到该域的记忆列表;记忆树展示作用域、类型与修正链;设置改完即存;导入导出 |
57
57
  | **一键向量后端** | 面板里下载 llama.cpp 运行时与内置模型,按 CPU / 内存 / 显卡推荐;换模型自动重建向量 |
58
58
  | **跨进程安全** | 每个作用域一把写锁,锁内重新读盘再合并;多个 DSH 实例或 MCP server 共用一个 store 不丢数据 |
59
59
 
@@ -95,6 +95,7 @@ JSONL 落盘 · 本机向量检索 · 五个模型工具 · 自动召回 · 硬
95
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
96
  - **参数仍传裸名**(0.26.0):展示名只用于显示。Agent 把 `custom:handbook` 直接粘进作用域参数时会被**自动归一**成 `handbook`(不再是另一条永远匹配不到记录的授权);`custom:` 后面仍必须是合法自定义名,`custom:` / `custom:foo:bar` / `custom:global` 都会被 `SCOPE_INVALID` 拒绝。旧 grants 文件里遗留的 `custom:` 键在读取时也会折回裸键。
97
97
  - **会话作用域的短 id**(0.25.9):会话 id 取**前 16 位**(`session-` + 8 位 uuid)。以前取前 8 位,而真机会话 id 恰好以 `session-` 开头(正好 8 个字符),结果所有会话作用域都显示成同一个名字——等于没给 id。
98
+ - **会话作用域跟随会话生命周期**(0.30.0):会话**创建**时系统自动建立它的作用域(只写用途元数据,不写记忆);会话在宿主里**归档**后,该作用域与其中的记忆**冻结、不再被任何检索命中**(`memory_search` / `memory_list` / `memory_get` / 注入都不会返回,目录与面板会把这一行标成「已归档」,授权判定返回 `SCOPE_ARCHIVED` 且不可申请);会话**恢复**(取消归档)后作用域与记忆**原样恢复**——归档状态实时读宿主的 `workspaceRegistry.archivedSessionIds`,记忆数据一个字节都不动,归档期间过期清理与容量淘汰也会跳过它。子 Agent 沿用父会话的作用域,不单独创建。
98
99
  - **浮窗里能直接看到真实键**(0.25.11):显示名与真实键不一致时(项目别名 → 完整路径、会话短 id → 完整 uuid、自定义名 → 裸键),每行名称下面多一行等宽的完整键;**不做手工截断**,放不下就按容器宽度用 CSS 省略号收尾,窗口宽就多显示几个字符。键行是等宽小字、和勾选框左对齐。记录卡 / 记忆树 / 审批卡的作用域徽标都在 `title` 里给出「显示名 → 真实键」。
99
100
  - **搜索与批量**:顶部可搜索作用域,支持「全选 / 取消全选」;列表最大高度受限,作用域多时在浮窗内滚动。**整张作用域卡片都能点**(0.25.7 起)——点名称、记录数或行内留白等同点勾选框,只有行内的按钮(勾选框 / 绑定 / 可读 / 可写)各管各的,点它们不会再多切换一次。
100
101
  - **浮窗层级**(0.25.8):浮窗 portal 到 `document.body` 渲染,`z-index:900`,不会再被会话里的「回到底部」圆钮(z-index:8)之类浮动件盖住;同时仍低于宿主自己的对话框 / 提示层(1000 起)。
@@ -257,6 +258,13 @@ memory_forget({ "id": "3f2a9c1d", "description": "删除过期的临时结论" }
257
258
  同一路径重复用同一个名字是幂等的;换名字会覆盖原别名;另一个路径抢同一个名字会被拒绝
258
259
  (`SCOPE_NAME_TAKEN`)。
259
260
 
261
+ **编辑用途与别名(0.29.0)**:Agent 用 `memory_scopes({ action: "edit", scope, scopeDescription?, scopeName? })`
262
+ —— `scopeDescription` 是那句用途(空串 = 清空,回退到按类型的默认描述),`scopeName` 是别名(空串 = 移除;
263
+ 省略 = 不改);两者至少给一个,且需要该作用域**可写**(范围外先 `action: "request"` 申请写权限)。用户在
264
+ 面板「记录 → 作用域」每行的「编辑」里改同样两项:用途编辑框只预填**自己写的**那句(按类型补的默认描述
265
+ 不预填,免得一保存就固化),别名留空保存即移除。`global` / `session` 不支持别名(显示名跟随类型与会话 id);
266
+ 别名与用途都存在 `<storeDir>/scope-meta/` 与 `scopes.json` 里,删光记录也不会丢。
267
+
260
268
  **新建自定义作用域(0.24.0)**:Agent 必须说明用途,可选写一条初始规则;两者在同一次
261
269
  `memory_save` 里原子写入(元数据先落 `pending`,记录与规则写完后转 `ready`,中途失败下次保存会续上):
262
270
 
@@ -614,6 +622,8 @@ npm run verify # 构建到 .verify/,不落 packages/
614
622
 
615
623
  ## 更新日志
616
624
 
625
+ - **0.30.0** —— 会话作用域绑定会话生命周期:会话创建时系统自动建立会话作用域(`ensureSessionScope`,只写 `scope-meta`,`createdBy: system`,幂等且不写记忆);会话归档后该作用域与记忆**冻结**——`search` / `list` / `listSync` / `getByIds` 全部跳过,授权统一返回 `SCOPE_ARCHIVED`(不可申请、无审批路径),目录与面板标「已归档」,归档期间小时级过期清理与容量淘汰也跳过它;取消归档后自动复原(实时读宿主 `workspaceRegistry.archivedSessionIds`,不复制、不缓存,数据文件一个字节不动)。`memory_scopes` 目录项新增 `archived` 与 `accessStatus='archived'`;面板作用域行显示「已归档」徽标;`session/created` 监听失败绝不回滚会话创建,启动时给已存在的会话补建。
626
+ - **0.29.0** —— 作用域用途 / 别名可编辑:`memory_scopes` 新增 `action="edit"`(`scope` + `scopeDescription?` / `scopeName?`,空串分别表示清空用途 / 移除别名,至少给一个,需要该作用域可写,范围外先走 `request` 申请写权限);面板「记录 → 作用域」每行新增「编辑」,用途编辑框只预填手写的那句,默认描述不预填;`describeScope` 的空描述从报错改为**清空**(保留元数据与 generation,目录回退按类型默认描述),新增 `renameScope`(项目 / 自定义作用域可设别名,global / session 拒绝,重名 `SCOPE_NAME_TAKEN`);`/memory/api/status` 新增 `descriptionSource`(custom / default)与别名 `name`,新增 `POST /memory/api/scope-meta`。
617
627
  - **0.28.0** —— 范围外命中只列作用域:`memory_search` 的 `outOfScope` 去掉条目索引(id / score / 标签 / 短摘要),改为只给命中的作用域、各几条、`description`(作用域用途,`scope-meta` 手写优先、没写过按类型补默认描述)与 `requestable`(该域能否走审批);渲染成「名称(条数 · 可申请性):用途」的独立清单,不再重复 `withheld` 说明。面板「记录」页新增「记忆 / 作用域」两个子标签页,作用域页展示名称、用途、条数、待嵌入与最近更新,可一键跳到该域的记忆列表;`/memory/api/status` 每项新增 `description`(无记录但写过用途的作用域也列出)。
618
628
  - **0.27.0** —— 范围外命中「先索引后审批」:普通限制下 `memory_search` 不再自动弹审批,结果新增 `outOfScope` 索引(作用域聚合 + 条目印象,不含正文),`requestApproval: true` 显式发起审批;`withheld` 新增 `out-of-scope` 原因;`memory_scopes` 目录给没写用途的作用域按类型补默认描述。
619
629
  - **0.22.3** —— 审批卡高度与宿主审批卡同口径(去掉额外的 `46vh` 上限),矮窗口下详情行固定后条目列表仍有滚动空间。
package/lib/client.js CHANGED
@@ -197,6 +197,13 @@ window.__ModuleLoader__.load({
197
197
  '.memp .scope-row-desc{font-size:11.5px;line-height:1.55;color:var(--dsw-alias-label-secondary)}',
198
198
  '.memp .scope-row-foot{display:flex;align-items:center;gap:8px;flex-wrap:wrap;font-size:10.5px;color:var(--dsw-alias-label-secondary)}',
199
199
  '.memp .scope-row-key{font-family:ui-monospace,SFMono-Regular,Consolas,monospace;font-size:10.5px;max-width:100%;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}',
200
+ // 作用域编辑(0.29.0):用途 textarea + 可选别名输入,动作行只有保存 / 取消
201
+ '.memp .scope-edit{display:flex;flex-direction:column;gap:5px;padding:2px 0 4px}',
202
+ '.memp .scope-edit label{font-size:10.5px;color:var(--dsw-alias-label-secondary)}',
203
+ '.memp .scope-edit textarea{width:100%;min-height:46px;resize:vertical;font-size:12px;line-height:1.5}',
204
+ '.memp .scope-edit input[type=text]{width:100%;font-size:12px}',
205
+ '.memp .scope-edit-actions{display:flex;gap:6px;padding-top:2px}',
206
+ '.memp .scope-edit-actions button{padding:3px 12px;font-size:11.5px}',
200
207
  // 记录视图:各区块之间留出呼吸感(之前全贴在一起)
201
208
  '.memp .memp-body > * + *{margin-top:14px}',
202
209
  '.memp .stats{margin-bottom:0}',
@@ -3552,6 +3559,14 @@ window.__ModuleLoader__.load({
3552
3559
  // 两个视图共用 /status 的那次拉取,切换不重新请求。
3553
3560
  const [dataView, setDataView] = React.useState('memories')
3554
3561
  const [scopeQuery, setScopeQuery] = React.useState('')
3562
+ // 作用域编辑(0.29.0):同一时间只编辑一行 —— 描述 / 别名都是全局共享的元数据,
3563
+ // 同时开多个编辑框只会让人不确定保存的是哪一条。
3564
+ const [editingScope, setEditingScope] = React.useState('')
3565
+ const [scopeDraftDescription, setScopeDraftDescription] = React.useState('')
3566
+ const [scopeDraftName, setScopeDraftName] = React.useState('')
3567
+ const [scopeBusy, setScopeBusy] = React.useState(false)
3568
+ const [scopeError, setScopeError] = React.useState('')
3569
+ const [scopeSaved, setScopeSaved] = React.useState('')
3555
3570
  const [pendingTick, setPendingTick] = React.useState(0)
3556
3571
  const [creating, setCreating] = React.useState(false)
3557
3572
 
@@ -3632,6 +3647,42 @@ window.__ModuleLoader__.load({
3632
3647
  setSearchInfo(null)
3633
3648
  load('', scope, false)
3634
3649
  }
3650
+ /**
3651
+ * 编辑作用域的描述 / 别名(0.29.0)。
3652
+ *
3653
+ * 用途只预填**自己写的**那句:`descriptionSource==='default'` 是按类型补的默认
3654
+ * 描述,预填进去再保存等于把默认文案固化成手写内容。
3655
+ * 别名字段对 global / session 不显示 —— provider 也不接受(显示名跟随类型/会话 id)。
3656
+ */
3657
+ const beginScopeEdit = (row) => {
3658
+ setEditingScope(row.scope)
3659
+ setScopeDraftDescription(row.descriptionSource === 'custom' ? row.description : '')
3660
+ setScopeDraftName(row.name === undefined ? '' : row.name)
3661
+ setScopeError('')
3662
+ setScopeSaved('')
3663
+ }
3664
+ const cancelScopeEdit = () => {
3665
+ setEditingScope('')
3666
+ setScopeError('')
3667
+ }
3668
+ const saveScopeEdit = async (row) => {
3669
+ setScopeBusy(true); setScopeError(''); setScopeSaved('')
3670
+ try {
3671
+ await api('scope-meta', {
3672
+ scope: row.scope,
3673
+ description: scopeDraftDescription.trim(),
3674
+ ...(row.canAlias ? { name: scopeDraftName.trim() } : {}),
3675
+ })
3676
+ setEditingScope('')
3677
+ setScopeSaved(row.scope)
3678
+ // 重新拉 /status:用途、别名与展示名都由服务端算(别名影响 label 与下拉)。
3679
+ await load()
3680
+ } catch (e) {
3681
+ setScopeError(String(e.message || e))
3682
+ } finally {
3683
+ setScopeBusy(false)
3684
+ }
3685
+ }
3635
3686
  // 审批浮层 / 其它入口点击记忆 ID:挂载时消费一次 pending,之后靠同一事件。
3636
3687
  React.useEffect(() => {
3637
3688
  const applyFocus = () => {
@@ -4039,14 +4090,21 @@ window.__ModuleLoader__.load({
4039
4090
  scope: s.scope,
4040
4091
  label: scopeLabel(s.scope, labels),
4041
4092
  description: typeof s.description === 'string' ? s.description.trim() : '',
4093
+ descriptionSource: s.descriptionSource === 'custom' ? 'custom' : (s.descriptionSource === 'default' ? 'default' : 'none'),
4094
+ name: typeof s.name === 'string' && s.name !== '' ? s.name : undefined,
4095
+ // global / session 的显示名跟随类型与会话 id,provider 也不接受别名。
4096
+ canAlias: !(String(s.scope) === 'global' || String(s.scope).startsWith('session:')),
4042
4097
  records: Number(s.records) || 0,
4043
4098
  pendingEmbeds: Number(s.pendingEmbeds) || 0,
4044
4099
  updatedAt: Number(s.updatedAt) || 0,
4100
+ // 0.30.0:会话归档后作用域保留但读写冻结;恢复会话自动复原。
4101
+ archived: s.archived === true,
4045
4102
  }))
4046
4103
  .filter((row) => needle === ''
4047
4104
  || row.label.toLowerCase().includes(needle)
4048
4105
  || row.scope.toLowerCase().includes(needle)
4049
- || row.description.toLowerCase().includes(needle))
4106
+ || row.description.toLowerCase().includes(needle)
4107
+ || (row.name !== undefined && row.name.toLowerCase().includes(needle)))
4050
4108
  .sort((a, b) => b.records - a.records || b.updatedAt - a.updatedAt || a.label.localeCompare(b.label))
4051
4109
  })()
4052
4110
  const viewSwitch = h('div', { className: 'row' },
@@ -4074,31 +4132,77 @@ window.__ModuleLoader__.load({
4074
4132
  const scopeListBody = !loading && !error && scopeRows.length === 0
4075
4133
  ? h('div', { className: 'empty' }, scopeQuery.trim() !== '' ? '没有匹配的作用域' : '还没有作用域')
4076
4134
  : h('div', { className: 'list' },
4077
- scopeRows.map((row) => h('div', { className: 'scope-row', key: row.scope },
4078
- h('div', { className: 'scope-row-head' },
4079
- h('span', { className: 'scope-row-name', title: scopeTitle(row.scope, row.label) }, row.label),
4080
- h('span', { className: 'badge' }, `${row.records} 条记忆`),
4081
- row.pendingEmbeds > 0
4082
- ? h('span', { className: 'pending', title: '待嵌入向量:向量服务就绪后会自动补上' }, `待嵌入 ${row.pendingEmbeds}`)
4083
- : null,
4084
- h('span', {
4085
- className: 'time',
4086
- title: row.updatedAt > 0 ? `最近更新 ${fmtTime(row.updatedAt)}` : '还没有记录',
4087
- }, row.updatedAt > 0 ? fmtTime(row.updatedAt) : '—'),
4088
- ),
4089
- h('div', { className: 'scope-row-desc' }, row.description === '' ? '(未填写用途)' : row.description),
4090
- h('div', { className: 'scope-row-foot' },
4091
- h('span', { className: 'scope-row-key', title: '作用域键:工具参数直接用它(自定义作用域传裸名)' }, row.scope),
4092
- h('span', { style: { flex: 1 } }),
4093
- row.records > 0
4094
- ? h('button', {
4095
- className: 'linkbtn',
4096
- title: '切到「记忆」并只看这个作用域',
4097
- onClick: () => openScopeRecords(row.scope),
4098
- }, '查看记忆')
4099
- : null,
4100
- ),
4101
- )),
4135
+ scopeRows.map((row) => {
4136
+ const editing = editingScope === row.scope
4137
+ return h('div', { className: 'scope-row', key: row.scope },
4138
+ h('div', { className: 'scope-row-head' },
4139
+ h('span', { className: 'scope-row-name', title: scopeTitle(row.scope, row.label) }, row.label),
4140
+ h('span', { className: 'badge' }, `${row.records} 条记忆`),
4141
+ row.archived
4142
+ ? h('span', {
4143
+ className: 'badge',
4144
+ title: '所属会话已归档:作用域与记忆被冻结,取消归档后自动恢复读写',
4145
+ }, '已归档')
4146
+ : null,
4147
+ row.pendingEmbeds > 0
4148
+ ? h('span', { className: 'pending', title: '待嵌入向量:向量服务就绪后会自动补上' }, `待嵌入 ${row.pendingEmbeds}`)
4149
+ : null,
4150
+ scopeSaved === row.scope ? h('span', { className: 'meta-done' }, '已保存') : null,
4151
+ h('span', {
4152
+ className: 'time',
4153
+ title: row.updatedAt > 0 ? `最近更新 ${fmtTime(row.updatedAt)}` : '还没有记录',
4154
+ }, row.updatedAt > 0 ? fmtTime(row.updatedAt) : '—'),
4155
+ ),
4156
+ editing
4157
+ ? h('div', { className: 'scope-edit' },
4158
+ h('label', null, '用途'),
4159
+ h('textarea', {
4160
+ rows: 2,
4161
+ value: scopeDraftDescription,
4162
+ placeholder: '一句话说明这个作用域放什么;留空保存 = 清空,回退到按类型的默认描述',
4163
+ onChange: (e) => setScopeDraftDescription(e.target.value),
4164
+ }),
4165
+ row.canAlias
4166
+ ? h('label', null, '别名(可选)')
4167
+ : h('div', { className: 'hint' }, 'global / session 作用域不支持别名:显示名跟随类型与会话 id。'),
4168
+ row.canAlias
4169
+ ? h('input', {
4170
+ type: 'text',
4171
+ value: scopeDraftName,
4172
+ placeholder: '只影响显示与引用;留空保存 = 移除别名。不改作用域键本身。',
4173
+ onChange: (e) => setScopeDraftName(e.target.value),
4174
+ })
4175
+ : null,
4176
+ scopeError !== '' ? h('div', { className: 'err' }, scopeError) : null,
4177
+ h('div', { className: 'scope-edit-actions' },
4178
+ h('button', { disabled: scopeBusy, onClick: () => saveScopeEdit(row) }, scopeBusy ? '保存中…' : '保存'),
4179
+ h('button', { disabled: scopeBusy, onClick: cancelScopeEdit }, '取消'),
4180
+ ),
4181
+ )
4182
+ : h('div', { className: 'scope-row-desc' },
4183
+ row.description === '' ? '(未填写用途)' : row.description,
4184
+ row.descriptionSource === 'default' ? h('span', { className: 'muted' }, ' · 默认描述') : null,
4185
+ ),
4186
+ editing
4187
+ ? null
4188
+ : h('div', { className: 'scope-row-foot' },
4189
+ h('span', { className: 'scope-row-key', title: '作用域键:工具参数直接用它(自定义作用域传裸名)' }, row.scope),
4190
+ h('span', { style: { flex: 1 } }),
4191
+ row.records > 0
4192
+ ? h('button', {
4193
+ className: 'linkbtn',
4194
+ title: '切到「记忆」并只看这个作用域',
4195
+ onClick: () => openScopeRecords(row.scope),
4196
+ }, '查看记忆')
4197
+ : null,
4198
+ h('button', {
4199
+ className: 'linkbtn',
4200
+ title: '编辑这个作用域的用途与别名(别名可选)',
4201
+ onClick: () => beginScopeEdit(row),
4202
+ }, '编辑'),
4203
+ ),
4204
+ )
4205
+ }),
4102
4206
  )
4103
4207
  // 旧 provider 没有 scope-meta 用途:说明一句,而不是让人以为作用域都没有用途。
4104
4208
  const scopeDescriptionMissing = scopes.length > 0
@@ -18,6 +18,8 @@ memory_search 只返回印象(ID、作用域、类型、标签和少量摘要
18
18
 
19
19
  新建自定义作用域时,memory_save 必须带 scopeDescription(一句话用途);可选带 scopeRule 写一条初始规则。已有作用域带上 scopeDescription 表示更新用途,不会写初始记忆。
20
20
 
21
+ 作用域的**用途**和**别名**可以改(用户也能在面板「记录 → 作用域」里改):memory_scopes({ action: "edit", scope, scopeDescription?, scopeName? }) —— scopeDescription 是那句用途(空串 = 清空,回退到按类型的默认描述),scopeName 是别名(空串 = 移除;只影响显示与引用,不改作用域键;项目 / 自定义作用域支持,global / session 不支持)。两者至少给一个,且需要该作用域可写(范围外先用 action="request" 申请写权限)。把用途写清楚,后续检索的「范围外清单」会直接告诉接手的人这个域是干什么的。
22
+
21
23
  同一会话里已经出现过的记忆,memory_search / memory_list 只回 ID 并注明“摘要因上下文去重被省略”;那不是没找到,需要正文时直接用 memory_get 取。
22
24
 
23
25
  本会话「记忆范围」为普通限制时(默认),调用任一 memory_* 工具都必须带 description 字段:用一句话说明这次调用要做什么(例如「查发布流程的坑」)。它只用于范围外访问的审批弹窗,不写进记忆;漏了会被工具直接拒绝。绝对限制 / 无限制下可省略。