dsh-napcat-keeper 2.5.0 → 2.6.0

package/CHANGELOG.md

@@ -1,5 +1,31 @@
 # Changelog
 
+## 2.6.0 — 清死代码 + README 与代码对齐
+- **删掉的死代码**（都确认过没有任何调用点，删了行为不变）：
+  - v2.2.2 起停用的目录自动探测三件套 `looksLikeShellDir()` / `findShellDirs()` / `detectShellDir()` —— 从那次起 `shellDir` 只认用户在设置页选的，这几个函数只被彼此和调试用的 `__internals` 引用；
+  - `napcatRoot(cfg)` —— 只在声明处出现过一次；
+  - `__internals` 里同步摘掉 `detectShellDir`。
+  合计 `lib/index.js` 从 3332 行降到 3262 行。
+- **PowerShell 调用收口**：新增 `psArgs()` / `runPs()` / `runPsSync()` 三个薄封装，原先 7 个调用点各自手抄一份 `['-NoProfile', '-NonInteractive', '-Command', …]`（漏一个参数就难查）。`where`/`tasklist`/`schtasks` 这些非 PowerShell 的调用保持原样。
+- **措辞跟现状对齐**：3 处还写着「自动探测」的注释/字段说明改成「在目录里挑」「点分盘扫描找」；`detectLauncher` 的注释原先和函数挤在同一行，拆开。
+- **README 统一**（这段是这回发版的主因）：
+  - 安装代码块末尾多出的空行去掉；
+  - 「真假判定」那段把「可能误判」从括号里拿出来正着说，兼修「一边 → 一遍」；
+  - 「多个可能的 shell」标题与正文口径对齐（不再写死「两个目录」）；
+  - 计划任务那一栏「留空 = 不用计划任务」语义是反的，改成「留空 = 走 cscript，跟着 DSH 生灭；填了才脱离 DSH」；
+  - `npm run check:privacy` 那条命令原先悬空（解释隐私体检的段落被删了），补回一整段说明；
+  - 块引用里孤零零一行 `[IO.File]::WriteAllText(...)` 补上引导语；
+  - Shell 型自动生成脚本的路径写错（`~/Dsh/…`），改成实际落点 `~/.dsh/napcat-autogen-node.bat`；文件清单同时补上 `napcat-autogen.bat`；
+  - 配置表补齐 `hideConsole` / `qrFreshSec` / `heartbeatSec` / `maxQqPerChain` / `maxLogBytes`，并注明路径类字段默认落在 `~/.dsh/`。
+- **验证**：`npm run smoke:client` PASS、`selftest:scan` 15/15、`selftest:setup` 45 通过 0 失败、`npm run check`（清单 + 隐私）双绿。
+- 版本 2.6.0。
+
+## 2.5.1 — README 按维护者口径重写（只有文档改动）
+- **为什么发这一版**：npm 上的 README 是发布那一刻的快照，改 GitHub 不会跟着变 —— 只有发一个新版本号，npm 页面才会重新抓。代码一行没动，纯为了把两个人看的那份对齐。
+- **README 改了什么**（作者手改，我照搬）：去掉「从本地目录装」那条只对开发者有意义的路径；分盘扫描的真假判定、多个 shell 并存这两段按实际重装经历改写；快速登录令牌失效时间改成实测的「几小时左右」；记住密码的风险清单删掉 MD5 那句；计划任务两处说明改成「留空 = 不建任务」的说法；开头补了一句吐槽。
+- **顺手修的一处**：手填示例路径里的用户名原来写成了一个具体目录名，`check-privacy` 会把它当成真实家目录拦下来，改成占位 `你`。
+- 版本 2.5.1。
+
 ## 2.5.0 — 统一用 DSH 自带的 Node 运行时
 - **为什么改**：以前凡是「要跑一段 JS」的地方，都默认那台机器上装过 node，或者干脆蹭 NapCat / QQ 的私有环境。换台机器、换个装法就哑火 —— 不通用。
 - **新增 `resolveNode()`**，顺序固定、结果缓存 60 秒：
@@ -8,7 +34,7 @@
   3. 系统 `PATH`（`where node`）；
   4. 常见安装目录（`Program Files\nodejs`、`%LOCALAPPDATA%\Programs\nodejs`）；
   5. NapCat 目录里自带的 `node.exe` 兜底。
