真实 Windows 截图:AI 实景合成主界面,标注模式切换 / 工具栏 / 单子列表 / 预览QC / 日志 / 状态五区

Overview

项目说明

「视觉海岸批量处理工作台」是给婚纱影楼的 AI 产线三合一 Windows 桌面程序——纯 Rust(25,000+ 行)单文件 exe(约 10.2MB),零运行时依赖,双击即用,现已迭代到 v1.5.26。本页用真实 Windows 截图完整展示程序的每一个界面:从登录页到三模式主界面、独立设置窗、成本闸、QC 选片、一对一选景器、前后滑动对比,直到全新的场景库自助管理窗与体检页。


面向真实产线的多模型 Agent Harness

项目目标:针对婚纱影楼传统 PS 手工精修单张耗时 20–40 分钟、12 人数码部门人力成本刚性的痛点,用 Rust + egui 构建单文件桌面 Agent Harness,编排 4 款出图模型 + 视觉判定模型 + 本地锁脸工具,以「判定 → 选景 → 装配 → 出图 → QC → 归集」的账本驱动闭环替代人工修图,并通过场景库自助管理让操作员不碰代码即可扩库。

技术 / 工具栈:

技术 / 工具栈在项目里干什么解决什么问题
Agent Loop + 账本状态机判定→选景→装配→出图→质检→归集全自动串联,每步结果落盘一册 40 张自动跑完;关机重开接着跑,已完成的不重做、不重复扣费
Tool Use + Subagent 分工模型只返回固定 JSON;判景别、场景打标、成图质检三个专职模型各管一摊模型不能自由发挥,答案直接入库;超出值域一律作废,宁可不判绝不错判
LLM-as-Judge(AI 质检)出图后自动比对 11 项(脸/姿势/服装/景别/手部…),有问题标红但不裁决机器先筛一遍人只做终审;手部不合格硬拦「送放大」,避免废片流到下游
Prompt + Context Engineering逐条写死判断纪律;提示词分层装配,4 款模型各拼各的版本同一张图提示词写法不同出错率差几倍;拼错语法会让约束失效直接出废片
KV Cache 缓存复用固定的判定纪律与质检清单统一顶在最前,每张照片的可变信息压到末尾一册要调 80 次模型,前缀完全相同即命中缓存不重复计费;顺序颠倒缓存全失效
Memory 记忆回流判定结果与选景理由落盘存档;判废记录回流成结构化数据,汇总首过率看板重跑不再花钱问模型;把「人为什么否掉这张」变成可统计信号,反哺选景与提示词
MCP + Skills场景检索、账本查询、任务提交封装成 MCP Server;产线纪律写成技能文档能力可被 Claude Code 等客户端直接接管;规矩沉淀成文档,换人换工具都能复用
多模型编排 + 韧性 + 成本闸4 款出图模型按 ¥0.43 / ¥0.5 / ¥3.5 三档切换;五域测速择优、模型下架自动换备用;首张试水成功才放并发单一模型达不到交付标准;上游真下架过模型、卡死过 300 秒;曾整批白烧钱
选景决策引擎 + FaceFusion 锁脸283 张场景照两道硬过滤 + 11 级排序自动选配,附中文理由;出图后把原片的脸像素级贴回选错景整册报废,每次选景可追溯;AI 出图必漂脸,锁脸是交付红线
Rust 工程与交付后台并发 + 四个独立停止开关;共享盘八步安全写盘;10.2MB 单文件 exe;199 项自动化测试界面不卡、停质检不误停出图;写坏生产库整条产线停摆;12 台机零部署,改代码全量自检

我的职责:

  • 设计账本驱动的 Agent Loop 与 9 状态持久化状态机,实现关机续跑、失败重试与成功重做留档;
  • 拆分判定 / 预打标 / QC 三个专职 Subagent,用结构化输出约束与 LLM-as-Judge 实现九字段判景别与 11 项自动质检;
  • 构建分层提示词装配器并做 KV Cache 分区重排降本,配套黄金对拍与 199 项自动化测试守住质量基线;
  • 开发 283 张场景的确定性选景引擎(两道硬过滤 + 11 级排序),实现选景全程可审计;
  • 建成五域探测、模型接力链、烟测门与可中断退避的多模型韧性与成本闸,杜绝无效扣费;
  • 交付场景库自助管理子系统(八步安全写盘管道),并封装 MCP Server 与 Skills 技能包实现能力复用。

