dsh-napcat-keeper 2.6.0 → 2.7.0

package/CHANGELOG.md

@@ -1,5 +1,29 @@
 # Changelog
 
+## 2.7.0 — 插件自己的文件收进 `~/.dsh/dsh-napcat-keeper/`
+- **为什么要动这个**：以前插件产生的东西全都摊在 `~/.dsh` 根上（配置、日志、状态、二维码、生成的 bat/vbs、提权脚本），和 DSH 自己的 `AGENT.md`、`profiles/`、一堆别的插件的文件混在一起，压根看不出哪些是它写的。现在一个目录装完自己的全部家当。
+- **新布局**（`~/.dsh/dsh-napcat-keeper/`）：
+
+  | 文件 | 是什么 | 老名字 |
+  | --- | --- | --- |
+  | `config.json` | 设置页存下来的配置 | `napcat-keeper-config.json` |
+  | `keeper.log` | 看门狗自己的日志 | `napcat-keeper.log` |
+  | `launch.log` | 拉起 QQ 那一路的输出 | `napcat-keeper-launch.log` |
+  | `state.json` | 给人看的运行状态快照 | `napcat-keeper-state.json` |
+  | `lock.json` | 跨进程拉起锁 | `napcat-keeper.lock.json` |
+  | `qr.png` | 待扫二维码的副本 | `napcat-qr.png` |
+  | `env.bat` | 「记住密码」中间层（含密码明文） | `napcat-keeper-env.bat` |
+  | `launch.vbs` | 无窗口壳，计划任务调它 | `napcat-keeper-launch.vbs` |
+  | `autogen.bat` / `autogen-node.bat` | 自动生成的启动脚本 | `napcat-autogen*.bat` |
+  | `setup/` | 提权交接脚本（apply.ps1 等） | `napcat-keeper-setup/` |
+  | `legacy/` | 老版本遗留的配置备份等，不参与运行 | —（原来散在根上） |
+
+- **自动搬迁**：`migrateLegacyFiles()` 在启动解析配置时跑一次，能 rename 就 rename（同卷原子），跨卷才退回复制再删；目标已存在时不动旧文件，旧文件自己会落到 `legacy/`。已经搬过就不再重复（按目录记住）。
+- **计划任务跟着改**：任务动作里写死的是 `wscript.exe "<vbs>"` 这种绝对路径，文件搬家后指向不存在的脚本 = 开机静默失败。新增 `repairTaskActions()`：只在动作对不上时用 `schtasks /change /tr` 就地改一次，**不 `/end`**，正在跑的 QQ 不会被踢下线。
+- **不搬的**：`qq-bridge-state.json` 属于 `dsh-qq-bridge`（我们只是读一下它的时间戳），`profiles/`、`package.json` 属于 DSH 自身，全都留在原地。
+- **验证**：`npm run smoke:client` PASS、`selftest:scan` 15/15、`selftest:setup` 45 通过 0 失败、`npm run check`（清单 + 隐私）双绿；真实环境里跑一次搬迁，配置/日志/二维码/中间层全部落到新目录，`napcat_status` 仍在线。
+- 版本 2.7.0。
+
 ## 2.6.0 — 清死代码 + README 与代码对齐
 - **删掉的死代码**（都确认过没有任何调用点，删了行为不变）：
   - v2.2.2 起停用的目录自动探测三件套 `looksLikeShellDir()` / `findShellDirs()` / `detectShellDir()` —— 从那次起 `shellDir` 只认用户在设置页选的，这几个函数只被彼此和调试用的 `__internals` 引用；

package/README.md

@@ -54,7 +54,7 @@ dsh plugin --profile <profile> add dsh-napcat-keeper
 | **要快登的 QQ 号** | 填了它，插件优先挑「填的这个号」的启动脚本；连脚本都没有时，自动生成一个直接调 `NapCatWinBootMain.exe <号>` 的脚本 |
 | **OneBot HTTP 端口** | 跟 NapCat 网络配置里的 httpServers 一致（默认 3000） |
 
-点 **保存设置** → 存到 `~/.dsh/napcat-keeper-config.json`，立刻热生效。
+点 **保存设置** → 存到 `~/.dsh/dsh-napcat-keeper/config.json`，立刻热生效。
 回「状态」看：在线会显示昵称和 QQ 号；离线就点「拉起 NapCat」。
 
 ## 分盘扫描：装在哪都能找到
@@ -115,7 +115,7 @@ DSH 自己是普通权限。插件要碰「装系统的位置」（往防火墙
 | 事 | 会做什么 | 要不要管理员 |
 | --- | --- | --- |
 | 自动启动脚本 | 在 `shellDir` 里补一个 `napcat.quick.auto.bat`（写死账号和 `NapCatWinBootMain.exe` 路径） | 看那个目录你能不能写，不能写才需要 |
