# LFSpecs 公开硬件规格库:收录手机、芯片等设备的详细参数,支持横向对比。设计文档见 [DESIGN.md](./DESIGN.md)。 ## 技术栈 Astro 7(SSR / Node adapter)+ Tailwind CSS 4 + shadcn/ui(React islands)+ SQLite(`node:sqlite`,无原生依赖) ## 本地开发 ```bash 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 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` 构建单镜像,不需要挂载。 ## 运维 ```bash 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 ```