@restregular/dsh-memory 0.15.0 → 0.15.1

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,19 @@
2
2
 
3
3
  本项目的版本记录。安装 id 与 npm 版本一一对应。
4
4
 
5
+ ## 0.15.1 — 流程索引:procedure 目录进入系统提示
6
+
7
+ 0.15.0 的流程记忆只能等模型主动 `memory_search`。这一版把「这个工作区有哪些流程」提前放进系统提示,
8
+ 但仍不复制正文:
9
+
10
+ - 新增 `kind=procedure` 的**触发词** `triggers`(工具名 / 关键词 / 路径;缺省用 `tags`),`memory_save` 与面板新建 / 编辑都可写。
11
+ - 系统提示新增 `memory:procedures` 段:当前工作区的流程总是可见;其他作用域的流程必须命中
12
+ 本轮用户消息、本会话最近用过的工具名或当前项目路径。每行只写 `id · 触发词 → 标题`,
13
+ 模型需要细节时用 `memory_get` 取全文。
14
+ - 条数(默认 10)与 token 预算(默认 500)可调;没有命中项时不注入;退役 / 过期流程不出现。
15
+ - 面板设置新增「流程索引」开关;记录详情展示触发词。
16
+ - 回归测试:工作区流程无条件出现、全局流程按 query/tool 触发、无关流程不出现;条数 / 预算 / 空结果;退役与过期过滤;系统提示 section 与 pre-step 的查询上下文连通。
17
+
5
18
  ## 0.15.0 — 去重与时效:退役记录默认隐藏、规则不进摘要、信号每轮一次、状态记忆
6
19
 
7
20
  这一版先解决评审里最扎眼的两件事:**旧结论仍在注入**和**同一批记忆从多个通道重复进入上下文**。
package/README.md CHANGED
@@ -46,6 +46,7 @@ JSONL 落盘 · 本机向量检索 · 五个模型工具 · 自动召回 · 硬
46
46
  | **印象形态** | 每轮只给每条记忆的短摘要;模型判断相关但需要细节时再 `memory_get` 取全文,省 token 也不丢信息 |
47
47
  | **硬性规则** | `kind: rule` 进系统提示常驻段;旧会话会收到新增 / 编辑提醒;超预算有明确警告,不静默丢弃 |
48
48
  | **状态记忆** | `kind: state` 默认 7 天 TTL;注入带「状态,使用前验证」;过期后默认不进检索 / 摘要 / 召回,但 `memory_get` 与面板仍可取 |
49
+ | **流程索引** | `kind: procedure` 的目录进系统提示:按当前工作区 + 触发词(工具名 / 关键词)列 `id · 触发词 → 标题`,需要时再用 `memory_get` 取全文 |
49
50
  | **可视化管理** | 记录浏览 / 搜索 / 新建 / 编辑 / 删除;**记录页可主动做语义检索**(与 `memory_search` 同一套排序);记忆树展示作用域、类型与修正链;设置改完即存;导入导出 |
50
51
  | **一键向量后端** | 面板里下载 llama.cpp 运行时与内置模型,按 CPU / 内存 / 显卡推荐;换模型自动重建向量 |
51
52
  | **跨进程安全** | 每个作用域一把写锁,锁内重新读盘再合并;多个 DSH 实例或 MCP server 共用一个 store 不丢数据 |
@@ -74,7 +75,7 @@ JSONL 落盘 · 本机向量检索 · 五个模型工具 · 自动召回 · 硬
74
75
 
75
76
  ### 设置
76
77
 
77
- 召回、摘要、印象、策略、规则、自动召回逐项开关;每个开关都有可见 label、说明和当前状态。
78
+ 召回、摘要、印象、策略、状态、流程索引、规则、自动召回逐项开关;每个开关都有可见 label、说明和当前状态。
78
79
  修改立即写入 `settings.json`,不需要点保存。
79
80
 
