快速开始
本地跑起来。
需要 Node.js 22.22.3+（或 24.15.0+），npm 11+。
启动
npm install
npm run auth:setup:local # 生成本机密钥到 .env 和 .dev.vars
npm run db:migrate:local # 本地 D1 建表
npm run dev
打开 http://127.0.0.1:3000。要用 127.0.0.1，不要用 localhost，认证和 Google 回调只认这个地址。
配置
在 .env 里填，变量名见 .env.example：
- 邮件：
NUXT_RESEND_API_KEY、NUXT_EMAIL_FROM、NUXT_RESEND_VERIFY_TEMPLATE_ID、NUXT_RESEND_RESET_TEMPLATE_ID - Google 登录：
NUXT_GOOGLE_CLIENT_ID、NUXT_GOOGLE_CLIENT_SECRET，客户端创建步骤见项目里的docs/google-oauth.md - Google One Tap：
NUXT_GOOGLE_ONE_TAP，默认开，填false关。只在 https 或localhost上弹出，本地127.0.0.1看不到 - 联系邮箱：
NUXT_PUBLIC_SUPPORT_EMAIL，显示在隐私政策和服务条款页
常用命令
npm run typecheck
npm run build
npm run preview # 本机跑 Workers 产物，端口 8797
npm run auth:check:local # 认证流程检查，需先启动 dev
npm run email:check:local # 邮件流程检查，不真实发信
npm run docs:build # 改了文档后重新生成
写文档
在 content/docs/ 新建 05-xxx.md，开头写：
---
title: 标题
description: 一句话简介
---
序号决定排序，xxx 是网址。