minimal-agent 0.8.2 → 0.10.0

package/README.md

@@ -1,7 +1,7 @@
 # minimal-agent
 
 > 一个**最小化但功能完整**的 AI 编程助手 —— Bun + React + TypeScript + Ink TUI 构建，
-> OpenAI 兼容、多 provider，11 个内置工具 + Skills + 插件 + Workflow DSL + 自动上下文压缩。
+> OpenAI 兼容、多 provider，16 个内置工具 + Skills + 插件 + Workflow DSL + 自动上下文压缩。
 > 为**学习与教学**而生：代码量克制、注释充分，把一个 agent「从输入到工具循环到落盘」讲透。
 
 `v0.5.1` · Runtime: **Bun**（主）/ Node ≥ 20 · License: **PolyForm Noncommercial 1.0.0**
@@ -22,10 +22,10 @@
 
 ## 特性
 
-- **11 个内置工具**：Read / Write / Edit / MultiEdit / Glob / Grep / WebSearch / WebFetch / WebBrowser / Bash / AskUserQuestion（向用户提结构化选择题，动态工作流交互底座）
+- **16 个内置工具**：Read / Write / Edit / MultiEdit / Glob / Grep / WebSearch / WebFetch / WebBrowser / Download / GenerateImage / GenerateSpeech / Bash / AskUserQuestion（向用户提结构化选择题，动态工作流交互底座）/ Advisor（独立配置的第二个 LLM，关键节点取第二意见）/ Agent（并行子任务分身：explore 只读调研 / general 读写执行，可 git worktree 隔离）
 - **OpenAI 兼容**：Message 形状对齐 Chat Completions，一套代码接 MiniMax / 火山 ARK / DeepSeek / OpenAI / Moonshot…
 - **Skills 系统**：放一个 `SKILL.md` 就能扩展能力，运行时实时扫描注入 prompt，改文件即生效
-- **插件系统**：`plugins/<id>/` drop-in，自带 `/ralph-loop`（复制任务循环）与 `/workflow`（YAML DAG 执行器）
+- **插件系统**：`plugins/<id>/` drop-in，自带 `/workflow`（YAML 工作流引擎，支持 while 循环 + 验证门 + fresh_context）
 - **自动上下文压缩**：接近上限时把旧对话压成摘要，保留系统提示 + 摘要 + 最近几条
 - **多 session + 归档**：同一工作目录多个并行会话，`/new` 归档、`/restore` 恢复
 - **可编程子进程**：`-p --output-format json` 输出一行结构化结局契约，方便被宿主程序 spawn 调度
@@ -51,15 +51,15 @@ bun run start               # 启动 TUI
 
 ```bash
 npm install -g minimal-agent
-minimal-agent                # 首次运行进入配置向导
+minimal-agent                # 首次运行进入配置菜单（逐项配置，完成退出后进入对话）
 ```
 
 ## 配置
 
-两种方式任选其一（**环境变量优先级高于配置文件**）：
+两种方式任选其一（**配置文件优先于环境变量**——env 只在没有任何 `config.json` 时作兜底；`MINIMAL_AGENT_CONFIG_MODE=env` 可强制只用环境变量）：
 
 1. **`.env` 文件**（源码模式，Bun 自动加载）—— 复制 `.env.example` 改值。
-2. **配置向导** —— 首次运行 `minimal-agent`（TUI）会引导你填，写到 `~/.minimal-agent/config.json`。
+2. **配置菜单** —— 首次运行 `minimal-agent`（TUI）会弹出菜单（基座模型/搜索引擎/生图模型/顾问模型/语音合成/OpenRouter 逐项配置），写到 `~/.minimal-agent/config.json`；会话中可用 `/config` 随时再次打开。
 
 必需三项 + 可选项：
 
@@ -98,7 +98,7 @@ bun run start        # 或全局安装后直接 minimal-agent
 | `/show <id>` | 展开某次工具调用的完整输出（列表默认折叠到 3 行） |
 | `/exit`（`/quit`） | 退出 |
 
