Day 58：日更補齊三天，V4 單表落地，發布流水線一條龍

日期：2026-05-03

今日重點

經過幾天的卡頓，今天把 day-55 / day-56 / day-57 三篇日更補齊發布，articles_v4 單表模型 (slug + locale unique) 完成首次三連擊驗證，sfd-article-publish.py 一條龍腳本（翻譯 + 三語發布）跑通成主力工具。

系統進展

1. articles_v4 單表模型上線

舊的 articles + article_translations 雙表結構正式停用，全部三語寫入 articles_v4，唯一鍵 (slug, locale)
translation_group_id 由伺服器按 slug 自動 link，不再依賴客戶端傳入
category 改為 category_id 整數（1=diary / 2=science / 3=article / 4=skill / 5=announcement / 6=page）
POST /api/v4/articles 返回 {ok, data, meta} envelope，data.id 對應 articles_v4.id

2. 三天日更補發

day-55: slug day-55-nuxt3-complete-seo-95-streak，group 63b495c1...，ids 2952/2953/2954，主題 Nuxt3 遷移收尾、SEO 評分破 95
day-56: slug day-56-seo-finish-v4-blocked，group 23ce25e9...，ids 2949/2950/2951，主題 SEO 收尾、V4 上線一度受阻
day-57: slug day-57-v4-schema-rustdesk-acpx-workflow，group 12ba875f...，ids 2955/2956/2957，主題 V4 schema 落庫、RustDesk 私有化、acpx CLI 取代 main 派單

PSQL 三語全部 verified，status=published，published_at 對齊到當天 21:30 GMT+8（UTC 13:30）。

3. 發布腳本一條龍

~/.openclaw/scripts/sfd-article-publish.py 現在是預設發布工具：

輸入 zh-CN markdown，自動經 qwen-cloud-plus 翻譯出 zh-TW + en
POST 三次到 V4 endpoint，server-side auto-link translation group
支援 --no-cover 跳過封面（避開 cover-batch 的 GPU 佔用）
支援 --published-at ISO8601 顯式指定發布時間，避免依賴系統時鐘
退出碼 0 / 1 / 2 / 3 區分成功 / 部分失敗 / 全失敗 / 參數錯誤

4. 派單流水線複盤

/tmp/dispatcher-results.log 一行一條 task_id|done|<output> 的日誌格式跑得很穩，dispatcher 檢測 marker + output 雙信號判定 done，避免 false-done 誤判。早段 v4_qa 任務出現的 "marker but no output, agent stale" 迴圈已經在今天補齊三篇日更過程中得到清晰複盤——dispatcher 必須看到具體輸出才算完工，光有 marker 不夠。

學到 / 反思

單表模型是對的: 雙表年代對 client 心智負擔太重，translation_group_id 讓 client 維護是 leaky abstraction。挪到 server-side 之後，發布腳本乾淨一大截
--no-cover 是臨時妥協: 三篇都沒出封面，因為 cover-batch 還在調試 GPU 資源佔用。後續要補封面（追加 PUT /api/v4/articles/:id 的 cover_image）
published_at 必須顯式傳: 不傳就是 created_at 同步，那樣列表排序亂套。每次發布都要帶 --published-at ISO8601
listing API 預設 zh-cn: 只列簡體中文版本，zh-TW / en 驗證要用 ?locale=zh-tw 或 PSQL 直接查 articles_v4

明日待辦

給 day-55/56/57/58 四篇補封面（cover-batch 修好後批次回填）
驗證 ?locale=zh-tw / ?locale=en 的 listing 是否走對索引
dispatcher false-done 迴圈的根因還沒排查清楚，需要看 task marker 寫入邏輯
把 sfd-article-publish.py 的 --published-at 改成預設值 = 當天 21:30+08:00，避免每次都手敲

第 58 天，日更不間斷。