@restregular/dsh-memory 0.35.3 → 0.36.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 +15 -0
- package/README.md +4 -2
- package/lib/inject/apply.js +22 -3
- package/lib/inject/inject.js +34 -3
- package/lib/inject/policy.js +2 -0
- package/lib/provider/index.js +13 -9
- package/lib/tools/apply.js +10 -4
- package/lib/tools/index.js +54 -3
- package/package.json +1 -1
- package/skills/memory-hook-scripts/SKILL.md +11 -0
package/CHANGELOG.md
CHANGED
|
@@ -2,6 +2,21 @@
|
|
|
2
2
|
|
|
3
3
|
本项目的版本记录。安装 id 与 npm 版本一一对应。
|
|
4
4
|
|
|
5
|
+
## 0.36.0 — supersedes 支持跨作用域修正,且必须显式带 scope
|
|
6
|
+
|
|
7
|
+
- **跨作用域修正**:此前 `memory_save.supersedes` 的旧记录按 id 精确查找时**只查新记录写入的那一个 scope**,旧记录在别的作用域一律报 `SUPERSEDES_UNKNOWN`(且文案与"id 不存在"完全一样)。现在改成跨全部作用域按完整 id 查找(`findById`):新记录可以落在任意作用域去修正另一作用域里的旧记录(project / global / session / 自定义均可)。配套把"已修正/退役"标记也改成全局收集 —— `search` / `listSync` / 自动召回的 `excludedIds` 不再只看当前搜索的 scopes,否则 global 里的修正版挡不住 project 里的旧记录。
|
|
8
|
+
- **必须显式带 scope**:带 `supersedes` 时省略 `scope`(依赖默认作用域)一律拒绝(`SUPERSEDES_SCOPE_REQUIRED`),不静默落到默认作用域造成"修错地方";`supersedes` / `scope` 两个参数的说明与常驻策略段都写清这条口径。
|
|
9
|
+
- **写权限硬门槛**:带 `supersedes` 时当前会话必须对目标作用域**已有写权限**,不足直接拒绝(`SUPERSEDES_SCOPE_NOT_WRITABLE`),不走范围外审批 —— 旧实现会把 `SCOPE_NOT_IN_RANGE` 误报成 `VISIBILITY_ABSOLUTE`。
|
|
10
|
+
- **返回提示统一带目标作用域 key**:所有 `memory_save` 的返回文案新增一行「保存到的目标作用域 key:<scope>」;`supersedes` 场景再补一条修正关系(含旧记录所在作用域)。返回值同时新增 `supersedes:{id,scope?}` 字段,文案仍以「已保存记忆 <uuid> @ <scope>」开头,`memorySaveResultIds` 按 UUID 抽取不受影响。
|
|
11
|
+
- 回归守卫:`service.test.ts` 加跨作用域修正与全局退役用例,`access.test.ts` 加缺 scope / 无写权限 / 返回值三个用例,`tools.test.ts` 与 `policy.test.ts` 锁住参数说明与常驻策略段,`apply-registration.test.ts` 静态锁住返回提示。全套 62 个测试文件在受限沙箱内逐文件跑通(0 失败)。
|
|
12
|
+
|
|
13
|
+
## 0.35.4 — 通用钩子 + 自动召回也走 before-inject
|
|
14
|
+
|
|
15
|
+
- **钩子不再必须挂到记忆上**:`memory_hooks` 的 `action:"save"` 新增可选 `ruleId` —— 不传就是**通用钩子**(不挂任何记忆,靠 `scopes` / `kinds` / `phase` 与脚本里的 `ctx` 决定何时自动执行;`scopes:[]`+`kinds:[]` 即对所有记忆生效)。传了则关联到规则记忆(报错带 id、可 memory_get 取全文)。更新时省略 = 保留旧关联。此前创建入口只有 `memory_save.hookCode`(强制关联一条规则),无法建通用钩子。
|
|
16
|
+
- **before-inject 覆盖自动召回**:此前只有规则段、摘要两条注入通道接了注入前解析,每轮按用户问题触发的自动召回没过钩子(三条通道里的漏网之鱼)。现在召回命中在渲染前过 `before-inject`:可返回 `{content}` 改写、 `{drop:true}` 丢弃(被丢的记录以 `reason:'hook'` 计入审计 omitted,不再凭空消失)。会话 id 由 injector 传给 transform;解析失败 = 没解析,记录原样进上下文,钩子坏掉不会吞掉记忆。
|
|
17
|
+
- **技能与文档同步**:`memory-hook-scripts` 补充"钩子一定要挂到记忆上吗"(两种创建方式)与三条注入通道说明。
|
|
18
|
+
- 回归守卫:`inject.test.ts` 加两条(transform 改写/丢弃 + 会话 id 传递、transform 抛错时原样注入),`hooks-tool.test.ts` 加两条(不传 ruleId 建通用钩子、显式 ruleId 关联)。全套 645 tests / 644 pass / 1 skipped。
|
|
19
|
+
|
|
5
20
|
## 0.35.3 — 钩子否决保存时自动带上关联规则 ID
|
|
6
21
|
|
|
7
22
|
- **问题**:钩子拒绝一条记忆写入时,报错只说「钩子『记忆内容规范(概括句:正文)』判定不符合要求」,模型看不到这条校验代码挂在**哪条规则记忆**上 —— 脚本的 `message` 往往只讲"缺什么",模型想按规则全文改对却无从取起。
|
package/README.md
CHANGED
|
@@ -370,9 +370,11 @@ memory_scopes({
|
|
|
370
370
|
|
|
371
371
|
| 时机 | 触发点 | 能做什么 |
|
|
372
372
|
| --- | --- | --- |
|
|
373
|
-
| `before-save` | `memory_save` 落盘前 | 返回 `{ ok: false, message: '哪里错、怎么改' }`
|
|
373
|
+
| `before-save` | `memory_save` 落盘前 | 返回 `{ ok: false, message: '哪里错、怎么改' }` **拒绝这次保存**,理由原样回给模型,它改对后重试;报错自动带上关联规则 id |
|
|
374
374
|
| `after-save` | 落盘后 | 只观察 / 附注,不改结果、不阻断 |
|
|
375
|
-
| `before-inject` | 进入上下文前 | 返回 `{ content: '改写后' }` 改写正文,`{ drop: true }`
|
|
375
|
+
| `before-inject` | 进入上下文前 | 返回 `{ content: '改写后' }` 改写正文,`{ drop: true }` 丢弃整条。覆盖**三条注入通道**:规则段、摘要、每轮自动召回 |
|
|
376
|
+
|
|
377
|
+
钩子**不必挂在记忆上**:随 `memory_save.hookCode` 保存会关联到那条规则(记 `ruleId`);用 `memory_hooks` 的 `action:"save"` 且不传 `ruleId` 则建成**通用钩子**,靠 `scopes` / `kinds` / `phase` 与脚本里的 `ctx` 决定何时自动执行。代码实际按作用域 + 类型匹配触发,`ruleId` 只作关联标注。
|
|
376
378
|
|
|
377
379
|
随规则一起登记(`memory_save` 的 `hookCode` / `hookPhase`):
|
|
378
380
|
|
package/lib/inject/apply.js
CHANGED
|
@@ -242,7 +242,24 @@ export function apply(ctx , config = {}) {
|
|
|
242
242
|
}
|
|
243
243
|
const impressionCfg = () => {
|
|
244
244
|
const settings = settingsOf().impression
|
|
245
|
-
return {
|
|
245
|
+
return {
|
|
246
|
+
impression: settings.enabled,
|
|
247
|
+
chars: settings.chars,
|
|
248
|
+
// 0.35.4:自动召回也走 before-inject 钩子 —— 之前只有规则段与摘要接了,
|
|
249
|
+
// 每轮按用户问题召回的正文没过钩子,是三个注入通道里的漏网之鱼。
|
|
250
|
+
// sessionId 由 injector 在渲染时传入(注入半边没有 agent 对象)。
|
|
251
|
+
transform: (records, sid) => {
|
|
252
|
+
const mem = ctx.get('memory')
|
|
253
|
+
if (records.length === 0 || typeof mem?.parseForInject !== 'function') return { records }
|
|
254
|
+
try {
|
|
255
|
+
const parsed = mem.parseForInject(records, sid)
|
|
256
|
+
return { records: parsed.records, droppedIds: new Set(parsed.changed.filter((c) => c.option === 'dropped').map((c) => c.id)) }
|
|
257
|
+
} catch {
|
|
258
|
+
// 解析失败 = 没解析:记录原样进上下文,不能因为钩子坏掉就少注入记忆。
|
|
259
|
+
return { records }
|
|
260
|
+
}
|
|
261
|
+
},
|
|
262
|
+
}
|
|
246
263
|
}
|
|
247
264
|
|
|
248
265
|
const extraScopes = normalizeExtraScopes(config.extraScopes ?? [])
|
|
@@ -535,9 +552,11 @@ export function apply(ctx , config = {}) {
|
|
|
535
552
|
procedureTools.set(sessionId, recent)
|
|
536
553
|
}
|
|
537
554
|
|
|
538
|
-
const excludedIds = (memory ,
|
|
555
|
+
const excludedIds = (memory , _scopes ) => {
|
|
539
556
|
try {
|
|
540
|
-
|
|
557
|
+
// 0.36.0:supersedes 支持跨作用域,修正版可能不在本次注入的 scopes 里;
|
|
558
|
+
// 退役 id 必须扫全部 scope(省略参数),否则 global 里的修正版挡不住 project 旧记录。
|
|
559
|
+
return new Set(memory.supersededIds?.() ?? [])
|
|
541
560
|
} catch {
|
|
542
561
|
return new Set()
|
|
543
562
|
}
|
package/lib/inject/inject.js
CHANGED
|
@@ -210,11 +210,19 @@ export function hasRecallMessage(
|
|
|
210
210
|
|
|
211
211
|
|
|
212
212
|
|
|
213
|
+
|
|
214
|
+
|
|
215
|
+
|
|
216
|
+
|
|
217
|
+
|
|
218
|
+
|
|
219
|
+
|
|
220
|
+
|
|
213
221
|
|
|
214
222
|
|
|
215
223
|
|
|
216
224
|
|
|
217
|
-
|
|
225
|
+
|
|
218
226
|
|
|
219
227
|
|
|
220
228
|
|
|
@@ -232,6 +240,24 @@ export function renderRecallBlock(
|
|
|
232
240
|
options = {},
|
|
233
241
|
) {
|
|
234
242
|
if (hits.length === 0) return null
|
|
243
|
+
// 0.35.4:before-inject 钩子先解析召回记录 —— 可改写正文或丢弃整条。
|
|
244
|
+
// 丢弃的要计入 omitted(审计要能解释"为什么某条没进上下文")。
|
|
245
|
+
let effectiveHits = hits
|
|
246
|
+
const droppedIds = new Set ()
|
|
247
|
+
if (options.transform !== undefined) {
|
|
248
|
+
try {
|
|
249
|
+
const transformed = options.transform(hits.map((h) => h.record), options.sessionId)
|
|
250
|
+
const byId = new Map(transformed.records.map((record) => [record.id, record]))
|
|
251
|
+
effectiveHits = hits
|
|
252
|
+
.filter((h) => byId.has(h.record.id))
|
|
253
|
+
.map((h) => ({ ...h, record: byId.get(h.record.id) }))
|
|
254
|
+
for (const id of transformed.droppedIds ?? []) droppedIds.add(id)
|
|
255
|
+
// 变换后没给 droppedIds 但记录变少了:按差集兜底。
|
|
256
|
+
if (transformed.droppedIds === undefined) {
|
|
257
|
+
for (const h of hits) if (!byId.has(h.record.id)) droppedIds.add(h.record.id)
|
|
258
|
+
}
|
|
259
|
+
} catch { /* 解析失败 = 没解析:记录原样进入上下文 */ }
|
|
260
|
+
}
|
|
235
261
|
const impression = options.impression === true
|
|
236
262
|
const chars = impression ? (options.chars ?? 120) : 300
|
|
237
263
|
const header = impression
|
|
@@ -242,7 +268,11 @@ export function renderRecallBlock(
|
|
|
242
268
|
const ids = []
|
|
243
269
|
const omitted = []
|
|
244
270
|
let budgetExhausted = false
|
|
245
|
-
|
|
271
|
+
// 被钩子丢弃的记录:审计里要给出原因,不能凭空消失。
|
|
272
|
+
for (const h of hits) {
|
|
273
|
+
if (droppedIds.has(h.record.id)) omitted.push({ id: h.record.id, reason: 'hook' })
|
|
274
|
+
}
|
|
275
|
+
for (const [index, h] of effectiveHits.entries()) {
|
|
246
276
|
if (index >= cfg.topK) {
|
|
247
277
|
omitted.push({ id: h.record.id, reason: 'top_k' })
|
|
248
278
|
continue
|
|
@@ -404,7 +434,8 @@ export class MemoryInjector {
|
|
|
404
434
|
const freshIds = new Set(fresh.map((record) => record.id))
|
|
405
435
|
const freshHits = candidates.filter((hit) => freshIds.has(hit.record.id))
|
|
406
436
|
const optionsForRender = typeof this.renderOptions === 'function' ? this.renderOptions() : this.renderOptions
|
|
407
|
-
|
|
437
|
+
// 0.35.4:把会话 id 传给 transform(before-inject 钩子按会话判断时用)。
|
|
438
|
+
const block = renderRecallBlock(freshHits, cfg, { ...optionsForRender, sessionId })
|
|
408
439
|
const base = {
|
|
409
440
|
ids: [], candidates: candidates.length, dedupSkipped: deduplicated.length, updated, omitted: [], query,
|
|
410
441
|
// 全部候选都被去重时 block 为 null;把 id 留在结果里,审计才能解释"跳过了哪条"。
|
package/lib/inject/policy.js
CHANGED
|
@@ -18,6 +18,8 @@ memory_search 只返回印象(ID、作用域、类型、标签和少量摘要
|
|
|
18
18
|
|
|
19
19
|
新建自定义作用域时,memory_save 必须带 scopeDescription(一句话用途);可选带 scopeRule 写一条初始规则。已有作用域带上 scopeDescription 表示更新用途,不会写初始记忆。
|
|
20
20
|
|
|
21
|
+
用 memory_save 的 supersedes 修正 / 替换旧记忆时:**必须显式带 scope 参数**(新记录要保存到的目标作用域 key),省略或依赖默认作用域一律拒绝;目标旧记录按完整 id 跨作用域查找,可以不在同一作用域,但当前会话必须对目标作用域已有写权限(不足直接拒绝,不会走范围外审批)。supersedes 只传完整 id(36 位 UUID);返回值里带「保存到的目标作用域 key」与修正关系。
|
|
22
|
+
|
|
21
23
|
作用域的**用途**和**别名**可以改(用户也能在面板「记录 → 作用域」里改):memory_scopes({ action: "edit", scope, scopeDescription?, scopeName? }) —— scopeDescription 是那句用途(空串 = 清空,回退到按类型的默认描述),scopeName 是别名(空串 = 移除;只影响显示与引用,不改作用域键;项目 / 自定义作用域支持,global / session 不支持)。两者至少给一个,且需要该作用域可写(范围外先用 action="request" 申请写权限)。把用途写清楚,后续检索的「范围外清单」会直接告诉接手的人这个域是干什么的。
|
|
22
24
|
|
|
23
25
|
同一会话里已经出现过的记忆,memory_search / memory_list 只回 ID 并注明“摘要因上下文去重被省略”;那不是没找到,需要正文时直接用 memory_get 取。
|
package/lib/provider/index.js
CHANGED
|
@@ -1292,7 +1292,10 @@ export class LocalMemoryService {
|
|
|
1292
1292
|
const s = this.store.peek(scope)
|
|
1293
1293
|
if (s) stores.push(s)
|
|
1294
1294
|
}
|
|
1295
|
-
|
|
1295
|
+
// 0.36.0:supersedes 支持跨作用域,所以退役标记也必须跨作用域收集 ——
|
|
1296
|
+
// 一条落在 global 的修正版要能让 project 里的旧记录退出检索/注入。
|
|
1297
|
+
// scope 参数只用于过滤"要枚举哪些记录",不再限制"从哪些 scope 收集修正关系"。
|
|
1298
|
+
const retired = input.includeSuperseded ? new Set () : new Set(this.supersededIds())
|
|
1296
1299
|
const now = Date.now()
|
|
1297
1300
|
const out = []
|
|
1298
1301
|
for (const s of stores) {
|
|
@@ -3294,8 +3297,12 @@ export class LocalMemoryService {
|
|
|
3294
3297
|
if (content.length > this.cfg.maxRecordChars) {
|
|
3295
3298
|
throw memoryError('CONTENT_TOO_LONG', `content exceeds ${this.cfg.maxRecordChars} chars`)
|
|
3296
3299
|
}
|
|
3297
|
-
|
|
3298
|
-
|
|
3300
|
+
// 0.36.0:supersedes 的旧记录按**完整 id 跨作用域**查找 —— 新记录可以落在任意
|
|
3301
|
+
// 作用域去修正另一作用域里的旧记录(project / global / session / 自定义均可)。
|
|
3302
|
+
// 之前这里用 `this.store.scope(scope).records.get(id)` 只查新记录自己的 scope,
|
|
3303
|
+
// 跨作用域一律报 SUPERSEDES_UNKNOWN;findById 会扫描全部已加载/已发现的 scope。
|
|
3304
|
+
if (input.supersedes && !this.findById(input.supersedes)) {
|
|
3305
|
+
throw memoryError('SUPERSEDES_UNKNOWN', `supersedes target ${input.supersedes} not found in any scope`)
|
|
3299
3306
|
}
|
|
3300
3307
|
// 状态型记忆(state)默认带 TTL:写入时算一次绝对 expiresAt,读取时只比较时间。
|
|
3301
3308
|
// 显式 expiresAt 优先;ttlMs 对任何 kind 都生效(便于测试/特殊用途)。
|
|
@@ -3618,12 +3625,9 @@ export class LocalMemoryService {
|
|
|
3618
3625
|
|
|
3619
3626
|
// 退役(superseded)记录默认不参与召回:它们只是被新记录修正过的历史版本,
|
|
3620
3627
|
// 继续返回会让模型拿旧结论当现行事实。memory_get(id)/面板历史仍可直接取。
|
|
3621
|
-
|
|
3622
|
-
|
|
3623
|
-
|
|
3624
|
-
if (record.supersedes) retired.add(record.supersedes)
|
|
3625
|
-
}
|
|
3626
|
-
}
|
|
3628
|
+
// 0.36.0:跨作用域修正后,修正版可能不在本次搜索的 scopes 里(例如修正版落
|
|
3629
|
+
// global、旧记录在 project),所以退役 id 必须扫全部 scope,不能只看 stores。
|
|
3630
|
+
const retired = new Set (this.supersededIds())
|
|
3627
3631
|
|
|
3628
3632
|
// --- channel 1: lexical recall, scored per scope with local IDF ---
|
|
3629
3633
|
|
package/lib/tools/apply.js
CHANGED
|
@@ -141,10 +141,16 @@ export function apply(ctx , config = {}) {
|
|
|
141
141
|
const head = value.deduped
|
|
142
142
|
? `已更新既有记忆(内容相同,去重):${value.id} @ ${renderScope(value.scope, agent)}`
|
|
143
143
|
: `已保存记忆 ${value.id} @ ${renderScope(value.scope, agent)}`
|
|
144
|
-
// 0.
|
|
145
|
-
//
|
|
144
|
+
// 0.36.0:所有 memory_save 返回统一带上保存到的目标作用域 key;用 supersedes
|
|
145
|
+
// 修正旧记忆时额外说明修正关系(旧记录所在作用域可不同)。文案仍以
|
|
146
|
+
// 「已保存记忆 <uuid> @ <scope>」开头,signals.ts 按 UUID 抽取不受影响。
|
|
147
|
+
const scopeKeyLine = `保存到的目标作用域 key:${value.scope}`
|
|
148
|
+
const correctionLine = value.supersedes === undefined
|
|
149
|
+
? ''
|
|
150
|
+
: `\n已用本条修正旧记忆 ${value.supersedes.id}${value.supersedes.scope !== undefined ? `(旧记录在 ${value.supersedes.scope})` : ''}`
|
|
151
|
+
const tail = `\n${scopeKeyLine}${correctionLine}`
|
|
146
152
|
const hook = value.hook
|
|
147
|
-
if (hook === undefined) return head
|
|
153
|
+
if (hook === undefined) return `${head}${tail}`
|
|
148
154
|
const approvalText = {
|
|
149
155
|
approved: '已获批准,会按设定时机运行',
|
|
150
156
|
rejected: '用户拒绝批准,**不会运行**(改脚本或让用户批准后才生效)',
|
|
@@ -156,7 +162,7 @@ export function apply(ctx , config = {}) {
|
|
|
156
162
|
const state = hook.approval.startsWith('save-failed')
|
|
157
163
|
? `登记失败:${hook.approval.slice('save-failed: '.length)}`
|
|
158
164
|
: approvalText[hook.approval] ?? hook.approval
|
|
159
|
-
return `${head}\n随附规则代码 ${hook.id !== '' ? `${hook.id} ` : ''}(${hook.phase}):${state}`
|
|
165
|
+
return `${head}${tail}\n随附规则代码 ${hook.id !== '' ? `${hook.id} ` : ''}(${hook.phase}):${state}`
|
|
160
166
|
})
|
|
161
167
|
|
|
162
168
|
register(tools.memory_search, (value, _args, exec) => {
|
package/lib/tools/index.js
CHANGED
|
@@ -645,6 +645,19 @@ function outOfScopeReason(
|
|
|
645
645
|
*/
|
|
646
646
|
const SUPERSEDES_PARAM_DESCRIPTION =
|
|
647
647
|
'被这条新记忆修正 / 替换掉的旧记录 id。必须传**完整 id**(36 位 UUID),不能传 memory_search / memory_list / 摘要 / 规则索引里显示的 8 位短 id;手头只有短 id 时先用 memory_get 取回 —— 它结果里每段首行的 [id] 就是完整 id。旧记录会被标记为「已修正」,默认不再出现在检索、规则和自动召回里,但 memory_get 仍能查到。'
|
|
648
|
+
+ '传了 supersedes 时**必须显式带 scope 参数**(不接受省略 / 默认作用域):scope 是新记录要保存到的目标作用域,本会话必须对它拥有写权限;跨作用域修正(旧记录在别的作用域)现在支持,但目标作用域必须写权限,否则直接拒绝,不做审批。'
|
|
649
|
+
|
|
650
|
+
/** 带 supersedes 时必须显式写 scope:拒绝静默落到默认作用域造成“修错地方”。 */
|
|
651
|
+
function requireScopeForSupersedes(args , explicit ) {
|
|
652
|
+
if (args.supersedes === undefined || args.supersedes === '') return
|
|
653
|
+
const raw = args.scope?.trim()
|
|
654
|
+
if (explicit === undefined || raw === undefined || raw === '') {
|
|
655
|
+
throw new MemoryToolError(
|
|
656
|
+
'SUPERSEDES_SCOPE_REQUIRED',
|
|
657
|
+
'用 supersedes 修正旧记忆时必须显式传 scope 参数(新记录要保存到的目标作用域 key),不能省略、不能依赖默认作用域;否则拒绝保存。',
|
|
658
|
+
)
|
|
659
|
+
}
|
|
660
|
+
}
|
|
648
661
|
|
|
649
662
|
/** memory_* 的 description 参数说明(模型可见)。 */
|
|
650
663
|
const DESCRIPTION_PARAM_DESCRIPTION =
|
|
@@ -956,10 +969,13 @@ function resolveScope(
|
|
|
956
969
|
|
|
957
970
|
|
|
958
971
|
|
|
972
|
+
|
|
959
973
|
|
|
960
974
|
|
|
961
975
|
|
|
962
976
|
|
|
977
|
+
|
|
978
|
+
|
|
963
979
|
|
|
964
980
|
|
|
965
981
|
|
|
@@ -1047,6 +1063,11 @@ export function memorySaveTool(opts )
|
|
|
1047
1063
|
explicit = resolved
|
|
1048
1064
|
}
|
|
1049
1065
|
|
|
1066
|
+
// 0.36.0:带 supersedes 时 scope 必须显式给出(见 requireScopeForSupersedes),
|
|
1067
|
+
// 且本会话必须对目标作用域已有写权限 —— 不触发范围外审批,权限不足直接拒绝。
|
|
1068
|
+
requireScopeForSupersedes(args, explicit)
|
|
1069
|
+
const isSupersedes = args.supersedes !== undefined && args.supersedes !== ''
|
|
1070
|
+
|
|
1050
1071
|
// 写入护栏(0.20.0 / 0.23.0):write 开关与范围等级分开判断。
|
|
1051
1072
|
// - 作用域在范围内但「可写」关掉 → 直接拒绝并说明开关;
|
|
1052
1073
|
// - absolute 且作用域不在范围内 → 直接拒绝并说明绝对限制;
|
|
@@ -1058,7 +1079,16 @@ export function memorySaveTool(opts )
|
|
|
1058
1079
|
const level = policy?.level ?? 'none'
|
|
1059
1080
|
const target = explicit ?? (typeof service.resolveWriteScope === 'function' ? service.resolveWriteScope(agent) : undefined)
|
|
1060
1081
|
let approved = false
|
|
1061
|
-
if (level !== 'none' && target !== undefined && !scopeWritableBy(decide, service, agent, policy, target)) {
|
|
1082
|
+
if (isSupersedes && level !== 'none' && target !== undefined && !scopeWritableBy(decide, service, agent, policy, target)) {
|
|
1083
|
+
// supersedes 是"改旧记忆"的写操作:必须已有写权限,不走范围外审批。
|
|
1084
|
+
// 不论拒绝原因是绝对限制 / 只读 / 范围外,统一用一个 dedicated 错误码与文案,
|
|
1085
|
+
// 避免把 "SCOPE_NOT_IN_RANGE" 误报成 VISIBILITY_ABSOLUTE(见 0.36.0)。
|
|
1086
|
+
throw new MemoryToolError(
|
|
1087
|
+
'SUPERSEDES_SCOPE_NOT_WRITABLE',
|
|
1088
|
+
`用 supersedes 修正旧记忆要求当前会话对目标作用域 ${target} 已有写权限(作用域不在本会话可写范围内),本次保存没有执行。请先让用户授予该作用域写权限,或改用本会话可写的作用域。`,
|
|
1089
|
+
)
|
|
1090
|
+
}
|
|
1091
|
+
if (!isSupersedes && level !== 'none' && target !== undefined && !scopeWritableBy(decide, service, agent, policy, target)) {
|
|
1062
1092
|
const decision = decide('write', target)
|
|
1063
1093
|
if (decision !== undefined) {
|
|
1064
1094
|
// provider 已经给出统一判定:不可申请就直接讲原因(absolute / 关闭 / 只读)。
|
|
@@ -1131,11 +1161,19 @@ export function memorySaveTool(opts )
|
|
|
1131
1161
|
description: args.description,
|
|
1132
1162
|
})
|
|
1133
1163
|
}
|
|
1164
|
+
let oldScope
|
|
1165
|
+
if (isSupersedes) {
|
|
1166
|
+
try {
|
|
1167
|
+
const hit = (await service.getByIds?.([args.supersedes ]))?.[0]
|
|
1168
|
+
oldScope = hit?.scope
|
|
1169
|
+
} catch { /* 取不到旧记录作用域只影响提示,不影响保存成功 */ }
|
|
1170
|
+
}
|
|
1134
1171
|
return {
|
|
1135
1172
|
id: record.id,
|
|
1136
1173
|
scope: record.scope,
|
|
1137
1174
|
...(alias !== undefined ? { scopeName: alias } : {}),
|
|
1138
1175
|
deduped: false,
|
|
1176
|
+
...(isSupersedes ? { supersedes: { id: args.supersedes , ...(oldScope !== undefined ? { scope: oldScope } : {}) } } : {}),
|
|
1139
1177
|
...(hookInfo !== undefined ? { hook: hookInfo } : {}),
|
|
1140
1178
|
}
|
|
1141
1179
|
} catch (error) {
|
|
@@ -2310,7 +2348,12 @@ export function memoryBlockTool(opts )
|
|
|
2310
2348
|
|
|
2311
2349
|
|
|
2312
2350
|
|
|
2313
|
-
|
|
2351
|
+
|
|
2352
|
+
|
|
2353
|
+
|
|
2354
|
+
|
|
2355
|
+
|
|
2356
|
+
|
|
2314
2357
|
|
|
2315
2358
|
|
|
2316
2359
|
|
|
@@ -2374,6 +2417,11 @@ export function memoryHooksTool(opts )
|
|
|
2374
2417
|
description: '运行时机;省略 = 更新时沿用旧值,新建默认 before-save。',
|
|
2375
2418
|
},
|
|
2376
2419
|
name: { type: 'string', description: '显示名(面板与审批卡用)' },
|
|
2420
|
+
ruleId: {
|
|
2421
|
+
type: 'string',
|
|
2422
|
+
description: '可选:把钩子关联到一条规则记忆(报错时带 id,可用 memory_get 取全文)。'
|
|
2423
|
+
+ '**省略 = 通用钩子**(不挂任何记忆,靠 scopes/kinds/phase 与脚本里的 ctx 决定何时自动执行)。更新时省略 = 保留旧关联。',
|
|
2424
|
+
},
|
|
2377
2425
|
scopes: { type: 'array', items: { type: 'string' }, description: '适用作用域键;省略 = 全部适用(更新时保留旧值)' },
|
|
2378
2426
|
kinds: { type: 'array', items: { type: 'string' }, description: '适用记忆类型(fact/rule/...);省略 = 全部适用' },
|
|
2379
2427
|
content: { type: 'string', description: 'run 试跑用的正文(只跑脚本,不写记忆)' },
|
|
@@ -2426,7 +2474,10 @@ export function memoryHooksTool(opts )
|
|
|
2426
2474
|
...(args.kinds !== undefined ? { kinds: args.kinds.map(String) } : { kinds: existing?.kinds ?? [] }),
|
|
2427
2475
|
...(args.description !== undefined ? { description: args.description } : {}),
|
|
2428
2476
|
createdBy: 'agent',
|
|
2429
|
-
|
|
2477
|
+
// 0.35.4:显式给了就更新;否则沿用旧关联;新建时省略 = 通用钩子(无 ruleId)。
|
|
2478
|
+
...(args.ruleId !== undefined
|
|
2479
|
+
? { ruleId: args.ruleId }
|
|
2480
|
+
: existing?.ruleId !== undefined ? { ruleId: existing.ruleId } : {}),
|
|
2430
2481
|
})
|
|
2431
2482
|
} catch (error) {
|
|
2432
2483
|
throw toolError(error)
|
package/package.json
CHANGED
|
@@ -19,8 +19,19 @@ description: "Use when writing or editing the executable script that rides along
|
|
|
19
19
|
| `after-save` | 记录已经落盘**之后** | ❌ 只能附注 | 否 |
|
|
20
20
|
| `before-inject` | 记忆即将进入上下文**之前** | ✅(`drop:true` 丢弃整条) | ✅ 返回 `{content}` 改写 |
|
|
21
21
|
|
|
22
|
+
`before-inject` 覆盖**三条注入通道**:系统提示的规则段、会话第一步的摘要、以及每轮按用户问题触发的自动召回。所以"改写/丢弃"对模型实际读到的所有记忆都生效。
|
|
23
|
+
|
|
22
24
|
默认是 `before-save`。绝大多数"规范类"规则都用它。
|
|
23
25
|
|
|
26
|
+
## 钩子一定要挂到记忆上吗?
|
|
27
|
+
|
|
28
|
+
**不用**。两种创建方式:
|
|
29
|
+
|
|
30
|
+
- **随规则保存**(`memory_save` 带 `hookCode`):钩子关联到那条规则记忆(记下 `ruleId`),校验失败时报错会自动带上规则 id,可用 `memory_get` 取全文。
|
|
31
|
+
- **独立通用钩子**(`memory_hooks` 的 `action:"save"`,**不传 `ruleId`**):不挂任何记忆,靠 `scopes` / `kinds` / `phase` 与脚本里的 `ctx` 决定何时自动执行。例:`scopes:[]` + `kinds:[]` = 对所有记忆生效的通用校验器。
|
|
32
|
+
|
|
33
|
+
代码实际是按 `scopes`(作用域)+ `kinds`(记忆类型)匹配来触发的,`ruleId` 只是关联标注、不参与匹配。所以同一段代码可以只管某个项目、只管 `rule`、或管全部。
|
|
34
|
+
|
|
24
35
|
## 写一个脚本
|
|
25
36
|
|
|
26
37
|
代码是**模块体**:里面定义一个入口函数即可,不需要 `export`,也不要写 `require`。
|