feiyu-brain 1.2.0 → 1.4.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/README.md +24 -0
- package/core/apps.js +279 -0
- package/core/driver.js +184 -0
- package/core/emotion.js +259 -0
- package/core/extract.js +39 -12
- package/core/memory.js +82 -2
- package/core/persona.js +6 -3
- package/docs/FEATURES.md +481 -0
- package/index.js +459 -7
- package/lib/dsh-plugin.mjs +100 -3
- package/market/fangqiuci__feiyu-brain.yml +2 -2
- package/package.json +1 -1
- package/store.js +15 -2
package/docs/FEATURES.md
ADDED
|
@@ -0,0 +1,481 @@
|
|
|
1
|
+
# feiyu-brain · 功能清单
|
|
2
|
+
|
|
3
|
+
> 一份把代码里所有能用的东西列全的说明书。
|
|
4
|
+
> 版本 1.2.0 · MIT · 零依赖 · Node ≥ 20
|
|
5
|
+
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
## 一、它是什么
|
|
9
|
+
|
|
10
|
+
**一个认知内核。** 输入一张人设卡,输出"此刻的她"和她的状态变化。
|
|
11
|
+
|
|
12
|
+
```
|
|
13
|
+
人设卡(roles/辞辞.md)
|
|
14
|
+
↓ 抽取
|
|
15
|
+
77 条带权重的命题
|
|
16
|
+
↓ 经历
|
|
17
|
+
权重 ±0.01 / 记忆进一条
|
|
18
|
+
↓ 唤醒
|
|
19
|
+
【此刻的她】你是 DeepSeek 的鲸鱼形象……
|
|
20
|
+
【手上的东西】自己的手机(竖屏,躺着 / 走着)
|
|
21
|
+
【想到的】扶摇说过「你嘴真硬」,我当时有点得意
|
|
22
|
+
```
|
|
23
|
+
|
|
24
|
+
**它不生成对话。** 对话由宿主自己的模型完成——它只负责"她是谁、她记得什么、她现在什么状态"。
|
|
25
|
+
|
|
26
|
+
---
|
|
27
|
+
|
|
28
|
+
## 二、两种形态
|
|
29
|
+
|
|
30
|
+
| 形态 | 入口 | 给谁 |
|
|
31
|
+
|---|---|---|
|
|
32
|
+
| **库** | `import { createBrain } from 'feiyu-brain'` | 自己写宿主的人 |
|
|
33
|
+
| **DSH 插件** | `dsh plugin add feiyu-brain` | 想直接让模型调用的人 |
|
|
34
|
+
|
|
35
|
+
同一个包,`main` 指向插件入口,插件入口 `export *` 回库——两种用法互不影响。
|
|
36
|
+
|
|
37
|
+
---
|
|
38
|
+
|
|
39
|
+
## 三、6 个 DSH 工具
|
|
40
|
+
### 1. `feiyu_status`
|
|
41
|
+
|
|
42
|
+
看她的状态。**只读,不改变任何东西。**
|
|
43
|
+
|
|
44
|
+
| 参数 | 类型 | 必填 | 说明 |
|
|
45
|
+
|---|---|---|---|
|
|
46
|
+
| `id` | string | 否 | 鱼的 id,默认 `default` |
|
|
47
|
+
|
|
48
|
+
返回:
|
|
49
|
+
|
|
50
|
+
```
|
|
51
|
+
🐟 default · 人设卡 辞辞
|
|
52
|
+
自知 denial(aware 11.4% / denial 63.2% / fixed 12.5% / naive 12.9%)
|
|
53
|
+
意识流 正常(1)
|
|
54
|
+
身体 手机(竖屏,躺着 / 走着,owned)
|
|
55
|
+
命题 77 条(身份 3 条,总权重 58.6)
|
|
56
|
+
记忆 经历 3 / 印象 3 / 幻想 0 / 蜕皮 0 / 遗忘 0
|
|
57
|
+
观察 3 次
|
|
58
|
+
|
|
59
|
+
权重最高的五条:
|
|
60
|
+
u004 0.85 别人叫你"大肥鱼"你会嘴硬否认……
|
|
61
|
+
...
|
|
62
|
+
|
|
63
|
+
不变量:全部通过 ✔
|
|
64
|
+
```
|
|
65
|
+
|
|
66
|
+
同时返回结构化 `snapshot`(人设 traits、style、weights、memory 计数、不变量违规列表)。
|
|
67
|
+
|
|
68
|
+
### 2. `feiyu_wake`
|
|
69
|
+
|
|
70
|
+
取"此刻的她"——**一段可直接拼进 system prompt 的定长文本**。不记录经历。
|
|
71
|
+
|
|
72
|
+
| 参数 | 类型 | 必填 | 说明 |
|
|
73
|
+
|---|---|---|---|
|
|
74
|
+
| `id` | string | 否 | 鱼的 id |
|
|
75
|
+
| `sender` | string | 否 | 当前说话的人,用于检索「对他的记忆」 |
|
|
76
|
+
| `text` | string | 否 | 他说的话,用于关键词检索 |
|
|
77
|
+
|
|
78
|
+
返回 `{ ok, text, chars }`。定长:brief ≤300 字 + 记忆 ≤900 字。
|
|
79
|
+
|
|
80
|
+
### 3. `feiyu_observe`
|
|
81
|
+
|
|
82
|
+
让她"经历"一件事。**这是她长大的唯一途径**——不调用,人设永远不变。
|
|
83
|
+
|
|
84
|
+
| 参数 | 类型 | 必填 | 说明 |
|
|
85
|
+
|---|---|---|---|
|
|
86
|
+
| `id` | string | 否 | 鱼的 id |
|
|
87
|
+
| `who` | string | 否 | 和谁发生的 |
|
|
88
|
+
| `text` | string | **是** | 发生了什么 |
|
|
89
|
+
| `feel` | string | 否 | 她当时的感受 |
|
|
90
|
+
|
|
91
|
+
副作用:
|
|
92
|
+
|
|
93
|
+
- 相关命题权重 `+0.01`,冲突命题 `-0.01`
|
|
94
|
+
- 权重掉到 `0.15` 以下 → 蜕皮成"我以前……"
|
|
95
|
+
- 记忆里进一条 episode
|
|
96
|
+
- 印象里的互动次数 `+1`
|
|
97
|
+
|
|
98
|
+
返回「一致 N 条 / 冲突 M 条」——**没匹配到任何命题时会明说「人设不动」**,不会假装有效。
|
|
99
|
+
|
|
100
|
+
### 4. `feiyu_tick`
|
|
101
|
+
|
|
102
|
+
每日结算。幂等,一天跑多次也只结算一次。
|
|
103
|
+
|
|
104
|
+
| 参数 | 类型 | 必填 | 说明 |
|
|
105
|
+
|---|---|---|---|
|
|
106
|
+
| `id` | string | 否 | 鱼的 id |
|
|
107
|
+
|
|
108
|
+
做三件事:**衰减**(`×0.999/天`)、**遗忘**(TTL 到期进 `forgotten`)、**蜕皮**(权重到底的沉进 `formerSelves`)。
|
|
109
|
+
|
|
110
|
+
### 5. `feiyu_feel`
|
|
111
|
+
|
|
112
|
+
让她对一件事产生感受。
|
|
113
|
+
|
|
114
|
+
| 参数 | 类型 | 必填 | 说明 |
|
|
115
|
+
|---|---|---|---|
|
|
116
|
+
| `id` | string | 否 | 鱼的 id |
|
|
117
|
+
| `valence` | number | **是** | 这件事对她好不好,-1 ~ 1 |
|
|
118
|
+
| `intensity` | number | 否 | 强度,0 ~ 1 |
|
|
119
|
+
| `what` | string | 否 | 发生了什么 |
|
|
120
|
+
|
|
121
|
+
做两件事:先算 PAD,再找词。
|
|
122
|
+
|
|
123
|
+
```
|
|
124
|
+
PAD 三维
|
|
125
|
+
掌控感 = f(energy, 嘴硬, 自信, 疲劳) ← 决定她是生气还是委屈
|
|
126
|
+
唤醒度 = f(intensity, 敏感)
|
|
127
|
+
愉悦度 = f(valence, 敏感)
|
|
128
|
+
↓
|
|
129
|
+
在已学会的词里找最近的原型(半径 0.42)
|
|
130
|
+
半径内 → 「我有点委屈」
|
|
131
|
+
两倍内 → 「我委屈,但跟以前那种不太一样」
|
|
132
|
+
两词之间 → 「说不清,有点像委屈,又有点像烦」
|
|
133
|
+
找不到 → 「我不知道这是什么感觉,就是很不舒服」
|
|
134
|
+
```
|
|
135
|
+
|
|
136
|
+
**词表空的时候她只会说最后那句——这是设计,不是 bug。**
|
|
137
|
+
|
|
138
|
+
### 6. `feiyu_app`
|
|
139
|
+
|
|
140
|
+
让她真的动起来。
|
|
141
|
+
|
|
142
|
+
| 参数 | 类型 | 必填 | 说明 |
|
|
143
|
+
|---|---|---|---|
|
|
144
|
+
| `id` | string | 否 | 鱼的 id |
|
|
145
|
+
| `action` | string | **是** | `open` / `screenshot` / `uninstall` |
|
|
146
|
+
| `package` | string | 否 | Android 包名,如 `com.ss.android.ugc.aweme` |
|
|
147
|
+
| `target` | string | 否 | 电脑上要启动的程序 |
|
|
148
|
+
| `why` / `consequence` | string | 否 | 卸载的 Q1 / Q3 |
|
|
149
|
+
|
|
150
|
+
- 手机 / 平板 / 模拟器 → **adb**:`monkey` 开 App、`screencap` 截屏、`uninstall` 卸载
|
|
151
|
+
- 电脑 → **PowerShell**:`Start-Process` 启动、`System.Drawing` 截屏
|
|
152
|
+
- 电脑上**禁止卸载**(`E_FORBIDDEN`)——太不可逆,必须人来做
|
|
153
|
+
- 每个动作写一条 evidence(截图文件 / `adb:uninstall:pkg`),**没有证据不算发生**
|
|
154
|
+
|
|
155
|
+
---
|
|
156
|
+
|
|
157
|
+
## 四、八个核心机制
|
|
158
|
+
|
|
159
|
+
### 1. 人设:从卡里长出来
|
|
160
|
+
|
|
161
|
+
| 函数 | 干什么 |
|
|
162
|
+
|---|---|
|
|
163
|
+
| `extractTraits(cardText)` | 用 10 个特质的词典卡,数出 0~1 的倾向向量(嘴硬 / 心软 / 好奇 / 好动 / 敏感 / 固执 / 自信 / 爱反思 / 理性 / 社交) |
|
|
164
|
+
| `extractUnits(cardText)` | 把卡里每条 bullet / 编号 / 引用 / 散文行抽成**命题**,分四类:`identity`(权重 1,永不衰减)/ `constraint`(0.85)/ `preference`(0.7)/ `trait`(0.6) |
|
|
165
|
+
| `birthFromCard(cardText)` | 上面两个一起跑 |
|
|
166
|
+
|
|
167
|
+
**同一张卡永远抽出同一组值**(确定性,可回放);换一张卡就长出另一条鱼。
|
|
168
|
+
|
|
169
|
+
### 2. brief:她现在的样子
|
|
170
|
+
|
|
171
|
+
`brief(units, {maxChars=300})`
|
|
172
|
+
|
|
173
|
+
- 按 `kind` 分层:身份 → 性格 → 偏好 → 约束
|
|
174
|
+
- 每条压成一句短话(去括号、取首个分句、过长才截)
|
|
175
|
+
- 用二元组相似度去重(防止「本体是……」出现两遍)
|
|
176
|
+
- 硬上限 300 字
|
|
177
|
+
|
|
178
|
+
### 3. 权重演化:不知不觉
|
|
179
|
+
|
|
180
|
+
| 常量 | 值 | 含义 |
|
|
181
|
+
|---|---|---|
|
|
182
|
+
| `WEIGHT_STEP` | 0.01 | 每次 ±0.01,**100 次才看得出来** |
|
|
183
|
+
| `DAILY_DECAY` | 0.999 | 每天自然褪色 |
|
|
184
|
+
| `SHED_THRESHOLD` | 0.15 | 低于此值蜕皮 |
|
|
185
|
+
|
|
186
|
+
`identity` 类**永不衰减、永不蜕皮**——身份不能忘。
|
|
187
|
+
|
|
188
|
+
### 4. 记忆:30 天窗口
|
|
189
|
+
|
|
190
|
+
| 类型 | 半衰期 | 谁定 |
|
|
191
|
+
|---|---|---|
|
|
192
|
+
| `episode`(情景) | 30 天 | `TTL_DAYS.episode` |
|
|
193
|
+
| `imagination`(幻想) | 30 天 | 独立池,永不进 episodes |
|
|
194
|
+
| `impression`(印象) | 90 天 | `TTL_DAYS.impression` |
|
|
195
|
+
| `fact` / `taste` | 不衰减 | `Infinity` |
|
|
196
|
+
|
|
197
|
+
- **提起续命**:`recall()` 重置 `lastRecall`
|
|
198
|
+
- **连续 15 天被提 → 升级 longTerm**,不再衰减(`PROMOTE_DAYS`)
|
|
199
|
+
- **忘了就是真的没有**:进 `forgotten`,不可检索
|
|
200
|
+
|
|
201
|
+
**四路检索** `retrieve(cue, memory)`,总长 ≤900 字:
|
|
202
|
+
|
|
203
|
+
| 线索 | 取什么 |
|
|
204
|
+
|---|---|
|
|
205
|
+
| 谁在说话 | 对他的印象 + 跟他的最近 3 次 |
|
|
206
|
+
| 说了什么词 | 相关 fact + 我对这词的态度(taste) |
|
|
207
|
+
| 我现在什么情绪 | 同情绪的旧事 |
|
|
208
|
+
| 最近发生了什么 | 近 7 天情绪最重的 3 件 |
|
|
209
|
+
|
|
210
|
+
### 5. 意识流:一条轴五档
|
|
211
|
+
|
|
212
|
+
`flowLevel(state, ctx)` → `0 / 0.2 / 1 / 1.5 / 2`
|
|
213
|
+
|
|
214
|
+
| 档位 | 触发 | 名字 |
|
|
215
|
+
|---|---|---|
|
|
216
|
+
| 0 | `sleep === 'asleep'` | 休眠 |
|
|
217
|
+
| 0.2 | `energy < 0.2` 或闲置 > 45 分钟 | 发呆 |
|
|
218
|
+
| 1.0 | 其余 | 正常 |
|
|
219
|
+
| 1.5 | 被打断但心里有别的事 | 走神 |
|
|
220
|
+
| 2.0 | `boredom > 0.7` 或睡前 | 幻想 |
|
|
221
|
+
|
|
222
|
+
优先序固定 → 全函数,不会两档都符合。
|
|
223
|
+
|
|
224
|
+
### 6. 自知:四种方向的份量
|
|
225
|
+
|
|
226
|
+
`styleVector(traits)` → `{aware, denial, fixed, naive}`,和为 1。
|
|
227
|
+
|
|
228
|
+
```
|
|
229
|
+
aware = 0.7·敏感 + 0.3·爱反思 "我最近不太一样了"
|
|
230
|
+
denial = 0.8·嘴硬 + 0.2·敏感 "我没变"(其实变了)
|
|
231
|
+
fixed = 0.8·固执 + 0.2·自信 "你想多了"(抗拒证据)
|
|
232
|
+
naive = 剩下的 "啊?有吗"
|
|
233
|
+
```
|
|
234
|
+
|
|
235
|
+
辞辞算出来约 `(0.11, 0.63, 0.13, 0.13)`——**不是一个标签,是一个配方**。
|
|
236
|
+
|
|
237
|
+
`sampleStyle(style, rng)` 按这个分布抽样,所以同一条鱼在不同时刻可能给不同反应。
|
|
238
|
+
|
|
239
|
+
### 7. 归因:不审批,只贴标签
|
|
240
|
+
|
|
241
|
+
`attribute(action, memory)` → 五种之一,优先序固定所以唯一:
|
|
242
|
+
|
|
243
|
+
| 顺序 | 标签 | 判据 |
|
|
244
|
+
|---|---|---|
|
|
245
|
+
| 1 | 明知故犯 | 做过 + 结果坏,还是做了 |
|
|
246
|
+
| 2 | 硬撑 | 状态不支持,还是做了 |
|
|
247
|
+
| 3 | 有据 | 做过 + 结果好 |
|
|
248
|
+
| 4 | 即兴 | 没做过,但临场想出来了 |
|
|
249
|
+
| 5 | 说不清 | 归不到上面 |
|
|
250
|
+
|
|
251
|
+
**拦截只有两条**(`intercept()`):违反人设红线 `C1` / 违反安全规则 `SAFETY`。加第三条就是入侵她的自由。
|
|
252
|
+
|
|
253
|
+
`ecg(labels)` 算归因分布,对照健康区间——**任何一格归零,她就退化成另一种东西**(全"有据"是复读机,全"说不清"是随机数生成器)。
|
|
254
|
+
|
|
255
|
+
### 8. 身体:手机 / 平板 / 电脑
|
|
256
|
+
|
|
257
|
+
| | 手机 | 平板 | 电脑 |
|
|
258
|
+
|---|---|---|---|
|
|
259
|
+
| 屏幕 | 竖屏 | 横屏 | 大屏 |
|
|
260
|
+
| 姿势 | 躺着 / 走着 | 靠着 / 趴着 | 坐着 |
|
|
261
|
+
| 自带 App | 抖音/快手/QQ/微信/B站 | B站/爱奇艺/抖音/QQ | 浏览器/QQ/Steam/VSCode/B站 |
|
|
262
|
+
|
|
263
|
+
**权限四级**:`L1 观察` / `L2 操作` / `L3 破坏` / `L4 金钱`。
|
|
264
|
+
|
|
265
|
+
- `owned` 默认给到 L3,`borrowed` 只给到 L2,`emulator` 到 L3
|
|
266
|
+
- **L4 永不默认**,且是两道门:身体要有 L4 + 这一次要 `approved`
|
|
267
|
+
- `canDo(body, action)` 返回 `{ok, code, reason}`,永不抛
|
|
268
|
+
- **没有身体 → `E_NO_BODY`**,不是崩溃,是"想而不得"
|
|
269
|
+
|
|
270
|
+
**摸哪具是人设算的**:`bodyScores(traits, ctx)` → 好动 → 手机,累 → 平板,理性好奇 → 电脑;`chooseBody()` 按分数抽样(rng 可注入,可回放)。
|
|
271
|
+
|
|
272
|
+
`recordAction()` 记账,**没有 `evidence` 的动作不算发生**。
|
|
273
|
+
|
|
274
|
+
### 附:关系与忍耐
|
|
275
|
+
|
|
276
|
+
| 函数 | 干什么 |
|
|
277
|
+
|---|---|
|
|
278
|
+
| `createContract(type, address)` | 关系契约,四种:`parent` / `sibling` / `partner` / `stranger` |
|
|
279
|
+
| `attentionBoost(sender, relation)` | 关系里的人**无条件进意识**(优先级 1.0)——但不管"怎么回" |
|
|
280
|
+
| `canSever` / `beginColdWar` / `sever` | 只有 `partner` 可解除:冷战 → severed,**记忆全留** |
|
|
281
|
+
| `assertContractImmutable` | `mustRecognize` / `dissolvable` / `priority` 三个字段任何漂移通道都不许动 |
|
|
282
|
+
|
|
283
|
+
| 函数 | 干什么 |
|
|
284
|
+
|---|---|
|
|
285
|
+
| `PATIENCE_DELTA` | 通用忍耐值:被吵醒 −0.15 / 被冒犯 −0.08 / 被忽视 −0.05 / 和好 +0.20 |
|
|
286
|
+
| `applyPatience` / `isOutburst` | 低于 0.2 爆发 |
|
|
287
|
+
| `whimProbability(mood)` | 发癫概率 `0.04 + 0.16×\|mood\|`,上限 20% |
|
|
288
|
+
| `wakeReply(traits, energy, rng)` | 被吵醒说什么,**168 种组合**,权重由嘴硬/心软/理性/社交连续算出 |
|
|
289
|
+
|
|
290
|
+
---
|
|
291
|
+
|
|
292
|
+
## 五、API 全表
|
|
293
|
+
|
|
294
|
+
### 入口 `index.js`
|
|
295
|
+
|
|
296
|
+
**生命周期**
|
|
297
|
+
|
|
298
|
+
| 函数 | 说明 |
|
|
299
|
+
|---|---|
|
|
300
|
+
| `configure({dataDir, roleDir})` | 指定数据目录 / 角色卡目录 |
|
|
301
|
+
| `birth({id, relation, address, cardText, cardName, body})` | 出生 |
|
|
302
|
+
| `ensureBrain(id)` | 取(没有就出生) |
|
|
303
|
+
| `resolveRoleCard(name)` | 从 `state/current-role.json` 或显式名字找卡 |
|
|
304
|
+
| `createBrain(options)` | 对象式门面,见下 |
|
|
305
|
+
| `exportBrain(id)` / `importBrain(data)` | 搬家 |
|
|
306
|
+
| `forgetCache(id)` | 清内存缓存(改盘后重读) |
|
|
307
|
+
|
|
308
|
+
**读写**
|
|
309
|
+
|
|
310
|
+
| 函数 | 说明 |
|
|
311
|
+
|---|---|
|
|
312
|
+
| `getBrief(id)` | 300 字 brief |
|
|
313
|
+
| `wakeLine(id, eventOrCue)` | 唤醒段 |
|
|
314
|
+
| `observe(id, event)` | 经历 |
|
|
315
|
+
| `settleBrain(id, now)` | 每日结算 |
|
|
316
|
+
| `snapshot(id)` | 全量快照 |
|
|
317
|
+
| `touch(id, key, {pool})` | 手动续命 |
|
|
318
|
+
| `matchUnits(units, text)` | 二元组粗匹配(observe 内部用) |
|
|
319
|
+
| `setBody(id, kind, opts)` | 换身体(会写 audit) |
|
|
320
|
+
| `tryBody(id, action)` | 试一次动作,拒绝也记账 |
|
|
321
|
+
| `listBrains()` / `readAudit(id, n)` | 列出 / 审计 |
|
|
322
|
+
|
|
323
|
+
**`createBrain()` 返回的对象**
|
|
324
|
+
|
|
325
|
+
```js
|
|
326
|
+
const fy = createBrain({ id, dataDir, roleDir, relation, address, cardText })
|
|
327
|
+
fy.wake(event) // { text, id } 内部自动 observe
|
|
328
|
+
fy.observe(event)
|
|
329
|
+
fy.tick(now)
|
|
330
|
+
fy.brief()
|
|
331
|
+
fy.snapshot()
|
|
332
|
+
fy.export()
|
|
333
|
+
fy.reset(opts)
|
|
334
|
+
fy.brain // 原始对象
|
|
335
|
+
```
|
|
336
|
+
|
|
337
|
+
### 其它模块
|
|
338
|
+
|
|
339
|
+
| 模块 | 主要导出 |
|
|
340
|
+
|---|---|
|
|
341
|
+
| `core/extract.js` | `TRAIT_LEXICON` `extractTraits` `extractUnits` `birthFromCard` `plainText` |
|
|
342
|
+
| `core/persona.js` | `brief` `evolve` `decay` `shed` `weightReport` + 三个常量 |
|
|
343
|
+
| `core/memory.js` | `emptyMemory` `addEpisode` `addImagination` `recall` `settle` `retrieve` `hasEvidence` |
|
|
344
|
+
| `core/derive.js` | `styleVector` `sampleStyle` `wakeReply` `flowLevel` `flowName` `whimProbability` `applyPatience` `isOutburst` `hashTraits` `mulberry32` |
|
|
345
|
+
| `core/body.js` | `createBody` `canDo` `hasCapability` `bodyScores` `chooseBody` `bodyLine` `recordAction` + `BODY_KINDS` `CAPABILITY` |
|
|
346
|
+
| `core/attribution.js` | `attribute` `intercept` `ecg` + `LABELS` `BLOCK` `HEALTHY_DISTRIBUTION` |
|
|
347
|
+
| `core/relation.js` | `createContract` `attentionBoost` `beginColdWar` `sever` `canSever` |
|
|
348
|
+
| `core/event.js` | `normalizeEvent` `keywords` `toCue` `toObservation` `shouldObserve` |
|
|
349
|
+
| `core/invariants.js` | `check` `derivationSpread` `syntheticTraits` + `INVARIANT_IDS` |
|
|
350
|
+
| `store.js` | `loadBrain` `saveBrain` `readAudit` `appendAudit` `setDataDir` `setRoleDir` `brainsDir` |
|
|
351
|
+
|
|
352
|
+
---
|
|
353
|
+
|
|
354
|
+
## 六、数据落在哪
|
|
355
|
+
|
|
356
|
+
```
|
|
357
|
+
<dataDir>/brains/<id>/
|
|
358
|
+
├── brain.json 人设命题 + 记忆 + 状态 + 自我认知 + 身体
|
|
359
|
+
└── audit.jsonl 出生 / 蜕皮 / 换身体 / 归因 / 导入
|
|
360
|
+
```
|
|
361
|
+
|
|
362
|
+
`brain.json` 顶层字段:
|
|
363
|
+
|
|
364
|
+
```jsonc
|
|
365
|
+
{
|
|
366
|
+
"id": "default", "schema": "brain/2", "born": 0, "roleCard": "辞辞",
|
|
367
|
+
"persona": { "seed": "...", "traits": {}, "units": [], "brief": "" },
|
|
368
|
+
"relation": { "type": "parent", "address": "老爹", "ctr": {} },
|
|
369
|
+
"self": { "style": {}, "divergence": 0, "narrative": "", "styleName": "" },
|
|
370
|
+
"state": { "energy": 0.8, "fatigue": 0.2, "sleep": "awake", "flow": 1 },
|
|
371
|
+
"affect": { "p": 0, "a": 0, "d": 0, "mood": "平静" },
|
|
372
|
+
"drive": { "curiosity": 0.9, "boredom": 0.5, "social": 0.6 },
|
|
373
|
+
"memory": { "facts": {}, "taste": {}, "impressions": {}, "episodes": [],
|
|
374
|
+
"imagination": [], "formerSelves": [], "forgotten": [],
|
|
375
|
+
"pending": [], "strategies": {} },
|
|
376
|
+
"body": { "kind": "phone", "apps": [], "scope": [1,2,3] },
|
|
377
|
+
"patience": 1,
|
|
378
|
+
"meta": { "observations": 0, "lastSettle": 0 }
|
|
379
|
+
}
|
|
380
|
+
```
|
|
381
|
+
|
|
382
|
+
**一条鱼一个目录,拷走就是搬家。**
|
|
383
|
+
|
|
384
|
+
---
|
|
385
|
+
|
|
386
|
+
## 七、命令行
|
|
387
|
+
|
|
388
|
+
```bash
|
|
389
|
+
npx feiyu status # 她什么状态
|
|
390
|
+
npx feiyu brief # 此刻的她
|
|
391
|
+
npx feiyu observe 扶摇 "你嘴真硬"
|
|
392
|
+
npx feiyu settle # 每日结算
|
|
393
|
+
npx feiyu audit 20 # 最近 20 条审计
|
|
394
|
+
npx feiyu spread # 派生检验(100 条鱼同一情境,看散度)
|
|
395
|
+
npx feiyu body # 看身体
|
|
396
|
+
npx feiyu body desktop # 换身体
|
|
397
|
+
npx feiyu rebirth parent 老爹
|
|
398
|
+
```
|
|
399
|
+
|
|
400
|
+
---
|
|
401
|
+
|
|
402
|
+
## 八、三种适配器
|
|
403
|
+
|
|
404
|
+
平台无关的关键:内核只认 `{sender, text, chatId}`。
|
|
405
|
+
|
|
406
|
+
| 适配器 | 给谁 | 入口 |
|
|
407
|
+
|---|---|---|
|
|
408
|
+
| `qq-bridge` | 老用户,接自己现有的桥接 | `createBridgeAdapter({id, log, truncateText})` |
|
|
409
|
+
| `tencent-official` | 新用户,腾讯官方开放平台 | `new TencentOfficialAdapter({appId, clientSecret, intents})` |
|
|
410
|
+
| `universal` | 任意平台 | `createUniversalHost({brain, buildSystemPrompt})` |
|
|
411
|
+
|
|
412
|
+
`qq-bridge` 保证三件事:**永不断链**(内部全 try/catch,失败返回空串)、**不重复记账**(同 seq 只算一次)、**定长**(不随对话增长)。
|
|
413
|
+
|
|
414
|
+
---
|
|
415
|
+
|
|
416
|
+
## 九、红线与不变量
|
|
417
|
+
|
|
418
|
+
`check(brain, ctx)` 可运行时验证的部分:
|
|
419
|
+
|
|
420
|
+
| # | 不变量 |
|
|
421
|
+
|---|---|
|
|
422
|
+
| I1 | 人设唯一(任何时刻只有一份 units) |
|
|
423
|
+
| I2 | 身份恒等(`identity` 权重恒为 1) |
|
|
424
|
+
| I3 | 关系恒等(三个字段不可漂移) |
|
|
425
|
+
| I6 | 幻想隔离(`imagination ∩ episodes = ∅`,且 `isReal === false`) |
|
|
426
|
+
| I7 | 拦截唯一(只有 C1 / SAFETY) |
|
|
427
|
+
| I8 | 归因唯一 |
|
|
428
|
+
| Σ1 / Σ4 | 权重范围 / 风格向量归一 |
|
|
429
|
+
|
|
430
|
+
---
|
|
431
|
+
|
|
432
|
+
## 十、已知边界(诚实清单)
|
|
433
|
+
|
|
434
|
+
| 没做的 | 现在是什么状态 |
|
|
435
|
+
|---|---|
|
|
436
|
+
| **记忆卡片自动触发** | `makeCard()` 有了,但"上下文超 6000 字自动压"要宿主在拼 prompt 时调 `needsCard()` |
|
|
437
|
+
| **时间压缩** | 一年的淡忘没法验证,只能真实等待 |
|
|
438
|
+
| **多设备并发** | 一次只有一具身体在动,换身体会换驱动 |
|
|
439
|
+
| **腾讯官方适配器** | 未线上联调(没有 appId/secret),字段以官方文档为准 |
|
|
440
|
+
|
|
441
|
+
### 1.3.0 补上的(之前缺的)
|
|
442
|
+
|
|
443
|
+
| 补了什么 | 怎么做的 |
|
|
444
|
+
|---|---|
|
|
445
|
+
| **情绪词表** | `brain.vocab`,出生为空,靠 `learnEmotion` 学 |
|
|
446
|
+
| **三段式** | 词 <10 个只会说"不知道";≥10 个能命名;有 ≥3 实例能自己归纳定义 |
|
|
447
|
+
| **记忆卡片** | `makeCard()` 把一段经历压成 ≤160 字,进 `memory.cards`,卡片也吃 30 天 TTL |
|
|
448
|
+
| **身体驱动** | `AdbDriver` / `DesktopDriver` / `DryDriver`,真的开 App、真的截屏 |
|
|
449
|
+
| **特质提取** | 词表从 10 组扩到 12 组;支持卡内 `性格:嘴硬=0.9` 手写覆盖;支持 `roles/<名字>.traits.json` 旁挂 |
|
|
450
|
+
|
|
451
|
+
---
|
|
452
|
+
|
|
453
|
+
## 十一、安装
|
|
454
|
+
|
|
455
|
+
```bash
|
|
456
|
+
# 库
|
|
457
|
+
npm i feiyu-brain
|
|
458
|
+
|
|
459
|
+
# DSH 插件
|
|
460
|
+
dsh plugin --profile desktop add feiyu-brain
|
|
461
|
+
# 装完完全退出再启动桌面端(宿主半需要冷启动)
|
|
462
|
+
```
|
|
463
|
+
|
|
464
|
+
```js
|
|
465
|
+
import { createBrain } from 'feiyu-brain';
|
|
466
|
+
|
|
467
|
+
const fy = createBrain({
|
|
468
|
+
id: 'default',
|
|
469
|
+
dataDir: './data',
|
|
470
|
+
roleDir: './roles',
|
|
471
|
+
relation: 'parent',
|
|
472
|
+
address: '老爹',
|
|
473
|
+
});
|
|
474
|
+
|
|
475
|
+
const { text } = fy.wake({ sender: '扶摇', text: '你嘴真硬啊', chatId: 'group:1' });
|
|
476
|
+
console.log(text);
|
|
477
|
+
```
|
|
478
|
+
|
|
479
|
+
---
|
|
480
|
+
|
|
481
|
+
**一句话:它不负责说话,它负责"说话的这个人是谁"。**
|