前言¶
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
