@restregular/dsh-memory 0.9.1 → 0.9.3
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 +13 -1
- package/lib/client.js +96 -39
- 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,23 @@ 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.3** —— 侧栏图标统一成插件美术:
|
|
330
|
+
- 左侧栏「记忆」入口和设置侧栏那一行原来各画各的(单色线稿芯片 / 宿主回退的齿轮),和插件列表里的年轮对不上。现在两处都直接使用 **`icon.svg` 的年轮瓦片本体**,按 `viewBox` 缩放到 16px(瓦片约 12.4px、年轮约 1.13px),三个入口是同一只图形。
|
|
331
|
+
- 设置侧栏仍是把宿主那颗 16px `svg` 的孩子换掉、`viewBox` 改到 36 网格,不动布局;两处渐变的 id 分开(`logo` / `nav`),同页同时出现也不会撞 id。
|
|
332
|
+
- 渲染冒烟测试新增几何/配色对账:侧栏路径必须逐字等于 `icon.svg` 的螺旋,深咖/香槟金四种颜色必须一致 —— 防止以后又退回线稿。
|
|
333
|
+
- **0.9.2** —— 规则增量的去重口径改成「**上一轮开始时的规则快照**」:
|
|
334
|
+
- 以前按「历史里出现过的规则行」去重,而系统提示是每步重渲染的:一条规则被编辑后,如果系统提示在同一步里已经刷新成新文本,下一轮就**不会再补**,编辑等于被吞掉。
|
|
335
|
+
- 现在每个会话记住每条规则 id 在**上一轮开始时**的渲染行:新增 → 补;同一 id 的行变了(编辑)→ 补,即使系统提示已经刷新;没变 → 不补。编辑回旧文本也算"变了",会补一次。
|
|
336
|
+
- 宿主重启 / 第一次见到某个会话时没有快照,用「系统提示 + 历史增量块」里已经出现的规则行做种子,所以不会整批重提醒。
|
|
326
337
|
- **0.9.1** —— 插件列表只显示包名的问题:**加了显示名与图标**。
|
|
327
338
|
- 宿主 `readPluginMeta` 只读包内 `locale/<lang>.json` 的 `meta.title` / `meta.description`(且必须能通过 `exports` 解析),缺失就回退成包名 —— 所以插件列表里一直是 `@restregular/dsh-memory` + 一长串 `package.json` 描述。现在 `locale/zh.json` 显示「**长期记忆**」,`locale/en.json` 显示「Long-term Memory」,描述也压成一行。
|
|
328
339
|
- 图标从蓝色芯片换成**年轮**:深咖 `#3B2D20 → #120E0A` 圆角瓦片 + 香槟金 `#F8E2B4 → #BF8230` 螺旋(记忆是时间累积出来的年轮)。刻意避开插件列表里扎堆的蓝/白底,30px 行高下仍是一条完整的线。
|
|
340
|
+
- **升级后需要重启一次 DSH**:宿主的 Node 进程会缓存 `package.json` 的 `exports` 映射。如果宿主启动时解析过**没有 locale 导出**的旧版,原地更新后列表会暂时仍显示包名(图标/描述已经是新的 —— 它们直接读文件);重启一次桌面端就恢复,之后的版本更新不再需要。
|
|
329
341
|
- 构建与产物测试补了护栏:`locale` 两个文件 + `exports` 放行 + `icon.svg` 体积/格式,任何一项缺失都会构建失败(否则只会静默显示成包名)。
|
|
330
342
|
- **0.9.0** —— **规则变更会跟进旧会话**:
|
|
331
343
|
- 以前在别的会话里新加一条 `kind=rule`,旧会话继续聊时只有系统提示段的文本会刷新 —— 不产生对话消息,模型未必会重读;而且规则段有 300 token 预算,新规则可能被更重要的旧规则挤出常驻段。
|
package/lib/client.js
CHANGED
|
@@ -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
|
{
|
|
@@ -1269,12 +1269,45 @@ window.__ModuleLoader__.load({
|
|
|
1269
1269
|
)
|
|
1270
1270
|
}
|
|
1271
1271
|
|
|
1272
|
-
/**
|
|
1273
|
-
|
|
1274
|
-
|
|
1275
|
-
|
|
1276
|
-
|
|
1277
|
-
|
|
1272
|
+
/**
|
|
1273
|
+
* 侧栏入口图标:插件列表里那只年轮瓦片(icon.svg)本体,按 size 缩放(默认 16)。
|
|
1274
|
+
*
|
|
1275
|
+
* 0.9.1 及以前这一列画的是「内存芯片」线稿(单色、跟随 currentColor),和插件
|
|
1276
|
+
* 管理器里的年轮图标是两套记号 —— 侧栏 / 设置侧栏 / 插件列表看到三个不同形状。
|
|
1277
|
+
* 现在三处共用同一份几何与配色:36 网格、深咖瓦片 + 香槟金年轮,显示尺寸交给
|
|
1278
|
+
* width/height 和 viewBox 缩放,所以 16px 下仍是同一只年轮,不需要 16px 小图。
|
|
1279
|
+
*
|
|
1280
|
+
* 渐变的 id 两处各用一套(logo / nav):同一个页面里侧栏入口和设置侧栏会同时
|
|
1281
|
+
* 存在,重复 id 虽然内容相同,但不能赌宿主什么时候卸载其中一个。
|
|
1282
|
+
*/
|
|
1283
|
+
const NAV_ICON_NS = 'http://www.w3.org/2000/svg'
|
|
1284
|
+
const LOGO_VIEW_BOX = '0 0 36 36'
|
|
1285
|
+
/** 年轮螺旋:与 icon.svg 同一条 7 段圆弧(改这里要同步改 icon.svg,测试会拦)。 */
|
|
1286
|
+
const LOGO_RING = 'M18.99 16.75 A2.19 2.19 0 0 1 19.99 19.95 A3.38 3.38 0 0 1 14.94 20.53 A4.56 4.56 0 0 1 15.15 13.71 A5.74 5.74 0 0 1 23.61 15.07 A6.92 6.92 0 0 1 20.76 24.99 A8.11 8.11 0 0 1 9.62 20.33'
|
|
1287
|
+
const LOGO_TILE = { x: 4, y: 4, width: 28, height: 28, rx: 8 }
|
|
1288
|
+
const LOGO_INNER = { x: 4.45, y: 4.45, width: 27.1, height: 27.1, rx: 7.6 }
|
|
1289
|
+
const LOGO_STOPS = {
|
|
1290
|
+
tile: [['#3B2D20', null], ['#120E0A', 1]],
|
|
1291
|
+
ring: [['#F8E2B4', null], ['#BF8230', 1]],
|
|
1292
|
+
}
|
|
1293
|
+
|
|
1294
|
+
function NavLogoIcon({ size = 16 } = {}) {
|
|
1295
|
+
return h('svg', { width: size, height: size, viewBox: LOGO_VIEW_BOX, fill: 'none', 'aria-hidden': 'true' },
|
|
1296
|
+
h('rect', { ...LOGO_TILE, fill: 'url(#dsh-memory-logo-tile)' }),
|
|
1297
|
+
h('rect', { ...LOGO_INNER, fill: 'none', stroke: 'rgba(240,200,140,0.20)', strokeWidth: 0.9 }),
|
|
1298
|
+
h('path', { d: LOGO_RING, fill: 'none', stroke: 'url(#dsh-memory-logo-ring)', strokeWidth: 2.55, strokeLinecap: 'round', strokeLinejoin: 'round' }),
|
|
1299
|
+
h('defs', null,
|
|
1300
|
+
h('linearGradient', { id: 'dsh-memory-logo-tile', x1: 18, y1: 4, x2: 18, y2: 32, gradientUnits: 'userSpaceOnUse' },
|
|
1301
|
+
...LOGO_STOPS.tile.map(([color, offset]) => offset === null
|
|
1302
|
+
? h('stop', { stopColor: color })
|
|
1303
|
+
: h('stop', { offset, stopColor: color })),
|
|
1304
|
+
),
|
|
1305
|
+
h('linearGradient', { id: 'dsh-memory-logo-ring', x1: 18, y1: 9, x2: 18, y2: 27, gradientUnits: 'userSpaceOnUse' },
|
|
1306
|
+
...LOGO_STOPS.ring.map(([color, offset]) => offset === null
|
|
1307
|
+
? h('stop', { stopColor: color })
|
|
1308
|
+
: h('stop', { offset, stopColor: color })),
|
|
1309
|
+
),
|
|
1310
|
+
),
|
|
1278
1311
|
)
|
|
1279
1312
|
}
|
|
1280
1313
|
|
|
@@ -1313,7 +1346,7 @@ window.__ModuleLoader__.load({
|
|
|
1313
1346
|
slots.inject('main', () => slots.register({ name: 'main', key: 'memory' }, () => React.createElement(MemoryPage))),
|
|
1314
1347
|
slots.inject('sidebar.panellist', () => slots.register(
|
|
1315
1348
|
{ name: 'sidebar.panellist', id: 'memory', order: 20, label: () => NAV_LABEL },
|
|
1316
|
-
() => React.createElement(
|
|
1349
|
+
() => React.createElement(NavLogoIcon),
|
|
1317
1350
|
)),
|
|
1318
1351
|
]
|
|
1319
1352
|
} catch (error) {
|
|
@@ -1339,7 +1372,7 @@ window.__ModuleLoader__.load({
|
|
|
1339
1372
|
const NAV_LABEL = '记忆'
|
|
1340
1373
|
|
|
1341
1374
|
/**
|
|
1342
|
-
*
|
|
1375
|
+
* 设置侧栏「记忆」那一行的图标 —— 与侧栏入口、插件列表共用同一只年轮。
|
|
1343
1376
|
*
|
|
1344
1377
|
* 宿主把导航图标写死在 `dsh-client-ui-settings-general` 的 `navIcon(id)` 里:只有
|
|
1345
1378
|
* account / models / agent-presets / plugins / archived-sessions 五个 id 有专属图标
|
|
@@ -1350,7 +1383,7 @@ window.__ModuleLoader__.load({
|
|
|
1350
1383
|
* "官方指定图标"的入口。
|
|
1351
1384
|
*
|
|
1352
1385
|
* 因此只有一条路:用宿主自己的类名做一次**定向覆盖** —— 把那颗齿轮**就地**换成我们的
|
|
1353
|
-
*
|
|
1386
|
+
* 记号。三条护栏让它不会把界面弄坏:
|
|
1354
1387
|
* 1. 选择器只认 className 的**后缀**:宿主的类名是 CSS Modules 生成的
|
|
1355
1388
|
* `<hash>_navCell` / `<hash>_navIcon`(hash 随构建变),所以用
|
|
1356
1389
|
* `[class*="_navIcon"]` 匹配,hash 变了也照样命中;
|
|
@@ -1358,44 +1391,59 @@ window.__ModuleLoader__.load({
|
|
|
1358
1391
|
* `dsh-memory-nav` 标记类,规则全部限定在它下面 —— 其它区块(账号/模型/插件市场)
|
|
1359
1392
|
* 的图标一个都不碰。标记打在**按钮自己**身上而不是它所在的列表上:整列共用一个
|
|
1360
1393
|
* 列表容器,标在容器上会波及所有区块。
|
|
1361
|
-
* 3. **不改布局、不插 DOM**:那颗 svg
|
|
1394
|
+
* 3. **不改布局、不插 DOM**:那颗 svg 还是宿主自己渲染的,我们只把它内部换成瓦片,
|
|
1362
1395
|
* 盒子尺寸/行高/对齐全由宿主保证。
|
|
1363
1396
|
*
|
|
1364
|
-
*
|
|
1365
|
-
*
|
|
1366
|
-
*
|
|
1367
|
-
*
|
|
1368
|
-
*
|
|
1397
|
+
* 0.5.3/0.5.4 曾把蓝色瓦片塞进这一列(实心色块混在细线图标里,格格不入),随后几版
|
|
1398
|
+
* 改画成单色线稿芯片 —— 但那样侧栏入口 / 设置侧栏 / 插件列表就是三种记号。现在统一
|
|
1399
|
+
* 成插件美术本身:深咖瓦片 + 香槟金年轮。16px 下瓦片约 12.4px、年轮约 1.13px,
|
|
1400
|
+
* 视觉重量和这一列的 1.3px 线稿接近;几何与配色只在上面的 LOGO_* 一处维护
|
|
1401
|
+
* (测试会核对它和 icon.svg 是同一只年轮)。
|
|
1369
1402
|
*
|
|
1370
|
-
* 实现:把宿主那颗 svg
|
|
1403
|
+
* 实现:把宿主那颗 svg 的**子节点**换成瓦片,并把 viewBox 改到 36 网格(宿主的
|
|
1404
|
+
* width/height 仍是 16,缩放由浏览器完成)。三条被否掉的路,留给后来人:
|
|
1371
1405
|
* - `::before` 补一个(0.5.3):真机上盒子没成形 —— 齿轮没了、记号也没出现,空一格;
|
|
1372
|
-
* - 给 svg 上背景图(0.5.4)
|
|
1406
|
+
* - 给 svg 上背景图(0.5.4):能画出来,但只能画色块,画不出年轮;
|
|
1373
1407
|
* - `content: url(...)` 替换 svg 内容:SVG 元素不支持 content 替换,实测无效。
|
|
1374
1408
|
* 换子节点这条路的失败模式是良性的:svg 由宿主渲染,我们只动它的孩子,尺寸/对齐/行高
|
|
1375
1409
|
* 一定由宿主保证;万一类名约定变了,选中不到就没有任何改动,图标保持原样。
|
|
1376
1410
|
* React 若重渲染把图形覆盖回去,observer 会在下一轮按子节点重新补上。
|
|
1377
1411
|
*/
|
|
1378
|
-
const
|
|
1379
|
-
|
|
1380
|
-
|
|
1381
|
-
{ tag: '
|
|
1382
|
-
{
|
|
1383
|
-
|
|
1412
|
+
const LOGO_DOM = [
|
|
1413
|
+
{ tag: 'rect', attrs: { ...LOGO_TILE, fill: 'url(#dsh-memory-nav-tile)' } },
|
|
1414
|
+
{ tag: 'rect', attrs: { ...LOGO_INNER, fill: 'none', stroke: 'rgba(240,200,140,0.20)', 'stroke-width': '0.9' } },
|
|
1415
|
+
{ tag: 'path', attrs: { d: LOGO_RING, fill: 'none', stroke: 'url(#dsh-memory-nav-ring)', 'stroke-width': '2.55', 'stroke-linecap': 'round', 'stroke-linejoin': 'round', 'data-dsh-memory-logo': '1' } },
|
|
1416
|
+
{
|
|
1417
|
+
tag: 'defs',
|
|
1418
|
+
attrs: {},
|
|
1419
|
+
children: [
|
|
1420
|
+
{
|
|
1421
|
+
tag: 'linearGradient',
|
|
1422
|
+
attrs: { id: 'dsh-memory-nav-tile', x1: '18', y1: '4', x2: '18', y2: '32', gradientUnits: 'userSpaceOnUse' },
|
|
1423
|
+
children: LOGO_STOPS.tile.map(([color, offset]) => ({ tag: 'stop', attrs: offset === null ? { 'stop-color': color } : { offset: String(offset), 'stop-color': color } })),
|
|
1424
|
+
},
|
|
1425
|
+
{
|
|
1426
|
+
tag: 'linearGradient',
|
|
1427
|
+
attrs: { id: 'dsh-memory-nav-ring', x1: '18', y1: '9', x2: '18', y2: '27', gradientUnits: 'userSpaceOnUse' },
|
|
1428
|
+
children: LOGO_STOPS.ring.map(([color, offset]) => ({ tag: 'stop', attrs: offset === null ? { 'stop-color': color } : { offset: String(offset), 'stop-color': color } })),
|
|
1429
|
+
},
|
|
1430
|
+
],
|
|
1431
|
+
},
|
|
1384
1432
|
]
|
|
1385
1433
|
|
|
1386
|
-
/**
|
|
1387
|
-
function
|
|
1388
|
-
const
|
|
1389
|
-
const
|
|
1390
|
-
const
|
|
1391
|
-
|
|
1392
|
-
|
|
1393
|
-
|
|
1394
|
-
|
|
1395
|
-
|
|
1396
|
-
|
|
1397
|
-
|
|
1398
|
-
|
|
1434
|
+
/** 递归建 SVG 节点(不用 innerHTML:避开宿主 CSP,也避免命名空间被字符串解析弄丢)。 */
|
|
1435
|
+
function svgNode({ tag, attrs, children }) {
|
|
1436
|
+
const node = document.createElementNS(NAV_ICON_NS, tag)
|
|
1437
|
+
for (const [name, value] of Object.entries(attrs ?? {})) node.setAttribute(name, String(value))
|
|
1438
|
+
for (const child of children ?? []) node.appendChild(svgNode(child))
|
|
1439
|
+
return node
|
|
1440
|
+
}
|
|
1441
|
+
|
|
1442
|
+
/** 把一颗 nav 图标的图形换成插件同款年轮;已经是年轮就跳过(observer 会反复调到这里)。 */
|
|
1443
|
+
function paintLogo(svg) {
|
|
1444
|
+
if (svg.querySelector('[data-dsh-memory-logo]') !== null) return
|
|
1445
|
+
svg.setAttribute('viewBox', LOGO_VIEW_BOX)
|
|
1446
|
+
svg.replaceChildren(...LOGO_DOM.map(svgNode))
|
|
1399
1447
|
}
|
|
1400
1448
|
|
|
1401
1449
|
/**
|
|
@@ -1414,7 +1462,7 @@ window.__ModuleLoader__.load({
|
|
|
1414
1462
|
if (label !== NAV_LABEL) continue
|
|
1415
1463
|
cell.classList?.add('dsh-memory-nav')
|
|
1416
1464
|
const icon = cell.querySelector('[class*="_navIcon"]')
|
|
1417
|
-
if (icon)
|
|
1465
|
+
if (icon) paintLogo(icon)
|
|
1418
1466
|
}
|
|
1419
1467
|
} catch { /* 换图失败:图标保持宿主原样 */ }
|
|
1420
1468
|
}
|
|
@@ -1441,7 +1489,16 @@ window.__ModuleLoader__.load({
|
|
|
1441
1489
|
return running || (requested === true && phase === 'idle')
|
|
1442
1490
|
}
|
|
1443
1491
|
|
|
1444
|
-
exports.__test = {
|
|
1492
|
+
exports.__test = {
|
|
1493
|
+
RecordCard: RecordCard,
|
|
1494
|
+
MemoryPanel: MemoryPanel,
|
|
1495
|
+
CSS: CSS,
|
|
1496
|
+
shouldPollInstall: shouldPollInstall,
|
|
1497
|
+
// 图标一致性护栏:测试会核对这两份图形与包内 icon.svg 是同一条年轮路径 / 同一组颜色
|
|
1498
|
+
NavLogoIcon: NavLogoIcon,
|
|
1499
|
+
LOGO_DOM: LOGO_DOM,
|
|
1500
|
+
paintLogo: paintLogo,
|
|
1501
|
+
}
|
|
1445
1502
|
return module.exports
|
|
1446
1503
|
},
|
|
1447
1504
|
})
|
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
|