-| 中间层 | 写 `napcat-keeper-env.bat`：把密码塞进环境变量再 call 启动脚本 | 不需要 |
+| 中间层 | 写 `env.bat`：把密码塞进环境变量再 call 启动脚本 | 不需要 |
 | 计划任务 | 用 `schtasks` 建用户级任务（要不要隐藏黑框跟着设置走） | 不需要 |
 | 防火墙放行 | `New-NetFirewallRule` 放行 OneBot 端口入站 | 需要 |
 
@@ -126,7 +126,7 @@ DSH 自己是普通权限。插件要碰「装系统的位置」（往防火墙
 ## 桌面上那个黑框
 
 cscript / cmd 直接拉 NapCat，会多出一个控制台窗口挂在桌面上。默认行为是**不显示**：
-计划任务的动作写的是 `wscript.exe "<DSH 家目录>\napcat-keeper-launch.vbs"`，这个壳里用
+计划任务的动作写的是 `wscript.exe "<DSH 家目录>\dsh-napcat-keeper\launch.vbs"`（绝对路径），这个壳里用
 `sh.Run cmd, 0, False` 把真正的 cmd 以隐藏窗口启动（`0` = SW_HIDE）。壳文件用 UTF-16LE 存，中文路径也认。
 
 不想要隐藏就把「拉起时不显示黑框」关掉，任务会退回直接跑 `cmd.exe`；已经跑起来的那条链想收窗口，
@@ -139,7 +139,7 @@ NapCat 的**快速登录令牌会失效**（实测几小时左右），失效后
 
 设置页「自动登录（可不填）」里勾 **记住密码** 时会先弹一段风险提示，要你自己点「我知道风险，仍然开启」才会生效。开启前请确认你接受这几条：
 
-1. 密码以**明文**存进 `~/.dsh/napcat-keeper-config.json` 和插件生成的 `napcat-keeper-env.bat`，不加密。
+1. 密码以**明文**存进 `~/.dsh/dsh-napcat-keeper/config.json` 和同目录下插件生成的 `env.bat`，不加密。
 2. 任何能读你用户目录的程序都能捡走：同步盘、备份工具、其它软件、远控、临时借电脑的人。
 3. QQ 密码往往和 QQ 邮箱、部分游戏、微信登录入口共用一套身份，泄漏面不止一个号。
 4. 插件不打印密码，`/state` 也只回「存没存 + 长度」，但那只是少开一个口子，不等于安全。
@@ -172,7 +172,7 @@ QQ 那条进程链挂在本 DSH 实例下面——DSH 开着它就在，DSH 关
 
 两种 NapCat 装法的区别：
 
-- **Shell 型**（官方 `NapCat.Shell` 包、目录**顶层**有 `napcat.mjs`）：插件会用上面这份 Node 生成 `~/.dsh/napcat-autogen-node.bat` 去跑 `node napcat.mjs` —— 这是 Node 运行时真正派上用场的地方；
+- **Shell 型**（官方 `NapCat.Shell` 包、目录**顶层**有 `napcat.mjs`）：插件会用上面这份 Node 生成 `~/.dsh/dsh-napcat-keeper/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 直接跑必崩。
@@ -215,24 +215,32 @@ QQ 那条进程链挂在本 DSH 实例下面——DSH 开着它就在，DSH 关
 | `bridgeStaleSec` | `180` | `dsh-qq-bridge` 的 state 多久没更新就警告 |
 | `maxLogBytes` | `1048576` | 日志超这么多字节就滚动一次 |
 
-剩下几个是路径类字段（`configPath` / `logPath` / `launcherLog` / `lockPath` / `statePath` / `qrCopyPath` / `bridgeStatePath`），默认都落在 `~/.dsh/` 下，一般不用碰。
+剩下几个是路径类字段（`configPath` / `logPath` / `launcherLog` / `lockPath` / `statePath` / `qrCopyPath` / `bridgeStatePath`），默认都落在 `~/.dsh/dsh-napcat-keeper/` 下（`bridgeStatePath` 例外，那是 `dsh-qq-bridge` 的文件，留在 `~/.dsh/` 根上），一般不用碰。
 
 ## 文件都在哪
 
+插件产生的东西全在 `~/.dsh/dsh-napcat-keeper/` 一个目录里，DSH 自己的目录不会被它塞满：
+
 ```
