#🗺️ MapKit

#v4.7.0-beta1 预发布

#🆕 New Features

• 新增 Cloudflare Pages 部署支持，并为网络默认配置、公告与 Geo Manifest 提供统一服务路径；重写模块现支持通过 endpoint 参数切换正式版、开发版或 Worker 服务端点。 @001ProMax
• 重构 Geo Manifest 地图瓦片样式合成，按基础地图、地图、2D/3D 卫星、交通、兴趣点、四处看看、道路、地球与公共交通等类别，根据源地区及设置选取中国大陆或国际版资源。 @patrickyanxxxxx
• 新增正式版、完整配置与开发版三套参数构建；正式版仅提供 10 项稳定设置并加入公共交通选项，开发版与 BoxJs 分别提供 18 项和 17 项完整设置。 @VirgilClyne

#🛠️ Bug Fixes

• 修正 Geo Manifest 合成时源地区、目标地区与国家代码的处理方向，补充美国地区映射，并修复资源、数据集、显示文本、URL 配置、Munin 分桶及位置偏移等内容在中国大陆版与国际版之间的选择逻辑。
• 修正定位漂移 AUTO 模式：根据资源清单请求的 os 参数选择服务，watchos 使用国际版 Apple 配置，其余系统使用中国版高德配置。
• 修正高德自动导航数据调度器的 URL 属性，并仅在 PEP 地区码存在时传递对应查询参数。
• 修正 Pages、Workers 与 Vercel 请求适配，统一使用 HTTPS 与标准端口，并按统一服务路径还原 Apple Maps 上游域名；同时补充服务端错误响应，便于定位处理失败。 @001ProMax
• 修正地图参数名称、默认值与运行时设置不一致的问题；公告环境默认保留原请求值，瓦片设置统一使用 CN 与 XX 两种地区版本。 @VirgilClyne
• 修复 GitHub Actions 缺少 Puppeteer 对应 Chrome 版本时无法生成 Egern 配置的问题。 @VirgilClyne

#🔣 Dependencies

• 更新 @nsnanocat/util 至 2.7.0，新增 @nsringo/mapkit 1.1.3 与 @nsnanocat/xml 0.4.4，并以 npm 包替代原有 MapKit Proto 与 XML Git 子模块。 @001ProMax
• 将 Hono 入口迁移至 hono/tiny，并补充 TypeScript 6.0.3 开发依赖。 @001ProMax
• 将 Egern 转换使用的 Puppeteer 固定为 25.7.0。 @VirgilClyne

#‼️ Breaking Changes

• BoxJs 设置与缓存命名空间由 Maps 更名为 MapKit；原 @iRingo.Maps.Settings 与 @iRingo.Maps.Caches 中的数据不会自动迁移。
• 正式版模块产物由 iRingo.Maps.* 更名为 iRingo.MapKit.*，原有模块订阅需要更新到新文件路径。
• 重写模块由 iRingo.Maps.Workers.* 更名为 iRingo.MapKit.Rewrite.*，原有模块订阅需要更新到新文件路径。
• 默认重写服务端点由按 Apple 上游域名拆分的 *.nanocat.cloud 地址迁移至统一的 mapkit.pages.dev；Worker 端点改为 mapkit.nanocat.cloud。
• 移除所有瓦片设置中的 HYBRID 模式，并将旧的 TileSet.Roads、TileSet.Satellite 参数分别更名为 TileSet.Road、TileSet.Satellite2D；已有自定义配置需要改用 CN 或 XX。

#🔄 Other Changes

• 统一项目、Worker 与重写模块中的 MapKit 命名，并拆分 Cloudflare Pages 与 Workers 的 Wrangler 配置及部署脚本。 @001ProMax
• 新增 Geo Manifest 地区合成、瓦片样式选择及 Worker 路由还原测试。
• 新增 Surge、Loon、Quantumult X 与 Stash 开发版模块模板及构建流程；开发版脚本与模块只同步到 Gist，GitHub Releases 继续仅发布正式版产物。 @VirgilClyne

#v4.6.1 正式版

