Kotlin MCP Server

🚀 企業級Kotlin Android MCP服務器

這是一個全面的模型上下文協議（MCP）服務器，為AI智能體提供企業級訪問基於Kotlin的Android開發項目的能力。該服務器能夠提供上下文感知的協助，並具備高級安全、隱私合規、AI集成和全面的開發工具。

---

📋 修訂歷史

版本2.1 (當前 - 2025年8月)

增強版發佈：統一智能服務器

🎯 最新改進

• 🧠 智能工具管理：所有27個工具現在都使用具有類似LSP功能的智能代理系統。
• 🔄 服務器整合：統一為單個kotlin_mcp_server.py文件，架構得到增強。
• 📁 簡潔架構：歸檔冗餘的服務器版本，使項目結構更清晰。
• ⚡ 增強工具暴露：完整的工具套件通過智能管理系統正確暴露。
• 🛠️ 改進工具路由：在原生實現和智能代理之間實現智能委託。

🔧 架構變更

• 統一服務器：單個kotlin_mcp_server.py文件取代了多個服務器版本。
• 智能代理系統：未完全實現的工具使用帶有AI增強的智能代理。
• 簡潔文件結構：舊版服務器歸檔在archive/legacy-servers/目錄中。
• 增強工具管理器：與IntelligentMCPToolManager集成，具備高級功能。
• 完整工具覆蓋：所有32個工具都正確暴露並可正常使用。

📊 工具實現狀態

• 完全實現：6個工具（format_code、run_lint、generate_docs、create_compose_component、setup_mvvm_architecture、security_hardening）
• 舊版集成：3個核心工具（create_kotlin_file、gradle_build、analyze_project）
• 智能代理：23個工具具有智能回退實現。
• 可用總數：32個工具，全面覆蓋Android開發。

版本2.0 (2025年8月)

重大版本發佈：AI增強的模塊化架構

🎯 關鍵改進

• 🤖 AI集成：從模板生成器轉變為AI驅動的開發助手。
• 🏗️ 模塊化架構：將單體結構重構為6個專門的模塊。
• 🌍 動態配置：消除所有硬編碼路徑，實現跨平臺可移植性。
• ⚡ 增強工具：工具數量從30個擴展到31個，並具有AI增強實現。
• 🛡️ 安全強化：添加可配置的審計跟蹤和合規監控。
• 📦 零配置設置：智能安裝程序可自動檢測環境。

🔧 技術變更

• 模塊化設計：拆分為ai/、android/、gradle/、security/、testing/、utils/模塊。
• AI驅動的代碼生成：利用調用大語言模型生成可投入生產的代碼（無TODO）。
• 環境變量支持：所有配置現在都使用動態環境變量。
• 跨平臺路徑：通用的~符號取代特定於操作系統的硬編碼路徑。
• 增強錯誤處理：全面驗證和優雅的故障恢復。
• 性能優化：通過更好的資源管理簡化工具執行。

📊 遷移影響

• 工具：從30個增加到32個工具（功能等效性達到107%並有所增強）。
• 文件大小：優化的模塊化結構與單體方法相比更優。
• 配置：無需手動配置路徑。
• 兼容性：與現有設置保持完全向後兼容。

版本1.0 (舊版 - 2025年8月之前)

初始版本發佈：基於模板的代碼生成器

• ✅ 帶有30個工具的基本MCP服務器
• ✅ 基於模板的Kotlin/Android代碼生成
• ✅ 手動配置，使用硬編碼路徑
• ✅ 單體架構
• ✅ 基本的安全和合規功能

---

🌟 企業級特性概述

🔒 安全與隱私合規

• GDPR合規 - 完整實現，包括同意管理、數據可移植性、刪除權。
• HIPAA合規 - 醫療級安全，包括審計日誌、訪問控制、加密。
• 數據加密 - 使用AES - 256加密和PBKDF2密鑰派生對敏感數據進行加密。
• 審計跟蹤 - 全面的日誌記錄，帶有合規標誌和安全事件跟蹤。
• 隱私設計 - 所有操作都內置隱私保護。

🤖 AI/ML集成

• 本地大語言模型支持 - 支持Ollama、LocalAI和自託管的變換器。
• 外部大語言模型API - 支持OpenAI GPT - 4、Anthropic Claude和自定義端點。
• AI驅動的代碼分析 - 進行安全、性能和複雜性分析。
• 智能代碼生成 - 上下文感知的Kotlin/Android代碼創建。
• ML模型集成 - 為Android應用集成TensorFlow Lite、ONNX、PyTorch Mobile。

📁 高級文件管理

• 企業級文件操作 - 備份、恢復、同步、加密、解密，並帶有審計跟蹤。
• 即時同步 - 使用文件系統監視器實現自動同步。
• 雲存儲集成 - 與AWS S3、Google Cloud、Azure集成，提供端到端加密。
• 智能文件分類 - 自動檢測和加密敏感數據。
• 版本控制 - 支持Git操作，具備衝突解決功能。

🌐 外部API集成

• 全面的認證支持 - 支持API密鑰、OAuth 2.0、JWT、基本認證。
• 安全特性 - 速率限制、請求日誌記錄、響應驗證。
• 即時監控 - 監控API使用指標、性能跟蹤、成本分析。
• 合規驗證 - 符合GDPR/HIPAA的API處理。

🏗️ 高級Android開發

• 架構模式 - MVVM、簡潔架構、依賴注入。
• 現代UI開發 - Jetpack Compose、自定義視圖、複雜佈局。
• 數據庫集成 - 集成Room並支持加密和遷移處理。
• 網絡層 - 支持Retrofit、GraphQL、WebSocket。
• 測試框架 - 全面的測試生成和執行。

---

🚀 快速開始與安裝

✨ 升級到V2.0的亮點

🤖 AI增強開發：現在利用AI助手生成可投入生產的代碼，而不是基本模板！

升級前 (V1.0)：

• ❌ 基於模板的代碼，帶有TODO佔位符。
• ❌ 在配置文件中手動編輯路徑。
• ❌ 單體架構（單個大文件）。
• ❌ 硬編碼路徑和特定於用戶的配置。
• ❌ 30個基本工具，AI集成有限。

升級後 (V2.0)：

• ✅ AI驅動的代碼生成：完整的、上下文感知的實現。
• ✅ 零配置設置：python3 install.py命令可處理所有配置。
• ✅ 模塊化架構：簡潔、可維護的6模塊結構。
• ✅ 動態配置：跨平臺，使用環境變量。
• ✅ 31個增強工具：集成AI，具備智能錯誤處理。

📋 系統要求

