@restregular/dsh-memory 0.28.0 → 0.29.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,16 @@
2
2
 
3
3
  本项目的版本记录。安装 id 与 npm 版本一一对应。
4
4
 
5
+ ## 0.29.0 — 作用域用途 / 别名可编辑(用户 + Agent)
6
+
7
+ - **问题**:0.28.0 之后「作用域用途」成了检索范围外清单里唯一的信息来源,但它**只能写不能改**——Agent 想补一句用途只能靠 `memory_save` 的 `scopeDescription`(还要顺带写一条记忆),面板则完全没有编辑入口;别名更只在 `memory_save({ path })` 那一瞬间能设,设错了只能改文件。于是第一次随手写的用途会一直错下去。
8
+ - **Agent:`memory_scopes` 新增 `action="edit"`**:`scope` 必填,`scopeDescription` / `scopeName` 至少给一个(省略 = 这次不动它,空串 = 清空用途 / 移除别名)。写权限与写入记忆同一把锁(`write` 开关 / 绝对限制 / 范围外),**范围外不弹隐式审批**——编辑元数据不是一条可勾选的记忆,改为明确提示先用 `action="request", permissions:["write"]` 申请。结果只回「改成了什么」(`{ scope, description?, name? }`),渲染成「用途:… / 别名:…」,空串分别渲染成「已清空(回退到按类型的默认描述)」「已移除」。
9
+ - **用户:面板「记录 → 作用域」每行「编辑」**:用途 textarea + 别名输入框(global / session 不显示别名字段,并说明原因)+ 保存 / 取消;保存走新增的 `POST /memory/api/scope-meta`,成功后重新拉 `/status`(别名会影响展示名与下拉)。用途编辑框**只预填手写的那句**:`/status` 新增 `descriptionSource: 'custom' | 'default'`,按类型补的默认描述不预填(否则一保存就把默认文案固化成手写内容);别名留空保存即移除。
10
+ - **provider**:`describeScope` 的空白描述从「报错」改成「清空」(写空串,**保留 createdAt / generation / createdBy** —— 删元数据会让按 generation 绑定的会话授权失效);`scopeCatalog` 对空描述回退到按类型的默认描述,与「从没写过」展示一致。新增 `renameScope(scope, name)`:非空走 `ScopeNames.claim`(统一校验、重名 `SCOPE_NAME_TAKEN`),空串 / undefined = 移除;`global` / `session` 拒绝(`SCOPE_NAME_UNSUPPORTED`,显示名跟随类型与会话 id);别名仍可当作用域参数用(`scopeKeyForName`)。
11
+ - **接口**:`POST /memory/api/scope-meta { scope, description?, name? }`——只允许改目录里看得见的作用域(未知作用域 404,避免把用途写到一条永远读不到的元数据上),什么都没给 400,旧 provider 501;`/memory/api/status` 每项新增 `descriptionSource` 与 `name`(别名),「删光记录但写过用途」的行也带别名。
12
+ - **讲清楚**:注入的「记忆系统」常驻段新增一条「用途与别名可以改」;`memory_scopes` 的工具说明与三个 editing 参数的说明同步。
13
+ - 测试:新增 provider「清空保留 generation / 目录回退默认描述」「别名设置 / 移除 / 重名 / 非法名 / global、session 拒绝」、工具「edit 更新两项 / 只改一项 / 空串清空 / 两个都没给报错 / 范围外要求先申请写权限」、面板「POST /scope-meta 往返 / 404 / 400 / 501」「作用域页编辑保存与默认描述不预填」等用例;全套 533 tests / 532 pass / 1 skipped(`multiprocess.test.ts` 需真起子进程)。
14
+
5
15
  ## 0.28.0 — 范围外命中只列作用域;面板「记录」页拆成记忆 / 作用域两个子标签页
6
16
 
7
17
  - **问题(真机工具结果)**: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
 
