# "想拍" App 产品需求文档 (PRD) - MVP版本

| 文档版本     | V1.1 (MVP)              |
| ------------ | ----------------------- |
| **创建日期** | 2025年9月11日           |
| **更新日期** | 2025年9月12日           |
| **创建人**   | Claude                  |
| **项目名称** | 想拍 (snapwish)         |
| **项目描述** | Shoot What Inspires You |

## 1. 引言

### 1.1. 项目背景

许多摄影爱好者和创意工作者在日常浏览社交媒体（如微博、Twitter、Instagram、Pinterest等）时，会发现很多能激发自己拍摄灵感的图片。然而，这些图片往往散落在各个平台的收藏夹或手机相册中，难以统一管理和快速查找。当用户想要寻找拍摄灵感时，需要在多个应用和文件夹中翻找，效率低下。"想拍"旨在解决这一痛点，提供一个统一的灵感收集和管理工具。

### 1.2. 产品愿景

成为摄影爱好者和创意人士首选的、最便捷的拍摄灵感收集与管理应用。通过无缝的分享体验和强大的分类功能，帮助用户捕捉、整理并随时回顾每一个创意火花。

### 1.3. 目标用户

- **摄影爱好者**：希望系统性地收集和整理摄影作品，以供学习和模仿
- **设计师/艺术家**：需要收集视觉素材，构建自己的灵感库
- **内容创作者/博主**：为自己的内容创作寻找视觉参考和创意灵感
- **普通用户**：喜欢美好图片，希望将喜欢的图片收藏并分类管理

### 1.4. MVP版本范围

本次V1.1 MVP版本专注于实现核心的灵感收集和管理功能，主要目标是让用户能够通过系统分享功能快速保存图片，并提供基础的文件夹和标签管理功能，以及良好的浏览查看体验。

## 2. 产品功能详述

### 2.1. 核心功能：接收并保存分享图片

#### 2.1.1. 从系统分享菜单接收图片

**功能描述**：App需要注册为系统分享菜单的目标应用。当用户在任何支持图片分享的应用中选择一张或多张图片并点击"分享"时，可以在分享列表中看到"想拍"App的图标。

**用户流程**：
1. 用户在第三方App中看到一张喜欢的图片
2. 用户长按图片或点击分享按钮，唤起系统分享菜单
3. 在分享列表中，用户找到并点击"想拍"图标
4. 系统显示半透明模态框覆盖在当前App上，展示图片保存界面

**技术要求**：
- 支持接收单张图片和多张图片（最多30张）
- 能正确处理传入的图片文件流
- 支持最大30MB的图片文件
- 支持格式：JPG、PNG、WebP、HEIC、GIF、动态WebP、APNG

#### 2.1.2. 图片保存界面

**功能描述**：从分享菜单跳转过来后，展示待保存的图片预览，并提供文件夹和标签选择器，以及备注输入框。

**界面元素**：
- **图片预览区**：清晰展示待保存的图片缩略图。多张图片时显示网格预览，可点击查看大图
- **文件夹选择器**：
  - 点击后弹出文件夹列表供用户选择
  - 默认显示"未分类"
  - 列表顶部应有"新建文件夹"的快捷入口
  - 支持文件夹图标选择
  - 按最近使用顺序排序
- **标签选择器**：
  - 输入框支持动态匹配已存在的标签，显示3个建议
  - 用户可以从匹配列表中选择，也可以直接输入新标签
  - 已选择的标签会显示在输入框下方，支持点击删除
  - 单张图片标签数量无限制
  - 单个标签字数限制：20个中文汉字长度
  - 重复标签自动忽略，更新标签使用顺序
- **备注输入框（可选）**：多行文本框，允许用户为图片添加文字描述
- **操作模式切换**：批量应用模式（默认） vs 单张编辑模式，切换时保留批量内容到单张编辑
- **"保存"按钮**：将图片文件保存到本地，并将元数据存入数据库
- **"取消"按钮**：放弃本次保存，关闭该界面

**保存策略**：
- 原图保存至应用专属目录
- 自动生成缩略图：长边500px，WebP格式，质量85%，保持原始比例
- 按保存日期分类存储：`/yyyy/MM/dd/`
- 异步处理，避免阻塞UI
- 多张图片保存时显示进度提示

### 2.2. 组织与管理功能

#### 2.2.1. 文件夹管理

**功能描述**：用户可以创建、重命名和删除文件夹。仅支持一级文件夹结构。

**具体实现**：
- **创建**：用户可以在文件夹选择器或专门的文件夹页面创建新文件夹，通过弹窗形式，支持图标选择
- **查看**：在"文件夹"标签页中，以网格形式展示所有文件夹及其封面（默认为该文件夹最新一张图）
- **重命名**：长按文件夹或通过编辑按钮进行重命名
- **删除**：删除文件夹时，其中的图片自动归类到"未分类"文件夹
- **排序**：按最近使用顺序排序

#### 2.2.2. 标签管理