• Python 3.8+（推薦3.9+）
• pip（Python包管理器）
• Git（用於克隆倉庫）
• 支持MCP的IDE（VS Code、JetBrains IDE、Claude Desktop）

🔧 安裝步驟

1. 克隆倉庫

git clone <your-repo-url>
cd kotlin-mcp-server

2. 自動化安裝與配置

項目包含一個增強的安裝腳本，可自動處理所有配置：

# 交互式安裝（推薦首次使用的用戶）
python3 install.py

# 非交互式安裝，使用特定配置
python3 install.py [install_type] [project_path] [server_name] [use_env_vars]

# 顯示所有可用選項
python3 install.py --help

安裝類型：

• 1 - 便攜版：直接從項目目錄運行。
• 2 - 系統版：將命令安裝到PATH中（kotlin-android-mcp）。
• 3 - 模塊版：啟用python -m kotlin_mcp_server。

配置示例：

# 交互式設置（詢問您的偏好）
python3 install.py 1

# 便攜版，指定您的Android項目路徑（替換為實際路徑）
python3 install.py 1 ~/AndroidStudioProjects/MyApp

# 系統安裝，使用動態環境變量
python3 install.py 2 none my-android-server true

# 模塊安裝，使用自定義服務器名稱
python3 install.py 3 /path/to/project kotlin-dev false

安裝程序的功能：

• ✅ 安裝所有Python依賴項：從requirements.txt文件中安裝。
• ✅ 創建特定於平臺的配置文件：（Claude、VS Code、通用）
• ✅ 設置正確的文件權限：為腳本設置權限。
• ✅ 配置環境變量：根據您的選擇進行配置。
• ✅ 消除手動路徑更新：在配置文件中無需手動更新路徑。
• ✅ 提供清晰的集成說明：為您的設置提供準確的集成步驟。

3. 手動安裝（可選）

如果您更喜歡手動安裝：

# 安裝核心依賴項
pip install -r requirements.txt

# 可選：安裝AI/ML依賴項以使用高級功能
pip install openai anthropic transformers torch

# 驗證安裝
python3 -c "import kotlin_mcp_server; print('✅ 安裝成功')"

已安裝的關鍵依賴項：

• 核心MCP：python-dotenv、pydantic
• 安全：cryptography、bcrypt、PyJWT
• 數據庫：aiosqlite、sqlalchemy
• HTTP客戶端：aiohttp、httpx
• 文件管理：aiofiles、watchdog
• 測試：pytest、pytest-asyncio、coverage
• 代碼質量：black、flake8、pylint、mypy
• 安全工具：bandit、safety

4. V2.0架構與工具增強

🏗️ 模塊化架構設計

V2.0版本引入了簡潔、可維護的模塊化結構：

kotlin-mcp-server/
├── kotlin_mcp_server.py      # 主服務器（32個AI增強工具）
├── ai/
│   ├── llm_integration.py    # AI助手集成
│   └── code_enhancement.py   # AI驅動的代碼生成
├── android/
│   ├── project_manager.py    # 項目結構管理  
│   └── manifest_utils.py     # Android清單操作
├── gradle/
│   ├── build_system.py       # Gradle構建自動化
│   └── dependency_manager.py # 依賴解析
├── security/
│   ├── compliance.py         # GDPR/HIPAA合規
│   └── encryption.py         # 數據保護
├── testing/
│   └── test_generator.py     # 自動化測試創建
└── utils/
    ├── file_operations.py    # 增強文件管理
    └── security.py           # 審計跟蹤和日誌記錄

🤖 AI增強工具能力

工具類別	V1.0（模板）	V2.0（AI增強）
代碼生成	帶有TODO的基本模板	可投入生產的、上下文感知的實現
架構模式	骨架代碼	完整的MVVM、簡潔架構模式
UI組件	靜態佈局	帶有業務邏輯的動態Jetpack Compose
數據庫操作	模式模板	帶有遷移的完整Room實現
測試	測試存根	包含邊緣情況的全面測試套件
安全	基本驗證	具備合規性的企業級安全

⚡ 性能與可靠性改進

• 31個工具（V1.0版本為30個），AI集成增強。
• 錯誤恢復：優雅處理AI服務中斷。
• 上下文感知：工具能夠理解項目結構和需求。
• 資源優化：高效的內存使用和更快的執行速度。
• 跨平臺支持：通用配置系統。

5. IDE集成設置

安裝完成後，腳本會生成可直接使用的配置文件：

• mcp_config_claude.json - 用於Claude Desktop。
• mcp_config_vscode.json - 用於VS Code和Cursor。
• mcp_config.json - 用於其他MCP客戶端。

集成說明：

🔹 Claude Desktop：將mcp_config_claude.json的內容複製到：

• Mac：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json
• Linux：~/.config/claude/claude_desktop_config.json

🔹 VS Code/Cursor：添加到您的VS Code settings.json中：

{
  "mcp.server.configFiles": [
    "/absolute/path/to/mcp_config_vscode.json"
  ]
}

🔹 其他IDE：使用mcp_config.json與您的MCP客戶端集成。

5. 環境配置（高級）

對於需要自定義環境設置的高級用戶： 在項目根目錄下創建一個.env文件（僅在高級配置時需要）：

# 複製示例文件並進行自定義
cp .env.example .env

# 使用您喜歡的編輯器進行編輯
nano .env  # 或使用其他編輯器

可選變量：

# 安全（生成強密碼）
MCP_ENCRYPTION_PASSWORD=$(openssl rand -base64 32)
COMPLIANCE_MODE=gdpr,hipaa

# 可選：AI集成
OPENAI_API_KEY=your-openai-api-key-here
ANTHROPIC_API_KEY=your-anthropic-api-key-here

💡 注意：安裝腳本會自動配置項目路徑和服務器設置，因此手動環境配置僅在需要高級功能（如AI集成或自定義安全設置）時才需要。

6. 安裝所需的IDE擴展/插件

請參閱下面的插件要求部分，瞭解特定於IDE的擴展。

7. 測試安裝

# 使用您配置的設置測試服務器
# 如果您在安裝過程中使用了固定的項目路徑：
python3 kotlin_mcp_server.py

# 如果您使用的是動態/環境變量：
python3 kotlin_mcp_server.py /path/to/android/project

# 對於系統安裝：
kotlin-android-mcp

# 對於模塊安裝：
python3 -m kotlin_mcp_server

# 驗證配置（可選）
python3 validate_config.py

# 運行全面測試（可選）
python test_mcp_comprehensive.py

# 測試VS Code橋接服務器（可選）
python3 vscode_bridge.py &
sleep 2
curl http://localhost:8080/health
# 應返回：{"status": "healthy", ...}
kill %1  # 停止後臺橋接服務器

⚡ 快速設置命令

