# 安装与配置 在DSH的插件安装入口输入`https://github.com/wz20/dsh-dafeiyu-dot`,确认安装并按提示启用,从侧栏「大肥鱼」进入配置中心。也可使用`dsh plugin --profile desktop add "https://github.com/wz20/dsh-dafeiyu-dot" --ignore-scripts`。本地开发继续支持`link:$PWD`安装。 1. **角色**:编辑名字、称呼和角色提示词;选择陪伴会话,开启鲸鱼娘模式。 2. **语音**:选择本地或API,填写兼容服务的地址、模型并选择自己的音色。API密钥通过密码输入保存至DSH凭据服务。首次配置可以先读取音色列表,再选择音色;检查连接后手动试听。 3. **记忆**:开启陪伴记忆,进入关系图查看、编辑与更正事实。复制完整宫殿目录可备份,须包含隐藏的`.state`目录。 4. **QQ**:启动支持OneBot正向WebSocket的本机网关,在配置页保存地址与令牌,选择陪伴会话,再使用主号完成配对。需要群回复时,单独启用该群,成员需真实@机器人。 5. **挂件**:按需开启显示与声音。触点文字可编辑,声音文件可放在本机插件数据目录的`assets/audio/`中。 ## 本地语音 本地兼容TTS默认地址是`http://127.0.0.1:3900/v1`,模型名`audiocpp`;应按自己的服务修改。其他API的情绪指令支持以服务文档和试听结果为准。语音识别使用DSH当前识别器,需要时在DSH准备识别模型。 本地情绪语音参考部署为[VoiceStudio](https://github.com/debpalash/VoiceStudio)的`audiocpp`引擎,通过[audio.cpp](https://github.com/0xShug0/audio.cpp)运行[Breeze TTS 2](https://github.com/breezeblue-ai/breeze-tts)。插件请求`POST /v1/audio/speech`,将朗读台词、音色及情绪指令分别放入`input`、`voice`、`instructions`。语气判断仅在开启情绪且使用本地`audiocpp`支持链路时执行。对话模型、音色和服务地址由使用者配置。 ## BreezeBlue 官方 API 1. 在 [BreezeBlue 官网](https://breezeblue.ai/)的开发者控制台创建自己的 API Key,并准备可用的账户额度。参考[官方接入文档](https://docs.breezeblue.ai/quickstart)。 2. 在插件「语音」页选择「API」,服务商选择「BreezeBlue 官方 API」。 3. 保留默认服务地址 `https://api.breeze.blue/v1`、模型 `breeze-tts-2`。自定义服务地址需使用 HTTPS;本机代理可使用 HTTP。 4. 在「BreezeBlue API密钥」填入 Key,点击「保存并读取音色」。密钥保存在 DSH 凭据服务;BreezeBlue 与 OpenAI 兼容 API 分别管理自己的密钥。 5. 从读取到的列表中选择音色,或填入自己账号可用的 `voice_id`。点击「保存并检查连接」,核对模型与音色。选择模型应以自己账号可用列表为准。 6. 开启「情绪语音」,选择表达方式和试听语气,点击试听。配置将用于桌面通话与 QQ 回复;自动朗读仍由对应开关控制。 此路线由云端运行模型,可直接使用账号里的音色。检查连接只读取模型和音色;试听及实际语音回复会发起合成并使用账号额度。单次朗读限清洗后的1000个字符,长文本请分段。非1倍语速的保音高调速仍需要本机 FFmpeg。 插件使用官方 `GET /v1/voices` 分页音色目录、`GET /v1/models` 和 `GET /v1/voices/{voice_id}` 检查配置,合成使用 `POST /v1/text-to-speech/{voice_id}?output_format=wav&delivery=sync`。请求通过 `xi-api-key` 鉴权,将情绪指令放入 `instructions` 和 `voice_settings.guidance_scale`。接口以[BreezeBlue官方文档](https://docs.breezeblue.ai/api-reference/text-to-speech/convert-text-to-speech)为准。 - **401**:检查 Key 是否有效,重新保存。 - **402**:检查账户额度与密钥预算。 - **403/404**:检查该账号能否使用所选模型、音色及服务地址。 - **429**:并发或请求频率达到限制,等待后手动重试。 - **超时、异常响应**:核对网络及服务状态;合成请求不会自动重复提交。 ## OpenAI 兼容 API 选择「API → OpenAI兼容 API」,填写兼容服务的 `/v1` 地址、模型、音色与密钥。此协议使用 `POST /audio/speech`,要求返回完整 WAV;各服务的音色目录支持可能不同,可手填音色ID后试听。当前通用兼容路线提供基础语音。切换服务商会保留各自的地址、模型、音色和密钥配置。 ## QQ 网关 QQ参考部署使用[NapCatQQ](https://github.com/NapNeko/NapCatQQ)。在网关启用OneBot v11正向WebSocket服务后,由插件主动建立连接;接收数组格式的消息段,发送文字、语音和图片。网关独立运行,登录状态由其管理。 QQ网关默认WebSocket为`ws://127.0.0.1:13001`,NapCat管理地址默认为`http://127.0.0.1:16099`,实际端口应与部署一致。在插件QQ页点击「重新连接」或「扫码登录」,即可在弹窗中查看二维码、刷新及确认登录状态。首次在弹窗的「NapCat连接设置」保存管理地址与WebUI Token,密钥由DSH凭据服务保管;Token可从自己的NapCat启动记录或管理配置中获取。手机QQ确认登录后,插件自动检查并恢复原有消息通道,保留原来的账号绑定。其他OneBot网关可继续使用原有连接方式。网关、DSH和语音服务需要保持运行。 本机插件数据目录为`$DSH_HOME/dsh-dafeiyu-dot/`,未设置`DSH_HOME`时使用`~/.dsh/dsh-dafeiyu-dot/`。自定义角色预览可放在`assets/role-preview.png`,自定义表情使用`assets/stickers/catalog.json`及同目录图片。自定义媒体只由当前本机插件读取,静态角色图与触点声音使用已鉴权的资源路由。 用户确认的现成清唱可登记在本机插件数据目录的`recorded-songs.json`中,格式为`{"version":1,"defaultRecordingId":"song-one","recordings":[{"id":"song-one","song":"曲名","audioFile":"/absolute/path/song.wav","sha256":"已确认音频的SHA-256","approved":true}]}`。未点名歌曲时播放默认曲目,点名时按曲名或`aliases`精确匹配;每次返回的歌曲音频与已确认文件保持一致,并绑定当前会话供桌面重播或QQ发送。目录和个人音频保存在本机运行数据中。 通话入口位于会话顶栏电话图标及配置中心「语音通话」。点击开始后才打开麦克风;识别、思考与播放阶段暂停收音。可以静音、打断、挂断,展开文字区后可打字和切换会话模型。 记忆默认保存于插件本机数据目录的`memory-palace/`。已有部署的`memoryPalaceRoot`设置继续沿用;希望保存在工作区时可指定该选项,并将宫殿目录排除版本控制。 内置挂件的账务与偏好沿用`$DSH_HOME/.dshw-*.json`及`$DSH_HOME/profiles/web/`对应文件;上传媒体沿用`whale-roles/`、`whale-audio/`、`whale-bubble-imgs/`目录。这些位置位于DSH本机数据范围内,与主插件的`dataRoot`选项独立。主号QQ私聊继承所选DSH会话已启用的工具权限;群成员使用独立受限会话。