VALPOINT
说明
🎯 ValPoint 是一个专为 Valorant 玩家打造的点位管理与分享平台。支持多地图标注、技能点位收藏、视频来源追踪、作者信息自动获取等功能，让你的游戏技巧管理更加高效。
🌐 官网地址
备用地址：
✨ 功能特性
🎮 三大功能模块
| 模块 | 说明 |
|---|---|
| 个人库 | 管理您的私有点位数据，支持新增、编辑、删除、导入导出 |
| 共享库 | 浏览公共点位，一键保存到个人库，支持图片自动迁移 |
| 管理后台 | 用户管理、投稿审核、数据统计、系统设置 |
🧩 核心功能
- 点位管理：创建 / 编辑 / 删除站位、瞄点、落点配图与描述
- 保存点位：从共享库保存点位到个人库，仅限同一项目内操作
- 下载点位：从共享库下载点位到个人库，支持跨项目操作
- 多视角筛选：按地图、英雄、技能、阵营（进攻/防守）筛选
- 作者信息自动获取：支持 B 站、抖音视频链接，自动解析作者头像和昵称
- 精准空降：点击跳转到视频的具体时间点
- 图床配置：支持阿里云 OSS、腾讯云 COS、七牛云 Kodo
- 图片自动迁移：从共享库保存点位时，自动将图片迁移到个人图床
- 批量下载：将点位打包为 ZIP 下载到本地
- 批量导入：支持导入 ZIP 格式的点位包
- 移动端适配：手机端可流畅浏览点位
🛠️ 技术栈
| 类别 | 技术 |
|---|---|
| 前端 | React 18 + TypeScript + Vite 5 + Tailwind CSS |
| 地图 | Leaflet + React-Leaflet |
| 后端 | Supabase (PostgreSQL + Auth + Storage + Edge Functions) |
| 图床 | 阿里云 OSS / 腾讯云 COS / 七牛云 Kodo |
| 部署 | Docker / Vercel / Cloudflare Pages |
🚀 快速开始
详细教程请查阅 👉 快速开始
bash
# 克隆项目
git clone https://github.com/xiongaox/ValPoint.git
cd ValPoint
# 安装依赖
npm install
# 配置环境变量
cp .env.example .env
# 编辑 .env 填入 Supabase 配置
# 启动开发服务器
npm run dev📁 项目结构
ValPoint/
├── src/
│ ├── apps/ # MPA 多入口应用
│ │ ├── admin/ # 管理后台
│ │ ├── shared/ # 共享库
│ │ └── user/ # 个人库
│ ├── components/ # 通用组件
│ ├── features/ # 业务功能模块
│ ├── hooks/ # 自定义 Hooks
│ ├── services/ # API 服务层
│ └── utils/ # 工具函数
├── docs/ # VitePress 文档
├── public/ # 静态资源
├── functions/ # Supabase Edge Functions
├── Dockerfile # Docker 镜像构建
├── docker-compose.yml # Docker Compose 编排
└── nginx.conf # Nginx 配置🚢 部署方式
⚡ 快速部署
选择你要部署的平台，点击下方按钮一键部署
Vercel（推荐）
Cloudflare Pages
Docker
创建 docker-compose.yml 文件：
yaml
services:
valpoint:
image: xiongaox7806/valpoint-a:latest
container_name: valpoint
restart: always
ports:
- "3208:3208"
environment:
- VITE_SUPABASE_URL=${VITE_SUPABASE_URL}
- VITE_SUPABASE_ANON_KEY=${VITE_SUPABASE_ANON_KEY}
networks:
- valpoint-net
networks:
valpoint-net:
driver: bridge启动服务：
bash
docker compose up -d详细教程请查阅 👉 部署指南
📖 文档导航
| 文档 | 说明 |
|---|---|
| 使用流程 | 了解如何使用 ValPoint |
| 个人库功能详解 | 个人库完整功能介绍 |
| 共享库功能详解 | 共享库完整功能介绍 |
| 移动端详解 | 移动端使用说明 |
| 后台详解 | 管理后台完整功能介绍 |
| 图床配置 | 配置个人图床教程 |
| 数据库建表 | Supabase 数据库配置 |
🗺️ 未来计划
- ✅ 平板端适配（已完成）
- ✅ 基于 SQLite 的本地 Docker 版本（已完成，项目地址：ValPoint-Local）
- ⬜ 云存储同步（WebDAV / S3）
详情请查阅 👉 未来计划
🤝 贡献指南
欢迎提交 Issue 和 Pull Request！
- Fork 项目
- 创建功能分支 (
git checkout -b feature/AmazingFeature) - 提交更改 (
git commit -m 'feat: Add some AmazingFeature') - 推送到分支 (
git push origin feature/AmazingFeature) - 开启 Pull Request
📄 许可证
MIT License
🙏 致谢
- Valorant API - 英雄和地图数据
- Supabase - 后端服务
- Leaflet - 地图库
- Lucide - 图标库
Made with ❤️ for Valorant Players
⭐ 如果这个项目对你有帮助，请给个 Star！