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

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

@@ -0,0 +1,168 @@
+# Chat Web slice 索引（双 Schema：search.py + slice-loading）
+# search.py slices 模式 + 05-slice-loading.md A.1.5/B.2
+
+slices:
+  - id: chat/detect-integration
+    name: 集成信号探测
+    tags: [detect integration]
+    file: slices/chat/web/detect-integration.md
+    description: 集成信号探测口径（仅看是否依赖 tuikit-atomicx-vue3）
+    layer: _base
+    applies-to: [tuikit-atomicx-vue3]
+    sdk-version: "tuikit-atomicx-vue3 >=6.0.0"
+    depends-on-stores: []
+    trigger-keywords: []
+    prerequisites: []
+  - id: chat/detect-style
+    name: CSS 与 UI 库检测
+    tags: [detect style]
+    file: slices/chat/web/detect-style.md
+    description: 项目 CSS 方案与 UI 库检测（识别已有体系 + 可复用组件）
+    layer: _base
+    applies-to: [tuikit-atomicx-vue3]
+    sdk-version: "tuikit-atomicx-vue3 >=6.0.0"
+    depends-on-stores: []
+    trigger-keywords: []
+    prerequisites: []
+  - id: chat/state-api-skeleton
+    name: State API 集成骨架
+    tags: [state api skeleton]
+    file: slices/chat/web/state-api-skeleton.md
+    description: tuikit-atomicx-vue3 Store 集成通用骨架（兜底分支用）
+    layer: _base
+    applies-to: [tuikit-atomicx-vue3]
+    sdk-version: "tuikit-atomicx-vue3 >=6.0.0"
+    depends-on-stores: []
+    trigger-keywords: []
+    prerequisites: []
+  - id: chat/style-guide
+    name: 样式指南
+    tags: [style guide]
+    file: slices/chat/web/style-guide.md
+    description: 前端 UI 规范（通用 · 所有 slice 必读）
+    layer: _base
+    applies-to: [tuikit-atomicx-vue3]
+    sdk-version: "tuikit-atomicx-vue3 >=6.0.0"
+    depends-on-stores: []
+    trigger-keywords: []
+    prerequisites: []
+  - id: chat/login-auth
+    name: SDK 登录鉴权
+    tags: [登录, login, 鉴权, userSig, 初始化, init, sdkAppID, kickedOffline]
+    keywords: [登录, login, 鉴权, userSig, 初始化, init, sdkAppID, kickedOffline, 被踢下线, logout, 登出, 登录页, login page]
+    file: slices/chat/web/login-auth.md
+    description: SDK 登录鉴权（tuikit-atomicx-vue3 useLoginStore 单例 composable）+ UserSig 来源；路径 A 同时覆盖默认登录页
+    layer: _starter
+    applies-to: [tuikit-atomicx-vue3]
+    sdk-version: "tuikit-atomicx-vue3 >=6.0.0"
+    depends-on-stores: [LoginStore]
+    trigger-keywords: [登录, login, 鉴权, userSig, 初始化, init, sdkAppID, kickedOffline, 被踢下线, logout, 登出, 登录页, login page]
+    prerequisites: []
+  - id: chat/conversation-list
+    name: 会话列表
+    tags: [会话列表, conversation list, 最近联系人, 置顶, pin, 删除会话, 免打扰, mute]
+    keywords: [会话列表, conversation list, 最近联系人, 置顶, pin, 删除会话, 免打扰, mute, do not disturb, 发起单聊, 发起群聊, 创建会话, 创建群组, 冷启动]
+    file: slices/chat/web/conversation-list.md
+    description: 会话列表（加载 / 渲染 + 置顶 / 删除 / 免打扰 基础操作）
+    layer: _starter
+    applies-to: [tuikit-atomicx-vue3]
+    sdk-version: "tuikit-atomicx-vue3 >=6.0.0"
+    depends-on-stores: []
+    trigger-keywords: [会话列表, conversation list, 最近联系人, 置顶, pin, 删除会话, 免打扰, mute, do not disturb, 发起单聊, 发起群聊, 创建会话, 创建群组, 冷启动]
+    prerequisites: [chat/login-auth]
+  - id: chat/message-list
+    name: 消息列表
+    tags: [消息列表, message list, 聊天记录, 消息滚动, 内部滚动, 上滑加载历史, 新消息提示, scroll to bottom]
+    keywords: [消息列表, message list, 聊天记录, 消息滚动, 内部滚动, 上滑加载历史, 新消息提示, scroll to bottom, MessageListStore]
+    file: slices/chat/web/message-list.md
+    description: 消息列表（加载 / 上滑加载历史 / 渲染 + 新消息监听 + 滚动状态机）
+    layer: _starter
+    applies-to: [tuikit-atomicx-vue3]
+    sdk-version: "tuikit-atomicx-vue3 >=6.0.0"
+    depends-on-stores: [MessageListStore]
+    trigger-keywords: [消息列表, message list, 聊天记录, 消息滚动, 内部滚动, 上滑加载历史, 新消息提示, scroll to bottom, MessageListStore]
+    prerequisites: [chat/login-auth, chat/conversation-list]
+  - id: chat/message-input
+    name: 消息输入框
+    tags: [输入框, 消息输入, message input, 工具栏, toolbar, MessageInputStore, sendMessage, 发消息]
+    keywords: [输入框, 消息输入, message input, 工具栏, toolbar, MessageInputStore, sendMessage, 发消息, 发文本]
+    file: slices/chat/web/message-input.md
+    description: 消息输入框（文本输入 + 发送 + toolbar 扩展位 + sending/error 三态；toolbar 不挂业务按钮）
+    layer: _starter
+    applies-to: [tuikit-atomicx-vue3]
+    sdk-version: "tuikit-atomicx-vue3 >=6.0.0"
+    depends-on-stores: [MessageInputStore]
+    trigger-keywords: [输入框, 消息输入, message input, 工具栏, toolbar, MessageInputStore, sendMessage, 发消息, 发文本]
+    prerequisites: [chat/login-auth, chat/message-list]
+  - id: chat/direct-chat-entry
+    name: 直连对话入口
+    tags: [直连对话, direct chat, 客服入口, 在线客服页, 单点对话, 固定会话]
+    keywords: [直连对话, direct chat, 客服入口, 在线客服页, 单点对话, 固定会话]
+    file: slices/chat/web/direct-chat-entry.md
+    description: Direct Chat 入口组件（静默登录 + 固定会话 + 三态管理 + 返回行为 + 集成方式）
+    layer: _starter
+    applies-to: [tuikit-atomicx-vue3]
+    sdk-version: "tuikit-atomicx-vue3 >=6.0.0"
+    depends-on-stores: [LoginStore, MessageListStore, MessageInputStore]
+    trigger-keywords: [直连对话, direct chat, 客服入口, 在线客服页, 单点对话, 固定会话]
+    prerequisites: [chat/login-auth, chat/message-list, chat/message-input]
+  - id: chat/send-custom-message
+    name: 自定义消息
+    tags: [自定义消息, custom message, customMessage, 订单, 订单消息, 商品卡片, 优惠券, 红包]
+    keywords: [自定义消息, custom message, customMessage, 订单, 订单消息, 商品卡片, 优惠券, 红包, 投票, 卡片消息, 业务卡片, meta 消息, 评价, 评分, rating, 五星, 客户评价, 满意度]
+    file: slices/chat/web/send-custom-message.md
+    description: 通用自定义消息（订单/商品/优惠券/投票/红包/评价等业务卡片，自定义 businessID）
+    layer: features
+    applies-to: [tuikit-atomicx-vue3]
+    sdk-version: "tuikit-atomicx-vue3 >=6.0.0"
+    depends-on-stores: [MessageInputStore]
+    trigger-keywords: [自定义消息, custom message, customMessage, 订单, 订单消息, 商品卡片, 优惠券, 红包, 投票, 卡片消息, 业务卡片, meta 消息, 评价, 评分, rating, 五星, 客户评价, 满意度]
+    prerequisites: [chat/login-auth, chat/message-list, chat/message-input]
+  - id: chat/conversation-actions
+    name: 会话增强操作
+    tags: [标星, 收藏, star, 标未读, 标已读, mark unread, mark read, 草稿]
+    keywords: [标星, 收藏, star, 标未读, 标已读, mark unread, mark read, 草稿, draft, 清空消息, clear messages]
+    file: slices/chat/web/conversation-actions.md
+    description: 会话增强操作（标星收藏 / 标已读未读 / 草稿 / 清空消息）
+    layer: features
+    applies-to: [tuikit-atomicx-vue3]
+    sdk-version: "tuikit-atomicx-vue3 >=6.0.0"
+    depends-on-stores: []
+    trigger-keywords: [标星, 收藏, star, 标未读, 标已读, mark unread, mark read, 草稿, draft, 清空消息, clear messages]
+    prerequisites: [chat/conversation-list]
+  - id: chat/send-media
+    name: 发送多媒体
+    tags: [发图片, 发视频, 发文件, 图片消息, 视频消息, 文件消息, send image, send video]
+    keywords: [发图片, 发视频, 发文件, 图片消息, 视频消息, 文件消息, send image, send video, send file, imageMessage, videoMessage, fileMessage, 上传, upload, 多媒体, media]
+    file: slices/chat/web/send-media.md
+    description: 发送图片、视频、文件消息（toolbar 按钮 + 文件选择 + 上传发送）
+    layer: features
+    applies-to: [tuikit-atomicx-vue3]
+    sdk-version: "tuikit-atomicx-vue3 >=6.0.0"
+    depends-on-stores: [MessageInputStore]
+    trigger-keywords: [发图片, 发视频, 发文件, 图片消息, 视频消息, 文件消息, send image, send video, send file, imageMessage, videoMessage, fileMessage, 上传, upload, 多媒体, media]
+    prerequisites: [chat/login-auth, chat/message-list, chat/message-input]
+  - id: chat/at-mention
+    name: 群聊 @ 提及
+    tags: [at, '@', 提及, mention, '@群成员', '@所有人', atUserList, 群成员选择]
+    keywords: [at, '@', 提及, mention, '@群成员', '@所有人', atUserList, 群成员选择]
+    file: slices/chat/web/at-mention.md
+    description: 群聊 @提及成员（成员选择器 + atUserList option + tag 展示）
+    layer: features
+    applies-to: [tuikit-atomicx-vue3]
+    sdk-version: "tuikit-atomicx-vue3 >=6.0.0"
+    depends-on-stores: [MessageInputStore, GroupMemberStore]
+    trigger-keywords: [at, '@', 提及, mention, '@群成员', '@所有人', atUserList, 群成员选择]
+    prerequisites: [chat/login-auth, chat/message-list, chat/message-input]
+  - id: chat/message-base-actions
+    name: 消息基础操作
+    tags: [消息操作, 复制消息, 撤回, 删除消息, 下载, copy, revoke, recall]
+    keywords: [消息操作, 复制消息, 撤回, 删除消息, 下载, copy, revoke, recall, delete message, download, 右键菜单, 长按菜单, context menu, message actions]
+    file: slices/chat/web/message-base-actions.md
+    description: 消息基础操作（复制 / 撤回 / 删除 / 下载媒体）
+    layer: features
+    applies-to: [tuikit-atomicx-vue3]
+    sdk-version: "tuikit-atomicx-vue3 >=6.0.0"
+    depends-on-stores: [MessageActionStore]
+    trigger-keywords: [消息操作, 复制消息, 撤回, 删除消息, 下载, copy, revoke, recall, delete message, download, 右键菜单, 长按菜单, context menu, message actions]
+    prerequisites: [chat/login-auth, chat/message-list]

