Music
Agent
让音乐推荐理解
“我现在想听什么”。
想听某种感觉，却不知道具体该搜什么歌。Music Agent 将自然语言即时需求转化为推荐、发现、试听与播放。
历史偏好知道过去，
但用户活在现在。
用户往往知道自己此刻想听什么感觉，却不知道具体该搜哪首歌。
Current Intent.
用户通常喜欢什么？
用户此刻想听什么？
产品定位，
功能设计。
Music Agent 从即时需求出发，把模糊听歌意图转化为推荐、发现、试听与播放。
Current Intent 优先于历史偏好
长期偏好用于个性化增强；用户此刻明确表达的场景、情绪与约束拥有更高优先级。
Discovery 是相对新鲜，而不是“从未听过”
系统只能依据当前可用记录描述未收藏、近期未推荐或较少出现；是否“以前没听过”由用户确认。
推荐可用 ≠ 正式播放可用
Catalog Candidate 可以进入推荐、Preview 或外部查看，但只有具备真实播放条件时才承诺 Formal Playback。
Unknown 不等于 Success
对象、权限或执行状态无法确认时，优先澄清、停止或降级，而不是用自然语言伪装完成。
实际产品体验，
直接展示实现效果。
V1 已打通从自然语言需求 → 推荐 → Preview / Playback → 连续反馈的核心体验，并在 macOS 上完成真实运行验证。
Intent → Recommendation
→ Preview / Playback → Feedback
产品把“现在想听什么”转化为可执行音乐结果，并让推荐、试听、播放与后续反馈保持在同一任务链路中。
从自然语言推荐，到 Preview / Playback / Feedback 的真实操作。
录制于当前 macOS V1 Demo Build。演示直接覆盖真实产品主链路，无需安装应用或配置 API Key 即可查看实际运行状态与核心交互。
从自然语言需求，
到可执行音乐结果。
从表达需求到获得可操作音乐结果，用户可以继续试听、播放或调整方向。
明确能力边界，
做出产品取舍。
V1 根据平台能力与执行可靠性收敛 Scope，并为不可用能力明确边界。
将无法可靠验证的持久写能力移出 V1。
Why：Like、Add to Library、Rating、Create / Edit Playlist 无法证明能够稳定执行并可靠确认结果，因此不作为 V1 可执行能力承诺。
先验证可执行路径，再让候选进入主结果。
Why：主要推荐至少需要一种真实可用路径，例如 Play、Preview 或外部查看；完全不可执行的候选默认不进入主结果。
将当前会话反馈与长期偏好分开处理。
Why：“今晚不要摇滚”描述的是当前 Session；只有明确的长期表达才作为 Long-term Preference Evidence。
对象不明确时先澄清，再执行。
Why：存在多个候选时不让 Agent 自行猜测目标；Fail-closed 优先于一次看似聪明但不可验证的执行。
Agent 规则，
保证行为可控、可信。
Agent 优先理解当前需求，歧义先确认，并只依据真实执行结果反馈状态。
从 Bad Case 出发，
收敛 Agent 的执行架构。
通过真实场景 UAT 与回归测试定位语义漂移、目标选择与执行可信度问题，并据此将关键决策逐步从模型自由判断收敛到结构化语义与代码工作流。
减少同一需求被重复解释
Bad Case 显示，同一输入在不同环节被反复解释可能导致任务方向漂移。当前采用 deterministic-first 的 TurnPlan 与结构化语义边界：模型负责理解，代码持有后续任务状态。
把关键目标选择交给确定性流程
对“随便播放一首”等请求，模型不直接决定最终执行对象；候选范围、选择权限与执行目标由结构化结果和代码规则约束。
先验证外部状态，再报告成功
播放等关键动作经过 Execution → Readback → Reconciliation，确认真实状态与目标一致后，Agent 才向用户报告成功。
固定任务验证，
持续检查真实表现。
Eval 不只检查“回答是否合理”，而是验证 Agent 是否遵守 Intent、Context、Tool Result、Failure / Safety 等产品契约。
Ambiguous Context
“播放那个。”
存在多个候选时先 Clarify，不随机选择并执行。
Current vs Long-term
历史偏好 Rock，但今晚想安静。
结果必须体现当前安静 / 舒缓约束。
Tool Failure / Verified Action
Playback Tool 返回失败。
必须保留真实失败状态；未经过成功执行与状态验证，不能回复“已经播放”。
Cold Start / Degradation
无 Preference / Library 不可读取。
降级到 Current Intent 与可用 Catalog Candidate，而不是虚构长期偏好或直接中断任务。
产品成果，
完整文档。
从产品问题、可运行 Demo、PRD 到公开实现仓库，形成“设计 → 实现 → 验证”的完整证据链。
V1 Demo Build
可运行的 macOS V1 Demo，覆盖自然语言请求、Recommendation、Preview / Playback、Feedback 与 Mini Player 等核心产品状态。
Product Demo
02:53 真实操作录屏，覆盖自然语言推荐、候选结果、Preview / Playback 与连续反馈等核心体验。
Public GitHub Repository
用于核验产品设计是否真正落地：包含 Agent Runtime、macOS App Shell、Product Eval、Automated Tests、Architecture Decisions 与 User Guide。
Full PRD V1.0
62 页：需求、Scope、User Flow、F01–F10、Agent / Prompt Design、Failure、Acceptance、Metrics、Risk，以及完整 Flow 与 Development Prototype Appendix。