OpenPencil

全球首個開源 AI 原生向量設計工具。
_{並行智能體團隊 • 設計即程式碼 • 內建 MCP 伺服器 • 多模型智慧}

English · 简体中文 · 繁體中文 · 日本語 · 한국어 · Français · Español · Deutsch · Português · Русский · हिन्दी · Türkçe · ไทย · Tiếng Việt · Bahasa Indonesia

_{點擊圖片觀看示範影片}

_{The trend above is rendered with HyperWeave — an experimental SVG artifact layer for agents.  Explore →}

`）提供 stdio 傳輸，並由執行中的應用程式提供即時 HTTP 端點（`127.0.0.1:/mcp`） - 從終端機進行設計自動化：透過任意 MCP 相容的智能體讀取、建立和修改 `.op` 檔案 - **分層設計工作流** — `design_skeleton` → `design_content` → `design_refine`，適用於高保真多區塊設計 - **分段提示詞擷取** — 僅載入所需的設計知識（schema、layout、roles、icons、planning 等） - 多頁面支援 — 透過 MCP 工具建立、重新命名、重新排序和複製頁面 **程式碼生成** - React + Tailwind CSS、HTML + CSS、CSS Variables - Vue、Svelte、Flutter、SwiftUI、Jetpack Compose、React Native ## CLI — `op` 全域安裝後即可從終端機控制設計工具： ```bash brew install zseven-w/openpencil/op ``` ```bash op start # 啟動桌面應用程式 op start --headless --file design.op # 啟動無頭伺服器 op design @landing.txt # 從檔案批次設計 op design @ui.js # 支援迴圈的沙箱 JavaScript op insert '{"type":"rectangle"}' # 插入節點 op import:figma design.fig # 匯入 Figma 檔案 cat design.dsl | op design - # 從 stdin 管道輸入 ``` 支援內嵌字串、`@filepath` 與 stdin（`-`），可搭配桌面應用程式、Web 伺服器或檔案型無頭伺服器使用。所有命令請查閱 [CLI 命令參考](./crates/op-cli/src/usage.txt)。 **LLM 技能** — 安裝 [OpenPencil Skill](https://github.com/ZSeven-W/openpencil-skill) 外掛，教 AI 智慧體使用 `op` 進行設計。可執行 `op install` 為偵測到的 Agent 安裝，或使用 `op install --target codex` 指定目標。 ## 功能特色 **畫布與繪圖** - 無限畫布，支援平移、縮放、智慧對齊參考線和吸附 - 矩形、橢圓、直線、多邊形、鋼筆（貝茲曲線）、Frame、文字 - 布林運算 — 聯合、減去、交集，搭配上下文工具列 - 圖示選擇器（Iconify）和圖片匯入（PNG/JPEG/SVG/WebP/GIF） - 自動版面配置 — 垂直/水平方向，支援間距、內邊距、主軸對齊、交叉軸對齊 - 多頁面文件，支援分頁導覽 **設計系統** - 設計變數 — 顏色、數字、字串令牌，支援 `$variable` 參照 - 多主題支援 — 多個主題軸，每個軸有多個變體（亮色/暗色、緊湊/舒適） - 元件系統 — 可重複使用元件，支援實體和覆寫 - CSS 同步 — 自動生成自訂屬性，程式碼輸出中使用 `var(--name)` - 可重複使用 UIKit — 從 `.pen` 檔案匯入/匯出元件套件 **AI 與智能體** - 提示詞轉畫布，支援串流生成與編排器驅動的空間分解 - 並發 Agent 團隊 — 多位設計師並行處理不同區塊，每位成員帶畫布指示器 - 分層工作流 — `design_skeleton` → `design_content` → `design_refine`，每個階段使用聚焦的提示詞 - 風格指南 — 50+ 內建風格（glassmorphism、brutalist、retro 等），支援基於標籤的模糊匹配，並接入規劃與生成流程 - 多模型能力設定檔 — 依模型層級自動適配思考模式、推理強度與提示詞形態 - 內建智能體執行環境（Rust）+ Anthropic、Claude Agent SDK、OpenCode、Codex、Copilot、Google Gemini API 提供商 - 中國大型語言模型 Anthropic 格式透傳 — Kimi、Zhipu、GLM、DouBao、Ark、Bailian/DashScope、ModelScope、Coding Plans **協作** - 經過身分驗證的點對點工作階段，支援公共中繼回退與內建的區域協作 Hub - 使用 10 位帶區域標籤的配對碼加入 — 區域網路工作階段無需帳號 - 即時遠端游標、跨帳號協作，以及帶逐條編輯詳情和可重播已捨棄編輯的衝突面板 - `--serve-web` daemon 的線上多租戶模式，向 op-hub 進行身分驗證並支援跨帳號租戶共享 - 裝置登入 — 透過 serve-web daemon 從瀏覽器登入，編輯器中顯示頭像與使用者名稱 **簡報** - 六個 16:9 簡報範本，配備範本選擇器，另有投影機尺寸的 AI 簡報規劃 — 一畫面一張投影片 - 以投影片放映方式進行簡報，配有簡報者控制 - 將簡報匯出為 PDF（每張投影片一頁）、自包含的投影片放映 HTML 檔案、可編輯的 PowerPoint（`.pptx`），或 hyperframes 影片合成 - 投影片軌道導覽器；Agent 會驗證簡報畫板的幾何（長寬比、溢位、置中）以及提示詞 **範本與網頁擷取** - 場景範本中心 — 一個可瀏覽的目錄，涵蓋六大場景下的 58 個範本，從「檔案 ▸ 從範本新增」開啟 - 提示詞中心，包含 web、儀表板、元件與修改項目及視覺化提示詞預覽 - 素材中心 — 全視窗響應式圖庫，配有雙動作範本與 DESIGN.md 風格匯入 - [Chrome 網頁擷取擴充功能](https://chromewebstore.google.com/detail/openpencil/ahfofgelkdaobcmglejmjbpnajhpgcij) — 將任意網頁快照到 OpenPencil，支援高保真的 HTML / 版面擷取；快照會送達你帳號在 hub 上的收件匣，或在離線時下載為一個可直接開啟的 `.op` 檔案 **Git 整合** - 複製精靈，支援 SSH / HTTPS 認證與 SSH 金鑰管理 - 分支選擇器 — 建立、切換、刪除、合併，全部在 Git 面板中完成 - 拉取 / 推送級聯，支援認證重試與非快轉推送處理 - 資料夾模式三路合併，在磁碟上追蹤 `MERGE_HEAD` 狀態 - 衝突面板 — 提供逐節點 / 逐欄位三路卡片、內嵌 JSON 編輯器、批次操作與內嵌 diff 區塊 - 遠端設定與 SSH 金鑰介面；整個 Git 功能涵蓋 15 種語言的 i18n **匯出** - 畫布匯出 — PNG、JPEG、WEBP、PDF（`Cmd+Shift+P`） - 程式碼匯出 — React + Tailwind、HTML + CSS、Vue、Svelte、Flutter、SwiftUI、Jetpack Compose、React Native - 增量 MCP 程式碼生成流水線 — `codegen_plan`、`codegen_submit_chunk`、`codegen_assemble`、`codegen_clean` **Figma 匯入** - 匯入 `.fig` 檔案，保留版面配置、填色、筆觸、效果、文字、圖片和向量圖形 **桌面應用程式** - 原生 macOS、Windows 和 Linux — 單一自包含二進位檔（winit + GPU Skia，無 Electron） - `.op` 檔案關聯 — 雙擊即可開啟，支援單一實體鎖定 - 背景檢查 GitHub Releases 更新 - 原生應用程式選單，支援另存新檔、開啟最近使用，以及關閉時的未儲存變更對話框 - 最近使用檔案持久化 ## 技術堆疊 | | | | ---------------- | ---------------------------------------------------------------------------------- | | **核心** | Rust workspace（`crates/`）— 編輯器狀態、widgets、hosts、MCP、AI、程式碼生成 | | **渲染** | 全平台 GPU Skia — 原生端使用 `skia-safe`（GL），瀏覽器端使用 CanvasKit（WASM/WebGL2）| | **UI 框架** | jian — 內建的純 Rust GPU-Skia UI 框架：widgets、版面配置、事件、熱重載（`vendor/jian`） | | **視窗系統** | winit（vendored `casement` fork） | | **桌面端** | 原生二進位檔 `openpencil-desktop` — 無需瀏覽器引擎 | | **Web SDK** | `op-web-sdk` + React 19 / Vue 3 轉接器 — 唯讀 `.op` 檢視器（TypeScript） | | **CLI** | `op` — 終端機控制、批次設計 DSL | | **AI** | 內建 Rust Agent 執行環境 · Anthropic SDK · Claude Agent SDK · OpenCode SDK · Copilot SDK | | **Lint** | clippy · rustfmt（Rust）· oxlint · oxfmt（Web SDK） | | **檔案格式** | `.op` — 基於 JSON，人類可讀，對 Git 友好 | ## 生態系 OpenPencil 是 **[ZSeven-W](https://github.com/ZSeven-W)** 出品的一系列純 Rust、AI 原生工具家族中的一員。它們彼此協作：`jian` 渲染 OpenPencil，`agent-rs` 執行它的智能體，`noema` 負責記憶，`zode` 則從終端機進行設計。 | 專案 | 簡介 | | ---- | ---- | | **[Zode](https://github.com/ZSeven-W/zode)** | 面向終端機的開源、AI 原生程式設計助手 — 一個快速的 Rust TUI（`ratatui`），可讀取你的程式碼、執行命令、搜尋檔案並管理 git。透過 MCP 驅動 OpenPencil。 | | **[agent-rs](https://github.com/ZSeven-W/agent-rs)** | 用於交付 LLM 智能體的純 Rust 非同步執行環境 — 多提供商、端到端工具能力、結構化權限、真正的 MCP、零 `unsafe`。為 OpenPencil 內建的智能體執行環境（`vendor/agent`）和 Zode 提供動力。 | | **[jian](https://github.com/ZSeven-W/jian)** | 純 Rust、GPU-Skia UI 框架 — widgets、版面配置、事件和熱重載集於一棧。將宣告式的 `.op` 文件變為原生、AI 可控的應用程式，無需 JS 執行環境、無 DOM、無 Electron。OpenPencil 的 UI 框架（`vendor/jian`）。 | | **[noema](https://github.com/ZSeven-W/noema)** | 面向程式設計智能體的本地優先、非向量記憶系統。以可檢視的檔案形式提供持久記憶、為新項目提供審閱佇列，以及詞彙式（無需嵌入）召回 — 適用於 Zode、Codex、Claude Code 和 MCP 執行環境。 | ## 為何選擇 Rust OpenPencil 已以 **Rust** 從頭重寫完成（[#129](https://github.com/ZSeven-W/openpencil/issues/129)）。重寫工作已經完成——TypeScript + Electron 版本的編輯器已在 `v0.7.5` 退役，本存放庫中的 Rust workspace 就是產品本身：一個原生核心，體積大幅縮小、速度更快，並能從單一程式碼庫支援更多平台。 | | TypeScript + Electron（已退役，`v0.7.5`） | Rust（現行版本） | | --------------------- | ------------------------------------------------ | -------------------------------------------------------------------- | | **桌面端執行環境** | Electron — 內建 Chromium + Node.js | 原生視窗（`winit` + GPU Skia），無需瀏覽器引擎 | | **桌面端安裝體積** | 每次安裝包含完整 Chromium 執行環境 | 單一自包含二進位檔 — **55.5 MB** | | **Web 傳輸大小** | JS + WASM 套件 | **8.2 MB** wasm / **2.18 MB** gzip 傳輸 | | **渲染** | Web 上的 CanvasKit/Skia | 在**所有**目標平台共用同一套 GPU 加速 Skia 後端 | | **記憶體** | JavaScript GC 暫停 | 無 GC — Rust 所有權機制，延遲可預測 | | **程式碼庫** | Web 技術棧 + Electron | 單一 Rust workspace：編輯器 · CLI · MCP · AI · 程式碼生成 · Figma · Git | | **支援平台** | Web + 桌面端，兩套獨立技術棧 | 桌面端（macOS/Win/Linux）· 行動端（iOS/Android）· 瀏覽器 — 同一核心 | **實測改善成果** - **極小體積** — 整個桌面應用程式僅為一個 **55.5 MB** 原生二進位檔，而非打包瀏覽器引擎加上 Node 執行環境。Web 版本在拆分圖示目錄後為 **8.2 MB** 原始大小 / **2.18 MB** gzip（傳輸減少 −48%）。 - **可擴展至大型文件** — **10,000 個節點**的即時畫布（巢狀自動版面配置，四層深）可在**無 panic 且閒置 CPU 約 ~0%** 的情況下完成讀寫與版面快照；全部 10k 節點的完整版面快照約在 **~0.68 s** 內返回。 - **快速互動** — 縮放平移不再在每個影格重新序列化文件（單一熱路徑修正將滾輪縮放 CPU 佔用從 **~69% 降至 ~0%**）；拖曳以增量方式更新場景、文字測量結果已快取，且每影格重繪次數合並為一次。 - **一個核心，全平台** — 相同的編輯器狀態與渲染後端，透過 WASM 編譯至原生桌面端、行動端和瀏覽器——無需維護多套平行實作。 - **GPU Skia 全平台統一** — 原生端透過 `skia-safe` 在 GL 上下文渲染；瀏覽器端透過 CanvasKit 在 WebGL2 上渲染——相同的繪圖程式碼，相同的輸出結果。 - **原生無障礙支援** — 在 macOS、Windows 和 Linux 使用 AccessKit，在 Web 上使用 DOM 鏡像，而非依賴瀏覽器的 a11y 樹狀結構。 - **單一型別檢查 workspace** — MCP 宿主、CLI、AI 供應商、程式碼生成、Figma 匯入和 Git 整合全部位於單一 Rust workspace，並由 CI 中的 `cargo-deny` 進行供應鏈管控。 > **狀態：** TypeScript 版編輯器已在 `v0.7.5` 退役，僅存於 Git 歷史紀錄中；本存放庫即為 Rust workspace。Rust 產品正在積極開發中（請見下方路線圖）。 ## 專案結構 ```text openpencil/ ├── crates/ Rust workspace — 產品本體 │ ├── op-editor-core/ 正典 `.op`（PenDocument）編輯器狀態 + EditorCommand + 設計變數 │ ├── op-editor-ui/ 平台無關的 widgets + RenderBackend facade（wasm32-clean） │ ├── op-editor-host-core/ 所有 host 共用、與傳輸方式無關的 host 狀態機 │ ├── op-host-native/ 原生 host 函式庫 — winit + skia-safe GL（桌面端 + 行動端） │ ├── op-host-web/ 瀏覽器套件 — wasm32 cdylib，CanvasKit 渲染器 │ ├── op-host-desktop/ 桌面二進位檔 `openpencil-desktop`；同時也是 `--serve-web` daemon │ ├── op-host-services/ Headless serve-web / MCP daemon 函式庫 │ ├── op-host-web-server/ 輕量、無 GL 依賴的 web-server 二進位檔 │ ├── op-cli/ CLI 工具 — `op` 命令 │ ├── op-mcp/ MCP 伺服器 — 工具、批次設計、分層工作流 │ ├── op-ai/ AI 提供商、聊天執行環境、串流處理 │ ├── op-ai-skills/ AI 提示詞技能引擎（分階段 prompt 載入） │ ├── op-orchestrator/ 並行 Agent 團隊編排 │ ├── op-codegen/ 程式碼生成器（React、HTML、Vue、Flutter...） │ ├── op-figma/ Figma .fig 檔案解析器與轉換器 │ ├── op-git/ Git 整合 — 複製、分支、推送/拉取、合併 │ └── ... op-opmerge / op-pen-loader / op-design-lint / op-i18n / │ op-config-store / op-process-io / op-acp / op-smoke / ... ├── packages/ Web SDK workspace（Bun） │ ├── op-web-sdk/ 唯讀 `.op` Web 檢視器 SDK（包裝 wasm 套件） │ ├── op-web-sdk-react/ React 19 轉接器 │ └── op-web-sdk-vue/ Vue 3 轉接器 ├── vendor/ 內建子系統（Git submodules） │ ├── jian/ GPU-Skia UI 框架 — 元件/渲染/事件 │ ├── casement/ winit fork │ └── agent/ 跨產品 Rust Agent 執行環境（agent-rs） └── .githooks/ Pre-commit 版本漂移檢查 ``` ## 鍵盤快捷鍵 | 按鍵 | 操作 | | 按鍵 | 操作 | | ----------- | ------------ | --- | ------------- | ----------------------- | | `V` | 選取 | | `Cmd+S` | 儲存 | | `R` | 矩形 | | `Cmd+Z` | 復原 | | `O` | 橢圓 | | `Cmd+Shift+Z` | 重做 | | `L` | 直線 | | `Cmd+C/X/V/D` | 複製/剪下/貼上/重複 | | `T` | 文字 | | `Cmd+G` | 群組 | | `F` | Frame | | `Cmd+Shift+G` | 解散群組 | | `P` | 鋼筆工具 | | `Cmd+Shift+P` | 匯出 (PNG/JPG/WEBP/PDF) | | `H` | 手形（平移） | | `Cmd+Shift+C` | 程式碼面板 | | `Del` | 刪除 | | `Cmd+Shift+V` | 變數面板 | | `[ / ]` | 調整圖層順序 | | `Cmd+J` | AI 聊天 | | 方向鍵 | 微移 1px | | `Cmd+,` | 智能體設定 | | `Cmd+Alt+U` | 布林聯合 | | `Cmd+Alt+S` | 布林減去 | | `Cmd+Alt+I` | 布林交集 | | `Cmd+Shift+S` | 另存新檔 | ## 指令碼命令 ```bash # Product (Rust — run from the repo root) cargo build --workspace # Build all crates (add --release for prod) cargo test --workspace # Run all tests cargo check --workspace # Type check cargo clippy --workspace --all-targets -- -D warnings # Lint cargo fmt --all # Format bash scripts/start-web-rust.sh # Web dev server (wasm bundle + headless host) cargo run -p op-host-desktop # Desktop app (binary: openpencil-desktop) cargo run -p op-cli -- # CLI (binary: op) # Web SDK / JS tooling (run from packages/) cd packages && bun run lint # Lint the web SDK (oxlint); also: bun run format cd packages && bun run generate-iconify-catalog # Regenerate the Rust icon catalog assets # 版本同步（從存放庫根目錄執行） scripts/sync-version.sh # Sync all managed versions from root Cargo.toml tools/check-version-sync.sh # Verify all managed versions match root Cargo.toml ``` ## 參與貢獻 歡迎貢獻！請查閱 [CLAUDE.md](./CLAUDE.md) 了解架構細節和程式碼風格。 1. Fork 並複製存放庫 2. 啟用版本漂移檢查：`git config core.hooksPath .githooks` 3. 建立分支：`git checkout -b feat/my-feature` 4. 執行檢查：`cargo test --workspace && cargo clippy --workspace --all-targets -- -D warnings` 5. 使用 [Conventional Commits](https://www.conventionalcommits.org/) 提交：`feat(canvas): add rotation snapping` 6. 向 `main` 分支發起 PR ## 路線圖 - [x] 設計變數與令牌，支援 CSS 同步 - [x] 元件系統（實體與覆寫） - [x] 帶編排器的 AI 設計生成 - [x] MCP 伺服器整合，支援分層設計工作流 - [x] 多頁面支援 - [x] Figma `.fig` 匯入 - [x] 布林運算（聯集、減去、交集） - [x] 多模型能力設定檔 - [x] Cargo workspace，包含可重複使用的 Rust crate 與 Web SDK 套件 - [x] Rust 桌面端與 Web 端編輯器 - [x] CLI 工具（`op`）終端控制 - [x] 內建 Rust Agent Runtime，支援多提供商 - [x] 國際化 — 15 種語言 - [x] 基於 wasm 的 JavaScript、React 與 Vue Viewer SDK - [x] Style Guides，支援以標籤配對和 MCP 工具 - [x] Concurrent Agent Teams，支援任務委派和畫布狀態指示 - [x] Git 整合（複製、分支、推送/拉取、資料夾模式三路合併） - [x] 畫布匯出（SVG / PNG / JPEG / WEBP / PDF） - [x] 協同編輯 — 經過身分驗證的 P2P、公共中繼與區域 Hub - [x] 簡報 — 範本、投影片放映簡報者，以及 PDF/HTML/PPTX/影片匯出 - [x] 裝置登入與線上多租戶 Web 託管 - [x] Chrome 網頁擷取擴充功能，支援 HTML / 瀏覽器快照匯入 - [ ] 外掛程式系統 ## 貢獻者 ## 贊助者 OpenPencil 免費且開源,開發完全由覺得它好用的人們贊助 —— 感謝你讓這塊畫布一直保持開放。 感謝 **[MrQyun](https://github.com/mrqyun)** —— 想把自己的名字也放在這裡?**[成為贊助者 →](https://github.com/sponsors/ZSeven-W)** ## 社群 加入我們的 Discord — 提問、分享設計、提出功能建議。 **認可社群：[LINUX DO](https://linux.do/)** ## 第三方 Fork 與致謝 感謝上游維護者的工作，OpenPencil 得以在此基礎上建構。以下副本僅為滿足 OpenPencil 特定的整合需求而維護： - **[casement](https://github.com/ZSeven-W/casement)** — fork 自 **[winit](https://github.com/rust-windowing/winit)**。 - **[anthropic-agent-sdk](./vendor/anthropic-agent-sdk)** — 自 **[bartolli/anthropic-agent-sdk](https://github.com/bartolli/anthropic-agent-sdk)** 引入存放庫，並作為本地 fork 維護。 各專案仍適用其各自的上游授權條款。 ## 安全評估 [](https://mseep.ai/app/zseven-w-openpencil) ## 授權條款 [MIT](./LICENSE) — Copyright (c) 2026 ZSeven-W