编辑“︁内容撰写指南”︁（章节）

== 上传 CAD 模型 ==

Robuddy 支持直接上传 STEP、IGES、BREP 等三维 CAD 格式，并在页面中嵌入 3D 预览。

=== 支持的格式 ===
{| class="wikitable"
! 格式 !! 扩展名 !! 说明
|-
| STEP || .step / .stp || 通用三维交换格式（推荐）
|-
| IGES || .iges / .igs || 传统曲面交换格式
|-
| BREP || .brep || OpenCASCADE 原生边界表示
|}

=== 上传步骤 ===

# 点击待编辑页面左侧边栏的「'''上传文件'''」，或直接访问 [[Special:上传文件]]。
# 选择本地的 CAD 文件（如 <code>我的机器人.STEP</code>）。
# '''文件名默认'''：使用 <code>项目名-零件名.格式</code>，例如 <code>机器人大赛-第二十二届-Line-大车.STEP</code>，便于后续引用。
# 填写文件描述（可选），点击「上传文件」。

=== 在页面中嵌入 3D 预览 ===

上传成功后，在页面源代码中插入 <code>&lt;cadviewer&gt;</code> 标签：

<syntaxhighlight lang="html">
<cadviewer file="机器人大赛-第二十二届-Line-大车.STEP" width="800" height="600"></cadviewer>
</syntaxhighlight>

参数说明：
* <code>file</code>：上传的文件名（不含 <code>File:</code> 前缀）
* <code>width</code>：预览窗口宽度（像素），建议 600–800
* <code>height</code>：预览窗口高度（像素），建议 400–600

{{Warning|上传文件命名后不可随意修改，引用的文件名必须完全一致（含大小写和扩展名），否则 3D 预览无法加载。}}

=== 常见问题 ===
* 如果 3D 预览加载失败，检查文件名是否与上传时完全一致。
* 文件大小不宜超过 50MB，过大文件在浏览器端可能加载不出来。
* STEP 格式兼容性最好，推荐优先使用。