声网实时互动 AgoraIO-Community/dsh-agora

dsh-agora

一个 DeepSeek Harness（DSH）插件，为你的智能体加上官方 Agora 技能，并内置声网支持。 装一次，就能用自然语言驱动语音 AI 智能体、RTC 音视频通话、RTM 聊天与信令、云端录制、Agora 命令行加速，以及服务端 token 生成。

技能内容从官方 AgoraIO/skills 仓库原样同步，因此始终与 Agora 文档和快速开始保持一致。

前置条件

- 已安装并运行 DeepSeek Harness（DSH）
- 一个 Agora 账号（构建真实应用时需要 token/App ID）

安装

dsh plugin --profile web add dsh-agora

注意：pnpm ≥ 8.15（例如 9.15）下，配置档工作区根目录会拒绝裸 add，报 ERR_PNPM_ADDING_TO_ROOT。遇到这种情况，加上 -w：

dsh plugin --profile web add -w dsh-agora

重启 web 配置档，agora 技能就会出现在技能目录里。

技能覆盖范围

| 领域 | 你能做什么 |
| 语音 AI 智能体（ConvoAI） | 构建语音智能体 / 语音机器人 |
| RTC | 音视频通话、直播、屏幕共享 |
| RTM | 聊天、在线状态、信令 |
| 云端录制 | 录制通话与直播流 |
| 服务端 | 在服务端生成 token 与 App ID |
| Server Gateway | 跨产品服务端协同 |
| Agora 命令行 | 命令行加速（已安装则自动检测） |

声网支持

同一个 agora 技能也覆盖声网区域（console.shengwang.cn）。发布时，插件会在每份产品参考文档顶部注入一道区域门——模型先确认是中国还是全球——并附带按产品划分的中国区差异表（cn.md），只有当用户面向中国大陆时模型才会加载：

| 产品 | 中国区差异 |
| RTC | 中国区（setArea({ areaCode: "CHINA" }) / AREA_CODE_CN）+ sd-rtn.com + 云代理 |
| RTM | 中国区（setArea({ areaCodes: ["CHINA"] }) / RtmAreaCode.CN）+ 中国区数据中心 |
| 云端录制 | api.sd-rtn.com + clientRequest.region="CN" + 中国大陆存储 |
| 服务端（token） | token 算法不变；中国区 REST 域名 + 凭证菜单路径 |
| Agora 命令行 | agora project create --region cn / --rtm-data-center CN |
| ConvoAI | 英文快速开始骨架 + api.agora.io/cn 端点 + BYOK 服务商（fengming ASR，deepseek/minimax LLM/TTS） |

官方技能内容保持原样；区域门与中国区差异表在构建时生成（见 scripts/sync-deps.sh），所以仍然只有一个 agora 技能——没有单独的配套技能。

使用技能

用自然语言描述你的需求——比如「用 Agora 搭一个语音 AI 智能体」或「做一个 RTC 视频通话应用」。技能会路由到官方快速开始，并引导你完成设置，包括认证与 token 流程。

FAQ

这个仓库包含技能本身吗？ 官方 agora 内容在每次发布时从 AgoraIO/skills 仓库原样同步（不提交到本仓库）。声网相关的差异内容放在 assets/agora-cn/，发布时构建成按产品划分的 cn.md 映射，外加一个区域开关（见 scripts/sync-deps.sh）。

我需要安装 Agora 命令行吗？ 不需要。它是可选的；如果它在你的 PATH 里，技能会用它来加快工作流。

许可证

MIT