FPAI 渲染 · 使用说明
—

把 SketchUp 里的模型，直接变成效果图

在 SketchUp 内打开面板，抓取当前视图作为参考图，选好模型与清晰度后提交出图； 渲染完成后可以把结果一键插回模型里对照。账号、模型与计费均由 FPAI 提供。

快速上手

  1. 打开面板点工具栏的「FPAI 渲染」，或菜单「扩展程序 → FPAI 渲染助手」。
  2. 登录账号用手机号或邮箱加密码登录。面板打开时会自动抓取一次当前视图，也可以随时重抓或直接拖入本地图片。
  3. 选空间类型点「家装 / 工装 / 建筑 / 景观」中的一个，面板会自动填入一条对应的预设提示词，并把预设列表收敛到该类型；提示词可以随意改写。
  4. 选模型、选清晰度下拉里是各系列模型，选好系列后再选输出清晰度；不同系列支持的清晰度不同，面板会自动只列出可用的档位。
  5. 提交并查看点生成后可在面板里看到进度；出图完成后点「插入模型」，结果会作为图片实体放进当前模型，点「保存到本地」则下载留档到 D 盘。

工具栏按钮

FPAI 渲染打开或唤出主面板。
抓取当前视图按当前视角重新抓一张参考图。面板没开时会先打开面板。
切换场景按顺序切到当前模型的下一个场景，方便逐场景出图。
插入渲染结果把最近一次出图结果插进模型，不用回面板再点一次。
使用说明打开本页。

配料单（OpenCutList）

配料单、切割图、材料估算不自研——直接用木作行业的开源标准 OpenCutList（L'Air du Bois，GNU GPLv3）。两个入口： 菜单 扩展程序 → OpenCutList 配料单（官方），或面板左侧功能栏的「配料单」，点一下即调起它的官方面板。 首次使用请先在 SketchUp 的「扩展程序管理器」里安装官方扩展（免费），Extension Warehouse 搜「OpenCutList」即可；本机已装则直接可用。

场景与插件

「扩展程序 → 场景管理」可创建、切换、重命名、更新或删除模型场景；批量渲染页也有「管理场景」入口。

「扩展程序 → 插件市场」显示 FPAI 维护的插件目录与本机已安装插件。目录中的「官方页面」会在浏览器打开下载页；下载 RBZ 后，通过 SketchUp 扩展管理器安装。

「扩展程序 → 插件助手」把本机已装的扩展按名字或作者搜索、自定义分组，并记录最近使用、导出与导入分组配置。它只做整理，不会卸载、启停或改动任何扩展的文件；要启停某个扩展，请走 SketchUp 自带的「扩展程序管理器」（改完通常需要重启 SketchUp）。

这三个功能都在菜单「扩展程序」里；工具箱移除后，面板侧不再放它们的按钮（旧版面板的「工具箱」页曾有）。

常见问题

找不到工具栏或面板？
菜单「扩展程序 → FPAI 渲染助手」一定能打开面板。工具栏如果没显示，在工具栏空白处右键勾选「FPAI 渲染」；首次创建可能是浮动小条，拖到顶部工具栏区即可停靠。另外：面板窗口会记住上次位置，如果换过显示器或分辨率后点按钮没反应，窗口可能开到了屏幕外——重启一次 SketchUp 再试，新版本会自动把它拉回屏幕中央。
原来的「工具箱」去哪了？
按用户反馈已整体移除。配料单（切割清单 / 切割图 / 材料估算）直接改用官方 OpenCutList：菜单「扩展程序 → OpenCutList 配料单（官方）」或面板左侧「配料单」。它比自研的更专业，还免费开源（GPLv3）。
点「配料单」提示没安装 OpenCutList？
在 SketchUp 的「扩展程序管理器」里安装官方扩展即可：Extension Warehouse 搜索「OpenCutList」（作者 L'Air du Bois），装完重启 SketchUp。它自己会出现在「扩展程序 → OpenCutList」菜单和工具栏里，与 FPAI 面板互不干扰。
抓取不到视图，提示抓取失败？
抓取的是当前打开模型的视图，需要模型已经打开、并且视口是正常状态。新建一个空白文件也会有默认视图，可以正常抓取。
插入的图跑到哪里了？
结果作为图片实体插入在模型中央上方，竖直立起、正面朝向相机，插入后会自动选中并定位过去。默认宽度按模型尺度自适应（约模型宽度的 1/4，最小 1000mm、最大 6000mm）。想调整大小或位置，用缩放和移动工具正常操作即可。插入会记入一次可撤销的操作。
出图结果存在我电脑的哪里？
默认不落盘：结果先在云端，只有点「保存到本地」才会下载到 D:\FPAI渲染结果\日期\，完成后状态栏会显示完整路径。点「插入到模型」则直接放进当前模型，不会另外存文件。
放了一会儿再点「插入到模型」，提示已过期？
结果的下载链接由服务端签发，有效期 1 小时。点「插入到模型」「保存到本地」「新窗口打开」时，插件会自动用任务号重新换一张新鲜链接；只有换不到时才会提示「请重新出图」，这时重新生成一张即可。
需求描述要不要自己写？
可以留空。点空间类型（家装 / 工装 / 建筑 / 景观）会自动填入一条对应的预设提示词，填在下面的框里可以直接改写；也可以从「预设提示词」下拉里另挑一条。
出图要多久？会扣费吗？
提交后进入队列，面板里会显示实时进度。渲染会按所选模型与清晰度消耗账户额度，额度余量在面板右上角可以看到，未出图前不会扣。
登录失败怎么办？
本插件使用手机号或邮箱加密码登录，不发短信验证码。请确认账号密码无误；连续失败会锁定一段时间。密码需要重置时，请联系管理员处理。
面板显示「后端未连接」？
说明探测不到 FPAI 服务地址，通常是网络受限。点右上角「⋯」打开连接设置，确认服务地址后重试。

版本信息

插件版本 —　·　宿主 —　·　 账号与出图服务由 FPAI 提供，使用前请确认已获得授权。