# Keen PDF PRD v1.0.3

> 更新日期：2026-08-13

## 1. 产品基本信息

| 项目 | 内容 |
|---|---|
| 产品名称 | Keen PDF |
| 平台 | Android |
| 版本号 | `v1.0.3` |
| 更新日期 | 2026-08-13 |
| 需求外链 | https://keen-pdf-docs.pages.dev/ |
| 蓝湖外链 |  |

## 2. 版本目标

优化启动、通知与全局交互体验，补齐设备文档管理、PDF 创建结果报告和桌面快捷入口，并完善广告控制。

## 3. 本次范围及具体需求

### 3.1 本次范围

| 需求编号 | 需求项 | 简要说明 |
|---|---|---|
| R1 | 启动页进度条 | 在现有启动页增加无百分比进度条 |
| R2 | 通知权限展示位置控制 | 根据中台 `startup` / `home` 配置决定通知权限申请位置 |
| R3 | 首次语言选择与语言入口 | 首次安装增加语言选择页；Home 与 Settings 提供后续入口；语言变更后冷启动 |
| R4 | 全局顶部栏修正 | 所有 App 自有页面顶部栏固定、正确适配系统安全区并删除副标题 |
| R5 | Home 内容调整 | 增加国旗入口，删除创建来源标题，Recent 最多展示 5 个真实 / 示例 PDF |
| R6 | My Files 一级功能 | 以 My Files 替换 Recent，读取并分类设备常用文档 |
| R7 | 文件权限引导与状态 | 首次进入 My Files 引导所有文件访问权限，并覆盖未授权、空、失败和搜索无结果状态 |
| R8 | 文件操作 | 支持真实文档打开、重命名、永久删除和系统分享 |
| R9 | 扫描拍摄页数量角标 | 左下角缩略图增加数字角标，并与顶部已拍页数实时同步 |
| R10 | 共用页面管理交互 | 页面管理改为双列缩略图、长按拖拽排序和点击进入底部操作面板 |
| R11 | Recent 二级页面 | 从 Home 查看全部最近文件，只展示 Keen PDF 生成或处理过的 PDF |
| R12 | 桌面小组件 | 增加大、中、小三种纯快捷入口样式，并支持快速添加到桌面 |
| R13 | 广告控制完善 | 广告点位拆分，广告相关控制查漏补缺 |
| R14 | 创建成功报告页 | PDF 生成后进入带成功插画的结果报告页，区分单文件与多文件结果 |
| R15 | 主要功能按钮动效 | 主要功能按钮增加扫光动效 |
| R16 | FCM 定时通知 | 每天按用户设备本地时间在 4 个固定时段发送功能通知 |
| R17 | 常驻通知卡片 | 增加带 4 个快捷入口和 1 个通栏创建按钮的卡片式常驻通知 |

**本版不做**

- 不新增 PDF 压缩、Office / TXT 转 PDF、App 内 Office / TXT 预览、PDF 编辑、签名、水印、加密、AI、账号、云同步或订阅。
- My Files 不扫描或展示图片、视频、音频、压缩包、安装包及其他未列入 R6 的文件类型；图片转 PDF 和 OCR 相册仍可通过系统照片选择器读取用户主动选择的图片。
- 不做批量重命名、批量删除、批量分享、移动文件或新建文件夹。

### 3.2 具体需求说明

#### R1：启动页进度条

| 字段 | 说明 |
|---|---|
| 入口 / 触发条件 | App 冷启动和现有 Warm Start 启动流程。 |
| 展示 | 保留现有品牌视觉，在启动页增加无百分比进度条；样式、位置和尺寸由新版 UI 确定。 |
| 用户交互 / 跳转 | 不要求用户操作；初始化完成后按 R2、R3 的顺序进入后续页面。 |
| 关键状态 / 异常 | 进度条不得冒充真实百分比；中台请求失败或超时不得卡死启动页，按降级规则继续进入 App。 |
| 数据 / 权限 / 商业化边界 | 启动页不新增广告；通知权限仅在 R2 配置为 `startup` 时于该页面申请。 |
| 关键用户文案 | 不涉及。 |
| 关联验收标准 | A1。 |

#### R2：通知权限展示位置控制