-~/.dsh/napcat-keeper.log           看门狗日志（超 1MB 自动滚动）
-~/.dsh/napcat-keeper-launch.log    启动脚本的原始输出（扫码提示都在这）
-~/.dsh/napcat-keeper-config.json   设置页保存的配置
-~/.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
+~/.dsh/dsh-napcat-keeper/
+├── config.json         设置页保存的配置
+├── keeper.log          看门狗日志（超 1MB 自动滚动）
+├── launch.log          启动脚本的原始输出（扫码提示都在这）
+├── state.json          每轮 tick 的状态快照
+├── lock.json           跨进程拉起锁（防两个 DSH 同时拉）
+├── qr.png              最近一张二维码副本（扫码时更新）
+├── env.bat             只在「记住密码」开启时生成：把密码塞进环境变量给启动脚本
+├── launch.vbs          「自动创建计划任务」时生成的无窗口壳，计划任务调它
+├── autogen-node.bat    Shell 型专用：拿 DSH 自带的 node 跑 napcat.mjs
+├── autogen.bat         没现成启动脚本时生成：直接调 NapCatWinBootMain.exe
+├── setup/              提权交接目录：plan.json / apply.ps1 / apply-admin.cmd
+│                       / undo-admin.cmd / result.json / run.log / README.txt
+└── legacy/             老版本遗留的配置备份等，不参与运行，整个删掉也没事
 ```
 
-那两份 `napcat-autogen*.bat` 只在需要时出现（每次拉起前按当前配置重写，删掉也会自己长回来）。
+- `env.bat` 只在「记住密码」开启时才有；两份 `autogen*.bat` 只在需要时出现（每次拉起前按当前配置重写，删掉也会自己长回来）。整个目录删掉 = 插件回到没配置过的状态。
+- **从老版本升上来（< 2.7.0）**：第一次启动会自动把原来散在 `~/.dsh` 根上的文件搬进这个目录（`napcat-keeper-config.json` → `config.json` 这种），改名一次就固定；计划任务里写死的旧路径也会一并改指新位置 —— 那一步用 `schtasks /change` 就地改，不结束正在跑的 QQ。老备份之类的零碎挪进 `legacy/`。
+- `~/.dsh/qq-bridge-state.json` **不在**这个目录里，也不归这个插件：它由 `dsh-qq-bridge` 写，插件只是读一下它的时间戳，判断那边轮询还活着没有。
 
 ## 出事了先跑体检：`npm run check`
 
@@ -259,7 +267,7 @@ npm run check:privacy              # 只查隐私（发版前必跑）
 ## 常见问题
 
 **「离线」但进程明明还在？**
-端口没通。看 `napcat-keeper-launch.log`，多半是卡在扫码，或者 QQ 弹了验证窗。
+端口没通。看 `~/.dsh/dsh-napcat-keeper/launch.log`，多半是卡在扫码，或者 QQ 弹了验证窗。
 
 **刚关掉 DSH，QQ 就跟着退了？**
 正常，默认就是这样：QQ 挂在 DSH 下面，DSH 一走它就走。下次开 DSH 会重新拉一条。

package/lib/client.js

@@ -253,7 +253,7 @@ window.__ModuleLoader__.load({
             setTimeout(拉, 900)
             return
           }
-          set说('接口没响应，读不到状态（日志见 ~/.dsh/napcat-keeper.log）')
+          set说('接口没响应，读不到状态（日志见 ~/.dsh/dsh-napcat-keeper/keeper.log）')
           set态({ ok: false, config: null, runtime: {}, scan: {}, drives: [], log: [] })
         }
         拉()
@@ -576,7 +576,7 @@ window.__ModuleLoader__.load({
 
       /* ---------- 「记住密码」那一块：先讲风险，再让人自己决定 ---------- */
       const 风险条目 = [
-        '密码会以明文写进本机两个地方：~/.dsh/napcat-keeper-config.json，以及插件生成的 napcat-keeper-env.bat。不加密、不做任何变换（MD5 那份是给 NapCat 兜底用的，同样等于密码）。',
+        '密码会以明文写进本机两个地方：~/.dsh/dsh-napcat-keeper/config.json，以及同目录下插件生成的 env.bat。不加密、不做任何变换（MD5 那份是给 NapCat 兜底用的，同样等于密码）。',
         '任何能读你这个用户目录的东西都能直接捡走：同步盘、备份工具、其它软件、远控木马、临时借你电脑的人。',
         'QQ 密码通常和 QQ 邮箱、部分游戏、微信的登录入口共用一套身份，泄漏的影响面不止这一个号。',
         '插件本身不打印密码、/state 接口也只回「存没存」和长度，但那只是少开一个泄漏口，不等于安全。',

package/lib/index.js

@@ -1,9 +1,20 @@
 /**
- * dsh-napcat-keeper —— NapCat 看门狗 v2.6.0（可发布通用版）
+ * dsh-napcat-keeper —— NapCat 看门狗 v2.7.0（可发布通用版）
  *
  * 解决的问题：DSH 是桌面应用，重启 DSH 时 NapCat(QQ 协议端) 不会跟着起来，
  * 于是 dsh-qq-bridge 一直轮询一个死端口，你在 QQ 里说的话就石沉大海。
  *
+ * v2.7.0：自己的东西收进自己的目录（~/.dsh/dsh-napcat-keeper/）
+ *   - 以前配置、日志、状态、二维码、生成的 bat/vbs、提权脚本全散在 ~/.dsh 根上，
+ *     和 DSH 自己的文件混在一起，一眼看不出哪些是插件产生的；
+ *   - 现在统一落在 ~/.dsh/dsh-napcat-keeper/ 一个目录里，文件名去掉重复前缀：
+ *     config.json / keeper.log / launch.log / state.json / lock.json / qr.png /
+ *     env.bat / launch.vbs / autogen.bat / autogen-node.bat / setup/；
+ *   - 老版本升级时 migrateLegacyFiles() 自动搬一次（能 rename 就 rename），
+ *     遗留的 *.bak、旧备份目录挪进 legacy/ 留档；计划任务里写死的旧路径由
+ *     repairTaskActions() 用 /change 改指新位置，不 /end、不打扰正在跑的 QQ；
+ *   - qq-bridge-state.json 不搬：那是 dsh-qq-bridge 的文件，只是被读一下。
+ *
  * v2.6.0：清死代码 + README 与代码对齐（行为一字没变）
  *   - 删掉 v2.2.2 起就没人再调用的目录自动探测三件套（looksLikeShellDir / findShellDirs /
  *     detectShellDir）和只被写过一次的 napcatRoot()：配置不再有「悄悄替你填」的暗路，
@@ -45,7 +56,7 @@
  *
  * v2.3.0：提权交接 —— 需要管理员的活，交给「你点一下」的脚本
  *   - 插件不再自己尝试要管理员（它本来也要不到）：把要做的事摊成步骤写进
- *     ~/.dsh/napcat-keeper-setup/plan.json，生成 apply.ps1 + apply-admin.cmd + undo-admin.cmd；
+ *     ~/.dsh/dsh-napcat-keeper/setup/plan.json，生成 apply.ps1 + apply-admin.cmd + undo-admin.cmd；
  *   - 脚本先数一遍有没有真需要管理员的步骤：没有就直接干；有才 Start-Process -Verb RunAs
  *     自我提权 —— UAC 那个「是」就是用户亲手按的确认键，插件全程普通权限；
  *   - 每步结果写 result.json，设置页「读结果」说清楚哪条成了、哪条没成、有没有拿到管理员；
@@ -67,7 +78,7 @@
  *   - NapCat 的快速登录 token 会失效（实测几小时就掉），失效后只剩手机扫码一条路；
  *   - 打开 rememberPassword 后，拉起时会通过环境变量 ACCOUNT / NAPCAT_QUICK_PASSWORD
  *     （外加 MD5 兜底）交给 NapCat，token 一失效它自己用密码重新登录，不用人管；
- *   - 密码只落在本机两处：~/.dsh/napcat-keeper-config.json 与生成的 napcat-keeper-env.bat，
+ *   - 密码只落在本机两处：~/.dsh/dsh-napcat-keeper/config.json 与生成的 env.bat，
  *     所以设置页打开它之前会先摆出风险说明，要人自己点确认；关掉或点「清除密码」就删干净。
  *   - 密码绝不进日志、绝不进 /state 返回值（只回「已保存」和长度）。
  *
@@ -100,6 +111,7 @@ import {
   readFileSync,
   readSync,
   readdirSync,
+  renameSync,
   statSync,
   unlinkSync,
   writeFileSync,
@@ -110,7 +122,7 @@ import { homedir, tmpdir } from 'node:os'
 import path from 'node:path'
 
 export const name = 'napcat-keeper'
-export const version = '2.6.0'
+export const version = '2.7.0'
 
 /** tools 用来注册 napcat_* 工具；webServer 用来挂设置界面接口。拿不到也不至于把 DSH 拖崩。 */
 export const inject = ['tools', 'webServer']
@@ -227,15 +239,102 @@ function dshHome() {
   return process.env.DSH_HOME || path.join(homedir(), '.dsh')
 }
 
-/** 设置界面写的那份配置（JSON，无 BOM） */
-function configFilePath(cfgOrHome) {
-  const home = typeof cfgOrHome === 'string' ? cfgOrHome : dshHome()
-  if (cfgOrHome && typeof cfgOrHome === 'object' && cfgOrHome.configPath) return cfgOrHome.configPath
-  return path.join(home, 'napcat-keeper-config.json')
+/**
+ * 插件自己的家：~/.dsh/dsh-napcat-keeper。
+ * 配置、日志、状态、二维码、生成的 bat / vbs、提权脚本全在这一个目录里 ——
+ * 老版本是直接摊在 ~/.dsh 根上的，2.7.0 起收拢，升级时 migrateLegacyFiles() 自动搬。
+ */
+function keeperDir() {
+  const dir = path.join(dshHome(), 'dsh-napcat-keeper')
+  try {
+    mkdirSync(dir, { recursive: true })
+  } catch {}
+  return dir
+}
+
+/* 老名字 → 新名字。搬过一次就不再动（同目录 rename 是原子的）。 */
+const LEGACY_FILES = [
+  ['napcat-keeper-config.json', 'config.json'],
+  ['napcat-keeper.log', 'keeper.log'],
+  ['napcat-keeper-launch.log', 'launch.log'],
+  ['napcat-keeper.lock.json', 'lock.json'],
+  ['napcat-keeper-state.json', 'state.json'],
+  ['napcat-qr.png', 'qr.png'],
+  ['napcat-keeper-env.bat', 'env.bat'],
+  ['napcat-keeper-launch.vbs', 'launch.vbs'],
+  ['napcat-autogen-node.bat', 'autogen-node.bat'],
+  ['napcat-autogen.bat', 'autogen.bat'],
+]
+const LEGACY_DIRS = [['napcat-keeper-setup', 'setup']]
+/** 老版本留下的零碎（配置备份、bom-backup 之类）：扫一遍挪进 legacy/，不参与运行 */
+const LEGACY_LEFTOVER = /^(napcat-keeper[.-]|napcat-qr\.|napcat-autogen)/
+const CANONICAL_LEGACY = new Set([...LEGACY_FILES, ...LEGACY_DIRS].map(([oldName]) => oldName))
+
+let migratedFor = ''
+/** 上一次搬迁搬了几个（给 apply 写一行日志用） */
+let lastMigrated = 0
+
+function moveOne(from, to) {
+  try {
+    if (existsSync(to)) return false
+    renameSync(from, to)
+    return true
+  } catch {
+    try {
+      copyFileSync(from, to)
+      unlinkSync(from)
+      return true
+    } catch {
+      return false
+    }
+  }
 }
 
-function readConfigFile(home) {
-  const file = configFilePath(home)
+/** 把老版本散在 ~/.dsh 根上的文件搬进 keeperDir；重复调用是空操作，返回搬了几个 */
+function migrateLegacyFiles(dir) {
+  const target = dir || keeperDir()
+  if (migratedFor === target) return 0
+  migratedFor = target
+  const home = dshHome()
+  let moved = 0
+  for (const [oldName, newName] of LEGACY_FILES) {
+    try {
+      if (!existsSync(path.join(home, oldName))) continue
+    } catch {
+      continue
+    }
+    if (moveOne(path.join(home, oldName), path.join(target, newName))) moved += 1
+  }
+  for (const [oldName, newName] of LEGACY_DIRS) {
+    try {
+      const from = path.join(home, oldName)
+      if (existsSync(from) && !existsSync(path.join(target, newName)) && moveOne(from, path.join(target, newName))) {
+        moved += 1
+      }
+    } catch {}
+  }
+  try {
+    for (const entry of readdirSync(home)) {
+      if (CANONICAL_LEGACY.has(entry) || !LEGACY_LEFTOVER.test(entry)) continue
+      try {
+        mkdirSync(path.join(target, 'legacy'), { recursive: true })
+        if (moveOne(path.join(home, entry), path.join(target, 'legacy', entry))) moved += 1
+      } catch {}
+    }
+  } catch {}
+  lastMigrated = moved
+  return moved
+}
+
+/** 设置界面写的那份配置（JSON，无 BOM）：<keeperDir>/config.json */
+function configFilePath(cfgOrDir) {
+  if (cfgOrDir && typeof cfgOrDir === 'object' && cfgOrDir.configPath) return cfgOrDir.configPath
+  const dir = typeof cfgOrDir === 'string' ? cfgOrDir : keeperDir()
+  return path.join(dir, 'config.json')
+}
+
+function readConfigFile(dir) {
+  const file = configFilePath(dir)
   try {
     if (!existsSync(file)) return {}
   } catch {
@@ -607,18 +706,22 @@ function normalizeConfig(cfg) {
 
 function resolveConfig(raw) {
   const home = dshHome()
+  const dir = keeperDir()
+  // 老版本的东西摊在 ~/.dsh 根上，先搬进 dir 再读配置（否则读的是搬走前的那份）
+  migrateLegacyFiles(dir)
   // 优先级：内置默认 < cordis 里的 config < 设置界面存下来的 json
-  const cfg = { ...DEFAULTS, ...(raw || {}), ...readConfigFile(home) }
+  const cfg = { ...DEFAULTS, ...(raw || {}), ...readConfigFile(dir) }
   normalizeConfig(cfg)
   // v2.2.2：shellDir 不再自动探测/自动填，空着就等用户在设置页里扫盘选或者手填
   if (!cfg.launcherScript) cfg.launcherScript = detectLauncher(cfg.shellDir, cfg.launchAccount)
-  if (!cfg.logPath) cfg.logPath = path.join(home, 'napcat-keeper.log')
-  if (!cfg.launcherLog) cfg.launcherLog = path.join(home, 'napcat-keeper-launch.log')
-  if (!cfg.lockPath) cfg.lockPath = path.join(home, 'napcat-keeper.lock.json')
-  if (!cfg.statePath) cfg.statePath = path.join(home, 'napcat-keeper-state.json')
-  if (!cfg.qrCopyPath) cfg.qrCopyPath = path.join(home, 'napcat-qr.png')
+  if (!cfg.logPath) cfg.logPath = path.join(dir, 'keeper.log')
+  if (!cfg.launcherLog) cfg.launcherLog = path.join(dir, 'launch.log')
+  if (!cfg.lockPath) cfg.lockPath = path.join(dir, 'lock.json')
+  if (!cfg.statePath) cfg.statePath = path.join(dir, 'state.json')
+  if (!cfg.qrCopyPath) cfg.qrCopyPath = path.join(dir, 'qr.png')
+  // qq-bridge-state.json 是 dsh-qq-bridge 写的，不归我们管，留在 ~/.dsh 根上
   if (!cfg.bridgeStatePath) cfg.bridgeStatePath = path.join(home, 'qq-bridge-state.json')
-  if (!cfg.configPath) cfg.configPath = configFilePath(home)
+  if (!cfg.configPath) cfg.configPath = configFilePath(dir)
   return cfg
 }
 
@@ -963,7 +1066,7 @@ function resolveLauncherPath(cfg) {
   if (standaloneMjs) {
     const node = resolveNode(cfg)
     if (node.path) {
-      const file = path.join(dshHome(), 'napcat-autogen-node.bat')
+      const file = path.join(keeperDir(), 'autogen-node.bat')
       const args = String(cfg.launchArgs || '').trim()
       const body =
         '@echo off\r\n' +
@@ -991,7 +1094,7 @@ function resolveLauncherPath(cfg) {
     // 用户只填了 QQ 号：直接调 NapCatWinBootMain.exe，不依赖别人的 quick bat
     const boot = findBootMain(cfg.shellDir)
     if (boot) {
-      const file = path.join(dshHome(), 'napcat-autogen.bat')
+      const file = path.join(keeperDir(), 'autogen.bat')
       const body =
         '@echo off\r\n' +
         'chcp 65001 >nul\r\n' +
@@ -1193,16 +1296,16 @@ function findStandaloneNapcatMjs(dir) {
   return ''
 }
 
-/** 无窗口壳 .vbs 的路径（跟日志放一起） */
+/** 无窗口壳 .vbs 的路径（跟日志放同一个目录） */
 function taskWrapperPath(cfg) {
-  const dir = path.dirname(cfg.launcherLog || path.join(dshHome(), 'napcat-keeper-launch.log'))
-  return path.join(dir, 'napcat-keeper-launch.vbs')
+  const dir = path.dirname(cfg.launcherLog || path.join(keeperDir(), 'launch.log'))
+  return path.join(dir, 'launch.vbs')
 }
 
 /** 「记住密码」时生成的那个 bat：设好环境变量，再 call 真正的启动脚本 */
 function envBatPath(cfg) {
-  const dir = path.dirname(cfg.launcherLog || path.join(dshHome(), 'napcat-keeper-launch.log'))
-  return path.join(dir, 'napcat-keeper-env.bat')
+  const dir = path.dirname(cfg.launcherLog || path.join(keeperDir(), 'launch.log'))
+  return path.join(dir, 'env.bat')
 }
 
 /** 密码是否真的在生效（三个条件缺一不可） */
@@ -1359,6 +1462,51 @@ function ensureTask(cfg) {
   return { ok: true, created: true }
 }
 
+/**
+ * 计划任务的动作是写死的绝对路径（wscript.exe "<vbs>"）。文件搬了家、或者日志目录换了，
+ * 任务就指向一个不存在的脚本 —— 开机静默失败，人还以为是别的原因。
+ *
+ * 这里只在「动作里的路径已经不是当前该用的那个」时改一次，用 /change 就地改：
+ * 不动 /end，正在跑的那条 QQ 进程链不会被踢下来。
+ */
+function repairTaskActions(cfg) {
+  if (!cfg.taskName) return { ok: true, skipped: true }
+  if (state.taskActionsChecked) return { ok: true, skipped: true }
+  let xml = ''
+  try {
+    xml = captureSync('schtasks.exe', ['/query', '/tn', cfg.taskName, '/xml'], 8000)
+  } catch {
+    xml = ''
+  }
+  // 任务不存在（或查不动）：不用管，真要建是 ensureTask 的活
+  if (!xml || !xml.trim()) return { ok: true, skipped: true }
+  const bat = resolveLauncherPath(cfg)
+  if (!bat) return { ok: true, skipped: true }
+  const wanted = cfg.hideConsole !== false ? taskWrapperPath(cfg) : passwordActive(cfg) ? envBatPath(cfg) : bat
+  state.taskActionsChecked = true
+  if (xml.includes(wanted)) return { ok: true, skipped: true }
+  try {
+    let inner = ''
+    if (cfg.hideConsole !== false) {
+      const vbs = writeTaskWrapper(cfg, bat, true)
+      inner = `wscript.exe "${vbs}"`
+    } else {
+      inner = taskCommandLine(cfg, bat)
+    }
+    execFileSync('schtasks.exe', ['/change', '/tn', cfg.taskName, '/tr', inner], {
+      stdio: 'ignore',
+      windowsHide: true,
+      timeout: 15000,
+    })
+    state.taskReady = undefined
+    log(cfg, `task "${cfg.taskName}" 动作已改指到 ${wanted}`)
+    return { ok: true, repaired: true }
+  } catch (error) {
+    state.taskActionsChecked = false
+    return { ok: false, error: String((error && error.message) || error) }
+  }
+}
+
 /* ── 提权交接：插件不自己去要管理员，改成给你一个双击就行的脚本 ──────────────
  *
  * 为什么要这样：DSH 自己是普通权限进程。插件偶尔要做几件「可能要管理员」的事
@@ -1374,7 +1522,7 @@ function ensureTask(cfg) {
  *   4. 每步结果写 result.json，设置页读回来说清楚哪条成了、哪条没成；
  *   5. 另外给一个 undo-admin.cmd，反着把插件建过的东西删掉。
  *
- * 所有产物只在 ~/.dsh/napcat-keeper-setup 一个目录里，整个删掉就等于撤回。
+ * 所有产物只在 ~/.dsh/dsh-napcat-keeper/setup 一个目录里，整个删掉就等于撤回。
  */
 
 const SETUP_NEEDS = {
@@ -1397,7 +1545,8 @@ const SETUP_NEEDS = {
 }
 
 function setupPaths() {
-  const dir = path.join(dshHome(), 'napcat-keeper-setup')
+  const dir = path.join(keeperDir(), 'setup')
+  migrateLegacyFiles()
   return {
     dir,
     ps1: path.join(dir, 'apply.ps1'),
@@ -1574,7 +1723,7 @@ function buildSetupSteps(cfg, wants) {
       ].join('\r\n')
       steps.push({
         id: 'task-wrapper',
-        label: '写无窗口壳 napcat-keeper-launch.vbs',
+        label: '写无窗口壳 launch.vbs',
         kind: 'writeFile',
         path: vbs,
         admin: !dirWritable(path.dirname(vbs)),
@@ -3205,6 +3354,13 @@ export function apply(ctx, config) {
       `scanTimeout=${cfg.scanTimeoutSec}s, shell=${cfg.shellDir || '(未配置)'}, task=${cfg.taskName || '(不用)'}, ` +
       `node=${node.path ? `${node.version || '?'}(${node.source})` : '(没找到)'})`,
   )
+  if (lastMigrated) {
+    log(cfg, `已把 ${lastMigrated} 个文件从 ~/.dsh 根上搬进 ${keeperDir()}（老版本的散装布局）`)
+  }
+  if (cfg.taskName) {
+    const repaired = repairTaskActions(cfg)
+    if (repaired.ok && repaired.repaired) log(cfg, '计划任务已跟着文件位置改好')
+  }
   registerTools(ctx, cfg)
   registerRoutes(ctx)
   armTimer(cfg)

package/package.json

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

package/scripts/selftest-setup.mjs

@@ -24,7 +24,7 @@ writeFileSync(path.join(fakeShell, 'NapCatWinBootMain.exe'), '', 'utf8')
 const cfg = internals.resolveConfig({})
 cfg.shellDir = fakeShell
 cfg.launcherScript = 'napcat.quick2.bat'
-cfg.launcherLog = path.join(fakeLogDir, 'napcat-keeper-launch.log')
+cfg.launcherLog = path.join(fakeLogDir, 'launch.log')
 cfg.taskName = 'NapCat-Keeper-Selftest'
 cfg.launchAccount = '10001'
 cfg.launchArgs = ''
@@ -139,10 +139,10 @@ if (first) {
   ok(first.results.length === 4, '4 条结果')
 }
 ok(existsSync(path.join(fakeShell, 'napcat.quick.auto.bat')), 'launcher: 启动脚本写出来了')
-ok(existsSync(path.join(fakeLogDir, 'napcat-keeper-env.bat')), 'envbat: 中间层写出来了')
-ok(existsSync(path.join(fakeLogDir, 'napcat-keeper-launch.vbs')), 'task-wrapper: vbs 写出来了')
+ok(existsSync(path.join(fakeLogDir, 'env.bat')), 'envbat: 中间层写出来了')
+ok(existsSync(path.join(fakeLogDir, 'launch.vbs')), 'task-wrapper: vbs 写出来了')
 
-const envBat = readFileSync(path.join(fakeLogDir, 'napcat-keeper-env.bat'), 'utf8')
+const envBat = readFileSync(path.join(fakeLogDir, 'env.bat'), 'utf8')
 ok(envBat.includes('NAPCAT_QUICK_PASSWORD=selftest-pass-123'), 'env bat 里带密码（这是它的用途）')
 ok(envBat.includes('call "'), 'env bat 会 call 真启动脚本')
 
@@ -186,8 +186,8 @@ const undone = internals.readSetupResult()
 ok(undone && undone.mode === 'undo', 'result 里 mode = undo')
 ok(undone && undone.ok === true, '撤回每步都成', JSON.stringify(undone && undone.results.filter((r) => !r.ok)))
 ok(!existsSync(path.join(fakeShell, 'napcat.quick.auto.bat')), '启动脚本删掉了')
-ok(!existsSync(path.join(fakeLogDir, 'napcat-keeper-env.bat')), '中间层删掉了（密码不留在磁盘）')
-ok(!existsSync(path.join(fakeLogDir, 'napcat-keeper-launch.vbs')), 'vbs 删掉了')
+ok(!existsSync(path.join(fakeLogDir, 'env.bat')), '中间层删掉了（密码不留在磁盘）')
+ok(!existsSync(path.join(fakeLogDir, 'launch.vbs')), 'vbs 删掉了')
 try {
   execFileSync('schtasks.exe', ['/query', '/tn', cfg.taskName], { stdio: 'ignore', windowsHide: true })
   ok(false, '计划任务还在（应该删掉）')

package/scripts/smoke-client.mjs

@@ -60,9 +60,9 @@ function collect(tree) {
 render(); // 第一次：态=null 的 loading 分支
 states[0] = {
   ok: true,
-  version: '2.2.2',
+  version: '2.7.0',
   config: {
-    configPath: 'C:/x/napcat-keeper-config.json', logPath: 'C:/x/napcat-keeper.log',
+    configPath: 'C:/Users/x/.dsh/dsh-napcat-keeper/config.json', logPath: 'C:/Users/x/.dsh/dsh-napcat-keeper/keeper.log',
     shellDir: 'C:/Users/x/NapCat/OneKey/NapCat.52230.Shell', launcherScript: 'napcat.quick2.bat',
     launchAccount: '1000000000', launchArgs: '', onebotPort: 3000, accessToken: '',
     taskName: 'NapCat-Keeper-Launch', rememberPassword: true, autoCreateTask: true,
@@ -78,10 +78,10 @@ states[0] = {
   scan: { running: false, found: [], drives: ['C:'], visited: 0, elapsedMs: 0, limitHit: false, cancelled: false },
   drives: ['C:', 'D:', 'E:'],
   setup: {
-    dir: 'C:/Users/x/.dsh/napcat-keeper-setup',
-    cmdPath: 'C:/Users/x/.dsh/napcat-keeper-setup/apply-admin.cmd',
-    ps1Path: 'C:/Users/x/.dsh/napcat-keeper-setup/apply.ps1',
-    undoCmdPath: 'C:/Users/x/.dsh/napcat-keeper-setup/undo-admin.cmd',
+    dir: 'C:/Users/x/.dsh/dsh-napcat-keeper/setup',
+    cmdPath: 'C:/Users/x/.dsh/dsh-napcat-keeper/setup/apply-admin.cmd',
+    ps1Path: 'C:/Users/x/.dsh/dsh-napcat-keeper/setup/apply.ps1',
+    undoCmdPath: 'C:/Users/x/.dsh/dsh-napcat-keeper/setup/undo-admin.cmd',
     exists: true,
     needs: [
       { id: 'launcher', label: '自动启动脚本', hint: '补一个 napcat.quick.auto.bat', ready: true, why: '', needAdmin: false },
@@ -179,7 +179,7 @@ check('显示上次生成 2 步', /上次生成：.*2 步/.test(setupOut.text));
 check('显示上次执行 1/2 步成', /执行：1\/2 步成/.test(setupOut.text));
 check('显示用了管理员', setupOut.text.includes('用了管理员'));
 check('失败项有 ✗', setupOut.text.includes('✗ 放行防火墙：没权限'));
-check('显示脚本目录', setupOut.text.includes('napcat-keeper-setup'));
+check('显示脚本目录', setupOut.text.includes('dsh-napcat-keeper'));
 
 // 没生成过 / 还没跑过
 const keepSetup = states[0].setup;