产品文档 / 历史记录与验收范围以文中日期为准

压缩解压缩 iOS App 产品需求文档

文档版本：v1.0
状态：最终产品定义
目标平台：iPhone、iPad
产品形态：本地优先的压缩包创建、解压和文件管理工具

1. 产品定义

产品帮助用户在 iPhone 和 iPad 上可靠地打开、查看、创建、解压和分享压缩文件。产品围绕压缩包任务设计，与 iOS Files、系统分享面板、照片选择器和云端 File Provider 集成。

产品承诺：

1. 用户从任何 App 收到压缩包后，可以快速查看内容并保存到明确的位置。
2. 用户可以批量选择文件或文件夹创建压缩包，也可以只解压压缩包内需要的内容。
3. 文件处理默认在设备本地完成，不上传用户文件，不需要注册账号。
4. 常见 ZIP、RAR、7z 场景稳定可用，错误提示能够指导用户解决问题。
5. iPhone 和 iPad 都遵循原生文件管理习惯，支持深色模式、动态字体、VoiceOver、拖拽和键盘操作。

2. 背景与用户问题

Apple Files 已经支持基础 ZIP 创建和解压，但无法覆盖完整的 RAR、7z、加密压缩包和批量处理场景。现有第三方产品虽然格式多，但公开评论中重复出现以下问题：

• 广告遮挡解压按钮、弹窗频繁、出现不适宜内容。
• 多选、文件夹压缩、密码设置等基础能力被付费墙阻断。
• 文件被解压到 App 私有目录，用户找不到或无法保存回原来的云盘位置。
• 大文件、RAR、7z 解压失败，错误只显示“未知错误”。
• 购买后反复要求 Restore Purchase，试用和续费说明不清晰。
• iPad 横屏、分屏、键盘、拖拽支持不足。
• 综合工具加入 OCR、PDF、视频转换等功能后，导航复杂、核心任务不突出。

因此，本产品保持功能边界：只做压缩包和压缩包相关的文件交接，不扩展成文档编辑器、视频转换器、浏览器或云盘客户端。

3. 目标用户与场景

核心任务

任务 A：打开并解压收到的压缩包

分享面板 → 选择本 App → 查看目录 → 输入密码（如需要）→ 选择文件 → 选择目标位置 → 解压 → 打开或分享结果。

任务 B：压缩照片或文件夹

文件或照片选择 → 创建压缩包 → 输入名称 → 设置密码（可选）→ 生成 → 保存到 Files 或分享。

任务 C：处理云端压缩包

从 Files 选择云端文件 → 下载并显示进度 → 查看目录 → 选择性解压 → 保存回原 File Provider 或其他位置。

任务 D：处理失败任务

查看失败原因 → 重新输入密码、补齐分卷、释放空间或选择其他目标位置 → 重试，已完成的文件不重复处理。

4. 产品边界

必须包含

• 本地文件和 Files 文件提供商导入、导出。
• ZIP 创建和解压。
• RAR、7z、TAR、GZIP、BZ2、TGZ、ZIPX 等常见格式解压。
• 密码和 AES 加密压缩包的解压；ZIP AES 加密创建。
• 创建标准 7z 和 ZIP AES-256 加密归档；7z 密码创建需等待底层写入库支持，RAR5 加密归档读取能力依赖底层解码支持。
• ZIP 多卷输入（.z01/.zip、.zip.001）与常见 RAR 分卷（.partNN.rar / .r00）按卷组导入并解压。
• 以 ZIP 64 KiB 切片生成分卷归档，所有分卷可在 Files 中保存和分享。
• 文件夹和多文件批量选择。
• 选择性解压、批量任务、进度、暂停、取消、重试。
• 文件列表搜索、排序、预览、重命名、移动、复制、删除、分享。
• 图片、PDF、文本、常见音频和视频的只读预览。
• iPhone、iPad、深色模式、动态字体、VoiceOver、键盘和拖拽。
• 路径穿越、解压炸弹、空间不足、损坏文件等安全和异常处理。
• 本地隐私、无广告、无强制登录。

