---
title: see-through-setup
canonical_url: "https://www.modelscope.cn/datasets/felix72/see-through-setup"
md_url: "https://www.modelscope.cn/datasets/felix72/see-through-setup.md"
repository: felix72/see-through-setup
chinese_name: "See-Through 部署脚本"
last_updated: 2026-10-19
license: apache-2.0
storage_size: "173 KB"
downloads: 456
stars: 8
---

# see-through-setup

> see-through-setup - felix72 在 ModelScope 开源的数据集。在魔搭 Notebook 上跑 See-Through 的一键脚本（仅 shell 脚本，无密钥）

felix72/see-through-setup 是 ModelScope 魔搭社区上的数据集，存储大小 173 KB，采用 apache-2.0 许可。

- **Repository**: felix72/see-through-setup
- **License**: apache-2.0
- **Storage size**: 173 KB
- **Downloads**: 456
- **Stars**: 8
- **Last updated**: 2026-10-19

Source: https://www.modelscope.cn/datasets/felix72/see-through-setup

---

数据集文件元信息以及数据文件，请浏览“数据集文件”页面获取。

当前数据集卡片使用的是默认模版，数据集的贡献者未提供更加详细的数据集介绍，但是您可以通过如下GIT Clone命令，或者ModelScope SDK来下载数据集

#### 下载方法 
:modelscope-code[]{type="sdk"}
:modelscope-code[]{type="git"}

# See-Through 运行说明（魔搭 Notebook）

## 0. 每次开机：**先起服务**（重开实例后必做）

```bash
bash /mnt/workspace/seethrough/st_run.sh
```

等到日志出现 `Running on local URL: http://0.0.0.0:7860`（约 140 秒）就好。
**不开服务，跑图会全是 `Connection refused`** —— 服务是手工起的，实例一关/一换容器就没了。

## 1. 一行跑完（日常用法）

```bash
python /mnt/workspace/我的图/分层导出.py run /mnt/workspace/我的图/输入
```

- 分辨率默认 **auto**：按每张图的最大边自动选（向上取 64 的倍数，夹在 768~1536），内部处理尺寸最贴近原图，不浪费显存也不白丢细节
- 想固定分辨率就在末尾写数字：`... run /mnt/workspace/我的图/输入 1024`
- 图放进 `/mnt/workspace/我的图/输入/`；**只跑新图**，已出过结果的自动跳过
- `--force` 全部重跑；`--move` 跑成功的输入图挪到 `输入/已处理/`
- 每张约 3 分钟（1024 分辨率；分辨率越高越慢越吃显存）

## 2. 一行补拆图层（已有 PSD 时用，秒级、不占 GPU）

```bash
cd /mnt/workspace/我的图 && git fetch -q origin && git reset -q --hard origin/master && PSD=$(ls -t /mnt/workspace/*.psd 2>/dev/null | head -1) && echo ">>> 用 PSD: $PSD" && python 分层导出.py psd "$PSD" && find /mnt/workspace/分层文件输出 -maxdepth 2 | head -20
```

这一行做的事：同步最新脚本 → 自动找最新的 PSD → 还原原图尺寸 + 拆图层 → 打印结构。

## 3. 尺寸规则（重要，别被 1024 骗了）

app 里的 `resolution` 决定的**不是"建议尺寸"，而是输出画布**：它先把图补成正方形、缩放到 resolution，PSD 画布尺寸直接取这个方图。所以不处理的话：

| 输入 | 出来是 |
|---|---|
| 838×840 | 1024×1024（两侧带透明补边） |
| 1500×1500 | 1024×1024（细节被压掉） |

本脚本默认**自动还原**：按原图尺寸裁掉补边 + 重采样，**PSD 和图层 PNG 都是原图尺寸**。不想要就加 `--keep-canvas`。

配合"分辨率 auto"，内部处理尺寸≈原图最大边，往返重采样几乎无损：

| 输入尺寸 | auto 选的处理分辨率 |
|---|---|
| 838×840 | 896 |
| 1024×1024 | 1024 |
| 1500×1500 | 1536（模型上限） |
| 1920×1080 | 1536（模型上限） |

**大于 1536 的图无论怎样都会丢细节**，这是模型上限，不是脚本的问题。

## 4. 输出结构

```
/mnt/workspace/分层文件输出/
└── back/                        <- 用图片名建的文件夹（PSD 名里的 "输出-" 前缀会自动剥掉）
    ├── back.psd                 <- 分层 PSD，画布 = 原图尺寸（这个文件存在 = 该图已处理）
    └── 图层/
        ├── 01_handwear.png      <- 每个 PNG 也是原图尺寸、位置对齐，可直接叠加
        ├── 02_footwear.png
        └── …                    <- 24 个图层 PNG
```

加 `--tight` 则图层 PNG 只存各自的可见区域（体积小，叠加时要自己对位）。

## 5. 下载

- 单个文件：左侧文件树里右键 → 下载
- 整个文件夹：先打包再下，只下载一个文件

```bash
cd /mnt/workspace && tar czf 输出.tar.gz 分层文件输出
```

## 6. 用完关掉（省额度）

```bash
pkill -f app.demo
```

然后点面板右上角「关闭实例」。额度按**实例运行时长**扣，不是按次数。

## 7. 环境事实 / 常见报错

| 项 | 值 |
|---|---|
| GPU / 显存 | NVIDIA A10 / 23028 MiB（1024 分辨率推理峰值 19679 MiB） |
| 持久化目录 | `/mnt/workspace`（= `/mnt/data`，关实例不丢）；其他路径关实例即清空 |
| 单次上限 | 10 小时；空闲 1 小时自动关 |
| **容器能读到的位置** | 只有 `/mnt/workspace` 下的真实路径。编辑器左侧那个「ModelScope Workspace」区**容器读不到**，别往那儿放图 |
| 传图通道 | 本数据集仓库 `felix72/see-through-setup` 的 `输入/` 目录 → 容器里 `git pull` |
| 端口 | 服务在容器内 7860，**没有对外入口**（这台环境不给端口转发），只能用命令行调用 |

| 报错 | 原因 / 解法 |
|---|---|
| `[Errno 111] Connection refused` | 服务没起（多半是重开了实例）。先 `bash /mnt/workspace/seethrough/st_run.sh` |
| `error: 您的本地修改将被合并覆盖: dataset_infos.json` | 平台改了这个文件（正常）。`git checkout -- dataset_infos.json && git pull`，或 `git fetch origin && git reset --hard origin/master` |
| `找不到 PSD: ...` | 路径写错或文件被删；`ls /mnt/workspace/*.psd` 看真实文件名 |