-- **补上「Shell 型」NapCat**：目录**顶层**有 `napcat.mjs` 的（官方 NapCat.Shell 包那种），现在会用上面这份 node 生成 `~/Dsh/napcat-autogen-node.bat` 去跑 `node napcat.mjs`；以前只认 `NapCatWinBootMain.exe`，遇到 node 型安装直接报「找不到启动脚本」。注入版 `versions\*\resources\app\napcat\napcat.mjs` **不会**被当成入口（那份是等 QQ 注入的，普通 node 跑必崩）。
+- **补上「Shell 型」NapCat**：目录**顶层**有 `napcat.mjs` 的（官方 NapCat.Shell 包那种），现在会用上面这份 node 生成 `~/.dsh/napcat-autogen-node.bat` 去跑 `node napcat.mjs`；以前只认 `NapCatWinBootMain.exe`，遇到 node 型安装直接报「找不到启动脚本」。注入版 `versions\*\resources\app\napcat\napcat.mjs` **不会**被当成入口（那份是等 QQ 注入的，普通 node 跑必崩）。
 - **注入型（OneKey）不变**：NapCat 跑在 `QQ.exe --type=utility --utility-sub-type=node.mojom.NodeService` 里，磁盘上没有 node.exe，外部 node 替不了它 —— 这条链路插件只负责调 bootmain。
 - **可见性**：设置页新增「Node 运行时」一栏 + 「测一下 node」按钮；状态条显示「哪份 node / 什么版本 / 路径」；`napcat_status` 返回值里多了 `node` 字段；启动日志 `boot:` 那行带上 node 来源。
 - **发版前隐私清洗**：`lib/client.js` 的「接口没响应」提示原来硬编码了本机家目录，改成 `~/.dsh/napcat-keeper.log`；`scripts/selftest-scan.mjs` / `scripts/smoke-client.mjs` 里写死的本机绝对路径改成按脚本自身位置定位；`smoke-client` 的 `launchAccount` fixture 换成合成占位 `1000000000`。现在换台机器 clone 下来，自测脚本照样跑得起来。

package/README.md

@@ -1,6 +1,6 @@
 # dsh-napcat-keeper
 
