docs: record knowledge signal chips rollout [skip ci]

This commit is contained in:
Your Name
2026-06-03 02:28:39 +08:00
parent 87e1ab2987
commit 1f3b871e28

View File

@@ -1,3 +1,37 @@
## 2026-06-03Knowledge 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-03Knowledge Base 視覺摘要與真分類治理落地
**背景**:統帥要求前端不能只堆大量文字,必須用圖、表、專業資訊架構讓使用者快速理解產品狀態。本輪接續前端 UI/UX 與素材治理,先處理 production 上的 `/zh-TW/knowledge-base`:讓知識庫首頁不是單純列表,而是用真 API 資料呈現摘要、分類分佈與資料品質線索。