dsh-napcat-keeper 2.8.1 → 2.9.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/CHANGELOG.md +34 -0
- package/README.md +33 -29
- package/lib/client.js +106 -108
- package/lib/index.js +535 -700
- package/package.json +4 -2
- package/scripts/selftest-layout.mjs +93 -0
- package/scripts/selftest-qrpanel.mjs +260 -0
- package/scripts/smoke-client.mjs +77 -54
- package/scripts/selftest-setup.mjs +0 -210
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,39 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
## 2.9.1 — 删掉「提权交接」那套生成脚本的机制(它做的事插件本来就能自己做)
|
|
4
|
+
|
|
5
|
+
- **删**:设置页里「需要你点一下的脚本(免管理员提权)」整块没了 —— 连带 `makeSetup` / `openSetup` / `setupResult` 三个动作、`SETUP_NEEDS`、`buildSetupSteps`、`writeSetupBundle`、`readSetupResult`、`readSetupPlan`、`setupState`、`openSetupFolder`、`setupPaths`、`dirWritable`、`needCatalog`、`applyPs1Source`、`setupCmdSource`、`setupUndoCmdSource`、`setupReadmeText`、`launcherBatLines`,以及面板里的「提权区」和它那排勾选框。服务端 `uiState().setup` 字段一并去掉;服务端旧版还带着 `setup` 时面板也不炸。
|
|
6
|
+
- **为什么**:那套机制把四件活写成 `plan.json` + `apply.ps1` + `apply-admin.cmd` 让人去双击,可这四件活插件自己全都能直接做完,而且**一件都不需要管理员**:
|
|
7
|
+
- 补启动脚本 → `autogen.bat` / `autogen-node.bat` 本来就写在插件自己目录里;
|
|
8
|
+
- 写 `env.bat` 中间层 → `writeEnvBat()` 在拉起和建任务时都会写;
|
|
9
|
+
- 建计划任务 → `ensureTask()` 走 `schtasks /create`,用户级,不需要管理员;
|
|
10
|
+
- 防火墙放行是唯一真要管理员的一步,也一并去掉(README「端口放行」给了 netsh 一行,要放行时自己跑一次;本机 127.0.0.1 连通根本不需要它)。
|
|
11
|
+
留着它只会让人以为「不点那几下插件就干不了活」,还多出一份把密码 base64 进 `plan.json` 的泄漏面。
|
|
12
|
+
- **删**:`scripts/selftest-setup.mjs` 跟着机制一起走,`npm test` 链条同步去掉。
|
|
13
|
+
- **清**:`migrateLegacyFiles()` 里等 `LEGACY_DIRS` 的改名搬家循环删了(没有需要改名的目录了),只留归档兜底;旧版本留下的 `~/.dsh/dsh-napcat-keeper/setup/` 是死文件,手动删掉即可。
|
|
14
|
+
- 版本号:`lib/index.js` 的 `version` 与 `package.json` 同步到 2.9.1(`check:manifest` 会查这一项)。
|
|
15
|
+
- 测试:`smoke-client` 里原来断言「有生成脚本按钮 / 4 个勾选框 / 读结果」的那 12 项,换成 5 项反向断言(不再是那套 UI、不再有 `npk-need-*` 勾选框、旧状态带 `setup` 字段也不炸);其余脚本全绿(清单体检、隐私体检、smoke 65 项、scan 15、save 12、probe 27、companion 83、layout 18、qrpanel 45)。
|
|
16
|
+
|
|
17
|
+
## 2.9.0 — 扫码页内嵌进插件:要扫码的时候点一下就能看见码
|
|
18
|
+
- **新**:NapCat 卡在扫码时,插件自己起一个**只监听 `127.0.0.1`** 的小页面(默认 `http://127.0.0.1:8899/`),点开就是一张会自己刷新的二维码 —— 深色卡片、3 秒对一次状态、图片 2 秒换一次(带 cache-buster),扫完它自己变绿;码快过期时盖一层「马上换码」的遮罩。上面还写清当前阶段、登录的号、OneBot 端口通不通、最近几行启动日志。
|
|
19
|
+
- 页面上两个按钮:「我要新码(重拉 NapCat)」直接走 `restart`、「立即刷新」只拉状态,不用回去翻设置页。
|
|
20
|
+
- **为什么要单独开端口**:DSH 自己的 `webServer` 对外部浏览器一律 `403 Browser access is disabled`,把页面只挂在 `/dsh-napcat-keeper/qr` 下面,别人拿浏览器点开是打不开的。所以两条路都留着 —— `qrPanel.url`(独立小端口,谁都能开)优先,`qrPanel.path`(DSH 路由)当兜底,设置页和 `napcat_status` 给的都是可用的那个。
|
|
21
|
+
- 设置页顶上新加一条黄色横幅:「⚠ NapCat 要手机扫码登录」+「点开扫码页」,点了直接开小端口那页;「二维码」那一行也多了「打开扫码页」按钮和当前端口状态。判定「要扫码」的口径:离线 + 阶段是 `need-scan`/`need-scan-giveup`,或者最近 900 秒内出过码。
|
|
22
|
+
- 新配置两项:`qrPanelEnabled`(默认开)、`qrPanelPort`(默认 `8899`,夹在 1024–65535)。改了立刻生效,不用重启 DSH;换端口时旧 server 会先关掉,不会两个端口都在听。
|
|
23
|
+
- 端口被别的程序占着时不闷头报错,`qrPanelPublic().note` 直接写「端口 N 被占了(改一个 qrPanelPort,或关掉占它的程序)」,设置页那行也照写。
|
|
24
|
+
- 服务状态挂在 `globalThis[Symbol.for('dsh.napcat-keeper.qrpanel')]` 上:插件热重载时会把旧 server 关掉,不会越攒越多;`stop()` 里也顺手关(`ctx.on('dispose')` 走到那儿)。
|
|
25
|
+
- 页面里的资源全走相对路径,所以在 `/` 下和在 `/dsh-napcat-keeper/qr` 下都能用;`serveQrPage()` 先把 `ROUTE` 前缀剥掉再分发,两个入口共用同一份处理。
|
|
26
|
+
- 测试:新增 `selftest:qrpanel`(33 项:默认值/夹紧、起服务与真实 `127.0.0.1` 握手、`/` 出 HTML 且用相对路径、`/qr-state` 结构、`/qr.png` 只会 404 或 `image/png`、未知路径 404、带 ROUTE 前缀也出页面、端口被占的人话提示、关掉开关后端口真的释放、换端口后旧端口释放、`qrPageState` 带 `panel`);已挂进 `npm test`。
|
|
27
|
+
|
|
28
|
+
## 2.8.2 — 「进程」那行按安装形态说人话 + 清一处重复模板
|
|
29
|
+
- **修**:`进程 NapCatWinBootMain 0 | QQ 2 | 链 1` 这句在 node 型(无头 Shell)安装上等于在骗人 —— 那种装法里 QQ 本体跑在 `node.exe` 里,机器上既没有 `QQ.exe` 也没有快登壳,`procs.boot` 恒为 0。现在设置页按形态换词:node 型写 `主/工作进程 2(node) | 链 1`,boot 型写 `快登壳 1 | QQ 4 | 链 1`,老服务端没给 `layout` 时退回原来那三项。
|
|
30
|
+
- 新增 `procsLayout()`,判形态的顺序是「**先看谁在跑**(`boot>0` → boot 型,`qq>0` → node 型),都没在跑才看 Shell 目录」。目录那步只认**顶层** `node.exe` + `index.js`/`napcat.mjs` 或顶层 `NapCatWinBootMain.exe`,不再拿「目录里某处有这个 exe」当判据 —— OneKey 那套会把壳模板留在 `napcat/` 子目录里,node 型目录里也常带一份。
|
|
31
|
+
- 目录判形按目录名缓存 60 秒:面板轻量档 1.5 秒来问一次,不该每次都去 `readdir`。
|
|
32
|
+
- 「进程」那行加了悬浮解释(`title`),写清楚 0 不等于没进程;前端另外挡一道 —— 服务端还说 boot、可壳是 0 个而 node 进程 > 0 时,仍按 node 说,省得等 host 侧热重载。
|
|
33
|
+
- **清**:`taskCommandLine` 与 `taskCommandLinePure` 原先各自抄了一遍 `cmd.exe /c chcp 65001 … call … >> log` 的模板,现在共用 `taskCmdLineOf()`,两边不会再改一处漏一处(一条会落盘中间层 bat、一条不落盘的区别照旧)。
|
|
34
|
+
- `procsLayout(cfg, p)` 补上 `cfg` 为空时的兜底,不再 `Cannot read properties of null`。
|
|
35
|
+
- 测试:新增 `selftest:layout`(18 项:三种形态、进程优先于目录、只有子目录模板时仍判 unknown、目录不存在 / shellDir 未填 / cfg 为 null 不抛、60 秒缓存、任务命令行两条路一字不差);`smoke-client` 加 7 项「进程」行渲染断言(含「服务端还说是 boot 但壳是 0 个」那条);新增 `npm test` 一把跑完清单体检 + 隐私体检 + 全部自测。
|
|
36
|
+
|
|
3
37
|
## 2.8.1 — 认得出两个共存插件(dsh-onebot-qq 跟它的端口,dsh-qq-bridge 替它对端口)
|
|
4
38
|
- 2.8.0 解决了「反向 WS 下不再误判离线、不再无限重启」,但端口还是得你自己抄:`dsh-onebot-qq` 默认监听 `8643`,你 `onebotPort` 里填的却是 `3000`,那就一直「没客户端连进来」。
|
|
5
39
|
- 现在会读 `dsh-onebot-qq` 自己的配置:扫 `~/.dsh/profiles/*` 的 `package.json`(`dependencies` + `dsh.profile.bundles`)和 `cordis.patch.yml` / `cordis.yml` 里它那一段,得出「装没装 / 挂没挂 / 反向还是正向 / 监听哪个端口 / 有没有配令牌」。不认识 `!!js` 这类表达式,认不出的宁可当没配。
|
package/README.md
CHANGED
|
@@ -38,6 +38,10 @@
|
|
|
38
38
|
- 需要的话设一个 token,记下来
|
|
39
39
|
3. 手动跑一次、扫码登录一次(之后有登录缓存就不用再扫,缓存时限在几十分钟左右吧)。
|
|
40
40
|
|
|
41
|
+
> 要扫码的时候不用再去翻 NapCat 的 `cache\qrcode.png`:插件自己起了个只监听本机的小页面
|
|
42
|
+
> (默认 **http://127.0.0.1:8899/**),设置页顶上那条黄横幅 / 二维码那一行的「打开扫码页」
|
|
43
|
+
> 点进去就是一张会自己刷新的码,扫完它自己变绿。换端口见下面配置表 `qrPanelPort`。
|
|
44
|
+
|
|
41
45
|
## 安装
|
|
42
46
|
|
|
43
47
|
**桌面版(点界面的)**:设置 → 插件 → **添加插件**,「包名或地址」那一栏只填包名 ——
|
|
@@ -111,33 +115,18 @@ dsh plugin --profile <profile> add dsh-napcat-keeper
|
|
|
111
115
|
| 建计划任务 | 现在就把计划任务建好(用户级,不需要管理员) |
|
|
112
116
|
| 收起黑框 | 把已经在跑的控制台窗口藏起来(不用重启 QQ) |
|
|
113
117
|
| 全部杀掉 | 只杀,不拉 |
|
|
114
|
-
| 生成脚本并打开文件夹 | 把勾好的「需要你点一下的脚本」写成 `apply.ps1` + 双击入口,同时弹资源管理器选中它 |
|
|
115
|
-
| 打开文件夹 | 只打开那个目录(脚本已经生成过时用,不用重新生成一遍) |
|
|
116
|
-
| 读结果 | 读回 `result.json`:上次跑成没成、哪一步失败、用没用上管理员 |
|
|
117
|
-
|
|
118
|
-
## 要动系统的部分:交给你点一下的脚本
|
|
119
|
-
|
|
120
|
-
DSH 自己是普通权限。插件要碰「装系统的位置」(往防火墙加规则、往别人的目录里写启动脚本……)时,
|
|
121
|
-
它不去偷偷提权,也不要你「以管理员身份重启 DSH」,而是把要做的事**写成一份脚本交给你**:
|
|
122
118
|
|
|
123
|
-
|
|
124
|
-
2. 资源管理器会跳出来并选中 `apply-admin.cmd`,双击它;
|
|
125
|
-
3. 里面若含管理员步骤,会弹一次 UAC —— **那个「是」就是你自己按的确认键**;一条都不含就直接跑完,不弹任何窗;
|
|
126
|
-
4. 回面板点 **读结果**,逐条显示成没成、为什么没成;
|
|
127
|
-
5. 想全撤,双击同目录的 `undo-admin.cmd`。
|
|
119
|
+
## 端口放行(只有这一步要管理员)
|
|
128
120
|
|
|
129
|
-
|
|
121
|
+
插件自己全程普通权限,不做任何提权,也不再生成「让你去双击」的脚本(2.9.1 删掉了那套机制)。
|
|
122
|
+
唯一真正需要管理员的事是给 OneBot 端口开防火墙入站 —— 要放行时,自己开一个管理员 PowerShell 跑一次:
|
|
130
123
|
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
| 计划任务 | 用 `schtasks` 建用户级任务(要不要隐藏黑框跟着设置走) | 不需要 |
|
|
136
|
-
| 防火墙放行 | `New-NetFirewallRule` 放行 OneBot 端口入站 | 需要 |
|
|
124
|
+
```powershell
|
|
125
|
+
New-NetFirewallRule -DisplayName "dsh-napcat-keeper OneBot" -Direction Inbound `
|
|
126
|
+
-Protocol TCP -LocalPort 3000 -Action Allow
|
|
127
|
+
```
|
|
137
128
|
|
|
138
|
-
|
|
139
|
-
别把这个目录发出去、别丢进同步盘);`result.json` 是上次跑的结果,`run.log` 是脚本自己记的流水账。
|
|
140
|
-
不用管理员就能做完的批次,`apply.ps1` 一条 `admin: true` 都数不到,于是原地跑完、绝不弹 UAC。
|
|
129
|
+
不放行也能用:NapCat 和 DSH 都在本机,走 127.0.0.1 不需要防火墙规则;只有从别的机器连进来才需要。
|
|
141
130
|
|
|
142
131
|
## 桌面上那个黑框
|
|
143
132
|
|
|
@@ -260,7 +249,7 @@ NapCat 连 OneBot 有两条相反的路:
|
|
|
260
249
|
|
|
261
250
|
| 工具 | 作用 |
|
|
262
251
|
| --- | --- |
|
|
263
|
-
| `napcat_status` |
|
|
252
|
+
| `napcat_status` | 端口/登录态、进程链、二维码副本路径、**扫码页地址(`qrPanel.url`,要扫码时发给用户点开)**、桥接心跳、日志尾部,以及两个共存插件的状态(`dsh-onebot-qq` 装了没/挂了没/端口模式/令牌一致不,`dsh-qq-bridge` 装了没/挂了没/桥接端口对不对) |
|
|
264
253
|
| `napcat_restart` | 干净地杀掉整条链并重拉,然后等它上线 |
|
|
265
254
|
| `napcat_dedupe` | 只在真有重复链时才杀(没重复就什么都不做) |
|
|
266
255
|
|
|
@@ -286,6 +275,8 @@ NapCat 连 OneBot 有两条相反的路:
|
|
|
286
275
|
| `probeIntervalSec` | `45` | 复查间隔 |
|
|
287
276
|
| `launchGraceSec` | `150` | 拉起后的宽限期 |
|
|
288
277
|
| `qrFreshSec` | `300` | 二维码新鲜度窗口:比这新 = 还在等人扫 |
|
|
278
|
+
| `qrPanelEnabled` | `true` | 要扫码时点开的那个小页面(只监听 `127.0.0.1`)。关掉 = 不起那个服务,只剩 DSH 里的路径 |
|
|
279
|
+
| `qrPanelPort` | `8899` | 扫码页的端口(1024–65535)。换了立刻生效,旧端口会先放掉 |
|
|
289
280
|
| `scanTimeoutSec` | `300` | 扫码等待上限 |
|
|
290
281
|
| `maxScanRetries` | `2` | 扫码重试上限 |
|
|
291
282
|
| `stuckSec` | `420` | 卡死判定 |
|
|
@@ -314,11 +305,12 @@ NapCat 连 OneBot 有两条相反的路:
|
|
|
314
305
|
├── launch.vbs 「自动创建计划任务」时生成的无窗口壳,计划任务调它
|
|
315
306
|
├── autogen-node.bat Shell 型专用:拿 DSH 自带的 node 跑 napcat.mjs
|
|
316
307
|
├── autogen.bat 没现成启动脚本时生成:直接调 NapCatWinBootMain.exe
|
|
317
|
-
├── setup/ 提权交接目录:plan.json / apply.ps1 / apply-admin.cmd
|
|
318
|
-
│ / undo-admin.cmd / result.json / run.log / README.txt
|
|
319
308
|
└── legacy/ 老版本遗留的配置备份等,不参与运行,整个删掉也没事
|
|
320
309
|
```
|
|
321
310
|
|
|
311
|
+
- 2.9.1 起目录里不再有 `setup/`(那套「生成 apply-admin.cmd 让你双击」的提权交接机制已整块删除,
|
|
312
|
+
旧版本留下的 `setup/` 目录是死文件,可以手动删掉)。
|
|
313
|
+
|
|
322
314
|
- `env.bat` 只在「记住密码」开启时才有;两份 `autogen*.bat` 只在需要时出现(每次拉起前按当前配置重写,删掉也会自己长回来)。整个目录删掉 = 插件回到没配置过的状态。
|
|
323
315
|
- **从老版本升上来(< 2.7.0)**:第一次启动会自动把原来散在 `~/.dsh` 根上的文件搬进这个目录(`napcat-keeper-config.json` → `config.json` 这种),改名一次就固定;计划任务里写死的旧路径也会一并改指新位置 —— 那一步用 `schtasks /change` 就地改,不结束正在跑的 QQ。老备份、以及搬不动的老文件(目标位已经有同名的那份、或者正被别的进程占着)都归到 `legacy/`,`~/.dsh` 根上不会留东西;实在被占着搬不动的,下次启动再搬一次。
|
|
324
316
|
- `~/.dsh/qq-bridge-state.json` **不在**这个目录里,也不归这个插件:它由 `dsh-qq-bridge` 写,插件只是读一下它的时间戳,判断那边轮询还活着没有。
|
|
@@ -340,7 +332,7 @@ npm run check:privacy # 只查隐私(发版前必跑)
|
|
|
340
332
|
|
|
341
333
|
**隐私体检**是发版前那道闸:把包里所有文本文件过一遍,找 Windows / Unix 家目录路径、邮箱、`ghp_` / `npm_` / `sk-` / `AKIA` 这类凭证、`Bearer` 后面的真串、DSH 会话 id,以及自测里那种 `launchAccount: '1234567890'` 的真实 QQ 号。命中就按 `文件:行` 列出来并返回非 0;确实是文档里必须留的示例,在那行末尾写 `check-privacy:ignore` 放过。占位写法(`C:/Users/你/…`、`C:/Users/x/…`)本来就放行。
|
|
342
334
|
|
|
343
|
-
另外几个自测,都不依赖本机路径,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-bridge` 的交叉结论)、`npm run selftest:setup`(临时目录里真跑一遍 apply / 重跑 / undo
|
|
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-bridge` 的交叉结论)、`npm run selftest:setup`(临时目录里真跑一遍 apply / 重跑 / undo)、`npm run selftest:layout`(验「进程」那行按安装形态换词、目录判形的 60 秒缓存,以及任务命令行两条路是否同一套模板)、`npm run selftest:qrpanel`(临时 DSH_HOME 里真起一次扫码页,验页面/状态/图片/未知路径/端口被占/关掉开关/换端口)。懒得一个个点就 `npm test`:清单体检 + 隐私体检 + 上面全部自测,一串跑完,红的就停。
|
|
344
336
|
|
|
345
337
|
> **改这个插件的文件的规矩**:别用 `Get-Content` 读、`Set-Content -Encoding utf8` 写 —— PowerShell 5.1 会按 ANSI 读、再按 UTF-8 写,一趟往返中文全变乱码,BOM 还照写。用编辑器另存为「UTF-8 无 BOM」;非要脚本写,就走
|
|
346
338
|
> `[IO.File]::WriteAllText($path, $text, (New-Object System.Text.UTF8Encoding($false)))`。
|
|
@@ -350,6 +342,18 @@ npm run check:privacy # 只查隐私(发版前必跑)
|
|
|
350
342
|
**「离线」但进程明明还在?**
|
|
351
343
|
端口没通。看 `~/.dsh/dsh-napcat-keeper/launch.log`,多半是卡在扫码,或者 QQ 弹了验证窗。
|
|
352
344
|
|
|
345
|
+
**设置页「进程」那行写着 `快登壳 0`,是不是一个进程都没有?**
|
|
346
|
+
不是。那行按你的安装形态换词,鼠标停上去有解释:
|
|
347
|
+
|
|
348
|
+
| 形态 | 面板怎么写 | 意思 |
|
|
349
|
+
| --- | --- | --- |
|
|
350
|
+
| node 型(无头 Shell,目录顶层是 `node.exe` + `index.js` / `napcat.mjs`) | `主/工作进程 2(node) | 链 1` | QQ 本体跑在 node 进程里,机器上**没有** `QQ.exe`、也没有快登壳 |
|
|
351
|
+
| 注入 / 快登壳型(目录顶层有 `NapCatWinBootMain.exe`) | `快登壳 1 | QQ 4 | 链 1` | 快登壳进程数 + QQ 进程数 |
|
|
352
|
+
|
|
353
|
+
所以 node 型安装下快登壳恒为 0 是正常的,不等于没进程 —— 真进程数看「主/工作进程」后面那个数字。
|
|
354
|
+
判形态的顺序是:**先看谁在跑**(有快登壳进程算 boot 型,只有 node 进程算 node 型),
|
|
355
|
+
都没在跑才去看目录(这一步按目录名缓存 60 秒,不会每 1.5 秒去 `readdir` 一次)。
|
|
356
|
+
|
|
353
357
|
**刚关掉 DSH,QQ 就跟着退了?**
|
|
354
358
|
正常,默认就是这样:QQ 挂在 DSH 下面,DSH 一走它就走。下次开 DSH 会重新拉一条。
|
|
355
359
|
想反过来(DSH 关了 NapCat 还活着)去填「计划任务名」+ 勾「自动创建计划任务」。
|
|
@@ -403,13 +407,13 @@ DSH 自带的 pnpm 不捎带 git,Windows 上又默认没装,于是就卡在
|
|
|
403
407
|
| 填进去的 | 结果 |
|
|
404
408
|
| --- | --- |
|
|
405
409
|
| `dsh-napcat-keeper` | ✅ |
|
|
406
|
-
| `dsh-napcat-keeper@2.8.
|
|
410
|
+
| `dsh-napcat-keeper@2.8.2` | ✅(指定版本) |
|
|
407
411
|
| `dsh plugin --profile desktop add dsh-napcat-keeper` | ❌ 整条命令 |
|
|
408
412
|
| `add dsh-napcat-keeper` | ❌ 多了 `add` |
|
|
409
413
|
| `Dsh-napcat-keeper` | ❌ 大写 |
|
|
410
414
|
| `dsh-napcat-keeper。`、`dsh-napcat-keeper;` | ❌ 全角标点 |
|
|
411
415
|
|
|
412
|
-
改法就一句:**那一栏只填 `dsh-napcat-keeper`**(要指定版本就 `dsh-napcat-keeper@2.8.
|
|
416
|
+
改法就一句:**那一栏只填 `dsh-napcat-keeper`**(要指定版本就 `dsh-napcat-keeper@2.8.2`)。想跑命令行的话,得在终端里跑,
|
|
413
417
|
不是在输入框里跑。
|
|
414
418
|
|
|
415
419
|
## License
|
package/lib/client.js
CHANGED
|
@@ -153,10 +153,13 @@ window.__ModuleLoader__.load({
|
|
|
153
153
|
items: [],
|
|
154
154
|
},
|
|
155
155
|
{
|
|
156
|
-
group: '
|
|
157
|
-
note: ''
|
|
158
|
-
|
|
159
|
-
items: [
|
|
156
|
+
group: '扫码页(要扫码时点开就能看)',
|
|
157
|
+
note: 'NapCat 掉线要手机扫码时,点一下就能看见一张会自己刷新的二维码,扫完它自己变绿。'
|
|
158
|
+
+ '只监听本机 127.0.0.1,不对外。',
|
|
159
|
+
items: [
|
|
160
|
+
['qrPanelEnabled', '开启扫码页', '关掉 = 不起那个小服务,只留 DSH 里的路径(外部浏览器打不开)', 'bool'],
|
|
161
|
+
['qrPanelPort', '扫码页端口', '在 127.0.0.1 上给它一个空端口,默认 8899', 'number'],
|
|
162
|
+
],
|
|
160
163
|
},
|
|
161
164
|
{
|
|
162
165
|
group: '高级',
|
|
@@ -206,7 +209,85 @@ window.__ModuleLoader__.load({
|
|
|
206
209
|
return 'dsh-qq-bridge ' + String(b.version) + ' · ' + 状态 + ' · ' + 开关 + ' · 连 ' + String(b.napcatUrl || '') + 问题
|
|
207
210
|
}
|
|
208
211
|
|
|
209
|
-
|
|
212
|
+
/**
|
|
213
|
+
* 实际在跑的形态优先于服务端声明的 layout:
|
|
214
|
+
* 声明是 boot、可快登壳进程 0 个而 node 进程 > 0 —— 那实际跑的就是 node 型,别按壳的说法写。
|
|
215
|
+
*/
|
|
216
|
+
function 实际形态(runtime) {
|
|
217
|
+
const p = runtime.procs || {}
|
|
218
|
+
if (runtime.layout === 'boot' && !Number(p.boot || 0) && Number(p.qq || 0) > 0) return 'node'
|
|
219
|
+
return runtime.layout
|
|
220
|
+
}
|
|
221
|
+
|
|
222
|
+
/**
|
|
223
|
+
* 「进程」那行的文案。按安装形态换词:
|
|
224
|
+
* - node 型(无头 Shell,napcat.mjs)没有快登壳,写「NapCatWinBootMain 0」会被当成没进程;
|
|
225
|
+
* - boot 型:快登壳 + QQ 个数都要看;
|
|
226
|
+
* - 老服务端没给 layout:退回原来的三项,别把面板搞宕。
|
|
227
|
+
*/
|
|
228
|
+
function 进程文案(runtime) {
|
|
229
|
+
const p = runtime.procs
|
|
230
|
+
if (!p || p.known === false) return '(还没探测)'
|
|
231
|
+
const 形态 = 实际形态(runtime)
|
|
232
|
+
const 链 = '链 ' + String(p.chains || 0) + (p.dup ? ' ⚠ 有重复链' : '')
|
|
233
|
+
if (形态 === 'node') {
|
|
234
|
+
return '主/工作进程 ' + String(p.qq || 0) + '(node)| ' + 链
|
|
235
|
+
}
|
|
236
|
+
if (形态 === 'boot') {
|
|
237
|
+
return '快登壳 ' + String(p.boot || 0) + ' | QQ ' + String(p.qq || 0) + ' | ' + 链
|
|
238
|
+
}
|
|
239
|
+
return 'NapCatWinBootMain ' + String(p.boot || 0) + ' | QQ ' + String(p.qq || 0) + ' | ' + 链
|
|
240
|
+
}
|
|
241
|
+
|
|
242
|
+
/** 上面那行的悬浮解释:为什么 0 不等于没进程 */
|
|
243
|
+
function 进程说明(runtime) {
|
|
244
|
+
const p = runtime.procs || {}
|
|
245
|
+
const 数 = String(p.qq || 0) + ' 个进程、' + String(p.chains || 0) + ' 条链'
|
|
246
|
+
const 形态 = 实际形态(runtime)
|
|
247
|
+
if (形态 === 'node') {
|
|
248
|
+
return (
|
|
249
|
+
'当前跑的是 node 型(无头 Shell):QQ 本体在 node.exe 里,机器上没有 QQ.exe、也没有快登壳进程。' +
|
|
250
|
+
'当前 ' + 数 + ';Shell 目录里就算躺着 NapCatWinBootMain.exe 也没在用,所以那一项恒为 0,属正常。'
|
|
251
|
+
)
|
|
252
|
+
}
|
|
253
|
+
if (形态 === 'boot') {
|
|
254
|
+
return (
|
|
255
|
+
'Shell 目录里有 NapCatWinBootMain.exe:快登壳 ' + String(p.boot || 0) +
|
|
256
|
+
' 个、QQ/node 进程 ' + String(p.qq || 0) + ' 个、' + String(p.chains || 0) + ' 条链。'
|
|
257
|
+
)
|
|
258
|
+
}
|
|
259
|
+
return '快登壳 ' + String(p.boot || 0) + ' 个、QQ/node 进程 ' + String(p.qq || 0) + ' 个、' + String(p.chains || 0) + ' 条链。'
|
|
260
|
+
}
|
|
261
|
+
|
|
262
|
+
/** 现在是不是「要人拿手机扫一下」那种状态(离线 + 刚出过码 / 阶段就写着等扫码) */
|
|
263
|
+
function 要扫码(runtime) {
|
|
264
|
+
if (!runtime || runtime.online) return false
|
|
265
|
+
const phase = String(runtime.phase || '')
|
|
266
|
+
if (phase === 'need-scan' || phase === 'need-scan-giveup') return true
|
|
267
|
+
const qr = runtime.qr
|
|
268
|
+
return Boolean(qr && typeof qr.ageSec === 'number' && qr.ageSec <= 900)
|
|
269
|
+
}
|
|
270
|
+
|
|
271
|
+
/**
|
|
272
|
+
* 扫码页链接:优先插件自己那个小端口(127.0.0.1:qrPanelPort,任何浏览器都打得开),
|
|
273
|
+
* 没起来才退回 DSH 路由(DSH 的 webServer 对外部浏览器是 403,只能当兜底)。
|
|
274
|
+
*/
|
|
275
|
+
function 扫码页链接(panel, 文字, 额外样式) {
|
|
276
|
+
const href = (panel && panel.url) || B + '/qr'
|
|
277
|
+
return h(
|
|
278
|
+
'a',
|
|
279
|
+
{
|
|
280
|
+
href: href,
|
|
281
|
+
target: '_blank',
|
|
282
|
+
rel: 'noreferrer',
|
|
283
|
+
title: href,
|
|
284
|
+
style: { ...S.btn, textDecoration: 'none', display: 'inline-block', ...(额外样式 || {}) },
|
|
285
|
+
},
|
|
286
|
+
文字 || '打开扫码页',
|
|
287
|
+
)
|
|
288
|
+
}
|
|
289
|
+
|
|
290
|
+
function 状态条(runtime, panel) {
|
|
210
291
|
if (!runtime) return null
|
|
211
292
|
const 在 = runtime.online
|
|
212
293
|
// 反向 WS:端口是别人在听(dsh-onebot-qq 之类),NapCat 反过来连进去,
|
|
@@ -236,6 +317,19 @@ window.__ModuleLoader__.load({
|
|
|
236
317
|
offline: '离线',
|
|
237
318
|
}[String(runtime.phase || '')] || String(runtime.phase || '?')
|
|
238
319
|
return h('div', { style: S.card },
|
|
320
|
+
要扫码(runtime)
|
|
321
|
+
? h('div', {
|
|
322
|
+
style: {
|
|
323
|
+
display: 'flex', gap: 10, alignItems: 'center', flexWrap: 'wrap',
|
|
324
|
+
marginBottom: 10, padding: '8px 10px', borderRadius: 8,
|
|
325
|
+
border: '1px solid #b8860b', background: 'rgba(184,134,11,.10)',
|
|
326
|
+
},
|
|
327
|
+
},
|
|
328
|
+
h('span', { style: S.warn }, '⚠ NapCat 要手机扫码登录'),
|
|
329
|
+
h('span', { style: S.dim }, '点右边这一页,二维码会自己刷新;扫完它会变绿。'),
|
|
330
|
+
扫码页链接(panel, '点开扫码页'),
|
|
331
|
+
)
|
|
332
|
+
: null,
|
|
239
333
|
h('div', { style: { display: 'flex', gap: 14, alignItems: 'center', flexWrap: 'wrap' } },
|
|
240
334
|
h('span', { style: 在 ? S.ok : S.bad }, 在 ? (反向 ? '● 反向 WS 已连接' : '● 在线') : '○ 离线'),
|
|
241
335
|
在 && (runtime.nickname || runtime.userId)
|
|
@@ -254,13 +348,7 @@ window.__ModuleLoader__.load({
|
|
|
254
348
|
),
|
|
255
349
|
h('div', { style: { ...S.kv, marginTop: 8 } },
|
|
256
350
|
h('span', { style: S.dim }, '进程'),
|
|
257
|
-
h('span',
|
|
258
|
-
runtime.procs && runtime.procs.known === false
|
|
259
|
-
? '(还没探测)'
|
|
260
|
-
: 'NapCatWinBootMain ' + String((runtime.procs && runtime.procs.boot) || 0) +
|
|
261
|
-
' | QQ ' + String((runtime.procs && runtime.procs.qq) || 0) +
|
|
262
|
-
' | 链 ' + String((runtime.procs && runtime.procs.chains) || 0) +
|
|
263
|
-
(runtime.procs && runtime.procs.dup ? ' ⚠ 有重复链' : '')),
|
|
351
|
+
h('span', { title: 进程说明(runtime) }, 进程文案(runtime)),
|
|
264
352
|
h('span', { style: S.dim }, '路径前缀'),
|
|
265
353
|
h('span', { style: { wordBreak: 'break-all' } }, String(runtime.procRoot || '(空)')),
|
|
266
354
|
h('span', { style: S.dim }, '启动脚本'),
|
|
@@ -276,7 +364,11 @@ window.__ModuleLoader__.load({
|
|
|
276
364
|
? '(读取中…)'
|
|
277
365
|
: runtime.taskReady ? ' ✓ 就绪' : '(还没建)')),
|
|
278
366
|
h('span', { style: S.dim }, '二维码'),
|
|
279
|
-
h('span', null,
|
|
367
|
+
h('span', null,
|
|
368
|
+
runtime.qr ? '最新一张 ' + String(runtime.qr.ageSec) + ' 秒前' : '还没有(没进扫码态)',
|
|
369
|
+
扫码页链接(panel, '打开扫码页', { marginLeft: 8 }),
|
|
370
|
+
panel && panel.note ? h('span', { style: { ...S.dim, marginLeft: 8 } }, String(panel.note)) : null,
|
|
371
|
+
),
|
|
280
372
|
h('span', { style: S.dim }, '桥接心跳'),
|
|
281
373
|
h('span', null, runtime.bridge && runtime.bridge.ageSec !== null ? String(runtime.bridge.ageSec) + ' 秒前' : '没读到'),
|
|
282
374
|
h('span', { style: S.dim }, '共存插件'),
|
|
@@ -299,8 +391,6 @@ window.__ModuleLoader__.load({
|
|
|
299
391
|
const [说, set说] = React.useState('')
|
|
300
392
|
const [开日志, set开日志] = React.useState(false)
|
|
301
393
|
const [风险开, set风险开] = React.useState(false)
|
|
302
|
-
// null = 「还没动过,默认全勾能做的」;一旦用户点过 checkbox 就固定用它(哪怕空数组)
|
|
303
|
-
const [勾, set勾] = React.useState(null)
|
|
304
394
|
|
|
305
395
|
const 装 = (data) => {
|
|
306
396
|
set态(data)
|
|
@@ -441,96 +531,6 @@ window.__ModuleLoader__.load({
|
|
|
441
531
|
|
|
442
532
|
const 改 = (k, v) => set草((prev) => ({ ...(prev || {}), [k]: v }))
|
|
443
533
|
|
|
444
|
-
/* 提权交接:插件自己不去要管理员,只写脚本;「是」由人在 UAC 上按。 */
|
|
445
|
-
function 提权区() {
|
|
446
|
-
const 设 = 态 && 态.setup
|
|
447
|
-
if (!设) return h('div', { style: S.hint }, '读不到脚本状态(刷新一下面板试试)')
|
|
448
|
-
const needs = 设.needs || []
|
|
449
|
-
const 可做 = needs.filter((n) => n.ready).map((n) => n.id)
|
|
450
|
-
const 选中 = (勾 === null ? 可做 : 勾).filter((id) => 可做.indexOf(id) >= 0)
|
|
451
|
-
const 切 = (id) => {
|
|
452
|
-
set勾(选中.indexOf(id) >= 0 ? 选中.filter((x) => x !== id) : 选中.concat(id))
|
|
453
|
-
}
|
|
454
|
-
const 跑 = async (doIt, extra) => {
|
|
455
|
-
if (忙) return
|
|
456
|
-
set忙(true)
|
|
457
|
-
set说('执行中:' + doIt + ' …')
|
|
458
|
-
const r = await post('/action', { do: doIt, ...(extra || {}) })
|
|
459
|
-
// 只换态、不动草稿:用户可能还有没保存的设置
|
|
460
|
-
if (r) set态(r)
|
|
461
|
-
set说((r && r.said) || '做完了')
|
|
462
|
-
set忙(false)
|
|
463
|
-
}
|
|
464
|
-
const 生成 = () => {
|
|
465
|
-
if (!选中.length) {
|
|
466
|
-
set说('先勾上至少一条要它做的事')
|
|
467
|
-
return
|
|
468
|
-
}
|
|
469
|
-
跑('makeSetup', { needs: 选中, open: true })
|
|
470
|
-
}
|
|
471
|
-
const 计划 = 设.plan
|
|
472
|
-
const 上次 = 设.lastRun
|
|
473
|
-
const 结果们 = (上次 && 上次.results) || []
|
|
474
|
-
const 成数 = 结果们.filter((x) => x.ok).length
|
|
475
|
-
return h('div', null,
|
|
476
|
-
h('div', { style: S.h }, '需要你点一下的脚本(插件不去抢管理员)'),
|
|
477
|
-
h('div', { style: { ...S.dim, marginBottom: 8 } },
|
|
478
|
-
'要动「装系统的位置」时,插件不偷偷提权,而是把要做的事写成一份脚本放到下面的目录里:'
|
|
479
|
-
+ '你双击 apply-admin.cmd,只有含管理员步骤的那一批才会弹 UAC —— 那个「是」就是你自己按的确认键;'
|
|
480
|
-
+ '不含的批次双击直接跑。跑完回来点「读结果」,想全部撤回就双击 undo-admin.cmd。'),
|
|
481
|
-
h('div', { style: S.card },
|
|
482
|
-
needs.map((n) => h('label', {
|
|
483
|
-
key: n.id,
|
|
484
|
-
style: {
|
|
485
|
-
display: 'flex',
|
|
486
|
-
gap: 8,
|
|
487
|
-
alignItems: 'flex-start',
|
|
488
|
-
padding: '6px 0',
|
|
489
|
-
opacity: n.ready ? 1 : 0.55,
|
|
490
|
-
cursor: n.ready ? 'pointer' : 'not-allowed',
|
|
491
|
-
},
|
|
492
|
-
},
|
|
493
|
-
h('input', {
|
|
494
|
-
type: 'checkbox',
|
|
495
|
-
name: 'npk-need-' + String(n.id),
|
|
496
|
-
checked: 选中.indexOf(n.id) >= 0,
|
|
497
|
-
disabled: !n.ready || 忙,
|
|
498
|
-
onChange: () => 切(n.id),
|
|
499
|
-
style: { marginTop: 3, flex: '0 0 auto' },
|
|
500
|
-
}),
|
|
501
|
-
h('div', { style: { flex: '1 1 auto', minWidth: 0 } },
|
|
502
|
-
h('div', null, String(n.label || n.id) + (n.needAdmin ? '(要不要管理员看你的目录权限)' : '(不需要管理员)')),
|
|
503
|
-
h('div', { style: S.hint }, String(n.hint || '')),
|
|
504
|
-
!n.ready ? h('div', { style: { ...S.warn, fontSize: 11.5, marginTop: 2 } }, '先解决:' + String(n.why || '')) : null),
|
|
505
|
-
)),
|
|
506
|
-
h('div', { style: { display: 'flex', gap: 8, flexWrap: 'wrap', marginTop: 10 } },
|
|
507
|
-
h('button', { type: 'button', style: S.btnOn, disabled: 忙, onClick: 生成 }, '生成脚本并打开文件夹'),
|
|
508
|
-
h('button', { type: 'button', style: S.btn, disabled: 忙 || !设.exists, onClick: () => 跑('openSetup') }, '打开文件夹'),
|
|
509
|
-
h('button', { type: 'button', style: S.btn, disabled: 忙, onClick: () => 跑('setupResult') }, '读结果'),
|
|
510
|
-
),
|
|
511
|
-
h('div', { style: { ...S.hint, marginTop: 6, wordBreak: 'break-all' } }, String(设.dir || '')),
|
|
512
|
-
计划
|
|
513
|
-
? h('div', { style: { ...S.dim, marginTop: 8 } },
|
|
514
|
-
'上次生成:' + String(计划.createdAt || '').replace('T', ' ').slice(0, 19)
|
|
515
|
-
+ '|' + String((计划.steps || []).length) + ' 步'
|
|
516
|
-
+ (计划.needAdmin ? '|含管理员步骤' : '|全程普通权限'),
|
|
517
|
-
h('div', { style: S.hint }, (计划.steps || []).map((s) => String(s.label || s.id)).join('、')))
|
|
518
|
-
: h('div', { style: { ...S.dim, marginTop: 8 } }, '还没生成过脚本'),
|
|
519
|
-
上次
|
|
520
|
-
? h('div', { style: { marginTop: 8 } },
|
|
521
|
-
h('div', { style: 上次.ok ? S.ok : S.bad },
|
|
522
|
-
(上次.mode === 'undo' ? '撤回' : '执行') + ':' + String(成数) + '/' + String(结果们.length) + ' 步成'
|
|
523
|
-
+ (上次.elevated ? '|用了管理员' : '|没用管理员')),
|
|
524
|
-
结果们.map((x) => h('div', {
|
|
525
|
-
key: String(x.id || '') + String(x.label || ''),
|
|
526
|
-
style: { ...S.hint, color: x.ok ? undefined : '#c0392b' },
|
|
527
|
-
}, (x.ok ? '✓ ' : x.skipped ? '· 跳过 ' : '✗ ')
|
|
528
|
-
+ String(x.label || x.id || '') + ':' + String(x.message || ''))))
|
|
529
|
-
: null,
|
|
530
|
-
),
|
|
531
|
-
)
|
|
532
|
-
}
|
|
533
|
-
|
|
534
534
|
function 扫描区() {
|
|
535
535
|
const 扫 = (态 && 态.scan) || { running: false, found: [], drives: [], visited: 0 }
|
|
536
536
|
const 盘们 = (态 && 态.drives) || []
|
|
@@ -797,7 +797,7 @@ window.__ModuleLoader__.load({
|
|
|
797
797
|
'让 NapCat(QQ 协议端)跟着 DSH 一起活着:不通就拉、重复就杀、卡住就重来。'
|
|
798
798
|
+ '版本 ' + String(态.version || '?') + '|配置:' + String(取(态.config, 'configPath'))),
|
|
799
799
|
|
|
800
|
-
状态条(态.runtime),
|
|
800
|
+
状态条(态.runtime, 态.qrPanel),
|
|
801
801
|
|
|
802
802
|
h('div', { style: { display: 'flex', gap: 8, flexWrap: 'wrap', margin: '10px 0' } },
|
|
803
803
|
h('button', { type: 'button', style: S.btn, disabled: 忙, onClick: () => 动('probe') }, '重新探活'),
|
|
@@ -815,8 +815,6 @@ window.__ModuleLoader__.load({
|
|
|
815
815
|
? h('div', { key: g.group }, 密码区())
|
|
816
816
|
: g.custom === 'scan'
|
|
817
817
|
? h('div', { key: g.group }, 扫描区())
|
|
818
|
-
: g.custom === 'setup'
|
|
819
|
-
? h('div', { key: g.group }, 提权区())
|
|
820
818
|
: h('div', { key: g.group },
|
|
821
819
|
h('div', { style: S.h }, g.group),
|
|
822
820
|
g.note ? h('div', { style: { ...S.dim, marginBottom: 8 } }, g.note) : null,
|