dsh-napcat-keeper 0.0.0-stage → 2.0.2

package/CHANGELOG.md

@@ -0,0 +1,47 @@
+# Changelog
+
+## 2.0.2
+
+- `package.json` 补 `repository` / `homepage` / `bugs`，npm 页面能直接跳 GitHub 仓库。
+- 纯元数据变更，功能与 2.0.1 一致。
+
+## 2.0.1 — 桌面不再多一个黑框
+
+- 简介改成：发现没有能够随着 dsh 打开自动启动 napcat 的插件，遂使用大肥鱼制作此插件，建议搭配 Yuuyuko-uu 的 dsh-qq-bridge 使用~；`author` 署名为「熙的大肥鱼」。
+- 发布前清洗：包内不含任何本机信息（QQ 号、昵称、用户名、令牌、会话 id 零命中）；示例路径统一写成 `C:/Users/你/NapCat/...`。
+- **拉起时不再弹出 cmd 黑窗**：计划任务改成先跑一个 `napcat-keeper-launch.vbs`（`sh.Run cmd, 0, False`），控制台以隐藏窗口启动。`hideConsole` 开关可关掉（默认开）。壳文件写在 `~/.dsh/napcat-keeper-launch.vbs`，UTF-16LE 存盘，中文路径也认。
+- 新增动作 `action=hideConsole`，设置页对应按钮「收起黑框」：把已经在跑的 NapCat 控制台窗口收起来（老链条留下的也能收，不用重启 QQ）。
+- `ensureTask` 遇到「任务正在运行、`/f` 覆盖被拒」时会先 `/end` 再重建一次。
+- 修：`taskWrapperPath` 里错用了不存在的 `homeDir()`（现为 `dshHome()`）。
+
+## 2.0.0 — 可以给别人的通用版
+
+- **新增设置界面「设置 → napcat桥」**（`lib/client.js`）：状态卡 + 全部配置项 + 一键动作 + 日志尾部，保存即热生效（不用重启 DSH）。
+- **不再写死任何本机路径**：`shellDir` / `launcherScript` / 进程路径前缀全部改成配置项，留空则自动探测（`~/NapCat`、`Documents/NapCat`、`C:\NapCat`、`%LOCALAPPDATA%\NapCat` …）。
+- **只填 QQ 号也能用**：`launchAccount` 填上后，会自动生成调用 `NapCatWinBootMain.exe <号>` 的启动脚本；探测启动脚本时也优先挑「写死了这个号」的那个 bat。
+- **自动建计划任务**：`autoCreateTask`，用户级、不需要管理员，并把 `ExecutionTimeLimit` 设成不限，避免长跑被任务计划掐断。
+- 新增 HTTP 接口：`/dsh-napcat-keeper/state`、`/save`、`/action`（probe/launch/restart/kill/dedupe/createTask/detect）、`/log`。
+- 修：PowerShell `-like` 只认反斜杠，路径前缀换成 `\` 再传，否则杀进程范围永远匹配不到。
+- 修：设置页保存的配置（`~/.dsh/napcat-keeper-config.json`）优先级最高，其次 cordis 里的 `config`，最后是内置默认。
+
+## 1.1.2
+
+- `killNapcat` 返回「是否真清干净」；没清干净就不拉新链（再拉会互踢），三个调用点都按这个判断走。
+- 在线时每 60s 复查一次重复链，只杀晚启动的那几条（`killNewerChains`）。
+- 版本号统一从 `version` 取，日志里不再写死。
+
+## 1.1.1
+
+- 修：`package.json` / `cordis.patch.yml` / `lib/index.js` 带 UTF-8 BOM 时，Node 的 `JSON.parse` 与 YAML 解析直接报 `Unexpected token ''`，插件装不上。全部改成无 BOM。
+- 改用计划任务拉起，彻底脱离 DSH 进程树（DSH 重启不再带走 QQ）。
+
+## 1.1.0
+
+- 修：重复拉起 —— 两条 QQ 链并存会互踢、掉进扫码态。改为按启动时间聚类判重 + 跨进程锁。
+- 修：卡在扫码不再静默，超时杀掉重来，上限后明确 giveup。
+- 修：杀进程的路径前缀多套了一层，会误伤用户目录下任何 `QQ.exe`。
+- 加：状态快照、二维码副本、心跳日志。
+
+## 1.0.0
+
+- 首个版本：探 OneBot 端口 → 不通就 `cscript` 拉起 `napcat.bat` → 45s 复查。

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 dsh-napcat-keeper contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,148 @@
-# Temporary Holding Version
+# dsh-napcat-keeper
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+发现没有能够随着dsh打开自动启动napcat的插件，遂使用大肥鱼制作此插件，建议搭配[Yuuyuko-uu 的 dsh-qq-bridge](https://github.com/Yuuyuko-uu/dsh-qq-bridge)使用~
+
+给 [NapCat](https://napneko.github.io/)（QQ 协议端）配一个看门狗：**DSH 在，QQ 就在**。
+
+端口不通就拉起来，进程重复就杀掉多余的，卡在扫码就重来，扫完码以后又掉线也会自己恢复。
+所有需要人填的东西都在 **DSH → 设置 → napcat桥** 一个页面里，保存即生效，不用重启。
+
+> 常配套 `dsh-qq-bridge`（把 QQ 和 DSH 会话接通）：那个负责「说话」，这个负责「别掉线」。
+> 也可以单独用——只要你想让 NapCat 一直活着。
+
+---
+
+## 它到底管什么
+
+| 情况 | 看门狗怎么做 |
+| --- | --- |
+| OneBot 端口不通、也没有 NapCat 进程 | 拉起来（优先走计划任务，其次 cscript） |
+| 刚拉起、端口还没通 | 给宽限期（默认 150s），期间不重复拉 |
+| 拉到一半卡在扫码 | 记一笔 `need-scan`；超过 `scanTimeoutSec` 就杀掉重来，重试 `maxScanRetries` 次后放弃并写日志 |
+| 有两条 QQ 进程链（客户端互踢的根源） | 按启动时间聚类判重，只杀晚出现的那几条，保留正在服务的那条 |
+| 进程在、端口不通、也没有任何新信号 | 判为卡死，杀掉重来 |
+| 一切正常 | 只记心跳（默认 10 分钟一行），并顺手检查 `dsh-qq-bridge` 的轮询是否还新鲜 |
+
+看门狗自己不会把 DSH 启动搞崩：外部调用都有超时、异常都吞掉写日志、跨进程还有一把锁防止两个 DSH 实例同时拉。
+
+## 前置：先把 NapCat 装好
+
+1. 装 [NapCat.Shell](https://github.com/NapNeko/NapCatQQ/releases)（Windows 有一键安装包，会顺带装 QQ）。
+2. 打开 NapCat 的 WebUI → **网络配置** → 加一个 **HTTP 服务器**：
+   - host `127.0.0.1`，port `3000`（或你喜欢的端口）
+   - 需要的话设一个 token，记下来
+3. 手动跑一次、扫码登录一次（之后有登录缓存就不用再扫）。
+
+## 安装
+
+```bash
+# 从 npm 装（发布后）
+dsh plugin --profile <profile> add dsh-napcat-keeper
+
+# 或从本地目录装（开发时）
+dsh plugin --profile <profile> add C:\path\to\dsh-napcat-keeper
+```
+
+装完重启一次 DSH（第一次装载才生效），然后去 **设置 → napcat桥**。
+
+## 首次配置：其实就三个空
+
+| 填什么 | 说明 |
+| --- | --- |
+| **NapCat Shell 目录** | 点旁边的「自动探测」多半就填好了；也可手填，例如 `C:/Users/你/NapCat/OneKey/NapCat.<版本>.Shell` |
+| **要快登的 QQ 号** | 填了它，插件优先挑「写死了这个号」的启动脚本；连脚本都没有时，自动生成一个直接调 `NapCatWinBootMain.exe <号>` 的脚本 |
+| **OneBot HTTP 端口** | 跟 NapCat 网络配置里的 httpServers 一致（默认 3000） |
+
+点 **保存设置** → 存到 `~/.dsh/napcat-keeper-config.json`，立刻热生效。
+回「状态」看：在线会显示昵称和 QQ 号；离线就点「拉起 NapCat」。
+
+## 页面上的按钮
+
+| 按钮 | 作用 |
+| --- | --- |
+| 自动探测 | 扫常见位置找 NapCat Shell 目录，找到就填进输入框（尚未保存） |
+| 重新探测 | 立刻跑一轮 tick（探端口 + 探进程） |
+| 拉起 NapCat | 手动下达拉起指令 |
+| 杀掉重拉 | 干净地杀掉整条链再拉一条（杀不干净就不拉，避免互踢） |
+| 去重复链 | 只杀掉晚出现的那几条链，保留最早那条 |
+| 建计划任务 | 现在就把计划任务建好（用户级，不需要管理员） |
+| 收起黑框 | 把已经在跑的控制台窗口藏起来（不用重启 QQ） |
+| 全部杀掉 | 只杀，不拉 |
+
+## 桌面上那个黑框
+
+cscript / cmd 直接拉 NapCat，会多出一个控制台窗口挂在桌面上。默认行为是**不显示**：
+计划任务的动作写的是 `wscript.exe "<dsh家目录>\napcat-keeper-launch.vbs"`，这个壳里用
+`sh.Run cmd, 0, False` 把真正的 cmd 以隐藏窗口启动（`0` = SW_HIDE）。壳文件用 UTF-16LE 存，中文路径也认。
+
+不想要隐藏就把「拉起时不显示黑框」关掉，任务会退回直接跑 `cmd.exe`；已经跑起来的那条链想收窗口，
+点「收起黑框」（`action=hideConsole`）即可。
+
+## 计划任务为什么重要
+
+`napcat.bat` / `NapCatWinBootMain.exe` 拉起的进程链会跟着「拉起它的进程」一起死。
+要是由 DSH 自己 `spawn`，DSH 一重启 QQ 就跟着没——这就是「刚才还好好的，重启完就不通」最常见的原因。
+
+所以默认由计划任务（`NapCat-Keeper-Launch`）来拉，父进程是任务计划服务，DSH 重启牵连不到。
+任务不存在时插件自动创建，也可以点「建计划任务」；不想用就把「自动创建计划任务」和「计划任务名」清掉，退回 cscript（能用，但 DSH 退出会带走 QQ）。
+
+## 给 agent 用的三个工具
+
+| 工具 | 作用 |
+| --- | --- |
+| `napcat_status` | 端口/登录态、进程链、二维码副本路径、桥接心跳、日志尾部 |
+| `napcat_restart` | 干净地杀掉整条链并重拉，然后等它上线 |
+| `napcat_dedupe` | 只在真有重复链时才杀（没重复就什么都不做） |
+
+## 配置项
+
+| 键 | 默认 | 说明 |
+| --- | --- | --- |
+| `enabled` | `true` | 总开关；关掉只保留状态观察，不自动拉也不自动杀 |
+| `shellDir` | 自动探测 | NapCat Shell 目录（启动脚本所在目录） |
+| `launcherScript` | 自动探测 | 启动脚本名或绝对路径 |
+| `launchAccount` | 空 | 想快登的 QQ 号 |
+| `launchArgs` | 空 | 追加给启动脚本的参数 |
+| `onebotPort` | `3000` | OneBot 11 HTTP 端口 |
+| `accessToken` | 空 | OneBot access token |
+| `taskName` | `NapCat-Keeper-Launch` | 负责拉起的计划任务名，留空 = 不用 |
+| `autoCreateTask` | `true` | 任务不存在时自动创建 |
+| `probeIntervalSec` | `45` | 复查间隔 |
+| `launchGraceSec` | `150` | 拉起后的宽限期 |
+| `scanTimeoutSec` | `300` | 扫码等待上限 |
+| `maxScanRetries` | `2` | 扫码重试上限 |
+| `stuckSec` | `420` | 卡死判定 |
+| `chainGapSec` | `120` | 重复链判定窗口 |
+| `procPathMatch` | 空（由 shellDir 推两层） | 只在这个路径前缀下找 QQ/NapCat 进程 |
+| `bridgeStaleSec` | `180` | `qq-bridge` 的 state 多久没更新就警告 |
+
+## 文件都在哪
+
+```
+~/.dsh/napcat-keeper.log           看门狗日志（超 1MB 自动滚动）
+~/.dsh/napcat-keeper-launch.log    启动脚本的原始输出（扫码提示都在这）
+~/.dsh/napcat-keeper-config.json   设置页保存的配置
+~/.dsh/napcat-keeper-state.json    每轮 tick 的状态快照
+~/.dsh/napcat-qr.png               最近一张二维码副本（扫码时会更新）
+```
+
+## 常见问题
+
+**「离线」但进程明明还在？**
+端口没通。看 `napcat-keeper-launch.log`——多半是卡在扫码，或者 QQ 弹了验证窗。
+
+**刚重启 DSH，QQ 就掉了？**
+说明这条链还是 DSH 拉起来的。填上「计划任务名」、点「建计划任务」，以后交给任务计划服务。
+
+**两个 QQ 客户端互相踢？**
+去重会兜住，但根因通常是有人手动又点了一次 `napcat.bat`。点「去重复链」立刻收敛。
+
+**换端口了？**
+改「OneBot HTTP 端口」保存即可；如果同时换了 Shell 目录，跨进程锁会自动清掉。
+
+**能在 Linux / macOS 上用吗？**
+看门狗本身是 node 实现，但「进程路径探测 / 计划任务 / cscript」这几处是为 Windows 写的；其它平台目前只保证「探端口 + 判活」这一条路。
+
+## License
+
+MIT

package/cordis.patch.yml

@@ -0,0 +1,27 @@
+# dsh-napcat-keeper 的 bundle patch：把看门狗这一行插进 profile 的插件名册。
+# 装法：dsh plugin --profile <profile> add <本目录或 npm 包名>
+#      （bundle patch 会自动应用，别再在 profile 的 cordis.patch.yml 里手插一遍，重复 id 会让 loader 崩）
+#
+# 这里的 config 只是「初始默认」。装完之后请在
+#   DSH → 设置 → napcat桥
+# 里填配置并保存 —— 那份（~/.dsh/napcat-keeper-config.json）优先级更高，
+# 改完立刻生效，不用重启 DSH。
+- insert:
+    - id: napcat-keeper
+      name: 'dsh-napcat-keeper'
+      config:
+        enabled: true
+        # ↓ 全部可留空 = 自动探测；下面这些只是给「不想用界面」的人参考的字段
+        # shellDir: 'C:/Users/你/NapCat/OneKey/NapCat.<版本>.Shell'
+        # launcherScript: 'napcat.quick.bat'
+        # launchAccount: '10001'
+        # onebotPort: 3000
+        # accessToken: ''
+        # taskName: 'NapCat-Keeper-Launch'
+        # autoCreateTask: true
+        # probeIntervalSec: 45
+        # launchGraceSec: 150
+        # scanTimeoutSec: 300
+        # maxScanRetries: 2
+        # stuckSec: 420
+        # chainGapSec: 120

package/lib/client.js

@@ -0,0 +1,345 @@
+// DSH「napcat桥」· 网页半边
+//
+// 在 **设置 → napcat桥** 里：看状态、填配置、点一下就能探测/拉起/杀掉重拉。
+// 这里不碰会话、不碰进程，只是往宿主那几条 /dsh-napcat-keeper/* 路由上读写。
+//
+// 对第一次用的人：只要三个空 —— NapCat Shell 目录、QQ 号、OneBot 端口，
+// 保存完就能用；其它都能自动探测。
+
+window.__ModuleLoader__.load({
+  id: 'dsh-napcat-keeper',
+  factory: (require) => {
+    var module = { exports: {} }
+    var exports = module.exports
+
+    const React = require('react')
+    const inject = ['slots']
+
+    const B = '/dsh-napcat-keeper'
+    const get = (p) => fetch(B + p, { cache: 'no-store' }).then((r) => r.json()).catch(() => null)
+    const post = (p, body) =>
+      fetch(B + p, {
+        method: 'POST',
+        headers: { 'content-type': 'application/json' },
+        body: JSON.stringify(body || {}),
+      })
+        .then((r) => r.json())
+        .catch(() => null)
+
+    const h = React.createElement
+
+    const S = {
+      wrap: {
+        padding: '12px 14px 24px',
+        fontSize: 13,
+        lineHeight: 1.7,
+        background: 'var(--dsw-alias-bg-layer-1, rgba(255,255,255,.92))',
+        border: '1px solid var(--dsw-alias-border-l1, rgba(0,0,0,.08))',
+        borderRadius: 12,
+      },
+      h: { fontSize: 14, fontWeight: 600, margin: '18px 0 8px' },
+      dim: { opacity: 0.62, fontSize: 12 },
+      card: {
+        border: '1px solid var(--dsw-alias-border-l2)',
+        borderRadius: 8,
+        padding: '10px 12px',
+        marginBottom: 10,
+        background: 'var(--dsw-alias-bg-layer-1)',
+      },
+      row: { display: 'flex', gap: 10, alignItems: 'flex-start', marginBottom: 10, flexWrap: 'wrap' },
+      lab: { minWidth: 200, paddingTop: 4, fontSize: 12.5 },
+      ctl: { flex: '1 1 300px', minWidth: 220 },
+      hint: { opacity: 0.6, fontSize: 11.5, marginTop: 3 },
+      input: {
+        border: '1px solid var(--dsw-alias-border-l2)',
+        borderRadius: 6,
+        padding: '5px 8px',
+        background: 'transparent',
+        color: 'inherit',
+        fontSize: 12.5,
+        width: '100%',
+        boxSizing: 'border-box',
+        fontFamily: 'inherit',
+      },
+      btn: {
+        border: '1px solid var(--dsw-alias-border-l2)',
+        borderRadius: 6,
+        padding: '4px 12px',
+        background: 'transparent',
+        color: 'inherit',
+        fontSize: 12.5,
+        cursor: 'pointer',
+      },
+      btnOn: {
+        border: '1px solid #2f6f4f',
+        borderRadius: 6,
+        padding: '4px 12px',
+        background: '#2f6f4f',
+        color: '#fff',
+        fontSize: 12.5,
+        cursor: 'pointer',
+      },
+      ok: { color: '#2f8f5b', fontWeight: 600 },
+      bad: { color: '#c0392b', fontWeight: 600 },
+      warn: { color: '#b8860b', fontWeight: 600 },
+      kv: { display: 'grid', gridTemplateColumns: 'auto 1fr', gap: '4px 14px', fontSize: 12.5 },
+      log: {
+        fontFamily: 'ui-monospace, Consolas, monospace',
+        fontSize: 11.5,
+        lineHeight: 1.5,
+        maxHeight: 220,
+        overflow: 'auto',
+        whiteSpace: 'pre-wrap',
+        wordBreak: 'break-all',
+        margin: 0,
+        padding: '8px 10px',
+        border: '1px solid var(--dsw-alias-border-l2)',
+        borderRadius: 8,
+        background: 'rgba(0,0,0,.03)',
+      },
+      float: {
+        position: 'sticky',
+        bottom: 0,
+        display: 'flex',
+        gap: 10,
+        alignItems: 'center',
+        marginTop: 12,
+        padding: '8px 12px',
+        borderRadius: 8,
+        border: '1px solid #c0392b',
+        background: 'var(--dsw-alias-bg-layer-1, #fff)',
+      },
+    }
+
+    const 字段 = [
+      {
+        group: '连接',
+        note: '这三项填完就能跑：NapCat 装在哪、要拉哪个 QQ、OneBot 开在哪个端口。',
+        items: [
+          ['shellDir', 'NapCat Shell 目录', '例如 C:/Users/你/NapCat/OneKey/NapCat.<版本>.Shell —— 里面有 napcat*.bat', 'text', true],
+          ['launcherScript', '启动脚本', '留空自动挑（quick 优先，其次 napcat*.bat）', 'text'],
+          ['launchAccount', '要快登的 QQ 号', '填了它、脚本又找不到时，会自动生成一个直接调 NapCatWinBootMain.exe 的脚本', 'text'],
+          ['onebotPort', 'OneBot HTTP 端口', 'NapCat 里 onebot11 的 httpServers 端口，默认 3000', 'number', true],
+          ['accessToken', 'OneBot 访问令牌', '没设就留空；设了要跟 NapCat 里填的一致', 'password'],
+        ],
+      },
+      {
+        group: '看护行为',
+        note: '',
+        items: [
+          ['enabled', '开启自动看护', '关掉 = 只留着看状态，不自动拉也不自动杀', 'bool'],
+          ['autoCreateTask', '自动创建计划任务', '让拉起的 QQ 链挂在任务计划服务下面，DSH 重启不会把它带走', 'bool'],
+          ['hideConsole', '拉起时不显示黑框', '用 wscript 壳把控制台窗口藏起来，桌面上不会多出那个 cmd 窗口', 'bool'],
+          ['taskName', '计划任务名', '留空 = 不用计划任务，退回 cscript 拉起（DSH 一退 QQ 就跟着退）', 'text'],
+          ['probeIntervalSec', '复查间隔（秒）', '多久检查一次端口通不通', 'number'],
+          ['launchGraceSec', '拉起后宽限期（秒）', '刚拉起时端口还没通，这期间不重复拉', 'number'],
+        ],
+      },
+      {
+        group: '高级',
+        note: '一般不用动。',
+        items: [
+          ['scanTimeoutSec', '扫码等待上限（秒）', '卡在扫码超过这个时间就杀掉重来', 'number'],
+          ['maxScanRetries', '扫码重试上限', '重试这么多次还不行就放弃并记日志，不再反复杀进程', 'number'],
+          ['stuckSec', '卡死判定（秒）', '进程在、端口不通、又没有任何新信号，判为卡死', 'number'],
+          ['chainGapSec', '重复链判定窗口（秒）', '两批 QQ 进程启动时间相隔超过它才算两条链', 'number'],
+          ['procPathMatch', '进程路径前缀', '留空 = 由 Shell 目录往上两层推导；填错会导致看不到进程', 'text'],
+        ],
+      },
+    ]
+
+    const 全部键 = 字段.reduce((acc, g) => acc.concat(g.items.map((i) => i[0])), [])
+
+    function 取(obj, key) {
+      return obj && Object.prototype.hasOwnProperty.call(obj, key) ? obj[key] : ''
+    }
+
+    function 状态条(runtime) {
+      if (!runtime) return null
+      const 在 = runtime.online
+      return h('div', { style: S.card },
+        h('div', { style: { display: 'flex', gap: 14, alignItems: 'center', flexWrap: 'wrap' } },
+          h('span', { style: 在 ? S.ok : S.bad }, 在 ? '● 在线' : '○ 离线'),
+          在 ? h('span', null, String(runtime.nickname || '') + '（' + String(runtime.userId || '') + '）') : null,
+          h('span', { style: S.dim }, '阶段：' + String(runtime.phase || '?')),
+          h('span', { style: S.dim }, '启动 ' + String(runtime.launchCount || 0) + ' 次'),
+          runtime.dedupeCount ? h('span', { style: S.dim }, '去重 ' + String(runtime.dedupeCount) + ' 次') : null,
+        ),
+        h('div', { style: { ...S.kv, marginTop: 8 } },
+          h('span', { style: S.dim }, '进程'),
+          h('span', null,
+            'NapCatWinBootMain ' + String((runtime.procs && runtime.procs.boot) || 0) +
+            ' ｜ QQ ' + String((runtime.procs && runtime.procs.qq) || 0) +
+            ' ｜ 链 ' + String((runtime.procs && runtime.procs.chains) || 0) +
+            (runtime.procs && runtime.procs.dup ? ' ⚠ 有重复链' : '')),
+          h('span', { style: S.dim }, '路径前缀'),
+          h('span', { style: { wordBreak: 'break-all' } }, String(runtime.procRoot || '（空）')),
+          h('span', { style: S.dim }, '启动脚本'),
+          h('span', { style: { wordBreak: 'break-all' } }, String(runtime.launcherFound || '⚠ 没找到')),
+          h('span', { style: S.dim }, '计划任务'),
+          h('span', null, String(runtime.taskName || '（不用）') + (runtime.taskReady ? ' ✓ 就绪' : '（还没建）')),
+          h('span', { style: S.dim }, '二维码'),
+          h('span', null, runtime.qr ? '最新一张 ' + String(runtime.qr.ageSec) + ' 秒前' : '还没有（没进扫码态）'),
+          h('span', { style: S.dim }, '桥接心跳'),
+          h('span', null, runtime.bridge && runtime.bridge.ageSec !== null ? String(runtime.bridge.ageSec) + ' 秒前' : '没读到'),
+        ),
+        runtime.error ? h('div', { style: { ...S.bad, marginTop: 6 } }, '最近错误：' + String(runtime.error)) : null,
+      )
+    }
+
+    function Section() {
+      const [态, set态] = React.useState(null)
+      const [草, set草] = React.useState(null)
+      const [忙, set忙] = React.useState(false)
+      const [说, set说] = React.useState('')
+      const [开日志, set开日志] = React.useState(false)
+
+      const 装 = (data) => {
+        set态(data)
+        if (data && data.config) {
+          const base = {}
+          全部键.forEach((k) => {
+            base[k] = 取(data.config, k)
+          })
+          set草(base)
+        }
+      }
+
+      React.useEffect(() => {
+        get('/state').then((d) => d && 装(d))
+      }, [])
+
+      const 脏 = Boolean(态 && 草 && 全部键.some((k) => String(取(草, k)) !== String(取(态.config, k))))
+
+      const 存 = async () => {
+        if (!草 || 忙) return
+        set忙(true)
+        const r = await post('/save', { patch: 草 })
+        if (r) 装(r)
+        set说(r && r.config ? '设置已保存并生效' : '保存失败，看看日志')
+        set忙(false)
+      }
+
+      const 动 = async (doIt) => {
+        if (忙) return
+        set忙(true)
+        set说('执行中：' + doIt + ' …')
+        const r = await post('/action', { do: doIt })
+        if (r) 装(r)
+        set说((r && r.said) || '做完了')
+        set忙(false)
+      }
+
+      const 探测 = async () => {
+        set忙(true)
+        const r = await post('/action', { do: 'detect' })
+        if (r) {
+          装(r)
+          if (r.extra) set草((prev) => ({ ...(prev || {}), shellDir: r.extra }))
+        }
+        set说((r && r.said) || '探测完了')
+        set忙(false)
+      }
+
+      if (!态) {
+        return h('div', { style: S.wrap }, h('div', { style: S.dim }, '正在读取 napcat 看门狗状态 …'))
+      }
+
+      const 改 = (k, v) => set草((prev) => ({ ...(prev || {}), [k]: v }))
+
+      const 渲染项 = (item) => {
+        const [key, label, hint, type] = item
+        const val = 取(草, key)
+        let ctl
+        if (type === 'bool') {
+          ctl = h('label', { style: { display: 'flex', gap: 6, alignItems: 'center', fontSize: 12.5 } },
+            h('input', {
+              type: 'checkbox',
+              checked: val !== false && String(val) !== 'false',
+              onChange: (e) => 改(key, e.target.checked),
+            }),
+            h('span', null, val !== false && String(val) !== 'false' ? '开' : '关'))
+        } else {
+          ctl = h('input', {
+            style: S.input,
+            type: type === 'number' ? 'number' : type === 'password' ? 'password' : 'text',
+            value: val === null || val === undefined ? '' : String(val),
+            placeholder: type === 'number' ? '' : '留空 = 自动',
+            spellCheck: false,
+            onChange: (e) => 改(key, type === 'number' ? e.target.value : e.target.value),
+          })
+        }
+        return h('div', { style: S.row, key },
+          h('div', { style: S.lab },
+            h('div', null, label),
+            hint ? h('div', { style: S.hint }, hint) : null),
+          h('div', { style: S.ctl },
+            ctl,
+            key === 'shellDir' ? h('div', { style: { marginTop: 6 } },
+              h('button', { type: 'button', style: S.btn, onClick: 探测, disabled: 忙 }, '自动探测')) : null),
+        )
+      }
+
+      return h('div', { style: S.wrap },
+        h('div', { style: S.h }, 'napcat桥'),
+        h('div', { style: S.dim },
+          '让 NapCat（QQ 协议端）跟着 DSH 一起活着：不通就拉、重复就杀、卡住就重来。'
+            + '版本 ' + String(态.version || '?') + '｜配置：' + String(取(态.config, 'configPath'))),
+
+        状态条(态.runtime),
+
+        h('div', { style: { display: 'flex', gap: 8, flexWrap: 'wrap', margin: '10px 0' } },
+          h('button', { type: 'button', style: S.btn, disabled: 忙, onClick: () => 动('probe') }, '重新探测'),
+          h('button', { type: 'button', style: S.btn, disabled: 忙, onClick: () => 动('launch') }, '拉起 NapCat'),
+          h('button', { type: 'button', style: S.btn, disabled: 忙, onClick: () => 动('restart') }, '杀掉重拉'),
+          h('button', { type: 'button', style: S.btn, disabled: 忙, onClick: () => 动('dedupe') }, '去重复链'),
+          h('button', { type: 'button', style: S.btn, disabled: 忙, onClick: () => 动('createTask') }, '建计划任务'),
+          h('button', { type: 'button', style: S.btn, disabled: 忙, onClick: () => 动('hideConsole') }, '收起黑框'),
+          h('button', { type: 'button', style: S.btn, disabled: 忙, onClick: () => 动('kill') }, '全部杀掉'),
+        ),
+        说 ? h('div', { style: { ...S.dim, marginBottom: 6 } }, 说) : null,
+
+        字段.map((g) => h('div', { key: g.group },
+          h('div', { style: S.h }, g.group),
+          g.note ? h('div', { style: { ...S.dim, marginBottom: 8 } }, g.note) : null,
+          g.items.map(渲染项),
+        )),
+
+        h('div', { style: S.h }, '日志'),
+        h('div', { style: { display: 'flex', gap: 8, marginBottom: 6 } },
+          h('button', { type: 'button', style: S.btn, onClick: () => set开日志(!开日志) }, 开日志 ? '收起' : '展开'),
+          h('button', {
+            type: 'button',
+            style: S.btn,
+            onClick: () => get('/log?lines=200').then((d) => {
+              if (d && d.lines) set态((prev) => ({ ...prev, log: d.lines }))
+            }),
+          }, '刷新'),
+          h('span', { style: S.dim }, String(取(态.config, 'logPath'))),
+        ),
+        开日志 ? h('pre', { style: S.log }, (态.log || []).join('\n') || '（还没有日志）') : null,
+
+        脏 ? h('div', { style: S.float },
+          h('span', { style: S.bad }, '⚠ 有改动还没保存'),
+          h('span', { style: S.dim }, '改完点右边就行，保存后立刻生效，不用重启 DSH'),
+          h('button', { type: 'button', style: S.btnOn, onClick: 存, disabled: 忙 }, 忙 ? '保存中…' : '保存设置'),
+        ) : h('div', { style: { ...S.dim, marginTop: 12 } }, '设置已同步 ✓'),
+      )
+    }
+
+    function apply(ctx) {
+      const slots = ctx.get('slots')
+      if (slots === undefined) return
+      slots.inject('settings.section', () =>
+        slots.register(
+          { name: 'settings.section', id: 'napcat-keeper', order: 53, label: () => 'napcat桥' },
+          Section,
+        ),
+      )
+    }
+
+    exports.apply = apply
+    exports.inject = inject
+    return module.exports
+  },
+})