# 一鍵完成設置（交互式）
python3 install.py

# 為開發環境快速設置
make setup-dev

# 快速驗證
make dev-check

# 完整質量管道
make ci

# 測試VS Code橋接服務器（可選）
python3 vscode_bridge.py --test-mode

🎯 安裝總結

增強的安裝過程消除了手動配置的需要：

✅ 之前（手動）：用戶必須手動編輯配置文件、查找路徑、更新環境變量。 ✅ 之後（自動化）：一個命令即可創建所有可直接使用的配置。

關鍵改進：

• 🚀 零手動配置：無需再更新路徑或編輯變量。
• 🎛️ 交互式和非交互式：適用於所有用戶的兩種模式。
• 🔧 特定於平臺的配置：為每個IDE/客戶端生成優化的文件。
• 📋 清晰的說明：為您的設置提供準確的集成步驟。
• ✨ 智能默認值：智能處理環境變量。

🐳 Docker部署（可選）

對於容器化部署，項目提供了全面的Docker支持：

快速Docker設置

# 1. 驗證Docker配置
python3 validate_docker.py

# 2. 使用設置腳本構建並運行
./docker-setup.sh build
./docker-setup.sh start

# 3. 或者直接使用Docker Compose
docker-compose up -d kotlin-mcp-server

Docker特性

• 🔒 安全：使用非root用戶，最小化攻擊面。
• 📦 優化：多階段構建，層緩存。
• 🔍 健康檢查：自動監控容器健康狀況。
• 🛠️ 開發：支持卷掛載，便於即時開發。
• 🚀 生產：支持守護模式，用於生產部署。

可用命令

./docker-setup.sh build              # 構建鏡像
./docker-setup.sh start              # 交互式開發
./docker-setup.sh daemon [path]      # 生產守護模式
./docker-setup.sh logs               # 查看容器日誌
./docker-setup.sh shell              # 打開容器shell
./docker-setup.sh test               # 在容器中運行測試
./docker-setup.sh clean              # 清理資源

有關詳細的Docker設置說明，請參閱DOCKER_SETUP.md

---

🎯 實戰驗證：生成真實的Android應用

準備好見證系統生成完整的、可投入生產的Android應用了嗎？ 按照以下步驟，體驗完整的端到端工作流程：

🚀 快速開始：生成您的第一個應用

# 1. 構建Kotlin邊車（創建胖JAR）
make sidecar

# 2. 生成具有所有功能的完整Android應用
make e2e

# 3. 您的APK文件將出現在這裡：
ls -la e2e/sampleapp/app/build/outputs/apk/debug/app-debug.apk

您將獲得：

• ✅ 完整的Gradle項目（Kotlin、Compose、Hilt、MVVM）
• ✅ 可運行的Android應用，包含主屏幕和詳情屏幕。
• ✅ Room數據庫，包含實體和DAO。
• ✅ Retrofit網絡層，包含API服務。
• ✅ 單元測試通過（Robolectric + JVM測試）
• ✅ 可在設備/模擬器上安裝的APK

🔧 可用命令

# 構建Kotlin邊車JAR
make sidecar

# 生成完整的Android應用
make e2e

# 格式化和優化代碼
make fix

# 運行detekt靜態分析
make detekt

# 運行spotless代碼格式化檢查
make spotless

# 清理所有工件
make clean

📊 生成應用的特性

生成的e2e/sampleapp應用包含：

🏗️ 架構：

• MVVM模式，使用ViewModel。
• Hilt依賴注入。
• 遵循簡潔架構原則。

🎨 UI/UX：

• Jetpack Compose屏幕。
• Material3設計。
• 屏幕間導航。

💾 數據層：

• Room數據庫，包含實體。
• 存儲庫模式。
• 遷移骨架。

🌐 網絡：

• Retrofit API客戶端。
• OkHttp攔截器。
• 錯誤處理。

🧪 測試：

• ViewModel的單元測試。
• 使用Robolectric進行DAO測試。
• API服務測試。

📱 構建：

• 生成調試APK。
• 進行Lint/格式化檢查。
• 優化Gradle構建。

⚙️ 環境變量

# 邊車配置
MCP_SIDECAR_CMD=["java", "-jar", "kotlin-sidecar/build/libs/kotlin-sidecar.jar"]

# 性能調優
MCP_API_TIMEOUT_MS=3000
MCP_RATE_LIMIT_QPS=10

# 構建設置
ANDROID_SDK_ROOT=/path/to/android/sdk
JAVA_HOME=/path/to/jdk17

🔍 故障排除

Gradle構建失敗：

# 確保安裝了Android SDK並設置了ANDROID_SDK_ROOT
export ANDROID_SDK_ROOT=/path/to/android/sdk

# 清理並重新構建
make clean && make e2e

邊車連接問題：

# 檢查JAR文件是否已構建
ls -la kotlin-sidecar/build/libs/kotlin-sidecar.jar

# 直接測試邊車
java -jar kotlin-sidecar/build/libs/kotlin-sidecar.jar

APK未生成：

# 檢查構建日誌
cd e2e/sampleapp && ./gradlew assembleDebug --info

# 確保使用的是JDK 17
java -version  # 應顯示Java 17

📈 性能基準

系統針對以下方面進行了優化：

• 邊車啟動：< 2秒
• 代碼生成：每個組件< 5秒
• 構建時間：調試APK< 30秒
• 測試執行：單元測試< 10秒

🎉 成功指標

當一切正常時：

• ✅ kotlin-sidecar.jar成功構建。
• ✅ e2e/sampleapp目錄創建，包含完整項目。
• ✅ ./gradlew assembleDebug無錯誤完成。
• ✅ APK文件存在：app/build/outputs/apk/debug/app-debug.apk。
• ✅ ./gradlew testDebugUnitTest測試通過。
• ✅ 生成的代碼中沒有TODO佔位符。
• ✅ 所有Lint/格式化檢查通過。

🎯 生成的應用可投入生產，可立即在Android Studio中打開！

---

🏥 從V1.0遷移到V2.0

⚡ 快速遷移步驟

如果您已經安裝了V1.0版本：

1. 備份當前設置：

   # 備份您現有的配置
   cp mcp_config*.json ~/backup/
   

2. 更新到V2.0：

   # 拉取最新更改
   git pull origin main
   
   # 運行V2.0安裝程序
   python3 install.py 1
   

3. 驗證遷移：

   # 測試新的模塊化架構
   python3 -c "from kotlin_mcp_server import KotlinMCPServer; print('✅ V2.0就緒！')"
   

🔍 自動遷移的內容

