@wanghaopeng1148/deskpet 2.0.0

package/shared/py-task-params.ts

@@ -0,0 +1,356 @@
+/**
+ * 解析 Python 脚本中的 TASK_PARAMS 常量 → 任务表单动态参数控件
+ *
+ * 对齐旧版 pet/src/ui/task_panel.py 的 `_parse_task_params`：
+ *   - 只做**字面量解析**（不执行脚本），仅支持 dict / list / str / number / bool / None
+ *   - 找不到 TASK_PARAMS 或解析失败 → 返回 null（表单回退到自由文本参数）
+ *
+ * 脚本内声明示例：
+ *   TASK_PARAMS = [
+ *     {"name": "--env", "label": "环境", "type": "select",
+ *      "options": [{"value": "uat", "label": "UAT"}]},
+ *     {"name": "--services", "label": "服务", "type": "multiselect",
+ *      "options": [{"value": "biz", "label": "biz"}]},
+ *     {"name": "--view", "label": "视图", "type": "text", "placeholder": "如 Y26M11"},
+ *   ]
+ */
+
+export interface TaskParamOption {
+  value: string
+  label?: string
+}
+
+export type TaskParamType = 'text' | 'select' | 'multiselect'
+
+export interface TaskParamDef {
+  /** 命令行参数名，如 "--env" */
+  name: string
+  label?: string
+  type?: TaskParamType
+  required?: boolean
+  placeholder?: string
+  help?: string
+  options?: TaskParamOption[]
+}
+
+export interface ParamArgState {
+  values: Record<string, string | string[]>
+  /** 不属于任何已声明参数的原有参数（原样保留） */
+  extra: string[]
+}
+
+/** 截取 `TASK_PARAMS = <字面量>` 的字面量源码（到配对括号结束） */
+function extractTaskParamsSource(source: string): string | null {
+  const m = /(^|\n)[ \t]*TASK_PARAMS\s*=\s*/.exec(source)
+  if (!m) return null
+  const start = m.index + m[0].length
+  const end = scanBalanced(source, start)
+  return end === null ? null : source.slice(start, end)
+}
+
+/** 从 start 处的 `[` / `{` 起，返回配对括号的结束位置（不含） */
+function scanBalanced(s: string, start: number): number | null {
+  let i = start
+  while (i < s.length && /\s/.test(s[i])) i++
+  const open = s[i]
+  if (open !== '[' && open !== '{') return null
+
+  const stack: string[] = []
+  let inStr: string | null = null
+  for (; i < s.length; i++) {
+    const ch = s[i]
+    if (inStr) {
+      if (ch === '\\') {
+        i++
+        continue
+      }
+      if (ch === inStr) inStr = null
+      continue
+    }
+    if (ch === '#') {
+      while (i < s.length && s[i] !== '\n') i++
+      continue
+    }
+    if (ch === '"' || ch === "'") {
+      inStr = ch
+      continue
+    }
+    if (ch === '[' || ch === '{') stack.push(ch)
+    else if (ch === ']' || ch === '}') {
+      stack.pop()
+      if (stack.length === 0) return i + 1
+    }
+  }
+  return null
+}
+
+/** Python 字面量递归下降解析器（受限子集） */
+class PyLiteralParser {
+  private i = 0
+  private readonly src: string
+
+  constructor(src: string) {
+    this.src = src
+  }
+
+  parse(): unknown {
+    const v = this.value()
+    this.skipWs()
+    if (this.i < this.src.length) {
+      throw new Error(`存在多余内容: ${this.src.slice(this.i, this.i + 20)}`)
+    }
+    return v
+  }
+
+  private skipWs(): void {
+    for (;;) {
+      while (this.i < this.src.length && /\s/.test(this.src[this.i])) this.i++
+      if (this.src[this.i] === '#') {
+        while (this.i < this.src.length && this.src[this.i] !== '\n') this.i++
+        continue
+      }
+      break
+    }
+  }
+
+  private value(): unknown {
+    this.skipWs()
+    const ch = this.src[this.i]
+    if (ch === '[') return this.list()
+    if (ch === '{') return this.dict()
+    if (ch === '"' || ch === "'") return this.string()
+    if (ch && /[A-Za-z_]/.test(ch)) {
+      const word = this.ident()
+      // 字符串前缀 r'' / b'' / u'' / f''（f-string 不支持）
+      const nxt = this.src[this.i]
+      if (nxt === '"' || nxt === "'") {
+        if (word === 'f' || word === 'F') throw new Error('不支持 f-string')
+        return this.string()
+      }
+      if (word === 'True') return true
+      if (word === 'False') return false
+      if (word === 'None') return null
+      throw new Error(`不支持的标识符: ${word}`)
+    }
+    return this.number()
+  }
+
+  private list(): unknown[] {
+    const out: unknown[] = []
+    this.i++
+    this.skipWs()
+    if (this.src[this.i] === ']') {
+      this.i++
+      return out
+    }
+    for (;;) {
+      out.push(this.value())
+      this.skipWs()
+      const ch = this.src[this.i]
+      if (ch === ',') {
+        this.i++
+        this.skipWs()
+        if (this.src[this.i] === ']') {
+          this.i++
+          break
+        }
+        continue
+      }
+      if (ch === ']') {
+        this.i++
+        break
+      }
+      throw new Error('列表格式错误')
+    }
+    return out
+  }
+
+  private dict(): Record<string, unknown> {
+    const out: Record<string, unknown> = {}
+    this.i++
+    this.skipWs()
+    if (this.src[this.i] === '}') {
+      this.i++
+      return out
+    }
+    for (;;) {
+      this.skipWs()
+      const key = this.value()
+      this.skipWs()
+      if (this.src[this.i] !== ':') throw new Error('字典缺少冒号')
+      this.i++
+      out[String(key)] = this.value()
+      this.skipWs()
+      const ch = this.src[this.i]
+      if (ch === ',') {
+        this.i++
+        this.skipWs()
+        if (this.src[this.i] === '}') {
+          this.i++
+          break
+        }
+        continue
+      }
+      if (ch === '}') {
+        this.i++
+        break
+      }
+      throw new Error('字典格式错误')
+    }
+    return out
+  }
+
+  private string(): string {
+    const quote = this.src[this.i]
+    this.i++
+    let out = ''
+    while (this.i < this.src.length) {
+      const ch = this.src[this.i]
+      if (ch === '\\') {
+        const next = this.src[this.i + 1]
+        this.i += 2
+        switch (next) {
+          case 'n':
+            out += '\n'
+            break
+          case 't':
+            out += '\t'
+            break
+          case 'r':
+            out += '\r'
+            break
+          case '\\':
+            out += '\\'
+            break
+          case "'":
+            out += "'"
+            break
+          case '"':
+            out += '"'
+            break
+          case 'u': {
+            const hex = this.src.slice(this.i, this.i + 4)
+            if (/^[0-9a-fA-F]{4}$/.test(hex)) {
+              out += String.fromCharCode(parseInt(hex, 16))
+              this.i += 4
+            }
+            break
+          }
+          default:
+            out += next ?? ''
+        }
+        continue
+      }
+      if (ch === quote) {
+        this.i++
+        return out
+      }
+      out += ch
+      this.i++
+    }
+    throw new Error('字符串未闭合')
+  }
+
+  private ident(): string {
+    const m = /^[A-Za-z_][A-Za-z0-9_]*/.exec(this.src.slice(this.i))
+    if (!m) throw new Error('标识符格式错误')
+    this.i += m[0].length
+    return m[0]
+  }
+
+  private number(): number {
+    const m = /^[+-]?(\d+\.?\d*|\.\d+)([eE][+-]?\d+)?/.exec(this.src.slice(this.i))
+    if (!m || !m[0]) throw new Error(`无法解析的值: ${this.src.slice(this.i, this.i + 12)}`)
+    this.i += m[0].length
+    return Number(m[0])
+  }
+}
+
+/** 解析脚本源码中的 TASK_PARAMS；无该常量或解析失败返回 null */
+export function parseTaskParams(source: string): TaskParamDef[] | null {
+  if (!source) return null
+  try {
+    const literal = extractTaskParamsSource(source)
+    if (!literal) return null
+    const parsed = new PyLiteralParser(literal).parse()
+    if (!Array.isArray(parsed)) return null
+
+    const out: TaskParamDef[] = []
+    for (const raw of parsed) {
+      if (!raw || typeof raw !== 'object' || Array.isArray(raw)) continue
+      const r = raw as Record<string, unknown>
+      const name = String(r['name'] ?? '').trim()
+      if (!name) continue
+
+      const rawType = String(r['type'] ?? 'text')
+      const type: TaskParamType =
+        rawType === 'select' || rawType === 'multiselect' ? rawType : 'text'
+
+      const options = Array.isArray(r['options'])
+        ? (r['options'] as unknown[])
+            .map((o) => {
+              const oo = (o ?? {}) as Record<string, unknown>
+              return {
+                value: String(oo['value'] ?? ''),
+                label: oo['label'] != null ? String(oo['label']) : undefined
+              }
+            })
+            .filter((o) => o.value !== '')
+        : undefined
+
+      out.push({
+        name,
+        label: r['label'] != null ? String(r['label']) : undefined,
+        type,
+        required: r['required'] === true,
+        placeholder: r['placeholder'] != null ? String(r['placeholder']) : undefined,
+        help: r['help'] != null ? String(r['help']) : undefined,
+        options
+      })
+    }
+    return out.length ? out : null
+  } catch {
+    return null
+  }
+}
+
+/** 从已有脚本参数回填动态表单（对齐旧版 _restore_params_from_args） */
+export function restoreParamState(params: TaskParamDef[], args: string[]): ParamArgState {
+  const values: Record<string, string | string[]> = {}
+  const consumed = new Set<number>()
+
+  for (const p of params) {
+    const idx = args.indexOf(p.name)
+    if (idx === -1 || idx + 1 >= args.length) continue
+    const next = args[idx + 1]
+    if (next.startsWith('--')) continue
+    consumed.add(idx)
+    consumed.add(idx + 1)
+    values[p.name] =
+      p.type === 'multiselect' ? next.split(',').map((s) => s.trim()).filter(Boolean) : next
+  }
+
+  const extra = args.filter((_, i) => !consumed.has(i))
+  return { values, extra }
+}
+
+/** 由动态表单值生成脚本参数（对齐旧版 _collect_params_as_args） */
+export function buildArgsFromParams(
+  params: TaskParamDef[],
+  values: Record<string, string | string[]>,
+  extra: string[] = []
+): string[] {
+  const args: string[] = []
+  for (const p of params) {
+    const v = values[p.name]
+    if (p.type === 'multiselect') {
+      const arr = Array.isArray(v) ? v : []
+      if (arr.length) args.push(p.name, arr.join(','))
+    } else {
+      const s = typeof v === 'string' ? v.trim() : ''
+      if (s) args.push(p.name, s)
+    }
+  }
+  args.push(...extra)
+  return args
+}

