docs: Phase 14 紅區治理 + Skills 01/03 更新
- CLAUDE.md: 紅區治理章節 - Skills 01/03: 版本更新 - ADR/Architecture: 標準化 Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
OG T
@@ -3,7 +3,7 @@
|
||||
> **專案名稱 (Project)**: AWOOOI
|
||||
> **行動代號 (Operation)**: Operation Phoenix Rising (原 Cyber-Shell)
|
||||
> **文件狀態 (Status)**: Active Development
|
||||
> **建檔日期 (Date)**: 2026-03-19 (更新: 2026-03-20)
|
||||
> **建檔日期 (Date)**: 2026-03-19 (更新: 2026-03-25)
|
||||
|
||||
本文件記錄了 AWOOOI 系統從零到一的關鍵架構決策與防禦性實作（防雷紀錄），作為未來技術團隊接手、擴展與稽核的最高指導原則。
|
||||
(This document records the key architectural decisions and defensive implementations of the AWOOOI system from zero to one, serving as the supreme guiding principle for future technical teams' handover, scaling, and auditing.)
|
||||
@@ -65,16 +65,57 @@
|
||||
|
||||
---
|
||||
|
||||
## Phase 6: 架構硬化 (Horizontal Scaling / 規劃中)
|
||||
## Phase 6: 架構硬化 ✅ (2026-03-23 完成)
|
||||
|
||||
| 核心模組與檔案 (Core Modules) | 首席架構師拍板的「關鍵決策與排雷紀錄」 (Architect's Key Decisions & Pitfall Avoidance) |
|
||||
| :--- | :--- |
|
||||
| **Redis 狀態持久化**<br>`multi_sig_redis.py` (規劃中) | 將 `MultiSigEngine` 從 In-Memory 遷移至 Redis Hash，支援分散式部署與 7 天 TTL 稽核保留。導入 Redlock 演算法實現分散式鎖。<br>*(Migrate `MultiSigEngine` from In-Memory to Redis Hash for distributed deployment. Implement Redlock algorithm for distributed locking.)* |
|
||||
| **Neo4j 圖資料庫**<br>`graph_rag_neo4j.py` (規劃中) | 將 `TopologyGraph` 遷移至 Neo4j，支援複雜的 Blast Radius 與 Root Cause 圖遍歷查詢。解決大型叢集的效能瓶頸。<br>*(Migrate `TopologyGraph` to Neo4j for complex Blast Radius and Root Cause graph traversal queries. Resolve performance bottlenecks in large clusters.)* |
|
||||
| **SSE 容錯驗證**<br>`dashboard.store.ts` | 驗證 ADR-004 定義的企業級 SSE 實作：Exponential Backoff (1s→30s)、Heartbeat (30s)、Buffer 批次更新 (5s)。<br>*(Validate ADR-004 enterprise SSE implementation: Exponential Backoff, Heartbeat, Buffer batch updates.)* |
|
||||
| **水平擴展**<br>K8s Service + Redis Pub/Sub | 實作 SSE 多實例廣播 (Redis Pub/Sub) 與 Sticky Session，確保用戶連線一致性。<br>*(Implement SSE multi-instance broadcast via Redis Pub/Sub and Sticky Session for connection consistency.)* |
|
||||
| **Redis 狀態持久化**<br>`multi_sig_redis.py` ✅ | 將 `MultiSigEngine` 從 In-Memory 遷移至 Redis Hash，支援分散式部署與 7 天 TTL 稽核保留。導入 Redlock 演算法實現分散式鎖。 |
|
||||
| **Event Bus**<br>`redis_streams.py` ✅ | Redis Streams 事件匯流排，支援告警信號傳遞與 Consumer Group 消費。 |
|
||||
| **雙層記憶系統**<br>`dual_memory.py` ✅ | Working Memory (Redis) + Episodic Memory (PostgreSQL) 雙層同步架構。 |
|
||||
| **SSE 容錯驗證**<br>`useApprovalSSE.ts` ✅ | 驗證 ADR-004 企業級 SSE 實作：Exponential Backoff、Heartbeat、Buffer 批次更新。 |
|
||||
|
||||
**來源**: `docs/ARCHITECTURE_CODE_REVIEW.md` 技術債審查 (2026-03-22)
|
||||
---
|
||||
|
||||
## Phase 7-10: 視覺主權與生產強化 ✅ (2026-03-21 ~ 23)
|
||||
|
||||
| 核心模組與檔案 (Core Modules) | 首席架構師拍板的「關鍵決策與排雷紀錄」 (Architect's Key Decisions & Pitfall Avoidance) |
|
||||
| :--- | :--- |
|
||||
| **GlobalPulseChart**<br>`global-pulse-chart.tsx` | 4 指標卡片 + Sparkline，Nothing.tech 純白工業風，真實 API 數據整合。 |
|
||||
| **AIProcessStepper**<br>`ai-process-stepper.tsx` | 5 步 AI 決策流程視覺化，支援即時狀態更新。 |
|
||||
| **Sentry 整合**<br>`sentry.client.config.ts` | Self-Hosted 192.168.0.110:9000 + Tunnel 避免內網權限對話框。 |
|
||||
| **OpenClaw Agent Teams**<br>`agent_teams.py` | 多專家共識決策 (Security/BlastRadius/ActionPlanner)，加權投票機制。 |
|
||||
| **Worker 獨立部署**<br>`awoooi-worker` | API/Worker Pod 分離，避免 Event Bus 阻塞影響 API 響應。 |
|
||||
|
||||
---
|
||||
|
||||
## Phase 11: 對話式 AI UI/UX ✅ (2026-03-25)
|
||||
|
||||
| 核心模組與檔案 (Core Modules) | 首席架構師拍板的「關鍵決策與排雷紀錄」 (Architect's Key Decisions & Pitfall Avoidance) |
|
||||
| :--- | :--- |
|
||||
| **ConversationalView**<br>`conversational-view.tsx` | ChatGPT 風格雙欄佈局，左側列表 + 右側詳情，SSE 即時更新整合。 |
|
||||
| **BatchModeSelector**<br>`batch-mode-selector.tsx` | 批次處理模式 (全部接受/逐一審核/CRITICAL Only)，CRITICAL/DESTRUCTIVE 安全過濾。 |
|
||||
| **useKeyboardShortcuts**<br>`useKeyboardShortcuts.ts` | Y/N 長按 2 秒 + 頂部進度條，防止誤觸。方向鍵導航 + Esc 取消。 |
|
||||
| **SSE 即時更新**<br>`useApprovalSSE.ts` | Polling → SSE 改造，減少伺服器壓力，即時推送 Approval 狀態變更。 |
|
||||
|
||||
---
|
||||
|
||||
## Phase 12: Ollama 深度整合 ✅ (2026-03-25)
|
||||
|
||||
| 核心模組與檔案 (Core Modules) | 首席架構師拍板的「關鍵決策與排雷紀錄」 (Architect's Key Decisions & Pitfall Avoidance) |
|
||||
| :--- | :--- |
|
||||
| **Tool Calling 優化**<br>`parse_operation_from_action()` | 24 測試案例 (英/中/混合)，準確率 80% → 100%，支援中文指令解析。 |
|
||||
| **ModelRouter**<br>`model_router.py` | 動態模型選擇，依複雜度路由到不同模型 (llama3.2:3b / qwen2.5:7b / qwen2.5:14b)。 |
|
||||
| **本地模型優化**<br>`qwen2.5:7b-instruct` | 192.168.0.188 (62GB RAM)，Benchmark: qwen2.5 29s vs llama3.2 69s。 |
|
||||
|
||||
---
|
||||
|
||||
## Phase 13: Enterprise AIOps 🟡 (2026-03-25 規劃)
|
||||
|
||||
| 核心模組與檔案 (Core Modules) | 首席架構師拍板的「關鍵決策與排雷紀錄」 (Architect's Key Decisions & Pitfall Avoidance) |
|
||||
| :--- | :--- |
|
||||
| **CI/CD 整合** (13.1)<br>`github_webhook_handler.py` | Git Push/CI 失敗 → AI 審查診斷。風險分級自動修復 (LOW/MEDIUM 可自動，HIGH/CRITICAL 人工)。 |
|
||||
| **Tool 實作** (13.2)<br>`mcp_bridge.py` | **P0 最優先** - Mock → 真實連接 (SignOz/K8s/PostgreSQL/RAG)，打通 AI 與外部系統。 |
|
||||
| **智能路由** (13.3)<br>`ai_router.py` | Intent Classifier + Complexity Scorer + 動態模型選擇，小模型判別意圖 (< 100ms)。 |
|
||||
|
||||
---
|
||||
|
||||
|
||||
Reference in New Issue
Block a user