GeoD CLI 0.1.1 — Windows x64 公开预览版

这是 GeoD 独立命令行工具的首个公开安装版本。AI、脚本和终端用户可以通过 JSON 参数获取边界、矢量和有范围限制的影像数据，再读取带来源、坐标和 SHA-256 的成果清单继续处理。

下载与安装

安装程序默认写入 %LOCALAPPDATA%\Programs\GeoD CLI，支持添加当前用户 PATH 和卸载。安装后新开终端：

geod --version
geod --help

无需安装 GeoD 桌面端、Rust、Node.js 或 GDAL 即可获取数据。便携版不修改 PATH，可直接使用 geod.exe 的完整路径。此安装包未使用代码签名证书签名。

获取河南边界

$example = Join-Path $env:LOCALAPPDATA 'Programs\GeoD CLI\examples\geod-cli\henan-boundary.json'
$out = Join-Path (Get-Location) ('henan-' + (Get-Date -Format 'yyyyMMdd-HHmmss'))
geod plan --request $example
geod fetch --request $example --out $out
geod inspect --bundle $out

便携版或自定义安装目录请相应调整 $example。每条命令都应检查退出码后再继续。示例从 DataV 获取河南行政区边界，不调用付费 AI；输出 GeoJSON 和 manifest.json。

主要能力

• plan：参数检查与瓦片、像素、空间范围预算。
• fetch：本地/HTTP GeoJSON、有界 XYZ 影像及受限 Overpass 查询，输出 PNG/JPEG/GeoTIFF 和矢量清单。
• inspect：核对资产、文件大小和 SHA-256。
• PNG/GeoTIFF 支持行政区面掩膜，保留透明度和洞。
• geostyle-import 与 geod-render.mjs 可选衔接兼容 GeoStyle 服务，供后续地图渲染。

stdout 为机器可读 JSON，stderr 为 JSON 行进度；失败退出码为 1，取消为 130。成果目录不覆盖，manifest.json 为完成标记。AI 应检查退出码、quality、来源和实际字段。

当前范围

本次只发布 Windows x64 安装包，不是 GeoD 桌面版更新。GitHub 标记为预发布，桌面版 latest 保持原有版本。

CLI 不包含地图数据、模型或 GeoStyle 服务；完整浏览器渲染另需兼容服务、Node.js 22+ 和 Chrome/Edge。没有自动地名解析、AI 意图分析、任意规模下载、DEM/3D Tiles、自动更新或中断续传。公网 Overpass 可能超时，其在线 POI 获取不作为本次发布的通过项。Blue Marble 示例是概览背景，不是实时高清影像。

数据获取和地图数据的使用范围取决于实际数据源授权，软件发布不授予数据转售权。网页版 CLI 在线体验仍只提供带水印预览，暂不开放成果下载。

完整参数、裁剪和 AI 调用说明见安装包中的 docs/geod-cli.md，或本标签对应的使用文档。

发布前验证

• 核心与 CLI 测试 72 项、渲染脚本测试 6 项、安装器打包校验 9 项通过。
• 最终安装包实际安装与卸载验收 49 项通过，包括 PATH 恢复、非空目录保护、已有 PATH 项与用户新增文件保留。
• 使用最终便携包实际获取河南 18 个地市边界及 NASA Blue Marble 影像，9/9 瓦片完成，输出 PNG、GeoTIFF 与成果清单并通过 inspect 校验。
• Windows x64 静态 CRT 构建，无额外 VC++ Runtime、OpenSSL 或 GDAL DLL 依赖。

npm 命令行安装

已提供内嵌原生程序的 npm 包，适用于 Windows x64、Node.js 18+：

npm install -g geod-cli
geod --version
geod --help

卸载：npm uninstall -g geod-cli。安装包无运行依赖，不会在 postinstall 中额外下载二进制。npm 注册表已发布 geod-cli@0.1.1，可以直接运行 npm install -g geod-cli。安装不要求登录 npm。

需要固定版本时可运行 npm install -g geod-cli@0.1.1，也可通过本 Release 的 .tgz 下载 URL 安装。

