音潮 AI 音乐 yinhcao/yinchao-ai-music-skill

YinChao AI Music｜音潮 AI 音乐创作

skills.sh

借助音潮开放平台，让 Codex、Claude Code 和其他智能体生成可播放的完整歌曲、纯音乐与 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 · 版本记录

生成效果试听

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

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

安装

通用智能体技能

使用 Skills CLI 从 GitHub 安装：

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

更新已安装的技能：

npx skills update yinchao-ai-music -g

DeepSeek Harness 插件

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

直接从 GitHub 安装到所使用的 DSH 配置档：

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

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

卸载：

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

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

能做什么

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

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

v4.5 歌曲支持最多 3000 字符提示词和 5000 字符歌词，纯音乐支持最多 3000 字符提示词。参考音频创作仍使用 v3.5，提示词/歌词上限分别为 1000/3000 字符。
平台已下线歌曲扩写/续写；旧 extend 命令只返回下线提示，不上传文件或提交任务。已有任务可继续用 status 查询。以上按 2026-10-16 的歌曲接口、纯音乐接口和更新日志更新。

配置 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 的律动和氛围创作一首新歌，但不要复刻旋律。

本地开发

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，适合咖啡馆氛围"

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

安全与许可

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

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