mcpField
G
gcode

gcode

github.com/earthtojake其他23.9k9.8k 次安装今天更新
代码仓库

关于 gcode

gcode 是一项使用 OrcaSlicer 对 3D 模型切片的技能，可通过命令行或应用操作。它帮助选择已有的打印机、工艺和耗材预设，检查输出设置，并交付 G-code；不会连接打印机。

主要功能

  1. 01通过 OrcaSlicer 命令行切片
  2. 02查找并生成完整预设
  3. 03在 OrcaSlicer 应用中打开模型
  4. 04检查模型尺寸和切片设置
  5. 05按打印机类型交付切片文件

适用场景

  1. 01使用指定预设批量外部切片
  2. 02没有合适预设时手动切片
  3. 03确认模型尺寸是否适配打印床
  4. 04交付 Bambu Lab 或其他打印机的文件

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/earthtojake/text-to-cad --skill gcode

安装后在 Claude Code 中输入/gcode确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

LICENSE
agents/
openai.yaml
scripts/
orca_presets.py

详细介绍

G-code

来源：由 earthtojake/text-to-cad 维护。 以已安装的本地技能文件作为运行时的事实来源；仓库链接仅用于来源追溯和发布审核。

使用 OrcaSlicer 进行切片：可使用无头模式（如下），也可在 OrcaSlicer 应用中打开模型供用户操作。Agent 不会连接打印机：如果是 Bambu Lab 打印机，将结果交给 $bambu-labs；其他打印机则向用户提供 .gcode。

安装 OrcaSlicer

  • macOS：brew install --cask orcaslicer。命令行路径为 /Applications/OrcaSlicer.app/Contents/MacOS/OrcaSlicer。
  • Windows 和 Linux：从 https://github.com/OrcaSlicer/OrcaSlicer/releases 安装一个发行版。命令为 orca-slicer；在 Linux 上，从 AppImage 或 Flatpak 运行。

下文中的 <orca> 指此命令。

无头模式切片

OrcaSlicer 的命令行（https://www.orcaslicer.com/wiki/cli/cli_mode）需要 完整的预设：它不会填入预设的父级设置，并且只会使用兼容打印机名称中包含该打印机的流程进行切片。 scripts/orca_presets.py（Python 3，无依赖项）根据 OrcaSlicer 的预设生成完整预设，先搜索用户自己的预设，再搜索 OrcaSlicer 内置配置文件。

  1. 找出用户的打印机、流程和耗材预设。优先使用用户实际打印时使用的预设；绝不要自行编造，因为错误的热床尺寸或温度可能损坏打印机。

    python scripts/orca_presets.py --list machine --match "MK4S"
python scripts/orca_presets.py --list process --match "@MK4S 0.4"
python scripts/orca_presets.py --list filament --match "PLA @MK4S"

  2. 写入完整预设：

    python scripts/orca_presets.py --printer "Prusa MK4S 0.4 nozzle" \
  --process "0.20mm SPEED @MK4S 0.4" --filament "Prusa Generic PLA @MK4S" \
  --out presets

  3. 进行切片。为 --outputdir 指定绝对路径：

    <orca> model.stl \
  --load-settings "presets/process.json;presets/printer.json" \
  --load-filaments presets/filament-1.json \
  --arrange 1 --slice 0 \
  --outputdir /absolute/path/to/out --export-3mf model.gcode.3mf

    这会在该文件夹中写入 plate_1.gcode（纯 G-code）和 model.gcode.3mf（切片后的 3MF）。命令行可读取 .stl、 .3mf、.obj 和 .amf；先使用 $cad 将 STEP 导出为 STL 或 3MF。 使用 --<setting>=<value> 覆盖单个设置，设置键中的下划线需改为连字符，例如 --layer-height=0.16。

在 OrcaSlicer 中打开

如果用户希望自行选择预设并切片，或找不到可用预设，请在应用中打开模型：macOS 上使用 open -a OrcaSlicer model.stl， Windows 上在 OrcaSlicer 可打开该文件类型时使用 Start-Process model.stl，或在 Linux 上使用 orca-slicer model.stl。该应用也可读取 STEP。

打印前检查

  • <orca> model.stl --info 会显示模型尺寸；模型必须能放进热床。

  • 检查切片设置；OrcaSlicer 会将其写在 G-code 文件末尾：

    grep -E '^; (printer_model|nozzle_diameter|filament_type|nozzle_temperature|hot_plate_temp|bed_temperature) =|printing time' out/plate_1.gcode

    确认这些设置与用户的打印机和材料相符后，再开始打印。

交接

  • Bambu Lab 打印机：使用 $bambu-labs，并提供 .gcode.3mf。
  • 其他打印机：用户可通过打印机应用、Web 界面（PrusaLink、OctoPrint、Mainsail、Fluidd）或 SD 卡打印 .gcode。

评论

支持 Markdown