• ✅ 所有30個原始工具：保留並增強了AI功能。
• ✅ 配置文件：使用動態環境變量進行更新。
• ✅ 項目路徑：轉換為跨平臺格式。
• ✅ 依賴項：更新到最新版本。
• ✅ 安全設置：增強了新的合規功能。

⚠️ 遷移注意事項

• 向後兼容性：V2.0與V1.0項目結構保持完全兼容。
• 增強輸出：代碼生成現在生成完整的實現，而不是模板。
• 新環境變量：可選的新配置選項（請參閱.env.example）。
• 模塊化結構：內部架構得到改進（無需用戶操作）。

---

🏗️ 項目根目錄解析策略

概述

Kotlin MCP服務器中的所有工具都經過重構，僅在用戶的項目工作區中運行，而不會在MCP服務器的當前工作目錄中運行。這確保了工具行為的安全性和可預測性，防止意外修改項目外的文件。

路徑解析優先級

工具按以下順序解析項目根目錄：

1. 顯式輸入：project_root或projectRoot參數。
2. 環境變量：PROJECT_PATH或WORKSPACE_PATH。
3. IDE元數據：從MCP客戶端（VS Code、Cursor等）獲取的工作區根目錄。
4. 故障安全：工具將報錯，而不會使用服務器的當前工作目錄。

輸入同義詞

工具接受駝峰命名法和蛇形命名法的參數名稱：

// 兩種格式的效果相同
{
  "project_root": "/path/to/project",
  "file_path": "src/main.kt",
  "build_tool": "gradle",
  "skip_tests": false
}

{
  "projectRoot": "/path/to/project", 
  "filePath": "src/main.kt",
  "buildTool": "gradle",
  "skipTests": false
}

IDE集成默認值

使用IDE擴展（VS Code、Cursor）時，工具會自動檢測：

• 工作區根目錄：活動工作區目錄。
• 活動文件：當前打開的文件，用於基於文件的操作。
• 選擇內容：文本選擇，用於重構操作。

安全保障

• 路徑遍歷保護：所有文件路徑都經過驗證，確保在項目根目錄下。
• 服務器當前工作目錄保護：運行時檢查，防止意外操作服務器目錄。
• 審計日誌：所有工具操作都記錄項目上下文。

工具調用示例

顯式指定項目根目錄：

{
  "tool": "buildAndTest",
  "input": {
    "project_root": "/Users/dev/MyAndroidApp",
    "buildTool": "gradle",
    "skipTests": false
  }
}

使用環境變量：

export PROJECT_PATH=/Users/dev/MyAndroidApp
# 不指定project_root的工具調用將使用環境變量

IDE自動檢測：

{
  "tool": "analyzeCodeQuality",
  "input": {
    "scope": "project",
    "ruleset": "all"
  }
}
// 自動使用活動工作區

錯誤處理

當無法解析項目根目錄時，工具會提供清晰的錯誤信息：

{
  "success": false,
  "error": "ProjectRootRequired: pass `project_root` or set env PROJECT_PATH",
  "error_type": "ProjectRootRequired"
}

---

📚 全面使用指南

🛠 完整工具參考

Kotlin MCP服務器為Android開發提供了31個全面的工具，按類別組織：

核心開發工具

1. gradle_build - 構建Android項目

執行Gradle構建任務，用於您的Android項目。

{
  "name": "gradle_build",
  "arguments": {
    "task": "assembleDebug",
    "clean_build": false,
    "parallel": true
  }
}

參數：

• task（字符串）：要執行的Gradle任務（例如，"assembleDebug"、"build"、"test"）
• clean_build（布爾值，可選）：是否在構建前清理。
• parallel（布爾值，可選）：是否啟用並行執行。

使用示例：

# 構建調試APK
{"name": "gradle_build", "arguments": {"task": "assembleDebug"}}

# 清理並構建發佈版
{"name": "gradle_build", "arguments": {"task": "assembleRelease", "clean_build": true}}

# 運行所有測試
{"name": "gradle_build", "arguments": {"task": "test"}}

2. run_tests - 執行測試套件

運行單元測試、集成測試或UI測試，並提供全面的報告。

{
  "name": "run_tests",
  "arguments": {
    "test_type": "unit",
    "test_class": "UserRepositoryTest",
    "generate_report": true
  }
}

參數：

• test_type（字符串）："unit"、"integration"、"ui"或"all"
• test_class（字符串，可選）：要運行的特定測試類。
• generate_report（布爾值，可選）：是否生成HTML測試報告。

3. create_kotlin_file - 生成Kotlin文件

創建具有正確包聲明和導入的結構化Kotlin文件。

{
  "name": "create_kotlin_file",
  "arguments": {
    "file_path": "src/main/kotlin/com/example/User.kt",
    "class_name": "User",
    "class_type": "data_class",
    "properties": ["id: String", "name: String", "email: String"],
    "package_name": "com.example.model"
  }
}

參數：

• file_path（字符串）：新文件的相對路徑。
• class_name（字符串）：主類的名稱。
• class_type（字符串）："class"、"data_class"、"sealed_class"、"object"、"interface"
• properties（數組，可選）：數據類的屬性列表。
• package_name（字符串，可選）：包聲明。

4. create_layout_file - 生成XML佈局

創建具有正確結構的Android XML佈局文件。

{
  "name": "create_layout_file",
  "arguments": {
    "file_path": "src/main/res/layout/activity_main.xml",
    "layout_type": "activity",
    "root_element": "LinearLayout",
    "include_common_attributes": true
  }
}

5. analyze_project - 項目分析

對您的Android項目結構、依賴項和架構進行全面分析。

{
  "name": "analyze_project",
  "arguments": {
    "analysis_type": "architecture",
    "include_dependencies": true,
    "check_best_practices": true
  }
}

分析類型：

• architecture：整體項目結構和模式。
• dependencies：Gradle依賴項和版本。
• security：安全漏洞和最佳實踐。
• performance：性能瓶頸和優化建議。

6. format_code - 代碼格式化

根據風格指南格式化Kotlin代碼。

{
  "name": "format_code",
  "arguments": {
    "file_path": "src/main/kotlin/MainActivity.kt",
    "style_guide": "ktlint"
  }
}

7. run_lint - 靜態代碼分析

運行Lint分析，檢測代碼問題。

{
  "name": "run_lint",
  "arguments": {
    "lint_tool": "detekt",
    "fail_on_warnings": false,
    "generate_report": true
  }
}

8. generate_docs - 文檔生成

以各種格式生成項目文檔。

{
  "name": "generate_docs",
  "arguments": {
    "doc_type": "kdoc",
    "output_format": "html",
    "include_private": false
  }
}

UI開發工具

9. create_compose_component - Jetpack Compose組件

生成遵循最佳實踐的Jetpack Compose UI組件。

