洛谷用户信息卡片 Luogu-User-Card
洛谷用户信息卡片 Luogu-User-Card
Jerry ZhouLuogu User Card 现在可以在网页端使用生成器简便生成，无需手动修改链接🎉
Luogu User Card
🏆 优雅的洛谷用户信息卡片及生成工具
📖 项目介绍
Luogu User Card 是一个动态生成洛谷用户信息卡片的工具，可以在个人主页、博客、GitHub 个人资料等任何支持 Markdown 或 HTML 的地方展示您的洛谷做题情况、用户信息和咕值等数据。
注意：为了不滥用洛谷服务器流量，本项目利用 Vercel 的边缘缓存功能缓存数据 12 小时，即同一个用户卡片 24 小时内最多只会向洛谷服务器请求 2 次数据，并且只有在用户访问卡片时才会请求数据。如果需要，可以在链接末尾添加
&disable_cache=true参数来禁用缓存。
✨ 特性
- 🌈 多种卡片类型：基本信息、练习徽章、练习情况、咕值信息
- 🌙 深色模式：支持浅色/深色两种显示模式
- 📏 自定义宽度：可根据放置场景调整卡片宽度
- 🚀 实时更新：数据自动从洛谷获取，无需手动更新
- 🔄 缓存机制：智能缓存减轻洛谷服务器压力
- 🔌 易于部署：一键部署到 Vercel，无需服务器
🌈 在线生成器
访问 api.jerryz.com.cn 使用在线生成器，填写信息后即可获取卡片。
🚀 使用指南
基本信息卡片
展示用户的基本信息，包括用户类型、关注、咕值排名、个性签名等。
1 |  |
带链接版本：
1 | [](https://www.luogu.com.cn/user/253620) |
练习徽章
简洁地显示用户的做题统计数据，适合放在项目徽章列表中。
1 |  |
带链接版本：
1 | [](https://www.luogu.com.cn/user/253620#practice) |
练习情况卡片
详细展示用户的做题情况，包括已通过题目数量和各个难度的题目分布。
1 |  |
带链接版本：
1 | [](https://www.luogu.com.cn/user/253620#practice) |
咕值信息卡片
展示用户的咕值数据，包括基础信用、练习情况、社区贡献、比赛情况、获得成就五个维度。
1 |  |
带链接版本：
1 | [](https://www.luogu.com.cn/user/253620) |
说明：
scores参数需要手动填入五个数据，分别对应基础信用、练习情况、社区贡献、比赛情况、获得成就，用英文逗号分隔。当系统检测到用户咕值排名在前 1000 名时，会自动获取数据并覆盖手动输入的数据。
🎨 自定义选项
所有卡片均支持以下自定义参数，可组合使用：
隐藏标题
添加 &hide_title=true 参数：
1 |  |
深色模式
添加 &dark_mode=true 参数：
1 |  |
自定义宽度
添加 &card_width=数值 参数（范围：500-1920）：
1 |  |
禁用缓存
添加 &disable_cache=true 参数：
1 |  |
🔧 自行部署
如果想要自行试验或者二次开发，可以将项目部署到自己的 Vercel 服务器：
- 登录 Vercel
- 点击下方按钮一键部署
手动部署步骤：
- Fork 这个仓库
- 注册/登录 Vercel
- 在 Vercel 点击 “New Project”
- 选择您的仓库
- 使用默认设置，点击 “Deploy”
🤝 参与贡献
提交问题与建议
请使用 GitHub Issues 提交问题和建议。提交 bug 时，请尽可能详细描述 bug 及其复现步骤，这将有助于我们更快地解决问题。
贡献代码
- Fork 本仓库
- 创建您的分支
- 提交您的更改
- 推送到分支
- 打开一个 Pull Request
📃 开源许可
版权所有 © 2020-2025 YangguangZhou
如果这个项目对您有帮助，请考虑给它一个 Star ⭐
