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

package/knowledge-base/slices/conference/web/integration-audit.md

@@ -17,7 +17,7 @@ related_scenario: general-conference
 
 # Conference Web 集成审计
 
-> **Meta slice** — 横切对照清单，供 Path B intent F（集成审计）使用。
+> **Meta slice** — 横切对照清单，供 intent F（集成审计）使用。
 > **不要**加入 scenario 的 `slices` / `confirmed_plan`，**不要**走 topic 集成队列或 apply 门禁。
 
 > 当用户问「检查业务流程遗漏」「对照官方接入流程」「在线课堂/会议流程是否正常」时使用本 slice。

package/knowledge-base/slices/conference/web/login-auth.md

@@ -11,20 +11,30 @@ api_docs:
     url: https://cloud.tencent.com/document/product/647/126917
 business_decisions:
   - key: usersig_source
+    tier: blocking
+    question: "您的项目当前处于哪个阶段？这决定鉴权凭证（UserSig）的生成方式。"
     tier: blocking
     question: "您的项目当前处于哪个阶段？这决定鉴权凭证（UserSig）的生成方式。"
     options:
       - { label: "本地开发 —— config 配置 SDKAppID+SecretKey，登录时按 UserID 自动签名（推荐，最快）", value: "local-dev" }
       - { label: "本地开发 / 调试 —— 到控制台生成 UserSig，复制粘贴到登录页（不配置 SecretKey）", value: "console" }
-      - { label: "生产环境（上线）—— 由您的后端接口签发，安全合规（推荐）", value: "backend" }
+      - { label: "对接生产 —— 由后端接口签发，安全合规（推荐）", value: "backend" }
   - key: userid_strategy
+    tier: blocking
+    question: "参会用户的身份需要绑定您现有的账号体系吗？"
     tier: blocking
     question: "参会用户的身份需要绑定您现有的账号体系吗？"
     options:
       - { label: "需要，直接使用现有账号的用户 ID —— 最常见，如员工工号、手机号等", value: "direct" }
       - { label: "需要，但不能暴露真实 ID —— 转换为会议专用身份，后台维护映射关系", value: "uuid-mapping" }
       - { label: "不需要，允许无账号匿名入会 —— 生成临时 ID，用完即弃", value: "anonymous" }
+      - { label: "需要，直接使用现有账号的用户 ID —— 最常见，如员工工号、手机号等", value: "direct" }
+      - { label: "需要，但不能暴露真实 ID —— 转换为会议专用身份，后台维护映射关系", value: "uuid-mapping" }
+      - { label: "不需要，允许无账号匿名入会 —— 生成临时 ID，用完即弃", value: "anonymous" }
   - key: on_session_lost
+    tier: deferrable
+    default: redirect-login
+    question: "如果用户登录态失效了（凭证过期，或在别处登录把这台顶下线），页面应如何处理？"
     tier: deferrable
     default: redirect-login
     question: "如果用户登录态失效了（凭证过期，或在别处登录把这台顶下线），页面应如何处理？"
@@ -32,6 +42,9 @@ business_decisions:
       - { label: "跳回登录页，让用户重新登录 —— 最稳妥（推荐默认）", value: "redirect-login" }
       - { label: "后台静默换新凭证、自动重连 —— 用户无感，但需后端配合", value: "auto-refresh" }
       - { label: "弹窗提示，由用户决定重连或退出", value: "prompt-user" }
+      - { label: "跳回登录页，让用户重新登录 —— 最稳妥（推荐默认）", value: "redirect-login" }
+      - { label: "后台静默换新凭证、自动重连 —— 用户无感，但需后端配合", value: "auto-refresh" }
+      - { label: "弹窗提示，由用户决定重连或退出", value: "prompt-user" }
 ---
 
 # 登录与鉴权

package/knowledge-base/tooling/aliases.yaml

@@ -0,0 +1,92 @@
+common:
+  - canonical: "进入房间"
+    variants:
+      - value: "进房"
+        strength: strong
+      - value: "join room"
+        strength: strong
+      - value: "进入会议"
+        strength: weak
+      - value: "加入房间"
+        strength: weak
+  - canonical: "登录"
+    variants:
+      - value: "login"
+        strength: strong
+      - value: "鉴权"
+        strength: weak
+      - value: "认证"
+        strength: weak
+
+products:
+  conference:
+    - canonical: "conference"
+      variants:
+        - value: "视频会议"
+          strength: strong
+        - value: "会议"
+          strength: weak
+        - value: "meeting"
+          strength: strong
+    - canonical: "roomkit"
+      variants:
+        - value: "tuiroomkit"
+          strength: strong
+        - value: "tui roomkit"
+          strength: weak
+        - value: "roomkit"
+          strength: strong
+        - value: "会议套件"
+          strength: strong
+        - value: "官方会议 ui"
+          strength: weak
+  live:
+    - canonical: "live"
+      variants:
+        - value: "直播"
+          strength: strong
+        - value: "live streaming"
+          strength: strong
+  chat:
+    - canonical: "chat"
+      variants:
+        - value: "即时通信"
+          strength: strong
+        - value: "im"
+          strength: weak
+        - value: "聊天"
+          strength: weak
+  call:
+    - canonical: "call"
+      variants:
+        - value: "音视频通话"
+          strength: strong
+        - value: "视频通话"
+          strength: strong
+        - value: "语音通话"
+          strength: strong
+  rtc-engine:
+    - canonical: "rtc engine"
+      variants:
+        - value: "trtc 引擎"
+          strength: strong
+        - value: "rtc"
+          strength: weak
+        - value: "实时音视频引擎"
+          strength: strong
+
+cross_product:
+  - canonical: "直播弹幕"
+    products: [live, chat]
+    variants:
+      - value: "live barrage"
+        strength: strong
+      - value: "弹幕直播"
+        strength: strong
+  - canonical: "直播连麦"
+    products: [live, rtc-engine]
+    variants:
+      - value: "连麦直播"
+        strength: strong
+      - value: "co-guest live"
+        strength: strong

