Imported from Furry-wucheng/resource_view (
doc/prd/AGENTS.md). Install upstream withnpx skills add Furry-wucheng/resource_view --skill prd. Copyright stays with the author.
Resource Viewer — 产品需求文档
版本：v1.2（终版） · 日期：2026-06-17 · 状态：已定稿 · 给 AI 阅读
产品定位
Resource Viewer 是一款多数据源统一收藏管理工具，帮助用户集中浏览、检索分散存储的漫画、图包等资源。
核心能力：竖版缩略图网格浏览 → 内置收藏 + 自定义标签交集筛选 → 统一查看器翻阅图片/PDF。
术语定义
| 术语 | 定义 |
|---|---|
| 数据源（Source） | 用户添加的文件来源，如本地文件夹路径或 SMB 网络共享 |
| 资源（Resource） | 一个可浏览/阅读的内容单元，通常为一个文件夹或单个 PDF/压缩包文件 |
| 标签（Tag） | 分为内置标签（收藏）和自定义标签，可绑定到任意资源 |
| 组织模式 | 资源内部文件的组织方式：章节模式 / 章节画廊模式 / 平铺网格 / 画廊模式 |
| ResourcePicker | 可复用的树形扫描选择弹窗组件，用于深层子文件夹选择 |
模块索引
| 编号 | 文档 | 职责 | 状态 |
|---|---|---|---|
| 01 | 资源库首页 | 竖版缩略图网格、筛选栏、空状态、拆分资源 | 已定稿 |
| 02 | 标签系统 | 内置+自定义标签、交集筛选、批量打标签 | 已定稿 |
| 03 | 数据源管理 | 本地/SMB 源、文件浏览器（双视图+宽屏+多选）、批量添加/打标签 | 已定稿 |
| 04 | 资源查看器 | 统一图片/PDF 查看器、滑动条翻页、跨章节阅读、视频播放器 | 已定稿 |
| 05 | 数据模型 | Source / Resource / Tag / ResourceTag 实体定义与关系 | 已定稿 |
| 06 | 页面结构与交互 | 页面树、导航、ResourcePicker 组件、平台适配 | 已定稿 |
| 07 | 资源组织结构 | 四种组织模式（章节/章节画廊/平铺网格/画廊）、自动判定 | 已定稿 |
| 08 | 设置页面 | 缓存管理、外观、查看器默认设置、数据源同步 | 已定稿 |
核心流程
打开应用
│
├─ [首次使用] → 添加数据源（本地 / SMB）→ 文件浏览器手动勾选 → 添加资源
│ └─ 系统自动判定组织模式（章节 / 平铺网格）；章节画廊 / 画廊需手动选择
│
└─ [日常使用]
├─ Tab 0 首页：浏览缩略图网格 → 筛选栏（全部 | 收藏 | 自定义标签交集）
├─ Tab 1 数据源：管理源 → 文件浏览器（导航/多选/扫描入库）
│ └─ 长按文件夹 → 扫描入库 → ResourcePicker 弹窗（树形级联选择）
└─ Tab 2 设置：缓存清理、外观切换、查看器默认配置
文档间引用规则
@01、@02等 → 指向同目录下的对应编号 PRD 文档@design/xxx.html→ 指向design/目录的 HTML 原型图- 跨文档引用使用
@XX-文档名.md格式
实施参考
MVP 分阶段实施计划已重写为 29 个微阶段，支持多 Agent 并行 worktree 开发。
| PRD 模块 | MVP Stage | 说明 |
|---|---|---|
| 01 资源库首页 | M16, M23, M24 | 筛选栏在 M16，首页网格在 M23，ResourcePicker 在 M24 |
| 02 标签系统 | M15 | 标签 CRUD + 交集筛选 |
| 03 数据源管理 | M12, M13, M17 | 本地源在 M12-M13，SMB 源在 M17 |
| 04 资源查看器 | M14, M19, M20, M21, M22 | 基础查看器 M14，视频 M19，组织模式 M20-M21，PDF M22 |
| 05 数据模型 | M06, M09 | Entity 在 M06，Domain Model 在 M09 |
| 06 页面结构与交互 | M03, M04, M05, M24 | 路由 M03，AppShell M04，占位页 M05，ResourcePicker M24 |
| 07 资源组织结构 | M20, M21 | 四种策略 + 自动判定 |
| 08 设置页面 | M25 | 缓存/外观/查看器默认值 |