前言¶
DSH 的插件機制讓 agent 可以按需接入本地工具。對需要讓 agent 產出圖像、語音、音樂或 SFX 的場景,常見麻煩是同一角色或同一聲線在多次調用中不一致,生成結果也難以在生成後立即回聽、對照檢查。
Deepseek-Continuity 是 linxuhao 維護的 DSH 插件,許可證爲 MIT。它提供本地圖像、語音、音樂、SFX 生成,WAV 轉寫回聽,以及跨調用身份一致性;失敗生成不會被當作成功返回。
下面先介紹它的定位,再說明安裝和典型用法。
視覺身份與聲線¶
固定視覺身份:
create_character、create_animal、create_object或import_subject固定一個角色、動物或道具。- 之後調用
subject_image生成保持該身份的圖像。
固定聲線:
create_actor或import_actor固定一個聲線。- 之後調用
actor_tts生成臺詞。
這類調用的重點是跨調用一致性:先固定身份,再生成具體內容。
一次性生成與回聽¶
一次性生成:
generate_image用於單次圖像生成。generate_speech用於單次語音生成。
回聽與後期:
transcribe將生成的 WAV 轉寫回文本。remove_bg和slice_sheet用於後期處理。
transcribe 適合把生成的 WAV 讀迴文本,再與預期臺詞或腳本對照。
音樂、SFX、後端與狀態¶
音樂生成:
- 使用 Stable Audio。
- 最長 120 秒。
- 無循環點。
SFX 生成:
- 爲程序化 sfxr。
- 無模型。
- 無 VRAM。
後端與狀態:
- 可對接 OpenAI 形狀
/v1/images/*與/v1/audio/transcriptions後端。 continuity_status用於查詢插件狀態。- 本地懶加載模型,空閒時 GPU 不受影響。
- 失敗生成不會被當作成功返回。
安裝與啓用¶
dsh plugin 會調用 pnpm。若尚未安裝 pnpm,先執行:
corepack enable pnpm
配置後端:
uvx --from dsh-continuity continuity-setup
也可以從源碼運行:
uvx --from git+https://github.com/linxuhao/Deepseek-Continuity continuity-setup
將插件添加到已有 app bundle 的 profile:
dsh plugin --profile <your-profile> add dsh-plugin-continuity
PyPI 發行包爲 dsh-continuity,不要使用無關的 continuity-mcp。
典型用法¶
1、固定角色後生成圖像:
先調用 create_character,再調用 subject_image 生成保持同一角色的圖像。
2、固定聲線後生成臺詞:
先調用 create_actor,再逐行調用 actor_tts 生成同一聲線的 WAV。
3、回聽並檢查:
調用 transcribe 回讀生成的 WAV,並與臺詞對照。
適用場景與注意¶
適合在 DSH 中讓 agent 生成本地圖像、語音、音樂、SFX,並需要固定角色、動物、道具或聲線的場景。
需要注意:
- 風格請求可能只部分生效;參考圖主導輸出風格。
- 服裝/裝備可能疊加而非替換。
- 插件以當前 dsh 進程權限運行;安裝前應檢查源碼與許可證。
- 許可證爲 MIT。
鏈接¶
倉庫地址:https://github.com/linxuhao/Deepseek-Continuity