package/knowledge-base/tooling/intent-signals.yaml

@@ -0,0 +1,181 @@
+# intent-signals.yaml
+# capability 查询的二级意图分类信号词
+#
+# detect_capability_intent() 用这两张表把 capability 查询分成：
+#   integrate  — 用户想在自己的项目里接入 / 构建功能（→ domain skill onboarding）
+#   lookup     — 用户想了解功能 / 查阅文档（→ trtc-docs）
+#   ambiguous  — 两类信号同时出现或都没有（→ dispatcher 主动问用户）
+#
+# 匹配方式：substring，在 _normalize_query() 归一化后的字符串上做。
+# 原则：
+#   - 只收"强信号"——能独立判定意图的短语，避免高频通用词误判。
+#   - 中文优先收完整词组（接入 / 是什么），不收单字（做 / 用）。
+#   - 每次新增前先问：这个词单独出现时意图是否还清晰？
+#   - 文档/quickstart 这类词如果同时和接入动词连用，默认视为 integrate；单独出现仍归 lookup。
+
+integrate_signals:
+  # 中文：主动构建 / 接入意图
+  - 接入
+  - 接进
+  - 接上
+  - 接起来
+  - 集成
+  - 对接
+  - 接好
+  - 搭建
+  - 落地
+  - 接通
+  - 帮我做
+  - 帮我接
+  - 帮我接入
+  - 帮我集成
+  - 我要做
+  - 我想做
+  - 做一个
+  - 做成
+  - 做完
+  - 快速接入
+  - 快速开始
+  - 开始接入
+  - 如何实现
+  - 怎么实现
+  - 怎么接
+  - 接到现有项目里
+  - 怎么接入
+  - 加到项目里
+  - 接到项目里
+  - 接进项目里
+  - 接入到项目里
+  - 接入到现有项目里
+  - 集成到项目里
+  - 集成到现有项目里
+  - 加一个功能
+  - 给现有项目加
+  - 添加功能
+  - 增加功能
+  - 新增功能
+  - 加上
+  - 接一个
+  - 做接入
+  - 做集成
+  - 步骤接入
+  - 从零接入
+  - 从0接入
+  - 从 0 接入
+  - 从头搭建
+  - 跑通
+  - 跑起来
+  - 串起来
+  - 整合进
+  - 嵌入到
+  - 嵌进去
+  - 接到业务里
+  - 接到现有业务里
+  - 接到页面里
+  - 接到直播间里
+  - 接到房间里
+  - 做到项目里
+  - 接这个能力
+  - 接这个功能
+  - 接这个场景
+  - 实现这个功能
+  - 实现这个场景
+  - 带我接
+  - 带我做
+  - 一步步接
+  - 一步步做
+  - 手把手接
+  - 逐步接入
+  - 逐步集成
+  - 迁移到
+  - 改造成
+  - 重构成
+  - 接入方案
+  - 集成方案
+  # 英文：主动构建 / 集成意图
+  - how to build
+  - how to implement
+  - how to integrate
+  - how to add
+  - how to set up
+  - how to create
+  - how to develop
+  - how to configure
+  - integrate
+  - implement
+  - hook up
+  - plug into
+  - plug in
+  - connect into
+  - connect with
+  - connect to my
+  - bring up
+  - spin up
+  - bootstrap
+  - roll out
+  - build a
+  - create a
+  - set up
+  - get started
+  - quick start
+  - add to my
+  - add to our
+  - add to the
+  - add into my
+  - add into our
+  - add in my
+  - add in our
+  - integrate into
+  - integrate with my
+  - implement in my
+  - build into
+  - embed into
+  - migrate to
+  - step by step
+  - guide me through
+  - walk me through how to
+  - wire up
+  - set up conference
+  - walk me through
+
+lookup_signals:
+  # 中文：理解 / 查询意图
+  - 是什么
+  - 有哪些
+  - 支持吗
+  - 是否支持
+  - 支持什么
+  - 能否
+  - 可以吗
+  - 有没有
+  - 怎么工作
+  - 有什么区别
+  - 有什么不同
+  - 什么区别
+  - 对比
+  - 原理
+  - 机制
+  - 概念
+  - 文档
+  - 介绍一下
+  - 了解
+  - 说明
+  # 英文：理解 / 查询意图
+  - what is
+  - what are
+  - does it support
+  - can it
+  - how does it work
+  - how does
+  - is it possible
+  - explain
+  - describe
+  - overview
+  - concept
+  - introduction
+  - vs
+  - compared to
+  - difference between
+  - what's the difference
+  - documentation
+  - docs

package/knowledge-base/tooling/symptom-keywords.yaml

@@ -0,0 +1,21 @@
+symptom_keywords:
+  - 失败
+  - 报错
+  - 黑屏
+  - 黑帧
+  - crash
+  - error
+  - 闪退
+  - 没声音
+  - 无声音
+  - 听不到
+  - 看不到
+  - 收不到
+  - 卡住
+  - 超时
+  - 断开
+  - 进不去
+  - 不工作
+  - 定格
+  - 升级后
+  - 无法

package/package.json

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