**功能描述**：用户可以创建和删除标签，并查看所有使用特定标签的图片。

**具体实现**：
- **创建**：在保存图片时输入新标签即可自动创建
- **查看**：在"标签"管理页面，以列表形式展示所有标签
- **管理**：提供标签编辑功能，支持Material Icons图标，颜色跟随主题
- **去重**：按文本内容自动去重
- **图标**：支持从Material Icons中选择图标，存储图标名称
- **颜色**：跟随应用主题色，存储为十六进制格式

### 2.3. 浏览与查看功能

#### 2.3.1. 主图库视图

**功能描述**：App的主界面，以瀑布流的形式展示所有已保存的图片。

**具体实现**：
- **布局**：瀑布流网格，支持列数切换
  - 手机（≤600dp）：2列
  - 平板（>600dp）：3-4列
- **排序**：默认按保存时间倒序排列
- **间距**：图片间距8dp
- **加载**：支持上拉加载更多，下拉刷新
- **空状态**：显示简洁插画和说明文案
- **搜索框**：常驻顶部

#### 2.3.2. 图片详情页

**功能描述**：点击图库中的任意一张图片，进入详情页。

**界面元素**：
- 高清大图查看，支持手势缩放和拖动
- 滑动切换：左右滑动切换上一张/下一张，不支持循环
- 双击放大：双击放大/缩小功能
- 横竖屏适配：根据设备方向自动调整布局
- 显示图片的所属文件夹、所有标签和备注信息
- 提供"编辑"按钮，允许用户修改文件夹、标签和备注
- 提供"删除"按钮，需要二次确认后删除图片
- 提供"导出"按钮，可将图片保存到系统相册

#### 2.3.3. 搜索功能

**功能描述**：在主图库顶部提供搜索功能。

**具体实现**：
- **搜索框**：常驻顶部，支持关键词输入
- **搜索范围**：文件夹名称、标签名称、备注内容
- **触发方式**：点击搜索按钮触发搜索
- **搜索历史**：记录最近10条搜索历史
- **搜索结果**：在图库中实时展示搜索结果，不高亮匹配文字
- **空搜索**：显示缺省页面
- **加载优化**：搜索超过1秒时显示loading状态

### 2.4. 设置功能

**功能描述**：提供应用的基本设置选项。

**设置项分组**：
- **外观设置**
  - **语言设置**：简体中文、繁体中文、English
  - **主题模式**：跟随系统、浅色、深色（保持一定对比度）
  - **网格布局**：瀑布流（默认）、等宽网格
- **存储管理**
  - **存储使用情况**：显示当前存储占用
  - **清理缓存**：一键清理缩略图缓存
- **关于应用**
  - **版本信息**：显示当前版本号
  - **用户协议**：链接到用户协议页面
  - **隐私政策**：链接到隐私政策页面

### 2.5. 国际化支持

**支持语言**：
- 简体中文（默认）
- 繁体中文
- English

**文案风格**：活泼友好，符合年轻用户喜好

**App名称**：
- 中文：想拍
- 英文：snapwish

## 3. 非功能性需求

### 3.1. 性能要求

- **启动速度**：应用冷启动时间应在2秒以内
- **加载速度**：图库列表滑动流畅，图片加载不应出现明显卡顿
- **响应速度**：所有用户操作的响应时间应在200毫秒内
- **内存管理**：合理管理大图片内存，避免OOM
- **搜索响应**：搜索响应时间应在500毫秒内

### 3.2. 易用性要求

- **UI/UX设计**：界面设计简洁、直观，符合主流操作习惯
- **核心操作路径**：分享→选择→保存应尽可能简短
- **空状态处理**：各种空状态都有友好的提示和引导
- **首次使用**：暂不增加引导，后续版本优化

### 3.3. 平台要求

- **技术栈**：使用Flutter框架开发
- **目标平台**：Android和iOS
- **最低版本**：Android 7.0+，iOS 12.0+
- **设备适配**：当前版本暂不考虑特殊设备适配

### 3.4. 数据存储要求

- **图片文件**：保存在应用专属的内部存储目录
- **缩略图**：单独目录保存，按日期分类存储
- **元数据**：使用Hive数据库存储图片信息
- **缓存管理**：智能缓存清理，30天/500MB自动清理

### 3.5. 图片处理要求

- **原图保存**：保持原始图片质量
- **缩略图生成**：长边500px，WebP格式，85%质量，保持原始比例
- **异步处理**：图片处理在后台进行，不阻塞UI
- **内存优化**：大图片分块加载，避免内存溢出
- **大GIF处理**：提取前几帧作为缩略图，避免内存溢出

## 4. 界面设计规范

### 4.1. 视觉风格

- **设计风格**：Material Design
- **主题色彩**：支持动态主题色，提供5-6种预设主题色
- **图标风格**：Material Icons
- **圆角规范**：8dp统一圆角
- **深色模式**：保持一定对比度，不完全反转

