storytold/artcraft — 交互式 AI 图像与视频创作 IDE

用 2D 画布和 3D 场景控制 AI 图像、视频创作。
本周新增 Star 13,572 ｜ 仓库 Star 总数 35,880 ｜ Forks 5,677

▲ 图 0：ArtCraft 官方角色摆位演示（官方截图）

▲ 图 1：Character Posing 演示（官方截图）

▲ 图 2：Mixed Asset Crafting 演示（官方截图）

一、核心概念：Show, Don't Tell

传统做法是"写提示词 → 抽奖"。ArtCraft 的主张是 先搭场景再生成：在 2D 画布与 3D 场景中固定构图、角色身份、相机位置，生成只是最后一步。

高阶创作能力

快速提示词工作流

二、支持的模型与提供方

ArtCraft 内置 62 个模型目录

图像（16）

视频（25）

音乐与音效（5）：Suno Music、Suno Remix、Suno Sounds、Suno Sample、Seed Audio 1.0

3D 网格（11）：Hunyuan 3D 2.0 / 2.1 / 3 / 3 Sketch / 3.1 Pro / 3.1 Rapid / 3.1 Part / 3.1 Smart Topology、Tripo3D H3.1、Meshy 6、Rodin 2.5 Fast

世界与 Gaussian splats（5）：Marble 1.0 / 1.0 Draft / 1.1 / 1.1 Plus、TripoSplat

† 当前停用　‡ 受限模型，桌面端暂不可用

计划中的集成：Kling、Google、Runway、Luma 的更多支持，以及 OpenArt、Freepik 等聚合订阅接入。

三、部署方式

方式 A：下载稳定版安装包（推荐）

• Windows 与 macOS 稳定版：https://getartcraft.com/
• GitHub Releases（含最新构建）：https://github.com/storytold/artcraft/releases

安装包通常为 .exe（Windows）或 .dmg（macOS），双击安装即可。Linux 需自行从源码构建（见方式 C）。

方式 B：从 GitHub Releases 下载便携包

访问 https://github.com/storytold/artcraft/releases ，下载对应平台的构建产物。macOS 首次打开可能需要：系统设置 → 隐私与安全性 → "仍要打开"。

方式 C：从源码构建（含 Linux）

前置依赖：

macOS / Linux 开发：

git clone https://github.com/storytold/artcraft.git
cd artcraft

# 一个终端里同时启动前端与 Rust/Tauri
./script/artcraft/unix_dev.sh

# 可选：在另一个端口启动空闲端口搜索
ARTCRAFT_DEV_PORT=6200 ./script/artcraft/unix_dev.sh

• 启动器把 Vite 绑定到 127.0.0.1，从端口 5193 起逐个尝试直到可用，不会占用已有监听端口。
• 只有真正绑定前端 socket 后才以该确切 devUrl 启动 Tauri；HTTP 与 HMR WebSocket 共用同一端口，Rust 侧走原生 Tauri IPC，无需额外 HTTP 端口。
• 端口隔离 不创建 独立的账号/数据配置。
• Ctrl-C 会一并停止本次会话的前端、Rust watcher/编译器和桌面应用。

Windows 开发（PowerShell）：

git clone https://github.com/storytold/artcraft.git
cd artcraft

# 启动前端开发服务器
.\script\artcraft\windows_frontend_dev.ps1

# 启动 Tauri Rust 应用
.\script\artcraft\windows_rust_dev.ps1

后端服务与网站构建在 独立的 artcraft-services 仓库 中。本仓库保留桌面端任务数据库 _database/sql/artcraft_migrations/ 与 SQLite 查询缓存 .sqlx/。无数据库服务器时可用 SQLX_OFFLINE=true cargo check -p artcraft 检查 Rust 代码。

验证启动器（不编译 Rust、不开窗口）：

node --test frontend/scripts/unix-dev.test.mjs

四、使用方法

4.1 基本创作流程

1. 登录并进入创作界面
2. 搭建场景：在 2D 画布中拖入图层，或在 3D 场景中摆位布景
3. 设定相机与角色姿态（Character Posing / Scene Blocking）
4. 选择模型并生成
5. 进入画布精修：绘画、蒙版、局部重绘（Canvas Image Editing）
6. 图生视频（Image to Video），调生成控制项
7. 导出

4.2 典型工作流示例

多镜头一致性

• 用 Image to Location 把角色放到固定环境中
• 在同一房间内规划多个镜头
• 每次生成都复用同一环境设定，保证跨镜头一致

2D 分层合成

• Background Removal 抠出主体
• 作为图层叠加到背景上
• 用 Canvas Image Editing 的蒙版精确控制局部变化

图转 3D 再取景

• Image to 3D Mesh 把参考图转成 3D 物体
• 在 3D 场景中旋转、定位、调整相机
• 再以该视角生成图像

角色身份迁移

• 用 Character Posing 摆一个模特人偶姿态
• Character Identity Transfer 让你的角色按该姿态落位
• 保持角色身份一致的同时复用构图

4.3 开发者参考

4.4 常见问题

Q：Linux 上怎么装？
官方仅提供 Windows 与 macOS 稳定版，Linux 需从源码构建（方式 C）。构建依赖 Rust + Node + Tauri CLI。

Q：能离线用吗？
需要联网调用模型 API（ArtCraft 自有模型、Grok、Midjourney、Sora、World Labs 等），本地只负责编排与合成。

Q：模型目录从哪来？
目录源自 artcraft-services 仓库中 crates/service/web/storyteller_web/src/configs/omni_gen/ 下的 image_models.rs、video_models/、audio_models.rs、mesh_models.rs、splat_models.rs。

参考链接

• 仓库：https://github.com/storytold/artcraft
• 官网：https://getartcraft.com/
• Releases：https://github.com/storytold/artcraft/releases
• 开发文档：https://github.com/storytold/artcraft/blob/main/_docs/dev_setup.md
• 路线图：https://github.com/storytold/artcraft/blob/main/ROADMAP.md
• Discord：https://discord.gg/artcraft