#🆕 New Features

• none

#🛠️ Bug Fixes

• 优化 Geo Manifest 资源清单缓存流程，补强下载、缓存校验与解码保护逻辑，提升资源清单刷新、读取与回退时的稳定性。
• 改进不同地区 Geo Manifest 的缓存预热与复用逻辑，并修正 XX -> US 的回源处理，减少切换地区后资源清单异常或缓存失效的情况。

#🔣 Dependencies

• 更新 @auraflare/shared 至 1.1.1，同步调整包源配置以适配共享存储能力。

#‼️ Breaking Changes

• none

#🔄 Other Changes

• 调整自托管 Worker 的默认缓存绑定配置，新增 Maps KV 绑定并改为复用共享 KV 实例，以改善持续运行场景下的缓存持久化表现。

#v4.6.0 正式版

#🆕 New Features

• none

#🛠️ Bug Fixes

• 优化 Geo Manifest 资源清单缓存流程，补强下载、缓存校验与解码保护逻辑，提升资源清单刷新与回退时的稳定性。
• 改进不同地区 Geo Manifest 缓存的预热与复用逻辑，减少切换地区后资源清单异常或缓存失效的情况。

#🔣 Dependencies

• 更新 @nsnanocat/util 并引入 @auraflare/shared，改善 Worker 场景下的共享能力与缓存兼容性。

#‼️ Breaking Changes

• none

#🔄 Other Changes

• 优化自托管 Worker 的默认缓存绑定配置与运行时放置策略，改善持续运行场景下的缓存持久化表现。

#v4.5.1 正式版

#🆕 New Features

• none

#🛠️ Bug Fixes

• 新增 Storage 配置类型选项，支持在 $argument、PersistentStore (BoxJs) 与 database 默认配置之间切换，并补充对应说明文案。

#🔣 Dependencies

• none

#‼️ Breaking Changes

• none

#🔄 Other Changes

• 调整构建、草稿发布与正式发布工作流，不再打包和上传 modules 目录，仅保留 rulesets 与 dist 等产物。

#v4.5.0 正式版

#🆕 New Features

• 新增基于 Workers 的 Maps (Rewrite) 新模块，面向 Loon、Surge、Stash、Shadowrocket、Egern 提供新的 Rewrite 版本配置。

#🛠️ Bug Fixes

• 修正 卫星图像(Satellite) 版本选项的文案描述，明确该设置仅影响 2D 卫星图像版本，并减少 HYBRID 表述歧义。

#🔣 Dependencies

• 新增基础依赖：hono、fetch-cookie、@biomejs/biome。
• 更新开发与基础依赖：@rspack/cli、@rspack/core 升级至 ^1.7.7，@nsnanocat/util 升级至 ^2.2.3。

#‼️ Breaking Changes

• none

#🔄 Other Changes

• 统一 Workers 模块命名，配置名称追加 (Rewrite) 后缀，提升不同版本的辨识度。

#v4.4.0 正式版

#🆕 New Features

• 动态(Dynamic)配置新增/调整解锁功能如下：
  • 新增地球(Earth)图层选项，影响地球视图下行政区划、地貌等信息的显示。
    • 🧭高德版（默认）
      • 地球视图下优先显示国家/地区名称
      • 部分国家/地区资料缺失
      • 国内信息来自互动百科（无探索/旅游指南）
      • 国外信息来自维基百科（有探索/旅游指南）
    • Apple
      • 地球视图下优先显示城市名称与知名地貌名称
      • 各个国家/地区资料完整
      • 全部信息来自维基百科（有探索/旅游指南）
  • 新增道路(Roads)图层选项，影响卫星视图下的道路图像与探索视图下四处看看可用路段。
    • 🧭高德版
      • 卫星视图下中国道路不偏移
      • 探索视图下四处看看无可用路段
        • 仍然可以通过 POI 四处看看小窗定点查看街景，但无法在街景视图中移动位置。
    • Apple（默认）
      • 卫星视图下中国道路偏移
      • 探索视图下四处看看正常可用
        • 可以在探索视图下随意拖放街景查看位置，并可以在街景视图中移动位置。

