MessageWeave

Author SHA1 Message Date

Author	SHA1	Message	Date
anonsaber	f9889288ba	docs: 同步 /worker 进 safelist（17 -> 18 条），cron 示例收敛到单一域名 - deployment.md：§6.3.1 两条端点都可直接打 Worker 域名，手动 curl 与 crontab、 k8s CronJob 示例去掉 WORKER_ORIGIN 只留 APP_URL，-m 分别给 320s / 300s（要略大于 LB 侧 per-route 超时，否则 curl 先掐掉一个本来能完成的排空）；§10.4 safelist 18 条并补 /worker、不在 safelist 的从 3 类减为 2 类；LB_WORKER_TIMEOUT_MS 补进 secret put 清单与 §10.9 变量表；测试计数 35 -> 37（index 12 -> 14） - README.md：路由白名单 17 -> 18 条、/worker 入列、LB_WORKER_TIMEOUT_MS 补进变量表与配置片段、/reconcile 例外段落扩成 /reconcile + /worker 两条长超时 - charter.md / reference.md：17 -> 18 条、Safe Routes 16 -> 18 entries - cron-drain.sh：MW_WORKER_URL 由「必须指源站直连地址」改为「可选，默认走平台域名」； 404 route not forwarded 的提示改为 LB 版本太旧（需 >= 2026.10.3），升级或绕过 LB 顺手修正 6 处已漂移的行号锚点（此前指向空行或已迁移的文件）： backends.js:10-28 -> 10-30、index.js:47-65 -> 54-73、index.js:76-78 -> 87-91、 index.js:87-89 -> 95-96、index.js:93 -> 105、src/index.js:138 -> src/lb.js:155 （x-lb-backend 的 catch 在 `656034d` 修不可变响应头时已迁到 lb.js，文档一直指旧文件）。 GATE-DOCS PASS（115 line-refs / 477 path-refs / 252 section-refs，0 error）。	2026-09-30 23:08:57 +08:00
anonsaber	fae37b35bc	chore(ops): scripts/cron-drain.sh 加可执行位，便于直接 ./ 调用	2026-09-30 22:29:45 +08:00
anonsaber	b9b7114fd3	feat(ops): scripts/cron-drain.sh，外部调度脚本，参数全走环境变量后端没有内部调度器（C-NO-LONG-CONN），消费出站队列的唯一入口是 POST /worker，增量对账的唯一入口是 POST /reconcile，两者都必须外部触发。没有这一步，新邮件会一直堆在 stalwart:jmap，一行通知都不会发出来。 - 一次触发做两步：先 /reconcile 再 /worker，顺序不可反 - 两个端点成功码都是 204 且响应体为空；401/409/503 各给明确提示 - 503 时把服务端的 Retry-After 一并打进日志，cron 侧不用自己猜 - MW_WORKER_URL 单独可配：/worker 不在 LB 白名单内，走 LB 会 404，脚本会点出来 - --diagnose 走 /debug/：配置是否保存、chat_id 是否占位值、webhook secret、 Redis/JMAP/Telegram 依赖可达性、游标是否还停在 null - --test-notify 绕过队列复用生产出站路径直发一条：这条能收到，问题一定在调度 - 凭据只从 MW_ 环境变量读，不读 .env、不写文件，日志不含 token - --once / --loop；MW_BATCH（服务端上限 10，超出提示）、MW_LOG_FILE、MW_TIMEOUT - 退出码 0/1/2 二值，失败步数看日志行数	2026-09-30 22:24:41 +08:00

anonsaber

f9889288ba

docs: 同步 /worker 进 safelist（17 -> 18 条），cron 示例收敛到单一域名

- deployment.md：§6.3.1 两条端点都可直接打 Worker 域名，手动 curl 与 crontab、
  k8s CronJob 示例去掉 WORKER_ORIGIN 只留 APP_URL，-m 分别给 320s / 300s（要略大于
  LB 侧 per-route 超时，否则 curl 先掐掉一个本来能完成的排空）；§10.4 safelist
  18 条并补 /worker、不在 safelist 的从 3 类减为 2 类；LB_WORKER_TIMEOUT_MS 补进
  secret put 清单与 §10.9 变量表；测试计数 35 -> 37（index 12 -> 14）
- README.md：路由白名单 17 -> 18 条、/worker 入列、LB_WORKER_TIMEOUT_MS 补进
  变量表与配置片段、/reconcile 例外段落扩成 /reconcile + /worker 两条长超时
- charter.md / reference.md：17 -> 18 条、Safe Routes 16 -> 18 entries
- cron-drain.sh：MW_WORKER_URL 由「必须指源站直连地址」改为「可选，默认走平台域名」；
  404 route not forwarded 的提示改为 LB 版本太旧（需 >= 2026.10.3），升级或绕过 LB

顺手修正 6 处已漂移的行号锚点（此前指向空行或已迁移的文件）：
backends.js:10-28 -> 10-30、index.js:47-65 -> 54-73、index.js:76-78 -> 87-91、
index.js:87-89 -> 95-96、index.js:93 -> 105、src/index.js:138 -> src/lb.js:155
（x-lb-backend 的 catch 在 656034d 修不可变响应头时已迁到 lb.js，文档一直指旧文件）。
GATE-DOCS PASS（115 line-refs / 477 path-refs / 252 section-refs，0 error）。

2026-09-30 23:08:57 +08:00

anonsaber fae37b35bc chore(ops): scripts/cron-drain.sh 加可执行位，便于直接 ./ 调用 2026-09-30 22:29:45 +08:00

anonsaber

b9b7114fd3

feat(ops): scripts/cron-drain.sh，外部调度脚本，参数全走环境变量

后端没有内部调度器（C-NO-LONG-CONN），消费出站队列的唯一入口是 POST /worker，
增量对账的唯一入口是 POST /reconcile，两者都必须外部触发。没有这一步，新邮件
会一直堆在 stalwart:jmap，一行通知都不会发出来。

- 一次触发做两步：先 /reconcile 再 /worker，顺序不可反
- 两个端点成功码都是 204 且响应体为空；401/409/503 各给明确提示
- 503 时把服务端的 Retry-After 一并打进日志，cron 侧不用自己猜
- MW_WORKER_URL 单独可配：/worker 不在 LB 白名单内，走 LB 会 404，脚本会点出来
- --diagnose 走 /debug/*：配置是否保存、chat_id 是否占位值、webhook secret、
  Redis/JMAP/Telegram 依赖可达性、游标是否还停在 null
- --test-notify 绕过队列复用生产出站路径直发一条：这条能收到，问题一定在调度
- 凭据只从 MW_* 环境变量读，不读 .env、不写文件，日志不含 token
- --once / --loop；MW_BATCH（服务端上限 10，超出提示）、MW_LOG_FILE、MW_TIMEOUT
- 退出码 0/1/2 二值，失败步数看日志行数

2026-09-30 22:24:41 +08:00

3 Commits