# Fishing Log（私人钓况本）v1.0 — 交付说明

需求来源：`~/workspace/app-demand-shortlist-v1.md` 第 7 名「钓鱼日志（私人钓况本）｜创意库 i140」。

## 产物

- APK：`~/workspace/your_files/FishingLog-v1.0.apk`（15.6 MB，debug 签名，可直接安装）
- 源码：`~/workspace/fishing-log-android/`
- 包名：`com.fishinglog.app`，versionCode 1 / versionName 1.0，minSdk 24 / targetSdk 34
- 技术栈：Kotlin + Jetpack Compose 纯原生（无 WebView），SQLite 本地存储
- 构建：一次成功（依赖已缓存）；aapt 校验通过

## 需求复核结论（开工前，2026-10-28）

**信号成立、未反转，照计划开工。**

- 头部 Fishbrain 的 Google Play 介绍仍以社交网络为核心卖点（1500 万+ 钓友社区、分享渔获动态、关注流），Pro 订阅 $74.99/年，主打地图与预报——「头部 = 社交路线」判断不变。
- 需要如实标注的变化：主打「私人、无社交」角度的小产品近一两年明显变多（Fishz 近期刚上线、FishLog、Creel、Stringer、FishBytes、Fishing Organiser 都在讲 private / no social）。这说明该角度不是无人区，与需求清单「低偏中」的修正评级一致；但这些小产品大多仍带账号、云同步或地图服务，像本版这样**零权限（无 INTERNET）、无账号、坐标默认不记**的极简组合仍有错位空间。差异化押在：极简记录 + 本地统计 + 技术上不可能上传（不申请网络权限）。
- 受众获取靠垂类社区、冷启动慢的风险与原判断一致，属于上架运营问题，不影响第一版开发。

## 第一版功能清单（只做需求定的 2 个功能）

1. **鱼获记录**
   - 照片：系统相册选择器（PickVisualMedia）选图，**不申请相机权限**；选中后复制进 App 私有目录存储，不依赖相册授权续期
   - 鱼种：自由输入 + 13 个常用鱼种快捷 chip（Bass/Trout/Salmon/Catfish/Carp 等）+ 历史鱼种也会出现在记录里
   - 重量（kg）、长度（cm，可选）
   - 钓点名称：自由输入 + 历史钓点快捷 chip 复用
   - 天气备注：自由文本（如 "Sunny, light wind, 18°C"）
   - 饵料、备注；日期可改（日期选择器，保留原时间）
   - 钓点坐标：**可选、默认关闭**；开启后为手动输入经纬度——App 不申请定位权限、不自动获取位置
   - 列表按时间倒序，卡片显示照片、鱼种、重量、钓点、天气；点进详情可编辑/删除（删除连带删照片文件）
2. **个人统计**
   - 总览：总渔获数、总重量、鱼种数、钓点数、个人最佳（最大单尾）
   - 按钓点汇总：次数、总重量、最大单尾
   - 按鱼种汇总：次数、总重量、最大单尾
   - 按月份汇总：次数、总重量、最大单尾（按月倒序）
   - 统计全部本地计算，文案明示无他人对比、无排行榜

**设置页**：隐私设计说明（无账号/无网络权限/数据只存本机）、当前记录数、一键删除全部记录与照片、版本信息。

## 红线执行情况

- 无任何社交、动态流、粉丝、排行榜、分享功能（连系统分享入口都没有）
- **不申请 INTERNET 权限**（aapt 校验：唯一权限是 activity-compose 框架自动添加的内部 DYNAMIC_RECEIVER 权限），数据技术上无法上传
- 不申请 CAMERA、LOCATION 权限；照片只走系统选择器，坐标只支持手动输入且默认不记
- 无账号、无联网、无第三方 SDK
- 钓点名称与坐标仅存于 App 私有数据库（SQLite），照片存于 App 私有目录

## 未做事项（按 v1 范围砍掉）

- 广告与会员付费墙（变现层未接）
- 数据导出/备份（CSV 等）
- 地图展示钓点、天气自动获取、鱼种识别
- 多语言 UI（当前英文优先）、单位切换（lb/inch 未做，当前 kg/cm）
- release 签名包、Play 上架材料（数据安全声明等）

## 已知问题

- 未做真机/模拟器实测（本环境无模拟器）：仅完成编译打包 + APK 结构与权限校验。建议真机首验一条链：选照片 → 填鱼种/重量/钓点 → 保存 → 统计页看汇总。
- 启动图标暂借用汽修报价单的占位图（同为蓝色圆形图），正式上架前应换钓鱼主题图标。
- 照片以原图复制进私有目录，长年使用照片多时占用空间会涨；v1 未做压缩。
- 日期只能改日期部分，时间沿用记录创建时间（新建）或原记录时间（编辑），不能单独改时分。
- 权重单位只有 kg/cm，未做英制切换——若主攻北美市场，这是 v2 的优先项。