docs(logbook): record knowledge base asset gap rollout [skip ci]

This commit is contained in:
Your Name
2026-06-26 21:10:45 +08:00
parent ae6e68ac50
commit 4b0514def5
2 changed files with 44 additions and 3 deletions

View File

@@ -1,3 +1,43 @@
## 2026-06-26D1D Knowledge Base 首屏補強KM / PlayBook / RAG 缺口可見化
**背景**:使用者指出 KM、PlayBook、腳本、排程、自動化機制與 Verifier 沉澱結果在頁面看不到,會讓 AI 自動化成果等於沒有做。正式 API 讀回確認知識庫並非無資料:`/api/v1/knowledge?project_id=awoooi&limit=50``total=667`;真正問題是首屏沒有把「哪些資產有沉澱、哪些仍缺」說清楚,且 `/api/v1/knowledge/rag/stats` 顯示 RAG chunks / sources 仍為 `0 / 0`
**完成內容**
- `/zh-TW/knowledge-base``KM 自動化掌控台` 增加 `RAG 索引` 決策卡,直接顯示語意檢索索引是否沉澱。
- `自動化資產沉澱總帳` 新增 `RAG / 向量索引` 一格,和 KM、PlayBook、腳本 / Ansible、排程 / 監控規則、Verifier 回寫並列。
- 保留既有 KM 條目、owner review、stale ratio、品質軌道、引用鏈、陳舊處理佇列與 Work Items 接續狀態。
- 不觸發 RAG indexing、不寫 KM、不 approve / archive、不提高 PlayBook trust、不送 Telegram、不開 runtime gate。
**Commit / deploy**
- Code commit`4309c02eb fix(web): surface knowledge RAG asset gap`
- Deploy marker`ae6e68ac5 chore(cd): deploy 4309c02 [skip ci]`
**正式 API 讀回**
- `/api/v1/knowledge?project_id=awoooi&limit=50``total=667`,前 50 筆正常回傳。
- `/api/v1/ai/governance/km-stale-candidates?project_id=awoooi&limit=5``total_stale=645``manual_review_required=true``writes_on_read=false`
- `/api/v1/ai/governance/km-stale-owner-reviews?project_id=awoooi&dispatch_status=pending&limit=5``total=10`
- `/api/v1/ai/governance/km-stale-owner-review-burndown?project_id=awoooi&limit=5``stale_ratio=0.967``threshold=0.2``entries_to_threshold=512`
- `/api/v1/knowledge/rag/stats``total_chunks=0``sources=0`
**正式站驗證**
- Desktop`https://awoooi.wooo.work/zh-TW/knowledge-base?_v=ae6e68ac-kb-rag-gap-desktop``667``645``Owner Review 10``RAG 索引 0``RAG / 向量索引``自動化資產沉澱總帳` 可見;`horizontalOverflow=false``tablists=0``appError=false`
- Mobile 首次 smoke 曾遇到主 KM 條目 API `502`,治理軌道仍顯示但列表數字暫為 0重測 `https://awoooi.wooo.work/zh-TW/knowledge-base?_v=ae6e68ac-kb-mobile-retest-2` 後正常顯示 `667``645``Owner Review 10``RAG 索引 0`,無 502`horizontalOverflow=false`
- 截圖:`/tmp/awoooi-kb-rag-gap-desktop-ae6e68ac.png``/tmp/awoooi-kb-mobile-retest-ae6e68ac.png`
**完成度**
- IA-D1D Knowledge Base 自動化資產缺口前移:正式站 `100%`
- Knowledge / PlayBook 沉澱可視化:`20% -> 28%`
- 全站 UI / UX 專業化:維持 `42%`
- 真正 AI 自動化 runtime 閉環:仍 `15-25%`
**後續缺口**
- RAG index 仍 `0 / 0`,必須另開安全排程 / 索引任務,而不是在讀取頁面時寫入。
- 需要把 PlayBook trust、腳本 / Ansible、排程 / 監控規則、Verifier 實體 ID、owner 與下一步下鑽補齊到 Work Items / Runs / Knowledge Base。
- Mobile 首次 502 顯示資料鏈仍有瞬時不穩,應在後續補 retry / stale cache / partial hydration resilience。
**邊界**
- 本段沒有寫入 KM、沒有索引 RAG、沒有 approve / archive、沒有修改 PlayBook trust、沒有發 Telegram、沒有 runtime execution。
## 2026-06-26D1C Observability runtime gate 真相修復:只讀 API 不再誤算為自動執行授權
**背景**:正式站 `/zh-TW/observability` 已把主機、專案、網站前後台、服務、套件、工具、監控訊號與 AI Agent 決策鏈集中成總覽、矩陣、拓樸、流程、訊號合約、健康缺口與下鑽入口;但頁面首屏把 `read_only_api_allowed=true` 誤算進 runtime gate造成 `執行閘門 2` / `自動執行授權 2` 的假性訊號。這會讓使用者以為 AI runtime 已可自動執行,與正式 API 邊界不符。

