yinhcao/yinchao-ai-music-skill

通过音潮开放平台，让 Codex、Claude Code 和其他 Agent 生成可播放的完整歌曲、纯音乐与 BGM，支持文字生成音乐、歌词谱曲、参考音频创作、歌曲续写和纯歌词创作。

YinChao is an AI music Agent Skill and DeepSeek Harness plugin that generates playable songs, instrumentals, and BGM from prompts, lyrics, or reference audio.

开放平台 · API 文档 · SkillHub · ClawHub · skills.sh · Awesome DSH Plugins · 版本记录

生成效果试听

无需安装即可先听音潮开放平台首页展示的生成效果：

• ▶ 自然稳定的情绪表达 — 听人声咬字、情绪表达与角色感
• ▶ 贴合主题的旋律记忆点 — 听主题旋律、副歌记忆点与情绪推进
• ▶ 层次丰富的风格化编曲 — 听人声、弦乐、鼓与笛等元素的编曲层次

安装

通用 Agent Skill

使用 Skills CLI 从 GitHub 安装：

npx skills add yinhcao/yinchao-ai-music-skill \
  --skill yinchao-ai-music \
  -g -y

更新已安装的 Skill：

npx skills update yinchao-ai-music -g

DeepSeek Harness Plugin

该插件已收录于 Awesome DSH Plugins；可在详情页查看条目，也可以直接运行下面的命令安装。

直接从 GitHub 安装到所使用的 DSH profile：

dsh plugin --profile web add github:yinhcao/yinchao-ai-music-skill

将 web 换成实际的 profile 名称。然后按下文配置 Harness credentials，并重启对应的 DSH 进程。

卸载：

dsh plugin --profile web remove yinchao-ai-music

如果 DSH 已通过其他方式安装过同名 Skill，请先移除旧副本，避免重复加载。

能做什么

• 根据主题、曲风、情绪、乐器和人声要求生成完整歌曲
• 根据风格、情绪、主题或使用场景生成无人声的纯音乐或 BGM
• 把已有歌词谱曲并演唱，默认保留原文
• 参考 MP3、WAV、公开音频地址或音潮歌曲 ID 创作新歌
• 从歌曲结尾或指定时间点继续创作和延长音乐
• 仅在用户明确要求时单独创作歌名和歌词
• 在长任务中保留任务 ID，避免中断后重复提交

普通歌曲和纯音乐使用 YinChao v4.0。用户只说“写歌”时，Skill 默认生成两个完整歌曲版本；要求“纯音乐”“BGM”“无人声”或“伴奏”时改用纯音乐生成；只有明确要求“只写歌词”时才不生成音频。

配置 API Key

先前往音潮开放平台创建 API Key。请勿把密钥发到聊天、Issue、日志或提交记录中。

通用 Skill

SkillHub、ClawHub、skills.sh、Codex、Claude Code 和本地脚本优先使用环境变量：

export YINCHAO_API_KEY="你的 API Key"

需要持久化配置时，推荐使用用户级配置文件 ~/.config/yinchao/.env；需要按项目隔离时，也可以使用当前目录的 .env：

# ~/.config/yinchao/.env
YINCHAO_API_KEY="你的 API Key"

其他可选方式：用 --env-file /path/to/.env 指定 dotenv 文件，或用 YINCHAO_API_KEY_FILE 指向仅含一行原始密钥的文件。读取优先级为：环境变量 → 密钥文件 → --env-file → 当前目录 .env → 用户级 .env。

请为密钥文件设置仅当前用户可读权限（如 chmod 600）；使用项目级 .env 时确认它已加入 .gitignore，不要把任何凭据文件提交到仓库。

DeepSeek Harness Plugin

DSH Plugin 推荐使用 Harness credentials。编辑 ~/.dsh/.credentials.yaml（设置了 DSH_HOME 时使用 $DSH_HOME/.credentials.yaml）：

version: 1

refs:
  YINCHAO_API_KEY: "你的 API Key"

如果文件已存在，只需把 YINCHAO_API_KEY 加到现有的 refs 下。然后运行：

chmod 600 "${DSH_HOME:-$HOME/.dsh}/.credentials.yaml"

密钥由 Harness 读取并仅传给音潮子进程，修改后会在下一次操作时生效。

使用本地参考音频或续写音频时，文件会上传至音潮开放平台用于本次创作。请只使用你有权使用的音频，并参阅隐私政策与服务条款。

使用示例

写一首温暖的中文民谣，木吉他和轻柔男声，主题是多年未见的朋友。

把下面这段歌词谱成一首完整歌曲，保持歌词原文不变：……

做一段轻快的原声吉他 BGM，温暖、松弛，适合咖啡馆使用，不要人声。

参考 /path/to/reference.mp3 的律动和氛围创作一首新歌，但不要复刻旋律。

把 /path/to/song.mp3 从 60 秒开始继续扩写，接下来唱这段歌词：……

本地开发

Skill 位于 skills/yinchao-ai-music。仓库根目录同时包含 Codex 和 DSH Plugin 配置，两者共用该 Skill。

运行离线校验和测试：

python3 tools/validate_skill.py
python3 -m unittest discover -s tests -v
npm pack --dry-run
npx skills add . --list

在 DSH Web 中测试本地 Plugin：

pack_dir="$(mktemp -d)"
package_file="$(npm pack --pack-destination "$pack_dir" --silent)"
dsh plugin --profile web add "$pack_dir/$package_file"
dsh --profile web --dump-config
dsh web

本地调用：

python3 skills/yinchao-ai-music/scripts/yinchao_music.py song \
  --prompt "温暖的中文民谣，木吉他，轻柔男声"

生成纯音乐：

python3 skills/yinchao-ai-music/scripts/yinchao_music.py instrumental \
  --prompt "轻快的原声吉他 BGM，适合咖啡馆氛围"

脚本默认输出适合 Agent 和工作流消费的精简 JSON；添加 --human 可输出歌名、试听地址和可用的歌词。

安全与许可

安全问题请参阅 SECURITY.md。公开反馈前请移除 API Key、任务 ID、私有音频地址和未发布歌词。

仓库代码采用 MIT License。许可证只适用于本仓库代码与 Skill 文件；平台服务、生成内容和品牌标识以音潮开放平台当时展示的条款为准。