Toolbox

🚀 工具箱：AI驅動自動化工具開發平臺

ToolBox 是一個基於 MIT 許可證開源的 AI 驅動自動化工具開發平臺。它藉助 package.json 配置，提供了一系列強大功能，能有效解決自動化工具開發中的諸多問題，為企業和開發者帶來了高效、便捷的開發體驗。

🚀 快速開始

在項目根目錄下創建 package.json，添加以下內容：

{
  "version": "1.0.0",
  "name": "toolbox_demo",
  "description": "ToolBox 示例項目",
  "scripts": {
    "start": "node build/index.js"
  },
  "tbx": {
    "servers": [
      {
        "id": "mcp_example_1",
        "type": "MCP_SERVER",
        "config": "examples/example_config.json"
      }
    ]
  }
}

然後運行以下命令完成初始化：

npm install tbx --save-dev
tbx init

✨ 主要特性

1. 企業級自動化

• 具備強大的模塊化架構，可靈活擴展工具鏈。
• 支持即時調試（使用 --inspect 標誌）。
• 提供 VSCode 調試配置模板。
• 擁有熱重載機制：

graph LR
  A[代碼修改] --> B[buildReload_tool]
  B --> C[自動編譯]
  C --> D[安全驗證]
  D --> E[工具熱重載]

通過調用 buildReload_tool 實現： - 零停機時間更新 - 自動依賴項樹解析 - 版本兼容性檢查 - 獨立沙箱環境測試

2. 開發者友好性

• 使用強類型 TypeScript 實現。
• 支持通過 Chrome DevTools 和 VSCode 進行調試。
• 熱重載機制：

graph LR
  A[代碼修改] --> B[buildReload_tool]
  B --> C[自動編譯]
  C --> D[安全驗證]
  D --> E[工具熱重載]

可實現零停機時間更新和版本兼容性檢查。

📦 安裝指南

在項目根目錄下創建 package.json，添加如下內容：

{
  "version": "1.0.0",
  "name": "toolbox_demo",
  "description": "ToolBox 示例項目",
  "scripts": {
    "start": "node build/index.js"
  },
  "tbx": {
    "servers": [
      {
        "id": "mcp_example_1",
        "type": "MCP_SERVER",
        "config": "examples/example_config.json"
      }
    ]
  }
}

接著運行以下命令完成初始化：

npm install tbx --save-dev
tbx init

📚 詳細文檔

核心價值

企業級自動化能力

• 全局 CLI 工具安裝：可通過 tbx 命令快速訪問工具箱功能。
• 工作流調度引擎：支持複雜的任務編排和依賴管理。
• 多平臺支持：能在 Windows 和 macOS 上無縫運行。
• 混合雲部署：集成了 MongoDB、Redis 和 SSH 遠程連接能力。

開發者友好性

• 強類型 TypeScript：提供嚴格類型檢查和代碼補全。
• 即時調試支持：通過 --inspect 標誌啟用調試模式。
• VSCode 調試配置：自動生成調試配置文件。
• 熱重載機制：實現零停機時間更新和版本兼容性檢查。

診斷與調試

1. Node.js 調試

啟動服務器時添加 --inspect=9229 標誌：

node --inspect=9229 build/index.js

然後在 Chrome 中打開 chrome://inspect 進行調試。

2. MCP 調試工具

使用 MCP Inspector，通過以下命令啟動：

npm run inspector

3. VSCode 調試配置

在項目根目錄下創建 .vscode/launch.json 文件，添加如下配置：

{
    "version": "0.2.0",
    "configurations": [
        {
            "type": "node",
            "request": "attach",
            "name": "ToolBox 調試",
            "address": "localhost",
            "port": 9229,
            "localRoot": "${workspaceFolder}"
        }
    ]
}

注意事項

敏感數據

請勿在容器中配置敏感信息（如 API 密鑰、數據庫密碼等）。任何與大語言模型 (LLM) 的交互都會默認 compromising 敏感數據，除非 LLM 在本地運行。

法律責任

• 警告：本工具按“原樣”提供，不附帶任何形式的擔保。
• 開發者不對任何直接或間接損害承擔責任。
• 用戶需自行承擔配置和使用過程中的一切風險。
• 請勿用於任何非法用途。

📄 許可證

本項目基於 MIT 許可證開源。