@restregular/dsh-memory 0.14.7 → 0.15.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,23 @@
2
2
 
3
3
  本项目的版本记录。安装 id 与 npm 版本一一对应。
4
4
 
5
+ ## 0.15.0 — 去重与时效:退役记录默认隐藏、规则不进摘要、信号每轮一次、状态记忆
6
+
7
+ 这一版先解决评审里最扎眼的两件事:**旧结论仍在注入**和**同一批记忆从多个通道重复进入上下文**。
8
+
9
+ - **退役记录默认隐藏**:被 `supersedes` 指向的旧记录不再进入 `memory_search`、`memory_list`、摘要、规则段和自动召回。检索层直接过滤,而不是只靠分数降权。
10
+ - `memory_search` 新增 `includeSuperseded`(默认 `false`);历史核对时显式打开。
11
+ - `memory_get(id)` 与面板「记录 / 记忆树」仍能查看旧版本,数据不删除。
12
+ - 面板的语义检索按历史浏览器处理,内部允许返回退役与过期记录。
13
+ - **摘要与规则跨通道去重**:摘要现在排除 `kind=rule`(规则已经常驻系统提示),并把每条被排除记录归入 `rule` 统计;规则段和规则增量实际渲染的 id + 版本会写进会话注入状态,后续 `recall` 不会再重复注入同一条规则。
14
+ - **行为信号降噪**:同一轮最多触发一次 signal 驱动召回;同 tag / 同 query 的重复信号只落一条 `signal_dropped` 审计,不再重复检索。工具失败信号与 0.14.7 的「必须有 description、`memory_*` 除外」规则保持不变。
15
+ - **新增 `kind=state`(状态记忆)**:
16
+ - 写入时默认 7 天 TTL(`memory_save` 可传 `ttlMs` / `expiresAt`,显式 `expiresAt` 优先;设置项 `state.ttlMs` 可改默认值)。
17
+ - 过期后默认从检索 / 摘要 / 召回 / 列表隐藏,但**不自动删除**;`memory_get` 和面板仍可取到正文。
18
+ - 注入与摘要行带「状态,使用前验证」前缀,避免把临时状态当成持久事实。
19
+ - 面板新建 / 编辑支持 `state` 与有效期,记录卡与详情显示「已过期」和剩余时间。
20
+ - 回归测试:默认检索不含退役/过期记录、`includeSuperseded` 可取历史;摘要不含规则;同轮第二个信号不检索;规则正文不会在 recall 里重复;状态过期隐藏但 `getByIds` 可取。
21
+
5
22
  ## 0.14.7 — memory_search / 无 description 的工具不再触发自动召回
6
23
 
7
24
  - **根因**:`tool/call` 的高风险召回信号不看 `description` 是否存在,直接把工具名 + 参数拼进匹配文本。`memory_search` 的 `query` 一旦含标签(包括默认的记忆标签),就会排队一次 `before_high_risk_tool` 信号;下一步强制召回,和已经注入的摘要/正文重复。
package/README.md CHANGED
@@ -28,10 +28,12 @@ JSONL 落盘 · 本机向量检索 · 五个模型工具 · 自动召回 · 硬
28
28
  | 新会话从零开始,换个窗口就问不出上次的结论 | 结论落成记忆;新会话第一步注入摘要,之后每轮按问题召回 |
29
29
  | 同一个坑反复踩,上次查到的命令又要再查一遍 | 发布 / 部署 / 工具失败等行为会触发定向召回;查到的做法直接复用 |
30
30
  | 写了规则没人执行,改过的规则旧会话不知道 | `kind: rule` 进系统提示常驻段;新增或编辑会补一条提醒 |
31
+ | 临时状态被当成永久事实 | `kind: state` 带默认 7 天 TTL 和「使用前验证」前缀;过期后默认隐藏,但不会自动删除 |
31
32
  | 云端记忆不可控,敏感内容不敢写 | 全部本地 JSONL;写入前过凭据扫描;检索默认不联网 |
32
33
 
33
34
  它也不是「把聊天记录整段塞给模型」:每条记忆是一句自洽的话,按作用域、类型和重要度管理;
34
- 召回有 token 预算与去重,旧结论可以用 `supersedes` 标注修正,而不是悄悄覆盖。
35
+ 召回有 token 预算与去重;旧结论可以用 `supersedes` 标注修正,被修正的旧版本默认不再参与
36
+ 检索 / 摘要 / 召回(历史仍可用 `memory_get` 和面板查看),而不是悄悄覆盖。
35
37
 
36
38
  ## 功能
37
39
 
@@ -43,6 +45,7 @@ JSONL 落盘 · 本机向量检索 · 五个模型工具 · 自动召回 · 硬
43
45
  | **自动召回** | 每轮按用户问题召回;新会话第一步注入项目 / global 摘要;发布、部署、工具失败等行为按标签触发定向召回 |
44
46
  | **印象形态** | 每轮只给每条记忆的短摘要;模型判断相关但需要细节时再 `memory_get` 取全文,省 token 也不丢信息 |
45
47
  | **硬性规则** | `kind: rule` 进系统提示常驻段;旧会话会收到新增 / 编辑提醒;超预算有明确警告,不静默丢弃 |
48
+ | **状态记忆** | `kind: state` 默认 7 天 TTL;注入带「状态,使用前验证」;过期后默认不进检索 / 摘要 / 召回,但 `memory_get` 与面板仍可取 |
46
49
  | **可视化管理** | 记录浏览 / 搜索 / 新建 / 编辑 / 删除;**记录页可主动做语义检索**(与 `memory_search` 同一套排序);记忆树展示作用域、类型与修正链;设置改完即存;导入导出 |
47
50
  | **一键向量后端** | 面板里下载 llama.cpp 运行时与内置模型,按 CPU / 内存 / 显卡推荐;换模型自动重建向量 |
48
51
  | **跨进程安全** | 每个作用域一把写锁,锁内重新读盘再合并;多个 DSH 实例或 MCP server 共用一个 store 不丢数据 |
@@ -148,9 +151,10 @@ try/catch——任何一半失败都只记一行日志,绝不让 DSH 启动失
148
151
  ```jsonc
149
152
  memory_save({
150
153
  "content": "本仓库用 pnpm 11 安装依赖;PATH 上的 pnpm 10 会报 ERR_PNPM_UNEXPECTED_STORE。",
151
- "kind": "procedure", // fact / decision / preference / procedure / note / rule
154
+ "kind": "procedure", // fact / decision / preference / procedure / note / rule / state
152
155
  "tags": ["pnpm", "toolchain"],
153
156
  "importance": 0.8, // 0~1
157
+ "expiresAt": 1793836800000, // 可选:过期时间(ms);kind=state 不传时按默认 TTL(7 天),也可传 ttlMs
154
158
  "path": "D:/repositories/dsh-memory" // 可选:写入 project:<该路径>
155
159
  })
156
160
  ```
