@wanghaopeng1148/deskpet 2.0.0

package/server/plugins/actions/jenkins-build.ts

@@ -0,0 +1,209 @@
+/**
+ * jenkins_build — 触发 Jenkins Job 构建并等待结果
+ *
+ * 凭据读取自「系统设置 → Jenkins」；CSRF crumb 自动获取（未启用 CSRF 时跳过）。
+ *
+ * 参数（task.actionParams）:
+ *   jobName   Job 名称，支持 "文件夹/Job名"
+ *   params    构建参数（可选）：JSON 对象，或每行一条 key=value
+ *   timeoutMs 等待构建完成的最长时间（可选，默认 10 分钟）
+ */
+import type { ActionExecutor } from '../registry.ts'
+
+const DEFAULT_TIMEOUT_MS = 600_000
+const POLL_INTERVAL_MS = 3_000
+
+interface JenkinsSettings {
+  url: string
+  username: string
+  password: string
+}
+
+function normalizeBase(raw: string): string {
+  return String(raw ?? '').trim().replace(/\/+$/, '')
+}
+
+function basicAuth(user: string, pass: string): string {
+  return 'Basic ' + Buffer.from(`${user}:${pass}`, 'utf-8').toString('base64')
+}
+
+/** "folder/my job" → "job/folder/job/my%20job" */
+function jobPath(job: string): string {
+  const segs = String(job ?? '')
+    .split('/')
+    .map((s) => encodeURIComponent(s.trim()))
+    .filter(Boolean)
+  return segs.map((s) => `job/${s}`).join('/')
+}
+
+/** 构建参数：JSON 对象 / 每行 key=value / 空 */
+function parseParams(raw: unknown): Record<string, string> {
+  if (!raw) return {}
+  if (typeof raw === 'object' && !Array.isArray(raw)) {
+    const out: Record<string, string> = {}
+    for (const [k, v] of Object.entries(raw as Record<string, unknown>)) {
+      out[k] = typeof v === 'object' ? JSON.stringify(v) : String(v)
+    }
+    return out
+  }
+  const text = String(raw).trim()
+  if (!text) return {}
+  if (text.startsWith('{')) {
+    const obj = JSON.parse(text) as Record<string, unknown>
+    const out: Record<string, string> = {}
+    for (const [k, v] of Object.entries(obj)) {
+      out[k] = typeof v === 'object' ? JSON.stringify(v) : String(v)
+    }
+    return out
+  }
+  const out: Record<string, string> = {}
+  for (const line of text.split('\n')) {
+    const t = line.trim()
+    if (!t) continue
+    const i = t.indexOf('=')
+    if (i <= 0) throw new Error(`构建参数每行应为 key=value，收到：${t}`)
+    out[t.slice(0, i).trim()] = t.slice(i + 1).trim()
+  }
+  return out
+}
+
+/** 获取 CSRF crumb；未启用 CSRF 时返回空 */
+async function fetchCrumb(base: string, headers: Record<string, string>): Promise<Record<string, string>> {
+  try {
+    const r = await fetch(`${base}/crumbIssuer/api/json`, { headers })
+    if (!r.ok) return {}
+    const j = (await r.json()) as { crumbRequestField?: string; crumb?: string }
+    if (j.crumbRequestField && j.crumb) return { [j.crumbRequestField]: j.crumb }
+    return {}
+  } catch {
+    return {}
+  }
+}
+
+function sleep(ms: number): Promise<void> {
+  return new Promise((r) => setTimeout(r, ms))
+}
+
+/** 轮询直到返回非 null 或超时（返回 null 表示超时） */
+async function pollUntil<T>(
+  fn: () => Promise<T | null>,
+  timeoutMs: number
+): Promise<T | null> {
+  const start = Date.now()
+  for (;;) {
+    const v = await fn()
+    if (v !== null && v !== undefined) return v
+    if (Date.now() - start >= timeoutMs) return null
+    await sleep(POLL_INTERVAL_MS)
+  }
+}
+
+export const jenkinsBuildAction: ActionExecutor = async (task, ctx) => {
+  const p = task.config.actionParams ?? {}
+  const job = String(p['jobName'] ?? '').trim()
+  if (!job) return { success: false, error: '未填写 Jenkins Job 名称' }
+
+  const j = (ctx.config.get().jenkins ?? {}) as Partial<JenkinsSettings>
+  const base = normalizeBase(j.url ?? '')
+  if (!base) {
+    return { success: false, error: '未配置 Jenkins 地址，请先到「系统设置 → Jenkins」填写 URL 与账号' }
+  }
+
+  let params: Record<string, string>
+  try {
+    params = parseParams(p['params'])
+  } catch (err) {
+    return { success: false, error: `构建参数解析失败: ${(err as Error).message}` }
+  }
+
+  const parsedTimeout = Number(p['timeoutMs'])
+  const timeoutMs = Number.isFinite(parsedTimeout) && parsedTimeout > 0 ? parsedTimeout : DEFAULT_TIMEOUT_MS
+
+  const headers: Record<string, string> = { Authorization: basicAuth(j.username ?? '', j.password ?? '') }
+  Object.assign(headers, await fetchCrumb(base, headers))
+
+  const hasParams = Object.keys(params).length > 0
+  const endpoint = hasParams ? 'buildWithParameters' : 'build'
+  const qs = hasParams ? `?${new URLSearchParams(params).toString()}` : ''
+  const triggerUrl = `${base}/${jobPath(job)}/${endpoint}${qs}`
+
+  ctx.log(`触发 Jenkins 构建：${job}`)
+  let res: Response
+  try {
+    res = await fetch(triggerUrl, { method: 'POST', headers })
+  } catch (err) {
+    return { success: false, error: `请求 Jenkins 失败: ${(err as Error).message}（请检查地址与网络）` }
+  }
+
+  if (res.status === 401 || res.status === 403) {
+    return {
+      success: false,
+      error: `Jenkins 认证失败（HTTP ${res.status}），请检查用户名与密码/API Token`
+    }
+  }
+  if (!res.ok && res.status !== 201) {
+    const detail = (await res.text().catch(() => '')).slice(0, 200)
+    return { success: false, error: `触发构建失败：HTTP ${res.status} ${detail}` }
+  }
+
+  const location = res.headers.get('location') ?? ''
+  if (!location) {
+    return { success: false, error: 'Jenkins 未返回队列地址（响应缺少 Location 头）' }
+  }
+
+  // 1) 等排队任务落到具体构建号
+  const queueUrl = location.endsWith('/') ? `${location}api/json` : `${location}/api/json`
+  const buildNumber = await pollUntil(async () => {
+    try {
+      const r = await fetch(queueUrl, { headers })
+      if (!r.ok) return null
+      const q = (await r.json()) as { executable?: { number?: number } }
+      return q.executable?.number ?? null
+    } catch {
+      return null
+    }
+  }, Math.min(timeoutMs, 120_000))
+
+  if (buildNumber == null) {
+    return { success: false, error: '等待 Jenkins 开始构建超时（任务可能一直在排队）' }
+  }
+
+  // 2) 等构建结束拿到结果
+  const buildApi = `${base}/${jobPath(job)}/${buildNumber}/api/json`
+  const consoleUrl = `${base}/${jobPath(job)}/${buildNumber}/console`
+  const result = await pollUntil(async () => {
+    try {
+      const r = await fetch(buildApi, { headers })
+      if (!r.ok) return null
+      const b = (await r.json()) as { building?: boolean; result?: string | null }
+      if (b.building) return null
+      return b.result ?? null
+    } catch {
+      return null
+    }
+  }, timeoutMs)
+
+  if (result == null) {
+    return {
+      success: false,
+      error: `等待构建结果超时（>${Math.round(timeoutMs / 1000)}s）`,
+      stdout: `Job: ${job}\n构建号: #${buildNumber}\n控制台: ${consoleUrl}`
+    }
+  }
+
+  const ok = result === 'SUCCESS'
+  const summary = [
+    `Job: ${job}`,
+    `构建号: #${buildNumber}`,
+    `结果: ${result}`,
+    `控制台: ${consoleUrl}`
+  ].join('\n')
+
+  ctx.log(`构建 #${buildNumber} 结果 ${result}`)
+  return {
+    success: ok,
+    exitCode: ok ? 0 : 1,
+    stdout: summary,
+    error: ok ? undefined : `Jenkins 构建结果：${result}（#${buildNumber}）`
+  }
+}

