dsh-qq-affinity 0.0.0-stage → 0.14.2
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 +55 -2
- package/client.js +3550 -0
- package/cordis.patch.yml +6 -0
- package/docs/DETAIL.md +332 -0
- package/icon.svg +12 -0
- package/index.js +128 -0
- package/lib/analyze.js +777 -0
- package/lib/api.js +984 -0
- package/lib/backfill.js +146 -0
- package/lib/bridge-server.js +78 -0
- package/lib/care.js +240 -0
- package/lib/features.js +200 -0
- package/lib/home.js +168 -0
- package/lib/inbound.js +120 -0
- package/lib/llm.js +137 -0
- package/lib/media.js +161 -0
- package/lib/onebot.js +207 -0
- package/lib/parse.js +184 -0
- package/lib/recover.js +46 -0
- package/lib/store.js +705 -0
- package/lib/util.js +186 -0
- package/lib/vision.js +108 -0
- package/locale/en.json +7 -0
- package/locale/zh.json +7 -0
- package/package.json +38 -4
- package/scripts/api-e2e.mjs +538 -0
- package/scripts/backfill-e2e.mjs +142 -0
- package/scripts/backfill-live.mjs +60 -0
- package/scripts/bridge-e2e.mjs +137 -0
- package/scripts/care-e2e.mjs +217 -0
- package/scripts/check-hook-order.mjs +83 -0
- package/scripts/make-napcat-config.mjs +87 -0
- package/scripts/media-e2e.mjs +103 -0
- package/scripts/recover-e2e.mjs +75 -0
- package/scripts/selftest.mjs +159 -0
- package/scripts/strip-bom.mjs +27 -0
package/cordis.patch.yml
ADDED
|
@@ -0,0 +1,6 @@
|
|
|
1
|
+
# Bundle patch: one row loads this package's main entry as the Host half.
|
|
2
|
+
# The `dsh.client` declaration in package.json makes the Web app load
|
|
3
|
+
# ./client.js as the browser half (root sidebar entry + main panel).
|
|
4
|
+
- insert:
|
|
5
|
+
- id: qq-affinity
|
|
6
|
+
name: dsh-qq-affinity
|
package/docs/DETAIL.md
ADDED
|
@@ -0,0 +1,332 @@
|
|
|
1
|
+
# QQ 好感度档案
|
|
2
|
+
|
|
3
|
+
把导出的 QQ 聊天记录变成按 **QQ 号** 建档的本地关系档案,并给出两件事:三个量化指标,以及对方发消息时可以用的三条回复候选。
|
|
4
|
+
|
|
5
|
+
## 它做什么
|
|
6
|
+
|
|
7
|
+
### 1. 按 QQ 号建档
|
|
8
|
+
|
|
9
|
+
每个出现在记录里的人,都会按真实 QQ 号建一份档案。同一个人在私聊和多个群里出现时共用同一份档案 —— 所以后开启某个群聊,群里那个人的历史数据会一并计入他的好感度。
|
|
10
|
+
|
|
11
|
+
### 2. 三个指标(满分 100)
|
|
12
|
+
|
|
13
|
+
| 指标 | 读什么 |
|
|
14
|
+
| --- | --- |
|
|
15
|
+
| **TA 对你的好感度** | 对方怎么和你说话:主动开口的比例、回复快慢、消息长度、提问和表情的密度、深夜聊天占比、连发几条的频率 |
|
|
16
|
+
| **你对 TA 的好感度** | 只读**你本人真实的表达**,见下面第 6 条 |
|
|
17
|
+
| **你们的亲密度** | 双方加起来:谁先开口、互相接话的速度、轻松程度、覆盖时长和活跃天数 |
|
|
18
|
+
|
|
19
|
+
三项都由一次模型调用得出,并附带具体理由(引用了哪句话、间隔多久),不是纯打分。分数旁边还能看到这次计算用的消息条数、我的真实表达条数、AI 代笔条数、置信度,以及「记录已变化,建议重新分析」的提示。
|
|
20
|
+
|
|
21
|
+
**颜色分八档**:90+ 深绿 → 80 绿蓝 → 70 黄绿 → 60 嫩黄 → 50 琥珀 → 40 橙 → 25 深橙红 → 0 红。这八档是从主题色按比例混出来的,所以亮色/暗色主题都会自动跟着变;浏览器不支持混色时会退回原来的四档。<br>指标区下面有一条渐变尺度条,标着「0 低 ← → 高 100」,方便对照。
|
|
22
|
+
|
|
23
|
+
**列表怎么分组**:对话列表分成「私聊」和「群聊」两段,各带条数。前面那个小圆点的**颜色代表类型**(私聊品牌色 / 群聊绿色),**实心代表已开启、空心代表未开启**——原来颜色被"开关状态"占用了,类型看不出来。
|
|
24
|
+
|
|
25
|
+
**档案里显示备注**:每一行是 `对方的 QQ 昵称(你给这个对话起的备注)`,备注取自你这个私聊对话的标题;没设备注就只有昵称。QQ 号在第二行。
|
|
26
|
+
|
|
27
|
+
**档案列表可以排序**:列表上方有下拉框,可选「TA 对你的好感度 / 你对 TA 的好感度 / 亲密度 / 消息条数」,右边的按钮在降序(↓)和升序(↑)之间切换。右边那个数字就是当前排序用的指标,颜色按上面八档着色;悬停能看到三项完整分数。还没分析过的人永远排在最后,不会因为升序就跑到最前面。
|
|
28
|
+
|
|
29
|
+
**手动调整顺序用每行右侧的 ▲▼ 按钮**:点 ▲ 上移一位、点 ▼ 下移一位,只在本分组内移动。
|
|
30
|
+
|
|
31
|
+
- 顺序存在档案的 `meta.json` 里(`order.conversations` / `order.people`),换数据位置、重启都跟着走。
|
|
32
|
+
- 按钮的点击不触发「选中这行」;保存失败会在列表上方留一条红色说明,写清原因。
|
|
33
|
+
- 新加的对话/新建档的人如果不在已保存的顺序里,会排在后面,不会消失。
|
|
34
|
+
- 后台每次收到顺序请求都会往档案目录的 `reorder.log` 写一行,用来判断问题出在客户端还是保存环节。
|
|
35
|
+
|
|
36
|
+
> **拖拽功能已移除**。这个外壳会吞掉鼠标按下事件(`click` 正常、`mousedown`/`pointerdown` 被拦截),各种手势方案都收不到开始信号,与其留一个永远失灵的手势,不如只保留确定有效的 ▲▼。
|
|
37
|
+
|
|
38
|
+
### 3. 智能回复建议
|
|
39
|
+
|
|
40
|
+
在任意已开启的对话里点「生成三条回复建议」,会用当前对话里**对方最新的一条消息**去生成三条候选,分别走三种策略:
|
|
41
|
+
|
|
42
|
+
1. **共情接住** —— 先确认对方的情绪或处境
|
|
43
|
+
2. **具体好奇** —— 问一个细节,把话头递回去
|
|
44
|
+
3. **轻松推进** —— 用轻量的下一步把对话往前带
|
|
45
|
+
|
|
46
|
+
每条都带「为什么」「预期」「风险」,你可以先判断再决定用不用。
|
|
47
|
+
|
|
48
|
+
**点「采用并发送」会直接以你的身份发给对方**(实时通道接通时),省掉复制粘贴。发出去的同时记为 AI 代笔,不计入「你对 TA 的好感度」。通道没接通时按钮退化成「采用」,只记录并复制到剪贴板。
|
|
49
|
+
|
|
50
|
+
**所有回复都按你的打字习惯重写一遍**,不管是建议、托管还是采用后发送:
|
|
51
|
+
|
|
52
|
+
- 逗号、句号、顿号、分号、冒号 → 一个空格
|
|
53
|
+
- 句尾句号直接去掉(不留空格)
|
|
54
|
+
- 去掉所有 emoji 和表情符号
|
|
55
|
+
- `?` 和 `!` 保留(它们带语气,去掉就不像人说的话了;想一起去掉跟我说)
|
|
56
|
+
|
|
57
|
+
### 4. 人格画像
|
|
58
|
+
|
|
59
|
+
除了好感度,还能单独分析「TA 大概是个什么样的人」。在档案页选一个人 → **分析 TA 的人格**。
|
|
60
|
+
|
|
61
|
+
**最上面是 MBTI 卡片**:类型(如 `INFP`)+ 中文别名 + 四个轴的倾向条 + 置信度 + 一句免责说明。四个轴分别给强度和理由:
|
|
62
|
+
|
|
63
|
+
| 轴 | 看什么 |
|
|
64
|
+
| --- | --- |
|
|
65
|
+
| E / I | 主动起话题的密度、话多话少、需要互动还是自述、回复的即时性 |
|
|
66
|
+
| N / S | 聊具体事实细节流程,还是聊可能性意义联想假设 |
|
|
67
|
+
| T / F | 讲道理给方案,还是先接情绪、在意感受和关系 |
|
|
68
|
+
| J / P | 计划明确讨厌变动,还是随性临时起意话题跳 |
|
|
69
|
+
|
|
70
|
+
类型不是照抄模型的字母:**四个轴的字母会被重新拼成类型**,所以不会出现「INFP 里带着 J 轴」这种自相矛盾的输出;拼不出来就整块不显示,而不是编一个。
|
|
71
|
+
|
|
72
|
+
下面是:
|
|
73
|
+
|
|
74
|
+
- 一句话画像
|
|
75
|
+
- **关键词标签**(4–6 个,每个一个色块)
|
|
76
|
+
- **4–6 条性格判断,每条一个色块**:左侧色条 + 淡色底 + 突出程度条。色块颜色按位置从一个主题色环里取,相邻两条不会同色
|
|
77
|
+
- 说话风格、关系模式(怎么靠近、怎么退开、在意什么)
|
|
78
|
+
- TA 明确提到过的兴趣
|
|
79
|
+
- 怎么聊更顺(2–4 条)
|
|
80
|
+
- 雷区(基于观察:某个话题之后 TA 明显变短变慢)
|
|
81
|
+
- 置信度 + 依据条数
|
|
82
|
+
|
|
83
|
+
分析**只读 TA 自己说的话**和说话习惯,纪律上禁止猜职业、年龄、学校、所在地、外貌。每条判断都能追到证据,你可以直接反驳证据本身。
|
|
84
|
+
|
|
85
|
+
> 所有颜色都是从主题色混出来的,亮色/暗色主题都会跟着变;浏览器不支持 `color-mix` 时退回单色,不会变成无法阅读。
|
|
86
|
+
|
|
87
|
+
### 5. 智能托管(自动回复)
|
|
88
|
+
|
|
89
|
+
对**某一个人**单独开启托管后,TA 发来消息时插件会自己写一句回复。
|
|
90
|
+
|
|
91
|
+
**两种方式**,按人分别设置:
|
|
92
|
+
|
|
93
|
+
- **先给我确认**(默认):写完放进「待发」记录,你点「发送」才真的发出去。
|
|
94
|
+
- **自动发送**:直接替你发出去,中间没有确认。
|
|
95
|
+
|
|
96
|
+
**前提:必须有实时通道。** 自动回复要能收到消息、也能把话发出去,这需要一个 OneBot v11 实现挂在你登录的 QQ 上,插件只连它的**本地 HTTP 接口**,不碰 QQ 本身。具体怎么接,见下面「接实时通道」一节。
|
|
97
|
+
|
|
98
|
+
## 接实时通道
|
|
99
|
+
|
|
100
|
+
### 选一个桥
|
|
101
|
+
|
|
102
|
+
| 方案 | 适合 | 代价 |
|
|
103
|
+
| --- | --- | --- |
|
|
104
|
+
| **LLOneBot** | 你平时就用电脑 QQ,想让它挂在**同一个**登录上 | 要给 QQ 装 LiteLoaderQQNT + LLOneBot 插件,QQ 更新后可能要重装 |
|
|
105
|
+
| **NapCat** | 想要一个独立的实例(自带 NTQQ,不碰你现有的 QQ 安装) | 要单独登录一份你的 QQ(和桌面 QQ 可能互挤),风险更高 |
|
|
106
|
+
|
|
107
|
+
两者讲同一套 OneBot v11 协议,插件这边填法完全一样,所以选哪个都行。
|
|
108
|
+
|
|
109
|
+
> **下载现状**:NapCat 的 GitHub 仓库在 2026 年已经没有 Release 文件和 tag 了,官方文档里指向 `github.com/NapNeko/NapCatQQ/releases/latest` 的链接是旧的。现在只能从他们官网/官方群的渠道拿安装包。插件**不提供**任何非官方镜像的下载——那类包会登录你的 QQ,来源不可验证就不该装。
|
|
110
|
+
|
|
111
|
+
### 三步
|
|
112
|
+
|
|
113
|
+
**第 1 步:在桥里开 HTTP API(正向 HTTP)**
|
|
114
|
+
|
|
115
|
+
在 LLOneBot / NapCat 的设置里找到「HTTP 服务 / HTTP Server」,启用,记下两样:
|
|
116
|
+
|
|
117
|
+
- 端口(LLOneBot 常见 `3000`,NapCat 常见 `3001`)
|
|
118
|
+
- token(有的默认空)
|
|
119
|
+
|
|
120
|
+
**第 2 步:在桥里开 HTTP 上报(反向 HTTP)**
|
|
121
|
+
|
|
122
|
+
同一个设置页里找「HTTP 上报 / 反向 HTTP / HTTP Client」,启用,地址填插件给你的那个:
|
|
123
|
+
|
|
124
|
+
```
|
|
125
|
+
http://127.0.0.1:17890/qq-affinity/onebot
|
|
126
|
+
```
|
|
127
|
+
|
|
128
|
+
这个端口是**插件自己固定监听的**,DSH 重启也不会变,所以填一次就长期有效。
|
|
129
|
+
|
|
130
|
+
> 如果你在插件里设了「上报口令」,把地址写成 `http://127.0.0.1:17890/qq-affinity/onebot?access_token=<你的口令>`。这样最省事,不依赖桥是否支持自定义请求头。
|
|
131
|
+
|
|
132
|
+
**这一步有个必须打开的开关:上报自身消息(reportSelfMessage)。**
|
|
133
|
+
|
|
134
|
+
不开它,插件只会收到对方说的话,收不到你自己说的话——「你对 TA 的好感度」就永远没有你自己的真实表达可算。打开的代价是:你自己发的每条消息也会进档案(这正是分析需要的),插件会把它存成「我」的消息,但**永远不会去回复它**。
|
|
135
|
+
|
|
136
|
+
WebUI 里点也可以;不想点就用脚本直接写配置文件:
|
|
137
|
+
|
|
138
|
+
```sh
|
|
139
|
+
node scripts/make-napcat-config.mjs --napcat "D:\NapCat" --uin 2608598941
|
|
140
|
+
```
|
|
141
|
+
|
|
142
|
+
它会生成 `config/onebot11_<QQ号>.json`:HTTP 服务端(127.0.0.1:3001,仅本机)+ HTTP 客户端(指向 17890)+ 自身消息上报开启,原有配置自动备份。
|
|
143
|
+
|
|
144
|
+
**第 3 步:回插件点一次测试**
|
|
145
|
+
|
|
146
|
+
**设置 → 实时通道**:
|
|
147
|
+
|
|
148
|
+
| 项 | 填什么 |
|
|
149
|
+
| --- | --- |
|
|
150
|
+
| HTTP API 地址 | 第 1 步记下的端口,如 `http://127.0.0.1:3001` |
|
|
151
|
+
| API access token | 第 1 步的 token,没有就留空 |
|
|
152
|
+
| 上报口令 | 可选。填了就要求上报带上它(第 2 步的 URL 后面加 `?access_token=`) |
|
|
153
|
+
|
|
154
|
+
点 **用上面这套配置测试连接**。成功会:连上桥 → 读出它登录的 QQ 号(自动填进「我的 QQ 号」)→ 启用通道。
|
|
155
|
+
|
|
156
|
+
### 怎么确认真的通了
|
|
157
|
+
|
|
158
|
+
**只读「桥里已经载入的消息」**:桥(NapCat / LLOneBot / SnowLuma)只会交出它自己已经载入的消息,不会向 QQ 服务器要历史。所以:
|
|
159
|
+
|
|
160
|
+
- 新消息:桥实时推给插件,来了就进档案;
|
|
161
|
+
- 已载入的历史:设置里「同步桥里已载入的消息」一次拉进所有已开启的对话(群聊和私聊都算);
|
|
162
|
+
- **插件每次启动会自动同步一次**(通道开启、距上次同步超过 5 分钟时),把 DSH 重启期间桥里攒下的消息补回来——所以平时你不需要手动点。
|
|
163
|
+
|
|
164
|
+
没在桥里出现过的旧消息(比如从没打开过的群)是拿不到的,这与插件无关,是桥只读本地这一设计的边界。
|
|
165
|
+
|
|
166
|
+
看同一页最下面那行:
|
|
167
|
+
|
|
168
|
+
- **「还没收到过上报」** → 桥没在往插件发东西。回去检查第 2 步的上报地址和启用状态。
|
|
169
|
+
- **「最近一次收到上报:<时间>」** → 双向通了。让人给你发一条消息,这个时间会刷新。
|
|
170
|
+
|
|
171
|
+
常见的非 204 返回(插件日志里能看到):
|
|
172
|
+
|
|
173
|
+
| 返回 | 原因 |
|
|
174
|
+
| --- | --- |
|
|
175
|
+
| `409 real-time channel is off` | 插件的通道还没启用。点一次「测试连接」成功即启用 |
|
|
176
|
+
| `401 bad token` | 上报口令不匹配(桥里没配,或 URL 里的 `access_token` 写错了) |
|
|
177
|
+
| `403 loopback only without a token` | 没设上报口令,而请求不是从本机发的 |
|
|
178
|
+
| `405 POST only` | 桥用了 GET 上报,改成 POST |
|
|
179
|
+
|
|
180
|
+
如果面板提示**固定端口没起来**(通常是另一个 DSH 实例占着 17890),就改用面板给的「备用地址」`http://127.0.0.1:<DSH的端口>/qq-affinity/onebot`——但那个端口每次重启 DSH 都会变,要跟着改。
|
|
181
|
+
|
|
182
|
+
**护栏**(都按人可调,全部有默认值):
|
|
183
|
+
|
|
184
|
+
| 护栏 | 默认 | 作用 |
|
|
185
|
+
| --- | --- | --- |
|
|
186
|
+
| 免打扰时段 | 23:30–08:00 | 这个时段不发;**两边都留空就完全不启用** |
|
|
187
|
+
| 每小时上限 | 5 条 | 唯一的频率限制;不设最短间隔 |
|
|
188
|
+
| 回复字数上限 | 60 字 | 保持像聊天 |
|
|
189
|
+
| 群里只回 @ 我的 | 开 | 不替你在群里插话;自动发送模式下关掉会二次确认 |
|
|
190
|
+
| 全局总开关 | 关 | 一键暂停所有人,单人设置保留;打开时若有人是「自动发送」会二次确认 |
|
|
191
|
+
|
|
192
|
+
> **没有最短间隔。** 同一个人的消息按顺序逐条处理,不会并行回多条;防止刷屏完全靠「每小时上限」。对方连发三条,插件就会回三条(除非触发上限),觉得吵就把每小时上限调小。
|
|
193
|
+
|
|
194
|
+
**还会直接跳过**:对方只发了图片/表情/文件/红包(没字可接)、生成失败。
|
|
195
|
+
|
|
196
|
+
**会记录什么**:发出去的、等你确认的、被护栏拦下的(含原因)、发送失败的。群里没 @ 你的消息**不会触发,也不记录** —— 否则群聊会把记录刷满。
|
|
197
|
+
|
|
198
|
+
**怎么看住它**:
|
|
199
|
+
|
|
200
|
+
- 面板顶部有一个状态条:`托管运行中 · N 人` / `托管待接通`(通道掉了)/ `托管已暂停`,以及 `N 条待确认`。
|
|
201
|
+
- 右边永远有 **全部暂停**,一键停掉所有人(单人设置保留),不需要进设置。
|
|
202
|
+
- 托管运行时会每 25 秒自动刷新一次,新的草稿和发送结果不用手动点。
|
|
203
|
+
|
|
204
|
+
### 6. 采用标记,并且不回灌「我对 TA」
|
|
205
|
+
|
|
206
|
+
这是这套设计里最要紧的一条规则:
|
|
207
|
+
|
|
208
|
+
- 点「采用」会记录这次选择,并把文本复制到剪贴板,方便你粘到 QQ 里发出去。
|
|
209
|
+
- 之后**再导入**包含这条消息的记录时,插件会认出它,把这条消息标记为 **AI 代笔**。
|
|
210
|
+
- 判断「**你对 TA 的好感度**」时,AI 代笔的消息会被**从输入里整体剔除** —— 不是「打个折」,而是模型根本看不到它们。所以用了建议也不会让插件误以为你对 TA 更有好感。
|
|
211
|
+
- 判断「**TA 对你的好感度**」和「亲密度」时,这些消息仍然算数,因为对方确实收到了你说的这句话。
|
|
212
|
+
|
|
213
|
+
**托管自动发出去的回复走同一条规则**:它们标成 `AI 自动回复`,同样不计入「你对 TA 的好感度」。区别只在标签和来源 —— 一个是你在建议里挑的,一个是插件自己写的,都不是你的真实表达。
|
|
214
|
+
|
|
215
|
+
界面上,AI 写的内容带 `AI 代笔` / `AI 自动回复` 标签,指标卡片里也会单独列出「AI 代笔(已排除)」的条数。
|
|
216
|
+
|
|
217
|
+
### 7. 只有开着的对话才会被读取
|
|
218
|
+
|
|
219
|
+
- **添加一个对话 = 同意读取它**:实时通道接通时,添加之后会立刻把它打开,并自动拉取**最近 200 条**消息,不用再点一次「补齐历史」。
|
|
220
|
+
- 通道没接通时,添加会把它留在关闭状态,并明确告诉你「没有自动读取」;之后接通了点一次「补齐历史」,或者把开关关掉再打开,也会自动拉 200 条。
|
|
221
|
+
- 把开关关掉之后,这个对话立刻从所有计算中退出(数据仍保留,直到你点「删除数据」),也不会再收新消息。
|
|
222
|
+
- 没被添加、没被打开的对话,插件不会读取、保存或分析它的任何内容——群里的消息再多也一样。
|
|
223
|
+
|
|
224
|
+
## 怎么用
|
|
225
|
+
|
|
226
|
+
1. 点侧边栏的 **QQ 好感度** 图标进入面板。
|
|
227
|
+
2. 点右上角 **填写我的 QQ 号** —— 插件需要它来区分「我」和「对方」。
|
|
228
|
+
3. 点左下角 **+ 添加对话**,填对方昵称 + 对方 QQ 号(群聊则填群名 + 群号)。私聊的 QQ 号可以留空,导入后会自动从记录里识别。
|
|
229
|
+
4. 添加完就已经是开启状态了(通道接通时会自动读入最近 200 条);没接通就回到对话页打开 **读取这个对话** 开关,再点「补齐历史」。
|
|
230
|
+
5. 点 **导入聊天记录**:在 QQ 的消息管理器里选中这个对话 → 导出消息记录 → 选择「文本 (.txt)」,然后把文件拖进来或直接粘贴。
|
|
231
|
+
6. 到 **档案** 标签页,选一个人,点 **开始分析**。群聊的话,导入后对话页会列出群成员,点名字就能单独分析。
|
|
232
|
+
7. 回到对话页,点 **生成三条回复建议**。
|
|
233
|
+
|
|
234
|
+
想让它自动回:先在 **设置 → 实时通道** 里接通 OneBot,点一次 **测试连接**;然后到 **档案** 里选人,打开 **智能托管**,选「先给我确认」或「自动发送」。
|
|
235
|
+
|
|
236
|
+
## 全自动导入
|
|
237
|
+
|
|
238
|
+
分三层,能力不一样,别混:
|
|
239
|
+
|
|
240
|
+
| 层 | 自动程度 | 前提 |
|
|
241
|
+
| --- | --- | --- |
|
|
242
|
+
| **以后的新消息** | 全自动,零操作 | 接通实时通道 |
|
|
243
|
+
| **历史消息** | 一键补齐;也可以设成接通后自动补齐 | 接通实时通道 + 桥支持「拉取历史」 |
|
|
244
|
+
| **纯离线(不接桥)** | 只能手动导出导入 | 无 |
|
|
245
|
+
|
|
246
|
+
### 新消息:接上就自动
|
|
247
|
+
|
|
248
|
+
通道接通后,**已开启**的对话里每来一条消息都会自动入库、自动参与分析。你不需要再做任何导入动作。
|
|
249
|
+
|
|
250
|
+
没开启的对话依然什么都不读 —— 这条规矩不因为接了通道就变。
|
|
251
|
+
|
|
252
|
+
### 历史消息:补齐
|
|
253
|
+
|
|
254
|
+
两个入口:
|
|
255
|
+
|
|
256
|
+
- 单个对话:对话页 **从通道补齐历史**
|
|
257
|
+
- 全部:**设置 → 实时通道 → 现在给所有已开启对话补齐**
|
|
258
|
+
|
|
259
|
+
或者勾上 **接通后自动补齐历史**:点「测试连接」成功后,插件会自己在后台把所有已开启对话的历史拉一遍。默认是勾上的。
|
|
260
|
+
|
|
261
|
+
补齐的行为:
|
|
262
|
+
|
|
263
|
+
- 每个对话一次最多拉 **1000 条**(`get_friend_msg_history` / `get_group_msg_history`,也兼容 go-cqhttp 的 `get_history_msg`),想拉更多就再点一次或多次(重复内容会按「时间 + 发送者 + 内容」指纹自动去重)。
|
|
264
|
+
- **只拉已开启的对话。** 关着的对话不会被碰。
|
|
265
|
+
- 每个对话的结果单独报告:哪个成功、新增几条、重复几条、哪个失败以及失败原因。一个群拉不动不影响私聊。
|
|
266
|
+
- 桥不支持这个接口时,会直接告诉你「这个桥不支持拉取历史」,而不是假装补齐了 —— 那就退回导出 .txt 导入。
|
|
267
|
+
|
|
268
|
+
### 为什么不读 QQ 本地数据库
|
|
269
|
+
|
|
270
|
+
理论上可以读 `nt_msg.db`(SQLCipher,密钥在 QQ 进程内存里),做到完全不依赖桥。但那条路要读进程内存、每次 QQ 升级都可能失效、还容易被安全软件拦。所以这版没做;桥能给的(实时 + 历史)已经覆盖了同一个目的,而且干净得多。
|
|
271
|
+
|
|
272
|
+
## 支持的导入格式
|
|
273
|
+
|
|
274
|
+
文本导出(QQ 消息管理器的 .txt),要点是「一行时间戳 + 一行发送者,后面跟内容」:
|
|
275
|
+
|
|
276
|
+
```
|
|
277
|
+
2023-07-01 21:03:10 小明(10001)
|
|
278
|
+
在吗
|
|
279
|
+
|
|
280
|
+
2023-07-01 21:03:42 我(20002)
|
|
281
|
+
在
|
|
282
|
+
```
|
|
283
|
+
|
|
284
|
+
同时兼容:
|
|
285
|
+
|
|
286
|
+
- 单行写法 `2023-07-01 21:03:10 小明(10001): 在吗`
|
|
287
|
+
- 方括号 / 尖括号 / 邮箱标识:`小明[10001]`、`小明<10001@qq.com>`
|
|
288
|
+
- 内容里的多行文本会合并成一条消息
|
|
289
|
+
- JSON 数组:`[{"time":"...","sender":"小明","uin":"10001","text":"在吗"}]`
|
|
290
|
+
|
|
291
|
+
**没有 QQ 号的格式会被忽略。** 有些导出只写时间戳和昵称(没有括号里的号码),插件无法判断一句话是你说的还是对方说的,这类行不会入库,也不会污染计算。导出的记录里带上 QQ 号才能用。
|
|
292
|
+
|
|
293
|
+
不支持 **HTML / MHT** 导出。一条都识别不出来时,插件会直接告诉你换格式,而不是静默导入 0 条。
|
|
294
|
+
|
|
295
|
+
## 数据存在哪
|
|
296
|
+
|
|
297
|
+
默认在 `~/.dsh/qq-affinity/`,面板顶部会显示当前实际路径。
|
|
298
|
+
|
|
299
|
+
```
|
|
300
|
+
meta.json 对话列表、人物档案、三项分数、采用记录、托管设置与通道配置
|
|
301
|
+
messages/<对话>.ndjson 聊天记录,每行一条
|
|
302
|
+
suggestions/<对话>.json 最近 20 批回复候选
|
|
303
|
+
outbox.ndjson 每一次自动回复尝试(含被跳过的原因)
|
|
304
|
+
```
|
|
305
|
+
|
|
306
|
+
### 换位置(在插件里改)
|
|
307
|
+
|
|
308
|
+
**设置 → 数据位置**:
|
|
309
|
+
|
|
310
|
+
1. 填新位置的绝对路径(`D:\QQ档案`、`~/qq-affinity` 都行,目录不存在会自动创建)。
|
|
311
|
+
2. 点 **迁移到这个位置**:把现有档案复制过去,然后立刻切过去。
|
|
312
|
+
- 默认**不删**原位置的数据,界面会告诉你在哪,确认无误后自己删。
|
|
313
|
+
- 勾上「迁移后删除原位置的数据」才会清掉旧副本(会二次确认)。
|
|
314
|
+
- 目标位置已经有一份档案时会拒绝,避免覆盖。
|
|
315
|
+
3. 或者点 **切过去(不搬数据)**:只改指向。新位置有档案就用那份,没有就从空档案开始。
|
|
316
|
+
4. **恢复默认位置**:把指针删掉,回到 `~/.dsh/qq-affinity`。
|
|
317
|
+
|
|
318
|
+
改完立即生效,不用重启 DSH。
|
|
319
|
+
|
|
320
|
+
指针文件在 `~/.dsh/qq-affinity/location.json`(只有用自定义位置时才存在),所以换位置不会把"位置本身"弄丢。
|
|
321
|
+
|
|
322
|
+
**环境变量优先**:设了 `DSH_QQ_AFFINITY_HOME` 时,它会盖过面板设置,面板里的换位置按钮会被锁住并说明原因。想用面板管理就把这个变量去掉。
|
|
323
|
+
|
|
324
|
+
## 边界
|
|
325
|
+
|
|
326
|
+
- **导入路线不是实时**:不开实时通道时,要看新消息就得再导一次(重复内容会自动去重)。只有接通 OneBot 之后,消息才是照着来的。
|
|
327
|
+
- **自动回复需要一个挂你 QQ 的桥**:NapCat / LLOneBot 这类工具本质是用非官方客户端登录你的号,**有被临时限制甚至封号的风险**,这一点插件改变不了。想稳妥就只用「先给我确认」,或者不接通道、只做导入分析。
|
|
328
|
+
- **自动发送就是用你的身份说话**:护栏只能挡掉一部分尴尬,挡不住全部。第一次开「自动发送」前,建议先跑几天「先给我确认」,看它写的东西是不是你能接受的水平。
|
|
329
|
+
- **采用识别靠文本比对**:忽略空格和标点后比较,相似度达到 0.9 就认定是同一条。如果你发送前改动较大,它会被当成你自己写的 —— 这偏保守:宁可漏标,也不会把你真实的想法误判成 AI 代笔。
|
|
330
|
+
- **评分是模型给的估计**:它只看到记录,不知道你们的线下关系。分数低不代表关系差,理由比分数更值得看。
|
|
331
|
+
- **记录少了不给分**:同一个人少于 8 条消息时,分析会拒绝执行。
|
|
332
|
+
- **每分析一次花一次模型调用**:用的是你在 DSH 里选的默认模型。自动回复同理,每触发一次回一条就是一次调用。
|
package/icon.svg
ADDED
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="24" height="24" role="img" aria-label="QQ affinity">
|
|
2
|
+
<defs>
|
|
3
|
+
<linearGradient id="qqa" x1="4" y1="3" x2="20" y2="21" gradientUnits="userSpaceOnUse">
|
|
4
|
+
<stop offset="0" stop-color="#ff8fa8"/>
|
|
5
|
+
<stop offset="1" stop-color="#d94f74"/>
|
|
6
|
+
</linearGradient>
|
|
7
|
+
</defs>
|
|
8
|
+
<path d="M12 20.6c-.5 0-1-.2-1.4-.5C6.2 16.7 3 13.4 3 9.9 3 7 5.2 4.7 8 4.7c1.6 0 3 .7 4 1.9 1-1.2 2.4-1.9 4-1.9 2.8 0 5 2.3 5 5.2 0 3.5-3.2 6.8-7.6 10.2-.4.3-.9.5-1.4.5Z" fill="url(#qqa)"/>
|
|
9
|
+
<path d="M15.6 18.9 18 21.3l-.2-3.4Z" fill="#d94f74"/>
|
|
10
|
+
<circle cx="8.9" cy="10.6" r="1.15" fill="#fff" opacity=".92"/>
|
|
11
|
+
<circle cx="15.1" cy="10.6" r="1.15" fill="#fff" opacity=".92"/>
|
|
12
|
+
</svg>
|
package/index.js
ADDED
|
@@ -0,0 +1,128 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* QQ affinity profiles — Host half.
|
|
3
|
+
*
|
|
4
|
+
* Two surfaces:
|
|
5
|
+
* - `/api/qq-affinity/*` for its own browser panel, admitted by the Harness
|
|
6
|
+
* Connection with the same browser credential the rest of the GUI uses;
|
|
7
|
+
* - a report route for a real-time bridge (NapCat / LLOneBot). It is served on
|
|
8
|
+
* a fixed loopback port the plugin owns, because DSH's own GUI port changes
|
|
9
|
+
* every launch and a bridge's configured URL must not.
|
|
10
|
+
*
|
|
11
|
+
* All state lives in a local directory. No QQ data is read from anywhere, a
|
|
12
|
+
* conversation contributes nothing until the user turns it on, and an automatic
|
|
13
|
+
* reply only runs for people the user switched on individually.
|
|
14
|
+
*/
|
|
15
|
+
|
|
16
|
+
import { readFileSync } from 'node:fs'
|
|
17
|
+
import path from 'node:path'
|
|
18
|
+
import { fileURLToPath } from 'node:url'
|
|
19
|
+
import { Store } from './lib/store.js'
|
|
20
|
+
import { resolveDataDirectory } from './lib/home.js'
|
|
21
|
+
import { createRoutes, INBOUND_PATH } from './lib/api.js'
|
|
22
|
+
import { createCareEngine } from './lib/care.js'
|
|
23
|
+
import { createNodeHandler } from './lib/inbound.js'
|
|
24
|
+
import { bridgePort, startBridgeServer } from './lib/bridge-server.js'
|
|
25
|
+
import { recoverLoaded } from './lib/recover.js'
|
|
26
|
+
|
|
27
|
+
export const name = 'qq-affinity'
|
|
28
|
+
|
|
29
|
+
/**
|
|
30
|
+
* This package's version, read once at load.
|
|
31
|
+
*
|
|
32
|
+
* The panel compares it with the version its own bundle was built from: a client
|
|
33
|
+
* that still runs an older bundle is then a visible mismatch instead of a
|
|
34
|
+
* mysteriously broken button.
|
|
35
|
+
*/
|
|
36
|
+
const VERSION = (() => {
|
|
37
|
+
try {
|
|
38
|
+
const here = path.dirname(fileURLToPath(import.meta.url))
|
|
39
|
+
return String(JSON.parse(readFileSync(path.join(here, 'package.json'), 'utf8')).version ?? '')
|
|
40
|
+
} catch {
|
|
41
|
+
return ''
|
|
42
|
+
}
|
|
43
|
+
})()
|
|
44
|
+
|
|
45
|
+
/** The Connection owns the `/api` trust boundary these routes sit behind; the
|
|
46
|
+
* timer service backs ctx.setTimeout for the startup sync. */
|
|
47
|
+
export const inject = ['connection', 'timer']
|
|
48
|
+
|
|
49
|
+
/**
|
|
50
|
+
* Register the panel API, the bridge report endpoint, and the care engine.
|
|
51
|
+
* @param {import('@deepseek-ai/cordis').Context} ctx
|
|
52
|
+
*/
|
|
53
|
+
export function apply(ctx) {
|
|
54
|
+
const store = new Store(resolveDataDirectory())
|
|
55
|
+
const engine = createCareEngine({ ctx, store })
|
|
56
|
+
// Shared mutable status: the listener settles asynchronously, the panel reads it on demand.
|
|
57
|
+
const bridge = { listening: false, port: bridgePort(), url: '', error: 'starting' }
|
|
58
|
+
const routes = createRoutes(ctx, store, engine, bridge, { version: VERSION })
|
|
59
|
+
|
|
60
|
+
ctx.effect(() => {
|
|
61
|
+
const disposers = routes.map(route => ctx.connection.fetch.register({
|
|
62
|
+
path: route.path,
|
|
63
|
+
methods: [route.method],
|
|
64
|
+
requestBody: route.requestBody,
|
|
65
|
+
fetch: route.fetch,
|
|
66
|
+
}))
|
|
67
|
+
return async () => {
|
|
68
|
+
for (const dispose of disposers) await dispose()
|
|
69
|
+
}
|
|
70
|
+
}, 'qq-affinity: panel api')
|
|
71
|
+
|
|
72
|
+
ctx.effect(() => {
|
|
73
|
+
const webServer = ctx.get('webServer')
|
|
74
|
+
if (webServer === undefined) {
|
|
75
|
+
ctx.logger?.warn?.('qq-affinity: no web server in this composition; the bridge fallback route is unavailable')
|
|
76
|
+
return () => {}
|
|
77
|
+
}
|
|
78
|
+
return webServer.register({
|
|
79
|
+
kind: 'exact',
|
|
80
|
+
path: INBOUND_PATH,
|
|
81
|
+
handler: createNodeHandler({ store, engine, ctx }),
|
|
82
|
+
})
|
|
83
|
+
}, 'qq-affinity: bridge fallback route')
|
|
84
|
+
|
|
85
|
+
ctx.effect(() => {
|
|
86
|
+
let disposed = false
|
|
87
|
+
let server
|
|
88
|
+
void startBridgeServer({ handler: createNodeHandler({ store, engine, ctx }) }).then((started) => {
|
|
89
|
+
if (disposed) {
|
|
90
|
+
void started.close()
|
|
91
|
+
return
|
|
92
|
+
}
|
|
93
|
+
server = started
|
|
94
|
+
Object.assign(bridge, {
|
|
95
|
+
listening: started.listening,
|
|
96
|
+
port: started.port,
|
|
97
|
+
url: started.url,
|
|
98
|
+
error: started.error ?? '',
|
|
99
|
+
})
|
|
100
|
+
ctx.logger?.info?.(started.listening
|
|
101
|
+
? `qq-affinity: bridge listening at ${started.url}`
|
|
102
|
+
: `qq-affinity: bridge port ${started.port} unavailable (${started.error}); use the Harness route instead`)
|
|
103
|
+
})
|
|
104
|
+
return async () => {
|
|
105
|
+
disposed = true
|
|
106
|
+
if (server !== undefined) await server.close()
|
|
107
|
+
}
|
|
108
|
+
}, 'qq-affinity: bridge listener')
|
|
109
|
+
|
|
110
|
+
// Recover whatever the bridge already has loaded.
|
|
111
|
+
//
|
|
112
|
+
// The bridge only serves messages it captured itself — it never asks the QQ
|
|
113
|
+
// server for history — so this pull is bounded, cheap, and cannot touch
|
|
114
|
+
// anything the user has not chosen to track: it only reads enabled
|
|
115
|
+
// conversations. It exists because DSH restarts (and this plugin's own
|
|
116
|
+
// reloads) leave gaps in live capture that no amount of later reporting can
|
|
117
|
+
// close; the bridge's store still holds those messages.
|
|
118
|
+
const timer = ctx.setTimeout(() => {
|
|
119
|
+
void recoverLoaded({ store }).then((result) => {
|
|
120
|
+
if (result.ran === true) ctx.logger?.info?.(`qq-affinity: startup sync recovered ${result.added ?? 0} loaded messages`)
|
|
121
|
+
}).catch((error) => {
|
|
122
|
+
ctx.logger?.warn?.(`qq-affinity: startup sync skipped: ${error instanceof Error ? error.message : String(error)}`)
|
|
123
|
+
})
|
|
124
|
+
}, 4000)
|
|
125
|
+
|
|
126
|
+
ctx.logger?.info?.(`qq-affinity: ready, data in ${store.directory}`)
|
|
127
|
+
return () => { clearTimeout(timer) }
|
|
128
|
+
}
|