| 字段 | 说明 |
|---|---|
| 入口 / 触发条件 | Android 13 及以上、通知权限尚未授予且满足再次申请条件时，读取中台下发的位置配置。有效值只有 `startup` 与 `home`。 |
| 展示 | `startup`：在启动页申请；`home`：进入 Home 后申请。中台不配置 `none`。 |
| 用户交互 / 跳转 | 用户允许后结束权限流程；拒绝后当天不再申请。隔天再次进入 App 时读取中台最新配置，并在对应位置重新发起申请。 |
| 关键状态 / 异常 | 同一设备本地自然日最多发起一次；中台字段缺失、请求失败、超时或值非法时，本次不申请并正常进入 App。系统拒绝再次展示权限弹窗时不得伪装成功或强制跳系统设置。 |
| 数据 / 权限 / 商业化边界 | Android 12 及以下不执行运行时通知权限申请；拒绝通知权限不影响扫描、OCR、PDF 或 My Files。仅保存控制每日申请所需的最小本地状态。 |
| 关键用户文案 | 使用 Android 系统通知权限文案，不自定义仿系统弹窗。 |
| 关联验收标准 | A2。 |

#### R3：首次语言选择与语言入口

| 字段 | 说明 |
|---|---|
| 入口 / 触发条件 | 首次安装：启动页结束后展示一次语言选择页；后续从 Home 右上角国旗或 Settings → `App Language（应用语言）` 进入。 |
| 展示 | 展示现有 16 种界面语言和 `System Default（跟随系统）`；每种语言展示对应国旗；首次安装默认选中 English（英语）；页面底部展示原生广告。Home 国旗显示当前实际生效语言的国旗，选择跟随系统时也显示解析后的实际语言国旗。 |
| 用户交互 / 跳转 | 首次安装点击确认后，先保存首次选择完成状态和语言设置；无论是否保留默认英语，均重启 App 并走完整冷启动流程，重启后不再重复进入首次语言页。后续从 Home 或 Settings 进入时，仅在语言实际发生变化后重启并走冷启动；未发生变化时直接返回。 |
| 跟随系统 | 系统语言在支持的 16 种语言内时使用对应语言，否则使用英语兜底；后续系统语言变化时继续跟随。 |
| 关键状态 / 异常 | 语言资源加载失败时使用英语；原生广告未填充、失败或超时时不得阻塞选择、确认或进入 App；语言重启不得导致同一自然日重复申请通知权限。 |
| 数据 / 权限 / 商业化边界 | 语言设置和首次完成状态仅保存在本地；原生广告须与语言项、确认操作和系统内容明确区隔。 |
| 关键用户文案 | `Choose your language（选择你的语言）`；`System Default（跟随系统）`。其余普通文案由 UI 与本地化资源承接。 |
| 关联验收标准 | A3、A4。 |

#### R4：全局顶部栏修正

| 字段 | 说明 |
|---|---|
| 入口 / 触发条件 | 所有 App 自有页面，包括一级页面、普通二级页面、扫描相机、裁边、OCR、PDF 预览及其他工具页面。 |
| 展示 | 顶部栏固定在系统状态栏下方并贴紧可用顶部，正确适配状态栏、刘海和挖孔安全区；所有页面保持统一的视觉高度和对齐关系，具体高度由新版 UI 和设备适配确定。 |
| 用户交互 / 跳转 | 顶部栏不随页面内容滚动；工具页保留返回、关闭、闪光灯、编辑等必要操作。 |
| 关键状态 / 异常 | 页面内容必须从顶部栏下方开始，不得覆盖、穿透或遮挡标题和操作；删除依赖负边距向上顶起内容的布局方式。 |
| 数据 / 权限 / 商业化边界 | 不涉及。 |
| 关键用户文案 | 删除所有页面主标题下方的说明性副标题，只保留页面主标题和必要操作文案。 |
| 关联验收标准 | A5。 |

#### R5：Home 内容调整

