前言¶
DeepSeek Harness (DSH) 采用插件化架构，允许通过安装插件来扩展智能体的能力。在开发涉及语音或视频的应用时，直接对接 Agora SDK 并处理多地区配置（尤其是神州云 Shengwang）往往需要编写大量配置代码。dsh-agora 插件将官方 Agora 技能集成到 DSH 中，通过自然语言指令即可调用其核心功能。
这是什么¶
dsh-agora 是一个 DeepSeek Harness (DSH) 插件。它将 AgoraIO/skills 仓库中的官方技能内容同步至 DSH，并在构建时注入神州云（Shengwang）的区域差异处理逻辑。安装后，DSH 代理即可通过自然语言操作 RTC、RTM、语音 AI 等功能。
核心功能¶
该插件集成了以下能力：
* Voice AI agents (ConvoAI)：构建语音智能体或语音机器人。
* RTC：视频通话、语音通话、直播流、屏幕共享。
* RTM：聊天、在线状态、信令。
* Cloud Recording：录制通话和直播流。
* Server：服务端生成 Token 和 App ID。
* Server Gateway：跨产品服务端协调。
* Agora CLI：CLI 加速（可选，安装后自动检测）。
安装与启用¶
通过命令行安装插件：
dsh plugin --profile web add dsh-agora
注意：如果你的环境使用 pnpm ≥ 8.15（如 9.15），执行 bare add 可能会报 ERR_PNPM_ADDING_TO_ROOT 错误。此时需在命令中添加 -w 参数：
dsh plugin --profile web add -w dsh-agora
安装完成后，重启 web profile，agora 技能即可在技能目录中生效。
典型用法¶
通过自然语言描述需求，插件会路由至官方的快速入门和指南页面，辅助完成配置。例如：
* “set up a voice AI agent with Agora”
* “build an RTC video call app”
适用场景与注意¶
- 前置要求：DSH 需已安装并运行；构建真实应用需要 Agora 账号以获取 Token 和 App ID。
- 神州云支持：插件内置了神州云区域支持（控制台地址为
console.shengwang.cn）。在构建时，系统会生成区域网关和 CN 映射文件（位于assets/agora-cn/），当用户请求指向中国大陆时，模型会自动加载相应的差异配置（如cn.md）。 - 内容同步：官方 Agora 技能内容是 verbatim 同步的，神州云的差异文件在发布时构建。
- CLI：Agora CLI 是可选的，如果已安装并加入 PATH，技能会利用其加速工作流。
短结尾¶
dsh-agora 插件为 DSH 用户提供了标准化的 Agora 服务接入方式，支持神州云环境，并通过自然语言降低开发门槛。所有功能均遵循 MIT 协议，官方内容同步自 AgoraIO/skills。
