release: PaopaoLocationSpoofer v1.0.0

- iOS 虚拟定位工具，基于本地 HTTP 代理 MITM 方案
- MapKit 原生地图体验，支持搜索、收藏、实时定位
- 完整的设置引导流程（证书安装、WiFi 代理配置、环境验证）
- 支持 iOS 15+，SwiftUI 构建

docs/BUILD.md

@@ -0,0 +1,44 @@
+# Build
+
+## Requirements
+
+- macOS with Xcode and Command Line Tools
+- Go 1.23 or newer
+- XcodeGen (`brew install xcodegen`)
+
+## One-command build
+
+```bash
+./build.sh
+```
+
+该脚本会先检查 `xcrun`、`xcodebuild`、`xcodegen` 和 `go`，随后构建 iOS Go 静态库、重新生成 Xcode 工程、构建并输出未签名 IPA。
+
+如需在未签名 IPA 已生成后额外运行 `PaopaoLocationSpoofer` 的 iOS Simulator 单元测试：
+
+```bash
+./build.sh --test
+```
+
+`--test` 默认使用名为 `iPhone 16` 的 Simulator。若本机没有该设备，请传入已安装设备的 destination：
+
+```bash
+SIMULATOR_DESTINATION='platform=iOS Simulator,name=<你的模拟器名称>' ./build.sh --test
+```
+
+Output:
+
+```text
+dist/PaopaoLocationSpoofer-unsigned.ipa
+```
+
+IPA 始终保持未签名。用 [Impact](https://github.com/claration/Impactor) 签名安装即可。
+
+## 发布验收
+
+1. `./build.sh` 通过并输出未签名 IPA
+2. 用 Impact 签名后安装到设备
+3. 真机安装后，按引导下载 CA → 安装 → 信任，再配置 WiFi HTTP 代理 `127.0.0.1:8888`
+4. 环境检测通过后，选点开启虚拟定位
+5. 打开 Apple 地图验证定位是否变为虚拟位置
+6. 若失败，查看诊断页的日志信息

docs/CHANGELOG.md

@@ -0,0 +1,7 @@
+# 更新日志
+
+各版本发布说明见 `docs/releases/` 目录。
+
+## 已发布
+
+- [v1.0.0](https://github.com/xweiba/location-spoofer/releases/tag/v1.0.0) — 2026-08-05

docs/SELF-SIGNING.md

@@ -0,0 +1,36 @@
+# 自签安装指南
+
+**免费 Apple ID 即可自签安装**，无需付费开发者账号。
+
+## 原理
+
+本项目只是一个本地 HTTP 代理配合 WiFi 手动代理，不涉及 VPN / Network Extension / Packet Tunnel Provider。无需特殊权限，个人免费 Apple ID 侧载完全可用。
+
+## 构建未签名 IPA
+
+```bash
+./build.sh
+```
+
+输出：`dist/PaopaoLocationSpoofer-unsigned.ipa`
+
+## 使用 Impact 签名安装
+
+用 [Impact](https://github.com/claration/Impactor) 打开 IPA 签名并安装到设备。
+
+关键标识符不可更改：
+
+| 组件 | Bundle ID |
+|------|-----------|
+| 主 App | `com.paopaolabs.location-spoofer` |
+| App Group | `group.com.paopaolabs.location-spoofer` |
+
+## 安装后步骤
+
+1. 首次打开，按引导下载 CA 证书 → 安装描述文件 → 开启完全信任
+2. 在 WiFi 设置中配置 HTTP 代理为 `127.0.0.1:8888`
+3. 环境检测通过后即可使用
+
+## iOS 26+ 注意事项
+
+开启虚拟定位后需重启设备清除定位缓存，详见 README 中的使用说明。

docs/releases/v1.0.0.md

@@ -0,0 +1,30 @@
+## PaopaoLocationSpoofer v1.0.0
+
+正式发布首个稳定版本。
+
+### 核心功能
+
+- **🗺️ 原生地图体验**：Apple MapKit 蓝点实时定位，搜索地点、点击选点、拖动浏览与 Apple 地图一致
+- **📍 虚拟定位引擎**：基于本地 HTTP 代理 MITM 方案，无需 VPN、无需越狱，对钉钉、微信及任意系统定位 App 生效
+- **🧪 完整设置引导**：证书安装 → WiFi 代理配置 → 环境验证，逐步检测代理、CA 信任、坐标写入与响应改写
+- **✈️ 飞行模式缓存清除**：一键化操作引导，按步骤刷新飞行模式、WiFi 和定位服务状态
+- **⭐ 收藏与快速切换**：保存常用坐标，一键跳转
+- **🧾 诊断日志**：实时查看定位请求和改写状态，每条独立可复制
+
+### 兼容性
+
+| 项目 | 要求 |
+|---|---|
+| iOS | 15.0+ |
+| 安装 | 自行签名（推荐 [Impact](https://github.com/claration/Impactor)） |
+| 网络 | 可手动配置 HTTP 代理的 WiFi |
+
+### 安装
+
+1. 从 [Releases](https://github.com/xweiba/location-spoofer/releases) 下载 `PaopaoLocationSpoofer-unsigned.ipa`
+2. 使用 [Impact](https://github.com/claration/Impactor) 签名安装
+3. 按 App 内引导完成证书安装和 WiFi 代理配置
+
+### 致谢
+
+核心定位响应改写思路与 Go 实现来源于 [Yu9191/wloc](https://github.com/Yu9191/wloc)。