照片流
下载应用
返回插件中心

官方插件 · team-retouch

团片协作

把多人合照按人物拆成小图分发修图，收回后自动对齐、匹配并合回原始尺寸。基础包包含本地检测模型，PairDETR / SAM 2.1 高级模型环境单独安装。

Windows x64本地处理基础模型已内置可选高级模型
下载插件查看安装说明 →
01

功能概览

团片协作可以帮你做什么

适合毕业照、社团合照、舞台合影和其他需要多人分别处理自己形象的照片。插件会保留原始大图，把协作任务拆成更适合手机或个人修图软件处理的小图，最后把结果重新合成。

人物检测与裁切

识别画面中的人物，规划带安全边距的裁切区域；误检人物可以排除，裁切范围可以调整。

身份与接收人

为人物填写姓名、分组和接收人，复用已确认的身份，减少多张照片重复整理。

协作小图导出

生成适合分发的小图与任务清单，不需要把高分辨率原图传给每一个参与者。

返图检查

批量接收处理结果，检查缺失、重复、无法匹配和需要人工确认的文件。

自动合回原图

对齐返图、匹配颜色、处理重叠区域，再合回原始尺寸并登记为新的照片版本。

任务与版本记录

长任务显示进度并支持取消；导出、返图和合并结果都留在项目与版本关系中。

02

工作方式

从人物检测到返图合并

  1. 选择照片在项目中进入团片协作，登记需要处理的多人合照。
  2. 检测人物使用基础模型检测人物；检查边框，排除误检并补充身份信息。
  3. 生成任务按接收人生成裁切小图和分发材料。
  4. 收回返图导入对方处理后的图片，插件根据身份与任务记录进行匹配。
  5. 确认差异逐项处理缺失、冲突、重复或无法自动匹配的结果。
  6. 合并发布自动对齐、调色与融合，输出完整大图并创建新版本。
03

基础安装

安装团片协作插件

  1. 1
    下载团片协作 ZIP

    在首页下载区获取与当前照片流版本匹配的 PhotoFlow-team-retouch-*.zip，不要提前解压。

  2. 2
    打开组件根目录

    进入“设置 → 插件管理”，点击“组件根目录”旁的“打开”。

  3. 3
    复制并刷新

    把 ZIP 原样放入组件根目录，回到插件管理点击刷新。

  4. 4
    安装并校验

    点击团片协作行中的“安装”，等待版本、清单、必需文件和完整性验证通过。

  5. 5
    打开插件

    进入项目文件页，通过“团片协作”入口打开独立工作页面。

无需额外安装 Python基础包包含自包含运行时以及 RTMDet、YuNet、AdaFace 和 OSNet 模型；未安装高级环境时，基础人物检测和完整协作流程仍然可用。
04

首次设置

设置人物检测和裁切方式

检测设备

按设备情况选择基础模型的运行方式；先用一张副本照片确认速度和识别效果。

裁切偏好

根据人物距离和后续修图方式调整裁切边距，避免头发、手臂或服装被截断。

工作图分组

默认自动分组；选择“每人一张”后，每个检测目标生成独立任务、裁切和人物蒙版。已有任务需明确重新检测才会改变。

高级环境状态

设置页会显示 PairDETR / SAM 环境是否可用，并提供预检、安装、修复和卸载操作。

组件停用

暂时不用时可在插件管理中停用；页面、服务与工作进程会关闭，但用户数据保留。

05

可选高级模型

安装 PairDETR 和 SAM 2.1 高级模型

高级环境用于 PairDETR 人物检测和 SAM 2.1 分割。它不是基础团片协作的必需项。照片流不会临时下载 Linux、Python、模型或仓库；用户需要先安装 WSL 2 和 NVIDIA 驱动，再导入照片流提供的高级离线包。

系统与硬件要求

Windows

Windows 11 x64，或 Windows 10 2004（Build 19041）及以上版本。使用 winver 查看版本和内部版本号。

处理器虚拟化

任务管理器“性能 → CPU”中的“虚拟化”必须显示“已启用”；未启用时进入 BIOS/UEFI 打开 Intel VT-x 或 AMD-V/SVM。

管理员权限

安装 Windows 可选功能、WSL、驱动和导入 WSL 虚拟磁盘时需要管理员权限。

NVIDIA 显卡

需要 NVIDIA GPU，以及支持 CUDA on WSL 的当前 Windows 显卡驱动。

磁盘空间

高级安装位置至少保留 35 GB 可用空间；虚拟磁盘、模型和工作缓存会长期占用该空间。

离线包

使用设置页要求的独立高级运行时 ZIP，版本和 SHA-256 必须与基础插件声明匹配；运行时版本独立于基础插件版本。

安装会创建 WSL 发行版照片流会注册名为 PhotoFlowNative 的 WSL 2 发行版，并在组件数据目录保存大型 ext4.vhdx。这与安装普通插件 ZIP 不同，需要用户明确确认。

联网安装 WSL 2

  1. 1
    确认 Windows 版本和虚拟化

    运行 winver；在任务管理器检查 CPU 虚拟化状态。若未启用，先修改 BIOS/UEFI 并重新进入 Windows。

  2. 2
    以管理员身份打开 PowerShell

    在开始菜单搜索 PowerShell，右键选择“以管理员身份运行”。

  3. 3
    只安装 WSL，不安装 Ubuntu

    团片协作会导入自己的 PhotoFlowNative 发行版，因此不需要额外安装 Ubuntu。

