@tencent-rtc/trtc-agent-skills 0.1.0 → 0.1.3

package/knowledge-base/slices/conference/web/official-roomkit-login-ui.md

@@ -57,39 +57,67 @@ platform: web
 | 1 | 标题 `<h1>加入会议</h1>` | 32px |
 | 2 | 输入框：用户 ID | 16px |
 | 3 | 输入框：会议 ID（placeholder: "输入会议 ID（创建时可留空）"） | 16px |
-| 4 | 输入框：SDKAppID | 16px |
-| 5 | 输入框：UserSig | 16px |
-| 6 | 凭证说明区（见下方规范） | 24px |
-| 7 | 主按钮「创建并加入」 | 24px |
-| 8 | 分割提示行：1px 横线 + 居中「或」 | 16px |
-| 9 | 次级按钮「加入已有会议」（outline 样式） | — |
+
+**按 `usersig_source` 分支追加字段（二选一，勿混用）：**
+
+| `usersig_source` | 追加字段（顺序接在会议 ID 之后） |
+|---|---|
+| `local-dev` | 仅凭证说明区（见 §3.1 local-dev）— **无** SDKAppID / UserSig 输入框 |
+| `console` | 输入框 SDKAppID → 输入框 UserSig → 凭证说明区（见 §3.1 console） |
+
+| # | 元素 | 与下一项的间距 |
+|---|---|---|
+| … | 主按钮「创建并加入」 | 24px |
+| … | 分割提示行 + 「或」 | 16px |
+| … | 次级按钮「加入已有会议」 | — |
+
+> **`local-dev`**：凭证在 `src/config/basic-info-config.ts`，登录调用 `getBasicInfo(userId)`。
+> **`console`**：保留 SDKAppID + UserSig 平铺输入框，UserSig 从控制台粘贴（见 `usersig-handling.md` Path B）。
 
 ### 3.1 凭证说明区规范
 
-在 SDKAppID 和 UserSig 输入框下方，以信息提示卡片形式展示（非折叠、非 tooltip）：
+在凭证相关输入框下方（或 `local-dev` 时在会议 ID 下方），以信息提示卡片展示：
 
 - 容器：背景 `#F0F6FF`，圆角 8px，内边距 12px 16px
 - 图标：左侧 ℹ️ 信息图标，颜色 `#0D6BDE`
 - 文字：12px，颜色 `#444`，行高 1.6
 
-内容（固定文案，不可省略）：
+**`local-dev` 文案：**
+
+```
+本地调试：在 src/config/basic-info-config.ts 填入 SDKAppID 和 SecretKey
+（控制台 → 应用管理 → 应用信息）：
+• 国际站：https://console.trtc.io
+• 国内站：https://console.cloud.tencent.com
+
+登录时只需输入 UserID —— userSig 会按 UserID 自动生成，两者必须匹配。
+⚠️ SecretKey 仅用于本地调试；生产环境请由服务端签发 UserSig。
+```
+
+**`console` 文案（固定，不可省略）：**
 
 ```
 SDKAppID 和 UserSig 可从控制台获取：
 • 国际站：https://console.trtc.io
 • 国内站：https://console.cloud.tencent.com
 
-⚠️ 测试 UserSig 约 24 小时后失效，生产环境请由服务端签发。
-「服务端签发」链接指向：https://trtc.io/document/34385
+在「UserSig 生成&校验」中输入与登录页相同的 UserID 再生成 UserSig —— 两者必须匹配。
+⚠️ 测试 UserSig 约 24h 后失效；生产环境请由服务端签发。
+「服务端签发」：https://trtc.io/document/34385
 ```
 
 链接使用主色 `#0D6BDE`，hover 加下划线，`target="_blank"`。
 
 ### 3.2 输入框要求
 
-- 四个输入框（用户 ID、会议 ID、SDKAppID、UserSig）均为**平铺展示**，不使用折叠/展开/高级设置等隐藏形式。
-- 若通过 MCP 获取到 SDKAppID 和 UserSig，可预填值但仍保持输入框可见可编辑。
-- UserSig 输入框使用 `type="password"` 遮罩显示。
+**`local-dev`：**
+- 仅用户 ID、会议 ID；SDKAppID / SecretKey 在 `basic-info-config.ts`。
+- 禁止 UserSig 手填框。
+
+**`console`：**
+- 用户 ID、会议 ID、SDKAppID、UserSig 四个输入框均平铺展示。
+- UserSig 使用 `type="password"`。
+- 凭证说明必须强调 **控制台生成 UserSig 时 UserID 与登录页一致**。
 
 约束要点：
 - 卡片内每个表单元素**宽度 100%**（撑满卡片内边距宽度）。

