﻿FPAI 渲染 · DCC 面板 —— 使用说明
==========================================================

一、怎么打开
----------------------------------------------------------
方式一（推荐）：双击「FPAI 渲染.exe」
  单个可执行文件，双击即用。它会自动释放文件并弹出面板窗口，
  不需要解压、不需要安装、不需要任何运行库。
  首次双击可能稍等一两秒（在释放文件），之后打开很快。

方式二：解压本压缩包，双击「启动 FPAI 渲染.vbs」
  同样弹出独立窗口（无地址栏、无标签页、无菜单栏）。
  如果双击没反应（被杀软或组策略拦截），改用「启动 FPAI 渲染.cmd」。

两种方式的界面、登录状态完全一致（数据都在同一个位置）。

二、怎么在桌面放一个图标（可选）
----------------------------------------------------------
双击「创建桌面快捷方式.vbs」→ 桌面上会出现一个带 FPAI 木金图标的
「FPAI 渲染」，以后从桌面双击就能开。

如果双击没反应，手工做：
  1) 右键「启动 FPAI 渲染.vbs」→ 发送到 → 桌面快捷方式
  2) 右键桌面上这个快捷方式 → 属性 → 更改图标 → 浏览 → 选 fpai.ico

三、怎么登录（重要）
----------------------------------------------------------
本项目支持「手机号或邮箱 + 密码」登录，不使用短信验证码。

点「立即登录」→ 在「手机号 / 邮箱」里填手机号或邮箱（二选一，同一个框）
→ 填密码 → 点「登录」。

· 手机号未注册时，首次登录会自动创建账号（以后端实际规则为准）。
· 密码不对、账号有疑问，请联系你的 FPAI 管理员。
· 不用密码也可以：点「改用 Token 登录」，粘贴官网个人中心里的 Token。

四、怎么出图
----------------------------------------------------------
登录后进入工作台
· 参考图：点「抓取当前视图」（在 DCC 宿主内），或把图片直接拖进方框，
  也可 Ctrl+V 粘贴
· 选空间类型：家装 / 工装 / 建筑 / 景观。点一下会自动从预设库里挑一条
  提示词填进「需求描述」，同时把「预设提示词」下拉收敛到该类型对应的
  那几组（不用在 90 条里翻）。想取消就再点一下同一个类型
· 需求描述：可以直接改写上面自动填入的提示词。留空也能出图，
  面板会按空间类型兜底一句通用描述
· 选模型：下拉里是「模型」本身（如 GPT Image 2、Nano Banana Pro），
  与官网首页同一套口径，不显示内部线路名
· 选分辨率：「1K / 2K / 4K」是所选模型支持的一档清晰度，
  换模型时档位会跟着变（只列该模型真正支持的档位）
· 选画面比例，点「开始渲染」，等进度条走完
· 出图后有三个动作：
  - 插入到模型：作为图片实体放进当前模型，落在模型中央上方、竖直立起正对相机，
    插入后自动选中并定位过去
  - 保存到本地：下载留档到 D:\FPAI渲染结果\日期\，状态栏显示完整路径
  - 新窗口打开：用系统默认浏览器看大图

五、配色与主题
----------------------------------------------------------
面板配色与 FPAI 官网完全一致（木金主色 + 官网暖白/深墨），
并提供深浅两套配色：点右上角「◐」即可切换，默认浅色（与官网一致）。
你的选择会被记住。

六、窗口图标 / 任务栏图标
----------------------------------------------------------
窗口标题栏和任务栏显示的都是 FPAI 的木金标记，不是浏览器图标。
它由面板页内联的品牌图标提供，不需要额外安装任何东西。

七、装进 SketchUp
----------------------------------------------------------
用「扩展程序管理器 → 安装扩展程序」选包里的 fpai_render.rbz，装完即用。

装好后在 SketchUp 里点 FPAI 按钮，会先抓当前视图当参考图，再唤起面板。
面板和插件是同一套前端，登录状态、模型列表都跟着走。

（3ds Max 版正在内测，上线后在官网单独提供 .mzp 安装包 —— 不随本免安装包附带。）

SketchUp 里会多出一条名为「FPAI 渲染」的工具栏，共 5 个按钮：
  · FPAI 渲染      打开 / 唤出面板（与菜单「扩展程序 → FPAI 渲染助手」等效）
  · 抓取当前视图    按当前视角重抓一张参考图
  · 切换场景       按顺序切到当前模型的下一个场景（多场景批量出图用）
  · 插入渲染结果    把最近一次出图结果插进模型，不必回面板再点一次
  · 使用说明       打开插件的图文说明页（快速上手 / 按钮说明 / 常见问题）

