PRODUCT.md

Rama main · réplica de lectura del repositorio original.

# Product

## Register

product

## Users

OmniNest 面向重视数据私有化、长期内容沉淀和多端访问的自托管用户。核心用户通常需要在桌面端集中管理文件、存储、任务和系统状态，也会在桌面端或移动端连续消费音乐、影视、照片、小说和漫画。界面需要同时支持高频浏览、批量管理、长时间阅读与播放，以及低频但高风险的系统管理操作。

## Product Purpose

OmniNest 是统一管理个人数字资产的自托管工作台。它把文件存储、媒体消费、阅读、相册、跨端同步、离线能力、通知和系统配置放在一个具有一致身份与权限边界的产品中。成功的体验应让用户能快速继续上次任务，清楚理解同步、上传和后台任务状态，并在不同设备之间保持内容与操作上下文连续。

## Brand Personality

可靠、安静、清晰。产品应呈现长期可用的工具感和克制的科技感，让内容成为视觉焦点，让系统状态和危险操作保持明确。语气直接、客观，不使用营销口号，也不通过装饰性效果掩盖信息结构。

## Anti-references

- 不做营销落地页式的大标题、卖点卡片墙和装饰性 Hero。
- 不做与个人内容脱节的通用 SaaS 后台，也不把所有模块压成同一种统计仪表盘。
- 不把移动端处理成桌面布局的缩小版本，不依赖 hover 才能完成关键操作。
- 不让 Portal、Music、Files、Photos、Video、Reader 和 Admin 各自形成互不相干的主题、导航与文案体系。
- 不默认堆叠玻璃卡片、强模糊、渐变或大面积品牌色，以免削弱动态壁纸、封面、海报和照片本身。

## Design Principles

1. **任务优先**：首屏优先呈现继续任务、当前状态和下一步操作，减少只用于展示的中间页面。
2. **内容决定表达**：影视突出海报和播放上下文，阅读突出书封与进度，文件和管理突出列表、筛选、状态与批量操作。
3. **统一系统，平台适配**：跨端保持相同信息架构、术语和状态语义，同时为键鼠、触控、窗口和系统返回行为提供符合平台习惯的交互。
4. **边界清晰**：共享主题、导航和跨模块契约，各业务模块保持独立状态与数据边界，聚合页面只依赖稳定的公开能力。
5. **状态可追踪**：上传、同步、扫描、异步任务、失败和危险操作必须提供可理解、可恢复、可审计的反馈。

## Accessibility & Inclusion

- 正文和交互文本满足 WCAG AA 对比度要求，动态壁纸场景按最终合成背景校验可读性。
- 所有仅图标操作提供 tooltip 或 semanticLabel，状态信息不只依赖颜色表达。
- 桌面端支持可预期的键盘导航、焦点顺序和可见 focus ring。
- 移动端主要触控目标不小于 48dp，并为窄屏、横屏和系统键盘保留稳定布局。
- 尊重减少动态效果偏好，连续位移、缩放和背景动画必须提供静态或弱动效替代。