🚀 Vercel 一键部署指南

您已经拥有的

✅ 所有代码已准备完毕 ✅ GitHub 代码已在本地提交 ✅ 环境已配置

现在需要做的

由于本地 WSL 环境网络限制，请按照以下步骤在浏览器中直接完成部署：

📋 部署步骤（5-10 分钟）

第 1 步：打开 Vercel（1 分钟）

访问：https://vercel.com
用 GitHub 账号登录
进入 Dashboard

第 2 步：导入项目（2 分钟）

点击 “New Project” 按钮
点击 “Import Git Repository”
在搜索框输入：pea1ce.github.io
选择 pea1ce/pea1ce.github.io 仓库
点击 “Import”

第 3 步：配置构建设置（2 分钟）

在项目导入页面，找到以下配置项，按照说明修改：

Framework Preset:

选择：Other（不要选 Jekyll！）

Build Command:

bundle install && bundle exec jekyll build

Output Directory:

_site

其他项保持默认即可。

第 4 步：配置环境变量（2 分钟）

点击 “Environment Variables” 展开此部分
添加以下 4 个环境变量：

变量名	变量值	备注
`GITHUB_TOKEN`	`你的GitHub Token`	在 GitHub Settings → Developer settings → Tokens 生成
`API_AUTH_TOKEN`	`你的密码`	自定义管理员密码（例如：123456）
`GITHUB_OWNER`	`pea1ce`	保持不变
`GITHUB_REPO`	`pea1ce.github.io`	保持不变

添加方式：

输入变量名
输入变量值
点击 “Add” 按钮
重复 4 次

第 5 步：完成部署（1 分钟）

确认所有配置正确
点击 “Deploy” 按钮
等待部署完成（通常 3-5 分钟）

✅ 部署完成后

部署完成后，您会看到：

蓝色的 “Ready” 状态
一个可访问的网址，格式如：https://pea1ce.vercel.app

🧪 测试功能（2 分钟）

部署完成后，测试管理界面：

访问管理页面：
```
https://pea1ce.vercel.app/admin.html
```

填写表单测试：

用户：Oliver
国家：China
省份：浙江
城市：测试市
备注：部署测试

点击”提交”按钮
输入管理密码： 123456
检查结果：
- ✅ 看到成功提示
- ✅ 访问 GitHub 检查新 commit
- ✅ 2-3 分钟后足迹地图显示新城市

🔑 配置信息说明

重要提示： 请将 GitHub Token 和 API 密码保存在安全的地方（如密码管理器），不要提交到代码仓库中。

配置参数：

GitHub Owner: pea1ce
GitHub Repo: pea1ce.github.io
GitHub Token: 在 Vercel 环境变量中配置
API 密码: 在 Vercel 环境变量中配置

⚠️ 如果遇到问题

问题 1：部署失败

检查 Build Command 是否正确
检查环境变量是否完整
查看构建日志了解具体错误

问题 2：API 调用失败

检查 GITHUB_TOKEN 是否正确
检查 API_AUTH_TOKEN（管理密码）是否正确
检查 Token 权限是否包含 repo

问题 3：密码输入错误

管理密码是 123456
区分大小写
如果忘记，可以在浏览器控制台运行：
```
localStorage.removeItem('apiToken')
```

🎉 完成！

一旦部署成功，您就可以：

✅ 访问 https://pea1ce.vercel.app 查看网站
✅ 访问 https://pea1ce.vercel.app/admin.html 添加足迹
✅ 数据自动同步到 GitHub
✅ 足迹地图自动更新

下一步

部署完成后，您可能想：

配置自定义域名（可选）
- Vercel Settings → Domains
- 添加 heyiping.cn
- 更新 DNS 记录
在 footprint.html 添加管理按钮（可选）
- 方便用户快速进入管理界面
查看完整文档
- QUICK_START.md：快速开始
- LOCAL_SETUP.md：本地开发
- IMPLEMENTATION_SUMMARY.md：技术细节

祝部署顺利！任何问题欢迎继续提问。 🚀