功能矩陣與維護狀態 (Feature Matrix)

解決風險: 功能膨脹可能導致維護困難

本文檔提供 Boring-Gemini 所有功能的完整視圖，包括穩定性狀態、依賴關係、以及維護責任分配。

---

📊 功能狀態概覽

┌─────────────────────────────────────────────────────────────────────────────┐
│                         功能生命週期 (Feature Lifecycle)                     │
├─────────────────────────────────────────────────────────────────────────────┤
│                                                                              │
│   🧪 Experimental ──► 🔵 Beta ──► ✅ Stable ──► ⚠️ Deprecated ──► ❌ Removed  │
│                                                                              │
│   實驗性功能        測試中       穩定可用       已棄用          已移除        │
│   (可能隨時變更)    (謹慎使用)   (生產就緒)    (將在下版移除)   (已刪除)       │
│                                                                              │
└─────────────────────────────────────────────────────────────────────────────┘

---

🧠 Code Intelligence (代碼智能)

功能	狀態	版本引入	依賴	維護者	說明
RAG Search	✅ Stable	v10.0	chromadb, sentence-transformers	@Boring206	語義代碼搜索
RAG Index	✅ Stable	v10.0	tree-sitter	@Boring206	代碼索引建立
Brain Manager	✅ Stable	v10.26	SQLite	@Boring206	模式學習與記憶
Vector Memory	❌ Removed	v10.0	chromadb	@Boring206	向量記憶存儲 (Moved to RAG)
Pattern Mining	🔵 Beta	v10.28	-	@Boring206	模式挖掘
Predictive Analyzer	🔵 Beta	v14.0	-	@Boring206	錯誤預測 (AI Bisect)
Adaptive Cache	🧪 Experimental	v11.2	-	@Boring206	智能快取預熱
GraphRAG	✅ Stable	v11.3	chromadb, networkx	@Boring206	依賴圖視覺化

依賴關係圖

Vector Memory ◄─── RAG Search
      │                 │
      ▼                 ▼
   ChromaDB ◄─── sentence-transformers

Brain Manager ◄─── Pattern Mining
      │                 │
      ▼                 ▼
   SQLite     ◄─── Memory Manager

---

✅ Quality Assurance (品質保證)

功能	狀態	版本引入	依賴	維護者	說明
Vibe Check	✅ Stable	v10.15	LLM Provider	@Boring206	遊戲化代碼審查
Code Review	✅ Stable	v10.15	LLM Provider	@Boring206	AI 代碼審查
Test Generation	✅ Stable	v10.20	LLM Provider	@Boring206	測試自動生成
Security Scan	✅ Stable	v10.10	bandit, pip-audit	@Boring206	安全掃描
Verify	✅ Stable	v10.5	-	@Boring206	自動驗證修復
Judge/Evaluate	🔵 Beta	v10.26	LLM Provider	@Boring206	LLM 評分
Perf Tips	🔵 Beta	v11.0	LLM Provider	@Boring206	性能建議

---

🔄 Workflow Automation (工作流自動化)

功能	狀態	版本引入	依賴	維護者	說明
Shadow Mode	✅ Stable	v10.8	Git	@Boring206	安全預覽模式
Smart Commit	✅ Stable	v10.5	Git	@Boring206	智能提交訊息
Checkpoint	✅ Stable	v10.31	Git	@Boring206	安全還原點
Session Management	✅ Stable	v10.20	-	@Boring206	人機對齊工作流
Multi-Agent	🔵 Beta	v10.25	-	@Boring206	多代理協作
Background Agent	🧪 Experimental	v10.30	Threading	@Boring206	後台任務
Workflow Evolver	🧪 Experimental	v11.0	-	@Boring206	工作流進化
Global Brain	✅ Stable	v11.3	Git, JSON	@Boring206	跨專案知識共享
Skills Autonomy	✅ Stable	v11.3	Skills Catalog	@Boring206	Agent 技能管理

---

🏗️ Infrastructure (基礎設施)

功能	狀態	版本引入	依賴	維護者	說明
MCP Server	✅ Stable	v10.0	fastmcp	@Boring206	核心 MCP 服務
Tool Router	✅ Stable	v10.15	-	@Boring206	自然語言路由
Plugin System	✅ Stable	v10.20	-	@Boring206	插件擴展系統
Workspace Manager	✅ Stable	v10.10	-	@Boring206	多專案管理
SpecKit	✅ Stable	v10.28	LLM Provider	@Boring206	規格驅動開發
HTTP API	🔵 Beta	v10.25	starlette	@Boring206	REST API
Web Monitor	🧪 Experimental	v10.30	streamlit	@Boring206	Web 監控面板
Diagnostic Engine	✅ Stable	v14.0	-	@Boring206	深度診斷 (Doctor)
Offline Mode	✅ Stable	v14.0	llama-cpp-python	@Boring206	離線優先架構
VSCode Server	🧪 Experimental	v11.0	-	@Boring206	VSCode 整合