@@ -257,6 +257,13 @@ memory_forget({ "id": "3f2a9c1d", "description": "删除过期的临时结论" }
257
257
  同一路径重复用同一个名字是幂等的;换名字会覆盖原别名;另一个路径抢同一个名字会被拒绝
258
258
  (`SCOPE_NAME_TAKEN`)。
259
259
 
260
+ **编辑用途与别名(0.29.0)**:Agent 用 `memory_scopes({ action: "edit", scope, scopeDescription?, scopeName? })`
261
+ —— `scopeDescription` 是那句用途(空串 = 清空,回退到按类型的默认描述),`scopeName` 是别名(空串 = 移除;
262
+ 省略 = 不改);两者至少给一个,且需要该作用域**可写**(范围外先 `action: "request"` 申请写权限)。用户在
263
+ 面板「记录 → 作用域」每行的「编辑」里改同样两项:用途编辑框只预填**自己写的**那句(按类型补的默认描述
264
+ 不预填,免得一保存就固化),别名留空保存即移除。`global` / `session` 不支持别名(显示名跟随类型与会话 id);
265
+ 别名与用途都存在 `<storeDir>/scope-meta/` 与 `scopes.json` 里,删光记录也不会丢。
266
+
260
267
  **新建自定义作用域(0.24.0)**:Agent 必须说明用途,可选写一条初始规则;两者在同一次
261
268
  `memory_save` 里原子写入(元数据先落 `pending`,记录与规则写完后转 `ready`,中途失败下次保存会续上):
262
269
 
@@ -614,6 +621,7 @@ npm run verify # 构建到 .verify/,不落 packages/
614
621
 
615
622
  ## 更新日志
616
623
 
624
+ - **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
625
  - **0.28.0** —— 范围外命中只列作用域:`memory_search` 的 `outOfScope` 去掉条目索引(id / score / 标签 / 短摘要),改为只给命中的作用域、各几条、`description`(作用域用途,`scope-meta` 手写优先、没写过按类型补默认描述)与 `requestable`(该域能否走审批);渲染成「名称(条数 · 可申请性):用途」的独立清单,不再重复 `withheld` 说明。面板「记录」页新增「记忆 / 作用域」两个子标签页,作用域页展示名称、用途、条数、待嵌入与最近更新,可一键跳到该域的记忆列表;`/memory/api/status` 每项新增 `description`(无记录但写过用途的作用域也列出)。
618
626
  - **0.27.0** —— 范围外命中「先索引后审批」:普通限制下 `memory_search` 不再自动弹审批,结果新增 `outOfScope` 索引(作用域聚合 + 条目印象,不含正文),`requestApproval: true` 显式发起审批;`withheld` 新增 `out-of-scope` 原因;`memory_scopes` 目录给没写用途的作用域按类型补默认描述。
619
627
  - **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,6 +4090,10 @@ 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,
@@ -4046,7 +4101,8 @@ window.__ModuleLoader__.load({
4046
4101
  .filter((row) => needle === ''
4047
4102
  || row.label.toLowerCase().includes(needle)
4048
4103
  || row.scope.toLowerCase().includes(needle)
4049
- || row.description.toLowerCase().includes(needle))
4104
+ || row.description.toLowerCase().includes(needle)
4105
+ || (row.name !== undefined && row.name.toLowerCase().includes(needle)))
4050
4106
  .sort((a, b) => b.records - a.records || b.updatedAt - a.updatedAt || a.label.localeCompare(b.label))
4051
4107
  })()