新增附件：geod-cli-0.1.1.tgz、geod-cli-0.1.1.tgz.sha256。原有安装器与便携 ZIP 保持原文件及原校验值。npm 包 SHA-256：486eafbabca1fee619ac51efd72e090a495e6d8f8645a4cb813ed91ea7ceff97。

包装器测试 19 项通过；隔离安装、同版重装、卸载和真实 Windows Ctrl+C（退出码 130）均已验证。原生程序保持 0.1.1，二进制与独立安装版相同。

npm 包使用说明 · 包装器源码

WinGet 收录已提交 microsoft/winget-pkgs#434088。当前尚未进入社区源索引，不能把 winget install --id GeoD.CLI --exact 视为已可用。

v3.6.10 - 坐标系导入、缓存容量与 AI 助手统计

本次版本重点修复 Shapefile 坐标系识别和瓦片缓存容量控制，同时完善多要素导入效率，并为开发者功能中的 AI 助手补充匿名使用统计。

Shapefile 与坐标系

• 从桌面文件选择器导入单独的 .shp 时，会自动查找同目录、同名的 .prj、.dbf、.shx 和 .cpg 配套文件。
• 识别 .prj 后会将投影坐标转换为 WGS 84，再交给地图显示和下载范围计算。
• 缺少 .prj 时不再静默接受明显的米制投影坐标；界面会给出坐标示例和补齐配套文件的建议。
• 坐标位于正常经纬度范围但无法确认 CRS 时，会要求用户确认是否按 WGS 84 导入。
• 导入结果会显示识别到的坐标系和配套文件数量，便于排查 GIS 软件中的位置偏移。

多要素导入

• 导入多个面要素后可按名称筛选，并按原始顺序、名称或实际面积排序。
• Shift 连选会遵循当前筛选和排序后的可见顺序，不会误选被过滤掉的要素。
• 面积改为基于多边形球面面积计算，支持扣除内环，不再使用外接矩形面积冒充真实面积。
• 对无法可靠计算的坐标显示 —，避免出现负面积或误导性的数值。

瓦片缓存

• 下载持续写入缓存时会周期性检查容量上限，不必等到应用重启才触发清理。
• 清理过程会避开当前下载任务仍在使用的瓦片，并复用连接池减少大量小文件场景下的额外开销。
• 容量统计和自动清理状态保持同步，降低小容量磁盘被缓存占满的风险。

AI 助手匿名统计

• 新增 AI 助手开启、面板操作、请求结果和 Agent 页面跳转等匿名事件。
• 请求耗时和知识来源数量只记录区间值，不记录精确内容。
• 不采集用户问题、模型回答、知识库原文、API Key、模型地址、文件路径或原始错误信息。
• 采集服务使用严格字段白名单，包含额外内容的事件会被拒绝。

安装与升级

• 本次升级不会删除已有任务、历史记录、输出文件、下载范围书签、设置或瓦片缓存。
• Windows、Linux、macOS Intel 和 Apple Silicon 安装包继续由 GitHub Actions 构建。
• macOS 安装包尚未进行 Apple Developer ID 签名与公证，部分系统仍可能显示安全提示。

v3.6.9 - 图源兼容、英文界面与导入效率改进

本次版本集中完善图源模板兼容、GIS 输出配套文件和多要素导入体验，同时补齐英文界面与天地图 Token 错误提示。

图源兼容与天地图提示

• 自定义栅格图源新增 TMS 反向 Y 占位符 {-y}，无需再由用户手动换算 Y 坐标。
• 新增 Bing QuadKey 占位符 {q}，地图预览、缓存和下载使用统一的 URL 解析规则。
• 设置页明确说明 GeoD 内置天地图 Key 为公开共享 Key，额度和可用性不受保证，并提供官方 Token 申请入口。
• 切换到天地图图源时会立即探测 Token 状态；遇到无效、无权限、缺失或额度不足时直接在界面提示，不再等全部瓦片失败。
• 下载阶段保留首个明确错误，整批失败时会显示实际 Token 或限流原因，而不是笼统提示无数据。