明确不包含

• OCR、PDF 编辑、电子签名。
• 视频剪辑、视频转码、音频编辑。
• 内置浏览器和下载器。
• 自建网盘、账号体系和服务端文件存储。
• 社交分享、协作评论。
• 不必要的“手机清理”“病毒扫描”等营销功能。

5. 功能需求

本表列出的需求全部属于首个正式版本的完整交付范围，不拆分为多个产品阶段。交付要求列统一标记为“本版”，以避免将完整能力误解为后续版本。

5.1 文件导入和来源

5.2 格式识别与查看

5.3 解压

5.4 创建压缩包

5.5 文件管理

5.6 任务中心

5.7 隐私和设置

6. 关键业务规则

1. 永远保留源压缩包，解压和重打包不会覆盖源文件。
2. 默认保留压缩包内目录结构，不默认把大量文件铺平到一个目录。
3. 对不安全路径进行规范化，拒绝写入目标目录以外的位置。
4. 解压前检查可用空间，至少预留预计输出大小加安全余量。
5. 单个文件失败不影响其他安全文件，但必须在结果页显示失败原因。
6. 密码错误不把密码写入日志、崩溃报告、通知或分析事件。
7. 云端文件未下载完成时不能开始解压；网络断开提供重试。
8. 用户取消任务后，已生成的完整文件可以保留，未完成临时文件必须清理。
9. 归档内同名文件按目录路径区分；输出时才执行冲突策略。
10. 压缩包扩展名与内容不一致时，以内容识别结果为准，并向用户说明。
11. ZipHarbor 创建的 ZIP 分卷使用 name.zip.001, name.zip.002 序列化切片；此方案保证本 App 可识别和组卷，但第三方工具兼容性需以用户所用工具为准。

7. 非功能需求

性能

• 本地 100 MB ZIP 在普通支持设备上 5 秒内显示目录。
• 100 张照片批量创建压缩包时界面保持可操作。
• 目录超过 10,000 条时使用虚拟列表，不出现明显滚动卡顿。
• 大任务使用流式读写，不能一次性把整个文件读入内存。

稳定性

• 有效 ZIP 样本解压成功率不低于 99%。
• 常见 RAR、7z 样本成功率不低于 98%。
• 任务取消、应用被系统挂起、磁盘空间不足后不损坏源文件。
• 不因畸形压缩包导致应用崩溃。

可访问性和国际化

• 支持 Dynamic Type、VoiceOver、Reduce Motion 和高对比度。
• 所有颜色状态都有文字或图标辅助，不只依赖颜色。
• 支持中英文，文件名和路径支持 Unicode、emoji、CJK 和 RTL 文本。

8. 验收指标

1. 新用户无需教程，在 60 秒内完成“打开 ZIP 并保存一个文件”。
2. 90% 的测试用户能在首次操作中找到输出文件。
3. 90% 的测试用户能完成“选择多张照片并生成 ZIP”。
4. 任务失败时，用户能从错误页判断下一步动作。
5. 测试数据中不发生 Zip Slip、越权写入或源文件覆盖。
6. 崩溃率低于 0.5%，任务级失败率持续监测并按格式分类。
7. 不采集文件名、路径、密码、文件内容或完整云盘结构。

9. 关键验收场景

10. 产品体验指标

• 首次成功率：新用户第一次打开或创建压缩包后成功完成任务的比例。
• 任务完成率：按格式和来源拆分的创建/解压成功任务比例。
• 找到文件率：任务完成后用户在一次操作内打开或定位输出文件的比例。
• 失败恢复率：用户根据失败提示重试后成功完成的比例。
• 重复使用率：使用最近记录、收藏、常用方案或快捷操作再次完成任务的比例。
• 信任指标：权限拒绝率、删除安装反馈和因广告/收费误导引起的差评应持续监测；产品不采集文件名或内容。

11. 研究依据

• iZip App Store
• Unzip App Store
• Zip & RAR File Extractor App Store
• Documents App Store
• WinZip App Store
• iTunes Search API
• Apple iPhone User Guide

下载 Markdown 文档