@wanghaopeng1148/deskpet 2.0.0 → 2.0.1

package/README.md

@@ -391,4 +391,19 @@ resources/  皮肤、图标等随包资源
   （执行中 / 排队 N），列表里排队任务显示 `#序号`，点「取消排队」可撤销；仪表盘横幅也会显示执行中与排队数。
   前端通过 `GET /api/queue` 拉取，并用 WebSocket `queue-changed` 实时更新。
 - 通知通道：系统原生通知（osascript / PowerShell Toast / notify-send）+ 管理台页面内提示 + 微信。
-- 开机自启：Windows 写入 `HKCU\...\Run`，macOS 写入 `~/Library/LaunchAgents`，Linux 暂不支持。
+- **开机自启**：管理台「设置」页有开关（对应配置项 `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`。

package/package.json

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

package/server/utils/auto-start.ts

@@ -1,55 +1,86 @@
 /**
- * 开机自启 — 取代 Electron app.setLoginItemSettings
- *   Windows: HKCU\...\Run 注册表项
- *   macOS  : ~/Library/LaunchAgents plist
- *   Linux  : 暂不支持
+ * 开机自启
  *
- * 仅在用户在设置中开启时写入；任何异常都只记录日志，不影响服务启动。
+ * 各平台实现：
+ *   Windows  启动文件夹放一个 .cmd —— 不依赖 reg / schtasks 命令，受管控的机器一样能用
+ *   macOS    ~/Library/LaunchAgents/<APP_ID>.plist
+ *   Linux    ~/.config/autostart/<APP_ID>.desktop（XDG 标准，GNOME/KDE 都认）
+ *
+ * 启动命令统一走 `bin/deskpet.mjs --no-open`，理由：
+ *   · bin/ 在「源码运行」和「npm 包运行」两种形态下都存在（scripts/ 不进发布包）
+ *   · 它内部用 process.execPath 拉起 server/main.ts，不依赖 PATH 里有没有 node / npm
+ *   · 脚本自己会按 package.json 推导根目录，所以不依赖工作目录
+ *   · --no-open 避免每次开机都弹一个浏览器
+ *
+ * 历史坑（说明为什么要主动清理旧文件）：
+ *   本项目早期是 Electron 应用，自启是安装包写在启动文件夹里的快捷方式
+ *   （DeskPet.lnk → pet\dist\DeskPet.exe）。后来改成纯 Node 服务、目录也从 pet 换成 pet2.0，
+ *   那个旧快捷方式却没人清理 —— 结果用户以为自启开着，实际每次开机拉起的是旧程序，
+ *   新服务仍然要手动启动。因此下面在写入自启时会**顺手删掉同名的旧 .lnk**。
+ *
+ * 仅在用户在设置中开启时写入；任何异常都只记录日志，不影响服务本身。
  */
-import { execFile } from 'node:child_process'
 import { existsSync, mkdirSync, unlinkSync, writeFileSync } from 'node:fs'
 import { homedir } from 'node:os'
-import { join } from 'node:path'
+import { dirname, join, resolve } from 'node:path'
 import { fileURLToPath } from 'node:url'
 
 const APP_ID = 'DeskPet'
 