-发现没有能够随着dsh打开自动启动napcat的插件，遂使用大肥鱼制作此插件，建议搭配[Yuuyuko-uu 的 dsh-qq-bridge](https://github.com/Yuuyuko-uu/dsh-qq-bridge)使用~
+发现没有能够随着 DSH 打开自动启动 NapCat 的插件，遂使用大肥鱼制作此插件，建议搭配[Yuuyuko-uu 的 dsh-qq-bridge](https://github.com/Yuuyuko-uu/dsh-qq-bridge)使用~
 
 给 [NapCat](https://napneko.github.io/)（QQ 协议端）配一个看门狗：**DSH 在，QQ 就在**。
 
@@ -13,6 +13,8 @@
 
 声明：基本纯让我家大肥鱼跑的，内容我只粗略检查了一下，本人也只是个半吊子学生，有隐性bug大概率也看不出来，这GitHub我也第一次用，之前光下别的大佬的好东西了，有大佬愿意的话欢迎随时指点我、提建议等等都行，爱你♥️
 
+吐槽：这傻鱼写的啥readme啊，我得自己改一下。
+
 ---
 
 ## 它到底管什么
@@ -34,16 +36,12 @@
 2. 打开 NapCat 的 WebUI → **网络配置** → 加一个 **HTTP 服务器**：
    - host `127.0.0.1`，port `3000`（或你喜欢的端口）
    - 需要的话设一个 token，记下来
-3. 手动跑一次、扫码登录一次（之后有登录缓存就不用再扫）。
+3. 手动跑一次、扫码登录一次（之后有登录缓存就不用再扫，缓存时限在几十分钟左右吧）。
 
 ## 安装
 
 ```bash
-# 从 npm 装（发布后）
 dsh plugin --profile <profile> add dsh-napcat-keeper
-
-# 或从本地目录装（开发时）
-dsh plugin --profile <profile> add C:\path\to\dsh-napcat-keeper
 ```
 
 装完重启一次 DSH（第一次装载才生效），然后去 **设置 → napcat桥**。
@@ -52,8 +50,8 @@ dsh plugin --profile <profile> add C:\path\to\dsh-napcat-keeper
 
 | 填什么 | 说明 |
 | --- | --- |
-| **NapCat Shell 目录** | 用下面的「分盘扫描」找：本机有几块盘就点哪块，扫到后点「用这个」直接填进去；也能手填，例如 `C:/Users/你/NapCat/OneKey/NapCat.<版本>.Shell` |
-| **要快登的 QQ 号** | 填了它，插件优先挑「写死了这个号」的启动脚本；连脚本都没有时，自动生成一个直接调 `NapCatWinBootMain.exe <号>` 的脚本 |
+| **NapCat Shell 目录** | 用下面的「分盘扫描」找：NapCat 装哪块盘就点哪块，扫到后点「用这个」直接填进去；也能手填，例如 `C:/Users/你/NapCat/OneKey/NapCat.Shell` |
+| **要快登的 QQ 号** | 填了它，插件优先挑「填的这个号」的启动脚本；连脚本都没有时，自动生成一个直接调 `NapCatWinBootMain.exe <号>` 的脚本 |
 | **OneBot HTTP 端口** | 跟 NapCat 网络配置里的 httpServers 一致（默认 3000） |
 
 点 **保存设置** → 存到 `~/.dsh/napcat-keeper-config.json`，立刻热生效。
@@ -61,7 +59,7 @@ dsh plugin --profile <profile> add C:\path\to\dsh-napcat-keeper
 
 ## 分盘扫描：装在哪都能找到
 
-从 2.2.2 起插件**不再自己猜** NapCat 装在哪（`自动探测` 已删）：`shellDir` 留空就是空，不会悄悄填一个可能填错的目录。
+从 2.2.2 起插件**不再自己猜** NapCat 装在哪：`shellDir` 留空就是空，不会悄悄填一个可能填错的目录。
 设置页第一组是 **分盘扫描**，目录由你来选：
 
 - 本机有几块盘就列几个按钮（盘符取自系统 `DriveInfo`，光驱、移动盘、上锁的卷都会列），点哪个扫哪个；
@@ -72,11 +70,13 @@ dsh plugin --profile <profile> add C:\path\to\dsh-napcat-keeper
   命中后不再往它下面钻（QQ 目录里几千个文件，钻进去只会变慢）。
 - **命中之后再分真假**：目录里只要有 `versions/`、`QQ.exe`、`napcat.mjs` 里的任意一样，就是**真 Shell**
   （标绿 `✓ 像真 Shell：versions/ · QQ.exe`，按钮「用这个」）；三样都没有的标黄
-  `⚠ 没看到 versions/QQ.exe/napcat.mjs`，按钮是「仍要用这个」（没禁用——精简版布局确实可能没有这三样，你更清楚）。
+  `⚠ 没看到 versions/QQ.exe/napcat.mjs`，按钮是「仍要用这个」。
+  这个判据只是经验值，精简版布局有可能三样都不带（我自己重装了一遍 NapCat 就没这仨，不管了 bro），
+  所以「标黄」不等于「不能用」，点「仍要用这个」照样能填进去。
   真 Shell 一律排在前面，不受磁盘遍历顺序影响。
-- **为什么会有两个**：OneKey 安装器会先把壳模板解到 `NapCat\OneKey\bootmain`（只有 `NapCatWinBootMain.exe`
+- **为什么会有好几个候选**：OneKey 安装器会先把壳模板解到 `NapCat\OneKey\bootmain`（只有 `NapCatWinBootMain.exe`
   + `napcat.quick.bat`，**没有 QQ 本体**），再把真正的版本装成 `NapCat\<版本>.Shell`（有 `versions/` 和 `QQ.exe`）。
-  一次安装留下两个目录，只有后者能拉起来。
+  一次安装可能留下多个目录，只有带 QQ 本体的那个能拉起来。
 - 每命中一条就列一行：路径、挑出来的启动脚本、是否含 `NapCatWinBootMain.exe`、真假判定，右边按钮一键填入。
 - 到时间/到数量上限会明确写「结果可能不全」，不会闷头扫一小时。
 
@@ -126,7 +126,7 @@ DSH 自己是普通权限。插件要碰「装系统的位置」（往防火墙
 ## 桌面上那个黑框
 
 cscript / cmd 直接拉 NapCat，会多出一个控制台窗口挂在桌面上。默认行为是**不显示**：
-计划任务的动作写的是 `wscript.exe "<dsh家目录>\napcat-keeper-launch.vbs"`，这个壳里用
+计划任务的动作写的是 `wscript.exe "<DSH 家目录>\napcat-keeper-launch.vbs"`，这个壳里用
 `sh.Run cmd, 0, False` 把真正的 cmd 以隐藏窗口启动（`0` = SW_HIDE）。壳文件用 UTF-16LE 存，中文路径也认。
 
 不想要隐藏就把「拉起时不显示黑框」关掉，任务会退回直接跑 `cmd.exe`；已经跑起来的那条链想收窗口，
@@ -134,12 +134,12 @@ cscript / cmd 直接拉 NapCat，会多出一个控制台窗口挂在桌面上
 
 ## 记住密码：默认关，开了要自己认风险
 
-NapCat 的**快速登录令牌会失效**（实测几小时到几天），失效后启动脚本只会停在扫码，QQ 就一直离线，
+NapCat 的**快速登录令牌会失效**（实测几小时左右），失效后启动脚本只会停在扫码，QQ 就一直离线，
 `dsh-qq-bridge` 那边则是刷屏的 `ECONNREFUSED 127.0.0.1:3000`。想让它自己能爬起来，就得给它密码。
 
 设置页「自动登录（可不填）」里勾 **记住密码** 时会先弹一段风险提示，要你自己点「我知道风险，仍然开启」才会生效。开启前请确认你接受这几条：
 
-1. 密码以**明文**存进 `~/.dsh/napcat-keeper-config.json` 和插件生成的 `napcat-keeper-env.bat`，不加密（MD5 那份是给 NapCat 兜底用的，等于同一个秘密）。
+1. 密码以**明文**存进 `~/.dsh/napcat-keeper-config.json` 和插件生成的 `napcat-keeper-env.bat`，不加密。
 2. 任何能读你用户目录的程序都能捡走：同步盘、备份工具、其它软件、远控、临时借电脑的人。
 3. QQ 密码往往和 QQ 邮箱、部分游戏、微信登录入口共用一套身份，泄漏面不止一个号。
 4. 插件不打印密码，`/state` 也只回「存没存 + 长度」，但那只是少开一个口子，不等于安全。
@@ -155,8 +155,8 @@ QQ 那条进程链挂在本 DSH 实例下面——DSH 开着它就在，DSH 关
 
 「刚重启 DSH，QQ 就掉了」不是毛病，是这个默认行为：新实例会自己重新拉起，扫不上就自动密码登录。
 
-要是反过来想要「DSH 关了 QQ 还活着」，才去填「计划任务名」（默认 `NapCat-Keeper-Launch`）+ 勾「自动创建计划任务」，
-那时插件改用 `schtasks /run` 拉，父进程是任务计划服务，DSH 重启牵连不到它——代价是 QQ 的寿命从此跟 DSH 脱钩。
+要是反过来想要「DSH 关了 QQ 还活着」，才去填「计划任务名」那一栏（比如 `NapCat-Keeper-Launch`；**留空 = 走 cscript，跟着 DSH 生灭**）+ 勾「自动创建计划任务」，
+那时插件改用 `schtasks /run` 拉，父进程是任务计划服务，DSH 重启牵连不到它。
 
 ## 用哪份 Node：默认借 DSH 自带的
 
@@ -172,8 +172,8 @@ QQ 那条进程链挂在本 DSH 实例下面——DSH 开着它就在，DSH 关
 
 两种 NapCat 装法的区别：
 
-- **Shell 型**（官方 `NapCat.Shell` 包、目录**顶层**有 `napcat.mjs`）：插件会用上面这份 Node 生成 `~/Dsh/napcat-autogen-node.bat` 去跑 `node napcat.mjs` —— 这是 Node 运行时真正派上用场的地方；
-- **注入型**（OneKey 那种，本机就是）：NapCat 跑在 `QQ.exe` 自己的 Node service 里（`--type=utility --utility-sub-type=node.mojom.NodeService`），磁盘上根本没有 `node.exe`，外面的 Node 也替不了它。这条链路插件只负责调 `NapCatWinBootMain.exe`，跟 Node 无关。
+- **Shell 型**（官方 `NapCat.Shell` 包、目录**顶层**有 `napcat.mjs`）：插件会用上面这份 Node 生成 `~/.dsh/napcat-autogen-node.bat` 去跑 `node napcat.mjs` —— 这是 Node 运行时真正派上用场的地方；
+- **注入型**（OneKey 那种）：NapCat 跑在 `QQ.exe` 自己的 Node service 里（`--type=utility --utility-sub-type=node.mojom.NodeService`），磁盘上根本没有 `node.exe`，外面的 Node 也替不了它。这条链路插件只负责调 `NapCatWinBootMain.exe`，跟 Node 无关。
 
 > 顺带一提：`versions\*\resources\app\napcat\napcat.mjs` 那份**不会**被当成入口——它是等 QQ 注入用的，拿普通 Node 直接跑必崩。
 
@@ -201,14 +201,21 @@ QQ 那条进程链挂在本 DSH 实例下面——DSH 开着它就在，DSH 关
 | `accessToken` | 空 | OneBot access token |
 | `taskName` | 空（= 用 cscript，QQ 跟着 DSH 生灭） | 想脱离 DSH 才填计划任务名 |
 | `autoCreateTask` | `false` | 填了 `taskName` 且任务不存在时自动创建 |
+| `hideConsole` | `true` | 拉起时不显示黑框（用 wscript 壳藏窗口） |
 | `probeIntervalSec` | `45` | 复查间隔 |
 | `launchGraceSec` | `150` | 拉起后的宽限期 |
+| `qrFreshSec` | `300` | 二维码新鲜度窗口：比这新 = 还在等人扫 |
 | `scanTimeoutSec` | `300` | 扫码等待上限 |
 | `maxScanRetries` | `2` | 扫码重试上限 |
 | `stuckSec` | `420` | 卡死判定 |
+| `heartbeatSec` | `600` | 一切正常时的心跳日志间隔 |
 | `chainGapSec` | `120` | 重复链判定窗口 |
+| `maxQqPerChain` | `4` | 单条链该有几条 `QQ.exe`，判重时的参考值 |
 | `procPathMatch` | 空（由 shellDir 推两层） | 只在这个路径前缀下找 QQ/NapCat 进程 |
-| `bridgeStaleSec` | `180` | `qq-bridge` 的 state 多久没更新就警告 |
+| `bridgeStaleSec` | `180` | `dsh-qq-bridge` 的 state 多久没更新就警告 |
+| `maxLogBytes` | `1048576` | 日志超这么多字节就滚动一次 |
+
+剩下几个是路径类字段（`configPath` / `logPath` / `launcherLog` / `lockPath` / `statePath` / `qrCopyPath` / `bridgeStatePath`），默认都落在 `~/.dsh/` 下，一般不用碰。
 
 ## 文件都在哪
 
@@ -219,10 +226,14 @@ QQ 那条进程链挂在本 DSH 实例下面——DSH 开着它就在，DSH 关
 ~/.dsh/napcat-keeper-env.bat       只在「记住密码」开启时生成：把密码塞进环境变量给启动脚本
 ~/.dsh/napcat-keeper-state.json    每轮 tick 的状态快照
 ~/.dsh/napcat-qr.png               最近一张二维码副本（扫码时会更新）
+~/.dsh/napcat-autogen-node.bat     Shell 型专用：拿 DSH 自带的 node 跑 napcat.mjs
+~/.dsh/napcat-autogen.bat          没现成启动脚本时生成：直接调 NapCatWinBootMain.exe
 ~/.dsh/napcat-keeper-setup/        提权交接目录：plan.json / apply.ps1 / apply-admin.cmd
                                    / undo-admin.cmd / result.json / run.log / README.txt
 ```
 
+那两份 `napcat-autogen*.bat` 只在需要时出现（每次拉起前按当前配置重写，删掉也会自己长回来）。
+
 ## 出事了先跑体检：`npm run check`
 
 插件整个没加载、DSH 日志里连一个字都不提它、QQ 掉线后再没人拉起来 —— 十有八九是 `package.json` 被动过：BOM、双重编码乱码、或者 JSON 语法坏掉。清单读不动，DSH 连插件代码都不会 import，看门狗自然一起消失。
@@ -238,24 +249,24 @@ npm run check:privacy              # 只查隐私（发版前必跑）
 
 **清单体检**查这几样：清单能不能 `JSON.parse`、有没有 BOM、是不是合法 UTF-8、有没有出现「鐔欑殑澶ц偉楸」这种双重编码乱码、入口文件在不在、清单版本和 `lib/index.js` 里的 `export const version` 同不同步。JSON 坏掉时直接告诉你第几行第几列，并用 `^` 指到那个字符上（位置 899 那种报错不用再数换行）。
 
-**隐私体检**管包里别夹带本机的东西：家目录绝对路径里的真实用户名、私人邮箱（含 QQ 邮箱）、凭据形状（`ghp_` / `npm_` / `sk-` / `AKIA`、实体 Bearer）、DSH 会话 id、fixture 里像真号的账号。命中就 exit 1，指到 `文件:行`；那一行确实要举例说明什么算泄漏的，写 `check-privacy:ignore` 豁免。
+**隐私体检**是发版前那道闸：把包里所有文本文件过一遍，找 Windows / Unix 家目录路径、邮箱、`ghp_` / `npm_` / `sk-` / `AKIA` 这类凭证、`Bearer` 后面的真串、DSH 会话 id，以及自测里那种 `launchAccount: '1234567890'` 的真实 QQ 号。命中就按 `文件:行` 列出来并返回非 0；确实是文档里必须留的示例，在那行末尾写 `check-privacy:ignore` 放过。占位写法（`C:/Users/你/…`、`C:/Users/x/…`）本来就放行。
 
 另外三个自测：`npm run smoke:client`（把 `lib/client.js` 塞进假 React 渲染一遍）、`npm run selftest:scan`（造假树验扫盘判定）、`npm run selftest:setup`（临时目录里真跑一遍 apply / 重跑 / undo）。都不依赖本机路径，clone 下来就能跑。
 
-> **改这个插件的文件的规矩**：别用 `Get-Content` 读、`Set-Content -Encoding utf8` 写 —— PowerShell 5.1 会按 ANSI 读、再按 UTF-8 写，一趟往返中文全变乱码，BOM 还照写。用编辑器另存为「UTF-8 无 BOM」，或者
+> **改这个插件的文件的规矩**：别用 `Get-Content` 读、`Set-Content -Encoding utf8` 写 —— PowerShell 5.1 会按 ANSI 读、再按 UTF-8 写，一趟往返中文全变乱码，BOM 还照写。用编辑器另存为「UTF-8 无 BOM」；非要脚本写，就走
 > `[IO.File]::WriteAllText($path, $text, (New-Object System.Text.UTF8Encoding($false)))`。
 
 ## 常见问题
 
 **「离线」但进程明明还在？**
-端口没通。看 `napcat-keeper-launch.log`多半是卡在扫码，或者 QQ 弹了验证窗。
+端口没通。看 `napcat-keeper-launch.log`，多半是卡在扫码，或者 QQ 弹了验证窗。
 
 **刚关掉 DSH，QQ 就跟着退了？**
 正常，默认就是这样：QQ 挂在 DSH 下面，DSH 一走它就走。下次开 DSH 会重新拉一条。
-想反过来（DSH 关了 QQ 还活着）才去填「计划任务名」+ 勾「自动创建计划任务」。
+想反过来（DSH 关了 NapCat 还活着）去填「计划任务名」+ 勾「自动创建计划任务」。
 
 **两个 QQ 客户端互相踢？**
-去重会兜住，但根因通常是有人手动又点了一次 `napcat.bat`。点「去重复链」立刻收敛。
+去重会兜住，但根因通常是有人又点了一次 `napcat.bat`。点「去重复链」立刻收敛。
 
 **换端口了？**
 改「OneBot HTTP 端口」保存即可；如果同时换了 Shell 目录，跨进程锁会自动清掉。

package/lib/index.js

@@ -1,9 +1,19 @@
 /**
- * dsh-napcat-keeper —— NapCat 看门狗 v2.5.0（可发布通用版）
+ * dsh-napcat-keeper —— NapCat 看门狗 v2.6.0（可发布通用版）
  *
  * 解决的问题：DSH 是桌面应用，重启 DSH 时 NapCat(QQ 协议端) 不会跟着起来，
  * 于是 dsh-qq-bridge 一直轮询一个死端口，你在 QQ 里说的话就石沉大海。
  *
+ * v2.6.0：清死代码 + README 与代码对齐（行为一字没变）
+ *   - 删掉 v2.2.2 起就没人再调用的目录自动探测三件套（looksLikeShellDir / findShellDirs /
+ *     detectShellDir）和只被写过一次的 napcatRoot()：配置不再有「悄悄替你填」的暗路，
+ *     文件也短了 70 行；
+ *   - PowerShell 调用收成 psArgs / runPs / runPsSync 三个薄封装，原先 7 处手抄的
+ *     ['-NoProfile','-NonInteractive','-Command', …] 不再各写一遍（参数漏一个就查半天的那种坑）；
+ *   - README：补回隐私体检那段说明（命令原先悬空）、修正计划任务「留空」的语义、
+ *     把 Shell 型自动生成的 bat 路径写对、配置表补齐 hideConsole / heartbeatSec 等漏掉的键；
+ *   - 发版流程不变：npm run check（清单 + 隐私）+ 三个自测全绿才发。
+ *
  * v2.5.0：统一用 DSH 自带的 Node 运行时
  *   - 以前凡是「要跑一段 JS」的地方都默认那台机器上有 node（或者干脆蹭 NapCat / QQ 的私有环境），
  *     换台机器、换个装法就哑火；现在统一走 resolveNode()：
@@ -62,7 +72,7 @@
  *   - 密码绝不进日志、绝不进 /state 返回值（只回「已保存」和长度）。
  *
  * v2.0.0：从「一台机器专用」改成通用款
- *   - 所有机器相关的路径都不再写死，改为「设置 → napcat桥」里填，或自动探测；
+ *   - 所有机器相关的路径都不再写死，改为「设置 → napcat桥」里填，或点分盘扫描找；
  *   - 新增设置界面（lib/client.js）：状态 / 配置 / 一键动作 / 日志，保存即热生效；
  *   - 计划任务不存在时自动创建（用户级，无需管理员），保证拉起的 QQ 链不随 DSH 退出；
  *   - 只填 QQ 号也能用：自动生成直接调 NapCatWinBootMain.exe 的启动脚本。
@@ -100,7 +110,7 @@ import { homedir, tmpdir } from 'node:os'
 import path from 'node:path'
 
 export const name = 'napcat-keeper'
-export const version = '2.5.0'
+export const version = '2.6.0'
 
 /** tools 用来注册 napcat_* 工具；webServer 用来挂设置界面接口。拿不到也不至于把 DSH 拖崩。 */
 export const inject = ['tools', 'webServer']
@@ -109,7 +119,7 @@ const DEFAULTS = {
   enabled: true,
   /** NapCat Shell 目录（启动脚本所在目录）；不再自动探测，留空就表示还没选 */
   shellDir: '',
-  /** 启动脚本名或绝对路径；留空则自动探测（quick / napcat*.bat） */
+  /** 启动脚本名或绝对路径；留空则在 shellDir 里自动挑（quick / napcat*.bat） */
   launcherScript: '',
   /**
    * Node 运行时（node.exe）的位置；留空 = 自动。
@@ -247,37 +257,6 @@ function writeConfigFile(home, data) {
   return file
 }
 
-/* ---- 自动探测：让新用户不用手填一堆路径 ---------------------------- */
-
-function looksLikeShellDir(dir) {
-  try {
-    if (!statSync(dir).isDirectory()) return false
-  } catch {
-    return false
-  }
-  try {
-    return readdirSync(dir).some((f) => /\.bat$/i.test(f))
-  } catch {
-    return false
-  }
-}
-
-function findShellDirs(root, depth, out) {
-  if (depth < 0 || out.length > 12) return
-  let entries = []
-  try {
-    entries = readdirSync(root, { withFileTypes: true })
-  } catch {
-    return
-  }
-  for (const entry of entries) {
-    if (!entry.isDirectory()) continue
-    const full = path.join(root, entry.name)
-    if (/shell$/i.test(entry.name) && looksLikeShellDir(full)) out.push(full)
-    else findShellDirs(full, depth - 1, out)
-  }
-}
-
 /**
  * 同步跑一条命令抓 stdout。失败一律返回空串 —— 这里全是「问一下系统」的活，
  * 问不到就走兜底，绝不能影响看门狗本身。
@@ -297,6 +276,16 @@ function captureSync(file, args, timeoutMs = 4000) {
   }
 }
 
+/* PowerShell 调用只有一种形状：-NoProfile -NonInteractive -Command <脚本>。
+ * 下面三个薄封装把这段样板收在一处，调用点只剩「脚本 + 超时」，也省得每处手抄漏参数。 */
+const psArgs = (script) => ['-NoProfile', '-NonInteractive', '-Command', script]
+
+/** 同步问一次系统（盘符这种一开机就该知道的廉价查询） */
+const runPsSync = (script, timeoutMs = 4000) => captureSync('powershell.exe', psArgs(script), timeoutMs)
+
+/** 异步跑一段 PowerShell，返回 stdout；失败返回空串 */
+const runPs = (script, timeoutMs = 20000) => runCapture('powershell.exe', psArgs(script), timeoutMs)
+
 /**
  * 本机有哪些盘 —— 系统里有几块就报几块。
  *
@@ -312,12 +301,7 @@ function listDrives() {
     if (match) found.add(`${match[1].toUpperCase()}:`)
   }
 
-  const out = captureSync('powershell.exe', [
-    '-NoProfile',
-    '-NonInteractive',
-    '-Command',
-    '[System.IO.DriveInfo]::GetDrives() | ForEach-Object { $_.Name }',
-  ])
+  const out = runPsSync('[System.IO.DriveInfo]::GetDrives() | ForEach-Object { $_.Name }')
   for (const line of out.split(/\r?\n/)) add(line)
 
   if (!found.size) {
@@ -330,45 +314,6 @@ function listDrives() {
   return [...found].sort()
 }
 
-/**
- * v2.2.2 起已停用：设置页不再替用户「自动探测」目录，只在用户点某个盘时深扫。
- * 函数留着是给 __internals / 调试脚本用，正常运行路径（resolveConfig、/state、/action）
- * 都不会再调用它，配置里的 shellDir 也不会被它悄悄填上。
- */
-function detectShellDir() {
-  const home = homedir()
-  const roots = [
-    path.join(home, 'NapCat'),
-    path.join(home, 'Documents', 'NapCat'),
-    path.join(home, 'Desktop', 'NapCat'),
-    path.join(home, 'Downloads', 'NapCat'),
-    process.env.LOCALAPPDATA ? path.join(process.env.LOCALAPPDATA, 'NapCat') : '',
-    process.env.ProgramData ? path.join(process.env.ProgramData, 'NapCat') : '',
-    process.env.ProgramFiles ? path.join(process.env.ProgramFiles, 'NapCat') : '',
-    'C:\\Program Files (x86)\\NapCat',
-  ].filter(Boolean)
-  for (const drive of listDrives()) {
-    for (const sub of ['NapCat', 'Tools\\NapCat', 'Soft\\NapCat', 'Program Files\\NapCat', 'Program Files (x86)\\NapCat']) {
-      roots.push(`${drive}\\${sub}`)
-    }
-  }
-  for (const root of roots) {
-    const out = []
-    try {
-      if (!statSync(root).isDirectory()) continue
-    } catch {
-      continue
-    }
-    findShellDirs(root, 3, out)
-    if (out.length) {
-      // 有多个就挑路径最短（=层级最浅）的那个
-      out.sort((a, b) => a.length - b.length)
-      return out[0].replace(/\\/g, '/')
-    }
-  }
-  return ''
-}
-
 /* ---- 分盘深扫：用户点「扫 C 盘 / 扫 D 盘」，边扫边报进度 ------------- */
 /**
  * 为什么要有这个：常见位置只有那么几个，装到「D:\Games\NapCat\OneKey\NapCat.x.Shell」
@@ -582,7 +527,8 @@ async function startScan(cfg, driveSpec) {
   }
 }
 
-/** 在 shellDir 里挑启动脚本：先挑「写死了这个 QQ 号」的，其次 quick，其次 napcat*.bat */function detectLauncher(shellDir, account = '') {
+/** 在 shellDir 里挑启动脚本：先挑「写死了这个 QQ 号」的，其次 quick，其次 napcat*.bat */
+function detectLauncher(shellDir, account = '') {
   if (!shellDir) return ''
   let files = []
   try {
@@ -804,11 +750,6 @@ async function probe(cfg) {
 /* 进程链 / 二维码 / 桥接新鲜度                                          */
 /* ------------------------------------------------------------------ */
 
-function napcatRoot(cfg) {
-  // .../NapCat/OneKey/NapCat.52230.Shell -> .../NapCat
-  return path.dirname(path.dirname(cfg.shellDir))
-}
-
 const PS_PROCS =
   "$ErrorActionPreference='SilentlyContinue';" +
   // node 也要算：无头版（Node 包）只有 node.exe 一条进程，没有 QQ.exe
@@ -824,7 +765,7 @@ const PS_PROCS =
  */
 async function probeProcs(cfg) {
   const root = procRoot(cfg)
-  const out = await runCapture('powershell.exe', ['-NoProfile', '-NonInteractive', '-Command', PS_PROCS], 15000)
+  const out = await runPs(PS_PROCS, 15000)
   const result = { boot: 0, qq: 0, chains: 0, dup: false, newestStartMs: 0, chainStarts: [], pids: [], source: 'ps' }
   let list = []
   if (out && out.trim()) {
@@ -1010,7 +951,7 @@ function taskReady(cfg) {
   return state.taskReady
 }
 
-/** 找启动脚本：配置的绝对/相对路径 → 自动探测 → 用 QQ 号现生成一个 */
+/** 找启动脚本：配置的绝对/相对路径 → 在 shellDir 里挑 → 用 QQ 号现生成一个 */
 function resolveLauncherPath(cfg) {
   const raw = String(cfg.launcherScript || '').trim()
   if (raw) {
@@ -1414,7 +1355,7 @@ function ensureTask(cfg) {
     `$t=Get-ScheduledTask -TaskName '${cfg.taskName.replace(/'/g, "''")}';` +
     `if($t){$s=$t.Settings;$s.ExecutionTimeLimit='PT0S';$s.DisallowStartIfOnBatteries=$false;` +
     `$s.StopIfGoingOnBatteries=$false;Set-ScheduledTask -TaskName '${cfg.taskName.replace(/'/g, "''")}' -Settings $s | Out-Null}`
-  void runCapture('powershell.exe', ['-NoProfile', '-NonInteractive', '-Command', ps], 20000)
+  void runPs(ps)
   return { ok: true, created: true }
 }
 