### 4.2. 交互规范

- **手势操作**：单击、长按、滑动、双击、捏合
- **动画效果**：Material标准动画，页面转场300ms
- **反馈机制**：点击波纹效果、加载状态、操作结果提示
- **按钮反馈**：Material标准波纹效果

### 4.3. 加载状态设计

- **图片加载**：使用骨架屏，提供良好的加载体验
- **保存进度**：多张图片保存时显示进度提示
- **搜索加载**：超过1秒时显示loading状态
- **列表加载**：下拉刷新和上拉加载更多

### 4.4. 空状态设计

- **插画风格**：简洁线性插画
- **文案风格**：温暖友好，具有引导性
- **操作引导**：提供明确的下一步操作建议
- **具体文案**：
  - 首次使用："还没有灵感？去其他App分享图片到这里吧～"
  - 搜索结果为空："换个关键词试试？或者去收集更多灵感吧！"
  - 文件夹为空："这个文件夹还在等它的第一张灵感图片"

### 4.5. 错误处理

- **分享失败**："出了点小问题，请重新分享试试~"
- **保存失败**："出了点小问题，请重新分享试试~"
- **存储空间不足**："出了点小问题，请重新分享试试~"
- **网络错误**：当前版本暂不考虑网络相关功能

## 5. 数据模型规范

### 5.1. 核心实体

```dart
class InspirationImage {
  final String id;              // UUID
  final String filePath;        // 原图路径
  final String thumbnailPath;   // 缩略图路径
  final String? folderId;       // 文件夹ID
  final List<String> tags;      // 标签ID列表
  final String? note;           // 备注内容
  final DateTime createdAt;     // 创建时间（保存时间）
  final DateTime updatedAt;     // 更新时间
  final String? originalName;   // 原始文件名
  final int fileSize;           // 文件大小
  final String mimeType;        // MIME类型
  final int? width;             // 图片宽度
  final int? height;            // 图片高度
  final bool isFavorite;        // 是否收藏
}

class ImageFolder {
  final String id;              // UUID
  final String name;            // 文件夹名称
  final String? coverImageId;   // 封面图片ID
  final String icon;            // Material Icons名称
  final DateTime createdAt;     // 创建时间
  final DateTime updatedAt;     // 更新时间
  final DateTime lastUsedAt;    // 最近使用时间
}

class ImageTag {
  final String id;              // UUID
  final String name;            // 标签名称
  final String icon;            // Material Icons名称
  final String color;           // 十六进制颜色
  final int usageCount;         // 使用次数
  final DateTime lastUsedAt;    // 最近使用时间
}
```

### 5.2. 存储路径规范

```
应用专属目录/
├── images/           # 原图存储
│   └── yyyy/MM/dd/  # 按保存日期分类
├── thumbnails/      # 缩略图存储
│   └── yyyy/MM/dd/  # 对应原图日期
└── cache/           # 缓存目录
    └── temp/        # 临时文件
```

## 6. 开发计划

### 6.1. MVP版本开发周期（12-17天）

**Phase 1: 架构搭建（3-4天）**
- 项目结构搭建和配置
- 主题和国际化基础配置
- 数据模型设计和Hive配置
- 基础组件封装

**Phase 2: 分享功能（2-3天）**
- 分享接收功能实现
- 图片保存界面开发
- 文件存储和缩略图生成

**Phase 3: 图库展示（2-3天）**
- 主图库瀑布流界面
- 空状态页面设计
- 图片加载和缓存优化

**Phase 4: 管理功能（3-4天）**
- 文件夹管理功能
- 标签管理系统
- 图片详情页开发

**Phase 5: 搜索设置（2-3天）**
- 搜索功能实现
- 设置页面开发
- 性能优化和bug修复

### 6.2. 后续版本规划

**V1.1版本（短期）**
- 批量管理功能
- 数据备份与恢复
- 多种排序方式
- 视图切换（列表/网格）

**V2.0版本（中长期）**
- 云同步功能
- 智能标签推荐
- 图片来源追溯
- 主题色提取功能

## 7. 风险评估

### 7.1. 技术风险
- **大文件处理**：30MB GIF的内存管理需要特别注意，采用帧提取策略
- **分享兼容性**：不同Android厂商的分享实现可能存在差异
- **存储权限**：Android 13+的媒体权限变更需要适配

### 7.2. 用户体验风险
- **首次使用**：没有引导流程，需要空状态设计足够友好
- **性能感知**：大量图片时的流畅度需要重点优化

### 7.3. 缓解措施
- 实现异步图片处理，避免阻塞主线程
- 充分测试各种分享场景和设备兼容性
- 实现智能缓存和内存管理策略
- 采用虚拟滚动和图片懒加载技术

---

**文档状态**：已优化，技术细节已确认
**最后更新**：2025年9月12日
**确认人员**：产品负责人 + 技术负责人
**版本说明**：V1.1版本补充了所有UI/UX细节、技术规范和性能指标