package/shared/types.ts

@@ -0,0 +1,309 @@
+/**
+ * 共享类型定义 — 主进程 / 渲染进程 / 预加载共用
+ */
+
+/**
+ * 宠物状态（值越大优先级越高，与旧版 Python 一致）
+ * 使用 const 对象 + 联合类型（兼容 Node 原生 TS strip-only 模式）
+ */
+export const PetState = {
+  SLEEP: 0,
+  IDLE: 1,
+  HOVER: 2,
+  BUSY: 3,
+  CLICK: 4
+} as const
+
+export type PetState = (typeof PetState)[keyof typeof PetState]
+
+export type PetStateName = 'sleep' | 'idle' | 'hover' | 'click' | 'busy'
+
+export const PET_STATE_NAMES: readonly PetStateName[] = [
+  'sleep',
+  'idle',
+  'hover',
+  'click',
+  'busy'
+] as const
+
+export function petStateName(state: PetState): PetStateName {
+  switch (state) {
+    case PetState.SLEEP:
+      return 'sleep'
+    case PetState.IDLE:
+      return 'idle'
+    case PetState.HOVER:
+      return 'hover'
+    case PetState.BUSY:
+      return 'busy'
+    case PetState.CLICK:
+      return 'click'
+    default:
+      return 'idle'
+  }
+}
+
+/** 点击互动动画类型（轮流触发） */
+export const ClickAnimationType = {
+  JUMP: 'jump',
+  SQUASH: 'squash',
+  SHAKE: 'shake'
+} as const
+
+export type ClickAnimationType = (typeof ClickAnimationType)[keyof typeof ClickAnimationType]
+
+/** 系统设置（与旧版 config/settings.json 字段对齐） */
+export interface Settings {
+  system: {
+    autoStart: boolean
+    powerMode: 'balanced' | 'low' | 'high'
+    idleSleepMinutes: number
+  }
+  audio: {
+    enabled: boolean
+    volume: number
+  }
+  /** 管理台 WebUI 服务 */
+  server: {
+    /** 127.0.0.1 仅本机；0.0.0.0 允许局域网访问 */
+    host: string
+    port: number
+  }
+  /** 任务可靠性 */
+  tasks: {
+    /** 连续失败熔断阈值（自动禁用任务），0=关闭 */
+    breakerThreshold: number
+  }
+  /** 微信 Bot（iLink Bot API） */
+  wechat: WechatSettings
+  /** 扫码枪（串口） */
+  scanner: ScannerSettings
+  /** Linux 服务器列表（SSH），任务可按 id 选择 */
+  servers: LinuxServer[]
+  /** Jenkins */
+  jenkins: JenkinsConfig
+}
+
+export interface WechatSettings {
+  notifyOnTaskComplete: boolean
+  notifyOnTaskFailed: boolean
+  notifyOnStartup: boolean
+  autoConnect: boolean
+  allowRemoteCommand: boolean
+}
+
+export interface ScannerSettings {
+  /** 启动时自动开启扫码枪 */
+  enabled: boolean
+  port: string
+  baud: number
+  /** 扫码后推送微信 */
+  notifyWechat: boolean
+  /** 扫码后桌面弹提醒 */
+  notifyDesktop: boolean
+}
+
+/** Linux 服务器（SSH）— 任务可择一执行 Shell 命令 */
+export interface LinuxServer {
+  id: string
+  /** 显示名，便于任务里选择时辨认 */
+  name: string
+  /** IP 或主机名 */
+  host: string
+  port: number
+  username: string
+  /** SSH 密码（明文保存在本机 settings.json；仅个人本机工具） */
+  password: string
+}
+
+/** Jenkins 配置 — 任务可触发指定 Job 构建 */
+export interface JenkinsConfig {
+  /** 例如 http://jenkins.example.com:8080 */
+  url: string
+  username: string
+  /** 密码或 API Token */
+  password: string
+}
+
+/** 快捷指令（M5 花瓣菜单用，先占位） */
+export interface QuickAction {
+  id: string
+  label: string
+  icon?: string
+  taskId?: string
+  color?: string
+}
+
+/**
+ * 任务提醒
+ * 桌面级提醒（全屏闪烁 / 气泡窗口）已随桌面宠物窗口一起移除，
+ * 因此这里只保留提醒文本；呈现由管理台通知 + 系统原生通知负责。
+ */
+export interface Reminder {
+  text: string
+}
+
+/** 系统通知 */
+export interface AppNotification {
+  title: string
+  body: string
+}
+
+// ── 任务系统 (M2) ─────────────────────────────────────────────
+
+export const TaskType = {
+  MANUAL: 'manual', // 手动
+  SCHEDULED: 'scheduled', // 定时
+  SCENE: 'scene' // 场景触发
+} as const
+export type TaskType = (typeof TaskType)[keyof typeof TaskType]
+
+export const TaskStatus = {
+  IDLE: 'idle',
+  PENDING: 'pending',
+  RUNNING: 'running',
+  COMPLETED: 'completed',
+  FAILED: 'failed',
+  CANCELLED: 'cancelled',
+  DISABLED: 'disabled'
+} as const
+export type TaskStatus = (typeof TaskStatus)[keyof typeof TaskStatus]
+
+export const ScheduleType = {
+  ONCE: 'once',
+  CRON: 'cron',
+  DELAY: 'delay',
+  INTERVAL: 'interval'
+} as const
+export type ScheduleType = (typeof ScheduleType)[keyof typeof ScheduleType]
+
+export const SceneTrigger = {
+  IDLE: 'idle',
+  STARTUP: 'startup',
+  NETWORK: 'network'
+} as const
+export type SceneTrigger = (typeof SceneTrigger)[keyof typeof SceneTrigger]
+
+/** 任务触发条件（字段与旧版 tasks.json 对齐） */
+export interface TaskTrigger {
+  /** once | cron | delay | interval | idle | startup | network */
+  type: string
+  /** "YYYY-MM-DD HH:MM" (once) */
+  datetime: string | null
+  /** cron 表达式（5 段） */
+  cron: string | null
+  /** 延时秒数 (delay) */
+  delaySeconds: number | null
+  /** 间隔分钟数 (interval) */
+  intervalMinutes: number | null
+  /** 闲置分钟数 (idle) */
+  idleMinutes: number | null
+  /** -1 无限循环 */
+  maxExecutions: number
+  /** 排除法定节假日（mac 暂不实现具体节假日表，默认 false） */
+  holidayCheck: boolean
+}
+
+/** 任务配置（与旧版 TaskConfig + tasks.json 字段对齐） */
+export interface TaskConfig {
+  name: string
+  type: TaskType
+  trigger: TaskTrigger
+
+  /** 动作标识: python_script / show_reminder / ssh_command / jenkins_build / ... */
+  action: string
+  actionParams: Record<string, unknown>
+
+  /** Python 脚本相关 */
+  scriptPath: string
+  interpreter: string | null
+  scriptArgs: string[]
+  scriptTimeout: number
+  scriptWorkDir: string | null
+
+  retryCount: number
+  enabled: boolean
+
+  /** 通知通道: ["desktop"] ["wechat"] ["desktop","wechat"] */
+  notifyChannels: string[]
+
+  /** 任务链: 完成后触发的下一个任务 id (M5) */
+  chainNext: string | null
+  /** 链触发条件: "exit==0" / "output contains xxx" (M5) */
+  chainCondition: string | null
+
+  /** 一次性任务（执行后自动删除） */
+  oneTime: boolean
+}
+
+/** 任务运行时记录（调度器内存态） */
+export interface TaskRecord {
+  id: string
+  config: TaskConfig
+  status: TaskStatus
+  createdAt: string
+  executionCount: number
+  lastRunAt: string | null
+  lastResult: string | null
+  lastError: string | null
+  nextRunAt: string | null
+  currentRetry: number
+}
+
+/** 任务 DTO（对外/API/UI 使用） */
+export type TaskDto = TaskRecord
+
+/** 执行历史记录（SQLite executions 表） */
+export interface ExecutionRecord {
+  id: number
+  taskId: string
+  taskName: string
+  status: string // running/completed/failed/timeout/cancelled
+  startedAt: string
+  finishedAt: string | null
+  exitCode: number | null
+  durationMs: number | null
+  /**
+   * 本次执行启动的子进程 pid（脚本类动作才有，其它动作为 null）。
+   *
+   * 存在的意义：进程被强杀（服务重启 / 崩溃）时走不到收尾逻辑，
+   * 而子进程在 Windows 上**不会**随父进程一起死。下次启动靠这个 pid 就能判断
+   * 「脚本是不是还在后台跑」，而不是一律判成「执行被中断」——
+   * 后者会让部署类脚本被误认为失败，甚至被重复触发。
+   */
+  pid?: number | null
+  stdout: string
+  stderr: string
+  error: string
+}
+
+/** 任务动作执行结果 */
+export interface ActionResult {
+  success: boolean
+  stdout?: string
+  stderr?: string
+  error?: string
+  /** 脚本超时标记（执行记录记为 timeout） */
+  timedOut?: boolean
+  /** 脚本退出码（python_script 动作提供） */
+  exitCode?: number | null
+}
+
+/** 脚本执行结果 */
+export interface ScriptResult {
+  success: boolean
+  exitCode: number | null
+  stdout: string
+  stderr: string
+  elapsedMs: number
+  timedOut: boolean
+  errorMessage: string
+}
+
+/** 执行状态变更事件 */
+export interface TaskStatusEvent {
+  taskId: string
+  taskName: string
+  status: TaskStatus
+  result?: string
+}