Guyungy/damaihelper - 快速上手

由于 trendforge.devlive.top 访问受限，请切换到 trendforge.devlive.org 域名

项目介绍快速开始学习路径项目截图 2 贡献者 1 增长趋势 Commit 历史代码统计生态关系项目时间线项目竞品上榜历史

DamaiHelper 5分钟快速开始

一个面向学习与联调的多平台票务自动化助手骨架，含 Ant Design Web 控制台、REST 后端与本机 YOLO/CUDA 逻辑层，默认 dry-run 跑通流程。

环境要求

支持的操作系统

Windows macOS Linux

运行环境

Python 3.10+ 必需

所需工具

Git

克隆仓库

必需

Node.js

构建 React 前端（可选，未安装时回退旧版 HTML）

NVIDIA GPU + 驱动

启用 CUDA 加速（可选，无则自动 mock）

操作步骤

克隆仓库

获取项目源码并进入目录。

克隆仓库到本地

git clone https://github.com/Guyungy/damaihelper.git

进入项目目录

cd damaihelper

预期结果：：本地出现 damaihelper 目录并切换进去。

若网络受限，可使用 GitHub 镜像或下载 ZIP 解压。

一键安装并启动（推荐）

运行仓库自带的一键脚本，会安装依赖、构建前端（如有 npm）、启动服务并打开浏览器。

按环境安装依赖，有 GPU 时装 CUDA 版 torch

python tools/installdeps.py

启动 REST 后端并同源托管前端

python webserver.py

预期结果：：终端输出服务启动日志，默认监听 http://localhost:8765/ 。

Windows 也可使用仓库提供的 .bat 一键脚本；macOS/Linux 可用对应 shell 脚本。

浏览器查看控制台

打开首页确认 Web 控制台可访问。

控制台首页（总览/配置/任务编排/YOLO·CUDA）

http://localhost:8765/

预期结果：：页面显示总览面板，能看到 GPU / 后端状态卡片。

若打开的是旧版 HTML，先执行 cd web-ui && npm install && npm run build 再重启 webserver.py。

健康检查与 AI 状态

通过 REST 接口确认后端与 AI 环境就绪。

服务与任务快照

curl http://localhost:8765/api/health

GPU / torch / YOLO 环境

curl http://localhost:8765/api/ai/status

预期结果：：返回 JSON，health 显示服务正常，ai/status 显示 CUDA 探测结果（无 GPU 时为 mock 模式）。

Windows 无 curl 时可直接在浏览器打开这两个地址。

dry-run 跑通任务编排

启动默认 dry-run 的编排任务，在控制台观察日志与进度。

启动编排（默认不真实购票）

curl -X POST http://localhost:8765/api/ticket/start -H "Content-Type: application/json" -d '{"dryrun": true}'

拉取增量日志

curl http://localhost:8765/api/ticket/logs?offset=0

预期结果：：任务开始执行并持续输出阶段日志，前端任务编排页实时刷新进度。

需要停止时调用 POST /api/ticket/stop。

验证成功

确认 Web 控制台、REST 接口与 dry-run 编排均正常工作。

浏览器打开 http://localhost:8765/ 显示 Ant Design 控制台首页

GET /api/health 返回包含服务与任务快照的 JSON

GET /api/ai/status 显示 GPU / torch / YOLO 环境状态

启动 dry-run 后 /api/ticket/logs 能持续返回增量日志与进度

快速提示

依赖

requirements.txt 不含 torch，GPU 栈请务必用 tools/installdeps.py 安装，避免误装 CPU 轮子。

前端开发

开发前端热更新可在 web-ui 下运行 npm run dev，与 webserver.py 联调。

使用范围

项目默认 dry-run，不会真实下单，仅用于学习与联调。

日志

日志文件保留在 logs/ 目录，便于事后排查。

常见问题

打开首页仍是旧版 HTML 面板

执行 cd web-ui && npm install && npm run build 构建前端，然后重启 python webserver.py。

CUDA 不可用或 torch 显示 +cpu

运行 python tools/installdeps.py 重新安装 CUDA 版 torch；确认 NVIDIA 驱动正常且 Python 版本在 3.10+ 范围内。

端口 8765 被占用

关闭占用进程或修改 webserver.py 监听端口后重启。

chromedriver 版本不匹配

升级到 Selenium 4.6+ 使用自动驱动管理，或手动放置匹配的 chromedriver；项目默认 dry-run 不强制真浏览器。

无法安装或找不到 Node.js

Node.js 为可选项，未安装时服务会回退到 web/index.html 旧版面板，功能仍可验证。

下一步

查看 API 集成文档

阅读 web/docs/integrationguide.md 了解完整接口约定。

加载 YOLO 权重

调用 POST /api/ai/load（可带 allowdownload）并用 /api/ai/detect 与 /api/ai/slider 联调 AI 能力。

自定义配置

通过 GET/POST /api/config 读写 config/config.json 定制平台与任务参数。

参与贡献

Fork 后新建分支改进 Ant Design 体验、编排阶段、YOLO 权重或依赖安装兼容性并发 PR。