#‼️ Breaking Changes

• 定位服务(Location Service)与地图(Maps)模块拆分为两个独立脚本与仓库，此仓库对应地图(Maps)。
  • 定位服务(Location Service)模块已发布，向后兼容代码已从地图(Maps)脚本中移除。
• 移除了 俯瞰(Flyover) 和 四处看看(Look Around) 设置项，这两者将始终启用并为 HYBIRD(混合) 模式。
  • 定位服务(Location Service)模块已发布，BoxJs中的相关选项已从地图(Maps)设置面板中移除。
• 3D 卫星图像选项合并至 Satellite 设置项中，默认为 HYBIRD(混合) 模式。

#v4.3.3 正式版

#🆕 New Features

• 兼容 iOS/macOS 26。
• 默认(Defaults)配置修改功能现在对任意地区代码均提供解锁功能，不再局限于 CN 地区代码，已知解锁功能如下：
  • 地图 App 中的交通卡和支付卡
  • 导航时显示朝向按钮
  • 支持地名和地标
  • 路线-驾驶-停靠点
  • 兴趣点(POI)实时繁忙度
  • 地图-路线-步行-现实世界中的路线-举起以查看
  • 地图-路线-步行-导航精确度-增强
  • 地图-为“地图”提供助力-评分与照片
  • 地图-为“地图”提供助力-显示评分和照片建议
  • 地图-照片使用-允许照片提供商使用你的照片
• 动态(Dynamic)配置新增/调整解锁功能如下：
  • 无论卫星图像版本，总是解锁地球模型显示（3D 地球仪视图）。
  • 无论卫星图像版本，总是解锁俯瞰(Flyover)使用的卫星扫描生成的 3D 城市模型。

#🔣 Dependencies

• 升级了 @nsnanocat/util

#‼️ Breaking Changes

• 定位服务(Location Service)与地图(Maps)模块拆分为两个独立脚本与仓库，此仓库对应地图(Maps)。
  • 定位服务(Location Service)模块已发布，向后兼容代码已从地图(Maps)脚本中移除。
• 移除了 俯瞰(Flyover) 和 四处看看(Look Around) 设置项，这两者将始终启用并为 HYBIRD(混合) 模式。
  • 定位服务(Location Service)模块已发布，BoxJs中的相关选项已从地图(Maps)设置面板中移除。
• 3D 卫星图像选项合并至 Satellite 设置项中，默认为 HYBIRD(混合) 模式。

#🔄 Other Changes

• 更新了模块/插件的内置分流规则。

#v4.3.2 预发布

#🆕 New Features

• 兼容 iOS/macOS 26。
• 默认(Defaults)配置修改功能现在对任意地区代码均提供解锁功能，不再局限于 CN 地区代码，已知解锁功能如下：
  • 地图 App 中的交通卡和支付卡
  • 导航时显示朝向按钮
  • 支持地名和地标
  • 路线-驾驶-停靠点
  • 兴趣点(POI)实时繁忙度
  • 地图-路线-步行-现实世界中的路线-举起以查看
  • 地图-路线-步行-导航精确度-增强
  • 地图-为“地图”提供助力-评分与照片
  • 地图-为“地图”提供助力-显示评分和照片建议
  • 地图-照片使用-允许照片提供商使用你的照片
• 动态(Dynamic)配置新增/调整解锁功能如下：
  • 无论卫星图像版本，总是解锁地球模型显示（3D 地球仪视图）。
  • 无论卫星图像版本，总是解锁俯瞰(Flyover)使用的卫星扫描生成的 3D 城市模型。

#🔣 Dependencies

• 升级了 @nsnanocat/util

#‼️ Breaking Changes

• 定位服务(Location Services)与地图(Maps)模块拆分为两个独立脚本与仓库，此仓库对应地图(Maps)。
  • 向后兼容代码将于定位服务(Location Services)模块发布后从地图(Maps)脚本中移除。
