diff --git a/docs/LOGBOOK.md b/docs/LOGBOOK.md index 6667b6b07..cb297c592 100644 --- a/docs/LOGBOOK.md +++ b/docs/LOGBOOK.md @@ -1,3 +1,37 @@ +## 2026-06-03|Knowledge Base 列表訊號 Chips 與 Raw Tags 收合落地 + +**背景**:統帥繼續要求前端頁面不要只堆文字、也不要像資料庫 dump。上一輪 Knowledge Base 已補摘要與真分類分佈;production 驗證後仍可見 `human_approved`、`execution_failed`、`human_intervention` 等 raw tags 直接出現在列表,對操作員不夠友善。 + +**本次調整**: +- `Knowledge Base` 列表卡片新增 `訊號` chips:已知 tags 轉為繁中狀態,例如 `human_approved` → `人工批准`、`execution_failed` → `執行失敗`、`human_intervention` → `人工介入`、`warning` → `警告`、`critical` → `嚴重`。 +- 列表最多顯示 3 個訊號,剩餘以 `+N` 收斂,避免卡片再次變成文字牆。 +- 冗餘 tags 會過濾掉:已在類別、類型、來源顯示的 `general / infrastructure / ai_system / postmortem` 等,不再重複出現在訊號列。 +- 詳情 panel 新增 `證據訊號` 區塊;完整 raw tags 改放進預設收合的 `原始技術標籤` details,保留工程追查能力但不干擾一般閱讀。 +- 日期顯示改用頁面 locale,避免手機或瀏覽器預設語系把日期格式顯示成英文區域格式。 + +**本機驗證**: +- `cmp -s apps/web/messages/zh-TW.json apps/web/messages/en.json` 通過。 +- `git diff --check` 通過。 +- `pnpm --dir apps/web exec tsc --noEmit --tsBuildInfoFile /tmp/kb-signal-chips-20260603.tsbuildinfo` 通過。 +- `NEXT_PUBLIC_API_URL=https://awoooi.wooo.work NEXT_PRIVATE_BUILD_WORKER_COUNT=1 pnpm --filter @awoooi/web build` 通過;KB route size `53.1 kB`。 +- 本機 production server:`http://127.0.0.1:3047/zh-TW/knowledge-base` Browser DOM 驗證 overview labels 存在、`horizontalOverflow=0`;390px Playwright 驗證 `horizontalOverflow=0`、`canScrollVertical=true`。 + +**正式部署**: +- Code commit:`8cb4af36 fix(web): clarify knowledge base signal chips`。 +- Gitea code-review run:`3594` / run number `2488` / success。 +- Gitea CD run:`3593` / run number `2487` / tests success、build-and-deploy success、post-deploy-checks success。 +- Deploy marker:`87e1ab29 chore(cd): deploy 8cb4af3 [skip ci]`。 + +**正式驗證**: +- Health:`https://awoooi.wooo.work/api/v1/health` → `status=healthy`、`environment=prod`、`mock_mode=false`、`version=1.0.0`。 +- Production 桌機:`https://awoooi.wooo.work/zh-TW/knowledge-base?_v=8cb4af3-kb-signal-prod` 顯示 `訊號` chips;已知 raw tags 未直接出現在列表;`原始技術標籤` 在詳情 panel 預設收合;`horizontalOverflow=0`。 +- Production 手機 390px:`hasSignalLabel=true`、`hasTranslatedSignals=true`、`hasKnownRawTagLeak=false`、`horizontalOverflow=0`、`canScrollVertical=true`。 + +**進度更新**: +- Knowledge Base 產品化可讀性由 `50%` 上修至 `56%`。 +- 前端設計系統 / i18n / 素材治理由 `51%` 上修至 `52%`。 +- 首頁產品化入口維持 `80%`;AwoooP/HITL 維持 `99.2%`;完整 AI 自動化飛輪仍維持約 `66%`,本輪仍是前端資訊架構與可讀性治理,沒有新增 AI 自動修復能力。 + ## 2026-06-03|Knowledge Base 視覺摘要與真分類治理落地 **背景**:統帥要求前端不能只堆大量文字,必須用圖、表、專業資訊架構讓使用者快速理解產品狀態。本輪接續前端 UI/UX 與素材治理,先處理 production 上的 `/zh-TW/knowledge-base`:讓知識庫首頁不是單純列表,而是用真 API 資料呈現摘要、分類分佈與資料品質線索。