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