chore: prepare v1.0.2 release

README.en.md

@@ -12,7 +12,7 @@ responses in a controlled test environment.
 [![iOS 15+](https://img.shields.io/badge/iOS-15%2B-111111?logo=apple)](project.yml)
 [![Swift 5.9](https://img.shields.io/badge/Swift-5.9-F05138)](project.yml)
 [![Go 1.23+](https://img.shields.io/badge/Go-1.23%2B-00ADD8?logo=go)](Core/go.mod)
-[![Version](https://img.shields.io/badge/version-v1.0.1-2563EB)](docs/CHANGELOG.md)
+[![Version](https://img.shields.io/badge/version-v1.0.2-2563EB)](docs/CHANGELOG.md)
 
 [Features](#feature-overview) ·
 [How It Works](#how-it-works) ·

README.md

@@ -12,7 +12,7 @@
 [![iOS 15+](https://img.shields.io/badge/iOS-15%2B-111111?logo=apple)](project.yml)
 [![Swift 5.9](https://img.shields.io/badge/Swift-5.9-F05138)](project.yml)
 [![Go 1.23+](https://img.shields.io/badge/Go-1.23%2B-00ADD8?logo=go)](Core/go.mod)
-[![Version](https://img.shields.io/badge/version-v1.0.1-2563EB)](docs/CHANGELOG.md)
+[![Version](https://img.shields.io/badge/version-v1.0.2-2563EB)](docs/CHANGELOG.md)
 
 [功能概览](#功能概览) ·
 [工作原理](#工作原理) ·

Tests/third_party_mode_contract_test.sh

@@ -43,7 +43,7 @@ grep -q 'HTTPS 解密' "$SETUP" || fail "Shadowrocket HTTPS decryption guidance
 grep -q 'presentSuccessfulOperationTip(.activation)' "$ROOT/App/MapHomeView.swift" || fail "third-party save must present the activation tip"
 grep -q 'presentSuccessfulOperationTip(.deactivation)' "$ROOT/App/MapHomeView.swift" || fail "third-party clear must present the deactivation tip"
 grep -q 'if spoofState == .active' "$ROOT/App/MapHomeView.swift" || fail "manual help must follow the shared spoof state"
-grep -q 'MARKETING_VERSION: "1.0.1"' "$ROOT/project.yml" || fail "marketing version must be 1.0.1"
-grep -q 'CURRENT_PROJECT_VERSION: "2"' "$ROOT/project.yml" || fail "build version must be 2"
+grep -q 'MARKETING_VERSION: "1.0.2"' "$ROOT/project.yml" || fail "marketing version must be 1.0.2"
+grep -q 'CURRENT_PROJECT_VERSION: "3"' "$ROOT/project.yml" || fail "build version must be 3"
 
 echo "PASS: third-party proxy mode contract"

docs/CHANGELOG.md

@@ -4,5 +4,6 @@
 
 ## 已发布
 
+- [v1.0.2](https://github.com/xweiba/location-spoofer/releases/tag/v1.0.2) — 2026-08-07
 - [v1.0.1](https://github.com/xweiba/location-spoofer/releases/tag/v1.0.1) — 2026-08-06
 - [v1.0.0](https://github.com/xweiba/location-spoofer/releases/tag/v1.0.0) — 2026-08-05

docs/releases/v1.0.2.md

@@ -0,0 +1,32 @@
+# v1.0.2
+
+发布日期：2026-08-07
+
+## 主要更新
+
+- 修复虚拟定位跨越中国大陆与境外后，MapKit 坐标标准变化可能导致的地图选点、蓝点和收藏位置偏移。
+- 增加运行期固定锚点刷新与状态清理，坐标标准切换后会按已保存的 WGS-84 / GCJ-02 坐标对重新显示图钉。
+- 点击实时定位时，如果当前位置与已保存收藏匹配，会恢复对应收藏的选中状态。
+- 当前选点面板同时显示 `GCJ-02(国内)` 与 `WGS-84(国际)` 坐标，两行可独立复制，并在窄屏自动调整宽度。
+
+## 文档与安装
+
+- 重写中英文 README，统一项目定位、双运行模式、构建要求、隐私边界和限制说明。
+- 补充 iOS 开发者模式、Impactor/第三方自签工具、USB 安装、设备驱动和 7 天免费签名有效期说明。
+- 增加完整功能预览，包含主界面和现有真机测试截图。
+
+## 兼容性说明
+
+- APP 模式仍使用设备内 Go 代理和当前 Wi-Fi 的手动 HTTP 代理，不创建 Network Extension 或系统 VPN。
+- 第三方代理模式仍由所选客户端负责代理/VPN、MITM、证书和坐标持久化。
+- MapKit 和系统定位存在运行时差异与缓存，本版本改进了坐标一致性，但不保证兼容所有 iOS 版本或第三方应用。
+
+## 自签安装
+
+- Release 附件为未签名 IPA，安装前需要自行签名。
+- 可使用免费 Apple ID 和 [Impactor](https://github.com/claration/Impactor/releases) 完成签名安装，无需付费开发者账号。
+- iOS 16 及以上版本需要在“设置 → 隐私与安全性 → 开发者模式”中开启开发者模式；iOS 15 可跳过。
+- 免费 Apple ID 签名通常只有 7 天有效期，到期后需要重新签名安装。
+- 第三方自签软件请从官方渠道获取，并自行评估账号、证书和隐私风险。
+
+<!-- commit-range: v1.0.1..v1.0.2 -->

project.yml

@@ -8,8 +8,8 @@ options:
 settings:
   base:
     SWIFT_VERSION: "5.9"
-    MARKETING_VERSION: "1.0.1"
-    CURRENT_PROJECT_VERSION: "2"
+    MARKETING_VERSION: "1.0.2"
+    CURRENT_PROJECT_VERSION: "3"
     CODE_SIGN_STYLE: Manual
     CODE_SIGNING_ALLOWED: "NO"
     CODE_SIGNING_REQUIRED: "NO"