语义分割助手（街景版）

能做什么

下面这些都在软件窗口里完成，不用再开第二个程序。

• 导入：单张拖入或打开；批量选整个文件夹，含子文件夹。支持 jpg、png、bmp、webp、tif，中文路径也可以。
• 三种场景：Cityscapes（19 类马路街景）、Mapillary（65 类精细街景，含车道线、护栏、井盖）、ADE20K（约 150 类室内外）。
• 模型：默认 SegFormer B0，普通电脑就能跑；更好电脑可选 B2；有 NVIDIA 显卡可试 B5 或 Mask2Former。没有独立显卡会自动用 CPU。
• 预览：对比 / 掩膜 / 标签 / 原图可切换，掩膜透明度可调。
• 标签图：叠在原图底上，带分界线和类别名称；字号随图片大小自动变大，大图不用再放大才看得见。
• 标签文字：中文或英文可切换，投外文期刊选英文。预览栏和导出窗口都能改。
• 导出：色块图、掩膜图、标签图、类别统计表；可选类别编号图。批量汇总成一份 CSV。
• 可选指标：绿视率、围合度、天空开敞度等，默认不勾，需要时再勾，点问号看公式。
• 原图不改：缩小只发生在内存里，磁盘上的照片保持原样。
• 单张与批量：单张边调边看；批量可暂停、继续、从断点续跑。

安装与打开

Windows：运行 StreetSegmentation-Setup-*.exe，装完后从开始菜单打开「语义分割助手（街景版）」。不用另外安装 Python、CUDA、Visual C++ 或开发工具。有 NVIDIA 显卡且驱动正常时自动用显卡加速，否则自动用 CPU，没有单独的 GPU 安装包。显卡中途失败时会改用 CPU 继续，不会因此闪退。若杀毒软件拦截，加入信任后再打开。

macOS：打开 .dmg，把「语义分割助手（街景版）」拖到「应用程序」。若提示无法验证开发者，到「系统设置 → 隐私与安全性」选择「仍要打开」。发给别人的安装包建议经过 Apple 公证。请先拖到应用程序再打开，不要在磁盘镜像里直接运行。双击仍打开窗口。要走命令行，在终端进入应用程序包的 Contents/MacOS 目录，运行 ./StreetSegmentation，子命令与 Linux 相同。

Linux：没有图形窗口。你会收到一个 .tar.gz，解压后保留整个 StreetSegmentation 文件夹（程序和 _internal 必须在一起，不要只拷走那一个程序）。在终端执行 tar -xzf 语义分割助手-街景版-linux-*.tar.gz，再 cd StreetSegmentation，然后用与 Windows / macOS 相同的激活码联网激活：./StreetSegmentation activate 你的激活码。无显示器的服务器也可以用。

• 没有独立显卡：使用 SegFormer B0，图片不要太大。
• 有 NVIDIA 显卡：可以尝试 B2、B5 或 Mask2Former。
• Apple 芯片：会使用 Apple GPU，大模型仍然可能较慢。
• 内存小于 8 GB：避免 B5 和 Mapillary 大模型，一次少开几张图。

第一次激活

把激活码整段粘贴后点「联网激活」，也可以「从文件导入…」选择 .lic 文件。不用回传机器码或任何个人信息。Linux 没有激活窗口。macOS 可以在窗口里激活，也可以在终端运行 ./StreetSegmentation activate 你的激活码，或 activate --file 激活码.lic。授权服务和续签规则相同。

第一次必须联网。成功后可以离线用，但大约每 7 天会尝试续签，最长 30 天需要联网一次。一张激活码只能激活一台电脑。把本机授权文件拷到另一台电脑无效，同事也不能共用。

换电脑、换硬盘或重装系统后，原来的激活码不能再激活新机器。请发邮件到 1252485024@qq.com 说明是换机，我们提供半价补购新授权。

单张分割：五步完成一次探索

• 导入：在「单张分割」页点「打开图片」，也可以拖入一张图片。支持 jpg、png、bmp、webp、tif 和中文路径。
• 选场景：普通马路用 Cityscapes（19 类）；要分车道线、护栏、井盖时用 Mapillary（65 类）；房间、公园、建筑外观用 ADE20K（约 150 类）。点「详情」可看到适用场合和完整类别表。
• 选模型：不确定就用 SegFormer B0。电脑较好可选 B2；有 NVIDIA 显卡可试 B5（软件会提前确认）。更精细边界选 Mask2Former。Mapillary 目前只有官方 Mask2Former（Swin Large）。不提供 FCN、PSP-Net、DeepLab v3+、SegNet：SegFormer / Mask2Former 在街景任务上已经全面领先。点「详情」可看到参数量、权重大小和硬件建议。
• 开始：点「分割当前图片」。「图片重构」默认收在「高级设置」里，通常保持自适应；内存不足会自动继续缩小重试，磁盘原图不会改。
• 查看与导出：预览上方可切换对比 / 掩膜 / 标签 / 原图，并拉动「掩膜透明度」：往左更像原图，往右颜色更明显，100% 即纯色块。标签图带原图底和类别名称，字号随图片大小变化；「标签文字」可选中文或英文。确认后点「导出当前结果」，文件写到程序同目录的 分割结果/单张，不用再选文件夹。

