【教程】下载DeepDraw AI建模引擎并安装在Codex中使用

系列文章

高级篇 Codex 直接驱动 DeepDraw 建模：一句话创建模型，再用一句话修改它 AI建模太牛了，自己动手搭建AI建模软件，Codex直接操作DeepDraw窗口建模 自己动手用Astra+DeepDraw嵌入式图形引擎 编写AI建模软件（一）：Python会话 自己动手用Astra+DeepDraw嵌入式图形引擎 编写AI建模软件（二）：接入Astra模型 自己动手用Astra+DeepDraw嵌入式图形引擎 编写AI建模软件（三）：Codex直接驱动DeepDraw建模

进阶篇 DeepDraw引擎 vs SketchUp 功能演示Demo截图 用 DeepDraw 几何引擎开发建筑设计软件（一）：SketchUp 替代 用 DeepDraw 几何引擎开发建筑设计软件（二）：下载DeepDraw 用 DeepDraw 几何引擎开发建筑设计软件（三）：用代码绘制线段 用 DeepDraw 几何引擎开发建筑设计软件（四）：用代码绘制面 用 DeepDraw 几何引擎开发建筑设计软件（五）：创建选择工具 用 DeepDraw 几何引擎开发建筑设计软件（六）：读取模型文件 用 DeepDraw 几何引擎开发建筑设计软件（七）：InputPoint输入捕获器 用 DeepDraw 几何引擎开发建筑设计软件（八）：画线工具 用 DeepDraw 几何引擎开发建筑设计软件（九）：矩形工具 用 DeepDraw 几何引擎开发建筑设计软件（十）：推挤工具 用 DeepDraw 几何引擎开发建筑设计软件（十一）：偏移工具 用 DeepDraw 几何引擎开发建筑设计软件（十二）：参考线工具 用 DeepDraw 几何引擎开发建筑设计软件（十三）：删除命令

基础篇 Python+OpenGL绘制3D模型（五）绘制三角型 Python+OpenGL绘制3D模型（六）材质文件载入和贴图映射 Python+OpenGL绘制3D模型（七）制作3dsmax导出插件

Codex 直接驱动 DeepDraw 建模：从安装到第一次对话建模

下载地址 https://www.archieast.com/DeepDrawAI_v1_win64.zip

下载 DeepDraw AI 发行包后，你就可以尝试在 Codex 中说：

建一座带台阶、立柱和开孔屋顶的庭院小亭，检查尺寸，截图给我看。

模型生成后，再继续说：

把屋顶升高，立柱和横梁同步调整。

这篇教程带你完成环境准备、Skill 安装和第一次对话建模。日常使用时，你只需要表达设计需求，由 Codex 调用 DeepDraw 执行建模与检查。

让Codex帮你安装

如果你觉得安装过程太麻烦，可以把安装包路径丢给codex，让codex自己安装

当然也可以之际说

DeepDraw安装在 D:\\DeepDrawAI_v1 请了解怎么用，然后启动一个空的场景，准备开始建模

一、开始前，需要准备什么？

本文适用于 DeepDraw AI v1.0 Windows x64 发行版。请准备：

• 一台 Windows 64 位电脑，并具备可用的桌面与 OpenGL 图形环境。
• 已安装并能正常使用的 Codex 本地客户端。
• CPython 3.8 64 位解释器。
• 发行包 DeepDrawAI_v1_win64.zip。

DeepDraw 引擎和 Codex 运行在同一台 Windows 电脑上。本文使用本地任务，不是在云端任务或 WSL/Linux 中运行 Windows 引擎。

发行包已经包含编译好的引擎模块，不需要安装 Cython，也不需要自行编译 C++。Python 解释器及运行依赖需要另外准备。

DeepDraw 通过 Codex 接收建模指令，发行包本身不要求填写 OPENAI_API_KEY。请先确保你的 Codex 已经能够正常对话和执行本地任务。

二、解压发行包

将压缩包完整解压到一个固定、可写的目录，例如：

D:\\DeepDrawAI_v1_win64

打开该目录，应该能直接看到：

DeepDrawAI_v1_win64/
├─ deepdraw.py
├─ README.md
├─ requirements-py38.txt
├─ engine/
├─ modeling/
├─ service/
├─ client/
├─ skill/
├─ scripts/
└─ examples/

