移动端安装
Android 与 iOS 的详细安装说明。
候选发布版和测试版构建请参阅加入测试版渠道。
Android
Google Play（推荐）
Mindwtr 已在 Google Play 上架。
F-Droid
从 F-Droid 安装：
- 安装 F-Droid 客户端。
- 打开 F-Droid 上的 Mindwtr并安装。
IzzyOnDroid
如果使用 Droid-ify、Neo Store 或 F-Droid 等兼容 F-Droid 的客户端，可从 IzzyOnDroid 安装：
- 添加 IzzyOnDroid 仓库：
https://apt.izzysoft.de/fdroid/repo。 - 打开 IzzyOnDroid 上的 Mindwtr并安装。
下载 APK
- 前往 GitHub Releases
- 下载最新 APK（例如
mindwtr-<version>.apk） - 在设备上打开 APK
中国大陆厂商应用商店
Mindwtr 暂未上架小米、OPPO、vivo 等中国大陆厂商的应用商店。这说的是商店分发渠道：使用这些品牌的手机，只要设备满足 Android 版本等运行要求，你仍可通过上面的官方 APK 安装。系统可能要求你确认安装来源，操作见下文。
在这些商店发布应用，维护者需要按各平台的规则准备材料、提交审核，并在后续版本中持续维护。除安装包和截图外，还可能涉及以下工作。
主体认证与企业资质。 各平台对个人和企业开发者开放的业务不同。例如，OPPO 公布的账号认证指南将 Android 应用分发列为企业开发者业务。进入要求企业主体的渠道，就需要具备相应的企业资质，并承担注册和维护主体的成本；不能据此推断所有 Android 商店都要求开发者注册公司。
APP 备案与网络资源。 工信部的备案说明介绍了实名核验、网络资源与业务信息登记，以及通过接入服务商或分发平台提交申请的流程。如果为上架渠道部署境内服务，还需要评估服务器租用、域名及相应备案的成本。不过，购买服务器或域名并非所有应用统一适用的前提；APP 备案也不等同于网站备案。例如，OPPO 的上传指南对单机资源列有例外，并要求单机承诺函。Mindwtr 虽然支持离线使用，也提供可选的联网功能，我们仍需逐平台确认适用要求，不能直接假定符合单机例外。
软件著作权与上架审核。 这里涉及的是软件著作权（软著）或平台接受的版权证明，不是“软件专利”。例如，小米的应用资质 FAQ要求上架应用提供 APP 备案及规定的版权证明。维护者还需分别处理各商店的资料填写、隐私与权限说明、审核反馈和版本更新。
目前，我们没有足够的预算和精力完成并长期维护这些渠道，因此继续提供官方 APK 下载。如果你希望 Mindwtr 在国内厂商应用商店上架，欢迎反馈你的需求，也可以捐赠支持项目。当需求和资源允许时，我们会重新评估；捐赠支持项目维护，不保证某个商店一定上架或具体上架时间。
以上说明依据各平台公开资料整理，具体资格和材料以主管部门及各平台最新要求为准。
允许安装未知来源应用
如果系统提示，请允许安装未知来源应用：
- 前往设置 → 安全（或设置 → 应用 → 特殊访问权限）
- 允许浏览器或文件管理器安装未知应用
- 返回 APK 并安装
验证安装
安装后：
- 从应用抽屉打开 Mindwtr
- 授予所请求的权限
- 开始记录任务！
iOS
当前状态
iOS 版现已在 App Store 上架：
TestFlight 测试版也可通过 https://testflight.apple.com/join/7SMJCTSR 获取。退出测试版的说明和其他平台的测试版渠道请参阅加入测试版渠道。
iOS App 包含已在配对实体手表上测试的原生 Apple Watch App。将运行 watchOS 10 或更新版本的 Apple Watch 与 iPhone 配对，安装 Mindwtr，然后通过 iPhone 上的 Watch App 将其安装到手表。轻点说话可录制音频并由 iPhone 转写，轻点输入可键入文字。你还可以完成或推迟专注任务，并控制关联的番茄钟。
选项
- App Store（推荐）：安装稳定版
- TestFlight：安装最新 iOS 测试版构建
- 模拟器构建：源代码中提供，用于开发
- 自行构建：使用 Xcode 自行构建并签名（设备签名需要 Apple Developer 账户）
不过，在 App Store 上维护 iOS 版本需要每年支付一笔不小的费用（参阅 Apple Developer Program），目前由开发者个人承担。
为了确保 Mindwtr 能够持续存在和发展，非常感谢你的支持。如果这款应用对你有价值，请考虑通过 GitHub Sponsors 或 Ko-fi 支持项目。
为 iOS 构建（开发者）
# Clone repo
git clone https://github.com/dongdongbh/Mindwtr.git
cd Mindwtr
# Install dependencies
bun install
# Run on iOS Simulator
bun mobile:ios
# Or open in Xcode for device builds
cd apps/mobile
npx expo prebuild --platform ios
open ios/*.xcworkspace数据位置
移动端数据保存在应用内部存储中，以 SQLite 为主要存储，并包含用于备份/同步的 JSON 数据。
更新
Android
- 从 Releases 下载新 APK
- 覆盖现有应用安装
- 你的数据会予以保留
提示：在应用中前往设置 → 关于 → 检查更新，可查看是否有新版本。
卸载
Android
- 长按 Mindwtr 图标
- 选择卸载或拖到垃圾桶
清理数据
卸载会移除所有本地数据。如果想保留数据：
- 先导出备份（设置 → 数据 → 导出备份）
- 保存导出的文件
- 卸载应用
故障排除
应用启动时崩溃
尝试清除应用数据：
- 前往设置 → 应用 → Mindwtr
- 点按存储 → 清除数据
- 重新打开应用
注意：这会删除所有本地数据。请从同步或备份恢复。
同步无法工作
同步故障排除请参阅数据与同步。
APK 无法安装
- 确保有足够的存储空间
- 允许安装未知来源应用
- 尝试重新下载 APK（原文件可能已损坏）