Figma Zero

AI 对话填字 · 使用教程

用一句话描述要填什么，AI 看着选中的文本图层清单生成文字并写回画布

这个功能要本机的 FigmaFocusServer 在运行（它负责调用本机的 AI 命令行或转发 API 请求）， 并且三种 AI 后端里至少配好一种。选中的图层文字、图层名和坐标会发给你选的那个后端， 图片不会外传；API Key 只存在你自己的电脑上，不经过 Figma、也不经过我们的服务器。

一、先打开面板

  1. 在 Figma 里选中要填字的对象（一个组、一个画板都行，里面得有文本图层）；
  2. 打开 Figma Zero 插件，找到 OCR截图填字 按钮，按住 shift 点击它；
  3. 面板标题变成「AI 对话填字」，顶部会显示当前选中了几个对象。

面板第一行是后端选择器，右边那句灰字是状态：CLI 已安装 / Key 已配置 表示可以直接用； 显示未找到或需要填 API Key就照下面对应的一节配一次，配完终身有效。

二、三种后端，选一种就够

后端 适合谁 怎么激活 花钱吗 一次响应
Claude 会员（CLI） 有 Claude Pro / Max 订阅 装 Claude Code 命令行，终端登录一次 用订阅额度，不额外付费 约 9 秒
GPT 会员（Codex CLI） 有 ChatGPT Plus / Pro 订阅 装 Codex 命令行，终端登录一次 用订阅额度，不额外付费 约 17 秒
DeepSeek API 没有上面两种会员 官网注册拿一个 API Key，粘进面板 按量计费，约 1 元 / 百万 token 数秒

三种都配也没关系，面板里随时切换，选中哪个就用哪个，选择会自动保存。

三、Claude 会员（CLI）

走的是你自己的 Claude 订阅额度，插件默认用 Sonnet 5 这个模型。 注意：Claude 桌面 App 里的登录状态不通用，必须在终端里给命令行单独登录一次。

  1. 先装 Node.js（18 以上版本）。
  2. 打开终端（Windows 用 PowerShell），装 Claude Code 命令行： 
    npm install -g @anthropic-ai/claude-code
  3. 输入 claude 回车，进入交互界面后输入 /login， 浏览器会弹出登录页，用你的 Claude 账号登录并授权。
  4. 看到登录成功后按 Ctrl + C 退出即可，凭据已经存在本机。
  5. 回到插件面板，后端选 Claude 会员（CLI），右边显示「CLI 已安装」就成了。

插件会去这几个位置找命令行：macOS 是 ~/.local/bin/claude、~/.claude/local/claude、 /opt/homebrew/bin/claude、/usr/local/bin/claude； Windows 是 %USERPROFILE%\.local\bin\claude.exe 和 npm 的全局目录。 装在别处的话，把它软链到上面任意一个位置即可。

四、GPT 会员（Codex CLI）

走的是你自己的 ChatGPT 订阅额度，同样只需在终端登录一次。

  1. 同样先装好 Node.js（18 以上）。
  2. 终端里装 Codex 命令行： 
    npm install -g @openai/codex
  3. 登录： 
    codex login
    浏览器里用 ChatGPT 账号登录授权，凭据会写到 ~/.codex/auth.json。
  4. 回到插件面板，后端选 GPT 会员（Codex CLI），右边显示「CLI 已安装」。

五、DeepSeek API

没有上面两种会员就用这个，注册几分钟搞定，充值十块钱能填很久。

  1. 打开 platform.deepseek.com 注册并登录。
  2. 左侧「API Keys」→「创建 API Key」，复制那串以 sk- 开头的密钥（只显示一次，先存好）。
  3. 在「充值」页充一点余额，没有余额调用会直接报错。
  4. 回到插件面板，后端选 DeepSeek API，下面会多出一行输入框， 把密钥粘进去点保存，状态变成「Key 已配置」。

密钥只写在你自己电脑上的 FigmaFocusServer 配置文件里： macOS 是 ~/Library/Application Support/FigmaFocusServer/ai-config.json， Windows 是 %LOCALAPPDATA%\FigmaFocusServer\ai-config.json。 它不会上传到 Figma，也不会发给我们。

六、开始填字

  1. 在 Figma 里选中要填的对象（可以多选）；
  2. 面板中间的输入框里写清楚要填什么，例如「填几个银川的排水泵站名称」「把标题都改成英文」「填 6 条最近一周的巡检记录，带日期」；
  3. 按 Cmd/Ctrl + Enter，或点发送给 AI；
  4. 等几秒，下面的日志会显示「完成：N/N 个图层已填写」，文字直接写回画布，原来的字体和样式保持不变。

写要求的几个小技巧

  • 说清数量和风格：「填 8 个」「每条不超过 6 个字」「口语一点」，比只说「填点内容」效果稳定得多。
  • 日期时间放心写：插件会把你电脑上的当前日期一起告诉 AI，说「今天」「最近一周」「本月」都能算对。
  • 只想改一部分：直接说「只改标题，数字不要动」，AI 会挑对应的图层填，其余保持原样。
  • 人名电话这类占位数据：会直接编造虚构内容，不用担心它回一句「我不能生成个人信息」。
  • 填得不满意就撤销（Cmd/Ctrl + Z）再换个说法重发，成本很低。

七、遇到报错怎么办

面板里的提示 原因和处理
无法连接 FocusServer 本机的 FigmaFocusServer 没在运行。macOS 打开 FigmaFocusServer.app，Windows 双击 FigmaFocusServer.exe，然后重新发送。
未找到 claude CLI / 未装 codex 对应的命令行没装，或者装到了插件找不到的目录。照第三、四节重装一次，装完在终端里敲 claude 或 codex 能出界面才算好了。
命令行未登录或授权失效 终端里运行 claude 后输入 /login 重新登录；Codex 则是 codex login。订阅到期同样会报这个。
需要填 API Key / Key 无效 DeepSeek 的密钥没填、填错，或者账户没余额。回官网确认密钥和余额，再粘一次保存。
选区里没有文本图层 选中的对象里一个文本图层都没有。选中包含文字的组或画板再试。
AI 没有返回有效的任务 JSON 模型这次没按格式回答，插件已经自动重试过一次。把要求写得更具体一点再发一次通常就好了。
部分失败：N/M 个别图层写不进去，通常是字体没装在本机。日志里会列出具体图层，换个字体或补装字体即可。

八、关于隐私

  • 发给 AI 的是：选中范围内每个文本图层的当前文字、图层名、字体名和坐标，以及你写的那句要求。
  • 画布截图、图片内容不会发送。
  • 用 CLI 后端时，请求由你自己电脑上的 claude / codex 命令行直接发给对应厂商，凭据在你本机。
  • 用 API 后端时，请求由本机 FigmaFocusServer 直接发给 DeepSeek，密钥存在本机配置文件里。
  • 无论哪种方式，内容都不经过 sjfls6.com 的服务器。

插件本身在 Figma Zero 产品页， 键盘快捷键看快捷键说明书， 其他问题看常见问题。