@restregular/dsh-memory 0.15.0 → 0.15.2
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 +18 -0
- package/README.md +12 -1
- package/lib/client.js +37 -0
- package/lib/inject/apply.js +40 -0
- package/lib/inject/procedures.js +188 -0
- package/lib/panel.js +3 -0
- package/lib/provider/index.js +15 -2
- package/lib/provider/store.js +10 -0
- package/lib/tools/index.js +4 -0
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -2,6 +2,24 @@
|
|
|
2
2
|
|
|
3
3
|
本项目的版本记录。安装 id 与 npm 版本一一对应。
|
|
4
4
|
|
|
5
|
+
## 0.15.2 — 导出 / 导入保留流程触发词与状态过期时间
|
|
6
|
+
|
|
7
|
+
- 0.15.0 / 0.15.1 新增的 `triggers` 与 `expiredAt` 之前没有进入 `exportAll`,导出再导入会把流程触发词丢掉、把状态记忆重新当成新状态(TTL 重算)。现在两者都随纯文本导出往返;`expiredAt` 导入时作为绝对时间写回,不再重算 TTL。
|
|
8
|
+
- 回归测试:状态记录的 `expiredAt` 与流程的 `triggers` 导出 → 导入到另一个 store 后逐字段一致。
|
|
9
|
+
|
|
10
|
+
## 0.15.1 — 流程索引:procedure 目录进入系统提示
|
|
11
|
+
|
|
12
|
+
0.15.0 的流程记忆只能等模型主动 `memory_search`。这一版把「这个工作区有哪些流程」提前放进系统提示,
|
|
13
|
+
但仍不复制正文:
|
|
14
|
+
|
|
15
|
+
- 新增 `kind=procedure` 的**触发词** `triggers`(工具名 / 关键词 / 路径;缺省用 `tags`),`memory_save` 与面板新建 / 编辑都可写。
|
|
16
|
+
- 系统提示新增 `memory:procedures` 段:当前工作区的流程总是可见;其他作用域的流程必须命中
|
|
17
|
+
本轮用户消息、本会话最近用过的工具名或当前项目路径。每行只写 `id · 触发词 → 标题`,
|
|
18
|
+
模型需要细节时用 `memory_get` 取全文。
|
|
19
|
+
- 条数(默认 10)与 token 预算(默认 500)可调;没有命中项时不注入;退役 / 过期流程不出现。
|
|
20
|
+
- 面板设置新增「流程索引」开关;记录详情展示触发词。
|
|
21
|
+
- 回归测试:工作区流程无条件出现、全局流程按 query/tool 触发、无关流程不出现;条数 / 预算 / 空结果;退役与过期过滤;系统提示 section 与 pre-step 的查询上下文连通。
|
|
22
|
+
|
|
5
23
|
## 0.15.0 — 去重与时效:退役记录默认隐藏、规则不进摘要、信号每轮一次、状态记忆
|
|
6
24
|
|
|
7
25
|
这一版先解决评审里最扎眼的两件事:**旧结论仍在注入**和**同一批记忆从多个通道重复进入上下文**。
|
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
|
-
|
|
78
|
+
召回、摘要、印象、策略、状态、流程索引、规则、自动召回逐项开关;每个开关都有可见 label、说明和当前状态。
|
|
78
79
|
修改立即写入 `settings.json`,不需要点保存。
|
|
79
80
|
|
|
80
81
|

|
|
@@ -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'
|
package/lib/inject/apply.js
CHANGED
|
@@ -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
|
package/lib/provider/index.js
CHANGED
|
@@ -1845,6 +1845,10 @@ export class LocalMemoryService {
|
|
|
1845
1845
|
|
|
1846
1846
|
|
|
1847
1847
|
|
|
1848
|
+
|
|
1849
|
+
|
|
1850
|
+
|
|
1851
|
+
|
|
1848
1852
|
|
|
1849
1853
|
{
|
|
1850
1854
|
this.discoverScopes()
|
|
@@ -1859,6 +1863,10 @@ export class LocalMemoryService {
|
|
|
1859
1863
|
importance: rec.importance,
|
|
1860
1864
|
createdAt: rec.createdAt,
|
|
1861
1865
|
updatedAt: rec.updatedAt,
|
|
1866
|
+
...(Array.isArray((rec ).triggers)
|
|
1867
|
+
? { triggers: ((rec ).triggers ).map(String) }
|
|
1868
|
+
: {}),
|
|
1869
|
+
...(rec.expiredAt !== undefined ? { expiredAt: rec.expiredAt } : {}),
|
|
1862
1870
|
})
|
|
1863
1871
|
}
|
|
1864
1872
|
}
|
|
@@ -1885,7 +1893,10 @@ export class LocalMemoryService {
|
|
|
1885
1893
|
const errors = []
|
|
1886
1894
|
for (const [index, raw] of list.entries()) {
|
|
1887
1895
|
try {
|
|
1888
|
-
const rec = raw
|
|
1896
|
+
const rec = raw
|
|
1897
|
+
|
|
1898
|
+
|
|
1899
|
+
|
|
1889
1900
|
const content = typeof rec.content === 'string' ? rec.content : ''
|
|
1890
1901
|
if (content.trim().length === 0) throw new Error('content 为空')
|
|
1891
1902
|
const normalized = normalizeScopeInput(typeof rec.scope === 'string' ? rec.scope : undefined)
|
|
@@ -1902,7 +1913,9 @@ export class LocalMemoryService {
|
|
|
1902
1913
|
content,
|
|
1903
1914
|
...(Array.isArray(rec.tags) ? { tags: rec.tags.map(String) } : {}),
|
|
1904
1915
|
...(typeof rec.importance === 'number' ? { importance: rec.importance } : {}),
|
|
1905
|
-
|
|
1916
|
+
...(Array.isArray(rec.triggers) ? { triggers: rec.triggers.map(String) } : {}),
|
|
1917
|
+
...(typeof rec.expiredAt === 'number' && Number.isFinite(rec.expiredAt) ? { expiresAt: rec.expiredAt } : {}),
|
|
1918
|
+
} )
|
|
1906
1919
|
imported += 1
|
|
1907
1920
|
} catch (error) {
|
|
1908
1921
|
rejected += 1
|
package/lib/provider/store.js
CHANGED
|
@@ -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 }
|
package/lib/tools/index.js
CHANGED
|
@@ -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 }
|