@tencent-rtc/trtc-agent-skills 0.1.0

package/knowledge-base/index.yaml

@@ -0,0 +1,454 @@
+# TRTC Knowledge Base Index
+# Slice 和 scenario 的集中目录
+# Skills 通过读取此文件发现和定位知识库内容
+
+version: "4.0"
+last_updated: "2026-03-30"
+
+# ============================================================
+# Products — TRTC 产品线
+# ============================================================
+# 仅保留 search skill 做产品识别和 fallback 所需的最小信息
+products:
+  - id: chat
+    name: Chat（即时通信）
+    description: 即时通信 SDK，提供消息收发、会话管理、群组、用户资料等能力
+    llms_file: llms/chat.txt
+
+  - id: call
+    name: Call（音视频通话）
+    description: 音视频通话组件，支持 1v1 和群组音视频通话
+    llms_file: llms/call.txt
+
+  - id: rtc-engine
+    name: RTC Engine（实时音视频引擎）
+    description: 底层实时音视频引擎，提供进房、推流、拉流、混流等核心能力
+    llms_file: llms/rtc-engine.txt
+
+  - id: live
+    name: Live（直播）
+    description: 直播互动 Core SDK，支持推流、拉流、连麦互动、弹幕、礼物、美颜等
+    llms_file: llms/live.txt
+
+  - id: conference
+    name: Conference（视频会议）
+    description: 视频会议 Core SDK，提供创建会议、入会、成员管理、会中聊天、屏幕分享等能力
+    llms_file: llms/conference.txt
+
+# ============================================================
+# Cross-Product Relations — 跨产品关系模型
+# ============================================================
+# search skill 和 apply skill 用来处理跨产品查询和代码校验
+cross_product_relations:
+  - id: live-chat-barrage
+    products: [live, chat]
+    slices: [chat/group-avchatroom, chat/group-msg]
+    description: 直播弹幕使用 Chat SDK 的直播群（AVChatRoom）能力
+
+  - id: live-rtc-streaming
+    products: [live, rtc-engine]
+    slices: [rtc-engine/enter-room, rtc-engine/publish-stream]
+    description: Live 底层音视频依赖 RTC Engine 的进房和推流能力
+
+  - id: call-rtc-engine
+    products: [call, rtc-engine]
+    slices: [rtc-engine/enter-room, rtc-engine/publish-stream]
+    description: Call 底层音视频依赖 RTC Engine
+
+  - id: call-chat-signaling
+    products: [call, chat]
+    slices: [chat/signaling]
+    description: Call 的呼叫信令基于 Chat SDK 的信令能力
+
+# ============================================================
+# Slices — 原子能力片段索引
+# ============================================================
+slices:
+
+  # ---- RTC Engine ----
+  - id: rtc-engine/enter-room
+    name: 进房
+    tags: [enter-room, join, room, connection]
+    platforms: [web, android, ios, flutter, electron]
+    file: slices/rtc-engine/enter-room.md
+    description: 进房参数配置、进房场景选择、进房回调处理、进房失败排障
+    status: planned
+
+  - id: rtc-engine/publish-stream
+    name: 推流
+    tags: [publish, stream, video, audio, camera, microphone]
+    platforms: [web, android, ios, flutter, electron]
+    file: slices/rtc-engine/publish-stream.md
+    description: 本地音视频采集与推流、摄像头/麦克风管理、视频编码参数、推流状态回调
+    status: planned
+
+  # ---- Live: 基础设施 ----
+  - id: live/login-auth
+    name: 登录认证
+    tags: [login, auth, SDKAppID, UserID, UserSig, LoginStore]
+    platforms: [ios]
+    file: slices/live/login-auth.md
+    description: LoginStore 登录认证、SDKAppID/UserID/UserSig 配置、Info.plist 权限、Pod 依赖安装
+    status: active
+
+  - id: live/device-control
+    name: 设备控制
+    tags: [camera, microphone, device, DeviceStore, permission]
+    platforms: [ios]
+    file: slices/live/device-control.md
+    description: 摄像头/麦克风的打开关闭、前后切换、设备权限处理
+    status: active
+
+  - id: live/error-codes
+    name: 错误码速查
+    tags: [error, error-code, troubleshoot, debug]
+    platforms: [ios]
+    file: slices/live/error-codes.md
+    description: Live 产品全部错误码速查：通用、设备、房间、权限、REST API
+    status: active
+
+  # ---- Live: 主播端 ----
+  - id: live/anchor-preview
+    name: 开播前预览
+    tags: [anchor, preview, LiveCoreView, pushView, camera]
+    platforms: [ios]
+    file: slices/live/anchor-preview.md
+    description: 主播开播前的视频预览：LiveCoreView 创建、setLiveID、摄像头预览
+    status: active
+
+  - id: live/anchor-room-config
+    name: 房间配置
+    tags: [room, config, metadata, LiveListStore, room-name, cover]
+    platforms: [ios]
+    file: slices/live/anchor-room-config.md
+    description: 房间名称、封面、MetaData 配置及限制
+    status: active
+
+  - id: live/anchor-lifecycle
+    name: 开播与结束
+    tags: [anchor, start, end, createLive, endLive, lifecycle]
+    platforms: [ios]
+    file: slices/live/anchor-lifecycle.md
+    description: 主播开播 createLive、结束 endLive、事件监听、释放顺序
+    status: active
+
+  # ---- Live: 观众端 ----
+  - id: live/live-list
+    name: 直播列表
+    tags: [list, fetch, category, slide-play, LiveListStore]
+    platforms: [ios]
+    file: slices/live/live-list.md
+    description: 直播列表拉取、分页加载、分类筛选、滑动播放
+    status: active
+
+  - id: live/audience-watch
+    name: 观众观看与退出
+    tags: [audience, watch, join, leave, playView, LiveCoreView]
+    platforms: [ios]
+    file: slices/live/audience-watch.md
+    description: 观众进房观看、退出、被踢处理、后台退出
+    status: active
+
+  - id: live/audience-list
+    name: 观众列表
+    tags: [audience, list, count, LiveAudienceStore]
+    platforms: [ios]
+    file: slices/live/audience-list.md
+    description: 观众列表展示、人数统计、单列/双列布局
+    status: active
+
+  # ---- Live: 互动模块 ----
+  - id: live/barrage
+    name: 弹幕
+    tags: [barrage, message, chat, mute, BarrageStore, danmu]
+    platforms: [ios]
+    file: slices/live/barrage.md
+    description: 弹幕展示、发送文本/自定义弹幕、禁言管理、性能优化
+    status: active
+
+  - id: live/gift
+    name: 礼物
+    tags: [gift, send, receive, GiftStore, reward]
+    platforms: [ios]
+    file: slices/live/gift.md
+    description: 礼物列表拉取、发送/接收礼物、扣费回调、事件驱动 UI
+    status: active
+
+  - id: live/audience-manage
+    name: 观众管理
+    tags: [manage, kick, admin, administrator, LiveAudienceStore]
+    platforms: [ios]
+    file: slices/live/audience-manage.md
+    description: 踢出用户、设置/撤销管理员、人数频控
+    status: active
+
+  - id: live/beauty
+    name: 基础美颜
+    tags: [beauty, smooth, whiten, ruddy, BaseBeautyStore, filter]
+    platforms: [ios]
+    file: slices/live/beauty.md
+    description: 磨皮/美白/红润调节、UI 滑块映射、状态订阅
+    status: active
+
+  - id: live/audio
+    name: 音效
+    tags: [audio, voice, effect, changer, reverb, ear-monitor, AudioEffectStore]
+    platforms: [ios]
+    file: slices/live/audio.md
+    description: 人声音量、耳返、变声、混响、reset
+    status: active
+
+  - id: live/coguest-apply
+    name: 连麦：观众申请
+    tags: [coguest, apply, seat, mic, CoGuestStore, connect]
+    platforms: [ios]
+    file: slices/live/coguest-apply.md
+    description: 观众申请上麦、主播审批、上麦后设备管理、断开连麦
+    status: active
+
+  # ---- Conference: 接入主线 ----
+  - id: conference/login-auth
+    name: 登录与鉴权
+    tags: [login, auth, SDKAppID, UserID, UserSig, session, multi-device]
+    platforms: [web]
+    file: slices/conference/web/login-auth.md
+    description: 统一登录态、SDKAppID/UserID/UserSig 鉴权、登录失效/会话过期/多端顶替处理
+    status: active
+
+  - id: conference/prejoin-check
+    name: 入会前设备检查
+    tags: [prejoin, device-check, camera, microphone, speaker, preview, selftest]
+    platforms: [web]
+    file: slices/conference/web/prejoin-check.md
+    description: 摄像头/麦克风/扬声器的会前检测与本地预览，完成设备自检与降级准备
+    status: active
+
+  - id: conference/room-lifecycle
+    name: 房间创建、加入、离开与结束
+    tags: [room, lifecycle, create, join, leave, end]
+    platforms: [web]
+    file: slices/conference/web/room-lifecycle.md
+    description: 会议从创建、加入、离开到结束的主链路，统一承接即时会议发起、加入已有会议与退场收口
+    status: active
+
+  # ---- Conference: 会议骨架 ----
+
+  - id: conference/video-layout
+    name: 视频布局
+    tags: [layout, RoomView, layoutTemplate, participantViewUI, grid, sidebar, mobile-layout, screen-share]
+    platforms: [web]
+    file: slices/conference/web/video-layout.md
+    description: 视频区域渲染、布局模板切换、主画面选择、共享突出展示、挂件扩展与移动端布局适配
+    status: active
+
+  - id: conference/room-schedule
+    name: 预约会议
+    tags: [schedule, reservation, future-meeting, reminder, list]
+    platforms: [web]
+    file: slices/conference/web/room-schedule.md
+    description: 未来会议的创建、更新、取消、列表查询与到点提醒；到点入会由 room-lifecycle 接管
+    status: active
+
+  - id: conference/room-call
+    name: 会中呼叫
+    tags: [call, signaling, accept, reject, timeout, multi-device]
+    platforms: [web]
+    file: slices/conference/web/room-call.md
+    description: 会议进行中向房外在线用户发起实时呼叫，处理接受/拒绝/超时/多设备收口等呼叫信令流程
+    status: active
+
+  # ---- Conference: 治理与互动 ----
+  - id: conference/participant-list
+    name: 参会人列表与状态
+    tags: [participant, list, role, speaking, pagination, sync]
+    platforms: [web]
+    file: slices/conference/web/participant-list.md
+    description: 参会人列表展示与同步，包括角色、发言态、音视频状态、业务扩展字段与分页加载
+    status: active
+
+  - id: conference/participant-management
+    name: 参会人管理与角色治理
+    tags: [kick, admin, role, transfer, invite-permission]
+    platforms: [web]
+    file: slices/conference/web/participant-management.md
+    description: 角色治理（设/撤管理员、转移房主、移出成员、改名片）+ 房间级会控（全员禁麦/禁画/禁言、单成员关设备、设备申请审批与邀请）
+    status: active
+
+  - id: conference/room-chat
+    name: 会中聊天
+    tags: [chat, message, group, history, unread, disable-chat]
+    platforms: [web]
+    file: slices/conference/web/room-chat.md
+    description: 会议与群组会话绑定、消息收发、历史分页、未读状态、禁聊联动
+    status: active
+
+  # ---- Conference: 设备、媒体与体验增强 ----
+  - id: conference/device-control
+    name: 设备控制
+    tags: [camera, microphone, speaker, device, permission, switch, recovery]
+    platforms: [web]
+    file: slices/conference/web/device-control.md
+    description: 会中摄像头/麦克风/扬声器的开关、切换、权限处理与异常恢复
+    status: active
+
+  - id: conference/network-quality
+    name: 网络质量
+    tags: [network, quality, rtt, packet-loss, reconnect, weak-network]
+    platforms: [web]
+    file: slices/conference/web/network-quality.md
+    description: 会中网络状态感知、弱网提示、重连状态与超时告警
+    status: active
+
+  - id: conference/screen-share
+    name: 屏幕分享
+    tags: [screen-share, desktop, system-audio, state, event]
+    platforms: [web]
+    file: slices/conference/web/screen-share.md
+    description: 桌面端共享屏幕、共享系统音频、共享状态监听、共享权限控制与共享相关事件
+    status: active
+
+  - id: conference/beauty-effects
+    name: 美颜效果
+    tags: [beauty, smooth, whiten, ruddy, preview, two-phase]
+    platforms: [web]
+    file: slices/conference/web/beauty-effects.md
+    description: 本地视频的磨皮/美白/红润等基础美颜，本地预览与保存生效的两阶段流程
+    status: active
+
+  - id: conference/virtual-background
+    name: 虚拟背景
+    tags: [virtual-background, blur, replace, assetsPath, browser-support]
+    platforms: [web]
+    file: slices/conference/web/virtual-background.md
+    description: 背景虚化/替换、模型资源与 assetsPath 配置、浏览器支持性检测、预览与保存生效链路
+    status: active
+
+  - id: conference/official-roomkit-api
+    name: 官方 RoomKit 适配层 API
+    tags: [official-roomkit, conference-api, conference-object, setWidgetVisible, registerWidget, onWill, setFeatureConfig, createAndJoinRoom, joinRoom, UIKitProvider]
+    platforms: [web]
+    file: slices/conference/web/official-roomkit-api.md
+    description: 官方 RoomKit 集成模式下 conference 对象的完整 API 签名、枚举定义、调用时序和代码示例（ui_mode=official-roomkit 专用）
+    status: active
+
+# ============================================================
+# Scenarios — 场景组合索引
+# ============================================================
+scenarios:
+  - id: 1v1-video-call
+    name: 1v1 视频通话
+    slices: [rtc-engine/enter-room, rtc-engine/publish-stream]
+    file: scenarios/1v1-video-call.md
+    description: 两个用户进行 1v1 视频通话的完整流程
+    status: planned
+
+  - id: entertainment-live-room
+    name: 秀场直播间
+    slices:
+      - live/login-auth
+      - live/device-control
+      - live/anchor-preview
+      - live/anchor-room-config
+      - live/anchor-lifecycle
+      - live/live-list
+      - live/audience-watch
+      - live/audience-list
+      - live/barrage
+      - live/gift
+      - live/audience-manage
+      - live/beauty
+      - live/audio
+      - live/coguest-apply
+      - live/error-codes
+    file: scenarios/live/entertainment-live-room.md
+    description: 完整秀场直播间：主播开播+美颜+音效，观众进房+弹幕+礼物+连麦
+    status: active
+
+  - id: 1v1-video-consultation
+    name: 1v1视频问诊
+    room_type: standard
+    base_scenario: general-conference
+    industry: medical
+    slices:
+      - conference/login-auth
+      - conference/prejoin-check
+      - conference/room-lifecycle
+      - conference/room-lifecycle
+      - conference/room-call
+      - conference/participant-list
+      - conference/device-control
+      - conference/network-quality
+      - conference/room-chat
+      - conference/video-layout
+    file: scenarios/conference/medical/1v1-video-consultation.md
+    description: 医疗 1v1 视频问诊：医生与患者一对一完成候诊叫号、入诊沟通、病历面板和问诊收口；新建项目优先使用 bundled medical consultation template
+    status: active
+
+  - id: medical-multidoctor-consultation
+    name: 医疗会诊
+    room_type: standard
+    base_scenario: general-conference
+    industry: medical
+    slices:
+      - conference/login-auth
+      - conference/prejoin-check
+      - conference/room-schedule
+      - conference/room-lifecycle
+      - conference/room-lifecycle
+      - conference/room-call
+      - conference/participant-list
+      - conference/participant-management
+      - conference/device-control
+      - conference/network-quality
+      - conference/room-chat
+      - conference/video-layout
+      - conference/screen-share
+    file: scenarios/conference/medical/medical-multidoctor-consultation.md
+    description: 医疗会诊：基于 general-conference 的医疗派生场景，多位医生围绕同一患者病例进行远程讨论、资料共享与会诊结论收口
+    status: active
+
+  - id: general-conference
+    name: 通用会议
+    room_type: standard
+    industry: generic
+    slices:
+      - conference/login-auth
+      - conference/prejoin-check
+      - conference/room-lifecycle
+      - conference/room-lifecycle
+      - conference/participant-list
+      - conference/video-layout
+      - conference/device-control
+      - conference/network-quality
+      - conference/room-chat
+      - conference/screen-share
+      - conference/participant-management
+      - conference/room-schedule
+      - conference/room-call
+      - conference/beauty-effects
+      - conference/virtual-background
+    file: scenarios/conference/base/general-conference.md
+    description: 通用会议：会前预览首页承接新建/加入/预约会议，会中以宫格或演讲者布局、成员面板和底部协作工具栏为核心
+    status: active
+
+  - id: webinar-conference
+    name: 研讨会 / 宣讲会
+    room_type: webinar
+    industry: generic
+    slices:
+      - conference/login-auth
+      - conference/prejoin-check
+      - conference/room-lifecycle
+      - conference/room-lifecycle
+      - conference/participant-list
+      - conference/video-layout
+      - conference/device-control
+      - conference/network-quality
+      - conference/room-chat
+      - conference/screen-share
+      - conference/participant-management
+      - conference/room-schedule
+      - conference/room-call
+    file: scenarios/conference/base/webinar-conference.md
+    description: 研讨会 / 宣讲会：主讲人中心化的 webinar 房型，会中以主舞台、聊天问答、受控上台和主持治理为核心
+    status: active