@@ -159,6 +163,7 @@ memory_save({
159
163
 
160
164
  ```jsonc
161
165
  memory_search({ "query": "pnpm 装依赖", "topK": 5 })
166
+ memory_search({ "query": "旧的发布流程", "includeSuperseded": true }) // 默认隐藏被修正/覆盖的旧版本
162
167
  memory_get({ "ids": ["3f2a9c1d"] })
163
168
  memory_list({ "limit": 20 })
164
169
  memory_forget({ "id": "3f2a9c1d" }) // 按内容删:memory_forget({ query, scope })
@@ -193,7 +198,7 @@ memory_forget({ "id": "3f2a9c1d" }) // 按内容删:memory_forget({ q
193
198
  | 层 | 触发 | 作用 |
194
199
  | --- | --- | --- |
195
200
  | `recall` | 每轮 `agent/pre-step` | 按本轮用户问题检索,按 topK / token 预算注入;默认只给每条 120 字摘要 + `memory_get` 指引 |
196
- | `digest` | 会话第一步 | 注入项目 + global 概览:按重要度 × 新鲜度挑选;正文超预算时附可检索的标签索引 |
201
+ | `digest` | 会话第一步 | 注入项目 + global 概览:按重要度 × 新鲜度挑选;`kind=rule` 不进摘要(已常驻系统提示);正文超预算时附可检索的标签索引 |
197
202
  | `policy` | 系统提示常驻 | 什么时候查记忆、查到怎么复用、查不到时低风险推断 / 高风险先问用户 |
198
203
  | `rules` | 系统提示常驻 | `kind: rule` 的硬性规则,限量与预算;`mandatory` / `pinned` 排在最前 |
199
204
  | `turnEnd` | 每轮结束(默认关) | 下一轮开头提醒「有可复用结论先落盘」 |
@@ -212,7 +217,10 @@ memory_forget({ "id": "3f2a9c1d" }) // 按内容删:memory_forget({ q
212
217
  ### 去重与修正
213
218
 
214
219
  - 召回按 **sessionId + 记忆 id / 版本** 去重;只给过标签的记录,任务命中后可补正文;内容更新会重新评估。
215
- - 被 `supersedes` 指向的旧记录不再进入摘要、规则段和自动召回;`memory_search` / `memory_get` 仍可查历史。
220
+ - 被 `supersedes` 指向的旧记录不再进入 `memory_search`、`memory_list`、摘要、规则段和自动召回;`memory_get(id)` 与面板仍可查历史。需要历史检索时 `memory_search({ includeSuperseded: true })`。
221
+ - 摘要排除 `kind=rule`;规则段实际进入系统提示的 id 会写进会话注入状态,recall 不再重复注入同一条规则。
222
+ - 同一轮最多发生一次 signal 驱动召回;同 tag / 同 query 的第二个信号只记一条 `signal_dropped` 审计。
223
+ - `kind=state` 过期后默认从检索 / 摘要 / 召回 / 列表隐藏,但数据不删除;`memory_get` 与面板仍可取。
216
224
  - compaction 后重置摘要与注入去重状态。
217
225
 
218
226
  ## 检索
package/lib/client.js CHANGED
@@ -83,6 +83,7 @@ window.__ModuleLoader__.load({
83
83
  '.memp .badge{border:1px solid var(--dsw-alias-border-l1);border-radius:5px;padding:0 6px;line-height:1.7;color:var(--dsw-alias-label-secondary);flex:none}',
84
84
  '.memp .badge.scope{color:var(--dsw-alias-brand-primary);max-width:220px;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}',
85
85
  '.memp .badge.corrected{color:var(--dsw-alias-brand-primary);border-color:var(--dsw-alias-brand-primary)}',
86
+ '.memp .badge.expired{color:#C0563B;border-color:color-mix(in srgb,#C0563B 55%,transparent)}',
86
87
  '.memp .tags{display:flex;flex-wrap:wrap;gap:4px;margin-top:6px}',
87
88
  '.memp .tag{font-size:11px;line-height:1.7;padding:0 6px;border-radius:999px;border:1px solid var(--dsw-alias-border-l1);color:var(--dsw-alias-label-secondary);background:var(--dsw-alias-bg-layer-2)}',
88
89
  '.memp .meta{display:flex;align-items:center;gap:8px;margin-top:8px;font-size:12px;color:var(--dsw-alias-label-secondary)}',
@@ -311,6 +312,7 @@ window.__ModuleLoader__.load({
311
312
  '.memp .tn-badge{border-radius:999px;padding:0 5px;line-height:1.55;font-size:9.5px;border:1px solid transparent;flex:none}',
312
313
  '.memp .tn-badge.corr{color:color-mix(in srgb,#D9A441 62%,var(--dsw-alias-label-primary));background:color-mix(in srgb,#D9A441 14%,transparent);border-color:color-mix(in srgb,#D9A441 35%,transparent)}',
313
314
  '.memp .tn-badge.old{color:var(--dsw-alias-label-secondary);background:var(--dsw-alias-bg-layer-2);border-color:var(--dsw-alias-border-l1)}',
315
+ '.memp .tn-badge.expired{color:color-mix(in srgb,#C0563B 70%,var(--dsw-alias-label-primary));background:color-mix(in srgb,#C0563B 12%,transparent);border-color:color-mix(in srgb,#C0563B 30%,transparent)}',
314
316
  '.memp .tn-time{margin-left:auto;flex:none;font-size:9.5px;opacity:.75}',
315
317
  '.memp .tn-content{font-size:11.5px;line-height:1.45;color:var(--dsw-alias-label-secondary);display:-webkit-box;-webkit-line-clamp:2;-webkit-box-orient:vertical;overflow:hidden;word-break:break-word}',
316
318
  '.memp .tree-empty{position:absolute;inset:0;display:flex;align-items:center;justify-content:center;flex-direction:column;gap:8px;color:var(--dsw-alias-label-secondary);font-size:12.5px;line-height:1.6;text-align:center;padding:24px;z-index:1}',
@@ -504,6 +506,21 @@ window.__ModuleLoader__.load({
504
506
  return `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())} ${pad(d.getHours())}:${pad(d.getMinutes())}`
505
507
  }
506
508
 
509
+ /** 过期时间的人话描述:还剩多久 / 已过期多久。 */
510
+ function expiryText(ts) {
511
+ if (!ts) return '永不过期'
512
+ const diff = Number(ts) - Date.now()
513
+ const abs = Math.abs(diff)
514
+ const days = Math.floor(abs / 86_400_000)
515
+ const hours = Math.floor((abs % 86_400_000) / 3_600_000)
516
+ const span = days > 0 ? `${days} 天${hours > 0 ? ` ${hours} 小时` : ''}` : `${Math.max(1, hours)} 小时`
517
+ return diff >= 0 ? `还剩 ${span}` : `已过期 ${span}`
518
+ }
519
+
520
+ function isExpired(rec) {
521
+ return rec && rec.expiredAt !== null && rec.expiredAt !== undefined && Number(rec.expiredAt) < Date.now()
522
+ }
523
+
507
524
  /**
508
525
  * scope 键 → 展示标签。优先用 /status 返回的 `label`(服务端能查会话标题、能解析
509
526
  * project 的 cwd);服务端没给(旧 provider / 还没加载到)时用本地回退。
@@ -518,7 +535,7 @@ window.__ModuleLoader__.load({
518
535
  }
519
536
 
520
537
  /** 记忆类型 → 中文名 + 树里的强调色(与宿主主题无关的固定色相,底色用 color-mix 自适应)。 */
521
- const KIND_ORDER = ['fact', 'decision', 'preference', 'procedure', 'note', 'rule']
538
+ const KIND_ORDER = ['fact', 'decision', 'preference', 'procedure', 'note', 'rule', 'state']
522
539
  const KIND_META = {
523
540
  fact: { label: '事实', color: '#5B8DEF' },
524
541
  decision: { label: '决策', color: '#D99A2B' },
@@ -526,6 +543,7 @@ window.__ModuleLoader__.load({
526
543
  procedure: { label: '流程', color: '#3FAE7A' },
527
544
  note: { label: '笔记', color: '#7C8AA0' },
528
545
  rule: { label: '规则', color: '#9B6BE0' },
546
+ state: { label: '状态', color: '#4AA3B8' },
529
547
  }
530
548
 
531
549
  function kindMeta(kind) {
@@ -791,6 +809,9 @@ window.__ModuleLoader__.load({
791
809
  const [kind, setKind] = React.useState(rec.kind)
792
810
  const [tags, setTags] = React.useState(rec.tags.join(', '))
793
811
  const [importance, setImportance] = React.useState(rec.importance)
812
+ const [ttlDays, setTtlDays] = React.useState(
813
+ rec.expiredAt ? Math.max(1, Math.round((Number(rec.expiredAt) - Date.now()) / 86_400_000)) : 7,
814
+ )
794
815
  const [busy, setBusy] = React.useState(false)
795
816
  const [error, setError] = React.useState('')
796
817
  const [copied, setCopied] = React.useState(false)
@@ -830,6 +851,7 @@ window.__ModuleLoader__.load({
830
851
  kind,
831
852
  importance: Number(importance) || 0,
832
853
  tags: tags.split(',').map((t) => t.trim()).filter(Boolean),
854
+ ...(kind === 'state' ? { ttlMs: Math.max(1, Number(ttlDays) || 7) * 86_400_000 } : {}),
833
855
  })
834
856
  setEditing(false)
835
857
  onSaved()
@@ -846,6 +868,7 @@ window.__ModuleLoader__.load({
846
868
  setEditing(false)
847
869
  setContent(rec.content); setKind(rec.kind)
848
870
  setTags(rec.tags.join(', ')); setImportance(rec.importance)
871
+ setTtlDays(rec.expiredAt ? Math.max(1, Math.round((Number(rec.expiredAt) - Date.now()) / 86_400_000)) : 7)
849
872
  }
850
873
 
851
874
  return h('div', { className: 'rec' + (focus ? ' focus' : ''), ref: cardRef },
@@ -883,6 +906,12 @@ window.__ModuleLoader__.load({
883
906
  title: `已被 #${rec.supersededBy} 修正(旧记录仍可检索,只是排序降权)`,
