dsh-agora 0.2.6 → 0.2.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (4) hide show
  1. package/README.md +5 -5
  2. package/assets/agora/references/cli/README.md +9 -21
  3. package/assets/agora/references/rtm/README.md +2 -2
  4. package/package.json +1 -1
package/README.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # dsh-agora
2
2
 
3
- **A DeepSeek Harness (DSH) plugin that adds the official Agora skill — with China-mainland (国内/声网) support baked in — to your agent.** One install gives you voice AI agents, RTC video/voice calls, RTM chat & signaling, Cloud Recording, Agora CLI acceleration, and server-side token generation — driven from natural language.
3
+ **A DeepSeek Harness (DSH) plugin that adds the official Agora skill — with Shengwang support baked in — to your agent.** One install gives you voice AI agents, RTC video/voice calls, RTM chat & signaling, Cloud Recording, Agora CLI acceleration, and server-side token generation — driven from natural language.
4
4
 
5
5
  The skill is synced verbatim from the official [AgoraIO/skills](https://github.com/AgoraIO/skills) repository, so it always matches the Agora docs and quickstarts.
6
6
 
@@ -36,9 +36,9 @@ Restart the web profile, and the `agora` skill appears in the skill catalog.
36
36
  | **Server Gateway** | Cross-product server coordination |
37
37
  | **Agora CLI** | CLI acceleration (auto-detected if installed) |
38
38
 
39
- ## China-mainland (国内/声网) support
39
+ ## Shengwang support
40
40
 
41
- The same `agora` skill covers the China-mainland (国内 / 声网 / `console.shengwang.cn`) region. At release time, the plugin appends a per-product China delta to each product reference, so the model picks the right section based on the user's intent (国内 vs global):
41
+ The same `agora` skill covers the Shengwang region (`console.shengwang.cn`). At release time, the plugin appends a per-product CN delta to each product reference, so the model picks the right section based on the user's intent (China vs global):
42
42
 
43
43
  | Product | CN delta |
44
44
  |---|---|
@@ -46,7 +46,7 @@ The same `agora` skill covers the China-mainland (国内 / 声网 / `console.she
46
46
  | RTM | CN region (`setArea({ areaCodes: ["CHINA"] })` / `RtmAreaCode.CN`) + CN data center |
47
47
  | Cloud Recording | `api.sd-rtn.com` + `clientRequest.region="CN"` + mainland storage |
48
48
  | Server (token) | token algorithm unchanged; CN REST domain + credential menu path |
49
- | Agora CLI | `agora login --region cn` / `--rtm-data-center CN` |
49
+ | Agora CLI | `agora project create --region cn` / `--rtm-data-center CN` |
50
50
  | ConvoAI | endpoint (`Area.CN`) + CN vendor catalog + managed/BYOK — **recorded as current status; end-to-end not yet verified** |
51
51
 
52
52
  The official skill content stays verbatim; the CN deltas are injected at build time (see `scripts/sync-deps.sh`), so there is still a single `agora` skill — no separate companion skill.
@@ -57,7 +57,7 @@ Describe what you want in natural language — e.g. *"set up a voice AI agent wi
57
57
 
58
58
  ## FAQ
59
59
 
60
- **Does this repo contain the skill itself?** The official `agora` content is synced verbatim from the AgoraIO/skills repo at each release (not committed). The China-mainland (国内/声网) deltas are maintained in this repo under `assets/agora-cn/` and injected into the product references at build time.
60
+ **Does this repo contain the skill itself?** The official `agora` content is synced verbatim from the AgoraIO/skills repo at each release (not committed). The Shengwang deltas are maintained in this repo under `assets/agora-cn/` and injected into the product references at build time.
61
61
 
62
62
  **Do I need the Agora CLI installed?** No. It's optional; if it's on your `PATH`, the skill uses it for faster workflows.
63
63
 
package/assets/agora/references/cli/README.md CHANGED
@@ -162,33 +162,21 @@ Topic files link here instead of duplicating this playbook: [install-auth.md](in
162
162
 
163
163
  <!-- CN-REGION 触发条件：仅当用户目标是国内/声网/China/CN/大陆时适用本段；若用户未说明 region，先问"国内还是海外"再决定；海外（global/console.agora.io）场景跳过本段。 -->
164
164
 
165
-
166
165
  # 国内 CLI 命令与版本
167
166
 
168
- 验证基线：CLI `0.2.8`（`agora introspect --json` 实测）。
169
-
170
- > 注意版本漂移：`agora` skill 内容基线是 CLI `0.2.1`，其中 `agora project create --region global|cn`
171
- > 在 `0.2.8` 已**不存在**——国内 flag 已经搬家到 login / data-center。
172
-
173
- ## 国内命令面（0.2.8 实测）
174
-
175
- - 登录国内控制台：`agora login --region cn`（等价 `agora auth login --region cn`；默认 `global`）
176
- - RTM 数据中心：`agora project create ... --rtm-data-center CN`（可选 `CN|NA|EU|AP`，默认 `NA`）
177
- - 一键脚手架：`agora init <name> --template <t> --rtm-data-center CN`
178
- - Webhook 投递区域：`agora project webhook create ... --delivery-region cn`（可选 `cn|sea|na|eu`）
167
+ 验证基线：与上游 `agora` skill 一致 —— CLI `0.2.1`。
179
168
 
180
- ## 版本要求
169
+ ## 国内命令面（0.2.1）
181
170
 
182
- - CN 入口（`login --region cn`、`--rtm-data-center CN`）比 `agora` skill 的验证基线 `0.2.1` 新。
183
- - **确切引入版本待钉**：本机 `0.2.8` 已实测具备这两个 flag；低于该版本的 CLI 没有它们。
184
- - 落地建议：国内路径要求 CLI 至少为实测具备 CN flag 的版本（当前以 `0.2.8` 为参照下界）。
171
+ - 选 CN 区域：`agora project create <name> --region cn`（`--region global|cn`）
172
+ - RTM 数据中心：`agora project create <name> --rtm-data-center CN`（flag 在 0.2.1 已有；官方示例只列 `EU`/`AP`，`CN` 为国内数据中心）
173
+ - 一键脚手架：`agora init <name> --template <t> --region cn`
185
174
 
186
- ## 端点相关环境变量（`agora env-help --json` 实测）
175
+ ## 说明
187
176
 
188
- - `AGORA_CONSOLE_URL` — 覆盖 `agora open --target console` 的 URL
189
- - `AGORA_API_BASE_URL`（默认 `https://agora-cli.agora.io`）
190
- - `AGORA_OAUTH_BASE_URL`（默认 `https://sso2.agora.io`）
177
+ - 登录：`agora login`（0.2.1 无 region 参数；区域在创建/选择项目时用 `--region` 指定）。
178
+ - 版本漂移：较新 CLI（如 0.2.8）把 `--region` 从 `project create` 挪到了 `login`。若本机 CLI 比 0.2.1 新，按上游 `agora` skill 规则用 `agora introspect --json` 现查当前命令面。
191
179
 
192
180
  ## 待验证
193
181
 
194
- - `agora login --region cn` 的 OAuth 流程端到端（需声网账号实测）。
182
+ - `agora project create --region cn` 端到端创建国内项目（需声网账号实测）。
package/assets/agora/references/rtm/README.md CHANGED
@@ -178,7 +178,7 @@ let rtmClient = try AgoraRtmClientKit(config, delegate: nil)
178
178
 
179
179
  | 层 | 入口 | 作用 | CN 取值 |
180
180
  |---|---|---|---|
181
- | **控制面**（项目/凭据落在哪个区域后端） | CLI `agora project create ... --rtm-data-center CN` / `agora init --rtm-data-center CN` | 决定项目在哪个区域后台开通、去哪个控制台拿 App ID | `CN`（另 `NA`/`EU`/`AP`，默认 `NA`） |
181
+ | **控制面**（项目/凭据落在哪个区域后端） | CLI `agora project create ... --rtm-data-center CN` / `agora init --rtm-data-center CN` | 决定项目在哪个区域后台开通、去哪个控制台拿 App ID | `CN`（另 `NA`/`EU`/`AP`） |
182
182
  | **数据面**（SDK 运行时连哪个 SDRTN 边缘区域） | 客户端 area code（§1–§3 的 `setArea` / `areaCode`） | 决定 SDK 连到哪个区域的 RTM 服务边缘节点 | Web `"CHINA"`；Android `RtmAreaCode.CN`；iOS `.CN` |
183
183
 
184
184
  - CLI 的 `--rtm-data-center CN` **不会**替客户端设置 area code，反之亦然：国内部署要**两者都设**
@@ -187,7 +187,7 @@ let rtmClient = try AgoraRtmClientKit(config, delegate: nil)
187
187
  （`CN/NA/EU/AS/JP/IN/GLOB`），没有字面一一对应（CLI 的 `AP` 无同名 SDK 码）。这是"控制面 vs 数据面"
188
188
  两个维度，不是同一枚举的两套别名。
189
189
 
190
- 来源：CLI 行为以 `agora` CLI 实测为准（`agora init --rtm-data-center CN` / `project create`）；SDK
190
+ 来源：CLI 控制面与上游 `agora` skill 基线（0.2.1）一致（`--rtm-data-center` flag）；SDK
191
191
  area code 见 §1–§3 来源。
192
192
 
193
193
  ### 5. CN 域名 / 端点（RTM Web 消息频道）
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "dsh-agora",
3
- "version": "0.2.6",
3
+ "version": "0.2.7",
4
4
  "description": "DSH skill bundle: the Agora skill (RTC, RTM, ConvoAI, CLI, Cloud Recording, tokens) synced verbatim from AgoraIO/skills at a pinned release tag. Install to add the `agora` skill to DeepSeek Harness.",
5
5
  "type": "module",
6
6
  "main": "index.js",