| 字段 | 说明 |
|---|---|
| 入口 / 触发条件 | Home（首页）。 |
| 展示 | 右上角增加当前生效语言的国旗入口；删除 `Create From（创建来源）` 标题；文件区标题统一为 `Recent（最近）`，不再使用 `Explore a sample（查看示例）`。 |
| 文件规则 | Home 文件区最多展示 5 个文件。真实最近 PDF 优先并按最近处理时间倒序；剩余位置由 3 个内置示例 PDF 补足。真实文件增加时，示例按顺序被挤出 Home，但继续在 My Files 展示。 |
| 示例规则 | 3 个示例均为由多张内置图片生成内容构成的只读多页 PDF，内容主题互不重复；示例不进入真实设备文档索引，不伪装成用户文件。用户可在 My Files 永久删除示例；删除后 Home 与 My Files 均不再展示，App 更新不恢复，卸载重装按新用户重新生成。 |
| 用户交互 / 跳转 | 点击国旗进入 R3 语言选择页；点击真实 PDF 或示例进入对应 PDF 预览；点击 `See all（查看全部）` 进入 R11 Recent 二级页面。 |
| 关键状态 / 异常 | 示例打开失败时提示失败，不生成损坏文件；已删除示例不得因列表刷新、进程重启或 App 更新重新出现。 |
| 数据 / 权限 / 商业化边界 | 示例删除状态保存在本地；Home 不因 My Files 未授权而申请所有文件权限。 |
| 关键用户文案 | `Recent（最近）`；示例保留明确的 `Sample（示例）` 标识。 |
| 关联验收标准 | A6。 |

#### R6：My Files 一级功能

| 字段 | 说明 |
|---|---|
| 入口 / 触发条件 | 底部导航以 `My Files（我的文件）` 替换原 `Recent（最近）`，底部继续保持 Home、Tools、My Files、Settings 四个一级入口。 |
| 展示 | 分类固定为 `All（全部）`、`PDF`、`Word`、`Excel`、`PPT`、`TXT`；支持文件名搜索；所有分类固定按文件最近修改时间倒序。3 个示例与真实文件使用同一时间倒序规则，不单独置顶；示例使用固定内置时间，刷新或启动不更新时间，3 个示例之间保持固定时间顺序。每个文件展示类型图标、文件名、文件大小、最近修改时间和更多操作入口，不展示父级目录或完整文件路径。底层读取常见新旧扩展名：PDF `.pdf`；Word `.doc/.docx`；Excel `.xls/.xlsx`；PPT `.ppt/.pptx`；TXT `.txt`。 |
| 用户交互 / 跳转 | 点击 PDF 使用 Keen PDF 现有预览能力打开；点击 Word、Excel、PPT 或 TXT 调用 Android 系统兼容 App 打开。设备不存在兼容 App 时提示无法打开。页面提供手动刷新入口；刷新时保留当前列表并显示轻量加载，不先清空整页内容。 |
| 关键状态 / 异常 | 文件已不存在、无权读取或系统打开失败时显示明确提示并刷新列表；搜索仅匹配当前可读取文件名。每次进入 My Files、从系统授权页返回和 App 从后台恢复时重新检查权限；权限被系统关闭后立即清除当前真实文件列表并进入未授权状态，不允许通过旧缓存继续打开、重命名、分享或删除。 |
| 数据 / 权限 / 商业化边界 | 只在设备本地读取和管理文件，不上传文件名、路径、内容或文档数据；不读取范围外文件类型。 |
| 关键用户文案 | `My Files（我的文件）`；分类文案按上表展示。 |
| 关联验收标准 | A7。 |

#### R7：文件权限引导与状态

| 字段 | 说明 |
|---|---|
| 入口 / 触发条件 | 用户首次进入 My Files 且尚未获得所需文件访问权限时。 |
| 展示 | 先展示用途说明弹窗；用户点击继续后进入对应系统授权页。拒绝或取消后进入未授权状态，不在启动流程申请文件权限。 |
| 用户交互 / 跳转 | 弹窗主按钮 `Continue（继续）` 进入系统授权；次按钮 `Not now（暂不）` 关闭并展示未授权状态。未授权状态提供 `Allow access（允许访问）`，仅在用户主动点击时再次进入系统授权页。权限在系统设置中被关闭时同样立即回到该未授权状态。 |
| 权限引导文案 | 标题：`Allow file access（允许文件访问）`；说明：`Allow access to find and manage documents on your device.（允许访问，以查找和管理设备中的文档。）`。 |
| 状态 | 首次读取：`Scanning documents…（正在扫描文档……）`；未授权：`File access is required.（需要文件访问权限。）` + Allow access；已授权无文件：`No documents found（未找到文档）`；加载失败：`Couldn’t load files（无法加载文件）` + `Try again（重试）`；搜索无结果：列表内显示 `No matching files（没有匹配的文件）`。 |
| 关键状态 / 异常 | 从系统授权页返回时必须重新检查真实权限状态，不能根据已跳转判断授权成功；拒绝后不自动循环弹用途说明或系统授权。不同 Android 版本使用对应系统授权能力。 |
| 数据 / 权限 / 商业化边界 | Android 11 及以上使用所有文件访问能力；旧系统按平台能力申请读取常用文档所需权限。未授权不影响其他功能。 |
| 关联验收标准 | A8。 |

