@wanghaopeng1148/deskpet 2.0.0

package/server/services/wechat-command-types.ts

@@ -0,0 +1,15 @@
+/**
+ * 微信指令路由依赖的最小调度器接口（便于测试注入替身）
+ */
+import type { TaskConfig, TaskDto } from '../../shared/types.ts'
+
+export type { TaskDto }
+
+export interface TaskSchedulerLike {
+  listTasks(): TaskDto[]
+  isStarted: boolean
+  requestRun(id: string, source?: 'manual' | 'trigger' | 'chain' | 'retry'): boolean
+  /** 带参执行：临时覆盖 scriptArgs，执行完自动恢复 */
+  runTaskWithArgs(id: string, args: string[]): boolean
+  createTask(config: TaskConfig): TaskDto
+}

package/server/services/wechat-commands.ts

@@ -0,0 +1,367 @@
+/**
+ * 微信指令路由 — 把微信收到的文本翻译成本地操作（对齐旧版 wechat_commands.py）
+ *
+ * 8 类指令: 帮助 / 状态 / 任务列表 / 创建任务 / 执行 / 带参执行 / 参数 / 提醒
+ * 仅关键字匹配，不接任何大模型；未识别返回提示。
+ */
+import * as os from 'node:os'
+import type { TaskDto, TaskSchedulerLike } from './wechat-command-types.ts'
+
+export const HELP_TEXT = [
+  '🐾 桌面宠物 · 微信指令',
+  '✅创建任务 <名称> <日期> <时间>',
+  '　　创建定时提醒任务',
+  '　　如: 创建任务 党会 2026-09-20 14:00',
+  '✅任务列表　查看全部任务',
+  '✅执行 <名称|序号> -- <参数...>',
+  '　　用自定义参数执行任务（临时覆盖，不改原配置）',
+  '✅带参执行 <名称|序号> -- <参数...>　同上（显式语义）',
+  '✅参数 <名称|序号>　查看任务运行参数',
+  '✅提醒 <内容>　在电脑上弹出全屏提醒',
+  '✅状态　查看桌宠与任务运行状态',
+  '✅帮助　显示本说明',
+  '任务执行完成后会自动推送结果到这里'
+].join('\n')
+
+const STATUS_ICON: Record<string, string> = {
+  running: '🔄',
+  completed: '✅',
+  failed: '❌',
+  disabled: '⏸',
+  idle: '⚪',
+  pending: '⏳',
+  cancelled: '🚫'
+}
+
+const TYPE_NAME: Record<string, string> = { manual: '手动', scheduled: '定时', scene: '场景' }
+
+function fmtTime(iso: string | null): string {
+  if (!iso) return '-'
+  const d = new Date(iso)
+  const p = (n: number): string => String(n).padStart(2, '0')
+  return `${d.getFullYear()}-${p(d.getMonth() + 1)}-${p(d.getDate())} ${p(d.getHours())}:${p(d.getMinutes())}`
+}
+
+export interface CommandDeps {
+  scheduler: TaskSchedulerLike
+  /** 弹出桌面全屏提醒 */
+  reminder: (text: string) => void
+}
+
+export class WechatCommandRouter {
+  private deps: CommandDeps
+
+  constructor(deps: CommandDeps) {
+    this.deps = deps
+  }
+
+  /** 处理一条微信消息；返回回复文本，null 表示不回复 */
+  handle(text: string): string | null {
+    const t = (text ?? '').trim()
+    if (!t) return null
+
+    if (['帮助', 'help', '?', '？', '菜单'].includes(t.toLowerCase()) || t === '帮助') {
+      return HELP_TEXT
+    }
+    if (['状态', 'status', '运行状态'].includes(t)) {
+      return this.status()
+    }
+    if (['任务列表', '任务', 'tasks', '列表'].includes(t)) {
+      return this.listTasks()
+    }
+    for (const prefix of ['创建任务', '新建任务', '添加任务']) {
+      if (t.startsWith(prefix)) return this.createTask(t.slice(prefix.length).trim())
+    }
+    for (const prefix of ['执行', '运行', 'run']) {
+      if (t.startsWith(prefix)) return this.execute(t.slice(prefix.length).trim(), false)
+    }
+    for (const prefix of ['带参执行', '带参运行']) {
+      if (t.startsWith(prefix)) return this.execute(t.slice(prefix.length).trim(), true)
+    }
+    if (t.startsWith('参数')) return this.showParams(t.slice(2).trim())
+    if (t.toLowerCase().startsWith('params')) return this.showParams(t.slice(6).trim())
+    if (t.startsWith('提醒')) return this.remind(t.slice(2).trim())
+
+    return '❓ 未识别的指令，发送「帮助」查看可用指令'
+  }
+
+  // ── 状态 ────────────────────────────────────────────────
+
+  private status(): string {
+    const sched = this.deps.scheduler
+    if (!sched) return '🟢 桌面宠物在线\n（任务调度器未接入）'
+    const tasks = sched.listTasks()
+    const running = tasks.filter((t) => t.status === 'running').length
+    const enabled = tasks.filter((t) => t.config.enabled).length
+    return (
+      '🟢 桌面宠物在线\n' +
+      `时间：${fmtTime(new Date().toISOString())}\n` +
+      `主机：${os.hostname()}\n` +
+      `系统：${os.type()} ${os.release()}\n` +
+      `任务：共 ${tasks.length} 个 / 已启用 ${enabled} 个 / 运行中 ${running} 个\n` +
+      `调度器：${sched.isStarted ? '运行中' : '已停止'}`
+    )
+  }
+
+  // ── 任务列表 ────────────────────────────────────────────
+
+  private listTasks(): string {
+    const records = this.deps.scheduler?.listTasks() ?? []
+    if (!records.length) {
+      return '📋 当前没有配置任何任务\n请在管理台「任务管理」中添加'
+    }
+    const lines = ['📋 任务列表']
+    records.forEach((rec, i) => {
+      const icon = STATUS_ICON[rec.status] ?? '⚪'
+      const flag = rec.config.enabled ? '' : '（已禁用）'
+      lines.push(`${i + 1}. ${icon} ${rec.config.name}${flag}`)
+    })
+    lines.push('发送「执行 1」或「执行 任务名」立即运行')
+    return lines.join('\n')
+  }
+
+  // ── 任务解析：序号/精确/模糊 ────────────────────────────
+
+  private resolveTask(target: string): { record: TaskDto | null; error: string | null } {
+    const records = this.deps.scheduler?.listTasks() ?? []
+    if (!records.length) return { record: null, error: '❌ 当前没有配置任何任务' }
+
+    if (!target) {
+      return {
+        record: null,
+        error: '用法：执行/参数 <任务名或序号>\n发送「任务列表」查看可用任务'
+      }
+    }
+
+    let record: TaskDto | null = null
+
+    // 1) 按序号
+    if (/^\d+$/.test(target)) {
+      const idx = parseInt(target, 10)
+      if (idx >= 1 && idx <= records.length) record = records[idx - 1]
+      else return { record: null, error: `❌ 序号超出范围（1-${records.length}）` }
+    }
+
+    // 2) 名称精确匹配
+    if (!record) {
+      record = records.find((r) => r.config.name === target) ?? null
+    }
+
+    // 3) 名称模糊匹配
+    if (!record) {
+      const hits = records.filter((r) => r.config.name.includes(target))
+      if (hits.length === 1) record = hits[0]
+      else if (hits.length > 1) {
+        const names = hits
+          .slice(0, 5)
+          .map((r) => r.config.name)
+          .join('、')
+        return { record: null, error: `❓ 匹配到多个任务：${names}\n请发送完整任务名或序号` }
+      }
+    }
+
+    if (!record) {
+      return { record: null, error: `❌ 未找到任务「${target}」\n发送「任务列表」查看可用任务` }
+    }
+    return { record, error: null }
+  }
+
+  // ── 执行 / 带参执行 ─────────────────────────────────────
+
+  private execute(target: string, forceArgs: boolean): string {
+    const sched = this.deps.scheduler
+    if (!sched) return '❌ 任务调度器未接入，无法执行任务'
+
+    // 解析 "任务名 -- arg1 arg2"
+    let taskTarget = target
+    let scriptArgs: string[] = []
+    if (target.includes(' -- ')) {
+      const [head, tail] = target.split(' -- ', 2)
+      taskTarget = head.trim()
+      scriptArgs = tail.trim() ? tail.trim().split(/\s+/) : []
+    }
+    if (forceArgs && !scriptArgs) {
+      return (
+        '用法：带参执行 <任务名|序号> -- <参数1> <参数2> ...\n' +
+        '例如：带参执行 备份 -- /data /backup\n' +
+        '参数会临时覆盖原配置，执行完自动恢复'
+      )
+    }
+
+    const { record, error } = this.resolveTask(taskTarget)
+    if (!record) return error as string
+
+    if (!record.config.enabled) {
+      return `⏸ 任务「${record.config.name}」已被禁用，请先在管理台启用`
+    }
+    if (record.status === 'running') {
+      return `🔄 任务「${record.config.name}」正在执行中，请稍候`
+    }
+
+    if (scriptArgs.length > 0) {
+      if (record.config.action !== 'python_script') {
+        return `⚠️ 任务「${record.config.name}」不是脚本任务\n只有 Python 脚本任务支持自定义参数`
+      }
+      const ok = sched.runTaskWithArgs(record.id, scriptArgs)
+      if (!ok) return `❌ 任务「${record.config.name}」启动失败`
+      return (
+        `🔔 已开始带参执行任务「${record.config.name}」\n` +
+        `临时参数：${scriptArgs.join(' ')}\n` +
+        `（执行完自动恢复原配置参数）\n完成后会自动推送结果`
+      )
+    }
+
+    const ok = sched.requestRun(record.id)
+    if (!ok) return `❌ 任务「${record.config.name}」启动失败`
+    return `🔔 已开始执行任务「${record.config.name}」\n完成后会自动推送结果`
+  }
+
+  // ── 查看参数 ────────────────────────────────────────────
+
+  private showParams(target: string): string {
+    const { record, error } = this.resolveTask(target)
+    if (!record) return error as string
+
+    const cfg = record.config
+    const lines = ['🔧 任务运行参数', `【${cfg.name}】`]
+    lines.push(
+      `类型：${TYPE_NAME[cfg.type] ?? cfg.type}｜状态：${record.status}｜${cfg.enabled ? '启用' : '已禁用'}`
+    )
+    lines.push(`动作：${cfg.action || '（无）'}`)
+
+    if (cfg.action === 'python_script') {
+      lines.push(`脚本：${cfg.scriptPath || '（未设置）'}`)
+      if (cfg.interpreter) lines.push(`解释器：${cfg.interpreter}`)
+      if (cfg.scriptArgs?.length) lines.push(`脚本参数：${cfg.scriptArgs.join(' ')}`)
+      if (cfg.scriptWorkDir) lines.push(`工作目录：${cfg.scriptWorkDir}`)
+      lines.push(`超时：${cfg.scriptTimeout}s`)
+    }
+
+    const tr = cfg.trigger
+    if (cfg.type === 'scheduled') {
+      let trig = '定时（未配置）'
+      if (tr.type === 'cron' && tr.cron) trig = `定时 (cron: ${tr.cron})`
+      else if (tr.type === 'once' && tr.datetime) trig = `定时 (${tr.datetime})`
+      else if (tr.type === 'delay' && tr.delaySeconds) trig = `延时 (${tr.delaySeconds}s)`
+      else if (tr.type === 'interval' && tr.intervalMinutes) trig = `间隔 (${tr.intervalMinutes} 分钟)`
+      lines.push(`触发：${trig}`)
+    } else if (cfg.type === 'scene') {
+      const sceneMap: Record<string, string> = { idle: '闲置', startup: '开机', network: '联网' }
+      lines.push(`触发：场景（${sceneMap[tr.type] ?? tr.type}）`)
+    }
+
+    if (cfg.actionParams && Object.keys(cfg.actionParams).length > 0) {
+      lines.push('运行参数：')
+      for (const [k, v] of Object.entries(cfg.actionParams)) {
+        lines.push(`  ${k}：${String(v)}`)
+      }
+    } else {
+      lines.push('运行参数：（无）')
+    }
+
+    lines.push(`重试：${cfg.retryCount} 次`)
+    lines.push(`累计执行：${record.executionCount} 次`)
+    if (record.lastRunAt) lines.push(`最后运行：${fmtTime(record.lastRunAt)}`)
+    return lines.join('\n')
+  }
+
+  // ── 提醒 ────────────────────────────────────────────────
+
+  private remind(content: string): string {
+    if (!content) return '用法：提醒 <提醒内容>\n例如：提醒 该开会了'
+    try {
+      this.deps.reminder(content)
+    } catch (err) {
+      return `❌ 提醒弹出失败：${String(err)}`
+    }
+    return `✅ 已在电脑上弹出提醒：${content}`
+  }
+
+  // ── 创建任务（定时提醒，oneTime） ───────────────────────
+
+  private createTask(content: string): string {
+    const sched = this.deps.scheduler
+    if (!sched) return '❌ 任务调度器未接入，无法创建任务'
+
+    if (!content) {
+      return (
+        '用法：创建任务 <任务名> <日期> <时间>\n' +
+        '例如：创建任务 党会 2026-09-20 14:00\n' +
+        '任务到时间会在电脑上弹出桌面提醒'
+      )
+    }
+
+    const dateMatch = /\d{4}[-/]\d{1,2}[-/]\d{1,2}/.exec(content)
+    const timeMatch = /\d{1,2}[:：]\d{2}/.exec(content)
+    if (!dateMatch) {
+      return (
+        '❌ 未识别到日期\n格式：创建任务 <任务名> YYYY-MM-DD HH:MM\n例如：创建任务 党会 2026-09-20 14:00'
+      )
+    }
+
+    // 规范化日期
+    const dateParts = dateMatch[0].replace(/\//g, '-').split('-')
+    const dateStr = `${dateParts[0]}-${String(Number(dateParts[1])).padStart(2, '0')}-${String(
+      Number(dateParts[2])
+    ).padStart(2, '0')}`
+
+    // 规范化时间（缺省 09:00）
+    let timeStr = '09:00'
+    if (timeMatch) {
+      const tp = timeMatch[0].replace('：', ':').split(':')
+      timeStr = `${String(Number(tp[0])).padStart(2, '0')}:${tp[1]}`
+    }
+    const datetimeStr = `${dateStr} ${timeStr}`
+
+    // 提取任务名：剔除日期与时间片段
+    let name = content
+    if (timeMatch) name = name.replace(timeMatch[0], ' ')
+    name = name.replace(dateMatch[0], ' ')
+    name = name.split(/\s+/).filter(Boolean).join(' ')
+    if (!name) return '❌ 任务名不能为空\n例如：创建任务 党会 2026-09-20 14:00'
+
+    // 校验未来时间
+    const runTime = new Date(`${datetimeStr.replace(' ', 'T')}:00`)
+    if (Number.isNaN(runTime.getTime())) {
+      return `❌ 日期时间格式错误: ${datetimeStr}`
+    }
+    if (runTime.getTime() <= Date.now()) {
+      return `❌ 时间已过去: ${datetimeStr}\n请指定未来的时间`
+    }
+
+    const dto = sched.createTask({
+      name,
+      type: 'scheduled',
+      trigger: {
+        type: 'once',
+        datetime: datetimeStr,
+        cron: null,
+        delaySeconds: null,
+        intervalMinutes: null,
+        idleMinutes: null,
+        maxExecutions: -1,
+        holidayCheck: false
+      },
+      action: 'show_reminder',
+      actionParams: { text: `提醒：${name}` },
+      scriptPath: '',
+      interpreter: null,
+      scriptArgs: [],
+      scriptTimeout: 120,
+      scriptWorkDir: null,
+      retryCount: 0,
+      enabled: true,
+      notifyChannels: [],
+      chainNext: null,
+      chainCondition: null,
+      oneTime: true
+    })
+
+    return (
+      `✅ 定时提醒已创建\n` +
+      `任务：${dto.config.name}\n` +
+      `时间：${datetimeStr}\n` +
+      `到点将在电脑上弹出全屏提醒，执行后自动删除`
+    )
+  }
+}

package/server/suppress-warnings.ts

@@ -0,0 +1,10 @@
+/**
+ * 进程级警告开关 —— 必须在 main.ts 的所有其他导入之前引入（ESM 导入按顺序求值）。
+ * node:sqlite 在 Node 22（Electron 37 内置）中为实验性 API，在内置模块编译期
+ * （compileForInternalLoader）同步发出 ExperimentalWarning，该时机早于 'warning'
+ * 事件分派，内部调用也不经过 process.emitWarning 属性查找，故事件监听与包装均无法
+ * 阻止默认打印。Node 在 emitExperimentalWarning 内提供了 process.noProcessWarnings
+ * 开关（等价 --no-warnings 对实验警告的效果）：在加载 node:sqlite 前置为 true 即可
+ * 静默实验警告；DeprecationWarning 等其他类型警告不受影响。
+ */
+;(process as NodeJS.Process & { noProcessWarnings?: boolean }).noProcessWarnings = true

package/server/utils/asset-url.ts

@@ -0,0 +1,27 @@
+/**
+ * 皮肤资源 URL — 取代原 deskpet:// 自定义协议
+ *
+ * 皮肤精灵图等本地文件通过 HTTP 接口 /api/assets?path=<绝对路径> 分发，
+ * 服务端做目录白名单校验，避免任意文件读取。
+ */
+import { existsSync } from 'node:fs'
+import { normalize, resolve, sep } from 'node:path'
+import { getResourcesRoot, getUserSkinsDir } from './paths.ts'
+
+export const ASSET_ENDPOINT = '/api/assets'
+
+/**
+ * 校验并解析 /api/assets 的 path 参数
+ * 仅允许访问用户皮肤目录与内置资源目录内的已存在文件，越界返回 null
+ */
+export function resolveAssetRequest(raw: unknown): string | null {
+  if (typeof raw !== 'string' || !raw.trim()) return null
+  const abs = normalize(resolve(raw.trim()))
+  for (const root of [getUserSkinsDir(), getResourcesRoot()]) {
+    const r = normalize(resolve(root))
+    if (abs === r || abs.startsWith(r + sep)) {
+      return existsSync(abs) ? abs : null
+    }
+  }
+  return null
+}

package/server/utils/auto-start.ts

@@ -0,0 +1,90 @@
+/**
+ * 开机自启 — 取代 Electron app.setLoginItemSettings
+ *   Windows: HKCU\...\Run 注册表项
+ *   macOS  : ~/Library/LaunchAgents plist
+ *   Linux  : 暂不支持
+ *
+ * 仅在用户在设置中开启时写入；任何异常都只记录日志，不影响服务启动。
+ */
+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 { fileURLToPath } from 'node:url'
+
+const APP_ID = 'DeskPet'
+
+/** 当前入口脚本绝对路径（供开机启动调用） */
+function entryScript(): string {
+  return fileURLToPath(import.meta.url).replace(/utils[\\/]auto-start\.ts$/, 'main.ts')
+}
+
+/** 建议的启动命令：node <入口> */
+function startCommand(): string {
+  return `"${process.execPath}" "${entryScript()}"`
+}
+
+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
+    }
+
+    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"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+  <dict>
+    <key>Label</key>
+    <string>${APP_ID}</string>
+    <key>ProgramArguments</key>
+    <array>
+      <string>${parts[0]}</string>
+${programArgs}
+    </array>
+    <key>RunAtLoad</key>
+    <true/>
+  </dict>
+</plist>
+`,
+        'utf-8'
+      )
+      return true
+    }
+  } 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`))
+    }
+  } catch {
+    /* ignore */
+  }
+  return false
+}