package/knowledge-base/slices/conference/web/prejoin-check.md

@@ -82,12 +82,12 @@ camera-testing / microphone-testing / speaker-testing
 
 1. **把入会前完整检查流程与真实入会控制拆成两段主链路** —— 用户先完成会前自检，再进入房间主链路；会中如需局部检查，应由会中设备能力单独承接。
 2. **把用户选定的设备延续到会中** —— 会前选好的摄像头、麦克风和扬声器应直接复用于会中控制。
-3. **在页面卸载或进入会议前停止测试** —— 避免会前测试与会中真实采集相互冲突。
+3. **在页面卸载、路由离开或进入会议前停止全部测试** —— 必须调用 `stopCameraTest()` 与 `stopSpeakerTest()`（若 SDK 暴露），避免会前测试与会中真实采集冲突，以及扬声器测试音贯穿整场会议。
 4. **把权限拒绝和设备缺失写成可执行提示** —— 告诉用户下一步该切浏览器权限、换设备，还是直接降级进入。
 
 ### ❌ NEVER
 
-1. **不要把会前测试残留到会中流程里** —— 测试流和真实采集流应在入会时完成切换。
+1. **不要把会前测试残留到会中流程里** —— 测试流和真实采集流应在入会时完成切换；`startSpeakerTest` 后未 `stopSpeakerTest` 会导致测试音循环播放至会议结束。
 2. **不要只测试摄像头而忽略麦克风和扬声器** —— 用户真实会议体验依赖完整的音视频链路。
 3. **不要在测试失败时静默继续入会** —— 如果关键设备不可用，应给出明确风险提示或修复建议。
 
@@ -103,6 +103,7 @@ const {
   stopCameraTest,
   startMicrophoneTest,
   startSpeakerTest,
+  stopSpeakerTest,
   currentMicVolume,
 } = useDeviceState();
 
@@ -130,7 +131,8 @@ async function toggleCameraPreview(view: HTMLElement) {
   }
 }
 
