22aa0ef4022a9b996e3aa9d6f603c5a6491f6c0a
LFSpecs
公开硬件规格库:收录手机、芯片等设备的详细参数,支持横向对比。设计文档见 DESIGN.md。
技术栈
Astro 7(SSR / Node adapter)+ Tailwind CSS 4 + shadcn/ui(React islands)+ SQLite(node:sqlite,无原生依赖)
本地开发
pnpm install
cp .env.example .env # Windows: Copy-Item .env.example .env
pnpm db:seed # 建表 + 写入种子数据(Xiaomi 14 / 骁龙 8 Gen 3)
pnpm dev # http://localhost:4321
组件自检页:/poc(验证 Button / Card / Dialog 可用,M0 验收后可删)。
部署
小内存服务器(当前 ECS 方案)
ECS 只有 1.6G 内存,Docker 多阶段构建会触发 kcompactd 长时间阻塞(load 飙到 40+)。因此改为「宿主构建 + 容器挂载」:
bash scripts/deploy.sh
脚本依次执行:拉代码 → pnpm install → pnpm build → docker compose up -d --force-recreate。容器用 node:24-slim 镜像,挂载 dist / node_modules / data,只有 ./data 需要持久化。
前提:服务器 Node 装在 /opt/node(脚本会自动加进 PATH),且已存在 .env。
普通机器 / CI
docker compose build && docker compose up -d 仍可用仓库里的 Dockerfile 构建单镜像,不需要挂载。
运维
pnpm backup # VACUUM INTO 快照 + 打包 uploads 到 backups/<时间戳>/
pnpm db:seed # 重跑种子数据(幂等,按 slug upsert)
目录
src/lib/schema/ zod 数据模型(phone / soc / FieldMeta)
src/lib/db.ts SQLite 连接 + 迁移
src/lib/repo.ts 唯一数据出入口
src/lib/storage.ts 图片存储驱动(local / s3 接口)
migrations/ SQL 迁移,按文件名顺序执行
scripts/ seed / backup
Languages
TypeScript
50.8%
Astro
25.1%
JavaScript
22%
CSS
1.8%
Dockerfile
0.2%
Other
0.1%