feiyu-brain 1.4.2 → 1.5.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.
@@ -0,0 +1,170 @@
1
+ // 记忆搬迁:老鱼把过去搬进来,新鱼从零开始。
2
+ //
3
+ // 宿主的记忆和大脑的记忆不是一回事:
4
+ // 宿主日记 = 流水账(发生过什么)
5
+ // brain = 带情绪的经历(她记得什么)
6
+ //
7
+ // 所以搬迁不是"复制一份",是**有损转换**:只搬那些真的会留下印象的,
8
+ // 并且每条都标 source:'import',将来能分清"亲历"和"听说的"。
9
+
10
+ export const MIGRATE_FORMATS = ['jsonl', 'days', 'generic'];
11
+
12
+ /** 一条宿主记录 → 她的经历。缺正文的直接丢。 */
13
+ export function toEpisode(item, { source = 'import' } = {}) {
14
+ if (!item) return null;
15
+ const text = String(item.text ?? item.what ?? item.content ?? item.message ?? '').trim();
16
+ if (!text) return null;
17
+ const at = Number(item.at ?? item.time ?? item.ts ?? item.createdAt);
18
+ return {
19
+ who: String(item.who ?? item.sender ?? item.name ?? item.from ?? '').trim(),
20
+ what: text.slice(0, 140),
21
+ feel: String(item.feel ?? item.mood ?? '').trim(),
22
+ mood: String(item.mood ?? '').trim(),
23
+ emotion: Number(item.emotion ?? 0) || 0,
24
+ outcome: item.outcome ?? null,
25
+ context: item.context ?? null,
26
+ at: Number.isFinite(at) ? at : 0,
27
+ source,
28
+ };
29
+ }
30
+
31
+ /**
32
+ * 解析 JSONL(一行一条 JSON)。
33
+ * 坏行不炸,记进 errors 里——搬迁最怕"因为一行坏了整批不进"。
34
+ */
35
+ export function parseJsonl(text) {
36
+ const out = [];
37
+ const errors = [];
38
+ const lines = String(text ?? '').split(/\r?\n/);
39
+ lines.forEach((line, i) => {
40
+ const s = line.replace(/^\uFEFF/, '').trim();
41
+ if (!s || s.startsWith('//') || s.startsWith('#')) return;
42
+ try {
43
+ const obj = JSON.parse(s);
44
+ const ep = toEpisode(obj);
45
+ if (ep) out.push(ep);
46
+ else errors.push({ line: i + 1, reason: '没有正文' });
47
+ } catch {
48
+ errors.push({ line: i + 1, reason: '不是合法 JSON' });
49
+ }
50
+ });
51
+ return { episodes: out, errors };
52
+ }
53
+
54
+ /**
55
+ * 解析日记式 markdown。
56
+ *
57
+ * 不指望通用的自然语言理解——只认几种明确写法的行:
58
+ * - 某人:"说了什么" (冒号 + 引号)
59
+ * - 2026-11-20 某人:说了什么 (日期头 + 冒号)
60
+ * - `- 说了什么` (无主语,算旁白)
61
+ *
62
+ * 认不出来的行直接跳过,不猜。**搬迁宁可少搬,不能瞎搬。**
63
+ */
64
+ export function parseDailyNotes(text) {
65
+ const out = [];
66
+ const errors = [];
67
+ let currentDate = 0;
68
+ let head = '';
69
+
70
+ const lines = String(text ?? '').split(/\r?\n/);
71
+ lines.forEach((line, i) => {
72
+ const s = line.replace(/^\uFEFF/, '').trim();
73
+ if (!s) return;
74
+
75
+ // 日期标题:## 2026-11-20
76
+ const d = /(\d{4})-(\d{2})-(\d{2})/.exec(s);
77
+ if (d && (s.startsWith('#') || s.length < 24)) {
78
+ currentDate = Date.UTC(Number(d[1]), Number(d[2]) - 1, Number(d[3]), 12, 0, 0);
79
+ return;
80
+ }
81
+
82
+ // 说话行:某人:「…」 / 某人:…
83
+ const say = /^[-*]?\s*([^\s::]{1,16})\s*[::]\s*[「“"]?(.+?)[」”"]?$/.exec(s);
84
+ if (say && !/^\d/.test(say[1])) {
85
+ const who = say[1].trim();
86
+ const body = say[2].trim();
87
+ if (body.length >= 2 && who.length <= 12) {
88
+ out.push({
89
+ who,
90
+ what: body.slice(0, 140),
91
+ feel: '',
92
+ mood: '',
93
+ emotion: 0,
94
+ outcome: null,
95
+ context: null,
96
+ // 没有 `## YYYY-MM-DD` 日期头就不编时间——宁可空着,也不假装知道几号
97
+ at: currentDate ? currentDate + out.length * 60_000 : 0,
98
+ source: 'import',
99
+ });
100
+ return;
101
+ }
102
+ }
103
+
104
+ // 无主语的项目符号:算旁白,who 留空
105
+ const bullet = /^[-*]\s+(.+)$/.exec(s);
106
+ if (bullet && bullet[1].trim().length >= 4) {
107
+ out.push({
108
+ who: head,
109
+ what: bullet[1].trim().slice(0, 140),
110
+ feel: '',
111
+ mood: '',
112
+ emotion: 0,
113
+ outcome: null,
114
+ context: null,
115
+ at: currentDate + out.length * 60_000,
116
+ source: 'import',
117
+ });
118
+ return;
119
+ }
120
+
121
+ errors.push({ line: i + 1, reason: '认不出格式(跳过,不猜)' });
122
+ });
123
+
124
+ return { episodes: out, errors };
125
+ }
126
+
127
+ /** 已经是数组就直接用 */
128
+ export function parseGeneric(list) {
129
+ const out = [];
130
+ const errors = [];
131
+ (Array.isArray(list) ? list : []).forEach((item, i) => {
132
+ const ep = toEpisode(item);
133
+ if (ep) out.push(ep);
134
+ else errors.push({ line: i + 1, reason: '没有正文' });
135
+ });
136
+ return { episodes: out, errors };
137
+ }
138
+
139
+ /** 按格式选解析器 */
140
+ export function parseAny(text, format = 'jsonl') {
141
+ if (format === 'days') return parseDailyNotes(text);
142
+ if (format === 'generic') {
143
+ try {
144
+ const j = JSON.parse(text);
145
+ return parseGeneric(Array.isArray(j) ? j : j.episodes);
146
+ } catch {
147
+ return { episodes: [], errors: [{ line: 0, reason: '不是合法 JSON 数组' }] };
148
+ }
149
+ }
150
+ return parseJsonl(text);
151
+ }
152
+
153
+ /**
154
+ * 去重:同一段对话可能导两次。
155
+ * 键 = 谁 + 前 40 字 + 时间(没有时间就只按前两项)。
156
+ */
157
+ export function dedupe(episodes, { existing = [] } = {}) {
158
+ const key = (e) => `${e.who ?? ''}|${String(e.what ?? '').slice(0, 40)}|${e.at || 0}`;
159
+ const seen = new Set();
160
+ for (const e of existing) seen.add(key(e));
161
+ const fresh = [];
162
+ let dup = 0;
163
+ for (const e of episodes) {
164
+ const k = key(e);
165
+ if (seen.has(k)) { dup += 1; continue; }
166
+ seen.add(k);
167
+ fresh.push(e);
168
+ }
169
+ return { episodes: fresh, duplicated: dup };
170
+ }
@@ -0,0 +1,101 @@
1
+ # 适配器契约 · qq-bridge(SnowLuma / OneBot)
2
+
3
+ > 这份文档存在的原因:有人照着示例接线,因为 `recentMessages` 没有 `seq`,
4
+ > 大脑**静默地**不再长大,而 `feiyu_status` 一切正常。这个坑不该踩第二次。
5
+
6
+ ---
7
+
8
+ ## 一、宿主需要提供什么
9
+
10
+ `buildBrainLine(key, st, brain)` 和 `drainUnread(key, st, brain)` 都读同一个 `st`:
11
+
12
+ ```js
13
+ st = {
14
+ unread: [], // 可选,强烈建议有
15
+ recentMessages: [], // 可选,通常有,但常常没有 seq
16
+ }
17
+ ```
18
+
19
+ ### 消息字段
20
+
21
+ | 字段 | 必填 | 说明 | 缺了会怎样 |
22
+ |---|---|---|---|
23
+ | `sender` / `nickname` | 建议 | 谁说的,用于"对这个人有没有印象" | 记为无名 |
24
+ | `text` / `plain` / `tail` | **是** | 说了什么 | 这条被跳过(`skipped`) |
25
+ | `seq` | 否 | 单调递增序号,最好的去重键 | 退到下一级 |
26
+ | `messageId` | 否 | 消息 id,第二优先 | 退到下一级 |
27
+ | `time` | **强烈建议** | 毫秒时间戳,第三优先 + 排序用 | 没有去重键 → 契约告警 |
28
+ | `isSelf` | 否 | 是不是她自己发的 | 默认 false,可能把自己的话记成经历 |
29
+
30
+ **去重键优先级**:`seq` → `messageId` → `time + 前16字`。
31
+
32
+ 三级都拿不到时,这条**不会**被静默丢弃——会记一条 `contractWarning`:
33
+
34
+ ```js
35
+ ad.warnings() // → [{ at, code: 'E_NO_NEW_KEYS', detail }]
36
+ ```
37
+
38
+ 宿主可以把这个数组挂到自己的 `/status` 接口上。**"没长大"不该是玄学。**
39
+
40
+ ---
41
+
42
+ ## 二、两个入口
43
+
44
+ ### `drainUnread(key, st, brain, { limit })`
45
+
46
+ 把 `st.unread + st.recentMessages` 里**没经历过的**按时间升序逐条 `observe`。
47
+
48
+ ```js
49
+ const r = ad.drainUnread('group:123', st, brain);
50
+ // → { observed: 7, skipped: 0, merged: 0, remaining: 0, ok: true }
51
+ ```
52
+
53
+ - `observed` 真正进记忆的条数
54
+ - `skipped` 有键但没正文,跳过的条数
55
+ - `merged` 超过 `limit` 时被合并成一条「补看」的条数
56
+ - `remaining` 合并后还剩多少没处理
57
+
58
+ 默认 `limit = 20`(构造适配器时 `createBridgeAdapter({ limit })` 可改)。
59
+
60
+ ### `buildBrainLine(key, st, brain)`
61
+
62
+ 唤醒时调一次:内部先 `drainUnread`,再产出要拼进 prompt 的那一段。永远不抛,失败返回空串。
63
+
64
+ ---
65
+
66
+ ## 三、验收标准(改完照这个测)
67
+
68
+ | # | 场景 | 期望 |
69
+ |---|---|---|
70
+ | 1 | `recentMessages` 只有 `time`,没有 `seq` | 必须产生一条 episode |
71
+ | 2 | 一次给 10 条 unread | 10 条(或 1 条合并 + 明确说明),不能只 1 条且无提示 |
72
+ | 3 | 同一条消息重复喂 | 不重复经历 |
73
+ | 4 | 拿不到去重键 | `warnings()` 里有记录,不静默 |
74
+ | 5 | 超过 limit | `merged > 0`,且合并的那条正文写明"补看 N 条" |
75
+
76
+ 这五条在 `scripts/test-contract.mjs` 里都有对应用例,`npm test` 会跑。
77
+
78
+ ---
79
+
80
+ ## 四、常见误接
81
+
82
+ | 症状 | 原因 | 修法 |
83
+ |---|---|---|
84
+ | `feiyu_status` 正常,但权重永远不动 | 宿主没有传 `st`,或 `st` 里没有消息 | 确认 `buildBrainLine` 拿到了当前会话的 `st` |
85
+ | 只在第一次有反应,后面都像没听见 | 用了旧版 `observeOnce`(只取最新一条 + 只认 seq) | 升级到 1.6+,改用 `drainUnread` |
86
+ | 权重乱跳 | 同一个 `st` 被 `buildBrainLine` 和手动 `observeOnce` 各调一次 | 只留一个入口 |
87
+ | 记忆里出现她自己的话 | `isSelf` 没标 | 宿主侧补上 |
88
+
89
+ ---
90
+
91
+ ## 五、影子模式(试跑不伤人设)
92
+
93
+ ```js
94
+ const brain = createBrain({ id: 'fy-test', dataDir, roleDir, cardText, shadow: true })
95
+ ```
96
+
97
+ - `observe` 只写 `audit.jsonl`,**不动权重、不进记忆、不落盘**
98
+ - 返回 `{ shadow: true, wouldChange: [{ id, from, to }] }` —— 直接能看到"如果真接会长成什么样"
99
+ - `feiyu_status` 里 `runtime.shadow` 会显示 `true`
100
+
101
+ 跑够一百轮,看 `wouldChange` 和自己的预期对不对,再关掉 shadow 正式接。
@@ -0,0 +1,136 @@
1
+ # 1.5.0 更新说明
2
+
3
+ > 上一个线上版本:**1.4.2**
4
+ > 这一版回答三件事:**怎么不打架、怎么接别人的系统、怎么把过去搬进来。**
5
+
6
+ ---
7
+
8
+ ## 一、不打架(四种装法)
9
+
10
+ 以前只有「全开」和「全关」,装上去就得整个接管人设和记忆。
11
+
12
+ 现在能只取一部分:
13
+
14
+ | 姿势 | 怎么配 | 适合谁 |
15
+ |---|---|---|
16
+ | **整脑** | 全套 | 从零开始 / 决定整套换 |
17
+ | **只当记忆库** | `observe(..., { evolve:false })` | 人设已有,只缺记忆 |
18
+ | **只当情绪机** | `wakeLine(..., { sections:['mood'] })` | 只想让语气有起伏 |
19
+ | **只当身体** | `tools:['app']` | 只想让它会开 App |
20
+
21
+ 实测:全量唤醒 100 字 → 只点 `mood` **22 字**,叠加时 token 不会翻倍。
22
+
23
+ ---
24
+
25
+ ## 二、接别人的系统
26
+
27
+ ### ① HTTP 边车(任何语言)
28
+
29
+ ```bash
30
+ npx feiyu serve --port 7788
31
+ ```
32
+
33
+ ```python
34
+ requests.post('http://127.0.0.1:7788/wake',
35
+ json={'id':'default','sender':who,'text':msg})
36
+ ```
37
+
38
+ 12 个接口,默认只绑 `127.0.0.1`,设了 `--token` 就要带 `x-feiyu-token` 头。
39
+ **Python / Java / Go 不用再 spawn node 进程。**
40
+
41
+ ### ② 适配器契约写清楚了
42
+
43
+ `recentMessages` 没有 `seq` 时,旧版会**静默地**不再长大,而 `status` 一切正常——
44
+ 这个坑不该踩第二次。
45
+
46
+ - 去重键三级兜底:`seq` → `messageId` → `time`
47
+ - `drainUnread()` 批量经历:10 条记 10 条,不再只记最新那条
48
+ - 拿不到键时记 `contractWarnings`,不静默
49
+
50
+ ### ③ 情绪双源仲裁
51
+
52
+ 宿主已有 `emotion.json` 的,两套都能改情绪会打架。现在定优先级:
53
+
54
+ ```yaml
55
+ moodPolicy: brain # brain(脑说了算)| host(宿主说了算,feel 只算不写)| blend(各一半)
56
+ ```
57
+
58
+ ---
59
+
60
+ ## 三、把过去搬进来
61
+
62
+ ```bash
63
+ # 老鱼:整个记忆目录一次并进来
64
+ npx feiyu migrate D:\cici\qq-bridge\memory --all --delete-source
65
+
66
+ # 自检
67
+ npx feiyu verify
68
+ ```
69
+
70
+ - 自动认格式:`.jsonl` / `.md`(日记式)/ `.json`
71
+ - 认不出的行**跳过并报行号**,不猜
72
+ - 搬两次自动去重
73
+ - `--delete-source` 把原文件改名 `.migrated`(**不是删除**,删不删你决定)
74
+ - 超过 5000 条自动压卡片 + 归档,脑子不会膨胀
75
+
76
+ ### 日记是她的心房
77
+
78
+ 宿主的日记记"发生过什么",她记"我怎么想"。
79
+
80
+ ```bash
81
+ npx feiyu diary # 今天的素材 + 第一人称骨架
82
+ npx feiyu diary write ./note.md # 存回去
83
+ npx feiyu diary list
84
+ ```
85
+
86
+ 存 `brains/<id>/days/2026-11-21.md`,**跟宿主日记分开**。
87
+ 写完自动记一条经历,以后能想起"我写过什么"。
88
+
89
+ **日记带心情**:正文没写就补一行;她自己写了就不动;那天没记过就写"那天没记",不编。
90
+
91
+ ---
92
+
93
+ ## 四、装不上能自救了
94
+
95
+ ```bash
96
+ npx feiyu doctor # 只查
97
+ npx feiyu doctor --fix # 能修的替你修
98
+ ```
99
+
100
+ 查四件事并给具体修法:pnpm、插件登记(bundles)、工具白名单、数据目录。
101
+ `--fix` 会改 profile 的 `package.json` 和 `tool-allow.json`,改完要**完全退出 DSH 再启动**。
102
+
103
+ ---
104
+
105
+ ## 五、安全与可控
106
+
107
+ | 能力 | 干什么 |
108
+ |---|---|
109
+ | `shadow` 影子模式 | 只写 audit,权重一个不动——先试跑一百轮看会长成什么样 |
110
+ | `snapshot` / `restore` | 存档回滚,权重逐条还原 |
111
+ | `ttlPolicy` | `hard` / `summarize` / `archive`(忘细节但原文进归档)/ `off` |
112
+ | `body.owner: host` | 宿主管设备时,脑不抢(`E_HOST_OWNS`) |
113
+ | `identityCheck()` | 查记忆 / 自我叙事 / 关系三项,判断"换过去还是不是她" |
114
+ | `exportPack()` / `importPack()` | 连同记忆一起搬走 |
115
+
116
+ ---
117
+
118
+ ## 六、数字
119
+
120
+ | | 1.4.2 | 1.5.0 |
121
+ |---|---|---|
122
+ | 公开导出 | 105 | 131 |
123
+ | DSH 工具 | 6 | 9 |
124
+ | 测试 | 118 | 167 |
125
+ | 文档 | 8 | 12 |
126
+ | 包大小 | 86.8 KB | ~122 KB |
127
+
128
+ 新增文档:`MEMORY.md`(记忆怎么处理)、`ADAPTER-CONTRACT.md`(接线必看)、`TROUBLESHOOT.md`(装不上)。
129
+
130
+ ---
131
+
132
+ ## 七、没做的
133
+
134
+ - **HTTP 边车的鉴权只有共享 token** —— 没有用户体系,够本地用,不够多租户
135
+ - **多设备并发** —— 一次只有一具身体在动
136
+ - **迁移不做语义理解** —— 日记里认不出的行直接跳过,不猜
package/docs/MEMORY.md ADDED
@@ -0,0 +1,289 @@
1
+ # 记忆怎么处理 —— 双记忆共存 + 老鱼/新鱼两条路
2
+
3
+ > 这份文档回答两个问题:
4
+ > ① 宿主已经有日记了,脑里再存一份,冲突怎么办?
5
+ > ② 已经养了很久的老鱼,怎么搬进来?新鱼又怎么开始?
6
+
7
+ ---
8
+
9
+ ## 一、四套记忆,各管什么
10
+
11
+ | 记忆 | 存在哪 | 内容 | 参与检索吗 |
12
+ |---|---|---|---|
13
+ | **脑记忆** | `brain.json` | 带情绪的经历、印象、卡片、口味 | ✅ **只有它参与** |
14
+ | **她的日记** | `brains/<id>/days/*.md` | **她自己写的**,用她自己的口吻 | ✅ 写日记会进记忆 |
15
+ | 宿主日记 | `days/*.md` | 流水账:今天发生了什么 | ❌ 归档 |
16
+ | 经验 | `experience.jsonl` | 学到的东西 | ❌ 归档 |
17
+ | 跨平台 | `cross-platform.jsonl` | 各平台事件 | ❌ 归档 |
18
+
19
+ **关键**:不是"两份都记",是**脑是主档,其余是归档**。
20
+
21
+ 用户问「你记得吗」——只有脑里有的才算"记得"。日记里有、脑里没有,那是"好像有过这回事"。
22
+
23
+ 这不是缺陷。人的记忆本来就分层:**记得住的是有情绪的,记不住的是流水。**
24
+
25
+ ---
26
+
27
+ ## 二、三种共存策略,选一种
28
+
29
+ ### 策略 A:脑为主,日记归档(推荐)
30
+
31
+ - 脑负责"她记得什么"
32
+ - 日记继续写,但**不灌进脑**,只在人工回溯时查
33
+ - 优点:只有一个真相来源,不会出现两个答案
34
+ - 缺点:日记里的东西她"想不起来"
35
+
36
+ ### 策略 B:一次性搬迁,之后各自独立
37
+
38
+ - 把日记**搬一次**进脑(`migrate`),之后日记停写或只写不读
39
+ - 适合:老鱼刚接进来,想让过去也算数
40
+ - 缺点:搬进来的都是 `source:'import'`,情绪值一律 0(日记里没有)
41
+
42
+ ### 策略 C:全量整合,之后只剩一份(你想要的这个)
43
+
44
+ - 把 `days/*.md`、`experience.jsonl`、`cross-platform.jsonl` **全部搬进脑**
45
+ - 搬完原文件改名 `.migrated`,宿主停写这些文件
46
+ - 从此**只有一份记忆**,不会再有两个答案
47
+ - 代价:见下面第七节,先说清楚再决定
48
+
49
+ **如果只想要"简单、不分层"——选 C。**
50
+
51
+ ---
52
+
53
+ ---
54
+
55
+ ## 三、老鱼:把过去搬进来
56
+
57
+ ### 第 1 步:先看会搬多少(不写任何东西)
58
+
59
+ ```bash
60
+ npx feiyu migrate ./days/2026-11-18.md --format days --dry-run
61
+ ```
62
+
63
+ 输出:
64
+
65
+ ```
66
+ 格式 days 解析出 2 条 重复 0 条 将导入 2 条
67
+ 时间跨度 2026-11-18 → 2026-11-18
68
+ 跳过 1 行:
69
+ 第 4 行 认不出格式(跳过,不猜)
70
+ ```
71
+
72
+ **认不出来就跳过,不猜。** 搬迁宁可少搬,不能瞎搬。
73
+
74
+ ### 第 2 步:确认没问题,真搬
75
+
76
+ ```bash
77
+ npx feiyu migrate ./days/2026-11-18.md --format days
78
+ ```
79
+
80
+ ### 第 3 步:体检
81
+
82
+ ```bash
83
+ npx feiyu status
84
+ npx feiyu brief # 看看"此刻的她"像不像原来那条鱼
85
+ ```
86
+
87
+ 或者代码里:
88
+
89
+ ```js
90
+ identityCheck('old')
91
+ // → { memory:{episodes:120,people:8}, narrative:true, relation:{...}, verdict:'是她' }
92
+ ```
93
+
94
+ ### 支持的三种格式
95
+
96
+ | format | 长什么样 |
97
+ |---|---|
98
+ | `jsonl` | 一行一条 `{"sender":"谁","text":"说了什么","time":1763500000000}` |
99
+ | `days` | 日记式:`- 某人:说了什么`,日期靠 `## 2026-11-18` 标题 |
100
+ | `generic` | JSON 数组 `[{who,text,at}]` |
101
+
102
+ **没有日期头就不编时间**——那几条 `at` 留 0,宁可空着也不假装知道几号。
103
+
104
+ ### 搬迁会丢什么
105
+
106
+ | 会保留 | 会丢 |
107
+ |---|---|
108
+ | 谁说的、说了什么 | 当时的情绪(日记里通常没有) |
109
+ | 时间(有日期头的话) | 语气、上下文 |
110
+ | `source:'import'` 标记 | — |
111
+
112
+ **搬进来的是"发生过",不是"她感受到"。** 这部分只能靠以后的经历慢慢补。
113
+
114
+ ---
115
+
116
+ ## 四、新鱼:从零开始
117
+
118
+ ```js
119
+ const fy = createBrain({ id: 'new', dataDir, roleDir, cardText, cardName: '新鱼' })
120
+ ```
121
+
122
+ - 记忆空、情绪词表空、关系只有创建时那一条
123
+ - 第一次对话开始 `observe`,权重才会动
124
+ - **不需要搬迁,也不要预填**——预填等于给她一段"别人的记忆"
125
+
126
+ 新鱼唯一的坑:**别把老鱼的 `brainId` 复用**。同一个 id 会把两段人生搅在一起。
127
+
128
+ ---
129
+
130
+ ## 五、TTL 和"永久日记"的冲突
131
+
132
+ 脑里 30 天过期,日记永久。这不是矛盾,是两种不同的"忘"。
133
+
134
+ 四档策略(`configure({ ttl })` 或 `cordis.patch.yml` 的 `ttlPolicy`):
135
+
136
+ | 值 | 行为 | 适合 |
137
+ |---|---|---|
138
+ | `hard`(默认) | 到期就忘,进 `forgotten` | 想要"真的会忘" |
139
+ | `summarize` | 忘之前压一张 ≤160 字卡片 | 想"忘细节、记得大概" |
140
+ | `archive` | 压卡片 + 原文追加到 `archive.jsonl` | 想留档但不让它占检索 |
141
+ | `off` | 永不遗忘 | 短周期调试,别长期用 |
142
+
143
+ `archive` 是给"既要永久日记、又要脑不膨胀"的人用的:
144
+
145
+ ```
146
+ 脑里:过期 → 卡片留下,原文走人(检索不到)
147
+ 归档:原文进 archive.jsonl(要查还能查)
148
+ ```
149
+
150
+ ---
151
+
152
+ ## 六、日记是她的心房,她自己写
153
+
154
+ **宿主的日记不是她的日记。** 宿主记的是"发生过什么",她记的是"我怎么想"。
155
+
156
+ 脑子不生成文笔(那是嘴的事),它做三件事:
157
+
158
+ ```js
159
+ // ① 给素材 + 第一人称骨架
160
+ feiyu_diary({ action: 'digest' })
161
+ ```
162
+
163
+ ```
164
+ 【2026-11-21 的素材】经历 2 条,见了 扶摇、访秋辞,心情 平静
165
+
166
+ # 2026-11-21
167
+
168
+ 今天跟扶摇、访秋辞说了话。
169
+
170
+ - 扶摇:「你嘴真硬」
171
+ - 访秋辞:「吃饭了吗」
172
+
173
+ 👉 用她自己的口吻把今天写成日记,别用第三人称,别总结升华,写完存回去。
174
+ ```
175
+
176
+ ```js
177
+ // ② 用她的口吻写完之后,存回去
178
+ feiyu_diary({ action: 'write', text: '今天扶摇又说我嘴硬。我没理他,但记下了。' })
179
+ ```
180
+
181
+ ```js
182
+ // ③ 以后能翻旧账
183
+ feiyu_diary({ action: 'read', date: '2026-11-21' })
184
+ feiyu_diary({ action: 'list' })
185
+ ```
186
+
187
+ 存哪:`<dataDir>/brains/<id>/days/2026-11-21.md`——**跟宿主的日记目录分开,不互相覆盖。**
188
+
189
+ 写进去之后会自动记一条 `source:'diary'` 的经历,所以问"你写过什么"她能想起来。
190
+
191
+ 命令行一样:
192
+
193
+ ```bash
194
+ npx feiyu diary # 今天的素材
195
+ npx feiyu diary write ./note.md # 存回去
196
+ npx feiyu diary list
197
+ npx feiyu diary read 2026-11-21
198
+ ```
199
+
200
+ ---
201
+
202
+ ## 七、全量整合:只剩一份记忆
203
+
204
+ 一条命令把所有记忆源并进脑子:
205
+
206
+ ```bash
207
+ # 先看会搬多少(不写任何东西)
208
+ npx feiyu migrate D:\cici\qq-bridge\memory --all --dry-run
209
+
210
+ # 确认无误,真搬 + 收走原文件
211
+ npx feiyu migrate D:\cici\qq-bridge\memory --all --delete-source
212
+
213
+ # 自检
214
+ npx feiyu verify
215
+ ```
216
+
217
+ 实测输出:
218
+
219
+ ```
220
+ 扫到 2 个文件 解析出 4 条 重复 0 条 将导入 4 条
221
+ 时间跨度 2026-11-18 → 2026-11-18
222
+
223
+ ✔ 全量导入 4 条,现在共 4 条经历。
224
+ 原文件已改名 2 个:
225
+ 2026-11-18.md.migrated
226
+ experience.jsonl.migrated
227
+ 体检:是她
228
+ ```
229
+
230
+ ```
231
+ 经历 4 条(亲历 0 / 搬来 4) 卡片 0 认识 2 个人
232
+ 体检:是她
233
+ 回忆抽检:100%(4/4)
234
+ ✔ 「你嘴真硬啊」
235
+ ✔ 「吃饭了吗」
236
+ ✔ 「又怼我」
237
+ ✔ 「刷到个驴蹄子」
238
+ ```
239
+
240
+ ### 三条设计决定,说清楚
241
+
242
+ **① 原文件是改名,不是删除**
243
+
244
+ `--delete-source` 把 `x.md` 变成 `x.md.migrated`。**我们不替你 rm。**
245
+ 跑一周觉得没问题,你自己删 `.migrated` 就行;万一搬漏了还能回去翻。
246
+
247
+ **② 自动认格式**
248
+
249
+ ```
250
+ .jsonl → 一行一条 JSON
251
+ .md / .txt → 日记式
252
+ .json → JSON 数组
253
+ ```
254
+
255
+ 按扩展名嗅探;认不出的行**跳过并报行号**,不猜。
256
+
257
+ **③ 容量保护:5000 条封顶**
258
+
259
+ 脑里超过 5000 条经历时,最老的一批自动:
260
+ - 压成一张 ≤160 字卡片(还在上下文里)
261
+ - 原文追加到 `archive.jsonl`(要查还能查)
262
+
263
+ **脑子不会因为搬了三年日记就变成几百 MB 的 json。**
264
+
265
+ ### 代价(必须知道)
266
+
267
+ | 代价 | 说明 |
268
+ |---|---|
269
+ | **脑变成单点** | 只有 `brain.json`(有 `.bak` 自动备份 + `snapshot` 手动存档) |
270
+ | **日记不可读** | md 人能手翻,json 不能。想看原文靠 `archive.jsonl` |
271
+ | **情绪是空的** | 日记里没有"当时什么感受",搬进来的 `emotion` 全是 0 |
272
+ | **先搬后忘** | 30 天 TTL 照常走,老日记搬进来后也会慢慢过期(除非 `ttlPolicy: off`) |
273
+
274
+ 最后一条最容易被忽略:**你搬进来的是三年前的日记,但她的 TTL 是 30 天。**
275
+ 要长期保留就配 `ttlPolicy: archive`——忘掉细节,卡片和归档都还在。
276
+
277
+ ---
278
+
279
+ ## 七、验收
280
+
281
+ | # | 场景 | 期望 |
282
+ |---|---|---|
283
+ | 1 | 同一份文件搬两次 | 第二次导入 0 条(去重) |
284
+ | 2 | 文件里有坏行 | 好行照搬,坏行报行号 |
285
+ | 3 | 搬完 `identityCheck` | `verdict: 是她` |
286
+ | 4 | 搬完 `wake` 带关键词 | 能检索到搬进来的内容 |
287
+ | 5 | 新鱼不搬 | 记忆 0 条,第一次 `observe` 后才开始长 |
288
+
289
+ 前四条在 `scripts/test-contract.mjs` 里有对应用例。