前言¶

在 DeepSeek Harness（DSH）的工作流中，让智能体直接产出音频内容往往需要绕过插件系统或调用外部 API。yinchao-ai-music 作为一个 DSH 插件，通过集成音潮开放平台的能力，让智能体能够根据文本描述或歌词直接生成可播放的歌曲、纯音乐或背景音乐。它将音频生成能力封装为标准的 DSH 插件，方便在多轮对话或复杂工作流中调用。

插件简介¶

这是一个由 yinhcao 维护的 AI 音乐生成 Agent Skill。它支持通过文字描述、歌词或参考音频来生成完整的歌曲、纯音乐（BGM）或对现有音乐进行续写。插件作为 DeepSeek Harness 的组件运行，通过 Harness credentials 调用音潮开放平台的 API，实现从文本到音频的生成流程。

核心功能¶

插件提供了以下音频生成能力：
1. 文本生成歌曲：根据主题、曲风、情绪、乐器和人声要求生成完整歌曲。
2. 生成纯音乐：根据风格、情绪、主题或使用场景生成无人声的纯音乐或 BGM。
3. 歌词谱曲：把已有歌词谱曲并演唱，默认保留原文。
4. 参考音频创作：参考 MP3、WAV、公开音频地址或音潮歌曲 ID 创作新歌。
5. 音乐续写：从歌曲结尾或指定时间点继续创作和延长音乐。
6. 长任务处理：在长任务中保留任务 ID，避免中断后重复提交。
7. 按需生成内容：仅在用户明确要求时单独创作歌名和歌词。

安装与启用¶

安装插件需要使用官方提供的命令，不要手动拼接仓库地址。执行以下命令将插件添加到指定的 DSH profile：

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

安装完成后，需要在 Harness 中配置音潮开放平台的 API Key。

配置 API Key¶

在使用前，必须前往音潮开放平台创建 API Key。DSH Plugin 推荐使用 Harness credentials 进行配置。编辑配置文件（路径为 ~/.dsh/.credentials.yaml，或 $DSH_HOME/.credentials.yaml）：

version: 1

refs:
  YINCHAO_API_KEY: "你的 API Key"

修改后请设置文件权限，确保只有当前用户可读：

chmod 600 ~/.dsh/.credentials.yaml

典型用法¶

智能体可以通过自然语言指令调用插件功能。以下是一些典型的输入示例：

写一首温暖的中文民谣，木吉他和轻柔男声，主题是多年未见的朋友。
把下面这段歌词谱成一首完整歌曲，保持歌词原文不变：……
做一段轻快的原声吉他 BGM，温暖、松弛，适合咖啡馆使用，不要人声。
参考 /path/to/reference.mp3 的律动和氛围创作一首新歌，但不要复刻旋律。
把 /path/to/song.mp3 从 60 秒开始继续扩写，接下来唱这段歌词：……

适用场景与注意事项¶

该插件适合需要为智能体赋予音频生成能力的场景，例如内容创作助手或多媒体交互 Agent。

• 安全与许可：代码采用 MIT License；平台服务、生成内容和品牌标识以音潮开放平台当时展示的条款为准。请勿把密钥发到聊天、Issue、日志或提交记录中。
• 权限：请只使用你有权使用的音频，并参阅隐私政策与服务条款。
• 传输：使用本地参考音频或续写音频时，文件会上传至音潮开放平台用于本次创作。

结语¶

通过 yinchao-ai-music，开发者可以在 DSH 生态中直接引入 AI 音乐生成能力。更多细节可参考插件目录或源码仓库。