@wanghaopeng1148/deskpet 2.0.2 → 2.0.4

package/README.md

@@ -432,17 +432,25 @@ resources/  皮肤、图标等随包资源
 - 通知通道：系统原生通知（osascript / PowerShell Toast / notify-send）+ 管理台页面内提示 + 微信。
 - **开机自启**：管理台「设置」页有开关（对应配置项 `system.autoStart`）。开启后各平台的落地方式：
 
-  | 平台 | 写到哪里 |
-  | --- | --- |
-  | Windows | 启动文件夹 `DeskPet.cmd`（不依赖 reg / schtasks，受管控的机器也能用） |
-  | macOS | `~/Library/LaunchAgents/DeskPet.plist` |
-  | Linux | `~/.config/autostart/DeskPet.desktop`（XDG 标准） |
-
-  注册的命令统一是 `bin/deskpet.mjs --no-open` —— 它内部用当前 node 拉起服务（不依赖 PATH），
-  也不会在开机时弹浏览器。**想临时停用，直接删掉对应文件即可**，或把设置页开关关掉。
-  服务启动时也会按配置同步一次（关闭时会移除文件）。
-
-  > 历史坑：本项目早期是 Electron 应用，自启是启动文件夹里的 `DeskPet.lnk`
-  > （指向旧的 `pet\dist\DeskPet.exe`）。改成 Node 服务、目录改名后，那个快捷方式不会自动失效消失，
-  > 结果就是「以为自启开着，实际每次开机拉起的是旧程序，新服务仍要手动启动」。
-  > 所以开启自启时会**主动清理**同名的旧 `.lnk`。
+  | 平台 | 写到哪里 | 是否弹窗口 |
+  | --- | --- | --- |
+  | Windows | 启动文件夹 `DeskPet.vbs`（不依赖 reg / schtasks，受管控的机器也能用） | **不弹**（WScript 以隐藏窗口启动） |
+  | macOS | `~/Library/LaunchAgents/DeskPet.plist` | 不弹 |
+  | Linux | `~/.config/autostart/DeskPet.desktop`（XDG 标准） | 不弹 |
+
+  注册的命令统一是 `bin/deskpet.mjs --no-open --log`：
+
+  - `--no-open` 不在开机时弹浏览器
+  - `--log` 把服务输出转存到 **`~/.deskpet/logs/service.log`**（超过 2MB 自动重开）。
+    Windows 用隐藏窗口启动后看不到控制台，日志必须有地方落 —— 排查启动失败就看它
+  - 入口内部用 `process.execPath` 拉起服务，不依赖 PATH 里有没有 node
+
+  **想临时停用**：删掉对应的自启文件即可，或在设置页把开关关掉。
+
+  > 历史坑 1：本项目早期是 Electron 应用，自启是启动文件夹里的 `DeskPet.lnk`
+  > （指向 `pet\dist\DeskPet.exe`）。改成 Node 服务、目录改名后，那个快捷方式不会自动消失，
+  > 于是「以为自启开着，实际每次开机拉起的是旧程序」。开启自启时会**主动清理**同名的旧 `.lnk`。
+  >
+  > 历史坑 2：中间一版用 `.cmd` + `start /min`，任务栏里**一直挂着一个最小化的 node.exe 窗口**。
+  > 现在是 `.vbs`（`WScript.Shell.Run(..., 0, False)`，窗口样式 0 = 完全隐藏），
+  > 写入时同样会清掉旧的 `.cmd`。文件用 UTF-16LE + BOM 编码，路径含中文也不会被按 ANSI 解析坏。

package/bin/deskpet.mjs

@@ -12,10 +12,11 @@
  *   npx deskpet                 启动，并自动打开浏览器
  *   npx deskpet --no-open       只启动、不开浏览器（SSH 远程 / 服务器场景）
  *   npx deskpet --port 3211     指定端口（等价于设置 DESKPET_PORT）
