Artifex 是 Gatewai 的 GPU 工具链、无头工作流引擎与离线媒体渲染器，以机器优先的 CLI 形式提供，供自主 AI 智能体在本地和离线环境组合、校验、运行并渲染工作流画布，内置 60 多个节点，其中包含 AI 工具。
用法与安装：可通过 npx -y @gatewai.studio/artifex --help 或 pnpm dlx -y @gatewai.studio/artifex --help 按需运行。
凭据与配置：可通过环境变量、当前工作目录的 .env 文件，或 ~/.config/gatewai/credentials.json 设置。GATEWAI_FAL_API_KEY 用于媒体生成节点（如 ImageGen、VideoGen、TextToSpeech、MusicGenerator）；GATEWAI_OPENROUTER_API_KEY 用于 LLM、Lottie Generator Agent 节点；GATEWAI_STORAGE_DIR 可选，指定本地素材存储目录，默认为调用目录下的 ./gw-assets；GATEWAI_CONCURRENT_RENDERS 可选，限制并发渲染操作数量，默认 2，超出部分排队。
命令目录：nodes 打印已注册节点的清单详情（类型、配置 schema 字段、输入/输出句柄）；skill <nodeType> 打印指定节点的 SKILL.md 文档；validate <spec.json> 校验规格布局 schema、节点配置 Zod schema 与边句柄接线，一次性汇总返回全部错误，出错时退出码 2（E_INPUT）；build <spec.json> 在内存中组装图并打印完整拓扑图树，拓扑失败时退出码 3（E_GRAPH）；run <spec.json> 按拓扑顺序运行所需节点、解析输出素材并写盘导出，默认运行全部终端节点，支持 --node、--state、--from-state 等选项；init-node <name> 搭建自定义节点包骨架。
工作流规格：spec.json 定义画布配置、动态导入、节点数组、边接线、加载字体与渲染设置。时间单位混用：多数节点配置（holdMs、durationInMS、trimStart、trimEnd）以毫秒计，Compositor 图层用 startFrame（帧）指定起始位置。Import 节点可在 config.file 直接指向本地文件，CLI 会自动读取并提取元数据注入执行图。无头渲染支持在顶层 fonts 数组注册自定义 TTF 字体并预载入 GPU 缓存。
推荐流程：先用 artifex nodes --json 查询能力清单，再用 artifex skill <node-type> 查看节点约束，然后 validate 与 build 校验，运行时用 --state 保存检查点以避免重复调用昂贵的远程 AI 生成接口，并可配合 --from-state 继续。可将终端或昂贵节点标记为 "locked": true 以阻止其默认执行。具体节点清单、参数与限制请以官方节点目录与各节点 SKILL.md 为准；资料未提供的收费、价格与平台信息暂未提供。