SWIFT · SWIFTUI · HEALTHKIT · CORE LOCATION · IOS 15.0+
A smart flashlight that reads the night. 会读懂夜晚的智能手电筒。
GloWalk is an iOS night-walking flashlight that adapts its brightness in real time to your surroundings — camera feedback, with a factor model as fallback. Record your path as a golden constellation trail and weave it into a shareable poster when you arrive.
随行路灯 是一款为夜间步行设计的智能手电筒。它根据摄像头反馈实时调整亮度，并在反馈不可用时使用因素模型。把你的步行记录成一条金色星座轨迹，到达后生成一张可分享的夜路海报。
-
Adaptive Walking Light — Rear-camera feedback controls the torch where available, with a factor model as fallback. Manual adjustments remain in your control.
随行自适应照明 — 后摄反馈可用时由闭环控制，否则使用因素模型；手动调光由你掌握。
-
Apple Health Sync — With your permission, completed walks are written to the Health app as full workout records: steps, distance, and active duration. Write-only — GloWalk never reads your health data, and nothing leaves your device.
Apple 健康同步 — 经你授权后，完成的步行会以完整运动记录（步数、距离和有效时长）写入「健康」App；仅写入、不读取，健康数据不出设备
-
Drag-to-Adjust Brightness — Drag the glow circle up or down through ten discrete levels and release to keep it, or drag all the way down to the brightness bars to turn the torch fully off.
拖动调光 — 拖动中央光晕在十档亮度间调节，松手停留在所选档位；拖到最下方亮度条可完全关闭手电
-
Constellation Path Recording — GPS walking paths are rendered as golden bezier trails with footprint markers. Occasionally, a nocturnal animal silhouette appears.
星座路径记录 — GPS 步行路径以金色贝塞尔曲线呈现，起终点有脚印标记，偶尔出现夜行动物剪影彩蛋
-
Night Walk Posters — When your walk ends, GloWalk generates a poster with your path, the night's moon phase, and a poetic tagline. Share it or save it to your photo library.
夜路海报 — 步行结束后自动生成海报，包含路径轨迹、当晚月相照片和诗意格言，可分享或保存
-
Night Imprints — Revisit the walk-specific lines that have appeared on your posters, including when each was first found and how often it returned.
夜行印记 — 回看曾在海报中出现的夜行纪念语，以及它们首次出现的时间和累计次数
-
Dark Interface — Every pixel is designed for night use. Amber-on-black HUD, no white flashes.
深色界面 — 每一像素都为夜间设计，琥珀金配色
-
11 Languages — English, 简体中文, 繁體中文, 日本語, 한국어, Français, Deutsch, Español, Português, Italiano, Русский. Each language renders in its matching open-source handwriting font (LXGW WenKai, Klee One, LXGW WenKai KR — all SIL OFL). Switch languages at runtime.
十一语言 — 中、英、繁、日、韩、法、德、西、葡、意、俄共 11 种语言，运行时即可切换；每种语言配对应的开源手写字体（霞鹜文楷、Klee One、霞鹜文楷韩文版，均为 SIL OFL 许可）
-
Thermal-Aware — The rear camera runs only when the adaptive loop needs it, and the torch steps down gently under heat — cooler in hand, longer on the night.
更凉爽 — 后置摄像头按需启停，手电在高热时平缓降档，减少发热
-
Privacy First — Walk data stays on-device, no account, no analytics, no tracking. Health data is only written to Apple Health with your explicit permission and never leaves your device. Your location is sent to Apple WeatherKit and Open-Meteo only for current weather.
隐私优先 — 步行数据仅存本机，无需账号，无分析，无追踪；健康数据仅在你授权后写入 Apple 健康，绝不出设备；仅位置信息会发送给 Apple WeatherKit 和 Open-Meteo 获取当前天气
| Splash 启动 |
Walking 步行 |
Poster 海报 |
|---|---|---|
| App icon + tagline 应用图标 + 标语 |
5-factor HUD + constellation path 五因素 HUD + 星座路径 |
Path + moon phase artwork 路径 + 月相图 |
-
iOS 15.0+
-
iPhone — requires rear camera and LED flash
iPhone — 需要后置摄像头和 LED 闪光灯
-
Xcode 26+
GloWalk/
├── Models/ # MoonPhase, PathProjector, WalkSession, Tagline
├── Services/ # LightEngine, LoopGate, TorchController, TorchThermalPolicy, SensorManager,
│ # LocationManager, WeatherService, PosterGenerator, HealthKitStore,
│ # HealthSyncService, HealthWorkoutFactory
├── ViewModels/ # HUDViewModel
├── Views/
│ ├── HUD/ # HUDView, GlowCircleView, ConstellationPathView, MoonWeatherCardView
│ ├── Launch/ # SplashView, PrivacyConsentView
│ ├── History/ # HistoryListView, HistoryPosterView
│ ├── Poster/ # ArrivalSummaryView
│ ├── Settings/ # SettingsView, PermissionsView, HelpView
│ └── Components/ # HUDButton, ShareSheet
├── Extensions/ # Color, Font, Haptic, L10n, ViewModifiers
└── Resources/ # Fonts (LXGW WenKai · Klee One · LXGW WenKai KR), Licenses (OFL),
# MoonPhases, Taglines.json, Localizable.xcstrings
brightness = ambient(40%) + posture(15%) + darkAdapt(15%) + moon(15%) + weather(15%)
This formula describes the fallback model. During rear-camera closed-loop control, factor cards show context only (—); they do not claim to explain the actual LED output.
以上为备用因素模型。后摄闭环控制时，卡片仅提供环境信息（—），不将模型估算显示成实际 LED 贡献。
| Action 操作 |
Gesture 手势 |
|---|---|
| Auto brightness 自动调光 |
Automatic — camera + posture + dark adaptation + moon + weather 全自动——摄像头 + 姿态 + 暗适应 + 月相 + 天气 |
| Manual adjust 手动调光 |
Drag the glow circle up/down — ten discrete levels, release to keep the position 在光晕区域上下滑动，十档亮度，松手停留 |
| Restore auto 恢复自动 |
Single-tap the glow circle 单击光晕 |
| Torch fully off / on 完全关灯 / 重新开灯 |
Drag the glow circle down to the brightness bars (off), or drag it up (on) 把光晕拖到下方亮度条位置（关灯）；上拖一点即恢复 |
| Pause / resume 暂停／继续 |
Hold the glow for 0.6s; tap to resume. Locking or leaving the app also pauses. 长按光晕 0.6 秒暂停，轻点继续；锁屏或离开应用也会暂停。 |
| End walk 结束步行 |
Double-tap the glow circle → confirm → generates poster 双击光晕 → 确认 → 生成海报 |
| Toggle a fallback factor 切换备用因素 |
In fallback automatic mode, tap a factor card; cards are informational during camera closed-loop control 备用自动模型生效时可点击因素卡片；摄像头闭环控制期间卡片仅作信息展示 |
| Dismiss poster 关闭海报 |
Swipe down on the poster 向下滑动海报 |
| View past posters 查看历史海报 |
Tap any walk in history to see its poster again 步行历史中点击记录，重新查看海报 |
git clone https://github.com/wxy/GloWalk.git
cd GloWalk
open GloWalk.xcodeprojBuild with Xcode 26+ targeting iOS 15.0+. Run on a physical iPhone for full sensor and camera access.
使用 Xcode 26+ 构建，目标 iOS 15.0+。建议在真机上运行以体验完整的传感器和摄像头功能。
New Health records contain no route coordinates. After 12 seconds without interaction, secondary HUD information fades; touch to reveal it. Paused intervals are excluded from records.
新健康记录不含路线坐标。12 秒不操作后次要信息淡出，触摸唤回；暂停区间不计入记录。
See PRIVACY.md — all walk data stays on-device; health data is only written to Apple Health with your permission and never leaves your device.
详见 PRIVACY.md——步行数据仅存本机；健康数据仅在你授权后写入 Apple 健康，绝不出设备。
Code, ideas, and docs are welcome — see CONTRIBUTING.md. Development: build with Xcode 26+ targeting iOS 15.0+, then run the test suite:
欢迎提交代码、想法与文档——见 CONTRIBUTING.md。开发：使用 Xcode 26+ 构建，目标 iOS 15.0+，然后运行测试套件：
xcodebuild test -project GloWalk.xcodeproj -scheme GloWalk \
-destination 'platform=iOS Simulator,name=iPhone 17'
Apache License 2.0 — see LICENSE for details.
Apache License 2.0——详见 LICENSE。
| Website 官网 |
App Store App Store |
Releases 发布 |
Issues 问题反馈 |
|---|