# 項目可持續性策略 (Sustainability Strategy)
> **解決風險**: 單一維護者的可持續性風險、功能膨脹、技術棧依賴
本文檔說明 Boring-Gemini 項目的可持續發展策略，確保項目長期健康發展。
---
## 🎯 可持續性願景
```
┌─────────────────────────────────────────────────────────────────────────────┐
│ 🌱 可持續性三大支柱 │
├─────────────────────────────────────────────────────────────────────────────┤
│ │
│ ┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐ │
│ │ 👥 人員彈性 │ │ 🔧 技術彈性 │ │ 📦 架構彈性 │ │
│ │ (Bus Factor) │ │ (Tech Agnostic) │ │ (Modularity) │ │
│ └────────┬────────┘ └────────┬────────┘ └────────┬────────┘ │
│ │ │ │ │
│ • 多維護者 • LLM 抽象層 • 插件系統 │
│ • 完善文檔 • 可選依賴 • 最小核心 │
│ • 自動化 CI/CD • 降級策略 • 清晰邊界 │
│ │
└─────────────────────────────────────────────────────────────────────────────┘
```
---
## 🚨 風險識別與緩解
### 風險 1: 單一維護者 (Bus Factor = 1)
**當前狀態**: ⚠️ 高風險
**影響**: 如果主要維護者無法繼續，項目可能停滯
**緩解策略**:
| 策略 | 行動 | 狀態 |
|------|------|------|
| **文檔完整** | 所有架構決策都有文檔記錄 | ✅ 已實施 |
| **自動化** | CI/CD 全自動化，減少人工干預 | ✅ 已實施 |
| **維護者招募** | 創建 MAINTAINERS.md，明確貢獻階梯 | ✅ 已實施 |
| **領域專家** | 在 CODEOWNERS 中定義領域負責人 | ✅ 已實施 |
| **決策記錄** | ADR (Architecture Decision Records) | 🔄 進行中 |
| **知識轉移** | 錄製關鍵系統的說明視頻 | 📅 計劃中 |
---
### 風險 2: 功能膨脹 (Feature Creep)
**當前狀態**: ⚠️ 中等風險
**影響**: 維護成本增加，代碼質量下降
**緩解策略**:
| 策略 | 行動 | 狀態 |
|------|------|------|
| **功能矩陣** | 維護 feature-matrix.md | ✅ 已實施 |
| **模組化安裝** | extras: `[mcp]`, `[vector]`, `[gui]` | ✅ 已實施 |
| **插件優先** | 新功能優先作為插件 | ✅ 已實施 |
| **定期審查** | 季度功能審查會議 | 📅 計劃中 |
| **棄用流程** | 明確的功能生命週期 | ✅ 已實施 |
---
### 風險 3: 技術棧強依賴 (Vendor Lock-in)
**當前狀態**: ⚠️ 中等風險
**緩解策略**:
| 策略 | 行動 | 狀態 |
|------|------|------|
| **LLM 抽象** | `src/boring/llm/provider.py` 介面 | ✅ 已實施 |
| **多 Provider** | Gemini, Ollama, OpenAI, Claude | ✅ 已實施 |
| **降級機制** | 功能在依賴不可用時優雅降級 | ✅ 已實施 |
| **本地優先** | 支持完全離線使用 (Ollama) | ✅ 已實施 |
---
## 📊 健康指標
| 指標 | 目標 | 當前 | 狀態 |
|------|------|------|------|
| Bus Factor | ≥ 2 | 1 | 🟡 招募中 |
| 測試覆蓋率 | ≥ 60% | 60% | ✅ |
| 文檔覆蓋率 | ≥ 80% | ~80% | ✅ |
| 開放 Issues | < 50 | ~20 | ✅ |
| PR 響應時間 | < 7 天 | ~2 天 | ✅ |
| 依賴過期數 | 0 | 0 | ✅ |
| 安全漏洞 | 0 高/中 | 0 | ✅ |
---
## 🔗 相關文檔
- [維護者指南](./contributing_zh.md)
- [功能矩陣](feature-matrix.md)
- [LLM 適配器指南](llm-adapters.md)
- [貢獻指南](./contributing_zh.md)
---
*最後更新: 2026-01-12*