80
81
  ![记忆设置](https://raw.githubusercontent.com/RestRegular/dsh-memory/main/preview/memory-settings.png)
@@ -153,6 +154,7 @@ memory_save({
153
154
  "content": "本仓库用 pnpm 11 安装依赖;PATH 上的 pnpm 10 会报 ERR_PNPM_UNEXPECTED_STORE。",
154
155
  "kind": "procedure", // fact / decision / preference / procedure / note / rule / state
155
156
  "tags": ["pnpm", "toolchain"],
157
+ "triggers": ["pnpm", "install"], // 可选:流程索引按工具名/关键词匹配;缺省用 tags
156
158
  "importance": 0.8, // 0~1
157
159
  "expiresAt": 1793836800000, // 可选:过期时间(ms);kind=state 不传时按默认 TTL(7 天),也可传 ttlMs
158
160
  "path": "D:/repositories/dsh-memory" // 可选:写入 project:<该路径>
@@ -201,6 +203,7 @@ memory_forget({ "id": "3f2a9c1d" }) // 按内容删:memory_forget({ q
201
203
  | `digest` | 会话第一步 | 注入项目 + global 概览:按重要度 × 新鲜度挑选;`kind=rule` 不进摘要(已常驻系统提示);正文超预算时附可检索的标签索引 |
202
204
  | `policy` | 系统提示常驻 | 什么时候查记忆、查到怎么复用、查不到时低风险推断 / 高风险先问用户 |
203
205
  | `rules` | 系统提示常驻 | `kind: rule` 的硬性规则,限量与预算;`mandatory` / `pinned` 排在最前 |
206
+ | `procedures` | 系统提示常驻 | `kind: procedure` 的目录:当前工作区 + 触发词命中的流程,每行 `id · 触发词 → 标题`;正文按需 `memory_get` |
204
207
  | `turnEnd` | 每轮结束(默认关) | 下一轮开头提醒「有可复用结论先落盘」 |
205
208
  | 行为召回 | 可见文本 / 任务 / 命令 / 工具失败 | 命中标签后,在**下一个** `agent/pre-step` 定向检索;工具失败优先用该工具自己的 description |
206
209
 
@@ -214,6 +217,14 @@ memory_forget({ "id": "3f2a9c1d" }) // 按内容删:memory_forget({ q
214
217
  的规则快照」与当前规则:新增、以及编辑过(同一 id 的行变了)的规则都补一条提醒,没变化不重复;
215
218
  宿主重启用历史里的规则行做种子,不会整批重提醒。关掉它只停提醒,常驻段与检索照旧。
216
219
 
220
+ ### 流程索引(procedure)
221
+
222
+ 流程通常很长,全部常驻会挤爆系统提示;而注入发生在 `agent/pre-step`,模型决定调用工具之前拿不到工具名。
223
+ 所以系统提示里只放一个**目录**:当前工作区的 `procedure` 总是可见;其他作用域的流程必须命中
224
+ `triggers`(缺省用 `tags`),匹配源是本轮用户消息、本会话最近调用过的工具名和当前项目路径。
225
+ 每行是 `id · 触发词 → 标题`,模型判断相关后用 `memory_get` 取全文。条数与 token 预算可在设置里调;
226
+ 没有命中项时不注入。
227
+
217
228
  ### 去重与修正
218
229
 
219
230
  - 召回按 **sessionId + 记忆 id / 版本** 去重;只给过标签的记录,任务命中后可补正文;内容更新会重新评估。
package/lib/client.js CHANGED
@@ -808,6 +808,7 @@ window.__ModuleLoader__.load({
808
808
  const [content, setContent] = React.useState(rec.content)
809
809
  const [kind, setKind] = React.useState(rec.kind)
810
810
  const [tags, setTags] = React.useState(rec.tags.join(', '))
811
+ const [triggers, setTriggers] = React.useState((rec.triggers ?? []).join(', '))
811
812
  const [importance, setImportance] = React.useState(rec.importance)
812
813
  const [ttlDays, setTtlDays] = React.useState(
813
814
  rec.expiredAt ? Math.max(1, Math.round((Number(rec.expiredAt) - Date.now()) / 86_400_000)) : 7,
@@ -851,6 +852,7 @@ window.__ModuleLoader__.load({
851
852
  kind,
852
853
  importance: Number(importance) || 0,
853
854
  tags: tags.split(',').map((t) => t.trim()).filter(Boolean),
855
+ ...(kind === 'procedure' ? { triggers: triggers.split(',').map((t) => t.trim()).filter(Boolean) } : {}),
854
856
  ...(kind === 'state' ? { ttlMs: Math.max(1, Number(ttlDays) || 7) * 86_400_000 } : {}),
855
857
  })
856
858
  setEditing(false)
@@ -868,6 +870,7 @@ window.__ModuleLoader__.load({
868
870
  setEditing(false)
869
871
  setContent(rec.content); setKind(rec.kind)
870
872
  setTags(rec.tags.join(', ')); setImportance(rec.importance)
873
+ setTriggers((rec.triggers ?? []).join(', '))
871
874
  setTtlDays(rec.expiredAt ? Math.max(1, Math.round((Number(rec.expiredAt) - Date.now()) / 86_400_000)) : 7)
872
875
  }
873
876
 
@@ -931,6 +934,9 @@ window.__ModuleLoader__.load({
931
934
  onChange: (next) => setKind(next),
932
935
  }),
933
936
  h('input', { type: 'text', style: { width: 170 }, value: tags, placeholder: '标签, 逗号分隔', onChange: (e) => setTags(e.target.value) }),
937
+ kind === 'procedure'
938
+ ? h('input', { type: 'text', style: { width: 170 }, value: triggers, placeholder: '触发词(工具名/关键词)', onChange: (e) => setTriggers(e.target.value) })
939
+ : null,
934
940
  h('label', null, '重要度 ',
935
941
  h('input', { type: 'number', min: 0, max: 1, step: 0.1, value: importance, onChange: (e) => setImportance(e.target.value) })),
936
942
  kind === 'state'
@@ -953,6 +959,12 @@ window.__ModuleLoader__.load({
953
959
  rec.tags && rec.tags.length > 0
954
960
  ? h('div', { className: 'tags' }, rec.tags.map((tag) => h('span', { className: 'tag', key: tag }, tag)))
955
961
  : null,
962
+ rec.triggers && rec.triggers.length > 0
963
+ ? h('div', { className: 'tags' },
964
+ h('span', { className: 'meta-label' }, '触发'),
965
+ rec.triggers.map((trigger) => h('span', { className: 'tag', key: trigger }, trigger)),
966
+ )
967
+ : null,
956
968
  rec.expiredAt
957
969
  ? h('div', { className: 'meta' },
958
970
  h('span', { className: 'meta-label' }, '过期'),
@@ -1101,6 +1113,12 @@ window.__ModuleLoader__.load({
1101
1113
  rec.tags && rec.tags.length > 0
1102
1114
  ? h('div', { className: 'td-tags' }, rec.tags.map((tag) => h('span', { className: 'tag', key: tag }, tag)))
1103
1115
  : null,
1116
+ rec.triggers && rec.triggers.length > 0
1117
+ ? h('div', { className: 'td-tags' },
1118
+ h('span', { className: 'meta-label' }, '触发'),
1119
+ rec.triggers.map((trigger) => h('span', { className: 'tag', key: trigger }, trigger)),
1120
+ )
1121
+ : null,
1104
1122
  h('div', { className: 'td-meta' },
1105
1123
  h('div', { className: 'rowline' },
1106
1124
  h('span', null, '重要度'),
@@ -1843,6 +1861,16 @@ window.__ModuleLoader__.load({
1843
1861
  { k: 'delta', label: '变更提醒', type: 'bool', hint: '旧会话在下一轮第一步补一条新增 / 编辑过的规则;没变化不重复。' },
1844
1862
  ],
1845
1863
  },
1864
+ {
1865
+ key: 'procedures', title: '流程索引',
1866
+ desc: '把当前工作区与任务触发词命中的 procedure 列成目录(id · 触发词 → 标题),需要细节时模型用 memory_get 取全文。',
1867
+ hint: '只在系统提示里占几行,不复制流程正文;没有命中项时不注入。',
1868
+ fields: [
1869
+ { k: 'enabled', label: '启用', type: 'bool', hint: '关闭后流程只能靠 memory_search 主动检索。' },
1870
+ { k: 'maxItems', label: '最多条数', type: 'num', min: 1, max: 30, step: 1, hint: '流程索引最多列几条。' },
1871
+ { k: 'tokenBudget', label: 'token 预算', type: 'num', min: 50, max: 4000, step: 50, hint: '流程索引的 token 上限。' },
1872
+ ],
1873
+ },
1846
1874
  {
1847
1875
  key: 'autoRecall', title: '自动召回',
1848
1876
  desc: '从可见文本(assistant 输出、任务清单、命令 / 工具描述、失败信息)匹配记忆标签,命中即检索。',
@@ -2107,6 +2135,7 @@ window.__ModuleLoader__.load({
2107
2135
  const [kind, setKind] = React.useState('note')
2108
2136
  const [content, setContent] = React.useState('')
2109
2137
  const [tags, setTags] = React.useState('')
2138
+ const [triggers, setTriggers] = React.useState('')
2110
2139
  const [importance, setImportance] = React.useState(0.6)
2111
2140
  const [ttlDays, setTtlDays] = React.useState(7)
2112
2141
  const [busy, setBusy] = React.useState(false)
@@ -2129,6 +2158,7 @@ window.__ModuleLoader__.load({
2129
2158
  kind,
2130
2159
  content,
2131
2160
  tags: tags.split(',').map((t) => t.trim()).filter(Boolean),
2161
+ ...(kind === 'procedure' ? { triggers: triggers.split(',').map((t) => t.trim()).filter(Boolean) } : {}),
2132
2162
  importance: Number(importance),
2133
2163
  ...(kind === 'state' ? { ttlMs: Math.max(1, Number(ttlDays) || 7) * 86_400_000 } : {}),
2134
2164
  })
@@ -2170,6 +2200,13 @@ window.__ModuleLoader__.load({
2170
2200
  type: 'text', style: { width: 190 }, placeholder: '逗号分隔,例如 pnpm, 工具链',
2171
2201
  value: tags, onChange: (e) => setTags(e.target.value),
2172
2202
  })),
2203
+ kind === 'procedure'
2204
+ ? h('label', { className: 'set-field' }, '触发词 ',
2205
+ h('input', {
2206
+ type: 'text', style: { width: 190 }, placeholder: '工具名 / 关键词,例如 npm, deploy',
2207
+ value: triggers, onChange: (e) => setTriggers(e.target.value),
2208
+ }))
2209
+ : null,
2173
2210
  h('label', null, '重要度 ',
2174
2211
  h('input', { type: 'number', min: 0, max: 1, step: 0.1, value: importance, onChange: (e) => setImportance(e.target.value) })),
2175
2212
  kind === 'state'
@@ -40,6 +40,7 @@ import {
40
40
 
41
41
  } from './inject.js'
42
42
  import { renderDigest, } from './digest.js'
43
+ import { renderProcedureIndex } from './procedures.js'
43
44
  import { renderRules, } from './rules.js'
44
45
  import { RulesDeltaInjector } from './rules-delta.js'
45
46
  import { POLICY_TEXT } from './policy.js'
@@ -133,6 +134,9 @@ export function apply(ctx , config = {}) {
133
134
  const tagCache = new Map ()
134
135
  /** 系统提示 rules 段的同源渲染缓存:pre-step 算一次,section 回调复用。 */
135
136
  const rulesCache = new Map ()
137
+ /** 流程索引的匹配上下文:最近一次用户消息 + 最近调用过的工具名。 */
138
+ const procedureQuery = new Map ()
139
+ const procedureTools = new Map ()
136
140
  const rulesStepStart = new Map ()
137
141
  let systemPromptReady = false
138
142
  let attachedMemory = null
@@ -197,6 +201,15 @@ export function apply(ctx , config = {}) {
197
201
  }
198
202
  }
199
203
 
204
+ /** 记录本会话最近用过的工具名,给流程索引做触发词匹配。 */
205
+ const rememberProcedureTool = (sessionId , tool ) => {
206
+ const recent = procedureTools.get(sessionId) ?? []
207
+ if (recent[recent.length - 1] === tool) return
208
+ recent.push(tool)
209
+ if (recent.length > 12) recent.shift()
210
+ procedureTools.set(sessionId, recent)
211
+ }
212
+
200
213
  const excludedIds = (memory , scopes ) => {
201
214
  try {
202
215
  return new Set(memory.supersededIds?.(scopes === undefined ? undefined : [...scopes]) ?? [])
@@ -398,6 +411,8 @@ export function apply(ctx , config = {}) {
398
411
  sessionAutoScopes.delete(sessionId)
399
412
  rulesCache.delete(sessionId)
400
413
  rulesStepStart.delete(sessionId)
414
+ procedureQuery.delete(sessionId)
415
+ procedureTools.delete(sessionId)
401
416
  for (const key of tagCache.keys()) if (key.startsWith(`${sessionId}|`)) tagCache.delete(key)
402
417
  callMeta.clear()
403
418
  return
@@ -412,6 +427,7 @@ export function apply(ctx , config = {}) {
412
427
 
413
428
  if (type === 'tool/call') {
414
429
  const tool = typeof data.name === 'string' ? data.name : 'tool'
430
+ rememberProcedureTool(sessionId, tool)
415
431
  const callId = typeof data.callId === 'string' ? data.callId : undefined
416
432
  const args = typeof data.arguments === 'string'
417
433
  ? data.arguments
@@ -511,6 +527,29 @@ export function apply(ctx , config = {}) {
511
527
  return rendered.render.text
512
528
  },
513
529
  })
530
+ systemPrompt.section({
531
+ name: 'memory:procedures',
532
+ order: 655,
533
+ text: (context ) => {
534
+ if (!enabled || !settingsOf().procedures.enabled) return ''
535
+ const memory = ctx.get('memory')
536
+ if (!memory?.listSync) return ''
537
+ const scopes = promptScopesFor(memory, context?.agent)
538
+ const sessionId = sessionIdOf(context?.agent)
539
+ let records = []
540
+ try {
541
+ records = memory.listSync({ scopes: [...scopes], kind: 'procedure', limit: 200 })
542
+ } catch {
543
+ return ''
544
+ }
545
+ const rendered = renderProcedureIndex(records, settingsOf().procedures, {
546
+ ...(sessionId !== undefined && procedureQuery.has(sessionId) ? { query: procedureQuery.get(sessionId) } : {}),
547
+ ...(sessionId !== undefined && procedureTools.has(sessionId) ? { tools: procedureTools.get(sessionId) } : {}),
548
+ projectScopes: scopes.filter((scope) => scope.startsWith('project:')),
549
+ })
550
+ return rendered?.text ?? ''
551
+ },
552
+ })
514
553
  systemPromptReady = true
515
554
  } catch {
516
555
  /* 重复注册或老宿主没有 section 契约:规则段缺席不影响注入 */
@@ -558,6 +597,7 @@ export function apply(ctx , config = {}) {
558
597
  let usableSignal = autoScopes === undefined ? undefined : signal
559
598
  const turnKey = turn ?? step
560
599
  const userQuery = pickQueryText(input.messages )
600
+ if (sessionId !== undefined && userQuery !== '') procedureQuery.set(sessionId, userQuery)
561
601
  const phase = detectPhase(userQuery)
562
602
  const userQueryField = sanitizeAuditText(userQuery)
563
603
  const auditBase = (channel , extra ) => ({
@@ -0,0 +1,188 @@
1
+ /**
2
+ * 流程索引:系统提示里的「相关流程」目录。
3
+ *
4
+ * 为什么不直接注入 procedure 全文:
5
+ * - 流程通常很长,全部常驻会挤爆系统提示;
6
+ * - 注入点在 agent/pre-step,模型决定调用工具之前拿不到工具名;
7
+ * - 所以这里只给"当前工作区 + 任务/工具触发词"命中的流程目录,每行
8
+ * `id · 触发词 → 标题`;模型需要细节时用 memory_get 取全文。
9
+ *
10
+ * 匹配口径:
11
+ * - 当前工作区的 procedure 总是可见(工作区本身就是触发条件);
12
+ * - 其它 scope(global/session/自定义)必须命中 triggers,没有 triggers 时用 tags;
13
+ * - 既没有 triggers/tags 又不在当前工作区的流程不出现,避免把无关项目带进来。
14
+ */
15
+
16
+ import { estimateTokens } from '../provider/rerank.js'
17
+
18
+ import { supersededIds } from './digest.js'
19
+ import { textHasTag } from './signals.js'
20
+
21
+ export const PROCEDURES_HEADER =
22
+ '以下是当前工作区 / 任务相关的流程索引(按需用 memory_get <id> 取全文):'
23
+
24
+
25
+                           
26
+
27
+              
28
+
29
+          
30
+
31
+
32
+
33
+
34
+
35
+
36
+
37
+
38
+
39
+
40
+
41
+
42
+
43
+
44
+
45
+
46
+
47
+
48
+
49
+
50
+
51
+
52
+
53
+
54
+
55
+
56
+ function triggersOf(record ) {
57
+ const raw = (record ).triggers
58
+ if (!Array.isArray(raw)) return []
59
+ const out = []
60
+ const seen = new Set ()
61
+ for (const value of raw) {
62
+ if (typeof value !== 'string') continue
63
+ const term = value.trim()
64
+ if (term === '') continue
65
+ const key = term.toLowerCase()
66
+ if (seen.has(key)) continue
67
+ seen.add(key)
68
+ out.push(term)
69
+ }
70
+ return out
71
+ }
72
+
73
+ /** 触发词:显式 triggers 优先,没有就用 tags。 */
74
+ export function procedureTerms(record ) {
75
+ const triggers = triggersOf(record)
76
+ if (triggers.length > 0) return triggers
77
+ return (record.tags ?? []).map((tag) => String(tag).trim()).filter((tag) => tag !== '')
78
+ }
79
+
80
+ function titleOf(record ) {
81
+ return record.content.replace(/\s+/g, ' ').trim().slice(0, 80)
82
+ }
83
+
84
+ /** 一行目录:ID · 触发词 → 标题。不复制正文。 */
85
+ export function procedureLine(record ) {
86
+ const terms = procedureTerms(record).slice(0, 3)
87
+ const trigger = terms.length > 0 ? terms.join('/') : '流程'
88
+ return `- \`${record.id.slice(0, 8)}\` · ${trigger} → ${titleOf(record)}`
89
+ }
90
+
91
+ function matches(record , terms , haystack ) {
92
+ if (terms.length === 0) return false
93
+ return terms.some((term) => textHasTag(haystack, term))
94
+ }
95
+
96
+ /**
97
+ * 渲染流程索引。没有命中项时返回 null(系统提示 section 用空串表示不注入)。
98
+ */
99
+ export function renderProcedureIndex(
100
+ records ,
101
+ cfg ,
102
+ context = {},
103
+ ) {
104
+ if (!cfg.enabled) return null
105
+ const now = context.now ?? Date.now()
106
+ const retired = supersededIds(records)
107
+ const projectScopes = new Set(context.projectScopes ?? [])
108
+ const haystack = [
109
+ context.query ?? '',
110
+ ...(context.tools ?? []),
111
+ ...projectScopes,
112
+ ].join(' ')
113
+
114
+ const candidates = []
115
+ const omitted = []
116
+ for (const record of records) {
117
+ if (record.kind !== 'procedure') continue
118
+ if (retired.has(record.id)) continue
119
+ if (record.expiredAt !== undefined && record.expiredAt < now) continue
120
+ candidates.push(record)
121
+ }
122
+
123
+ const matched = []
124
+ for (const record of candidates) {
125
+ const terms = procedureTerms(record)
126
+ const isProject = projectScopes.has(record.scope)
127
+ if (isProject || matches(record, terms, haystack)) matched.push(record)
128
+ else omitted.push({ id: record.id, reason: 'unmatch' })
129
+ }
130
+
131
+ // 当前工作区优先,其次重要度 / 新鲜度;稳定排序保证同一输入同样输出。
132
+ const ordered = [...matched].sort(
133
+ (a, b) =>
134
+ Number(projectScopes.has(b.scope)) - Number(projectScopes.has(a.scope)) ||
135
+ b.importance - a.importance ||
136
+ b.updatedAt - a.updatedAt ||
137
+ a.content.localeCompare(b.content),
138
+ )
139
+
140
+ let tokens = estimateTokens(PROCEDURES_HEADER) + 4
141
+ const lines = []
142
+ const ids = []
143
+ let omittedTopK = 0
144
+ let omittedBudget = 0
145
+ let budgetExhausted = false
146
+ for (const [index, record] of ordered.entries()) {
147
+ if (index >= cfg.maxItems) {
148
+ omittedTopK += 1
149
+ omitted.push({ id: record.id, reason: 'top_k' })
150
+ continue
151
+ }
152
+ if (budgetExhausted) {
153
+ omittedBudget += 1
154
+ omitted.push({ id: record.id, reason: 'budget' })
155
+ continue
156
+ }
157
+ const line = procedureLine(record)
158
+ const cost = estimateTokens(line) + 1
159
+ if (tokens + cost > cfg.tokenBudget) {
160
+ budgetExhausted = true
161
+ omittedBudget += 1
162
+ omitted.push({ id: record.id, reason: 'budget' })
163
+ continue
164
+ }
165
+ lines.push(line)
166
+ ids.push(record.id)
167
+ tokens += cost
168
+ }
169
+
170
+ if (lines.length === 0) return null
171
+ return {
172
+ text: `${PROCEDURES_HEADER}\n${lines.join('\n')}`,
173
+ tokens,
174
+ count: lines.length,
175
+ ids,
176
+ stats: {
177
+ candidates: candidates.length,
178
+ matched: matched.length,
179
+ injected: lines.length,
180
+ tokens,
181
+ ids,
182
+ omitted,
183
+ },
184
+ }
185
+ }
186
+
187
+
188
+ //# sourceURL=source/memory-inject/src/procedures.ts
package/lib/panel.js CHANGED
@@ -208,6 +208,7 @@ function wireRecord(rec, scopeStore, supersededBy = null) {
208
208
  accessCount: rec.accessCount ?? 0,
209
209
  supersededBy,
210
210
  supersedes: rec.supersedes ?? null,
211
+ triggers: rec.triggers ?? [],
211
212
  expiredAt: rec.expiredAt ?? null,
212
213
  expired: rec.expiredAt !== undefined && rec.expiredAt < Date.now(),
213
214
  embedded: !scopeStore.embedPending.has(rec.id) && scopeStore.vectors.has(rec.id),
@@ -578,6 +579,7 @@ async function handle(ctx, routePath, req, res) {
578
579
  ...(typeof body.importance === 'number' ? { importance: body.importance } : {}),
579
580
  ...(typeof body.ttlMs === 'number' ? { ttlMs: body.ttlMs } : {}),
580
581
  ...(typeof body.expiresAt === 'number' ? { expiresAt: body.expiresAt } : {}),
582
+ ...(Array.isArray(body.triggers) ? { triggers: body.triggers.map(String) } : {}),
581
583
  })
582
584
  console.log(`[dsh-memory-panel] 新建 ${record.kind} @ ${record.scope}: ${record.id}`)
583
585
  writeJson(res, { ok: true, value: { record } })
@@ -809,6 +811,7 @@ async function handle(ctx, routePath, req, res) {
809
811
  if (body.kind !== undefined) rec.kind = String(body.kind)
810
812
  if (body.importance !== undefined) rec.importance = Math.min(1, Math.max(0, Number(body.importance) || 0))
811
813
  if (body.tags !== undefined) rec.tags = Array.isArray(body.tags) ? body.tags.map(String) : []
814
+ if (body.triggers !== undefined) rec.triggers = Array.isArray(body.triggers) ? body.triggers.map(String) : []
812
815
  if (body.supersededBy !== undefined) rec.supersedes = body.supersededBy === null ? undefined : String(body.supersededBy)
813
816
  // 过期时间:null 清除;expiresAt 绝对时间优先;ttlMs 相对当前时间。
814
817
  if (body.expiredAt === null) delete rec.expiredAt
@@ -784,6 +784,9 @@ export class MemoryStore {
784
784
  // 同一内容重写 = 刷新状态:TLL 重新计时;显式去掉过期时间时一并清掉。
785
785
  if (input.expiredAt !== undefined) rec.expiredAt = input.expiredAt
786
786
  else delete rec.expiredAt
787
+ // 流程触发词是可编辑元数据:重写同一条流程时跟着更新。
788
+ const triggers = (input ).triggers
789
+ if (Array.isArray(triggers)) (rec ).triggers = triggers.map(String)
787
790
  s.insert(rec) // 去重命中的也是一次写:进增量,flush 时落盘
788
791
  return { record: rec, deduped: true }
789
792
  }
@@ -803,6 +806,13 @@ export class MemoryStore {
803
806
  importance: input.importance ?? defaults.importance,
804
807
  ...(input.supersedes ? { supersedes: input.supersedes } : {}),
805
808
  ...(input.expiredAt ? { expiredAt: input.expiredAt } : {}),
809
+ ...(Array.isArray((input ).triggers)
810
+ ? { triggers: ((input ).triggers ).map(String) }
811
+ : {}),
812
+ }
813
+ if (record.kind === 'state' && record.expiredAt === undefined) {
814
+ // provider 已经按默认 TTL 算出 expiredAt;这里只兜底直接调 store 的调用方。
815
+ record.expiredAt = now + 7 * 86_400_000
806
816
  }
807
817
  s.insert(record)
808
818
  return { record, deduped: false }
@@ -155,6 +155,8 @@ function resolveScope(
155
155
 
156
156
                        
157
157
 
158
+                             
159
+
158
160
 
159
161
 
160
162
 
@@ -192,6 +194,7 @@ export function memorySaveTool(opts )
192
194
  supersedes: { type: 'string', description: 'Record id this corrects/replaces' },
193
195
  expiresAt: { type: 'number', description: '过期时间(毫秒时间戳)。kind=state 不传时按设置里的默认 TTL(7 天)' },
194
196
  ttlMs: { type: 'number', description: '相对有效期(毫秒)。与 expiresAt 二选一,expiresAt 优先' },
197
+ triggers: { type: 'array', items: { type: 'string' }, description: '流程触发词(kind=procedure):工具名/关键词/路径;缺省用 tags' },
195
198
  },
196
199
  async execute(args , exec ) {
197
200
  const service = svc(opts)
@@ -241,6 +244,7 @@ export function memorySaveTool(opts )
241
244
  ...(args.supersedes ? { supersedes: args.supersedes } : {}),
242
245
  ...(typeof args.expiresAt === 'number' ? { expiresAt: args.expiresAt } : {}),
243
246
  ...(typeof args.ttlMs === 'number' ? { ttlMs: args.ttlMs } : {}),
247
+ ...(Array.isArray(args.triggers) ? { triggers: args.triggers.map(String) } : {}),
244
248
  source: { origin: 'explicit' },
245
249
  })
246
250
  return { id: record.id, scope: record.scope, ...(alias !== undefined ? { scopeName: alias } : {}), deduped: false }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@restregular/dsh-memory",
3
- "version": "0.15.0",
3
+ "version": "0.15.1",
4
4
  "description": "DeepSeek Harness 记忆系统(单包单入口):JSONL 存储 + 本地向量检索(BGE-M3)+ 五个模型工具 + 自动召回注入 + 管理面板。",
5
5
  "icon": "./icon.svg",
6
6
  "type": "module",