项目成果:数码部门编制由 12 人压缩至 4 人(保留终审、选片、锁脸、疑难件、库维护五类人工触点),叠加 AI 调用支出后产线综合成本 ¥48,000/月 → ¥20,300/月,降幅 57.7%,年化节省约 ¥33 万;单张成品成本 ¥8.00 → ¥3.38,人均产能提升 3 倍


三模式:AI 实景合成(判景别 → 七键序选景 → 四轴装配 → 三引擎出图 → AI 预筛)、AI 调色(自然 / 鲜艳 / 冷 / 胶片四档重打光)、AI 高清增强(RunningHub 批量放大)。三个能力串成一条龙:入景 → 调色 → 放大。

本轮相较早期版本的主要演进:

  • 登录系统(v1.5.25):账号密码 + 7 天本机免密、五层失效、明文零落盘。
  • 场景库自助管理窗(v1.5.21):浏览 / AI 预打标入库 / 编辑打标 / 建库改名 / 体检 / 备份回滚——283 plate · 28 库,把场景库运营从「改 JSON」下放为「点界面」。
  • 三出图引擎可切换:gpt-image-2(锁构图 ¥0.43)/ Gemini 4K(17.1MP 保脸 ¥3.5)/ RunningHub 低价通道(17MP ¥0.5),按构图先验路由、成本三档计价。
  • 一对一指定场景、成功单重做、失败单多选重试、4sapi 多域名自动择优等产线韧性升级。

Harness 工程仍是内核:状态机账本驱动关机续跑、首张烟测拦全批、成本闸跑前可见、错误分类重试、199 项自动化测试全绿门禁(黄金对拍 / catalog 完整性 / egui_kittest 无头 UI 硬断言)、与同事 Python 实现逐字对拍互验。

配图说明:登录页为本机实机运行 v1.5.26 直出;其余界面为程序随包《全功能小白图文手册》的直出截图(与实际运行窗口一致,部分带功能标注)——三模式 × 双主题 × 独立设置窗 × 场景库管理窗,程序的每个界面都在这里。

Process

制作流程

每个详情页都把真正重要的步骤拆开,不只展示结果,也展示判断是如何形成的。

真实截图 · 登录页:账号密码 + 7 天本机免密自动登录,v1.5.26
01

登录系统:7 天本机免密,明文密码零落盘

v1.5.25 起程序有独立登录页(紫色渐变、VisionCoast 品牌)。账号密码由负责人线下发放,文档与安装包均无明文;勾选「7 天内本机免密自动登录」后本机 7 天内回车即进,过期需重新输入。安全上做了五层失效——硬过期 / 防篡改 / 绑本机 / 防回拨(改系统时间无效)/ 换口令全体作废,且明文密码零落盘。这是一个面向内部产线的工具,访问控制是交付前提。

真实截图 · AI 实景合成主界面五区(带功能标注)
02

主界面:一屏五区,一个开始键

登录后默认进「AI 实景合成」。界面分五区:① 三模式切换、② 工具栏(开始 / AI 预筛 / 归集 / 输出夹)、③ 独立参数设置窗入口、④ 单子列表(每张原片一行,看状态 / 改景别 / 勾重试)、⑤ 预览 QC 区(原片↔结果对比)、⑥ 日志(可过滤 / 搜索 / 导出)、⑦ 状态·缩放·主题·版本。操作员选原片文件夹、点「▶ 开始出图」,后台自动跑完判景别 → 选景 → 装配 → 出图 → 落盘。

真实截图 · 浅色主题主界面:同一布局骨架跨主题不裂
03

界面工程:深浅双主题,一键切换、选择记住

深色为默认(中性深灰画布不干扰看图评色,对标 Lightroom);顶栏「🌓 主题」一键切浅色(Apple HIG 分组灰 + 白卡),选择持久化。两套主题共用同一布局骨架:标题 → 工具栏 → 列表 / 预览 / 日志;系统蓝强调 + 绿/橙/红语义状态色。20260721 的 UI 大改引入 slate + 靛蓝设计系统、顶栏分段控件、品牌 splash 与四层字体族——修图师白天黑夜都不刺眼。

真实截图 · 实景合成参数设置窗:引擎 / 额度 / 283 plate 场景库 / 并发 / 烟测门
04

参数设置:独立窗口,三引擎与场景库都在这里

每个模式工具栏最右的「⚙ 参数设置」点开一个独立小窗(可拖到旁边边看边调,改即生效、关窗自动保存)。实景合成设置窗含:4sapi Key、调色档、**出图引擎下拉(gpt-image-2-c / Gemini 4K / RH 低价)**、场景池、原片 / 输出文件夹、实时额度、场景库路径(已加载 283 张 plate)、「管理场景库…」入口、并发数、断点续跑与烟测门开关。

