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|

` 的日誌格式跑得很穩，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 天，日更不間斷。*