-`/init`、`/config` 等是 **LLM 驱动的 skill**；`/workflow`、`/ralph-loop` 是**插件命令**（见下）。
+`/init`、`/config` 等是 **LLM 驱动的 skill**；`/workflow`、`/workflows` 是**插件激活入口**（见下）。
 
 ### 非交互模式（`-p`）—— 脚本 / CI / 被宿主程序调用
 
@@ -152,9 +152,8 @@ minimal-agent -p --output-format json "做点事"           # 一行结构化结
 - **Skills**：每个 `skills/<name>/SKILL.md`（带 frontmatter）。运行时实时扫描注入 prompt，prompt 体按需懒加载。
   cwd 优先、包内 fallback，用户可在自己项目里覆盖或新增。内置 20+ 个（`/init`、`/config`、文档生成、设计等）。
 - **插件**（`plugins/<id>/`，drop-in，`src/` 一行不改）：
-  - **`/ralph-loop`**（ralph-wiggum）—— Karpathy 式复制任务循环，自带 PLAN/BUILD/VERIFY/HEAL 状态机 + 验证门
-  - **`/workflow` · `/workflows`**（workflow-runner）—— YAML DAG 执行器，9 种 step（tool/llm/skill/assert/branch/loop/pause/parallel/vote）
-- **可视化编辑器**：`editor/` 子项目（Bun + Vite + React Flow）拖拽编排 workflow YAML（不属于 npm 发布物）。
+  - **`/workflow` · `/workflows`**（workflow-runner）—— YAML 工作流引擎，13 种 step（tool/llm/skill/agent + assert/verify/set/branch/loop/break/continue/echo/pause），支持 while 循环 + fresh_context + 验证门。内置 `ralph-loop` 等工作流定义
+- **可视化编辑器**：`../minimal-workflow/` 子项目（与本仓库平级，Bun + Vite + React Flow）拖拽编排 workflow YAML（不属于 npm 发布物）。
 
 ---
 
@@ -215,14 +214,17 @@ dev 下 Bun 透明回退到 `.ts` 兄弟，发布前 `tsc --build` 原地产出
 minimal-agent/
 ├─ src/            # 主程序（loop / tools / llm / ui / plugins / config …）
 ├─ skills/         # 内置 skill（每个一个 SKILL.md）
-├─ plugins/        # 内置插件（ralph-wiggum / workflow-runner）
+├─ plugins/        # 内置插件（workflow-runner）
 ├─ workflows/      # 内置 workflow（YAML）
 ├─ vendor/ripgrep/ # Grep 自带的 6 平台 ripgrep 二进制
 ├─ scripts/        # 构建脚本（含绿色版 build-green.ts）
-├─ editor/         # workflow 可视化编辑器（独立子项目）
 ├─ test/           # 测试
 ├─ GREEN-BUILD.md  # 绿色版/U 盘分发指南
 └─ CLAUDE.md       # 架构与开发指南
