klad-app/klad
多媒体与设计一款面向人机协作的 2D 绘画与动画应用,人和编程 Agent 通过命令行在同一张画上作画。
项目介绍
klad 是一款为人和编程 Agent 协作而设计的 2D 绘画与动画编辑器。人在编辑器里用画笔作画,Agent 通过 klad 命令行用同一套笔刷、图层和时间线作画,双方约一秒内就能看到对方的笔触。应用内部没有图像模型:Agent(Claude Code、Codex 或任何能执行命令的工具)决定画什么,klad 只提供绘画工具。
核心设计是让一切保持可编辑的数据形态:一笔保留路径、压力、笔刷和颜色,形状保留控制点,填充保留区域。无论是人还是 Agent 画的笔画,之后都能选中、改色、弯折、移动或删除,每次修改都是共享撤销历史中的一步。此外还支持矢量内容(渐变、发光、附带的开源字体文本)、带洋葱皮、片段和中间帧的动画、带 IK 的骨骼,以及导出 PNG、精灵表或 Godot SpriteFrames 场景 README。
适合希望借助 Agent 又不想放弃笔画级控制权的插画师、动画师和游戏开发者,也适合想通过 CLI 和公开文件格式脚本化作画的开发者。
快速使用
项目目前需要从源码构建,尚无安装包。准备 Rust(通过 rustup)和 just;Linux 上还需安装 pkg-config、libfreetype-dev、libfontconfig1-dev、libxkbcommon-dev 和 libwayland-dev。
git clone https://github.com/klad-app/klad && cd klad
just compile # 首次约需十分钟
target/release/klad open # Linux 上为 target/linux/release/klad open
接着把命令行工具装到终端和 Agent 的 PATH,并打开一张画:
target/release/klad install # Linux 上为 target/linux/release/klad install
target/release/klad open samples/lantern/lantern.klad
要交给 Agent 作画,在目标画作所在目录启动 Agent,提示它先运行 klad skill 和 klad skill drawing 并阅读输出,再创建 scene.klad 并画一幅夜景(提灯的旅人和小生物)。文件生成后,在另一个终端执行 klad open scene.klad 即可看到笔触逐步落下。你可以按 N 在画布上留便签让 Agent 读取,或按 S 接管任意笔画自行修改。两个 Agent 技能文档均为 MIT 许可,由 klad skill 命令输出 Try it。
首次启动会提供分步引导和六张内置示例画;klad samples 可列出示例并复制一张出来。
使用约束
- 许可证: 源码可见(source-available),采用 PolyForm Internal Use 1.0.0 附加若干额外许可,并非开源。个人使用和自行构建免费;上一个纳税年度收入达到 50 万欧元的公司需按使用者购买许可证,且不得再分发源码或构建产物。文件格式、CLI 文档、Agent 技能和
klad-clientcrate 为 MIT 许可 Licence。 - 平台: 主要在 macOS 上开发,支持笔压与倾斜。Linux 和 Windows 上能构建并通过测试,但 Linux 目前只能用鼠标(无数位板压感),Windows 上尚无人实际绘制过。
- 自行构建: 暂无签名安装包,付费构建版计划覆盖 macOS、Windows 和 Linux。
- 功能缺口: 缺少部分插画基础功能,包括多形状同时选择、对齐分布、吸附、网格和 SVG 导入导出;骨骼仍是预览功能,命令可能变动。
- 数据: 每张画是本地普通文件夹,无需账号,每天只检查一次更新(可关闭),适合纳入 git。
HotRepo 点评
klad 于 2026-11-11 首次出现在 HotRepo 的 Rust 语言新项目榜:在约一个半小时的统计窗口内新增 13 Star,总数达到 113;当天的 Show HN 帖子获得 66 分、28 条评论。讨论比常见的发布帖更具体:一位评论者用参考图测试 Agent 绘画,认为效果明显落后于经典的图生视频方案,并把瓶颈归于所用模型 测试反馈 和 作者回应;另一位评论者称让 Agent 生成的角色比常见 LLM 产物自然得多,并附上结果 Agent 成果。这种「笔画级控制真实存在,但当前模型画技有限」的张力值得关注——应用的价值最终取决于 Agent 的绘画水平,而非编辑器本身。
本文由 AI 根据项目 README 生成,更新于 ,以项目官方文档为准。