🎮 PS5 / Nintendo Switch 游戏资产与游玩记录 PWA

个人游戏资产账本 + 游戏生命周期记录 + 游玩体验日志

记录我购买过什么游戏、花了多少钱、卖了多少钱、最终盈亏多少、玩了多久、是否通关、是否开心，以及 100% 本地保存和迁移个人数据。

🌐 在线体验：psn-ns-record.664501775.workers.dev

---

✨ 核心特性

• 🔒 100% 离线与隐私安全：所有数据均保存在本地浏览器 IndexedDB 中，无需注册账号，不依赖任何后端数据库，不收集任何用户隐私。
• 💰 游戏资产全周期记账：
  • 记录买入价格、币种（CNY / HKD / JPY / USD）与汇率。
  • 售出自动计算：实际到手 = 卖出标价 - 平台手续费 - 快递费，最终盈亏 = 实际到手 - 买入成本。
  • 自动计算每小时净成本（已卖出游戏为真实净花费/小时，持有中为当前成本/小时）。
• 🕹️ 游玩与生命周期 Timeline：
  • 购买入库 → 开始游玩 → 通关/弃坑 → 已售出回血 → 最终财务结算。
  • 记录通关进度、游玩时长、开心程度（15 😐🙂😊😄🤩）、游戏评分（110）及深度体验心得。
• 📊 多维统计与价值分析：
  • 自动计算总投入、PS5 / Switch / 数字版 / 实体版分组花费、回血回收金额与总盈亏。
  • 价值分析评选："最划算游戏"、"游玩时间最长"、"最开心游戏"、"二手最赚 / 回血最高"、"卖出亏损最高"。
• 🖥️ 硬件设备与充值点卡独立账本：
  • 硬件设备（PS5、NS2、显示器、采集卡、手柄等）与充值点卡（Eshop、PSN）独立分立记账，不混淆游戏盈亏。
• 🔄 完善的数据导入与导出：
  • 历史 Excel 专属适配器：直接无缝解析导入包含 PS光盘、PS数字版、NS卡带、Eshop点卡、硬件设备 的历史 Excel 文件。
  • JSON 全量备份与恢复：带版本号与预览校验，支持合并或覆盖导入。
  • CSV 导出与导入：支持智能列名匹配与自定义字段映射。
• 📱 PWA 支持：
  • 支持 iOS / Android 添加到主屏幕，无网络断网状态下照常离线使用。

---

🛠️ 技术栈

• 构建工具: Vite
• 核心框架: React 18 + TypeScript (Strict Mode)
• 路由: React Router 6
• 本地存储: IndexedDB (原生事务封装，支持版本迁移)
• 离线与 PWA: Vite PWA + Service Worker + Web Manifest
• 表格解析: SheetJS (XLSX) + PapaParse
• 图标: Lucide React
• 设计风格: Apple Settings & Linear 极简响应式设计

---

🚀 本地开发与运行

1. 克隆与安装依赖

git clone https://github.com/CodeAlex52/psn-ns-record.git
cd psn-ns-record
npm install

2. 启动开发服务器

npm run dev

在浏览器中打开 http://localhost:5173。

3. 局域网在手机上测试 PWA

npm run dev -- --host

手机连接同一局域网访问显示的 IP，在 Safari 或 Chrome 中选择「添加到主屏幕 / 安装应用」。

4. 生产构建

npm run build

---

☁️ 部署到 Cloudflare Pages

本项目是纯静态前端应用（零后端），非常适合托管在 Cloudflare Pages：

1. 登录 Cloudflare Dashboard。
2. 进入 Workers & Pages → Create Application → 选择 Pages → Connect to Git。
3. 选择你的 GitHub 仓库（如 psn-ns-record）。
4. 在构建配置（Build Settings）中设置：
   • Framework preset: Vite
   • Build command: npm run build
   • Build output directory: dist
5. 点击 Save and Deploy，1分钟后即可获得全球 CDN 加速的访问域名！

---

📄 License

MIT © CodeAlex52