884
907
  }, '已被修正')
885
908
  : null,
909
+ isExpired(rec)
910
+ ? h('span', {
911
+ className: 'badge expired',
912
+ title: `过期于 ${fmtTime(rec.expiredAt)};默认检索/摘要/召回会隐藏,memory_get 仍可取`,
913
+ }, '已过期')
914
+ : null,
886
915
  // 只在"待嵌入"时提示:已嵌入是常态,向量没启用时这条也没有行动价值。
887
916
  !rec.embedded && vectorOn ? h('span', { className: 'pending', title: '待嵌入:向量服务就绪后会自动补上' }, '待嵌入') : null,
888
917
  h('span', { className: 'time', title: `更新于 ${fmtTime(rec.updatedAt)}` }, fmtTime(rec.updatedAt)),
@@ -896,7 +925,7 @@ window.__ModuleLoader__.load({
896
925
  h('div', { className: 'editrow' },
897
926
  // 类型也用同一个自绘下拉(全站不再有原生 select)
898
927
  h(Dropdown, {
899
- items: ['fact', 'decision', 'preference', 'procedure', 'note', 'rule'].map((k) => ({ value: k, label: k })),
928
+ items: ['fact', 'decision', 'preference', 'procedure', 'note', 'rule', 'state'].map((k) => ({ value: k, label: k })),
900
929
  value: kind,
901
930
  disabled: busy,
902
931
  onChange: (next) => setKind(next),
@@ -904,6 +933,10 @@ window.__ModuleLoader__.load({
904
933
  h('input', { type: 'text', style: { width: 170 }, value: tags, placeholder: '标签, 逗号分隔', onChange: (e) => setTags(e.target.value) }),
905
934
  h('label', null, '重要度 ',
906
935
  h('input', { type: 'number', min: 0, max: 1, step: 0.1, value: importance, onChange: (e) => setImportance(e.target.value) })),
936
+ kind === 'state'
937
+ ? h('label', null, '有效期(天) ',
938
+ h('input', { type: 'number', min: 1, max: 365, step: 1, value: ttlDays, onChange: (e) => setTtlDays(e.target.value) }))
939
+ : null,
907
940
  ),
908
941
  h('div', { className: 'acts' },
909
942
  h('button', { disabled: busy, onClick: save }, busy ? '保存中…' : '保存'),
@@ -920,6 +953,12 @@ window.__ModuleLoader__.load({
920
953
  rec.tags && rec.tags.length > 0
921
954
  ? h('div', { className: 'tags' }, rec.tags.map((tag) => h('span', { className: 'tag', key: tag }, tag)))
922
955
  : null,
956
+ rec.expiredAt
957
+ ? h('div', { className: 'meta' },
958
+ h('span', { className: 'meta-label' }, '过期'),
959
+ h('span', { className: isExpired(rec) ? 'meta-done' : '' }, `${fmtTime(rec.expiredAt)}(${expiryText(rec.expiredAt)})`),
960
+ )
961
+ : null,
923
962
  ),
924
963
  )
925
964
  : null,
@@ -968,6 +1007,9 @@ window.__ModuleLoader__.load({
968
1007
  rec.supersededBy
969
1008
  ? h('span', { className: 'tn-badge old', title: `已被 #${rec.supersededBy} 修正` }, '已修正')
970
1009
  : null,
1010
+ isExpired(rec)
1011
+ ? h('span', { className: 'tn-badge expired', title: `过期于 ${fmtTime(rec.expiredAt)}` }, '已过期')
1012
+ : null,
971
1013
  h('span', { className: 'tn-time' }, shortTime(rec.updatedAt)),
972
1014
  ),
973
1015
  h('div', { className: 'tn-content' }, rec.content),
@@ -1067,6 +1109,13 @@ window.__ModuleLoader__.load({
1067
1109
  ),
1068
1110
  h('div', { className: 'rowline' }, h('span', null, '创建'), h('b', null, fmtTime(rec.createdAt))),
1069
1111
  h('div', { className: 'rowline' }, h('span', null, '更新'), h('b', null, fmtTime(rec.updatedAt))),
1112
+ rec.expiredAt
1113
+ ? h('div', { className: 'rowline' },
1114
+ h('span', null, '过期'),
1115
+ h('b', null, `${fmtTime(rec.expiredAt)}(${expiryText(rec.expiredAt)})`),
1116
+ isExpired(rec) ? h('span', { className: 'tn-badge expired' }, '已过期') : null,
1117
+ )
1118
+ : null,
1070
1119
  h('div', { className: 'rowline' },
1071
1120
  h('span', null, 'id'),
1072
1121
  h('code', { className: 'td-id', title: '点击复制完整 id', onClick: copyId }, rec.id),
@@ -1775,6 +1824,14 @@ window.__ModuleLoader__.load({
1775
1824
  { k: 'enabled', label: '启用', type: 'bool', hint: '关闭只移除这段提示,不影响记忆检索。' },
1776
1825
  ],
1777
1826
  },
1827
+ {
1828
+ key: 'state', title: '状态记忆',
1829
+ desc: 'kind=state 的默认有效期;注入时带「状态,使用前验证」前缀,过期后默认不进检索/摘要/召回。',
1830
+ hint: '过期不会自动删除:面板和 memory_get 仍能取到,方便核对历史。',
1831
+ fields: [
1832
+ { k: 'ttlMs', label: '默认有效期(天)', type: 'num', min: 1, max: 365, step: 1, scale: 86_400_000, hint: '设置里存毫秒;面板按天编辑。' },
1833
+ ],
1834
+ },
1778
1835
  {
1779
1836
  key: 'rules', title: '硬性规则',
1780
1837
  desc: '把 kind=rule 的记忆放进系统提示常驻段;旧会话下一轮补一条新增 / 变更的规则。',
@@ -1864,8 +1921,9 @@ window.__ModuleLoader__.load({
1864
1921
  field.hint ? h('span', { className: 'setfield-hint' }, field.hint) : null,
1865
1922
  ),
1866
1923
  h('input', {
1867
- type: 'number', min: field.min, max: field.max, step: field.step, value: value,
1868
- onChange: (e) => onPatch(Number(e.target.value)),
1924
+ type: 'number', min: field.min, max: field.max, step: field.step,
1925
+ value: field.scale ? Math.round(Number(value) / field.scale) : value,
1926
+ onChange: (e) => onPatch(field.scale ? Number(e.target.value) * field.scale : Number(e.target.value)),
1869
1927
  }),
1870
1928
  )
1871
1929
  }
@@ -2050,6 +2108,7 @@ window.__ModuleLoader__.load({
2050
2108
  const [content, setContent] = React.useState('')
2051
2109
  const [tags, setTags] = React.useState('')
2052
2110
  const [importance, setImportance] = React.useState(0.6)
2111
+ const [ttlDays, setTtlDays] = React.useState(7)
2053
2112
  const [busy, setBusy] = React.useState(false)
2054
2113
  const [error, setError] = React.useState('')
2055
2114
 
@@ -2071,6 +2130,7 @@ window.__ModuleLoader__.load({
2071
2130
  content,
2072
2131
  tags: tags.split(',').map((t) => t.trim()).filter(Boolean),
2073
2132
  importance: Number(importance),
2133
+ ...(kind === 'state' ? { ttlMs: Math.max(1, Number(ttlDays) || 7) * 86_400_000 } : {}),
2074
2134
  })
2075
2135
  setBusy(false)
2076
2136
  onCreated()
@@ -2091,10 +2151,11 @@ window.__ModuleLoader__.load({
2091
2151
  })
2092
2152
  : null,
2093
2153
  h(Dropdown, {
2094
- items: ['fact', 'decision', 'preference', 'procedure', 'note', 'rule'].map((k) => ({ value: k, label: k })),
2154
+ items: ['fact', 'decision', 'preference', 'procedure', 'note', 'rule', 'state'].map((k) => ({ value: k, label: k })),
2095
2155
  value: kind, disabled: busy, onChange: setKind,
2096
2156
  }),
2097
2157
  kind === 'rule' ? h('span', { className: 'warn' }, '规则会进入系统提示常驻段') : null,
2158
+ kind === 'state' ? h('span', { className: 'warn' }, '状态会带“使用前验证”前缀,过期后默认隐藏') : null,
2098
2159
  ),
2099
2160
  h('div', { className: 'row' },
2100
2161
  h('textarea', {
@@ -2111,6 +2172,10 @@ window.__ModuleLoader__.load({
2111
2172
  })),
2112
2173
  h('label', null, '重要度 ',
2113
2174
  h('input', { type: 'number', min: 0, max: 1, step: 0.1, value: importance, onChange: (e) => setImportance(e.target.value) })),
2175
+ kind === 'state'
2176
+ ? h('label', null, '有效期(天) ',
2177
+ h('input', { type: 'number', min: 1, max: 365, step: 1, value: ttlDays, onChange: (e) => setTtlDays(e.target.value) }))
2178
+ : null,
2114
2179
  h('button', { onClick: submit, disabled: busy || content.trim() === '' || resolvedScope === '' }, busy ? '保存中…' : '保存'),
2115
2180
  h('button', { className: 'linkbtn', onClick: onCancel, disabled: busy }, '取消'),
2116
2181
  ),
@@ -128,6 +128,8 @@ export function apply(ctx , config = {}) {
128
128
  const callMeta = new Map ()
129
129
  const sessionScopes = new Map ()
130
130
  const sessionAutoScopes = new Map ()
131
+ /** 本轮已经发生过的 signal 驱动召回:每轮最多一次,同 tag/query 也跳过。 */
132
+ const signalRecallTurn = new Map ()
131
133
  const tagCache = new Map ()
132
134
  /** 系统提示 rules 段的同源渲染缓存:pre-step 算一次,section 回调复用。 */
133
135
  const rulesCache = new Map ()
@@ -390,6 +392,7 @@ export function apply(ctx , config = {}) {
390
392
  })
391
393
  injectionState.clear(sessionId)
392
394
  signals.clear(sessionId)
395
+ signalRecallTurn.delete(sessionId)
393
396
  digester.reset(sessionId)
394
397
  sessionScopes.delete(sessionId)
395
398
  sessionAutoScopes.delete(sessionId)
@@ -552,7 +555,8 @@ export function apply(ctx , config = {}) {
552
555
  const exclude = excludedIds(memory, scopes)
553
556
  const excludeAuto = excludedIds(memory, autoScopes)
554
557
  const signal = sessionId === undefined ? undefined : signals.take(sessionId)
555
- const usableSignal = autoScopes === undefined ? undefined : signal
558
+ let usableSignal = autoScopes === undefined ? undefined : signal
559
+ const turnKey = turn ?? step
556
560
  const userQuery = pickQueryText(input.messages )
557
561
  const phase = detectPhase(userQuery)
558
562
  const userQueryField = sanitizeAuditText(userQuery)
@@ -575,6 +579,19 @@ export function apply(ctx , config = {}) {
575
579
  }
576
580
  const settings = settingsOf()
577
581
 
582
+ // 每轮最多一次 signal 驱动召回:一轮里的第二个信号不再强制检索。
583
+ // 同 tag / 同 query 的重复信号单独给出更精确的审计原因。
584
+ let signalDropReason
585
+ if (usableSignal !== undefined && sessionId !== undefined) {
586
+ const used = signalRecallTurn.get(sessionId)
587
+ if (used !== undefined && used.turn === turnKey) {
588
+ signalDropReason = used.tag !== undefined && usableSignal.tag !== undefined && used.tag === usableSignal.tag
589
+ ? 'same_tag'
590
+ : used.query === usableSignal.query ? 'same_query' : 'turn_capped'
591
+ usableSignal = undefined
592
+ }
593
+ }
594
+
578
595
  // 本步的评估先收集,等最终消息组装/校验完成后再统一写 evaluation + delivery。
579
596
  // 这样可以准确表达“评估选中了 X”与“消息真的追加了吗”两件不同的事。
580
597
  const staged = []
@@ -584,7 +601,8 @@ export function apply(ctx , config = {}) {
584
601
 
585
602
  if (signal !== undefined && usableSignal === undefined) {
586
603
  recordAudit(auditBase('signal', {
587
- kind: 'signal', stage: 'signal_dropped', outcome: 'skipped', reasonCode: 'auto_scope_unavailable',
604
+ kind: 'signal', stage: 'signal_dropped', outcome: 'skipped',
605
+ reasonCode: signalDropReason ?? 'auto_scope_unavailable',
588
606
  trigger: signal.reason, phase: signal.phase,
589
607
  ...(signal.callId !== undefined ? { operationId: signal.callId } : {}),
590
608
  signal: {
@@ -626,6 +644,9 @@ export function apply(ctx , config = {}) {
626
644
  if (delta.text !== undefined) {
627
645
  parts.push(delta.text)
628
646
  messageChannels.add('rules_delta')
647
+ if (sessionId !== undefined && delta.injectedEntries !== undefined) {
648
+ injectionState.markContent(sessionId, delta.injectedEntries)
649
+ }
629
650
  stage(auditBase('rules_delta', {
630
651
  kind: 'evaluation', stage: 'rendered', outcome: 'success', reasonCode: 'delta_rendered',
631
652
  selected: { contentIds: delta.changes.map((change) => change.id), hintIds: [], count: delta.records.length },
@@ -734,6 +755,11 @@ export function apply(ctx , config = {}) {
734
755
  }))
735
756
  } else {
736
757
  if (sessionId !== undefined) rulesCache.set(sessionId, { at: Date.now(), scopes: promptScopes, render: rendered.render })
758
+ // 规则正文已经进入系统提示常驻段;写进会话注入状态后,recall 不会再
759
+ // 把同一条规则当"新记忆"重复塞进对话消息。
760
+ if (sessionId !== undefined && rendered.render.stats.injectedEntries.length > 0) {
761
+ injectionState.markContent(sessionId, rendered.render.stats.injectedEntries)
762
+ }
737
763
  const rulesStats = rendered.render.stats
738
764
  const rulesOutcome = rulesStats.candidates === 0 ? 'skipped' : rulesStats.injected === 0 ? 'partial' : 'success'
739
765
  const rulesReason = rulesStats.candidates === 0 ? 'no_candidates' : rulesStats.injected === 0 ? 'all_omitted' : 'system_prompt_shared_render'
@@ -799,6 +825,14 @@ export function apply(ctx , config = {}) {
799
825
  } else {
800
826
  const recallScopes = usableSignal === undefined ? scopes : autoScopes
801
827
  const recallExclude = usableSignal === undefined ? exclude : excludeAuto
828
+ if (usableSignal !== undefined && sessionId !== undefined) {
829
+ signalRecallTurn.set(sessionId, {
830
+ turn: turnKey,
831
+ key: usableSignal.key,
832
+ ...(usableSignal.tag !== undefined ? { tag: usableSignal.tag } : {}),
833
+ query: usableSignal.query,
834
+ })
835
+ }
802
836
  const recall = await injector.maybeInjectDetailed(
803
837
  { messages: input.messages , signal: input.signal, ...(recallScopes !== undefined ? { scopes: recallScopes } : {}), ...(sessionId !== undefined ? { sessionId } : {}) },
804
838
  { messages: decision.messages },
@@ -5,10 +5,11 @@
5
5
  * 挑几条,让模型一开始就知道有哪些旧结论可复用,而不是先搜一遍。
6
6
  *
7
7
  * 0.9.6 起,摘要不再静默截断:
8
- * - 返回完整的候选/注入/省略统计与每条省略原因(top_k / budget / superseded / expired);
8
+ * - 返回完整的候选/注入/省略统计与每条省略原因(top_k / budget / superseded / expired / rule);
9
9
  * - 被省略的正文会生成一段**独立的标签索引**,让模型知道哪些领域还有未展开的记忆;
10
10
  * - 标签索引有自己的 token 预算与条数上限,不会反过来挤爆正文;
11
- * - 退役(superseded)记录默认不进入摘要正文,也不生成索引。
11
+ * - 退役(superseded)记录默认不进入摘要正文,也不生成索引;
12
+ * - kind=rule 的记录不进摘要:硬性规则已经常驻系统提示,再列一遍是跨通道重复。
12
13
  */
13
14
 
14
15
  import { estimateTokens } from '../provider/rerank.js'
@@ -22,7 +23,7 @@ const HINT_HEADER = '相关记忆索引(正文未注入):'
22
23
  const HINT_FOOTER = '这些条目的正文尚未加载;遇到相关任务时,按标签或 ID 用 memory_search 取正文。'
23
24
 
24
25
  /** 一条正文被省略的原因。统计口径互斥:每条记录只归入一个原因。 */
25
-
26
+
26
27
 
27
28
 
28
29
 
@@ -50,6 +51,7 @@ const HINT_FOOTER = '这些条目的正文尚未加载;遇到相关任务时
50
51
 
51
52
 
52
53
 
54
+
53
55
 
54
56
 
55
57
 
@@ -191,11 +193,20 @@ function renderHintIndex(omitted , cfg )
191
193
  return { text, tokens, injected: lines.length, omittedTopK, omittedBudget, injectedIds }
192
194
  }
193
195
 
196
+ /** 一条记录在摘要/召回里的行首标签。状态型记忆必须提示“使用前验证”。 */
197
+ export function recordKindPrefix(record ) {
198
+ return record.kind === 'state' ? '【状态,使用前验证】' : ''
199
+ }
200
+
201
+ export function digestLine(record ) {
202
+ return `- ${record.id.slice(0, 8)} [${digestScopeLabel(record.scope)}/${record.kind}] ${recordKindPrefix(record)}${record.content.replace(/\s+/g, ' ').slice(0, 160)}`
203
+ }
204
+
194
205
  /**
195
206
  * 摘要的完整计划:正文 + 截断统计 + 标签索引。
196
207
  *
197
- * 统计口径:先按退役/过期过滤,再按排序依次尝试注入;`selected` 以外的记录
198
- * 只会归入 `top_k`、`budget`、`superseded`、`expired` 之一。
208
+ * 统计口径:先按规则/退役/过期过滤,再按排序依次尝试注入;`selected` 以外的记录
209
+ * 只会归入 `top_k`、`budget`、`superseded`、`expired`、`rule` 之一。
199
210
  */
200
211
  export function renderDigest(records , cfg , now = Date.now()) {
201
212
  if (records.length === 0) return null
@@ -205,7 +216,14 @@ export function renderDigest(records , cfg
205
216
  const omitted = []
206
217
  let omittedSuperseded = 0
207
218
  let omittedExpired = 0
219
+ let omittedRules = 0
208
220
  for (const record of records) {
221
+ // 规则已经常驻系统提示(rules 段);摘要再列一遍就是同一个 id 在两个通道出现。
222
+ if (record.kind === 'rule') {
223
+ omittedRules += 1
224
+ omitted.push({ id: record.id, reason: 'rule', kind: record.kind, tags: tagsOf(record) })
225
+ continue
226
+ }
209
227
  if (retired.has(record.id)) {
210
228
  omittedSuperseded += 1
211
229
  omitted.push({ id: record.id, reason: 'superseded', kind: record.kind, tags: tagsOf(record) })
@@ -239,7 +257,7 @@ export function renderDigest(records , cfg
239
257
  omitted.push({ id: record.id, reason: 'budget', kind: record.kind, tags: tagsOf(record) })
240
258
  continue
241
259
  }
242
- const line = `- ${record.id.slice(0, 8)} [${digestScopeLabel(record.scope)}/${record.kind}] ${record.content.replace(/\s+/g, ' ').slice(0, 160)}`
260
+ const line = digestLine(record)
243
261
  const cost = estimateTokens(line) + 1
244
262
  if (tokens + cost > cfg.tokenBudget) {
245
263
  budgetExhausted = true
@@ -254,7 +272,7 @@ export function renderDigest(records , cfg
254
272
 
255
273
  const hint = renderHintIndex(hintCandidates, cfg)
256
274
  const bodyText = selected.length > 0
257
- ? `${HEADER}\n${selected.map((record) => `- ${record.id.slice(0, 8)} [${digestScopeLabel(record.scope)}/${record.kind}] ${record.content.replace(/\s+/g, ' ').slice(0, 160)}`).join('\n')}`
275
+ ? `${HEADER}\n${selected.map((record) => digestLine(record)).join('\n')}`
258
276
  : ''
259
277
  const text = [bodyText, hint.text].filter((part) => part !== null && part !== '').join('\n\n')
260
278
  if (text === '') return null
@@ -267,6 +285,7 @@ export function renderDigest(records , cfg
267
285
  omittedBudget,
268
286
  omittedSuperseded,
269
287
  omittedExpired,
288
+ omittedRules,
270
289
  truncated: omitted.length > 0,
271
290
  omitted,
272
291
  hint: {
@@ -9,6 +9,7 @@
9
9
  import { estimateTokens } from '../provider/rerank.js'
10
10
  import { normalizeScopeInput } from '../provider/scope.js'
11
11
  import { textHasTag } from './signals.js'
12
+ import { recordKindPrefix } from './digest.js'
12
13
  import { InjectionState } from './state.js'
13
14
 
14
15
 
@@ -230,7 +231,7 @@ export function renderRecallBlock(
230
231
  omitted.push({ id: h.record.id, reason: 'budget' })
231
232
  continue
232
233
  }
233
- const line = `- ${h.record.id.slice(0, 8)} ${h.record.content.replace(/\s+/g, ' ').slice(0, chars)}`
234
+ const line = `- ${h.record.id.slice(0, 8)} ${recordKindPrefix(h.record)}${h.record.content.replace(/\s+/g, ' ').slice(0, chars)}`
234
235
  const cost = estimateTokens(line) + 1
235
236
  if (tokens + cost > cfg.tokenBudget) {
236
237
  budgetExhausted = true
@@ -289,6 +290,7 @@ export function recallText(text ) {
289
290
 
290
291
 
291
292
 
293
+
292
294
 
293
295
 
294
296
 
@@ -353,6 +355,12 @@ export class MemoryInjector {
353
355
  retrieval: { ok: false, count: 0, error: 'retrieval_failed', errorCode: 'retrieval_failed' },
354
356
  }
355
357
  }
358
+ // 过期状态由 provider 的检索层过滤;这里再兜一道,防止旧 provider 把过期
359
+ // state 当成当前事实注入。memory_get(id) 仍可直接取到历史正文。
360
+ const now = Date.now()
361
+ const retrieved = hits
362
+ hits = hits.filter((hit) => !(hit.record.expiredAt !== undefined && hit.record.expiredAt < now))
363
+ const expiredExcluded = retrieved.length - hits.length
356
364
  // 成功检索后记住查询(即使没有新正文):同一 query 的后续 step 不再重复全量检索。
357
365
  this.state.setLastQuery(sessionId, query)
358
366
 
@@ -379,7 +387,7 @@ export class MemoryInjector {
379
387
  const block = renderRecallBlock(freshHits, cfg, optionsForRender)
380
388
  const base = {
381
389
  ids: [], candidates: candidates.length, dedupSkipped: deduplicated.length, updated, omitted: [], query,
382
- tokens: 0, rawHits: hits.length, tagFiltered, supersededExcluded,
390
+ tokens: 0, rawHits: hits.length, tagFiltered, supersededExcluded, expiredExcluded,
383
391
  retrieval: { ok: true, count: hits.length },
384
392
  }
385
393
  if (!block) return base
@@ -60,6 +60,8 @@ export function derivedHistoryOf(agent )
60
60
 
61
61
 
62
62
 
63
+                           
64
+
63
65
 
64
66
 
65
67
  /**
@@ -121,6 +123,7 @@ maybeInjectDetailed(agent , memory , cfg
121
123
  records: unseen,
122
124
  changes,
123
125
  ...(text !== undefined ? { tokens: rendered.tokens } : {}),
126
+ ...(text !== undefined ? { injectedEntries: rendered.stats.injectedEntries } : {}),
124
127
  }
125
128
  }
126
129
 
@@ -69,6 +69,8 @@ export function orderRules(records ) {
69
69
 
70
70
            
71
71
 
72
+                                    
73
+
72
74
             
73
75
 
74
76
 
@@ -103,6 +105,7 @@ function renderLines(
103
105
  let tokens = estimateTokens(header) + 4
104
106
  const lines = []
105
107
  const injectedIds = []
108
+ const injectedEntries = []
106
109
  let omittedTopK = 0
107
110
  let omittedBudget = 0
108
111
  let budgetExhausted = false
@@ -135,6 +138,7 @@ function renderLines(
135
138
  }
136
139
  lines.push(line)
137
140
  injectedIds.push(record.id)
141
+ injectedEntries.push({ id: record.id, updatedAt: record.updatedAt })
138
142
  tokens += cost
139
143
  if (mandatory) mandatoryInjected += 1
140
144
  }
@@ -151,6 +155,7 @@ function renderLines(
151
155
  mandatoryOmitted,
152
156
  truncated: omitted.length > 0,
153
157
  injectedIds,
158
+ injectedEntries,
154
159
  omitted,
155
160
  omittedIds: omitted.map((entry) => entry.id),
156
161
  }
package/lib/panel.js CHANGED
@@ -208,6 +208,8 @@ function wireRecord(rec, scopeStore, supersededBy = null) {
208
208
  accessCount: rec.accessCount ?? 0,
209
209
  supersededBy,
210
210
  supersedes: rec.supersedes ?? null,
211
+ expiredAt: rec.expiredAt ?? null,
212
+ expired: rec.expiredAt !== undefined && rec.expiredAt < Date.now(),
211
213
  embedded: !scopeStore.embedPending.has(rec.id) && scopeStore.vectors.has(rec.id),
212
214
  }
213
215
  }
@@ -574,6 +576,8 @@ async function handle(ctx, routePath, req, res) {
574
576
  ...(typeof body.content === 'string' ? { content: body.content } : {}),
575
577
  ...(Array.isArray(body.tags) ? { tags: body.tags.map(String) } : {}),
576
578
  ...(typeof body.importance === 'number' ? { importance: body.importance } : {}),
579
+ ...(typeof body.ttlMs === 'number' ? { ttlMs: body.ttlMs } : {}),
580
+ ...(typeof body.expiresAt === 'number' ? { expiresAt: body.expiresAt } : {}),
577
581
  })
578
582
  console.log(`[dsh-memory-panel] 新建 ${record.kind} @ ${record.scope}: ${record.id}`)
579
583
  writeJson(res, { ok: true, value: { record } })
@@ -806,6 +810,10 @@ async function handle(ctx, routePath, req, res) {
806
810
  if (body.importance !== undefined) rec.importance = Math.min(1, Math.max(0, Number(body.importance) || 0))
807
811
  if (body.tags !== undefined) rec.tags = Array.isArray(body.tags) ? body.tags.map(String) : []
808
812
  if (body.supersededBy !== undefined) rec.supersedes = body.supersededBy === null ? undefined : String(body.supersededBy)
813
+ // 过期时间:null 清除;expiresAt 绝对时间优先;ttlMs 相对当前时间。
814
+ if (body.expiredAt === null) delete rec.expiredAt
815
+ else if (typeof body.expiresAt === 'number') rec.expiredAt = body.expiresAt
816
+ else if (typeof body.ttlMs === 'number' && body.ttlMs > 0) rec.expiredAt = Date.now() + body.ttlMs
809
817
  rec.updatedAt = Date.now()
810
818
  // 改动本身要进增量(flush 只落增量,不再整份快照覆盖);向量作废靠 vectorsDirty。
811
819
  s.insert(rec)
@@ -686,7 +686,7 @@ export class LocalMemoryService {
686
686
  *
687
687
  * 默认排除已被 supersede 的旧记录;需要历史/审计时显式 includeSuperseded。
688
688
  */
689
- listSync(input = {}) {
689
+ listSync(input = {}) {
690
690
  const wanted = (input.scopes ?? []).map((scope) => this.canonicalScope(scope))
691
691
  const seen = new Set ()
692
692
  const stores = []
@@ -697,10 +697,13 @@ export class LocalMemoryService {
697
697
  if (s) stores.push(s)
698
698
  }
699
699
  const retired = input.includeSuperseded ? new Set () : new Set(this.supersededIds(wanted))
700
+ const now = Date.now()
700
701
  const out = []
701
702
  for (const s of stores) {
702
703
  for (const rec of s.records.values()) {
703
704
  if (retired.has(rec.id)) continue
705
+ // 过期 state 默认不参与任何自动注入/规则渲染;memory_get(id) 与面板仍可取。
706
+ if (!input.includeExpired && rec.expiredAt !== undefined && rec.expiredAt < now) continue
704
707
  if (input.kind !== undefined && rec.kind !== input.kind) continue
705
708
  out.push(rec)
706
709
  }
@@ -1336,6 +1339,20 @@ export class LocalMemoryService {
1336
1339
  if (input.supersedes && !this.store.scope(scope).records.get(input.supersedes)) {
1337
1340
  throw memoryError('SUPERSEDES_UNKNOWN', `supersedes target ${input.supersedes} not found in ${scope}`)
1338
1341
  }
1342
+ // 状态型记忆(state)默认带 TTL:写入时算一次绝对 expiresAt,读取时只比较时间。
1343
+ // 显式 expiresAt 优先;ttlMs 对任何 kind 都生效(便于测试/特殊用途)。
1344
+ const timing = input
1345
+ const explicitExpiresAt = typeof timing.expiresAt === 'number' && Number.isFinite(timing.expiresAt)
1346
+ ? timing.expiresAt
1347
+ : undefined
1348
+ const explicitTtl = typeof timing.ttlMs === 'number' && Number.isFinite(timing.ttlMs) && timing.ttlMs > 0
1349
+ ? timing.ttlMs
1350
+ : undefined
1351
+ const stateTtl = input.kind === 'state' ? this.injectSettings().state.ttlMs : undefined
1352
+ const expiresAt = explicitExpiresAt
1353
+ ?? (explicitTtl !== undefined ? Date.now() + explicitTtl
1354
+ : stateTtl !== undefined ? Date.now() + stateTtl : undefined)
1355
+ const saveInput = expiresAt !== undefined ? { ...input, expiredAt: expiresAt } : input
1339
1356
  // design §11: keep credentials out of the plaintext store and the embedder
1340
1357
  if (this.cfg.secrets.enabled) {
1341
1358
  const findings = scanSecrets(content)
@@ -1347,7 +1364,7 @@ export class LocalMemoryService {
1347
1364
  }
1348
1365
  }
1349
1366
  const { record } = this.store.save(
1350
- { ...input, scope, content },
1367
+ { ...saveInput, scope, content },
1351
1368
  { importance: input.source?.origin === 'auto' ? 0.4 : 0.8, source: { origin: 'explicit' } },
1352
1369
  )
1353
1370
  void this.embedRecord(record).catch(() => {})
@@ -1475,8 +1492,10 @@ export class LocalMemoryService {
1475
1492
  // 面板的语义检索复用这条流水线,但它是"看一眼"的浏览:不写访问计数,也不在
1476
1493
  // 没有任何向量时白跑一次嵌入请求。这两个开关只给面板的 searchForPanel 用,
1477
1494
  // 工具 / 注入调用不会传。
1478
- const internal = query
1495
+ const internal = query
1479
1496
  const allowVector = internal.vector !== false && this.cfg.vector.enabled && this.cfg.vector.configured
1497
+ const includeSuperseded = internal.includeSuperseded === true
1498
+ const includeExpired = internal.includeExpired === true
1480
1499
 
1481
1500
  // 候选 scope:显式 pin(单值)优先;否则用调用方给的合并集合(query.scopes,
1482
1501
  // 工具 / 注入传"会话 + 项目 + global");两者都没有才退回旧的 project + global。
@@ -1496,6 +1515,15 @@ export class LocalMemoryService {
1496
1515
  stores.push({ store, scope, isGlobal: scope === 'global' })
1497
1516
  }
1498
1517
 
1518
+ // 退役(superseded)记录默认不参与召回:它们只是被新记录修正过的历史版本,
1519
+ // 继续返回会让模型拿旧结论当现行事实。memory_get(id)/面板历史仍可直接取。
1520
+ const retired = new Set ()
1521
+ for (const { store } of stores) {
1522
+ for (const record of store.records.values()) {
1523
+ if (record.supersedes) retired.add(record.supersedes)
1524
+ }
1525
+ }
1526
+
1499
1527
  // --- channel 1: lexical recall, scored per scope with local IDF ---
1500
1528
 
1501
1529
  const candidates = new Map ()
@@ -1509,7 +1537,8 @@ export class LocalMemoryService {
1509
1537
  const stats = buildStats(tokenSets)
1510
1538
  for (let i = 0; i < all.length; i++) {
1511
1539
  const rec = all[i]
1512
- if (rec.expiredAt && rec.expiredAt < now) continue
1540
+ if (!includeExpired && rec.expiredAt && rec.expiredAt < now) continue
1541
+ if (!includeSuperseded && retired.has(rec.id)) continue
1513
1542
  const lex = lexicalScore(queryTokens, tokenSets[i] , stats)
1514
1543
  if (lex <= 0) continue
1515
1544
  // Weak-only overlap (no shared word/bigram) must clear the "real hit"
@@ -1539,30 +1568,27 @@ export class LocalMemoryService {
1539
1568
  }
1540
1569
  }
1541
1570
  for (const [id, sim] of vectorScores) {
1571
+ if (!includeSuperseded && retired.has(id)) continue
1542
1572
  const existing = candidates.get(id)
1543
1573
  if (existing) {
1544
1574
  existing.recallScore = Math.max(existing.recallScore, sim) // best channel wins
1545
- } else {
1546
- const rec = this.findById(id)
1547
- if (rec && !(rec.expiredAt && rec.expiredAt < now)) {
1548
- if (!(rec.scope === 'global' && sim < this.cfg.globalThreshold)) {
1549
- candidates.set(id, { record: rec, recallScore: sim, isGlobal: rec.scope === 'global' })
1550
- }
1551
- }
1575
+ continue
1576
+ }
1577
+ const rec = this.findById(id)
1578
+ if (!rec) continue
1579
+ if (!includeExpired && rec.expiredAt !== undefined && rec.expiredAt < now) continue
1580
+ if (!(rec.scope === 'global' && sim < this.cfg.globalThreshold)) {
1581
+ candidates.set(id, { record: rec, recallScore: sim, isGlobal: rec.scope === 'global' })
1552
1582
  }
1553
1583
  }
1554
1584
  }
1555
1585
 
1556
1586
  // shape with recency/importance, sort, cut
1557
- const supersededIds = new Set ()
1558
- for (const { store } of stores) {
1559
- for (const r of store.records.values()) if (r.supersedes) supersededIds.add(r.supersedes)
1560
- }
1561
1587
  const shape = (c ) =>
1562
1588
  recordScore(c.recallScore, c.record.importance, c.record.accessCount, c.record.lastAccessedAt, {
1563
1589
  now,
1564
1590
  halfLifeDays: this.cfg.halfLifeDays,
1565
- superseded: supersededIds.has(c.record.id),
1591
+ superseded: retired.has(c.record.id),
1566
1592
  })
1567
1593
 
1568
1594
  // 稳定 tie-break:同分时 session > project > 自定义 > global,再同分按 record id ——
@@ -1657,9 +1683,12 @@ export class LocalMemoryService {
1657
1683
  text: input.text,
1658
1684
  scopes,
1659
1685
  topK: input.topK ?? 20,
1686
+ // 面板是**历史浏览器**:退役/过期记录也要能搜到,否则用户无法从面板确认旧版本。
1687
+ includeSuperseded: true,
1688
+ includeExpired: true,
1660
1689
  vector,
1661
1690
  touch: false,
1662
- } )
1691
+ } )
1663
1692
  // 嵌入请求失败会被 EmbedClient 熔断(markDown),所以"跑完还健康"就等于向量通道
1664
1693
  // 真的产出了分数;否则这次只能算词法排序。
1665
1694
  const vectorRan = vector && this.embed.isHealthy
@@ -1718,18 +1747,29 @@ export class LocalMemoryService {
1718
1747
  * 一律走 `peek`,所以列一个不存在的 scope 只会得到空数组,不会造出文件。
1719
1748
  */
1720
1749
  async list(input = {}) {
1750
+ const internal = input
1721
1751
  const wanted = (input.scope !== undefined
1722
1752
  ? [input.scope]
1723
1753
  : (input.scopes ?? []).length > 0
1724
1754
  ? input.scopes
1725
1755
  : [this.defaultProjectScope]).map((scope) => this.canonicalScope(scope))
1726
1756
  const seen = new Set ()
1727
- let records = []
1757
+ const stores = []
1728
1758
  for (const scope of wanted) {
1729
1759
  if (seen.has(scope)) continue
1730
1760
  seen.add(scope)
1731
1761
  const store = this.store.peek(scope)
1732
- if (store) records.push(...store.records.values())
1762
+ if (store) stores.push(store)
1763
+ }
1764
+ const retired = internal.includeSuperseded ? new Set () : new Set(this.supersededIds(wanted))
1765
+ const now = Date.now()
1766
+ let records = []
1767
+ for (const store of stores) {
1768
+ for (const rec of store.records.values()) {
1769
+ if (retired.has(rec.id)) continue
1770
+ if (internal.includeExpired !== true && rec.expiredAt !== undefined && rec.expiredAt < now) continue
1771
+ records.push(rec)
1772
+ }
1733
1773
  }
1734
1774
  if (input.kind) records = records.filter((r) => r.kind === input.kind)
1735
1775
  records.sort((a, b) => b.updatedAt - a.updatedAt)
@@ -1771,6 +1811,8 @@ export class LocalMemoryService {
1771
1811
 
1772
1812
 
1773
1813
 
1814
+
1815
+
1774
1816
  ) {
1775
1817
  const normalized = normalizeScopeInput(input.scope)
1776
1818
  if (!normalized.ok) throw memoryError('SCOPE_INVALID', normalized.message)
@@ -1783,7 +1825,9 @@ export class LocalMemoryService {
1783
1825
  content: String(input.content ?? ''),
1784
1826
  ...(input.tags !== undefined ? { tags: input.tags } : {}),
1785
1827
  ...(input.importance !== undefined ? { importance: input.importance } : {}),
1786
- })
1828
+ ...(input.ttlMs !== undefined ? { ttlMs: input.ttlMs } : {}),
1829
+ ...(input.expiresAt !== undefined ? { expiresAt: input.expiresAt } : {}),
1830
+ } )
1787
1831
  }
1788
1832
 
1789
1833
  /**
@@ -33,6 +33,19 @@
33
33
 
34
34
 
35
35
 
36
+ /** 状态型记忆(kind=state)的默认有效期。过期后默认隐藏,但 memory_get 仍可取。 */
37
+
38
+                   
39
+
40
+
41
+
42
+ /** 流程索引:系统提示里按当前工作区/触发词列出的 procedure 目录。 */
43
+
44
+
45
+
46
+
47
+
48
+
36
49
 
37
50
                        
38
51
 
@@ -94,15 +107,21 @@ export const DEFAULT_AUTO_RECALL_TAGS = [
94
107
 
95
108
 
96
109
 
110
+
111
+
97
112
 
98
113
 
99
114
 
100
115
 
116
+ export const DEFAULT_STATE_TTL_MS = 7 * 86_400_000
117
+
101
118
  export const defaultInjectSettings = {
102
119
  recall: { enabled: true, topK: 5, tokenBudget: 500 },
103
120
  digest: { enabled: true, topK: 8, tokenBudget: 800, hintBudget: 160, hintMaxItems: 6 },
104
121
  impression: { enabled: true, chars: 120 },
105
122
  policy: { enabled: true },
123
+ state: { ttlMs: DEFAULT_STATE_TTL_MS },
124
+ procedures: { enabled: true, maxItems: 10, tokenBudget: 500 },
106
125
  rules: { enabled: true, maxItems: 10, tokenBudget: 300, delta: true },
107
126
  autoRecall: {
108
127
  enabled: true,
@@ -148,10 +167,15 @@ export function normalizeInjectSettings(raw , base = def
148
167
  const digest = section('digest')
149
168
  const impression = section('impression')
150
169
  const policy = section('policy')
170
+ const state = section('state')
171
+ const procedures = section('procedures')
151
172
  const rules = section('rules')
152
173
  const autoRecall = section('autoRecall')
153
174
  const turnEnd = section('turnEnd')
154
175
  const sidebar = section('sidebar')
176
+ // 兼容方案里的 `inject.stateTtlMs` 写法;新配置统一放到 state.ttlMs。
177
+ const legacyStateTtl = (r ).stateTtlMs
178
+ const stateTtlInput = state.ttlMs ?? legacyStateTtl
155
179
  const rawTags = Array.isArray(autoRecall.tags) ? autoRecall.tags : base.autoRecall.tags
156
180
  const normalizedTags = []
157
181
  const seenTags = new Set ()
@@ -182,6 +206,14 @@ export function normalizeInjectSettings(raw , base = def
182
206
  chars: clampInt(impression.chars, 40, 800, base.impression.chars),
183
207
  },
184
208
  policy: { enabled: bool(policy.enabled, base.policy.enabled) },
209
+ state: {
210
+ ttlMs: clampInt(stateTtlInput, 60_000, 365 * 86_400_000, base.state.ttlMs),
211
+ },
212
+ procedures: {
213
+ enabled: bool(procedures.enabled, base.procedures.enabled),
214
+ maxItems: clampInt(procedures.maxItems, 1, 30, base.procedures.maxItems),
215
+ tokenBudget: clampInt(procedures.tokenBudget, 50, 4000, base.procedures.tokenBudget),
216
+ },
185
217
  rules: {
186
218
  enabled: bool(rules.enabled, base.rules.enabled),
187
219
  maxItems: clampInt(rules.maxItems, 1, 40, base.rules.maxItems),
@@ -781,6 +781,9 @@ export class MemoryStore {
781
781
  rec.accessCount += 1
782
782
  rec.importance = Math.max(rec.importance, input.importance ?? defaults.importance)
783
783
  if (input.supersedes) rec.supersedes = input.supersedes
784
+ // 同一内容重写 = 刷新状态:TLL 重新计时;显式去掉过期时间时一并清掉。
785
+ if (input.expiredAt !== undefined) rec.expiredAt = input.expiredAt
786
+ else delete rec.expiredAt
784
787
  s.insert(rec) // 去重命中的也是一次写:进增量,flush 时落盘
785
788
  return { record: rec, deduped: true }
786
789
  }
@@ -151,6 +151,10 @@ function resolveScope(
151
151
 
152
152
 
153
153
 
154
+                          
155
+
156
+                       
157
+
154
158
 
155
159
 
156
160
 
@@ -177,15 +181,17 @@ function resolveWorkspacePath(raw , agent ) {
177
181
  export function memorySaveTool(opts ) {
178
182
  return {
179
183
  name: 'memory_save',
180
- description: 'Save a durable memory (fact, decision, preference, procedure, rule) for future sessions.',
184
+ description: 'Save a durable memory (fact, decision, preference, procedure, rule, state) for future sessions.',
181
185
  parameters: {
182
186
  content: { type: 'string', description: 'Self-contained declarative sentence, readable without context', required: true },
183
187
  scope: { type: 'string', description: `${SCOPE_DESCRIPTION};配合 path 时表示该工作区作用域的显示名(别名)` },
184
188
  path: { type: 'string', description: '工作区目录路径;给出后写入 project:<路径>,此时 scope 用作该作用域的显示名(别名,可省略 = 用路径本身)' },
185
- kind: { type: 'string', enum: ['fact', 'decision', 'preference', 'procedure', 'note', 'rule'] },
189
+ kind: { type: 'string', enum: ['fact', 'decision', 'preference', 'procedure', 'note', 'rule', 'state'] },
186
190
  tags: { type: 'array', items: { type: 'string' } },
187
191
  importance: { type: 'number', description: '0~1, higher = more important' },
188
192
  supersedes: { type: 'string', description: 'Record id this corrects/replaces' },
193
+ expiresAt: { type: 'number', description: '过期时间(毫秒时间戳)。kind=state 不传时按设置里的默认 TTL(7 天)' },
194
+ ttlMs: { type: 'number', description: '相对有效期(毫秒)。与 expiresAt 二选一,expiresAt 优先' },
189
195
  },
190
196
  async execute(args , exec ) {
191
197
  const service = svc(opts)
@@ -233,6 +239,8 @@ export function memorySaveTool(opts )
233
239
  ...(args.tags ? { tags: args.tags } : {}),
234
240
  ...(args.importance !== undefined ? { importance: args.importance } : {}),
235
241
  ...(args.supersedes ? { supersedes: args.supersedes } : {}),
242
+ ...(typeof args.expiresAt === 'number' ? { expiresAt: args.expiresAt } : {}),
243
+ ...(typeof args.ttlMs === 'number' ? { ttlMs: args.ttlMs } : {}),
236
244
  source: { origin: 'explicit' },
237
245
  })
238
246
  return { id: record.id, scope: record.scope, ...(alias !== undefined ? { scopeName: alias } : {}), deduped: false }
@@ -247,6 +255,8 @@ export function memorySaveTool(opts )
247
255
 
248
256
 
249
257
 
258
+                         
259
+
250
260
 
251
261
 
252
262
 
@@ -270,6 +280,7 @@ export function memorySearchTool(opts )
270
280
  query: { type: 'string', required: true },
271
281
  scope: { type: 'string', description: SCOPE_DESCRIPTION },
272
282
  topK: { type: 'number', description: '1~20' },
283
+ includeSuperseded: { type: 'boolean', description: '默认 false;true 时把已被 supersede 的旧版本也返回(历史核对)' },
273
284
  },
274
285
  async execute(args , exec ) {
275
286
  const service = svc(opts)
@@ -292,6 +303,7 @@ export function memorySearchTool(opts )
292
303
  ...(resolved.scope !== undefined ? { scope: resolved.scope } : {}),
293
304
  ...(scopes !== undefined ? { scopes } : {}),
294
305
  ...(args.topK !== undefined ? { topK: args.topK } : {}),
306
+ ...(args.includeSuperseded === true ? { includeSuperseded: true } : {}),
295
307
  })
296
308
  return {
297
309
  records: hits.map((h) => ({
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@restregular/dsh-memory",
3
- "version": "0.14.7",
3
+ "version": "0.15.0",
4
4
  "description": "DeepSeek Harness 记忆系统(单包单入口):JSONL 存储 + 本地向量检索(BGE-M3)+ 五个模型工具 + 自动召回注入 + 管理面板。",
5
5
  "icon": "./icon.svg",
6
6
  "type": "module",