feiyu-brain 0.0.0-stage → 1.1.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/LICENSE +21 -0
- package/README.md +152 -2
- package/adapters/index.js +18 -0
- package/adapters/qq-bridge.js +88 -0
- package/adapters/tencent-official.js +247 -0
- package/adapters/universal.js +39 -0
- package/cli.mjs +135 -0
- package/core/attribution.js +81 -0
- package/core/body.js +183 -0
- package/core/derive.js +176 -0
- package/core/event.js +70 -0
- package/core/extract.js +167 -0
- package/core/invariants.js +110 -0
- package/core/memory.js +170 -0
- package/core/persona.js +184 -0
- package/core/relation.js +71 -0
- package/demo.mjs +185 -0
- package/docs/BODY.md +138 -0
- package/docs/COMPLIANCE.md +99 -0
- package/docs/HOW-TO-PUBLISH.md +201 -0
- package/docs/MIGRATION.md +123 -0
- package/docs/PLATFORM.md +135 -0
- package/docs/PUBLISH.md +140 -0
- package/examples/bridge-integration.mjs +35 -0
- package/examples/tencent-bot.mjs +65 -0
- package/index.js +413 -0
- package/market/fangqiuci_feiyu-brain.yml +94 -0
- package/package.json +58 -4
- package/selftest.mjs +309 -0
- package/store.js +111 -0
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 feiyu-brain contributors
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.md
CHANGED
|
@@ -1,3 +1,153 @@
|
|
|
1
|
-
#
|
|
1
|
+
# feiyu-brain · 大肥鱼的大脑
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
> **人设是根,其余都是长出来的。**
|
|
4
|
+
|
|
5
|
+
一个**平台无关**的认知内核。给它一张人设卡,它长出一条有记忆、有情绪、会发呆、会嘴硬的鱼。
|
|
6
|
+
|
|
7
|
+
它**不会说话**——说话是"身体"的事。它只做两件事:
|
|
8
|
+
|
|
9
|
+
- 唤醒时,产出该拼进 prompt 的那一段(`【此刻的她】…`)
|
|
10
|
+
- 经历时,让她的权重、记忆、情绪动一动
|
|
11
|
+
|
|
12
|
+
**换一个身体(QQ 桥接 / 腾讯官方 / 你自己的平台),大脑一行不动。**
|
|
13
|
+
|
|
14
|
+
---
|
|
15
|
+
|
|
16
|
+
## 安装
|
|
17
|
+
|
|
18
|
+
```bash
|
|
19
|
+
npm i feiyu-brain
|
|
20
|
+
```
|
|
21
|
+
|
|
22
|
+
或者直接把仓库里的 `plugins/feiyu-brain/` 拷走。
|
|
23
|
+
|
|
24
|
+
Node ≥ 20。零依赖。
|
|
25
|
+
|
|
26
|
+
---
|
|
27
|
+
|
|
28
|
+
## 两种接法
|
|
29
|
+
|
|
30
|
+
| 你是谁 | 用哪个 | 说明 |
|
|
31
|
+
|---|---|---|
|
|
32
|
+
| **老用户**,还在跑自己的桥接 | `adapters/qq-bridge` | 桥接不用改,插一段进 prompt 就行 |
|
|
33
|
+
| **新用户**,走腾讯官方 | `adapters/tencent-official` | 官方开放平台,HTTP + WebSocket |
|
|
34
|
+
| 其他平台 | `adapters/universal` | 你能把消息变成 `{sender,text,chatId}` 就行 |
|
|
35
|
+
|
|
36
|
+
⚠️ 本包**不含任何平台协议实现**,也**不内置任何桥接**。它只是脑子。
|
|
37
|
+
详见 [docs/COMPLIANCE.md](docs/COMPLIANCE.md)。
|
|
38
|
+
|
|
39
|
+
---
|
|
40
|
+
|
|
41
|
+
## 30 秒上手
|
|
42
|
+
|
|
43
|
+
```js
|
|
44
|
+
import { createBrain } from 'feiyu-brain';
|
|
45
|
+
|
|
46
|
+
const fy = createBrain({
|
|
47
|
+
id: 'default',
|
|
48
|
+
dataDir: './data', // 她的档案放哪
|
|
49
|
+
roleDir: './roles', // 人设卡目录(roles/辞辞.md)
|
|
50
|
+
relation: 'parent',
|
|
51
|
+
address: '老爹',
|
|
52
|
+
});
|
|
53
|
+
|
|
54
|
+
// 她看到一条消息 → 拿到该注入 prompt 的那段
|
|
55
|
+
const { text } = fy.wake({
|
|
56
|
+
sender: '扶摇',
|
|
57
|
+
text: '你嘴真硬啊',
|
|
58
|
+
chatId: 'group:123',
|
|
59
|
+
});
|
|
60
|
+
|
|
61
|
+
console.log(text);
|
|
62
|
+
// 【此刻的她】你是 DeepSeek 的鲸鱼形象,网友口中的「小鲸鱼」…
|
|
63
|
+
// 【想到的】
|
|
64
|
+
// 扶摇:嘴毒但人不坏(互动 3 次)
|
|
65
|
+
|
|
66
|
+
// 每天跑一次:衰减、遗忘、蜕皮
|
|
67
|
+
fy.tick();
|
|
68
|
+
```
|
|
69
|
+
|
|
70
|
+
`text` 拼进你模型 system prompt 的任何位置都行。**建议放在靠前**——先知道"我是谁",再谈"现在几点"。
|
|
71
|
+
|
|
72
|
+
---
|
|
73
|
+
|
|
74
|
+
## 大脑里有什么
|
|
75
|
+
|
|
76
|
+
| 器官 | 它做什么 |
|
|
77
|
+
|---|---|
|
|
78
|
+
| **人设** | 从卡里抽成 77 条带权重的命题;行为一致 +0.01,冲突 −0.01,掉到 0.15 就蜕皮成"我以前……" |
|
|
79
|
+
| **记忆** | 30 天窗口;提起续命;连续被提 15 天升级长期;忘了就是真的没有 |
|
|
80
|
+
| **情绪** | PAD 三轴(愉悦/唤醒/掌控);不会命名 → 会命名 → 自己总结 |
|
|
81
|
+
| **意识流** | 休眠 / 发呆 / 正常 / 走神 / 幻想,一条轴五档 |
|
|
82
|
+
| **自知** | 四种方向的份量(aware/denial/fixed/naive),从人设算出来,不是选格子 |
|
|
83
|
+
| **归因** | 不审批,只贴标签:有据 / 即兴 / 硬撑 / 明知故犯 / 说不清 |
|
|
84
|
+
| **关系** | 只管"谁进意识",不管"怎么回" |
|
|
85
|
+
| **身体** | 手机 / 平板 / 电脑,三具可插拔;L1~L4 权限;没证据的操作不算发生 |
|
|
86
|
+
|
|
87
|
+
---
|
|
88
|
+
|
|
89
|
+
## 唯一的验收标准
|
|
90
|
+
|
|
91
|
+
> **同一件事,换一条人设,她的反应会不会变?**
|
|
92
|
+
|
|
93
|
+
```
|
|
94
|
+
100 条不同人设,同一情境(被吵醒):
|
|
95
|
+
反应种类 70 / 100
|
|
96
|
+
自知配方 100 / 100
|
|
97
|
+
```
|
|
98
|
+
|
|
99
|
+
不变 = 硬编码 = 那不是鱼,是壳。
|
|
100
|
+
|
|
101
|
+
```bash
|
|
102
|
+
npx feiyu spread
|
|
103
|
+
```
|
|
104
|
+
|
|
105
|
+
---
|
|
106
|
+
|
|
107
|
+
## 数据
|
|
108
|
+
|
|
109
|
+
```
|
|
110
|
+
<dataDir>/brains/<id>/
|
|
111
|
+
├── brain.json 人设命题 + 记忆 + 状态 + 自我认知
|
|
112
|
+
└── audit.jsonl 出生 / 蜕皮 / 归因 / 导入导出
|
|
113
|
+
```
|
|
114
|
+
|
|
115
|
+
一条鱼一个目录。**你可以把整个目录拷走,她就是她。**
|
|
116
|
+
|
|
117
|
+
---
|
|
118
|
+
|
|
119
|
+
## CLI
|
|
120
|
+
|
|
121
|
+
```bash
|
|
122
|
+
npx feiyu status # 她什么状态
|
|
123
|
+
npx feiyu brief # 此刻的她(唤醒注入的那段)
|
|
124
|
+
npx feiyu observe 扶摇 "你嘴真硬"
|
|
125
|
+
npx feiyu settle # 每日结算
|
|
126
|
+
npx feiyu spread # 派生检验
|
|
127
|
+
npx feiyu audit 20
|
|
128
|
+
npx feiyu rebirth parent 老爹
|
|
129
|
+
```
|
|
130
|
+
|
|
131
|
+
---
|
|
132
|
+
|
|
133
|
+
## 文档
|
|
134
|
+
|
|
135
|
+
- [docs/MIGRATION.md](docs/MIGRATION.md) —— 老用户:桥接怎么接
|
|
136
|
+
- [docs/PLATFORM.md](docs/PLATFORM.md) —— 新用户:腾讯官方怎么接
|
|
137
|
+
- [docs/BODY.md](docs/BODY.md) —— 手机 / 平板 / 电脑:权限与证据
|
|
138
|
+
- [docs/COMPLIANCE.md](docs/COMPLIANCE.md) —— 边界与合规
|
|
139
|
+
- [docs/PUBLISH.md](docs/PUBLISH.md) —— 发布清单
|
|
140
|
+
|
|
141
|
+
---
|
|
142
|
+
|
|
143
|
+
## 已知边界
|
|
144
|
+
|
|
145
|
+
- **特质提取的精度取决于人设卡。** 一张"怎么说话"的卡抽出来偏窄(嘴硬 1.00、好奇 0.15)。要更准,给她一张"她是什么人"的卡。
|
|
146
|
+
- **腾讯官方适配器未线上联调**(没有 appId/secret)。字段以官方文档为准,先 sandbox 单群验证。
|
|
147
|
+
- **身体层只有抽象,没有驱动。** 手机/平板/电脑的"能做什么、该用哪具、权限够不够"已经写好了;真去开 App 要宿主自己接 ADB / 桌面自动化。
|
|
148
|
+
|
|
149
|
+
---
|
|
150
|
+
|
|
151
|
+
## 许可证
|
|
152
|
+
|
|
153
|
+
MIT。
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
// 适配器总入口
|
|
2
|
+
//
|
|
3
|
+
// 一个大脑,两种接法:
|
|
4
|
+
// 老用户 → qq-bridge (继续用你现在的桥接)
|
|
5
|
+
// 新用户 → tencent-official (腾讯官方机器人开放平台)
|
|
6
|
+
// 其他 → universal (自带传输)
|
|
7
|
+
//
|
|
8
|
+
// 大脑本身不含任何平台代码——它只产出文本、只记录经历。
|
|
9
|
+
|
|
10
|
+
export { createBridgeAdapter } from './qq-bridge.js';
|
|
11
|
+
export { TencentOfficialAdapter, INTENTS } from './tencent-official.js';
|
|
12
|
+
export { createUniversalHost, normalizeEvent } from './universal.js';
|
|
13
|
+
|
|
14
|
+
export const ADAPTERS = {
|
|
15
|
+
'qq-bridge': '老用户:SnowLuma / OneBot 桥接(宿主提供传输)',
|
|
16
|
+
'tencent-official': '新用户:腾讯官方机器人开放平台(HTTP + WebSocket)',
|
|
17
|
+
universal: '任意平台:自带传输,把消息变成 { sender, text, chatId } 即可',
|
|
18
|
+
};
|
|
@@ -0,0 +1,88 @@
|
|
|
1
|
+
// 适配器一:老用户 · QQ 桥接(SnowLuma/OneBot 那套)
|
|
2
|
+
//
|
|
3
|
+
// 这个文件只做一件事:把桥接内部的状态对象 map 成大脑认识的形状。
|
|
4
|
+
// 它不含任何 QQ 协议实现——协议在宿主(桥接)里,本包只提供大脑。
|
|
5
|
+
//
|
|
6
|
+
// 用法(宿主侧):
|
|
7
|
+
// import * as brain from 'feiyu-brain'
|
|
8
|
+
// const ad = brain.createBridgeAdapter({ log, truncateText })
|
|
9
|
+
// ...
|
|
10
|
+
// const line = ad.buildBrainLine(key, st) // 插进唤醒 prompt
|
|
11
|
+
// ad.observeOnce(key, st) // 她"看到"了最新那条
|
|
12
|
+
|
|
13
|
+
import { normalizeEvent } from '../core/event.js';
|
|
14
|
+
|
|
15
|
+
/**
|
|
16
|
+
* @param {object} opts
|
|
17
|
+
* @param {(msg:string)=>void} [opts.log]
|
|
18
|
+
* @param {(s:string,n:number)=>string} [opts.truncateText]
|
|
19
|
+
* @param {string} [opts.id] 鱼 id
|
|
20
|
+
*/
|
|
21
|
+
export function createBridgeAdapter({ log = () => {}, truncateText = (s, n) => String(s ?? '').slice(0, n), id = 'default' } = {}) {
|
|
22
|
+
const observedSeq = new Map(); // key -> 已"经历"到的 seq
|
|
23
|
+
|
|
24
|
+
function newestIncoming(st) {
|
|
25
|
+
if (!st) return null;
|
|
26
|
+
return [...(Array.isArray(st.unread) ? st.unread : [])].reverse().find((m) => m && !m.isSelf)
|
|
27
|
+
|| [...(Array.isArray(st.recentMessages) ? st.recentMessages : [])].reverse().find((m) => m && !m.isSelf)
|
|
28
|
+
|| null;
|
|
29
|
+
}
|
|
30
|
+
|
|
31
|
+
/** 桥接消息 → 通用事件 */
|
|
32
|
+
function toEvent(msg) {
|
|
33
|
+
if (!msg) return null;
|
|
34
|
+
return normalizeEvent({
|
|
35
|
+
kind: 'message',
|
|
36
|
+
platform: 'qq-bridge',
|
|
37
|
+
chatId: msg.chatId ?? msg.groupId ?? 'unknown',
|
|
38
|
+
chatKind: msg.chatKind ?? 'group',
|
|
39
|
+
sender: msg.sender ?? msg.nickname ?? '',
|
|
40
|
+
senderId: msg.user_id ?? msg.userId ?? msg.senderId ?? '',
|
|
41
|
+
text: String(msg.tail || msg.plain || msg.text || ''),
|
|
42
|
+
at: Number(msg.time) || Date.now(),
|
|
43
|
+
isSelf: msg.isSelf === true,
|
|
44
|
+
seq: msg.seq,
|
|
45
|
+
}, 'qq-bridge');
|
|
46
|
+
}
|
|
47
|
+
|
|
48
|
+
/** 一条只算一次:同一个 seq 不重复"经历"。 */
|
|
49
|
+
function observeOnce(key, st, brainApi) {
|
|
50
|
+
const newest = newestIncoming(st);
|
|
51
|
+
if (!newest) return null;
|
|
52
|
+
const seq = Number(newest.seq);
|
|
53
|
+
if (!Number.isFinite(seq)) return null;
|
|
54
|
+
if (seq <= (observedSeq.get(key) ?? 0)) return null;
|
|
55
|
+
observedSeq.set(key, seq);
|
|
56
|
+
const ev = toEvent(newest);
|
|
57
|
+
if (!ev?.text) return null;
|
|
58
|
+
try {
|
|
59
|
+
return brainApi.observe(id, ev);
|
|
60
|
+
} catch (error) {
|
|
61
|
+
log(`[brain] observe 失败(已忽略):${error?.message ?? error}`);
|
|
62
|
+
return null;
|
|
63
|
+
}
|
|
64
|
+
}
|
|
65
|
+
|
|
66
|
+
return {
|
|
67
|
+
id,
|
|
68
|
+
toEvent,
|
|
69
|
+
newestIncoming,
|
|
70
|
+
observeOnce,
|
|
71
|
+
|
|
72
|
+
/**
|
|
73
|
+
* 生成唤醒 prompt 里的那一段。
|
|
74
|
+
* 永远不抛:失败就返回空串——没有内心也要能说话。
|
|
75
|
+
*/
|
|
76
|
+
buildBrainLine(key, st, brainApi) {
|
|
77
|
+
try {
|
|
78
|
+
observeOnce(key, st, brainApi);
|
|
79
|
+
const ev = toEvent(newestIncoming(st));
|
|
80
|
+
const text = brainApi.wakeLine(id, ev ?? null);
|
|
81
|
+
return text ? `${text}\n\n` : '';
|
|
82
|
+
} catch (error) {
|
|
83
|
+
log(`[brain] 唤醒段生成失败(已忽略):${error?.message ?? error}`);
|
|
84
|
+
return '';
|
|
85
|
+
}
|
|
86
|
+
},
|
|
87
|
+
};
|
|
88
|
+
}
|
|
@@ -0,0 +1,247 @@
|
|
|
1
|
+
// 适配器二:新用户 · 腾讯官方机器人开放平台
|
|
2
|
+
//
|
|
3
|
+
// 只依赖官方公开的 HTTP/WS 接口,不含任何逆向或私有协议。
|
|
4
|
+
// ⚠️ 本文件未经线上联调(没有 appId/appSecret),字段以官方文档为准;
|
|
5
|
+
// 第一次接入请先用 sandbox + 单群验证,再放量。
|
|
6
|
+
//
|
|
7
|
+
// 用法:
|
|
8
|
+
// import { TencentOfficialAdapter } from 'feiyu-brain/adapters/tencent-official'
|
|
9
|
+
// const bot = new TencentOfficialAdapter({ appId, clientSecret, intents })
|
|
10
|
+
// bot.onMessage(async (ev) => {
|
|
11
|
+
// const { text } = brain.wake(ev)
|
|
12
|
+
// const reply = await callYourLLM(text) // 你的模型
|
|
13
|
+
// await bot.reply(ev, reply)
|
|
14
|
+
// })
|
|
15
|
+
// await bot.start()
|
|
16
|
+
|
|
17
|
+
import { normalizeEvent } from '../core/event.js';
|
|
18
|
+
|
|
19
|
+
const API_BASE = 'https://api.sgroup.qq.com';
|
|
20
|
+
const TOKEN_URL = 'https://bots.qq.com/app/getAppAccessToken';
|
|
21
|
+
const WS_URL = 'wss://api.sgroup.qq.com/websocket';
|
|
22
|
+
|
|
23
|
+
/** 官方 intents 位 */
|
|
24
|
+
export const INTENTS = {
|
|
25
|
+
GUILDS: 1 << 0,
|
|
26
|
+
GUILD_MEMBERS: 1 << 1,
|
|
27
|
+
PUBLIC_MESSAGES: 1 << 25,
|
|
28
|
+
DIRECT_MESSAGE: 1 << 12,
|
|
29
|
+
GROUP_AND_C2C: 1 << 25, // 群/C2C 消息事件
|
|
30
|
+
};
|
|
31
|
+
|
|
32
|
+
export class TencentOfficialAdapter {
|
|
33
|
+
/**
|
|
34
|
+
* @param {object} opts
|
|
35
|
+
* @param {string} opts.appId
|
|
36
|
+
* @param {string} opts.clientSecret
|
|
37
|
+
* @param {number} [opts.intents]
|
|
38
|
+
* @param {(m:string)=>void} [opts.log]
|
|
39
|
+
*/
|
|
40
|
+
constructor({ appId, clientSecret, intents = INTENTS.GROUP_AND_C2C, log = () => {} } = {}) {
|
|
41
|
+
if (!appId || !clientSecret) throw new Error('缺少 appId / clientSecret');
|
|
42
|
+
this.appId = appId;
|
|
43
|
+
this.clientSecret = clientSecret;
|
|
44
|
+
this.intents = intents;
|
|
45
|
+
this.log = log;
|
|
46
|
+
|
|
47
|
+
this.token = null;
|
|
48
|
+
this.tokenExpiresAt = 0;
|
|
49
|
+
this.ws = null;
|
|
50
|
+
this.seq = null;
|
|
51
|
+
this.sessionId = null;
|
|
52
|
+
this.heartbeatTimer = null;
|
|
53
|
+
this.handlers = { message: [] };
|
|
54
|
+
this.stopped = false;
|
|
55
|
+
}
|
|
56
|
+
|
|
57
|
+
onMessage(fn) {
|
|
58
|
+
this.handlers.message.push(fn);
|
|
59
|
+
return this;
|
|
60
|
+
}
|
|
61
|
+
|
|
62
|
+
// ── 鉴权 ────────────────────────────────────────────────────────────
|
|
63
|
+
async getToken() {
|
|
64
|
+
if (this.token && Date.now() < this.tokenExpiresAt - 60_000) return this.token;
|
|
65
|
+
const res = await fetch(TOKEN_URL, {
|
|
66
|
+
method: 'POST',
|
|
67
|
+
headers: { 'Content-Type': 'application/json' },
|
|
68
|
+
body: JSON.stringify({ appId: this.appId, clientSecret: this.clientSecret }),
|
|
69
|
+
});
|
|
70
|
+
if (!res.ok) throw new Error(`取 token 失败:HTTP ${res.status}`);
|
|
71
|
+
const data = await res.json();
|
|
72
|
+
if (!data.access_token) throw new Error(`取 token 失败:${JSON.stringify(data)}`);
|
|
73
|
+
this.token = data.access_token;
|
|
74
|
+
this.tokenExpiresAt = Date.now() + (Number(data.expires_in) || 7200) * 1000;
|
|
75
|
+
return this.token;
|
|
76
|
+
}
|
|
77
|
+
|
|
78
|
+
async request(method, path, body) {
|
|
79
|
+
const token = await this.getToken();
|
|
80
|
+
const res = await fetch(`${API_BASE}${path}`, {
|
|
81
|
+
method,
|
|
82
|
+
headers: {
|
|
83
|
+
Authorization: `QQBot ${token}`,
|
|
84
|
+
'Content-Type': 'application/json',
|
|
85
|
+
'X-Union-Appid': this.appId,
|
|
86
|
+
},
|
|
87
|
+
body: body ? JSON.stringify(body) : undefined,
|
|
88
|
+
});
|
|
89
|
+
const text = await res.text();
|
|
90
|
+
let data = null;
|
|
91
|
+
try { data = text ? JSON.parse(text) : null; } catch { data = { raw: text }; }
|
|
92
|
+
if (!res.ok) throw new Error(`API ${method} ${path} → ${res.status} ${text.slice(0, 200)}`);
|
|
93
|
+
return data;
|
|
94
|
+
}
|
|
95
|
+
|
|
96
|
+
// ── 发消息(被动回复要带 msg_id)────────────────────────────────────
|
|
97
|
+
sendGroupMessage(groupOpenid, content, msgId, msgSeq = 1) {
|
|
98
|
+
return this.request('POST', `/v2/groups/${encodeURIComponent(groupOpenid)}/messages`, {
|
|
99
|
+
content: String(content).slice(0, 2000),
|
|
100
|
+
msg_type: 0,
|
|
101
|
+
...(msgId ? { msg_id: msgId, msg_seq: msgSeq } : {}),
|
|
102
|
+
});
|
|
103
|
+
}
|
|
104
|
+
|
|
105
|
+
sendC2CMessage(openid, content, msgId, msgSeq = 1) {
|
|
106
|
+
return this.request('POST', `/v2/users/${encodeURIComponent(openid)}/messages`, {
|
|
107
|
+
content: String(content).slice(0, 2000),
|
|
108
|
+
msg_type: 0,
|
|
109
|
+
...(msgId ? { msg_id: msgId, msg_seq: msgSeq } : {}),
|
|
110
|
+
});
|
|
111
|
+
}
|
|
112
|
+
|
|
113
|
+
/** 用大脑事件直接回复 */
|
|
114
|
+
async reply(event, content, msgSeq = 1) {
|
|
115
|
+
if (event.chatKind === 'group') {
|
|
116
|
+
return this.sendGroupMessage(event.chatId.replace(/^group:/, ''), content, event.sourceMsgId, msgSeq);
|
|
117
|
+
}
|
|
118
|
+
return this.sendC2CMessage(event.chatId.replace(/^private:/, ''), content, event.sourceMsgId, msgSeq);
|
|
119
|
+
}
|
|
120
|
+
|
|
121
|
+
// ── 事件映射 ────────────────────────────────────────────────────────
|
|
122
|
+
/**
|
|
123
|
+
* 官方事件 → 通用事件。
|
|
124
|
+
* 支持:C2C_MESSAGE_CREATE / GROUP_AT_MESSAGE_CREATE
|
|
125
|
+
*/
|
|
126
|
+
toBrainEvent(type, d = {}) {
|
|
127
|
+
const author = d.author ?? {};
|
|
128
|
+
if (type === 'C2C_MESSAGE_CREATE') {
|
|
129
|
+
return normalizeEvent({
|
|
130
|
+
kind: 'message',
|
|
131
|
+
platform: 'tencent-official',
|
|
132
|
+
chatId: `private:${author.user_openid ?? author.id ?? ''}`,
|
|
133
|
+
chatKind: 'private',
|
|
134
|
+
sender: author.username ?? author.id ?? '',
|
|
135
|
+
senderId: author.user_openid ?? author.id ?? '',
|
|
136
|
+
text: d.content ?? '',
|
|
137
|
+
at: Number(d.timestamp) || Date.now(),
|
|
138
|
+
isSelf: false,
|
|
139
|
+
seq: undefined,
|
|
140
|
+
}, 'tencent-official');
|
|
141
|
+
}
|
|
142
|
+
if (type === 'GROUP_AT_MESSAGE_CREATE') {
|
|
143
|
+
return normalizeEvent({
|
|
144
|
+
kind: 'message',
|
|
145
|
+
platform: 'tencent-official',
|
|
146
|
+
chatId: `group:${d.group_openid ?? ''}`,
|
|
147
|
+
chatKind: 'group',
|
|
148
|
+
sender: author.member_openid ?? author.id ?? '',
|
|
149
|
+
senderId: author.member_openid ?? author.id ?? '',
|
|
150
|
+
text: d.content ?? '',
|
|
151
|
+
at: Number(d.timestamp) || Date.now(),
|
|
152
|
+
isSelf: false,
|
|
153
|
+
isAtMe: true, // 群里的 @ 消息才算事件
|
|
154
|
+
}, 'tencent-official');
|
|
155
|
+
}
|
|
156
|
+
return null;
|
|
157
|
+
}
|
|
158
|
+
|
|
159
|
+
// ── 连接 ────────────────────────────────────────────────────────────
|
|
160
|
+
async start() {
|
|
161
|
+
this.stopped = false;
|
|
162
|
+
await this.connect();
|
|
163
|
+
return this;
|
|
164
|
+
}
|
|
165
|
+
|
|
166
|
+
async connect() {
|
|
167
|
+
const gateway = await this.request('GET', '/gateway').catch(() => null);
|
|
168
|
+
const url = gateway?.url || WS_URL;
|
|
169
|
+
const token = await this.getToken();
|
|
170
|
+
|
|
171
|
+
const ws = new WebSocket(url);
|
|
172
|
+
this.ws = ws;
|
|
173
|
+
|
|
174
|
+
ws.addEventListener('open', () => {
|
|
175
|
+
this.log('[tencent] ws 已连接,发送 identify');
|
|
176
|
+
});
|
|
177
|
+
|
|
178
|
+
ws.addEventListener('message', (frame) => this.onFrame(String(frame.data)));
|
|
179
|
+
ws.addEventListener('close', () => {
|
|
180
|
+
this.stopHeartbeat();
|
|
181
|
+
if (!this.stopped) {
|
|
182
|
+
this.log('[tencent] ws 断开,5 秒后重连');
|
|
183
|
+
setTimeout(() => this.connect().catch((e) => this.log(`[tencent] 重连失败:${e.message}`)), 5000);
|
|
184
|
+
}
|
|
185
|
+
});
|
|
186
|
+
ws.addEventListener('error', () => this.log('[tencent] ws 错误'));
|
|
187
|
+
|
|
188
|
+
// identify 在 Hello(10) 之后发,见 onFrame
|
|
189
|
+
this.identifyToken = token;
|
|
190
|
+
}
|
|
191
|
+
|
|
192
|
+
onFrame(raw) {
|
|
193
|
+
let payload;
|
|
194
|
+
try { payload = JSON.parse(raw); } catch { return; }
|
|
195
|
+
const { op, d, s, t } = payload;
|
|
196
|
+
if (Number.isFinite(s)) this.seq = s;
|
|
197
|
+
|
|
198
|
+
switch (op) {
|
|
199
|
+
case 10: { // Hello
|
|
200
|
+
const interval = Number(d?.heartbeat_interval) || 30000;
|
|
201
|
+
this.startHeartbeat(interval);
|
|
202
|
+
this.send({ op: 2, d: { token: `QQBot ${this.identifyToken}`, intents: this.intents, shard: [0, 1], properties: {} } });
|
|
203
|
+
break;
|
|
204
|
+
}
|
|
205
|
+
case 0: { // Dispatch
|
|
206
|
+
if (t === 'READY') this.sessionId = d?.session_id ?? null;
|
|
207
|
+
this.dispatch(t, d);
|
|
208
|
+
break;
|
|
209
|
+
}
|
|
210
|
+
case 11: break; // Heartbeat ACK
|
|
211
|
+
case 7: this.log('[tencent] 收到重连指令'); this.ws?.close(); break;
|
|
212
|
+
case 9: this.log('[tencent] identify 被拒,检查 intents'); break;
|
|
213
|
+
default: break;
|
|
214
|
+
}
|
|
215
|
+
}
|
|
216
|
+
|
|
217
|
+
dispatch(type, d) {
|
|
218
|
+
const ev = this.toBrainEvent(type, d);
|
|
219
|
+
if (!ev) return;
|
|
220
|
+
ev.sourceMsgId = d?.id; // 被动回复要带这个
|
|
221
|
+
for (const fn of this.handlers.message) {
|
|
222
|
+
try { Promise.resolve(fn(ev)).catch((e) => this.log(`[tencent] 处理失败:${e?.message ?? e}`)); }
|
|
223
|
+
catch (e) { this.log(`[tencent] 处理失败:${e?.message ?? e}`); }
|
|
224
|
+
}
|
|
225
|
+
}
|
|
226
|
+
|
|
227
|
+
send(payload) {
|
|
228
|
+
try { this.ws?.send(JSON.stringify(payload)); } catch (e) { this.log(`[tencent] 发送失败:${e.message}`); }
|
|
229
|
+
}
|
|
230
|
+
|
|
231
|
+
startHeartbeat(interval) {
|
|
232
|
+
this.stopHeartbeat();
|
|
233
|
+
this.heartbeatTimer = setInterval(() => this.send({ op: 1, d: this.seq }), interval);
|
|
234
|
+
this.heartbeatTimer.unref?.();
|
|
235
|
+
}
|
|
236
|
+
|
|
237
|
+
stopHeartbeat() {
|
|
238
|
+
if (this.heartbeatTimer) clearInterval(this.heartbeatTimer);
|
|
239
|
+
this.heartbeatTimer = null;
|
|
240
|
+
}
|
|
241
|
+
|
|
242
|
+
async stop() {
|
|
243
|
+
this.stopped = true;
|
|
244
|
+
this.stopHeartbeat();
|
|
245
|
+
try { this.ws?.close(); } catch {}
|
|
246
|
+
}
|
|
247
|
+
}
|
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
// 适配器三:任意平台(带自己的传输)
|
|
2
|
+
//
|
|
3
|
+
// 只要你能把消息变成 { sender, text, chatId },就能用这个。
|
|
4
|
+
// 大脑不认识平台——它只认识事件。
|
|
5
|
+
|
|
6
|
+
import { normalizeEvent } from '../core/event.js';
|
|
7
|
+
|
|
8
|
+
/**
|
|
9
|
+
* 最小宿主:把"收到消息"和"注入 prompt"接起来。
|
|
10
|
+
*
|
|
11
|
+
* @param {object} opts
|
|
12
|
+
* @param {object} opts.brain createBrain() 的返回值
|
|
13
|
+
* @param {(injected:string, event:object) => string} [opts.buildSystemPrompt]
|
|
14
|
+
* @param {(system:string, event:object) => void} [opts.onContext]
|
|
15
|
+
*/
|
|
16
|
+
export function createUniversalHost({ brain, buildSystemPrompt, onContext } = {}) {
|
|
17
|
+
if (!brain) throw new Error('需要 brain 实例');
|
|
18
|
+
|
|
19
|
+
return {
|
|
20
|
+
/**
|
|
21
|
+
* 收到一条消息 → 返回该拼进 system prompt 的那一段。
|
|
22
|
+
* 顺便让她"经历"这条消息(权重会动)。
|
|
23
|
+
*/
|
|
24
|
+
handle(rawEvent) {
|
|
25
|
+
const event = normalizeEvent(rawEvent, rawEvent?.platform ?? 'universal');
|
|
26
|
+
const { text: injected } = brain.wake(event);
|
|
27
|
+
const system = buildSystemPrompt ? buildSystemPrompt(injected, event) : injected;
|
|
28
|
+
if (onContext) onContext(system, event);
|
|
29
|
+
return { event, injected, system };
|
|
30
|
+
},
|
|
31
|
+
|
|
32
|
+
/** 只记录,不唤醒(比如她自己发的消息、系统通知) */
|
|
33
|
+
record(rawEvent) {
|
|
34
|
+
return brain.observe(normalizeEvent(rawEvent, rawEvent?.platform ?? 'universal'));
|
|
35
|
+
},
|
|
36
|
+
};
|
|
37
|
+
}
|
|
38
|
+
|
|
39
|
+
export { normalizeEvent };
|