功能描述

使用天谱乐 AI 生成纯音乐、歌曲（含人声演唱）或歌词，将结果保存到本地。当用户提到"天谱乐""天璞悦""Tianpuyue""Tempolor""AI 作曲""AI 音乐""生成音乐""生成歌曲""生成歌词""BGM""背景音乐"时引用；当用户需要为视频、游戏或内容创作配乐时引用；当用户需要纯音乐（无人声）时引...

使用说明 (SKILL.md)

\r \r

天谱乐音乐生成\r

Name: 天谱乐音乐生成大师
Author: showtimewalker

\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

安全使用建议

This skill appears to do what it says: call Tianpuyue endpoints to generate music/songs/lyrics, poll job status, download resulting audio/lyrics, and save logs and outputs under OUTPUT_ROOT. Before installing, confirm: (1) you trust the Tianpuyue provider because your API key (TIANPUYUE_API_KEY) will be sent in requests; (2) the 'uv' runner used to launch scripts is acceptable in your environment; (3) your environment has a compatible Python version (scripts declare requires-python >=3.14, which may be unrealistic); (4) generated prompts and metadata are logged locally under OUTPUT_ROOT — avoid sending sensitive data in prompts if you do not want it persisted; (5) the skill does not upload outputs or publish shareable links (you must handle sharing separately). If any of these points are concerning, do not install or review/modify the scripts (common.py) to meet your security policies.

功能分析

Type: OpenClaw Skill Name: tianpuyue-music Version: 1.0.0 The skill bundle provides a functional interface for the Tianpuyue AI music generation service (api.tianpuyue.cn). The scripts (generate_music.py, generate_song.py, etc.) implement standard API task creation, polling, and file downloading logic using Python's built-in urllib library. There is no evidence of malicious behavior, data exfiltration, or harmful prompt injection; the code is well-structured and aligns perfectly with its stated purpose of generating and saving AI music locally.

能力评估

✓ Purpose & Capability

Name/description match the code and SKILL.md. The skill needs an API key (TIANPUYUE_API_KEY) and an output root for saving files (OUTPUT_ROOT), which are appropriate for a remote music-generation provider that returns downloadable audio/lyrics.

ℹ Instruction Scope

The SKILL.md and scripts explicitly limit behavior to: create tasks, poll status, download result files, and write local logs/outputs. Scripts log events (including user prompts) to local log files under OUTPUT_ROOT and call network endpoints only at BASE_URL (api.tianpuyue.cn) and the returned audio URLs. One minor inconsistency: script headers demand Python >=3.14, which may not match typical environments and could cause runtime problems if not available.

✓ Install Mechanism

There is no install spec (instruction-only with shipped scripts). The skill does not download arbitrary code at install time. It does require the 'uv' runner binary (used to invoke the scripts) — this is reasonable for the provided invocation examples but you should ensure 'uv' is a trusted runner in your environment.

✓ Credentials

Only TIANPUYUE_API_KEY (primary credential) and OUTPUT_ROOT are required, with an optional TIANPUYUE_CALLBACK_URL. These are proportionate to the skill's function. The API key will be sent to the provider in an Authorization header; users should ensure the key's scope and trust in the provider.

✓ Persistence & Privilege

always is false and the skill is user-invocable; it does not request permanent platform presence or modify other skills. It writes logs and outputs under OUTPUT_ROOT but does not alter system-wide agent settings.

版本历史

v1.0.0

tianpuyue-music 1.0.0 初始版本发布 - 支持通过天谱乐 AI 生成纯音乐、带人声歌曲或歌词，并保存结果到本地 - 提供音乐、歌曲、歌词的任务创建、状态查询及本地结果下载脚本 - 输出目录和 JSON 结果格式标准化，便于后续处理和集成 - 自定义参数和环境变量支持，适配多种使用和部署场景 - 自动适配内容创作、BGM、视频及游戏配乐等常见需求

元数据

Slug tianpuyue-music

版本 1.0.0

许可证 MIT-0

累计安装 0

当前安装数 0

历史版本数 1

常见问题

天谱乐音乐生成大师是什么？

使用天谱乐 AI 生成纯音乐、歌曲（含人声演唱）或歌词，将结果保存到本地。当用户提到"天谱乐""天璞悦""Tianpuyue""Tempolor""AI 作曲""AI 音乐""生成音乐""生成歌曲""生成歌词""BGM""背景音乐"时引用；当用户需要为视频、游戏或内容创作配乐时引用；当用户需要纯音乐（无人声）时引... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 89 次。

如何安装天谱乐音乐生成大师？

在 OpenClaw 或 Claude Code 对话框中运行命令「/install tianpuyue-music」即可一键安装，无需额外配置。

天谱乐音乐生成大师是免费的吗？

是的，天谱乐音乐生成大师完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。

天谱乐音乐生成大师支持哪些平台？

天谱乐音乐生成大师跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。

谁开发了天谱乐音乐生成大师？

由王新平（Wang-Xin-ping）（@showtimewalker）开发并维护，当前版本 v1.0.0。

天谱乐音乐生成大师