Configuration reference

运行时配置控制 Appaloft serve、数据库、静态资源目录和自托管行为。

APPALOFT_DOCS_STATIC_DIR 覆盖 public docs 静态资源，不覆盖 Web console。

Durable worker runtime 配置控制已经 accepted 的长耗时工作在请求返回 id 之后如何被 claim、执行和监控。 默认 embedded 模式会随 appaloft serve 一起启动 worker slots，降低自托管部署难度。operator 也可以运行 appaloft worker 启动专用 worker 进程；Cloud 这类部署可以配置多个 standalone workers，共享同一个 durable queue backend。

默认 queue backend 是 database，使用专门的 durable work item 和 event 表作为 durable state authority。Temporal、Kafka 或其他外部 workflow engine 必须通过 adapter 接入，并继续为 operator-work.* query 投影安全的 durable-work 和 process-attempt 进度。

appaloft doctor、GET /api/system/doctor 和 Web Instance 页面会报告配置的 mode、queue backend、 worker group、worker ids 和 coordinator role。Web/API 进程不执行 durable work 时，也可以通过 APPALOFT_WORKER_OBSERVED_GROUPS 观测独立 worker group。

除非另有说明，scheduled worker 默认关闭。只在应拥有周期性工作的实例上启用它们。

certificate retry scheduler 是默认开启的例外，因为它只处理已经 accepted、随后进入 retry-scheduled 状态的 managed certificate work。Runtime execution、runtime prune、history retention、monitoring collection 和 preview cleanup worker 都保持默认关闭，直到 operator 显式启用对应的 APPALOFT_*_ENABLED 设置。

这些 runner 不会在 Appaloft 状态之外发现新工作。它们只会处理已经到期的 task runs、显式 runtime prune policies、retention defaults、已存在运行时归属的 monitoring targets、已经过期且仍 active 的 preview environments，或已经记录为 retry-scheduled 的 cleanup attempts。

appaloft doctor、GET /api/system/doctor 和 Web Instance 页面会报告这些 worker 的配置激活状态、 间隔、batch 设置和安全模式，但不会启动或 tick 它们。