package/server/utils/clipboard.ts

@@ -0,0 +1,50 @@
+/**
+ * 剪贴板读写 — 取代 Electron clipboard 模块
+ * 通过系统命令实现，失败时静默返回空串（不阻塞任务链路）
+ */
+import { execFile } from 'node:child_process'
+
+function run(cmd: string, args: string[], input?: string): Promise<string> {
+  return new Promise((resolvePromise) => {
+    const child = execFile(
+      cmd,
+      args,
+      { timeout: 3000, windowsHide: true, maxBuffer: 4 * 1024 * 1024 },
+      (err, stdout) => {
+        resolvePromise(err ? '' : String(stdout ?? ''))
+      }
+    )
+    if (input !== undefined) child.stdin?.end(input)
+  })
+}
+
+/** 读取剪贴板文本；不支持的平台返回空串 */
+export async function readClipboardText(): Promise<string> {
+  try {
+    if (process.platform === 'darwin') return await run('pbpaste', [])
+    if (process.platform === 'win32') {
+      return await run('powershell', [
+        '-NoProfile',
+        '-Sta',
+        '-Command',
+        'Get-Clipboard -Raw'
+      ])
+    }
+    if (process.platform === 'linux') return await run('xclip', ['-selection', 'clipboard', '-o'])
+  } catch {
+    /* ignore */
+  }
+  return ''
+}
+
+/** 清空剪贴板 */
+export async function clearClipboard(): Promise<void> {
+  try {
+    if (process.platform === 'darwin') await run('pbcopy', [], '')
+    else if (process.platform === 'win32') {
+      await run('powershell', ['-NoProfile', '-Command', 'Set-Clipboard -Value $null'])
+    } else if (process.platform === 'linux') await run('xclip', ['-selection', 'clipboard'], '')
+  } catch {
+    /* ignore */
+  }
+}

package/server/utils/dashboard-url.ts

@@ -0,0 +1,9 @@
+/**
+ * 管理台 WebUI 地址工具
+ */
+
+/** 管理台访问地址（0.0.0.0 监听时本机访问用 127.0.0.1） */
+export function dashboardUrl(host: string, port: number): string {
+  const h = host === '0.0.0.0' || host === '' ? '127.0.0.1' : host
+  return `http://${h}:${port}/`
+}