如果解压工具额外创建了一层同名文件夹，请以包含 deepdraw.py 的那一层为实际安装目录。

安装 Skill 后尽量不要移动这个目录，因为安装器会记录软件的位置。

三、准备 Python 3.8 和依赖

安装 CPython 时选择 3.8 系列的 Windows 64 位版本。已有其他版本 Python 也没有关系，可以并存；这里需要明确使用 Python 3.8 来启动 DeepDraw 引擎。

下面假设你的解释器位于：

C:\\Python38\\python.exe

请把所有命令中的示例路径换成自己电脑上的实际路径。 以下命令都在 Windows PowerShell 中执行，开头的 & 也需要保留。

先检查版本与位数：

& "C:\\Python38\\python.exe" –c "import sys, struct; print(sys.version); print('bits:', struct.calcsize('P') * 8)"

应当显示 Python 3.8.x，以及 bits: 64。

然后进入软件目录，安装运行依赖：

Set-Location "D:\\DeepDrawAI_v1_win64"
& "C:\\Python38\\python.exe" –m pip install –r requirements-py38.txt

依赖主要包括 PySide2、PyOpenGL 和 NumPy。安装完成后，可以做一次导入检查：

& "C:\\Python38\\python.exe" –c "import PySide2, OpenGL, numpy; print('依赖检查通过')"

使用 解释器路径 -m pip，可以确保依赖安装到引擎实际使用的 Python 中。

四、把 DeepDraw Skill 安装到 Codex

Skill 包含 DeepDraw 的操作说明、调用脚本和 API 参考。安装后，Codex 就能按这套流程启动引擎、执行建模、检查结果和保存模型。

当前官方文档将用户级本地 Skill 目录列为 ~/.agents/skills。下面显式指定这个目录，避免与发行包安装器的默认目录混淆。目录规则及 Skill 的使用方式可参阅 OpenAI 官方 Skill 文档。

仍在发行包根目录下，执行：

& "C:\\Python38\\python.exe" scripts/install_skill.py —engine-python "C:\\Python38\\python.exe" —destination "$env:USERPROFILE\\.agents\\skills"

成功后会输出类似：

Installed skill: C:\\Users\\你的用户名\\.agents\\skills\\deepdraw

安装器会同时生成 installation.json，记录两个位置：

• home：DeepDraw 的解压目录。
• engine_python：Python 3.8 解释器路径。

不要只复制 SKILL.md 文件。 使用安装器可以把调用脚本、参考文档和本机路径配置一并准备好。

已使用旧版 Codex Skill 目录的用户

这个发行包的安装器默认写入 $CODEX_HOME/skills；未设置 CODEX_HOME 时为用户目录下的 .codex/skills。如果你的客户端明确使用该目录，可以省略 –destination：

& "C:\\Python38\\python.exe" scripts/install_skill.py —engine-python "C:\\Python38\\python.exe"

两种方式选择与你的客户端匹配的一种即可，不需要重复安装。

五、在 Codex 中开始第一次建模

打开 Codex，选择解压后的 D:\\DeepDrawAI_v1_win64 作为本地项目目录，并新建一个任务。如果安装的 Skill 尚未出现，重新启动 Codex 后再试。

在对话中输入：

请使用 DeepDraw Skill，新建一个名为 first-box 的引擎会话，
创建宽 100、深 80、高 60 的盒子，命名为 box。
尺寸使用引擎单位。检查尺寸和模型有效性，截图给我看，
打开三维窗口，完成后保持会话。

如果你的客户端支持 $ 技能选择，也可以输入 $deepdraw 选择该 Skill，再填写建模需求。

Codex 将启动本地引擎，执行建模并返回结果。三维窗口标题形如：

DeepDraw AI v1.0 [免费版] — first-box

首次启动包含引擎授权验证。只有验证成功，服务才会接受建模请求。

看到模型之后，可以直接继续修改，不必重新创建。 例如：

继续操作 first-box 会话，把 box 的高度改为 90，
保持底面位置不变。检查尺寸，再截图给我看。

六、尝试一个更完整的模型

完成盒子测试后，可以新建另一个模型：