package/server/plugins/actions/open-app.ts

@@ -0,0 +1,40 @@
+/**
+ * open_app 动作 — 打开本地程序 / 文件 / 文件夹 / URL
+ * action_params:
+ *   - url: 打开 URL（系统默认浏览器）
+ *   - target: 文件/文件夹路径（系统默认程序）
+ *   - app: 应用名或可执行文件路径
+ */
+import { openApp, openPath, openUrl } from '../../utils/open.ts'
+import type { ActionExecutor } from '../registry.ts'
+
+export const openAppAction: ActionExecutor = async (task, ctx) => {
+  const p = task.config.actionParams
+  const url = p.url as string | undefined
+  const target = p.target as string | undefined
+  const app = p.app as string | undefined
+
+  try {
+    if (url) {
+      const err = await openUrl(String(url))
+      if (err) return { success: false, error: `打开失败: ${err}` }
+      ctx.log(`已打开 URL: ${url}`)
+      return { success: true }
+    }
+    if (target) {
+      const err = await openPath(String(target))
+      if (err) return { success: false, error: `打开失败: ${err}` }
+      ctx.log(`已打开: ${target}`)
+      return { success: true }
+    }
+    if (app) {
+      const err = await openApp(String(app))
+      if (err) return { success: false, error: `打开失败: ${err}` }
+      ctx.log(`已打开应用: ${app}`)
+      return { success: true }
+    }
+    return { success: false, error: '未指定 url/target/app 任一参数' }
+  } catch (err) {
+    return { success: false, error: `打开失败: ${String(err)}` }
+  }
+}