#### R8：文件操作

| 字段 | 说明 |
|---|---|
| 入口 / 触发条件 | My Files、Recent 中的真实文件操作菜单，以及创建成功报告页中的结果文件操作入口。 |
| 打开 | My Files 与 Recent 按各自页面规则打开文件；创建成功报告页点击 PDF 缩略图或 `Open（打开）`进入 App 内 PDF 预览。 |
| 重命名 | 用户只编辑主文件名，扩展名固定保留且不可编辑；空名称、非法字符和重名均不能保存；不覆盖已有文件。重命名成功后更新文件修改时间，并按时间倒序重新排列到所属列表；Keen PDF 生成或处理过的 PDF 同步刷新 Home、Recent 与 My Files，其他文档仅刷新 My Files；不复制或新增第二份文件。 |
| 分享 | My Files、Recent 和创建成功报告页均调用 Android 系统分享面板分享单个文件；取消分享不视为失败。 |
| 删除 | 仅 My Files 和 Recent 提供删除，创建成功报告页不提供删除。删除真实文件前必须二次确认；确认为永久删除且不可恢复。成功后立即从其所属列表移除；Keen PDF 生成或处理过的 PDF 同步刷新 Home、Recent 与 My Files，其他文档仅刷新 My Files。示例文件删除遵守 R5 的永久隐藏规则。 |
| 关键用户文案 | 删除确认必须带真实文件名：`Delete “{file name}” permanently? This action cannot be undone.（永久删除“{文件名}”？此操作无法撤销。）` |
| 关键状态 / 异常 | 权限不足、文件不存在、被占用或操作失败时不得显示成功；保留文件并刷新当前状态。 |
| 数据 / 权限 / 商业化边界 | 所有操作仅针对用户明确选择的单个文件；不上传或备份文件。 |
| 关联验收标准 | A9。 |

#### R9：扫描拍摄页数量角标

| 字段 | 说明 |
|---|---|
| 入口 / 触发条件 | Scan Camera（扫描拍摄页）存在已成功拍摄并保存的页面时。 |
| 展示 | 左下角当前页面缩略图右上角增加数字角标，显示当前已拍页面总数；角标与顶部标题中的页面数量使用同一实际页数并实时同步。角标采用红底白字；1–99 显示实际数字，超过 99 页显示 `99+`；0 页时不显示角标。 |
| 用户交互 / 跳转 | 角标不新增独立点击行为，继续沿用缩略图原有入口。 |
| 关键状态 / 异常 | 每次拍摄成功保存后，两处数量同时增加；删除页面后同时减少；重拍替换单页时总数不变；返回恢复未完成任务时按实际页面数恢复。拍摄失败、保存失败或尚未成功写入任务时不得增加数量。 |
| 数据 / 权限 / 商业化边界 | 仅使用当前扫描任务的本地页面数量，不新增权限、网络请求或广告。 |
| 关键用户文案 | 角标仅显示数字或 `99+`，不新增文字文案。 |
| 关联验收标准 | A10。 |

#### R10：共用页面管理交互

| 字段 | 说明 |
|---|---|
| 入口 / 触发条件 | 扫描生成 PDF、图片转 PDF、OCR 拍照识别和 OCR 相册识别进入 Page Manager（页面管理）时。PDF 合并与 PDF 拆分不使用本交互。 |
| 展示 | 页面缩略图采用双列网格，一行 2 张，按从左到右、从上到下排列；最后一行只有 1 张时仍保持单列卡片宽度，不拉伸整行。每张缩略图左上角显示连续页码序号，右下角显示小编辑图标；卡片表面不再展示上移、下移、重拍、裁剪、旋转和删除按钮。 |
| 拖拽排序 | 长按任意缩略图进入拖拽排序；拖动经过其他页面时，其余页面实时让位；松手后立即保存新顺序并连续更新所有页码。最终生成 PDF 或执行 OCR 时，严格使用当前网格顺序。删除现有上移、下移排序入口。 |
| 点击编辑 | 普通点击缩略图任意位置或右下角编辑图标，打开该页面的 Bottom Sheet（底部操作面板）；编辑图标仅作为入口提示，不提供不同于点击缩略图的独立行为。拖拽状态下隐藏或弱化编辑图标。 |
| 操作面板 | 扫描生成 PDF 和 OCR 拍照识别显示 `Retake（重拍）`、`Crop（裁剪）`、`Rotate（旋转）`、`Delete（删除）`；图片转 PDF 和 OCR 相册识别不显示重拍，仅显示裁剪、旋转、删除。删除前继续二次确认。 |
| 新增页面 | 保留顶部 `+`：扫描生成 PDF 和 OCR 拍照识别点击后进入相机继续拍摄；图片转 PDF 和 OCR 相册识别点击后打开相册继续选择。新增成功的页面默认追加到列表末尾，用户可再拖拽排序；拍摄或导入失败时不新增空卡片，也不改变原有顺序。 |
| 关键状态 / 异常 | 裁剪、旋转或重拍完成后返回页面管理并刷新对应缩略图；删除后重新连续编号，删除最后一页时沿用现有空任务退出规则。长按拖拽与普通点击不得互相误触；进程重建或返回未完成任务后保持最新页面顺序。 |
| 数据 / 权限 / 商业化边界 | 仅调整现有本地页面管理交互，不新增权限、网络请求、广告或功能范围。 |
| 关键用户文案 | `Retake（重拍）`、`Crop（裁剪）`、`Rotate（旋转）`、`Delete（删除）`；页码序号直接显示数字。 |
| 关联验收标准 | A11。 |

