Lazy Terminal

🚀 懶終端

懶終端 是一款智能命令行助手，藉助 MCP（模塊化組件協議）把語言模型和外部工具連接起來。它可以依據上下文動態判斷查詢是直接回答，還是調用已註冊的工具，實現無縫的終端自動化與智能交互（您可以偷懶，它可不會！）。

🚀 快速開始

安裝

pip install -r requirements.txt

配置

• 編輯 config/models.yaml 文件，添加您的模型憑證。
• 編輯 config/mcp_servers.yaml 文件，列出您的 MCP 服務器。

運行

使用以下命令啟動助手：

python main.py

直接從控制檯開始與懶終端互動！

✨ 主要特性

• 動態工具路由：自動選擇直接回答或工具調用。
• 上下文記憶：維持對話上下文（默認 50 次互動）。
• 多模型支持：通過 Coagent 輕鬆集成各種語言模型。
• 強健的 JSON 處理：提取並處理結構化的模型響應。
• 安全的 Bash 執行：通過 MCP 工具安全執行受控的 bash 腳本。

💻 使用示例

基礎用法

啟動 bash 運行器服務器：

python test_servers/bash_runner.py

高級用法

示例交互： 用戶輸入：

You: 列出 ~/Documents 目錄下所有 .txt 文件並將結果保存到 files.txt

助手工具調用：

{
  "tool_name": "run_bash_script",
  "parameters": {
    "commands": "ls ~/Documents/*.txt > files.txt"
  }
}

懶終端將執行此操作並返回結果。

📚 詳細文檔

🔑 環境變量

設置模型 API 密鑰為環境變量，例如：

export DEEPSEEK_API_KEY="your-api-key"

確保這些密鑰與 models.yaml 中的配置匹配。

📌 路線圖

• [ ] 實現高級記憶壓縮。
• [ ] 添加交互式 UI（終端/網頁）。
• [ ] 增強錯誤處理和日誌記錄。
• [ ] 擴展工具集（例如文件處理、瀏覽器自動化）。
• [ ] 支持多工具調用

🤝 致謝

• Coagent
• MCP

享受構建您的智能終端助手！