Skip to content

Repository files navigation

觅道录

Node.js License GitHub

寻觅真理,录制精华。一款专业的 HLS 流媒体视频下载管理工具。

目录

功能特性

  • 视频页面 URL 解析与信息提取
  • HLS 流媒体检测与解析
  • AES-128 加密视频下载支持
  • 实时进度跟踪与阶段显示
  • 下载日志实时查看
  • 已下载视频管理
  • 赛博朋克/修仙风格界面

快速开始

环境要求

  • Node.js 18+
  • npm 或 yarn
  • Git Bash (Windows 用户必须,用于提供 curl 命令)

安装

# 克隆项目
git clone https://github.com/ops120/midao-lookup
cd midao-lookup

# 使用国内镜像源安装依赖(推荐)
npm install --registry=https://registry.npmmirror.com

运行

  1. 启动后端服务:
npm run server
  1. 新开终端,启动前端:
npm run dev
  1. 浏览器打开 http://localhost:5173

使用说明

  1. 配置代理:留空则直连,用于下载受限资源时可填写代理地址(默认:http://127.0.0.1:33333

  2. 解析 URL:输入视频页面 URL,点击"解析 URL"

    • 系统将提取视频信息,包括标题、类型、分片数
  3. 开始下载:点击"开始下载"

    • 系统将执行:解析 URL -> 下载分片 -> 解密 -> 合并
  4. 监控进度:实时查看进度条和日志

  5. 管理视频:在列表中查看、播放或删除已下载视频

技术栈

分类 技术
前端 React 19, Vite, Tailwind CSS v4, Framer Motion, Zustand
后端 Express.js, Node.js
下载 curl, openssl

项目结构

midao-lookup/
├── server.js              # Express 后端服务
├── public/                # 静态资源
├── src/
│   ├── components/
│   │   ├── ui/           # UI 组件
│   │   └── panels/       # 功能面板
│   ├── stores/            # Zustand 状态管理
│   └── App.jsx           # 主应用
├── docs/                  # 文档目录
├── logs/                  # 日志目录 (自动创建)
├── downloads/             # 下载目录 (自动创建)
├── download_states/       # 下载状态目录 (自动创建)
└── package.json

API 接口

方法 路径 描述
POST /api/parse 解析 URL,提取视频信息
POST /api/download 启动下载任务
GET /api/status/:taskId 获取任务状态和日志
DELETE /api/cancel/:taskId 取消运行中的任务
GET /api/videos 列出已下载视频
GET /api/play/:filename 流式播放视频
DELETE /api/videos/:filename 删除视频文件

License

MIT

About

寻觅真理,录制精华。一款专业的 HLS 流媒体视频下载管理工具。

Resources

Stars

8 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages