前言¶
DeepSeek Harness (DSH) 的設計理念是“一切皆插件”。在集成實時語音/視頻 API 時，開發者通常面臨兩個痛點：一是手動粘貼 API Key 到對話中，存在安全風險且每次會話需重新配置；二是直接調用 API 時，模型可能無意中觸發消耗信用的操作，且無法追蹤。dsh-realtimeavatar 插件將 Realtime Avatar 的能力封裝爲 Harness 的原生原語：API Key 由 Harness 持有並解析，文檔轉化爲按需技能，API 調用通過工具封裝，並配有 /rta 命令引導開發者完成從無 Key 到建立通話的流程。
這是什麼¶
dsh-realtimeavatar 是 DeepSeek Harness 的一個插件，用於實現實時 AI 角色的語音或視頻通話功能。該插件由 theinfluencecompany 維護，分類爲“趣味換裝”。
插件的核心定位是：
* 安全憑證託管：Harness 持有 API 密鑰，模型端不可見。
* 知識庫即技能：將 14 個公共文檔頁面轉化爲可按需加載的技能。
* 工具化封裝：通過 18 個 REST API 工具（以 rta_* 命名）暴露功能。
* 零依賴：不依賴任何運行時庫。
核心功能¶
插件提供了以下已覈實的能力：
- 實時通話：支持實時 AI 角色的語音/視頻通話。
- 狀態與餘額查詢：提供
rta_status檢查密鑰狀態與信用額度，以及rta_balance查看可用和預留信用額度。 - 資源管理：提供
rta_avatars列出工作區頭像，rta_avatar_create創建頭像，以及rta_session_mint創建通話會話。 - 文檔支持：提供
rta_docs獲取文檔。
安裝與啓用¶
當前資料中未明確提供具體的安裝命令。根據 package.json 信息，插件包含 lib、skills、cordis.patch.yml、README.md 和 LICENSE 等文件。
通常可通過插件目錄或 GitHub 倉庫安裝。使用前應檢查源碼與許可證（MIT）。
典型用法¶
開發者可以通過以下步驟與插件交互：
- 入門引導：使用
/rta命令進行入門。 - 檢查狀態：運行
rta_status檢查密鑰配置、信用額度及可用性。 - 管理資產：運行
rta_avatars列出工作區頭像，或使用rta_assets列出上傳的圖片資產（用於創建頭像）。 - 創建通話：運行
rta_session_mint創建通話會話。 - 創建頭像：使用
rta_avatar_create從圖像資產創建頭像。
適用場景與注意¶
- 審批機制：寫入操作默認啓用但需審批，任何消耗信用的操作始終會詢問批准。若需完全禁止寫入，可在配置中設置
readOnly:true。 - 冪等性控制：對於重試操作，必須使用
Idempotency-Key以防止重複執行。 - 網絡與安全：
transcriptWebhook必須配置 HTTPS 協議。 - 會話限制：通話時長受
maxSessionSeconds配置限制。
短結尾¶
dsh-realtimeavatar 通過將憑證、文檔和 API 工具封裝進 Harness，解決了開發者管理實時通話接口的複雜度，提供了安全的接入路徑。
- 插件目錄：https://www.skillhub.cn/plugins/theinfluencecompany/dsh-realtimeavatar
- GitHub：https://github.com/theinfluencecompany/dsh-realtimeavatar
