\r \r

天谱乐音乐生成\r

\r 这个 skill 是纯内容生成能力，负责天谱乐的纯音乐/歌曲/歌词任务创建、状态查询和本地下载，不负责对象存储上传或分享链接生成。\r \r 适用场景：\r \r

• 用户明确指定使用天谱乐生成纯音乐、歌曲或歌词\r
• 多媒体工作流需要一个音乐生成供应商\r
• 已有 item_id，只需要查询进度或下载本地结果\r \r

使用脚本\r

\r 脚本位于 skill 目录内的 scripts/，运行时始终使用绝对路径。\r \r 设 TP_SKILL_DIR 为 .claude/skills/tianpuyue_music 的绝对路径：\r \r

• 纯音乐生成（完整流程）：uv run --python python $TP_SKILL_DIR/scripts/generate_music.py --prompt "..." --name "忧伤钢琴曲"\r
• 歌曲生成（完整流程）：uv run --python python $TP_SKILL_DIR/scripts/generate_song.py --prompt "..." --name "夏日海边"\r
• 歌词生成（完整流程）：uv run --python python $TP_SKILL_DIR/scripts/generate_lyrics.py --prompt "..." --name "青春离别"\r
• 纯音乐状态查询：uv run --python python $TP_SKILL_DIR/scripts/query_music_status.py --item-id \x3CID>\r
• 歌曲状态查询：uv run --python python $TP_SKILL_DIR/scripts/query_song_status.py --item-id \x3CID>\r
• 歌词状态查询：uv run --python python $TP_SKILL_DIR/scripts/query_lyrics_status.py --item-id \x3CID>\r \r

脚本参数\r

\r

纯音乐生成\r

\r | 参数 | 必需 | 说明 |\r |------|------|------|\r | --prompt | 是 | 音乐描述提示词，可包含节奏、调性、和弦、时长等 |\r | --name | 否 | 文件名描述，不超过 10 个中文字 |\r | --model | 否 | 模型名称，默认 TemPolor i3.5 |\r | --poll-interval | 否 | 轮询间隔秒数，默认 15 |\r | --timeout | 否 | 超时秒数，默认 900 |\r \r

歌曲生成\r

\r | 参数 | 必需 | 说明 |\r |------|------|------|\r | --prompt | 是 | 音乐描述提示词 |\r | --name | 否 | 文件名描述，不超过 10 个中文字 |\r | --model | 否 | 模型名称，默认 TemPolor v4.5 |\r | --lyrics | 否 | 自定义歌词（为空时自动生成） |\r | --voice-id | 否 | 演唱声音 ID，参考 references/voice_id_map.md |\r | --poll-interval | 否 | 轮询间隔秒数，默认 15 |\r | --timeout | 否 | 超时秒数，默认 900 |\r \r

歌词生成\r

\r | 参数 | 必需 | 说明 |\r |------|------|------|\r | --prompt | 是 | 歌词生成的提示文本 |\r | --name | 否 | 文件名描述，不超过 10 个中文字 |\r | --song-model | 否 | 适配的歌曲模型名称，默认 TemPolor v4.5 |\r | --poll-interval | 否 | 轮询间隔秒数，默认 10 |\r | --timeout | 否 | 超时秒数，默认 300 |\r \r

输出约定\r

\r

• 本地输出目录（相对于 OUTPUT_ROOT，默认为项目根目录）：\r
  • outputs/tianpuyue/music/\r
  • outputs/tianpuyue/songs/\r
  • outputs/tianpuyue/lyrics/\r
• 纯音乐/歌曲输出 JSON 至少包含：\r
  • type — music / song\r
  • provider — tianpuyue\r
  • item_id\r
  • local_path\r
  • source_url\r
• 歌词输出 JSON 至少包含：\r
  • type — lyrics\r
  • provider — tianpuyue\r
  • item_id\r
  • local_path\r
  • title\r
  • lyric\r \r

配置\r

\r

• 环境变量：TIANPUYUE_API_KEY（必需，未设置时直接报错）\r
• 环境变量：TIANPUYUE_CALLBACK_URL（可选，轮询模式下使用占位值即可）\r
• 环境变量：OUTPUT_ROOT（可选，输出根目录，支持 ~ 展开，默认为用户主目录）\r \r

协作方式\r

\r

• 如果用户只要求生成并得到本地文件，本 skill 可直接完成\r
• 如果用户还需要可访问链接，应由后续的交付环节继续处理\r
• 当用户未指定供应商时，是否使用天谱乐由多媒体内容生成 Agent 的预设策略决定\r