<a href="https://github.com/3899/ncmm/raw/v1.1.7/LICENSE">
  <img
    src="https://img.shields.io/github/license/3899/ncmm?style=flat-square"
  />
</a>
<a href="https://github.com/3899/ncmm/releases">
  <img
    src="https://img.shields.io/github/v/release/3899/ncmm?style=flat-square"
  />
</a>
<a href="https://github.com/3899/ncmm/releases">
  <img
    src="https://img.shields.io/github/downloads/3899/ncmm/total?style=flat-square"
  />  
</a>

🎵 ncmm

ncmm 是一个专门为网易云音乐人设计的命令行助手工具，基于 Go 语言开发。

本项目旨在帮助网易云音乐人 / 普通账号一键完成日常签到、自动执行黑胶 VIP 进阶任务（包括图文笔记自动发布与秒删、多粉丝号接力刷播放量等），帮助音乐人轻松获取并维持黑胶会员权益。工具严格遵循防风控设计，支持多账号安全隔离、播放量分摊回退、日推歌曲混听干扰以及本人播放拦截等安全策略。

🚀 核心功能

1. 🔑 账号登录管理 (ncmm login)：支持扫码登录、Cookie 导入与 CookieCloud 同步。
2. 🎵 模拟歌曲播放 (ncmm playids)：真实模拟音频流量下载、播放时长等待以及歌曲播放动作上报。
3. 📊 每日播放目标控制：支持随机每日播放上限、限额自增与达标退出机制，防范防刷检测。
4. 📅 每日任务一键签到 (ncmm sign)：一键完成黑胶 VIP 签到、云贝日常任务做任务（浏览、点赞、小众听歌等）。
5. 🎖️ 音乐人及黑胶进阶任务 (ncmm musician)：日常云豆签到领取、VIP 图文发布及多账号接力刷播放量任务。
6. 🎧 乐迷团任务 (ncmm fansgroup)：一键打卡已加入乐迷团的日常任务，包含播放、发布笔记、点赞分享等。
7. 📝 笔记发布独立命令 (ncmm note)：单独发布图文动态，并支持发布后自动秒删，维持个人主页整洁。
8. 📁 灵活的 --home 隔离机制：多账号下配置、Cookie、数据库、日志自动隔离，安全无干扰。

⚡ 快速上手

1. 账号登录

推荐使用 Cookie 导入：

# 导入主账号 Cookie 并标记为 -m (Main)
./ncmm login cookie '你的MUSIC_U_cookie串' -m

2. 一键运行批量任务

运行以下命令，即可在默认工作目录下根据配置文件规则自动执行日常一键打卡签到任务：

./ncmm task

(更多有关多账号隔离管理和 Docker 自动部署，请参阅下方详细文档。)

📚 详细文档

为了获得更好的阅读体验，本项目的详细使用手册已拆分为以下子文档：

• ⚙️ 配置文件详解 — 了解 config.yaml 详细配置字段及各项任务开关说明。
• 🐳 Docker 部署指南 — 了解如何通过 Docker/Docker Compose 一键部署并配合定时任务运行。
• 📖 命令行使用说明 — 查看完整的命令树、通用参数以及所有子命令的使用实例。
• 👥 多账号隔离最佳实践 — 学习如何使用 --home 管理多个粉丝账号，实现全自动接力刷量。
• 📝 版本更新记录 — 查看历史版本的新增功能、架构优化与 Bug 修复记录。

⚠️ 免责声明

本项目仅供学术研究和 Golang 学习探讨之用，请勿用于任何商业用途或违反网易云音乐服务条款的行为。对于使用本项目带来的任何账号封禁、数据丢失等不良后果，由使用者自行承担，本项目不提供任何连带保证。

🎖️ 鸣谢

👥 贡献者

crossgg

📦 参考项目