把你的 AI 助手接到声屿的声音上
装上这个技能包，助手就知道怎么调用声屿：自动分段、逐段合成、
按角色分配音色、拼成一条完整音频。你不用再手写任何请求。
ZIP 约 46.3 KB · 纯 Python 标准库实现 · 无需 pip 安装
三步用起来
生成密钥 → 装进助手 → 说一句话
把技能包放进助手
下载后解压到助手的技能目录，或直接在项目里引用。下面给了 Claude Code / DSH、Cursor 和纯命令行三种方式。
对助手说一句话
「用声屿把这篇稿子念出来，女声，别太快。」助手会读完技能说明，列出可用音色让你挑，然后开始合成。
安装方式
三种方式任选，命令行那条不需要任何 AI 助手
Claude Code / DSH
解压到助手的技能目录，重启助手即可识别：
Windows 对应 %USERPROFILE%\.claude\skills\。只想在单个项目里生效，放到项目的 .claude/skills/ 下。
Cursor
把文件夹放到项目根目录，再新建 .cursor/rules/shengyu-voice.mdc：
装上之后能做什么
不是一份接口说明书，而是一套能交付成品的工作流
文字转语音
说一句「念出来」，助手挑好音色直接合成，返回 WAV 文件路径与时长。
长文 / 有声书
按标点自动切成 400 字以内的分段，逐段合成后合并成一条音频，段落之间自动加长停顿。
多人对话配音
写一份「角色: 台词」的脚本，每句话自动换成对应音色，一次合成整段对话或播客。
声音克隆
把手上的参考音频交给助手，它会检查时长和体积、上传、注册音色，完事直接拿去合成。
断点续传
分段落盘保存，任务中断后重跑会复用已完成的部分，不重复消耗额度，也不用从头再来。
先自检再动手
密钥、网络、音色三项先验证通过才开始合成；额度耗尽会立刻停下说明原因，不会循环重试烧额度。
包里有什么
全部是纯文本，可以直接读源码
- README.md6.1 KB · 可直接查看
- SKILL.md5.7 KB · 可直接查看
- examples/dialogue-demo.txt1.2 KB · 可直接查看
- references/api.md5.0 KB · 可直接查看
- scripts/shengyu.py28.4 KB · 可直接查看
SKILL.md 是助手读的说明书；scripts/shengyu.py 是全部逻辑所在，只用标准库，没有隐藏依赖。
下载完整技能包常见问题
下载与使用前，你可能想知道这些
什么是声屿语音技能包？
它是一份给 AI 助手看的说明书加命令行工具。装进 Claude Code、Cursor、Codex 等助手后，你只要说一句「把这篇稿子配成音频」，助手就知道该调哪个接口、怎么分段、怎么把几十段音频拼成一条完整的 WAV。
技能包收费吗？
技能包本身免费下载，代码全部开源可读。使用时的语音合成按声屿账号的每日额度计算，与网页端共用同一份额度，注册即可获得免费额度。
都需要安装什么？
只需要 Python 3.8 以上版本，不需要 pip 安装任何第三方库——技能包的命令行工具只用 Python 标准库写。
我的 API Key 会被上传或共享吗？
不会。技能包本身不包含任何密钥，Key 由你通过环境变量 SHENGYU_API_KEY 提供，只在你本机发往声屿的接口请求里使用。技能包完全在本地运行，可以直接阅读源码确认。
长文章会不会超长报错？
不会。声屿接口单次上限 500 字，技能包会自动按标点把长文切分成每段 400 字以内，逐段合成后再合并成一条音频，并在段落之间插入更长的停顿。合成前可以先用 --dry-run 预览分段，不消耗额度。
做有声书这样的大工程中断了怎么办？
加上 --keep-dir 参数后，每段音频都会单独保存。任务中断时重跑同一条命令，已经完成的分段会被直接复用，不会重复消耗额度，也不需要从头再来。
支持自行部署的声屿吗？
支持。技能包默认指向官方地址，自建部署只需把环境变量 SHENGYU_BASE_URL 设置成你自己的域名即可。从本站下载的包已经预置了本站地址。
AI 助手会不会反复重试把额度烧光？
不会。技能包明确区分了可重试与不可重试的错误：只有后端异常（502）会重试一次，密钥错误、权限不足、额度耗尽都会立即停下并说明原因，不会陷入循环调用。