每一步，都有答案。

下载与首次启动

从官网下载区下载 Windows 64 位加密轻量包。使用 7-Zip、WinRAR 等支持 AES 的工具，输入发布者提供的密码，把整个 ZIP 解压到可写文件夹，再双击 启动 HMI Studio.vbs。

1. 首次运行如果缺少组件，启动器会显示所需内容；选择“下载并启动”。
2. 运行环境约 172 MB，自动保存在软件目录，不需要另行配置 Python 或 Node.js。
3. 准备完成后，软件窗口自动打开。以后可直接启动，日常编辑支持离线使用。
4. 先体验设计：点击“添加素材”，选择包内 素材/绿境温室-公开演示.svg。它包含 3 页原创温室设计。

先认识两个工作区

同一个工程里，“工程画面”显示已存在的原生页面和控件，“设计调整”处理素材、布局、底图和状态关系。你可以在两边来回维护。

“调整已自动保存”表示工作副本已保存；“已写入工程”表示修改已经落到工程文件。黄色圆点表示还有待写入内容。完成编辑后，通过“写入工程”的预览统一确认。

点击放大

点击放大

为工程绑定设计器

1. 点击左上角工程菜单 → “打开工程…”，选择 .tftp 工程文件。工程可以位于任意文件夹。
2. 在绑定栏点击“查看 / 更换”，或进入“设置 → 设计器位置…”。
3. 选择配套的 GUIDesigner.exe 或安装目录，等待程序与内核检查完成。
4. 核对它适用于工程的目标硬件，勾选确认并绑定。随后点击“在设计器打开”。

一个设计器可以服务多个工程，每个工程各自记住绑定。同版本号的设计器也可能包含不同硬件内核；复制到新电脑、移动目录或更换内核后，重新检查绑定。绑定完成后的状态栏可在上一章的真实工程截图中看到。

导入一份或多份素材

1. 点击“添加素材”，选择文件，或将 SVG / HTML 拖入画布。可以一次选择多份文件。
2. 有外部图片时，使用桌面版文件选择或填写完整路径，让软件找到相对路径资源。
3. 首次导入选择“新增独立页面”；已有素材时，按下一章选择更新方式。
4. 批量导入逐项核对处理方式与目标素材组。多份文件冲突更新同一目标时，先拆开处理。
5. 进入设计调整，检查页面数量、文本、图片和状态。导入本身不会立即写入工程。

给 AI 设计时，从“导出”菜单取得 SVG 或 HTML 生成规约，与需求一起提供。维护已有设计时附上完整素材，保留页面与控件的稳定标识。普通插画 SVG 不会仅凭外观自动获得按钮或业务语义。

点击放大

更新、恢复与单页回导

1. 导入修改后的文件，在“更新哪组页面”选择原素材组。
2. 只维护一页时，回导该页文件即可；页面和控件标识用于找回对应关系。
3. 到“底图设置”核对写入目标。只改控件可保留工程底图；换皮肤选择“使用素材重新生成底图”。
4. 查看写入预览，确认更新对象和删除清单，再写入。

单页或局部导出文件会记录维护范围，未包含的页面和控件继续保留。现有原生行为、输入设置和 Lua 按维护规则保留；如果改动了稳定标识，软件可能把它识别成新对象，回导前应核对。

画布、搜索与布局

1. 左侧选择页面，再选择当前页元素。页面和控件标题右侧显示数量。
2. 点击标题旁的放大镜展开搜索；不需要时收起，给列表留出空间。
3. 上下两段列表之间的分隔条可拖动调整高度；双击恢复。左右边栏也可调整宽度或收起。
4. 在画布中选择、拖动对象，右侧可精确输入坐标和尺寸。使用“适应窗口”找回整页视图。

“整体 / 底图 / 控件”切换编辑图层；“原稿参考 / 与原稿对比”用于核对效果。缩放、搜索和临时预览开关不会改动工程属性。

文字、输入与 RTC

修改文字或数值输入

1. 选择文字对象，在右侧修改文案、字体、字号、颜色和对齐。
2. 在工程画面中，可继续设置输入方式、键盘、最小值、最大值和小数位数。
3. 调整显示区域后检查长文案和不同语言是否放得下，再写入工程。