GeoTIFF 输出

• GeoTIFF 与 DEM 输出可选生成 .tfw 和 .prj 辅助文件，改善部分传统 GIS 软件的坐标识别兼容性。
• 普通影像按 Web Mercator 生成辅助文件，DEM 按 WGS 84 输出对应空间参考。
• 批量下载、Wayback 和部分任务导出使用相同的辅助文件设置。

多要素导入

• 导入包含大量面要素的文件时，支持先点击一个要素，再按住 Shift 点击另一个要素进行连续选择。
• 连续选择支持正向和反向操作，也可以整段取消；点击整行或复选框行为一致。
• 全选、清空和反选后会重置连选起点，避免从旧位置意外扩展选择。
• 修复 WebView 在按下 Shift 时显示残留焦点描边的问题，同时保留正常键盘操作能力。

界面与文案

• 新增简体中文与英文界面切换，语言选择保存在本机。
• 下载、Wayback、任务中心、设置、图源管理、新手引导和常用弹窗完成统一翻译。
• 任务状态文案改为集中映射，未知状态仍会保留原始值，便于后续版本兼容。

安装与升级

• 本次升级不会删除已有任务、历史记录、输出文件、下载范围书签或瓦片缓存。
• Windows、Linux、macOS Intel 和 Apple Silicon 安装包继续由 GitHub Actions 构建。
• macOS 安装包尚未进行 Apple Developer ID 签名与公证，部分系统仍可能显示安全提示。

v3.6.8 - 区域边界导入与下载范围书签

本次版本集中修复真实用户文件中的区域几何兼容问题，并新增可重复使用的下载范围书签。

区域边界导入

• 支持将 KML/KMZ 中首尾闭合的 LineString 边界识别为 Polygon 下载区域。
• 支持递归提取混合 GeometryCollection 中的面要素；同一集合同时包含面、开放线或点时，不再漏掉有效区域。
• 标准 Polygon / MultiPolygon 保持原有语义，开放线和点不会被错误转换为面。
• 区域选择和批量下载共用同一套面几何提取规则，bbox、裁剪边界和要素列表保持一致。
• 文件只包含开放线或点时，提示会明确说明无法作为下载区域，并引导转换为 Polygon。
• 新手引导和上传入口补全 GeoJSON、Shapefile、KML、KMZ 格式说明。

下载范围书签

• 可将当前行政区、手绘矩形/多边形或导入边界保存为命名书签。
• 支持一键恢复选区并同步更新地图，也可在书签管理中重命名或删除。
• 书签只记录下载范围，不绑定图源、缩放级别、输出格式等任务参数。
• 书签保存在本机应用数据目录的独立 SQLite 数据库中，大型 KML 边界不会占用 WebView 本地缓存额度。

新手引导 v2

• 主界面总览更新为 GeoD 当前的六种数据模式和统一下载中心流程。
• 新增“区域选择与地图工具”“下载中心”专项引导，覆盖范围书签、量测、经纬网、任务批量操作与历史记录。
• 新增 MVT 和 OSM 独立下载引导，并更新影像、3D Tiles、Wayback 引导入口。
• 从任意页面启动专项引导时，会先自动切换到正确模式和侧栏页面，避免引导指向隐藏内容。
• 已看过旧版主引导的用户升级后会看到一次 v2 总览，之后不会重复打扰。

匿名使用统计

• 增加下载任务、范围选择、边界导入、范围书签、地图量测和新手引导的匿名功能事件，后台可按固定分类查看功能采用情况。
• 要素数、坐标点数和缩放级别数只按区间统计，不上传文件名、路径、URL、地图坐标、图源密钥、错误原文或用户数据。
• 收集服务对事件字段和值执行严格白名单校验，夹带额外字段的事件会被拒绝，不会写入数据库。
• 匿名统计说明升级至 v2，旧版已同意用户会重新确认一次；拒绝或关闭不会影响下载、预览、导出及更新。

验证

