dsh-napcat-keeper 2.9.1 → 2.9.3
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/CHANGELOG.md +17 -0
- package/README.md +50 -44
- package/lib/client.js +6 -4
- package/lib/index.js +59 -22
- package/package.json +5 -4
- package/scripts/check-manifest.mjs +17 -0
- package/scripts/selftest-companion.mjs +25 -6
- package/scripts/smoke-client.mjs +4 -4
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,22 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
## 2.9.3 — 补上市场索引要的两项:`engines.dsh` 与 README 的 Requirements
|
|
4
|
+
|
|
5
|
+
- **改**:`package.json` 的 `engines` 里加上 `"dsh": ">=0.2.1-rc.2"`(与既有的 `dshTarget` 对齐)。dsh-market 索引原本报 `engines.dsh is missing, so the market index cannot state the host requirement`,补上之后市场页能标出宿主版本要求。
|
|
6
|
+
- **改**:README 增加英文标题的 `## Requirements` 段(内含中文表格:DSH 宿主 / Node / Windows / NapCat / 可选的 dsh-qq-link,并注明每项对应的清单字段)。市场校验原本报 `README.md has no Requirements section`。
|
|
7
|
+
- **改**:`scripts/check-manifest.mjs` 把这两项也纳入体检(缺 `engines.dsh`、缺 `## Requirements` 直接 FAIL),以后本地 `npm test` 就能拦住同类漏项,不用等市场回来说。
|
|
8
|
+
- 版本号:`lib/index.js` 的 `version` 与 `package.json` 同步到 2.9.3。
|
|
9
|
+
|
|
10
|
+
## 2.9.2 — 跟着上游把桥接插件认成 `dsh-qq-link`(老名继续兼容)
|
|
11
|
+
|
|
12
|
+
- **改**:上游把 `dsh-qq-bridge` 改名成 **`dsh-qq-link`**(npm 包名与仓库名都换了,2026-11)。本插件认包的地方跟着改:`BRIDGE_PACKAGES = ['dsh-qq-link', 'dsh-qq-bridge']`,新增 `bridgeHits()` 把两个包名的探测结果合并、一个 profile 只留一条、新名优先。
|
|
13
|
+
- **没改(很关键)**:上游只换了包名,插件内部还是老名字 —— `export const name = 'qq-bridge'`、配置 `~/.dsh/qq-bridge-config.json`、状态 `~/.dsh/qq-bridge-state.json`、路由前缀 `/dsh-qq-bridge/*`(实测 1.5.1 仍然如此)。所以 `BRIDGE_ID`、`bridgeStatePath`、配置文件名一律原样保留;谁把它们跟着改成 link,就会永远认不到桥接。
|
|
14
|
+
- **兼容**:机器上还装着老包 `dsh-qq-bridge` 的,照样认得出(结果里 `candidates[].packageName` 会如实标出是哪个包)。
|
|
15
|
+
- **界面/工具**:桥接那行改成显示**实际装的包名**(`bridgePublic.packageName`,缺省 `dsh-qq-link`),不再硬编码文案;`napcat_status` 的 `companion.bridge` 一并带上这个字段。提示语(没挂载 / 连了反向 WS 端口 / 端口对不上 / 总开关关着 / 试运行)统一说 `dsh-qq-link`。
|
|
16
|
+
- **README**:全文(含开篇简介、心跳说明、配置表、文件位置、自测清单)统一改成 `dsh-qq-link`;补一段「改名只换了包名,内部名字没变」的说明;顺手删掉 `npm run selftest:setup` 那半句(2.9.1 已把该脚本删掉,留着会骗人)。
|
|
17
|
+
- **测过**:`npm test` 全绿(清单体检 + 隐私体检 + smoke:client 65 项 + scan/save/probe/companion/layout/qrpanel 全部自测);`selftest:companion` 的夹具改成新包名,并保留「老包名也认」的断言。
|
|
18
|
+
- 版本号:`lib/index.js` 的 `version` 与 `package.json` 同步到 2.9.2。
|
|
19
|
+
|
|
3
20
|
## 2.9.1 — 删掉「提权交接」那套生成脚本的机制(它做的事插件本来就能自己做)
|
|
4
21
|
|
|
5
22
|
- **删**:设置页里「需要你点一下的脚本(免管理员提权)」整块没了 —— 连带 `makeSetup` / `openSetup` / `setupResult` 三个动作、`SETUP_NEEDS`、`buildSetupSteps`、`writeSetupBundle`、`readSetupResult`、`readSetupPlan`、`setupState`、`openSetupFolder`、`setupPaths`、`dirWritable`、`needCatalog`、`applyPs1Source`、`setupCmdSource`、`setupUndoCmdSource`、`setupReadmeText`、`launcherBatLines`,以及面板里的「提权区」和它那排勾选框。服务端 `uiState().setup` 字段一并去掉;服务端旧版还带着 `setup` 时面板也不炸。
|
package/README.md
CHANGED
|
@@ -1,13 +1,13 @@
|
|
|
1
1
|
# dsh-napcat-keeper
|
|
2
2
|
|
|
3
|
-
发现没有能够随着 DSH 打开自动启动 NapCat 的插件,遂使用大肥鱼制作此插件,建议搭配[Yuuyuko-uu 的 dsh-qq-
|
|
3
|
+
发现没有能够随着 DSH 打开自动启动 NapCat 的插件,遂使用大肥鱼制作此插件,建议搭配[Yuuyuko-uu 的 dsh-qq-link](https://github.com/Yuuyuko-uu/dsh-qq-link)使用~
|
|
4
4
|
|
|
5
5
|
给 [NapCat](https://napneko.github.io/)(QQ 协议端)配一个看门狗:**DSH 在,QQ 就在**。
|
|
6
6
|
|
|
7
7
|
端口不通就拉起来,进程重复就杀掉多余的,卡在扫码就重来,扫完码以后又掉线也会自己恢复。
|
|
8
8
|
所有需要人填的东西都在 **DSH → 设置 → napcat桥** 一个页面里,保存即生效,不用重启。
|
|
9
9
|
|
|
10
|
-
> 常配套 `dsh-qq-
|
|
10
|
+
> 常配套 `dsh-qq-link`(把 QQ 和 DSH 会话接通):那个负责「说话」,这个负责「别掉线」。
|
|
11
11
|
> 也可以单独用——只要你想让 NapCat 一直活着。
|
|
12
12
|
|
|
13
13
|
|
|
@@ -26,33 +26,46 @@
|
|
|
26
26
|
| 拉到一半卡在扫码 | 记一笔 `need-scan`;超过 `scanTimeoutSec` 就杀掉重来,重试 `maxScanRetries` 次后放弃并写日志 |
|
|
27
27
|
| 有两条 QQ 进程链(客户端互踢的根源) | 按启动时间聚类判重,只杀晚出现的那几条,保留正在服务的那条 |
|
|
28
28
|
| 进程在、端口不通、也没有任何新信号 | 判为卡死,杀掉重来 |
|
|
29
|
-
| 一切正常 | 只记心跳(默认 10 分钟一行),并顺手检查 `dsh-qq-
|
|
29
|
+
| 一切正常 | 只记心跳(默认 10 分钟一行),并顺手检查 `dsh-qq-link` 的轮询是否还新鲜 |
|
|
30
30
|
|
|
31
31
|
看门狗自己不会把 DSH 启动搞崩:外部调用都有超时、异常都吞掉写日志、跨进程还有一把锁防止两个 DSH 实例同时拉。
|
|
32
32
|
|
|
33
33
|
## 前置:先把 NapCat 装好
|
|
34
34
|
|
|
35
|
-
|
|
36
|
-
2. 打开 NapCat 的 WebUI → **网络配置** → 加一个 **HTTP 服务器**:
|
|
37
|
-
- host `127.0.0.1`,port `3000`(或你喜欢的端口)
|
|
38
|
-
- 需要的话设一个 token,记下来
|
|
39
|
-
3. 手动跑一次、扫码登录一次(之后有登录缓存就不用再扫,缓存时限在几十分钟左右吧)。
|
|
35
|
+
装 [NapCat.Shell](https://github.com/NapNeko/NapCatQQ/releases)(Windows 有一键安装包,会顺带装 QQ)。
|
|
40
36
|
|
|
41
|
-
>
|
|
37
|
+
> 装完napcat之后不用自己配置,后面插件会一件懒人配置的
|
|
38
|
+
> 等正式允许要QQ扫码的时候不用再去翻 NapCat 的 `cache\qrcode.png`:插件自己起了个只监听本机的小页面
|
|
42
39
|
> (默认 **http://127.0.0.1:8899/**),设置页顶上那条黄横幅 / 二维码那一行的「打开扫码页」
|
|
43
40
|
> 点进去就是一张会自己刷新的码,扫完它自己变绿。换端口见下面配置表 `qrPanelPort`。
|
|
44
41
|
|
|
42
|
+
## Requirements
|
|
43
|
+
|
|
44
|
+
dsh-market 的索引会读这一段(标题必须是英文 `Requirements`,否则市场校验报 `README.md has no Requirements section`),内容照旧中文。
|
|
45
|
+
|
|
46
|
+
| 项 | 要求 | 清单字段 |
|
|
47
|
+
| --- | --- | --- |
|
|
48
|
+
| DSH 宿主 | `>= 0.2.1-rc.2`(本机实测 0.2.1-rc.3) | `engines.dsh` |
|
|
49
|
+
| Node.js | `>= 20`(插件零 npm 依赖,只用 Node 内置模块) | `engines.node` |
|
|
50
|
+
| 操作系统 | **Windows**(进程探测靠 `Get-CimInstance`、拉起与计划任务靠 `schtasks` / `cscript`) | — |
|
|
51
|
+
| NapCat | NapCat.Shell(Windows 一键包,自带 QQ 内核),装在 `D:\tool\napcat` 这类目录即可 | 设置页「路径前缀」 |
|
|
52
|
+
| 可选 | `dsh-qq-link`(负责把 QQ 与 DSH 会话接通;本插件只管让 NapCat 不掉线) | — |
|
|
53
|
+
|
|
45
54
|
## 安装
|
|
46
55
|
|
|
47
|
-
|
|
56
|
+
**DSH桌面版**:设置 → 插件 → **添加插件**,「包名或地址」那一栏只填包名 ——
|
|
48
57
|
|
|
49
58
|
```
|
|
50
59
|
dsh-napcat-keeper
|
|
51
60
|
```
|
|
61
|
+
或者填
|
|
62
|
+
```
|
|
63
|
+
github:waning-sun/dsh-napcat-keeper
|
|
64
|
+
```
|
|
52
65
|
|
|
53
66
|
> 只填包名,**别把整条命令粘进去**:那一栏是按「包名 / 仓库地址 / 本地目录」解析的,
|
|
54
67
|
> 多一个空格、多一个 `add`、多一个大写字母,就会报 `无法识别这个包名或地址:not a package name the registry accepts`。
|
|
55
|
-
>
|
|
68
|
+
> 顺带一提,桌面版刚装完之后 DSH 目录里并没有 `dsh` 命令,所以下面那条命令行不是人人都能跑 —— 用不了就走上面这条路。
|
|
56
69
|
|
|
57
70
|
**命令行**:
|
|
58
71
|
|
|
@@ -60,27 +73,24 @@ dsh-napcat-keeper
|
|
|
60
73
|
dsh plugin --profile <profile> add dsh-napcat-keeper
|
|
61
74
|
```
|
|
62
75
|
|
|
63
|
-
> **别加 `github:` 前缀。** 写成 `add github:waning-sun/dsh-napcat-keeper` 走的是 git 通道,pnpm 会去调外部 `git ls-remote`;
|
|
64
|
-
> 机器上没装 Git(或者 Git 不在 PATH 里)就当场报 `'git' is not recognized as an internal or external command`。
|
|
65
|
-
> 上面这条是 npm 名安装,全程不碰 git。真踩到了看「常见问题」里 `'git' is not recognized` 那条。
|
|
66
|
-
|
|
67
76
|
装完重启一次 DSH(第一次装载才生效),然后去 **设置 → napcat桥**。
|
|
68
77
|
|
|
69
78
|
## 首次配置:其实就三个空
|
|
70
79
|
|
|
71
80
|
| 填什么 | 说明 |
|
|
72
81
|
| --- | --- |
|
|
73
|
-
| **NapCat Shell 目录** |
|
|
82
|
+
| **NapCat Shell 目录** | 用「分盘扫描」找:NapCat 装哪块盘就点哪块,不知道装在哪里了就用扫全部盘(慢),扫到后点「用这个」直接填进去;也能手填,例如 `C:/Users/你/NapCat/OneKey/NapCat.Shell` |
|
|
74
83
|
| **要快登的 QQ 号** | 填了它,插件优先挑「填的这个号」的启动脚本;连脚本都没有时,自动生成一个直接调 `NapCatWinBootMain.exe <号>` 的脚本 |
|
|
75
84
|
| **OneBot HTTP 端口** | 跟 NapCat 网络配置里的 httpServers 一致(默认 3000) |
|
|
76
85
|
|
|
77
86
|
点 **保存设置** → 存到 `~/.dsh/dsh-napcat-keeper/config.json`,立刻热生效。
|
|
78
87
|
回「状态」看:在线会显示昵称和 QQ 号;离线就点「拉起 NapCat」。
|
|
79
88
|
|
|
89
|
+
---
|
|
90
|
+
|
|
80
91
|
## 分盘扫描:装在哪都能找到
|
|
81
92
|
|
|
82
|
-
从 2.2.2 起插件**不再自己猜** NapCat
|
|
83
|
-
设置页第一组是 **分盘扫描**,目录由你来选:
|
|
93
|
+
从 2.2.2 起插件**不再自己猜** NapCat 装在哪,设置页第一组是 **分盘扫描**,目录由你来选:
|
|
84
94
|
|
|
85
95
|
- 本机有几块盘就列几个按钮(盘符取自系统 `DriveInfo`,光驱、移动盘、上锁的卷都会列),点哪个扫哪个;
|
|
86
96
|
有「全部盘(慢)」;扫的时候可以点「停止」;插了新盘点「重新读盘」,不用重启 DSH。
|
|
@@ -90,8 +100,8 @@ dsh plugin --profile <profile> add dsh-napcat-keeper
|
|
|
90
100
|
命中后不再往它下面钻(QQ 目录里几千个文件,钻进去只会变慢)。
|
|
91
101
|
- **命中之后再分真假**:目录里只要有 `versions/`、`QQ.exe`、`napcat.mjs` 里的任意一样,就是**真 Shell**
|
|
92
102
|
(标绿 `✓ 像真 Shell:versions/ · QQ.exe`,按钮「用这个」);三样都没有的标黄
|
|
93
|
-
`⚠ 没看到 versions/QQ.exe/napcat.mjs
|
|
94
|
-
|
|
103
|
+
`⚠ 没看到 versions/QQ.exe/napcat.mjs 时`,按钮是「仍要用这个」。
|
|
104
|
+
这个判据只是经验,精简版布局有可能三样都不带(我自己重装了一遍 NapCat 就没这仨,不管了 bro),
|
|
95
105
|
所以「标黄」不等于「不能用」,点「仍要用这个」照样能填进去。
|
|
96
106
|
真 Shell 一律排在前面,不受磁盘遍历顺序影响。
|
|
97
107
|
- **为什么会有好几个候选**:OneKey 安装器会先把壳模板解到 `NapCat\OneKey\bootmain`(只有 `NapCatWinBootMain.exe`
|
|
@@ -116,17 +126,9 @@ dsh plugin --profile <profile> add dsh-napcat-keeper
|
|
|
116
126
|
| 收起黑框 | 把已经在跑的控制台窗口藏起来(不用重启 QQ) |
|
|
117
127
|
| 全部杀掉 | 只杀,不拉 |
|
|
118
128
|
|
|
119
|
-
##
|
|
120
|
-
|
|
121
|
-
插件自己全程普通权限,不做任何提权,也不再生成「让你去双击」的脚本(2.9.1 删掉了那套机制)。
|
|
122
|
-
唯一真正需要管理员的事是给 OneBot 端口开防火墙入站 —— 要放行时,自己开一个管理员 PowerShell 跑一次:
|
|
129
|
+
## 端口放行
|
|
123
130
|
|
|
124
|
-
|
|
125
|
-
New-NetFirewallRule -DisplayName "dsh-napcat-keeper OneBot" -Direction Inbound `
|
|
126
|
-
-Protocol TCP -LocalPort 3000 -Action Allow
|
|
127
|
-
```
|
|
128
|
-
|
|
129
|
-
不放行也能用:NapCat 和 DSH 都在本机,走 127.0.0.1 不需要防火墙规则;只有从别的机器连进来才需要。
|
|
131
|
+
(2.9.1 删掉了这套机制)插件自己全程普通权限,不做任何提权。
|
|
130
132
|
|
|
131
133
|
## 桌面上那个黑框
|
|
132
134
|
|
|
@@ -140,15 +142,15 @@ cscript / cmd 直接拉 NapCat,会多出一个控制台窗口挂在桌面上
|
|
|
140
142
|
## 记住密码:默认关,开了要自己认风险
|
|
141
143
|
|
|
142
144
|
NapCat 的**快速登录令牌会失效**(实测几小时左右),失效后启动脚本只会停在扫码,QQ 就一直离线,
|
|
143
|
-
`dsh-qq-
|
|
145
|
+
`dsh-qq-link` 那边则是刷屏的 `ECONNREFUSED 127.0.0.1:3000`。想让它自己能爬起来,就得给它密码。
|
|
144
146
|
|
|
145
147
|
设置页「自动登录(可不填)」里勾 **记住密码** 时会先弹一段风险提示,要你自己点「我知道风险,仍然开启」才会生效。开启前请确认你接受这几条:
|
|
146
148
|
|
|
147
149
|
1. 密码以**明文**存进 `~/.dsh/dsh-napcat-keeper/config.json` 和同目录下插件生成的 `env.bat`,不加密。
|
|
148
150
|
2. 任何能读你用户目录的程序都能捡走:同步盘、备份工具、其它软件、远控、临时借电脑的人。
|
|
149
151
|
3. QQ 密码往往和 QQ 邮箱、部分游戏、微信登录入口共用一套身份,泄漏面不止一个号。
|
|
150
|
-
4. 插件不打印密码,`/state` 也只回「存没存 +
|
|
151
|
-
5.
|
|
152
|
+
4. 插件不打印密码,`/state` 也只回「存没存 + 长度」,但那只是少了一个直接查看的口子,不等于安全。
|
|
153
|
+
5. 随时可以点「清除密码」,配置和 bat 里的密码会被删掉。
|
|
152
154
|
|
|
153
155
|
密码不写成命令行参数(`NapCatWinBootMain.exe <号> <密码>` 那样会进进程列表和 Windows 事件日志),
|
|
154
156
|
而是走环境变量 `NAPCAT_QUICK_PASSWORD` / `NAPCAT_QUICK_PASSWORD_MD5`,且只有本机 `127.0.0.1:3000` 回连时才注入。
|
|
@@ -160,7 +162,7 @@ QQ 那条进程链挂在本 DSH 实例下面——DSH 开着它就在,DSH 关
|
|
|
160
162
|
|
|
161
163
|
「刚重启 DSH,QQ 就掉了」不是毛病,是这个默认行为:新实例会自己重新拉起,扫不上就自动密码登录。
|
|
162
164
|
|
|
163
|
-
|
|
165
|
+
要是想要「DSH 关了 QQ 还活着」,才去填「计划任务名」那一栏(比如 `NapCat-Keeper-Launch`;**留空 = 走 cscript,跟着 DSH 生灭**)+ 勾「自动创建计划任务」,
|
|
164
166
|
那时插件改用 `schtasks /run` 拉,父进程是任务计划服务,DSH 重启牵连不到它。
|
|
165
167
|
|
|
166
168
|
## 用哪份 Node:默认借 DSH 自带的
|
|
@@ -226,9 +228,13 @@ NapCat 连 OneBot 有两条相反的路:
|
|
|
226
228
|
|
|
227
229
|
> 同一个端口没法既当 HTTP 接口又当反向 WS 服务 —— 谁先占着就听谁的。两样都想要,就给它们分两个端口。
|
|
228
230
|
|
|
229
|
-
### 装了 dsh-qq-
|
|
231
|
+
### 装了 dsh-qq-link 的,插件会替你把端口对一遍
|
|
232
|
+
|
|
233
|
+
`dsh-onebot-qq` 提供的是**接口**(端口由它开,NapCat 连进去);`dsh-qq-link` 是**客户端**(它反过来拿 HTTP 去连 NapCat,再把消息接到 QQ 聊天里)。两者对端口的要求正好相反。
|
|
230
234
|
|
|
231
|
-
|
|
235
|
+
> 上游 2026-11 把 `dsh-qq-bridge` 改名成了 `dsh-qq-link`。**只换了包名和仓库名**,插件内部还是老名字:
|
|
236
|
+
> 插件 id 仍是 `qq-bridge`、配置仍是 `~/.dsh/qq-bridge-config.json`、状态仍是 `~/.dsh/qq-bridge-state.json`、
|
|
237
|
+
> 路由仍是 `/dsh-qq-bridge/*`。本插件 2.9.2 起两个包名都认(新名优先),还没升级的机器照样认得出,设置页显示的是你实际装的那个。
|
|
232
238
|
|
|
233
239
|
本插件会顺手读桥接的配置(`~/.dsh/qq-bridge-config.json`,它的配置不在 profile 里、摊在 `~/.dsh` 根上),然后拿自己看到的实际情况跟它比一比,结论写在设置页「桥接插件」那行:
|
|
234
240
|
|
|
@@ -249,7 +255,7 @@ NapCat 连 OneBot 有两条相反的路:
|
|
|
249
255
|
|
|
250
256
|
| 工具 | 作用 |
|
|
251
257
|
| --- | --- |
|
|
252
|
-
| `napcat_status` | 端口/登录态、进程链、二维码副本路径、**扫码页地址(`qrPanel.url`,要扫码时发给用户点开)**、桥接心跳、日志尾部,以及两个共存插件的状态(`dsh-onebot-qq` 装了没/挂了没/端口模式/令牌一致不,`dsh-qq-
|
|
258
|
+
| `napcat_status` | 端口/登录态、进程链、二维码副本路径、**扫码页地址(`qrPanel.url`,要扫码时发给用户点开)**、桥接心跳、日志尾部,以及两个共存插件的状态(`dsh-onebot-qq` 装了没/挂了没/端口模式/令牌一致不,`dsh-qq-link` 装了没/挂了没/桥接端口对不对) |
|
|
253
259
|
| `napcat_restart` | 干净地杀掉整条链并重拉,然后等它上线 |
|
|
254
260
|
| `napcat_dedupe` | 只在真有重复链时才杀(没重复就什么都不做) |
|
|
255
261
|
|
|
@@ -284,10 +290,10 @@ NapCat 连 OneBot 有两条相反的路:
|
|
|
284
290
|
| `chainGapSec` | `120` | 重复链判定窗口 |
|
|
285
291
|
| `maxQqPerChain` | `4` | 单条链该有几条 `QQ.exe`,判重时的参考值 |
|
|
286
292
|
| `procPathMatch` | 空(由 shellDir 推两层) | 只在这个路径前缀下找 QQ/NapCat 进程 |
|
|
287
|
-
| `bridgeStaleSec` | `180` | `dsh-qq-
|
|
293
|
+
| `bridgeStaleSec` | `180` | `dsh-qq-link` 的 state 多久没更新就警告 |
|
|
288
294
|
| `maxLogBytes` | `1048576` | 日志超这么多字节就滚动一次 |
|
|
289
295
|
|
|
290
|
-
剩下几个是路径类字段(`configPath` / `logPath` / `launcherLog` / `lockPath` / `statePath` / `qrCopyPath` / `bridgeStatePath`),默认都落在 `~/.dsh/dsh-napcat-keeper/` 下(`bridgeStatePath` 例外,那是 `dsh-qq-
|
|
296
|
+
剩下几个是路径类字段(`configPath` / `logPath` / `launcherLog` / `lockPath` / `statePath` / `qrCopyPath` / `bridgeStatePath`),默认都落在 `~/.dsh/dsh-napcat-keeper/` 下(`bridgeStatePath` 例外,那是 `dsh-qq-link` 的文件,留在 `~/.dsh/` 根上),一般不用碰。
|
|
291
297
|
|
|
292
298
|
## 文件都在哪
|
|
293
299
|
|
|
@@ -309,11 +315,11 @@ NapCat 连 OneBot 有两条相反的路:
|
|
|
309
315
|
```
|
|
310
316
|
|
|
311
317
|
- 2.9.1 起目录里不再有 `setup/`(那套「生成 apply-admin.cmd 让你双击」的提权交接机制已整块删除,
|
|
312
|
-
旧版本留下的 `setup/`
|
|
318
|
+
旧版本留下的 `setup/` 目录是死文件,可以删掉)。
|
|
313
319
|
|
|
314
320
|
- `env.bat` 只在「记住密码」开启时才有;两份 `autogen*.bat` 只在需要时出现(每次拉起前按当前配置重写,删掉也会自己长回来)。整个目录删掉 = 插件回到没配置过的状态。
|
|
315
321
|
- **从老版本升上来(< 2.7.0)**:第一次启动会自动把原来散在 `~/.dsh` 根上的文件搬进这个目录(`napcat-keeper-config.json` → `config.json` 这种),改名一次就固定;计划任务里写死的旧路径也会一并改指新位置 —— 那一步用 `schtasks /change` 就地改,不结束正在跑的 QQ。老备份、以及搬不动的老文件(目标位已经有同名的那份、或者正被别的进程占着)都归到 `legacy/`,`~/.dsh` 根上不会留东西;实在被占着搬不动的,下次启动再搬一次。
|
|
316
|
-
- `~/.dsh/qq-bridge-state.json` **不在**这个目录里,也不归这个插件:它由 `dsh-qq-
|
|
322
|
+
- `~/.dsh/qq-bridge-state.json` **不在**这个目录里,也不归这个插件:它由 `dsh-qq-link` 写,插件只是读一下它的时间戳,判断那边轮询还活着没有。
|
|
317
323
|
|
|
318
324
|
## 出事了先跑体检:`npm run check`
|
|
319
325
|
|
|
@@ -332,7 +338,7 @@ npm run check:privacy # 只查隐私(发版前必跑)
|
|
|
332
338
|
|
|
333
339
|
**隐私体检**是发版前那道闸:把包里所有文本文件过一遍,找 Windows / Unix 家目录路径、邮箱、`ghp_` / `npm_` / `sk-` / `AKIA` 这类凭证、`Bearer` 后面的真串、DSH 会话 id,以及自测里那种 `launchAccount: '1234567890'` 的真实 QQ 号。命中就按 `文件:行` 列出来并返回非 0;确实是文档里必须留的示例,在那行末尾写 `check-privacy:ignore` 放过。占位写法(`C:/Users/你/…`、`C:/Users/x/…`)本来就放行。
|
|
334
340
|
|
|
335
|
-
另外几个自测,都不依赖本机路径,clone 下来就能跑:`npm run smoke:client`(把 `lib/client.js` 塞进假 React 渲染一遍)、`npm run selftest:scan`(造假树验扫盘判定)、`npm run selftest:save`(保存真的落到插件目录、误写的那份被认领回来)、`npm run selftest:probe`(本地起假服务器,验普通 HTTP / 反向 WS / 需要鉴权 / 端口没开四种判定)、`npm run selftest:companion`(造假 profile 与桥接配置,验 `dsh-onebot-qq` 的端口跟随和 `dsh-qq-
|
|
341
|
+
另外几个自测,都不依赖本机路径,clone 下来就能跑:`npm run smoke:client`(把 `lib/client.js` 塞进假 React 渲染一遍)、`npm run selftest:scan`(造假树验扫盘判定)、`npm run selftest:save`(保存真的落到插件目录、误写的那份被认领回来)、`npm run selftest:probe`(本地起假服务器,验普通 HTTP / 反向 WS / 需要鉴权 / 端口没开四种判定)、`npm run selftest:companion`(造假 profile 与桥接配置,验 `dsh-onebot-qq` 的端口跟随和 `dsh-qq-link` 的交叉结论)、`npm run selftest:layout`(验「进程」那行按安装形态换词、目录判形的 60 秒缓存,以及任务命令行两条路是否同一套模板)、`npm run selftest:qrpanel`(临时 DSH_HOME 里真起一次扫码页,验页面/状态/图片/未知路径/端口被占/关掉开关/换端口)。懒得一个个点就 `npm test`:清单体检 + 隐私体检 + 上面全部自测,一串跑完,红的就停。
|
|
336
342
|
|
|
337
343
|
> **改这个插件的文件的规矩**:别用 `Get-Content` 读、`Set-Content -Encoding utf8` 写 —— PowerShell 5.1 会按 ANSI 读、再按 UTF-8 写,一趟往返中文全变乱码,BOM 还照写。用编辑器另存为「UTF-8 无 BOM」;非要脚本写,就走
|
|
338
344
|
> `[IO.File]::WriteAllText($path, $text, (New-Object System.Text.UTF8Encoding($false)))`。
|
|
@@ -340,7 +346,7 @@ npm run check:privacy # 只查隐私(发版前必跑)
|
|
|
340
346
|
## 常见问题
|
|
341
347
|
|
|
342
348
|
**「离线」但进程明明还在?**
|
|
343
|
-
端口没通。看 `~/.dsh/dsh-napcat-keeper/launch.log`,多半是卡在扫码,或者 QQ
|
|
349
|
+
端口没通。看 `~/.dsh/dsh-napcat-keeper/launch.log`,多半是卡在扫码,或者 QQ 弹了验证窗,需要你手动登录那个 QQ 查看情况,到底是需要扫码,还是风险验证。
|
|
344
350
|
|
|
345
351
|
**设置页「进程」那行写着 `快登壳 0`,是不是一个进程都没有?**
|
|
346
352
|
不是。那行按你的安装形态换词,鼠标停上去有解释:
|
|
@@ -356,7 +362,7 @@ npm run check:privacy # 只查隐私(发版前必跑)
|
|
|
356
362
|
|
|
357
363
|
**刚关掉 DSH,QQ 就跟着退了?**
|
|
358
364
|
正常,默认就是这样:QQ 挂在 DSH 下面,DSH 一走它就走。下次开 DSH 会重新拉一条。
|
|
359
|
-
想反过来(DSH 关了 NapCat
|
|
365
|
+
想反过来(DSH 关了 NapCat 还活着)去填「计划任务名」(随便写,就是个名字)+ 勾「自动创建计划任务」。
|
|
360
366
|
|
|
361
367
|
**两个 QQ 客户端互相踢?**
|
|
362
368
|
去重会兜住,但根因通常是有人又点了一次 `napcat.bat`。点「去重复链」立刻收敛。
|
package/lib/client.js
CHANGED
|
@@ -194,10 +194,10 @@ window.__ModuleLoader__.load({
|
|
|
194
194
|
return 'dsh-onebot-qq ' + String(c.version) + ' · ' + 状态 + ' · ' + 模式 + 令牌
|
|
195
195
|
}
|
|
196
196
|
|
|
197
|
-
/** 「桥接插件」那行:dsh-qq-
|
|
197
|
+
/** 「桥接插件」那行:dsh-qq-link 装没装、挂没挂、它连的端口对不对 */
|
|
198
198
|
function 桥接描述(runtime) {
|
|
199
199
|
const b = runtime && runtime.bridgePlugin
|
|
200
|
-
if (!b || !b.version) return '没检测到 dsh-qq-
|
|
200
|
+
if (!b || !b.version) return '没检测到 dsh-qq-link(不装也不影响;装了它就会显示在这里)'
|
|
201
201
|
const 状态 = b.mounted ? '已启用' : '已安装但没挂进 profile'
|
|
202
202
|
const 开关 = !b.configKnown ? '没读到配置' : !b.enabled ? '总开关关着' : b.dryRun ? '试运行中' : '在发'
|
|
203
203
|
const 问题 =
|
|
@@ -206,7 +206,9 @@ window.__ModuleLoader__.load({
|
|
|
206
206
|
: b.check === 'port-mismatch'
|
|
207
207
|
? ' · ⚠ 端口和 NapCat 对不上'
|
|
208
208
|
: ''
|
|
209
|
-
|
|
209
|
+
// 报实际装的那个包名:还没升级到 dsh-qq-link 的机器会显示老名 dsh-qq-bridge
|
|
210
|
+
const 包名 = String(b.packageName || 'dsh-qq-link')
|
|
211
|
+
return 包名 + ' ' + String(b.version) + ' · ' + 状态 + ' · ' + 开关 + ' · 连 ' + String(b.napcatUrl || '') + 问题
|
|
210
212
|
}
|
|
211
213
|
|
|
212
214
|
/**
|
|
@@ -670,7 +672,7 @@ window.__ModuleLoader__.load({
|
|
|
670
672
|
'任何能读你这个用户目录的东西都能直接捡走:同步盘、备份工具、其它软件、远控木马、临时借你电脑的人。',
|
|
671
673
|
'QQ 密码通常和 QQ 邮箱、部分游戏、微信的登录入口共用一套身份,泄漏的影响面不止这一个号。',
|
|
672
674
|
'插件本身不打印密码、/state 接口也只回「存没存」和长度,但那只是少开一个泄漏口,不等于安全。',
|
|
673
|
-
'不开的代价:快速登录令牌会失效(实测几小时到几天),失效后就只能手机扫码,否则 QQ 离线,dsh-qq-
|
|
675
|
+
'不开的代价:快速登录令牌会失效(实测几小时到几天),失效后就只能手机扫码,否则 QQ 离线,dsh-qq-link 会一路报 ECONNREFUSED。',
|
|
674
676
|
'想收回:随时点下面「清除密码」,配置文件和这个 bat 里的密码都会被删掉;已经跑起来的进程环境只活到那次进程结束。',
|
|
675
677
|
]
|
|
676
678
|
|
package/lib/index.js
CHANGED
|
@@ -1,8 +1,15 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* dsh-napcat-keeper —— NapCat 看门狗 v2.9.
|
|
2
|
+
* dsh-napcat-keeper —— NapCat 看门狗 v2.9.2(可发布通用版)
|
|
3
3
|
*
|
|
4
4
|
* 解决的问题:DSH 是桌面应用,重启 DSH 时 NapCat(QQ 协议端) 不会跟着起来,
|
|
5
|
-
* 于是 dsh-qq-
|
|
5
|
+
* 于是 dsh-qq-link 一直轮询一个死端口,你在 QQ 里说的话就石沉大海。
|
|
6
|
+
*
|
|
7
|
+
* v2.9.2:跟着上游改名 —— 桥接插件 dsh-qq-bridge 已更名为 **dsh-qq-link**
|
|
8
|
+
* - 包名/仓库名换了,插件内部 id(`qq-bridge`)、配置 `~/.dsh/qq-bridge-config.json`、
|
|
9
|
+
* 状态 `~/.dsh/qq-bridge-state.json`、路由前缀 `/dsh-qq-bridge/*` 全都没变(实测 1.5.1);
|
|
10
|
+
* - 所以只改「认哪个包」:BRIDGE_PACKAGES = ['dsh-qq-link', 'dsh-qq-bridge'],
|
|
11
|
+
* 新名优先、老名兜底(还没升级的机器仍认得出),界面与文档统一说 dsh-qq-link;
|
|
12
|
+
* - 桥接行显示的是实际装的那个包名(bridgePublic.packageName),不是硬编码文案。
|
|
6
13
|
*
|
|
7
14
|
* v2.8.2:「进程」那行按安装形态说人话 + 清一处重复模板
|
|
8
15
|
* - node 型(无头 Shell)装法里 QQ 本体跑在 node.exe 里,机器上没有 QQ.exe 也没有快登壳,
|
|
@@ -18,7 +25,7 @@
|
|
|
18
25
|
* 得出「装没装 / 挂没挂 / 反向还是正向 / 监听哪个端口 / 令牌配没配」;
|
|
19
26
|
* 你填的端口不通、它确实挂着反向 WS 时自动跟随(companionFollow,默认开),
|
|
20
27
|
* 你填的端口一通就绝不插手;没挂进 profile 或它是正向模式则不跟,并说明为什么;
|
|
21
|
-
* - 读 dsh-qq-
|
|
28
|
+
* - 读 dsh-qq-link 的 ~/.dsh/qq-bridge-config.json,把它填的 NapCat 地址与本插件
|
|
22
29
|
* 看到的实际情况交叉比对,五种结论(没挂载 / 连了反向 WS 端口 / 端口对不上 /
|
|
23
30
|
* 总开关关着 / 试运行中)写进设置页「桥接插件」行与 napcat_status;只看配置,
|
|
24
31
|
* 不碰它的进程和文件;
|
|
@@ -63,7 +70,7 @@
|
|
|
63
70
|
* - 老版本升级时 migrateLegacyFiles() 自动搬一次(能 rename 就 rename),
|
|
64
71
|
* 遗留的 *.bak、旧备份目录挪进 legacy/ 留档;计划任务里写死的旧路径由
|
|
65
72
|
* repairTaskActions() 用 /change 改指新位置,不 /end、不打扰正在跑的 QQ;
|
|
66
|
-
* - qq-bridge-state.json 不搬:那是 dsh-qq-
|
|
73
|
+
* - qq-bridge-state.json 不搬:那是 dsh-qq-link 的文件,只是被读一下。
|
|
67
74
|
*
|
|
68
75
|
* v2.6.0:清死代码 + README 与代码对齐(行为一字没变)
|
|
69
76
|
* - 删掉 v2.2.2 起就没人再调用的目录自动探测三件套(looksLikeShellDir / findShellDirs /
|
|
@@ -171,7 +178,7 @@ import { homedir, tmpdir } from 'node:os'
|
|
|
171
178
|
import path from 'node:path'
|
|
172
179
|
|
|
173
180
|
export const name = 'napcat-keeper'
|
|
174
|
-
export const version = '2.9.
|
|
181
|
+
export const version = '2.9.3'
|
|
175
182
|
|
|
176
183
|
/** tools 用来注册 napcat_* 工具;webServer 用来挂设置界面接口。拿不到也不至于把 DSH 拖崩。 */
|
|
177
184
|
export const inject = ['tools', 'webServer']
|
|
@@ -879,7 +886,7 @@ function resolveConfig(raw) {
|
|
|
879
886
|
if (!cfg.lockPath) cfg.lockPath = path.join(dir, 'lock.json')
|
|
880
887
|
if (!cfg.statePath) cfg.statePath = path.join(dir, 'state.json')
|
|
881
888
|
if (!cfg.qrCopyPath) cfg.qrCopyPath = path.join(dir, 'qr.png')
|
|
882
|
-
// qq-bridge-state.json 是 dsh-qq-
|
|
889
|
+
// qq-bridge-state.json 是 dsh-qq-link 写的,不归我们管,留在 ~/.dsh 根上
|
|
883
890
|
if (!cfg.bridgeStatePath) cfg.bridgeStatePath = path.join(home, 'qq-bridge-state.json')
|
|
884
891
|
if (!cfg.configPath) cfg.configPath = configFilePath(dir)
|
|
885
892
|
return cfg
|
|
@@ -1145,7 +1152,7 @@ function parseCompanionConfig(text) {
|
|
|
1145
1152
|
/**
|
|
1146
1153
|
* 扫一遍 `~/.dsh/profiles/*`,找出「装了这个包」的 profile。
|
|
1147
1154
|
*
|
|
1148
|
-
* 两个共存插件(dsh-onebot-qq / dsh-qq-
|
|
1155
|
+
* 两个共存插件(dsh-onebot-qq / dsh-qq-link)用的是同一套判断:
|
|
1149
1156
|
* - 装了 = 它的 package.json 在 node_modules 里,或者写在 profile 的 dependencies 里;
|
|
1150
1157
|
* - 挂了 = 出现在 `dsh.profile.bundles` 里,或者被 `cordis.patch.yml` / `cordis.yml`
|
|
1151
1158
|
* 单独 insert 过(认 `id: xxx`)。只装在 dependencies 里而没进 bundles 的,DSH 不会加载它,
|
|
@@ -1285,18 +1292,44 @@ function companionTokenMatch(cfg, comp) {
|
|
|
1285
1292
|
}
|
|
1286
1293
|
|
|
1287
1294
|
/* ------------------------------------------------------------------ *
|
|
1288
|
-
* 第二个共存插件:dsh-qq-
|
|
1295
|
+
* 第二个共存插件:dsh-qq-link(把 NapCat 的消息接到 QQ 聊天里)
|
|
1289
1296
|
*
|
|
1290
1297
|
* 它和 dsh-onebot-qq 是两种东西:onebot 提供「接口」,qq-bridge 是「客户端」——
|
|
1291
1298
|
* 它拿 HTTP/WS 去连 NapCat,所以两边端口必须对上,对不上就静默不工作。
|
|
1292
1299
|
* 它的配置不在 profile 里,摊在 ~/.dsh/qq-bridge-config.json(中文键名)。
|
|
1293
1300
|
* ------------------------------------------------------------------ */
|
|
1294
1301
|
|
|
1295
|
-
|
|
1302
|
+
/**
|
|
1303
|
+
* 认哪个包?上游 2026-11 把 `dsh-qq-link` 更名成 `dsh-qq-link`,但**插件内部一个字没改**:
|
|
1304
|
+
* `export const name = 'qq-bridge'`、配置 `~/.dsh/qq-bridge-config.json`、
|
|
1305
|
+
* 状态 `~/.dsh/qq-bridge-state.json`、路由前缀 `/dsh-qq-bridge/*`。
|
|
1306
|
+
* 所以这里只换「包名」,别把 id 和文件名一起换掉 —— 换了就永远认不到。
|
|
1307
|
+
*
|
|
1308
|
+
* 新名排前面、老名兜底:还没升级的机器装着 `dsh-qq-bridge` 也照样认得出。
|
|
1309
|
+
*/
|
|
1310
|
+
const BRIDGE_PACKAGES = ['dsh-qq-link', 'dsh-qq-bridge']
|
|
1311
|
+
const BRIDGE_PACKAGE = BRIDGE_PACKAGES[0]
|
|
1296
1312
|
const BRIDGE_ID = 'qq-bridge'
|
|
1297
1313
|
const BRIDGE_DEFAULTS = { napcat: 'http://127.0.0.1:3000', enabled: false, dryRun: true }
|
|
1298
1314
|
const bridgeCache = { at: 0, value: null }
|
|
1299
1315
|
|
|
1316
|
+
/**
|
|
1317
|
+
* 把两个包名的探测结果并起来(一个 profile 只留一条,新名优先)。
|
|
1318
|
+
* 正常机器只会命中一个;同时装了新旧两代的,说新名那个。
|
|
1319
|
+
*/
|
|
1320
|
+
function bridgeHits() {
|
|
1321
|
+
const seen = new Map()
|
|
1322
|
+
for (const pkg of BRIDGE_PACKAGES) {
|
|
1323
|
+
for (const hit of profileHits(pkg, BRIDGE_ID)) {
|
|
1324
|
+
if (!seen.has(hit.dir)) seen.set(hit.dir, { ...hit, pkg })
|
|
1325
|
+
}
|
|
1326
|
+
}
|
|
1327
|
+
const current = path.join(dshHome(), 'profiles', 'desktop')
|
|
1328
|
+
return [...seen.values()].sort((a, b) =>
|
|
1329
|
+
a.dir === current ? -1 : b.dir === current ? 1 : String(a.profile).localeCompare(String(b.profile)),
|
|
1330
|
+
)
|
|
1331
|
+
}
|
|
1332
|
+
|
|
1300
1333
|
/** 从 OneBot 地址里抠端口(认不出就 0,不要瞎猜) */
|
|
1301
1334
|
function urlPort(raw) {
|
|
1302
1335
|
try {
|
|
@@ -1323,7 +1356,7 @@ function detectBridge(options = {}) {
|
|
|
1323
1356
|
: 20000
|
|
1324
1357
|
if (!force && bridgeCache.value && Date.now() - bridgeCache.at < maxAgeMs) return bridgeCache.value
|
|
1325
1358
|
|
|
1326
|
-
const hits =
|
|
1359
|
+
const hits = bridgeHits()
|
|
1327
1360
|
const top = hits.find((h) => h.mounted) || hits[0] || null
|
|
1328
1361
|
const rc = readBridgeConfig()
|
|
1329
1362
|
const cfg = rc.cfg || {}
|
|
@@ -1331,6 +1364,7 @@ function detectBridge(options = {}) {
|
|
|
1331
1364
|
|
|
1332
1365
|
const result = {
|
|
1333
1366
|
found: Boolean(top),
|
|
1367
|
+
packageName: String((top && top.pkg) || BRIDGE_PACKAGE),
|
|
1334
1368
|
packageVersion: String((top && top.version) || ''),
|
|
1335
1369
|
profile: String((top && top.profile) || ''),
|
|
1336
1370
|
mounted: Boolean(top && top.mounted),
|
|
@@ -1342,7 +1376,7 @@ function detectBridge(options = {}) {
|
|
|
1342
1376
|
napcatPort: urlPort(napcatUrl),
|
|
1343
1377
|
tokenKnown: rc.known ? String(cfg.令牌 || '').trim() !== '' : false,
|
|
1344
1378
|
bindings: rc.known && Array.isArray(cfg.绑定) ? cfg.绑定.length : 0,
|
|
1345
|
-
candidates: hits.map((h) => ({ profile: h.profile, mounted: h.mounted, version: h.version })),
|
|
1379
|
+
candidates: hits.map((h) => ({ profile: h.profile, packageName: h.pkg, mounted: h.mounted, version: h.version })),
|
|
1346
1380
|
}
|
|
1347
1381
|
bridgeCache.at = Date.now()
|
|
1348
1382
|
bridgeCache.value = result
|
|
@@ -1353,6 +1387,7 @@ function detectBridge(options = {}) {
|
|
|
1353
1387
|
function bridgePublic(bridge) {
|
|
1354
1388
|
if (!bridge || !bridge.found) return null
|
|
1355
1389
|
return {
|
|
1390
|
+
packageName: bridge.packageName,
|
|
1356
1391
|
version: bridge.packageVersion,
|
|
1357
1392
|
profile: bridge.profile,
|
|
1358
1393
|
mounted: bridge.mounted,
|
|
@@ -1385,19 +1420,19 @@ function bridgeCheck(health, bridge) {
|
|
|
1385
1420
|
let note = ''
|
|
1386
1421
|
if (!bridge.mounted) {
|
|
1387
1422
|
state = 'not-mounted'
|
|
1388
|
-
note = 'dsh-qq-
|
|
1423
|
+
note = 'dsh-qq-link 装了但没挂进 profile(bundles 里没有它、patch 也没 insert),桥接不会跑'
|
|
1389
1424
|
} else if (reverse && bp && portUsed && bp === portUsed) {
|
|
1390
1425
|
state = 'bridge-hits-reverse'
|
|
1391
|
-
note = `dsh-qq-
|
|
1426
|
+
note = `dsh-qq-link 连的是 ${bridge.napcatUrl},而那个端口现在是反向 WebSocket(只收 WebSocket 握手)—— 桥接用 HTTP 敲它就是 426/401。让它改连 NapCat 自己 httpServers 的端口`
|
|
1392
1427
|
} else if (!reverse && bp && portUsed && bp !== portUsed) {
|
|
1393
1428
|
state = 'port-mismatch'
|
|
1394
|
-
note = `dsh-qq-
|
|
1429
|
+
note = `dsh-qq-link 连的是 ${bridge.napcatUrl}(端口 ${bp}),NapCat 的 OneBot 接口在 ${portUsed} —— 两边对不上,消息发不出去`
|
|
1395
1430
|
} else if (bridge.configKnown && !bridge.enabled) {
|
|
1396
1431
|
state = 'disabled'
|
|
1397
|
-
note = 'dsh-qq-
|
|
1432
|
+
note = 'dsh-qq-link 的「总开关」是关的:它在跑,但一句都不会发'
|
|
1398
1433
|
} else if (bridge.configKnown && bridge.dryRun) {
|
|
1399
1434
|
state = 'dry-run'
|
|
1400
|
-
note = 'dsh-qq-
|
|
1435
|
+
note = 'dsh-qq-link 开着「试运行」:只记账,不真发到 QQ'
|
|
1401
1436
|
}
|
|
1402
1437
|
return { state, note, bridgePort: bp, portUsed, reverse }
|
|
1403
1438
|
}
|
|
@@ -1554,7 +1589,7 @@ async function probe(cfg, options = {}) {
|
|
|
1554
1589
|
? options.companion
|
|
1555
1590
|
: detectCompanion()
|
|
1556
1591
|
const tokenMatch = companionTokenMatch(cfg, comp)
|
|
1557
|
-
// 桥接(dsh-qq-
|
|
1592
|
+
// 桥接(dsh-qq-link)只是「顺便看一眼」,不参与「探哪个端口」的决策,所以可以注入桩
|
|
1558
1593
|
const bridge =
|
|
1559
1594
|
options && Object.prototype.hasOwnProperty.call(options, 'bridge') ? options.bridge : detectBridge()
|
|
1560
1595
|
const wrap = (health, extra = {}) => {
|
|
@@ -2949,7 +2984,7 @@ function registerTools(ctx, cfg) {
|
|
|
2949
2984
|
defineTool({
|
|
2950
2985
|
name: 'napcat_status',
|
|
2951
2986
|
description:
|
|
2952
|
-
'看 NapCat(QQ) 看门狗此刻的状态:OneBot 是否在线、登录的是哪个号、进程链数量(有无重复链)、二维码是否在等人扫(含副本路径)、dsh-qq-
|
|
2987
|
+
'看 NapCat(QQ) 看门狗此刻的状态:OneBot 是否在线、登录的是哪个号、进程链数量(有无重复链)、二维码是否在等人扫(含副本路径)、dsh-qq-link 的轮询有多久没更新、这次用的是哪份 Node 运行时(DSH 自带 / 系统 / 手填),以及最近看门狗日志。',
|
|
2953
2988
|
parameters: {},
|
|
2954
2989
|
output: { schema: { type: 'string' }, render: (_args, value) => renderText(value) },
|
|
2955
2990
|
async execute() {
|
|
@@ -2991,7 +3026,7 @@ function registerTools(ctx, cfg) {
|
|
|
2991
3026
|
tokenMatches:
|
|
2992
3027
|
health.companionTokenMatch === undefined ? null : health.companionTokenMatch,
|
|
2993
3028
|
},
|
|
2994
|
-
/** dsh-qq-
|
|
3029
|
+
/** dsh-qq-link:装没装、挂没挂、桥接指向的端口和 NapCat 对不上没有 */
|
|
2995
3030
|
bridge: health.bridge || bridgePublic(detectBridge()) || { found: false },
|
|
2996
3031
|
},
|
|
2997
3032
|
procs,
|
|
@@ -3032,7 +3067,7 @@ function registerTools(ctx, cfg) {
|
|
|
3032
3067
|
},
|
|
3033
3068
|
logTail: tail,
|
|
3034
3069
|
note: health.online
|
|
3035
|
-
? '在线。若 QQ 里还是没回音,问题在 dsh-qq-
|
|
3070
|
+
? '在线。若 QQ 里还是没回音,问题在 dsh-qq-link 那一侧(绑定/试运行开关)。'
|
|
3036
3071
|
: health.mode === 'reverse'
|
|
3037
3072
|
? health.clients === null
|
|
3038
3073
|
? '反向 WebSocket 模式:端口是反向 WS 服务在听(HTTP 问不出在线),客户端数还查不到——按在线处理,不会重启。'
|
|
@@ -3822,7 +3857,7 @@ async function uiState(cfg, options = {}) {
|
|
|
3822
3857
|
/** 设置页「跟随 dsh-onebot-qq」那一行显不显示,就看它(装了且挂进 profile) */
|
|
3823
3858
|
companionReady: Boolean(cfg.companionReady),
|
|
3824
3859
|
companionTokenMatch: health.companionTokenMatch === undefined ? null : health.companionTokenMatch,
|
|
3825
|
-
/** dsh-qq-
|
|
3860
|
+
/** dsh-qq-link 的共存情况(键名避开下面表示心跳新鲜度的 bridge) */
|
|
3826
3861
|
bridgePlugin: health.bridge || bridgePublic(detectBridge()),
|
|
3827
3862
|
clients: health.clients,
|
|
3828
3863
|
hint: health.hint || '',
|
|
@@ -4208,7 +4243,7 @@ export const __internals = {
|
|
|
4208
4243
|
probeOnPort,
|
|
4209
4244
|
COMPANION_DEFAULTS,
|
|
4210
4245
|
COMPANION_PACKAGE,
|
|
4211
|
-
// 与 dsh-qq-
|
|
4246
|
+
// 与 dsh-qq-link 共存:它是「客户端」,配置摊在 ~/.dsh/qq-bridge-config.json
|
|
4212
4247
|
profileHits,
|
|
4213
4248
|
detectBridge,
|
|
4214
4249
|
bridgePublic,
|
|
@@ -4216,8 +4251,10 @@ export const __internals = {
|
|
|
4216
4251
|
readBridgeConfig,
|
|
4217
4252
|
urlPort,
|
|
4218
4253
|
BRIDGE_DEFAULTS,
|
|
4254
|
+
BRIDGE_PACKAGES,
|
|
4219
4255
|
BRIDGE_PACKAGE,
|
|
4220
4256
|
BRIDGE_ID,
|
|
4257
|
+
bridgeHits,
|
|
4221
4258
|
qrInfo,
|
|
4222
4259
|
bridgeAge,
|
|
4223
4260
|
launchNapcat,
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "dsh-napcat-keeper",
|
|
3
|
-
"version": "2.9.
|
|
4
|
-
"description": "发现没有能够随着dsh打开自动启动napcat的插件,遂使用大肥鱼制作此插件,建议搭配Yuuyuko-uu的dsh-qq-
|
|
3
|
+
"version": "2.9.3",
|
|
4
|
+
"description": "发现没有能够随着dsh打开自动启动napcat的插件,遂使用大肥鱼制作此插件,建议搭配Yuuyuko-uu的dsh-qq-link使用~",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "lib/index.js",
|
|
7
7
|
"exports": {
|
|
@@ -38,7 +38,7 @@
|
|
|
38
38
|
"onebot",
|
|
39
39
|
"qq",
|
|
40
40
|
"watchdog",
|
|
41
|
-
"dsh-qq-
|
|
41
|
+
"dsh-qq-link"
|
|
42
42
|
],
|
|
43
43
|
"author": "熙的大肥鱼",
|
|
44
44
|
"license": "MIT",
|
|
@@ -57,7 +57,8 @@
|
|
|
57
57
|
}
|
|
58
58
|
},
|
|
59
59
|
"engines": {
|
|
60
|
-
"node": ">=20"
|
|
60
|
+
"node": ">=20",
|
|
61
|
+
"dsh": ">=0.2.1-rc.2"
|
|
61
62
|
},
|
|
62
63
|
"dshTarget": "0.2.1-rc.2",
|
|
63
64
|
"publishConfig": {
|
|
@@ -296,6 +296,23 @@ if (pkg) {
|
|
|
296
296
|
else if (m[1] !== pkg.version) fail(`版本不同步:package.json=${pkg.version},${entry}=${m[1]}`);
|
|
297
297
|
else ok(`版本同步:${pkg.version}`);
|
|
298
298
|
}
|
|
299
|
+
|
|
300
|
+
// 市场索引(dsh-market)专用:这两项缺了,市场页会标红,用户看不出宿主要求
|
|
301
|
+
const dsEngine = pkg.engines?.dsh;
|
|
302
|
+
if (typeof dsEngine === 'string' && dsEngine.trim()) ok(`engines.dsh = ${dsEngine}`);
|
|
303
|
+
else fail('package.json 缺 engines.dsh —— dsh-market 索引无法标出宿主版本要求(engines.dsh is missing)');
|
|
304
|
+
|
|
305
|
+
const readmePath = join(ROOT, 'README.md');
|
|
306
|
+
if (!existsSync(readmePath)) {
|
|
307
|
+
fail('README.md 不存在 —— 市场页没有可读的说明');
|
|
308
|
+
} else {
|
|
309
|
+
const readme = readFileSync(readmePath, 'utf8');
|
|
310
|
+
if (/^##\s+Requirements\s*$/m.test(readme)) {
|
|
311
|
+
ok('README.md 有英文标题的 ## Requirements 段(市场索引能解析宿主要求)');
|
|
312
|
+
} else {
|
|
313
|
+
fail('README.md 没有英文标题的 ## Requirements 段 —— dsh-market 会报 README.md has no Requirements section');
|
|
314
|
+
}
|
|
315
|
+
}
|
|
299
316
|
}
|
|
300
317
|
|
|
301
318
|
// ── 3. 全目录扫 BOM / 非法 UTF-8 / 双重编码 ────────────────────────────────
|
|
@@ -42,7 +42,7 @@ const {
|
|
|
42
42
|
probe,
|
|
43
43
|
normalizeConfig,
|
|
44
44
|
COMPANION_DEFAULTS,
|
|
45
|
-
// dsh-qq-
|
|
45
|
+
// dsh-qq-link 那一套
|
|
46
46
|
detectBridge,
|
|
47
47
|
bridgePublic,
|
|
48
48
|
bridgeCheck,
|
|
@@ -50,6 +50,8 @@ const {
|
|
|
50
50
|
urlPort,
|
|
51
51
|
BRIDGE_DEFAULTS,
|
|
52
52
|
BRIDGE_PACKAGE,
|
|
53
|
+
BRIDGE_PACKAGES,
|
|
54
|
+
bridgeHits,
|
|
53
55
|
profileHits,
|
|
54
56
|
} = await loadInternals()
|
|
55
57
|
|
|
@@ -364,8 +366,8 @@ console.log('\n5b) 跟随开关:装没装 / 启没启用 决定显不显示、
|
|
|
364
366
|
setStored({})
|
|
365
367
|
}
|
|
366
368
|
|
|
367
|
-
/* 6. dsh-qq-
|
|
368
|
-
console.log('\n6) dsh-qq-
|
|
369
|
+
/* 6. dsh-qq-link 也认得出 -------------------------------------------- */
|
|
370
|
+
console.log('\n6) dsh-qq-link:装没装、挂没挂、桥接指向哪')
|
|
369
371
|
{
|
|
370
372
|
// 清场:前面几组造的 profile 全删掉,这一组只看自己造的
|
|
371
373
|
for (const name of ['alpha', 'beta', 'gamma', 'delta', 'desktop']) {
|
|
@@ -386,8 +388,8 @@ console.log('\n6) dsh-qq-bridge:装没装、挂没挂、桥接指向哪')
|
|
|
386
388
|
|
|
387
389
|
// 6b. 装了 + 在 bundles 里 + 配置文件齐全
|
|
388
390
|
mkProfile('desktop', {
|
|
389
|
-
deps: { 'dsh-qq-
|
|
390
|
-
bundles: ['dsh-napcat-keeper', 'dsh-qq-
|
|
391
|
+
deps: { 'dsh-qq-link': '^1.0.7' },
|
|
392
|
+
bundles: ['dsh-napcat-keeper', 'dsh-qq-link'],
|
|
391
393
|
patch: 'plugins: []\n',
|
|
392
394
|
})
|
|
393
395
|
dropPkg('desktop', BRIDGE_PACKAGE, '1.0.7')
|
|
@@ -398,6 +400,8 @@ console.log('\n6) dsh-qq-bridge:装没装、挂没挂、桥接指向哪')
|
|
|
398
400
|
b = detectBridge({ force: true })
|
|
399
401
|
ok(b.found === true && b.mounted === true, '装了且在 bundles 里 → 已挂载', JSON.stringify({ found: b.found, mounted: b.mounted }))
|
|
400
402
|
ok(b.packageVersion === '1.0.7', '读到它的版本号', String(b.packageVersion))
|
|
403
|
+
ok(b.packageName === 'dsh-qq-link', '报的是新包名 dsh-qq-link', String(b.packageName))
|
|
404
|
+
ok(bridgePublic(b).packageName === 'dsh-qq-link', '对外也带 packageName(界面照着显示)', String(bridgePublic(b).packageName))
|
|
401
405
|
ok(readBridgeConfig().known === true, '读得到 ~/.dsh/qq-bridge-config.json(摊在根上,不在 profile 里)')
|
|
402
406
|
ok(b.napcatPort === 4000, '桥接指向 4000', String(b.napcatPort))
|
|
403
407
|
ok(b.enabled === true && b.dryRun === false, '总开关开、试运行关', JSON.stringify({ enabled: b.enabled, dryRun: b.dryRun }))
|
|
@@ -435,7 +439,7 @@ console.log('\n6) dsh-qq-bridge:装没装、挂没挂、桥接指向哪')
|
|
|
435
439
|
ok(bridgeCheck({ mode: 'http', portUsed: 3000 }, b).state === 'dry-run', '试运行 → dry-run')
|
|
436
440
|
|
|
437
441
|
// 6h. 装了但没挂进 profile:先报没挂,别先去怪端口
|
|
438
|
-
mkProfile('beta', { deps: { 'dsh-qq-
|
|
442
|
+
mkProfile('beta', { deps: { 'dsh-qq-link': '^1.0.7' }, bundles: ['dsh-napcat-keeper'], patch: 'plugins: []\n' })
|
|
439
443
|
dropPkg('beta', BRIDGE_PACKAGE, '1.0.7')
|
|
440
444
|
fs.rmSync(path.join(HOME, 'profiles', 'desktop'), { recursive: true, force: true })
|
|
441
445
|
b = detectBridge({ force: true })
|
|
@@ -481,6 +485,21 @@ console.log('\n6) dsh-qq-bridge:装没装、挂没挂、桥接指向哪')
|
|
|
481
485
|
)
|
|
482
486
|
ok(Boolean(health.bridge && health.bridge.note), '而且带一句人话提示')
|
|
483
487
|
await srv2.close()
|
|
488
|
+
|
|
489
|
+
// 6k. 老包名 dsh-qq-bridge(还没升级的机器)照样认得出
|
|
490
|
+
// 上游 2026-11 才改名,真实机器上很可能还躺着老包;认不到就等于「说得像没装」。
|
|
491
|
+
fs.rmSync(path.join(HOME, 'profiles', 'beta'), { recursive: true, force: true })
|
|
492
|
+
mkProfile('gamma', {
|
|
493
|
+
deps: { 'dsh-qq-bridge': '^1.0.7' },
|
|
494
|
+
bundles: ['dsh-napcat-keeper', 'dsh-qq-bridge'],
|
|
495
|
+
patch: 'plugins: []\n',
|
|
496
|
+
})
|
|
497
|
+
dropPkg('gamma', 'dsh-qq-bridge', '1.0.7')
|
|
498
|
+
const legacy = detectBridge({ force: true })
|
|
499
|
+
ok(legacy.found === true && legacy.mounted === true, '只装了老包 → 仍认得出且算已挂载', JSON.stringify({ found: legacy.found, mounted: legacy.mounted }))
|
|
500
|
+
ok(legacy.packageName === 'dsh-qq-bridge', '这时 packageName 如实报老名', String(legacy.packageName))
|
|
501
|
+
ok(BRIDGE_PACKAGES[0] === 'dsh-qq-link' && BRIDGE_PACKAGES.includes('dsh-qq-bridge'), '两个包名都在候选里、新名优先', JSON.stringify(BRIDGE_PACKAGES))
|
|
502
|
+
ok(bridgeHits().some((h) => h.pkg === 'dsh-qq-bridge'), 'bridgeHits 把老包也扫进来了', JSON.stringify(bridgeHits().map((h) => h.pkg)))
|
|
484
503
|
}
|
|
485
504
|
|
|
486
505
|
fs.rmSync(HOME, { recursive: true, force: true })
|
package/scripts/smoke-client.mjs
CHANGED
|
@@ -190,10 +190,10 @@ delete states[0].runtime.companion;
|
|
|
190
190
|
delete states[0].runtime.companionReady;
|
|
191
191
|
delete states[0].runtime.companionTokenMatch;
|
|
192
192
|
|
|
193
|
-
// 和 dsh-qq-
|
|
193
|
+
// 和 dsh-qq-link 共存:它是「客户端」,要能看出装没装、挂没挂、连的端口对不对
|
|
194
194
|
const noBridge = collect(render());
|
|
195
195
|
check('没装桥接时也有「桥接插件」那行', noBridge.text.includes('桥接插件'));
|
|
196
|
-
check('没装时写「没检测到 dsh-qq-
|
|
196
|
+
check('没装时写「没检测到 dsh-qq-link」', noBridge.text.includes('没检测到 dsh-qq-link'));
|
|
197
197
|
states[0].runtime.bridgePlugin = {
|
|
198
198
|
version: '1.0.7',
|
|
199
199
|
profile: 'desktop',
|
|
@@ -206,10 +206,10 @@ states[0].runtime.bridgePlugin = {
|
|
|
206
206
|
bindings: 0,
|
|
207
207
|
configKnown: true,
|
|
208
208
|
check: 'bridge-hits-reverse',
|
|
209
|
-
note: 'dsh-qq-
|
|
209
|
+
note: 'dsh-qq-link 连的是 http://127.0.0.1:8643,而那个端口现在是反向 WebSocket',
|
|
210
210
|
};
|
|
211
211
|
const withBridge = collect(render());
|
|
212
|
-
check('装了会说版本与状态', withBridge.text.includes('dsh-qq-
|
|
212
|
+
check('装了会说版本与状态', withBridge.text.includes('dsh-qq-link 1.0.7') && withBridge.text.includes('已启用'));
|
|
213
213
|
check('在发 / 试运行 要分得清', withBridge.text.includes('在发'));
|
|
214
214
|
check('连的是反向 WS 端口要标出来', withBridge.text.includes('连的是反向 WS 端口'));
|
|
215
215
|
check('提示文案单独一行给出来', withBridge.text.includes('桥接提示:') && withBridge.text.includes('反向 WebSocket'));
|