From 3917b96e7159ee0f16d081fc4a1755791077797d Mon Sep 17 00:00:00 2001 From: anonsaber Date: Wed, 30 Sep 2026 22:24:53 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=C2=A74.1=20/=20=C2=A76.3.1=20=E6=8C=87?= =?UTF-8?q?=E5=90=91=20scripts/cron-drain.sh?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 「为什么收不到 Telegram」的答案分两层：调度没跑（外部 cron 问题），还是配置或 凭据问题。§4.1 第三步和 §6.3.1 各加一段指向新脚本，并说明 --diagnose 与 --test-notify 两个开关分别用来区分这两种情况。 顺带核对过 §6.3.1 的状态码表与 src/notify.rs 实际契约一致：/reconcile 成功是 204（401/409/503+Retry-After），/worker 成功是 204（400/401/503），RECONCILE_ INITIAL_CHANGES=100 在 notify.rs:294，/worker batch 上限 MAX=10 在 notify.rs:407， 行号锚点全部准确。 GATE-DOCS 6/6（PATH 475 -> 477）。 --- docs/deployment.md | 16 ++++++++++++++-- 1 file changed, 14 insertions(+), 2 deletions(-) diff --git a/docs/deployment.md b/docs/deployment.md index afeac0a..d802535 100644 --- a/docs/deployment.md +++ b/docs/deployment.md @@ -199,8 +199,8 @@ curl -fsS -X POST "https://<你的平台URL>/api/push/register" \ **第三步：排空（`POST /worker`）** 前两步只负责把事件送进队列。把邮件从队列取出来并发成 Telegram 消息，靠外部 cron 周期性 -调用 `POST /worker` 完成——见 §6.3.1。**缺这一步，邮件会持续积压在 `stalwart:jmap`， -一行通知都不会发出来。** +调用 `POST /worker` 完成——见 §6.3.1（仓库内有现成脚本 `scripts/cron-drain.sh`，参数全走 +环境变量）。**缺这一步，邮件会持续积压在 `stalwart:jmap`，一行通知都不会发出来。** **验证**：群内发 `/help`，`/worker` 排空后应收到自动回复（入站方向）；给自己发一封新邮件， 排空后应收到该邮件通知（出站方向）。 @@ -423,6 +423,18 @@ token 轮换后**无需重启**——worker 处理函数开头先 `refresh_busin `/worker` 不在 Worker 转发白名单里（`SAFE_ROUTES`：`/reconcile` 在内、`/worker` 不在）， 走 Worker 会被 404 `route not forwarded` 挡掉，必须打后端 origin。见 §10.4。 +不想自己拼 curl 的话，仓库里有现成脚本 `scripts/cron-drain.sh`：两步都做了，参数全部走 +环境变量（`MW_APP_URL` / `MW_WORKER_URL` / `MW_RECONCILE_TOKEN` / `MW_WORKER_TOKEN` +等），凭据不写任何文件。两个额外开关专门用来回答「为什么没收到 Telegram」： + +- `--diagnose`：依次查 `/api/status`、`/debug/config`（配置是否保存、chat_id 是否为占位值、 + webhook secret 是否配置）、`/debug/redis`、`/debug/telegram`（bot token 是否有效）、 + `/debug/jmap`、`/debug/worker`（游标是否还停在 null）。配置问题会直接点出来，不用猜。 +- `--test-notify`：绕过队列直接走生产出站路径发一条测试消息。这条能收到，说明 + token/chat_id/allowlist 全对，问题一定在调度；收不到，问题就在这一层，跟 cron 无关。 + +诊断端点需要后端以 `--debug` 启动并设置 `MW_DEBUG_TOKEN`，且必须直连 origin。 + 最小示例（手动烟测，打印状态码；`/reconcile` **不接受请求体**，游标存在服务端 Redis 里）： ```bash