• 使用用户反馈 KML 验证两条闭合边界能够整理为包含 2 个面的 MultiPolygon，完整保留 4313 和 8862 个坐标点。
• 新增闭合线、多面、嵌套/混合集合、开放线、点和标准面回归测试。
• 新增范围书签保存、重命名、删除及 15000 点大型边界持久化测试。
• 验证新版帮助菜单、下载中心自动切页，以及区域工具全部 6 个引导目标。
• 本次升级不会删除已有任务、历史记录、输出文件或瓦片缓存。

v3.6.7 - 下载任务、Wayback 与 3D Tiles 稳定性修复

本次版本集中处理近期反馈的下载任务暂停、Wayback 扫描和 3D Tiles 下载问题，不新增大型功能。

下载任务

• 修复同时运行多个任务时，后创建的任务可能无法暂停的问题；等待中的任务现在也可以正常暂停。
• 活动、暂停和异常中断任务统一显示在同一个任务列表中，每个任务始终只保留一张卡片。
• 暂停、继续、删除和进度统一在任务卡片内操作，批量操作也使用相同语义。
• 修复暂停任务被同时识别为中断任务、出现重复卡片，或从错误入口恢复后重复启动下载流程的问题。
• 删除暂停任务时会正确唤醒并终止后台下载，不再遗留等待中的任务。

影像与 Wayback

• 修复沿海和图源边界区域的无数据瓦片被计入下载失败，导致任务误标为“部分完成/缺块”的问题。
• Wayback 元数据扫描新增停止操作，离开页面时也会终止仍在运行的扫描和轮询。
• 修复 Esri 不支持 HTTP HEAD 时 Wayback 最大可用层级被低估的问题。

3D Tiles

• 3D Tiles 的 box 和 sphere 包围体现在会正确应用并继承 tile transform，改善选区空间过滤准确性。
• 外部 tileset 子树重试全部失败或内容文件下载失败时，任务会明确报告失败，不再显示为成功。
• 临时下载文件使用唯一名称，避免同名但不同扩展名的内容并发写入时发生碰撞。

安装与升级

• 本次升级不会自动删除已有任务、历史记录、输出文件或瓦片缓存。
• Windows、Linux、macOS Intel 和 Apple Silicon 安装包继续由 GitHub Actions 构建。
• macOS 安装包尚未进行 Apple Developer ID 签名与公证，部分系统仍可能显示安全提示。

v3.6.6 - 大任务稳定性、GeoD 助手与地图交互

本次稳定版整合了 3.6.6 两个测试版本的验证结果，重点改善大规模下载任务的恢复速度、磁盘空间保护和地图操作体验，并加入默认关闭的 GeoD 助手开发者功能。

大任务与磁盘保护

• 大型任务的中间瓦片改为按列分目录保存，避免单目录包含海量文件导致扫描和重启恢复变慢。
• 新任务的工作目录保存在输出目录旁的 .geod-work 中，减少大型任务持续占用系统盘的风险。
• 创建任务和下载过程中都会检查剩余磁盘空间；空间不足时停止写入并保留恢复数据。
• 旧版本保存的未完成任务仍可识别，旧的平铺式中间文件也可以继续恢复。

地图与界面

• 图层管理面板改为点击展开、点击外部关闭，修复鼠标移入面板时意外收回的问题。
• 调整 Wayback 图层面板位置，避免与时间轴相互遮挡。
• 经纬网支持自动细化或固定间隔，用户可以按底图和当前缩放级别选择显示方式。
• 经纬度、缩放级别和三维视角高度统一移到地图外的底部状态栏，减少地图内控件遮挡。
• 修复助手与图源管理同时打开时的布局错位，以及主题菜单点击无响应的问题。

GeoD 助手与图源配置

• GeoD 助手作为开发者功能默认关闭，可由用户自行配置 DeepSeek Key 和 AI 网关。
• 助手使用 GeoD 知识库回答常见问题，并可通过回答中的操作链接跳转到相关设置位置。
• 图源管理新增智能解析，可从用户提供的 URL 辅助识别瓦片模板、测试可用性并引导完成配置。
• 启用助手前会展示风险提示、免责声明和隐私说明，并要求用户再次确认。

