银河路书支持中心
欢迎使用银河路书（StarShot）。在这里你可以：
- 看常见问题解决最常见的疑问
- 反馈 bug 或建议
- 了解系统要求和兼容性
常见问题
应用使用
Q: 打开应用后看到「使用默认位置评估」横幅，怎么办？
A: 这意味着定位服务没有授权或还没拿到 GPS 信号。两种情况：
- 第一次启动还没拿到位置 — 等几秒，应用拿到 GPS 后会自动重新评估，横幅消失
- 定位被关闭 — 去 系统设置 → 隐私与安全 → 定位服务 → StarShot，选择「使用 App 期间」
应用没有定位也能使用，但分数和推荐基于默认坐标（北京附近）。
Q: 「推荐观测点」列表只显示一个站点？
A: 你设置的「最大车程」太短，附近暗夜点不够。去设置 → 偏好 → 最大车程调大（默认 2 小时，最多 5 小时）。
Q: 下拉刷新显示「刚才刷新失败」是什么意思？
A: Open-Meteo 天气服务在你当前网络环境下访问失败（常见于弱网 / 切换 Wi-Fi 瞬间）。应用保留上次成功的天气数据继续使用，60 秒后横幅自动消失。如持续失败，检查：
- 网络连接是否正常（试着在浏览器打开 open-meteo.com）
- 是否启用了 VPN（VPN 切换可能干扰）
- 设备时间是否准确（HTTPS 证书校验需要正确时间）
Q: 地图页云图按钮点了没反应？
A: RainViewer 卫星数据源偶尔会有空数据窗口期（每天 ~5% 时间）。应用会弹出「云图数据暂不可用」toast 告诉你点击注册成功，但数据源此刻没数据。过几小时通常恢复。
Q: 「今晚不建议出发」是怎么算的？
A: 应用判定今晚没有可拍窗口。原因有三：
- 银心不升起 — 季节原因，本地纬度今晚银河核心不会升出地平线
- 月光干扰严重 — 月相亮度高 + 月亮整夜在天上挡住可拍时段
- 天文夜不连通 — 高纬度地区夏天可能没有完整的天文黑夜
打开「银河核心」详情页可以看具体哪一项是原因。
Q: 评分数字是怎么计算的？
A: 四因子加权：
- 银河可见性 35%（银心高度 + 可见时长）
- 月光干扰 25%（月相 × 月亮在天时长）
- 天气云量 30%（夜间窗口内分层云量加权 + 大气透明度）
- 暗夜可达性 10%（Bortle 等级 + 车程成本）
详细公式见应用内设置 → 关于。
Q: 红光模式有什么用？
A: 户外天文观测时，红光不会破坏暗适应视觉（视网膜 30 分钟才能完全暗适应）。在野外打开手机看 app，红光模式让你不用闭一只眼睛就能看屏幕。整个 app 字号也会自动放大到 15pt 以上，避免在户外读小字困难。
Q: 7 天预览的「趋势箭头」准吗？
A: 后 4 天用的是 OpenMeteo 数值预报，超过 72 小时校准性下降，所以只显示趋势箭头不显示具体小时数——参考它做"下周末值不值得请假"的方向性判断 OK，不要拿来精确规划。前 3 天有「X.X 小时可拍」具体窗口数字，准确性较高。
数据来源
Q: 暗夜点列表完整吗？我家附近有更好的点没列出来。
A: 应用内置 36 个相对成熟的暗夜观测点。我们持续在补充，欢迎在「问题反馈」里告诉我们坐标 + Bortle 等级，会在后续版本加入。
Q: Bortle 等级是怎么定的？
A: 基于 NASA VIIRS 卫星 2024 年辐射数据划分。Bortle 1 是最暗（极致暗夜）、Bortle 9 是城市中心。摄影银河至少需要 Bortle 5 以下（部分人觉得 Bortle 4 才够好）。
Q: 我能离线使用吗？
A: 部分功能可以：
- ✅ 银心 / 月相 / 天文昏暮时间计算（基于本地天文库 SwiftAA）
- ✅ 暗夜点信息 / Bortle 等级（随安装包分发）
- ✅ UI 主题切换 / 偏好设置
- ❌ 天气预报（需要 Open-Meteo）
- ❌ 大气透明度（需要 7Timer!）
- ❌ 卫星云图（需要 RainViewer）
- ❌ 真实驾车路线（需要 Apple Maps，但有直线距离 fallback）
- ❌ 光污染瓦片（首次需要下载，已访问过的区域有缓存）
打开过的暗夜点信息和最近 12 小时的天气数据会缓存在本地，弱网 / 离线时仍可参考。
隐私
Q: 我的位置数据安全吗？
A: 你的 GPS 坐标不会被上传到 StarShot 自有服务器（因为我们没有服务器）。当你查询天气 / 驾车路线时，坐标参数会发给 Open-Meteo / 7Timer! / Apple Maps；RainViewer 云图按地图视图请求瓦片，不发送你的坐标。这些服务不知道是你（没有账号、没有设备 ID）。
详见 完整隐私政策。
Q: 应用收集我的什么数据？
A: 只有位置（且不与你身份关联，不用于追踪）。无账号、无 analytics、无广告 SDK。详细见 App Privacy 页。
系统要求
- iOS：17.0 及以上
- 设备：iPhone（暂不支持 iPad / Mac Catalyst）
- 网络：天气 / 云图 / 路线功能需要联网；核心天文计算和暗夜点数据离线可用
- 位置权限：可选（拒绝后应用以默认坐标降级运行）
联系我们
- 应用内反馈：设置 → 关于 → 问题反馈
- 邮箱：1162558327@qq.com
- GitHub Issues：https://github.com/NaibManco/StarShot/issues
我们会在 24-48 小时内回复。
如果遇到 Crash
应用 crash 后再次打开会自动恢复——所有本地数据安全。如能复现：
- 在「问题反馈」里描述操作步骤
- 附上系统版本（设置 → 通用 → 关于本机）
- 附上 StarShot 版本（应用内设置 → 关于 → 版本）
- 如果方便，附上 Xcode/iOS Console 抓的崩溃日志
已知问题
- Open-Meteo 在中国大陆部分网络环境下可能慢：应用做了重试和兜底但偶尔仍会显示"刚才刷新失败" toast
- 7Timer! 是学术项目无 SLA：偶尔会几小时不可用，应用会自动 fallback 到三因子评分（无大气透明度）
- iPad 暂未适配：首版仅支持 iPhone，暂无独立 iPad 版
StarShot 是个人开发者作品，欢迎反馈和建议帮助我们做得更好。