項目上下文

這是一個使用 React 和 Next.js 的 TypeScript 項目。

開發指南

• 使用函數式組件和 Hooks
• 遵循現有文件結構
• 為新功能編寫測試
• 使用 TypeScript 嚴格模式

**特性：**
- 內容自動作為 `<system_prompt>...</system_prompt>` 注入到每個提示前。
- 最大大小：1 MB。
- 超過限制自動截斷（UTF-8 字符邊界安全）。

### 🔒 安全特性
- ✅ **默認只讀** - 無 `auto` 參數時僅允許讀取操作。
- ✅ **顯式權限** - 需明確指定 `auto` 級別才能修改。
- ✅ **超時強制** - 防止無限執行（默認 10 分鐘）。
- ✅ **高權限保護** - `high` 級別需配置文件允許。
- ✅ **資源限制** - 自動大小和內存限制：
  - Agent 消息：10 MB。
  - 所有消息：50 MB。
  - DROID.md：1 MB。
  - stderr：100 KB。

### 🛠️ 開發指南
#### 構建命令
```bash
cargo build              # 調試構建
cargo build --release    # 優化構建（啟用 LTO）
cargo clean              # 清理構建產物

測試和代碼質量

cargo test               # 運行測試
cargo clippy             # 代碼檢查
cargo fmt                # 代碼格式化
cargo check              # 快速類型檢查

開發要求

• Rust 1.70+。
• Droid CLI 已安裝並在 PATH 中。

🏗️ 架構概覽

數據流

Claude Code (MCP Client)
    ↓ stdio transport
MCP Server (main.rs)
    ↓ clap CLI parsing
Tool Handler (server.rs::droid)
    ↓ parameter validation + MCP protocol
CLI Wrapper (droid.rs::run)
    ↓ async process spawn + JSON stream parsing
droid exec CLI (subprocess)

核心文件

關鍵設計模式

1. 延遲配置加載 - 使用 OnceLock 緩存靜態配置。
2. 流式處理 - 異步逐行解析 JSON 流。
3. 大小限制 - 多層截斷邊界（10MB/50MB/1MB）。
4. 超時包裝 - tokio::time::timeout 強制超時。
5. 自定義模型系統 - 智能 GPT 優先 + 索引引用。

📁 配置文件位置總結

🎉 功能完整性檢查

✓ 核心功能

• [x] MCP 協議完整支持。
• [x] 所有 droid exec 參數映射。
• [x] 會話管理（SESSION_ID）。
• [x] 自定義模型系統。
• [x] DROID.md 注入。
• [x] 智能模型選擇（GPT 優先）。

✓ 高級功能

• [x] 推理模式（reasoning_effort）。
• [x] 規範模式（use_spec）。
• [x] 權限跳過（skip_permissions_unsafe）。
• [x] 輸出格式控制（output_format）。
• [x] 文件輸入（file）。
• [x] 工具控制（enabled_tools/disabled_tools）。

✓ 質量保證

• [x] 零警告編譯。
• [x] Clippy 全通過。
• [x] 跨平臺支持（Windows/Linux/macOS）。
• [x] 完整錯誤處理。
• [x] 資源限制和安全控制。

💻 使用示例

場景 1️⃣：基礎查詢（使用所有默認值）

await use_mcp_tool("droid", {
  PROMPT: "分析這個項目的代碼質量"
});
// 自動使用：auto=high, 第一個 GPT 模型, stream-json

場景 2️⃣：深度推理 + 規範模式

await use_mcp_tool("droid", {
  PROMPT: "重構認證模塊，提升安全性",
  reasoning_effort: "high",  // 深度推理
  use_spec: true,            // 先規劃後執行
  spec_model: "gpt-5.1"      // 使用 GPT-5.1 規劃
});

場景 3️⃣：多輪會話

// 第一輪：開始任務
const result1 = await use_mcp_tool("droid", {
  PROMPT: "創建用戶認證功能"
});

// 第二輪：繼續會話
const result2 = await use_mcp_tool("droid", {
  PROMPT: "添加單元測試",
  SESSION_ID: result1.SESSION_ID  // 恢復上下文
});

// 第三輪：繼續完善
const result3 = await use_mcp_tool("droid", {
  PROMPT: "優化性能",
  SESSION_ID: result2.SESSION_ID
});

場景 4️⃣：從文件讀取任務

// prompt.md 內容：
// # 任務
// 重構整個項目架構...

await use_mcp_tool("droid", {
  file: "./prompt.md",      // 從文件讀取
  reasoning_effort: "high"
});

場景 5️⃣：自定義模型

await use_mcp_tool("droid", {
  PROMPT: "生成 API 文檔",
  model: "custom:Sonnet-4.5-[88code]-0"  // 使用自定義模型
});

場景 6️⃣：隔離環境無限制執行

// ⚠️ 僅在 Docker 容器等隔離環境使用！
await use_mcp_tool("droid", {
  PROMPT: "系統級配置修改",
  skip_permissions_unsafe: true  // 跳過所有權限檢查
});

場景 7️⃣：精細控制工具

await use_mcp_tool("droid", {
  PROMPT: "分析代碼但不要修改",
  enabled_tools: "read,grep,find",   // 僅允許讀取類工具
  disabled_tools: "write,edit,bash"  // 禁用寫入類工具
});