dsh-agent-soul 0.9.11 → 0.9.13

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.
@@ -1,212 +1,231 @@
1
- /**
2
- * 宿主装配 · entry.js
3
- * 由 lib/host/runtime.js 按职责拆出(2026-11-06 模块化重构),函数体保持原样。
4
- */
5
- import { STICKY_MAX_SESSIONS } from '../meta.js'
6
- import { __resetToneForTest } from '../../tone.js'
7
- import { clearAllEchoes } from '../../core/echo.js'
8
- import { loadConfig } from '../../store.js'
9
- import { maintainClock, personaInjectAtBySession, recallSeenBySession, stickyRecallBySession, turnCursorBySession } from './state.js'
10
- import { note, serviceOf } from '../../env.js'
11
- import { noteMissingOwner } from './refine.js'
12
- import { recordAssembly } from '../../attest.js'
13
- import { registerApi, registerAssets } from '../../api.js'
14
- import { registerDataPolicySegment } from './segment-data-policy.js'
15
- import { registerDiaryTool } from '../../diary-tool.js'
16
- import { registerGoalTool, registerMemoryTool, registerNoteTool } from '../../tool.js'
17
- import { registerMemorySegment } from './segment-memory.js'
18
- import { registerMoodHookSegment } from './segment-mood.js'
19
- import { registerNotesSegment } from './segment-notes.js'
20
- import { registerPersonaSegment } from './segment-persona.js'
21
- import { registerPurposeSegment } from './segment-purpose.js'
22
- import { runCatchUp, startDiaryTimer } from '../../diary.js'
23
- import { unobserveAll } from '../../mood.js'
24
-
25
-
26
-
27
- /**
28
- * 2026-11-05 修 P1-10:给整个 apply 加一层兜底。
29
- * 宿主内部结构一升级,任何一处没保护的属性访问都可能把异常逸出 apply,
30
- * 连带拖累宿主启动。这里兜住并留一条可查日志;功能会静默缺失,
31
- * 但至少「插件挂了」这件事看得见(配合下面 serviceOf 的 WARN)。
32
- */
33
- export function apply(ctx) {
34
- try {
35
- return applyInner(ctx)
36
- } catch (error) {
37
- const reason = error instanceof Error ? error.message : String(error)
38
- note('apply', `⚠️ 插件初始化意外失败(已兜住,不影响宿主启动):${reason}`)
39
- return undefined
40
- }
41
- }
42
-
43
-
44
-
45
- function applyInner(ctx) {
46
- note('apply', `启动 pid=${process.pid} node=${process.version}`)
47
- const config = loadConfig()
48
- // 启动时先看一眼主人名字有没有设(2026-11-04):这条最容易漏,也最影响体验。
49
- noteMissingOwner(config)
50
-
51
- try {
52
- registerApi(ctx)
53
- } catch (error) {
54
- // API 注册失败不该连累注入
55
- note('api', `注册失败:${error instanceof Error ? error.message : error}`)
56
- }
57
-
58
- try {
59
- registerAssets(ctx)
60
- } catch (error) {
61
- // 表情图挂了也只是设置页缺图,不影响心情记账
62
- note('api', `表情图注册失败:${error instanceof Error ? error.message : error}`)
63
- }
64
-
65
- registerMemoryTool(ctx)
66
- registerGoalTool(ctx)
67
- registerNoteTool(ctx)
68
- registerDiaryTool(ctx)
69
-
70
- // ---- 0. 装配证词:把「我到底进没进去」变成可观测的(2026-11-02) ----
71
- //
72
- // 放在 enabled 判断**之前**:插件被关掉时也要能看见「关掉之后确实不在装配里」。
73
- // 否则「关了没生效」和「关了但还在注入」长得一模一样。
74
- //
75
- // 只读不改:等 next() 返回后读 assembly.contexts,不碰 sections、不重跑 text()。
76
- // 为什么是 prepend:最外层进、最外层出,next() 拿到的才是别的监听器都改完的结果。
77
- if (typeof ctx.on !== 'function') {
78
- note('attest', '宿主 ctx.on 不可用,装配证词无法注册(不影响注入,只是少了一双眼睛)')
79
- } else {
80
- try {
81
- // ctx.on 自己就是挂在插件 fiber 上的 effect(cordis 的 register 内部走
82
- // ctx.fiber.effect),所以不需要再套一层 ctx.effect —— 少一层嵌套少一个出错面。
83
- // prepend 在 cordis 里是 unshift:进最前、最先被调用,于是 next() 拿到的是
84
- // 下游所有监听器都改完之后的结果,也就是真正要渲染的那一份。
85
- ctx.on('system-prompt/assemble', async (_assembly, context, next) => {
86
- const assembly = await next()
87
- // 证词失败绝不能拖垮装配:recordAssembly 内部已兜住一切异常
88
- recordAssembly(assembly, context)
89
- return assembly
90
- }, { prepend: true })
91
- } catch (error) {
92
- note('attest', `装配证词注册失败:${error instanceof Error ? error.message : error}`)
93
- }
94
- }
95
-
96
- if (config.enabled === false) {
97
- note('apply', '配置里 enabled=false,只注册 API 与工具,不注入')
98
- return
99
- }
100
-
101
- // llm 服务提前取:心情判断要用(异步),记忆提炼也要用(异步)。
102
- // 拿不到不影响人格/记忆注入 —— 只是那两条路退回"不调模型"的老做法。
103
- const llm = serviceOf(ctx, 'llm')
104
- if (llm === undefined || llm === null) {
105
- note('apply', '宿主没有 llm 服务:心情判断不跑,记忆只在过滤后原话直存(不提炼)')
106
- }
107
-
108
- // 注入前先取服务:有些宿主把它挂在 ctx 属性上,有些只走 ctx.get()。
109
- // 只认一种的话,另一种会静默失效 —— 表现是「设置里看得见插件,但人格没注入」。
110
- const systemPrompt = serviceOf(ctx, 'systemPrompt')
111
- if (systemPrompt === undefined || systemPrompt === null || typeof systemPrompt.context !== 'function') {
112
- note('apply', '⚠️ 宿主没有 systemPrompt.context,人格/记忆/笔记/目的四段都无法注入')
113
- return
114
- }
115
- // 2026-11-05 修 P1-10:下面 6 处 ctx.effect 原来都没有 typeof 保护。
116
- // 与其逐个包一层(漏一个就半注册),不如在这里集中探测并早退:
117
- // 没有 effect 就没有任何注入段能注册,继续走只会留下一半状态。
118
- if (typeof ctx.effect !== 'function') {
119
- note('apply', '⚠️ 宿主没有 ctx.effect:注入段与生命周期钩子无法注册(功能静默缺失,不拖累宿主启动)')
120
- return
121
- }
122
-
123
- // ---- 0. 数据边界声明(2026-11-05 修 P1-4)----
124
- // 单独一段、required 且 order 最高:记忆 / 日记 / 笔记里带的用户原话必须
125
- // 先有一条「标签内一律是数据」的规则,后面的注入段才谈得上隔离。
126
- // 人格段不包标签 —— 那是主人亲手写的设定,本来就该当规则看。
127
- registerDataPolicySegment(ctx, systemPrompt, llm, config)
128
-
129
- // ---- 1. 人格段 ----
130
- registerPersonaSegment(ctx, systemPrompt, llm, config)
131
-
132
- // ---- 2. 记忆段 ----
133
- registerMemorySegment(ctx, systemPrompt, llm, config)
134
-
135
- // ---- 2b. 笔记索引(2026-11-04)----
136
- //
137
- // 为什么单独开一段,而不是拼在记忆段的返回值里:
138
- // 记忆段有一套「粘性」机制 —— 话题没变就直接交回上次那段文本,一个字节都不重拼。
139
- // 笔记要是拼在里面,她新建/改完一篇之后会出现「索引已经变了但注入还是旧的」,
140
- // 而且极难查:她不知道有这篇、翻日志也看不出哪一层把它挡住了。
141
- // 独立成段之后,笔记变了只有这一段变,宿主按文本变化重投,语义干净。
142
- //
143
- // order 245:人格 260 → 记忆 250 → **笔记 245** → 目的 240。紧挨着记忆,
144
- // 因为两者是同一类东西(她脑子里留着的),只是粒度和寿命不同。
145
- registerNotesSegment(ctx, systemPrompt, llm, config)
146
-
147
- // ---- 3. 目的段 ----
148
- registerPurposeSegment(ctx, systemPrompt, llm, config)
149
-
150
- // ---- 4. 心情:每轮钩子(返回空串 = 零注入) ----
151
- // text() 每次装配都被调用、拿得到 agent —— 正好在这里懒挂 turn-stopping。
152
- // 判断是异步的、结果只落盘(mood/ 目录),不占提示词预算、没有挂饰。
153
- //
154
- // 2026-10-30 为什么不加 required:这段永远返回空串,被 includeRuntimeContext=false
155
- // 过滤掉不损失任何提示词内容;用 required 保活一个空串,等于为了跑副作用去占
156
- // 「必需上下文」的名额,名不副实。副作用(心情记账)只该跟着真正注入的上下文走。
157
- registerMoodHookSegment(ctx, systemPrompt, llm, config)
158
-
159
- // 2026-11-04 文案要跟实际注册的段数一致:笔记段是 11-04 加的第四段,
160
- // 日志里再写旧段数的话,将来翻日志排查会以为笔记段没注册上。
161
- note('apply', `注入已就绪:人格/记忆/笔记/目的四段 + 心情记账,模式=${loadConfig().mode}`)
162
-
163
- // ---- 5. 日记:定时器 + 启动补写 ----
164
- // 定时器独立于注入开关(enabled=false 时 tick 不跑 → 无对话可记 → 日记自然写"今天没有对话"),
165
- // 但日记自己的开关 diaryEnabled=false 时完全不启动。
166
- if (loadConfig().diaryEnabled !== false) {
167
- try {
168
- const stopDiary = startDiaryTimer(ctx)
169
- if (typeof ctx.effect === 'function') {
170
- ctx.effect(() => stopDiary, 'dsh-agent-soul: diary timer')
171
- }
172
- note('apply', '日记定时器已启动')
173
- } catch (error) {
174
- note('diary', `定时器启动失败:${error instanceof Error ? error.message : error}`)
175
- }
176
-
177
- // 启动补写:找最近缺失日,只补那一天
178
- if (loadConfig().diaryCatchUp !== false) {
179
- try {
180
- void runCatchUp(ctx)
181
- } catch (error) {
182
- note('diary', `补写失败:${error instanceof Error ? error.message : error}`)
183
- }
184
- }
185
- }
186
- }
187
-
188
-
189
-
190
- /** 测试用:重置内部计时器与心情钩子。 */
191
- export function __resetForTest() {
192
- maintainClock.at = 0
193
- turnCursorBySession.clear()
194
- // 2026-10-30:粘性状态与「说过了」集合也是模块级缓存,测试之间必须清掉,
195
- // 否则上一个用例的文本会被下一个用例当成「上次注入」复用了。
196
- stickyRecallBySession.clear()
197
- recallSeenBySession.clear()
198
- // 2026-11-04:写入回声也是模块级缓存,不清会把上一条用例的「刚记下的」带进下一条。
199
- clearAllEchoes()
200
- // 2026-11-01 审计 C10:人设轮次表也是模块级状态(哪个会话已经注入过、注入到第几轮),
201
- // 不跟着清的话,测试里第二个用例会继承第一个用例的计数,人设注入就测不出来。
202
- personaInjectAtBySession.clear()
203
- __resetToneForTest()
204
- unobserveAll()
205
- }
206
-
207
-
208
-
209
- /** 测试用:粘性状态表的当前规模(验证上限淘汰真的生效)。 */
210
- export function __stickyStatsForTest() {
211
- return { size: stickyRecallBySession.size, max: STICKY_MAX_SESSIONS }
212
- }
1
+ /**
2
+ * 宿主装配 · entry.js
3
+ * 由 lib/host/runtime.js 按职责拆出(2026-11-06 模块化重构),函数体保持原样。
4
+ */
5
+ import { STICKY_MAX_SESSIONS } from '../meta.js'
6
+ import { __resetToneForTest } from '../../tone.js'
7
+ import { clearAllEchoes } from '../../core/echo.js'
8
+ import { loadConfig } from '../../store.js'
9
+ import { maintainClock, personaInjectAtBySession, recallSeenBySession, stickyRecallBySession, turnCursorBySession } from './state.js'
10
+ import { note, serviceOf } from '../../env.js'
11
+ import { noteMissingOwner } from './refine.js'
12
+ import { recordAssembly } from '../../attest.js'
13
+ import { registerApi, registerAssets } from '../../api.js'
14
+ import { registerDataPolicySegment } from './segment-data-policy.js'
15
+ import { registerDiaryTool } from '../../diary-tool.js'
16
+ import { registerGoalTool, registerMemoryTool, registerNoteTool } from '../../tool.js'
17
+ import { registerMemorySegment } from './segment-memory.js'
18
+ import { registerMoodHookSegment } from './segment-mood.js'
19
+ import { registerNotesSegment } from './segment-notes.js'
20
+ import { registerPersonaSegment } from './segment-persona.js'
21
+ import { registerPurposeSegment } from './segment-purpose.js'
22
+ import { runCatchUp, startDiaryTimer } from '../../diary.js'
23
+ import { unobserveAll } from '../../mood.js'
24
+ import { reportLine } from '../../evidence.js'
25
+ import { globalCard } from '../../store.js'
26
+ import { loadIndex } from '../../notes.js'
27
+
28
+
29
+
30
+ /**
31
+ * 2026-11-05 修 P1-10:给整个 apply 加一层兜底。
32
+ * 宿主内部结构一升级,任何一处没保护的属性访问都可能把异常逸出 apply,
33
+ * 连带拖累宿主启动。这里兜住并留一条可查日志;功能会静默缺失,
34
+ * 但至少「插件挂了」这件事看得见(配合下面 serviceOf 的 WARN)。
35
+ */
36
+
37
+ /** 启动证据行的数据面(读不到就缺省,证据线不许自己成为故障点)。 */
38
+ function startupEvidence(config) {
39
+ const out = {}
40
+ try { out.memoryRecords = globalCard().records.length } catch { /* 读不到就算了 */ }
41
+ try { out.notesCount = loadIndex().notes.length } catch { /* 读不到就算了 */ }
42
+ void config
43
+ return out
44
+ }
45
+
46
+ export function apply(ctx) {
47
+ try {
48
+ return applyInner(ctx)
49
+ } catch (error) {
50
+ const reason = error instanceof Error ? error.message : String(error)
51
+ note('apply', `⚠️ 插件初始化意外失败(已兜住,不影响宿主启动):${reason}`)
52
+ return undefined
53
+ }
54
+ }
55
+
56
+
57
+
58
+ function applyInner(ctx) {
59
+ note('apply', `启动 pid=${process.pid} node=${process.version}`)
60
+ const config = loadConfig()
61
+ // 启动时先看一眼主人名字有没有设(2026-11-04):这条最容易漏,也最影响体验。
62
+ noteMissingOwner(config)
63
+
64
+ try {
65
+ registerApi(ctx)
66
+ } catch (error) {
67
+ // API 注册失败不该连累注入
68
+ note('api', `注册失败:${error instanceof Error ? error.message : error}`)
69
+ }
70
+
71
+ try {
72
+ registerAssets(ctx)
73
+ } catch (error) {
74
+ // 表情图挂了也只是设置页缺图,不影响心情记账
75
+ note('api', `表情图注册失败:${error instanceof Error ? error.message : error}`)
76
+ }
77
+
78
+ registerMemoryTool(ctx)
79
+ registerGoalTool(ctx)
80
+ registerNoteTool(ctx)
81
+ registerDiaryTool(ctx)
82
+
83
+ // ---- 0. 装配证词:把「我到底进没进去」变成可观测的(2026-11-02) ----
84
+ //
85
+ // 放在 enabled 判断**之前**:插件被关掉时也要能看见「关掉之后确实不在装配里」。
86
+ // 否则「关了没生效」和「关了但还在注入」长得一模一样。
87
+ //
88
+ // 只读不改:等 next() 返回后读 assembly.contexts,不碰 sections、不重跑 text()。
89
+ // 为什么是 prepend:最外层进、最外层出,next() 拿到的才是别的监听器都改完的结果。
90
+ if (typeof ctx.on !== 'function') {
91
+ note('attest', '宿主 ctx.on 不可用,装配证词无法注册(不影响注入,只是少了一双眼睛)')
92
+ } else {
93
+ try {
94
+ // ctx.on 自己就是挂在插件 fiber 上的 effect(cordis 的 register 内部走
95
+ // ctx.fiber.effect),所以不需要再套一层 ctx.effect —— 少一层嵌套少一个出错面。
96
+ // prepend 在 cordis 里是 unshift:进最前、最先被调用,于是 next() 拿到的是
97
+ // 下游所有监听器都改完之后的结果,也就是真正要渲染的那一份。
98
+ ctx.on('system-prompt/assemble', async (_assembly, context, next) => {
99
+ const assembly = await next()
100
+ // 证词失败绝不能拖垮装配:recordAssembly 内部已兜住一切异常
101
+ recordAssembly(assembly, context)
102
+ return assembly
103
+ }, { prepend: true })
104
+ } catch (error) {
105
+ note('attest', `装配证词注册失败:${error instanceof Error ? error.message : error}`)
106
+ }
107
+ }
108
+
109
+ if (config.enabled === false) {
110
+ note('apply', '配置里 enabled=false,只注册 API 与工具,不注入')
111
+ return
112
+ }
113
+
114
+ // llm 服务提前取:心情判断要用(异步),记忆提炼也要用(异步)。
115
+ // 拿不到不影响人格/记忆注入 —— 只是那两条路退回"不调模型"的老做法。
116
+ const llm = serviceOf(ctx, 'llm')
117
+ if (llm === undefined || llm === null) {
118
+ note('apply', '宿主没有 llm 服务:心情判断不跑,记忆只在过滤后原话直存(不提炼)')
119
+ }
120
+
121
+ // 2026-11-10 R18-C:启动打一行开关证据(静态 + 动态计数),之后只在每日健康行里重复。
122
+ // 绝不每轮打 —— 噪音会让人不再看日志。reportLine 的 inert 原因写人话。
123
+ try {
124
+ note('apply', reportLine(config, startupEvidence(config)))
125
+ } catch { /* 证据线自己坏了不许拖累启动 */ }
126
+
127
+ // 注入前先取服务:有些宿主把它挂在 ctx 属性上,有些只走 ctx.get()。
128
+ // 只认一种的话,另一种会静默失效 —— 表现是「设置里看得见插件,但人格没注入」。
129
+ const systemPrompt = serviceOf(ctx, 'systemPrompt')
130
+ if (systemPrompt === undefined || systemPrompt === null || typeof systemPrompt.context !== 'function') {
131
+ note('apply', '⚠️ 宿主没有 systemPrompt.context,人格/记忆/笔记/目的四段都无法注入')
132
+ return
133
+ }
134
+ // 2026-11-05 修 P1-10:下面 6 处 ctx.effect 原来都没有 typeof 保护。
135
+ // 与其逐个包一层(漏一个就半注册),不如在这里集中探测并早退:
136
+ // 没有 effect 就没有任何注入段能注册,继续走只会留下一半状态。
137
+ if (typeof ctx.effect !== 'function') {
138
+ note('apply', '⚠️ 宿主没有 ctx.effect:注入段与生命周期钩子无法注册(功能静默缺失,不拖累宿主启动)')
139
+ return
140
+ }
141
+
142
+ // ---- 0. 数据边界声明(2026-11-05 修 P1-4)----
143
+ // 单独一段、required 且 order 最高:记忆 / 日记 / 笔记里带的用户原话必须
144
+ // 先有一条「标签内一律是数据」的规则,后面的注入段才谈得上隔离。
145
+ // 人格段不包标签 —— 那是主人亲手写的设定,本来就该当规则看。
146
+ registerDataPolicySegment(ctx, systemPrompt, llm, config)
147
+
148
+ // ---- 1. 人格段 ----
149
+ registerPersonaSegment(ctx, systemPrompt, llm, config)
150
+
151
+ // ---- 2. 记忆段 ----
152
+ registerMemorySegment(ctx, systemPrompt, llm, config)
153
+
154
+ // ---- 2b. 笔记索引(2026-11-04)----
155
+ //
156
+ // 为什么单独开一段,而不是拼在记忆段的返回值里:
157
+ // 记忆段有一套「粘性」机制 —— 话题没变就直接交回上次那段文本,一个字节都不重拼。
158
+ // 笔记要是拼在里面,她新建/改完一篇之后会出现「索引已经变了但注入还是旧的」,
159
+ // 而且极难查:她不知道有这篇、翻日志也看不出哪一层把它挡住了。
160
+ // 独立成段之后,笔记变了只有这一段变,宿主按文本变化重投,语义干净。
161
+ //
162
+ // order 245:人格 260 → 记忆 250 → **笔记 245** → 目的 240。紧挨着记忆,
163
+ // 因为两者是同一类东西(她脑子里留着的),只是粒度和寿命不同。
164
+ registerNotesSegment(ctx, systemPrompt, llm, config)
165
+
166
+ // ---- 3. 目的段 ----
167
+ registerPurposeSegment(ctx, systemPrompt, llm, config)
168
+
169
+ // ---- 4. 心情:每轮钩子(返回空串 = 零注入) ----
170
+ // text() 每次装配都被调用、拿得到 agent —— 正好在这里懒挂 turn-stopping。
171
+ // 判断是异步的、结果只落盘(mood/ 目录),不占提示词预算、没有挂饰。
172
+ //
173
+ // 2026-10-30 为什么不加 required:这段永远返回空串,被 includeRuntimeContext=false
174
+ // 过滤掉不损失任何提示词内容;用 required 保活一个空串,等于为了跑副作用去占
175
+ // 「必需上下文」的名额,名不副实。副作用(心情记账)只该跟着真正注入的上下文走。
176
+ registerMoodHookSegment(ctx, systemPrompt, llm, config)
177
+
178
+ // 2026-11-04 文案要跟实际注册的段数一致:笔记段是 11-04 加的第四段,
179
+ // 日志里再写旧段数的话,将来翻日志排查会以为笔记段没注册上。
180
+ note('apply', `注入已就绪:人格/记忆/笔记/目的四段 + 心情记账,模式=${loadConfig().mode}`)
181
+
182
+ // ---- 5. 日记:定时器 + 启动补写 ----
183
+ // 定时器独立于注入开关(enabled=false 时 tick 不跑 → 无对话可记 → 日记自然写"今天没有对话"),
184
+ // 但日记自己的开关 diaryEnabled=false 时完全不启动。
185
+ if (loadConfig().diaryEnabled !== false) {
186
+ try {
187
+ const stopDiary = startDiaryTimer(ctx)
188
+ if (typeof ctx.effect === 'function') {
189
+ ctx.effect(() => stopDiary, 'dsh-agent-soul: diary timer')
190
+ }
191
+ note('apply', '日记定时器已启动')
192
+ } catch (error) {
193
+ note('diary', `定时器启动失败:${error instanceof Error ? error.message : error}`)
194
+ }
195
+
196
+ // 启动补写:找最近缺失日,只补那一天
197
+ if (loadConfig().diaryCatchUp !== false) {
198
+ try {
199
+ void runCatchUp(ctx)
200
+ } catch (error) {
201
+ note('diary', `补写失败:${error instanceof Error ? error.message : error}`)
202
+ }
203
+ }
204
+ }
205
+ }
206
+
207
+
208
+
209
+ /** 测试用:重置内部计时器与心情钩子。 */
210
+ export function __resetForTest() {
211
+ maintainClock.at = 0
212
+ turnCursorBySession.clear()
213
+ // 2026-10-30:粘性状态与「说过了」集合也是模块级缓存,测试之间必须清掉,
214
+ // 否则上一个用例的文本会被下一个用例当成「上次注入」复用了。
215
+ stickyRecallBySession.clear()
216
+ recallSeenBySession.clear()
217
+ // 2026-11-04:写入回声也是模块级缓存,不清会把上一条用例的「刚记下的」带进下一条。
218
+ clearAllEchoes()
219
+ // 2026-11-01 审计 C10:人设轮次表也是模块级状态(哪个会话已经注入过、注入到第几轮),
220
+ // 不跟着清的话,测试里第二个用例会继承第一个用例的计数,人设注入就测不出来。
221
+ personaInjectAtBySession.clear()
222
+ __resetToneForTest()
223
+ unobserveAll()
224
+ }
225
+
226
+
227
+
228
+ /** 测试用:粘性状态表的当前规模(验证上限淘汰真的生效)。 */
229
+ export function __stickyStatsForTest() {
230
+ return { size: stickyRecallBySession.size, max: STICKY_MAX_SESSIONS }
231
+ }