#### R11：Recent 二级页面

| 字段 | 说明 |
|---|---|
| 入口 / 触发条件 | Home → `Recent（最近）` → `See all（查看全部）`。Recent 不再作为底部一级 Tab。 |
| 展示 | 只展示 Keen PDF 生成或处理过的真实 PDF，不展示设备全盘 PDF、Word、Excel、PPT、TXT 或内置示例。默认按最近处理时间倒序；每项展示 PDF 图标、文件名、文件大小、最近处理时间和更多操作入口。 |
| 用户交互 / 跳转 | 点击文件进入 Keen PDF PDF 预览；更多操作支持重命名、永久删除和系统分享，规则复用 R8。从 PDF 预览返回时回到 Recent 并保留原滚动位置；从 Recent 顶部返回时回到 Home。 |
| 关键状态 / 异常 | 无记录时展示 Recent 空状态；文件已不存在或操作失败时显示明确提示并刷新列表。Home 与 Recent 使用同一份 Keen PDF 文件数据，重命名、删除或新结果生成后两处同步刷新。 |
| 数据 / 权限 / 商业化边界 | 不扫描设备全盘；从 My Files 打开外部 PDF 不自动加入 Home 或 Recent。只有通过 Keen PDF 生成、合并、拆分或完成其他处理后的结果进入 Recent。 |
| 关键用户文案 | `Recent（最近）`；普通空状态文案由 UI 与本地化资源承接。 |
| 关联验收标准 | A12。 |

#### R12：桌面小组件

| 字段 | 说明 |
|---|---|
| 入口 / 触发条件 | Tools 增加 `Widgets（桌面小组件）`功能卡，Settings 增加 `Widgets（桌面小组件）`列表项；两个入口进入同一个 Widgets 二级页面。同时支持 Android 系统桌面的小组件添加入口。 |
| 展示 | 提供大、中、小三种响应式样式，全部只展示功能快捷入口，不展示最近文件、生成记录或处理过的 PDF。小号展示 1 个快捷入口，默认为扫描；中号展示扫描、图片转 PDF、OCR 3 个快捷入口；大号展示扫描、图片转 PDF、OCR 拍照、OCR 相册、合并 PDF、拆分 PDF 6 个快捷入口。具体尺寸随系统桌面和启动器适配，不固定像素或桌面格数。 |
| 用户交互 / 跳转 | Widgets 二级页面分别展示大、中、小三种样式及各自的 `Add（添加）`按钮；点击任一快捷入口直接打开 App 对应功能；点击 Add 后调用 Android 系统的小组件固定流程，由用户在系统确认框中确认添加。已添加过的小组件仍允许再次添加。 |
| 关键状态 / 异常 | 系统桌面不支持快速固定时，引导用户通过桌面的小组件列表手动添加；添加取消或失败不影响 App 使用。快捷入口对应功能不可用时，进入 App 后显示该功能原有异常状态，不停留在空白页面。 |
| 数据 / 权限 / 商业化边界 | 小组件不读取或展示文件列表、文件名、缩略图及 PDF 内容；不新增文件权限；小组件本身不展示广告。 |
| 关键用户文案 | `Add（添加）`；系统不支持快速固定时显示简短的手动添加引导。 |
| 关联验收标准 | A13。 |