package/knowledge-base/chat/web/path-d-signals.yaml

@@ -0,0 +1,4 @@
+# Path D / Step 0 信号词 — Root §A 与 trtc-chat Step 0 共同 Read
+
+im_consult: [计费, 价格, 免费额度, 套餐, 购买, 开通, 产品能力, 群人数上限, 消息保存时长, UserSig 生成方法, 多端登录配置, 服务端错误码, IM 内网代理配置, UserID 限制, 命名规则, 账号限制, 服务端, 管理员, 后台接口, REST, REST API, 导入账号, 服务端发消息, 回调, Webhook, 发消息前回调, 发消息后回调, 第三方回调, 回调配置, TUIKit, UIKit, Search, ContactList, ConversationList, ChatSetting, im-uikit, 组件集成, Compose UIKit, SwiftUI UIKit, Vue3 UIKit, React UIKit, uniapp uikit, UI 组件, 集成指南, 初始化, SDK API, createXXXMessage, sendMessage, login, UserSig, Client, 错误码, API 用法, 版本迁移]
+symptom_in_integration: [白屏, 连不上, 登录失败, 报错, 编译失败]

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

@@ -0,0 +1,143 @@
+# Conference Web 平台 slice 索引
+# search.py 的 slices 模式在 platform=web 时优先读取此文件
+# 文件路径格式：相对于 knowledge-base/ 根目录
+
+slices:
+
+  # ---- 接入主线 ----
+
+  - id: conference/login-auth
+    name: 登录与鉴权
+    tags: [login, auth, SDKAppID, UserID, UserSig, session, multi-device]
+    keywords: [6206, UserSig过期, login-failed, 进房失败, kicked-offline, 被踢下线]
+    file: slices/conference/web/login-auth.md
+    description: 统一登录态、SDKAppID/UserID/UserSig 鉴权、登录失效/会话过期/多端顶替处理
+
+  - id: conference/prejoin-check
+    name: 入会前设备检查
+    tags: [prejoin, device-check, camera, microphone, speaker, preview, selftest]
+    keywords: [MediaPermissionCheck, getUserMedia, DeviceDetector, 两套设备检测, stopSpeakerTest]
+    file: slices/conference/web/prejoin-check.md
+    description: 摄像头/麦克风/扬声器的会前检测与本地预览，完成设备自检与降级准备
+
+  - id: conference/room-lifecycle
+    name: 房间创建、加入、离开与结束
+    tags: [room, lifecycle, create, join, leave, end]
+    keywords: [100211, take-seat, 100006, live-room-only, 进房失败, join-failed, createAndJoinRoom]
+    file: slices/conference/web/room-lifecycle.md
+    description: 会议从创建、加入、离开到结束的主链路，统一承接即时会议发起、加入已有会议与退场收口
+
+  # ---- 会议骨架 ----
+
+  - id: conference/video-layout
+    name: 视频布局
+    tags: [layout, RoomView, layoutTemplate, participantViewUI, grid, sidebar, mobile-layout, screen-share]
+    file: slices/conference/web/video-layout.md
+    description: 视频区域渲染、布局模板切换、主画面选择、共享突出展示、挂件扩展与移动端布局适配
+
+  - id: conference/room-schedule
+    name: 预约会议
+    tags: [schedule, reservation, future-meeting, reminder, list]
+    file: slices/conference/web/room-schedule.md
+    description: 未来会议的创建、更新、取消、列表查询与到点提醒；到点入会由 room-lifecycle 接管
+
+  - id: conference/room-call
+    name: 会中呼叫
+    tags: [call, signaling, accept, reject, timeout, multi-device]
+    file: slices/conference/web/room-call.md
+    description: 会议进行中向房外在线用户发起实时呼叫，处理接受/拒绝/超时/多设备收口等呼叫信令流程
+
+  # ---- 治理与互动 ----
+
+  - id: conference/participant-list
+    name: 参会人列表与状态
+    tags: [participant, list, role, speaking, pagination, sync]
+    file: slices/conference/web/participant-list.md
+    description: 参会人列表展示与同步，包括角色、发言态、音视频状态、业务扩展字段与分页加载
+
+  - id: conference/participant-management
+    name: 参会人管理与角色治理
+    tags: [kick, admin, role, transfer, invite-permission]
+    keywords: [举手审批, 设备申请审批, raise-hand-approval, device-approval, mute-all]
+    file: slices/conference/web/participant-management.md
+    description: >
+      角色治理（设/撤管理员、转移房主、移出成员、改名片）+
+      房间级会控（全员禁麦/禁画/禁言、单成员关设备、设备申请审批与邀请）
+
+  - id: conference/room-chat
+    name: 会中聊天
+    tags: [chat, message, group, history, unread, disable-chat]
+    keywords: [会中聊天, in-meeting-chat, 消息, 群聊]
+    file: slices/conference/web/room-chat.md
+    description: 会议与群组会话绑定、消息收发、历史分页、未读状态、禁聊联动
+
+  # ---- 设备、媒体与体验增强 ----
+
+  - id: conference/device-control
+    name: 设备控制
+    tags: [camera, microphone, speaker, device, permission, switch, recovery]
+    file: slices/conference/web/device-control.md
+    description: 会中摄像头/麦克风/扬声器的开关、切换、权限处理与异常恢复
+
+  - id: conference/network-quality
+    name: 网络质量
+    tags: [network, quality, rtt, packet-loss, reconnect, weak-network]
+    file: slices/conference/web/network-quality.md
+    description: 会中网络状态感知、弱网提示、重连状态与超时告警
+
+  - id: conference/screen-share
+    name: 屏幕分享
+    tags: [screen-share, desktop, system-audio, state, event]
+    file: slices/conference/web/screen-share.md
+    description: 桌面端共享屏幕、共享系统音频、共享状态监听、共享权限控制与共享相关事件
+
+  - id: conference/beauty-effects
+    name: 美颜效果
+    tags: [beauty, smooth, whiten, ruddy, preview, two-phase]
+    file: slices/conference/web/beauty-effects.md
+    description: 本地视频的磨皮/美白/红润等基础美颜，本地预览与保存生效的两阶段流程
+
+  - id: conference/virtual-background
+    name: 虚拟背景
+    tags: [virtual-background, blur, replace, assetsPath, browser-support]
+    file: slices/conference/web/virtual-background.md
+    description: 背景虚化/替换、模型资源与 assetsPath 配置、浏览器支持性检测、预览与保存生效链路
+
+  # ---- 官方套件 ----
+
+  - id: conference/official-roomkit-api
+    name: 官方 RoomKit 适配层 API
+    keywords: [roomkit, tuiroomkit, tui-roomkit, conference-api]
+    tags: [official-roomkit, conference-api, conference-object, setWidgetVisible, registerWidget,
+           onWill, setFeatureConfig, createAndJoinRoom, joinRoom, UIKitProvider]
+    file: slices/conference/web/official-roomkit-api.md
+    description: >
+      官方 RoomKit 集成模式下 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]
+    file: slices/conference/web/official-roomkit-login-ui.md
+    description: 官方 RoomKit 登录页的布局、表单、凭证提示与状态反馈规范，包括 UIKitProvider 与 LoginPanel 集成约束
+
+  - id: conference/integration-audit
+    name: Conference Web 集成审计
+    tags: [audit, checklist, meta, integration-review, roomkit, online-classroom]
+    file: slices/conference/web/integration-audit.md
+    description: 横切对照官方 Conference Web 接入流程的审计清单；intent F 使用，不进 scenario 集成队列
+
+  # ---- 会议模式扩展 ----
+
+  - id: conference/webinar-interaction
+    name: 研讨会互动
+    tags: [webinar, raise-hand, audience, barrage, participant, requestToOpenDevice, device-approval]
+    file: slices/conference/web/webinar-interaction.md
+    description: 研讨会房型中的观众举手、主持审批、上台发言、设备申请收口与弹幕互动
+
+  - id: conference/ai-tools
+    name: AI 工具集成
+    tags: [ai, asr, transcription, subtitle, translation, realtime]
+    file: slices/conference/web/ai-tools.md
+    description: 会中 AI 实时转写、字幕展示、翻译语言配置、实时消息列表与启停收口

package/knowledge-base/docs/chat/debug/GenerateTestUserSig.js

@@ -0,0 +1,23 @@
+/*eslint-disable*/
+
+/**
+ * ⚠️ 仅用于本地开发调试！
+ * 上线前必须：
+ *   1. 删除整个 public/debug/ 目录
+ *   2. 从 index.html 移除两行 <script> 引入
+ *   3. 改为调用后端签发接口获取 UserSig
+ * 后端签发文档：https://cloud.tencent.com/document/product/269/32688
+ */
+
+const SDKAPPID = 0;
+const SECRETKEY = '';
+const EXPIRETIME = 604800; // 默认时间：7 x 24 x 60 x 60 = 604800 = 7 天，时间单位：秒
+
+function genTestUserSig(userID) {
+  const generator = new window.LibGenerateTestUserSig(SDKAPPID, SECRETKEY, EXPIRETIME);
+  const userSig = generator.genTestUserSig(userID);
+  return {
+    SDKAppID: SDKAPPID,
+    userSig: userSig
+  };
+}