package/server/plugins/actions/python-script.ts

@@ -0,0 +1,187 @@
+/**
+ * python_script 动作 — 执行 Python 脚本
+ *
+ * 1) 脚本来源：优先「任务内导入」的脚本（actionParams.scriptContent，运行时写入临时文件）；
+ *    兼容旧任务：无导入内容时回退 config.scriptPath 指向的本地脚本。
+ * 2) 配置注入：把「系统设置」里的 Jenkins / Linux 服务器配置写入临时 JSON，
+ *    并通过环境变量传给脚本，脚本无需再硬编码地址与密码：
+ *      DESKPET_CONFIG       注入配置文件的绝对路径（JSON）
+ *      DESKPET_LOG_DIR      脚本日志目录（~/.deskpet/logs）
+ *      DESKPET_JENKINS_URL / _USER / _PASS
+ *      DESKPET_SERVER_HOST / _PORT / _USER / _PASS / _NAME（任务选了服务器时才有）
+ *      DESKPET_TASK_ID / DESKPET_TASK_NAME / DESKPET_PARAMS（actionParams JSON）
+ *    执行结束（含失败）会清理所有临时文件。
+ */
+import { mkdirSync, rmSync, writeFileSync } from 'node:fs'
+import { tmpdir } from 'node:os'
+import { join } from 'node:path'
+import type { LinuxServer } from '../../../shared/types.ts'
+import { getDataRoot } from '../../utils/paths.ts'
+import { resolvePythonInterpreter } from '../../utils/python-interpreter.ts'
+import type { ActionExecutor } from '../registry.ts'
+
+const TEMP_DIR_NAME = 'deskpet-scripts'
+
+export const pythonScriptAction: ActionExecutor = async (task, ctx) => {
+  const c = task.config
+  const params = c.actionParams ?? {}
+  const scriptContent = typeof params['scriptContent'] === 'string' ? params['scriptContent'] : ''
+  const scriptName =
+    typeof params['scriptName'] === 'string' && params['scriptName'] ? params['scriptName'] : 'script.py'
+
+  const settings = ctx.config.get()
+  const servers = (settings.servers ?? []) as LinuxServer[]
+  const selected =
+    servers.find((s) => s.id === String(params['serverId'] ?? '')) ?? null
+
+  const dir = join(tmpdir(), TEMP_DIR_NAME)
+  const tempFiles: string[] = []
+  const stamp = Date.now()
+
+  try {
+    mkdirSync(dir, { recursive: true })
+  } catch (err) {
+    return { success: false, error: `创建临时目录失败: ${String(err)}` }
+  }
+
+  // ── 注入配置（Jenkins / 服务器），供脚本读取 ─────────────
+  let configPath = ''
+  try {
+    const injected = {
+      jenkins: settings.jenkins ?? { url: '', username: '', password: '' },
+      servers,
+      server: selected,
+      task: { id: task.id, name: c.name, args: c.scriptArgs ?? [] },
+      params
+    }
+    configPath = join(dir, `${task.id}-${stamp}.config.json`)
+    writeFileSync(configPath, JSON.stringify(injected, null, 2), 'utf-8')
+    tempFiles.push(configPath)
+  } catch (err) {
+    return { success: false, error: `写入注入配置失败: ${String(err)}` }
+  }
+
+  // ── 脚本来源 ────────────────────────────────────────────
+  let scriptPath = c.scriptPath || String(params['script_path'] ?? '')
+  if (scriptContent.trim()) {
+    try {
+      const p = join(dir, `${task.id}-${stamp}.py`)
+      writeFileSync(p, scriptContent, 'utf-8')
+      scriptPath = p
+      tempFiles.push(p)
+    } catch (err) {
+      cleanup(tempFiles)
+      return { success: false, error: `写入临时脚本失败: ${String(err)}` }
+    }
+  }
+
+  if (!scriptPath) {
+    cleanup(tempFiles)
+    return { success: false, error: '任务未导入 Python 脚本，请编辑任务上传 .py 文件' }
+  }
+
+  // 脚本日志目录（持久化，便于排查）
+  const logDir = join(getDataRoot(), 'logs')
+  try {
+    mkdirSync(logDir, { recursive: true })
+  } catch {
+    /* 建目录失败时交给脚本自行回退 */
+  }
+
+  const env: Record<string, string> = {
+    // Windows 下 Python 默认用 GBK 输出，会导致中文日志乱码 → 强制 UTF-8
+    PYTHONIOENCODING: 'utf-8',
+    PYTHONUTF8: '1',
+    // 关键：关闭 Python 的输出缓冲。否则 stdout 为管道时是「块缓冲」，
+    // print() 的内容要等缓冲区满或进程结束才会到达父进程 —— 管理台就看不到实时日志。
+    // 等价于 python -u；配合 script-runner 的 onOutput 即可边跑边看。
+    PYTHONUNBUFFERED: '1',
+    DESKPET_CONFIG: configPath,
+    DESKPET_LOG_DIR: logDir,
+    DESKPET_JENKINS_URL: settings.jenkins?.url ?? '',
+    DESKPET_JENKINS_USER: settings.jenkins?.username ?? '',
+    DESKPET_JENKINS_PASS: settings.jenkins?.password ?? '',
+    DESKPET_TASK_ID: task.id,
+    DESKPET_TASK_NAME: c.name ?? '',
+    DESKPET_PARAMS: JSON.stringify(params)
+  }
+  if (selected) {
+    env['DESKPET_SERVER_NAME'] = selected.name ?? ''
+    env['DESKPET_SERVER_HOST'] = selected.host ?? ''
+    env['DESKPET_SERVER_PORT'] = String(selected.port ?? 22)
+    env['DESKPET_SERVER_USER'] = selected.username ?? ''
+    env['DESKPET_SERVER_PASS'] = selected.password ?? ''
+  }
+
+  ctx.log(`开始执行脚本: ${scriptName}`)
+
+  // ── 解释器解析 ──────────────────────────────────────────
+  // Windows 上 `python3` 往往是 Microsoft Store 的别名存根，非交互执行直接返回 9009，
+  // 这里统一解析成真实可执行文件的绝对路径（跳过存根），避免「exit_code=9009、无任何输出」。
+  const resolution = resolvePythonInterpreter(c.interpreter)
+  if (!resolution.ok) {
+    cleanup(tempFiles)
+    return { success: false, error: resolution.error }
+  }
+  ctx.log(`解释器: ${resolution.interpreter.command}`)
+
+  try {
+    const handle = ctx.scriptRunner.start({
+      scriptPath,
+      interpreter: resolution.interpreter.command,
+      args: c.scriptArgs,
+      timeout: c.scriptTimeout,
+      workDir: c.scriptWorkDir,
+      env,
+      // 实时把子进程输出推给管理台（调度器注入的回调）
+      onOutput: (stream, text) => ctx.onOutput?.(stream, text)
+    })
+    // 注册句柄供任务停止
+    try {
+      ctx.trackRunningScript?.(task.id, handle)
+    } catch {
+      /* 调度器未注入时忽略 */
+    }
+    // 登记子进程 pid：服务中途被强杀时，靠它判断脚本是否还在后台跑
+    if (handle.pid) {
+      try {
+        ctx.onChildPid?.(handle.pid)
+      } catch {
+        /* 调度器未注入时忽略 */
+      }
+    }
+    const result = await handle.result
+    try {
+      ctx.trackRunningScript?.(task.id, null)
+    } catch {
+      /* ignore */
+    }
+    if (result.timedOut) {
+      ctx.log(`执行超时 (${c.scriptTimeout}s)`)
+    } else if (result.success) {
+      ctx.log(`执行成功, 退出码 ${result.exitCode}, 耗时 ${(result.elapsedMs / 1000).toFixed(1)}s`)
+    } else {
+      ctx.log(`执行失败: ${result.errorMessage}`)
+    }
+    return {
+      success: result.success,
+      exitCode: result.exitCode,
+      stdout: result.stdout,
+      stderr: result.stderr,
+      error: result.errorMessage || undefined,
+      timedOut: result.timedOut
+    }
+  } finally {
+    cleanup(tempFiles)
+  }
+}
+
+function cleanup(files: string[]): void {
+  for (const f of files) {
+    try {
+      rmSync(f, { force: true })
+    } catch {
+      /* 清理失败可忽略 */
+    }
+  }
+}