---

🤖 LLM Providers (語言模型提供者)

Provider	狀態	版本引入	依賴	說明
Gemini	✅ Stable	v10.0	google-genai	主要支援
Ollama	✅ Stable	v10.20	ollama (optional)	本地模型
OpenAI Compatible	🔵 Beta	v11.0	openai (optional)	通用適配器
Claude	🧪 Experimental	v11.2	-	Anthropic 整合
LMStudio	🧪 Experimental	v11.0	-	本地推理

功能降級矩陣

當某個 Provider 不可用時的降級策略：

功能	Gemini 不可用	全部 LLM 不可用
RAG Search	✅ 正常 (僅 Embedding)	⚠️ 僅關鍵字搜索
Vibe Check	🔄 切換到 Ollama	❌ 功能禁用
Smart Commit	🔄 切換到 Ollama	⚠️ 傳統 Git 訊息
Shadow Mode	✅ 正常 (Git 操作)	✅ 正常
Security Scan	✅ 正常 (Bandit)	✅ 正常
Brain Manager	✅ 正常 (SQLite)	✅ 正常

---

📦 安裝配置檔 (Installation Profiles)

Profile	包含功能	目標用戶
Core (default)	CLI, Git, Basic Tools	所有用戶
mcp-lite	Core + MCP Server	Smithery 部署
mcp	mcp-lite + Vector Search	本地全功能
vector	Core + RAG + ChromaDB	RAG 專用
gui	Core + Streamlit Dashboard	視覺化用戶
dev	Core + Testing + Linting	開發者
all	完整功能	功能測試

---

⚠️ 棄用功能 (Deprecated Features)

功能	棄用版本	移除計劃	替代方案
boring.memory.LoopMemory (舊路徑)	v10.26	v12.0	boring.intelligence.memory
boring.vector_memory (根目錄)	v10.26	v12.0	boring.intelligence.vector_memory
mcp/vibe_tools.py (舊入口)	v10.26	v12.0	mcp/tools/vibe.py
mcp/v10_tools.py (舊入口)	v10.26	v12.0	mcp/tools/*.py
JSON Brain Storage	v11.2	v13.0	SQLite Brain Manager

---

🔀 功能依賴圖 (全局)

                              ┌─────────────────┐
                              │   LLM Provider  │
                              │ (Gemini/Ollama) │
                              └────────┬────────┘
                                       │
           ┌───────────────────────────┼───────────────────────────┐
           ▼                           ▼                           ▼
   ┌───────────────┐          ┌───────────────┐          ┌───────────────┐
   │  Vibe Coder   │          │  Judge/Eval   │          │  Smart Commit │
   └───────┬───────┘          └───────────────┘          └───────────────┘
           │
           ▼
   ┌───────────────┐
   │ Brain Manager │◄──────────┐
   └───────┬───────┘           │
           │                   │
           ▼                   │
   ┌───────────────┐    ┌──────┴──────┐
   │    SQLite     │    │Pattern Miner│
   └───────────────┘    └─────────────┘

   ┌───────────────┐
   │  RAG System   │
   └───────┬───────┘
           │
   ┌───────┴───────┐
   ▼               ▼
┌───────┐   ┌─────────────────┐
│ChromaDB│  │sentence-transformers│
└───────┘   └─────────────────┘

   ┌───────────────┐
   │  MCP Server   │
   └───────┬───────┘
           │
   ┌───────┴───────┐
   ▼               ▼
┌───────┐   ┌───────────┐
│FastMCP │  │  Starlette │
└───────┘   └───────────┘

---

📈 維護優先級

高優先級 (P0) - 核心功能

• MCP Server
• Tool Router
• Shadow Mode
• Brain Manager

中優先級 (P1) - 重要功能

• RAG System
• Vibe Coder
• Plugin System
• LLM Providers

低優先級 (P2) - 擴展功能

• Web Monitor
• Predictive Analyzer
• Workflow Evolver

---

🎯 功能簡化策略

為防止功能膨脹，我們遵循以下原則：

1. 核心最小化: 核心包只包含必要功能
2. 可選擴展: 進階功能通過 extras 安裝
3. 插件優先: 新功能優先作為插件實現
4. 定期審查: 每季度審查實驗性功能
5. 勇於移除: 6 個月無活躍使用的功能將被棄用

---

最後更新: 2026-01-15 | 版本: 14.0.0