Files
imagefind/PRODUCT.md
T

61 lines
3.2 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Product
<!-- impeccable:product-schema 1 -->
## Platform
web
## Users
ImageFind 面向在飞牛 NAS 上管理个人与家庭私有媒体的单管理员。用户会在桌面浏览器和手机 Web/App 容器中上传、整理、搜索、播放和维护媒体,希望在设备资源有限、媒体来源多样的情况下仍能清楚掌握后台状态。
## Product Purpose
ImageFind 将本地目录、WebDAV 与 AList 媒体集中到一个私有媒体空间,通过本地 AI 识别画面语义、OCR 文字、人物、音频和字幕,让用户可以搜索到视频中的具体内容并直接跳转到对应时间点。
## Positioning
ImageFind 的核心差异是:在 NAS 本地把视频的画面、文字、人物和声音转化为可搜索、可播放的时间片段,同时保留私有部署、加密来源和本地推理能力。
## Operating Context
- 单管理员在桌面端进行来源配置、模型管理、批量整理、存储和备份操作。
- 手机端主要用于浏览、搜索、播放、上传、收藏、继续观看和快速整理。
- 视频可能来自本地目录、WebDAV、AList 加密来源、浏览器上传、WebDAV 服务端上传或后台下载。
- AI、转存、扫描和下载任务会在 NAS 资源保护策略下后台运行。
## Capabilities and Constraints
- 保持现有单管理员架构、中文界面、浅色蓝色品牌、深色模式及跟随系统能力。
- 保留首页、搜索、资料库、合集、上传中心、分类标签、人物、个人中心、设置和播放器等现有能力。
- 移动端底栏固定首页、搜索、中央上传、个人中心和更多;二级页必须有明确返回与当前位置。
- 触控目标至少 44px;功能文字需达到 WCAG AA 对比度并可通过键盘完成主要流程。
- 高保真原型不连接真实后端,不读取 NAS 数据,也不承诺现有 API 之外的新能力。
## Brand Commitments
- 产品名称保持 ImageFind。
- 视觉基调是克制、可信、私密的原生媒体应用,而不是营销页或通用文件管理后台。
- 交互层级参考 B 站的移动导航与合集、夸克的播放器、Infuse 的封面优先媒体库,但不复制其品牌色或组件外观。
- 品牌色保持清爽蓝色,封面内容承担页面主要色彩。
## Evidence on Hand
- 生产前端:`frontend/src/App.tsx``frontend/src/styles.css`
- 当前部署五种视口截图:`dist/live-ui-audit-current/`
- 既有 UI critique`.impeccable/critique/2026-08-03T17-47-41Z__frontend-src-app-tsx.md`
- 无可用于本原型的真实媒体封面资产;演示内容必须明确为合成数据,不得虚构商业证明或真实用户内容。
## Product Principles
1. 任何系统状态都应清楚可见,后台工作不能让用户猜测。
2. 内容、播放和搜索优先于文件路径与技术实现细节。
3. 手机体验应像完整应用,而不是缩小后的桌面后台。
4. 私密、本地和可恢复能力必须通过明确状态与文案建立信任。
5. 复杂能力使用渐进披露,常用操作保持一步可达。
## Accessibility & Inclusion
主要流程需支持键盘、可见焦点、语义化控件、屏幕阅读器标签、减少动画、200% 缩放以及不依赖颜色单独表达状态。