{
  "name": "create_compose_component",
  "arguments": {
    "component_name": "UserCard",
    "component_type": "composable",
    "file_path": "src/main/kotlin/ui/components/UserCard.kt",
    "parameters": [
      "user: User",
      "onClick: () -> Unit"
    ],
    "include_preview": true,
    "material_design": "material3"
  }
}

組件類型：

• composable：標準可組合函數。
• stateful：帶有內部狀態的可組合函數。
• stateless：純UI可組合函數。
• layout：帶有子組件的佈局可組合函數。

10. create_custom_view - 自定義Android視圖

創建具有正確生命週期管理的自定義視圖類。

{
  "name": "create_custom_view",
  "arguments": {
    "view_name": "CircularProgressView",
    "base_class": "View",
    "file_path": "src/main/kotlin/ui/views/CircularProgressView.kt",
    "custom_attributes": [
      {"name": "progressColor", "type": "color"},
      {"name": "strokeWidth", "type": "dimension"}
    ]
  }
}

架構與模式工具

11. setup_mvvm_architecture - MVVM實現

設置完整的MVVM架構，包括ViewModel、存儲庫和UI層。

{
  "name": "setup_mvvm_architecture",
  "arguments": {
    "feature_name": "UserProfile",
    "package_name": "com.example.userprofile",
    "include_repository": true,
    "include_use_cases": true,
    "state_management": "compose"
  }
}

生成的文件：

• 帶有狀態管理的ViewModel。
• 帶有數據源抽象的存儲庫。
• 用於業務邏輯的用例。
• UI可組合函數或片段。
• 用於事件的狀態類和密封類。

12. setup_dependency_injection - 依賴注入框架設置

使用Hilt或Dagger配置依賴注入。

{
  "name": "setup_dependency_injection",
  "arguments": {
    "di_framework": "hilt",
    "modules": ["DatabaseModule", "NetworkModule", "RepositoryModule"],
    "application_class": "MyApplication"
  }
}

13. setup_room_database - 數據庫設置

創建Room數據庫實現，包括實體、DAO和遷移。

{
  "name": "setup_room_database",
  "arguments": {
    "database_name": "AppDatabase",
    "entities": [
      {
        "name": "User",
        "fields": [
          {"name": "id", "type": "String", "primaryKey": true},
          {"name": "name", "type": "String"},
          {"name": "email", "type": "String"}
        ]
      }
    ],
    "version": 1,
    "enable_encryption": true
  }
}

14. setup_retrofit_api - 網絡層

設置Retrofit API接口，包括正確的錯誤處理和攔截器。

{
  "name": "setup_retrofit_api",
  "arguments": {
    "base_url": "https://api.example.com/",
    "endpoints": [
      {
        "name": "getUser",
        "method": "GET",
        "path": "users/{id}",
        "response_type": "User"
      }
    ],
    "include_interceptors": ["logging", "auth", "retry"],
    "enable_cache": true
  }
}

安全與合規工具

15. encrypt_sensitive_data - 數據加密

使用行業標準的加密算法加密敏感數據。

{
  "name": "encrypt_sensitive_data",
  "arguments": {
    "data": "患者: 約翰· Doe，社保號: 123 - 45 - 6789",
    "data_type": "phi",
    "compliance_level": "hipaa",
    "encryption_algorithm": "AES - 256"
  }
}

16. implement_gdpr_compliance - GDPR實現

實現完整的GDPR合規框架。

{
  "name": "implement_gdpr_compliance",
  "arguments": {
    "package_name": "com.example.app",
    "features": [
      "consent_management",
      "data_portability",
      "right_to_erasure",
      "privacy_policy",
      "data_breach_notification"
    ],
    "supported_languages": ["en", "de", "fr"],
    "include_ui": true
  }
}

生成的組件：

• 同意管理UI和邏輯。
• 數據導出功能。
• 用戶數據刪除工作流。
• 隱私政策模板。
• 審計日誌系統。

17. implement_hipaa_compliance - HIPAA實現

實現符合HIPAA的安全措施。

{
  "name": "implement_hipaa_compliance",
  "arguments": {
    "package_name": "com.healthcare.app",
    "features": [
      "audit_logging",
      "access_controls",
      "encryption",
      "secure_messaging",
      "risk_assessment"
    ],
    "minimum_password_strength": "high",
    "session_timeout": 900
  }
}

18. setup_secure_storage - 安全數據存儲

配置用於敏感數據的加密存儲。

{
  "name": "setup_secure_storage",
  "arguments": {
    "storage_type": "room_encrypted",
    "package_name": "com.example.app",
    "data_classification": "restricted",
    "key_management": "android_keystore"
  }
}

AI/ML集成工具

19. query_llm - 大語言模型查詢

查詢本地或遠程大語言模型，獲取代碼幫助。

{
  "name": "query_llm",
  "arguments": {
    "prompt": "生成一個帶有驗證的Kotlin數據類User",
    "llm_provider": "local",
    "model": "codellama",
    "privacy_mode": true,
    "max_tokens": 1000,
    "temperature": 0.2
  }
}

支持的提供商：

• local：Ollama、LocalAI。
• openai：GPT - 4、GPT - 3.5。
• anthropic：Claude模型。
• custom：自定義API端點。

20. analyze_code_with_ai - AI代碼分析

使用AI分析代碼的各個方面。

{
  "name": "analyze_code_with_ai",
  "arguments": {
    "file_path": "src/main/kotlin/UserManager.kt",
    "analysis_type": "security",
    "use_local_model": true,
    "detailed_report": true
  }
}

分析類型：

• security：安全漏洞和最佳實踐。
• performance：性能優化建議。
• bugs：潛在的bug檢測。
• style：代碼風格改進。
• complexity：代碼複雜性分析。
• maintainability：可維護性評估。

21. generate_code_with_ai - AI代碼生成

根據自然語言描述使用AI生成代碼。

{
  "name": "generate_code_with_ai",
  "arguments": {
    "description": "帶有生物識別認證和錯誤處理的登錄屏幕",
    "code_type": "compose_screen",
    "framework": "compose",
    "compliance_requirements": ["gdpr"],
    "include_tests": true,
    "style_guide": "material3"
  }
}

文件管理工具

22. manage_project_files - 高級文件操作

執行全面的文件管理操作。

{
  "name": "manage_project_files",
  "arguments": {
    "operation": "backup",
    "include_build_files": false,
    "compression": "zip",
    "encryption": true,
    "backup_location": "/path/to/backup",
    "exclude_patterns": ["*.tmp", "build/", ".gradle/"]
  }
}

操作：

• backup：創建加密備份。
• restore：從備份中恢復。
• sync：與雲存儲同步。
• encrypt：加密敏感文件。
• decrypt：解密文件（需適當授權）。
• organize：按類型/類別組織文件。

