扫描现有 WebUI
扫描本机或指定文件夹，自动识别并挂载已有 WebUI。
扫描适合不知道实例路径，或者只有 WebUI Core、缺少可用独立 Python 的情况。扫描会根据目录中的标志文件识别 WebUI 类型，不需要预先选择类型。
两种扫描范围
在“添加实例”页面选择“扫描系统”。Windows 会扫描本机固定磁盘；Linux 和 macOS 从系统根目录开始扫描当前文件系统。完整扫描可能读取大量目录并持续数分钟。
扫描步骤
选择扫描系统
在首页点击“添加实例”，切换到“扫描系统”。这一模式没有 WebUI 类型列表和第二步配置表单。
阅读并确认扫描范围
点击“扫描本机”后会出现确认窗口，说明预计耗时、自动添加行为和后台运行方式。确认后才开始全盘扫描。
返回首页等待
页面会返回首页，扫描在后台继续。底部状态报告先显示已经读取的目录和发现数量，进入挂载阶段后显示已处理数量。
查看完成汇总
完成报告会分别显示已添加、待安装、已存在和已跳过数量。扫描不会逐个弹出候选确认；符合条件的项目会自动出现在首页。
处理待安装实例
仅发现 Core 而没有可用 Python 时，实例会显示“未安装”。打开该实例并点击“开始安装”，应用会在新的受管实例根目录中准备 Python，同时继续使用发现的外部 Core。
扫描阶段与补装阶段不同
扫描和挂载只读取现有文件并写入实例记录；对“待安装”实例执行安装时，完整安装器会以发现的 Core 为目标，可能下载、更新或调整其中的文件。先备份自定义代码。
汇总结果是什么意思
| 汇总 | 含义 | 下一步 |
|---|---|---|
| 已添加 | Core 与独立 Python 都可用，实例已经就绪 | 打开实例并验证启动 |
| 待安装 | 识别到 Core，但没有唯一可用的独立 Python | 打开实例并开始安装 |
| 已存在 | 同一 Core 已经由某个实例管理 | 使用已有实例，无需重复添加 |
| 已跳过 | 候选在挂载或验证阶段未满足条件 | 打开任务中心查看具体原因 |
任务中心的详细结果还可能包含：
- 路径冲突：候选根目录、Python 或 Core 与现有实例重叠。
- Python 无效：找到了疑似 Python，但无法执行或解析版本。
- 访问警告：某个子目录无权读取，扫描会继续处理其他目录。
- 根目录失败：指定扫描根目录本身无法读取；所有根都失败时整个扫描失败。
- 处理失败：路径安全、实例记录或生命周期提交等步骤未完成。
为什么没有识别到
扫描只识别当前支持的目录标志，并主动跳过符号链接和 Windows 重解析点。在 Unix 系统上，全盘扫描不会跨越到其他文件系统，因此外部磁盘和某些挂载目录应使用“拖入文件夹”定向扫描。高度定制的目录结构也可能无法自动关联 Python，此时可以手动导入。
打开任务中心可以查看扫描路径、警告和具体结果；仍无法判断时参阅安装故障处理。