匿名使用统计

• 匿名统计必须经过用户明确同意后才会启用，可随时在设置中关闭或重置匿名标识。
• 仅统计应用版本、系统平台和少量功能开关事件。
• 不采集图源 URL、文件路径、文件名、搜索内容、坐标、选区范围、Token、API Key 或下载数据。
• 统计服务由 GeoD 自托管，关闭后会立即清除本地待发送队列。

安装与升级

• Windows、Linux、macOS Intel 和 Apple Silicon 安装包均由 GitHub Actions 构建。
• macOS 安装包执行 ad-hoc 签名和打包后校验，但尚未进行 Apple Developer ID 签名与公证，部分系统仍可能显示安全提示。
• 稳定版用户可通过应用内更新检查升级；升级不会自动删除已有任务、历史记录或瓦片缓存。

v3.6.6-beta.2 - 大任务稳定性与 GeoD 助手测试版

这是一个预发布测试版本，重点验证大规模下载任务的断点恢复、磁盘空间保护，以及开发者模式下的 GeoD AI 助手。

关键改进

• 大任务恢复更可靠：中间文件改为按列分目录保存，避免单个目录包含海量文件导致扫描和重启恢复变慢。
• 工作目录跟随输出盘：新任务的临时数据保存在输出目录旁的 .geod-work 中，减少系统盘被大型任务占满的风险。
• 磁盘空间保护：创建任务和下载过程中都会检查剩余空间，空间不足时保留恢复数据并给出明确提示。
• 图层面板交互修复：图层管理改为点击展开、点击外部关闭，并修复 Wayback 时间轴与图层面板遮挡。
• GeoD AI 助手：作为开发者功能默认关闭，支持用户配置自己的 DeepSeek Key，通过知识库回答使用问题并跳转到相关设置。
• 智能图源配置：可从用户提供的 URL 辅助识别瓦片模板、测试可用性并引导完成配置。

兼容与安全

• 旧版本保存的未完成任务仍可识别；旧的平铺式中间文件也可以继续恢复。
• AI 助手启用前会展示风险提示、免责声明和隐私说明，并要求二次确认。
• DeepSeek Key 保存在操作系统凭据存储中，不写入普通设置文件；请求可通过用户指定的 AI 网关转发。
• macOS 安装包增加 ad-hoc 签名，并由 GitHub Actions 挂载生成的 DMG 后验证其中的应用签名。

测试重点

• 使用数万到数十万瓦片的任务，确认下载期间界面和任务列表保持流畅。
• 中断任务并重启应用，确认任务仍在可恢复列表中，已下载瓦片无需重复获取。
• 将输出目录放在非系统盘，确认 .geod-work 也创建在该盘，任务完成后能够自动清理。
• 在磁盘空间不足时，确认任务停止并保留恢复数据，而不是持续写满磁盘。
• 在 GeoTIFF 与 Wayback 页面反复打开图层面板，确认面板常驻、外部点击关闭且不遮挡时间轴。
• macOS 用户请重点验证 DMG 能否正常打开及首次启动。

测试过程中如遇异常，请保留任务信息、相关日志以及 .geod-work 目录，以便继续定位。

v3.6.5 - 历史性能、日志清理与地图量测

本次更新整合了两个测试版本的验证结果，重点改善大量下载任务下的历史记录性能、任务日志占用与清理可靠性，并新增地图距离和面积量测工具。

历史记录性能

• 下载历史由单个 JSON 文件迁移到 SQLite，新增、删除和更新记录不再反复读写全部历史。
• 历史记录改为分页加载，每页 50 条，大量记录下仍可快速打开和翻页。
• 数据库操作移至后台线程，任务完成时不再阻塞下载运行时。
• 任务日志写入与任务列表锁分离，多个并行任务不会因日志磁盘写入互相等待。
• 首次升级会自动导入旧版 history.json，成功后保留为 history.json.migrated。

日志生命周期与清理

