前言¶

在 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 音樂生成能力。更多細節可參考插件目錄或源碼倉庫。