Sign inSign up

halucinar/daqi-music-tagger

By halucinar

•Updated about 17 hours ago

自研极速私有音乐刮削与流派治理系统(双架构)

Image
0

150

halucinar/daqi-music-tagger repository overview

⁠🎵 Daqi Music Tagger (大旗音乐刮削系统)

全新自研的高性能、轻量级私有音乐库元数据刮削、流派治理与智能歌单生成系统。采用 Go 原生静态编译,内嵌现代暗黑 Web UI,单容器开箱即用(内置持久化 Redis 引擎),镜像仅 ~50MB。

Docker 官方镜像:halucinar/daqi-music-tagger:latest


⁠🌟 核心功能特性

  • 纯自研·极简高效:无任何商业限制、无臃肿运行环境依赖,原生多线程并发极速扫描。
  • 极速多平台刮削流水线:
    • 直连主流音源平台(网易云、酷狗、咪咕等),毫秒级获取高清封面、内嵌歌词与标准元数据;
    • 搭载 Jev 综合置信度评分引擎(物理音频时长严格硬约束 + 歌名/歌手清洗 + 词素 Levenshtein 匹配),百首曲目秒级全自动精准匹配。
  • 单曲精准候选点选:
    • 点击单曲【🔍 刮削】即刻弹出云端候选列表,支持多音源横向比对、封面与年份预览、自定义关键字重搜,一键采纳精准写入。
  • 独立艺术家与流派治理中心:
    • 刮削与流派打标清晰解耦:以“艺术家”为核心治理单元,自动聚合全库歌手画像;
    • 支持快捷选择场景/流派标签,支持一键调用本地大模型(LM Studio / Ollama / DeepSeek 等)对未识别风格的音乐人做风格推断;
    • 一键批量将艺术家流派继承给名下所有曲目,全库风格整齐划一。
  • 无损原子写入与标签隔离防护:
    • 独创基于临时文件的原子安全替换机制,写入失败自动回滚;
    • 流派打标采用专属 ID3v2 TIT1 (Grouping) 帧隔离写入,绝不覆盖、不破坏已有的歌手、歌名、专辑、封面与歌词。
  • Navidrome / Symfonium 智能场景歌单:
    • 自动基于场景流派标签生成通用 UTF-8 标准 #EXTM3U(.m3u8)歌单,各主流音乐服务端及播放器秒级识别。

⁠🚀 极速部署 (Docker)

⁠方式一:Docker CLI 单命令运行(自带内置 Redis,开箱即用)
docker run -d \
  --name daqi-music-tagger \
  --restart unless-stopped \
  -p 8086:8080 \
  -v /path/to/your/music:/musics \
  -v /path/to/your/data:/data \
  -e TZ=Asia/Shanghai \
  halucinar/daqi-music-tagger:latest

提示:若未设置 REDIS_ADDR,容器将在后台自动启动内置持久化 Redis 引擎,数据自动保存在挂载的 /data 目录下,免去单独搭建 Redis 容器的繁琐流程。

⁠方式二:Docker Compose

在您的工作目录下创建 docker-compose.yml:

version: '3.8'

services:
  daqi-tagger:
    image: halucinar/daqi-music-tagger:latest
    container_name: daqi-music-tagger
    restart: unless-stopped
    ports:
      - "8086:8080"
    volumes:
      - /mnt/user/musics:/musics
      - /mnt/user/appdata/daqi-tagger/data:/data
    environment:
      - TZ=Asia/Shanghai
      - CONFIG_PATH=/data/config.json
      # 可选:连接已有外部 Redis(留空则自动启用容器内置 Redis)
      # - REDIS_ADDR=192.168.1.100:6379

启动容器:

docker compose up -d

⁠📖 新手上路与使用说明

  1. 进入系统: 在浏览器输入 http://<您的宿主机IP>:8086/ 即可进入控制台。
  2. 第一步:音乐库扫描:
    • 页面首次启动时会自动扫描 /musics 目录下的音频文件(支持 mp3、flac、m4a、wav 等主流格式);
    • 也可随时点击顶部的【重新扫描】按钮进行增量扫描。
  3. 第二步:元数据刮削与写入:
    • 单曲精细刮削:在曲目列表中点击【🔍 刮削】,系统将列出所有音源候选项,挑选满意项后点击【采纳并写入】;
    • 批量自动刮削:勾选想要刮削的歌曲(或点击“选择当前页 / 筛选”),点击顶部【批量刮削】,系统将依据 Jev 高置信度模型全自动匹配封面、歌词与基础信息。
  4. 第三步:艺术家流派治理(可选):
    • 点击顶部导航【🎨 流派管理】;
    • 系统已自动提炼全库艺术家人数与已有画像。针对未打标的艺术家,您可以手动选择预设标签(如“摇滚/朋克”、“深夜emo”、“运动健身”等),亦可点击【AI 智能分析流派】让大模型辅助推断;
    • 点击【批量打标到歌曲】,即可将艺术家的标签写入名下所有音轨中,过程仅改写 Grouping 帧,不破坏已有歌曲元数据。
  5. 第四步:多媒体服务联动:
    • 打标完成的曲目在 Navidrome、Jellyfin、Emby、Symfonium 等客户端中均可直接按“分组/流派”过滤;
    • 生成的 .m3u8 歌单文件存放在播放列表目录中,播放器可直接播放相应场景歌单。

⁠⚙️ 挂载路径与环境变量说明

参数 / 目录类型说明
/musics卷挂载音乐库目录(映射宿主机音乐文件夹,需读写权限)
/data卷挂载持久化数据目录(保存系统配置文件与内置 Redis 缓存)
PORT环境变量容器内服务监听端口(默认 8080,可映射宿主机 8086)
REDIS_ADDR环境变量可选。外部 Redis 地址(格式如 192.168.1.100:6379,不填则使用内置)
AI_BASE_URL环境变量可选。兼容 OpenAI 格式的大模型 API 地址(亦可在 Web 设置面板中配置)
AI_API_KEY环境变量可选。大模型 API Key(本地模型一般随意填写)

Tag summary

Content type

Image

Digest

sha256:fdd8302a8…

Size

19.8 MB

Last updated

about 17 hours ago

docker pull halucinar/daqi-music-tagger