• 单个任务日志最大保留 5 MiB，达到上限后会明确标记截断。
• 完成超过 7 天的日志会分批压缩为 gzip，历史页面仍可直接查看。
• 超过 90 天的日志会自动清理，下载历史记录继续保留。
• 删除单条历史时，先删除关联的 .log 和 .log.gz，成功后再删除记录。
• 清空历史时同步删除关联日志，并清理旧版本遗留的孤立任务日志。
• 日志删除失败时保留历史记录并显示错误；正在运行的任务日志不会被误删。
• 所有日志清理均不会删除已经下载的影像、瓦片或其他成果文件。

地图量测

• Leaflet 地图新增距离、面积和清除量测工具。
• 距离量测显示各分段长度及总长度。
• 面积量测显示面积及周长。
• 量测结果会保留在地图上，直到主动清除；再次点击当前工具或按 Esc 可取消绘制。
• 量测图层与下载选区完全独立，不会修改或清除已有下载范围。
• 蓝色虚线和高对比度结果标签可在明暗及不同类型底图上保持清晰。

升级说明

• 稳定版用户可通过应用内更新检查升级。
• 首次打开历史记录时如需迁移大量旧数据，可能会有一次性的短暂等待。
• 如需协助排查历史或日志问题，请保留 %LOCALAPPDATA%/geo-downloader/history.db、history.json.migrated 和相关任务日志。

v3.6.5-beta.2 - 历史日志清理修复

这是一个预发布测试版本，用于验证历史记录与任务日志的同步清理行为。

修复内容

• 删除单条下载历史时，会先删除关联的 .log 和 .log.gz 日志，成功后再删除历史记录。
• 日志删除失败时会保留历史记录并显示错误，避免界面提示成功但日志仍占用磁盘。
• 清空下载历史时，会同步删除全部关联日志，并清理旧版本遗留的孤立任务日志。
• 正在运行的任务日志会受到保护，不会被历史清理误删。
• 删除确认弹窗明确说明将同时删除关联日志，但不会删除已经下载的影像文件。

测试建议

• 删除一条包含日志的历史记录，确认记录及对应日志文件均被删除。
• 清空历史记录，确认旧的 task_*.log 和 task_*.log.gz 文件被清理。
• 在任务运行期间执行清理，确认活动任务能够继续运行且日志保持完整。
• 确认已下载的 GeoTIFF、瓦片和其他成果文件不受影响。

v3.6.5-beta.1 - 历史记录性能测试版

这是一个预发布测试版本，重点验证大量批量任务长期运行时的历史记录和日志性能。

性能改进

• 下载历史由单个 JSON 文件迁移到 SQLite，新增、删除和更新记录不再反复读取并重写全部历史。
• 历史记录改为分页加载，每页 50 条，避免数千条记录同时渲染造成界面卡顿。
• 历史记录数据库操作移到后台线程，任务完成时不再阻塞下载运行时。
• 任务日志写入与任务列表锁分离，多个并行任务不会因为日志磁盘写入互相等待。

日志维护

• 单个任务日志最大保留 5 MiB，超过后会明确标记为已截断。
• 完成超过 7 天的日志会逐批压缩为 gzip，历史页面可直接查看压缩日志。
• 超过 90 天的日志文件会自动清理，但下载历史记录仍会保留。
• 删除历史记录时同步清理对应日志，同时保护仍在运行的任务日志。

数据迁移

• 首次打开历史记录时，旧版 history.json 会自动完整导入 SQLite。
• 导入成功后，原文件保留为 history.json.migrated，不会直接删除。
• 如果旧历史文件损坏，程序会保留原文件并报告错误，不会用空数据覆盖。

测试重点

• 使用上千条历史记录时，批量下载速度是否保持稳定。
• 首次升级后历史记录总数、顺序和翻页是否正确。
• 普通日志和压缩日志是否均可正常查看。
• 删除单条历史、清空历史及并行任务日志是否行为正常。

测试中如遇异常，请保留 %LOCALAPPDATA%/geo-downloader/history.db、history.json.migrated 和相关日志以便定位。