.oo o .oPYo. o
.P 8 8
.P 8 o8 `Yooo. .oPYo. o8 oPYo. .oPYo.
oPooo8 8 `8 8 8 8 8 `' 8oooo8
.P 8 8 8 8 8 8 8 8.
.P 8 8 `YooP' 8YooP' 8 8 `Yooo'
..:::::..:..:.....:8 ....::....:::::.....:
:::::::::::::::::::8 :::::::::::::::::::::
:::::::::::::::::::..:::::::::::::::::::::AiSpire 的
AiSpire是Vectric Aspire和V-Carve CAD/CAM软件的智能接口，可实现AI驱动的设计和加工能力。
概述
AiSpire由两个主要部分组成：
- Lua小工具 -在CAD/CAM环境中运行的Vectric Aspire/V-Cave插件
- Python MCP服务器 -实现LLM集成模型上下文协议的服务器
┌─────────────┐ ┌─────────────┐ ┌─────────┐
│ │ │ │ │ │
│ LLMs │◄─────────► │ Python MCP │◄─────────► │ Lua │
│ │ (MCP) │ Server │ (Socket) │ Gadget │
│ │ │ │ │ │
└─────────────┘ └─────────────┘ └─────────┘
│
│
▼
┌─────────────┐
│ Vectric │
│ Aspire/ │
│ V-Carve │
└─────────────┘特性
- 在Vectric软件中执行任意Lua代码
- 以编程方式创建和操纵矢量路径
- 导入和修改三维模型
- 绘制矢量形状和文本
- 优化矢量嵌套以提高材料利用率
- 生成和计算CNC加工的刀具路径
- 具有日志查看和命令历史记录的交互式UI
- 利用先进的Vectric SDK功能：
- 用于精确对象操作的矩阵变换 - 专业工作类型（双面、旋转） - 先进的刀具路径策略（V形雕刻、凹槽雕刻、棱柱雕刻） - 工具数据库集成 - 自定义UI元素（HTML对话框、进度条） - 外部刀具路径生成和导入/导出
项目状态
AiSpire目前正在积极开发中。关键组成部分已经实施：
- Lua套接字服务器：带命令处理管道的基本套接字服务器
- 命令处理：用于执行Lua代码和SDK功能的框架
- UI管理器：带有日志查看器和命令历史记录的交互式用户界面
- Helper函数：通用操作综合库
- Python MCP服务器：使用套接字客户端实现基本MCP协议
UI功能
AiSpire小工具包括一个全面的用户界面：
- 日志查看器：实时显示带有颜色编码严重级别的系统消息
- 命令历史记录：查看和回放带有成功/失败指示器的过去命令
- 历史记录管理：保存和加载命令历史记录以供将来参考
- 连接状态：显示连接状态和活动的视觉指示器
- 断开控制装置：通过确认对话框安全断开连接
用户界面可通过两种方式访问：
- 主小工具操作使用UI启动服务器
- 次要操作（“显示AiSpire控制面板”）仅打开UI，而无需重新启动服务器
目录结构
lua_gadget/-Vectric软件的Lua插件
- server.lua -Socket服务器实现 - ui_manager.lua -小工具的UI实现 - json.lua -JSON解析实现 - helpers/ -常见操作的辅助功能
python_mcp_server/-MCP服务器的Python实现tests/-两个组件的测试文件docs/-项目文件
- vectric_sdk/ -包含详细的Vectric SDK参考文档
llm_brain/-人工智能开发指南和项目记忆
入门指南
*即将推出-当第一个功能版本可用时，将提供安装和使用说明。*
建造和测试
该项目包括一个Makefile，其中包含用于构建和测试的各种命令：
# Install development dependencies
make install-dev-deps
# Run all tests
make test
# Run specific test suites
make test-all-lua # Run all Lua tests
make test-all-python # Run all Python tests
make test-e2e # Run end-to-end tests
# More granular test options
make test-lua # Run Lua tests in tests/lua_tests/
make test-lua-helpers # Run Lua helper tests
make test-python-core # Run Python core tests
make test-python-mcp # Run Python MCP server tests
make test-python-tests # Run tests in tests/python_tests
# Create Vectric gadget bundle
make bundle
# Show all available commands
make help需求
- Vectric Aspire或V-Carve软件
- Lua 5.3+与LuaSocket库
- Python 3.8+及所需软件包（见requirements.txt）
- 访问支持模型上下文协议的LLM
SDK参考
该项目包括一个全面的Vectric SDK参考（位于 docs/vectric_sdk/Vectric.lua)该文档记录了与Vectric Aspire/V-Cave交互的可用功能。本参考文件包括：
- 创造就业和管理
- 矢量和几何运算
- 使用各种策略生成刀具路径
- 工具数据库访问
- 用户界面元素
- 三维组件操作（仅限Aspire）
- 系统信息和注册表访问
计划中的增强功能
基于详细的SDK参考，我们计划实现：
- 高级几何运算：基于矩阵的变换、复杂路径创建和极坐标函数
- 专业作业管理：支持双面和旋转作业
- 综合工具路径策略：轮廓、口袋、V形雕刻、凹槽、棱柱雕刻、3D粗加工和精加工
- 工具数据库集成：访问系统工具数据库，创建自定义工具
- UI集成：自定义对话框、进度条、文件选择界面
- 系统集成：应用程序检测、文件位置访问、注册表设置
- 外部刀具路径支持：生成、导入和导出自定义刀具路径
许可证
*许可证信息待定*
联系
*需提供联系方式*