使用 DeepDraw 新建 courtyard 会话，设计一座庭院小亭。
包含两级台阶、四根立柱、横梁、中央开孔的屋顶，
以及一张长椅和背部格栅。
各构件独立建模，并建立方便后续修改的命名集合。
检查模型，截图并打开窗口，保持会话。

随后逐步调整：

把屋顶升高 40 个引擎单位，立柱同步加高，横梁同步上移。

把整张长椅向亭子前方移动 12 个单位，其余构件保持不变。

描述修改时，说清楚修改对象、方向或尺寸，以及需要保留的部分，更容易得到符合预期的结果。

也可以让 Codex 在空会话中运行发行包自带的 examples/middleware_courtyard.py，复现内置的庭院小亭示例。

七、保存模型，下次继续设计

完成一个阶段后，可以直接告诉 Codex：

将当前模型保存为 D:\\DeepDrawModels\\courtyard.dim，
告诉我保存结果，继续保持会话。

下次打开新的 Codex 任务时，可以说：

使用 DeepDraw 新建会话，加载 D:\\DeepDrawModels\\courtyard.dim。
先查看场景结构和命名集合，打开窗口，等待我继续修改。

命名集合和模型描述会随文件保存，为后续定位构件提供依据。

需要结束时，明确说：

保存当前模型，然后关闭这个 DeepDraw 引擎会话。

窗口右上角的关闭按钮只会隐藏窗口；真正结束引擎需要关闭会话，且关闭会话不会自动保存。

八、常见问题

1. Codex 找不到 DeepDraw Skill

检查安装器输出的目录，确认其中存在 deepdraw/SKILL.md、scripts、references 和 installation.json。 确认安装到了当前客户端读取的 Skill 目录，然后重新启动 Codex。

如果仍未发现，可以在本地任务中明确提供文件路径：

请读取 D:\\DeepDrawAI_v1_win64\\skill\\deepdraw\\SKILL.md，
按照里面的说明使用 DeepDraw。
引擎解释器为 C:\\Python38\\python.exe。

2. 安装器提示 Destination exists

表示目标目录已经有同名 Skill，安装器没有覆盖它。已有版本可用时无需重复安装。 需要升级时，先备份旧 Skill，再替换并重新安装，避免丢失自己修改的配置。

3. 找不到 Python、PySide2 或 NumPy

核对 installation.json 中的 engine_python，确保它指向实际存在的 Python 3.8 64 位解释器。 再用这个解释器执行第三节的依赖安装命令。

Codex 使用的 Python 和 DeepDraw 引擎使用的 Python 可以不同；关键是不要把依赖装进另一个环境。

4. 返回 LICENSE_DENIED

这是引擎授权失败。请按提示从 DeepDraw 官网获取最新版本并完成授权，然后使用新的会话名称重新启动。

LICENSE_API_UNAVAILABLE 表示当前引擎缺少授权接口；LICENSE_INITIALIZATION_FAILED 表示授权初始化异常。 授权错误会明确返回给 Codex，不需要反复发送建模指令。

5. 有截图，却看不到三维窗口

引擎可以在隐藏窗口状态下完成建模与离屏渲染。直接告诉 Codex：

显示当前 DeepDraw 会话的窗口，保留现有模型。

窗口中可以选择对象和调整视角。中键拖动旋转，Shift 加中键拖动平移，滚轮缩放。

6. 启动没有成功，或者会话无响应

将实际错误内容交给 Codex 排查。默认日志位于：

DeepDrawAI_v1_win64\\runtime\\sessions\\会话名称\\host.log

结构化启动错误保存在同一目录的 startup_error.json。 如果客户端返回 starting，表示启动仍在进行，应查询会话状态，而不是重复创建会话。 如果建模请求超时，应使用原来的请求 ID 查询结果，避免重复执行修改。

7. 移动了软件目录后无法启动

更新已安装 Skill 的 installation.json 中的 home 为新目录；如果解释器也移动了，同时更新 engine_python。 不要修改发行包中 .pyd 文件的名字。

现在，开始你的第一次设计

环境与 Skill 只需要准备一次。之后，从一个盒子到一座小亭，从创建构件到修改比例，都可以在对话中逐步完成。

打开 Codex，试着说：

“使用 DeepDraw，我们来设计一个空间。”