一次处理很多张图

切换到「批量分割」页，选择图片文件夹、场景和模型。可选指标、高级设置（图片重构模式）与单张分割相同，再点「开始批量分割」。此模式不加载逐张预览。结果自动写入程序同目录的 分割结果/批量/时间-源文件夹名 任务目录，并保留输入文件夹层级。类别占比和勾选的指标会汇总到任务根目录的同一份 分割结果.csv，不会一张图一个表格。若应用目录不可写则改存“文稿”目录。完成后软件显示完整输出路径，并提供「打开结果文件夹」快捷按钮。

每张图片成功导出后都会原子写入断点清单。再次选择同一输入文件夹时，场景、模型、透明度、导出项和指标完全一致即可复用原任务；图片重构参数不参与配置指纹。只有路径、大小、修改时间均未变化且输出齐全的图片才会跳过。其他配置变化、原图修改或输出缺失都会重新处理；分割结果.csv 中的行会覆盖更新，不会重复追加。

批量处理支持「暂停 / 继续」和「终止」，已成功导出的结果及断点会保留。单张模式只提供「中断」，不缓存未完成的中间状态，再次开始会从头处理整张。正在执行的 CPU / GPU 模型前向计算无法安全强杀，因此操作可能要到下一个安全检查点才生效；被中断的当前图片不会导出。

CLI 使用说明

装好软件后，也可以不打开窗口，在终端里激活、分割和批量处理。不必再装 Python。macOS 和 Linux 命令相同：activate、run、batch 等。macOS 在终端进入 语义分割助手（街景版）.app/Contents/MacOS；Linux 解压 .tar.gz 后进入 StreetSegmentation 目录（旁边的 _internal 不要删）。然后按下面这样运行。Mac 双击仍开窗口；Linux 没有窗口。任意子命令加 --help 可看完整参数。

./StreetSegmentation activate 你的激活码
./StreetSegmentation run 照片.jpg --dataset cityscapes --model b0

导出文件分别是什么

PNG 和 CSV 里会写入授权编号，便于分辨是哪份授权产出的结果。授权编号不是激活码，不要当激活码发给别人。

可选指标在分割前选择，默认全部不计算：色彩丰富度、视觉熵看原图；绿视率、围合度、天空开敞度、建筑界面率、道路占比、车视率、步行空间占比看分割结果。水面率只有 Mapillary / ADE20K 能算。点指标旁的「?」可看公式。

• 色块图 *_mask.png：只有颜色块，不要原图细节。
• 掩膜图 *_overlay.png：原图上叠一层颜色，透明度和预览滑条一致。
• 标签图 *_label.png：原图底上叠颜色、分界线和主要类别名称；字号随图片大小变化。可把标签文字改成英文，方便投外文期刊。
• 类别编号图 *_id.png：像素值等于类别编号，给 GIS 二次处理；普通查看可以不勾。
• 统计表 *_labels.csv：仅单张导出使用，用 Excel 打开可看这一张图每一类占了多少像素；勾选场景指标时，表头会多出对应列。
• 批量汇总表 分割结果.csv：批量分割时写在任务根目录，一行一张图，包含尺寸、勾选的指标和全部类别占比。

授权说明（请先看）

一张激活码等于一台电脑。买一份授权，只能在你第一次激活时的那一台机器上使用。发给同事、拷到另一台电脑、换机器后再粘贴，都不会成功。

换电脑、换硬盘或重装系统后，软件会把新环境识别成另一台机器，原来的码不能再用。不要反复粘贴旧码，请发邮件到 1252485024@qq.com，说明是换机补购，我们提供半价购买渠道，给你发一张新激活码。

窗口里会显示授权摘要，包括须联网续签的日期。经常联网时，大约 7 天后会自动续签。若提示联网期限已过，接上网络再打开软件或再点一次分割即可。不要把激活码发到群里。

为什么没有 FCN、PSP-Net、DeepLab v3+、SegNet

这些名字常见于教材和早期论文（大约 2015–2018 年）。本软件不提供它们，不是漏做。当前街景任务上，SegFormer 与 Mask2Former 已经全面领先：Cityscapes、ADE20K 等公开评测的 mIoU 更高，车道线、护栏、行人等细长或较小区域的边界更好，官方街景微调权重也更完整。

SegFormer B0 在普通笔记本、没有独立显卡时就能用。继续内置老模型只会加大安装包，却换不来更好结果。以前课题写的是 DeepLab v3+ 或 PSP-Net，用默认的 SegFormer B0 即可对照；需要更细边界再换 Mask2Former。不建议为了和旧论文同名，再去找这些老模型。