KRPano 全景图批量下载工具 · 使用说明
版本 1.0.0 · 更新日期 2026-10-17
本文档面向最终用户：界面操作、参数选择建议、免费版与专业版对比、常见问题。
一、软件简介
本工具用于将在线 KRPano 全景漫游批量下载到本地，自动完成「解析场景 → 下载瓦片 → 拼接成图」全过程，输出严格 2:1 的高清等距柱状全景原图。
核心能力：
- 粘贴漫游链接即可解析全部场景，支持加密漫游与主流全景平台
- 自动选取最高分辨率层级，支持上亿像素超大图
- 内嵌浏览器实时预览，解析失败时自动切换到浏览器捕获通道
- 遇反爬防护（如 720yun）自动切换浏览器下载通道，无需手动设置
二、快速上手（三步完成）
- 复制链接 —— 粘贴全景漫游页面地址到顶部地址栏
- 选择场景 —— 点击「解析场景」，在列表中勾选要下载的场景
- 开始下载 —— 点击「开始下载」，选择输出目录，等待完成
三、界面详解
| 区域 | 说明 |
|---|---|
| ① 菜单行 | 左侧显示当前版本状态；右侧「联系购买」「注册」按钮 |
| ② 漫游地址 | 输入漫游页面 URL 或 XML 地址，回车或点「解析场景」开始解析 |
| ③ 场景列表 | 展示解析出的场景：勾选框、名称、标题、投影类型、最大分辨率、预览图 |
| ④ 下载设置 | 仅保留 JPG 质量一项，其余参数由系统按站点自动给出最优配置 |
| ⑤ 全景浏览器 | 内嵌 Chromium 浏览器，实时加载漫游页面；解析失败时自动辅助捕获 |
| ⑥ 下载进度 | 总体进度条 + 当前任务进度条 |
| ⑦ 日志 | 详细运行日志，结束后自动生成 download_log.txt |
| ⑧ 底部按钮 | 开始下载 / 取消下载 / 打开输出目录 |
四、解析场景
点击「解析场景」后，场景列表会列出漫游中的全部场景：
上图为免费版界面：只有第一个场景的复选框可用（已自动勾选），其余场景显示为灰色不可选；「全选/全不选」按钮同时禁用。
专业版注册后，全部场景均可自由勾选：
使用技巧：
- 鼠标悬停在「最大分辨率」列上，可查看该场景的实际输出尺寸提示
- 下载范围完全由勾选状态决定，无需其他配置
- 支持一次解析上百个场景的大型漫游
五、下载设置与参数选择建议
5.1 GUI 参数（仅 JPG 质量）
图形界面只保留一个可调参数，其余由系统按站点自动给出最优值：
| 参数 | 默认值 | 选择建议 |
|---|---|---|
| JPG 质量 | 85% | 日常下载直接用默认值即可，与 krpano 官方 q85 口径一致（4:4:4 无色度子采样），画质与文件大小平衡最佳 |
| 90–95% | 用于印刷、存档等对画质要求极高的场景，文件体积约增大 30–60% | |
| 70–80% | 仅用于快速预览或大量样片筛选，体积更小 |
系统内置的最优配置（无需关心）：并发 6、重名跳过、最高分辨率层级、cube 转等距柱状（面宽 × π 官方口径）、严格 2:1 输出、反爬通道自动探测。
5.2 CLI 高级参数（命令行用户）
GUI 已固化的参数在命令行中均可调，建议如下：
| 参数 | 取值 | 建议 |
|---|---|---|
-r 分辨率 | high / medium / low | 成品交付用 high；快速审图用 medium（长边 ≤4096）；批量筛选用 low（≤1024） |
-w 并发数 | 1–16 | 建议 4–8；超过 12 容易触发目标站限流导致失败率上升 |
-q JPG 质量 | 50–100 | 同 5.1 建议 |
--on-exists 重名策略 | skip / overwrite / rename | 增量补漏用 skip（默认）；强制更新用 overwrite；保留旧版本用 rename |
--cube-mode | equirect / equirect_wide / strip | 标准全景用 equirect（推荐）；需要六面原始排布调试用 strip |
--capture | 开关 | XML 加密的漫游使用（GUI 下会自动处理，无需此参数） |
--current N | 场景序号 | 只下载第 N 个场景（从 0 开始），便于单场景测试 |
5.3 输出格式说明
- GUI：固定输出 JPG（体积最小、兼容性最好，全景图场景下 PNG 体积通常是 JPG 的 3–5 倍）
- CLI：可选
-f jpg或-f png - 输入瓦片：JPG / PNG / WebP 均自动识别，无需关心源站格式
六、下载与输出
- 点击「开始下载」后弹出目录选择框（记住上次选择的目录，默认为
Downloads/krpano_panos） - 下载过程中可随时点「取消下载」中断；瓦片缓存在输出目录的
.tile_cache/中，重跑自动续传，已下载的瓦片不会重复下载 - 输出文件命名：
{场景标题}_{场景名}_{分辨率}.jpg，例如大厅全景_scene_0_high.jpg - 结束后自动生成
download_log.txt并询问是否打开目录
七、免费版与专业版功能对比
| 功能 | 免费版 | 专业版 |
|---|---|---|
| 解析全部场景 | ✅ | ✅ |
| 内嵌浏览器预览 | ✅ | ✅ |
| 加密漫游下载 | ✅ | ✅ |
| 反爬站点自动通道 | ✅ | ✅ |
| 最高分辨率输出 | ✅ | ✅ |
| 下载场景数量 | 仅第一个场景 | 不限，批量下载 |
| 场景列表勾选 | 仅第一个可选 | 全部可选，支持全选 |
注册方式：点击菜单行「注册」按钮，弹出注册窗口：
- 点击「复制」复制机器码
- 点击「在线获取注册码」跳转购买页面获取注册码
- 粘贴注册码，点击「注册」（注册过程需要联网）
注册成功后菜单行显示「专业版（至 XXXX-XX-XX）」或「专业版（永久）」；授权状态本地缓存 1 天，日常离线也能正常使用。如需换机或退出授权，点击「取消注册」即可。
八、特殊站点说明
| 情况 | 处理方式 | 需要用户做什么 |
|---|---|---|
| 加密 XML 漫游 | 内嵌浏览器通过 krpano 运行时接口直读 | 无，自动处理 |
| 反爬防护站点（如 720yun） | 下载前自动探测，命中挑战页自动切浏览器通道 | 无，自动处理 |
| SPA 结构站点（如 view.vra.cn） | 专用接口拉取场景列表 | 无，自动处理 |
| 页面内嵌 XML 的站点 | 直接从页面提取，不额外请求 | 无，自动处理 |
九、常见问题速查
Q：解析失败提示"无法获取 XML 内容"？
确认链接能在浏览器中正常打开，且确实是 KRPano 漫游页面；部分站点需先登录后再复制链接。
Q：瓦片下载全部失败？
若为反爬站点请确认已安装浏览器组件（打包版用户不受影响）；网络不稳定时重试即可，断点续传会跳过已完成部分。
Q：拼接出的全景图有黑色缝隙或错位？
请反馈具体漫游链接，通常是该站点瓦片分辨率层级格式特殊，需要针对性适配。
Q：程序闪退或无法启动？
安装版可将 %USERPROFILE%\.krpano_pano_downloader\crash.log 发给客服定位问题。
Q：机器码会变吗？
机器码由硬盘序列号、网卡 MAC 与用户名共同生成；更换硬盘、网卡或系统用户名会导致机器码变化，需重新注册。