#### R13：广告控制完善

| 字段 | 说明 |
|---|---|
| 需求说明 | 广告点位拆分，广告相关控制查漏补缺。 |
| 关联验收标准 | A14。 |

#### R14：创建成功报告页

| 字段 | 说明 |
|---|---|
| 入口 / 触发条件 | 扫描生成 PDF、图片转 PDF、PDF 合并、PDF 拆分中的提取页面或全部拆分成功并保存结果后进入。OCR、打开已有 PDF 和打开示例 PDF 不进入本页面。 |
| 展示 | 报告页展示创建成功插画和成功状态，不直接展开 PDF。扫描生成 PDF、图片转 PDF、PDF 合并和提取页面使用单文件形态，展示 PDF 缩略图、文件名、页数和文件大小；全部拆分使用多文件形态，展示已生成文件数量和结果文件列表。 |
| 用户交互 / 跳转 | 单文件形态提供 `Share（分享）`、`Rename（重命名）`、`Create（继续创建）`、`Open（打开）`、`Home（返回首页）`；点击缩略图或 Open 进入 App 内 PDF 预览。多文件形态点击单个文件进入预览，并支持单文件重命名和分享。点击 Create 时结束并清空当前任务，再重新进入刚才使用的同一功能；全部拆分的 Create 重新进入 PDF 拆分。点击 Home 或按系统返回键时结束当前任务并返回 Home，不退回页面管理。已生成并保存的 PDF 始终保留，不因结束任务或继续创建而删除。 |
| 关键状态 / 异常 | 生成或保存失败时不进入报告页，保留当前可恢复内容并支持重试；分享取消不视为失败；重命名失败时保留原文件名；结果文件已不存在或无法读取时显示明确提示并刷新页面，不展示虚假成功状态。 |
| 数据 / 权限 / 商业化边界 | 报告页仅使用本次真实生成并保存的本地 PDF 数据；不上传文件名、缩略图或 PDF 内容。文件操作规则复用 R8。 |
| 关键用户文案 | `Share（分享）`、`Rename（重命名）`、`Create（继续创建）`、`Open（打开）`、`Home（返回首页）`；成功标题与普通辅助文案由 UI 和本地化资源承接。 |
| 关联验收标准 | A15。 |

#### R15：主要功能按钮动效

主要功能按钮增加扫光动效。

#### R16：FCM 定时通知

| 字段 | 说明 |
|---|---|
| 入口 / 触发条件 | 每天按用户设备本地时间发送 4 条 FCM 通知。 |
| 发送时间与落点 | `09:00`：点击进入扫描拍摄页；`12:30`：点击进入图片转 PDF；`18:00`：点击进入 OCR 文字识别；`21:00`：点击进入 My Files。App 未启动时先完成冷启动，再进入对应功能。 |
| 09:00 文案 | 标题：`📄 Paperwork Piling Up? Scan It Now!（纸质文件越堆越多？现在就扫描！）`；正文：`Your pocket scanner turns paper into a crisp PDF in seconds.（随身扫描工具，几秒即可将纸张变成清晰 PDF。）` |
| 12:30 文案 | 标题：`🔥 Turn Photos Into One Perfect PDF（将多张图片整理成一份完整 PDF）`；正文：`Combine today’s images into a clean file that’s ready to send.（把今天的图片合成一份整洁、随时可发送的文件。）` |
| 18:00 文案 | 标题：`🪄 Copy Text Without Typing a Word（不用打一个字，也能复制文字）`；正文：`Snap a photo and let OCR pull out the text for you.（拍张照片，让 OCR 帮你提取其中的文字。）` |
| 21:00 文案 | 标题：`🔍 Stop Digging for Documents（别再到处翻找文档）`；正文：`Find, open, rename, and share your files from one place.（在一个地方查找、打开、重命名和分享文件。）` |
| 数据 / 权限 / 商业化边界 | 通知权限申请位置与再次申请规则沿用 R2。 |
| 关联验收标准 | A17。 |

#### R17：常驻通知卡片

常驻通知采用卡片形式，不展示标题和简短说明。卡片中间一行依次放置 `Scan（扫描）`、`OCR（文字识别）`、`Files（文件）`、`Widget（小组件）`4 个小入口；下方放置通栏按钮 `Create Now（立即创建）`。Scan 进入扫描拍摄页，OCR 进入 OCR 来源选择，Files 进入 My Files，Widget 进入 Widgets 二级页面，Create Now 进入 Home 创建功能区。