真实截图 · 成本闸:本批 3 张 ≈ ¥1.3,跑前预估
05

成本闸:跑前先算这批多少钱

纯 API 产线每次点击都是真金白银。点「开始」前,工具栏旁的成本闸先算出「本批 3 张 ≈ ¥1.3」并标出「按 ¥0.43/张,估算判景别另计几分/张」——引擎不同分档计价(gpt ¥0.43 / RH 低价 ¥0.5 / Gemini ¥3.5)。可预期的成本,是影楼敢把这条产线排进报价单的前提。

真实截图 · QC 选片:原片↔结果候选并排 + AI 预筛徽章 + 选用/判废
06

QC 选片:原片↔结果并排,AI 预筛只标红

出图后进 QC:每张「原片↔结果候选」全分辨率并排,人做终审「选用 / 判废」。工具栏「🔎 AI 预筛」按 11 项(保本人 / 姿势 / 服装配饰 / 景别 / 接地 / 基调 / 双人 / 手部 / 干净 / 比例 / 空侧)与原片比对,只标红不裁决——把人从逐张全看降为只看疑点。铁律「验收不接 AI」:最终选片、判废永远由人裁决。

真实截图 · 一对一指定场景:按景别筏向过滤的缩略图选景器
07

一对一指定场景:不满意就换个背景重出

v1.5.23 新增。某一单选景不理想,点「选景」弹出「指定场景」缩略图窗:清单已按这一单的景别与筏向过滤过(**选不出错的**),点一张即指定给这单并自动勾选重试。带蓝框的是当前用景。把「换背景重出」从改配置变成点缩略图。

真实截图 · AI 调色模式:四档重打光,内容构图不变
08

AI 调色:整册统一色调,自然 / 鲜艳 / 冷 / 胶片四档

第二模式「AI 调色」——任意成品图整图重打光,四档:自然(还原实拍)、鲜艳、冷、胶片(20260806 按示例色调重写为「胶片·浓郁大片」,去灰蒙 + 晴空湛蓝 + 明亮通透 + 细节零重绘)。人物内容构图完全不动,`原名_g.png` 输出。全册基调一次定死是产线铁律,三 / 四档并排就是给客户看的色卡。

真实截图 · AI 高清增强模式:工作流节点识别 / 参数表单 / 状态筛选 / 余额徽章
09

AI 高清增强:RunningHub 批量放大 / 精修

第三模式接 RunningHub(ComfyUI 云端,Flux2-Klein 精修放大)。工作流 JSON 拖进来自动识别输入 / 输出节点、参数表单化、预设可存取;上传 → 提交 → 轮询 → 下载全自动,断点续跑,右上余额徽章常驻。图片列表带状态筛选(全部 / 进行中 / 成功 / 跳过 / 失败),`原名_rh.png` 输出。三个能力串成一条龙:入景 → 调色 → 放大。

真实截图 · 前后滑动对比查看器:滑动条逐像素比对
10

前后对比查看器:适应 / 1:1 / 并排 / 滑动

处理前后对比是产线终审的核心工具:全分辨率,支持「适应 / 1:1」缩放、「并排 / 滑动对比」切换,滑动条可拖动逐像素比对。缩略图后台解码不卡界面,可一键用系统程序打开原图 / 结果。QC 就在这块屏上完成——不用打开任何别的软件。

真实截图 · 场景库自助管理窗:库列表 / plate 网格 / 结构化打标详情(带标注)
11

场景库自助管理窗:把审美变成一张可管理的数据库

v1.5.21 新增的独立管理窗(设置窗 →「管理场景库…」)。三栏:① 库列表(28 库)、② 库内 plate 缩略图网格、③ 详情打标——每张 plate 的结构化字段(库 / 文件 / 景别适配 fits_shot / 横竖 / 构图 composition / 光线档 light_key / 机位 view_angle)一目了然。顶部「+ 添加场景」走 AI 预打标入库,「配置卡 / 新建库 / 编辑打标 / 下架恢复」齐全。场景库运营从「找开发改 JSON」下放为「操作员点界面」。

真实截图 · 场景库体检:0 错误 + 逐库家底统计(plate数/竖横/景别覆盖)
12

场景库体检:数据质量也有门禁

管理窗「体检」页对整库做完整性校验:「0 错误 = 库是健康的」,黄字提示逐条给出可补的项(横竖单侧向、raft XOR、无 full 档等),并列出每库家底——plate 数 / 竖横比 / 景别覆盖 / raft 桶 / 光线档。plate 质量决定成片下限,所以库本身也要过门禁;这与代码侧 catalog_integrity 测试同口径。

