> ## Documentation Index
> Fetch the complete documentation index at: https://starforge.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 定时任务

> 后台任务的排期、运行历史，以及立即执行一次。

仅管理员。平台为自己运行的每一个周期性任务：出队、诊断、看门狗、存储扫描、
注册表对账、每日日报。

<Frame caption="后台任务的排期与运行历史。">
  <img src="https://mintcdn.com/starforge/GatXR2rI5-_Vm4_H/images/console/admin-tasks.png?fit=max&auto=format&n=GatXR2rI5-_Vm4_H&q=85&s=8fcf09088a2cd6835bf1e4a64dd00a9b" alt="StarForge scheduled tasks" width="2160" height="1350" data-path="images/console/admin-tasks.png" />
</Frame>

## 你会看到什么

| 列        | 显示什么             |
| -------- | ---------------- |
| **排期**   | 间隔，或者「已关闭」       |
| **启用**   | 它到底跑不跑           |
| **上次运行** | 什么时候、跑了多久、成功还是失败 |
| **触发方式** | 那一次是排期触发还是手动触发   |

## 你可以做什么

* 对可调节奏的任务**修改间隔**。有些是固定节奏的，页面会写明。
* **关闭**某个任务。
* **立即运行** —— 改完某项任务会读取的设置之后很有用，不用干等它的下一个周期。
* **看历史** —— 最近几次运行的结果和耗时。

## 两条值得看懂的提示

<AccordionGroup>
  <Accordion title="所有后台任务都已停止" icon="circle-off">
    没有配置 Redis。后台角色需要一把共享锁，避免多个控制台副本同时跑同一个任务；
    没有锁的话平台会停掉它们，而不是不安全地跑。

    单实例下这是一条你可以接受的警告。多副本下它意味着存储记账、诊断和每日日报
    根本没有在发生。
  </Accordion>

  <Accordion title="Worker 跑在独立进程里" icon="split">
    `FORGE_INPROCESS_WORKERS` 是关的，所以这些任务由 `python -m server.worker` 执行，
    而不是在 web 进程内。规模上去之后这是推荐形态——调用 LLM 的慢 tick 不再抬高 API 尾延迟——
    而这一页仍然显示它们的排期和历史。

    某个任务没在跑的话，检查它那个角色的 worker 进程是不是真的起来了。
  </Accordion>
</AccordionGroup>