工具栏没显示时：在工具栏空白处右键勾选「FPAI 渲染」。首次创建可能是浮动小条，
拖到顶部工具栏区即可停靠。

配料单（切割清单 / 切割图 / 材料估算）不自研 —— 直接用木作行业的开源标准
OpenCutList（L'Air du Bois，GNU GPLv3）。两个入口：
  · 面板左侧功能栏的「配料单」，点一下即调起它的官方面板
  · 或 SketchUp 菜单「扩展程序 → OpenCutList 配料单（官方）」
首次使用请先在「扩展程序管理器」里安装官方扩展（免费），Extension Warehouse
搜「OpenCutList」即可；装完重启 SketchUp。它自己也会出现在「扩展程序 →
OpenCutList」菜单和工具栏里，与 FPAI 面板互不干扰。

（2026-10-12 按用户反馈：原「FPAI 工具箱」已整体移除；场景管理 / 插件市场 /
插件助手三个功能仍在菜单「扩展程序」里。）

面板左侧还有一条功能栏，七个入口各有各的用处：
  · 渲染        抓图 + 空间类型（家装 / 工装 / 建筑 / 景观，点了自动填预设）+ 需求描述，出效果图
  · 方案生成    拿体块或线稿一次出两个方案，横向比较后再挑
  · 全景渲染    出宽幅环视图，按住画面左右拖动即可环视
  · 批量渲染    读取当前模型的全部场景，勾选后逐个排队出图
  · 画布        在图上框选一块区域，只改那一块
  · 历史        本地留存的出图记录，可插入模型 / 保存到本地 / 回填提示词再改一版
  · 配料单      调起官方 OpenCutList 的面板（切割清单 / 切割图 / 材料估算）

两点如实说明：全景渲染出的是宽幅环视图（服务端暂无 360 球面管线）；
画布是「引导式局部重绘」（服务端暂无局部重绘管线），实际改动范围由模型理解决定。

另一点如实说明：个别模型档位在「图生图（带参考图）」时，上游偶发只回空结果。
遇到这种情况面板不会假装成功，会明确提示「上游没有返回图片」，并提示你带上那句
提示联系客服核对算力——因为该次算力很可能已被扣除。

插入的渲染结果落在模型中央上方、竖直立起并正面朝向相机，插入后会自动选中并定位过去；
默认宽度按模型尺度自适应（约模型宽度的 1/4，最小 1000mm、最大 6000mm），可自行缩放移动；
插入记为一次可撤销操作。

八、运行依赖
----------------------------------------------------------
只需要 Windows 自带的 Edge（或 Chrome）浏览器，无需安装任何运行库。

面板的登录状态等数据存放在 %LOCALAPPDATA%\FPAI DCC\shell-profile，
删掉该文件夹即等于「恢复出厂设置」。

九、出图结果放在哪 / 链接会不会过期
----------------------------------------------------------
· 出图结果默认不落盘，只存在云端：只有当你点「保存到本地」或
  「插入到模型」时才会下载到本机。所以找不到图在哪里是正常的 ——
  它在此之前本来就没有下载过。
· 「保存到本地」的存放位置是：
      D:\FPAI渲染结果\YYYY-MM-DD\
  文件名形如 FPAI_渲染_20261009_141230.png（按结果类型 + 时间命名）。
  同名不会覆盖，会自动加 _2、_3 后缀。保存完成后状态栏会显示完整路径。
· 结果的下载链接由服务端签发，有效期 1 小时。超过 1 小时后点
  「插入到模型」「保存到本地」「新窗口打开」，面板会先用任务号重新换一张
  新鲜链接，所以正常情况下你不必关心这件事。
  万一换不到（例如服务端记录已被清理），面板会明确提示
  「这张图已过期，且拿不到新链接，请重新出图」，不会静默失败。
· 工具栏的「插入渲染结果」同理：面板开着时它交给面板去做（面板才有
  账号凭证去换新链接）；面板关着时用最近一次记录直接插入。

十、说明
----------------------------------------------------------
本面板为 FPAI 自研，界面与配色按 FPAI 自有设计规范实现，
服务端指向 FPAI 自有后端（默认 https://openfpai.com）。