@@ -2073,7 +2014,7 @@ function hideConsoleWindows(cfg) {
     '[void][K.U]::EnumWindows($cb, [IntPtr]::Zero)',
     'Write-Output ("hidden=" + $global:ktHidden + " targets=" + ($global:ktTargets -join ","))',
   ].join('\n')
-  const out = runCapture('powershell.exe', ['-NoProfile', '-NonInteractive', '-Command', ps], 20000)
+  const out = runPs(ps)
   const hidden = /hidden=(\d+)/.exec(String(out || ''))
   const n = hidden ? Number(hidden[1]) : 0
   log(cfg, `hide console: ${n} 个窗口收起`)
@@ -2185,7 +2126,7 @@ async function killNewerChains(cfg, oldestLastMs) {
     'Get-Process QQ,NapCatWinBootMain,node | ' +
     `Where-Object { $_.Path -like '${root}*' -and $_.StartTime -gt $cut } | ` +
     'ForEach-Object { try { Stop-Process -Id $_.Id -Force -ErrorAction Stop } catch {} }'
-  await runCapture('powershell.exe', ['-NoProfile', '-NonInteractive', '-Command', script], 20000)
+  await runPs(script)
 }
 
 /** 杀掉 root 下所有 QQ / NapCatWinBootMain；返回是否真的清干净（没清干净就别拉新链） */