View File

@@ -1,8 +1,8 @@
# AWOOOI IA / UIUX 重整盤點與整合推進清單
日期2026-06-26台北時間
基線:`gitea/main=54b50a337 chore(cd): deploy 83d7d86 [skip ci]`
狀態D0 盤點完成D1 全域導航 shell 已完成第一段正式部署手機版改為抽屜式導航D1B Tenants 資產 cockpit 已正式部署,將所有網站 / 專案 / 產品的判讀矩陣前移並收合長明細D1C Observability 已修正 runtime gate 真相計數,正式站顯示 `執行閘門 0` / `自動執行授權 0`;後續仍需逐頁整併舊 route / tabs / 大量文字頁。
基線:`gitea/main=ae6e68ac5 chore(cd): deploy 4309c02 [skip ci]`
狀態D0 盤點完成D1 全域導航 shell 已完成第一段正式部署手機版改為抽屜式導航D1B Tenants 資產 cockpit 已正式部署,將所有網站 / 專案 / 產品的判讀矩陣前移並收合長明細D1C Observability 已修正 runtime gate 真相計數,正式站顯示 `執行閘門 0` / `自動執行授權 0`D1D Knowledge Base 已把 KM / PlayBook / 腳本 / 排程 / Verifier / RAG 資產缺口前移到首屏;後續仍需逐頁整併舊 route / tabs / 大量文字頁。
## 0. 這次先校正方向
@@ -84,7 +84,7 @@
| AwoooP 操作台產品化 | `68%` | `55%` | Work Items / Runs / Approvals 資料有,但還不像完整自動化控制台。 |
| Tenants 全產品資產中心 | `68%` | `72%` | 已把 16 產品 / 專案、31 網站 / 服務入口、10 來源範圍與 57 可視資產前移成決策支援矩陣;明細預設收合。 |
| Observability 專業拓樸 / 告警中心 | `38%` | `32%` | 已把主機、專案、網站、服務、套件、工具、訊號拓樸、告警流程與下鑽入口集中到 `/observability`,並修正 read-only API 誤算 runtime gate 的問題;仍需補真正告警漏斗、噪音治理與 AI 修復閉環。 |
| Knowledge / PlayBook 沉澱可視化 | `34%` | `20%` | 使用者看不到 KM、PlayBook、腳本、排程、Verifier 的完整沉澱。 |
| Knowledge / PlayBook 沉澱可視化 | `34%` | `28%` | `/knowledge-base` 已顯示 667 筆 KM、645 stale、Owner Review 10、RAG 索引 0並把 KM / PlayBook / 腳本 / 排程 / Verifier / RAG 納入首屏資產總帳;仍需補 PlayBook trust、腳本、排程、Verifier 實體 ID 與可追蹤下鑽。 |
| Code Review / Release Safety Gate | `58%` | `35%` | 還沒把所有產品 pre / post deploy gate 與惡意程式碼防護做成產品化流程。 |
| 真正 AI 自動化 runtime 閉環 | `60-64%` | `15-25%` | 目前大量告警仍停在 owner review / manual required不可再用治理卡假性拉高。 |
@@ -179,6 +179,7 @@
| IA-D0-002 | Canonical route map | `AwoooProductShell` / sidebar / command palette 共用資料來源設計 | 完成草案 |
| IA-D0-003 | PageTabs 去留清單 | 第 3 節轉成實作 issue / checklist | 完成 |
| IA-D1C-001 | Observability runtime gate 真相修復 | read-only API 不再被算成自動執行授權;正式站 `執行閘門 0` / `自動執行授權 0` | 完成 |
| IA-D1D-001 | Knowledge Base 自動化資產缺口前移 | 首屏顯示 KM、PlayBook、腳本、排程、Verifier、RAG正式站顯示 KM 667、stale 645、Owner Review 10、RAG 0 | 完成 |
| IA-D0-004 | 優先頁視覺骨架 | Situation / Flow / Matrix / Topology / Evidence / Action component spec | 進行中Tenants 已套用 Matrix / Drilldown |
| IA-D1-001 | 導航實作 | Sidebar、手機抽屜、breadcrumb、context links、legacy route redirect plan | 部分完成Sidebar / 手機抽屜正式站 100%breadcrumb / redirect 待做 |
| IA-D1-002 | Tenants 全產品資產 cockpit | 全域資產判讀矩陣、收合明細、正式站 desktop / mobile smoke | 完成 |