设置时钟

“当前页控件”旁的加号可添加时钟。选择 RTC 后设置显示格式、语言、时差、是否允许编辑及按压方式。日期与时间可组合，使用自定义格式时同时检查显示宽度。

按素材新增的 RTC 默认使能，并支持长按编辑。已有工程的 RTC 设置按工程保留；在设计器中改为不可编辑后，重新读取工程即可同步。编辑时间的小键盘还需要“允许编辑”、使能和正确按压方式同时成立。

点击放大

按钮、底图与独立文字

一个按钮可以由透明触控框、状态图片和独立文字共同组成。先选对调整方式，再移动或缩放。

1. 在设计调整中选中按钮，“按钮整体”联动图形、触控与关联文字；只改点击区域时选择只调触控。
2. 展开按钮外观与行为，选择正常、按下、选中或禁用图片，并检查初始状态。
3. 文字方式可以是“按钮原生文字”或“独立文字控件”。分离后可单独调整文字位置、字号及译文。
4. 图形超出触控框时，使用“触控框包住图形”；想让图形适配现有范围则使用“图形适配触控框”。
5. 设置页面跳转或 Lua 通知后写入，在对应设计器中验证运行效果。

普通按钮正常态可留在页面底图，松开图片为空仍然有效；按下态使用独立图片。PNG 保留透明区，自动模式遇到透明区域也会使用 PNG。软件不会按“开始灌溉”等文案自动生成设备控制逻辑。

点击放大

新建、删除与撤回

新增页面与控件

工程画面标题旁的加号新建页面；“当前页控件”旁的加号添加控件。新建和修改先进入待写入状态，可以通过撤销返回。已有特殊控件可以复制同类对象，再调整可维护属性。

删除页面

1. 点击页面标题右侧“管理页面”。
2. 勾选一个或多个页面，点击“删除所选”，页面进入待删除状态。
3. 写入前可以撤回；确认写入后，删除才进入工程文件。

点击放大

删除按钮和分离文字

选择控件 → “删除控件…”。确认按钮关联的底图图形，以及是否同时删除分离文字。取消相应勾选可保留文字。绑定图片文件继续保留，其他控件引用同一资源不受影响。

点击放大

取消“参与导入 / 参与本次写入”只排除本次写入，不等于删除。未关联控件是工程中仍存在、尚未关联当前素材的对象，默认保留。Lua 中的引用不会随删除自动改写，写入前检查相关提示。

隐藏项与未完成的占位

空文本、没有图片的按钮和初始隐藏项都可以保留，用来继续制作未完成的页面。

1. 在工程画面勾选“显影隐藏项”，临时查看隐藏控件的位置。紫色虚线帮助识别，它不改变初始可见属性。
2. 需要实际显示或隐藏时，在属性面板修改“初始可见”。
3. 导出窗口按需选择隐藏项、空文本 / 占位项和新控件，可展开每页逐个勾选。
4. 回导时维护这些对象的标识与状态；空白部分不必先画成有色方块。

提取的透明状态资源看起来可能是空白，它有时代表按钮正常外观已放在整张背景里。展示素材可以进一步整理或重绘；工程维护时先保留原有绑定关系。

检查并写入工程

1. 先在设计器保存要保留的修改，关闭当前工程，避免旧窗口再次保存覆盖新内容。
2. 设计调整中选择“有改动的页面”“当前页面”或“勾选的页面”；工程画面中的原生修改也会列入待写入检查。
3. 点击“写入工程”，查看新增、调整、删除的页面和控件。
4. 有阻止项时使用“定位到对象”，修正后重新检查。可以展开完整明细核对自动保留内容。
5. 确认写入，完成后关闭结果窗口。顶部显示“已写入工程”，再点击“在设计器打开”查看。

点击放大

想把修改保存成另一个工程，使用工程菜单“工程另存为…”。如果设计器窗口未刷新，应关闭并重新打开对应工程；不要用旧窗口覆盖刚写入的版本。

按页、按控件导出

