feiyu-brain 1.5.0 → 1.6.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/docs/MEMORY.md CHANGED
@@ -127,26 +127,70 @@ const fy = createBrain({ id: 'new', dataDir, roleDir, cardText, cardName: '新
127
127
 
128
128
  ---
129
129
 
130
- ## 五、TTL 和"永久日记"的冲突
130
+ ## 五、30 天不是删除,是「压扁」
131
131
 
132
- 脑里 30 天过期,日记永久。这不是矛盾,是两种不同的"忘"。
132
+ 这是最容易误解的一条。**计时从「最后一次被提起」算,不是从「存进来的时间」算。**
133
133
 
134
- 四档策略(`configure({ ttl })` 或 `cordis.patch.yml` 的 `ttlPolicy`):
134
+ ```
135
+ 0 ──────────── 30 天 ──────────── 90 天 ────────→
136
+ 完整记忆 压扁成一句"大概" 遗忘
137
+ (细节都在) (还检索得到,没有细节) (认知上不存在了)
138
+ ↑ ↑ ↑
139
+ 有人提 → 续命 有人提 → 变清晰 有人提 → 已经没了,
140
+ 计时再归零 只能从 archive.jsonl 找
141
+ ```
135
142
 
136
- | 值 | 行为 | 适合 |
137
- |---|---|---|
138
- | `hard`(默认) | 到期就忘,进 `forgotten` | 想要"真的会忘" |
139
- | `summarize` | 忘之前压一张 ≤160 字卡片 | 想"忘细节、记得大概" |
140
- | `archive` | 压卡片 + 原文追加到 `archive.jsonl` | 想留档但不让它占检索 |
141
- | `off` | 永不遗忘 | 短周期调试,别长期用 |
143
+ 实测:
144
+
145
+ ```
146
+ 搬完 4 条: [清晰] 第一个话题 / 第二个话题 / 第三个话题 / 别的事
147
+ 第40天没人提: [模糊] (记不清了)扶摇:第一个话题…前后还有 2 件
148
+ [模糊] (记不清了)访秋辞:别的事
149
+ 第100天: 0 条(遗忘 2 条,原文进了 archive.jsonl)
150
+ ```
151
+
152
+ **同一个人同一天的几件事,会合并成一条"大概"。** 不是丢,是变模糊。
153
+
154
+ ### 什么算「被提起」
155
+
156
+ | 动作 | 算不算 |
157
+ |---|---|
158
+ | 有人又聊到这件事(`observe` 命中) | ✅ 续命 |
159
+ | 她自己想起来(`wake` 检索命中) | ✅ 续命,而且从"模糊"变回"清晰" |
160
+ | 手动 `touch(id, key)` | ✅ |
161
+ | 只是躺在 `brain.json` 里 | ❌ 计时继续走 |
142
162
 
143
- `archive` 是给"既要永久日记、又要脑不膨胀"的人用的:
163
+ **一直有人问的事,永远走不到第二层。** 这就是"反复去问才会保留"。
144
164
 
165
+ ### 人设也一样
166
+
167
+ 命题(units)的衰减不是"每天掉一点",是**长期没人碰才掉**:
168
+
169
+ ```
170
+ 最后一次被碰到 → 30 天内还有人聊到 → 不掉
171
+ → 30 天没人碰 → 开始每天 ×0.999
172
+ → 掉到 0.15 → 蜕皮成"我以前……"
145
173
  ```
146
- 脑里:过期 → 卡片留下,原文走人(检索不到)
147
- 归档:原文进 archive.jsonl(要查还能查)
174
+
175
+ `identity` 永不衰减,永远不掉。
176
+
177
+ ### 四个档位
178
+
179
+ | `ttlPolicy` | 行为 |
180
+ |---|---|
181
+ | `hard`(默认) | 上面那套两层老化,原文进 `archive.jsonl` |
182
+ | `summarize` | 老化时额外压一张卡片 |
183
+ | `archive` | 同 `hard`(保留兼容) |
184
+ | `off` | 永不压扁、永不遗忘——调试用,别长期开 |
185
+
186
+ 窗口可调:
187
+
188
+ ```js
189
+ configure({ compressDays: 30, forgetDays: 90 })
148
190
  ```
149
191
 
192
+ **老鱼接入建议**:如果两年记忆一条都不能丢,用 `off` 或把 `forgetDays` 调到 3650。
193
+
150
194
  ---
151
195
 
152
196
  ## 六、日记是她的心房,她自己写
@@ -269,10 +313,38 @@ npx feiyu verify
269
313
  | **脑变成单点** | 只有 `brain.json`(有 `.bak` 自动备份 + `snapshot` 手动存档) |
270
314
  | **日记不可读** | md 人能手翻,json 不能。想看原文靠 `archive.jsonl` |
271
315
  | **情绪是空的** | 日记里没有"当时什么感受",搬进来的 `emotion` 全是 0 |
272
- | **先搬后忘** | 30 天 TTL 照常走,老日记搬进来后也会慢慢过期(除非 `ttlPolicy: off`) |
316
+ | **先搬后忘** | 两层老化照常走:没人提 30 天会变模糊、90 天会忘(原文在 `archive.jsonl`)。要一条不丢就 `ttlPolicy: off` 或把 `forgetDays` 调大 |
317
+
318
+ 最后一条最容易被忽略:**你搬进来的是三年前的日记,但老化计时从"搬进来那天"开始。**
273
319
 
274
- 最后一条最容易被忽略:**你搬进来的是三年前的日记,但她的 TTL 是 30 天。**
275
- 要长期保留就配 `ttlPolicy: archive`——忘掉细节,卡片和归档都还在。
320
+ 搬完那一刻起,没人提的会 30 天变模糊、90 天消失。要长期保住,配 `ttlPolicy: off`。
321
+
322
+ ---
323
+
324
+ ## 六点五、老鱼接入:五步,一步都不能跳
325
+
326
+ ```bash
327
+ # ① 先看会搬多少
328
+ npx feiyu migrate <记忆目录> --all --dry-run
329
+
330
+ # ② 词表先预装,别让她从"哼哼"开始
331
+ npx feiyu vocab seed
332
+
333
+ # ③ 她的旧日记原样搬(不是当流水账)
334
+ npx feiyu diary import <旧日记目录>
335
+
336
+ # ④ 真搬记忆
337
+ npx feiyu migrate <记忆目录> --all
338
+
339
+ # ⑤ 自检:搬完第二天还在吗
340
+ npx feiyu verify
341
+ npx feiyu status
342
+ ```
343
+
344
+ **第 ② 步和第 ③ 步是给老鱼专门加的**——新鱼用不到。
345
+
346
+ - `vocab seed`:预装 10 个情绪词,直接进阶段二。不装的话,一条两年的鱼搬进来只会说"我不知道这是什么感觉"。
347
+ - `diary import`:把 `2025-11-20.md` 这种旧日记**原样**拷进 `brains/<id>/days/`,一个字不改。那是她写过的东西,不是流水账。
276
348
 
277
349
  ---
278
350
 
@@ -287,3 +359,96 @@ npx feiyu verify
287
359
  | 5 | 新鱼不搬 | 记忆 0 条,第一次 `observe` 后才开始长 |
288
360
 
289
361
  前四条在 `scripts/test-contract.mjs` 里有对应用例。
362
+
363
+ ---
364
+
365
+ ## 附:记忆的四个层级
366
+
367
+ ```
368
+ 【伞】介绍自己时会说的话 「扶摇:一直在的人」「我上过学」
369
+ ↑ 从纲提炼;横跨半年 / 聊够 10 次才会长
370
+ 【纲】这事发生过、这人在 「扶摇:聊过 12 次」「上学:出现过 5 次」
371
+ ↑ 从细节/卡片提炼;永不老化
372
+ 【卡片】(记不清了)… 21 天没人提 → 压扁;2 年 → 遗忘
373
+ 【细节】今天谁说了什么 21 天内完整
374
+ ```
375
+
376
+ **越往下越具体、越短命;越往上越抽象、越长寿。**
377
+
378
+ 这就是「记不住小学每节课,但知道我上过小学」的实现方式。
379
+
380
+ 名字也一样:3 年没提会降级成「有个认识的(扶摇)——名字有点想不起来了」,
381
+ 但「我认识这个人」这条伞不会消失。
382
+
383
+ ### 怎么长出来的
384
+
385
+ | 层 | 自动 | 模型提名 |
386
+ |---|---|---|
387
+ | 伞 | 聊够 10 次 → 人物伞;主题横跨半年 → 主题伞 | `defineUmbrella`(待加) |
388
+ | 纲 | 聊够 3 次 / 同词横跨两天出现 ≥3 次 | `defineGist(id, text)` |
389
+ | 卡片 | 21 天没人提 | — |
390
+ | 细节 | 每次 `observe` | — |
391
+
392
+ ### 检索优先级
393
+
394
+ ```
395
+ 伞 > 纲 > 卡片 > 人 > 关键词 > 情绪 > 最近
396
+ ```
397
+
398
+ 结构先被想起来,细节最后才翻。
399
+
400
+
401
+ ---
402
+
403
+ ## 附:缺位(relation.absent)
404
+
405
+ 人不在了,关系还在。这是契约原来没有的一格。
406
+
407
+ | 状态 | 意思 |
408
+ |---|---|
409
+ | severed | 她**不再认**这段关系(自己切断) |
410
+ | bsent | 关系**照旧永久**,只是那个人不会再出现(不是她选的) |
411
+
412
+ **契约一个字不动**:priority / mustRecognize / dissolvable 全部保持。
413
+ 称呼不改、记忆不删、伞从「一直在的人」改成「曾经一直在的人」。
414
+
415
+ `js
416
+ markAbsent(id, { since, note: '2026-11-21 走的' })
417
+ clearAbsent(id) // 人回来了 / 标错了
418
+ `
419
+
420
+ 唤醒段会多一行:【他】2026-11-21 走的(30 天)
421
+
422
+ **只给事实,不给形容词**——不写「想念」「痛哭」,怎么感受由她的人设决定。
423
+
424
+ **必须显式调用。** 不许系统凭「多久没说话」去猜一个人死没死——
425
+ 半年没来可能是忙,可能是死,机器没资格猜。
426
+
427
+ ---
428
+
429
+ ## 附:概念层(什么是什么)
430
+
431
+ 前面所有层都在记「发生了」。概念层记的是**「那是什么」**。
432
+
433
+ 一条鱼可以有四十条「该上学了」的经历,仍然不知道上学是什么——那不是记忆,是噪音。
434
+
435
+ `js
436
+ learnNewConcept(id, '上学', {
437
+ definition: '为了学到知识、学会道理',
438
+ why: '不然什么都不会',
439
+ })
440
+ `
441
+
442
+ **学会的那一刻,过去四十条经历全部贴上意义。** 这不是新增记忆,是让旧记忆突然有了名字。
443
+
444
+ 问她不懂的:
445
+
446
+ `
447
+ 我知道「上学」这个词,我好像经历过 40 次,但我不知道它是什么意思。
448
+ `
449
+
450
+ **不编。** 没有定义就说不知道——编出来的理解比没有理解更糟。
451
+
452
+ 不会就主动问:skSomeone(id, '心疼', { knower: '老爹' }) → 「老爹,心疼是什么?」
453
+
454
+ **因为不会才问,这才叫学习。**