Aispire

🚀 AiSpire 智能界面

AiSpire 是一款面向 Vectric Aspire 和 V - Carve CAD/CAM 軟件的智能接口，藉助 AI 驅動，實現強大的設計與加工功能，為用戶帶來更高效、智能的操作體驗。

🚀 快速開始

要開始使用請先完成以下準備：

1. 安裝 Vectric Aspire 或 V - Carve 軟件。
2. 配置 Lua 5.3+ 環境並安裝 LuaSocket 庫。
3. 安裝 Python 3.8+ 並配置所需依賴（見 requirements.txt）。
4. 獲取支持 MCP 協議的 LLM 服務。

✨ 主要特性

• 任意 Lua 代碼執行：可在 Vectric 軟件內部運行任意 Lua 腳本，滿足多樣化的自定義需求。
• 複雜幾何操作：支持矩陣變換、極座標運算等高級幾何處理，輕鬆應對複雜的設計場景。
• 專業加工策略：涵蓋輪廓銑削、插槽銑削、V 型銑削、粗加工和精加工等多種切削方式，提供全面的加工解決方案。
• 工具數據庫訪問：能訪問系統工具庫，還支持自定義工具創建，方便用戶根據實際需求定製工具。
• 自定義用戶界面：提供對話框、進度條等交互元素，增強用戶與軟件的交互體驗。

📚 詳細文檔

項目概述

AiSpire 包含兩個主要組件：

1. Lua 組件 - 在 Vectric 軟件內部運行的插件。
2. Python MCP 服務器 - 實現模型上下文協議 (MCP) 的 LLM 集成服務器。

                 ┌─────────────┐            ┌─────────────┐            ┌─────────┐
                 │             │            │             │            │         │
                 │    LLMs     │◄─────────► │ Python MCP  │◄─────────► │   Lua   │
                 │             │   (MCP)    │   Server    │  (Socket)  │         │
                 └─────┬──────┘            └─────┬──────┘            └─────┬──────┘
                        │                        │                         │
                        ▼                        ▼                         ▼
                     Vectric 軟件             處理器                  用戶界面

項目狀態

當前實現的功能

1. 基礎幾何操作與路徑生成。
2. 標準加工任務執行。
3. 工具數據庫基礎訪問。
4. 簡單的用戶界面交互。

計劃中功能

1. 高級矩陣變換支持。
2. 專業切削策略優化。
3. 複雜多軸加工實現。
4. 集成 AI 輔助設計功能。

目錄結構

項目文件按功能劃分如下：

.
├── lua_component/        # Lua 插件代碼
│   ├── server.lua       # 主服務器邏輯
│   └── utils/          # 工具函數
├── python_mcp/         # Python MCP 服務器實現
│   ├── mcp_core.py     # 核心 MCP 協議處理
│   └── handlers/       # 各類請求處理器
└── ui_elements/        # 用戶界面組件
    ├── dialogs/          # 對話框模板
    └── progressbars/   # 進度條實現

SDK 參考

項目附帶詳細的 Vectric SDK 文檔，涵蓋以下內容：

• 工作任務創建與管理。
• 向量與幾何操作。
• 加工路徑生成策略。
• 工具庫訪問接口。
• 用戶界面組件使用。
• 系統信息獲取。

計劃增強

基於 SDK 參考，未來計劃實現：

1. 高級幾何運算：矩陣變換、複雜路徑生成、極座標支持。
2. 專業加工任務：多軸銑削、五軸加工、高速切削優化。
3. 智能工具管理：自定義刀具庫創建與管理。
4. AI 輔助設計：集成機器學習模型實現智能設計建議。
5. 系統擴展接口：支持第三方插件開發。

🔧 技術細節

技術需求

• 硬件：現代 PC，支持 OpenGL 2.0 及以上。
• 軟件：
  • Vectric Aspire/V - Carve 軟件。
  • Lua 5.3+ with LuaSocket。
  • Python 3.8+ with 標準庫和第三方包。
• 網絡：互聯網連接（用於 LLM 服務）。

📦 安裝指南

項目提供多種測試選項：

make help              # 顯示所有可用命令
make test-lua          # 運行 Lua 單元測試
make test-python       # 運行 Python 核心測試
make bundle           # 打包生成 Vectric 插件包

📄 許可證

許可證信息待定

聯繫方式

聯繫信息待提供