package/server/plugins/actions/screenshot.ts

@@ -0,0 +1,41 @@
+/**
+ * 截图动作 — macOS screencapture（全屏截图保存到指定目录）
+ */
+import { execFile } from 'node:child_process'
+import { mkdirSync } from 'node:fs'
+import { homedir } from 'node:os'
+import { join } from 'node:path'
+import type { ActionResult, TaskRecord } from '../../../shared/types.ts'
+import type { ActionExecutor } from '../registry.ts'
+
+export const screenshotAction: ActionExecutor = async (task: TaskRecord) => {
+  const p = task.config.actionParams ?? {}
+  if (process.platform !== 'darwin') {
+    return { success: false, error: `截图动作暂不支持 ${process.platform}` }
+  }
+
+  // 目标路径：参数指定目录或默认 ~/Downloads
+  const dir = (typeof p['dir'] === 'string' && p['dir']) || join(homedir(), 'Downloads')
+  try {
+    mkdirSync(dir, { recursive: true })
+  } catch {
+    /* 已存在 */
+  }
+  const ts = new Date().toISOString().replace(/[:.]/g, '-').slice(0, 19)
+  const filePath =
+    (typeof p['file'] === 'string' && p['file']) || join(dir, `deskpet-screenshot-${ts}.png`)
+
+  return new Promise<ActionResult>((resolve) => {
+    // -x 不播放快门声；-m 只截主屏（可选）
+    const args = ['-x']
+    if (p['mainDisplayOnly'] === true) args.push('-m')
+    args.push(filePath)
+    execFile('screencapture', args, { timeout: 15_000 }, (err) => {
+      if (err) {
+        resolve({ success: false, error: String(err) })
+      } else {
+        resolve({ success: true, stdout: filePath })
+      }
+    })
+  })
+}