-// 入会前停止测试释放设备资源
+// 入会前停止测试释放设备资源（扬声器测试音必须停止，否则会贯穿整场会议）
+await stopSpeakerTest?.();
 await stopCameraTest();
 ```
 
@@ -163,6 +165,7 @@ onMounted(async () => {
 });
 
 onUnmounted(async () => {
+  await stopSpeakerTest?.();
   await stopCameraTest();
 });
 
@@ -239,8 +242,8 @@ export function useConferenceDevice() {
 
 1. **在预览容器准备好后再调用 `startCameraTest()`** — 否则本地预览无法正常渲染。  
    **Verify**: 检查是否为 `view` 传入真实 DOM 节点。
-2. **在页面离开或流程结束时停止测试** — 否则设备资源会残留占用。  
-   **Verify**: 检查是否存在 `stopCameraTest()` 或等价清理逻辑。
+2. **在页面离开或流程结束时停止全部测试** — 必须配对 `stopCameraTest()` 与 `stopSpeakerTest()`（入会按钮点击、路由离开、`onUnmounted` 三处至少覆盖入会路径）。  
+   **Verify**: 搜索 `stopCameraTest` 与 `stopSpeakerTest`（或 SDK 等价 API）。
 
 #### MUST NOT（生成时绝不能出现）
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tencent-rtc/trtc-agent-skills",
-  "version": "0.1.0",
+  "version": "0.1.3",
   "description": "Installer for the TRTC Agent Skills suite (Chat, Call, RTC Engine, Live, Conference) + knowledge base, with one-command MCP setup for Claude Code / Cursor / CodeBuddy / Codex.",
   "bin": {
     "trtc-agent-skills": "bin/cli.js"
@@ -9,6 +9,12 @@
     "bin/",
     "skills/",
     "knowledge-base/",
+    "hooks/",
+    "ai-instructions/",
+    ".cursor/rules/",
+    "CLAUDE.md",
+    "AGENTS.md",
+    "CODEBUDDY.md",
     "README.md"
   ],
   "engines": {

package/skills/trtc/SKILL.md

@@ -143,15 +143,16 @@ Route to `../trtc-onboarding/SKILL.md` when ANY of these are true:
 - User asks for specific API details ("what are the parameters for applyForSeat?") → `docs` skill (follows slice-first fallback chain)
 - User asks a fact / decision question (pricing, quotas, product comparison, migration) → `docs` skill (reads llms.txt directly)
 
-**Review-request handling (hard rule — triage, do NOT refuse):** When the user uses review / audit / cross-check / validate / 帮我看看 / 是否正确 / check my X wording, do NOT perform a code-style review AND do NOT refuse outright. Instead **triage to the underlying intent** and route accordingly. The authoritative A/B/C/D/E triage logic (including the Decline template for option E) lives in `../trtc-onboarding/reference/path-b-troubleshoot.md` → **B-Q0**. On a review-worded turn, route to onboarding Path B so it can run B-Q0; for quick lookup from the root:
+**Review-request handling (hard rule — triage, do NOT refuse):** When the user uses review / audit / cross-check / validate / 帮我看看 / 是否正确 / check my X wording, do NOT perform a code-style review AND do NOT refuse outright. Instead **triage to the underlying intent** and route accordingly. The authoritative A/B/C/D/E/F triage logic (including the Decline template for option E) lives in `../trtc-onboarding/reference/path-b-troubleshoot.md` → **B-Q0**. On a review-worded turn, route to onboarding Path B so it can run B-Q0; for quick lookup from the root:
 
-- A. Symptom with pasted code ("doesn't work", crash, black screen, login fails) → onboarding Path B → B-Q1 symptom tree
+- A. Runtime symptom ("doesn't work", crash, black screen, login fails, 进房失败) → onboarding Path B → B-Q1 symptom tree (Conference Web menu when applicable)
 - B/C/D. Error code / official pattern / API comparison → `docs` skill (slice-first fallback chain)
+- F. Integration audit (检查遗漏 / 业务流程 / 对照官方 / 在线课堂流程) → Path B → **B-Audit** (`conference/integration-audit` slice)
 - E. Pure style/quality review with no concrete question → Decline (apply is internal quality gate, not user-facing review)
 
-See B-Q0 in path-b-troubleshoot.md for signals, option E decline template, and the full self-check list. If the intent is ambiguous, B-Q0 will ask ONE triage question. Never just say "I don't do code review" and stop — land the user on A–D if any signal is there.
+See B-Q0 in path-b-troubleshoot.md for signals, option E decline template, and the full self-check list. If the intent is ambiguous, B-Q0 will ask ONE triage question. Never just say "I don't do code review" and stop — land the user on A–F if any signal is there.
 
-**Answer-shape constraint (applies on every turn):** even when routing to A–D, your reply MUST NOT take review shapes — no "Critical Review Checklist", no "✅ Correct pattern vs ❌ Incorrect pattern" contrast as the main structure, no "Improvements you should make" list, no "Fixed version of your code" as a finished artifact. These shapes, produced after a review-worded request, constitute review behaviour even without the words "apply skill" / "verify" / "review your code". Use documentation / factual-lookup shapes instead (cite slice X, quote official pattern, link the error-code doc).
+**Answer-shape constraint (applies on every turn):** even when routing to A–F, your reply MUST NOT take review shapes — no "Critical Review Checklist", no "✅ Correct pattern vs ❌ Incorrect pattern" contrast as the main structure, no "Improvements you should make" list, no "Fixed version of your code" as a finished artifact. These shapes, produced after a review-worded request, constitute review behaviour even without the words "apply skill" / "verify" / "review your code". Use documentation / factual-lookup shapes instead (cite slice X, quote official pattern, link the error-code doc). Intent **F** (integration audit) may use the `conference/integration-audit` checklist shape.
 
 **The key distinction:** "I want to ADD/BUILD/IMPLEMENT X" → onboarding Path A2. "I want to UNDERSTAND/LEARN about X" → `docs` skill.
 
@@ -316,8 +317,8 @@ These rules are checked on **every turn**. If anything above conflicts with a ru
    **NEVER call any other MCP tool**, regardless of prefix
    (`mcp__tencentcloud-sdk-mcp__` / `mcp__tencent-rtc__` or any other). This
    explicitly includes:
-   - `get_usersig` — the skill does NOT generate UserSig; the user obtains a test
-     UserSig from the TRTC console (see `../trtc-onboarding/reference/usersig-handling.md`)
+   - `get_usersig` — use bundled local signing per
+     `../trtc-onboarding/reference/usersig-handling.md` (medical-template config pattern)
    - `get_callkit_api`, `get_faq`, `get_native_*`, `get_web_*`,
      `present_framework_choice` — these doc tools bypass the skill's knowledge
      base; answer from slices / llms.txt via `../trtc-docs/SKILL.md` instead

package/skills/trtc/room-builder/SKILL.md

@@ -57,12 +57,7 @@ RoomKit** 时，走官方 RoomKit 集成模式。
 4. 房间号 `roomId` 必须来自业务系统或由业务系统保证唯一；在线问诊、1v1 客服等
    双方不确定谁先建房的场景，可统一用业务单据号作为 `roomId` 并调用
    `conference.createAndJoinRoom()`。
-5. UserSig 处理必须复用 `skills/trtc-onboarding/reference/usersig-handling.md`
-   的规则：生成占位符 `userSig` + 引导用户去 TRTC 控制台获取测试 UserSig 填入
-   (skill 不自动签发)，正式环境由业务后端签发；前端只保留
-   `SDKAppID / userId / userSig` 输入项或占位。
-   不要生成 `src/utils/usersig.ts`，不要在前端依赖 `SecretKey`，不要用 `crypto-js`、
-   `pako`、`HmacSHA256` 或 `tls-sig-api-v2` 在浏览器端签名。
+5. UserSig：`usersig-handling.md` 三路径 — `local-dev`（bundled lib）、`console`（控制台粘贴，保留）、`backend`（生产）。
 6. 按钮、工具栏、内置按钮点击前拦截只使用官方界面微调 API：
    `conference.setWidgetVisible()` 隐藏/恢复内置按钮，
    `conference.registerWidget()` 添加自定义业务按钮或侧边面板，
@@ -83,9 +78,9 @@ RoomKit** 时，走官方 RoomKit 集成模式。
   `ui-*` class 数量规则。
 - 不要手写一套替代 RoomKit 主界面的会议 SFC；官方组件承担会议主界面，业务侧只
   负责外层路由、登录、房间号、事件监听和官方 UI 微调 API。
-- 不要生成前端 UserSig 签名器，尤其不要生成 `src/utils/usersig.ts`、不要把
-  `SecretKey` 放进 `src/config.ts`、不要新增 `crypto-js` / `pako` / `tls-sig-api-v2`
-  这类仅用于浏览器端签名的依赖。
+- 本地开发可使用 bundled signing lib（`src/config/basic-info-config.ts` + `lib-generate-test-usersig-es.min.js`），
+  与医疗模板同源；生产环境禁止把 SecretKey 放进客户端。
+- 不要手写 `src/utils/usersig.ts`，不要新增 `crypto-js` / `pako` / `tls-sig-api-v2`。
 - 不要用 CSS 选择器或 DOM hack 修改 RoomKit 内部按钮显隐、点击前权限和工具栏
   扩展；这些需求必须使用 `setWidgetVisible()`、`registerWidget()`、`onWill()`。
 - 不要在进房前写死 `setFeatureConfig({ shareLink })`；分享链接依赖最终 `roomId`，

package/skills/trtc/room-builder/assets/local-usersig/basic-info-config.ts

@@ -0,0 +1,39 @@
+/**
+ * Local development credentials — Conference Web integration.
+ *
+ * ⚠️ SDKSECRETKEY is for local debugging ONLY. Do NOT ship to production.
+ * Production UserSig MUST be issued by your backend.
+ *
+ * Source bundle (copy all 3 files into the target project's src/config/):
+ *   skills/trtc/room-builder/assets/local-usersig/
+ * Same signing lib as the medical-consultation template config.
+ */
+import LibGenerateTestUserSig from './lib-generate-test-usersig-es.min';
+
+export const SDKAPPID = 0;
+export const SDKSECRETKEY = '';
+export const EXPIRETIME = 604800;
+
+export function assertBasicInfoConfigured() {
+  if (!Number(SDKAPPID) || !String(SDKSECRETKEY).trim()) {
+    throw new Error(
+      '请先在 src/config/basic-info-config.ts 中配置 SDKAPPID 和 SDKSECRETKEY'
+    );
+  }
+}
+
+/** Generate login params for the given userId. userSig always matches userId. */
+export function getBasicInfo(userId: string) {
+  assertBasicInfoConfigured();
+  const generator = new LibGenerateTestUserSig(
+    SDKAPPID,
+    SDKSECRETKEY,
+    EXPIRETIME
+  );
+  return {
+    sdkAppId: SDKAPPID,
+    userId,
+    userSig: generator.genTestUserSig(userId),
+    scene: 5001 as const,
+  };
+}

package/skills/trtc/room-builder/assets/local-usersig/lib-generate-test-usersig-es.min.d.ts

@@ -0,0 +1,4 @@
+export default class LibGenerateTestUserSig {
+  constructor(sdkAppId: number, secretKey: string, expireTime: number);
+  genTestUserSig(userId: string): string;
+}