dsh-agent-soul 0.9.17 → 0.9.18
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
|
@@ -7,6 +7,51 @@
|
|
|
7
7
|
|
|
8
8
|
---
|
|
9
9
|
|
|
10
|
+
## 0.9.18 · 2026-11-12
|
|
11
|
+
|
|
12
|
+
`segment-cache.js`(四段系统提示的渲染缓存)审计后的整改。审计报告在交接目录,
|
|
13
|
+
两个自写探针在 `审计证据\` 里(不进仓库)。
|
|
14
|
+
|
|
15
|
+
### 修复 · 缓存永久冻结(P1)
|
|
16
|
+
|
|
17
|
+
`everyTurns` 的判据是 `human - hit.turn`,而 `human` 靠 `isFirstTurnOfSession` 推进 ——
|
|
18
|
+
它依赖 `session.snapshotEvents()`。宿主在**压缩会话**上持续抛错时,`turns.js` 的处理是
|
|
19
|
+
「游标推进、human 不动」,于是 human 恒为 0、差值恒为 0 → **一直命中,永不重算**:
|
|
20
|
+
|
|
21
|
+
```
|
|
22
|
+
探针实测:everyTurns=2,21 轮里 compute 只跑了 1 次,日志里一个字都没有
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
**修法**:槽位记 `at`,命中条件再加一条 `now - hit.at < SEGMENT_CACHE_MAX_AGE_MS`
|
|
26
|
+
(默认 30 分钟)。正常路径(human 在涨)永远轮不到它;只有在轮次推不动的退化场景下,
|
|
27
|
+
最多 30 分钟自愈一次。**毒化**:删掉这条条件 → 4 条断言变红(`到期后重算`、`compute 两次` 等);
|
|
28
|
+
恢复 → 15/15 全绿。
|
|
29
|
+
|
|
30
|
+
> 没有从根上改 `isFirstTurnOfSession`(抛错恢复后 human 会永久少算历史条数)——
|
|
31
|
+
> 那牵动首轮判定,改错会让新会话失忆,值单独一轮做,不顺手夹带。
|
|
32
|
+
|
|
33
|
+
### 删除 · 死代码
|
|
34
|
+
|
|
35
|
+
- `shouldInjectPersona`(`turns.js`)与 `personaInjectAtBySession`(`state.js`):
|
|
36
|
+
0.9.17 人格段改成「缓存优先」之后已无调用方,只剩只写不读。
|
|
37
|
+
- 留着它是**文档陷阱**:那段注释讲「首轮注入、之后每 15 轮补一次」,而真实行为是
|
|
38
|
+
「每轮都在,只是每 15 轮重算一次」。想恢复旧行为应该加配置开关,而不是复活这个函数。
|
|
39
|
+
- 连带清掉 `entry.js` 里的 `.clear()`、两处 import,以及导出快照里的三个名字。
|
|
40
|
+
|
|
41
|
+
### 文档
|
|
42
|
+
|
|
43
|
+
- `segment-notes.js` 的指纹注释补了一条实测结论:**手改一篇已有笔记,最多 7 轮后才生效**
|
|
44
|
+
(NTFS 上改文件内容不会改父目录 mtime,`index.json` 也不动;新增/删除文件能立刻发现)。
|
|
45
|
+
这条以前只有「目录 mtime 能兜住手改」的模糊说法,审计时被证伪了一半。
|
|
46
|
+
|
|
47
|
+
### 审计确认没问题的
|
|
48
|
+
|
|
49
|
+
跨会话串味(拿不到 sessionId 就不缓存)、无上限增长(128 槽真 LRU)、
|
|
50
|
+
写入回声不被缓存吃掉(有回声时绕过缓存)、开关短路在缓存之外、
|
|
51
|
+
以及缓存确实在工作(`context.agent` 被已在用的功能依赖,不是空转)。
|
|
52
|
+
|
|
53
|
+
---
|
|
54
|
+
|
|
10
55
|
## 0.9.17 · 2026-11-12
|
|
11
56
|
|
|
12
57
|
外部审查(43 条)整改轮 **R20**。审查报告基于 `47549e5`,整改落在 `4805cd7` 之后。
|
|
@@ -6,7 +6,7 @@ import { STICKY_MAX_SESSIONS } from '../meta.js'
|
|
|
6
6
|
import { __resetToneForTest } from '../../tone.js'
|
|
7
7
|
import { clearAllEchoes } from '../../core/echo.js'
|
|
8
8
|
import { loadConfig } from '../../store.js'
|
|
9
|
-
import { maintainClock,
|
|
9
|
+
import { maintainClock, recallSeenBySession, stickyRecallBySession, turnCursorBySession } from './state.js'
|
|
10
10
|
import { note, serviceOf } from '../../env.js'
|
|
11
11
|
import { noteMissingOwner } from './refine.js'
|
|
12
12
|
import { recordAssembly } from '../../attest.js'
|
|
@@ -217,9 +217,6 @@ export function __resetForTest() {
|
|
|
217
217
|
recallSeenBySession.clear()
|
|
218
218
|
// 2026-11-04:写入回声也是模块级缓存,不清会把上一条用例的「刚记下的」带进下一条。
|
|
219
219
|
clearAllEchoes()
|
|
220
|
-
// 2026-11-01 审计 C10:人设轮次表也是模块级状态(哪个会话已经注入过、注入到第几轮),
|
|
221
|
-
// 不跟着清的话,测试里第二个用例会继承第一个用例的计数,人设注入就测不出来。
|
|
222
|
-
personaInjectAtBySession.clear()
|
|
223
220
|
// 2026-11-11:四段渲染缓存也是模块级状态,不跟着清会让下一条用例
|
|
224
221
|
// 拿到上一条的文本(尤其是人格段:不刷新时返回的正是缓存文本)。
|
|
225
222
|
__resetSegmentCacheForTest()
|
|
@@ -27,6 +27,7 @@
|
|
|
27
27
|
* ── 什么时候重算 ──
|
|
28
28
|
* · sig 变了(文件的 mtime+size / 用户这句话 / 时段等「廉价指纹」);
|
|
29
29
|
* · 距离上次渲染过了 `everyTurns` 个人话轮次(兜底:sig 漏掉的变化也会定期刷新);
|
|
30
|
+
* · 距离上次渲染过了 `maxAgeMs`(默认 30 分钟,**保险丝**:轮次推不动时靠它自愈,见下);
|
|
30
31
|
* · 被 invalidateSegment / invalidateAll 主动作废(写盘之后调用)。
|
|
31
32
|
* 轮次用 turns.js 的 `isFirstTurnOfSession` 推进的 human 计数 —— 它天然
|
|
32
33
|
* 「同一轮内多次装配不涨」,正好对应宿主 preStep + refreshContext 的多次调用。
|
|
@@ -46,10 +47,25 @@ import { turnCursorBySession } from './state.js'
|
|
|
46
47
|
*/
|
|
47
48
|
export const SEGMENT_CACHE_MAX_ENTRIES = STICKY_MAX_SESSIONS * 4
|
|
48
49
|
|
|
50
|
+
/**
|
|
51
|
+
* 缓存槽的**保险丝**:多久之后无条件重算一次(2026-11-12 审计 D1)。
|
|
52
|
+
*
|
|
53
|
+
* 为什么需要它:`everyTurns` 的判据是 `human - hit.turn`,而 `human` 靠
|
|
54
|
+
* `isFirstTurnOfSession` 推进 —— 它依赖 `session.snapshotEvents()`。
|
|
55
|
+
* 宿主在压缩会话上**持续抛错**时,`turns.js` 的处理是「游标推进、human 不动」,
|
|
56
|
+
* 于是 human 恒为 0、`human - hit.turn` 恒为 0 → **缓存永久冻结**:
|
|
57
|
+
* 21 轮里 compute 只跑了 1 次,日志里一个字都没有。
|
|
58
|
+
*
|
|
59
|
+
* 所以这里加一道与轮次无关的时限:正常路径(human 在涨)永远不会触发,
|
|
60
|
+
* 只有在「轮次推不动」的退化场景下,最多 30 分钟自愈一次。
|
|
61
|
+
* 30 分钟是权衡:再短会在正常会话里白白打断 prefix cache。
|
|
62
|
+
*/
|
|
63
|
+
export const SEGMENT_CACHE_MAX_AGE_MS = 30 * 60 * 1000
|
|
64
|
+
|
|
49
65
|
/** key 与 sessionId 的分隔符:用 NUL,正常 id 里不可能出现。 */
|
|
50
66
|
const SEP = '\u0000'
|
|
51
67
|
|
|
52
|
-
/** @type {Map<string, { sig: string, turn: number, text: string }>} */
|
|
68
|
+
/** @type {Map<string, { sig: string, turn: number, text: string, at: number }>} */
|
|
53
69
|
const entries = new Map()
|
|
54
70
|
|
|
55
71
|
/** sessionId 归一化:拿不到就是空串,绝不退化成全局 key。 */
|
|
@@ -71,12 +87,13 @@ function asText(value) {
|
|
|
71
87
|
* @param {any} agent 宿主上下文里的 agent(用来取 session id 与轮次)
|
|
72
88
|
* @param {string} key 段名:'persona' / 'memory' / 'notes' / 'purpose'
|
|
73
89
|
* @param {() => string} compute 未命中时真正渲染的函数
|
|
74
|
-
* @param {{ sig?: string, everyTurns?: number }} [options]
|
|
90
|
+
* @param {{ sig?: string, everyTurns?: number, maxAgeMs?: number }} [options]
|
|
75
91
|
* sig: 内容的廉价指纹(文件 mtime+size 拼串、query 指纹……)。变了就重算。
|
|
76
92
|
* everyTurns: 最多沿用一个渲染结果多少个人话轮次,默认 7。
|
|
93
|
+
* maxAgeMs: 保险丝 —— 距离上次渲染超过这么久就无条件重算,默认 30 分钟。
|
|
77
94
|
* @returns {string}
|
|
78
95
|
*/
|
|
79
|
-
export function renderCached(agent, key, compute, { sig = '', everyTurns = 7 } = {}) {
|
|
96
|
+
export function renderCached(agent, key, compute, { sig = '', everyTurns = 7, maxAgeMs = SEGMENT_CACHE_MAX_AGE_MS } = {}) {
|
|
80
97
|
const name = String(key ?? '')
|
|
81
98
|
const computeText = typeof compute === 'function' ? compute : () => ''
|
|
82
99
|
const sessionId = sessionIdOf(agent)
|
|
@@ -89,10 +106,19 @@ export function renderCached(agent, key, compute, { sig = '', everyTurns = 7 } =
|
|
|
89
106
|
isFirstTurnOfSession(agent)
|
|
90
107
|
const human = Number(turnCursorBySession.get(sessionId)?.human ?? 0)
|
|
91
108
|
const every = Math.max(1, Math.trunc(Number(everyTurns) || 1))
|
|
109
|
+
const ageLimit = Math.max(0, Number(maxAgeMs) || 0)
|
|
110
|
+
const now = Date.now()
|
|
92
111
|
const slot = `${name}${SEP}${sessionId}`
|
|
93
112
|
|
|
94
113
|
const hit = entries.get(slot)
|
|
95
|
-
|
|
114
|
+
// 三条同时成立才算命中:指纹没变、轮次没超、**没超过保险丝时限**。
|
|
115
|
+
// 第三条是为「human 推不动」的退化场景准备的,正常路径不会触发(见 SEGMENT_CACHE_MAX_AGE_MS)。
|
|
116
|
+
if (
|
|
117
|
+
hit !== undefined &&
|
|
118
|
+
hit.sig === sig &&
|
|
119
|
+
human - hit.turn < every &&
|
|
120
|
+
(ageLimit === 0 || now - hit.at < ageLimit)
|
|
121
|
+
) {
|
|
96
122
|
// 命中:挪到队尾,淘汰时它就不是最旧的
|
|
97
123
|
entries.delete(slot)
|
|
98
124
|
entries.set(slot, hit)
|
|
@@ -101,7 +127,7 @@ export function renderCached(agent, key, compute, { sig = '', everyTurns = 7 } =
|
|
|
101
127
|
|
|
102
128
|
const text = asText(computeText())
|
|
103
129
|
entries.delete(slot)
|
|
104
|
-
entries.set(slot, { sig, turn: human, text })
|
|
130
|
+
entries.set(slot, { sig, turn: human, text, at: now })
|
|
105
131
|
trimMap(entries, SEGMENT_CACHE_MAX_ENTRIES)
|
|
106
132
|
return text
|
|
107
133
|
}
|
|
@@ -19,6 +19,12 @@ const NOTES_CACHE_TURNS = 7
|
|
|
19
19
|
* 用 index.json 而不是扫描每篇笔记:所有写入路径(write / append / rename /
|
|
20
20
|
* delete / 手动放文件后的 reconcile)最终都会落一次索引。目录 mtime 兜的是
|
|
21
21
|
* 「手动往 notes/ 里丢了一篇 md」,配置文件则管注入开关与字数上限。
|
|
22
|
+
*
|
|
23
|
+
* ⚠️ 它**测不到**「手改一篇已有笔记的正文」(2026-11-12 审计 S1,NTFS 上实测):
|
|
24
|
+
* 修改文件内容不会改父目录的 mtime,index.json 也不会跟着变 → 指纹一个字节都不动。
|
|
25
|
+
* 这种情况靠 `everyTurns`(7 轮)兜底,也就是**手改已有笔记最多 7 轮后才生效**。
|
|
26
|
+
* 新增 / 删除文件能被立刻发现(目录 mtime 会变)。
|
|
27
|
+
* 想立刻生效:设置页里动一下笔记,或重启插件。
|
|
22
28
|
*/
|
|
23
29
|
function notesSignature() {
|
|
24
30
|
return fileSignature(notesIndexPath(), notesDir(), configPath())
|
|
@@ -3,10 +3,10 @@
|
|
|
3
3
|
* 由 lib/host/runtime.js 按职责拆出(2026-11-06 模块化重构),函数体保持原样。
|
|
4
4
|
*/
|
|
5
5
|
import { trimMap } from '../../core/lru.js'
|
|
6
|
-
import {
|
|
6
|
+
import { STICKY_MAX_SESSIONS, STICKY_NOTE_INTERVAL_MS, name } from '../meta.js'
|
|
7
7
|
import { isHumanEvent } from '../../extract.js'
|
|
8
8
|
import { note } from '../../env.js'
|
|
9
|
-
import {
|
|
9
|
+
import { stickyRecallBySession, turnCursorBySession } from './state.js'
|
|
10
10
|
|
|
11
11
|
|
|
12
12
|
|
|
@@ -336,29 +336,13 @@ export function hasHumanInputThisTurn(agent) {
|
|
|
336
336
|
|
|
337
337
|
|
|
338
338
|
|
|
339
|
-
|
|
340
|
-
|
|
341
|
-
|
|
342
|
-
|
|
343
|
-
|
|
344
|
-
|
|
345
|
-
|
|
346
|
-
|
|
347
|
-
|
|
348
|
-
if (id === '') return true
|
|
349
|
-
|
|
350
|
-
const human = turnCursorBySession.get(id)?.human ?? 0
|
|
351
|
-
const last = personaInjectAtBySession.get(id)
|
|
339
|
+
// 2026-11-12 删除:shouldInjectPersona 与 personaInjectAtBySession。
|
|
340
|
+
//
|
|
341
|
+
// 它原本的职责是「首轮注入人格、之后每 PERSONA_REFRESH_TURNS 轮补一次,其余轮次返回空」。
|
|
342
|
+
// 0.9.17 起人格段改成「缓存优先」:非刷新轮次返回**上次那段原文**而不是空串
|
|
343
|
+
// (旧行为让 15 轮里 14 轮系统提示里没有身份,而且一空一有会把 prefix cache 打断)。
|
|
344
|
+
// 于是这个判定函数没有任何调用方,personaInjectAtBySession 也只剩只写不读。
|
|
345
|
+
//
|
|
346
|
+
// 留着它会变成文档陷阱:这段注释讲的规则和真实行为不一致(现在是每轮都在、每 15 轮重算)。
|
|
347
|
+
// 想让「人格每 15 轮才出现」回来,正确做法是给 soul:persona 段加配置开关,而不是复活这个函数。
|
|
352
348
|
|
|
353
|
-
// 同一轮内会装配多次(重试 / 标题生成)。已经为这个 human 计数注入过,
|
|
354
|
-
// 就不要再注入一遍 —— 否则「省消耗」反而变成一轮发好几份人格。
|
|
355
|
-
if (last !== undefined && human === last) return false
|
|
356
|
-
|
|
357
|
-
// 首轮、或从来没记过注入点(重启后 Map 是空的,补一次)、或隔得够远了
|
|
358
|
-
if (first || last === undefined || human - last >= PERSONA_REFRESH_TURNS) {
|
|
359
|
-
trimMap(personaInjectAtBySession, 200)
|
|
360
|
-
personaInjectAtBySession.set(id, human)
|
|
361
|
-
return true
|
|
362
|
-
}
|
|
363
|
-
return false
|
|
364
|
-
}
|
package/package.json
CHANGED