mirror of
https://github.com/ZSeven-W/openpencil.git
synced 2026-06-01 03:14:29 +07:00
440 lines
30 KiB
Markdown
440 lines
30 KiB
Markdown
<p align="center">
|
|
<img src="./apps/desktop/build/icon.png" alt="OpenPencil" width="120" />
|
|
</p>
|
|
|
|
<h1 align="center">OpenPencil</h1>
|
|
|
|
<p align="center">
|
|
<strong>เครื่องมือออกแบบเวกเตอร์โอเพนซอร์สที่ขับเคลื่อนด้วย AI ตัวแรกของโลก</strong><br />
|
|
<sub>ทีม Agent ทำงานพร้อมกัน • Design-as-Code • MCP Server ในตัว • ปัญญาหลายโมเดล</sub>
|
|
</p>
|
|
|
|
<p align="center">
|
|
<a href="./README.md"><b>English</b></a> · <a href="./README.zh.md">简体中文</a> · <a href="./README.zh-TW.md">繁體中文</a> · <a href="./README.ja.md">日本語</a> · <a href="./README.ko.md">한국어</a> · <a href="./README.fr.md">Français</a> · <a href="./README.es.md">Español</a> · <a href="./README.de.md">Deutsch</a> · <a href="./README.pt.md">Português</a> · <a href="./README.ru.md">Русский</a> · <a href="./README.hi.md">हिन्दी</a> · <a href="./README.tr.md">Türkçe</a> · <a href="./README.th.md">ไทย</a> · <a href="./README.vi.md">Tiếng Việt</a> · <a href="./README.id.md">Bahasa Indonesia</a>
|
|
</p>
|
|
|
|
<p align="center">
|
|
<a href="https://github.com/ZSeven-W/openpencil/stargazers"><img src="https://img.shields.io/github/stars/ZSeven-W/openpencil?style=flat&color=cfb537" alt="Stars" /></a>
|
|
<a href="https://github.com/ZSeven-W/openpencil/blob/main/LICENSE"><img src="https://img.shields.io/github/license/ZSeven-W/openpencil?color=64748b" alt="License" /></a>
|
|
<a href="https://github.com/ZSeven-W/openpencil/actions/workflows/ci.yml"><img src="https://img.shields.io/github/actions/workflow/status/ZSeven-W/openpencil/ci.yml?branch=main&label=CI" alt="CI" /></a>
|
|
<a href="https://discord.gg/h9Fmyy6pVh"><img src="https://img.shields.io/discord/1476517942949580952?label=Discord&logo=discord&logoColor=white&color=5865F2" alt="Discord" /></a>
|
|
</p>
|
|
|
|
<br />
|
|
|
|
<p align="center">
|
|
<a href="https://oss.ioa.tech/zseven/openpencil/a46e24733239ce24de36702342201033.mp4">
|
|
<img src="./screenshot/op-cover.png" alt="OpenPencil — คลิกเพื่อดูวิดีโอสาธิต" width="100%" />
|
|
</a>
|
|
</p>
|
|
<p align="center"><sub>คลิกที่รูปภาพเพื่อดูวิดีโอสาธิต</sub></p>
|
|
|
|
<br />
|
|
|
|
> **หมายเหตุ:** มีโปรเจกต์โอเพนซอร์สอีกโปรเจกต์หนึ่งที่ใช้ชื่อเดียวกัน — [OpenPencil](https://github.com/open-pencil/open-pencil) ซึ่งเน้นการออกแบบภาพที่เข้ากันได้กับ Figma พร้อมการทำงานร่วมกันแบบเรียลไทม์ โปรเจกต์นี้เน้นเวิร์กโฟลว์ AI-native สำหรับการแปลงดีไซน์เป็นโค้ด
|
|
|
|
## ทำไมต้อง OpenPencil
|
|
|
|
<table>
|
|
<tr>
|
|
<td width="50%">
|
|
|
|
### 🎨 Prompt → Canvas
|
|
|
|
อธิบาย UI ใดก็ได้ด้วยภาษาธรรมชาติ ดูมันปรากฏบน Canvas ไม่จำกัดขนาดแบบเรียลไทม์พร้อม animation แบบ streaming แก้ไขดีไซน์ที่มีอยู่โดยเลือกองค์ประกอบแล้วพิมพ์สนทนา
|
|
|
|
</td>
|
|
<td width="50%">
|
|
|
|
### 🤖 ทีม Agent ทำงานพร้อมกัน
|
|
|
|
Orchestrator แบ่งหน้าที่ซับซ้อนออกเป็น sub-task เชิงพื้นที่ AI agent หลายตัวทำงานในส่วนต่าง ๆ พร้อมกัน — hero, features, footer — ทั้งหมด streaming แบบขนาน
|
|
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td width="50%">
|
|
|
|
### 🧠 ปัญญาหลายโมเดล
|
|
|
|
ปรับตัวตามความสามารถของแต่ละโมเดลโดยอัตโนมัติ Claude ได้ prompt เต็มรูปแบบพร้อม thinking; GPT-4o/Gemini ปิด thinking; โมเดลขนาดเล็ก (MiniMax, Qwen, Llama) ได้ prompt แบบย่อเพื่อผลลัพธ์ที่เสถียร
|
|
|
|
</td>
|
|
<td width="50%">
|
|
|
|
### 🔌 MCP Server
|
|
|
|
ติดตั้งได้ด้วยคลิกเดียวใน Claude Code, Codex, Gemini, OpenCode, Kiro หรือ Copilot CLIs ออกแบบจาก terminal ของคุณ — อ่าน สร้าง และแก้ไขไฟล์ `.op` ผ่าน agent ที่รองรับ MCP
|
|
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td width="50%">
|
|
|
|
### 📦 Design-as-Code
|
|
|
|
ไฟล์ `.op` เป็น JSON — อ่านได้โดยมนุษย์, Git-friendly, เปรียบเทียบความแตกต่างได้ Design variables สร้าง CSS custom properties ส่งออกโค้ดเป็น React + Tailwind หรือ HTML + CSS
|
|
|
|
</td>
|
|
<td width="50%">
|
|
|
|
### 🖥️ ใช้งานได้ทุกที่
|
|
|
|
เว็บแอป + เดสก์ท็อปแบบ native บน macOS, Windows และ Linux ผ่าน Electron อัปเดตอัตโนมัติจาก GitHub Releases เชื่อมโยงไฟล์ `.op` — ดับเบิลคลิกเพื่อเปิด
|
|
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td width="50%">
|
|
|
|
### ⌨️ CLI — `op`
|
|
|
|
ควบคุมเครื่องมือออกแบบจาก terminal ของคุณ `op design`, `op insert` — batch design DSL, จัดการ node Pipe จากไฟล์หรือ stdin ทำงานร่วมกับแอปเดสก์ท็อปหรือ web server
|
|
|
|
</td>
|
|
<td width="50%">
|
|
|
|
### 🎯 ส่งออกโค้ดหลายแพลตฟอร์ม
|
|
|
|
ส่งออกจากไฟล์ `.op` ไฟล์เดียวไปยัง React + Tailwind, HTML + CSS, Vue, Svelte, Flutter, SwiftUI, Jetpack Compose, React Native Design variables กลายเป็น CSS custom properties
|
|
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
|
|
## เริ่มต้นอย่างรวดเร็ว
|
|
|
|
```bash
|
|
# ติดตั้ง dependencies
|
|
bun install
|
|
|
|
# เริ่ม dev server ที่ http://localhost:3000
|
|
bun --bun run dev
|
|
```
|
|
|
|
หรือรันเป็นแอปพลิเคชัน Desktop:
|
|
|
|
```bash
|
|
bun run electron:dev
|
|
```
|
|
|
|
> **ข้อกำหนดเบื้องต้น:** [Bun](https://bun.sh/) >= 1.0 และ [Node.js](https://nodejs.org/) >= 18
|
|
|
|
### Docker
|
|
|
|
มี image หลายรูปแบบให้เลือก — เลือกแบบที่เหมาะกับความต้องการของคุณ:
|
|
|
|
| Image | ขนาด | รวม |
|
|
| ---------------------------- | ------- | ---------------------- |
|
|
| `openpencil:latest` | ~226 MB | เว็บแอปเท่านั้น |
|
|
| `openpencil-claude:latest` | — | + Claude Code CLI |
|
|
| `openpencil-codex:latest` | — | + Codex CLI |
|
|
| `openpencil-opencode:latest` | — | + OpenCode CLI |
|
|
| `openpencil-copilot:latest` | — | + GitHub Copilot CLI |
|
|
| `openpencil-gemini:latest` | — | + Gemini CLI |
|
|
| `openpencil-full:latest` | ~1 GB | เครื่องมือ CLI ทั้งหมด |
|
|
|
|
**รัน (เว็บเท่านั้น):**
|
|
|
|
```bash
|
|
docker run -d -p 3000:3000 ghcr.io/zseven-w/openpencil:latest
|
|
```
|
|
|
|
**รันพร้อม AI CLI (เช่น Claude Code):**
|
|
|
|
AI chat ต้องใช้การเข้าสู่ระบบ OAuth ของ Claude CLI ใช้ Docker volume เพื่อเก็บรักษา session การเข้าสู่ระบบ:
|
|
|
|
```bash
|
|
# ขั้นตอนที่ 1 — เข้าสู่ระบบ (ครั้งเดียว)
|
|
docker volume create openpencil-claude-auth
|
|
docker run -it --rm \
|
|
-v openpencil-claude-auth:/root/.claude \
|
|
ghcr.io/zseven-w/openpencil-claude:latest claude login
|
|
|
|
# ขั้นตอนที่ 2 — เริ่มต้น
|
|
docker run -d -p 3000:3000 \
|
|
-v openpencil-claude-auth:/root/.claude \
|
|
ghcr.io/zseven-w/openpencil-claude:latest
|
|
```
|
|
|
|
**Build ในเครื่อง:**
|
|
|
|
```bash
|
|
# พื้นฐาน (เว็บเท่านั้น)
|
|
docker build --target base -t openpencil .
|
|
|
|
# พร้อม CLI เฉพาะตัว
|
|
docker build --target with-claude -t openpencil-claude .
|
|
|
|
# เต็มรูปแบบ (CLI ทั้งหมด)
|
|
docker build --target full -t openpencil-full .
|
|
```
|
|
|
|
## การออกแบบที่ขับเคลื่อนด้วย AI
|
|
|
|
**จาก Prompt สู่ UI**
|
|
|
|
- **ข้อความเป็นดีไซน์** — อธิบายหน้า แล้วสร้างขึ้นบน Canvas แบบเรียลไทม์พร้อม animation แบบ streaming
|
|
- **Orchestrator** — แบ่งหน้าที่ซับซ้อนออกเป็น sub-task เชิงพื้นที่เพื่อการสร้างแบบขนาน
|
|
- **การแก้ไขดีไซน์** — เลือกองค์ประกอบ แล้วอธิบายการเปลี่ยนแปลงด้วยภาษาธรรมชาติ
|
|
- **Vision input** — แนบ screenshot หรือ mockup เพื่อใช้เป็นข้อมูลอ้างอิงในการออกแบบ
|
|
|
|
**รองรับหลาย Agent**
|
|
|
|
| Agent | วิธีตั้งค่า |
|
|
| --------------------------- | ---------------------------------------------------------------------------------------------- |
|
|
| **ในตัว (9+ ผู้ให้บริการ)** | เลือกจากพรีเซ็ตผู้ให้บริการพร้อมตัวสลับภูมิภาค — Anthropic, OpenAI, Google, DeepSeek และอื่น ๆ |
|
|
| **Claude Code** | ไม่ต้องตั้งค่า — ใช้ Claude Agent SDK พร้อม local OAuth |
|
|
| **Codex CLI** | เชื่อมต่อใน Agent Settings (`Cmd+,`) |
|
|
| **OpenCode** | เชื่อมต่อใน Agent Settings (`Cmd+,`) |
|
|
| **GitHub Copilot** | `copilot login` จากนั้นเชื่อมต่อใน Agent Settings (`Cmd+,`) |
|
|
| **Gemini CLI** | เชื่อมต่อใน Agent Settings (`Cmd+,`) |
|
|
|
|
**โปรไฟล์ความสามารถของโมเดล** — ปรับ prompt, โหมด thinking และ timeout ตามระดับโมเดลโดยอัตโนมัติ โมเดลระดับเต็ม (Claude) ได้ prompt ครบถ้วน; โมเดลระดับมาตรฐาน (GPT-4o, Gemini, DeepSeek) ปิด thinking; โมเดลระดับพื้นฐาน (MiniMax, Qwen, Llama, Mistral) ได้ prompt แบบ nested-JSON ที่ย่อลงเพื่อความเสถียรสูงสุด
|
|
|
|
**i18n** — การแปลภาษาเต็มรูปแบบใน 15 ภาษา: English, 简体中文, 繁體中文, 日本語, 한국어, Français, Español, Deutsch, Português, Русский, हिन्दी, Türkçe, ไทย, Tiếng Việt, Bahasa Indonesia
|
|
|
|
**MCP Server**
|
|
|
|
- MCP Server ในตัว — ติดตั้งได้ด้วยคลิกเดียวใน Claude Code / Codex / Gemini / OpenCode / Kiro / Copilot CLIs
|
|
- ตรวจจับ Node.js อัตโนมัติ — หากไม่ได้ติดตั้ง จะสำรองไปใช้ HTTP transport และเริ่ม MCP HTTP server โดยอัตโนมัติ
|
|
- การทำ Design automation จาก terminal: อ่าน สร้าง และแก้ไขไฟล์ `.op` ผ่าน agent ที่รองรับ MCP
|
|
- **Layered design workflow** — `design_skeleton` → `design_content` → `design_refine` สำหรับดีไซน์หลายส่วนที่มีความละเอียดสูงขึ้น
|
|
- **Segmented prompt retrieval** — โหลดเฉพาะความรู้ด้านดีไซน์ที่ต้องการ (schema, layout, roles, icons, planning ฯลฯ)
|
|
- รองรับหลายหน้า — สร้าง เปลี่ยนชื่อ เรียงลำดับ และทำซ้ำหน้าผ่าน MCP tools
|
|
|
|
**การสร้างโค้ด**
|
|
|
|
- React + Tailwind CSS, HTML + CSS, CSS Variables
|
|
- Vue, Svelte, Flutter, SwiftUI, Jetpack Compose, React Native
|
|
|
|
## CLI — `op`
|
|
|
|
ติดตั้งแบบ global และควบคุมเครื่องมือออกแบบจาก terminal ของคุณ:
|
|
|
|
```bash
|
|
npm install -g @zseven-w/openpencil
|
|
```
|
|
|
|
```bash
|
|
op start # เปิดแอปเดสก์ท็อป
|
|
op design @landing.txt # ออกแบบแบบ batch จากไฟล์
|
|
op insert '{"type":"RECT"}' # แทรก node
|
|
op import:figma design.fig # นำเข้าไฟล์ Figma
|
|
cat design.dsl | op design - # Pipe จาก stdin
|
|
```
|
|
|
|
รองรับ 3 วิธีการป้อนข้อมูล: สตริงแบบ inline, `@filepath` (อ่านจากไฟล์) หรือ `-` (อ่านจาก stdin) ทำงานร่วมกับแอปเดสก์ท็อปหรือ web dev server ดู [CLI README](./apps/cli/README.md) สำหรับคู่มือคำสั่งฉบับเต็ม
|
|
|
|
**LLM Skill** — ติดตั้งปลั๊กอิน [OpenPencil Skill](https://github.com/ZSeven-W/openpencil-skill) เพื่อสอน AI agent (Claude Code, Cursor, Codex, Gemini CLI ฯลฯ) ออกแบบด้วย `op`
|
|
|
|
## ฟีเจอร์
|
|
|
|
**Canvas และการวาด**
|
|
|
|
- Canvas ไม่จำกัดขนาดพร้อม pan, zoom, smart alignment guides และ snapping
|
|
- Rectangle, Ellipse, Line, Polygon, Pen (Bezier), Frame, Text
|
|
- การดำเนินการบูลีน — รวม ลบ ตัดกัน พร้อมแถบเครื่องมือตามบริบท
|
|
- ตัวเลือก Icon (Iconify) และนำเข้ารูปภาพ (PNG/JPEG/SVG/WebP/GIF)
|
|
- Auto-layout — แนวตั้ง/แนวนอนพร้อม gap, padding, justify, align
|
|
- เอกสารหลายหน้าพร้อมการนำทางด้วย tab
|
|
|
|
**Design System**
|
|
|
|
- Design variables — color, number, string tokens พร้อมการอ้างอิง `$variable`
|
|
- รองรับหลาย theme — หลาย axis แต่ละ axis มี variants (Light/Dark, Compact/Comfortable)
|
|
- ระบบ Component — component ที่นำกลับมาใช้ใหม่ได้พร้อม instance และ override
|
|
- CSS sync — สร้าง custom properties อัตโนมัติ, `var(--name)` ในผลลัพธ์โค้ด
|
|
- UIKits ที่นำกลับมาใช้ใหม่ได้ — นำเข้า/ส่งออกชุด component จากไฟล์ `.pen`
|
|
|
|
**AI และ Agents**
|
|
|
|
- Prompt-to-canvas พร้อมการสร้างแบบ streaming และการแตกย่อยเชิงพื้นที่ที่ขับเคลื่อนโดย orchestrator
|
|
- Concurrent Agent Teams — นักออกแบบหลายคนทำงานกับส่วนต่าง ๆ พร้อมกัน พร้อมตัวบ่งชี้บน canvas สำหรับแต่ละสมาชิก
|
|
- Layered workflow — `design_skeleton` → `design_content` → `design_refine` พร้อม prompt ที่เน้นเฉพาะในแต่ละเฟส
|
|
- Style Guides — สไตล์ในตัวกว่า 50 แบบ (glassmorphism, brutalist, retro ฯลฯ) พร้อม fuzzy matching ตาม tag ใช้ในการวางแผนและการสร้าง
|
|
- โปรไฟล์ความสามารถหลายโมเดล — ปรับโหมดการคิด ความพยายาม และรูปแบบ prompt อัตโนมัติตามระดับโมเดล
|
|
- Agent runtime ในตัว (`agent-native`, Zig NAPI) + ผู้ให้บริการ Anthropic, Claude Agent SDK, OpenCode, Codex, Copilot, Gemini
|
|
- Passthrough รูปแบบ Anthropic สำหรับผู้ให้บริการ LLM จีน — Kimi, Zhipu, GLM, DouBao, Ark, Bailian/DashScope, ModelScope, Coding Plans
|
|
|
|
**การเชื่อมต่อ Git**
|
|
|
|
- ตัวช่วย Clone พร้อมการยืนยันตัวตน SSH / HTTPS และการจัดการ SSH key
|
|
- ตัวเลือก branch — สร้าง สลับ ลบ merge ทั้งหมดจาก Git panel
|
|
- Cascade สำหรับ pull / push พร้อม auth retry และการจัดการ non-fast-forward
|
|
- Three-way merge โหมดโฟลเดอร์พร้อมการติดตามสถานะ `MERGE_HEAD` บนดิสก์
|
|
- Conflict panel พร้อมการ์ด three-way ต่อ node / field, ตัวแก้ไข JSON inline, bulk actions และบล็อก diff inline
|
|
- UI สำหรับตั้งค่า remote และ SSH keys; i18n 15 ภาษาครอบคลุมทั้งส่วนของ Git
|
|
|
|
**การส่งออก**
|
|
|
|
- ส่งออก Canvas — PNG, JPEG, WEBP, PDF (`Cmd+Shift+P`)
|
|
- ส่งออกโค้ด — React + Tailwind, HTML + CSS, Vue, Svelte, Flutter, SwiftUI, Jetpack Compose, React Native
|
|
- Pipeline การสร้างโค้ด MCP แบบเพิ่มทีละส่วน — `codegen_plan`, `codegen_submit_chunk`, `codegen_assemble`, `codegen_clean`
|
|
|
|
**นำเข้าจาก Figma**
|
|
|
|
- นำเข้าไฟล์ `.fig` โดยคงไว้ซึ่ง layout, fills, strokes, effects, text, images และ vectors
|
|
|
|
**Desktop App**
|
|
|
|
- รองรับ macOS, Windows และ Linux แบบ native ผ่าน Electron
|
|
- เชื่อมโยงไฟล์ `.op` — ดับเบิลคลิกเพื่อเปิด, single-instance lock
|
|
- อัปเดตอัตโนมัติจาก GitHub Releases
|
|
- เมนูแอปพลิเคชันแบบ native พร้อม Save As, Open Recent และกล่องโต้ตอบการเปลี่ยนแปลงที่ไม่ได้บันทึกเมื่อปิด
|
|
- การเก็บรักษาไฟล์ล่าสุด
|
|
|
|
## Tech Stack
|
|
|
|
| | |
|
|
| -------------- | -------------------------------------------------------------------------------- |
|
|
| **Frontend** | React 19 · TanStack Start · Tailwind CSS v4 · shadcn/ui · i18next |
|
|
| **Canvas** | CanvasKit/Skia (WASM, GPU-accelerated) |
|
|
| **State** | Zustand v5 |
|
|
| **Server** | Nitro |
|
|
| **Desktop** | Electron 35 |
|
|
| **CLI** | `op` — ควบคุมจาก terminal, batch design DSL |
|
|
| **AI** | Vercel AI SDK v6 · Anthropic SDK · Claude Agent SDK · OpenCode SDK · Copilot SDK |
|
|
| **Runtime** | Bun · Vite 7 |
|
|
| **รูปแบบไฟล์** | `.op` — ใช้ JSON, อ่านได้โดยมนุษย์, Git-friendly |
|
|
|
|
## โครงสร้างโปรเจกต์
|
|
|
|
```text
|
|
openpencil/
|
|
├── apps/
|
|
│ ├── web/ TanStack Start web app
|
|
│ │ ├── src/
|
|
│ │ │ ├── canvas/ CanvasKit/Skia engine — การวาด, sync, layout
|
|
│ │ │ ├── components/ React UI — editor, panels, shared dialogs, icons
|
|
│ │ │ ├── services/ai/ AI chat, orchestrator, การสร้างดีไซน์, streaming
|
|
│ │ │ ├── stores/ Zustand — canvas, document, pages, history, AI
|
|
│ │ │ ├── mcp/ MCP server tools สำหรับการเชื่อมต่อ CLI ภายนอก
|
|
│ │ │ ├── hooks/ Keyboard shortcuts, file drop, Figma paste
|
|
│ │ │ └── uikit/ ระบบ component kit ที่นำกลับมาใช้ใหม่ได้
|
|
│ │ └── server/
|
|
│ │ ├── api/ai/ Nitro API — streaming chat, generation, validation
|
|
│ │ └── utils/ Claude CLI, OpenCode, Codex, Copilot wrappers
|
|
│ ├── desktop/ Electron desktop app
|
|
│ │ ├── main.ts Window, Nitro fork, native menu, auto-updater
|
|
│ │ ├── ipc-handlers.ts ไดอะล็อกไฟล์เนทีฟ, ซิงค์ธีม, การตั้งค่า IPC
|
|
│ │ └── preload.ts IPC bridge
|
|
│ └── cli/ เครื่องมือ CLI — คำสั่ง `op`
|
|
│ ├── src/commands/ คำสั่ง design, document, export, import, node, page, variable
|
|
│ ├── connection.ts การเชื่อมต่อ WebSocket ไปยังแอปที่กำลังทำงาน
|
|
│ └── launcher.ts ตรวจจับและเปิดแอปเดสก์ท็อปหรือ web server อัตโนมัติ
|
|
├── packages/
|
|
│ ├── pen-types/ Type definitions สำหรับ PenDocument model
|
|
│ ├── pen-core/ Document tree ops, layout engine, variables
|
|
│ ├── pen-codegen/ Code generators (React, HTML, Vue, Flutter, ...)
|
|
│ ├── pen-figma/ Figma .fig file parser และ converter
|
|
│ ├── pen-renderer/ Standalone CanvasKit/Skia renderer
|
|
│ ├── pen-sdk/ Umbrella SDK (re-exports ทุก package)
|
|
│ ├── pen-ai-skills/ AI prompt skill engine (โหลด prompt ตามเฟส)
|
|
│ └── agent/ AI Agent SDK (Vercel AI SDK, หลายผู้ให้บริการ, ทีม Agent)
|
|
└── .githooks/ Pre-commit version sync จาก branch name
|
|
```
|
|
|
|
## คีย์ลัด
|
|
|
|
| คีย์ | การทำงาน | | คีย์ | การทำงาน |
|
|
| ----------- | ----------- | --- | ------------- | ------------------------- |
|
|
| `V` | เลือก | | `Cmd+S` | บันทึก |
|
|
| `R` | Rectangle | | `Cmd+Z` | เลิกทำ |
|
|
| `O` | Ellipse | | `Cmd+Shift+Z` | ทำซ้ำ |
|
|
| `L` | Line | | `Cmd+C/X/V/D` | คัดลอก/ตัด/วาง/ทำซ้ำ |
|
|
| `T` | Text | | `Cmd+G` | จัดกลุ่ม |
|
|
| `F` | Frame | | `Cmd+Shift+G` | ยกเลิกการจัดกลุ่ม |
|
|
| `P` | Pen tool | | `Cmd+Shift+P` | ส่งออก (PNG/JPG/WEBP/PDF) |
|
|
| `H` | Hand (pan) | | `Cmd+Shift+C` | Code panel |
|
|
| `Del` | ลบ | | `Cmd+Shift+V` | Variables panel |
|
|
| `[ / ]` | เรียงลำดับ | | `Cmd+J` | AI chat |
|
|
| ลูกศร | เลื่อน 1px | | `Cmd+,` | Agent settings |
|
|
| `Cmd+Alt+U` | รวมบูลีน | | `Cmd+Alt+S` | ลบบูลีน |
|
|
| `Cmd+Alt+I` | ตัดกันบูลีน | | `Cmd+Shift+S` | บันทึกเป็น |
|
|
|
|
## Scripts
|
|
|
|
```bash
|
|
bun --bun run dev # Dev server (port 3000)
|
|
bun --bun run build # Production build
|
|
bun --bun run test # รันการทดสอบ (Vitest)
|
|
npx tsc --noEmit # ตรวจสอบ type
|
|
bun run bump <version> # Sync version ในทุก package.json
|
|
bun run electron:dev # Electron dev
|
|
bun run electron:build # Electron package
|
|
bun run cli:dev # รัน CLI จาก source
|
|
bun run cli:compile # คอมไพล์ CLI ไปยัง dist
|
|
```
|
|
|
|
## การมีส่วนร่วม
|
|
|
|
ยินดีต้อนรับการมีส่วนร่วมทุกรูปแบบ! ดู [CLAUDE.md](./CLAUDE.md) สำหรับรายละเอียดสถาปัตยกรรมและรูปแบบโค้ด
|
|
|
|
1. Fork และ clone
|
|
2. ตั้งค่า version sync: `git config core.hooksPath .githooks`
|
|
3. สร้าง branch: `git checkout -b feat/my-feature`
|
|
4. รันการตรวจสอบ: `npx tsc --noEmit && bun --bun run test`
|
|
5. Commit ด้วย [Conventional Commits](https://www.conventionalcommits.org/): `feat(canvas): add rotation snapping`
|
|
6. เปิด PR เข้า `main`
|
|
|
|
## Roadmap
|
|
|
|
- [x] Design variables และ tokens พร้อม CSS sync
|
|
- [x] ระบบ Component (instances และ overrides)
|
|
- [x] การสร้างดีไซน์ด้วย AI พร้อม orchestrator
|
|
- [x] การเชื่อมต่อ MCP server พร้อม layered design workflow
|
|
- [x] รองรับหลายหน้า
|
|
- [x] นำเข้า Figma `.fig`
|
|
- [x] Boolean operations (union, subtract, intersect)
|
|
- [x] โปรไฟล์ความสามารถหลายโมเดล
|
|
- [x] ปรับโครงสร้างเป็น monorepo พร้อม package ที่นำกลับมาใช้ใหม่ได้
|
|
- [x] เครื่องมือ CLI (`op`) ควบคุมจาก terminal
|
|
- [x] AI Agent SDK ในตัว รองรับหลายผู้ให้บริการ
|
|
- [x] i18n — 15 ภาษา
|
|
- [x] การเชื่อมต่อ Git (clone, branch, push/pull, three-way merge โหมดโฟลเดอร์)
|
|
- [x] การส่งออก Canvas แบบ raster (PNG / JPEG / WEBP / PDF)
|
|
- [ ] การแก้ไขร่วมกัน
|
|
- [ ] ระบบปลั๊กอิน
|
|
|
|
## ผู้มีส่วนร่วม
|
|
|
|
<a href="https://github.com/ZSeven-W/openpencil/graphs/contributors">
|
|
<img src="https://contrib.rocks/image?repo=ZSeven-W/openpencil" alt="Contributors" />
|
|
</a>
|
|
|
|
## ผู้สนับสนุน
|
|
|
|
OpenPencil เป็นซอฟต์แวร์ฟรีและโอเพนซอร์ส การพัฒนาได้รับการสนับสนุนจากผู้ที่เห็นว่ามันมีประโยชน์ — ขอบคุณที่ช่วยให้ผืนผ้าใบยังคงเปิดอยู่
|
|
|
|
<a href="https://github.com/mrqyun" title="MrQyun">
|
|
<img src="https://wsrv.nl/?url=github.com/mrqyun.png&w=128&h=128&mask=circle&maxage=7d" width="64" height="64" alt="MrQyun" />
|
|
</a>
|
|
|
|
ขอบคุณ **[MrQyun](https://github.com/mrqyun)** — อยากเห็นชื่อของคุณตรงนี้ใช่ไหม? **[เป็นผู้สนับสนุน →](https://github.com/sponsors/ZSeven-W)**
|
|
|
|
## ชุมชน
|
|
|
|
<a href="https://discord.gg/h9Fmyy6pVh">
|
|
<img src="./apps/web/public/logo-discord.svg" alt="Discord" width="16" />
|
|
<strong> เข้าร่วม Discord ของเรา</strong>
|
|
</a>
|
|
— ถามคำถาม แชร์ดีไซน์ เสนอฟีเจอร์
|
|
|
|
## Star History
|
|
|
|
<a href="https://star-history.com/#ZSeven-W/openpencil&Date">
|
|
<picture>
|
|
<source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=ZSeven-W/openpencil&type=Date&theme=dark" />
|
|
<source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=ZSeven-W/openpencil&type=Date" />
|
|
<img alt="Star History Chart" src="https://api.star-history.com/svg?repos=ZSeven-W/openpencil&type=Date" width="100%" />
|
|
</picture>
|
|
</a>
|
|
|
|
## การประเมิน
|
|
|
|
[](https://mseep.ai/app/zseven-w-openpencil)
|
|
|
|
## สัญญาอนุญาต
|
|
|
|
[MIT](./LICENSE) — Copyright (c) 2026 ZSeven-W
|