@restregular/dsh-memory 0.9.1 → 0.9.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/README.md +9 -1
- package/lib/client.js +2 -2
- package/lib/inject/apply.js +5 -2
- package/lib/inject/rules-delta.js +79 -21
- package/lib/inject/rules.js +4 -9
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -189,7 +189,7 @@ provider 的配置在顶层,工具 / 注入 / 面板各占一个小节(合并前
|
|
|
189
189
|
|
|
190
190
|
- **注入分四层**:`recall`(每轮按问题检索)、`digest`(会话第一步给概览)、`policy`(系统提示常驻的使用策略)、`rules`(系统提示常驻的 `kind=rule` 规则),外加 `turnEnd`(轮末提醒,默认关)。每层独立开关,`inject.enabled: false` 全关。面板改过的值写在 `<storeDir>/settings.json`,**优先级高于这里的配置**。
|
|
191
191
|
- **写规则**:`memory_save({ kind: 'rule', content: '改 lib 必须同时改 source' })`。规则会进系统提示常驻段;能机械校验的规则更适合做成钩子,提示词只负责解释。
|
|
192
|
-
- **规则变更怎么进旧会话**:系统提示段本身每步都会按 store 快照重渲染,但那只改提示词文本、不产生任何对话消息,旧会话里的模型不会主动重读;而且常驻段有 token 预算,新规则可能被更重要的旧规则挤掉。所以 `rules.delta`(默认开)
|
|
192
|
+
- **规则变更怎么进旧会话**:系统提示段本身每步都会按 store 快照重渲染,但那只改提示词文本、不产生任何对话消息,旧会话里的模型不会主动重读;而且常驻段有 token 预算,新规则可能被更重要的旧规则挤掉。所以 `rules.delta`(默认开)在一轮的第一步拿「该会话上一轮开始时的规则快照」与当前规则比:新增、以及**编辑过**(同一 id 的行变了)的规则都补一条 `source.kind='memory'` 消息,没变化的不重复;编辑即使被系统提示的刷新"抢先"也会补。旧会话重开 / 宿主重启用历史里的规则行做种子,不会整批重提醒;关掉它只影响这条提醒,常驻段照旧。
|
|
193
193
|
|
|
194
194
|
向量检索是**按配置启用**的:写了 `endpoint`、配了 `spawn`、或面板里装了本地后端才会碰网络,否则一个请求都不发,检索自动降级为纯词法(IDF + CJK bigram)。不需要自动召回就 `inject.enabled: false`。
|
|
195
195
|
|
|
@@ -321,11 +321,19 @@ tools/build-single-package.mjs 构建(产物契约检查 + 可选加载验证)
|
|
|
321
321
|
**面板里看不到「记忆」**
|
|
322
322
|
包名与 Loader entry 必须一一对应(见「为什么是一个包」)。检查 profile 的 patch 里是否只有一条 `@restregular/dsh-memory`,以及 profile 是否真的装上了这个依赖(`ls node_modules/@restregular/dsh-memory`)。
|
|
323
323
|
|
|
324
|
+
**插件列表里还是 `@restregular/dsh-memory`,没有「长期记忆」**
|
|
325
|
+
先确认版本 ≥ 0.9.1 且包里有 `locale/` 目录;然后在**重启一次 DSH 桌面端**。宿主的 Node 进程会缓存 `package.json` 的 `exports` 映射,原地更新不会让这份缓存失效:如果宿主启动时解析的是**还没有 `./locale/*.json` 导出**的旧版,`readPluginMeta` 就解析不到 locale,静默回退成包名 + `package.json` 描述(图标仍会更新,因为它是直接读文件的)。重启后恢复,之后的版本更新不再需要。
|
|
326
|
+
|
|
324
327
|
## 版本
|
|
325
328
|
|
|
329
|
+
- **0.9.2** —— 规则增量的去重口径改成「**上一轮开始时的规则快照**」:
|
|
330
|
+
- 以前按「历史里出现过的规则行」去重,而系统提示是每步重渲染的:一条规则被编辑后,如果系统提示在同一步里已经刷新成新文本,下一轮就**不会再补**,编辑等于被吞掉。
|
|
331
|
+
- 现在每个会话记住每条规则 id 在**上一轮开始时**的渲染行:新增 → 补;同一 id 的行变了(编辑)→ 补,即使系统提示已经刷新;没变 → 不补。编辑回旧文本也算"变了",会补一次。
|
|
332
|
+
- 宿主重启 / 第一次见到某个会话时没有快照,用「系统提示 + 历史增量块」里已经出现的规则行做种子,所以不会整批重提醒。
|
|
326
333
|
- **0.9.1** —— 插件列表只显示包名的问题:**加了显示名与图标**。
|
|
327
334
|
- 宿主 `readPluginMeta` 只读包内 `locale/<lang>.json` 的 `meta.title` / `meta.description`(且必须能通过 `exports` 解析),缺失就回退成包名 —— 所以插件列表里一直是 `@restregular/dsh-memory` + 一长串 `package.json` 描述。现在 `locale/zh.json` 显示「**长期记忆**」,`locale/en.json` 显示「Long-term Memory」,描述也压成一行。
|
|
328
335
|
- 图标从蓝色芯片换成**年轮**:深咖 `#3B2D20 → #120E0A` 圆角瓦片 + 香槟金 `#F8E2B4 → #BF8230` 螺旋(记忆是时间累积出来的年轮)。刻意避开插件列表里扎堆的蓝/白底,30px 行高下仍是一条完整的线。
|
|
336
|
+
- **升级后需要重启一次 DSH**:宿主的 Node 进程会缓存 `package.json` 的 `exports` 映射。如果宿主启动时解析过**没有 locale 导出**的旧版,原地更新后列表会暂时仍显示包名(图标/描述已经是新的 —— 它们直接读文件);重启一次桌面端就恢复,之后的版本更新不再需要。
|
|
329
337
|
- 构建与产物测试补了护栏:`locale` 两个文件 + `exports` 放行 + `icon.svg` 体积/格式,任何一项缺失都会构建失败(否则只会静默显示成包名)。
|
|
330
338
|
- **0.9.0** —— **规则变更会跟进旧会话**:
|
|
331
339
|
- 以前在别的会话里新加一条 `kind=rule`,旧会话继续聊时只有系统提示段的文本会刷新 —— 不产生对话消息,模型未必会重读;而且规则段有 300 token 预算,新规则可能被更重要的旧规则挤出常驻段。
|
package/lib/client.js
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
/**
|
|
1
|
+
/**
|
|
2
2
|
* dsh-memory — 客户端半边(设置页「记忆」区块)。
|
|
3
3
|
*
|
|
4
4
|
* 合并后本 bundle 与 provider / 工具 / 注入同属一个 npm 包
|
|
@@ -684,7 +684,7 @@ window.__ModuleLoader__.load({
|
|
|
684
684
|
{ k: 'enabled', label: '启用', type: 'bool' },
|
|
685
685
|
{ k: 'maxItems', label: '最多条数', type: 'num', min: 1, max: 40, step: 1 },
|
|
686
686
|
{ k: 'tokenBudget', label: 'token 预算', type: 'num', min: 50, max: 4000, step: 50 },
|
|
687
|
-
{ k: 'delta', label: '变更提醒', type: 'bool', hint: '
|
|
687
|
+
{ k: 'delta', label: '变更提醒', type: 'bool', hint: '旧会话在下一轮第一步补一条新增/编辑过的规则;没变化的不重复' },
|
|
688
688
|
],
|
|
689
689
|
},
|
|
690
690
|
{
|
package/lib/inject/apply.js
CHANGED
|
@@ -34,7 +34,7 @@ import {
|
|
|
34
34
|
} from './inject.js'
|
|
35
35
|
import { renderDigestBlock } from './digest.js'
|
|
36
36
|
import { renderRulesBlock } from './rules.js'
|
|
37
|
-
import {
|
|
37
|
+
import { RulesDeltaInjector } from './rules-delta.js'
|
|
38
38
|
import { POLICY_TEXT } from './policy.js'
|
|
39
39
|
import { normalizeInjectSettings, } from '../provider/inject-settings.js'
|
|
40
40
|
|
|
@@ -114,6 +114,9 @@ export function apply(ctx , config = {}) {
|
|
|
114
114
|
})
|
|
115
115
|
})
|
|
116
116
|
|
|
117
|
+
// 规则增量:一个激活一个实例,跨轮记住每条规则上一轮的样子(编辑后才补提醒)。
|
|
118
|
+
const rulesDelta = new RulesDeltaInjector()
|
|
119
|
+
|
|
117
120
|
// 系统提示:记忆使用策略(常驻) + 硬性规则(kind='rule')。
|
|
118
121
|
// 两者都用函数形式,面板开关/规则改动下一步就生效;文本稳定时可随前缀缓存。
|
|
119
122
|
ctx.inject(['systemPrompt'], (scoped ) => {
|
|
@@ -182,7 +185,7 @@ export function apply(ctx , config = {}) {
|
|
|
182
185
|
// `delta !== false` 而不是 `=== true`:老 provider 的 settings 快照没有这个
|
|
183
186
|
// 字段时要按"开"处理,否则升级当天等于静默关掉。
|
|
184
187
|
if (settings && step === 1 && settings.rules.enabled && settings.rules.delta !== false) {
|
|
185
|
-
const delta =
|
|
188
|
+
const delta = rulesDelta.maybeInject(agent, memory, settings.rules)
|
|
186
189
|
if (delta) parts.push(delta)
|
|
187
190
|
}
|
|
188
191
|
if (pendingNudge && step === 1) {
|
|
@@ -1,10 +1,19 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* 规则增量(0.9.
|
|
2
|
+
* 规则增量(0.9.x):旧会话继续聊之前,把「这个会话还没见过 / 已经被改过」的
|
|
3
|
+
* 硬性规则补一条消息。
|
|
3
4
|
*
|
|
4
5
|
* 为什么光刷新系统提示不够:规则段每步都会按 store 快照重渲染,但那条更新只改
|
|
5
6
|
* 系统提示文本、不产生任何对话消息 —— 模型在旧会话里接着聊时不会主动重读;
|
|
6
7
|
* 而且规则段有 token 预算,新规则还可能被更重要的旧规则挤出常驻段。
|
|
7
8
|
*
|
|
9
|
+
* 去重口径(0.9.2 起按"上一轮开始时的规则快照"而不是"历史里出现过的文本"):
|
|
10
|
+
* - 每条规则按 id 记住上一轮开始时的渲染行;
|
|
11
|
+
* - 新增规则 → 提醒;编辑过(同一 id 的行变了)→ 提醒,即使系统提示在这一轮里
|
|
12
|
+
* 已经刷新成新文本(否则"编辑后重新插入"会被系统提示的刷新吞掉);
|
|
13
|
+
* - 没变化的规则 → 不重复;编辑回旧文本算"变了",也会提醒一次。
|
|
14
|
+
* - 宿主重启 / 首次见到这个会话时没有快照,用历史(系统提示 + 历史增量块)里
|
|
15
|
+
* 已经出现的规则行做种子 —— 旧会话不会因为重启被整批重提醒。
|
|
16
|
+
*
|
|
8
17
|
* 这里只做"读会话派生历史 + 算差集 + 渲染",宿主差异(拿不到 session / 拿不到
|
|
9
18
|
* listSync)一律降级为不提醒 —— 注入路径抛错会打断整个 agent 循环。
|
|
10
19
|
*/
|
|
@@ -12,10 +21,11 @@
|
|
|
12
21
|
import {
|
|
13
22
|
latestSystemText,
|
|
14
23
|
renderRulesDeltaBlock,
|
|
24
|
+
ruleLine,
|
|
15
25
|
seenRuleLines,
|
|
16
|
-
unseenRules,
|
|
17
26
|
|
|
18
27
|
} from './rules.js'
|
|
28
|
+
import { sessionIdOf } from './inject.js'
|
|
19
29
|
|
|
20
30
|
|
|
21
31
|
/** 宿主 Session 上我们用到的那一小部分(派生历史是 surface 节点的缓存投影)。 */
|
|
@@ -29,6 +39,9 @@ import {
|
|
|
29
39
|
|
|
30
40
|
|
|
31
41
|
|
|
42
|
+
/** 每个会话最多记多少个规则快照(进程里开过的会话上界,防止 Map 无限长)。 */
|
|
43
|
+
const MAX_TRACKED_SESSIONS = 500
|
|
44
|
+
|
|
32
45
|
/** 会话的模型可见历史;老宿主 / 半个加载失败时返回 undefined。 */
|
|
33
46
|
export function derivedHistoryOf(agent ) {
|
|
34
47
|
try {
|
|
@@ -43,27 +56,72 @@ export function derivedHistoryOf(agent )
|
|
|
43
56
|
}
|
|
44
57
|
|
|
45
58
|
/**
|
|
46
|
-
*
|
|
47
|
-
*
|
|
48
|
-
* 规则范围与系统提示「硬性规则」段一致(`resolveReadScopes`,拿不到就 global),
|
|
49
|
-
* 免得提醒了本来就不该进常驻段的规则。只在一轮的第一步调用:增量消息会持久化,
|
|
50
|
-
* 每一步都算会重复;新会话(还没有系统提示)直接跳过 —— 系统提示这次就带全。
|
|
59
|
+
* 规则增量注入器。一个激活一个实例:它要跨轮记住"每条规则上一轮开始时长什么样",
|
|
60
|
+
* 才能在规则被编辑后补一次、在没变时不重复。
|
|
51
61
|
*/
|
|
52
|
-
export
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
62
|
+
export class RulesDeltaInjector {
|
|
63
|
+
/** sessionId -> (规则 id -> 上一轮开始时的渲染行) */
|
|
64
|
+
baselines = new Map ()
|
|
65
|
+
|
|
66
|
+
/**
|
|
67
|
+
* 本轮第一步的增量正文;没有新增/变更(或这是会话的第一步)时返回 undefined。
|
|
68
|
+
*
|
|
69
|
+
* 规则范围与系统提示「硬性规则」段一致(`resolveReadScopes`,拿不到就 global),
|
|
70
|
+
* 免得提醒了本来就不该进常驻段的规则。只在一轮的第一步调用:增量消息会持久化,
|
|
71
|
+
* 每一步都算会重复;新会话(还没有系统提示)直接跳过 —— 系统提示这次就带全。
|
|
72
|
+
*/
|
|
73
|
+
maybeInject(agent , memory , cfg ) {
|
|
74
|
+
const history = derivedHistoryOf(agent)
|
|
75
|
+
if (history === undefined || latestSystemText(history) === undefined) return undefined
|
|
76
|
+
let scopes = ['global']
|
|
77
|
+
try {
|
|
78
|
+
const resolved = memory.resolveReadScopes?.(agent)
|
|
79
|
+
if (Array.isArray(resolved) && resolved.length > 0) scopes = resolved
|
|
80
|
+
} catch { scopes = ['global'] }
|
|
81
|
+
let records
|
|
82
|
+
try {
|
|
83
|
+
records = memory.listSync?.({ scopes, kind: 'rule', limit: 100 }) ?? []
|
|
84
|
+
} catch {
|
|
85
|
+
return undefined
|
|
86
|
+
}
|
|
87
|
+
|
|
88
|
+
const sessionId = sessionIdOf(agent)
|
|
89
|
+
const seen = seenRuleLines(history)
|
|
90
|
+
const baseline = (sessionId === undefined ? undefined : this.baselines.get(sessionId)) ?? seedBaseline(records, seen)
|
|
91
|
+
const unseen = records.filter((record) => {
|
|
92
|
+
const line = ruleLine(record)
|
|
93
|
+
const before = baseline.get(record.id)
|
|
94
|
+
// 编辑过(同一 id 的行变了)一定要提醒;新规则只在模型还没在历史里见过时才提醒。
|
|
95
|
+
return before !== undefined ? before !== line : !seen.has(line)
|
|
96
|
+
})
|
|
97
|
+
|
|
98
|
+
if (sessionId !== undefined) this.remember(sessionId, records)
|
|
99
|
+
return renderRulesDeltaBlock(unseen, cfg) ?? undefined
|
|
100
|
+
}
|
|
101
|
+
|
|
102
|
+
remember(sessionId , records ) {
|
|
103
|
+
const snapshot = new Map ()
|
|
104
|
+
for (const record of records) snapshot.set(record.id, ruleLine(record))
|
|
105
|
+
this.baselines.delete(sessionId)
|
|
106
|
+
this.baselines.set(sessionId, snapshot)
|
|
107
|
+
if (this.baselines.size > MAX_TRACKED_SESSIONS) {
|
|
108
|
+
const oldest = this.baselines.keys().next()
|
|
109
|
+
if (!oldest.done) this.baselines.delete(oldest.value)
|
|
110
|
+
}
|
|
111
|
+
}
|
|
112
|
+
}
|
|
113
|
+
|
|
114
|
+
/**
|
|
115
|
+
* 没有跨轮快照时的种子:历史里已经出现过的规则行当作"上一轮就是这样"。
|
|
116
|
+
* 拿不到 id → 只能按行回填,规则行一致就不会提醒。
|
|
117
|
+
*/
|
|
118
|
+
function seedBaseline(records , seen ) {
|
|
119
|
+
const baseline = new Map ()
|
|
120
|
+
for (const record of records) {
|
|
121
|
+
const line = ruleLine(record)
|
|
122
|
+
if (seen.has(line)) baseline.set(record.id, line)
|
|
65
123
|
}
|
|
66
|
-
return
|
|
124
|
+
return baseline
|
|
67
125
|
}
|
|
68
126
|
|
|
69
127
|
|
package/lib/inject/rules.js
CHANGED
|
@@ -5,11 +5,11 @@
|
|
|
5
5
|
* 注意力;系统提示是每步都会看见的位置,且文本稳定时可以跟着前缀缓存。
|
|
6
6
|
* 只放"不可机械校验"的规则 —— 能写成检查的规则应该进钩子(代码强制)。
|
|
7
7
|
*
|
|
8
|
-
* 增量提醒(0.9.0):系统提示段每步都会按内存快照重渲染,但"规则是别的会话里
|
|
9
|
-
*
|
|
8
|
+
* 增量提醒(0.9.0 起):系统提示段每步都会按内存快照重渲染,但"规则是别的会话里
|
|
9
|
+
* 新加/改过的"这件事只改文本、不产生任何对话消息;模型在旧会话里继续聊时未必会
|
|
10
10
|
* 重新读一遍系统提示,而且规则段有 token 预算,新规则可能被旧规则挤出常驻段。
|
|
11
|
-
* 所以 apply.ts
|
|
12
|
-
*
|
|
11
|
+
* 所以 apply.ts 在每轮第一步把「新加/编辑过的规则」补成一条消息;这里只放纯函数:
|
|
12
|
+
* 渲染、从系统提示/历史消息里抽取规则行、判断哪些行已经出现过。
|
|
13
13
|
*/
|
|
14
14
|
|
|
15
15
|
import { estimateTokens } from '../provider/rerank.js'
|
|
@@ -130,10 +130,5 @@ export function seenRuleLines(history )
|
|
|
130
130
|
return seen
|
|
131
131
|
}
|
|
132
132
|
|
|
133
|
-
/** 还没在这个会话里出现过的规则(按常驻段同一套行格式比对)。 */
|
|
134
|
-
export function unseenRules(records , seen ) {
|
|
135
|
-
return records.filter((record) => !seen.has(ruleLine(record)))
|
|
136
|
-
}
|
|
137
|
-
|
|
138
133
|
|
|
139
134
|
//# sourceURL=source/memory-inject/src/rules.ts
|