📚 AceCrush-Craft 文档

English | 简体中文

这是什么?

AceCrush Craft 是一款面向网球爱好者的 装备数据工具。不是另一支「网球社区 App」，而是把日常用得到的 4 件事——测算、记录、提醒、张力换算——全部装在一个离线优先的小工具里：

#	功能	你得到
1	握把尺寸测量	拍照 AI（端侧 MediaPipe）→ Yonex / Wilson / Head-Prince-Babolat 三套推荐；也可用尺子手动
2	球拍档案	记录你每支球拍的规格与备注
3	穿线记录	每次穿线写一条 + 自动换线提醒
4	张力换算	DT ⇄ RT ⇄ lbs ⇄ kg 互转；点「用此张力」直接落到穿线记录

所有数据存在设备本地 SQLite，不上传；AI 测量只在「你按下拍照」时启动并默认在端侧跑。

当前支持平台：Android（iOS 暂无可用版本）
当前最新版本：V1.0.x

每个 release 含 app-release.apk + SHA-256 校验值。

安装提示：第一次安装会被 Android 拦截"未知来源应用"。前往 设置 → 应用 → 特殊权限 → 安装未知应用 → 允许此来源，再次点击 APK 即可。 iOS 用户：暂无可用版本，建议收藏官网获取上架通知。

如果你刚装好 V1.0，最少要走的一步：

章节	内容	谁看
00 · 项目介绍	App 定位、4 个功能、版本路线、三大基石	第一次接触的人 —— 从这里开始
01 · 快速开始	安装、权限、首页、主导航、语言/主题	新用户 —— 5 分钟走完
02 · 握把尺寸测量	拍照 → MediaPipe Hand → 三家体系推荐（也可尺子手动）	不知道用几号握把的人
03 · 球拍档案	添加 / 编辑 / 删除球拍及规格	拥有 ≥1 支拍的人
04 · 穿线记录	穿线日志、自动提醒	想知道何时该换线的人
05 · 张力换算	DT ⇄ RT ⇄ lbs ⇄ kg；用此张力记录穿线 CTA	买线、调磅数、记录穿线时
06 · 云同步（自建 Supabase）	多设备同步 + 照片云端备份（BYO 模式，opt-in）	想跨设备共享数据时
07 · 设置	主题 / 单位 / 字体 / 数据管理 / 通知	想改外观或导出数据时
08 · 隐私	权限清单、开源许可、第三方组件	想看清权限时
09 · 反馈	反馈模板、邮件、小红书	遇到 Bug 或想提建议
10 · 常见问题	13 个 FAQ（免费 / iOS / 上传 / 数据恢复等）	任何时候