SakuGIS 0.4.0 — Apple Silicon Test Build

SakuGIS 0.4.0 / 0.4 版本说明

SakuGIS 0.4.0 的重点是让一次多模态定位工作能够完整保存、可靠移交并离线复盘。

中文

新增功能

• 新增 SakuGIS 自有的 .sgd 单文件工程格式。
• 保存查询文本、原始输入照片、三 Agent 结构化阶段结果、空间约束、真实地点
  检索、GIS 核验、候选评分、地图范围和图层状态。
• 打包支持的本地 GeoJSON、GeoPackage、Shapefile、KML、GPX、GeoTIFF、IMG
  数据和 QML 图层样式。
• 保存已经取得的 Brave 地点介绍、来源链接和界面照片缩略图；复盘时不需要
  Brave Key，也不会自动重新检索。
• 打开 .sgd 后确定性重建候选点、候选范围、Agent 面板和地图视图，不重新
  调用 Qwen、Nominatim、Overpass、PostGIS 或 Brave。
• 在 macOS 注册 .sgd 文档类型，可从 Finder 交给 SakuGIS 打开。

完整性与隐私

• 清单记录每个载荷的大小和 SHA-256；加载时拒绝损坏文件、路径穿越、符号链接、
  未登记条目和不兼容格式版本。
• 使用临时文件和原子替换，避免保存中断破坏已有工程。
• Qwen API Key、Brave API Key、PostGIS DSN、环境变量及钥匙串内容永不写入
  .sgd。
• OSM 和 Google 在线瓦片不会离线打包；数据库、远程或暂不支持的数据源会明确
  提示为未打包。

安装注意事项

• 仅支持 Apple Silicon，要求 macOS 13 或更高版本。
• DMG 已包含独立 QGIS 运行时，无需另行安装 QGIS。
• 当前构建采用 ad-hoc 签名，尚未进行 Apple 公证。首次启动时如被 Gatekeeper
  阻止，请在 Finder 中右键 SakuGIS，选择“打开”。
• SakuGIS 仍属于研究软件；候选评分是排序信号，不是经过校准的概率。

DMG SHA-256：473836e4f924c0858b2fccd094d58fb4d88a7540e08051615135e84eb9ae265b

English

SakuGIS 0.4.0 introduces the versioned .sgd single-file project format. It
packages case queries, original input photos, structured outputs from all three
Agents, GIS verification and ranking data, map state, supported local GIS
layers and styles, and acquired Place Explorer descriptions and thumbnails.
Reopening a project reconstructs the analysis and candidate layers without
calling online services again.

Every payload entry is size- and SHA-256-verified. The loader rejects path
traversal, symbolic links, unindexed entries and incompatible format versions.
Qwen and Brave keys, PostGIS DSNs, Keychain values and environment variables
are never included. Online map tiles and arbitrary remote/database connections
are not cached in the project.

The build requires macOS 13 or later on Apple Silicon. It includes its own QGIS
runtime, is ad-hoc signed, and is not yet Apple-notarized. Candidate scores are
research ranking signals rather than calibrated probabilities.

DMG SHA-256: 473836e4f924c0858b2fccd094d58fb4d88a7540e08051615135e84eb9ae265b

SakuGIS 0.3.1 — Apple Silicon Test Build

中文

SakuGIS 0.3.1 是面向 Apple Silicon 的测试版本，重点改善 Qwen 服务配置、启动体验和后续版本获取。

更新内容

• 在“设置 → API 服务”中集中显示 Qwen 接口地址与 API Key，并明确两者区别；保存后下一次请求立即生效，无需重启。
• 每次启动从 24 座全球大城市中随机选择初始地图视角；同一次运行中“回到初始范围”保持该城市。
• 在“关于 SakuGIS”中新增非阻塞的 GitHub Release 更新检查；发现新版本时可打开 DMG 下载或版本说明。
• 更新中英文 README、应用版本、About 页面、网络 User-Agent 和打包元数据。

重要说明

• Token Plan API Key 必须配合对应的 Token Plan OpenAI 兼容接口使用。新 Key 与旧项目专属接口混用会出现鉴权失败。
• 仅支持 Apple Silicon，要求 macOS 13 或更高版本。
• DMG 已包含独立 QGIS 运行时，无需另行安装 QGIS，因此文件约 1.7 GB。
• 当前采用 ad-hoc 签名且尚未经过 Apple 公证；首次启动可能需要在 Finder 中右键 SakuGIS 并选择“打开”。
• 候选评分是用于比较地点的排序信号，不是经过校准的统计概率。

验证

• 59 项 Python 单元测试
• QGIS 3.40.5 运行时冒烟测试
• 真实 GitHub Releases API 与 App 内更新检查
• Apple Silicon arm64 启动器和完整代码签名验证
• DMG CRC 与 SHA-256 校验
• 源码和 App 包内凭证扫描

SHA-256：5ca5270e422a14f176f4a3bf6238510ede23b17ddad05ca5febe379d9a452d66

---

English

