@wanghaopeng1148/deskpet 2.0.3 → 2.0.5

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
@@ -146,13 +155,16 @@ function waitPort(port, host = '127.0.0.1', timeoutMs = 30000) {
 }
 
 function openUrl(url) {
+  // windowsHide 一并加上：这三个都是控制台程序（cmd）或会转交控制台，
+  // stdio 又是 ignore + detached，不加就会给浏览器那一跳闪一个黑窗体
+  const opts = { stdio: 'ignore', detached: true, windowsHide: true }
   try {
     if (isWin) {
-      spawn('cmd', ['/c', 'start', '', url], { stdio: 'ignore', detached: true }).unref()
+      spawn('cmd', ['/c', 'start', '', url], opts).unref()
     } else if (process.platform === 'darwin') {
-      spawn('open', [url], { stdio: 'ignore', detached: true }).unref()
+      spawn('open', [url], opts).unref()
     } else {
-      spawn('xdg-open', [url], { stdio: 'ignore', detached: true }).unref()
+      spawn('xdg-open', [url], opts).unref()
     }
   } catch {
     /* 打不开就算了：URL 已经打印出来，用户可自行复制 */
@@ -187,12 +199,45 @@ 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',
-  env: { ...process.env, DESKPET_PORT: String(port) }
+  stdio: logStream ? ['ignore', 'pipe', 'pipe'] : 'inherit',
+  env: { ...process.env, DESKPET_PORT: String(port) },
+  /**
+   * windowsHide: true —— 关键的一行。
+   *
+   * Node 的这个选项默认是 **false**。它只在「父进程没有控制台、且没有继承 stdio」
+   * 时才起作用：那种情况下 Windows 会给子进程**新分配一个控制台窗口**，
+   * 也就是开机时闪一下的黑窗体。自启链路里 wscript 本身是没有控制台的图形程序，
+   * 一旦 stdio 走管道（--log 就是这种情况），子进程就属于这一档。
+   * 设为 true 会让 Node 带上 CREATE_NO_WINDOW，任何情况下都不会新建窗口。
+   */
+  windowsHide: true
 })
 
+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/utils/auto-start.js

@@ -2,21 +2,24 @@
  * 开机自启
  *
  * 各平台实现：
- *   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**，避免重复启动或误导排查。
  *
  * 仅在用户在设置中开启时写入；任何异常都只记录日志，不影响服务本身。
  */
@@ -45,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）。
  *
- * 注意两点：
- *   · 换行必须是 CRLF，注释用英文 —— cmd 按系统 ANSI 代码页解析批处理，
- *     写中文注释在中文 Windows 上容易乱码（虽然注释不影响执行，但很难看）
- *   · 用 `start /min` 让服务窗口最小化，不打扰用户，同时任务栏里能看到它在跑
+ * 为什么不是 .cmd：批处理启动的任何控制台程序都会**弹出一个窗口**，
+ * `start /min` 只能把它最小化 —— 任务栏里始终挂着一个 node.exe，很碍眼。
+ * 改用 WScript.Shell.Run 的第二参数（窗口样式）传 0，窗口**完全隐藏**：
+ *   0 = 隐藏窗口，False = 不等待其结束（否则 wscript 会一直挂着）
+ *
+ * 编码用 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');
 }
@@ -120,21 +130,24 @@ export async function setAutoStart(on, opts = {}) {
         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 (removeWhenOff && existsSync(file)) {
                 unlinkSync(file);
@@ -179,8 +192,10 @@ export async function setAutoStart(on, opts = {}) {
 /** 查询当前是否已设置自启 */
 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.3",
+  "version": "2.0.5",
   "description": "DeskPet 2.0 — 本机任务自动化服务 + Web 管理台 (Node + Express + Vue 3 + TypeScript)",
   "type": "module",
   "author": "whp",

package/server/utils/auto-start.ts

@@ -2,21 +2,24 @@
  * 开机自启
  *
  * 各平台实现：
- *   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**，避免重复启动或误导排查。
  *
  * 仅在用户在设置中开启时写入；任何异常都只记录日志，不影响服务本身。
  */
@@ -51,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）。
  *
- * 注意两点：
- *   · 换行必须是 CRLF，注释用英文 —— cmd 按系统 ANSI 代码页解析批处理，
- *     写中文注释在中文 Windows 上容易乱码（虽然注释不影响执行，但很难看）
- *   · 用 `start /min` 让服务窗口最小化，不打扰用户，同时任务栏里能看到它在跑
+ * 为什么不是 .cmd：批处理启动的任何控制台程序都会**弹出一个窗口**，
+ * `start /min` 只能把它最小化 —— 任务栏里始终挂着一个 node.exe，很碍眼。
+ * 改用 WScript.Shell.Run 的第二参数（窗口样式）传 0，窗口**完全隐藏**：
+ *   0 = 隐藏窗口，False = 不等待其结束（否则 wscript 会一直挂着）
+ *
+ * 编码用 UTF-16LE 带 BOM：wscript 默认按系统 ANSI 代码页读 .vbs，
+ * 若安装路径含中文（例如用户名是中文）会乱码成乱路径；带 BOM 则按 Unicode 解析。
+ *
+ * 隐藏窗口后看不到服务日志，所以启动命令带 `--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')
 }
@@ -151,21 +161,23 @@ export async function setAutoStart(on: boolean, opts: AutoStartOptions = {}): Pr
       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 (removeWhenOff && existsSync(file)) {
         unlinkSync(file)
         console.log('[autostart] 开机自启已关闭')
@@ -210,7 +222,10 @@ export async function setAutoStart(on: boolean, opts: AutoStartOptions = {}): Pr
 /** 查询当前是否已设置自启 */
 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 {