NECloudMusic-Plugin

网易云音乐免费听插件，依赖 Free30Time HTTP 后端完成扫码登录、账号管理、免费听领取和拼图流程。

功能

• 扫码登录网易云音乐账号
• 查询账号列表和当前账号实时状态
• 切换当前账号
• 删除指定账号
• 执行免费听完整流程
• 执行拼图完整流程

命令

日常

命令	说明
#ncm帮助	查看命令帮助
#ncm登录	创建网易云扫码登录任务
#ncm领时长	执行免费听完整流程，使用全部广告类型
#ncm领时长 即领	执行免费听完整流程，使用 adType=click
#ncm领时长 跳转	执行免费听完整流程，使用 adType=stay
#ncm拼图	执行 1 轮拼图完整流程
#ncm拼图 2	执行 2 轮拼图完整流程

账号

命令	说明
#ncm账号	查询当前账号、VIP、免费听和拼图实时状态
#ncm账号列表	查看绑定账号列表和当前账号标记
#ncm切换账号 <序号>	按账号列表序号切换当前账号
#ncm删除账号 <序号>	按账号列表序号删除账号

配置

默认配置模板：

plugins/NECloudMusic-Plugin/config/default_config/config.yaml

运行配置：

plugins/NECloudMusic-Plugin/config/config.yaml

首次使用时复制模板并填写 apiKey：

baseUrl: "http://127.0.0.1:3080"
apiKey: ""
taskPollIntervalMs: 2000
taskTimeoutSeconds: 600

字段	说明
baseUrl	Free30Time 后端地址
apiKey	后端启动时打印的接口密钥，填写到本地运行配置
taskPollIntervalMs	异步任务轮询间隔，单位毫秒
taskTimeoutSeconds	异步任务等待超时，单位秒

账号、Cookie、checkToken、任务状态由后端托管。 config/config.yaml 是本地运行配置，已由插件内 .gitignore 忽略。

流程

登录

#ncm登录 创建扫码任务，插件发送二维码。扫码确认后插件轮询任务结果，并展示当前账号。

账号状态

#ncm账号 查询 /state，展示当前账号登录态、VIP、免费听和拼图实时状态。后端返回 diagnostics.ready=false 时，插件会展示缺失配置项并提示运行 getconfig。

账号管理

#ncm账号列表 使用列表序号展示账号。#ncm切换账号 <序号> 和 #ncm删除账号 <序号> 先读取账号列表，再把序号转换为后端 accountId。

删除当前账号后，后端会返回新的当前账号；账号清空时返回 null。

完整流程

#ncm领时长 [即领|跳转] 调用 free30，后端创建 free30-complete 任务。插件轮询任务完成后展示登录态、VIP 和免费听结果。

#ncm拼图 [轮数] 调用 jigsaw，后端创建 jigsaw-complete 任务。插件轮询任务完成后展示登录态、VIP 和拼图结果。

项目结构

plugins/NECloudMusic-Plugin
├── apps
│   ├── account.js   # 账号查询、切换、删除
│   ├── claim.js     # 免费听完整流程命令
│   ├── jigsaw.js    # 拼图完整流程命令
│   ├── login.js     # 扫码登录
│   └── ncm.js       # 帮助
├── model
│   ├── accountStore.js   # 账号 API
│   ├── apiClient.js      # Free30Time HTTP API 客户端
│   ├── configStore.js    # API 配置读取
│   ├── qrLoginService.js # 扫码登录任务 API
│   └── taskService.js    # 完整流程任务 API
├── utils
│   ├── format.js         # 通用展示格式化
│   └── pluginRuntime.js  # 插件运行时公共方法和任务锁
├── config
│   ├── config.yaml               # 本地运行配置
│   └── default_config/config.yaml # 默认配置模板
└── index.js              # 自动加载 apps/*.js

常见提示

提示	处理
API Key 未配置	复制默认配置模板到 config/config.yaml 并填写 apiKey
无法连接 Free30Time 后端	检查 baseUrl 和后端进程
当前账号不存在，请先扫码登录	使用 #ncm登录 添加账号
账号序号不存在	先用 #ncm账号列表 查看序号
当前账号已有同类任务执行中	等待当前账号的同类任务完成