Klad 推出可由 coding agent 操作的繪圖與動畫工具
Show HN: Klad, a paint app your coding agent can drive (source-available)
Klad 推出首個公開版本,讓使用者與 coding agent 透過同一個繪圖與動畫專案協作,並即時看到彼此新增的筆畫。
- - 編輯方式:Agent 透過命令列操作畫筆、圖層與時間軸。
- 筆畫、形狀和填色都保留為可個別修改的資料。
AI 伴隨問答
針對這篇報導有疑問?可直接點選快捷問題或向 AI 追問背景脈絡與技術細節:
Klad 將繪圖保留為可逐筆修改的筆畫資料,並讓人與 coding agent 共用畫布,呈現一種可介入、可回溯的協作繪圖流程。
給你的 AI 代理真正的畫筆。klad 是一款 2D 繪圖與動畫 App,可與程式碼代理搭配使用。你用筆在編輯器裡作畫。代理則透過 klad 命令列,使用相同的畫筆,在同一張圖上作畫;你們都能即時看到彼此的筆畫。
klad 沒有影像模型。你的代理(Claude Code、Codex,或任何能執行命令的工具)決定要畫什麼;klad 提供畫筆、圖層和時間軸。無論是你還是代理畫下的內容,都會保留原樣:筆畫會保留路徑、筆壓、畫筆和顏色;形狀會保留控制點;填色會保留區域。因此不用反覆生成、碰運氣:哪片葉子看起來不對,就修改那片葉子。
代理接到「幫我的遊戲畫一隻小小的芽芽生物」的要求後,畫了 4,344 筆並填色。你可以修改它們:替葉子重新上色、調整嘴巴的弧度、移動一抹汙漬、暈開腮紅。接著代理為它製作動畫:將生物的部位分成五個群組,用 205 個關鍵影格讓它們動起來,而且不用重畫任何影格。
![]() |
![]() |
使用 Claude Fable 5.2 製作的圖:生物、場景和道具組都是透過 klad 命令列逐筆繪製而成。
- 網站與指南:klad.studio,可逐筆重播這些圖。
- 授權條款:原始碼可供檢視,但不是開放原始碼。可免費自行開發和使用,也可在年營收不到 500,000 歐元的公司內使用。請參閱 授權條款。
- 執行平臺:macOS(支援筆壓與傾斜)。也能在 Linux 和 Windows 上建置並通過測試,每次變更都會檢查;目前在 Linux 上啟動編輯器時只能使用滑鼠,而 Windows 版還沒有人用來作畫。
- 狀態:早期版本。這是第一個公開版本,需要自行建置:請參閱 從原始碼建置。
為什麼不直接生成圖片?
影像生成器交給你的是畫素,接下來能做的只有再擲一次骰子。klad 將每一筆和每次填色都保留為資料:畫在哪裡、筆壓多重、使用的畫筆和顏色。過了幾小時後,你仍能選取其中任何一筆,無論是你畫的還是代理畫的,然後重新上色、調整弧度、移動或刪除。
- 它畫的是顏料,不只是向量。筆畫會像向量一樣保留路徑和筆壓,同時也會呈現顏料的質感。載入的油彩會留下能映照光線的筆觸隆起;塗抹工具會拖曳圖層上已有的顏料。塗抹本身也會保留為筆畫:之後移動它時,klad 會在新位置重新混色。
- 也能只使用向量。可編輯控制點的形狀、漸層、光暈,以及以約五十種隨附開放字型呈現的真實文字,適合製作海報、封面和卡片。
- 它是一款完整的繪圖與動畫 App。有二十多種畫筆和畫筆編輯器、圖層、遮色片、剪裁、效果、附洋蔥皮和片段的時間軸、以關鍵圖畫製作的中間畫格、支援 IK 的骨架,以及 PNG、精靈圖集或直接匯出到 Godot 的功能。
- 你的圖始終由你掌控。每張圖都是電腦裡的一個普通檔案資料夾,klad 不需要帳戶。它每天只會檢查一次新版,你也可以關閉這項功能。編輯時只會變更所編輯內容的檔案,因此圖稿很適合用 git 管理。
與你的代理合作
- 提出需求。用簡單的文字告訴代理這張圖需要什麼:替旅店畫一盞燈籠,從左側打光,並放在獨立圖層上。
- 觀看。它透過
klad命令列繪圖,筆觸大約一秒後就會出現在你的編輯器裡。 - 指示。在畫布上釘選備註,或選取你指的部分(「這一側多加點苔蘚」)。代理程式會同時讀取兩者。
- 接手。想親手重畫哪裡都可以,代理程式的筆觸也一樣。它的筆觸會標示為代理程式所畫,而且每項變更都是共用歷史紀錄中的一個步驟,因此你可以復原其中任何變更。
起始提示詞在 試用 下方。klad skill 會在 docs/skill/SKILL.md 輸出代理程式技能:如何觀察圖畫、修改圖畫並檢查結果。另一個技能 klad skill drawing(docs/skill/drawing/SKILL.md)則會教它繪圖技巧:規劃畫面、形體上的光線、明暗、邊緣、色彩、材質,以及如何評估結果。兩者都採用 MIT 授權,因此可搭配任何代理程式和工具使用。開啟圖畫,就能觀看並一起畫:
代理程式畫出來的效果,取決於使用哪個代理程式,以及你給它多少指引。這些技能會教它使用工具和一些繪圖技巧;剩下的就交給你手中的筆。
給開發者:圖畫就是資料
在編輯器裡能做的每件事,也都有對應的 klad 命令,因此指令碼或代理程式都能編輯你目前開啟的同一張圖。它會以 JSON 讀取筆觸,透過筆觸位址修改任意筆觸,並以 JSON ops 套用一批編輯。
| 操作 | 在編輯器中 | 透過指令碼或代理程式 |
|---|---|---|
| 繪圖 | 用 B 和具壓力感應的筆 | klad stroke art.klad l4 --brush oil --path 'M100 400 C 300 200 500 600 700 400' |
| 之後修改筆觸 | 按 S 選取,接著重新上色、調整大小或移動;按 A 調整路徑 | klad set art.klad c4:s12 size=3.5 color=#3355aa |
| 讀取現有內容 | 用 S 指向它 | klad strokes art.klad l4 --json |
| 平面色彩 | 按 G,依據線條圖層填色 | klad fill art.klad l2 --at 820,640 --ref lines --gap 4 --color skin |
| 指向某個物件 | 按 N 釘選備註,按 S 選取 | klad notes art.klad、klad selection art.klad |
| 中間影格 | 中間影格視窗 | klad inbetween art.klad --layers lines,colour --from 0 --to 6 |
| 匯出 | 按 cmd E,或從動畫片段匯出至 Godot | klad export art.klad --godot ../game/art |
| 復原 | 按 cmd Z,或使用「歷史紀錄」窗格 | klad undo art.klad |
檔案格式採用 MIT 授權,並且有完整的位元組層級檔案(docs/format.md),因此其他應用程式和遊戲引擎都能讀寫 klad 圖檔,不論是否使用 klad。
專為遊戲打造
道具、角色、背景和逐格動畫。畫出關鍵姿勢,klad 就會逐個部分補上中間影格;它會檢查動作弧線(例如腳滑動,或某個部分陷入地面),根據第一張圖為每張圖上色,並匯出精靈圖集,或包含各動畫片段時間設定的 Godot SpriteFrames 場景。
klad inbetween creature.klad --layers lines,colour --from 3 --to 5 --spacing in-out klad arcs creature.klad --track 'lines:near leg' --clip walk --check klad export creature.klad --godot ../game/art
試用
git clone https://github.com/klad-app/klad && cd klad just compile # about ten minutes the first time target/release/klad open # on Linux: target/linux/release/klad open
接著讓你的代理程式繪圖
-
將
klad加入你的路徑,讓你和代理程式都能使用:target/release/klad install(Linux 上使用target/linux/release/klad install;Mac 可能會要求輸入密碼)。 -
在要存放圖畫的資料夾中啟動你的程式碼代理程式(Claude Code、Codex,或任何能執行命令的工具),然後貼上:
執行
klad skill和klad skill drawing,並閱讀它們輸出的內容。接著建立 scene.klad 並繪製一幅夜景:一位戴兜帽的旅人朝著一座廢墟拱門舉起提燈,一隻小生物跟在後方,採用平面陰影,並以提燈照明。 -
建立好
scene.klad後,在另一個終端機中開啟它,觀看筆觸逐一齣現,並一起繪圖:klad open scene.klad。 -
接著引導它。按 N 在畫布上釘選備註(「這一側多加點苔蘚」),並告訴代理程式讀取你的備註;或者按 S 選取任意筆觸,親自修改。
每個建置版本都包含 klad 命令列工具、編輯器、字型、授權、代理程式技能,以及六個可供參考和繪製的範例圖(啟動畫面會顯示這些範例;klad samples 會列出它們並複製其中一個)。首次啟動時會提供入門步驟:繪製形狀、填色,並將圖畫交給代理程式。docs/guide/ 中的指南會逐步示範如何在編輯器中繪畫、選取、填色、製作動畫、設定骨架和匯出,從開始使用著手。
從原始碼建置
第一次建置約需十分鐘。
- 使用 rustup 和
just安裝 Rust(brew install just,或cargo install 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和klad-editor(Linux 上則在target/linux/release/中)。建置成果可供你個人使用;若你的公司去年營收未達 500,000 歐元,也可供公司使用(請參閱授權)。target/release/klad open會在啟動畫面開啟編輯器:建立圖畫並開始繪製,或從入門步驟開始(在編輯器中選擇「Help > First steps」)。target/release/klad install會將klad加入你終端機的路徑,供你和代理程式使用(編輯器的檔案選單中也有相同功能,名稱為「install the klad command」)。just samples會在samples/中建置範例圖(燈籠、行走中的生物、奔跑的快遞員、地下遺跡、旅店招牌、樹、草地、塗繪的立體物、檸檬碗,以及同一幅以筆刷筆觸重新繪製的畫、彈跳球、墨水範例);使用target/release/klad open samples/lantern/lantern.klad開啟其中一個。samples/shipped.json中列出的六個範例會顯示在啟動畫面,也會包含在每個建置版本中(packaging/samples.sh)。- 在 Mac 上,
just app會在dist/中建立klad.app和磁碟映像檔;just dist會將這臺電腦的建置成果打包成封存檔。每臺電腦都會為自身平臺建置:Mac 建置 Mac 版本,Linux 建置 Linux 版本。
目前尚待完善之處
- 需要自行建置。目前還沒有安裝程式。macOS、Windows 和 Linux 的簽署版本正在規劃中,並採用與原始碼相同的授權;請在 klad.studio 上留下電子郵件,以便收到推出通知。
- 編輯器是在 Mac 上開發的。在 Linux 上可以啟動並使用滑鼠繪圖,但目前不支援繪圖板的壓力感應。在 Windows 上可以建置,測試也都通過了,但還沒有人在該平臺上用它繪圖,歡迎告訴我們你的使用情況。
- 還缺少一些插畫基本功能:一次選取多個形狀、對齊與分散、貼齊、格線,以及 SVG 匯入和匯出。
- 骨架功能仍屬預覽版:相關命令仍可能變更。
- klad 持續更新時,舊圖畫仍可開啟:格式版本更新時會一併進行遷移。
以此為基礎開發
docs/format.md:圖畫的檔案格式,足以讓任何程式讀取和寫入圖畫。docs/cli.md:所有命令及其選項(klad <command> --help會輸出相同內容)。crates/client:klad-client,一個小型 Rust crate,可執行 klad 命令、以 JSON ops 套用編輯,並讀回圖畫。docs/DESIGN.md:klad 的建置方式,包含 CLI、筆刷引擎、算繪、編輯器和相依專案。CONTRIBUTING.md:建置、測試、程式碼規範,以及如何提交變更。samples/:從零開始產生圖畫的工具,是檢視 ops 實際用法的最佳起點。
just build # release build of the klad CLI and the editor just test # every test, and the drawkit check just lint # rustfmt and clippy, warnings as errors just audit # licences, RustSec advisories, sources, and the notices are current just samples # build the sample drawings
授權
klad 原始碼可供使用,但並非開放原始碼,著作權屬於 Indicode BV。
- 這款應用程式,也就是下一點未列出的所有內容,採用PolyForm Internal Use License 1.0.0授權,並附有三項額外許可和一項限制(
LICENSE):你可以免費從原始碼建置程式,供個人用途使用,也可以在公司內部使用;你可以將修改內容傳送給 Indicode BV,提議將其納為貢獻;你用它繪製的圖畫歸你所有,可以分享,其中包含筆刷設定和 klad 放入的圖片副本。限制:上一個課稅年度營收達 500,000 歐元或以上的公司(連同其控制或受其控制的公司計算),必須為每位代表公司使用 klad 的人購買授權。你可以為這些用途建置和修改程式,但不得以原始碼或建置版本的形式散佈。 - 在 itch.io、Steam 或向 Indicode BV 購買建置版本,即可取得該付費授權;建置版本也採用相同條款授權:一份授權涵蓋原始碼和建置版本,不另設終端使用者授權。
- 這些檔案採用 MIT License(
LICENSE-MIT)授權,因此任何程式或代理程式都能處理 klad 圖畫:docs/format.md(檔案格式)、docs/cli.md(命令參考)、docs/skill/(代理程式技能)和crates/client/(klad-clientcrate)。 - 貢獻內容依貢獻者授權協議(
CLA.md)授權給 Indicode BV,以納入 klad 和其銷售的建置版本;請參閱CONTRIBUTING.md。
klad 使用開放原始碼程式庫、字型和 Skia 建置;其授權條款列於 THIRD-PARTY-NOTICES.md,也可透過 klad licences 和編輯器的「關於」視窗檢視。






