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.
- package/README.md +159 -4
- package/adapters/qq-bridge.js +169 -26
- package/cli.mjs +246 -3
- package/cordis.patch.yml +20 -2
- package/core/body.js +13 -1
- package/core/diary.js +119 -0
- package/core/extract.js +49 -10
- package/core/migrate.js +170 -0
- package/docs/ADAPTER-CONTRACT.md +101 -0
- package/docs/CHANGELOG-1.5.md +136 -0
- package/docs/MEMORY.md +289 -0
- package/docs/TROUBLESHOOT.md +136 -0
- package/index.js +752 -44
- 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/store.js +31 -3
|
@@ -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
|
+
两条都正常,才算真的装好了。
|