@@ -2200,7 +2141,7 @@ async function killNapcat(cfg) {
     "Get-Process QQ,NapCatWinBootMain,node -ErrorAction SilentlyContinue | " +
     `Where-Object { $_.Path -like '${root}*' } | ` +
     'ForEach-Object { try { Stop-Process -Id $_.Id -Force -ErrorAction Stop } catch {} }'
-  await runCapture('powershell.exe', ['-NoProfile', '-NonInteractive', '-Command', script], 20000)
+  await runPs(script)
   // 等进程真的消失，别在旧客户端还没退干净时就拉新的（这就是互踢的根源）
   for (let i = 0; i < 20; i += 1) {
     const procs = await probeProcs(cfg)
@@ -2211,7 +2152,7 @@ async function killNapcat(cfg) {
   let final = await probeProcs(cfg)
   for (let round = 0; round < 2 && (final.boot > 0 || final.qq > 0); round += 1) {
     log(cfg, `KILL round ${round + 1}: 仍有 boot=${final.boot} qq=${final.qq}，再清一遍`)
-    await runCapture('powershell.exe', ['-NoProfile', '-NonInteractive', '-Command', script], 20000)
+    await runPs(script)
     await sleep(1500)
     final = await probeProcs(cfg)
   }
@@ -3282,7 +3223,6 @@ export const __internals = {
   resolveConfig,
   normalizeConfig,
   doAction,
-  detectShellDir,
   detectLauncher,
   resolveLauncherPath,
   resolveNode,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-napcat-keeper",
-  "version": "2.5.0",
+  "version": "2.6.0",
   "description": "发现没有能够随着dsh打开自动启动napcat的插件，遂使用大肥鱼制作此插件，建议搭配Yuuyuko-uu的dsh-qq-bridge使用~",
   "type": "module",
   "main": "lib/index.js",