4052
4108
  const viewSwitch = h('div', { className: 'row' },
@@ -4074,31 +4130,71 @@ window.__ModuleLoader__.load({
4074
4130
  const scopeListBody = !loading && !error && scopeRows.length === 0
4075
4131
  ? h('div', { className: 'empty' }, scopeQuery.trim() !== '' ? '没有匹配的作用域' : '还没有作用域')
4076
4132
  : 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
- )),
4133
+ scopeRows.map((row) => {
4134
+ const editing = editingScope === row.scope
4135
+ return h('div', { className: 'scope-row', key: row.scope },
4136
+ h('div', { className: 'scope-row-head' },
4137
+ h('span', { className: 'scope-row-name', title: scopeTitle(row.scope, row.label) }, row.label),
4138
+ h('span', { className: 'badge' }, `${row.records} 条记忆`),
4139
+ row.pendingEmbeds > 0
4140
+ ? h('span', { className: 'pending', title: '待嵌入向量:向量服务就绪后会自动补上' }, `待嵌入 ${row.pendingEmbeds}`)
4141
+ : null,
4142
+ scopeSaved === row.scope ? h('span', { className: 'meta-done' }, '已保存') : null,
4143
+ h('span', {
4144
+ className: 'time',
4145
+ title: row.updatedAt > 0 ? `最近更新 ${fmtTime(row.updatedAt)}` : '还没有记录',
4146
+ }, row.updatedAt > 0 ? fmtTime(row.updatedAt) : '—'),
4147
+ ),
4148
+ editing
4149
+ ? h('div', { className: 'scope-edit' },
4150
+ h('label', null, '用途'),
4151
+ h('textarea', {
4152
+ rows: 2,
4153
+ value: scopeDraftDescription,
4154
+ placeholder: '一句话说明这个作用域放什么;留空保存 = 清空,回退到按类型的默认描述',
4155
+ onChange: (e) => setScopeDraftDescription(e.target.value),
4156
+ }),
4157
+ row.canAlias
4158
+ ? h('label', null, '别名(可选)')
4159
+ : h('div', { className: 'hint' }, 'global / session 作用域不支持别名:显示名跟随类型与会话 id。'),
4160
+ row.canAlias
4161
+ ? h('input', {
4162
+ type: 'text',
4163
+ value: scopeDraftName,
4164
+ placeholder: '只影响显示与引用;留空保存 = 移除别名。不改作用域键本身。',
4165
+ onChange: (e) => setScopeDraftName(e.target.value),
4166
+ })
4167
+ : null,
4168
+ scopeError !== '' ? h('div', { className: 'err' }, scopeError) : null,
4169
+ h('div', { className: 'scope-edit-actions' },
4170
+ h('button', { disabled: scopeBusy, onClick: () => saveScopeEdit(row) }, scopeBusy ? '保存中…' : '保存'),
4171
+ h('button', { disabled: scopeBusy, onClick: cancelScopeEdit }, '取消'),
4172
+ ),
4173
+ )
4174
+ : h('div', { className: 'scope-row-desc' },
4175
+ row.description === '' ? '(未填写用途)' : row.description,
4176
+ row.descriptionSource === 'default' ? h('span', { className: 'muted' }, ' · 默认描述') : null,
4177
+ ),
4178
+ editing
4179
+ ? null
4180
+ : h('div', { className: 'scope-row-foot' },
4181
+ h('span', { className: 'scope-row-key', title: '作用域键:工具参数直接用它(自定义作用域传裸名)' }, row.scope),
4182
+ h('span', { style: { flex: 1 } }),
4183
+ row.records > 0
4184
+ ? h('button', {
4185
+ className: 'linkbtn',
4186
+ title: '切到「记忆」并只看这个作用域',
4187
+ onClick: () => openScopeRecords(row.scope),
4188
+ }, '查看记忆')
4189
+ : null,
4190
+ h('button', {
4191
+ className: 'linkbtn',
4192
+ title: '编辑这个作用域的用途与别名(别名可选)',
4193
+ onClick: () => beginScopeEdit(row),
4194
+ }, '编辑'),
4195
+ ),
4196
+ )
4197
+ }),
4102
4198
  )
4103
4199
  // 旧 provider 没有 scope-meta 用途:说明一句,而不是让人以为作用域都没有用途。
4104
4200
  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 字段:用一句话说明这次调用要做什么(例如「查发布流程的坑」)。它只用于范围外访问的审批弹窗,不写进记忆;漏了会被工具直接拒绝。绝对限制 / 无限制下可省略。