package/server/plugins/actions/send-keystroke.ts

@@ -0,0 +1,103 @@
+/**
+ * 按键序列动作 — macOS osascript System Events（模拟快捷键）
+ *
+ * 参数: keys: "cmd+shift+4" / "ctrl+c" / "return" / "cmd+alt+esc"
+ */
+import { execFile } from 'node:child_process'
+import type { ActionResult, TaskRecord } from '../../../shared/types.ts'
+import type { ActionExecutor } from '../registry.ts'
+
+const MODIFIER_MAP: Record<string, string> = {
+  cmd: 'command down',
+  command: 'command down',
+  ctrl: 'control down',
+  control: 'control down',
+  alt: 'option down',
+  option: 'option down',
+  shift: 'shift down',
+  fn: 'fn down'
+}
+
+/** 组合键 → osascript keystroke 脚本；非法返回 null */
+export function buildKeystrokeScript(combo: string): string | null {
+  const parts = combo
+    .split(/[+-]/)
+    .map((s) => s.trim().toLowerCase())
+    .filter(Boolean)
+  if (!parts.length) return null
+
+  const modifiers: string[] = []
+  let key = ''
+  for (const part of parts) {
+    if (MODIFIER_MAP[part]) {
+      modifiers.push(MODIFIER_MAP[part])
+    } else {
+      key = part
+    }
+  }
+  if (!key) return null
+
+  // 特殊键映射
+  const special: Record<string, string> = {
+    return: 'return',
+    enter: 'return',
+    tab: 'tab',
+    space: 'space',
+    delete: 'delete',
+    escape: 'escape',
+    esc: 'escape',
+    up: 'up arrow',
+    down: 'down arrow',
+    left: 'left arrow',
+    right: 'right arrow',
+    home: 'home',
+    end: 'end',
+    pageup: 'page up',
+    pagedown: 'page down'
+  }
+
+  if (special[key]) {
+    const using = modifiers.length ? ` using {${modifiers.join(', ')}}` : ''
+    return `tell application "System Events" to key code ${KEY_CODES[special[key]] ?? `"${special[key]}"`}${using}`
+  }
+  if (key.length !== 1) return null
+  const using = modifiers.length ? ` using {${modifiers.join(', ')}}` : ''
+  return `tell application "System Events" to keystroke "${key}"${using}`
+}
+
+// System Events 特殊键的 key code（部分键只能用 key code 表达）
+const KEY_CODES: Record<string, number> = {
+  return: 36,
+  tab: 48,
+  space: 49,
+  delete: 51,
+  escape: 53,
+  home: 115,
+  end: 119,
+  pageup: 116,
+  'page down': 121,
+  'up arrow': 126,
+  'down arrow': 125,
+  'left arrow': 123,
+  'right arrow': 124
+}
+
+export const sendKeystrokeAction: ActionExecutor = async (task: TaskRecord): Promise<ActionResult> => {
+  if (process.platform !== 'darwin') {
+    return { success: false, error: `按键模拟暂不支持 ${process.platform}` }
+  }
+  const combo = String(task.config.actionParams?.['keys'] ?? '').trim()
+  if (!combo) {
+    return { success: false, error: '未指定按键序列（actionParams.keys，如 cmd+q）' }
+  }
+  const script = buildKeystrokeScript(combo)
+  if (!script) {
+    return { success: false, error: `无法解析按键组合: ${combo}` }
+  }
+  return new Promise<ActionResult>((resolve) => {
+    execFile('osascript', ['-e', script], { timeout: 10_000 }, (err, stdout) => {
+      if (err) resolve({ success: false, error: String(err) })
+      else resolve({ success: true, stdout: `已发送按键: ${combo}\n${stdout.trim()}` })
+    })
+  })
+}

package/server/plugins/actions/show-reminder.ts

@@ -0,0 +1,16 @@
+/**
+ * show_reminder 动作 — 任务提醒
+ *
+ * 旧版支持「全屏闪烁 / 气泡」两种桌面级提醒，依赖桌面宠物窗口；
+ * 该窗口已移除，故这里只发送提醒文本（管理台通知 + 系统原生通知）。
+ * 历史任务 actionParams 里的 mode / flash / color 会被忽略（无害残留）。
+ */
+import type { ActionExecutor } from '../registry.ts'
+
+export const showReminderAction: ActionExecutor = async (task, ctx) => {
+  const p = task.config.actionParams
+  const text = String(p.text ?? task.config.name ?? '提醒')
+  ctx.notifier.showReminder({ text })
+  ctx.log(`提醒触发: ${text}`)
+  return { success: true }
+}