面向中文新手用户的 GitHub Actions 定时任务桌面应用。
装一个 App，像聊天一样说出你的需求（"每天早上 8 点播报上海天气"），剩下的交给 GitHub——App 会自动把你的任务翻译成 GitHub Actions workflow，推送到你的私有仓库里执行。全程不需要写代码、不需要懂 YAML。
UI 采用 Codex Desktop 风格（暖炭黑 + 米白 + 单色中性配色，参考 LiveStudio 的视觉规范），支持深色 / 浅色主题切换。
一键启动（自动安装依赖、编译 Electron 主进程、同时启动 Vite 和 Electron）：
./dev.sh # Vite + Electron
./dev.sh vite # 仅浏览器模式（调试 UI 用，需手动 npm run dev:electron 跑完整功能）也可以手动分步：
cd frontend
npm install
npm run dev:electron # Vite + Electron 并跑
npm run dev # 仅浏览器
npm test# 单元测试（流程编译、摘要提取、workflow 生成）欢迎提 PR！开发环境、代码约定和安全须知见 CONTRIBUTING.md。
- 打开 App，进入「设置」
- 点击「去 GitHub 生成 Token」，登录你的 GitHub 账号
- 勾选
repo和workflow两个权限（有效期建议选 90 天以上），生成后复制粘贴回 App - 点击「连接 GitHub」——App 会自动为你创建私有仓库
taskflow-tasks - 回到「我的任务」，点「＋ 新建任务」，选择模板或直接输入中文描述
⚠️ 当前版本使用经典 Personal Access Token 打通全流程；后续版本将换成 GitHub App（device flow），用户只需浏览器点一下授权。
- 💬 一句话创建任务：支持"每天 8 点""每周一 9 点""每月 1 日"等中文描述，自动识别模板与时间
- 🧩 模板市场：天气播报、基金净值提醒、网页变化监控（关键词检测 + 状态存档）、RSS 每日摘要、每日网页存档、网站掉线监控、每日一句、GitHub 绿点打卡
- 🛠️ 自定义模板：粘贴自己的 Shell 脚本 + 定义参数，多步骤编排；内置模板可「复制修改」；模板支持导出 / 导入文件分享
- 🔀 可视化流程编排（Coze 风格）：拖拽式节点流——抓取网页 → 检查关键词 → 请求接口 → 条件判断（if/else 分支）→ 输出结果，填表单代替写脚本，自动编译成 workflow
- 💾 运行历史本地缓存：离线 / GitHub 接口异常时也能查看最近运行记录
- 📌 RESULT 结果约定：模板显式标记结果行，推送/通知只带主要信息，不再猜日志格式
- ⏰ 双调度：App 打开时精确触发；App 关闭时由 GitHub cron 兜底（可能有几分钟误差）
- 🕘 运行历史：实时查看每次运行状态与耗时，一键跳转 GitHub 完整日志
- 📄 查看结果：App 内直接查看每次运行的日志输出（天气结果、监控结论等），不用跳网页
- 🔔 通知：App 打开时系统通知弹结果摘要；App 关闭时由 Server酱 / 钉钉 / 企业微信机器人推送（设置 → 通知设置，保存后点「同步到已有任务」）
- ⏸ 暂停 / 恢复 / 删除：暂停会同步移除 GitHub 上的定时触发，删除会清理远端 workflow 文件
- ✏️ 任务编辑：随时修改任务名称、参数、触发时间，改动自动同步到远端 workflow
- 🔒 本地优先：Token 用系统钥匙串加密保存，任务配置存本地，执行全部在你的 GitHub 私有仓库中
taskflow/
├── dev.sh # 一键开发启动
└── frontend/
├── electron/ # Electron 主进程（tsc 编译到 dist-electron）
│ ├── main.ts # 应用入口（dev 加载 :5173，生产加载 dist/）
│ ├── preload.ts # IPC 桥接 window.taskflow
│ ├── github.ts # GitHub REST API（fetch 实现，无需额外依赖）
│ ├── workflow.ts # 任务 → workflow YAML 生成器
│ ├── scheduler.ts # 本地 cron 精确调度
│ ├── store.ts # 本地 JSON 存储（userData/taskflow.json）
│ └── ipc.ts # IPC 通道
├── shared/ # 主进程/渲染进程共享类型与模板
├── src/ # 渲染进程（Vite + React + Tailwind v4）
│ ├── components/ # Sidebar / TaskCard / CreateTaskDialog / ui
│ ├── pages/ # 我的任务 / 运行历史 / 模板市场 / 设置
│ └── lib/ # cron 生成、中文意图解析、格式化
├── index.html
├── vite.config.ts
├── tsconfig.json
└── tsconfig.electron.json
用户表单 / 中文描述
│
▼
任务配置（本地 JSON）
│
▼
workflow 生成器 → .github/workflows/taskflow-xxx.yml
│
▼
GitHub API push 到私有仓库 taskflow-tasks
│
├─ App 打开时 → node-cron 精确触发 workflow_dispatch
└─ App 关闭时 → GitHub schedule cron 兜底触发
│
▼
运行结果 → Actions API 拉取 → 历史页面展示
- Electron + React + Vite + TypeScript（构建方式与 LiveStudio 一致：
tsc编译主进程 +concurrently并跑 Vite/Electron） - Tailwind CSS v4（Codex Desktop 色板，
@themeCSS 变量，支持明暗主题） - GitHub REST API（内置 fetch，零额外依赖）
- node-cron：App 内精确调度
- safeStorage：Token 加密存储
cd frontend
npm run build
npx electron-builder --mac # macOS（dmg）
npx electron-builder --win # Windows（nsis 安装包）- GitHub App（device flow）一键授权，替代手动 Token
- 更多模板：邮件推送、股票提醒
- 任务编辑（修改参数与时间）
- 推送通知（系统通知 + 微信/钉钉/Server酱）
- 云调度增值服务（不装 App 也能跑）
MIT