1. 点击“导出” → “SVG 设计文件”或“HTML 设计文件 · Beta”。
2. 选择需要的页面；可只选当前页，也可多选多个页面。
3. “文件组织”选择合并为一个文件，或每页一个文件。
4. 展开页面的控件列表，决定是否包含背景、隐藏项、空文本 / 占位项以及新增对象。
5. 点击“导出并检查”。修改导出结果后，按回导步骤更新原工程。

点击放大

工程中新加的页面和控件默认不选，请按需勾选。未勾选对象不会因回导自动删除。已保存的设计调整可以随素材导出；原生工程或设计器中尚未写入、尚未保存的修改，应先完成保存再导出。

单页素材携带所需状态图片；跨页跳转在同一工程回导时恢复关联。图片按现有 PNG / JPG 保留，不会自动转回可编辑矢量。HTML 与 SVG 可以用于维护流转，复杂效果仍应核对回读与预览结果。

从老工程提取设计

1. 打开老工程并绑定它原来使用的设计器。
2. 工程名菜单 → “从工程提取设计 · Beta”。先处理待写入的原生修改。
3. 查看提取结果中的页面、可维护控件和跳过项；进入设计调整检查布局。
4. 导出需要的页面，交给设计工具或 AI 整理，再导回同一工程维护。

已关联素材的工程无需重复首次提取，直接通过设计调整和导出继续维护。原生菜单、滑块、曲线等控件的支持程度取决于类型和属性；跳过的对象仍保留在原工程，不妨碍更新其他受支持控件。

撤销、历史与另存为

1. 编辑中使用工具栏“撤销 / 重做”，处理尚未写入的调整。
2. 已写入的修改：工程菜单 → “历史与恢复”。
3. 选择记录 → “查看恢复内容”，核对文件与对象后确认恢复。
4. 恢复操作本身也生成记录，可继续沿可恢复的历史链维护。

点击放大

“素材 → 来源与版本”用于查看素材来源与迭代；它与整工程历史恢复用途不同。准备大幅改版时，工程另存为能保留一条独立分支。保留工程目录中的维护元数据和备份，复制工程时一起复制。

多语言与本地 AI

1. 点击“多语言”，选择当前设计文字或工程已有控件。
2. 输入语言名并追加，在表格中逐项填写译文。正常与按下文字可以分别保存。
3. 展开“本机翻译与工程术语”，可先用术语、繁简转换填入，再使用本机 AI 补全空项。
4. 应用后切换预览语言，检查长文字、对齐和按钮宽度，再写入工程。

点击放大

按需安装 AI

进入“设置 → 本地 AI 组件…”。Qwen3.5-4B 模型约 2.74 GB，下载时一并准备推理组件；支持暂停与继续、文件校验。建议 8 GB 以上可用内存，软件所在磁盘预留约 4 GB。

点击放大

模型在本机完成翻译。未填译文可沿用默认文案，已有译文保留；主动清空则表示需要空文字。图片中已经烘焙的文字需要改图片。语言切换按钮按设计需求制作，并在工程中接入切换行为。

定位问题与操作速查

写入或导出被阻止

打开检查明细，点击“定位到对象”。软件会切换到对应页面、选中对象并显示问题属性。例如文本越界要调整位置或尺寸；按钮图形超出点击区域可使用“触控框包住图形”。文件级错误不一定对应一个画布对象。

点击放大

解析或导出时间较长

优先导出正在维护的页面，避免每次处理全部页面。复杂位图、状态资源和全工程首次解析需要时间；关注底部阶段提示，避免重复触发同一任务。软件会使用已实现的缓存和并发处理，没有需要用户开启的“GPU 加速”开关。

下载中断或环境缺失

重新打开启动器继续准备；AI 下载在组件窗口继续。网络仍无法连通时检查对应来源，保留已下载的文件。压缩包密码由发布者提供；更新密码后，请下载新版压缩包。

找不到窗口或打开了错误版本

从目标安装目录启动，检查任务栏已有窗口。完整复制软件时，保留 app、tools 和启动文件的相对位置；工程、设计器和软件是三个独立路径。