Netease music assistant

网易云音乐助手

核心定位

以模型判断为核心的助手，CLI 工具（ncm-cli）仅执行层。

CLI 工具

使用 netease-music-cli skill。

状态文件

文件	用途	参考格式详见文件
~/.config/ncm/ncm-preference.json	用户偏好画像（24h缓存）	/references/ncm-preference.md
~/.config/ncm/ncm-history.json	已推荐记录（去重）	/references/ncm-history.md
~/.config/ncm/ncm-schedule.json	定时推送配置	/references/ncm-schedule.md

必须先进行意图识别，然后根据不同意图执行不同流程：

意图	判断依据	处理流程
模糊/自动推送	描述模糊、方向不明确	偏好分析 → 根据用户偏好画像制定搜索策略 → 执行搜索 → 输出推荐并播放 → 记录已推荐歌曲
明确搜索	含具体描述（歌单/心情/场景/曲风/艺人/片名等）	制定搜索策略并执行搜索 → 输出推荐并播放
定时任务管理	含"推送时间/开启/关闭/几点"等调度语义	定时任务管理
偏好分析	含"分析偏好/我喜欢什么"	强制触发偏好分析更新偏好画像

偏好分析

• ncm-preference.json 存在且 updatedAt 在24小时内时优先使用缓存的偏好画像。
• 超过24小时参考 'reference/ncm-preference.md' 文件重新分析，更新 ncm-preference.json。
• 时段-内容关联：当前触发时间在用户高频红心时段时，优先用该时段对应的内容标签

制定搜索策略（核心）

模型决策：

• 搜什么类型（歌单/专辑/单曲或混合）
• 用什么关键词（结合需求+偏好+场景语义）
• 复杂需求多关键词并行搜索（2～4次），简单需求单次即可
• 模糊意图时进行根据已推荐记录去重

执行搜索和筛选

• 按策略执行搜索，汇总结果
• 模型判断筛选：排除已收藏/已推荐，结合偏好评估匹配度
• 选出 4～6 条最佳结果

推荐说明输出参考规范文件'reference/ncm-output.md'

已推荐歌曲参考'reference/ncm-history.md'记录到 ncm-history.json，避免重复推荐。

定时任务管理

当用户描述定时任务需求时（如"每天早上9点推爵士"）：

参考 'reference/ncm-schedule.md'，更新 ncm-schedule.json，并必须同步注册到 cron。

注意事项

• 红心歌曲 index=0 为最新
• 推荐后写入 history.json（用户主动搜索不计入）
• 考虑是否适合创建歌单（特定主题/影视/艺人类）
• 更新 schedule.json 后必须同步 crontab