release: 1.0.0 docs + version bump

Author: Wenfeng-GAO

.gitignore

@@ -21,3 +21,6 @@ xcuserdata/
 *.ipa
 *.dSYM.zip
 *.dSYM
+
+# Local screenshots (generated for simulator demos)
+docs/screenshots/

README.md

@@ -4,22 +4,29 @@
 
 # ClipDock
 
-ClipDock is an iOS app that helps users move videos from iPhone Photos to external storage, then delete originals to free up device space.
+ClipDock is an iOS app that helps you copy selected videos from iPhone Photos to an external folder (Files), then optionally delete originals to free up device space.
 
 [![CI](https://github.com/Wenfeng-GAO/clipdock/actions/workflows/ci.yml/badge.svg)](https://github.com/Wenfeng-GAO/clipdock/actions/workflows/ci.yml)
 
-## Current docs
+## Docs (1.0)
 
-- Product doc: `docs/product.md`
-- Development doc: `docs/development.md`
-- Project plan (3-day sprint): `docs/project-plan.md`
+- Product doc: `docs/releases/1.0/product.md`
+- Development doc: `docs/releases/1.0/development.md`
+- App Store prep: `docs/app-store/app-store-connect.md`
 
-## Current implementation status
+## Key Features (1.0)
 
-- M0: Project scaffold completed.
-- M1: Photo permission flow completed.
-- M2: External folder picker + security-scoped bookmark completed.
-- M3 (minimal): Video scan sorted by date (desc) completed.
+- Choose an external destination folder (security-scoped bookmark).
+- Scan videos from Photos.
+- Sort by date or size (local-only, best-effort).
+- Select videos manually, Select All, or use Quick Filter (by year/month and/or Top-N by size).
+- Migrate (copy) selected videos to the destination folder.
+- After a successful migration run, optionally delete migrated originals (explicit confirmation).
+
+## Notes / Limitations
+
+- Video size is best-effort and local-only (iCloud-only items may show `--` until downloaded/exported).
+- Migration is most reliable when ClipDock stays in the foreground; background execution is limited by iOS.
 
 ## Local setup
 
@@ -44,6 +51,11 @@ sudo xcode-select -s /Applications/Xcode.app/Contents/Developer
 
 GitHub Actions runs `xcodegen generate` and `xcodebuild test` on PRs and `main`.
 
+## App Store Links
+
+- Privacy Policy: https://wenfeng-gao.github.io/clipdock/app-store/privacy-policy.html
+- Support: https://wenfeng-gao.github.io/clipdock/app-store/support.html
+
 ## License
 
 MIT. See `LICENSE`.

docs/releases/1.0/development.md

@@ -22,38 +22,27 @@
 3. 删除更克制：删除入口在迁移完成后出现，且仅在满足权限与校验条件时可用。
 
 ### 2.2 页面结构（单页）
-建议从现有 `List + 多 Section` 调整为“顶部状态卡 + 列表 + 底部操作区”的结构：
-
-1. 顶部状态卡（2 张卡片）
-   - 目录卡：已选目录、可写状态、`Choose` / `Recheck` 按钮
-   - 权限卡：相册权限状态、`Grant` 按钮
-2. 扫描与排序卡
-   - `Scan Videos` CTA
-   - 排序 `Date/Size`（保持 segmented）
-   - `Loading sizes...` 次级提示
-3. 选择卡
-   - 手动选择提示 + 统计（已选数量）
-   - 规则选择入口：
-     - `By Month...`（弹层 Month Picker）
-     - `Top N...`（弹层 N 输入 + 应用）
-   - `Show selected only`、`Select all`、`Clear`
-4. 列表（虚拟化）
-   - 仅负责展示与勾选，不承载迁移/删除按钮
-5. 底部操作区（sticky）
-   - Primary：`Start Migration`
-   - Secondary：`Delete Migrated Originals`（仅在迁移完成且 deletable>0 时可用）
-   - Progress：进度条 + 当前文件名（迁移中）
-   - 结果摘要：成功/失败数（迁移后）
-
-### 2.3 弹层 A：按月份选择（Month Picker）
-1. 数据来源：扫描完成后按 `creationDate` 生成 `YYYY-MM` 分组。
-2. 展示：月份列表（YYYY-MM）+ 视频数量；支持多选月份。
-3. 动作：`Apply` 将所选月份的全部视频加入选中集合；`Clear` 清空月份选择。
-
-### 2.4 弹层 B：最大 N（Top-N Picker）
-1. 输入：N（快捷按钮 20/50/100 + 自定义输入）。
-2. 规则：对“当前排序结果”取前 N（如果启用“仅看已选”，则对过滤后的列表取前 N）。
-3. 说明：当排序为 `Size` 时，未知 size 的视频排在底部，Top-N 默认只会命中已知 size 的条目。
+当前实现为“卡片式单页 + 底部操作区”：
+
+1. 目录卡
+   - 已选目录、可写状态、`Choose` / `Recheck`。
+2. 扫描与选择卡（Scan & Select）
+   - `Scan Videos` CTA（当授权状态为 `notDetermined` 时会触发系统弹窗；拒绝时给出提示）。
+   - 统计：视频数量、已选数量、已选总大小（best-effort）。
+   - 入口：`Select All` / `Quick Filter` / `Clear`、`Show selected only`。
+3. 列表卡（Video List）
+   - 列表顶部提供排序：字段 `Date/Size`（segmented）+ 正/倒序按钮。
+   - 列表行支持点选切换选择；size 异步补齐。
+4. 底部操作区（sticky）
+   - `Start Migration` / `Delete Originals`。
+   - 迁移中：进度条 + completed/total + 当前文件名。
+   - 迁移后：成功/失败摘要 + 失败列表入口。
+   - 状态策略：迁移完成且可删时，Start 置灰，Delete 变为强调态；删除后 Delete 置灰。
+
+### 2.3 弹层：快捷筛选（Quick Filter）
+1. 按月份：按“年份 -> 月份”分组展示（DisclosureGroup），并支持多选月份。
+2. Top-N：输入 N（20/50/100 快捷），基于本地可得 size 的 “largest first”。
+3. 动作：`Cancel / Apply`，且 `Apply` 仅在用户设置了筛选条件时可用。
 
 ## 3. 后端实现方式（MVVM + Services）
 
@@ -86,6 +75,7 @@
 ### 3.5 size 获取与 Top-N 边界
 1. size 读取使用 public API，且 `isNetworkAccessAllowed=false`，不会触发 iCloud 下载。
 2. Top-N 选择与大小排序不强制要求 size 全量完成；未知 size 统一视为“排序靠后”，并在 UI 里显示 `--`。
+3. 1.0 为了让“大小排序”更确定，扫描完成后会后台预取全库本地 size（best-effort）。
 
 ### 3.6 迁移与删除
 1. 迁移：保持“导出到临时目录 -> `NSFileCoordinator` 写入目标目录”，持有 security scope 覆盖整个迁移任务。
@@ -124,7 +114,7 @@
 ### 2026-02-13 - 规则选择（按月份 / Top-N）+ 去除 History 入口
 1. 交付：
    - 新增规则选择服务 `SelectionRulesService`（按月份分组 + Top-N 选择）。
-   - UI 增加 `By Month...` / `Top N...` 弹层入口。
+   - UI 增加 `By Month...` / `Top N...` 弹层入口（后续在 1.0 收敛为 `Quick Filter`）。
    - 移除 `History` 相关 UI 入口（按 1.0 形态要求）。
 2. 关键文件：
    - `/Users/wenfeng/Documents/iphoneapp/ClipDock/Services/Selection/SelectionRulesService.swift`
@@ -195,3 +185,31 @@
    - `/Users/wenfeng/Documents/iphoneapp/ClipDock/Resources/zh-Hans.lproj/Localizable.strings`
 3. 验证：
    - `xcodebuild test`（Simulator）：16 tests / 0 failure。
+
+### 2026-02-14 - 视觉收敛：移除 Home 大标题
+1. 交付：
+   - Home 页面移除导航标题 “ClipDock”，减少无效占位，保留右上角 `info` 入口。
+2. 关键文件：
+   - `/Users/wenfeng/Documents/iphoneapp/ClipDock/Features/Home/HomeView.swift`
+3. 验证：
+   - `xcodebuild test`（Simulator）：通过。
+
+### 2026-02-14 - 快捷筛选：月份按年份分组（可折叠）
+1. 交付：
+   - `Quick Filter` 的月份列表按 `Year -> Months` 分组展示，支持展开/收起，缓解月份列表过长问题。
+   - 新增单测覆盖长列表（6 年 * 12 月 + unknown）。
+2. 关键文件：
+   - `/Users/wenfeng/Documents/iphoneapp/ClipDock/Features/Home/RulePickers/MonthSummaryGrouper.swift`
+   - `/Users/wenfeng/Documents/iphoneapp/ClipDock/Features/Home/RulePickers/QuickFilterView.swift`
+   - `/Users/wenfeng/Documents/iphoneapp/ClipDockTests/MonthSummaryGrouperTests.swift`
+3. 验证：
+   - `xcodebuild test`（Simulator）：通过。
+
+### 2026-02-14 - 迁移操作条：完成后引导删除
+1. 交付：
+   - 迁移完成且存在可删条目时：`Start Migration` 置灰，`Delete Originals` 变为强调态（红色）。
+   - 删除完成并触发 rescan 后：`Delete Originals` 置灰。
+2. 关键文件：
+   - `/Users/wenfeng/Documents/iphoneapp/ClipDock/Features/Home/MigrationActionBar.swift`
+3. 验证：
+   - `xcodebuild test`（Simulator）：通过。

docs/releases/1.0/product.md

@@ -1,9 +1,11 @@
 # ClipDock 1.0 PRD（设计稿）
 
-更新时间：2026-02-13
+更新时间：2026-02-14
 
 本文基于已完成的 MVP，定义 1.0 版本“产品内容与形态”。1.0 目标：更清晰、更克制、更像一个可长期使用的工具 App；同时为 App Store 上架做准备（不引入高风险实现）。
 
+发布版本：`1.0.0`
+
 ## 1. 1.0 产品定位
 
 ClipDock 是一款离线工具，用于将 iPhone 相册中的视频复制到用户选择的目标目录（可为外接存储目录），并在用户确认后删除原视频以释放空间。
@@ -21,37 +23,39 @@ ClipDock 是一款离线工具，用于将 iPhone 相册中的视频复制到用
 4. 迁移策略：更稳（串行）。
 5. 视觉风格：干净克制。
 
-## 3. 1.0 核心用户流程（单页 + 两个轻弹层）
+## 3. 1.0 核心用户流程（单页 + 一个轻弹层）
 
 单页仍以“迁移主流程”为主，但做信息密度重排，减少当前长列表造成的认知负担。
 
 1. 选择外接目录
 2. 扫描视频
-3. 通过“规则选择”或“手动勾选”确定迁移集合
+3. 通过“快捷筛选 / 全选 / 手动勾选”确定迁移集合
 4. 开始迁移（串行）
 5. 展示结果（成功/失败 + 失败原因列表）
 6. 可选删除原视频（仅成功且校验通过的条目）
 
-弹层 A：按月份选择（Month Picker）
-1. 列出可用月份（YYYY-MM），显示每个月的视频数量（以及可选：已知大小合计）
-2. 支持：选择某个月 -> 一键选中该月所有视频
-3. 支持：多月叠加选择
-
-弹层 B：最大 N 选择（Top-N Picker）
-1. 输入 N（默认 20，可快速 20/50/100）
-2. 选择策略（1.0 先固定为）：按“大小从大到小”取 Top N
-3. 对 size 未知项的处理（1.0 规则）：
-   - 未知 size 的视频不参与 Top-N 计算（避免误选），但用户仍可手动勾选
+弹层：快捷筛选（Quick Filter）
+1. 按月份筛选：
+   - 按“年份 -> 月份”分组展示，减少月份列表过长导致的滚动成本。
+   - 多月可叠加。
+2. Top-N 筛选：
+   - 输入 N（默认 20，可快速 20/50/100）。
+   - 固定策略：按“大小从大到小”取 Top N（基于本地可得 size）。
+3. 按钮与状态：
+   - `Cancel / Apply`；仅当用户设置了筛选条件时 `Apply` 才可用。
+4. 对 size 未知项的处理：
+   - 未知 size 的视频不参与 Top-N 计算（避免误选），但用户仍可手动勾选。
 
 ## 4. 1.0 功能范围（Must/Should）
 
 ### 4.1 Must（1.0 必须交付）
 1. UI 重排为“单流程面板”
    - 顶部：目录状态 + 可写状态
-   - 中部：扫描与排序（日期/大小）
-   - 中部：规则选择入口（按月份、最大 N）
+   - 中部：扫描与选择（含“已选数量/已选大小”统计）
+   - 中部：快捷筛选入口（按月份/Top-N）
+   - 列表：排序（日期/大小 + 正序/倒序）
    - 底部：迁移与进度、删除入口、结果摘要
-2. 批量选择规则（按月份、最大 N）
+2. 批量选择规则（快捷筛选：按月份、最大 N）
 3. 稳定迁移（串行 + 可重试失败项）
 4. 删除安全闸门（保持 MVP 的安全约束）
 5. i18n（已做）：中英跟随系统
@@ -93,3 +97,9 @@ ClipDock 是一款离线工具，用于将 iPhone 相册中的视频复制到用
 2. size 为 best-effort：iCloud-only 资产可能显示 `--`，Top-N 不包含未知 size 项，避免误选。
 3. 串行优先：吞吐更低，但稳定性更好，也更符合“清理工具”的风险偏好。
 
+## 8. 1.0 现状总结（已完成）
+
+1. 单页流程：外接目录 -> 扫描 -> 选择/快捷筛选 -> 迁移 -> 结果 -> 删除。
+2. 快捷筛选：按年份分组的月份筛选 + Top-N（按本地 size）。
+3. 选择统计：展示“已选总大小”（best-effort），并提示已知大小数量。
+4. 操作引导：迁移完成后 `Start Migration` 变暗，`Delete Originals` 变亮；删除后恢复为不可用。

project.yml

@@ -6,8 +6,8 @@ options:
 settings:
   base:
     SWIFT_VERSION: 5.0
-    CURRENT_PROJECT_VERSION: 8
-    MARKETING_VERSION: 0.2.6
+    CURRENT_PROJECT_VERSION: 9
+    MARKETING_VERSION: 1.0.0
     CODE_SIGN_STYLE: Automatic
 configs:
   Debug: debug