@wanghaopeng1148/deskpet 2.0.0 → 2.0.2

package/dist/node/server/services/wechat-commands.js

@@ -0,0 +1,330 @@
+/**
+ * 微信指令路由 — 把微信收到的文本翻译成本地操作（对齐旧版 wechat_commands.py）
+ *
+ * 8 类指令: 帮助 / 状态 / 任务列表 / 创建任务 / 执行 / 带参执行 / 参数 / 提醒
+ * 仅关键字匹配，不接任何大模型；未识别返回提示。
+ */
+import * as os from 'node:os';
+export const HELP_TEXT = [
+    '🐾 桌面宠物 · 微信指令',
+    '✅创建任务 <名称> <日期> <时间>',
+    '　　创建定时提醒任务',
+    '　　如: 创建任务 党会 2026-09-20 14:00',
+    '✅任务列表　查看全部任务',
+    '✅执行 <名称|序号> -- <参数...>',
+    '　　用自定义参数执行任务（临时覆盖，不改原配置）',
+    '✅带参执行 <名称|序号> -- <参数...>　同上（显式语义）',
+    '✅参数 <名称|序号>　查看任务运行参数',
+    '✅提醒 <内容>　在电脑上弹出全屏提醒',
+    '✅状态　查看桌宠与任务运行状态',
+    '✅帮助　显示本说明',
+    '任务执行完成后会自动推送结果到这里'
+].join('\n');
+const STATUS_ICON = {
+    running: '🔄',
+    completed: '✅',
+    failed: '❌',
+    disabled: '⏸',
+    idle: '⚪',
+    pending: '⏳',
+    cancelled: '🚫'
+};
+const TYPE_NAME = { manual: '手动', scheduled: '定时', scene: '场景' };
+function fmtTime(iso) {
+    if (!iso)
+        return '-';
+    const d = new Date(iso);
+    const p = (n) => String(n).padStart(2, '0');
+    return `${d.getFullYear()}-${p(d.getMonth() + 1)}-${p(d.getDate())} ${p(d.getHours())}:${p(d.getMinutes())}`;
+}
+export class WechatCommandRouter {
+    deps;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    /** 处理一条微信消息；返回回复文本，null 表示不回复 */
+    handle(text) {
+        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 '❓ 未识别的指令，发送「帮助」查看可用指令';
+    }
+    // ── 状态 ────────────────────────────────────────────────
+    status() {
+        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 ? '运行中' : '已停止'}`);
+    }
+    // ── 任务列表 ────────────────────────────────────────────
+    listTasks() {
+        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');
+    }
+    // ── 任务解析：序号/精确/模糊 ────────────────────────────
+    resolveTask(target) {
+        const records = this.deps.scheduler?.listTasks() ?? [];
+        if (!records.length)
+            return { record: null, error: '❌ 当前没有配置任何任务' };
+        if (!target) {
+            return {
+                record: null,
+                error: '用法：执行/参数 <任务名或序号>\n发送「任务列表」查看可用任务'
+            };
+        }
+        let record = 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 };
+    }
+    // ── 执行 / 带参执行 ─────────────────────────────────────
+    execute(target, forceArgs) {
+        const sched = this.deps.scheduler;
+        if (!sched)
+            return '❌ 任务调度器未接入，无法执行任务';
+        // 解析 "任务名 -- arg1 arg2"
+        let taskTarget = target;
+        let scriptArgs = [];
+        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;
+        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完成后会自动推送结果`;
+    }
+    // ── 查看参数 ────────────────────────────────────────────
+    showParams(target) {
+        const { record, error } = this.resolveTask(target);
+        if (!record)
+            return error;
+        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 = { 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');
+    }
+    // ── 提醒 ────────────────────────────────────────────────
+    remind(content) {
+        if (!content)
+            return '用法：提醒 <提醒内容>\n例如：提醒 该开会了';
+        try {
+            this.deps.reminder(content);
+        }
+        catch (err) {
+            return `❌ 提醒弹出失败：${String(err)}`;
+        }
+        return `✅ 已在电脑上弹出提醒：${content}`;
+    }
+    // ── 创建任务（定时提醒，oneTime） ───────────────────────
+    createTask(content) {
+        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/dist/node/server/suppress-warnings.js

@@ -0,0 +1,12 @@
+/**
+ * 进程级警告开关 —— 必须在 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.noProcessWarnings = true;
+export {};

package/dist/node/server/utils/asset-url.js

@@ -0,0 +1,26 @@
+/**
+ * 皮肤资源 URL — 取代原 deskpet:// 自定义协议
+ *
+ * 皮肤精灵图等本地文件通过 HTTP 接口 /api/assets?path=<绝对路径> 分发，
+ * 服务端做目录白名单校验，避免任意文件读取。
+ */
+import { existsSync } from 'node:fs';
+import { normalize, resolve, sep } from 'node:path';
+import { getResourcesRoot, getUserSkinsDir } from "./paths.js";
+export const ASSET_ENDPOINT = '/api/assets';
+/**
+ * 校验并解析 /api/assets 的 path 参数
+ * 仅允许访问用户皮肤目录与内置资源目录内的已存在文件，越界返回 null
+ */
+export function resolveAssetRequest(raw) {
+    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/dist/node/server/utils/auto-start.js

@@ -0,0 +1,186 @@
+/**
+ * 开机自启
+ *
+ * 各平台实现：
+ *   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 { existsSync, mkdirSync, unlinkSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { dirname, join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+const APP_ID = 'DeskPet';
+/** 应用根目录（源码运行为项目根，npm 包运行为包根） */
+function appRoot() {
+    return resolve(dirname(fileURLToPath(import.meta.url)), '..', '..');
+}
+/** 开机要执行的 node 可执行文件与入口脚本 */
+function launch() {
+    return { node: process.execPath, entry: join(appRoot(), 'bin', 'deskpet.mjs') };
+}
+// ── Windows ─────────────────────────────────────────────────
+function winStartupDir() {
+    const appData = process.env.APPDATA ?? join(homedir(), 'AppData', 'Roaming');
+    return join(appData, 'Microsoft', 'Windows', 'Start Menu', 'Programs', 'Startup');
+}
+function winCmdPath() {
+    return join(winStartupDir(), `${APP_ID}.cmd`);
+}
+function winLegacyLnkPath() {
+    return join(winStartupDir(), `${APP_ID}.lnk`);
+}
+/**
+ * 生成自启批处理。
+ *
+ * 注意两点：
+ *   · 换行必须是 CRLF，注释用英文 —— cmd 按系统 ANSI 代码页解析批处理，
+ *     写中文注释在中文 Windows 上容易乱码（虽然注释不影响执行，但很难看）
+ *   · 用 `start /min` 让服务窗口最小化，不打扰用户，同时任务栏里能看到它在跑
+ */
+function winCmdContent() {
+    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() {
+    return join(homedir(), 'Library', 'LaunchAgents', `${APP_ID}.plist`);
+}
+function macPlistContent() {
+    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>
+    <key>Label</key>
+    <string>${APP_ID}</string>
+    <key>ProgramArguments</key>
+    <array>
+      <string>${node}</string>
+      <string>${entry}</string>
+      <string>--no-open</string>
+    </array>
+    <key>WorkingDirectory</key>
+    <string>${appRoot()}</string>
+    <key>RunAtLoad</key>
+    <true/>
+  </dict>
+</plist>
+`;
+}
+// ── Linux (XDG autostart) ───────────────────────────────────
+function linuxDesktopPath() {
+    return join(homedir(), '.config', 'autostart', `${APP_ID}.desktop`);
+}
+function linuxDesktopContent() {
+    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) {
+    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;
+    }
+}
+/** 查询当前是否已设置自启 */
+export function autoStartEnabled() {
+    try {
+        if (process.platform === 'win32')
+            return existsSync(winCmdPath());
+        if (process.platform === 'darwin')
+            return existsSync(macPlistPath());
+        if (process.platform === 'linux')
+            return existsSync(linuxDesktopPath());
+    }
+    catch {
+        /* ignore */
+    }
+    return false;
+}

package/dist/node/server/utils/clipboard.js

@@ -0,0 +1,50 @@
+/**
+ * 剪贴板读写 — 取代 Electron clipboard 模块
+ * 通过系统命令实现，失败时静默返回空串（不阻塞任务链路）
+ */
+import { execFile } from 'node:child_process';
+function run(cmd, args, input) {
+    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() {
+    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() {
+    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/dist/node/server/utils/dashboard-url.js

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