23. setup_cloud_sync - 雲存儲集成

配置雲存儲同步，並進行加密。

{
  "name": "setup_cloud_sync",
  "arguments": {
    "cloud_provider": "aws_s3",
    "bucket_name": "my-app-backup",
    "encryption_in_transit": true,
    "encryption_at_rest": true,
    "sync_frequency": "hourly",
    "compliance_mode": "gdpr"
  }
}

API集成工具

24. setup_external_api - API配置

設置外部API集成，包括安全和監控。

{
  "name": "setup_external_api",
  "arguments": {
    "api_name": "PaymentAPI",
    "base_url": "https://api.payment.com/v1/",
    "auth_type": "oauth2",
    "auth_config": {
      "client_id": "your_client_id",
      "scopes": ["payments", "users"]
    },
    "rate_limiting": {
      "requests_per_minute": 100,
      "burst_limit": 10
    },
    "security_features": ["request_signing", "response_validation"],
    "monitoring": true
  }
}

25. call_external_api - API調用

進行安全的API調用，並提供全面的監控。

{
  "name": "call_external_api",
  "arguments": {
    "api_name": "PaymentAPI",
    "endpoint": "/charges",
    "method": "POST",
    "data": {
      "amount": 1000,
      "currency": "USD",
      "description": "測試支付"
    },
    "headers": {
      "Content-Type": "application/json"
    },
    "timeout": 30,
    "retry_config": {
      "max_retries": 3,
      "backoff_strategy": "exponential"
    }
  }
}

測試工具

26. generate_unit_tests - 單元測試生成

為Kotlin類生成全面的單元測試。

{
  "name": "generate_unit_tests",
  "arguments": {
    "file_path": "src/main/kotlin/UserRepository.kt",
    "test_framework": "junit5",
    "mocking_framework": "mockk",
    "include_edge_cases": true,
    "test_coverage_target": 90
  }
}

27. setup_ui_testing - UI測試配置

使用Espresso或Compose測試框架設置UI測試。

{
  "name": "setup_ui_testing",
  "arguments": {
    "testing_framework": "compose",
    "include_accessibility_tests": true,
    "include_screenshot_tests": true,
    "test_data_setup": "in_memory_database"
  }
}

Git工具

28. gitStatus - Git倉庫狀態

獲取全面的Git倉庫狀態，包括分支、更改和領先/落後計數。

{
  "name": "gitStatus",
  "arguments": {}
}

返回值：

• 當前分支名稱。
• 帶有狀態的更改文件列表。
• 相對於遠程的領先/落後計數。
• 倉庫是否有未提交的更改。

29. gitSmartCommit - 智能提交消息

根據代碼更改分析創建符合規範的提交消息。

{
  "name": "gitSmartCommit",
  "arguments": {}
}

特性：

• 分析更改的文件以確定提交類型。
• 生成符合規範的提交消息。
• 自動暫存更改。
• 支持feat、fix、docs、refactor、test類型。

30. gitCreateFeatureBranch - 安全分支創建

創建符合驗證和命名約定的功能分支。

{
  "name": "gitCreateFeatureBranch",
  "arguments": {
    "branchName": "user-authentication"
  }
}

特性：

• 創建feature/branch-name格式的分支。
• 驗證分支名稱格式。
• 檢查是否存在現有分支。
• 自動切換到新分支。

31. gitMergeWithResolution - 智能合併

嘗試合併並進行衝突解決和提供建議。

{
  "name": "gitMergeWithResolution",
  "arguments": {
    "targetBranch": "main"
  }
}

特性：

• 嘗試自動合併。
• 提供衝突解決建議。
• 返回結構化的衝突塊。
• 提供合併策略建議。

外部API工具

32. apiCallSecure - 安全API調用

進行經過身份驗證的API調用，並進行監控和合規檢查。

{
  "name": "apiCallSecure",
  "arguments": {
    "apiName": "github",
    "endpoint": "/repos/owner/repo/issues",
    "method": "GET",
    "auth": {
      "type": "bearer",
      "token": "ghp_..."
    }
  }
}

特性：

• 多種身份驗證類型（Bearer、API密鑰、OAuth、基本認證）。
• 自動重試和退避策略。
• 請求/響應監控。
• 合規驗證。

33. apiMonitorMetrics - API指標監控

獲取即時的API使用指標和性能數據。

{
  "name": "apiMonitorMetrics",
  "arguments": {
    "apiName": "github",
    "windowMinutes": 60
  }
}

返回值：

• 請求計數和成功率。
• 平均延遲。
• 錯誤計數。
• 窗口化指標（1分鐘到7天）。

34. apiValidateCompliance - API合規驗證

驗證API使用是否符合GDPR/HIPAA合規規則。

{
  "name": "apiValidateCompliance",
  "arguments": {
    "apiName": "payment-api",
    "complianceType": "gdpr"
  }
}

驗證內容：

• 數據處理實踐。
• 隱私政策合規性。
• 審計日誌要求。
• 提供可操作的補救措施。

提高開發效率的工具

35. projectSearch - 快速項目搜索

在項目文件中進行快速grep搜索，並提供上下文。

{
  "name": "projectSearch",
  "arguments": {
    "query": "TODO|FIXME",
    "includePattern": "*.kt",
    "maxResults": 50,
    "contextLines": 2
  }
}

特性：

• 使用ripgrep提高速度。
• 匹配結果周圍的上下文行。
• 支持正則表達式模式。
• 文件類型過濾。

36. todoListFromCode - TODO/FIXME提取

從代碼庫中解析和組織TODO/FIXME註釋。

{
  "name": "todoListFromCode",
  "arguments": {
    "includePattern": "*.{kt,java,py,js,ts}",
    "maxResults": 100
  }
}

返回值：

• 按優先級組織（FIXME > TODO > XXX > HACK）。
• 文件位置和行號。
• 完整的註釋上下文。
• 摘要統計信息。

37. readmeGenerateOrUpdate - README管理

生成或更新README文件，包括徽章、設置說明和工具目錄。

{
  "name": "readmeGenerateOrUpdate",
  "arguments": {
    "forceRegenerate": false
  }
}

生成內容：

• 構建狀態徽章。
• 設置和使用說明。
• 完整的工具目錄。
• 環境變量文檔。

38. changelogSummarize - 變更日誌處理

將符合規範的提交匯總為分組的發佈說明。

{
  "name": "changelogSummarize",
  "arguments": {
    "changelogPath": "CHANGELOG.md",
    "version": "latest"
  }
}

按類型分組提交：

• 功能特性。
• 錯誤修復。
• 文檔更新。
• 重大變更。

