🚀 AiSpire 智能界面
AiSpire 是 Vectric Aspire 和 V - Carve CAD/CAM 软件的智能接口，借助 AI 驱动，实现设计与加工功能，为用户带来更高效、智能的操作体验。
🚀 快速开始
要开始使用请先完成以下准备：
- 安装 Vectric Aspire 或 V - Carve 软件。
- 配置 Lua 5.3+ 环境并安装 LuaSocket 库。
- 安装 Python 3.8+ 并配置所需依赖（见 requirements.txt）。
- 获取支持 MCP 协议的 LLM 服务。
✨ 主要特性
- 任意 Lua 代码执行：在 Vectric 软件内部运行任意 Lua 脚本。
- 复杂几何操作：支持矩阵变换、极坐标运算等高级几何处理。
- 专业加工策略：包括轮廓铣削、插槽铣削、V 型铣削、粗加工和精加工等多种切削方式。
- 工具数据库访问：可访问系统工具库，支持自定义工具创建。
- 自定义用户界面：提供对话框、进度条等交互元素。
📦 安装指南
构建与测试
项目提供多种测试选项：
make help # 显示所有可用命令
make test - lua # 运行 Lua 单元测试
make test - python # 运行 Python 核心测试
make bundle # 打包生成 Vectric 插件包
💻 使用示例
目前文档未提供具体代码示例。若后续有相关代码示例，可按照以下方式展示：
基础用法
# 这里放置基础用法的代码示例
高级用法
# 这里放置高级用法的代码示例
📚 详细文档
项目概述
AiSpire 包含两个主要组件：
- Lua 组件 - 在 Vectric 软件内部运行的插件。
- Python MCP 服务器 - 实现模型上下文协议 (MCP) 的 LLM 集成服务器。
┌─────────────┐ ┌─────────────┐ ┌─────────┐
│ │ │ │ │ │
│ LLMs │◄─────────► │ Python MCP │◄─────────► │ Lua │
│ │ (MCP) │ Server │ (Socket) │ │
└─────┬──────┘ └─────┬──────┘ └─────┬──────┘
│ │ │
▼ ▼ ▼
Vectric 软件 处理器 用户界面
项目状态
当前实现的功能
- 基础几何操作与路径生成。
- 标准加工任务执行。
- 工具数据库基础访问。
- 简单的用户界面交互。
计划中功能
- 高级矩阵变换支持。
- 专业切削策略优化。
- 复杂多轴加工实现。
- 集成 AI 辅助设计功能。
目录结构
项目文件按功能划分如下：
.
├── lua_component/ # Lua 插件代码
│ ├── server.lua # 主服务器逻辑
│ └── utils/ # 工具函数
├── python_mcp/ # Python MCP 服务器实现
│ ├── mcp_core.py # 核心 MCP 协议处理
│ └── handlers/ # 各类请求处理器
└── ui_elements/ # 用户界面组件
├── dialogs/ # 对话框模板
└── progressbars/ # 进度条实现
SDK 参考
项目附带详细的 Vectric SDK 文档，涵盖以下内容：
- 工作任务创建与管理。
- 向量与几何操作。
- 加工路径生成策略。
- 工具库访问接口。
- 用户界面组件使用。
- 系统信息获取。
计划增强
基于 SDK 参考，未来计划实现：
- 高级几何运算：矩阵变换、复杂路径生成、极坐标支持。
- 专业加工任务：多轴铣削、五轴加工、高速切削优化。
- 智能工具管理：自定义刀具库创建与管理。
- AI 辅助设计：集成机器学习模型实现智能设计建议。
- 系统扩展接口：支持第三方插件开发。
🔧 技术细节
技术需求
- 硬件：现代 PC，支持 OpenGL 2.0 及以上。
- 软件：
- Vectric Aspire/V - Carve 软件。
- Lua 5.3+ with LuaSocket。
- Python 3.8+ with 标准库和第三方包。
- 网络：互联网连接（用于 LLM 服务）。
📄 许可证
许可证信息待定
联系方式
联系信息待提供