@restregular/dsh-memory 0.9.5 → 0.9.7

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/README.md CHANGED
@@ -111,11 +111,25 @@ memory_save({
111
111
  - **服务**:「向量服务」:状态、地址、启停开关、**模型与硬件**(见下)、维护(卸载向量服务 / 清空记忆数据,两步确认)
112
112
  - **记录**(默认打开):顶部统计(记忆数 / 作用域数 / 待嵌入向量数)、搜索、按作用域筛选、**新建**(任意作用域 + 类型,类型里含 `rule`)、展开编辑 / 删除;列表放在独立的滚动容器里(记忆再多也不把面板撑长),滚动条是自定义的细圆头样式,从侧栏入口打开时容器还会跟着窗口长高;作用域下拉**动态枚举实际存在的作用域**(`global` 显示「全局」、project 显示 cwd、会话 scope 显示会话标题、自定义 scope 显示原名)
113
113
  - **记忆树**:所有作用域的记忆按 **作用域 → 类型 → 记录** 三层展开,根节点显示总数;记录卡按类型着色,`supersedes` / `supersededBy` 用金色虚线把「修正版」和「被修正的旧版」连起来。支持搜索(命中高亮、其余淡出)、按类型逐个开关、按作用域筛选、折叠作用域 / 类型、缩放与「适应」、以及点击记录打开的详情抽屉(全文、标签、重要度、时间、id 与双向修正链)。修正是**关系**而不是层级,所以不改变树结构,只叠在右侧;悬停或选中一条记录时,整条修正链一起点亮
114
- - **设置**:注入链路逐项开关 —— 每轮召回(topK / 预算)、印象形态(每条字数)、会话摘要(条数 / 预算)、记忆使用策略段、硬性规则段(条数 / 预算 / 变更提醒,并显示当前规则条数)、轮末提醒、侧栏入口;底部「数据」:导出全部 / 导入文件。改完**即保存**,不需要点按钮
114
+ - **设置**:注入链路逐项开关 —— 每轮召回(topK / 预算)、印象形态(每条字数)、会话摘要(条数 / 正文预算 / 截断标签预算 / 标签条数)、记忆使用策略段、硬性规则段(条数 / 预算 / 变更提醒,并显示当前规则条数)、自动召回(标签 / 是否用工具 description / 是否并入记忆库标签 / 查询字数)、轮末提醒、侧栏入口;底部「数据」:导出全部 / 导入文件。改完**即保存**,不需要点按钮
115
115
 
116
116
  > **导入 / 导出**:导出的是纯文本 —— 作用域、类型、内容、标签、重要度、时间戳,**没有向量**。导入时逐条走保存路径,按**当前模型重新嵌入**,并按「作用域 + 内容」去重(重复的计入「跳过」)。一次最多 5000 条。
117
117
 
118
- 面板后端在 `/memory/api`,全部路由:`GET /status`、`GET /records`、`POST /create`、`POST /update`、`POST /delete`、`GET /settings`、`POST /settings`、`GET /export`、`POST /import`、`GET /embed/status`、`POST /embed/start|stop`、`GET /embed/model`、`POST /embed/model/refresh|install|install/cancel|uninstall`、`POST /data/wipe`。
118
+ 面板后端在 `/memory/api`,全部路由:`GET /status`、`GET /records`、`GET /settings`、`POST /settings`、`GET /audit`、`POST /create`、`POST /update`、`POST /delete`、`GET /export`、`POST /import`、`GET /embed/status`、`POST /embed/start|stop`、`GET /embed/model`、`POST /embed/model/refresh|install|install/cancel|uninstall`、`POST /data/wipe`。
119
+
120
+ ## 注入可靠性(0.9.6 – 0.9.7)
121
+
122
+ 摘要和规则不再静默截断:
123
+
124
+ - **正文预算**:`digest.tokenBudget` 默认从 400 提到 800;`topK` 与预算仍是两个独立上限。
125
+ - **截断标签**:正文因 `topK` / 预算没注入时,附一条独立的「相关记忆索引」——每条只给 8 位 id、标签/主题、类型、作用域,以及 `memory_search` 检索指引;标签有 `digest.hintBudget` / `digest.hintMaxItems` 独立预算。标签也溢出时报告省略数量与原因。
126
+ - **退役规则**:被 `supersedes` 指向的旧记录不再进入摘要、规则段和自动召回;`memory_search` / `memory_get` 仍可查历史。
127
+ - **mandatory / pinned**:规则标签里写 `mandatory` / `pinned`(或 `必含` / `强制`)的条目排在规则段最前;超预算时输出明确警告,不静默丢弃。
128
+ - **标签触发的行为召回(0.9.7)**:设置里的 `autoRecall.tags` 是**标签**,不是正则;默认还会并入记忆库里已有的标签(`useMemoryTags`)。匹配源包括 `tool/call` 的 name / description / 参数、`tool/result` 的失败描述、可见 `assistant/message` 文本、`todo/write` 任务清单、`command/run`、`goal/change`。命中标签后,在下一个 `agent/pre-step` 用标签 + 命中片段检索;工具失败则始终用该工具调用自己的 `description`(取不到才退回错误类别)。中英标签有最小同义词映射(如 `deploy` ↔ 部署、`database` ↔ 数据库)。
129
+ - **去重**:已注入正文按 **sessionId + 记忆 id/版本** 跳过;只给过标签的会补正文;内容更新会重新评估;compaction 后重置摘要与去重状态。
130
+ - **标签可检索**:`search` 的词法通道把记录标签也并入检索文本,所以中文正文 + 英文标签也能被标签查询命中。
131
+ - **审计**:每次摘要/召回/规则评估写入内存审计环,`GET /memory/api/audit?session=<id>` 可查触发原因、阶段、候选、正文、标签、去重、省略原因与各通道预算;不记录凭据。
132
+ - **限制**:行为召回发生在**下一个** `agent/pre-step`;宿主虽有 `tools/pre-execute`,本插件没有用它做操作前硬阻断。不读取隐藏思维链:只消费可见 text 块、任务清单、命令/工具描述与失败信息。工具失败若底层只返回 aborted,审计会保留 `ABORTED_UNKNOWN`,不会臆测成凭据问题。
119
133
 
120
134
  ## 数据与文件布局
121
135
 
@@ -331,6 +345,22 @@ tools/build-single-package.mjs 构建(产物契约检查 + 可选加载验证)
331
345
 
332
346
  ## 版本
333
347
 
348
+ - **0.9.7** —— 行为召回从“固定发布/部署模式”改成**标签匹配**:
349
+ - `autoRecall.tags` 是可编辑标签列表,不再要求写正则;默认并入记忆库里已有的标签(`useMemoryTags`),所以不需要把每个标签抄进设置。
350
+ - 匹配源扩到可见 `assistant/message` text 块、`todo/write` 任务清单、`command/run`、`goal/change`、`tool/call` 的 name/description/参数,以及 `tool/result` 失败描述;不读取 hidden reasoning。
351
+ - 工具失败始终用该调用自己的 `description` 做检索查询;取不到才退回错误类别。
352
+ - 标签支持中英最小同义词(`deploy` ↔ 部署、`database` ↔ 数据库等);词法检索把记录标签并入可检索文本。
353
+ - 面板新增自动召回设置与标签编辑器;审计 signal 记录命中标签与来源。
354
+ - 测试覆盖标签触发、description 优先、assistant text/todo/command/goal 提取、跨语言标签、标签检索与设置归一化。
355
+ - **0.9.6** —— 注入可靠性改造:
356
+ - 摘要默认正文预算 400 → 800;旧版 `settings.json` 里仍是 400 且没有 `hintBudget` 的配置会在加载时迁移到 800,显式带 `hintBudget` 的配置不动。新增候选/正文/`top_k`/预算/退役/过期互斥统计,任何截断都有原因。
357
+ - 被截断记录生成独立标签索引(id + 标签/主题 + 类型 + 作用域),标签有独立预算与条数上限;mandatory/pinned 与发布/部署/凭据类标签优先保留。
358
+ - `supersedes` 旧记录统一从摘要、规则段、自动召回中退役;`memory_search` / `memory_get` 仍保留历史。
359
+ - 规则段支持 `mandatory` / `pinned` 标签,超出预算时输出警告;规则溢出不再静默。
360
+ - 按会话 + 记忆 id/版本去重,区分 `hint_injected` 与 `content_injected`;只给过标签的记忆可在任务命中后补正文,内容更新会重新评估;compaction 后重置摘要与去重状态。
361
+ - 监听 `session/event` 的 `tool/call` / `tool/result`,对 `npm publish`、`git push`、部署和工具失败做定向增量召回;失败按 `MISSING_CREDENTIAL` / `PERMISSION_DENIED` / `TIMEOUT` / `ABORTED_UNKNOWN` 分类。
362
+ - 新增内存审计环与 `GET /memory/api/audit`;记录触发原因、阶段、候选、正文、标签、去重、省略原因和各通道预算,不记录凭据。
363
+ - 测试新增摘要截断/标签索引/退役/mandatory/会话级状态/审计/行为信号,以及一次完整的「摘要标签 → 高风险工具 → 正文召回 → 工具失败诊断」链路。
334
364
  - **0.9.5** —— 新增「记忆树」标签页:
335
365
  - 所有作用域的记忆按 **作用域 → 类型 → 记录** 分层展示,根节点是总数;记录卡按类型着色(事实 / 决策 / 偏好 / 流程 / 笔记 / 规则),修正/被修正各有徽标。
336
366
  - `supersedes` 是点对点关系、不是层级,所以不改树结构:金色虚线从修正版弯到旧版的右缘,悬停或选中任意一端时,两端与整条修正链一起点亮;关闭「修正连线」可只看结构。
package/lib/client.js CHANGED
@@ -164,6 +164,9 @@ window.__ModuleLoader__.load({
164
164
  '.memp .switch .knob{position:absolute;top:2px;left:2px;width:16px;height:16px;border-radius:50%;background:#fff;transition:left .12s ease;box-shadow:0 1px 2px rgba(0,0,0,.25)}',
165
165
  '.memp .switch.on .knob{left:16px}',
166
166
  '.memp .setfoot{display:flex;align-items:center;gap:10px;padding-top:12px}',
167
+ '.memp .autorecall{flex:1 1 100%;display:flex;flex-direction:column;gap:6px;margin-top:6px}',
168
+ '.memp .autorecall textarea{min-height:150px;font-family:var(--ds-font-family-code, ui-monospace, monospace);font-size:11px;line-height:1.5}',
169
+ '.memp .autorecall .row{display:flex;gap:8px;align-items:center;flex-wrap:wrap}',
167
170
  '.memp .create{padding:10px 12px;border:1px solid var(--dsw-alias-border-l1);border-radius:8px;margin:8px 0;background:var(--dsw-alias-bg-layer-2)}',
168
171
  '.memp .create .row{display:flex;gap:8px;align-items:center;margin:6px 0;flex-wrap:wrap}',
169
172
  '.memp .create textarea{width:100%;min-height:64px}',
@@ -1547,11 +1550,13 @@ window.__ModuleLoader__.load({
1547
1550
  },
1548
1551
  {
1549
1552
  key: 'digest', title: '会话摘要',
1550
- desc: '会话第一步给一次项目 / 全局的记忆概览。',
1553
+ desc: '会话第一步给一次项目 / 全局的记忆概览;正文被截断时附一条标签索引。',
1551
1554
  fields: [
1552
1555
  { k: 'enabled', label: '启用', type: 'bool' },
1553
1556
  { k: 'topK', label: '最多条数', type: 'num', min: 1, max: 30, step: 1 },
1554
1557
  { k: 'tokenBudget', label: 'token 预算', type: 'num', min: 50, max: 4000, step: 50 },
1558
+ { k: 'hintBudget', label: '标签预算', type: 'num', min: 30, max: 1000, step: 10 },
1559
+ { k: 'hintMaxItems', label: '标签条数', type: 'num', min: 1, max: 30, step: 1 },
1555
1560
  ],
1556
1561
  },
1557
1562
  {
@@ -1570,6 +1575,16 @@ window.__ModuleLoader__.load({
1570
1575
  { k: 'delta', label: '变更提醒', type: 'bool', hint: '旧会话在下一轮第一步补一条新增/编辑过的规则;没变化的不重复' },
1571
1576
  ],
1572
1577
  },
1578
+ {
1579
+ key: 'autoRecall', title: '自动召回',
1580
+ desc: '从可见文本(assistant 输出、任务清单、命令/工具描述、失败信息)匹配记忆标签,命中即检索。',
1581
+ fields: [
1582
+ { k: 'enabled', label: '启用', type: 'bool' },
1583
+ { k: 'useToolDescription', label: '用工具 description', type: 'bool', hint: '失败/命中时优先用工具调用自己写的 description 做检索' },
1584
+ { k: 'useMemoryTags', label: '用记忆标签', type: 'bool', hint: '自动把记忆库里已有的标签并入触发词' },
1585
+ { k: 'maxQueryChars', label: '查询字数', type: 'num', min: 40, max: 500, step: 10 },
1586
+ ],
1587
+ },
1573
1588
  {
1574
1589
  key: 'turnEnd', title: '轮末提醒',
1575
1590
  desc: '下一轮开头提醒把本轮结论落盘,默认关闭。',
@@ -1582,6 +1597,32 @@ window.__ModuleLoader__.load({
1582
1597
  },
1583
1598
  ]
1584
1599
 
1600
+ /**
1601
+ * 自动召回“模式”编辑器:模式就是一组标签,每行一个。
1602
+ * 工具 name / description / 参数命中任一标签就召回;失败调用始终用 description。
1603
+ */
1604
+ function AutoRecallTagsEditor({ tags, onSave }) {
1605
+ const [text, setText] = React.useState((tags ?? []).join('\n'))
1606
+ return h('div', { className: 'autorecall' },
1607
+ h('div', { className: 'hint' },
1608
+ '每行一个额外标签。记忆库里已有的标签会自动并入(可关);',
1609
+ '可见文本命中任一个就触发召回,工具失败时始终用 description 检索。'),
1610
+ h('textarea', {
1611
+ rows: 8,
1612
+ spellCheck: false,
1613
+ value: text,
1614
+ placeholder: 'release\npublish\ndeploy\ndatabase\ncredentials\n发布\n部署',
1615
+ onChange: (e) => setText(e.target.value),
1616
+ }),
1617
+ h('div', { className: 'row' },
1618
+ h('button', {
1619
+ onClick: () => onSave(text.split(/[\n,,]+/).map((tag) => tag.trim()).filter(Boolean)),
1620
+ }, '保存标签'),
1621
+ h('span', { className: 'muted' }, '额外标签为空时仍会使用记忆库标签和失败召回'),
1622
+ ),
1623
+ )
1624
+ }
1625
+
1585
1626
  function SettingsTab() {
1586
1627
  const [settings, setSettings] = React.useState(null)
1587
1628
  const [error, setError] = React.useState('')
@@ -1687,6 +1728,14 @@ window.__ModuleLoader__.load({
1687
1728
  : null,
1688
1729
  )
1689
1730
  }),
1731
+ h('div', { className: 'setrow' },
1732
+ h('span', { className: 'set-title' }, '召回标签'),
1733
+ h('span', { className: 'set-desc' }, '工具调用命中标签,或工具失败时,用操作/失败描述检索记忆。'),
1734
+ h(AutoRecallTagsEditor, {
1735
+ tags: settings.autoRecall && Array.isArray(settings.autoRecall.tags) ? settings.autoRecall.tags : [],
1736
+ onSave: (tags) => patch('autoRecall', 'tags', tags),
1737
+ }),
1738
+ ),
1690
1739
  h('div', { className: 'setrow data' },
1691
1740
  h('span', { className: 'set-title' }, '数据'),
1692
1741
  h('span', { className: 'set-desc' }, '导出文本(不含向量),导入按当前模型重新嵌入并按内容去重。'),