wsl --install --no-distribution

命令完成后重新启动 Windows。重启后再次打开 PowerShell，执行以下命令确认 WSL 2 可用：

wsl --update
wsl --set-default-version 2
wsl --status
wsl --version
Microsoft：安装 WSLMicrosoft：WSL 基本命令

手动安装 WSL 2

企业网络、LTSC 或离线电脑可以手动安装 WSL。本步骤只安装 WSL 平台，不需要另行下载 Linux 发行版。

  1. 1
    下载官方 WSL MSI

    在 Microsoft WSL 的 GitHub Releases 页面打开最新版本，在 Assets 中下载适用于 x64 Windows 的 WSL MSI 安装包，并以管理员身份安装。

  2. 2
    启用两个 Windows 可选功能

    在管理员 PowerShell 中运行下面两条 DISM 命令。

dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
  1. 3
    重新启动 Windows

    两项功能启用后必须重启，虚拟机平台才能加载。

  2. 4
    设置并检查 WSL 2

    运行 wsl --set-default-version 2、wsl --status 和 wsl --version。

下载 Microsoft WSL MSIMicrosoft：手动安装 WSLMicrosoft：WSL 故障排查

安装 NVIDIA CUDA on WSL 驱动

  1. 1
    下载当前 NVIDIA Windows 驱动

    从 NVIDIA 官方驱动下载页选择显卡型号和 Windows 版本。需要支持 CUDA on WSL 的 Windows 驱动。

  2. 2
    安装并重启

    完成驱动安装后重新启动 Windows。高级离线包内已经包含 Linux 模型环境，不要另外向 PhotoFlowNative 安装显卡驱动。

  3. 3
    检查驱动

    在 Windows PowerShell 运行 nvidia-smi，必须能够显示 GPU 名称、驱动版本和显存。

nvidia-smi
NVIDIA 官方驱动下载NVIDIA：CUDA on WSL 指南

导入 PairDETR / SAM 2.1 高级离线包

  1. 1
    下载匹配的高级运行时 ZIP

    按基础插件设置页显示的包名和版本获取离线包，不要用基础组件 ZIP 或来源不明的 VHDX 代替。

  2. 2
    放入高级包专用目录

    在“设置 → 团片协作”打开高级包目录，将 ZIP 原样放入。默认位置为 %LOCALAPPDATA%/PhotoFlow/components/team-retouch/advanced/packages，以设置页实际路径为准；无需文件选择器，也不通过插件管理安装此运行时 ZIP。

  3. 3
    运行预检

    在“设置 → 团片协作”检查 WSL 2、NVIDIA 驱动、nvidia-smi、x64 架构和至少 35 GB 剩余空间。

  4. 4
    确认安装

    点击安装并确认系统级操作。照片流会校验包清单、组件兼容性、路径和 VHDX SHA-256，然后导入虚拟磁盘。

  5. 5
    检查状态

    安装完成后确认 PairDETR 与 SAM 2.1 状态可用；失败时可使用同一离线包执行“修复”。

高级包目录与安装后的环境分开管理，环境位置以设置页显示为准。普通基础插件更新会保留高级包目录和已安装环境，无需每次重新下载或导入；卸载高级环境会注销其 WSL 发行版并删除虚拟磁盘，不会卸载基础插件。

06

实际使用

使用团片协作处理多人合照

  • 从项目中的原始大图开始，不要用已经被聊天软件压缩的图片作为母版。
  • 检测后逐人检查裁切框和身份；人物重叠严重时优先人工确认。
  • 导出后不要重命名任务结构中的文件；接收人只处理分配给自己的小图。
  • 分发结果遇到不属于本任务的同名文件时，会另取文件名并保留已有文件。以实际导出结果为准，不要只按原先计划的名称查找。
  • 返图导入后先查看待确认列表，再执行批量合并。
  • 合并结果会作为新输出/版本保存；确认无误后再决定交付或设为当前版本。
07

数据与恢复

保存、备份和恢复团片任务

团片协作用独立 SQLite 数据库保存人物、裁切、分发、返图和任务记录。长任务会记录进度，取消或重启后按任务状态继续。工作区和项目备份会包含对应插件数据。

卸载不等于删数据卸载基础组件只移除代码，不会自动删除组件数据。高级 WSL 环境则由设置页中的独立“卸载高级环境”操作管理。
08

建议与限制

哪些照片需要手动调整

原图和返图支持最高 5 亿像素，单边最多 65,535 像素。生成的工作图和蒙版最多 4,000 万像素。大图合并可能输出 BigTIFF，请先确认后续软件能打开这种文件。

为控制内存占用，特别大的修图区域可能先缩小处理，再放回原尺寸画布；这可能减少修改区域的细节，也不能补回低分辨率返图中已经丢失的细节。未修改区域保留原始像素，大图处理需要足够的临时磁盘和输出空间。

  • 严重遮挡、快速运动、极端光线、特殊妆造或很小的人物可能需要手动调整。
  • 手机修图软件可能改变色彩、锐化、压缩和几何形状；合回后应放大检查边缘与重叠区域。
  • 高级模型不可用时会回退到基础 RTMDet 检测并显示原因，不会阻止基础流程。
  • 正式素材必须保留独立备份；插件的任务记录和版本关系不能替代原片备份。
下载团片协作插件

先安装基础插件；需要 PairDETR / SAM 2.1 时，再配置 WSL 2 高级模型环境。

前往下载