fix(knowledge): classify assets and fail soft list readback
Some checks failed
CD Pipeline / workflow-shape (push) Successful in 0s
CD Pipeline / cancel-stale-cd (push) Has been skipped
CD Pipeline / build-and-deploy (push) Has been cancelled
CD Pipeline / post-deploy-checks (push) Has been cancelled
CD Pipeline / tests (push) Has been cancelled

This commit is contained in:
Your Name
2026-07-03 09:00:42 +08:00
parent cc5b508ac5
commit 77daf55cdd
7 changed files with 266 additions and 75 deletions

View File

@@ -53942,3 +53942,26 @@ production browser smoke:
**下一步**
- commit / push 聚合告警修正;再套用新版 Prometheus rule確認 `BackupAlertReceiptStageMissing` pending/firing 數量聚合成 110 / 188 host-level summary而不是逐 stage 噪音。
## 2026-07-03 — Knowledge Base 資產分類與 AI 自動化資訊架構
**完成內容**
- `/zh-TW/knowledge-base` 左側分類從單一 API category 清單提升為「資產維度 + 動態分類」雙層 IA新增可點選過濾的專案、產品、網站、服務、套件、工具、Log / 事件、Alert / 告警、PlayBook、RAG / 向量、MCP / Connector、排程 / Worker。
- 新增 `entryMatchesAssetLens` 與固定 taxonomy hints先用 title / category / entry_type / source / tags / playbook 關聯完成 UI 分群,不等待後端 schema 先改完;後續可把同一 taxonomy 回寫到 ingest/tagger。
- 左側新增目前分類範圍摘要與清除按鈕,避免使用者只看到「基礎設施 / 應用層 / AI 系統 / 安全」少數粗分類而誤判 KM 資料不完整。
- `KnowledgeListResponse` 新增 `readback_status / operator_stage / next_step / writes_on_read / manual_review_required``KnowledgeService.list_entries` 讀取失敗時改回 `readback_status=degraded``operator_stage=knowledge_readback_degraded_ai_controlled_repair` 與空 items不再讓 `/api/v1/knowledge` 間歇性 500 使前端誤判 KM 歸零。
- 前端收到 degraded 會顯示「知識條目讀取降級」KPI 不把 0 當真實完成值,並保留 AI 受控修復隊列與 RAG / PlayBook readback。
**本地驗證結果**
- `python3 -m json.tool apps/web/messages/zh-TW.json``python3 -m json.tool apps/web/messages/en.json`:通過。
- `pnpm --dir apps/web typecheck`:通過。
- `DATABASE_URL=postgresql+asyncpg://test:test@localhost/test PYTHONPATH=apps/api python3.11 -m pytest apps/api/tests/test_knowledge_service_readback_degraded.py apps/api/tests/test_knowledge_repository_read_model.py -q -p no:cacheprovider``5 passed`
- `python3.11 -m py_compile apps/api/src/models/knowledge.py apps/api/src/services/knowledge_service.py apps/api/tests/test_knowledge_service_readback_degraded.py`:通過。
**仍維持**
- 沒有讀 secret / token / `.env` / raw sessions / SQLite / auth。
- 沒有使用 GitHub / gh / GitHub API / GitHub Actions。
- 沒有重啟主機,沒有 Docker / Nginx / K3s / DB / firewall restart沒有 workflow_dispatch沒有 DROP / TRUNCATE / restore / prune。
**下一步**
- 跑 web build、UI density、runner pressure guard 與 Knowledge Base desktop / mobile smoke通過後 commit / push 到 Gitea main等 deploy marker 再驗證正式頁面顯示新的資產分類與主知識 API fail-soft。