From 62a17647e16aa1fc0348b2f7af2231ee784c0d10 Mon Sep 17 00:00:00 2001 From: augushong Date: Tue, 2 Jun 2026 23:06:27 +0800 Subject: [PATCH] =?UTF-8?q?docs(timer):=20=E8=A1=A5=E5=85=85=E5=AE=9A?= =?UTF-8?q?=E6=97=B6=E5=99=A8=E6=8A=80=E8=83=BD=E6=96=87=E6=A1=A3=20-=20ex?= =?UTF-8?q?ecute=20=E6=97=A5=E5=BF=97=E5=8C=85=E8=A3=B9=E6=9C=BA=E5=88=B6?= =?UTF-8?q?=E8=AF=B4=E6=98=8E=E4=B8=8E=E6=9C=AC=E5=9C=B0=E5=BC=80=E5=8F=91?= =?UTF-8?q?=E5=B8=B8=E8=A7=81=E5=9D=91=E4=BD=8D?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .agents/skills/ulthon-timer/SKILL.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/.agents/skills/ulthon-timer/SKILL.md b/.agents/skills/ulthon-timer/SKILL.md index df9c202..d3fcfe4 100644 --- a/.agents/skills/ulthon-timer/SKILL.md +++ b/.agents/skills/ulthon-timer/SKILL.md @@ -211,9 +211,10 @@ site 任务会按站点域名发起请求，默认从 `sysconfig('site','site_do ## 常见坑位（快速自检） -- `name` 重复：会导致 Cache key 冲突，表现为任务“莫名其妙不跑/跑得不对” +- `name` 重复：会导致 Cache key 冲突，表现为任务"莫名其妙不跑/跑得不对" - `concurrency` 与控制器侧 `$concurrency` 不一致：会触发 `concurrency id/count error` - 只依赖控制器侧 `$frequency`：它只是防刷，不是调度；调度频率以定时器侧 Cache 节流为准 +- 本地开发忘记 `--local`：`site` 任务默认请求 `sysconfig('site','site_domain')` 指向的生产域名，不带 `--local` 会直接打到线上 ## 多节点协调 @@ -246,7 +247,7 @@ site 任务会按站点域名发起请求，默认从 `sysconfig('site','site_do ### 执行日志 -`TimerControllerBase` 提供 `logStart()` / `logEnd()` 方法记录执行日志。`host_id` 会自动注入到 site 任务的 URL 参数中，用于标识执行节点。 +`TimerControllerBase::execute()` 自动包裹 `do()` 并调用 `logStart()` / `logEnd()` 记录执行日志，开发者无需手动调用。配置中写 `/do`，运行时 `TimerServiceBase` 自动重写为 `/execute` 以触发日志包裹。`host_id` 会自动注入到 site 任务的 URL 参数中，用于标识执行节点。 ### 管理后台