feat(automation): 拆开「多久跑一次」与「同一账号多久重检」—— 调度频率终于可配

用户反馈:「单账号重检间隔(小时) 很别扭,直接设置多久跑一次、一次跑多少个更符合直觉」。

**对,而且比"别扭"更严重:调度频率以前根本改不了。**

## 问题:两个概念挤在一个字段里

`_run_one` 里原本写着:

    job.next_run_at = finished + timedelta(seconds=JOB_INTERVAL_SECONDS)   # 硬编码 300 秒

也就是不管界面上填什么,下一轮永远是「跑完 + 5 分钟」。
而界面那个「单账号重检间隔(小时)」对应的是 `interval_seconds` ——
它只被作业**自己的选行逻辑**使用("这行多久该重检"),**完全不参与调度**。

于是出现最坏的情况:**看起来能配调度,其实配的是一个不相干的参数**。
上一轮我还拿它算过吞吐("10 分钟一轮"),算错了 —— 已在调度器注释里纠正。

## 拆法

| 概念 | 字段 | 界面 |
| --- | --- | --- |
| **多久跑一次** | `run_interval_seconds`(迁移 0051,默认 300)| 「多久跑一次(分钟)」|
| 同一账号多久重检 | `interval_seconds`(不变)| 「同一账号多久重检(小时)」|

- `next_run_at = finished + run_interval_seconds`(有下限 30 秒,避免忙轮询)
- 接口:`GET` 返回新字段、`PATCH` 可改
- 前端:两个输入框分开,并把原来那段绕口的 tooltip
  ("它不决定调度频率 —— 调度周期见页面顶部说明")改掉 ——
  那句话本身就是这个设计缺陷的自白

## 默认 300 秒

与改动前**实际行为一致** —— 不会因为这次迁移让已有作业突然变快或变慢。
想调快就自己填(比如「账号资料定时补全」填 5 分钟 + 每轮 400 条 ≈ 3 小时补完)。

## ⚠️ 顺带说明一个你截图里可能看到的现象

截图里「账号资料定时补全」显示的是 **0.5 小时 / 30 条** —— 那是我**最初的默认值**。
因为 `ensure_jobs` **只创建不更新**,我后面改成 10 分钟/400 **不会作用到已存在的行**。
这是刻意的(否则会覆盖运维的手工调整),但意味着**默认值改了要手动在界面上改**,
或者删掉那行让 `ensure_jobs` 重建。现在有了「多久跑一次」这个框,直接填就行。

## 测试(+3)

- 下一轮按**运行间隔**排,不是按「同一行重检间隔」(两个值刻意设成不同来钉住)
- 不填时默认 300 秒(保持旧行为)
- 过小的间隔被夹到下限

## 验证

TZ=Asia/Shanghai **639 passed / 6 skipped**;ruff 全绿;前端 build 通过、lint 0 errors。
This commit is contained in:
yml2213
2026-10-04 21:30:13 +08:00
parent aea8e4f73d
commit 55f899c615
8 changed files with 197 additions and 6 deletions
+78
View File
@@ -916,3 +916,81 @@ class TestSchedulerRunsJobsConcurrently:
time.sleep(0.1)
assert not scheduler._IN_FLIGHT, "失败后没清在途标记,作业会被永久跳过"
assert calls, "作业应该真的跑过一次"
class TestRunIntervalIsScheduling:
"""「多久跑一次」与「同一行多久重检」是**两个独立概念**。
用户反馈:界面上那个「单账号重检间隔(小时)」很别扭,直接设「多久跑一次、
一次跑多少个」更符合直觉 —— 对,因为**调度频率以前根本改不了**:
job.next_run_at = finished + timedelta(seconds=JOB_INTERVAL_SECONDS) # 硬编码 5 分钟
于是不管界面上填什么,下一轮永远是「跑完 + 5 分钟」。
"""
def setup_method(self):
self.engine = get_test_engine()
self.session = make_test_session(self.engine)
reset_registry()
def teardown_method(self):
reset_registry()
self.session.close()
def _job(self, run_interval: int | None):
calls: list[int] = []
def probe(db, job):
calls.append(1)
return {"scanned": 1}
register_job(
JobSpec(
key="probe",
title="probe",
interval_seconds=6 * 3600, # 同一行重检间隔(不参与调度)
batch_size=10,
concurrency=1,
run=probe,
**({"run_interval_seconds": run_interval} if run_interval else {}),
)
)
self.session.add(
AutomationJob(
key="probe",
title="probe",
interval_seconds=6 * 3600,
run_interval_seconds=run_interval or 300,
batch_size=10,
concurrency=1,
enabled=True,
)
)
self.session.commit()
return calls
def _next_run_delay(self) -> float:
run_due_jobs(self.session)
job = (
self.session.query(AutomationJob).filter(AutomationJob.key == "probe").one()
)
assert job.last_run_at is not None and job.next_run_at is not None
return (job.next_run_at - job.last_run_at).total_seconds()
def test_next_run_follows_run_interval_not_the_row_interval(self):
"""下一轮按**运行间隔**排,不是按「同一行重检间隔」。"""
self._job(run_interval=1800)
delay = self._next_run_delay()
assert delay == 1800, f"应按运行间隔 1800 排,实际 {delay}"
assert delay != 6 * 3600, "不能再用「同一行重检间隔」当调度周期"
def test_default_run_interval_keeps_old_behaviour(self):
"""不填时默认 300 秒 —— 与改动前的硬编码行为一致(不会突然变快变慢)。"""
self._job(run_interval=None)
assert self._next_run_delay() == 300
def test_too_small_interval_is_clamped(self):
"""太小的间隔是忙轮询,没有意义 —— 有下限。"""
self._job(run_interval=1)
assert self._next_run_delay() >= scheduler.MIN_RUN_INTERVAL_SECONDS
+1 -1
View File
@@ -26,7 +26,7 @@ TESTS_DIR = Path(__file__).resolve().parent
PROJECT_ROOT = TESTS_DIR.parent
VERSIONS_DIR = PROJECT_ROOT / "web" / "backend" / "migrations" / "versions"
HEAD_REVISION = "20261004_0050"
HEAD_REVISION = "20261004_0051"
# 迁移新增、但不声明在模型里的复合查询索引。
EXTRA_INDEXES = (