关联验收标准：A18。

## 4. 验收标准

| 序号 | 关联需求 | 验收项 | 验收标准 |
|---:|---|---|---|
| A1 | R1 | 启动页进度条 | 冷启动和现有 Warm Start 均展示无百分比进度条；初始化或中台请求异常不造成无限停留。 |
| A2 | R2 | 通知权限位置与频次 | Android 13+ 未授权设备分别验证 `startup`、`home`；权限在配置页面触发，同一自然日最多一次，拒绝后隔天按最新配置重试；字段异常或网络失败时本次不申请；Android 12及以下不执行。 |
| A3 | R3 | 首次语言选择 | 全新安装后仅首次展示语言页，English 默认选中；16 种语言及 System Default 均可选择，国旗与实际生效语言一致；首次确认无论是否保留默认英语均重启并走冷启动，且不循环进入首次语言页。 |
| A4 | R3 | 后续语言重启与广告降级 | 后续从 Home 或 Settings 进入语言页时，只有语言实际发生变化才保存设置、重启并走冷启动，未变化时直接返回；原生广告未填充、失败或超时时不阻塞操作。 |
| A5 | R4 | 全局顶部栏 | 所有 App 自有页面的顶部栏位于系统安全区下方、固定且不随内容滚动；标题和操作无遮挡；所有说明性副标题已删除；无负边距造成的顶部错位。 |
| A6 | R5 | Home 与示例 | Home 无 `Create From` 和 `Explore a sample`；显示国旗入口与 `Recent`；文件区最多 5 条，真实 PDF 优先，最多 3 个多图生成的只读多页示例补位；被挤出示例可在 My Files 查看；示例永久删除后重启和更新均不恢复。 |
| A7 | R6 | My Files 分类与打开 | 底部以 My Files 替换 Recent；五类常用文档均进入正确分类，文件项完整展示类型、名称、大小和修改时间且不展示路径；真实文件与示例按修改时间统一倒序，示例不单独置顶且刷新不改变固定时间；搜索和手动刷新正确；刷新不先清空现有列表；PDF 可预览，其他文档可调用兼容 App，缺少兼容 App 时有明确提示。 |
| A8 | R7 | 权限与状态 | 首次进入先显示确认弹窗，继续后进入真实系统授权；返回后按实际权限展示列表或未授权状态；扫描中、未授权、无文件、加载失败和搜索无结果五类状态互不混淆；在系统设置关闭权限后，进入页面或从后台恢复时立即清除真实文件列表并禁止旧缓存操作；拒绝不影响其他功能。 |
| A9 | R8 | 文件操作 | My Files、Recent 和创建成功报告页均按规则打开、重命名和分享文件；创建成功报告页不提供删除，My Files 与 Recent 删除前展示带真实文件名的永久删除确认。对五类真实文档分别验证保留扩展名、重名/非法名称拦截、重命名后修改时间更新并按时间倒序前移、分享取消及操作失败；重命名不产生第二份文件，失败不得修改或丢失原文件。 |
| A10 | R9 | 扫描数量角标 | 0 页时不显示角标；成功拍摄、连续多页、删除、重拍、失败和任务恢复后，缩略图角标与顶部数量始终一致；1–99 显示实际数字，超过 99 页显示 `99+`。 |
| A11 | R10 | 共用页面管理 | 分别从扫描生成 PDF、图片转 PDF、OCR 拍照和 OCR 相册进入页面管理：均为双列网格，页码连续，点击缩略图或编辑图标打开正确操作面板，长按可拖拽且实时让位，松手后顺序持久保存；相机来源显示重拍并由顶部 `+` 继续拍摄，相册来源不显示重拍并由顶部 `+` 继续选择图片；新增页面追加末尾，失败不产生空卡片或改变原顺序；裁剪、旋转、重拍、删除后缩略图和序号正确，最终 PDF / OCR 顺序与网格一致。PDF 合并和拆分交互不受影响。 |
| A12 | R11 | Recent 二级页面 | Home 的 See all 进入 Recent 二级页面；页面仅显示 Keen PDF 生成或处理过的真实 PDF，并按最近处理时间倒序，不显示全盘文档或示例；打开、重命名、永久删除、分享及空状态正确，Home 与 Recent 同步更新；从 My Files 打开外部 PDF 不进入 Recent；PDF 预览返回后停留在 Recent 原滚动位置，Recent 顶部返回后进入 Home。 |
| A13 | R12 | 桌面小组件 | Tools 功能卡与 Settings 列表项均进入同一个 Widgets 二级页面；大、中、小三种样式均可添加，分别展示 1、3、6 个约定快捷入口且不展示任何文件；点击后进入正确功能；允许重复添加；系统不支持快速固定、用户取消或添加失败时有正确降级且不影响 App 使用。 |
| A14 | R13 | 广告控制完善 | 完成广告点位拆分，并完成广告相关控制查漏补缺。 |
| A15 | R14 | 创建成功报告页 | 扫描生成 PDF、图片转 PDF、PDF 合并和提取页面成功后进入单文件报告页，展示成功插画和文件缩略图但不直接展开 PDF；全部拆分进入多文件报告页；报告页不提供删除；Create 清空当前任务并重新进入同一功能，Home 与系统返回键均结束任务并返回 Home，以上操作均不删除已保存的 PDF；各操作入口和失败状态正确；OCR、已有 PDF 和示例 PDF 不进入报告页。 |
| A16 | R15 | 主要功能按钮动效 | 主要功能按钮增加扫光动效。 |
| A17 | R16 | FCM 定时通知 | 每天按设备本地时间在 09:00、12:30、18:00、21:00 分别收到对应文案；点击后进入扫描、图片转 PDF、OCR、My Files，冷启动时也能进入正确目标。 |
| A18 | R17 | 常驻通知卡片 | 卡片不展示标题和简短说明；一行正确展示 Scan、OCR、Files、Widget 4 个小入口，下方展示通栏 Create Now 按钮；5 个入口分别进入约定页面。 |
| A19 | R1-R17 | 兼容与回归 | API 24、29、34、36 按系统能力验证权限、文件、小组件及通知链路；Pixel API 36 真机验证顶部安全区、首次语言、通知权限位置、FCM 四时段通知、常驻通知卡片、My Files 授权与撤销、真实测试文档操作、Recent 二级页、扫描数量同步、双列页面管理、三种小组件及创建成功报告页；扫描、OCR、图片转 PDF、合并、拆分不因本版改动失效。 |