39. buildAndTest - 構建和測試管道

運行Gradle/Maven構建並返回詳細的測試結果。

{
  "name": "buildAndTest",
  "arguments": {
    "buildTool": "auto",
    "skipTests": false
  }
}

返回值：

• 構建成功/失敗。
• 失敗測試的詳細信息。
• 構建工件。
• 性能指標。

40. dependencyAudit - 依賴項安全審計

審計Gradle依賴項的漏洞和許可證合規性。

{
  "name": "dependencyAudit",
  "arguments": {}
}

檢查內容：

• OSV漏洞數據庫。
• 許可證兼容性。
• 過時的依賴項。
• 安全公告。

41. securityHardening - 安全強化管理

管理安全強化功能，包括基於角色的訪問控制（RBAC）、速率限制、緩存和監控。

{
  "name": "securityHardening",
  "arguments": {
    "operation": "get_metrics"
  }
}

操作：

• get_metrics - 獲取安全指標和監控數據。
• assign_role - 分配用戶角色（管理員、開發者、只讀、訪客）。
• check_permission - 檢查用戶對操作的權限。
• clear_cache - 清除安全緩存。
• export_telemetry - 導出遙測數據。

特性：

• 基於角色的訪問控制（RBAC）。
• 滑動窗口速率限制。
• 斷路器模式。
• 基於TTL的緩存。
• 全面的指標收集。
• 遙測數據導出功能。

🚀 快速開始工具示例

完整項目設置工作流

以下是一個逐步的工作流，用於設置一個具有企業級特性的新Android項目：

# 1. 分析現有項目結構
{
  "name": "analyze_project",
  "arguments": {
    "analysis_type": "architecture",
    "include_dependencies": true
  }
}

# 2. 設置MVVM架構
{
  "name": "setup_mvvm_architecture", 
  "arguments": {
    "feature_name": "UserManagement",
    "package_name": "com.example.users",
    "include_repository": true,
    "state_management": "compose"
  }
}

# 3. 配置依賴注入
{
  "name": "setup_dependency_injection",
  "arguments": {
    "di_framework": "hilt",
    "modules": ["DatabaseModule", "NetworkModule"]
  }
}

# 4. 設置安全數據庫
{
  "name": "setup_room_database",
  "arguments": {
    "database_name": "AppDatabase",
    "entities": [
      {
        "name": "User",
        "fields": [
          {"name": "id", "type": "String", "primaryKey": true},
          {"name": "name", "type": "String"},
          {"name": "email", "type": "String"}
        ]
      }
    ],
    "enable_encryption": true
  }
}

# 5. 實現合規性（如果需要）
{
  "name": "implement_gdpr_compliance",
  "arguments": {
    "package_name": "com.example.app",
    "features": ["consent_management", "data_portability"],
    "include_ui": true
  }
}

# 6. 生成UI組件
{
  "name": "create_compose_component",
  "arguments": {
    "component_name": "UserListScreen",
    "component_type": "stateful",
    "include_preview": true,
    "material_design": "material3"
  }
}

# 7. 設置API集成
{
  "name": "setup_retrofit_api",
  "arguments": {
    "base_url": "https://api.example.com/",
    "endpoints": [
      {
        "name": "getUsers",
        "method": "GET", 
        "path": "users",
        "response_type": "List<User>"
      }
    ],
    "include_interceptors": ["logging", "auth"]
  }
}

# 8. 生成全面測試
{
  "name": "generate_unit_tests",
  "arguments": {
    "file_path": "src/main/kotlin/UserRepository.kt",
    "test_framework": "junit5",
    "include_edge_cases": true
  }
}

# 9. 構建和測試
{
  "name": "gradle_build",
  "arguments": {
    "task": "assembleDebug",
    "clean_build": true
  }
}

{
  "name": "run_tests",
  "arguments": {
    "test_type": "all",
    "generate_report": true
  }
}

AI驅動的開發示例

# 使用AI生成完整的登錄功能
{
  "name": "generate_code_with_ai",
  "arguments": {
    "description": "完整的登錄功能，包括電子郵件/密碼、生物識別認證、記住我選項、忘記密碼流程和正確的錯誤處理",
    "code_type": "feature",
    "framework": "compose",
    "compliance_requirements": ["gdpr"],
    "include_tests": true
  }
}

# 分析現有代碼的安全問題
{
  "name": "analyze_code_with_ai",
  "arguments": {
    "file_path": "src/main/kotlin/AuthManager.kt",
    "analysis_type": "security",
    "detailed_report": true
  }
}

# 獲取AI協助進行復雜實現
{
  "name": "query_llm",
  "arguments": {
    "prompt": "如何在Android中實現安全的生物識別認證，並在失敗時回退到PIN碼？包括對不同生物識別狀態的錯誤處理。",
    "llm_provider": "local",
    "privacy_mode": true
  }
}

🛠️ 工具使用最佳實踐

文件路徑約定

始終使用相對於項目根目錄的路徑：

# ✅ 正確
"file_path": "src/main/kotlin/com/example/User.kt"

# ❌ 錯誤  
"file_path": "/absolute/path/to/User.kt"

包命名

遵循Android包命名約定：

# ✅ 正確
"package_name": "com.company.app.feature.user"

# ❌ 錯誤
"package_name": "User.Package"

安全最佳實踐

• 始終對敏感數據使用加密。
• 從一開始就實現適當的合規功能。
• 使用安全存儲來保存API密鑰和機密信息。
• 啟用審計日誌以滿足合規要求。

性能優化

• 儘可能在Gradle構建中使用parallel: true。
• 逐步生成測試，而不是一次性生成所有測試。
• 對於隱私敏感的代碼分析，使用本地大語言模型提供商。
• 為API設置啟用緩存。

錯誤處理

所有工具都提供全面的錯誤信息：

{
  "success": false,
  "error": "文件已存在",
  "details": {
    "file_path": "src/main/kotlin/User.kt",
    "suggestion": "使用不同的文件名或設置overwrite: true"
  }
}

📊 工具響應格式

成功響應

{
  "success": true,
  "result": {
    "files_created": ["User.kt", "UserTest.kt"],
    "lines_of_code": 125,
    "compilation_status": "success"
  },
  "metadata": {
    "execution_time": "2.3s",
    "tools_used": ["kotlin_compiler", "test_generator"]
  }
}

錯誤響應

{
  "success": false,
  "error": "編譯失敗",
  "details": {
    "error_type": "compilation_error",
    "line_number": 23,
    "message": "未解析的引用: undefinedVariable",
    "suggestions": [
      "檢查變量聲明",
      "驗證導入"
    ]
  }
}

🔒 安全與隱私特性

