@tencent-rtc/trtc-agent-skills 0.1.6 → 0.1.8

package/bin/cli.js

@@ -62,7 +62,10 @@ const SKILL_ALLOWLIST = new Set([
   "trtc-docs",
   "trtc-conference",
   "trtc-ai-service",
+  "trtc-ai-oral-coach",
+  "trtc-ai-realtime-interpreter",
   "trtc-chat",
+  "trtc-push",
 ]);
 
 function getSkillNames() {
@@ -106,6 +109,96 @@ const MCP_TARGETS = {
 const MCP_SERVER_NAME  = "tencent-rtc-skill-tool";
 const MCP_SERVER_ENTRY = "@tencent-rtc/skill-tool@latest";
 
+// Multi-MCP registry. tencent-rtc-skill-tool is always installed via npx.
+// trtc-push-mcp is now public on npm and should be installed automatically with
+// the skill suite. Maintainers can still force a local checkout via
+// TRTC_PUSH_MCP_ENTRY / TIMPUSH_MCP_ENTRY when validating unpublished MCP code.
+const TRTC_PUSH_MCP_NAME = "trtc-push-mcp";
+const TRTC_PUSH_MCP_PACKAGE = process.env.TRTC_PUSH_MCP_PACKAGE || "@tencent-rtc/trtc-push-mcp@1";
+
+function getDefaultPathFallbacks({ platform = process.platform, env = process.env } = {}) {
+  if (platform === "win32") {
+    const systemRoot = env.SystemRoot || env.WINDIR || "C:\\Windows";
+    return [path.win32.join(systemRoot, "System32"), systemRoot];
+  }
+  return ["/opt/homebrew/bin", "/usr/local/bin", "/usr/bin", "/bin", "/usr/sbin", "/sbin"];
+}
+
+function buildNodePathEnv({
+  execPath = process.execPath,
+  pathEnv = process.env.PATH || "",
+  platform = process.platform,
+  env = process.env,
+} = {}) {
+  const nodeBin = path.dirname(execPath);
+  const fallback = getDefaultPathFallbacks({ platform, env });
+  const seen = new Set();
+  return [nodeBin, ...pathEnv.split(path.delimiter), ...fallback]
+    .filter(Boolean)
+    .filter((part) => {
+      if (seen.has(part)) return false;
+      seen.add(part);
+      return true;
+    })
+    .join(path.delimiter);
+}
+
+function buildNpxMcpEntry(packageName, { execPath = process.execPath, pathEnv = process.env.PATH || "" } = {}) {
+  return {
+    type: "stdio",
+    command: "npx",
+    args: ["-y", packageName],
+    env: {
+      PATH: buildNodePathEnv({ execPath, pathEnv }),
+    },
+  };
+}
+
+function resolveTrtcPushMcpEntry({
+  env = process.env,
+  execPath = process.execPath,
+  existsSync = fs.existsSync,
+} = {}) {
+  const fromEnv = env.TRTC_PUSH_MCP_ENTRY || env.TIMPUSH_MCP_ENTRY;
+  if (fromEnv && existsSync(fromEnv)) {
+    return {
+      command: "node",
+      args: [path.resolve(fromEnv)],
+      source: "env",
+      env: { TRTC_PUSH_MCP_REPORT_DISABLED: "1" },
+    };
+  }
+  return {
+    ...buildNpxMcpEntry(env.TRTC_PUSH_MCP_PACKAGE || TRTC_PUSH_MCP_PACKAGE, {
+      execPath,
+      pathEnv: env.PATH || "",
+    }),
+    source: "npm",
+  };
+}
+
+function getMcpServersToInstall() {
+  const servers = [
+    {
+      name: MCP_SERVER_NAME,
+      entry: buildNpxMcpEntry(MCP_SERVER_ENTRY),
+    },
+  ];
+  const trtcPushMcp = resolveTrtcPushMcpEntry();
+  const entry = {
+    type: "stdio",
+    command: trtcPushMcp.command,
+    args: trtcPushMcp.args,
+  };
+  if (trtcPushMcp.env) entry.env = trtcPushMcp.env;
+  const note =
+    trtcPushMcp.source === "npm"
+      ? `npm → ${trtcPushMcp.args[1]}`
+      : `local → ${trtcPushMcp.args[0]}`;
+  servers.push({ name: TRTC_PUSH_MCP_NAME, entry, note });
+  return servers;
+}
+
 // Hooks distribution targets per IDE.
 //   claude / codebuddy / codex: hooks/ files copied to <root>/.{ide}/hooks/, and
 //     hooks/hooks.json is rewritten + merged into <root>/.{ide}/settings.json.
@@ -156,7 +249,6 @@ const HOOKS_TARGETS = {
     // PLUGIN_ROOT by walking up to the nearest dir containing skills/, so
     // this nested location still resolves correctly.
     hooksDir:        ".cursor/hooks/trtc-agent-skills",
-    hooksFiles:      ["cursor-adapter.py"],
     settingsFile:    ".cursor/hooks.json",
     sourceConfig:    "hooks-cursor.json",
     // The hardcoded path string we need to rewrite in hooks-cursor.json.
@@ -170,11 +262,13 @@ const HOOKS_TARGETS = {
 // one of these path-segment hints — every guardrail script we ship lives under
 // `skills/<skill>/hooks/` or `skills/<skill>/guardrails/`, and the cursor
 // adapter under our namespaced hooks subdir.
+// NOTE: trtc-topic and trtc-apply are no longer in SKILL_ALLOWLIST, but their
+// hints are kept here so --clean can remove hook entries left by older installs.
 const OWNED_COMMAND_HINTS = [
   "/skills/trtc/hooks/",
   "/skills/trtc/room-builder/guardrails/",
-  "/skills/trtc-topic/guardrails/",
-  "/skills/trtc-apply/guardrails/",
+  "/skills/trtc-topic/guardrails/",   // legacy — removed from allowlist, kept for cleanup
+  "/skills/trtc-apply/guardrails/",   // legacy — removed from allowlist, kept for cleanup
   "/skills/trtc-conference/hooks/",
   "/hooks/trtc-agent-skills/cursor-adapter.py",
 ];
@@ -249,6 +343,30 @@ function isSymlink(p) {
   catch { return false; }
 }
 
+// Local checkout install (npx from sibling / `node bin/cli.js` inside this repo)
+// should symlink skills so edits under skills/ are live in IDE skill roots.
+// Opt out with TRTC_SKILLS_COPY=1; force on with TRTC_SKILLS_SYMLINK=1.
+function shouldSymlinkSkills(skillsRootAbs, resolvedRoot) {
+  if (process.env.TRTC_SKILLS_COPY === "1") return false;
+  if (process.env.TRTC_SKILLS_SYMLINK === "1") return true;
+  const pkg = path.resolve(PKG_ROOT);
+  const root = path.resolve(resolvedRoot);
+  const skillsRoot = path.resolve(skillsRootAbs);
+  return root === pkg || skillsRoot.startsWith(pkg + path.sep);
+}
+
+function installSkillDir(src, dest, { symlink }) {
+  rmrf(dest);
+  if (symlink) {
+    ensureDir(path.dirname(dest));
+    const rel = path.relative(path.dirname(dest), src);
+    fs.symlinkSync(rel || src, dest, "dir");
+    return "symlink";
+  }
+  copyRecursive(src, dest);
+  return "copy";
+}
+
 // ── project root resolution ───────────────────────────────────────────────────
 // Walk UP from cwd for strong repo-root signals (P1 monorepo manifest,
 // P2 package.json workspaces, P3 .git). Otherwise P4 cwd-local package.json,
@@ -343,7 +461,7 @@ function printHelp() {
     ${c.dim("KB     :")} ${c.gray("alongside the skills root as knowledge-base/")}
     ${c.dim("Hooks  :")} ${c.gray("<projectRoot>/.{ide}/hooks/  +  settings file with hook events wired")}
     ${c.dim("Rules  :")} ${c.gray("CLAUDE.md / AGENTS.md / CODEBUDDY.md (marker-merged)")}
-    ${c.dim("MCP    :")} ${c.gray("tencent-rtc-skill-tool → IDE mcp config (npx @tencent-rtc/skill-tool@latest)")}
+    ${c.dim("MCP    :")} ${c.gray("tencent-rtc-skill-tool + npm trtc-push-mcp (local only with TRTC_PUSH_MCP_ENTRY)")}
 
   ${c.dim("Skills are copied as sibling dirs so relative routing (../trtc-onboarding) keeps working.")}
 `);
@@ -351,13 +469,13 @@ function printHelp() {
 
 function listSkills() {
   const descriptions = {
-    "trtc":             "Entry router — detects product/platform, routes to sub-skills",
-    "trtc-ai-service":  "AI customer service scenarios (TRTC Conversational AI)",
-    "trtc-onboarding":  "Get-started / integration / troubleshooting flow",
-    "trtc-docs":        "Docs & error-code lookup",
-    "trtc-topic":       "Step-by-step scenario walkthrough",
-    "trtc-search":      "Internal slice lookup (AI-facing)",
-    "trtc-apply":       "Internal compile/integration quality gate",
+    "trtc":               "Entry router — detects product/platform, routes to sub-skills",
+    "trtc-docs":          "Docs & error-code lookup",
+    "trtc-conference":    "Video conference / multi-person room scenarios",
+    "trtc-ai-service":    "AI customer service scenarios (TRTC Conversational AI)",
+    "trtc-ai-oral-coach": "AI oral speaking coach / 口语陪练 (TRTC Conversational AI)",
+    "trtc-chat":          "IM / Chat SDK integration",
+    "trtc-push":          "TIMPush offline push integration (via trtc-push-mcp)",
   };
   console.log(`\n  ${c.bold("Skills shipped in this package:")}\n`);
   for (const name of getSkillNames()) {
@@ -368,7 +486,7 @@ function listSkills() {
 }
 
 // ── core: skill install ─────────────────────────────────────────────────────────
-function cleanSkills(skillsRootAbs) {
+function cleanSkills(skillsRootAbs, ide) {
   if (!fs.existsSync(skillsRootAbs)) return 0;
   let wiped = 0;
   for (const name of getSkillNames()) {
@@ -378,9 +496,15 @@ function cleanSkills(skillsRootAbs) {
   // also wipe a co-located knowledge-base copy if present
   const kb = path.join(path.dirname(skillsRootAbs), "knowledge-base");
   if (fs.existsSync(kb)) { rmrf(kb); }
-  // also wipe a co-located hooks/ copy if present (npx-mode hook scripts)
-  const hooks = path.join(path.dirname(skillsRootAbs), "hooks");
-  if (fs.existsSync(hooks)) { rmrf(hooks); }
+  // Wipe only our exact hooks dir (not the IDE's hooks/ parent). For cursor
+  // this is the namespaced .cursor/hooks/trtc-agent-skills/ subdir; for other
+  // IDEs it coincides with the parent .{ide}/hooks/ dir.
+  const hooksTarget = HOOKS_TARGETS[ide];
+  const resolvedRoot = path.dirname(path.dirname(skillsRootAbs));
+  const hooksDir = hooksTarget
+    ? path.join(resolvedRoot, hooksTarget.hooksDir)
+    : path.join(path.dirname(skillsRootAbs), "hooks");
+  if (fs.existsSync(hooksDir)) { rmrf(hooksDir); }
   return wiped;
 }
 
@@ -462,14 +586,17 @@ function cleanHooksSettings(ideList, resolvedRoot) {
   }
 }
 
-function installSkills(skillsRootAbs) {
+function installSkills(skillsRootAbs, resolvedRoot) {
   ensureDir(skillsRootAbs);
+  const symlink = shouldSymlinkSkills(skillsRootAbs, resolvedRoot);
+  const modes = [];
   for (const name of getSkillNames()) {
     const src = path.join(SKILLS_SRC, name);
-    if (fs.existsSync(src)) {
-      copyRecursive(src, path.join(skillsRootAbs, name));
-    }
+    if (!fs.existsSync(src)) continue;
+    const mode = installSkillDir(src, path.join(skillsRootAbs, name), { symlink });
+    modes.push({ name, mode });
   }
+  return { symlink, modes };
 }
 
 // Copy knowledge-base so that skills can resolve it. Skills use
@@ -712,11 +839,7 @@ function installAiInstructions(ideList, resolvedRoot) {
 
 // ── MCP installation ──────────────────────────────────────────────────────────
 function installMcp(ideList, resolvedRoot) {
-  const serverEntry = {
-    type: "stdio",
-    command: "npx",
-    args: ["-y", MCP_SERVER_ENTRY],
-  };
+  const servers = getMcpServersToInstall();
 
   for (const ide of ideList) {
     const mcpTarget = MCP_TARGETS[ide];
@@ -728,7 +851,9 @@ function installMcp(ideList, resolvedRoot) {
     ensureDir(path.dirname(configPath));
 
     if (mcpTarget.format === "toml") {
-      installMcpToml(configPath, serverEntry);
+      for (const server of servers) {
+        installMcpToml(configPath, server.name, server.entry);
+      }
     } else {
       let config = {};
       if (fs.existsSync(configPath)) {
@@ -738,27 +863,39 @@ function installMcp(ideList, resolvedRoot) {
       if (!config.mcpServers || typeof config.mcpServers !== "object") {
         config.mcpServers = {};
       }
-      config.mcpServers[MCP_SERVER_NAME] = serverEntry;
+      for (const server of servers) {
+        config.mcpServers[server.name] = server.entry;
+      }
       fs.writeFileSync(configPath, JSON.stringify(config, null, 2) + "\n", "utf8");
     }
-    console.log(c.green("    ✓ ") + `${ide} MCP → ${configPath}`);
+    const labels = servers
+      .map(s => s.name + (s.note ? ` (${s.note})` : ""))
+      .join(", ");
+    console.log(c.green("    ✓ ") + `${ide} MCP → ${configPath}` + c.dim(` [${labels}]`));
   }
 }
 
-function installMcpToml(configPath, serverEntry) {
+function installMcpToml(configPath, serverName, serverEntry) {
   let content = fs.existsSync(configPath) ? fs.readFileSync(configPath, "utf8") : "";
 
-  const sectionHeader = `[mcp_servers.${MCP_SERVER_NAME}]`;
+  const sectionHeader = `[mcp_servers.${serverName}]`;
   const argsValue = JSON.stringify(serverEntry.args).replace(/,/g, ", ");
-  const newSection = [
+  const lines = [
     sectionHeader,
     `command = "${serverEntry.command}"`,
     `args = ${argsValue}`,
-  ].join("\n") + "\n";
+  ];
+  if (serverEntry.env && typeof serverEntry.env === "object") {
+    for (const [k, v] of Object.entries(serverEntry.env)) {
+      lines.push(`[mcp_servers.${serverName}.env]`);
+      lines.push(`${k} = "${String(v).replace(/"/g, '\\"')}"`);
+    }
+  }
+  const newSection = lines.join("\n") + "\n";
 
-  const escapedName = MCP_SERVER_NAME.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  const escapedName = serverName.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
   const sectionRegex = new RegExp(
-    `\\[mcp_servers\\.${escapedName}\\]\\n(?:(?!\\[)[^\\n]*\\n)*`,
+    `\\[mcp_servers\\.${escapedName}\\](?:\\.[^\\]\\n]+)?\\n(?:(?!\\[)[^\\n]*\\n)*`,
     "g"
   );
   content = content.replace(sectionRegex, "");
@@ -782,7 +919,7 @@ function installClaudePermissions(ideList, resolvedRoot) {
   if (!settings.permissions || typeof settings.permissions !== "object") settings.permissions = {};
   if (!Array.isArray(settings.permissions.allow)) settings.permissions.allow = [];
 
-  const rules = [`mcp__${MCP_SERVER_NAME}__*`];
+  const rules = [`mcp__${MCP_SERVER_NAME}__*`, `mcp__${TRTC_PUSH_MCP_NAME}__*`];
   const added = rules.filter(r => !settings.permissions.allow.includes(r));
   if (added.length > 0) {
     settings.permissions.allow.push(...added);
@@ -808,9 +945,13 @@ function installCursorPermissions(ideList, resolvedRoot) {
   }
   if (!Array.isArray(perms.mcpAllowlist)) perms.mcpAllowlist = [];
 
-  const rule = `${MCP_SERVER_NAME}:skill_analysis`;
-  if (!perms.mcpAllowlist.includes(rule)) {
-    perms.mcpAllowlist.push(rule);
+  const rules = [
+    `${MCP_SERVER_NAME}:skill_analysis`,
+    `${TRTC_PUSH_MCP_NAME}:*`,
+  ];
+  const added = rules.filter(r => !perms.mcpAllowlist.includes(r));
+  if (added.length > 0) {
+    perms.mcpAllowlist.push(...added);
     fs.writeFileSync(permPath, JSON.stringify(perms, null, 2) + "\n", "utf8");
     console.log(c.green("    ✓ ") + `cursor permissions → ${permPath}`);
   } else {
@@ -912,12 +1053,15 @@ function main() {
     console.log(`  ${c.bold(ide)}  ${c.gray("→ " + skillsRootAbs + "/")}`);
 
     if (isClean) {
-      const wiped = cleanSkills(skillsRootAbs);
+      const wiped = cleanSkills(skillsRootAbs, ide);
       if (wiped > 0) console.log(c.dim(`    ✓ cleaned ${wiped} existing skill ${wiped === 1 ? "entry" : "entries"}`));
     }
 
-    installSkills(skillsRootAbs);
-    for (const name of getSkillNames()) console.log(c.green("    ✓ ") + name + "/");
+    const { modes } = installSkills(skillsRootAbs, resolvedRoot);
+    for (const { name, mode } of modes) {
+      const tag = mode === "symlink" ? c.dim(" (symlink → skills/" + name + ")") : "";
+      console.log(c.green("    ✓ ") + name + "/" + tag);
+    }
 
     const kbDest = copyKnowledgeBase(skillsRootAbs);
     console.log(c.green("    ✓ ") + "knowledge-base/ " + c.dim("→ " + kbDest));
@@ -945,10 +1089,20 @@ function main() {
   console.log(`\n  ${c.bold("Done.")} ${c.dim("Just describe what you want to build in your IDE — the skill activates automatically.")}\n`);
 }
 
-try {
-  main();
-} catch (err) {
-  console.error(c.red(`\n  Error: ${err.message || err}\n`));
-  if (err.stack && process.env.DEBUG) console.error(c.dim(err.stack) + "\n");
-  process.exit(1);
+module.exports = {
+  getDefaultPathFallbacks,
+  buildNodePathEnv,
+  buildNpxMcpEntry,
+  resolveTrtcPushMcpEntry,
+  getMcpServersToInstall,
+};
+
+if (require.main === module) {
+  try {
+    main();
+  } catch (err) {
+    console.error(c.red(`\n  Error: ${err.message || err}\n`));
+    if (err.stack && process.env.DEBUG) console.error(c.dim(err.stack) + "\n");
+    process.exit(1);
+  }
 }

package/knowledge-base/conference/web/index.yaml

@@ -107,20 +107,20 @@ slices:
 
   - id: conference/official-roomkit-api
     name: 官方 RoomKit 适配层 API
-    keywords: [roomkit, tuiroomkit, tui-roomkit, conference-api]
+    keywords: [roomkit, tuiroomkit, tui-roomkit, conference-api, react, vue3, roomkit-web-react]
     tags: [official-roomkit, conference-api, conference-object, setWidgetVisible, registerWidget,
-           onWill, setFeatureConfig, createAndJoinRoom, joinRoom, UIKitProvider]
+           onWill, setFeatureConfig, createAndJoinRoom, joinRoom, UIKitProvider, React, Vue3]
     file: slices/conference/web/official-roomkit-api.md
     description: >
-      官方 RoomKit 集成模式下 conference 对象的完整 API 签名、枚举定义、调用时序和代码示例
+      官方 RoomKit 集成模式下 Vue3 / React conference 对象的完整 API 签名、枚举定义、调用时序和代码示例
       （ui_mode=official-roomkit 专用）
 
   - id: conference/official-roomkit-login-ui
     name: 官方 RoomKit 登录 UI
-    keywords: [roomkit, login-ui, tuiroomkit]
-    tags: [official-roomkit, login-ui, layout, form, UIKitProvider, LoginPanel]
+    keywords: [roomkit, login-ui, tuiroomkit, react, vue3]
+    tags: [official-roomkit, login-ui, layout, form, UIKitProvider, LoginPanel, React, Vue3]
     file: slices/conference/web/official-roomkit-login-ui.md
-    description: 官方 RoomKit 登录页的布局、表单、凭证提示与状态反馈规范，包括 UIKitProvider 与 LoginPanel 集成约束
+    description: 官方 RoomKit 登录页的布局、表单、凭证提示与状态反馈规范，包括 Vue3 / React UIKitProvider 与 LoginPanel 集成约束
 
   - id: conference/integration-audit
     name: Conference Web 集成审计

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

@@ -4,30 +4,44 @@ platform: web
 api_docs:
   - title: 快速接入 Web&H5 (Vue3)
     url: https://cloud.tencent.com/document/product/647/81962
+  - title: 快速接入 Web (React)
+    url: https://cloud.tencent.com/document/product/647/132839
   - title: 界面微调 (Web)
     url: https://cloud.tencent.com/document/product/647/129842
 ---
 
 # 官方 RoomKit 适配层 API — Web 实现
 
-> 本 slice 覆盖 `@tencentcloud/roomkit-web-vue3` 导出的 `conference` 对象的完整 API。
+> 本 slice 覆盖官方 RoomKit Web 包导出的 `conference` 对象 API。
+> Vue3 项目使用 `@tencentcloud/roomkit-web-vue3`，React 项目使用
+> `@tencentcloud/roomkit-web-react`。两者的 `conference` API 调用时序保持一致。
 > 当 `ui_mode = official-roomkit` 时，业务侧通过此对象操作会议，
-> 而不是直接调用 composable（composable 层见 `conference/web/room-lifecycle.md` 等）。
+> 而不是直接调用 no-UI hooks/composables（no-UI 层见 `conference/web/room-lifecycle.md` 等）。
 >
-> 以下签名基于 `@tencentcloud/roomkit-web-vue3@5.9.0` 源码验证。
-> 源码参考：`RoomKit/adapter/conference.ts` + `RoomKit/adapter/type.ts`。
+> Vue3 签名基于 `@tencentcloud/roomkit-web-vue3@5.9.0` 源码验证；React
+> 签名基于官方 React 快速接入文档与同名导出校验。
 
 ## 前置条件
 
-**安装依赖**：
+**安装依赖（按项目框架二选一，不要混装）**：
+
+Vue3：
 ```bash
 npm install @tencentcloud/roomkit-web-vue3@5 tuikit-atomicx-vue3 \
   @tencentcloud/uikit-base-component-vue3 @tencentcloud/universal-api
 ```
 
-**版本要求**：lockfile 中 `@tencentcloud/roomkit-web-vue3` 解析版本必须 `>=5.4.3`。
+React：
+```bash
+npm install @tencentcloud/roomkit-web-react tuikit-atomicx-react \
+  @tencentcloud/uikit-base-component-react @tencentcloud/universal-api
+```
+
+**版本要求**：
+- Vue3：lockfile 中 `@tencentcloud/roomkit-web-vue3` 解析版本必须 `>=5.4.3`。
+- React：使用 `@tencentcloud/roomkit-web-react` 与同版本族的 `tuikit-atomicx-react`。
 
-**导入来源**：
+**导入来源（Vue3）**：
 ```ts
 // 会议组件 + conference API + 事件/枚举
 import {
@@ -43,6 +57,21 @@ import {
 import { UIKitProvider } from '@tencentcloud/uikit-base-component-vue3'
 ```
 
+**导入来源（React）**：
+```tsx
+// 会议组件 + conference API + 事件/枚举
+import {
+  ConferenceMainView,
+  conference,
+  RoomEvent,
+  BuiltinWidget,
+  InterceptorAction,
+} from '@tencentcloud/roomkit-web-react'
+
+// UIKitProvider（包裹组件用）
+import { UIKitProvider } from '@tencentcloud/uikit-base-component-react'
+```
+
 ## 枚举定义
 
 ```ts
@@ -189,7 +218,7 @@ interface FeatureConfig {
 7. RoomEvent.ROOM_LEAVE / ROOM_DISMISS 回调 → 清理注销函数
 ```
 
-## 完整代码示例
+## 完整代码示例（Vue3）
 
 ```vue
 <template>
@@ -270,14 +299,93 @@ onUnmounted(() => {
 </script>
 ```
 
+## 完整代码示例（React）
+
+```tsx
+import { useEffect } from 'react'
+import { useNavigate, useSearchParams } from 'react-router-dom'
+import {
+  ConferenceMainView,
+  conference,
+  RoomEvent,
+  BuiltinWidget,
+} from '@tencentcloud/roomkit-web-react'
+import { UIKitProvider } from '@tencentcloud/uikit-base-component-react'
+
+export function MeetingRoom() {
+  const navigate = useNavigate()
+  const [searchParams] = useSearchParams()
+
+  useEffect(() => {
+    const sdkAppId = Number(searchParams.get('sdkAppId'))
+    const userId = searchParams.get('userId') || ''
+    const userSig = searchParams.get('userSig') || ''
+    const roomId = searchParams.get('roomId') || ''
+    const cleanupFns: Array<() => void> = []
+
+    const cleanupRoomListeners = () => {
+      conference.off(RoomEvent.ROOM_LEAVE, handleLeave)
+      conference.off(RoomEvent.ROOM_DISMISS, handleLeave)
+      cleanupFns.forEach((fn) => fn())
+    }
+
+    const handleLeave = () => {
+      cleanupRoomListeners()
+      navigate('/')
+    }
+
+    const start = async () => {
+      if (!sdkAppId || !userId || !userSig || !roomId) {
+        navigate('/')
+        return
+      }
+
+      await conference.login({ sdkAppId, userId, userSig })
+      await conference.setSelfInfo({ userName: userId, avatarUrl: '' })
+
+      conference.setWidgetVisible({
+        [BuiltinWidget.InviteWidget]: false,
+      })
+
+      conference.on(RoomEvent.ROOM_LEAVE, handleLeave)
+      conference.on(RoomEvent.ROOM_DISMISS, handleLeave)
+
+      await conference.createAndJoinRoom({
+        roomId,
+        options: { roomName: `会议-${roomId}` },
+      })
+
+      conference.setFeatureConfig({
+        shareLink: `${window.location.origin}/meeting?roomId=${roomId}`,
+      })
+    }
+
+    start().catch(() => navigate('/'))
+
+    return () => {
+      cleanupRoomListeners()
+    }
+  }, [navigate, searchParams])
+
+  return (
+    <UIKitProvider theme="light" language="zh-CN">
+      <ConferenceMainView />
+    </UIKitProvider>
+  )
+}
+```
+
 ## 代码生成约束
 
 ### MUST
 
 1. **使用 UIKitProvider 包裹会议组件** — `ConferenceMainView` / `ConferenceMainViewH5` 必须放在 `UIKitProvider` 内。
+   - Vue3：`@tencentcloud/uikit-base-component-vue3`
+   - React：`@tencentcloud/uikit-base-component-react`
 2. **界面微调 API 在 login 之后、进房之前注册** — 避免按钮闪烁或拦截器遗漏。
 3. **registerWidget / onWill 返回的注销函数必须收集并在 ROOM_LEAVE + ROOM_DISMISS 时清理** — 防止重复注册。
 4. **shareLink 在进房成功后设置** — 依赖最终确定的 roomId。
+5. **按项目框架选择包名** — React 项目必须使用 `@tencentcloud/roomkit-web-react` / `tuikit-atomicx-react`，Vue3 项目必须使用 `@tencentcloud/roomkit-web-vue3` / `tuikit-atomicx-vue3`。
 
 ### MUST NOT
 
@@ -286,6 +394,7 @@ onUnmounted(() => {
 3. **不要给 joinRoom 传 isOpenCamera / isOpenMicrophone** — 只接受 `roomId`、`roomType`、`password`。
 4. **不要把 shareLink 写成对象** — `setFeatureConfig({ shareLink: '...' })` 是纯字符串。
 5. **不要用 CSS/DOM hack 修改 RoomKit 内部 UI** — 必须用 `setWidgetVisible` / `registerWidget` / `onWill`。
+6. **不要在 React 项目中生成 Vue SFC 或 Vue 包导入**；也不要在 Vue3 项目中生成 React JSX / TSX。
 
 ## 常见错误速查
 
@@ -296,3 +405,5 @@ onUnmounted(() => {
 | `joinRoom({ roomId, isOpenCamera: true })` | `joinRoom({ roomId })` | 无 isOpenCamera 参数 |
 | `setFeatureConfig({ shareLink: { link, title } })` | `setFeatureConfig({ shareLink: 'url' })` | shareLink 是字符串 |
 | `import { UIKitProvider } from '@tencentcloud/roomkit-web-vue3'` | `import { UIKitProvider } from '@tencentcloud/uikit-base-component-vue3'` | UIKitProvider 在 peer 包中 |
+| React 项目 `import { ConferenceMainView } from '@tencentcloud/roomkit-web-vue3'` | `import { ConferenceMainView } from '@tencentcloud/roomkit-web-react'` | React 与 Vue3 包名不同 |
+| React 项目 `import { useRoomState } from 'tuikit-atomicx-vue3/room'` | `import { useRoomState } from 'tuikit-atomicx-react/room'` | React no-UI hooks 使用 React 包 |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tencent-rtc/trtc-agent-skills",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "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"