使用与配置指南

Google 登录：推荐独立配置

1. 为模板站新建一个 Google Cloud 项目，配置 Google Auth Platform 的品牌和目标对象。
2. 测试阶段将你自己的 Google 账号加入测试用户；生产站使用独立项目与正式品牌信息。
3. 创建「Web 应用」类型 OAuth 客户端，本地与线上测试分别使用一个客户端。
4. 本地授权重定向 URI：http://localhost:3100/api/auth/callback/google
5. 线上测试 URI：https://你的测试域名/api/auth/callback/google
6. 将 Client ID、Client Secret 和随机认证密钥填入本地 .dev.vars；线上使用 Workers Secrets。
7. 让 BETTER_AUTH_URL 与当前访问地址一致，重新启动应用后前往登录页。

仅使用基础身份信息范围：openid、email、profile。回调地址必须与控制台登记的地址完全一致。

Google 官方配置文档 ↗

部署到 Cloudflare Workers

1. 创建 D1 数据库，将实际 ID 写入 wrangler.jsonc。
2. 创建 R2 文件存储桶，核对 MEDIA 绑定名称。
3. 执行数据库迁移，为本地和线上分别初始化认证与积分表。
4. 将站点 URL 和认证 URL 配置为测试站的 HTTPS 地址。
5. 配置两个 Worker 的 Secrets，先部署 Jobs 注册 Workflow，再部署网站。

完整命令和 fork 步骤见项目 README。当前模板默认禁止搜索引擎索引。

邮箱验证码登录

在 Resend 验证发件域名，填写 RESEND_API_KEY 与 AUTH_EMAIL_FROM。用户输入邮箱获取六位验证码，五分钟内验证，首次登录自动注册并赠送积分。所有模板凭据默认为空，没有开发验证码后门。

Wan 视频编辑与文件存储

填写 SEEAPI_API_KEY 和 MEDIA_BASE_URL，部署 Jobs Worker 并绑定 Workflow。两个 Worker 使用同一个 D1、私有 R2 桶及 BETTER_AUTH_SECRET。素材域名必须是网站的公开 HTTPS origin，使供应商能读取签名素材链接。

上传参考视频和可选参考图，任务冻结积分；成功转存结果到 R2 后结算，明确失败退还，状态不确定则保留原任务待核对。我的作品中可查看个人历史、预览和下载结果。

运营后台

后台使用独立账号密码。运行 npm run admin:configure 设置账号并生成密码；线上配置 ADMIN_USERNAME 和 ADMIN_PASSWORD_HASH，不配置时无法登录后台。

支持用户查询、账户停用与恢复、积分调整、任务查询、模型开关和计价，以及管理审计。支付渠道尚未接入，后台不会显示虚构订单。

当前实现边界

邮箱与 Google 登录、Wan 视频编辑、用户素材和历史、R2 转存下载、积分扣退与运营后台已有代码。外部凭据由每个 fork 自行配置，接入后的真实链路需要实测。

通用工作台模型仍是参数示例。支付订阅、完整内容审核、文件清理、Blog、公开分享与完整双语内容尚未实现。完整配置与部署步骤见 README 和 docs/integration.md。