# anycad.api4ai

**Repository Path**: anycad/anycad.api4ai

## Basic Information

- **Project Name**: anycad.api4ai
- **Description**: 方便AI使用的API文档
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-11-23
- **Last Updated**: 2025-12-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AnyCAD API4AI 示例项目

本项目展示了如何使用AnyCAD API创建参数化的3D模型，所有脚本都遵循AnyCAD的Python API规范。

![](./img/chair.png)

## 项目结构

```
.
├── doc/                    # API文档
│   ├── Geometry/          # 几何建模API文档
│   └── Math/              # 数学库API文档
├── sample.py              # 示例代码模板
└── README.md              # 项目说明文档
```

## 使用方法

这些脚本专为AnyCAD环境设计，不能直接在标准Python环境中运行。要在AnyCAD中使用这些脚本：

1. 在AnyCAD中打开脚本编辑器
2. 加载相应的.py文件
3. 调整参数值
4. 运行脚本生成3D模型

### 通过VS Code任务运行脚本

项目包含了VS Code任务配置，可以通过HTTP服务将脚本发送到AnyCAD执行：

1. 确保AnyCAD HTTP服务正在运行（监听8080端口）
2. 在VS Code中打开脚本文件
3. 按 `Ctrl+Shift+B` 运行默认任务，将当前脚本发送到AnyCAD
4. 或按 `Ctrl+Shift+P`，输入 "Tasks: Run Task"，选择相应任务

### 直接通过Python脚本运行

您也可以直接运行 [tools/run_script.py](file:///D:/OpenSource/anycad.api4ai/tools/run_script.py) 脚本将Python代码发送到AnyCAD：

```bash
python tools/run_script.py your_script.py
```

如果未指定脚本文件，则默认运行sample.py。

## 下载AnyCAD NEXT

```
链接:https://pan.baidu.com/s/1OFhz7yskxouj_hHgy7p6fA?pwd=dtpt 提取码:dtpt 
```

## API规范

所有脚本都遵循AnyCAD API规范：
- 使用`ctx.GetDouble()`定义参数
- 使用`ctx.SetShape()`存储最终模型
- 正确使用TopoShapeList的`append()`方法添加形状
- 严格按照API文档定义调用方法和参数顺序

## 开发规范

- 所有脚本都应遵循sample.py的结构模板
- 使用中文注释说明代码功能
- 严格按照doc/目录下的YAML格式API定义实现模型创建
- 通过AnyCAD MCP工具可以在AnyCAD中创建Py对象显示

## 工具和实用程序

### tools/run_script.py

这是一个实用的Python脚本，可用于将任何Python脚本发送到AnyCAD HTTP服务执行。它不依赖任何第三方库，仅使用Python标准库。

使用方法：
```bash
python tools/run_script.py script_to_run.py
```

如果未指定脚本文件，则默认运行sample.py。