@restregular/dsh-memory 0.9.6 → 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,13 +111,13 @@ 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
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
119
 
120
- ## 注入可靠性(0.9.6)
120
+ ## 注入可靠性(0.9.6 – 0.9.7)
121
121
 
122
122
  摘要和规则不再静默截断:
123
123
 
@@ -125,9 +125,11 @@ memory_save({
125
125
  - **截断标签**:正文因 `topK` / 预算没注入时,附一条独立的「相关记忆索引」——每条只给 8 位 id、标签/主题、类型、作用域,以及 `memory_search` 检索指引;标签有 `digest.hintBudget` / `digest.hintMaxItems` 独立预算。标签也溢出时报告省略数量与原因。
126
126
  - **退役规则**:被 `supersedes` 指向的旧记录不再进入摘要、规则段和自动召回;`memory_search` / `memory_get` 仍可查历史。
127
127
  - **mandatory / pinned**:规则标签里写 `mandatory` / `pinned`(或 `必含` / `强制`)的条目排在规则段最前;超预算时输出明确警告,不静默丢弃。
128
- - **行为感知召回**:监听 `session/event` 的 `tool/call` / `tool/result` / compaction。命中 `npm publish`、`git push`、部署等高风险操作,或工具失败(凭据/权限/超时/abort 分类)后,在下一个 `agent/pre-step` 用任务查询做一次增量召回;已注入正文按 **sessionId + 记忆 id/版本** 去重,只给过标签的会补正文,内容更新会重新评估。
129
- - **审计**:每次摘要/召回/规则评估写入内存审计环,`GET /memory/api/audit?session=<id>` 可查候选、正文、标签、去重、省略原因与各通道预算;不记录凭据或令牌。
130
- - **限制**:当前行为召回基于 `session/event` 的 `tool/call` / `tool/result`,召回发生在**下一个** `agent/pre-step`;宿主虽有 `tools/pre-execute`,本插件没有用它做操作前阻断,因此"发布/推送前强制检查"仍是告警 + 召回,不是硬阻断。工具失败若底层只返回 aborted,审计会保留 `ABORTED_UNKNOWN`,不会臆测成凭据问题。
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`,不会臆测成凭据问题。
131
133
 
132
134
  ## 数据与文件布局
133
135
 
@@ -343,6 +345,13 @@ tools/build-single-package.mjs 构建(产物契约检查 + 可选加载验证)
343
345
 
344
346
  ## 版本
345
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 提取、跨语言标签、标签检索与设置归一化。
346
355
  - **0.9.6** —— 注入可靠性改造:
347
356
  - 摘要默认正文预算 400 → 800;旧版 `settings.json` 里仍是 400 且没有 `hintBudget` 的配置会在加载时迁移到 800,显式带 `hintBudget` 的配置不动。新增候选/正文/`top_k`/预算/退役/过期互斥统计,任何截断都有原因。
348
357
  - 被截断记录生成独立标签索引(id + 标签/主题 + 类型 + 作用域),标签有独立预算与条数上限;mandatory/pinned 与发布/部署/凭据类标签优先保留。
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}',
@@ -1572,6 +1575,16 @@ window.__ModuleLoader__.load({
1572
1575
  { k: 'delta', label: '变更提醒', type: 'bool', hint: '旧会话在下一轮第一步补一条新增/编辑过的规则;没变化的不重复' },
1573
1576
  ],
1574
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
+ },
1575
1588
  {
1576
1589
  key: 'turnEnd', title: '轮末提醒',
1577
1590
  desc: '下一轮开头提醒把本轮结论落盘,默认关闭。',
@@ -1584,6 +1597,32 @@ window.__ModuleLoader__.load({
1584
1597
  },
1585
1598
  ]
1586
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
+
1587
1626
  function SettingsTab() {
1588
1627
  const [settings, setSettings] = React.useState(null)
1589
1628
  const [error, setError] = React.useState('')
@@ -1689,6 +1728,14 @@ window.__ModuleLoader__.load({
1689
1728
  : null,
1690
1729
  )
1691
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
+ ),
1692
1739
  h('div', { className: 'setrow data' },
1693
1740
  h('span', { className: 'set-title' }, '数据'),
1694
1741
  h('span', { className: 'set-desc' }, '导出文本(不含向量),导入按当前模型重新嵌入并按内容去重。'),