# 功能矩陣與維護狀態 (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*
