feiyu-brain 1.4.1 → 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,150 @@
1
+ # 1.4 相比之前加了什么
2
+
3
+ > 对比区间:**1.1.0(首发)→ 1.4.1(当前 latest)**
4
+ > 中间发过的版本:1.1.0 / 1.1.1 / 1.2.0 / 1.4.0 / 1.4.1
5
+
6
+ ---
7
+
8
+ ## 一句话
9
+
10
+ **1.1 是一颗能记住事的脑;1.4 是一颗会说"我委屈"、会真的去开 App、口味会被人设带着走的脑。**
11
+
12
+ ---
13
+
14
+ ## 一、情绪:从"三个数字"到"会说人话"
15
+
16
+ | | 1.1.0 | 1.4.1 |
17
+ |---|---|---|
18
+ | 情绪表示 | PAD 三个数字(-1~1) | PAD 三维 **+ 情绪词表** |
19
+ | 能不能说出"委屈" | ❌ 说不出,只有数值 | ✅ 词表 ≥10 个时能命名 |
20
+ | 学习情绪词 | ❌ | ✅ 要**两个来源一致**才采纳(问用户 / 抖音 / 群聊) |
21
+ | 自己归纳定义 | ❌ | ✅ 同词攒够 3 个实例 → 自己总结"委屈是被污蔑" |
22
+ | 匹配不上时 | 硬给个最近的 | ✅ 说"说不清,有点像 A,又像 B" |
23
+
24
+ **三段式**:`只会说"不知道"` → `能说"我有点委屈"` → `能说"这是被污蔑,我委屈"`。
25
+
26
+ 而且**同一件事,不同状态不同结果**:
27
+
28
+ ```
29
+ 被冤枉 + 有劲 → 掌控感高 → 生气 → "凭什么"
30
+ 被冤枉 + 累了 → 掌控感低 → 委屈 → "……算了"
31
+ ```
32
+
33
+ ---
34
+
35
+ ## 二、记忆:从"只有经历"到"有卡片、有平台"
36
+
37
+ | | 1.1.0 | 1.4.1 |
38
+ |---|---|---|
39
+ | 情景记忆 | ✅ 30 天 TTL | ✅ 不变 |
40
+ | 印象 / 事实 / 口味 | ✅ | ✅ 不变 |
41
+ | **记忆卡片** | ❌ 长对话只能靠预算硬截 | ✅ 超 6000 字压成 ≤160 字卡片,卡片也吃 TTL |
42
+ | **平台记忆** | ❌ 只有"跟谁聊过",没有"刷过什么" | ✅ QQ / 微信 / 抖音 / B站 各一桶 |
43
+ | 跨平台检索 | ❌ | ✅ "这事我见过"——跨平台找相似标题 |
44
+ | 备份 | ❌ 单文件坏 = 丢档 | ✅ 自动 `.bak`,读失败自修复 |
45
+
46
+ 平台记忆每桶记四样:**看过哪些(带反应和时长)、口味、上次停在哪、一共待了多久**。
47
+
48
+ ---
49
+
50
+ ## 三、身体:从"能不能做"到"真的做了"
51
+
52
+ | | 1.1.0 | 1.4.1 |
53
+ |---|---|---|
54
+ | 三种身体 | ✅ 手机 / 平板 / 电脑 | ✅ 不变 |
55
+ | 四级权限 | ✅ L1~L4,L4 两道门 | ✅ 不变 |
56
+ | 摸哪具由人设算 | ✅ | ✅ 不变 |
57
+ | **真开 App** | ❌ 只有判定,不会动 | ✅ **adb**(手机/平板/模拟器)· **PowerShell**(电脑) |
58
+ | **真截屏** | ❌ | ✅ 落盘成 evidence 文件 |
59
+ | **真卸载** | ❌ | ✅ 过「临界点 + 三问」才动,电脑上禁止 |
60
+
61
+ **没证据的动作不算发生**——每个动作都要留截图或 `adb:uninstall:包名`。
62
+
63
+ ---
64
+
65
+ ## 四、口味:从"刷出来"到"人设带着走"
66
+
67
+ 这是 1.4 最大的一块。
68
+
69
+ | | 1.1.0 | 1.4.1 |
70
+ |---|---|---|
71
+ | 口味来源 | ❌ 没有口味概念 | ✅ **先验(人设算)70% + 经历 30%** |
72
+ | 选 App | ❌ | ✅ `pickApp()`——社交型摸 QQ,学霸型摸 B站 |
73
+ | 选内容 | ❌ | ✅ `pickContent()`——懒鱼选解压,好奇选科技 |
74
+ | 人设会不会被刷改变 | ❌ | ✅ **会**:看 120 条解压,`懒` 从 0.50 → 0.98 |
75
+
76
+ **闭环**:
77
+
78
+ ```
79
+ 用户写的卡 → 决定先看什么 → 刷 → 有反应 → 改人设 → 口味变 → 刷的不一样
80
+ ```
81
+
82
+ 实测:刷 120 条解压视频后,选解压的概率 **47% → 57%**。
83
+
84
+ 而且修了一个设计错误:**"谁爱看什么"和"看了会变成什么"必须是两张表**——混用的话,看解压视频会让她变理性。
85
+
86
+ ---
87
+
88
+ ## 五、人设:从"只能出生一次"到"能换卡、能转折"
89
+
90
+ | | 1.1.0 | 1.4.1 |
91
+ |---|---|---|
92
+ | 从卡出生 | ✅ | ✅ |
93
+ | **换卡** | ❌ 只能 rebirth(清空一切) | ✅ `importRoleCard()`——**只换人格,记忆/关系/身体全留** |
94
+ | 人格主档 | ❌ 说不清谁是主档 | ✅ `persona.source` 记来源+哈希+时间,**brain.json 是唯一主档** |
95
+ | **重大转折** | ❌ 只能 ±0.01,永远磨 | ✅ `reframe()`——一次推多条,幅度 1~5,**必须带证据** |
96
+ | 特质精度 | 自动统计,抽不准没法救 | ✅ 卡里写 `性格:嘴硬=0.9` 手写覆盖 + `traits.json` 旁挂 |
97
+
98
+ ---
99
+
100
+ ## 六、检索:从"只能关键词"到"可插拔"
101
+
102
+ | | 1.1.0 | 1.4.1 |
103
+ |---|---|---|
104
+ | 内置检索 | ✅ 四路线索(人/词/情绪/最近) | ✅ 不变 |
105
+ | **外部检索** | ❌ | ✅ `setRetriever()` 注入向量库/图谱,结果进【搜到的】 |
106
+ | 检索器坏了 | — | ✅ 不拖垮唤醒(try/catch + 只警告一次) |
107
+
108
+ ---
109
+
110
+ ## 七、DSH 插件形态(1.2.0 才有)
111
+
112
+ | | 1.1.0 | 1.2.0+ |
113
+ |---|---|---|
114
+ | 库 | ✅ | ✅ |
115
+ | **DSH 插件** | ❌ | ✅ `dsh.bundle` + `cordis.patch.yml` |
116
+ | 工具数 | 0 | **4 → 6**(1.4 加了 `feiyu_feel`、`feiyu_app`) |
117
+
118
+ 六个工具:`feiyu_status` / `feiyu_wake` / `feiyu_observe` / `feiyu_tick` / `feiyu_feel` / `feiyu_app`
119
+
120
+ ---
121
+
122
+ ## 八、1.4.1 专门修的首跑体验
123
+
124
+ | 坑 | 后果 | 修法 |
125
+ |---|---|---|
126
+ | 没配卡直接抛堆栈 | 新人第一条命令就是红字 | 改成引导页,`exit 0` |
127
+ | 记事本存的 json 带 BOM | 桥接正常、脑说"找不到卡" | 读之前剥 BOM |
128
+ | 短身份句被丢 | `你是鱼。` 6 字 → 身份 0 条 | 以「你是/我叫/本体是」开头的放行 |
129
+
130
+ ---
131
+
132
+ ## 九、数字对比
133
+
134
+ | | 1.1.0 | 1.4.1 |
135
+ |---|---|---|
136
+ | 包大小 | 48.6 KB | **83.8 KB** |
137
+ | 文件数 | 29 | **37** |
138
+ | DSH 工具 | 0 | **6** |
139
+ | 适配器 | 3 | 3(桥接真的接进线上,官方写完未联调) |
140
+ | 测试 | 37 + 12 | **45 + 12 + 43 + 13 + 5 = 118** |
141
+ | 依赖 | 0 | **0** |
142
+
143
+ ---
144
+
145
+ ## 十、没变的(免得被误会)
146
+
147
+ - 人设卡**永远由用户写**,包不生成、不代写
148
+ - 拦截永远只有两条:C1 人设红线 + SAFETY
149
+ - 身份和关系永不遗忘,性格可以蜕皮
150
+ - 内核不生成对话,只负责"她是谁"
@@ -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/FEATURES.md CHANGED
@@ -1,7 +1,7 @@
1
1
  # feiyu-brain · 功能清单
2
2
 
3
3
  > 一份把代码里所有能用的东西列全的说明书。
4
- > 版本 1.2.0 · MIT · 零依赖 · Node ≥ 20
4
+ > 对外叫 **1.4**(npm 上的 latest 是 1.4.1,属同一版,修了首跑体验)· MIT · 零依赖 · Node ≥ 20
5
5
 
6
6
  ---
7
7
 
@@ -438,7 +438,7 @@ npx feiyu rebirth parent 老爹
438
438
  | **多设备并发** | 一次只有一具身体在动,换身体会换驱动 |
439
439
  | **腾讯官方适配器** | 未线上联调(没有 appId/secret),字段以官方文档为准 |
440
440
 
441
- ### 1.3.0 补上的(之前缺的)
441
+ ### 1.3 / 1.4 补上的(之前缺的)
442
442
 
443
443
  | 补了什么 | 怎么做的 |
444
444
  |---|---|