内容
aboy
**一个本地优先的Figma克隆版，带有Codex CLI，直接内置于桌面应用程序中。**
通过熟悉的画布、图层、框架和检查器手动设计界面 - 或者打开嵌入式终端，并要求Codex检查和编辑。Codex的更改立即显示为原生、可编辑的，具有撤销/重做和本地自动保存。
[官网://0xmiki.githubfigmaboy/) ·](https://0xmiki.github.io/figmaboy/docs/) · [下载 Figm](https://0xmiki.github.io/figmaboy[](https://github.com/0xmiki/figm/actions/workflows/ci.yml最新发布](https://img.shields.io/github/v/release/0xmiki/figmaboy)](github.com/0xmiki/figmaboy/releases[](LICENSE)
## 下载
在[Fignaboyhttps://0xmiki/figmaboy上选择推荐的安装程序，或在[GitHub Releases](github.com/0xmiki/figmaboy/releases/latest)上浏览原始资产：
- Linux：AppImage、Deb包和RPM软件包
- macOS：Apple SiliconDMG构建
：NSIS和MSI
- MCP：每个发布目标的独立`figmaboy`二进制文件
发布资产包括`SHA256SUM用于验证。Linux软件包同时安装`figmaboy`figmaboy`；AppImage用户同一发布版本下载匹配的独立MCP二进制文件。
目前，macOS构建版本为临时签名，而不是经过公证，因此第一次启动可能需要在**系统设置 → 隐私和安全**中获得批准。版本尚未进行代码签名，可能会显示SmartScreen警告。
## Codex设计MCP
Figmaboy包含一个配套的`figmaboy-mcp`_stdio服务器。它可以在桌面应用程序关闭时使用已保存的设计作为只读Codex上下文，或者编辑应用程序中当前打开的设计，并具有实时的撤销/重做和自动保存 使用已保存的设计作为Codex上下文
在aboy工作区中右键单击设计卡片并选择设计ID**，或在中使用文件名旁边的复制按钮。ID是稳定且，因此它们是引用重要设计的最佳方式：
> 根据Fignaboy设计`file_，页面`Home`。
唯一名称也可以使用> 使用名为`Marketing site`的Fignaboy设计和布局参考。
MCP公开了两个离线工具：
- `designs_list`搜索已保存的设计并返回、名称、项目、时间戳和页面数量。
-_context_get`接受`file或`fileName`，以及可选的`pageId`或`pageName`。最新的自动保存的页面修订版、完整的原生文档、的图层树、数据和视觉预览。
活动设计具有相同的名称，返回它们的项目名称和Codex可以重试并使用确切的ID。离线上下文始终为只读；在要求Codex更改之前，请在Fignaboy中打开设计。
### 运行时架构
桌面应用程序和MCP服务器是具有两条数据路径的独立进程：text
Codex（或其他MCP客户端）
│ JSON-RPC通过stdio
▼
figmaboy-mcp
├── 只读SQLite ───────────────► 已保存的页面、图层、预览
│ （应用程序打开或关闭）
│
└── 身份验证的127.0.0.1桥接 ─► 当前打开的编辑器
（实时检查和编辑）
```
1. Figmaboy将其原生页面文档和每页预览自动保存到其本地SQLite工作区。
2. `figmaboy-mcp`以只读模式打开该数据库中的SQLite，以便进行`designs_list`和`design_context_get`操作。WAL模式在应用程序保存时保持读取安全。
3. Figmaboy在桌面应用程序打开时在其回端口上启动编辑接。
4. 应用程序将包含端口、随机身份验证令牌和其进程IDeditor-bridge.json`写入本地应用程序数据目录。在Unix文件的权限限制为当前用户，模式为`06005. MCP客户端将`figmaboy-mcp普通的stdio服务器启动。桌面应用程序**不**启动它。
6. 实时工具通过桥接连接；编辑器执行和渲染，并通过同一路径返回结果。
MCP进程从不写入SQLite数据库。这将验证、撤销/重做、实时渲染、修订检查和自动保存保留在桌面应用程序中。
默认发现文件位于：
| 平台 | 路径 |
| --- | --- |
| Linux | `${XDG_DATA_HOME:-$HOME/.local/share}/com.miki.figmaboy/editor-bridge.json` macOS | `/Application Support/com.maboy/editor-bridge.json` |
| Windows | `%LOCALAPPDATA%\com.miki.figmaboy\editor-bridge.json` |
在需要非默认发现路径时，为MCP进程设置`FIGMABOY_BRIDGE_FILE`。
为可移植安装和测试设置`FIGMABOY_DB_PATH`以覆盖已保存的工作区数据库路径。
### 安装并Codex
桌面软件安装GUI和配套的maboy-mcp`可执行文件。当前的N软件包在`PATH`上公开了两者。注册其，以便Codex不依赖于启动它的环境：
```console
MCP_BIN -v figmabcp)"
test -nCP_BIN"
codex mcp add figmaboyMCP_BIN"
codecp list
```
如果maboy`已旧存储库检出中的二进制文件，请先替换该条目：
```console
codex mcp remove figoy
codex mcp add figmaboy -- "$(v figmabcp)"
```
在mac非Nix Linux软件同一命令中使用路径：
```consolex mcp add figmaboy -- /绝对路径/to/figmaboy-mcp
```
在Windows上，在PowerShell中使用已安装的`路径运行等效
```powershell
code add figmaboy -- "C:\绝对路径\to\figmaboy-mcp.exe"
```
注册后，开始一个新的Codex会话。已保存的上下文工具在Figmaboy打开或关闭时都起作用。实时编辑器工具需要打开的设计，并在应用程序不可用时报告明确的错误。
Tauri的`externalBin`设置确保发布工件包含MCP可执行文件，但它不将服务器注册到Codex，也不自动将可执行文件公开到`PATH`上。每个平台安装程序必须为注册命令提供稳定的可执行文件路径。NixOS软件包已经这样做了。
工具和创作契约
服务器公开了离线工具来查找已保存的设计并加载页面作为结构化加视觉x上下文。其实时工具检查编辑器状态和节点，检索坐标几何，化创建/更新/重新父节点/重新层，放置生成的图像资产，水平/垂直居中图层，设置边框半径，控制选择和视口焦点，撤销/重做/保存，并捕获完整的框架作为PNG证据。
Codex完全从原生框架、组、形状、文本、图像和图标构建设计。每个可见元素都可以通过M址，并在图层。`design工具返回当前节点契约以及预期的语义分组模型；Codex设计之前调用它样式目前包括实心渐变和径向渐变填充；独立的角半径；笔画宽度、虚线、帽和连接控件；混合模式；分层投影和模糊；以及扩展的排版（任意字体系列、权重、斜体、大小写、装饰、垂直对齐、调整、段落间距/缩截断）。设计每个屏幕使用一个顶级框架，每个部分使用框架/组，并使用命名组件组而不是扁平的根图层列表。
右键单击任何框架**复制为图像**，以将框架及其所有的高分辨率栅格化放在系统剪贴板渲染器以3840像素的长边为目标的情况下，对于普通的框架大小不少于2倍，并在4096像素的安全限制内保持宽高比。在Linux上，它提供PNG像素和缓存的PNG文件URI，以便结果可以粘贴到图像感知应用程序或直接粘贴到文件夹中。
机器的TypeScript契约位于[`mcp/types.ts`](mcp/types.ts)并由`types_get`工具返回。Codex应使用`nodes_center`进行Figma样式的居中对齐，使用`nodes_set_border_radius`进行圆形曲面，并使用`frame_screenshot`直观地检查每个已完成的框架。
### 生成的艺术作品
Codex可以使用其图像生成功能创建英雄艺术、产品图像、纹理、插图、徽标切，然后使用最终的本地PNG、JPEG或WebP路径调用`image_place`。Figma Boy验证化文件在其资产数据库中，并创建一个普通的编辑图像层。对于背景，将包含的框架作为`parentId`传递placement: "fill-parent"`、`fit: "cover"`和`index: 0`；对于徽标或，使用透明PNG和自然放置以及明确的位置/大小。通过调用`frame_screenshot`并检查合成。
### 开发服务器
直接从此检出构建并注册MCP二进制文件：
```console
nix-shell --run 'cargo build --locked --release --manifest-path src-tauri/mcp/Cargo.toml'
codex mcp add figmaboy --src-tauri/target/release/figmaboy"
```
在切换到已安装的软件包和存储库构建之间时，请先删除现有的`figmaboy`条目。
### 捆绑的侧车
Tauri构建版本包含`figmaboy-mcp`作为外部二进制文件。开发和发布钩子为选定的目标编译它，并使用Tauri所需的目标三自动分直接准备和主机二进制文件```console
nix-shell --run 'bun run sideprepare'
nix-shell --run 'bun run sidecaroke'
```
生成的侧车二进制文件位于`src/binaries/`下，不会被提交。`bun run dev`准备了一个调试侧车；生产Tauri准备了一个发布侧车。
## 开发
运行-shell`，然后运行`bun run tauri dev`。
## 推荐的IDE设置
[VS Code](https://code.visualstudio.com/) + [Svelte](httpsplace.visualstudio.com/items?item