package/knowledge-base/platform-slice-template.md

@@ -0,0 +1,233 @@
+# 平台 Slice 模板
+
+> **本文件是平台实现 slice 的标准模板。**
+> 复制本文件到 `slices/{product}/{platform}/{ability}.md`，按 `<!-- 指引: ... -->` 批注填写内容，填完后删除所有批注。
+>
+> **填写范例**：请参考 [`slices/live/ios/coguest-apply.md`](slices/live/ios/coguest-apply.md) — 目前最完整的平台 slice，包含所有 section 的真实内容。
+
+---
+
+```yaml
+---
+id: {product}/{ability}       # [必填] 与 index.yaml 中的 id 一致
+platform: {platform}          # [必填] ios / android / web / flutter / electron
+api_docs:                      # [必填] 该平台对应的 API 参考文档链接，至少 1 条
+  - title: {API 类名/模块名}
+    url: https://...
+---
+```
+
+<!-- 指引: Frontmatter 字段说明：
+     - id: 与 index.yaml 中的 slice id 完全一致
+     - platform: 当前平台标识
+     - api_docs: 该功能在该平台的 API 参考文档链接（接口签名、参数类型、返回值等）。
+       产品级概览已不再放文档链接，教程/指南类 URL 也不放在 api_docs 里。
+
+       ✅ 必须精确到类/模块级的 URL（如 CoGuestStore 的 API 页面）
+       ✅ 涉及多个类时可有多条（如 CoGuestStore + DeviceStore 各一条）
+       ❌ 不要填 SDK 首页（AI 拿不到校验所需的签名信息）
+       ❌ 不要填产品级教程页
+
+     其余元数据（name、tags、platforms、related）在产品级概览中维护，此处不重复。
+-->
+
+# {名称} — {平台} 实现
+
+## 前置条件 [必填]
+
+<!-- 指引: 通用依赖（SDK 安装、基础权限）已在 login-auth 平台 slice 中统一描述，此处不要重复。
+     本 section 只写两类内容：
+
+     1. 增量依赖 — 本 slice 额外需要的库/权限（如美颜 SDK、蓝牙权限）。
+        如果没有额外依赖，写「无额外依赖」即可。
+     2. 前置状态 — 本功能依赖哪些 Store 已初始化/哪些操作已完成，引用对应 slice ID。
+
+     ❌ 不要重复写 SDK 主包安装（如 pod 'AtomicXCore'、implementation 'com.tencent.liteav:...'）
+     ❌ 不要重复写基础权限声明（如 NSCameraUsageDescription、CAMERA permission），除非本 slice 需要额外权限
+     ❌ 不要写通用开发环境搭建（如「安装 Xcode」「安装 Android Studio」）
+-->
+
+**通用依赖**：见 [login-auth 平台 slice](../login-auth.md)
+
+**额外依赖**：
+<!-- 如果有本 slice 独有的依赖，在此列出；没有则写「无」 -->
+
+**前置状态**：
+<!-- 列出必须满足的前置条件，引用 slice ID。例如：
+     - `LoginStore.shared` 登录成功（→ live/login-auth）
+     - 已进入直播间，持有有效 liveID（→ live/audience-watch）
+-->
+
+## 代码示例 [必填]
+
+<!-- 指引: 本 section 是平台 slice 的核心交付物。详细标准见 slice-spec.md 第四节「代码示例标准」。
+     定位是「零件」— 单个功能的完整实现。多个零件如何组装成完整场景，由 scenario 的平台实现文件负责。
+
+     最低标准（必须全部满足）：
+     1. 可编译：完整 import、完整类/函数闭包，严禁用 `...` 省略任何逻辑分支
+     2. 可运行：补充业务参数后可直接跑通；业务参数用 `{TODO: 填入 xxx}` 占位
+     3. 有日志锚点：关键路径（成功/失败/事件到达）必须有日志，供「验证矩阵」运行时使用
+        — 日志统一带模块前缀（如 `[CoGuest]`）
+     4. 有错误处理：每个 .failure / catch / error 分支都必须有面向用户的处理（errorMessage / alert），
+        不允许只 print 了事
+     5. 多角色分开写：主播端 / 观众端 必须拆成独立的代码块，不要耦合
+     6. 可组合性：前置依赖通过注释声明（`// 前置：登录完成（→ live/login-auth）`），不硬编码其他 slice 的调用
+
+     组织方式：按用户操作流程，用 MARK / region / 注释分隔各步骤（初始化 → 核心操作 → 事件监听 → 错误处理 → 清理）
+
+     ❌ 不要写伪代码或用省略号 (...) 跳过逻辑
+     ❌ 不要混入其他 slice 的职责代码
+     ❌ 不要把多个功能耦合在一个类里
+     ❌ 不要省略错误处理 — 每个失败分支都必须有处理
+-->
+
+## 调用时序 [条件必填：多角色异步交互 或 回调嵌套 ≥3 层]
+
+<!-- 指引: 【条件必填】— 触发条件任一满足即必须画：
+     — 多角色交互（主播/观众/服务端三方时序不容易从单段代码看出）
+     — 异步回调链路特别深（3 层以上嵌套回调）
+     — 有隐含的时序依赖不写出来容易踩坑（如「必须先订阅再操作」）
+
+     如果代码示例已经足够清晰（单角色、同步或浅回调），可以跳过此 section 并整段删除。
+
+     格式：用 ``` 包裹的 ASCII 文本流程图。
+-->
+
+## 平台特有注意事项 [必填：至少 1 条]
+
+<!-- 指引: 本 section 是平台 slice 区别于产品级概览的核心价值所在。
+     只写该平台独有的坑，产品级概览的通用最佳实践不要重复。
+
+     每条注意事项的格式：
+     ### {编号}. {一句话标题}
+     — 先说现象/问题（开发者会遇到什么）
+     — 再说原因（为什么会这样）
+
+     什么内容该写在这里：
+     - 该平台的类型陷阱（如 iOS 的 Int32 vs Int、Android 的 Int vs Long）
+     - 该平台的生命周期问题（如 Android Activity 重建、iOS 后台挂起）
+     - 该平台的内存/线程问题（如 iOS [weak self]、Android 主线程更新 UI）
+     - 该平台的权限行为差异（如 iOS 崩溃 vs Android 返回错误码）
+     - 该平台特有的错误码或异常行为
+
+     什么内容不该写：
+     ❌ 跨平台通用的业务逻辑（如「先登录再操作」→ 产品级概览已覆盖）
+     ❌ API 用法说明（→ 代码示例已覆盖）
+     ❌ 通用排障流程（→ 产品级概览已覆盖）
+
+     质量标准：每条都应该是「不写出来，研发大概率会踩坑」的内容。
+     如果一条注意事项对于有经验的该平台开发者来说是常识，就不用写。
+-->
+
+## 代码生成约束 [必填]
+
+<!-- 指引: 本 section 供 AI 在生成/验证代码时使用，是给机器读的硬性规则。
+     与「平台特有注意事项」互补：
+     — 注意事项 = 给人读的经验提醒
+     — 代码生成约束 = 给 AI 读的可检查规则
+
+     所有规则必须基于实际 SDK 行为，不允许凭经验推测。
+     ⚠️ 核心要求：每条 MUST / MUST NOT 使用 **prose + backtick** 格式：
+        N. **<动作> `符号`** — <违反后果>。
+           **Verify**: 检查是否存在 `符号`。
+     backtick 里的符号 = apply 唯一会 grep 的东西；规则文字其他词 apply 不验。
+     完整原则与红旗词表见 slice-spec.md 第四节「MUST 规则的维度对齐原则」。
+-->
+
+### 编译必要条件 [必填]
+
+<!-- 指引: 本 slice 代码能编译通过的最小条件。
+     只写增量条件（通用条件见 login-auth slice）。
+     — 必须导入的模块/包（精确到包名）
+     — 本 slice 额外需要的 SDK 版本要求（如果高于基础要求）
+     — 本 slice 额外需要的权限声明或配置
+
+     如果没有增量条件，写「同 login-auth，无额外要求」
+-->
+
+### 生成规则 [必填]
+
+#### MUST（生成时必须包含）
+
+<!-- 指引: 每条格式：
+
+     N. **<动作> `符号`** — <违反后果>。
+        **Verify**: 检查是否存在 `符号`。
+
+     重要原则（详细规则见 slice-spec.md 第四节「MUST 规则的维度对齐原则」）：
+     — backtick 里的符号 = apply 唯一会 grep 的东西
+     — 规则文字描述的判断 / 选择 / 等价 / 条件分支，apply 全部不验
+     — 多 backtick 的规则可以接受，apply 解析为「全部都要出现」（all-of）
+
+     ⚠️ 红旗词：以下写法说明 MUST 写错了，要么拆分要么下沉到软规则区
+     — 「或 / 任一」、「等价 / 或类似」、「按业务 / 根据场景」
+     — 「留给 / 负责」、「多 backtick 但 Verify 只提一个」
+
+     示例（复制修改）：
+     1. **必须导入 `useRoomState`** — 否则状态与 UI 无法收口。
+        **Verify**: 检查是否存在 `useRoomState`。
+
+     2. **必须从 `tuikit-atomicx-vue3/room` 导入** — 错包的同名 hook 不会跑通。
+        **Verify**: 检查是否存在 `tuikit-atomicx-vue3/room` 与 `useRoomState`
+        同时出现在同一 import 语句。
+
+     只写本 slice 独有的规则。跨 slice 通用规则如果在多个 slice 中反复出现，
+     考虑提到产品级概览或 base-setup 中。
+-->
+
+#### MUST NOT（生成时绝不能出现）
+
+<!-- 指引: 同上格式，每条 = 一个禁现的具体符号或符号组合。
+     重点写「看起来能跑但逻辑错误」的写法 — 这类问题编译器抓不到，只有了解业务语义才能避免。
+
+     示例：
+     1. **不要把 `leaveRoom()` 当成解散会议** — 会导致房主离开后房间仍在。
+        **Verify**: 检查 `leaveRoom` 不与房主路径并列出现，房主收口必须用 `endRoom`。
+
+     注：MUST NOT 的 Verify 同样依赖 backtick 符号 + apply 的「all-of」grep；
+     避免用「不应该 / 不要」+ 抽象描述这种 grep 无法验证的写法。
+-->
+
+### 集成检查点 [必填]
+
+<!-- 指引: 假设目标是已有项目（不是从零开始的 demo），列出集成时需要确认的事项：
+     — 是否与项目中已有的 SDK 初始化冲突
+     — 是否需要合并到已有的生命周期方法中（而非新建）
+     — 是否依赖其他 slice 的前置状态（引用具体 slice ID）
+     — 对已有代码的侵入性（新增文件 vs 修改已有文件）
+-->
+
+## 验证矩阵 [必填]
+
+<!-- 指引: 平台 slice 的统一验收出口。AI 生成代码后或人工 review 时，自上而下跑一遍就能完成验收。
+
+     4 个层级：
+     — 1. 编译级：能编译、依赖齐全（CI / AI 自动）
+     — 2. 静态规则级：纯静态扫描 / grep 可查（CI / AI 自动）
+     — 3. 运行时级：跑起来通过日志锚点可观察（AI 半自动 / 人工）
+     — 4. 业务行为级：人眼看 UI / 硬件状态（人工）
+
+     要求：
+     — 每条「代码生成约束」的 MUST / MUST NOT 都要在矩阵中有对应行（层级 1 或 2）
+     — 至少 1 条层级 3 的检查，证明代码真能跑
+     — 至少 1 条层级 4 的检查，证明业务语义正确（通常是 ALWAYS / NEVER 的运行时体现）
+-->
+
+| 层级 | 检查项 | 验证手段 | 预期结果 |
+|------|--------|----------|---------|
+| 1. 编译级 | {模块导入齐全} | {xcodebuild build / ./gradlew assembleDebug / tsc --noEmit} | exit code 0 |
+| 1. 编译级 | {最低版本达标} | {查项目 deployment target} | ≥ {版本} |
+| 2. 静态规则级 | {对应 MUST 规则 1} | {grep 正则} | {匹配条件} |
+| 2. 静态规则级 | {对应 MUST NOT 规则 1} | {grep 正则} | {不应匹配} |
+| 3. 运行时级 | {关键路径日志} | {触发操作 → 查日志} | {日志内容} |
+| 4. 业务行为级 | {业务语义观察} | {操作步骤} | {UI / 硬件状态} |
+
+---
+
+## DoD 自查（提交前删除此 section）
+
+提交前对照 `slice-spec.md` 第五节「平台实现文件 DoD」逐条打勾。任何一项不满足 = 未完成。
+
+---
+
+> **填写范例**：请参考 [`slices/live/ios/coguest-apply.md`](slices/live/ios/coguest-apply.md) — 这是目前最完整的平台 slice 实现，包含所有 section 的真实内容。