• 移除了 俯瞰(Flyover) 和 四处看看(Look Around) 设置项，这两者将始终启用并为 HYBIRD(混合) 模式。
  • BoxJs中的相关选项将于定位服务(Location Services)模块发布后从地图(Maps)设置面板中移除。
• 3D 卫星图像选项合并至 Satellite 设置项中，默认为 HYBIRD(混合) 模式。

#🔄 Other Changes

• 更新了模块/插件的内置分流规则。

#v4.3.1 预发布

#🆕 New Features

• 兼容 iOS/macOS 26。
• 默认(Defaults)配置修改功能现在对任意地区代码均提供解锁功能，不再局限于 CN 地区代码，已知解锁功能如下：
  • 地图 App 中的交通卡和支付卡
  • 导航时显示朝向按钮
  • 支持地名和地标
  • 路线-驾驶-停靠点
  • 兴趣点(POI)实时繁忙度
  • 地图-路线-步行-现实世界中的路线-举起以查看
  • 地图-路线-步行-导航精确度-增强
  • 地图-为“地图”提供助力-评分与照片
  • 地图-为“地图”提供助力-显示评分和照片建议
  • 地图-照片使用-允许照片提供商使用你的照片
• 动态(Dynamic)配置新增/调整解锁功能如下：
  • 无论卫星图像版本，总是解锁地球模型显示（3D 地球仪视图）。
  • 无论卫星图像版本，总是解锁俯瞰(Flyover)使用的卫星扫描生成的 3D 城市模型。

#🔣 Dependencies

• 升级了 @nsnanocat/util

#‼️ Breaking Changes

• 定位服务(Location Services)与地图(Maps)模块拆分为两个独立脚本与仓库，此仓库对应地图(Maps)。
  • 向后兼容代码将于定位服务(Location Services)模块发布后从地图(Maps)脚本中移除。
• 移除了 俯瞰(Flyover) 和 四处看看(Look Around) 设置项，这两者将始终启用并为 HYBIRD(混合) 模式。
  • BoxJs中的相关选项将于定位服务(Location Services)模块发布后从地图(Maps)设置面板中移除。
• 3D 卫星图像选项合并至 Satellite 设置项中，默认为 HYBIRD(混合) 模式。

#v4.3.0 预发布

#🆕 New Features

• 兼容 iOS/macOS 26。
• 默认(Defaults)配置修改功能现在对任意地区代码均提供解锁功能，不再局限于 CN 地区代码，已知解锁功能如下：
  • 地图 App 中的交通卡和支付卡
  • 导航时显示朝向按钮
  • 支持地名和地标
  • 路线-驾驶-停靠点
  • 兴趣点(POI)实时繁忙度
  • 地图-路线-步行-现实世界中的路线-举起以查看
  • 地图-路线-步行-导航精确度-增强
  • 地图-为“地图”提供助力-评分与照片
  • 地图-为“地图”提供助力-显示评分和照片建议
  • 地图-照片使用-允许照片提供商使用你的照片

#🔣 Dependencies

• 升级了 @nsnanocat/util

#‼️ Breaking Changes

• 定位服务(Location Services)与地图(Maps)模块拆分为两个独立脚本与仓库，此仓库对应地图(Maps)。
  • 向后兼容代码将于定位服务(Location Services)模块发布后从地图(Maps)脚本中移除。
• 移除了 俯瞰(Flyover) 和 四处看看(Look Around) 设置项，这两者将始终启用并为 HYBIRD(混合) 模式。
  • BoxJs中的相关选项将于定位服务(Location Services)模块发布后从地图(Maps)设置面板中移除。
• 3D 卫星图像选项合并至 Satellite 设置项中，默认为 HYBIRD(混合) 模式。

#v4.2.2 正式版

#🛠️ Bug Fixes

• 修复 $argument 和 $persistentStore 载入顺序颠倒的问题
  • 正确顺序为先读取 $argument 再读取 $persistentStore (BoxJs)
  • 即，有相同键名时，$persistentStore (BoxJs) 的值会覆盖 $argument 的值

#🔣 Dependencies

