MaterialCraft 技能用于通过结构化自动化接口操作 MaterialCraft，按用户指定的材质工作流和目标图完成节点式程序化 PBR 材质的构建、编辑、检查与导出。
用途
- 在已有 MaterialCraft 环境中自动化材质图操作，而非替代或安装该应用。
- 支持无头（headless）会话处理文件，或通过 MCP 桥接/应用控制通道操作用户已打开的包与窗口。
主要能力
- 发现运行时命令与节点：用 command.list 与 library.list 查询命令 ID 和节点定义、参数，避免臆造 ID；文档仅列出关键命令，不包含全部 227 个节点。
- 图形编辑：file.new 使用模板（empty、pbr、bricks、stone_tiles、wood、rusty_metal、fabric、ground）新建文件；graph.node.add 添加节点，graph.connect / graph.disconnect 管理连线，graph.node.param 设置带类型的参数值（数值、[x,y]、颜色、枚举、曲线、渐变、函数图），graph.node.base 设置每节点烘焙尺寸、格式、种子与平铺。
- 检查与验证：session.inspect 返回包、图、节点定义与参数、连线、暴露输入、视图与历史；应用中 ui.inspect 还提供图视图和节点/端口的屏幕坐标。用 view.screenshot 或 render 渲染，hq: true 生成含置换、光线追踪 AO 与投影主光的成品渲染；view.2d / view.3d 可指定节点、通道或场景，view.3d.loadMesh 可加载 OBJ/glTF/GLB 网格。
- 文件与导出：headless 模式下文件访问受启动时 --read-root / --write-root 限制；package.open / package.save 处理包；bitmap.import 嵌入位图；outputs.export 全尺寸烘焙并写出 PNG、JPEG、TGA、TIFF、BMP、WEBP、EXR 或 HDR（8/16/32 位）；file.exportMaterial 与 file.sendToTextureCraft 生成或发送 .mcmat 便携材质。
- 批量执行：command.batch 用于已知步骤序列，遇到首个错误即停止，且不是事务，失败前的步骤会保留。
使用方式
- 先定位可执行文件：PATH 中查找 materialcraft 与 materialcraft-cli；macOS 可查 /Applications、~/Applications 或 mdfind；Linux 有 AppImage、Flatpak、deb/rpm、tarball；源码可用 cargo run 构建。不得臆造路径。
- 选择会话：操作用户打开的包时用 MCP 桥接（materialcraft-cli mcp --bridge <port>）或应用控制通道（materialcraft --control <port>）；无人值守处理用 headless MCP（--read-root / --write-root）或 JSON-lines 服务（materialcraft-cli serve）。
- 控制通道每次连接先鉴权：令牌来自 MATERIALCRAFT_CONTROL_TOKEN 或临时目录下的 materialcraft-control-<port>.token；之后每行一个 JSON 对象 {"id","method","params"}，按 id 匹配回复并检查 ok。脚本运行时设 MATERIALCRAFT_NO_PREFS=1 以免改动用户布局；TCP 仅限回环，令牌文件私有，不得打印、提交或写入命令行参数。
- 编辑前先 inspect；重试变更前若连接中断或结果不明，先再次 inspect，避免重复执行。
适用场景
- 批量或无人值守生成纹理贴图与便携材质。
- 程序化构建与调整 PBR 材质图、参数和函数驱动参数。
- 在已打开的应用中通过 UI 合成事件或截屏验证材质效果。
限制
- 技能不安装 MaterialCraft，也不注册 MCP 服务器；缺少可执行文件或连接时需报告具体前置条件。
- 无头会话无法编辑用户当前窗口；headless 文件访问受根目录限制，不得绕过被拒绝的路径。
- 未要求时不应覆盖用户源包，应另存副本。
- 官方文档未提供具体定价、平台支持范围或性能数据，暂未提供。