osFoundry / Platform
应用 cron 任务
为每个应用安排周期任务。Cron 语法、重试、可观察的运行记录。
简介
应用 Cron 任务让你为 osFoundry 中某个具体的应用安排定期执行的工作。你不必让脚本一直挂着运行，也不必记着手动去触发，而是把一份计划直接附加到应用本身，让它按自己的节奏自动运行。每个任务都用标准 cron 语法定义，所以像 `0 * * * *` 这样的表达式表示每小时执行一次，`30 6 * * 1-5` 表示工作日 6:30 执行。由于计划属于应用本身，任务运行所需的一切（它的逻辑、它的环境、它的密钥）都随应用一起走，而不是留在一个独立、脱节的调度器里。
在底层，每一次定时运行都被当作一个可观察的单元来对待。当某次运行失败时，任务会重试，而不是悄无声息地丢掉这份工作，并且每一次尝试都会被记录下来，让你看得到运行了什么、何时运行、是否成功、产出了什么。正是这份运行历史，区分了一条你只能寄望它触发的 cron 行，和一份你真正能够核实的计划。osFoundry 是一个自带密钥（BYOK）的桌面工作区，因此这些任务是针对你用自己的 API 密钥接入的模型和服务来执行的。定期任务花费的成本上不会有任何转售加价，而且由于工作区本地优先，应用及其计划可以留在你自己的设备上，而不是厂商的服务器上。
这一点对应用中日积月累、悄无声息又重复的工作最有意义：按节奏拉取数据、重新生成某项输出、跑一次检查、按定时器启动一个 agent 任务。cron 让你精确掌控在什么时候执行，重试让计划能够扛住偶发的失败，运行日志让整件事可审计。它与 osFoundry 的其余部分（聊天与 agents、应用、代码、知识与数据）并肩共存，因此一个定时的应用任务可以为你本来就在用的同一个工作区供给内容，而不是另立一个自动化孤岛。
主要功能
- 用标准 cron 语法定义计划，从简单的每小时一次，到仅工作日或按月边界的表达式
- 把计划附加到某个具体应用，让它的逻辑、环境和密钥作为一个整体一起运行
- 运行失败时自动重试，而不是悄无声息地丢掉计划中的工作
- 可观察的运行历史：查看每次运行的时间、状态和产出，确认计划确实触发了
- BYOK 且本地优先：任务针对你自己接入的模型和密钥运行，没有按席位收费，也没有转售加价
使用场景
- 数据工程师：用 cron 安排某个应用每小时拉取并刷新一份数据集，再查看运行日志确认每次同步都已完成
- 运营负责人：在工作日清晨运行一个应用任务，重新生成报表，并在数据源短暂不可用时自动重试
- 独立开发者：把一个定期的 agent 任务放到夜间 cron 上，让日常工作在你自己的机器上、用你自己的 API 密钥无人值守地运行
常见问题
osFoundry 使用哪种 cron 语法？
标准的 cron 表达式：分钟、小时、日、月、星期五个字段。所以 `0 * * * *` 在每个整点执行，`30 6 * * 1-5` 在工作日 6:30 执行。计划是按应用分别设置的。
如果一次定时运行失败了会怎样？
任务会重试，而不是悄无声息地丢掉这份工作，并且每一次尝试都会记录在该应用的运行历史里，让你看得到哪些运行成功、哪些失败，以及各自产出了什么。
任务在哪里运行，花费如何？
osFoundry 是一个本地优先、自带密钥的桌面工作区，所以定时的应用任务是针对你用自己的 API 密钥接入的模型和服务来运行的。这部分用量没有转售加价，安排计划也不收按席位的费用。