SakuGIS 0.3.1 is an Apple Silicon test build focused on safer Qwen service configuration, a more global startup experience, and in-app release discovery.

Highlights

• Keeps the Qwen endpoint and API key together under Settings → API Services, explains their different roles, and applies saved changes to the next request without restarting.
• Selects the initial map view from 24 major world cities at random on each launch while keeping that city as the session's initial extent.
• Adds a non-blocking GitHub Release update check to About SakuGIS, with direct paths to the DMG and release notes when a newer version exists.
• Updates bilingual documentation, application metadata, the About dialog, network User-Agent, and packaging metadata.

Important notes

• A Token Plan API key must be paired with its corresponding Token Plan OpenAI-compatible endpoint. Using the new key with the previous project-specific endpoint will fail authentication.
• Requires macOS 13 or later on Apple Silicon only.
• The roughly 1.7 GB DMG includes an independent QGIS runtime; QGIS does not need to be installed separately.
• This build is ad-hoc signed and not Apple-notarized. On first launch, you may need to right-click SakuGIS in Finder and choose Open.
• Candidate scores are comparative ranking signals, not calibrated probabilities.

Validation

• 59 Python unit tests
• QGIS 3.40.5 runtime smoke test
• Live GitHub Releases API and packaged in-app update check
• Apple Silicon arm64 launcher and full code-signature verification
• DMG CRC and SHA-256 verification
• Credential scans of the repository and packaged source

SHA-256: 5ca5270e422a14f176f4a3bf6238510ede23b17ddad05ca5febe379d9a452d66

SakuGIS 0.3.0 — Apple Silicon Test Build

SakuGIS 0.3.0 — Apple Silicon 测试版

SakuGIS 是由 UrbanComp 团队开发的轻量级 macOS GIS 与多模态地理定位工具。本版本是首个可直接安装的 Apple Silicon 测试包，内置独立 QGIS 运行时。

本版功能

• 基础 GIS 图层加载、拖动、缩放、漫游与工程保存
• OpenStreetMap 与 Google 遥感影像 XYZ 图层
• 最多 6 张同一地点照片的多模态地理定位
• 三 Agent 证据提取、候选生成与 GIS 核验流程
• OSM Nominatim / Overpass 地点解析与空间约束
• 可选 PostGIS 本地空间核验
• 候选地点综合评分、GIS 分数与地点详情浮窗
• 可选 Brave Search 地点介绍与网络照片
• 中文 / English 界面、浅色 / 深色模式
• 统一“设置”菜单，保存后无需重启即可生效

系统要求

• macOS 13 或更高版本
• Apple Silicon：M1 / M2 / M3 / M4 或更新芯片
• 不支持 Intel Mac
• 安装包约 1.7 GB；包含 QGIS、GDAL、PROJ 与 PyQGIS 运行时，无需另装 QGIS

安装方式

1. 下载 SakuGIS-0.3.0-Apple-Silicon.dmg。
2. 可使用随附 SHA-256 文件核验下载完整性。
3. 打开 DMG，将 SakuGIS.app 拖到 Applications。
4. 首次启动时，建议在 Finder 中右键 SakuGIS，选择“打开”。

重要注意事项

• 这是 ad-hoc 签名且尚未经过 Apple 公证的测试包。首次打开可能出现 macOS 安全提示；不要绕过来源不明文件的安全提示，只使用本 Release 提供的 DMG 并核对 SHA-256。
• 安装包不包含任何通义千问、Brave Search 或 PostGIS 密钥。请在“设置 → 设置…”中配置；凭据仅保存到当前用户的 macOS 钥匙串。
• 通义千问是 Agent 定位的必需服务。Brave Search 为可选项；未配置时仍可执行 GIS 定位，但不会显示网络介绍与照片。
• 候选综合评分用于探索性排序，目前尚未经过独立地理验证集校准，不应解释为统计概率。
• OSM、Brave、通义千问和遥感底图依赖网络服务，其可用性、速率限制和许可条款由相应提供方决定。
• 当前 Google 遥感影像使用可替换的 XYZ 地址，并非正式 Google Maps Tile API 集成；生产使用前应确认许可与可用性。
• 本 Release 用于验证 DMG 分发流程。除非项目后续明确要求，不会为每次源码更新重新生成 DMG。

下载校验

SHA-256
9daff87ab5ed48e6a9edb289cedd67f2b28d3555e497fab821b08b893a80477a

---

SakuGIS 0.3.0 — Apple Silicon Test Build

This is the first installable Apple Silicon test build of SakuGIS, developed by the UrbanComp team. It bundles an independent QGIS runtime and does not require a separate QGIS installation.

Requirements: macOS 13 or later and an Apple Silicon Mac. Intel Macs are not supported.

The package is ad-hoc signed and not Apple-notarized. On first launch, use Finder’s Open command if macOS displays a security warning. API keys are not bundled; configure the required Qwen key and optional Brave/PostGIS services from Settings → Settings…. Scores are exploratory rankings rather than calibrated statistical probabilities.