-/** 当前入口脚本绝对路径（供开机启动调用） */
-function entryScript(): string {
-  return fileURLToPath(import.meta.url).replace(/utils[\\/]auto-start\.ts$/, 'main.ts')
+/** 应用根目录（源码运行为项目根，npm 包运行为包根） */
+function appRoot(): string {
+  return resolve(dirname(fileURLToPath(import.meta.url)), '..', '..')
 }
 
-/** 建议的启动命令：node <入口> */
-function startCommand(): string {
-  return `"${process.execPath}" "${entryScript()}"`
+/** 开机要执行的 node 可执行文件与入口脚本 */
+function launch(): { node: string; entry: string } {
+  return { node: process.execPath, entry: join(appRoot(), 'bin', 'deskpet.mjs') }
 }
 
-export async function setAutoStart(on: boolean): Promise<boolean> {
-  try {
-    if (process.platform === 'win32') {
-      const args = on
-        ? ['add', 'HKCU\\Software\\Microsoft\\Windows\\CurrentVersion\\Run', '/v', APP_ID, '/t', 'REG_SZ', '/d', startCommand(), '/f']
-        : ['delete', 'HKCU\\Software\\Microsoft\\Windows\\CurrentVersion\\Run', '/v', APP_ID, '/f']
-      await new Promise<void>((resolve) => {
-        execFile('reg', args, { windowsHide: true }, () => resolve())
-      })
-      return true
-    }
+// ── Windows ─────────────────────────────────────────────────
 
-    if (process.platform === 'darwin') {
-      const dir = join(homedir(), 'Library', 'LaunchAgents')
-      const plist = join(dir, `${APP_ID}.plist`)
-      if (!on) {
-        if (existsSync(plist)) unlinkSync(plist)
-        return true
-      }
-      mkdirSync(dir, { recursive: true })
-      const cmd = startCommand().replace(/"/g, '')
-      const parts = cmd.split(' ')
-      const programArgs = parts.slice(1).map((p) => `      <string>${p}</string>`).join('\n')
-      writeFileSync(
-        plist,
-        `<?xml version="1.0" encoding="UTF-8"?>
+function winStartupDir(): string {
+  const appData = process.env.APPDATA ?? join(homedir(), 'AppData', 'Roaming')
+  return join(appData, 'Microsoft', 'Windows', 'Start Menu', 'Programs', 'Startup')
+}
+
+function winCmdPath(): string {
+  return join(winStartupDir(), `${APP_ID}.cmd`)
+}
+
+function winLegacyLnkPath(): string {
+  return join(winStartupDir(), `${APP_ID}.lnk`)
+}
+
+/**
+ * 生成自启批处理。
+ *
+ * 注意两点：
+ *   · 换行必须是 CRLF，注释用英文 —— cmd 按系统 ANSI 代码页解析批处理，
+ *     写中文注释在中文 Windows 上容易乱码（虽然注释不影响执行，但很难看）
+ *   · 用 `start /min` 让服务窗口最小化，不打扰用户，同时任务栏里能看到它在跑
+ */
+function winCmdContent(): 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`,
+    ''
+  ].join('\r\n')
+}
+
+// ── macOS ───────────────────────────────────────────────────
+
+function macPlistPath(): string {
+  return join(homedir(), 'Library', 'LaunchAgents', `${APP_ID}.plist`)
+}
+
+function macPlistContent(): string {
+  const { node, entry } = launch()
+  return `<?xml version="1.0" encoding="UTF-8"?>
 <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
 <plist version="1.0">
   <dict>
@@ -57,32 +88,110 @@ export async function setAutoStart(on: boolean): Promise<boolean> {
     <string>${APP_ID}</string>
     <key>ProgramArguments</key>
     <array>
-      <string>${parts[0]}</string>
-${programArgs}
+      <string>${node}</string>
+      <string>${entry}</string>
+      <string>--no-open</string>
     </array>
+    <key>WorkingDirectory</key>
+    <string>${appRoot()}</string>
     <key>RunAtLoad</key>
     <true/>
   </dict>
 </plist>
-`,
-        'utf-8'
-      )
+`
+}
+
+// ── Linux (XDG autostart) ───────────────────────────────────
+
+function linuxDesktopPath(): string {
+  return join(homedir(), '.config', 'autostart', `${APP_ID}.desktop`)
+}
+
+function linuxDesktopContent(): string {
+  const { node, entry } = launch()
+  return [
+    '[Desktop Entry]',
+    'Type=Application',
+    `Name=${APP_ID}`,
+    'Comment=DeskPet 本机任务自动化服务',
+    `Exec="${node}" "${entry}" --no-open`,
+    `Path=${appRoot()}`,
+    'X-GNOME-Autostart-enabled=true',
+    ''
+  ].join('\n')
+}
+
+// ── 对外接口 ────────────────────────────────────────────────
+
+/** 开启 / 关闭开机自启，返回是否成功（失败原因会打印到日志） */
+export async function setAutoStart(on: boolean): Promise<boolean> {
+  try {
+    if (process.platform === 'win32') {
+      const dir = winStartupDir()
+      mkdirSync(dir, { recursive: true })
+
+      // 清掉 Electron 时代遗留的失效快捷方式（它指向 pet\dist\DeskPet.exe）
+      const legacy = winLegacyLnkPath()
+      if (existsSync(legacy)) {
+        try {
+          unlinkSync(legacy)
+          console.log(`[autostart] 已清理旧版自启快捷方式: ${legacy}`)
+        } catch (err) {
+          console.warn(`[autostart] 旧快捷方式清理失败（可手动删除）: ${String(err)}`)
+        }
+      }
+
+      const file = winCmdPath()
+      if (on) {
+        writeFileSync(file, winCmdContent(), 'utf-8')
+        console.log(`[autostart] 开机自启已开启: ${file}`)
+      } else if (existsSync(file)) {
+        unlinkSync(file)
+        console.log('[autostart] 开机自启已关闭')
+      }
       return true
     }
+
+    if (process.platform === 'darwin') {
+      const file = macPlistPath()
+      if (on) {
+        mkdirSync(dirname(file), { recursive: true })
+        writeFileSync(file, macPlistContent(), 'utf-8')
+        console.log(`[autostart] 开机自启已开启: ${file}`)
+      } else if (existsSync(file)) {
+        unlinkSync(file)
+        console.log('[autostart] 开机自启已关闭')
+      }
+      return true
+    }
+
+    if (process.platform === 'linux') {
+      const file = linuxDesktopPath()
+      if (on) {
+        mkdirSync(dirname(file), { recursive: true })
+        writeFileSync(file, linuxDesktopContent(), 'utf-8')
+        console.log(`[autostart] 开机自启已开启: ${file}`)
+      } else if (existsSync(file)) {
+        unlinkSync(file)
+        console.log('[autostart] 开机自启已关闭')
+      }
+      return true
+    }
+
+    console.warn(`[autostart] 暂不支持的平台: ${process.platform}`)
+    return false
   } catch (err) {
     console.error('[autostart] 设置失败:', err)
     return false
   }
-  console.warn(`[autostart] 暂不支持的平台: ${process.platform}`)
-  return false
 }
 
-/** 查询当前是否已设置自启（尽力而为，失败返回 false） */
+/** 查询当前是否已设置自启 */
 export function autoStartEnabled(): boolean {
   try {
-    if (process.platform === 'darwin') {
-      return existsSync(join(homedir(), 'Library', 'LaunchAgents', `${APP_ID}.plist`))
-    }
+    if (process.platform === 'win32') return existsSync(winCmdPath())
+    if (process.platform === 'darwin') return existsSync(macPlistPath())
+    if (process.platform === 'linux') return existsSync(linuxDesktopPath())
   } catch {
     /* ignore */
   }