4,545
stars
713
forks
19
watchers
22
prs
67
issues
0
releases
README
🎟️ DamaiHelper
多平台票务自动化 · Web 控制台 · 本机 YOLO/CUDA 逻辑层
面向学习与联调的抢票助手骨架:配置 → 任务编排 → 日志回传 → AI 滑块接口。
不保证真实抢票效果,默认 dry-run 跑通逻辑。
功能特性 · 快速开始 · 界面预览 · API · 项目结构 · 常见问题
---
⭐ Star History
---
✨ 功能特性
| 模块 | 说明 |
|------|------|
| Ant Design 控制台 | web-ui/:总览 / 配置 / 任务编排 / YOLO·CUDA |
| REST 后端 | web_server.py 同源托管前端 + /api/ |
| 任务编排 | scripts/task_runner.py 阶段流、可停止、增量日志 |
| 本机 AI | CUDA 探测 + Ultralytics YOLO(无权重自动 mock) |
| 一键安装 | tools/install_deps.py 按 GPU 装 CUDA 版 torch |
| 旧版兼容 | 无 web-ui/dist 时回退 web/index.html |
---
🚀 快速开始
环境
- Windows 10/11 或 macOS
- Python 3.10+(本机可 3.14)
- 可选:NVIDIA GPU + 驱动(RTX 系列)、Node.js 18+(构建前端)
方式 A:一键脚本(推荐)
Windows
bat
win一键运行.bat
macOS / Linux
bash
chmod +x mac_一键运行.sh
./mac_一键运行.sh
脚本会:安装 Python 依赖 →(有 npm 时)构建 web-ui → 启动 web_server.py → 打开浏览器。
方式 B:手动
bash
1) 依赖(含本机 CUDA torch 探测)
python tools/install_deps.py
2) 前端构建(可选,用于 Ant Design)
cd web-ui && npm install && npm run build && cd ..
3) 启动控制台
python web_server.py
浏览器打开:http://localhost:8765/
| 入口 | 地址 |
|------|------|
| 控制台首页 | http://localhost:8765/ |
| 健康检查 | http://localhost:8765/api/health |
| AI 状态 | http://localhost:8765/api/ai/status |
开发前端(热更新):
bash
python web_server.py 终端 1
cd web-ui && npm run dev 终端 2 → http://localhost:5173
pip install -r requirements.txt 不含 torch,避免误装 CPU 轮子。GPU 栈请用 tools/install_deps.py。
---
🖥️ 界面预览
以下为仓库内 本地 SVG 示意图(不依赖 shields / 外链图床,GitHub 渲染稳定)。
1. 总览(GPU / 后端状态)
!Dashboard
2. 任务编排(日志 + 进度)
!Task Runner
3. 经典 Web 面板截图(仓库内 PNG)
| 配置主面板 | 运行中日志 |
|:---:|:---:|
| !home | !running |
若截图路径失效,可直接运行 python web_server.py 在浏览器查看实机界面。
重新生成示意图:python tools/gen_readme_assets.py
---
📡 API 一览
完整约定见 web/docs/integration_guide.md。
| 方法 | 路径 | 说明 |
|------|------|------|
| GET | /api/health | 服务与任务快照 |
| GET/POST | /api/config | 读写 config/config.json |
| POST | /api/ticket/start | 启动编排(默认 dry_run: true) |
| POST | /api/ticket/stop | 停止当前任务 |
| GET | /api/ticket/logs?offset= | 增量日志 / 进度 |
| POST | /api/dependencies/install | 依赖逻辑任务 |
| GET | /api/ai/status | GPU / torch / YOLO 环境 |
| POST | /api/ai/load | 加载权重(可 allow_download) |
| POST | /api/ai/detect | 目标检测 |
| POST | /api/ai/slider | 滑块偏移求解 |
CLI 演练:
bash
python -m scripts.main
python -m scripts.main --accounts
python -m scripts.main --schedule
---
📁 项目结构
text
damaihelper/
├── web_server.py HTTP 服务 + REST + 静态托管
├── tools/
│ ├── install_deps.py 一键依赖(CUDA torch / YOLO / 前端)
│ └── gen_readme_assets.py 生成本地 README 图
├── web-ui/ Ant Design + React + Vite
│ └── src/pages/ 总览 / 配置 / 任务 / AI
├── web/
│ ├── index.html 旧版面板(兼容)
│ ├── images/ 截图 PNG
│ └── docs/integration_guide.md
├── scripts/
│ ├── task_runner.py 任务编排
│ ├── config_manager.py 配置读写
│ ├── yolo_engine.py YOLO 封装
│ ├── device_probe.py CUDA 探测
│ └── ...
├── config/ Top issues
#93怎么用 跪求3 comments · 2026-08-24#88这个能自动抢票吗?2 comments · 2026-08-04#92能不能给个使用教程哥,配置完好像没用啊1 comments · 2026-08-23#91给个联系方式、?1 comments · 2026-08-20#94怎么设置账号信息去抢呢0 comments · 2026-09-10#89大佬,刚刚看到一个帖子说:现在很多要在app中抢票,脚本需要配合抓包使用。这是否可以是“该渠道无法购票”这个问题的解决思路呀0 comments · 2026-08-04