+
+../minimal-desktop/  # React/Tauri 桌面产品与本机 Agent Runtime
+../minimal-server/   # 中央账号、好友、群聊、附件与 Agent Node 路由
+../minimal-workflow/ # workflow 可视化编辑器
 ```
 
 ## License

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "minimal-agent",
-  "version": "0.8.2",
+  "version": "0.10.0",
   "description": "最小化 Agent 系统 —— 10 工具 + 插件系统 + workflow DSL + 自动压缩 + OpenAI 兼容 + Ink TUI；NodeNext + tsc 原地编译，dev 用 Bun .ts、install 用 Node .js（学习/教学用）",
   "license": "SEE LICENSE IN LICENSE",
   "author": "Bill Wang <leiwang0359@gmail.com>",
@@ -29,6 +29,31 @@
   "bin": {
     "minimal-agent": "src/main.js"
   },
+  "exports": {
+    "./protocol": {
+      "types": "./src/web/protocol.ts",
+      "bun": "./src/web/protocol.ts",
+      "default": "./src/web/protocol.js"
+    },
+    "./config-service": {
+      "types": "./src/config/configService.ts",
+      "bun": "./src/config/configService.ts",
+      "default": "./src/config/configService.js"
+    },
+    "./provider-presets": {
+      "types": "./src/cli/wizards/providerPresets.ts",
+      "bun": "./src/cli/wizards/providerPresets.ts",
+      "default": "./src/cli/wizards/providerPresets.js"
+    },
+    "./tools/agent/worktree": {
+      "types": "./src/tools/agent/worktree.ts",
+      "bun": "./src/tools/agent/worktree.ts",
+      "default": "./src/tools/agent/worktree.js"
+    },
+    "./src/*.js": "./src/*.ts",
+    "./plugins/*.js": "./plugins/*.ts",
+    "./package.json": "./package.json"
+  },
   "engines": {
     "node": ">=20"
   },
@@ -53,16 +78,19 @@
     "dev": "bun --watch src/main.tsx",
     "build": "tsc --build",
     "clean": "bun scripts/clean-build.ts",
+    "check:build-artifacts": "bun scripts/check-build-artifacts.ts",
     "test": "bun test",
     "typecheck": "tsc --noEmit -p tsconfig.typecheck.json",
     "verify-all": "bun scripts/verify-all.ts",
     "compile:green": "bun scripts/build-green.ts",
     "compile:green:host": "bun scripts/build-green.ts --host",
+    "doc:gen": "node doc/scripts/gen-pptx.mjs",
     "prepublishOnly": "bun run clean && bun run build"
   },
   "dependencies": {
     "fast-glob": "^3.3.2",
     "ink": "^5.0.1",
+    "marked": "^18.0.6",
     "react": "^18.3.1",
     "turndown": "^7.2.4",
     "yaml": "^2.9.0",
@@ -74,5 +102,10 @@
     "@types/react": "^18.3.0",
     "bun-types": "^1.3.13",
     "typescript": "^5.5.0"
+  },
+  "optionalDependencies": {
+    "playwright-core": "^1.40.0",
+    "pngjs": "^7.0.0",
+    "pptxgenjs": "^4.0.1"
   }
 }

package/plugins/cron-runner/.claude-plugin/plugin.json

@@ -0,0 +1,5 @@
+{
+  "name": "cron-runner",
+  "version": "0.1.0",
+  "description": "Schedule prompt and workflow runs while the minimal-agent TUI is alive"
+}

package/plugins/cron-runner/commands/cron.md

@@ -0,0 +1,26 @@
+---
+description: "Create and manage scheduled cron tasks"
+argument-hint: "create|list|pause|resume|delete|run|show|missed ..."
+---
+
+The cron-runner plugin handles this command in plugin.ts.
+
+Supported forms:
+
+- `/cron 120m Prompt`
+- `/cron 1d Task description /workflow daily-news.yaml Extra workflow prompt`
+- `/cron 1m Task description workflow inspect-homework.yaml camera.jpg`
+- `/cron 每天 6:07 Prompt`
+- `/cron 工作日 6:07 Prompt`
+- `/cron 每周一 6:07 Prompt`
+- `/cron create --name "Name" --cron "7 6 * * 1" --prompt "Prompt"`
+- `/cron create --name "Once" --cron "5 13 * * *" --prompt "Prompt" --once`
+- `/cron create --name "Workflow" --cron "7 6 * * 1" --workflow "plan \"Weekly report\"" --permanent`
+- `/cron create --name "Fresh workflow" --cron "7 6 * * *" --workflow "daily-news.yaml" --fresh-session`
+- `/cron list`
+- `/cron show <id>`
+- `/cron pause <id>`
+- `/cron resume <id>`
+- `/cron run <id>`
+- `/cron missed`
+- `/cron delete <id>`

package/plugins/cron-runner/commands/crons.md

@@ -0,0 +1,7 @@
+---
+description: "List scheduled cron tasks"
+argument-hint: ""
+---
+
+The cron-runner plugin handles this command in plugin.ts and lists active,
+paused, recurring, once, and recently missed cron tasks.

package/plugins/cron-runner/plugin.js

@@ -0,0 +1,34 @@
+import { handleCronCommand } from './src/commands.js';
+import { Scheduler } from './src/scheduler.js';
+import { migrateCronTasks } from './src/store.js';
+let scheduler = null;
+let schedulerStop = null;
+export function getCronScheduler() {
+    return scheduler;
+}
+const api = {
+    async activate(ctx) {
+        await migrateCronTasks();
+        await scheduler?.stop();
+        await schedulerStop;
+        const instance = new Scheduler(ctx);
+        scheduler = instance;
+        instance.start();
+        return () => {
+            if (scheduler === instance)
+                scheduler = null;
+            let tracked;
+            tracked = instance.stop().finally(() => {
+                if (schedulerStop === tracked)
+                    schedulerStop = null;
+            });
+            schedulerStop = tracked;
+        };
+    },
+    async *runCommand(commandName, args) {
+        const text = await handleCronCommand(commandName, args, scheduler);
+        yield { type: 'text', delta: text };
+        yield { type: 'turn_done' };
+    },
+};
+export default api;

package/plugins/cron-runner/src/commands.js

@@ -0,0 +1,348 @@
+import { getWorkingDir } from '../../../src/plugin-sdk.js';
+import { formatDateTime } from './cronTime.js';
+import { createTask, deleteTask, getTask, listMissed, listTasks, recentRuns, updateTask, upsertTask, } from './store.js';
+import { validateCron, validateIsoDate } from './schema.js';
+export async function handleCronCommand(commandName, args, scheduler) {
+    if (commandName === 'crons')
+        return await formatTaskList(await listTasks());
+    const argv = tokenize(args);
+    const action = argv.shift() ?? 'list';
+    if (action === 'list')
+        return await formatTaskList(await listTasks());
+    if (action === 'create')
+        return await createFromArgs(argv);
+    if (action === 'pause' || action === 'resume')
+        return await setStatus(argv[0], action === 'resume' ? 'active' : 'paused');
+    if (action === 'delete' || action === 'remove')
+        return await remove(argv[0]);
+    if (action === 'show')
+        return await show(argv[0]);
+    if (action === 'run')
+        return await runNow(argv[0], scheduler);
+    if (action === 'missed')
+        return await formatMissed();
+    if (action === 'help')
+        return helpText();
+    const shortcut = await createFromShortcut(action, argv);
+    if (shortcut)
+        return shortcut;
+    if (/^\d+\S*$/.test(action)) {
+        return `无效间隔：${action}。支持 1m、2h、1d、1w（最小 1 分钟）。`;
+    }
+    return `未知 /cron 子命令：${action}\n\n${helpText()}`;
+}
+async function createFromArgs(argv) {
+    const opts = parseOptions(argv);
+    const cron = opts.cron;
+    const name = opts.name;
+    const prompt = opts.prompt;
+    const workflow = opts.workflow;
+    if (!cron || !name || (!prompt && !workflow)) {
+        return helpText();
+    }
+    const cronValidation = validateCron(cron);
+    if (!cronValidation.ok) {
+        return `无效 cron 表达式：${cron}\n${cronValidation.error}`;
+    }
+    const maxTurns = opts.maxTurns ? Number.parseInt(opts.maxTurns, 10) : undefined;
+    if (opts.maxTurns && (!Number.isFinite(maxTurns) || maxTurns <= 0)) {
+        return `无效 maxTurns：${opts.maxTurns}`;
+    }
+    const maxRuns = opts.maxRuns ? Number.parseInt(opts.maxRuns, 10) : undefined;
+    if (opts.maxRuns && (!Number.isFinite(maxRuns) || maxRuns <= 0)) {
+        return `无效 max-runs：${opts.maxRuns}（须是正整数，跑满这么多次后自动暂停）`;
+    }
+    if (opts.expiresAt) {
+        const expiresAtValidation = validateIsoDate(opts.expiresAt, 'expires-at');
+        if (!expiresAtValidation.ok)
+            return expiresAtValidation.error;
+    }
+    const task = createTask({
+        name,
+        ...(opts.description ? { description: opts.description } : {}),
+        cron,
+        timezone: Intl.DateTimeFormat().resolvedOptions().timeZone || 'local',
+        cwd: getWorkingDir(),
+        ...(opts.model ? { model: opts.model } : {}),
+        ...(maxTurns ? { maxTurns } : {}),
+        kind: opts.once === 'true' ? 'once' : 'recurring',
+        ...(opts.permanent === 'true' ? { permanent: true } : {}),
+        ...(opts.expiresAt ? { expiresAt: opts.expiresAt } : {}),
+        ...(maxRuns ? { maxRuns } : {}),
+        sessionMode: opts.freshSession === 'true' ? 'fresh' : 'persistent',
+        action: workflow
+            ? { type: 'workflow', command: workflow }
+            : { type: 'prompt', prompt: prompt },
+    });
+    await upsertTask(task);
+    return `已创建 cron：${task.id}\n${await formatTask(task)}`;
+}
+async function createFromShortcut(head, rest) {
+    const parsed = parseShortcutSchedule(head, rest);
+    if (!parsed)
+        return null;
+    if ('error' in parsed)
+        return parsed.error;
+    const task = createTask({
+        name: parsed.name,
+        ...(parsed.description ? { description: parsed.description } : {}),
+        ...(parsed.cron ? { cron: parsed.cron } : {}),
+        ...(parsed.intervalMs ? { intervalMs: parsed.intervalMs, anchorAt: new Date().toISOString() } : {}),
+        timezone: Intl.DateTimeFormat().resolvedOptions().timeZone || 'local',
+        cwd: getWorkingDir(),
+        action: parsed.action,
+    });
+    await upsertTask(task);
+    return `已创建 cron：${task.id}\n${await formatTask(task)}`;
+}
+export function parseShortcutSchedule(head, rest) {
+    const intervalMs = parseIntervalShortcut(head);
+    let actionTokens = rest;
+    let cron;
+    if (!intervalMs) {
+        const time = rest[0];
+        if (!time)
+            return null;
+        const parsedTime = parseClockTime(time);
+        if (!parsedTime)
+            return null;
+        actionTokens = rest.slice(1);
+        const { hour, minute } = parsedTime;
+        const cronTime = `${minute} ${hour}`;
+        if (head === '每天' || head === '每日')
+            cron = `${cronTime} * * *`;
+        else if (head === '工作日')
+            cron = `${cronTime} * * 1-5`;
+        else {
+            const weekly = head.match(/^每周([一二三四五六日天])$/);
+            if (!weekly)
+                return null;
+            cron = `${cronTime} * * ${weekdayNumber(weekly[1])}`;
+        }
+    }
+    const parsedAction = parseShortcutAction(actionTokens);
+    if ('error' in parsedAction)
+        return parsedAction;
+    return {
+        ...(cron ? { cron } : {}),
+        ...(intervalMs ? { intervalMs } : {}),
+        ...parsedAction,
+    };
+}
+export function parseIntervalShortcut(text) {
+    const match = text.match(/^(\d+)(m|min|分钟|h|小时|d|天|w|周)$/i);
+    if (!match)
+        return null;
+    const value = Number.parseInt(match[1], 10);
+    if (!Number.isFinite(value) || value <= 0)
+        return null;
+    const unit = match[2].toLowerCase();
+    const multiplier = unit === 'w' || unit === '周'
+        ? 7 * 24 * 60 * 60_000
+        : unit === 'd' || unit === '天'
+            ? 24 * 60 * 60_000
+            : unit === 'h' || unit === '小时'
+                ? 60 * 60_000
+                : 60_000;
+    const intervalMs = value * multiplier;
+    return Number.isSafeInteger(intervalMs) && intervalMs >= 60_000 ? intervalMs : null;
+}
+function parseShortcutAction(tokens) {
+    if (tokens.length === 0) {
+        return { error: '请在时间后面写提示词或 workflow。\n例如：/cron 1d /workflow daily-news.yaml 生成中文新闻稿' };
+    }
+    const markerIndex = tokens.findIndex((token) => token === '/workflow' || token === 'workflow');
+    if (markerIndex < 0) {
+        const prompt = tokens.join(' ').trim();
+        return { action: { type: 'prompt', prompt }, name: deriveName(prompt) };
+    }
+    const workflowName = tokens[markerIndex + 1];
+    if (!workflowName)
+        return { error: 'workflow 标记后缺少 YAML 名称。' };
+    const description = tokens.slice(0, markerIndex).join(' ').trim();
+    const command = serializeTokens(tokens.slice(markerIndex + 1));
+    return {
+        action: { type: 'workflow', command },
+        ...(description ? { description } : {}),
+        name: description || deriveName(workflowName.replace(/\.ya?ml$/i, '')),
+    };
+}
+function serializeTokens(tokens) {
+    return tokens
+        .map((token) => (/\s|["'\\]/.test(token) ? JSON.stringify(token) : token))
+        .join(' ');
+}
+function parseClockTime(text) {
+    const match = text.match(/^(\d{1,2})[:：](\d{1,2})$/);
+    if (!match)
+        return null;
+    const hour = Number.parseInt(match[1], 10);
+    const minute = Number.parseInt(match[2], 10);
+    if (hour < 0 || hour > 23 || minute < 0 || minute > 59)
+        return null;
+    return { hour, minute };
+}
+function weekdayNumber(day) {
+    return { 日: 0, 天: 0, 一: 1, 二: 2, 三: 3, 四: 4, 五: 5, 六: 6 }[day] ?? 1;
+}
+function deriveName(prompt) {
+    const compact = prompt.replace(/\s+/g, ' ').trim();
+    return compact.length > 18 ? `${compact.slice(0, 18)}...` : compact || 'cron task';
+}
+async function setStatus(id, status) {
+    if (!id)
+        return '请提供任务 id。';
+    const task = await getTask(id);
+    if (!task)
+        return `未找到任务：${id}`;
+    await updateTask(task.id, (latest) => ({ ...latest, status }));
+    return `已${status === 'active' ? '恢复' : '暂停'} ${task.id}`;
+}
+async function remove(id) {
+    if (!id)
+        return '请提供任务 id。';
+    return (await deleteTask(id)) ? `已删除 ${id}` : `未找到任务：${id}`;
+}
+async function show(id) {
+    if (!id)
+        return '请提供任务 id。';
+    const task = await getTask(id);
+    if (!task)
+        return `未找到任务：${id}`;
+    const runs = await recentRuns(task.id, 5);
+    const runLines = runs.length === 0
+        ? '最近运行：无'
+        : `最近运行：\n${runs.map((r) => `- ${formatDateTime(r.startedAt)} ${r.status}${r.error ? ` · ${r.error}` : ''}`).join('\n')}`;
+    return `${await formatTask(task)}\n${runLines}`;
+}
+async function runNow(id, scheduler) {
+    if (!id)
+        return '请提供任务 id。';
+    if (!scheduler)
+        return 'cron scheduler 尚未启动；请在 TUI 中运行。';
+    const task = await getTask(id);
+    if (!task)
+        return `未找到任务：${id}`;
+    void scheduler.runTaskNow(task.id);
+    return `已开始手动运行 ${task.id}`;
+}
+async function formatMissed() {
+    const missed = await listMissed(20);
+    if (missed.length === 0)
+        return '暂无错过任务。';
+    return [
+        '错过任务：',
+        ...missed.map((m) => `- ${m.taskId} · ${m.taskName} · ${m.reason === 'overlap' ? '运行重叠' : m.reason === 'binding_unavailable' ? '会话绑定失效' : '宿主离线'}跳过 ${m.missedCount} 次 · 计划 ${formatDateTime(m.scheduledFor)} · ${m.actionPreview}`),
+    ].join('\n');
+}
+async function formatTaskList(tasks) {
+    if (tasks.length === 0)
+        return '暂无 cron 任务。';
+    const missed = await listMissed(1);
+    const header = missed.length > 0 ? `提示：有错过任务，可用 /cron missed 查看。\n\n` : '';
+    const body = await Promise.all(tasks.map(formatTask));
+    return `${header}${body.join('\n\n')}`;
+}
+async function formatTask(task) {
+    const action = task.action.type === 'workflow'
+        ? `/workflow ${task.action.command}`
+        : task.action.prompt;
+    const runs = await recentRuns(task.id, 1);
+    const recent = runs[0]
+        ? `${runs[0].status}${runs[0].error ? ` · ${runs[0].error}` : ''}`
+        : '-';
+    return [
+        `${task.id} · ${task.name}`,
+        `状态：${task.status === 'active' ? '活跃' : '暂停'}`,
+        `类型：${task.kind === 'once' ? '一次性' : task.maxRuns ? `限 ${task.maxRuns} 次` : '重复'}`,
+        `下次运行：${formatDateTime(task.schedule.nextRunAt)}`,
+        `上次运行时间：${formatDateTime(task.stats.lastRunAt)}`,
+        `详情：${task.description ?? '-'}`,
+        `运行环境：${task.runtime.environment}`,
+        `项目：${task.runtime.cwd}`,
+        `重复次数：${task.stats.runCount}${task.maxRuns ? `/${task.maxRuns}（跑满自动暂停）` : ''}`,
+        `跳过次数：${task.stats.skippedCount}`,
+        `会话：${task.runtime.sessionMode === 'fresh' ? '每次全新' : '持续会话'}`,
+        `模型：${task.runtime.model ?? '-'}`,
+        `最近结果：${recent}`,
+        `计划：${task.schedule.human} (${task.schedule.type === 'cron' ? `${task.schedule.cron}, ${task.schedule.timezone}` : `锚点 ${formatDateTime(task.schedule.anchorAt)}`})`,
+        `动作：${action}`,
+    ].join('\n');
+}
+function helpText() {
+    return [
+        '用法：',
+        '/cron 120m 整理最近 AI 新闻',
+        '/cron 1d 整理每日国际新闻 /workflow daily-news.yaml 生成中文新闻稿',
+        '/cron 1m 检查学生作业 workflow inspect-homework.yaml 摄像头画面在 camera.jpg',
+        '/cron 每天 6:07 写国际 AI 晨间简报',
+        '/cron 工作日 6:07 写过去 48 小时国际 AI 大事',
+        '/cron 每周一 6:07 整理国际 AI 超级个体创业案例',
+        '/cron create --name "晨间简报" --cron "7 6 * * 2-6,0" --prompt "写国际 AI 简报"',
+        '/cron create --name "提醒" --cron "5 13 * * *" --prompt "执行提醒" --once',
+        '/cron create --name "周报" --cron "7 6 * * 1" --workflow "plan \\"整理周报\\"" --permanent',
+        '/cron create --name "定时PPT" --cron "0 */2 * * *" --workflow "ppt.yaml 做个X方案" --max-runs 5',
+        '/cron create --name "独立日报" --cron "7 6 * * *" --workflow "daily-news.yaml" --fresh-session',
+        '/cron list',
+        '/cron pause <id>',
+        '/cron resume <id>',
+        '/cron run <id>',
+        '/cron show <id>',
+        '/cron missed',
+        '/cron delete <id>',
+    ].join('\n');
+}
+function tokenize(input) {
+    const out = [];
+    let cur = '';
+    let quote = null;
+    for (let i = 0; i < input.length; i++) {
+        const ch = input[i];
+        if (quote) {
+            if (ch === '\\' && i + 1 < input.length) {
+                cur += input[++i];
+            }
+            else if (ch === quote) {
+                quote = null;
+            }
+            else {
+                cur += ch;
+            }
+            continue;
+        }
+        if (ch === '"' || ch === "'") {
+            quote = ch;
+            continue;
+        }
+        if (/\s/.test(ch)) {
+            if (cur) {
+                out.push(cur);
+                cur = '';
+            }
+            continue;
+        }
+        cur += ch;
+    }
+    if (cur)
+        out.push(cur);
+    return out;
+}
+function parseOptions(argv) {
+    const map = {};
+    for (let i = 0; i < argv.length; i++) {
+        const key = argv[i];
+        if (!key.startsWith('--'))
+            continue;
+        const value = argv[i + 1];
+        if (!value || value.startsWith('--')) {
+            map[toCamel(key.slice(2))] = 'true';
+            continue;
+        }
+        map[toCamel(key.slice(2))] = value;
+        i++;
+    }
+    return map;
+}
+function toCamel(s) {
+    return s.replace(/-([a-z])/g, (_, c) => c.toUpperCase());
+}