📚 开发文档

完整的配置指南、使用说明和最佳实践

🔐 管理后台配置

功能概览

📊 数据统计

实时查看用户数、脚本数、下载量

👥 用户管理

管理用户信息和权限

📜 脚本管理

上传、更新、删除脚本

📢 公告管理

发布和管理网站公告

配置步骤

1. 启用 Firestore

https://console.firebase.google.com/project/akinktogo/firestore

2. 设置管理员

编辑 admin.js 第 17 行：

const ADMIN_EMAILS = ['your-email@example.com'];

3. 访问后台

http://localhost:8000/admin.html

🛡️ reCAPTCHA Enterprise

功能说明

reCAPTCHA Enterprise 提供企业级机器人防护，防止：

  • 暴力破解攻击
  • 批量注册机器人
  • 自动化脚本攻击

配置步骤

1. 启用 API

https://console.cloud.google.com/apis/library/recaptchaenterprise.googleapis.com?project=akinktogo

2. 部署 Functions

cd functions npm install firebase deploy --only functions

3. 密钥配置

站点密钥: 6LcIWg0sAAAAAOXwIWOL2G1zuVUOawv8BXRuU95M

项目 ID: akinktogo

🔥 Firebase 配置

使用的服务

🔐 Authentication

邮箱密码、Google、GitHub 登录

📊 Firestore

NoSQL 云数据库

⚡ Functions

无服务器后端函数

项目配置

projectId: "akinktogo" authDomain: "akinktogo.firebaseapp.com"

🐙 GitHub 登录配置

创建 OAuth App

1. 访问 GitHub 设置

https://github.com/settings/developers

2. 创建应用

  • Application name: mspaint
  • Homepage URL: https://yourdomain.com
  • Callback URL: https://akinktogo.firebaseapp.com/__/auth/handler

3. 配置 Firebase

将 Client ID 和 Secret 添加到 Firebase Console

🚀 部署指南

本地开发

python -m http.server 8000

部署到 Firebase

firebase init hosting firebase deploy --only hosting

🔧 故障排除

常见问题

Q: 无法登录管理后台？

A: 确保邮箱在管理员列表中，并已在主页注册

Q: reCAPTCHA 未加载？

A: 检查网络连接和站点密钥配置

Q: Functions 部署失败？

A: 确认已安装依赖并选择正确的项目