GDPR合規實現

{
  "name": "implement_gdpr_compliance",
  "arguments": {
    "package_name": "com.example.app",
    "features": [
      "consent_management",
      "data_portability", 
      "right_to_erasure",
      "privacy_policy"
    ]
  }
}

生成的特性：

• 同意管理UI組件。
• 數據導出功能。
• 用戶數據刪除工作流。
• 隱私政策模板。
• 法律依據跟蹤。

HIPAA合規實現

{
  "name": "implement_hipaa_compliance",
  "arguments": {
    "package_name": "com.healthcare.app",
    "features": [
      "audit_logging",
      "access_controls",
      "encryption",
      "secure_messaging"
    ]
  }
}

生成的特性：

• 全面的審計日誌系統。
• 基於角色的訪問控制框架。
• 受保護健康信息（PHI）加密實用工具。
• 安全消息傳遞基礎設施。
• 風險評估工具。

數據加密

{
  "name": "encrypt_sensitive_data",
  "arguments": {
    "data": "患者: 約翰· Doe，社保號: 123 - 45 - 6789",
    "data_type": "phi",
    "compliance_level": "hipaa"
  }
}

安全存儲設置

{
  "name": "setup_secure_storage",
  "arguments": {
    "storage_type": "room_encrypted",
    "package_name": "com.example.app",
    "data_classification": "restricted"
  }
}

🤖 AI集成特性

本地大語言模型查詢

{
  "name": "query_llm", 
  "arguments": {
    "prompt": "生成一個帶有驗證的Kotlin數據類User",
    "llm_provider": "local",
    "privacy_mode": true,
    "max_tokens": 1000
  }
}

AI驅動的代碼分析

{
  "name": "analyze_code_with_ai",
  "arguments": {
    "file_path": "src/main/UserManager.kt",
    "analysis_type": "security",
    "use_local_model": true
  }
}

分析類型：

• security - 漏洞和安全最佳實踐。
• performance - 性能優化建議。
• bugs - 潛在的bug檢測。
• style - 代碼風格和格式化改進。
• complexity - 代碼複雜性分析。

AI代碼生成

{
  "name": "generate_code_with_ai",
  "arguments": {
    "description": "帶有生物識別認證的登錄屏幕",
    "code_type": "component",
    "framework": "compose",
    "compliance_requirements": ["gdpr", "hipaa"]
  }
}

代碼類型：

• class - 帶有方法的Kotlin類。
• function - 獨立函數。
• layout - XML佈局文件。
• test - 單元和集成測試。
• component - Jetpack Compose組件。

📁 文件管理操作

高級備份

{
  "name": "manage_project_files",
  "arguments": {
    "operation": "backup",
    "target_path": "./src",
    "destination": "./backups",
    "encryption_level": "high"
  }
}

即時同步

{
  "name": "manage_project_files",
  "arguments": {
    "operation": "sync",
    "target_path": "./src",
    "destination": "./remote-sync",
    "sync_strategy": "real_time"
  }
}

雲存儲同步

{
  "name": "setup_cloud_sync",
  "arguments": {
    "cloud_provider": "aws",
    "sync_strategy": "scheduled",
    "encryption_in_transit": true,
    "compliance_mode": "gdpr"
  }
}

支持的操作：

• backup - 創建帶有清單的加密備份。
• restore - 從備份中恢復，並進行完整性檢查。
• sync - 雙向同步，解決衝突。
• encrypt - 就地加密敏感文件。
• decrypt - 解密文件（需適當授權）。
• archive - 創建壓縮存檔。
• extract - 提取存檔並進行驗證。
• search - 基於內容的文件發現。
• analyze - 文件結構和使用分析。

🌐 外部API集成

API集成設置

{
  "name": "integrate_external_api",
  "arguments": {
    "api_name": "HealthRecordsAPI",
    "base_url": "https://api.healthrecords.com",
    "auth_type": "oauth",
    "security_features": [
      "rate_limiting",
      "request_logging", 
      "response_validation"
    ],
    "compliance_requirements": ["hipaa"]
  }
}

API使用監控

{
  "name": "monitor_api_usage",
  "arguments": {
    "api_name": "HealthRecordsAPI",
    "metrics": [
      "latency",
      "error_rate",
      "usage_volume",
      "cost"
    ],
    "alert_thresholds": {
      "error_rate": 5.0,
      "latency_ms": 2000
    }
  }
}

認證類型：

• none - 無需認證。
• api_key - 在頭部或查詢中使用API密鑰。
• oauth - OAuth 2.0流程。
• jwt - JSON Web Token。
• basic - 基本HTTP認證。

🏗️ 高級Android開發

MVVM架構設置

{
  "name": "setup_mvvm_architecture",
  "arguments": {
    "feature_name": "UserProfile",
    "package_name": "com.example.app",
    "include_repository": true,
    "include_use_cases": true,
    "data_source": "both"
  }
}

Jetpack Compose組件

{
  "name": "create_compose_component",
  "arguments": {
    "file_path": "ui/components/LoginForm.kt",
    "component_name": "LoginForm",
    "component_type": "component",
    "package_name": "com.example.ui",
    "uses_state": true,
    "uses_navigation": false
  }
}

Room數據庫設置

{
  "name": "setup_room_database",
  "arguments": {
    "database_name": "AppDatabase",
    "package_name": "com.example.data",
    "entities": ["User", "Profile", "Settings"],
    "include_migration": true
  }
}

Retrofit API客戶端

{
  "name": "setup_retrofit_api",
  "arguments": {
    "api_name": "UserApiService",
    "package_name": "com.example.network",
    "base_url": "https://api.example.com",
    "endpoints": [
      {
        "method": "GET",
        "path": "/users/{id}",
        "name": "getUser"
      }
    ],
    "include_interceptors": true
  }
}

依賴注入（Hilt）

{
  "name": "setup_dependency_injection",
  "arguments": {
    "module_name": "NetworkModule",
    "package_name": "com.example.di",
    "injection_type": "network"
  }
}

ML模型集成

{
  "name": "integrate_ml_model",
  "arguments": {
    "model_type": "tflite",
    "model_path": "assets/model.tflite",
    "use_case": "image_classification",
    "privacy_preserving": true
  }
}

🛠️ 特定工具故障排除

Gradle構建問題

# 工具: gradle_build
# 常見解決方案:

# 1. 清除Gradle緩存
{
  "name": "gradle_build",
  "arguments": {
    "task": "clean",
    "clean_build": true
  }
}

# 2. 檢查Java版本
echo $JAVA_HOME
java -version

# 3. 修復權限問題（macOS/Linux）
chmod +x gradlew

# 4. 啟用詳細輸出進行調試
{
  "name": "