Fused-Gaming/plug
GitHub: Fused-Gaming/plug
一款隐私优先的充电站定位地图应用，帮助弱势群体寻找免费的设备充电设施，目前为只读地图的 MVP 版本。
Stars: 0 | Forks: 0
# Next Chapter Project 演示
Next Chapter Project 训练营参赛项目的最小可行性演示。
## 项目愿景
**充电站定位器** — 一款隐私优先的地图应用，旨在帮助弱势群体（无家可归者、学生、旅行者、零工等）寻找免费、可靠的设备充电设施。
**本 MVP：** 提供显示充电位置的只读地图界面。作为训练营的提交作品，重点在于体现核心价值主张，暂不包含用户提交或复杂的功能。
## 包含内容
- 展示设备充电站的交互式地图
- 位置详情（名称、地址、营业时间）
- 基础筛选与搜索
- 移动端响应式设计
- 自动化 GitHub Pages 部署至 plug.vln.gg
## 在线演示
**生产环境：** https://plug.vln.gg
（每次推送到 main 分支时自动部署）
## 快速开始
### 前置条件
- Node.js 18+（或您选择的其他运行时）
- [其他关键要求]
### 安装说明
```
git clone https://github.com/fused-gaming/plug.git
cd plug
npm install
```
### 运行演示
```
npm run dev
```
演示将在 `http://localhost:3000` 提供
## 核心功能：只读充电地图
- 在交互式地图上查看充电站
- 查看详情：名称、地址、营业时间
- 按可用性筛选（如果已知位置信息）
- 基于距离的排序
- 同时适配移动端和桌面端
## 架构
**前端：** React + Vite（快速构建，轻量级）
**地图：** MapLibre GL JS + OpenStreetMap（免费，无需 API key）
**数据：** 硬编码的种子位置（无需后端）
**部署：** GitHub Pages（推送到 main 分支时自动部署）
## 测试
```
npm test
```
## 部署说明
本项目通过 GitHub Actions 自动部署至 GitHub Pages。
- **在线地址：** https://plug.vln.gg
- **工作流：** `.github/workflows/deploy.yml`
- **构建输出：** `dist/` 文件夹
有关详细的部署文档和故障排除，请参阅 [DEPLOYMENT.md](DEPLOYMENT.md)。
## 提交详情
- **目标：** Next Chapter Project 编程训练营
- **提交日期：** [第 7 天截止日期]
- **演示时长：** 5-10 分钟
## 许可证
[项目许可证]
## 联系方式
如有关于此提交的疑问，请联系 [您的联系方式]
标签：MapLibre, React, Syscalls, Vite, 充电站查询, 公益服务, 前端, 地图, 自定义脚本