@wanghaopeng1148/deskpet 2.0.0 → 2.0.2

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 */
   }

package/server/utils/paths.ts

@@ -23,6 +23,33 @@ export function moduleDir(): string {
 
 const MODULE_DIR = moduleDir()
 
+/**
+ * 包根目录（含 package.json 的那一层）。
+ *
+ * 为什么不写死相对层级：源码运行时本模块在 `server/utils/`，
+ * 而发布产物在 `dist/node/server/utils/` —— 两者距包根的层数不同，
+ * 任何 `../../xxx` 形式的假设都会在编译后失效（曾导致 resources 与 dist/web 定位不到）。
+ * 这里改为从模块目录向上查找 package.json，源码形态与产物形态都能正确定位。
+ */
+function findPackageRoot(): string {
+  let dir = MODULE_DIR
+  for (let i = 0; i < 8; i += 1) {
+    if (existsSync(join(dir, 'package.json'))) return dir
+    const parent = dirname(dir)
+    if (parent === dir) break
+    dir = parent
+  }
+  // 兜底：沿用源码形态的假设（server/utils → 上两级即包根）
+  return resolve(MODULE_DIR, '../..')
+}
+
+const PACKAGE_ROOT = findPackageRoot()
+
+/** 包根目录 */
+export function getPackageRoot(): string {
+  return PACKAGE_ROOT
+}
+
 /** 数据根目录（配置/数据库/皮肤/快照） */
 export function getDataRoot(): string {
   const env = process.env.DESKPET_HOME
@@ -34,7 +61,7 @@ export function getDataRoot(): string {
 export function getResourcesRoot(): string {
   const env = process.env.DESKPET_RESOURCES
   if (env && env.trim()) return resolve(env.trim())
-  return resolve(MODULE_DIR, '../../resources')
+  return join(PACKAGE_ROOT, 'resources')
 }
 
 /** 用户配置目录 */