feiyu-brain 1.4.2 → 1.5.1
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/README.md +160 -5
- package/adapters/qq-bridge.js +169 -26
- package/cli.mjs +276 -3
- package/cordis.patch.yml +32 -2
- package/core/body.js +13 -1
- package/core/bond.js +186 -0
- package/core/concept.js +138 -0
- package/core/diary.js +119 -0
- package/core/extract.js +124 -12
- package/core/memory.js +539 -18
- package/core/migrate.js +170 -0
- package/core/persona.js +91 -4
- package/core/relation.js +78 -0
- package/core/self.js +72 -0
- package/docs/ADAPTER-CONTRACT.md +101 -0
- package/docs/CHANGELOG-1.5.md +136 -0
- package/docs/MEMORY.md +454 -0
- package/docs/TROUBLESHOOT.md +136 -0
- package/index.js +1294 -56
- package/lib/doctor.mjs +181 -0
- package/lib/dsh-plugin.mjs +197 -15
- package/lib/serve.mjs +187 -0
- package/market/fangqiuci__feiyu-brain.yml +2 -2
- package/package.json +3 -2
- package/selftest.mjs +37 -3
- package/store.js +172 -13
package/docs/MEMORY.md
ADDED
|
@@ -0,0 +1,454 @@
|
|
|
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
|
+
## 五、30 天不是删除,是「压扁」
|
|
131
|
+
|
|
132
|
+
这是最容易误解的一条。**计时从「最后一次被提起」算,不是从「存进来的时间」算。**
|
|
133
|
+
|
|
134
|
+
```
|
|
135
|
+
0 ──────────── 30 天 ──────────── 90 天 ────────→
|
|
136
|
+
完整记忆 压扁成一句"大概" 遗忘
|
|
137
|
+
(细节都在) (还检索得到,没有细节) (认知上不存在了)
|
|
138
|
+
↑ ↑ ↑
|
|
139
|
+
有人提 → 续命 有人提 → 变清晰 有人提 → 已经没了,
|
|
140
|
+
计时再归零 只能从 archive.jsonl 找
|
|
141
|
+
```
|
|
142
|
+
|
|
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` 里 | ❌ 计时继续走 |
|
|
162
|
+
|
|
163
|
+
**一直有人问的事,永远走不到第二层。** 这就是"反复去问才会保留"。
|
|
164
|
+
|
|
165
|
+
### 人设也一样
|
|
166
|
+
|
|
167
|
+
命题(units)的衰减不是"每天掉一点",是**长期没人碰才掉**:
|
|
168
|
+
|
|
169
|
+
```
|
|
170
|
+
最后一次被碰到 → 30 天内还有人聊到 → 不掉
|
|
171
|
+
→ 30 天没人碰 → 开始每天 ×0.999
|
|
172
|
+
→ 掉到 0.15 → 蜕皮成"我以前……"
|
|
173
|
+
```
|
|
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 })
|
|
190
|
+
```
|
|
191
|
+
|
|
192
|
+
**老鱼接入建议**:如果两年记忆一条都不能丢,用 `off` 或把 `forgetDays` 调到 3650。
|
|
193
|
+
|
|
194
|
+
---
|
|
195
|
+
|
|
196
|
+
## 六、日记是她的心房,她自己写
|
|
197
|
+
|
|
198
|
+
**宿主的日记不是她的日记。** 宿主记的是"发生过什么",她记的是"我怎么想"。
|
|
199
|
+
|
|
200
|
+
脑子不生成文笔(那是嘴的事),它做三件事:
|
|
201
|
+
|
|
202
|
+
```js
|
|
203
|
+
// ① 给素材 + 第一人称骨架
|
|
204
|
+
feiyu_diary({ action: 'digest' })
|
|
205
|
+
```
|
|
206
|
+
|
|
207
|
+
```
|
|
208
|
+
【2026-11-21 的素材】经历 2 条,见了 扶摇、访秋辞,心情 平静
|
|
209
|
+
|
|
210
|
+
# 2026-11-21
|
|
211
|
+
|
|
212
|
+
今天跟扶摇、访秋辞说了话。
|
|
213
|
+
|
|
214
|
+
- 扶摇:「你嘴真硬」
|
|
215
|
+
- 访秋辞:「吃饭了吗」
|
|
216
|
+
|
|
217
|
+
👉 用她自己的口吻把今天写成日记,别用第三人称,别总结升华,写完存回去。
|
|
218
|
+
```
|
|
219
|
+
|
|
220
|
+
```js
|
|
221
|
+
// ② 用她的口吻写完之后,存回去
|
|
222
|
+
feiyu_diary({ action: 'write', text: '今天扶摇又说我嘴硬。我没理他,但记下了。' })
|
|
223
|
+
```
|
|
224
|
+
|
|
225
|
+
```js
|
|
226
|
+
// ③ 以后能翻旧账
|
|
227
|
+
feiyu_diary({ action: 'read', date: '2026-11-21' })
|
|
228
|
+
feiyu_diary({ action: 'list' })
|
|
229
|
+
```
|
|
230
|
+
|
|
231
|
+
存哪:`<dataDir>/brains/<id>/days/2026-11-21.md`——**跟宿主的日记目录分开,不互相覆盖。**
|
|
232
|
+
|
|
233
|
+
写进去之后会自动记一条 `source:'diary'` 的经历,所以问"你写过什么"她能想起来。
|
|
234
|
+
|
|
235
|
+
命令行一样:
|
|
236
|
+
|
|
237
|
+
```bash
|
|
238
|
+
npx feiyu diary # 今天的素材
|
|
239
|
+
npx feiyu diary write ./note.md # 存回去
|
|
240
|
+
npx feiyu diary list
|
|
241
|
+
npx feiyu diary read 2026-11-21
|
|
242
|
+
```
|
|
243
|
+
|
|
244
|
+
---
|
|
245
|
+
|
|
246
|
+
## 七、全量整合:只剩一份记忆
|
|
247
|
+
|
|
248
|
+
一条命令把所有记忆源并进脑子:
|
|
249
|
+
|
|
250
|
+
```bash
|
|
251
|
+
# 先看会搬多少(不写任何东西)
|
|
252
|
+
npx feiyu migrate D:\cici\qq-bridge\memory --all --dry-run
|
|
253
|
+
|
|
254
|
+
# 确认无误,真搬 + 收走原文件
|
|
255
|
+
npx feiyu migrate D:\cici\qq-bridge\memory --all --delete-source
|
|
256
|
+
|
|
257
|
+
# 自检
|
|
258
|
+
npx feiyu verify
|
|
259
|
+
```
|
|
260
|
+
|
|
261
|
+
实测输出:
|
|
262
|
+
|
|
263
|
+
```
|
|
264
|
+
扫到 2 个文件 解析出 4 条 重复 0 条 将导入 4 条
|
|
265
|
+
时间跨度 2026-11-18 → 2026-11-18
|
|
266
|
+
|
|
267
|
+
✔ 全量导入 4 条,现在共 4 条经历。
|
|
268
|
+
原文件已改名 2 个:
|
|
269
|
+
2026-11-18.md.migrated
|
|
270
|
+
experience.jsonl.migrated
|
|
271
|
+
体检:是她
|
|
272
|
+
```
|
|
273
|
+
|
|
274
|
+
```
|
|
275
|
+
经历 4 条(亲历 0 / 搬来 4) 卡片 0 认识 2 个人
|
|
276
|
+
体检:是她
|
|
277
|
+
回忆抽检:100%(4/4)
|
|
278
|
+
✔ 「你嘴真硬啊」
|
|
279
|
+
✔ 「吃饭了吗」
|
|
280
|
+
✔ 「又怼我」
|
|
281
|
+
✔ 「刷到个驴蹄子」
|
|
282
|
+
```
|
|
283
|
+
|
|
284
|
+
### 三条设计决定,说清楚
|
|
285
|
+
|
|
286
|
+
**① 原文件是改名,不是删除**
|
|
287
|
+
|
|
288
|
+
`--delete-source` 把 `x.md` 变成 `x.md.migrated`。**我们不替你 rm。**
|
|
289
|
+
跑一周觉得没问题,你自己删 `.migrated` 就行;万一搬漏了还能回去翻。
|
|
290
|
+
|
|
291
|
+
**② 自动认格式**
|
|
292
|
+
|
|
293
|
+
```
|
|
294
|
+
.jsonl → 一行一条 JSON
|
|
295
|
+
.md / .txt → 日记式
|
|
296
|
+
.json → JSON 数组
|
|
297
|
+
```
|
|
298
|
+
|
|
299
|
+
按扩展名嗅探;认不出的行**跳过并报行号**,不猜。
|
|
300
|
+
|
|
301
|
+
**③ 容量保护:5000 条封顶**
|
|
302
|
+
|
|
303
|
+
脑里超过 5000 条经历时,最老的一批自动:
|
|
304
|
+
- 压成一张 ≤160 字卡片(还在上下文里)
|
|
305
|
+
- 原文追加到 `archive.jsonl`(要查还能查)
|
|
306
|
+
|
|
307
|
+
**脑子不会因为搬了三年日记就变成几百 MB 的 json。**
|
|
308
|
+
|
|
309
|
+
### 代价(必须知道)
|
|
310
|
+
|
|
311
|
+
| 代价 | 说明 |
|
|
312
|
+
|---|---|
|
|
313
|
+
| **脑变成单点** | 只有 `brain.json`(有 `.bak` 自动备份 + `snapshot` 手动存档) |
|
|
314
|
+
| **日记不可读** | md 人能手翻,json 不能。想看原文靠 `archive.jsonl` |
|
|
315
|
+
| **情绪是空的** | 日记里没有"当时什么感受",搬进来的 `emotion` 全是 0 |
|
|
316
|
+
| **先搬后忘** | 两层老化照常走:没人提 30 天会变模糊、90 天会忘(原文在 `archive.jsonl`)。要一条不丢就 `ttlPolicy: off` 或把 `forgetDays` 调大 |
|
|
317
|
+
|
|
318
|
+
最后一条最容易被忽略:**你搬进来的是三年前的日记,但老化计时从"搬进来那天"开始。**
|
|
319
|
+
|
|
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/`,一个字不改。那是她写过的东西,不是流水账。
|
|
348
|
+
|
|
349
|
+
---
|
|
350
|
+
|
|
351
|
+
## 七、验收
|
|
352
|
+
|
|
353
|
+
| # | 场景 | 期望 |
|
|
354
|
+
|---|---|---|
|
|
355
|
+
| 1 | 同一份文件搬两次 | 第二次导入 0 条(去重) |
|
|
356
|
+
| 2 | 文件里有坏行 | 好行照搬,坏行报行号 |
|
|
357
|
+
| 3 | 搬完 `identityCheck` | `verdict: 是她` |
|
|
358
|
+
| 4 | 搬完 `wake` 带关键词 | 能检索到搬进来的内容 |
|
|
359
|
+
| 5 | 新鱼不搬 | 记忆 0 条,第一次 `observe` 后才开始长 |
|
|
360
|
+
|
|
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
|
+
**因为不会才问,这才叫学习。**
|
|
@@ -0,0 +1,136 @@
|
|
|
1
|
+
# 装不上 / 装上了不工作 —— 排障表
|
|
2
|
+
|
|
3
|
+
> **先跑这条**:
|
|
4
|
+
> ```bash
|
|
5
|
+
> npx feiyu doctor # 只查
|
|
6
|
+
> npx feiyu doctor --fix # 能修的替你修(bundles + 工具白名单)
|
|
7
|
+
> ```
|
|
8
|
+
> 它查 pnpm、插件登记、工具白名单、数据目录,逐项给出修法。下面的手工步骤是它修不了时的兜底。
|
|
9
|
+
|
|
10
|
+
> 来自一次真机(Windows 11 + DSH 0.2.2-rc.1 + 全新设备)的实测,五处会卡。
|
|
11
|
+
|
|
12
|
+
---
|
|
13
|
+
|
|
14
|
+
## 一、装不进去
|
|
15
|
+
|
|
16
|
+
### ① `'pnpm' 不是内部或外部命令`
|
|
17
|
+
|
|
18
|
+
`dsh plugin add` 底层调 pnpm。**这不是插件的问题,是机器上没有 pnpm。**
|
|
19
|
+
|
|
20
|
+
```powershell
|
|
21
|
+
npm i -g pnpm
|
|
22
|
+
pnpm -v # 确认
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
或者用 corepack:
|
|
26
|
+
|
|
27
|
+
```powershell
|
|
28
|
+
corepack enable pnpm
|
|
29
|
+
```
|
|
30
|
+
|
|
31
|
+
### ② DSH CLI 直接 `node bin.js` 报 `MODULE_NOT_FOUND`
|
|
32
|
+
|
|
33
|
+
DSH 桌面版把 CLI 打包在 `app.asar` 里,普通 node 读不了。用 Electron 跑:
|
|
34
|
+
|
|
35
|
+
```powershell
|
|
36
|
+
$env:ELECTRON_RUN_AS_NODE="1"
|
|
37
|
+
& "D:\你的安装目录\DeepSeek Harness.exe" `
|
|
38
|
+
"D:\你的安装目录\resources\app.asar\dsh\node_modules\@deepseek-ai\dsh\lib\bin.js" `
|
|
39
|
+
plugin --profile desktop add feiyu-brain
|
|
40
|
+
```
|
|
41
|
+
|
|
42
|
+
---
|
|
43
|
+
|
|
44
|
+
## 二、装上了但没生效
|
|
45
|
+
|
|
46
|
+
### ③ `pnpm add` 成功,但 DSH 启动时没装配它
|
|
47
|
+
|
|
48
|
+
检查 `~/.dsh/profiles/<profile>/package.json` 两处都要有:
|
|
49
|
+
|
|
50
|
+
```jsonc
|
|
51
|
+
{
|
|
52
|
+
"dependencies": { "feiyu-brain": "^1.6.0" },
|
|
53
|
+
"dsh": {
|
|
54
|
+
"profile": {
|
|
55
|
+
"bundles": [ "...", "feiyu-brain" ] // ← 这一行最容易漏
|
|
56
|
+
}
|
|
57
|
+
}
|
|
58
|
+
}
|
|
59
|
+
```
|
|
60
|
+
|
|
61
|
+
漏了就直接打开 DSH 也不会加载——**等于没装**。
|
|
62
|
+
|
|
63
|
+
### ④ 六个/八个 `feiyu_*` 工具被闸门拒
|
|
64
|
+
|
|
65
|
+
`~/.dsh/state/tool-allow.json` 的 `exact` 里加上:
|
|
66
|
+
|
|
67
|
+
```jsonc
|
|
68
|
+
{
|
|
69
|
+
"exact": [
|
|
70
|
+
"feiyu_status", "feiyu_wake", "feiyu_observe", "feiyu_tick",
|
|
71
|
+
"feiyu_feel", "feiyu_app", "feiyu_lint", "feiyu_snapshot"
|
|
72
|
+
]
|
|
73
|
+
}
|
|
74
|
+
```
|
|
75
|
+
|
|
76
|
+
不想一个个加就加前缀 `feiyu_`。
|
|
77
|
+
|
|
78
|
+
### ⑤ 数据写到包目录里,升级就丢
|
|
79
|
+
|
|
80
|
+
1.5 之前,`dataDir` 留空会落到包同级。装进 `node_modules` 之后那是**只读目录**,
|
|
81
|
+
`brain.json` 写不进去,或者升级就被覆盖。
|
|
82
|
+
|
|
83
|
+
**1.6 起自动判断**:
|
|
84
|
+
|
|
85
|
+
| 情况 | 数据落在哪 |
|
|
86
|
+
|---|---|
|
|
87
|
+
| 显式配了 `dataDir` | 你配的地方 |
|
|
88
|
+
| 环境变量 `FEIYU_DATA_DIR` | 那儿 |
|
|
89
|
+
| 仓库内开发 | `<仓库>/state` |
|
|
90
|
+
| **装进 node_modules** | **`~/.feiyu-brain/state`** |
|
|
91
|
+
|
|
92
|
+
自己查一下:
|
|
93
|
+
|
|
94
|
+
```bash
|
|
95
|
+
npx feiyu status # 或者看 /status 工具返回的 runtime.dataDir
|
|
96
|
+
```
|
|
97
|
+
|
|
98
|
+
`runtime.dataDirInsidePackage` 为 `true` 就说明还在包里,需要显式配。
|
|
99
|
+
|
|
100
|
+
---
|
|
101
|
+
|
|
102
|
+
## 三、装上了、但"她没长大"
|
|
103
|
+
|
|
104
|
+
**先跑这三步,别急着怀疑装错。**
|
|
105
|
+
|
|
106
|
+
```bash
|
|
107
|
+
npx feiyu status # 命题数、记忆数
|
|
108
|
+
npx feiyu observe 某人 "他说的话" # 手动记一条
|
|
109
|
+
npx feiyu status # 权重变了吗?记忆 +1 了吗?
|
|
110
|
+
```
|
|
111
|
+
|
|
112
|
+
如果手动 `observe` 有效,但接上桥接后不动——**那是适配器契约问题**,
|
|
113
|
+
看 [ADAPTER-CONTRACT.md](ADAPTER-CONTRACT.md),八成是 `recentMessages` 没有 `seq`。
|
|
114
|
+
|
|
115
|
+
---
|
|
116
|
+
|
|
117
|
+
## 四、想先试跑、不想改线上人格
|
|
118
|
+
|
|
119
|
+
```js
|
|
120
|
+
createBrain({ id: 'fy-test', dataDir, roleDir, cardText, shadow: true })
|
|
121
|
+
```
|
|
122
|
+
|
|
123
|
+
- 用独立 `brainId`(比如 `fy-test`),跟线上那条鱼完全隔离
|
|
124
|
+
- 影子模式下 `observe` 只写审计,**权重一个都不动**
|
|
125
|
+
- 跑一百轮,看 `wouldChange` 合不合预期,再关掉 shadow 正式接
|
|
126
|
+
|
|
127
|
+
---
|
|
128
|
+
|
|
129
|
+
## 五、一次性自检
|
|
130
|
+
|
|
131
|
+
```bash
|
|
132
|
+
npx feiyu status # 数据目录 / 影子模式 / TTL 策略都会打出来
|
|
133
|
+
npx feiyu lint # 卡写得对不对、哪几行会被忽略
|
|
134
|
+
```
|
|
135
|
+
|
|
136
|
+
两条都正常,才算真的装好了。
|