Thinking

设计思路

这里说明为什么这样做,而不是只列出做了哪些动作。

为什么是 Rust 单 exe,不是 Electron / Python

用户是影楼修图师——交付物必须「拷过去双击就能用」。Python 要装环境,Electron 拖 200MB 运行时;Rust + egui 出 10.2MB 单文件,TLS 走系统 Schannel 连 OpenSSL 都不带,12 台机零部署。配置存 exe 同目录、原子写,换机连配置一起拷走;单实例守卫防重复开窗。

Harness 的第一性原理:人只在该决策处出现

自动化不是把所有事交给 AI,是精确回答「哪些判断不可省」。答案只有两个:判景别(可手改)与 QC 终审(只裁决)。其余选景、装配、出图、重试、记账、归集全部机器化,靠状态机账本(pending→prompted→generating→awaiting_qc→selected→done)驱动,关机重开接着跑、已完成的不重做不重复扣费。

场景库是数据库,自助管理窗是它的后台

「这张海景好看」不可执行;fits_shot / light_key / figure_anchor / view_angle 这些字段可执行。283 plate 每张一条结构化数据,选景算法读字段而非「看图感觉」。把打标 / 建库 / 体检 / 回滚做成 GUI 管理窗,是把「场景库的 schema 维护」从工程师手里下放给操作员——数据运营不再是发版事件。

三引擎:选型不问哪个强,问哪种失效可控

gpt-image-2 像素编辑锁构图但清晰度被档位钉死;Gemini 17.1MP 保脸但先验外元素每抽掷骰;RH 低价通道 ¥0.5 出 17MP 但结构仍是抽签。没有单一引擎能单抽过四轴红线(三引擎 13+ 抽实证),所以按构图先验路由 + 人工终审兜底,并把三档成本写进成本闸。

回归门禁与确定性:能复现先于能修复

199 项自动化测试全绿才发包——与 Python 参考实现逐字对拍的黄金样本、catalog 完整性、状态机干跑、egui_kittest 无头模拟真实控件树点击的布局硬断言。进度动画用固定种子抖动,「动画对不对」都能变成合成时间轴上的单测。随机抖动固定种子、键序重构给等价证明、账本字段 serde default 兼容旧账本——不确定的系统连 bug 都无法拥有。

成本与韧性是一等公民

纯 API 产线的命门是「跑一半断流」与「跑完才发现全废」:首张烟测通过才放全批(07-02 ¥1.53 教训)、成本闸跑前预估、错误分类重试(瞬时退避 / 持久响亮中止)、停止弃在途不写盘、4sapi 多域名自动择优、断点续跑按文件名跳过。可预期的成本与不丢单的韧性,是这条产线能对客户收费的底座。

Result

交付与结果

交付内容
  • 单文件 exe(约 10.2MB,12 台机零部署)零运行时依赖:GNU 工具链 + 系统 Schannel TLS,无 OpenSSL / WebView2 / .NET,双击即用;单实例守卫防重复开窗
  • 登录系统:账号密码 + 7 天本机免密自动登录、五层失效(硬过期 / 防篡改 / 绑本机 / 防回拨 / 换口令全作废)、明文密码零落盘
  • 三模式一套外壳(全部附真实截图):AI 实景合成 / AI 调色 / AI 高清增强 + 独立参数设置窗 + 深浅双主题
  • 场景库自助管理窗:库/场景浏览、AI 预打标入库、编辑打标、建库改名、体检、备份回滚——283 plate · 28 库,数据库式管理
  • 三出图引擎可切换:gpt-image-2(锁构图 ¥0.43)/ Gemini 4K(17.1MP 保脸 ¥3.5)/ RunningHub 低价通道(17MP ¥0.5)
项目结果
  • 数码部门编制 12 人 → 4 人(保留终审 / 选片 / 锁脸 / 疑难件 / 库维护五类人工触点)
  • 产线综合成本 ¥48,000/月 → ¥20,300/月,降幅 57.7%,年化节省约 ¥33 万
  • 单张成品成本 ¥8.00 → ¥3.38,人均产能提升 3 倍
  • L3 全册一键:判景别 → 选景 → 装配 → 出图 → 预筛全自动;账本状态机让关机重开接着跑、已完成的不重做不重复扣费
  • 场景库运营下放操作员:自助管理窗内加图 / 建库 / 体检 / 回滚(283 plate·28 库),主机改一次全员生效、程序零发版
  • 25,000+ 行 Rust、199 项自动化测试全绿门禁:黄金对拍 / catalog 完整性 / 状态机干跑 / egui_kittest 无头 UI 硬断言