+ *   npx deskpet --log           输出转存到 <数据目录>/logs/service.log（供无窗口自启使用）
  *   npx deskpet --check         只做环境自检，不启动服务
  */
 import { spawn, spawnSync } from 'node:child_process'
-import { existsSync, readdirSync, readFileSync, statSync } from 'node:fs'
+import { createWriteStream, existsSync, mkdirSync, readdirSync, readFileSync, statSync } from 'node:fs'
 import net from 'node:net'
 import { homedir } from 'node:os'
 import { dirname, join } from 'node:path'
@@ -99,11 +100,19 @@ const flagValue = (name) => {
 const cliPort = flagValue('--port') ?? process.env.DESKPET_PORT ?? null
 const checkOnly = hasFlag('--check')
 const shouldOpen = !hasFlag('--no-open')
+/** 把服务输出转存到 <数据目录>/logs/service.log（自启时窗口是隐藏的，日志总得有地方看） */
+const logToFile = hasFlag('--log')
 
 function log(msg) {
   process.stdout.write(`[deskpet] ${msg}\n`)
 }
 
+/** 数据根目录（与 server/utils/paths.ts 的规则保持一致） */
+function dataRoot() {
+  const env = process.env.DESKPET_HOME?.trim()
+  return env || join(homedir(), '.deskpet')
+}
+
 /** 实际监听端口：命令行 > 环境变量 > 配置文件 > 默认 3210 */
 function resolvePort() {
   if (cliPort) {
@@ -112,7 +121,7 @@ function resolvePort() {
     console.error(`[deskpet] 端口无效：${cliPort}`)
     process.exit(1)
   }
-  const home = process.env.DESKPET_HOME?.trim() || join(homedir(), '.deskpet')
+  const home = dataRoot()
   try {
     const s = JSON.parse(readFileSync(join(home, 'config', 'settings.json'), 'utf-8'))
     if (Number.isInteger(s?.server?.port) && s.server.port > 0) return s.server.port
@@ -187,12 +196,35 @@ if (checkOnly) {
 
 // ── 2. 启动后端 ───────────────────────────────────────────
 log(`启动服务（端口 ${port}）…`)
+
+/** 日志文件：超过 2MB 就重开一个，避免长期运行无限增长 */
+function openLogStream() {
+  const file = join(dataRoot(), 'logs', 'service.log')
+  try {
+    mkdirSync(join(dataRoot(), 'logs'), { recursive: true })
+    const fresh = existsSync(file) && statSync(file).size < 2 * 1024 * 1024
+    const stream = createWriteStream(file, { flags: fresh ? 'a' : 'w' })
+    stream.write(`\n===== ${new Date().toISOString()} 启动（端口 ${port}）=====\n`)
+    log(`日志文件：${file}`)
+    return stream
+  } catch (e) {
+    log(`日志文件不可写，输出将丢弃：${e?.message ?? e}`)
+    return null
+  }
+}
+
+const logStream = logToFile ? openLogStream() : null
 const child = spawn(process.execPath, [...server.args, server.entry], {
   cwd: pkgRoot,
-  stdio: 'inherit',
+  stdio: logStream ? ['ignore', 'pipe', 'pipe'] : 'inherit',
   env: { ...process.env, DESKPET_PORT: String(port) }
 })
 
+if (logStream) {
+  child.stdout.pipe(logStream)
+  child.stderr.pipe(logStream)
+}
+
 process.on('SIGINT', () => child.kill('SIGINT'))
 process.on('SIGTERM', () => child.kill('SIGTERM'))
 child.on('exit', (code) => process.exit(code ?? 0))

package/dist/node/server/main.js

@@ -220,12 +220,16 @@ async function main() {
     startHeartbeat();
     scheduler.start({ recover: instanceLock.acquired });
     // 开机自启：启动时应用 + 跟随设置变化
+    // removeWhenOff: false —— 启动时的同步只「确保开启时文件存在」，不删除。
+    // 否则一个用默认配置（autoStart=false）起来的实例（例如临时跑一次 npx，
+    // 或换了 DESKPET_HOME）会把主实例写在同一个启动文件夹里的自启文件删掉。
     let lastAutoStart = config.get().system.autoStart;
-    void setAutoStart(lastAutoStart);
+    void setAutoStart(lastAutoStart, { removeWhenOff: false });
     config.on('changed', () => {
         const next = config.get().system.autoStart;
         if (next !== lastAutoStart) {
             lastAutoStart = next;
+            // 用户在设置页显式切换 → 关闭时应当真的移除文件
             void setAutoStart(next);
         }
     });

package/dist/node/server/utils/auto-start.js

@@ -2,32 +2,42 @@
  * 开机自启
  *
  * 各平台实现：
- *   Windows  启动文件夹放一个 .cmd —— 不依赖 reg / schtasks 命令，受管控的机器一样能用
+ *   Windows  启动文件夹放一个 .vbs —— 不依赖 reg / schtasks 命令，受管控的机器一样能用；
+ *            用 WScript 以隐藏窗口（样式 0）启动，**任务栏不会出现 node.exe 窗口**
  *   macOS    ~/Library/LaunchAgents/<APP_ID>.plist
  *   Linux    ~/.config/autostart/<APP_ID>.desktop（XDG 标准，GNOME/KDE 都认）
  *
- * 启动命令统一走 `bin/deskpet.mjs --no-open`，理由：
+ * 启动命令统一走 `bin/deskpet.mjs --no-open --log`，理由：
  *   · bin/ 在「源码运行」和「npm 包运行」两种形态下都存在（scripts/ 不进发布包）
- *   · 它内部用 process.execPath 拉起 server/main.ts，不依赖 PATH 里有没有 node / npm
+ *   · 它内部用 process.execPath 拉起后端，不依赖 PATH 里有没有 node / npm
  *   · 脚本自己会按 package.json 推导根目录，所以不依赖工作目录
  *   · --no-open 避免每次开机都弹一个浏览器
+ *   · --log 把输出转存到文件：窗口隐藏后，出问题时总得有地方看日志
  *
  * 历史坑（说明为什么要主动清理旧文件）：
  *   本项目早期是 Electron 应用，自启是安装包写在启动文件夹里的快捷方式
  *   （DeskPet.lnk → pet\dist\DeskPet.exe）。后来改成纯 Node 服务、目录也从 pet 换成 pet2.0，
  *   那个旧快捷方式却没人清理 —— 结果用户以为自启开着，实际每次开机拉起的是旧程序，
- *   新服务仍然要手动启动。因此下面在写入自启时会**顺手删掉同名的旧 .lnk**。
+ *   新服务仍然要手动启动。再往后一版用 .cmd（start /min），会弹出一个最小化窗口。
+ *   因此下面写自启时会**顺手删掉同名的旧 .lnk 与 .cmd**，避免重复启动或误导排查。
  *
  * 仅在用户在设置中开启时写入；任何异常都只记录日志，不影响服务本身。
  */
 import { existsSync, mkdirSync, unlinkSync, writeFileSync } from 'node:fs';
 import { homedir } from 'node:os';
-import { dirname, join, resolve } from 'node:path';
-import { fileURLToPath } from 'node:url';
+import { dirname, join } from 'node:path';
+import { getPackageRoot } from "./paths.js";
 const APP_ID = 'DeskPet';
-/** 应用根目录（源码运行为项目根，npm 包运行为包根） */
+/**
+ * 应用根目录。
+ *
+ * 用 getPackageRoot() 向上查找 package.json，而不是写死 `../..`：
+ * 源码运行时本模块在 `server/utils/`，编译产物在 `dist/node/server/utils/`，
+ * 距包根的层数不同 —— 写死层级会让**从 npm 安装版开启自启**生成一个指向
+ * 不存在路径的启动脚本（开机静默失败）。
+ */
 function appRoot() {
-    return resolve(dirname(fileURLToPath(import.meta.url)), '..', '..');
+    return getPackageRoot();
 }
 /** 开机要执行的 node 可执行文件与入口脚本 */
 function launch() {
@@ -38,28 +48,35 @@ function winStartupDir() {
     const appData = process.env.APPDATA ?? join(homedir(), 'AppData', 'Roaming');
     return join(appData, 'Microsoft', 'Windows', 'Start Menu', 'Programs', 'Startup');
 }
-function winCmdPath() {
-    return join(winStartupDir(), `${APP_ID}.cmd`);
+function winVbsPath() {
+    return join(winStartupDir(), `${APP_ID}.vbs`);
 }
-function winLegacyLnkPath() {
-    return join(winStartupDir(), `${APP_ID}.lnk`);
+/** 历史版本写过的自启文件：Electron 时代的快捷方式、上一版的批处理 */
+function winLegacyPaths() {
+    return [join(winStartupDir(), `${APP_ID}.lnk`), join(winStartupDir(), `${APP_ID}.cmd`)];
 }
 /**
- * 生成自启批处理。
+ * 生成自启脚本（VBScript）。
+ *
+ * 为什么不是 .cmd：批处理启动的任何控制台程序都会**弹出一个窗口**，
+ * `start /min` 只能把它最小化 —— 任务栏里始终挂着一个 node.exe，很碍眼。
+ * 改用 WScript.Shell.Run 的第二参数（窗口样式）传 0，窗口**完全隐藏**：
+ *   0 = 隐藏窗口，False = 不等待其结束（否则 wscript 会一直挂着）
  *
- * 注意两点：
- *   · 换行必须是 CRLF，注释用英文 —— cmd 按系统 ANSI 代码页解析批处理，
- *     写中文注释在中文 Windows 上容易乱码（虽然注释不影响执行，但很难看）
- *   · 用 `start /min` 让服务窗口最小化，不打扰用户，同时任务栏里能看到它在跑
+ * 编码用 UTF-16LE 带 BOM：wscript 默认按系统 ANSI 代码页读 .vbs，
+ * 若安装路径含中文（例如用户名是中文）会乱码成乱路径；带 BOM 则按 Unicode 解析。
+ *
+ * 隐藏窗口后看不到服务日志，所以启动命令带 `--log`：输出转存到
+ * <数据目录>/logs/service.log（见 bin/deskpet.mjs）。
  */
-function winCmdContent() {
+function winVbsContent() {
     const { node, entry } = launch();
     return [
-        '@echo off',
-        'rem DeskPet autostart - generated by the DeskPet dashboard.',
-        'rem Delete this file to disable autostart.',
-        `cd /d "${appRoot()}"`,
-        `start "${APP_ID}" /min "${node}" "${entry}" --no-open`,
+        "' DeskPet autostart - generated by the DeskPet dashboard.",
+        "' Delete this file to disable autostart.",
+        'Set sh = CreateObject("WScript.Shell")',
+        `sh.CurrentDirectory = "${appRoot()}"`,
+        `sh.Run """${node}"" ""${entry}"" --no-open --log", 0, False`,
         ''
     ].join('\r\n');
 }
@@ -106,30 +123,33 @@ function linuxDesktopContent() {
         ''
     ].join('\n');
 }
-// ── 对外接口 ────────────────────────────────────────────────
 /** 开启 / 关闭开机自启，返回是否成功（失败原因会打印到日志） */
-export async function setAutoStart(on) {
+export async function setAutoStart(on, opts = {}) {
+    const removeWhenOff = opts.removeWhenOff ?? true;
     try {
         if (process.platform === 'win32') {
             const dir = winStartupDir();
             mkdirSync(dir, { recursive: true });
-            // 清掉 Electron 时代遗留的失效快捷方式（它指向 pet\dist\DeskPet.exe）
-            const legacy = winLegacyLnkPath();
-            if (existsSync(legacy)) {
+            // 清掉历史遗留：Electron 时代的 .lnk（指向已不存在的 pet\dist\DeskPet.exe）
+            // 与上一版的 .cmd（会弹窗口）。留着只会重复启动或误导排查。
+            for (const legacy of winLegacyPaths()) {
+                if (!existsSync(legacy))
+                    continue;
                 try {
                     unlinkSync(legacy);
-                    console.log(`[autostart] 已清理旧版自启快捷方式: ${legacy}`);
+                    console.log(`[autostart] 已清理旧版自启文件: ${legacy}`);
                 }
                 catch (err) {
-                    console.warn(`[autostart] 旧快捷方式清理失败（可手动删除）: ${String(err)}`);
+                    console.warn(`[autostart] 旧自启文件清理失败（可手动删除）: ${String(err)}`);
                 }
             }
-            const file = winCmdPath();
+            const file = winVbsPath();
             if (on) {
-                writeFileSync(file, winCmdContent(), 'utf-8');
-                console.log(`[autostart] 开机自启已开启: ${file}`);
+                // utf16le + BOM：见 winVbsContent() 的说明（路径含中文时不会被 ANSI 解析搞坏）
+                writeFileSync(file, Buffer.from(`\ufeff${winVbsContent()}`, 'utf16le'));
+                console.log(`[autostart] 开机自启已开启（静默，无窗口）: ${file}`);
             }
-            else if (existsSync(file)) {
+            else if (removeWhenOff && existsSync(file)) {
                 unlinkSync(file);
                 console.log('[autostart] 开机自启已关闭');
             }
@@ -142,7 +162,7 @@ export async function setAutoStart(on) {
                 writeFileSync(file, macPlistContent(), 'utf-8');
                 console.log(`[autostart] 开机自启已开启: ${file}`);
             }
-            else if (existsSync(file)) {
+            else if (removeWhenOff && existsSync(file)) {
                 unlinkSync(file);
                 console.log('[autostart] 开机自启已关闭');
             }
@@ -155,7 +175,7 @@ export async function setAutoStart(on) {
                 writeFileSync(file, linuxDesktopContent(), 'utf-8');
                 console.log(`[autostart] 开机自启已开启: ${file}`);
             }
-            else if (existsSync(file)) {
+            else if (removeWhenOff && existsSync(file)) {
                 unlinkSync(file);
                 console.log('[autostart] 开机自启已关闭');
             }
@@ -172,8 +192,10 @@ export async function setAutoStart(on) {
 /** 查询当前是否已设置自启 */
 export function autoStartEnabled() {
     try {
-        if (process.platform === 'win32')
-            return existsSync(winCmdPath());
+        if (process.platform === 'win32') {
+            // .cmd 是上一版留下的形式，也算「已开启」，直到下次写入时被替换
+            return winLegacyPaths().some((p) => p.endsWith('.cmd') && existsSync(p)) || existsSync(winVbsPath());
+        }
         if (process.platform === 'darwin')
             return existsSync(macPlistPath());
         if (process.platform === 'linux')

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@wanghaopeng1148/deskpet",
   "productName": "DeskPet",
-  "version": "2.0.2",
+  "version": "2.0.4",
   "description": "DeskPet 2.0 — 本机任务自动化服务 + Web 管理台 (Node + Express + Vue 3 + TypeScript)",
   "type": "module",
   "author": "whp",

package/server/main.ts

@@ -239,12 +239,16 @@ async function main(): Promise<void> {
   scheduler.start({ recover: instanceLock.acquired })
 
   // 开机自启：启动时应用 + 跟随设置变化
+  // removeWhenOff: false —— 启动时的同步只「确保开启时文件存在」，不删除。
+  // 否则一个用默认配置（autoStart=false）起来的实例（例如临时跑一次 npx，
+  // 或换了 DESKPET_HOME）会把主实例写在同一个启动文件夹里的自启文件删掉。
   let lastAutoStart = config.get().system.autoStart
-  void setAutoStart(lastAutoStart)
+  void setAutoStart(lastAutoStart, { removeWhenOff: false })
   config.on('changed', () => {
     const next = config.get().system.autoStart
     if (next !== lastAutoStart) {
       lastAutoStart = next
+      // 用户在设置页显式切换 → 关闭时应当真的移除文件
       void setAutoStart(next)
     }
   })

package/server/utils/auto-start.ts

@@ -2,34 +2,44 @@
  * 开机自启
  *
  * 各平台实现：
- *   Windows  启动文件夹放一个 .cmd —— 不依赖 reg / schtasks 命令，受管控的机器一样能用
+ *   Windows  启动文件夹放一个 .vbs —— 不依赖 reg / schtasks 命令，受管控的机器一样能用；
+ *            用 WScript 以隐藏窗口（样式 0）启动，**任务栏不会出现 node.exe 窗口**
  *   macOS    ~/Library/LaunchAgents/<APP_ID>.plist
  *   Linux    ~/.config/autostart/<APP_ID>.desktop（XDG 标准，GNOME/KDE 都认）
  *
- * 启动命令统一走 `bin/deskpet.mjs --no-open`，理由：
+ * 启动命令统一走 `bin/deskpet.mjs --no-open --log`，理由：
  *   · bin/ 在「源码运行」和「npm 包运行」两种形态下都存在（scripts/ 不进发布包）
- *   · 它内部用 process.execPath 拉起 server/main.ts，不依赖 PATH 里有没有 node / npm
+ *   · 它内部用 process.execPath 拉起后端，不依赖 PATH 里有没有 node / npm
  *   · 脚本自己会按 package.json 推导根目录，所以不依赖工作目录
  *   · --no-open 避免每次开机都弹一个浏览器
+ *   · --log 把输出转存到文件：窗口隐藏后，出问题时总得有地方看日志
  *
  * 历史坑（说明为什么要主动清理旧文件）：
  *   本项目早期是 Electron 应用，自启是安装包写在启动文件夹里的快捷方式
  *   （DeskPet.lnk → pet\dist\DeskPet.exe）。后来改成纯 Node 服务、目录也从 pet 换成 pet2.0，
  *   那个旧快捷方式却没人清理 —— 结果用户以为自启开着，实际每次开机拉起的是旧程序，
- *   新服务仍然要手动启动。因此下面在写入自启时会**顺手删掉同名的旧 .lnk**。
+ *   新服务仍然要手动启动。再往后一版用 .cmd（start /min），会弹出一个最小化窗口。
+ *   因此下面写自启时会**顺手删掉同名的旧 .lnk 与 .cmd**，避免重复启动或误导排查。
  *
  * 仅在用户在设置中开启时写入；任何异常都只记录日志，不影响服务本身。
  */
 import { existsSync, mkdirSync, unlinkSync, writeFileSync } from 'node:fs'
 import { homedir } from 'node:os'
-import { dirname, join, resolve } from 'node:path'
-import { fileURLToPath } from 'node:url'
+import { dirname, join } from 'node:path'
+import { getPackageRoot } from './paths.ts'
 
 const APP_ID = 'DeskPet'
 
-/** 应用根目录（源码运行为项目根，npm 包运行为包根） */
+/**
+ * 应用根目录。
+ *
+ * 用 getPackageRoot() 向上查找 package.json，而不是写死 `../..`：
+ * 源码运行时本模块在 `server/utils/`，编译产物在 `dist/node/server/utils/`，
+ * 距包根的层数不同 —— 写死层级会让**从 npm 安装版开启自启**生成一个指向
+ * 不存在路径的启动脚本（开机静默失败）。
+ */
 function appRoot(): string {
-  return resolve(dirname(fileURLToPath(import.meta.url)), '..', '..')
+  return getPackageRoot()
 }
 
 /** 开机要执行的 node 可执行文件与入口脚本 */
@@ -44,30 +54,37 @@ function winStartupDir(): string {
   return join(appData, 'Microsoft', 'Windows', 'Start Menu', 'Programs', 'Startup')
 }
 
-function winCmdPath(): string {
-  return join(winStartupDir(), `${APP_ID}.cmd`)
+function winVbsPath(): string {
+  return join(winStartupDir(), `${APP_ID}.vbs`)
 }
 
-function winLegacyLnkPath(): string {
-  return join(winStartupDir(), `${APP_ID}.lnk`)
+/** 历史版本写过的自启文件：Electron 时代的快捷方式、上一版的批处理 */
+function winLegacyPaths(): string[] {
+  return [join(winStartupDir(), `${APP_ID}.lnk`), join(winStartupDir(), `${APP_ID}.cmd`)]
 }
 
 /**
- * 生成自启批处理。
+ * 生成自启脚本（VBScript）。
+ *
+ * 为什么不是 .cmd：批处理启动的任何控制台程序都会**弹出一个窗口**，
+ * `start /min` 只能把它最小化 —— 任务栏里始终挂着一个 node.exe，很碍眼。
+ * 改用 WScript.Shell.Run 的第二参数（窗口样式）传 0，窗口**完全隐藏**：
+ *   0 = 隐藏窗口，False = 不等待其结束（否则 wscript 会一直挂着）
+ *
+ * 编码用 UTF-16LE 带 BOM：wscript 默认按系统 ANSI 代码页读 .vbs，
+ * 若安装路径含中文（例如用户名是中文）会乱码成乱路径；带 BOM 则按 Unicode 解析。
  *
- * 注意两点：
- *   · 换行必须是 CRLF，注释用英文 —— cmd 按系统 ANSI 代码页解析批处理，
- *     写中文注释在中文 Windows 上容易乱码（虽然注释不影响执行，但很难看）
- *   · 用 `start /min` 让服务窗口最小化，不打扰用户，同时任务栏里能看到它在跑
+ * 隐藏窗口后看不到服务日志，所以启动命令带 `--log`：输出转存到
+ * <数据目录>/logs/service.log（见 bin/deskpet.mjs）。
  */
-function winCmdContent(): string {
+function winVbsContent(): string {
   const { node, entry } = launch()
   return [
-    '@echo off',
-    'rem DeskPet autostart - generated by the DeskPet dashboard.',
-    'rem Delete this file to disable autostart.',
-    `cd /d "${appRoot()}"`,
-    `start "${APP_ID}" /min "${node}" "${entry}" --no-open`,
+    "' DeskPet autostart - generated by the DeskPet dashboard.",
+    "' Delete this file to disable autostart.",
+    'Set sh = CreateObject("WScript.Shell")',
+    `sh.CurrentDirectory = "${appRoot()}"`,
+    `sh.Run """${node}"" ""${entry}"" --no-open --log", 0, False`,
     ''
   ].join('\r\n')
 }
@@ -123,29 +140,45 @@ function linuxDesktopContent(): string {
 
 // ── 对外接口 ────────────────────────────────────────────────
 
+export interface AutoStartOptions {
+  /**
+   * 配置为「关闭」时是否删除自启文件（默认 true）。
+   *
+   * 启动时的同步必须传 false：多个实例可能共用同一个启动文件夹，
+   * 一个以默认配置（autoStart=false）起来的实例不该把别人的自启文件删掉。
+   * 这个坑很隐蔽 —— 临时跑一次 `npx deskpet`（数据目录是全新的默认配置）
+   * 就会把主实例的开机自启悄悄弄没，之后每次开机都得手动启动。
+   * 关闭自启只应由「设置页里显式关掉开关」这个动作来执行。
+   */
+  removeWhenOff?: boolean
+}
+
 /** 开启 / 关闭开机自启，返回是否成功（失败原因会打印到日志） */
-export async function setAutoStart(on: boolean): Promise<boolean> {
+export async function setAutoStart(on: boolean, opts: AutoStartOptions = {}): Promise<boolean> {
+  const removeWhenOff = opts.removeWhenOff ?? true
   try {
     if (process.platform === 'win32') {
       const dir = winStartupDir()
       mkdirSync(dir, { recursive: true })
 
-      // 清掉 Electron 时代遗留的失效快捷方式（它指向 pet\dist\DeskPet.exe）
-      const legacy = winLegacyLnkPath()
-      if (existsSync(legacy)) {
+      // 清掉历史遗留：Electron 时代的 .lnk（指向已不存在的 pet\dist\DeskPet.exe）
+      // 与上一版的 .cmd（会弹窗口）。留着只会重复启动或误导排查。
+      for (const legacy of winLegacyPaths()) {
+        if (!existsSync(legacy)) continue
         try {
           unlinkSync(legacy)
-          console.log(`[autostart] 已清理旧版自启快捷方式: ${legacy}`)
+          console.log(`[autostart] 已清理旧版自启文件: ${legacy}`)
         } catch (err) {
-          console.warn(`[autostart] 旧快捷方式清理失败（可手动删除）: ${String(err)}`)
+          console.warn(`[autostart] 旧自启文件清理失败（可手动删除）: ${String(err)}`)
         }
       }
 
-      const file = winCmdPath()
+      const file = winVbsPath()
       if (on) {
-        writeFileSync(file, winCmdContent(), 'utf-8')
-        console.log(`[autostart] 开机自启已开启: ${file}`)
-      } else if (existsSync(file)) {
+        // utf16le + BOM：见 winVbsContent() 的说明（路径含中文时不会被 ANSI 解析搞坏）
+        writeFileSync(file, Buffer.from(`\ufeff${winVbsContent()}`, 'utf16le'))
+        console.log(`[autostart] 开机自启已开启（静默，无窗口）: ${file}`)
+      } else if (removeWhenOff && existsSync(file)) {
         unlinkSync(file)
         console.log('[autostart] 开机自启已关闭')
       }
@@ -158,7 +191,7 @@ export async function setAutoStart(on: boolean): Promise<boolean> {
         mkdirSync(dirname(file), { recursive: true })
         writeFileSync(file, macPlistContent(), 'utf-8')
         console.log(`[autostart] 开机自启已开启: ${file}`)
-      } else if (existsSync(file)) {
+      } else if (removeWhenOff && existsSync(file)) {
         unlinkSync(file)
         console.log('[autostart] 开机自启已关闭')
       }
@@ -171,7 +204,7 @@ export async function setAutoStart(on: boolean): Promise<boolean> {
         mkdirSync(dirname(file), { recursive: true })
         writeFileSync(file, linuxDesktopContent(), 'utf-8')
         console.log(`[autostart] 开机自启已开启: ${file}`)
-      } else if (existsSync(file)) {
+      } else if (removeWhenOff && existsSync(file)) {
         unlinkSync(file)
         console.log('[autostart] 开机自启已关闭')
       }
@@ -189,7 +222,10 @@ export async function setAutoStart(on: boolean): Promise<boolean> {
 /** 查询当前是否已设置自启 */
 export function autoStartEnabled(): boolean {
   try {
-    if (process.platform === 'win32') return existsSync(winCmdPath())
+    if (process.platform === 'win32') {
+      // .cmd 是上一版留下的形式，也算「已开启」，直到下次写入时被替换
+      return winLegacyPaths().some((p) => p.endsWith('.cmd') && existsSync(p)) || existsSync(winVbsPath())
+    }
     if (process.platform === 'darwin') return existsSync(macPlistPath())
     if (process.platform === 'linux') return existsSync(linuxDesktopPath())
   } catch {