项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-10-08 · 当前星标 ★ 7312
技术标签
使用教程
环境要求
- Rust stable 工具链(从源码构建产品时必需)
- Docker(用容器方式运行 Web 版时需要)
- Bun >= 1.0 与 Node.js >= 18(仅 packages/ 下 Web SDK 需要)
- macOS / Windows / Linux 桌面环境;Nix 方式当前仅发布 x86_64-linux
安装与启动步骤
-
1macOS 桌面版安装
用 Homebrew 添加官方 tap 并安装 cask,装好后可直接双击 .op 文件打开。
brew tap zseven-w/openpencil brew install --cask openpencil -
2Windows 桌面版安装
用 Scoop 添加 openpencil 桶后安装,安装过程会按需补齐微软签名的 VC++ 运行库。
scoop bucket add openpencil https://github.com/zseven-w/scoop-openpencil scoop install openpencil -
3Linux 手动下载安装
在 GitHub Releases 页面下载 .AppImage 或 .deb(Windows 则为 .exe)后自行安装。
-
4安装 op 命令行工具
macOS / Linux 用官方脚本安装 op CLI;加 OP_PRERELEASE=1 可获取最新预发布版。
curl -fsSL https://raw.githubusercontent.com/ZSeven-W/openpencil/main/scripts/install-op.sh | bash -
5Windows 安装 op CLI
Windows 用 PowerShell 脚本安装 op CLI;也可先把 OP_PRERELEASE 设为 1 再执行。
irm https://raw.githubusercontent.com/ZSeven-W/openpencil/main/scripts/install-op.ps1 | iex -
6Docker 运行 Web 版
克隆仓库后在根目录构建并运行镜像,映射 3100 端口;也可直接跑官方 ghcr.io/zseven-w/openpencil-web:vX.Y.Z 镜像。
docker build -f Dockerfile.web-rust -t openpencil-web-rust . docker run -p 3100:3100 openpencil-web-rust -
7从源码构建运行
先安装 Rust stable;桌面端执行 cargo run -p op-host-desktop,Web 端用 bash scripts/start-web-rust.sh。
cargo run -p op-host-desktop
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
OPENPENCIL_PERSIST_WEB_CREDENTIALS_SERVE | 否 | 私有部署下启用浏览器凭据服务端持久化,部署范围生效 | true |
OPENPENCIL_WEB_ALLOWED_ORIGINS | 否 | 公网反向代理时设置为精确来源的逗号分隔列表 | https://demo.openpencil.dev |
OPENPENCIL_WEB_AI_ENDPOINT_ALLOWLIST | 否 | 允许访问内部 AI 端点的精确 URL 来源列表 | http://127.0.0.1:11434,https://llm.internal.example |
OP_PRERELEASE | 否 | 让 CLI 安装脚本允许安装最新预发布版本 | 1 |
如何确认成功
打开 http://localhost:3100/ 能看到界面;桌面应用能正常启动并打开 .op 文件。
常见问题
Q:Docker 镜像里包含 Claude/Codex 等 CLI 吗?
A:不包含。镜像只含 Rust web host、wasm 包与 CanvasKit 资源,Web UI 仅暴露内置 agent profiles,CLI 与 ACP agent 只在原生端可用。
Q:Windows 安装包被杀毒软件报毒怎么办?
A:这是新版本低流行度触发的已知启发式误报,可按 docs/security/antivirus-false-positives.md 说明校验下载文件。
Q:便携版 zip 或 VSIX 为什么装不上?
A:这两类产物不运行提权安装程序,需要先自行安装微软最新支持的 Visual C++ Redistributable 再使用。
Q:如何安装最新的预发布版 CLI?
A:macOS/Linux 执行安装脚本时加 OP_PRERELEASE=1;Windows 先设置 $env:OP_PRERELEASE = "1" 再运行脚本。
注意事项
- 只有 Rust stable 是构建产品的必需项,Bun 与 Node.js 仅用于 packages/ 下的 Web SDK。
- 浏览器端凭据默认保存在同源 localStorage(openpencil-rust-web-credentials),同源脚本可读取,需防 XSS。
- 启用 OPENPENCIL_PERSIST_WEB_CREDENTIALS_SERVER 必须限定在受控、HTTPS、单一管理员配置的可信部署中。
- 官方 TypeScript 镜像(内置 AI CLI)已停止发布,现在只发布 Rust web-host 镜像。
核心亮点
- 并发 Agent Teams 让多个 AI 同时改不同区域,复杂界面生成效率更高
- 设计即代码,产出可对接 React/React Native/Flutter,减少手工还原
- Rust 实现,性能与内存表现优于常见 Electron 设计工具
不足之处
- 项目较新,功能完整度与稳定性仍需时间验证
- 生态与插件数量相比成熟设计工具还有差距
适用场景
- 产品经理用一句话快速生成可讨论的界面原型
- 独立开发者从提示词直接得到可继续开发的前端 UI 稿
- 设计团队用多 Agent 并行产出多套方案做快速对比
替代项目
Penpot、Excalidraw
同类项目推荐
sd-ppp
开源
在 Photoshop 里直接调用 AI 画图,不用切换软件
A Photoshop AI plugin
openpencil
开源
说一句话,AI 在画布上直接画出可编辑 UI
The world's first open-source AI-native vector design tool and the first to feature ···
design.md
开源
输入网址,一键生成设计规范与 Tailwind 主题
Generate DESIGN.md, Tailwind themes, tokens, and prompts from any website.
Excalidraw
开源
开源虚拟白板协作工具
Virtual whiteboard for sketching hand-drawn like diagrams
motion-anything
开源
用大白话描述动效,AI 直接帮你生成动画
✨ The agentic motion layer — an open-source, chat-native motion engine. Describe t···
freecad-ai
开源
用一句话在 FreeCAD 里生成可编辑三维模型
AI-powered assistant workbench for FreeCAD — generate 3D models from natural langua···
GPThemes
开源
一键换肤 ChatGPT,自定义颜色字体气泡宽度
GPThemes is a Chrome and Firefox extension designed to improve the visual experience···
SD-Anima-Prompt-Studio
开源
写提示词不再纠结,智能组合实时预览,轻松出好图
✨ Stunning glassmorphism UI for Stable Diffusion and Anima prompt engineering. Inte···
SwiftGraphics
开源
用 Swift 代码生成 SVG,直接驱动笔式绘图仪创作艺术。
SwiftGraphics is a library for creative coding and generative art tailored towards r···