## 5. 修订记录

| 修订日期 | 变更内容 | 影响范围 | 确认方式 |
|---|---|---|---|
| 2026-08-12 | 增加文档扫描中状态、手动刷新和文件详细信息；固定按修改时间倒序；重命名后更新修改时间并前移；删除确认显示真实文件名；3 个示例统一为多图生成的多页 PDF | R5-R8、A6-A9 | 常老大确认 |
| 2026-08-12 | 扫描拍摄页左下角缩略图增加数字角标，与顶部已拍页数实时同步；0 页隐藏，超过 99 页显示 `99+` | R9、A10-A11 | 常老大确认 |
| 2026-08-12 | 共用页面管理改为一行 2 张缩略图，左上角页码、右下角编辑图标；点击进入底部操作面板，长按拖拽排序；覆盖扫描、图片转 PDF、OCR 拍照和 OCR 相册 | R10、A11 | 常老大确认 |
| 2026-08-12 | Home See all 改为进入 Recent 二级页面；My Files 示例与真实文件统一按时间倒序且不展示路径；权限关闭后即时切换未授权状态；页面管理顶部 `+` 按来源继续拍摄或选图并追加末尾 | R5-R7、R10-R11、A6-A12、A19 | 常老大确认 |
| 2026-08-12 | 增加大、中、小三种纯快捷入口桌面小组件及快速添加能力；增加广告点位拆分与广告相关控制查漏补缺 | R12-R13、A13-A14、A19 | 常老大确认 |
| 2026-08-12 | Widgets 同时增加 Tools 与 Settings 入口并共用二级页面；新增单文件与多文件创建成功报告页及成功插画；主要功能按钮增加扫光动效 | R12、R14-R15、A13、A15-A16、A19 | 常老大确认 |
| 2026-08-13 | 修正首次语言确认与后续语言切换的重启规则；限定 My Files 不扫描的文件范围；统一 My Files、Recent、报告页文件操作入口；补齐 Recent 与报告页返回栈；更新版本目标 | 版本目标、R3、R8、R11、R14、A3-A4、A9、A12、A15 | 常老大确认 |
| 2026-08-13 | 增加每天按设备本地时间发送 4 条 FCM 功能通知及对应中英文文案；增加无标题和说明的卡片式常驻通知，包含 4 个小入口和 1 个通栏创建按钮 | R16-R17、A17-A19 | 常老大确认 |
