English | 简体中文 | 日本語

Curated 是本地优先的媒体资料库：Vue 3 前端、Go + SQLite 后端，以及 Electron 桌面壳。产品正式名称是 Curated。仓库目录和 npm 包名仍可能使用 jav-shadcn。

本 README 只做公开入口。启动细节、配置、打包，以及 docs/ 里各篇文章的索引，见 docs/guide.md。HTTP API 参考是 API.md。

正式 Windows 安装包和便携包发布在 GitHub Releases。请使用 最新 Release。

• 安装器（推荐）： Curated-Setup-<version>.exe
• 便携包： Curated-<version>-windows-x64.zip

已安装的应用也可以在 设置 → 关于 中检查并下载新的安装器。

• 本地优先：Vue 3 SPA、Go HTTP API、SQLite，以及面向 Windows 的 Electron 托盘壳。
• 双模式开发：真实 Web API 与 Mock UI 共用同一服务层。
• 资料库浏览、刮削、导入、播放、萃取帧、演员身份、每日推荐与个人洞察。
• 可选 PIN 锁、可验证备份、路径迁移、资料库健康与有界修复。
• 基于 GitHub Releases 的更新检查与安装器下载；正式包内置 FFmpeg 与本地 hls.js。

环境：与 Vite 8 兼容的当前 Node.js LTS、pnpm、Go 1.25.4+。

cd backend && go run ./cmd/curated

pnpm install
pnpm dev

• 后端默认：http://127.0.0.1:8080（仅 loopback），健康名 curated-dev。
• 前端默认：http://localhost:5173。
• 根目录 .env 设置 VITE_USE_WEB_API=true 走真实 API，否则为 Mock。
• 桌面壳：pnpm dev:electron。
• Windows 开发二进制：pnpm backend:build:dev → backend/runtime/curated-dev.exe。

备份、恢复、路径迁移、配置项和发布打包见 docs/guide.md。

src/        Vue SPA
backend/    Go 模块 curated-backend（`cmd/curated`）
electron/   桌面壳 MVP
config/     资料库级运行配置（保留在仓库根目录）
docs/       手册、规范、产品、运维、计划、PRD
icon/       品牌源文件（wordmark / appicon / mark）

• 当前阶段是 Web 优先 + 最小 Electron 壳。更深的 IPC、mpv 与广泛原生桥接仍是目标方向。
• docs/film-scanner/ 是参考材料，不是生产模块树。

后续若有大模型接手本仓库工作，请把名称追加到下面。

• Composer 2.5
• DeepSeek V4
• GPT 5.5
• GPT 5.6 Terra sol
• Grok 4.6