🚀 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 插件包

📄 许可证

许可证信息待定

联系方式

联系信息待提供