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,358 +1,367 @@
1
- /**
2
- * 状态与持久化编排 · cache.js
3
- * 由 lib/store.js 按职责拆出(2026-11-06 模块化重构),函数体保持原样。
4
- */
5
- import { DEFAULTS } from '../memory.js'
6
- import { atomicWrite, configPath, exists, memoryDir, readText } from '../paths.js'
7
- import { normalizeState } from '../purpose.js'
8
- import { note } from '../env.js'
9
- import { clearAll, invalidate, readThrough, settle } from './file-cache.js'
10
-
11
- // 保持公共导出路径不变:cards.js / mood-state.js 仍从 './cache.js' 拿 mtimeOf。
12
- export { mtimeOf } from './file-cache.js'
13
-
14
-
15
- export const cardCache = new Map()
16
-
17
- export const moodCache = new Map()
18
-
19
- /** 单值缓存也用 Map,固定 key,好让四类状态共用同一套 readThrough / settle。 */
20
- const SINGLE = 'value'
21
-
22
- /** 目的状态缓存。 */
23
- const purposeStore = new Map()
24
-
25
- /** 配置缓存带 mtime:用户可能直接用编辑器改 persona.json(README 明确说可以),
26
- * 只在内存里缓存会让外部改动永不生效。跟记忆卡同一套「mtime 失效」模式。 */
27
- const configStore = new Map()
28
-
29
-
30
- /** 配置文件路径(为了不破坏 dsh-agent-md,用另一个文件名)。 */
31
- export const CONFIG_FILE = () => configPath()
32
-
33
-
34
- export function loadCached(key, file, loader, fallback) {
35
- return readThrough(cardCache, key, file, (f) => loader(f) ?? fallback())
36
- }
37
-
38
-
39
- /** 目的状态文件。 */
40
- export const PURPOSE_FILE = () => `${memoryDir()}/purpose.json`
41
-
42
-
43
- export function purposeState() {
44
- return readThrough(purposeStore, SINGLE, PURPOSE_FILE(), (file) => {
45
- let raw = null
46
- try {
47
- const text = readText(file)
48
- raw = text === '' ? null : JSON.parse(text)
49
- } catch {
50
- raw = null
51
- }
52
- return normalizeState(raw)
53
- })
54
- }
55
-
56
-
57
- export function savePurposeState(state) {
58
- // 2026-11-05 DSH 复核收尾:S3 只补了「结果不再被忽略 + 记日志」,清缓存仍无条件
59
- // 执行 —— 这是「同类 bug 只修了一半」,看起来修过其实更危险。
60
- // purposeState() 按 mtime 判缓存,缓存一清就强制回盘读;写失败时盘上还是旧内容,
61
- // 刚写进去的新状态**当场回退**,调用方还拿不到任何失败信号。
62
- // 现在:成功才清缓存;失败把「新值 + 当前磁盘 mtime」留在缓存里,内存视图不回退,
63
- // 并返回结构化失败结果。内部调用点(tick / maintain / 情绪牵引)忽略返回值是安全的:
64
- // 日志已写明「重启会丢失」,且内存不会回退。
65
- const file = PURPOSE_FILE()
66
- const written = atomicWrite(file, `${JSON.stringify(state, null, 2)}\n`)
67
- if (written?.ok !== true) {
68
- const error = written?.error ?? '未知原因'
69
- note('purpose', `⚠️ 目的状态写盘失败:${error}(改动保留在内存,重启会丢失,请检查磁盘/权限)`)
70
- // 写失败:把内存新值与当前磁盘 mtime 绑定,purposeState() 不会回退成旧值。
71
- settle(purposeStore, SINGLE, file, normalizeState(state) ?? state)
72
- return { ok: false, error, state }
73
- }
74
- // 写成功:失效,下次按新 mtime 重读盘上内容(跨进程改动也能看见)。
75
- invalidate(purposeStore, SINGLE)
76
- return { ok: true, state }
77
- }
78
-
79
-
80
- /** 插件配置。 */
81
- export const DEFAULT_CONFIG = Object.freeze({
82
- enabled: true,
83
- /** 设置页接口只允许本机回环请求(2026-11-04)。
84
- * 默认 true:本机任何进程都能 POST 改人格 / 覆盖笔记,这事必须收口。
85
- * 万一某些宿主的 webServer 走代理、remoteAddress 不是回环,改 false 可自救。 */
86
- apiLoopbackOnly: true,
87
- /** 人格:stack = 全局 + 项目按小节合并(默认);exclusive = 有项目就不注入全局 */
88
- mode: 'stack',
89
- includeGlobal: true,
90
- projectPersonaEnabled: true,
91
- localNames: ['AGENT.md'],
92
- /** 记忆 */
93
- // 注入预算只留一个默认值来源:memory.js 的 DEFAULTS(2026-10-30 统一,默认 3200)。
94
- // 这里以前写死 1600、memory.js 写 2400,实际生效 1600 而告警按 2400 算。
95
- injectMaxChars: DEFAULTS.injectMaxChars,
96
- /** 注入时按当前用户消息召回相关区(false = 退回整卡渲染,逐字节等价旧行为)。 */
97
- memoryRecall: DEFAULTS.memoryRecall,
98
- // 2026-10-31 补:设置页和 index.js 一直在读这个开关,但默认值表里漏了它。
99
- // 缺默认值时行为仍然「默认开启」(undefined === false 不成立),
100
- // 但设置页显示不出默认状态,配置项也容易被当成不存在。补上。
101
- memoryEnabled: true,
102
- /** 相关区最多召回几条。 */
103
- memoryRecallTopK: DEFAULTS.memoryRecallTopK,
104
- projectMemoryEnabled: true,
105
- /** 跨工作区双写门槛:自动提取的记忆同时满足「关于主人本人」+ 重要度 ≥ 这个值,
106
- * 就额外往全局卡写一份 —— 换工作区也认得你。调高更严、调低更舍得记。 */
107
- globalPromoteImportance: 62,
108
- /** 自动提取时先让模型提炼成「记忆」再入库(关掉就退回原话直存,会变成流水账)。
109
- * 提炼失败/超时会自动退回原话,不会丢信息。 */
110
- memoryRefine: true,
111
- memoryRefineProvider: '',
112
- memoryRefineModel: '',
113
- /** 自动记忆的重要度门槛,按 kind 分档(2026-10-30)。
114
- * 默认值只在 memory.js 的 DEFAULTS 里定义一次,这里引用不复制字面量。
115
- * event=70(一次性经历要够格才占位置)/ 其余=42(画像类保持宽口径)。 */
116
- autoImportanceEvent: DEFAULTS.autoImportanceEvent,
117
- autoImportanceDefault: DEFAULTS.autoImportanceDefault,
118
-
119
- // ---- 2026-11-04(B6):把「只在 memory.js 的 DEFAULTS 里、谁都改不到」的 9 个参数
120
- // 补进公开配置。之前它们没有默认值条目 → loadConfig() 不返回 → /state 不回传 →
121
- // 设置页没有控件 → 只能手改 persona.json 才生效,等于「有个旋钮但没装在面板上」。
122
- //
123
- // 值一律引用 DEFAULTS,不复制字面量(injectMaxChars 那次 2400/1600 打架就是这么来的)。
124
- //
125
- // 但「有默认值」不等于「该给滑块」。这些参数调坏了是静默崩的(maxRecords=5 的表现是
126
- // 「她什么都不记得了」,没有任何报错),所以设置页上它们只以**档位**形式出现,
127
- // 不给直接改数字的口子。真正需要单独暴露的只有下面标了「可单列」的三个。
128
- recentDays: DEFAULTS.recentDays,
129
- fuzzyAfterDays: DEFAULTS.fuzzyAfterDays,
130
- forgetAfterDays: DEFAULTS.forgetAfterDays,
131
- minOwnerImportance: DEFAULTS.minOwnerImportance,
132
- maxRecords: DEFAULTS.maxRecords,
133
- /** 可单列:告警字数,调大了只是提醒晚一点,不会破坏数据 */
134
- warnChars: DEFAULTS.warnChars,
135
- autoCompact: DEFAULTS.autoCompact,
136
- /** 可单列:一次维护最多动几条,调小了只是慢 */
137
- maxPerTick: DEFAULTS.maxPerTick,
138
- /** 维护时段(小时)。2026-11-04 之前它只被 clamp、从没被读 —— 死配置。
139
- * 接上之前先保持 0 = 不限制时段,避免「设了却不生效」再来一次。 */
140
- dailyHour: DEFAULTS.dailyHour,
141
- // 2026-10-31:新会话第一轮带上「最近」—— 最近几天的日记 + 今天到目前为止的流水。
142
- //
143
- // 为什么需要:树树不会在一个对话里做完所有事(修插件、QQ、闲聊是分开的会话)。
144
- // 记忆卡只有零碎事实,日记只写到「昨天」,所以新开一个对话时她不知道
145
- // 今天早些时候在别的对话里做过什么。这条是补那条通路的。
146
- // 0 = 关闭对应项。
147
- memoryRecentDiaryDays: 2,
148
- memoryRecentChatChars: 3000,
149
- // 私密日记要不要也进「最近」。默认 false:私密是写给自己的,
150
- // 不该默认出现在每个新对话的开场里。
151
- memoryRecentDiaryIncludePrivate: false,
152
- /** 目的机制 */
153
- purposeEnabled: true,
154
- /** 笔记(2026-11-04):她自己写的 md,永不衰减。
155
- * 跟记忆的区别:记忆是一句一条、会淡忘;笔记成篇、她自己组织、一直留着。 */
156
- notesEnabled: true,
157
- /** 笔记索引的注入预算。只注入「标题 + 字数 + 摘要」,正文靠 soul_note 按需读,
158
- * 所以这个值不用大 —— 600 字够列 8~10 篇。 */
159
- notesInjectMaxChars: 600,
160
- /** 心情(每轮判断一次心情变化;不注入提示词、无挂饰) */
161
- moodEnabled: true,
162
- moodBase: 70,
163
- moodFloor: 0,
164
- moodDecayHalfHours: 12,
165
- moodSigMood: 3,
166
- moodSigDim: 5,
167
- moodSelfName: '小糖',
168
- // ---- 主人是谁(2026-11-04)----
169
- //
170
- // 值一律引用 memory.js 的 DEFAULTS,不复制字面量(跟 injectMaxChars 那次
171
- // 1600/2400 打架是同一个教训)。默认是空串 —— 陌生人装完不会被告知
172
- // 「你是树树的伴侣」。空串时提示词整句省略,见 mood.js 的 buildJudgeSystem。
173
- ownerName: DEFAULTS.ownerName,
174
- ownerGender: DEFAULTS.ownerGender,
175
- relationship: DEFAULTS.relationship,
176
- /**
177
- * 已废弃(2026-11-04):旧版把主人名字写在 `moodOwnerName` 里。
178
- * 现在统一到 `ownerName`,这个键**只为两件事保留**:
179
- * ① 迁移:loadConfig 发现配置里没有 ownerName、却有它时,把值搬过去并写回;
180
- * ② 兼容:外部代码(旧设置页、手写调用)直接传 moodOwnerName 时,
181
- * normalizeMoodConfig 仍能认出来。
182
- * 新代码不要再读它。默认空串 = 没设过。
183
- */
184
- moodOwnerName: '',
185
- // 2026-11-04:别名是「主人平时怎么叫她」,原来误填成 '树树'(跟 moodOwnerName
186
- // 一样),判定提示词会写成「树树平时会这样叫你:树树」。默认空,空时整句省略。
187
- moodSelfAliases: '',
188
- moodJudgeProvider: '',
189
- moodJudgeModel: '',
190
- // 心情语气(2026-11-01):隔几轮往用户消息后挂一行。
191
- // 中档什么都不发(大多数时候),低/高才发,且每 N 轮才发一次。
192
- moodToneInject: true,
193
- moodToneEveryTurns: 7,
194
- moodToneThreshold: 8,
195
- /** 日记:开机时写前一天的那一篇(公开 + 私密) */
196
- diaryEnabled: true,
197
- // 2026-10-31:原来这里是 diarySchedule: '22:00'(每天 22 点触发)。
198
- // 机器的开机时间不固定——可能几天不开,也可能一直不关——定点闹钟靠不住,
199
- // 所以改成「第二天写前一天的」:开机写一次,看门狗定时兜底。
200
- //
201
- // 这个键现在**完全停用**:不再触发定时(定时器已删),
202
- // 也不再参与日记的「一天边界」(2026-10-31 起固定为自然日 00:00~24:00,
203
- // 见 diary.js 的 diaryDayBoundaries)。留着只为不让旧配置报错。
204
- diarySchedule: '22:00',
205
- // 看门狗间隔(分钟):电脑一直不关机时,每隔这么久看一眼昨天写没写。
206
- // 只是两次文件存在性判断,几乎不花钱;真正烧钱的生成一天最多一次。
207
- diaryWatchdogMinutes: 30,
208
- diaryCatchUp: true,
209
- diaryBackfillDays: 4,
210
- diaryOverwrite: true,
211
- /** 让她自己写日记(2026-11-04)。
212
- * true = 先投消息让她用 soul_diary 写,等文件出现;等不到才由插件兜底生成
213
- * false = 老路子,插件直接调模型生成(2026-10-31 那版)
214
- * 兜底永远在,所以这一项关不关都不会丢日记,只影响「谁来写」。 */
215
- diaryAgentWrite: true,
216
- /** 等她写多久(毫秒)。写一篇日记要几十秒,3 分钟够;
217
- * 设太短会经常掉进兜底,设太长开机后日记会迟到。 */
218
- diaryAgentTimeoutMs: 180000,
219
- diaryManualNote: true,
220
- diaryPublicTone: '',
221
- diaryPrivateTone: '',
222
- // 喂给日记模型的对话预算(2026-11-02 改)。
223
- // 原来 30000 且超了从前面截断 —— 砍掉的正好是早上那半段,而且那 30000 字里
224
- // 80% 是技术细节。现在改成按分数挑(见 diary-pick.js),8000 字就够写,
225
- // 生活内容占比从 20% 升到 87%,全天跨度也保住了。
226
- diaryMaxConversationChars: 8000,
227
- // 已停用,仅为兼容旧配置保留(2026-11-04 核对:只有废弃的 summarizeConversations
228
- // 还在读它,日记主流程不做摘要;删了会让老配置报错)。
229
- diaryMaxSummaryChars: 2000,
230
- // 日记里的情绪底色:给几条「当时你自己的想法」。公开那篇是要拿给人看的,少给几条。
231
- // 设 0 或关掉心情(moodEnabled=false)就完全不带情绪段。
232
- diaryPublicMoodMoments: 3,
233
- diaryPrivateMoodMoments: 6,
234
- // 投第二条(私密)之前,等公开那篇落盘的最长时间。
235
- //
236
- // 2026-11-04:**这个配置已经删掉**。它存在的理由是当年两条消息并发投递、
237
- // 需要等公开落盘再投私密。现在投递是串行的(公开等到文件出现才轮到私密),
238
- // 而且她写、插件兜底两条路都会保证顺序,没有可等的东西了。
239
- // 留着它只会让人以为「把它调大能解决竞态」——那是个假旋钮。
240
- diarySummarizeProvider: '',
241
- diarySummarizeModel: '',
242
- // 对话流水保留期(2026-11-05 修 P1-5 的另一半,机制见 lib/retention.js)。
243
- // 默认 0 = 永不自动删除;老配置文件没有这两个键,loadConfig 的
244
- // {...DEFAULT_CONFIG, ...raw} 会自动补 0,升级后一个文件都不会动。
245
- // 设了值也要 >= 补写能追溯的天数(findMissingDay 查 7 天,建议 >= 30),
246
- // 否则补写时那天的对话已经被清掉,那一天就永远补不回来了。
247
- conversationRetentionDays: 0,
248
- // 目录总量上限(字节),0 = 不限。超出时从最旧的整天 .jsonl 开始删,今天永不删。
249
- conversationMaxTotalBytes: 0,
250
- // 归档档案体积上限(字节),0 = 不启用(默认)。超过时把 archive.jsonl
251
- // 另存为带时间戳的分片,旧内容完整保留、绝不删除;recallArchived 会连分片一起查。
252
- // 默认 0 时 rotateArchiveIfNeeded 连 stat 都不做,升级后一个文件都不会动。
253
- archiveMaxBytes: 0,
254
- // 绑定的日记会话(2026-10-31):只认这个 id,不再自建会话。
255
- // 空串 = 未绑定,日记触发时跳过并提示去设置页绑定。
256
- diarySessionId: DEFAULTS.diarySessionId,
257
- // 这次绑定是什么时候开始的(2026-11-04,毫秒时间戳)。0 = 老配置没有这个字段。
258
- diarySessionBornAt: 0,
259
- // 私密日记正文是否允许在设置页查看(默认 false = 只报存在性)。
260
- diaryPrivateVisible: DEFAULTS.diaryPrivateVisible,
261
- diarySummarizeTimeoutMs: 30000
262
- })
263
-
264
-
265
- /**
266
- * 旧配置迁移:把 `moodOwnerName` 搬到 `ownerName`(2026-11-04)。
267
- *
268
- * ── 为什么必须有这一步 ──
269
- * 0.5.2 及以前,主人名字只有一个来源:`moodOwnerName`,默认写死 `'树树'`。
270
- * 现在默认值改成了空串(陌生人装完不该被告知「你是树树的伴侣」),
271
- * 但老用户的 persona.json 里**只有旧键**、没有新键 —— 如果什么都不做,
272
- * 升级之后 prompt 里「关于谁」的整段会静默消失,表现是「她突然不认识我了」。
273
- *
274
- * 所以:只要配置里没有 `ownerName` 这个键,就认为它是旧配置,
275
- * · 有 `moodOwnerName` 就搬它的值(用户可能自己改过,不该被覆盖);
276
- * · 没有就用旧版的默认值 `'树树'`;
277
- * 然后把 `ownerName` **写回文件** —— 只迁一次,之后这个键就存在了。
278
- *
279
- * 全新安装不会误迁:新版本的 saveConfig 写的是 merge 过 DEFAULT_CONFIG 的完整配置,
280
- * 里面天然带 `ownerName` 键(哪怕是空串);而安装后没改过任何设置时,
281
- * 配置文件压根不存在。两种情况都不会走进来。
282
- *
283
- * 写回失败不算错误(可能只是只读),内存里已经用迁移后的值了;
284
- * 日志只记一次,别把 soul.log 刷满。
285
- *
286
- * @returns {string} 迁移后的 ownerName;没迁移返回 null
287
- */
288
- const LEGACY_OWNER_NAME = '树树'
289
-
290
- let ownerMigrateNoted = false
291
-
292
-
293
- function migrateOwnerName(file, raw) {
294
- if (raw === null || typeof raw !== 'object' || Array.isArray(raw)) return null
295
- // 已经把新键显式写进配置(哪怕是空串 = 「我就是不设」)→ 尊重它,不迁移
296
- if (Object.prototype.hasOwnProperty.call(raw, 'ownerName')) return null
297
- // 没有配置文件 / 文件读不出东西(JSON 坏了)→ 不猜。坏文件写回会把它整份抹掉。
298
- if (!exists(file) || Object.keys(raw).length === 0) return null
299
-
300
- const legacy = typeof raw.moodOwnerName === 'string' ? raw.moodOwnerName.trim() : ''
301
- const ownerName = legacy !== '' ? legacy : LEGACY_OWNER_NAME
302
- const next = { ...raw, ownerName }
303
- try {
304
- const written = atomicWrite(file, `${JSON.stringify(next, null, 2)}\n`)
305
- if (written?.ok !== true) note('config', `⚠️ ownerName 迁移写盘失败(内存已按新值运行):${written?.error ?? '未知原因'}`)
306
- if (!ownerMigrateNoted) {
307
- ownerMigrateNoted = true
308
- note('config', `已从旧配置迁移 ownerName=${ownerName}(来源:${legacy !== '' ? 'moodOwnerName' : '旧版默认值'}),已写回 persona.json`)
309
- }
310
- } catch (error) {
311
- if (!ownerMigrateNoted) {
312
- ownerMigrateNoted = true
313
- note('config', `旧配置迁移 ownerName=${ownerName} 写回失败(本次仍按迁移后的值运行):${error instanceof Error ? error.message : error}`)
314
- }
315
- }
316
- return ownerName
317
- }
318
-
319
-
320
- export function loadConfig() {
321
- return readThrough(configStore, SINGLE, CONFIG_FILE(), (file) => {
322
- let raw = {}
323
- try {
324
- const text = readText(file)
325
- raw = text === '' ? {} : JSON.parse(text)
326
- } catch {
327
- raw = {}
328
- }
329
- const migrated = migrateOwnerName(file, raw)
330
- const value = { ...DEFAULT_CONFIG, ...(raw !== null && typeof raw === 'object' ? raw : {}) }
331
- if (migrated !== null) value.ownerName = migrated
332
- return value
333
- })
334
- }
335
-
336
-
337
- export function saveConfig(patch) {
338
- const value = { ...loadConfig(), ...(patch ?? {}) }
339
- const written = atomicWrite(CONFIG_FILE(), `${JSON.stringify(value, null, 2)}\n`)
340
- if (written?.ok !== true) {
341
- // 2026-11-05 S3:这一处原来是 P0-4 的同型漏检 —— 写盘失败也回 200「配置已保存」。
342
- // 现在抛给调用方,handler 的外层 catch 会回 500;缓存清空避免内存里留假配置。
343
- invalidate(configStore, SINGLE)
344
- throw new Error(`配置写盘失败:${written?.error ?? '未知原因'}`)
345
- }
346
- // 写盘后把已知新值与写后 mtime 绑定,保证进程内一致(不必再读一次盘)
347
- settle(configStore, SINGLE, CONFIG_FILE(), value)
348
- return value
349
- }
350
-
351
-
352
- /** 测试用:丢掉所有缓存。 */
353
- export function resetCaches() {
354
- clearAll(cardCache)
355
- clearAll(moodCache)
356
- clearAll(purposeStore)
357
- clearAll(configStore)
358
- }
1
+ /**
2
+ * 状态与持久化编排 · cache.js
3
+ * 由 lib/store.js 按职责拆出(2026-11-06 模块化重构),函数体保持原样。
4
+ */
5
+ import { DEFAULTS } from '../memory.js'
6
+ import { atomicWrite, configPath, exists, memoryDir, readText } from '../paths.js'
7
+ import { normalizeState } from '../purpose.js'
8
+ import { note } from '../env.js'
9
+ import { clearAll, invalidate, readThrough, settle } from './file-cache.js'
10
+
11
+ // 保持公共导出路径不变:cards.js / mood-state.js 仍从 './cache.js' 拿 mtimeOf。
12
+ export { mtimeOf } from './file-cache.js'
13
+
14
+
15
+ export const cardCache = new Map()
16
+
17
+ export const moodCache = new Map()
18
+
19
+ /** 单值缓存也用 Map,固定 key,好让四类状态共用同一套 readThrough / settle。 */
20
+ const SINGLE = 'value'
21
+
22
+ /** 目的状态缓存。 */
23
+ const purposeStore = new Map()
24
+
25
+ /** 配置缓存带 mtime:用户可能直接用编辑器改 persona.json(README 明确说可以),
26
+ * 只在内存里缓存会让外部改动永不生效。跟记忆卡同一套「mtime 失效」模式。 */
27
+ const configStore = new Map()
28
+
29
+
30
+ /** 配置文件路径(为了不破坏 dsh-agent-md,用另一个文件名)。 */
31
+ export const CONFIG_FILE = () => configPath()
32
+
33
+
34
+ export function loadCached(key, file, loader, fallback) {
35
+ return readThrough(cardCache, key, file, (f) => loader(f) ?? fallback())
36
+ }
37
+
38
+
39
+ /** 目的状态文件。 */
40
+ export const PURPOSE_FILE = () => `${memoryDir()}/purpose.json`
41
+
42
+
43
+ export function purposeState() {
44
+ return readThrough(purposeStore, SINGLE, PURPOSE_FILE(), (file) => {
45
+ let raw = null
46
+ try {
47
+ const text = readText(file)
48
+ raw = text === '' ? null : JSON.parse(text)
49
+ } catch {
50
+ raw = null
51
+ }
52
+ return normalizeState(raw)
53
+ })
54
+ }
55
+
56
+
57
+ export function savePurposeState(state) {
58
+ // 2026-11-05 DSH 复核收尾:S3 只补了「结果不再被忽略 + 记日志」,清缓存仍无条件
59
+ // 执行 —— 这是「同类 bug 只修了一半」,看起来修过其实更危险。
60
+ // purposeState() 按 mtime 判缓存,缓存一清就强制回盘读;写失败时盘上还是旧内容,
61
+ // 刚写进去的新状态**当场回退**,调用方还拿不到任何失败信号。
62
+ // 现在:成功才清缓存;失败把「新值 + 当前磁盘 mtime」留在缓存里,内存视图不回退,
63
+ // 并返回结构化失败结果。内部调用点(tick / maintain / 情绪牵引)忽略返回值是安全的:
64
+ // 日志已写明「重启会丢失」,且内存不会回退。
65
+ const file = PURPOSE_FILE()
66
+ const written = atomicWrite(file, `${JSON.stringify(state, null, 2)}\n`)
67
+ if (written?.ok !== true) {
68
+ const error = written?.error ?? '未知原因'
69
+ note('purpose', `⚠️ 目的状态写盘失败:${error}(改动保留在内存,重启会丢失,请检查磁盘/权限)`)
70
+ // 写失败:把内存新值与当前磁盘 mtime 绑定,purposeState() 不会回退成旧值。
71
+ settle(purposeStore, SINGLE, file, normalizeState(state) ?? state)
72
+ return { ok: false, error, state }
73
+ }
74
+ // 写成功:失效,下次按新 mtime 重读盘上内容(跨进程改动也能看见)。
75
+ invalidate(purposeStore, SINGLE)
76
+ return { ok: true, state }
77
+ }
78
+
79
+
80
+ /** 插件配置。 */
81
+ export const DEFAULT_CONFIG = Object.freeze({
82
+ enabled: true,
83
+ /** 设置页接口只允许本机回环请求(2026-11-04)。
84
+ * 默认 true:本机任何进程都能 POST 改人格 / 覆盖笔记,这事必须收口。
85
+ * 万一某些宿主的 webServer 走代理、remoteAddress 不是回环,改 false 可自救。 */
86
+ apiLoopbackOnly: true,
87
+ /** 人格:stack = 全局 + 项目按小节合并(默认);exclusive = 有项目就不注入全局 */
88
+ mode: 'stack',
89
+ includeGlobal: true,
90
+ projectPersonaEnabled: true,
91
+ localNames: ['AGENT.md'],
92
+ /** 记忆 */
93
+ // 注入预算只留一个默认值来源:memory.js 的 DEFAULTS(2026-10-30 统一,默认 3200)。
94
+ // 这里以前写死 1600、memory.js 写 2400,实际生效 1600 而告警按 2400 算。
95
+ injectMaxChars: DEFAULTS.injectMaxChars,
96
+ /** 注入时按当前用户消息召回相关区(false = 退回整卡渲染,逐字节等价旧行为)。 */
97
+ memoryRecall: DEFAULTS.memoryRecall,
98
+ // 2026-10-31 补:设置页和 index.js 一直在读这个开关,但默认值表里漏了它。
99
+ // 缺默认值时行为仍然「默认开启」(undefined === false 不成立),
100
+ // 但设置页显示不出默认状态,配置项也容易被当成不存在。补上。
101
+ memoryEnabled: true,
102
+ /** 相关区最多召回几条。 */
103
+ memoryRecallTopK: DEFAULTS.memoryRecallTopK,
104
+ projectMemoryEnabled: true,
105
+ /** 跨工作区双写门槛:自动提取的记忆同时满足「关于主人本人」+ 重要度 ≥ 这个值,
106
+ * 就额外往全局卡写一份 —— 换工作区也认得你。调高更严、调低更舍得记。 */
107
+ globalPromoteImportance: 62,
108
+ /** 自动提取时先让模型提炼成「记忆」再入库(关掉就退回原话直存,会变成流水账)。
109
+ * 提炼失败/超时会自动退回原话,不会丢信息。 */
110
+ memoryRefine: true,
111
+ memoryRefineProvider: '',
112
+ memoryRefineModel: '',
113
+ /** 自动记忆的重要度门槛,按 kind 分档(2026-10-30)。
114
+ * 默认值只在 memory.js 的 DEFAULTS 里定义一次,这里引用不复制字面量。
115
+ * event=70(一次性经历要够格才占位置)/ 其余=42(画像类保持宽口径)。 */
116
+ autoImportanceEvent: DEFAULTS.autoImportanceEvent,
117
+ autoImportanceDefault: DEFAULTS.autoImportanceDefault,
118
+
119
+ // ---- 2026-11-04(B6):把「只在 memory.js 的 DEFAULTS 里、谁都改不到」的 9 个参数
120
+ // 补进公开配置。之前它们没有默认值条目 → loadConfig() 不返回 → /state 不回传 →
121
+ // 设置页没有控件 → 只能手改 persona.json 才生效,等于「有个旋钮但没装在面板上」。
122
+ //
123
+ // 值一律引用 DEFAULTS,不复制字面量(injectMaxChars 那次 2400/1600 打架就是这么来的)。
124
+ //
125
+ // 但「有默认值」不等于「该给滑块」。这些参数调坏了是静默崩的(maxRecords=5 的表现是
126
+ // 「她什么都不记得了」,没有任何报错),所以设置页上它们只以**档位**形式出现,
127
+ // 不给直接改数字的口子。真正需要单独暴露的只有下面标了「可单列」的三个。
128
+ recentDays: DEFAULTS.recentDays,
129
+ fuzzyAfterDays: DEFAULTS.fuzzyAfterDays,
130
+ forgetAfterDays: DEFAULTS.forgetAfterDays,
131
+ minOwnerImportance: DEFAULTS.minOwnerImportance,
132
+ maxRecords: DEFAULTS.maxRecords,
133
+ /** 可单列:告警字数,调大了只是提醒晚一点,不会破坏数据 */
134
+ warnChars: DEFAULTS.warnChars,
135
+ autoCompact: DEFAULTS.autoCompact,
136
+ /** 可单列:一次维护最多动几条,调小了只是慢 */
137
+ maxPerTick: DEFAULTS.maxPerTick,
138
+ /** 维护时段(小时)。2026-11-04 之前它只被 clamp、从没被读 —— 死配置。
139
+ * 接上之前先保持 0 = 不限制时段,避免「设了却不生效」再来一次。 */
140
+ dailyHour: DEFAULTS.dailyHour,
141
+ // 2026-10-31:新会话第一轮带上「最近」—— 最近几天的日记 + 今天到目前为止的流水。
142
+ //
143
+ // 为什么需要:树树不会在一个对话里做完所有事(修插件、QQ、闲聊是分开的会话)。
144
+ // 记忆卡只有零碎事实,日记只写到「昨天」,所以新开一个对话时她不知道
145
+ // 今天早些时候在别的对话里做过什么。这条是补那条通路的。
146
+ // 0 = 关闭对应项。
147
+ memoryRecentDiaryDays: 2,
148
+ memoryRecentChatChars: 3000,
149
+ // 私密日记要不要也进「最近」。默认 false:私密是写给自己的,
150
+ // 不该默认出现在每个新对话的开场里。
151
+ memoryRecentDiaryIncludePrivate: false,
152
+ /** 目的机制 */
153
+ purposeEnabled: true,
154
+ /** 笔记(2026-11-04):她自己写的 md,永不衰减。
155
+ * 跟记忆的区别:记忆是一句一条、会淡忘;笔记成篇、她自己组织、一直留着。 */
156
+ notesEnabled: true,
157
+ /** 笔记索引的注入预算。只注入「标题 + 字数 + 摘要」,正文靠 soul_note 按需读,
158
+ * 所以这个值不用大 —— 600 字够列 8~10 篇。 */
159
+ notesInjectMaxChars: 600,
160
+ /** 心情:每轮判断一次心情变化;状态注入为 `soul:mood` 段(order 230),语气另由 moodToneInject 控 */
161
+ moodEnabled: true,
162
+ moodBase: 70,
163
+ moodFloor: 0,
164
+ moodDecayHalfHours: 12,
165
+ moodSigMood: 3,
166
+ moodSigDim: 5,
167
+ moodSelfName: '小糖',
168
+ // ---- 主人是谁(2026-11-04)----
169
+ //
170
+ // 值一律引用 memory.js 的 DEFAULTS,不复制字面量(跟 injectMaxChars 那次
171
+ // 1600/2400 打架是同一个教训)。默认是空串 —— 陌生人装完不会被告知
172
+ // 「你是树树的伴侣」。空串时提示词整句省略,见 mood.js 的 buildJudgeSystem。
173
+ ownerName: DEFAULTS.ownerName,
174
+ ownerGender: DEFAULTS.ownerGender,
175
+ relationship: DEFAULTS.relationship,
176
+ /**
177
+ * 已废弃(2026-11-04):旧版把主人名字写在 `moodOwnerName` 里。
178
+ * 现在统一到 `ownerName`,这个键**只为两件事保留**:
179
+ * ① 迁移:loadConfig 发现配置里没有 ownerName、却有它时,把值搬过去并写回;
180
+ * ② 兼容:外部代码(旧设置页、手写调用)直接传 moodOwnerName 时,
181
+ * normalizeMoodConfig 仍能认出来。
182
+ * 新代码不要再读它。默认空串 = 没设过。
183
+ */
184
+ moodOwnerName: '',
185
+ // 2026-11-04:别名是「主人平时怎么叫她」,原来误填成 '树树'(跟 moodOwnerName
186
+ // 一样),判定提示词会写成「树树平时会这样叫你:树树」。默认空,空时整句省略。
187
+ moodSelfAliases: '',
188
+ moodJudgeProvider: '',
189
+ moodJudgeModel: '',
190
+ // 心情语气(2026-11-01):隔几轮往用户消息后挂一行。
191
+ // 中档什么都不发(大多数时候),低/高才发,且每 N 轮才发一次。
192
+ moodToneInject: true,
193
+ moodToneEveryTurns: 7,
194
+ moodToneThreshold: 8,
195
+ /** 日记:开机时写前一天的那一篇(公开 + 私密) */
196
+ diaryEnabled: true,
197
+ // 2026-10-31:原来这里是 diarySchedule: '22:00'(每天 22 点触发)。
198
+ // 机器的开机时间不固定——可能几天不开,也可能一直不关——定点闹钟靠不住,
199
+ // 所以改成「第二天写前一天的」:开机写一次,看门狗定时兜底。
200
+ //
201
+ // 这个键现在**完全停用**:不再触发定时(定时器已删),
202
+ // 也不再参与日记的「一天边界」(2026-10-31 起固定为自然日 00:00~24:00,
203
+ // 见 diary.js 的 diaryDayBoundaries)。留着只为不让旧配置报错。
204
+ diarySchedule: '22:00',
205
+ // 看门狗间隔(分钟):电脑一直不关机时,每隔这么久看一眼昨天写没写。
206
+ // 只是两次文件存在性判断,几乎不花钱;真正烧钱的生成一天最多一次。
207
+ diaryWatchdogMinutes: 30,
208
+ diaryCatchUp: true,
209
+ diaryBackfillDays: 4,
210
+ diaryOverwrite: true,
211
+ /** 让她自己写日记(2026-11-04)。
212
+ * true = 先投消息让她用 soul_diary 写,等文件出现;等不到才由插件兜底生成
213
+ * false = 老路子,插件直接调模型生成(2026-10-31 那版)
214
+ * 兜底永远在,所以这一项关不关都不会丢日记,只影响「谁来写」。 */
215
+ diaryAgentWrite: true,
216
+ /** 等她写多久(毫秒)。写一篇日记要几十秒,3 分钟够;
217
+ * 设太短会经常掉进兜底,设太长开机后日记会迟到。 */
218
+ diaryAgentTimeoutMs: 180000,
219
+ diaryManualNote: true,
220
+ diaryPublicTone: '',
221
+ diaryPrivateTone: '',
222
+ // 喂给日记模型的对话预算(2026-11-02 改)。
223
+ // 原来 30000 且超了从前面截断 —— 砍掉的正好是早上那半段,而且那 30000 字里
224
+ // 80% 是技术细节。现在改成按分数挑(见 diary-pick.js),8000 字就够写,
225
+ // 生活内容占比从 20% 升到 87%,全天跨度也保住了。
226
+ diaryMaxConversationChars: 8000,
227
+ // 已停用,仅为兼容旧配置保留(2026-11-04 核对:只有废弃的 summarizeConversations
228
+ // 还在读它,日记主流程不做摘要;删了会让老配置报错)。
229
+ diaryMaxSummaryChars: 2000,
230
+ // 日记里的情绪底色:给几条「当时你自己的想法」。公开那篇是要拿给人看的,少给几条。
231
+ // 设 0 或关掉心情(moodEnabled=false)就完全不带情绪段。
232
+ diaryPublicMoodMoments: 3,
233
+ diaryPrivateMoodMoments: 6,
234
+ // 投第二条(私密)之前,等公开那篇落盘的最长时间。
235
+ //
236
+ // 2026-11-04:**这个配置已经删掉**。它存在的理由是当年两条消息并发投递、
237
+ // 需要等公开落盘再投私密。现在投递是串行的(公开等到文件出现才轮到私密),
238
+ // 而且她写、插件兜底两条路都会保证顺序,没有可等的东西了。
239
+ // 留着它只会让人以为「把它调大能解决竞态」——那是个假旋钮。
240
+ diarySummarizeProvider: '',
241
+ diarySummarizeModel: '',
242
+ // 对话流水保留期(2026-11-05 修 P1-5 的另一半,机制见 lib/retention.js)。
243
+ // 默认 0 = 永不自动删除;老配置文件没有这两个键,loadConfig 的
244
+ // {...DEFAULT_CONFIG, ...raw} 会自动补 0,升级后一个文件都不会动。
245
+ // 设了值也要 >= 补写能追溯的天数(findMissingDay 查 7 天,建议 >= 30),
246
+ // 否则补写时那天的对话已经被清掉,那一天就永远补不回来了。
247
+ conversationRetentionDays: 0,
248
+ // 目录总量上限(字节),0 = 不限。超出时从最旧的整天 .jsonl 开始删,今天永不删。
249
+ conversationMaxTotalBytes: 0,
250
+ // 归档档案体积上限(字节),0 = 不启用(默认)。超过时把 archive.jsonl
251
+ // 另存为带时间戳的分片,旧内容完整保留、绝不删除;recallArchived 会连分片一起查。
252
+ // 默认 0 时 rotateArchiveIfNeeded 连 stat 都不做,升级后一个文件都不会动。
253
+ archiveMaxBytes: 0,
254
+ // 绑定的日记会话(2026-10-31):只认这个 id,不再自建会话。
255
+ // 空串 = 未绑定,日记触发时跳过并提示去设置页绑定。
256
+ diarySessionId: DEFAULTS.diarySessionId,
257
+ // 这次绑定是什么时候开始的(2026-11-04,毫秒时间戳)。0 = 老配置没有这个字段。
258
+ diarySessionBornAt: 0,
259
+ // 私密日记正文是否允许在设置页查看(默认 false = 只报存在性)。
260
+ diaryPrivateVisible: DEFAULTS.diaryPrivateVisible,
261
+ diarySummarizeTimeoutMs: 30000
262
+ })
263
+
264
+
265
+ /**
266
+ * 旧配置迁移:把 `moodOwnerName` 搬到 `ownerName`(2026-11-04)。
267
+ *
268
+ * ── 为什么必须有这一步 ──
269
+ * 0.5.2 及以前,主人名字只有一个来源:`moodOwnerName`,默认写死 `'树树'`。
270
+ * 现在默认值改成了空串(陌生人装完不该被告知「你是树树的伴侣」),
271
+ * 但老用户的 persona.json 里**只有旧键**、没有新键 —— 如果什么都不做,
272
+ * 升级之后 prompt 里「关于谁」的整段会静默消失,表现是「她突然不认识我了」。
273
+ *
274
+ * 所以:只要配置里没有 `ownerName` 这个键,就认为它是旧配置,
275
+ * · 有 `moodOwnerName` 就搬它的值(用户可能自己改过,不该被覆盖);
276
+ * · 没有就用旧版的默认值 `'树树'`;
277
+ * 然后把 `ownerName` **写回文件** —— 只迁一次,之后这个键就存在了。
278
+ *
279
+ * 全新安装不会误迁:新版本的 saveConfig 写的是 merge 过 DEFAULT_CONFIG 的完整配置,
280
+ * 里面天然带 `ownerName` 键(哪怕是空串);而安装后没改过任何设置时,
281
+ * 配置文件压根不存在。两种情况都不会走进来。
282
+ *
283
+ * 写回失败不算错误(可能只是只读),内存里已经用迁移后的值了;
284
+ * 日志只记一次,别把 soul.log 刷满。
285
+ *
286
+ * @returns {string} 迁移后的 ownerName;没迁移返回 null
287
+ */
288
+ const LEGACY_OWNER_NAME = '树树'
289
+
290
+ let ownerMigrateNoted = false
291
+
292
+
293
+ function migrateOwnerName(file, raw) {
294
+ if (raw === null || typeof raw !== 'object' || Array.isArray(raw)) return null
295
+ // 已经把新键显式写进配置(哪怕是空串 = 「我就是不设」)→ 尊重它,不迁移
296
+ if (Object.prototype.hasOwnProperty.call(raw, 'ownerName')) return null
297
+ // 没有配置文件 / 文件读不出东西(JSON 坏了)→ 不猜。坏文件写回会把它整份抹掉。
298
+ if (!exists(file) || Object.keys(raw).length === 0) return null
299
+
300
+ const legacy = typeof raw.moodOwnerName === 'string' ? raw.moodOwnerName.trim() : ''
301
+ const ownerName = legacy !== '' ? legacy : LEGACY_OWNER_NAME
302
+ const next = { ...raw, ownerName }
303
+ try {
304
+ const written = atomicWrite(file, `${JSON.stringify(next, null, 2)}\n`)
305
+ if (written?.ok !== true) note('config', `⚠️ ownerName 迁移写盘失败(内存已按新值运行):${written?.error ?? '未知原因'}`)
306
+ if (!ownerMigrateNoted) {
307
+ ownerMigrateNoted = true
308
+ note('config', `已从旧配置迁移 ownerName=${ownerName}(来源:${legacy !== '' ? 'moodOwnerName' : '旧版默认值'}),已写回 persona.json`)
309
+ }
310
+ } catch (error) {
311
+ if (!ownerMigrateNoted) {
312
+ ownerMigrateNoted = true
313
+ note('config', `旧配置迁移 ownerName=${ownerName} 写回失败(本次仍按迁移后的值运行):${error instanceof Error ? error.message : error}`)
314
+ }
315
+ }
316
+ return ownerName
317
+ }
318
+
319
+
320
+ export function loadConfig() {
321
+ return readThrough(configStore, SINGLE, CONFIG_FILE(), (file) => {
322
+ let raw = {}
323
+ try {
324
+ const text = readText(file)
325
+ raw = text === '' ? {} : JSON.parse(text)
326
+ } catch {
327
+ raw = {}
328
+ }
329
+ const migrated = migrateOwnerName(file, raw)
330
+ const value = { ...DEFAULT_CONFIG, ...(raw !== null && typeof raw === 'object' ? raw : {}) }
331
+ if (migrated !== null) value.ownerName = migrated
332
+ return value
333
+ })
334
+ }
335
+
336
+
337
+ export function saveConfig(patch) {
338
+ const value = { ...loadConfig(), ...(patch ?? {}) }
339
+ // 2026-11-10 R18-B:废弃键不落盘 —— 它们是兼容占位,不是配置项;照原样写回
340
+ // config.json 会让它们在文件里永远活着,看起来像有效配置。内存里保留
341
+ // (DEFAULT_CONFIG / validateConfigEntry 的口径不变),只是文件里不放。
342
+ // · diarySchedule:直接剔(代码里没人读);
343
+ // · moodOwnerName:**只在 ownerName 已经有值之后**剔 —— migrateOwnerName
344
+ // 读的是文件原文,ownerName 还空着就把源值剔了,老用户的迁移数据会丢。
345
+ const toWrite = { ...value }
346
+ delete toWrite.diarySchedule
347
+ if (String(toWrite.ownerName ?? '') !== '') delete toWrite.moodOwnerName
348
+ const written = atomicWrite(CONFIG_FILE(), `${JSON.stringify(toWrite, null, 2)}\n`)
349
+ if (written?.ok !== true) {
350
+ // 2026-11-05 S3:这一处原来是 P0-4 的同型漏检 —— 写盘失败也回 200「配置已保存」。
351
+ // 现在抛给调用方,handler 的外层 catch 会回 500;缓存清空避免内存里留假配置。
352
+ invalidate(configStore, SINGLE)
353
+ throw new Error(`配置写盘失败:${written?.error ?? '未知原因'}`)
354
+ }
355
+ // 写盘后把已知新值与写后 mtime 绑定,保证进程内一致(不必再读一次盘)
356
+ settle(configStore, SINGLE, CONFIG_FILE(), value)
357
+ return value
358
+ }
359
+
360
+
361
+ /** 测试用:丢掉所有缓存。 */
362
+ export function resetCaches() {
363
+ clearAll(cardCache)
364
+ clearAll(moodCache)
365
+ clearAll(purposeStore)
366
+ clearAll(configStore)
367
+ }