前言¶
在 DeepSeek Harness 里做内容或演示时，经常需要「马上有一首能播的歌」：自己写词、找编曲、再导出 mp3，链路长；单纯让模型「描述一首歌」又拿不到文件。虾盘云音乐插件把「自然语言需求 → 写词 → Suno V6 出歌 → 可下载 mp3」收成 Agent 可调用的能力，Key 由使用者自备（BYOK），走虾盘云 API。
这是什么¶
虾盘云音乐（xiapan-music） 是维护者 dongsheng123132 发布的 DeepSeek Harness 插件，npm 包名为 dsh-xiapan-music，当前 Release 为 v0.1.1，许可证 MIT。同一仓库还提供 Agent Skill 入口，DSH 侧装插件即可。
底层调用 虾盘云 API，一把 sk-... Key 用于写词（文本模型）与 Suno V6 出歌。README 说明：一次「有人声完整出歌」约出 2 首完整歌（每首约 2 分钟），Suno 侧费用约 ¥2.4/次；纯音乐 BGM 约 ¥1/首；写词成本可忽略。以虾盘云实际扣费为准。
核心功能¶
装完并配置 Key 后，插件会注册「音乐」技能与 xiapan_music 工具，README 列出的能力包括：
- 一句话出歌：中文或英文描述风格与主题，自动写词并用 Suno V6 编曲演唱，默认一次 2 个版本。
- 已有歌词谱曲：传入歌词，默认一字不改唱出来。
- 纯音乐 / BGM：适合视频配乐、口播背景、播客片头等。
- 查余额：查看当前 Key 还能支持多少次出歌等。
- 出歌后可引导至 虾盘云画板 配画面、排歌词、做 MV。
仓库内示例：《凌晨两点的便利店》 — 由一句话需求经写词到 Suno V6 出 2 首完整歌（README 记录时长约 169s / 172s，流程约 76 秒、约 ¥2.4）。
安装与启用¶
运行环境要求 Node.js >= 22（见仓库 package.json）。
准备虾盘云 Key¶
- 在 api.u-claw.org.cn 注册，在「令牌管理」创建 Key。
- 在 充值页 充值（README 写 ¥10 起）。
- 若电脑已装虾盘 U 盘 / U-King，README 说明可 零配置，脚本自动读
~/.uking/device.json中的设备 Key。
安装 DSH 插件¶
推荐在 npm 审核前从 GitHub Release 安装：
dsh plugin --profile web add https://github.com/dongsheng123132/xiapan-music/releases/download/v0.1.1/dsh-xiapan-music-0.1.1.tgz
npm 包 dsh-xiapan-music 发布后也可：
dsh plugin --profile web add dsh-xiapan-music
或从源码安装：
dsh plugin --profile web add github:dongsheng123132/xiapan-music
安装后 重启 DSH。除 U-King 自动 Key 外，任选其一配置：
- 在
~/.dsh/.credentials.yaml的 refs 中增加XIAPAN_API_KEY: sk-... - 或环境变量：
export XIAPAN_API_KEY=sk-...
典型用法¶
在 DSH 对话里用自然语言描述即可，由 Agent 调用插件工具完成写词与出歌。README 30 秒上手示例：
写一首关于凌晨两点便利店的温柔 city pop
流程为：模型理解需求 → 写词 → 调用 Suno V6 → 返回可下载的 mp3（一次 2 首完整歌）。
若已有歌词，直接说明「用下面歌词谱曲、不要改词」并粘贴正文即可走「已有歌词谱曲」路径。
适用场景与注意¶
适合：需要在 Harness 工作流里快速产出可播放 demo、BGM 或完整歌曲的开发者；已持有虾盘云 Key 或 U-King 设备、接受按次计费的用户。
注意：
- 插件以 当前 dsh 进程权限 运行，安装前应阅读 GitHub 源码 与 MIT 许可证，确认 Key 存放方式符合你的安全策略。
- 出歌依赖外网 API 与虾盘云账户余额；失败时先查 Key、余额与网络。
- DeepSeek Harness 社区插件目录（如 SkillHub 插件页）为独立生态站点，与 DeepSeek / 幻方无官方从属关系；分类为 工作流。
结尾¶
虾盘云音乐把「描述 → 词曲 → mp3」接到 DSH 插件与 xiapan_music 工具上，BYOK 使用虾盘云，适合在 Agent 对话里一句话出歌或把现成歌词唱出来。