• 升级了 @nsnanocat/util
  • util 由 submodule 更改为 package
  • $platform 改为 $app
  • 使用了全新的 Console polyfill

#v4.2.0 预发布

#🛠️ Bug Fixes

• 修复 $argument 和 $persistentStore 载入顺序颠倒的问题
  • 正确顺序为先读取 $argument 再读取 $persistentStore (BoxJs)
  • 即，有相同键名时，$persistentStore (BoxJs) 的值会覆盖 $argument 的值

#🔣 Dependencies

• 升级了 @nsnanocat/util
  • util 由 submodule 更改为 package
  • $platform 改为 $app
  • 使用了全新的 Console polyfill

#v4.1.2 正式版

#🆕 New Features

• 现在可以为 ⌚️ Watch 单独设置[URL信息集] 定位漂移了

#🛠️ Bug Fixes

• 修复苹果版地图中整合高德版地图功能时的错误

#🔣 Dependencies

• 升级了 @nsnanocat/util
  • util 由 submodule 更改为 package
  • $platform 改为 $app

#‼️ Breaking Changes

• 从脚本中移除了 @nsnanocat/url polyfill
  • 由于 @nsnanocat/url 已经被移除，所以 🛰️ GeoServices 项目已完全不再支持 🚀ShadowRocket
• 从 🗺️ Maps 中分离了 ⌚️ Watch 的 🧰 BoxJs 设置
  • 如果您曾经使用过 🗺️ Maps 的 🧰 BoxJs 设置面板，请重新进行设置方能生效
  • 如果您曾经使用过 ⌚️ Watch 的 🧰 BoxJs 设置面板，请重新进行设置方能生效

#🔄 Other Changes

• 打包器由 rollup 更改为 rspack

#v4.1.1 预发布

#🆕 New Features

• 现在可以为 ⌚️ Watch 单独设置[URL信息集] 定位漂移了

#🛠️ Bug Fixes

• 修复苹果版地图中整合高德版地图功能时的错误

#🔣 Dependencies

• 升级了 @nsnanocat/util
  • util 由 submodule 更改为 package
  • $platform 改为 $app

#‼️ Breaking Changes

• 从脚本中移除了 @nsnanocat/url polyfill
  • 由于 @nsnanocat/url 已经被移除，所以 🛰️ GeoServices 项目已完全不再支持 🚀ShadowRocket
• 从 🗺️ Maps 中分离了 ⌚️ Watch 的 🧰 BoxJs 设置
  • 如果您曾经使用过 🗺️ Maps 的 🧰 BoxJs 设置面板，请重新进行设置方能生效
  • 如果您曾经使用过 ⌚️ Watch 的 🧰 BoxJs 设置面板，请重新进行设置方能生效

#🔄 Other Changes

• 打包器由 rollup 更改为 rspack

#v4.1.0 预发布

#🆕 New Features

• 现在可以为 ⌚️ Watch 单独设置[URL信息集] 定位漂移了

#🛠️ Bug Fixes

• 修复苹果版地图中整合高德版地图功能时的错误

#🔣 Dependencies

• 升级了 @nsnanocat/util
  • util 由 submodule 更改为 package
  • $platform 改为 $app

#‼️ Breaking Changes

• 从脚本中移除了 @nsnanocat/url polyfill
  • 由于 @nsnanocat/url 已经被移除，所以 🛰️ GeoServices 项目已完全不再支持 🚀ShadowRocket
• 从 🗺️ Maps 中分离了 ⌚️ Watch 的 🧰 BoxJs 设置
  • 如果您曾经使用过 🗺️ Maps 的 🧰 BoxJs 设置面板，请重新进行设置方能生效
  • 如果您曾经使用过 ⌚️ Watch 的 🧰 BoxJs 设置面板，请重新进行设置方能生效

#🔄 Other Changes

• 打包器由 rollup 更改为 rspack

#v4.0.9 正式版

#🔄 Other Changes

• 自动生成模块

#v4.0.4-rc2 正式版

#🛠️ Bug Fixes

• 修复 Shadowrocket 专用模块内链

#v4.0.4-rc 正式版

• 首次发布