企业官网建设流程全解析

See-through桌面标注UI完全指南：用Qt6界面高效完成Live2D模型人工修正工作流

【免费下载链接】see-through"Single-image Layer Decomposition for Anime Characters" (SIGGRAPH 2026 Conference Paper)项目地址: https://gitcode.com/gh_mirrors/se/see-through

See-through 是一款被 SIGGRAPH 2026 收录的动漫图像层分解工具，其配套的桌面标注 UI 是一个基于 Qt6 的桌面应用，用于对 Live2D 模型解析结果进行人工修正。本文带你完成从启动界面、翻页浏览、标签修正到结果导出的完整工作流，帮助新手快速上手这套 Live2D 标注工具。

标注 UI 能做什么？

自动模型虽然能把一张静态插画分解为最多 23 个语义层，但边界、左右拆分、遮挡区域总会出现小瑕疵。See-through 桌面标注 UI 就是为此设计的"人工修正工作台"：

• 以项目为单位批量管理多个 Live2D 模型文件夹，每页对应一个模型
• 在画布上查看、选中、修正每个 drawable（图元）的部位标签
• 用彩色掩码叠加层直观核对分割效果
• 一键导出修正后的解析结果为 7z 归档

核心逻辑位于 ui/ui/ 目录：主窗口 mainwindow.py、画布 canvas.py、右侧标签树 tag_tree.py、项目数据管理 proj.py。

三步快速启动 See-through 标注 UI

前置条件：先按根目录 README.md 装好see_throughconda 环境，并在仓库根目录创建assets软链接（ln -sf common/assets assets），否则启动时会因找不到图标而崩溃。

⚠️ 务必以仓库根目录作为工作目录启动，ui/README.md 中明确说明了这一要求。Windows 用户也可以直接双击 launch_ui_win.bat。

启动时可以直接带上项目参数：python ui/ui/launch.py --proj workspace/datasets/<项目名>，即可自动打开指定项目（参数解析见 launch.py）。

工作区结构：UI 期望数据位于workspace/datasets/<项目名>/下，exec_list.txt是模型路径清单，每个模型文件夹含final.jxl源图、final.json元数据和推理生成的*_masks.json掩码文件。

See-through 标注 UI 主界面全览

首次打开项目后，你会看到如下主界面（深色主题）：

界面分为五大区域：

1. 顶部工具栏：Edit / View / Go / Run四个菜单，以及Color Mask（彩色掩码）、Opacity（不透明度）、Contour（轮廓）开关和Tag标签下拉框，右侧还有Is Incomplete/Valid两个页面状态勾选框（顶部栏实现见 top_area.py）
2. 左侧边栏：文件夹图标用于打开/保存/导出项目，下方按钮切换页列表显隐
3. 中央画布：显示当前页的彩色掩码叠加效果，左下角可输入缩放百分比
4. 右侧标签树：按 hair、headwear、face、eyes、ears、topwear、handwear 等 23 个部位分类，每个节点带颜色块和可见性复选框，可展开查看该部位下的所有 drawable
5. 右下角预览窗：实时显示当前选中 drawable 的局部预览

Live2D 标注修正工作流五步法

第 1 步：翻页定位问题页

用A/D键或PageUp/PageDown在项目内逐页切换，标题栏会实时显示进度（如6 / 35）：

左侧页列表还支持右键"Reveal in File Explorer"，直接在文件管理器中定位到对应模型文件夹。

第 2 步：调出彩色掩码辅助核对

勾选Color Mask并调节Opacity，不同部位会以不同颜色叠加在原图上，一眼即可发现标签贴错位置的 drawable。

第 3 步：选中并修正标签

在画布或标签树中点击选中目标 drawable，然后在顶部Tag下拉框选择正确部位，修改会即时生效并自动同步到画布、标签树和预览窗。所有修改都支持撤销/重做。

第 4 步：标记页面状态

• Valid：该页解析结果是否有效
• Is Incomplete：该页模型是否不完整

这两个状态会写入 final.json 元数据，是训练数据质检的关键字段。

第 5 步：借助"前页传播"批量对齐

标签树右键菜单提供 propagate 功能，自动比对上一页的标签投票结果，将当前页能匹配的 drawable 一次性对齐，并对可能出错的条目弹出复查提示——多页连续标注时效率提升非常明显。

See-through 标注 UI 快捷键与高效技巧清单

标题栏Edit菜单集中展示了最常用的编辑功能：

其他实用技巧：

• 按住Ctrl+ 滚轮缩放，底部缩放框可直接输入百分比精确控制
• 在标签树中只勾选感兴趣部位的复选框，可一键隐藏其余标签，聚焦核对
• View菜单支持深/浅色主题切换与显示语言设置，配置会自动持久化

保存与导出：从工作区到 7z 结果归档

每次翻页时 UI 会自动保存当前页的修改（标题栏会显示 saved/unsaved 状态），关闭窗口前也会做兜底保存。

批量修正完成后，点击左侧边栏菜单中的Export Results，UI 会将项目内所有页面的解析文件（parsing_src指定的 json）复制打包为<项目名>.7z归档并弹出保存路径提示——这份归档即可直接用于后续训练数据流水线（参考 README_datapipeline.md）。

常见问题 FAQ

Q1：启动时崩溃或图标显示异常？检查仓库根目录是否存在assets软链接，没有则执行ln -sf common/assets assets。

Q2：打开项目提示依赖错误？官方建议在安装mmdet层依赖（pip install -r requirements-inference-mmdet.txt）后再启动 UI，以保证实例分割等推理功能可用。

Q3：为什么打不开我的数据？确认数据位于workspace/datasets/下且包含exec_list.txt，路径格式见 ui/README.md；模型文件夹结构需符合 scrap_model.py 定义的 Live2D 解析格式。

Q4：部位标签有哪些？23 个一级部位及细分标签完整定义在 bodytags_v3.json 中，包括 front hair、headwear、face、eyes、topwear、handwear、bottomwear、objects 等。

掌握以上流程后，你就可以用这套 Qt6 桌面标注 UI 高效完成 Live2D 解析结果的人工修正，让 See-through 的自动层分解成果真正落地为高质量训练数据。

【免费下载链接】see-through"Single-image Layer Decomposition for Anime Characters" (SIGGRAPH 2026 Conference Paper)项目地址: https://gitcode.com/gh_mirrors/se/see-through