Skip to content

task_doc.md

Latest commit

 

History

History
127 lines (79 loc) · 5.8 KB

task_doc.md

File metadata and controls

127 lines (79 loc) · 5.8 KB

定时任务 ⏰(Scheduled Tasks) 使用说明文档

文档更新时间：2026年3月4日

定时任务 是 Funchat 2.0 引入的重磅功能。它允许您将 AI 的工作自动化，让 Funchat 成为您的 24 小时全天候智能员工。

您可以设置任务让 AI 每天早上阅读新闻并生成摘要，或者每小时检查一次服务器状态，甚至让 AI 通过内置的 MCP 工具自我管理任务计划。

1. 快速开始

在 Funchat 主界面，点击顶部的 “定时任务” 标签页（闹钟图标），即可进入任务管理界面。

定时任务界面

1.1 创建任务

  1. 点击左侧列表底部的 “+ 新建任务” 按钮。
  2. 输入任务名称（例如：每日早报），回车确认。
  3. 在右侧详情页配置具体的触发规则和执行内容。
  4. 点击右上角的开关 启用任务。

1.2 核心概念

  • 触发规则 (Trigger)：决定任务何时运行。
  • 目标助手 (Target Agent)：决定由哪个 AI 角色来执行任务。
    • 注意：只有 “独立窗口” 模式的快捷助手才能被选中。
  • 指令内容 (Prompt)：发送给 AI 的具体命令。
    • 建议：指令应包含明确的目标、步骤和输出要求。例如：“搜索各科技媒体的头条，总结为 markdown 表格，并保存为名为 'news.md' 的本地文件。”

2. 触发规则详解

Funchat 提供了灵活的调度策略以满足不同场景：

  • 间隔触发 (Interval)：每隔 X 分钟执行一次。
    • 起始时间：设置当天的计算起点（例如 09:00）。
    • 生效时间段：您可以添加一个或多个允许触发的时间范围（例如 09:00-12:00，14:30-17:30）。设置后，任务仅在这些有效时间内触发；如果不设置，则默认全天 24 小时执行。
    • 场景：每小时监控服务、每30分钟提醒喝水（限制在白天不打扰夜间睡眠）。
  • 每日定时 (Daily)：每天在固定时间（HH:mm）执行。
    • 场景：每日日报生成、每日单词推送。
  • 每周定时 (Weekly)：在每周特定几天的固定时间执行。
    • 场景：周五写周报、工作日早上查收邮件。
  • 每月定时 (Monthly)：在每月几号的固定时间执行。
    • 场景：月度账单整理、系统月度维护检查。

3. 高级配置

3.1 默认助手与模型

如果您不想为每个任务单独创建一个快捷助手，可以使用系统预置的 “默认助手 (Default Agent)”。

  • 点击左侧底部的 ⚙️ (全局设置) 按钮，可以配置默认助手使用的 AI 模型（例如 GPT-5.2 或 Gemini-3-flash）。
  • 默认助手是一个纯净的执行环境，不包含任何预设的 System Prompt。

3.2 环境覆盖 (Overrides)

有些任务可能需要特殊的工具支持，您可以为特定任务临时挂载能力，而无需修改快捷助手的全局配置：

  • 覆盖 MCP 服务：勾选此任务执行时需要的 MCP 工具（默认已勾选内置服务）。
  • 覆盖 Skill 技能：勾选此任务需要参考的 Skill 知识库。

3.3 后台行为

为了实现全自动化的“无人值守”运行，建议配置以下选项：

  • 自动保存对话 (Auto-save)：开启后，任务执行产生的对话记录将自动保存到本地（格式：任务名-时间.json）。
    • 依赖：需在“设置”中配置本地对话路径。
  • 自动关闭窗口 (Auto-close)：开启后，当 AI 执行完毕（停止输出或工具调用结束）时，独立窗口会自动关闭，不打扰您的工作。

4. 历史记录与监控

在任务配置页面的底部，您可以查看 “最近执行记录”。

  • 状态监控：显示执行时间、成功/失败状态。
  • 文件链接：如果任务生成了对话文件，点击文件名可以直接在“历史对话”中打开查看。
  • 日志管理：支持刷新和一键清空历史记录（可选择同时删除对应的本地文件）。

5. 进阶：使用 MCP 自我管理

Funchat 内置了 Task Manager MCP 服务。这意味着您可以创建一个 AI 助手，让它来帮您管理任务！

示例 Prompt：

"帮我创建一个每隔2小时执行一次的任务，名字叫'喝水提醒'，生效时间在早上9点到晚上6点，内容是提醒我喝水。"

AI 的操作：

  1. AI 调用 create_task 工具。
  2. 自动填入参数：name="喝水提醒", schedule_type="interval", time_param="120", interval_time_ranges=["09:00-18:00"], instruction="用一两句话提醒我喝水"。
  3. 任务创建成功并立即生效。

6. 常见问题 (FAQ)

Q1: 电脑休眠或 uTools 退出后，任务还会执行吗？

A: 很可惜不会执行。Funchat 是基于 uTools 运行的插件，依赖于主进程存活。如果电脑休眠或 uTools 完全退出，计时器将暂停。唤醒后，如果错过了触发时间，系统会根据逻辑判断是否补发（通常会忽略过期的触发，等待下一个周期）。

Q2: 为什么我的任务触发了，但是窗口弹出来一片空白或者报错？

A:

  1. 请检查网络连接。
  2. 请检查所选的 目标助手 是否配置了有效的模型和 API Key。
  3. 如果使用了 MCP 工具，请确保相关服务已启动且未报错。

Q3: 多个任务同时触发会发生什么？

A: 它们会依次排队或同时弹出多个独立窗口（取决于系统资源和 uTools 限制）。建议错开高频任务的执行时间。

如需更多帮助，请访问我们的开源社区或联系开发者。祝您使用愉快！顺便求个Star🌟>.Q

GITHUB开源项目 AI Funchat GITEE开源项目 AI Funchat QQ群：1065512489