npm - @tencent-rtc/trtc-agent-skills - Versions diffs - 0.1.4 → 0.1.6 - Mend

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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (94) hide show

package/CODEBUDDY.md +0 -24
package/README.md +12 -0
package/README.zh.md +12 -0
package/bin/cli.js +18 -5
package/knowledge-base/chat/web/index.yaml +168 -0
package/knowledge-base/chat/web/path-d-signals.yaml +4 -0
package/knowledge-base/docs/chat/debug/GenerateTestUserSig.js +23 -0
package/knowledge-base/docs/chat/debug/lib-generate-test-usersig.min.js +1 -0
package/knowledge-base/docs/chat/gen-usersig.md +129 -0
package/knowledge-base/docs/chat/product.md +61 -0
package/knowledge-base/docs/chat/restapi.md +227 -0
package/knowledge-base/docs/chat/sdk/android/faq.md +7 -0
package/knowledge-base/docs/chat/sdk/android/index.md +94 -0
package/knowledge-base/docs/chat/sdk/flutter/faq.md +7 -0
package/knowledge-base/docs/chat/sdk/flutter/index.md +83 -0
package/knowledge-base/docs/chat/sdk/ios/faq.md +7 -0
package/knowledge-base/docs/chat/sdk/ios/index.md +94 -0
package/knowledge-base/docs/chat/sdk/web/faq.md +8 -0
package/knowledge-base/docs/chat/sdk/web/index.md +97 -0
package/knowledge-base/docs/chat/uikit/android/index.md +28 -0
package/knowledge-base/docs/chat/uikit/flutter/index.md +17 -0
package/knowledge-base/docs/chat/uikit/ios/index.md +28 -0
package/knowledge-base/docs/chat/uikit/react/index.md +6 -0
package/knowledge-base/docs/chat/uikit/uniapp/index.md +6 -0
package/knowledge-base/docs/chat/uikit/vue3/index.md +6 -0
package/knowledge-base/docs/chat/webhook.md +73 -0
package/knowledge-base/products.yaml +2 -2
package/knowledge-base/slices/chat/web/at-mention.md +417 -0
package/knowledge-base/slices/chat/web/conversation-actions.md +178 -0
package/knowledge-base/slices/chat/web/conversation-list.md +368 -0
package/knowledge-base/slices/chat/web/detect-integration.md +36 -0
package/knowledge-base/slices/chat/web/detect-style.md +88 -0
package/knowledge-base/slices/chat/web/direct-chat-entry.md +210 -0
package/knowledge-base/slices/chat/web/login-auth.md +244 -0
package/knowledge-base/slices/chat/web/message-base-actions.md +273 -0
package/knowledge-base/slices/chat/web/message-input.md +209 -0
package/knowledge-base/slices/chat/web/message-list.md +532 -0
package/knowledge-base/slices/chat/web/send-custom-message.md +189 -0
package/knowledge-base/slices/chat/web/send-media.md +214 -0
package/knowledge-base/slices/chat/web/state-api-skeleton.md +60 -0
package/knowledge-base/slices/chat/web/style-guide.md +210 -0
package/package.json +5 -1
package/skills/trtc/SKILL.md +57 -23
package/skills/trtc/hooks/topic_phase_gate.py +5 -0
package/skills/trtc/tests/test_reporting_v2_docs_query.py +175 -0
package/skills/trtc/tools/kb.py +130 -0
package/skills/trtc/tools/reporting.py +23 -2
package/skills/trtc/tools/reporting_v2.py +501 -0
package/skills/trtc-ai-service/README.ja.md +209 -0
package/skills/trtc-ai-service/README.md +23 -9
package/skills/trtc-ai-service/README.zh-CN.md +23 -9
package/skills/trtc-ai-service/SKILL.md +4 -4
package/skills/trtc-chat/.docs-query.yaml +9 -0
package/skills/trtc-chat/SKILL.md +186 -0
package/skills/trtc-chat/docs/SKILL.md +31 -0
package/skills/trtc-chat/flows/maintenance.md +19 -0
package/skills/trtc-chat/flows/onboarding.md +79 -0
package/skills/trtc-chat/references/01-detect-project.md +136 -0
package/skills/trtc-chat/references/02-path-a-questions.md +182 -0
package/skills/trtc-chat/references/02-path-a-scaffold-template.md +59 -0
package/skills/trtc-chat/references/02-path-a-script.md +266 -0
package/skills/trtc-chat/references/02-path-a-templates.md +159 -0
package/skills/trtc-chat/references/03-path-b-script.md +226 -0
package/skills/trtc-chat/references/04-path-c-script.md +95 -0
package/skills/trtc-chat/references/04-uikit-redirect.md +32 -0
package/skills/trtc-chat/references/05-path-d-script.md +735 -0
package/skills/trtc-chat/references/05-slice-loading.md +139 -0
package/skills/trtc-chat/references/06-a-defensive-coding.md +139 -0
package/skills/trtc-chat/references/06-hard-rules.md +190 -0
package/skills/trtc-chat/references/08-state-config.md +231 -0
package/skills/trtc-chat/references/09-troubleshoot.md +91 -0
package/skills/trtc-chat/references/10-references-index.md +63 -0
package/skills/trtc-chat/references/11-what-to-do-next-template.md +338 -0
package/skills/trtc-chat/references/12-page-composition.md +73 -0
package/skills/trtc-chat/references/13-reporting.md +166 -0
package/skills/trtc-chat/references/14-official-docs.md +169 -0
package/skills/trtc-chat/references/execution-units.yaml +27 -0
package/skills/trtc-chat/references/vue3.md +104 -0
package/skills/trtc-chat/tests/test_chat_bundle_contract.py +330 -0
package/skills/trtc-chat/tools/__init__.py +5 -0
package/skills/trtc-chat/tools/_delegate.py +32 -0
package/skills/trtc-chat/tools/flow.py +8 -0
package/skills/trtc-chat/tools/kb.py +8 -0
package/skills/trtc-chat/tools/reporting_v2.py +8 -0
package/skills/trtc-chat/tools/session.py +8 -0
package/hooks/__pycache__/cursor-adapter.cpython-313.pyc +0 -0
package/skills/trtc/hooks/__pycache__/report_prompt.cpython-313.pyc +0 -0
package/skills/trtc/tools/__pycache__/__init__.cpython-313.pyc +0 -0
package/skills/trtc/tools/__pycache__/query_classifier.cpython-313.pyc +0 -0
package/skills/trtc/tools/__pycache__/reporting.cpython-313.pyc +0 -0
package/skills/trtc/tools/__pycache__/search.cpython-313.pyc +0 -0
package/skills/trtc/tools/__pycache__/session.cpython-313.pyc +0 -0
package/skills/trtc-conference/tests/__pycache__/test_conference_onboarding_contract.cpython-313-pytest-9.0.2.pyc +0 -0
package/skills/trtc-conference/tests/__pycache__/test_conference_topic_flow_contract.cpython-313-pytest-9.0.2.pyc +0 -0

package/knowledge-base/docs/chat/product.md ADDED Viewed

@@ -0,0 +1,61 @@
+# 产品计费与配置 — 官方文档 URL 映射
+## 计费与购买
+| 子问题 | 目标文档 |
+|--------|---------|
+| 计费说明 | `https://cloud.tencent.com/document/product/269/11673` |
+| 购买指引 | `https://cloud.tencent.com/document/product/269/32458` |
+| 套餐包功能差异 | `https://cloud.tencent.com/document/product/269/112884` |
+| 购买套餐后变更配置 | `https://cloud.tencent.com/document/product/269/81908` |
+| 续费指引（含自动续费） | `https://cloud.tencent.com/document/product/269/32472` |
+| 退费指引 | `https://cloud.tencent.com/document/product/269/32473` |
+## 产品能力与配置
+| 子问题 | 目标文档 |
+|--------|---------|
+| 多端登录配置指引 | `https://cloud.tencent.com/document/product/269/1499` |
+| 控制台功能介绍 | `https://cloud.tencent.com/document/product/269/1499` |
+| 用户在线状态管理 | `https://cloud.tencent.com/document/product/269/3665` |
+| 用户资料管理（标准资料字段/自定义资料字段/自定义资料字段的命名规范） | `https://cloud.tencent.com/document/product/269/1500` |
+| 关系链管理（标配好友字段/自定义好友字段/添加好友/删除好友功能介绍） | `https://cloud.tencent.com/document/product/269/1501` |
+| 漫游消息存储时长说明 | `https://cloud.tencent.com/document/product/269/81908` |
+| 单聊消息权限控制与配置 | `https://cloud.tencent.com/document/product/269/3662` |
+| 群组消息管理（App 管理员发送消息/群消息发送控制/消息优先级与频率控制
+） | `https://cloud.tencent.com/document/product/269/3663` |
+| 不同类型群组基础能力操作差异 | `https://cloud.tencent.com/document/product/269/1502` |
+| 不同类型群组加群方式差异 | `https://cloud.tencent.com/document/product/269/1502` |
+| 不同类型群组成员管理能力差异 | `https://cloud.tencent.com/document/product/269/1502` |
+| 不同类型群组群组限制差异 | `https://cloud.tencent.com/document/product/269/1502` |
+| 不同类型群组消息能力差异 | `https://cloud.tencent.com/document/product/269/1502` |
+| 群组/群成员/群消息导入 | `https://cloud.tencent.com/document/product/269/1502` |
+| 群组自动回收能力 | `https://cloud.tencent.com/document/product/269/1502` |
+| 自定义群组ID(话题 ID) | `https://cloud.tencent.com/document/product/269/1502` |
+| 群组自定义字段 | `https://cloud.tencent.com/document/product/269/1502` |
+| 云端审核能力介绍 | `https://cloud.tencent.com/document/product/269/83795` |
+### 使用限制
+| 子问题 | 目标文档 |
+|--------|---------|
+| 业务特性限制（UserID 命名规则/格式要求/长度上限/允许字符、单个 App 可创建群组数/用户加入群组上限/群成员数/好友数上限等） | `https://cloud.tencent.com/document/product/269/32429` |
+| 接口通用限制（REST API QPS 限制/请求频率/消息体大小 12KB 限制（不可修改）/单次拉取与批量接口上限等） | `https://cloud.tencent.com/document/product/269/32429` |
+| 账号管理限制（导入账号上限/批量导入多个账号上限/删除与查询账号限制数等） | `https://cloud.tencent.com/document/product/269/32429` |
+| 单聊消息限制（离线消息漫游存储时长/单聊单条消息已读回执限制等） | `https://cloud.tencent.com/document/product/269/32429` |
+| 关系链管理限制（添加与删除好友限制/好友分组限制/黑名单限制/批量好友接口上限等） | `https://cloud.tencent.com/document/product/269/32429` |
+| 群组管理限制（群主转让/群成员禁言/群封禁人数限制/群计数器限制/群自定义字段数等） | `https://cloud.tencent.com/document/product/269/32429` |
+## 出海解决方案
+| 子问题 | 目标文档 |
+|--------|---------|
+| 海外接入指南 | `https://cloud.tencent.com/document/product/269/81906` |
+| 海外节点全球加速 | `https://cloud.tencent.com/document/product/269/86463` |
+| 海外数据安全合规 | `https://cloud.tencent.com/document/product/269/86464` |
+## 场景解决方案
+| 子问题 | 目标文档 |
+|--------|---------|
+| 内网代理实现方案 | `https://cloud.tencent.com/document/product/269/122408` |

package/knowledge-base/docs/chat/restapi.md ADDED Viewed

@@ -0,0 +1,227 @@
+# 服务端 REST API — 官方文档 URL 映射
+### 通用技术
+| 子问题 | 目标文档 |
+|--------|---------|
+| UserSig 生成方法（登录鉴权） | `https://cloud.tencent.com/document/product/269/32688` |
+| 服务端错误码表 | `https://cloud.tencent.com/document/product/269/1671` |
+| 服务端消息格式 | `https://cloud.tencent.com/document/product/269/2720` |
+## 消息相关 REST API
+### 发送消息
+| 子问题 | 目标文档 |
+|--------|---------|
+| 单发单聊消息 | `https://cloud.tencent.com/document/product/269/2282` |
+| 批量发单聊消息 | `https://cloud.tencent.com/document/product/269/1612` |
+| 在群组中发送普通消息 | `https://cloud.tencent.com/document/product/269/1629` |
+| 发送 C2C 流式消息 | `https://cloud.tencent.com/document/product/269/128596` |
+| 发送群流式消息 | `https://cloud.tencent.com/document/product/269/128597` |
+| 直播群广播消息 | `https://cloud.tencent.com/document/product/269/77402` |
+| 导入群消息 | `https://cloud.tencent.com/document/product/269/1635` |
+| 导入单聊消息 | `https://cloud.tencent.com/document/product/269/2568` |
+| 公众号用户发送广播消息 | `https://cloud.tencent.com/document/product/269/102298` |
+### 历史消息
+| 子问题 | 目标文档 |
+|--------|---------|
+| 修改单聊历史消息 | `https://cloud.tencent.com/document/product/269/74740` |
+| 修改群聊历史消息 | `https://cloud.tencent.com/document/product/269/74741` |
+| 拉取单聊历史消息 | `https://cloud.tencent.com/document/product/269/42794` |
+| 拉取群聊历史消息 | `https://cloud.tencent.com/document/product/269/2738` |
+| 拉取公众号用户历史消息 | `https://cloud.tencent.com/document/product/269/102299` |
+### 删除消息
+| 子问题 | 目标文档 |
+|--------|---------|
+| 单向删除单聊历史消息 | `https://cloud.tencent.com/document/product/269/101439` |
+| 清空群聊历史消息 | `https://cloud.tencent.com/document/product/269/95617` |
+| 删除指定用户发送的消息 | `https://cloud.tencent.com/document/product/269/2359` |
+### 撤回消息
+| 子问题 | 目标文档 |
+|--------|---------|
+| 撤回单聊消息 | `https://cloud.tencent.com/document/product/269/38980` |
+| 撤回群消息 | `https://cloud.tencent.com/document/product/269/12341` |
+| 撤回公众号消息 | `https://cloud.tencent.com/document/product/269/102327` |
+### 已读回执
+| 子问题 | 目标文档 |
+|--------|---------|
+| 群消息已读回执 | `https://cloud.tencent.com/document/product/269/107478` |
+| 发送单聊消息已读回执 | `https://cloud.tencent.com/document/product/269/104121` |
+| 拉取群消息已读回执详情 | `https://cloud.tencent.com/document/product/269/77693` |
+| 拉取群消息已读回执信息 | `https://cloud.tencent.com/document/product/269/77694` |
+### 消息扩展
+| 子问题 | 目标文档 |
+|--------|---------|
+| 拉取单聊消息扩展 | `https://cloud.tencent.com/document/product/269/82029` |
+| 设置单聊消息扩展 | `https://cloud.tencent.com/document/product/269/82030` |
+| 拉取群消息扩展 | `https://cloud.tencent.com/document/product/269/82031` |
+| 设置群消息扩展 | `https://cloud.tencent.com/document/product/269/82032` |
+## 会话相关 REST API
+### 会话基础能力
+| 子问题 | 目标文档 |
+|--------|---------|
+| 拉取会话列表 | `https://cloud.tencent.com/document/product/269/62118` |
+| 设置群成员未读消息计数 | `https://cloud.tencent.com/document/product/269/1637` |
+| 清理单聊会话的未读消息计数 | `https://cloud.tencent.com/document/product/269/50349` |
+| 设置置顶会话 | `https://cloud.tencent.com/document/product/269/103772` |
+| 删除单个会话 | `https://cloud.tencent.com/document/product/269/62119` |
+### 会话分组标记
+| 子问题 | 目标文档 |
+|--------|---------|
+| 创建会话分组数据 | `https://cloud.tencent.com/document/product/269/85791` |
+| 更新会话分组数据 | `https://cloud.tencent.com/document/product/269/85793` |
+| 删除会话分组数据 | `https://cloud.tencent.com/document/product/269/85795` |
+| 创建或更新会话标记数据 | `https://cloud.tencent.com/document/product/269/85792` |
+| 搜索会话分组标记 | `https://cloud.tencent.com/document/product/269/85796` |
+| 拉取会话分组标记数据 | `https://cloud.tencent.com/document/product/269/85794` |
+## 群组相关 REST API
+### 群组管理
+| 子问题 | 目标文档 |
+|--------|---------|
+| 创建群组 | `https://cloud.tencent.com/document/product/269/1615` |
+| 解散群组 | `https://cloud.tencent.com/document/product/269/1624` |
+| 获取用户所加入的群组 | `https://cloud.tencent.com/document/product/269/1625` |
+| 获取 App 中的所有群组 | `https://cloud.tencent.com/document/product/269/1614` |
+### 群资料
+| 子问题 | 目标文档 |
+|--------|---------|
+| 获取群详细资料 | `https://cloud.tencent.com/document/product/269/1616` |
+| 修改群基础资料 | `https://cloud.tencent.com/document/product/269/1620` |
+| 导入群基础资料 | `https://cloud.tencent.com/document/product/269/1634` |
+### 群成员管理
+| 子问题 | 目标文档 |
+|--------|---------|
+| 增加群成员 | `https://cloud.tencent.com/document/product/269/1621` |
+| 删除群成员 | `https://cloud.tencent.com/document/product/269/1622` |
+| 群成员封禁 | `https://cloud.tencent.com/document/product/269/79249` |
+| 群成员解封 | `https://cloud.tencent.com/document/product/269/79250` |
+| 获取封禁群成员列表 | `https://cloud.tencent.com/document/product/269/79248` |
+| 批量禁言和取消禁言 | `https://cloud.tencent.com/document/product/269/1627` |
+| 获取被禁言群成员列表 | `https://cloud.tencent.com/document/product/269/2925` |
+| 转让群主 | `https://cloud.tencent.com/document/product/269/1633` |
+| 查询用户在群组中的身份 | `https://cloud.tencent.com/document/product/269/1626` |
+| 导入群成员 | `https://cloud.tencent.com/document/product/269/1636` |
+### 群成员资料
+| 子问题 | 目标文档 |
+|--------|---------|
+| 获取群成员详细资料 | `https://cloud.tencent.com/document/product/269/1617` |
+| 获取指定群成员详细资料 | `https://cloud.tencent.com/document/product/269/112002` |
+| 修改群成员资料 | `https://cloud.tencent.com/document/product/269/1623` |
+### 群自定义属性
+| 子问题 | 目标文档 |
+|--------|---------|
+| 获取群自定义属性 | `https://cloud.tencent.com/document/product/269/67012` |
+| 修改群自定义属性 | `https://cloud.tencent.com/document/product/269/67010` |
+| 清空群自定义属性 | `https://cloud.tencent.com/document/product/269/67009` |
+| 重置群自定义属性 | `https://cloud.tencent.com/document/product/269/67011` |
+| 删除群自定义属性 | `https://cloud.tencent.com/document/product/269/104440` |
+### 直播群管理
+| 子问题 | 目标文档 |
+|--------|---------|
+| 设置直播群机器人 | `https://cloud.tencent.com/document/product/269/103784` |
+| 取消直播群机器人 | `https://cloud.tencent.com/document/product/269/103785` |
+| 设置/取消直播群管理员 | `https://cloud.tencent.com/document/product/269/102857` |
+| 获取直播群管理员列表 | `https://cloud.tencent.com/document/product/269/102858` |
+| 获取直播群在线人数 | `https://cloud.tencent.com/document/product/269/49180` |
+| 获取直播群在线成员列表 | `https://cloud.tencent.com/document/product/269/77266` |
+| 设置直播群成员标记 | `https://cloud.tencent.com/document/product/269/79267` |
+### 社群管理
+| 子问题 | 目标文档 |
+|--------|---------|
+| 创建话题 | `https://cloud.tencent.com/document/product/269/78203` |
+| 解散话题 | `https://cloud.tencent.com/document/product/269/78202` |
+| 获取话题资料 | `https://cloud.tencent.com/document/product/269/78204` |
+| 修改话题资料 | `https://cloud.tencent.com/document/product/269/78205` |
+| 导入话题基础资料 | `https://cloud.tencent.com/document/product/269/85313` |
+| 获取社群在线人数 | `https://cloud.tencent.com/document/product/269/102707` |
+### 群计数器
+| 子问题 | 目标文档 |
+|--------|---------|
+| 获取群计数器 | `https://cloud.tencent.com/document/product/269/85953` |
+| 更新群计数器 | `https://cloud.tencent.com/document/product/269/85952` |
+| 删除群计数器 | `https://cloud.tencent.com/document/product/269/85954` |
+## 用户相关 REST API
+### 账号管理
+| 子问题 | 目标文档 |
+|--------|---------|
+| 导入单个账号 | `https://cloud.tencent.com/document/product/269/1608` |
+| 导入多个账号 | `https://cloud.tencent.com/document/product/269/4919` |
+| 查询账号 | `https://cloud.tencent.com/document/product/269/38417` |
+| 删除账号 | `https://cloud.tencent.com/document/product/269/36443` |
+### 用户资料管理
+| 子问题 | 目标文档 |
+|--------|---------|
+| 获取用户资料 | `https://cloud.tencent.com/document/product/269/1639` |
+| 设置用户资料 | `https://cloud.tencent.com/document/product/269/1640` |
+### 用户在线状态
+| 子问题 | 目标文档 |
+|--------|---------|
+| 查询账号在线状态 | `https://cloud.tencent.com/document/product/269/2566` |
+| 失效账号登录状态 | `https://cloud.tencent.com/document/product/269/3853` |
+### 全局禁言管理
+| 子问题 | 目标文档 |
+|--------|---------|
+| 设置全局禁言 | `https://cloud.tencent.com/document/product/269/4230` |
+| 查询全局禁言 | `https://cloud.tencent.com/document/product/269/4229` |
+### 云端搜索
+| 子问题 | 目标文档 |
+|--------|---------|
+| 用户搜索 | `https://cloud.tencent.com/document/product/269/114547` |
+| 群成员搜索 | `https://cloud.tencent.com/document/product/269/114548` |
+| 群组搜索 | `https://cloud.tencent.com/document/product/269/114549` |
+| 隐藏搜索对象 | `https://cloud.tencent.com/document/product/269/114550` |
+| 查询隐藏搜索对象 | `https://cloud.tencent.com/document/product/269/114551` |
+### 机器人
+| 子问题 | 目标文档 |
+|--------|---------|
+| 发送流式响应消息 | `https://cloud.tencent.com/document/product/269/104537` |
+| 创建机器人 | `https://cloud.tencent.com/document/product/269/89991` |
+| 删除机器人 | `https://cloud.tencent.com/document/product/269/89992` |
+| 获取取所有机器人 | `https://cloud.tencent.com/document/product/269/89993` |

package/knowledge-base/docs/chat/sdk/android/faq.md ADDED Viewed

@@ -0,0 +1,7 @@
+# Web — 高频问题预检清单
+> dispatcher 检索前先判断是否属于已知高频问题，可节省一次 android 请求。
+| 高频问题 | 快速答案（预埋） |
+|---------|----------------|

package/knowledge-base/docs/chat/sdk/android/index.md ADDED Viewed

@@ -0,0 +1,94 @@
+# Web — SDK 官方文档 URL 映射
+> 知识咨询时 `read_file` 本文件，按问题匹配领域和子问题，获取目标 URL。检索方式和兜底策略见 `references/14-official-docs.md`。
+## A — SDK 集成和初始化（Android）
+| 子问题 | 目标文档 |
+|--------|---------|
+| Android SDK 集成 | `https://cloud.tencent.com/document/product/269/75283` |
+| Android SDK 初始化 | `https://cloud.tencent.com/document/product/269/75291` |
+## B — 登录
+| 子问题 | 目标文档 |
+|--------|---------|
+| 登录（`login` API） | `https://cloud.tencent.com/document/product/269/75294` |
+| 登出（`logout` API） | `https://cloud.tencent.com/document/product/269/75294` |
+## C — SDK API 使用
+| 子问题 | 目标文档 |
+|--------|---------|
+| SDK 消息类型介绍 | `https://cloud.tencent.com/document/product/269/75313` |
+| 文本消息（sendC2CMessage/sendGroupTextMessage） | `https://cloud.tencent.com/document/product/269/75315` |
+| 群 @ 消息（createAtSignedGroupMessage → sendMessage） | `https://cloud.tencent.com/document/product/269/75349` |
+| 图片消息（createImageMessage → sendMessage） | `https://cloud.tencent.com/document/product/269/75315` |
+| 语音消息（createSoundMessage → sendMessage） | `https://cloud.tencent.com/document/product/269/75315` |
+| 视频消息（createVideoMessage → sendMessage） | `https://cloud.tencent.com/document/product/269/75315` |
+| 文件消息（createFileMessage → sendMessage） | `https://cloud.tencent.com/document/product/269/75315` |
+| 自定义消息（sendC2CCustomMessage/sendGroupCustomMessage） | `https://cloud.tencent.com/document/product/269/75315` |
+| 表情消息（createFaceMessage → sendMessage） | `https://cloud.tencent.com/document/product/269/75315` |
+| 地理位置消息（createLocationMessage → sendMessage） | `https://cloud.tencent.com/document/product/269/75315` |
+| 合并消息（createMergerMessage → sendMessage） | `https://cloud.tencent.com/document/product/269/75324` |
+| 逐条转发消息（createForwardMessage → sendMessage） | `https://cloud.tencent.com/document/product/269/75324` |
+| 发送消息参数配置（sendMessage 参数） | `https://cloud.tencent.com/document/product/269/75315` |
+| 接收消息（addSimpleMsgListener/addAdvancedMsgListener） | `https://cloud.tencent.com/document/product/269/75318` |
+| 获取历史消息（getC2CHistoryMessageList/getGroupHistoryMessageList/getHistoryMessageList） | `https://cloud.tencent.com/document/product/269/75321` |
+| 修改消息（modifyMessage） | `https://cloud.tencent.com/document/product/269/75327` |
+| 插入消息（insertC2CMessageToLocalStorage/insertGroupMessageToLocalStorage） | `https://cloud.tencent.com/document/product/269/75330` |
+| 删除消息（deleteMessageFromLocalStorage/deleteMessages） | `https://cloud.tencent.com/document/product/269/75332` |
+| 清空消息（clearC2CHistoryMessage/clearGroupHistoryMessage） | `https://cloud.tencent.com/document/product/269/75335` |
+| 撤回消息（revokeMessage） | `https://cloud.tencent.com/document/product/269/75337` |
+| 在线消息 | `https://cloud.tencent.com/document/product/269/75340` |
+| 已读回执（单聊/群聊） | `https://cloud.tencent.com/document/product/269/75343` |
+| 查询消息（findMessages） | `https://cloud.tencent.com/document/product/269/75346` |
+| 群定向消息 | `https://cloud.tencent.com/document/product/269/75351` |
+| 消息免打扰（setC2CReceiveMessageOpt/setGroupReceiveMessageOpt/setAllReceiveMessageOpt） | `https://cloud.tencent.com/document/product/269/75353` |
+| 消息扩展（投票/接龙场景） | `https://cloud.tencent.com/document/product/269/81038` |
+| 消息回应（表情回应） | `https://cloud.tencent.com/document/product/269/96241` |
+| 消息翻译（translateText） | `https://cloud.tencent.com/document/product/269/85380` |
+| 语音转文字（convertVoiceToText） | `https://cloud.tencent.com/document/product/269/96280` |
+| 消息置顶（pinGroupMessage） | `https://cloud.tencent.com/document/product/269/106050` |
+| 流式消息（V2TIM_ELEM_TYPE_STREAM） | `https://cloud.tencent.com/document/product/269/129557` |
+| 文字转语音 | `https://cloud.tencent.com/document/product/269/131939` |
+| 会话存储限制 | `https://cloud.tencent.com/document/product/269/75363` |
+| 会话列表（getConversationList） | `https://cloud.tencent.com/document/product/269/75366` |
+| 会话资料（getConversation） | `https://cloud.tencent.com/document/product/269/75369` |
+| 会话未读数（getTotalUnreadMessageCount） | `https://cloud.tencent.com/document/product/269/75372` |
+| 置顶会话（pinConversation） | `https://cloud.tencent.com/document/product/269/75375` |
+| 删除会话（deleteConversation） | `https://cloud.tencent.com/document/product/269/75378` |
+| 会话草稿（setConversationDraft） | `https://cloud.tencent.com/document/product/269/75381` |
+| 会话标记（markConversation） | `https://cloud.tencent.com/document/product/269/77389` |
+| 会话分组 | `https://cloud.tencent.com/document/product/269/77392` |
+| 群组类型和不同群类型能力介绍 | `https://cloud.tencent.com/document/product/269/75697` |
+| 普通群管理 | `https://cloud.tencent.com/document/product/269/75395` |
+| 群资料（getGroupsInfo / setGroupInfo） | `https://cloud.tencent.com/document/product/269/75397` |
+| 群成员管理 | `https://cloud.tencent.com/document/product/269/75400` |
+| 群成员资料 | `https://cloud.tencent.com/document/product/269/75403` |
+| 群自定义属性 | `https://cloud.tencent.com/document/product/269/75406` |
+| 群计数器（groupCounter） | `https://cloud.tencent.com/document/product/269/85676` |
+| 社群（Community / 话题） | `https://cloud.tencent.com/document/product/269/75409` |
+| 社群（权限组） | `https://cloud.tencent.com/document/product/269/104417` |
+| 用户资料（getUsersInfo / setSelfInfo） | `https://cloud.tencent.com/document/product/269/75416` |
+| 用户状态（getUserStatus / subscribeUserStatus） | `https://cloud.tencent.com/document/product/269/75511` |
+| 好友管理 | `https://cloud.tencent.com/document/product/269/75419` |
+| 好友分组 | `https://cloud.tencent.com/document/product/269/75422` |
+| 用户黑名单 | `https://cloud.tencent.com/document/product/269/75425` |
+| 关注和粉丝 | `https://cloud.tencent.com/document/product/269/105494` |
+| 云端搜索消息（searchCloudMessages） | `https://cloud.tencent.com/document/product/269/115824` |
+| 云端搜索用户（searchUsers） | `https://cloud.tencent.com/document/product/269/115825` |
+| 云端搜索群组（searchGroups） | `https://cloud.tencent.com/document/product/269/115826` |
+| 云端搜索群成员（searchGroupMembers） | `https://cloud.tencent.com/document/product/269/115827` |
+| 本地搜索消息（searchLocalMessages） | `https://cloud.tencent.com/document/product/269/75436` |
+| 本地搜索好友（searchFriends） | `https://cloud.tencent.com/document/product/269/75439` |
+| 本地搜索群组（searchGroups） | `https://cloud.tencent.com/document/product/269/75441` |
+| 本地搜索群成员（searchGroupMembers） | `https://cloud.tencent.com/document/product/269/75443` |
+## D — 错误码（SDK 错误码）
+> 错误码查询策略见 `references/14-official-docs.md §14.4`
+| 子问题 | 目标文档 |
+|--------|---------|
+| Android SDK 错误码表 | `https://cloud.tencent.com/document/product/269/1671` |

package/knowledge-base/docs/chat/sdk/flutter/faq.md ADDED Viewed

@@ -0,0 +1,7 @@
+# Web — 高频问题预检清单
+> dispatcher 检索前先判断是否属于已知高频问题，可节省一次 flutter 请求。
+| 高频问题 | 快速答案（预埋） |
+|---------|----------------|

package/knowledge-base/docs/chat/sdk/flutter/index.md ADDED Viewed

@@ -0,0 +1,83 @@
+# Web — SDK 官方文档 URL 映射
+> 知识咨询时 `read_file` 本文件，按问题匹配领域和子问题，获取目标 URL。检索方式和兜底策略见 `references/14-official-docs.md`。
+## A — SDK 集成和初始化（Flutter）
+| 子问题 | 目标文档 |
+|--------|---------|
+| Flutter SDK 集成 | `https://cloud.tencent.com/document/product/269/75286` |
+| Flutter SDK 初始化 | `https://cloud.tencent.com/document/product/269/75293` |
+## B — 多端登录配置与 UserSig 鉴权
+| 子问题 | 目标文档 |
+|--------|---------|
+| 登录（`login` API） | `https://cloud.tencent.com/document/product/269/75296` |
+| 登出（`logout` API） | `https://cloud.tencent.com/document/product/269/75296` |
+## C — SDK API 使用
+| 子问题 | 目标文档 |
+|--------|---------|
+| SDK 消息类型介绍 | `https://cloud.tencent.com/document/product/269/75674` |
+| 文本消息（createTextMessage → sendMessage） | `https://cloud.tencent.com/document/product/269/75317` |
+| 群 @ 消息（createTextAtMessage → sendMessage） | `https://cloud.tencent.com/document/product/269/75350` |
+| 图片消息（createImageMessage → sendMessage） | `https://cloud.tencent.com/document/product/269/75317` |
+| 语音消息（createSoundMessage → sendMessage） | `https://cloud.tencent.com/document/product/269/75317` |
+| 视频消息（createVideoMessage → sendMessage） | `https://cloud.tencent.com/document/product/269/75317` |
+| 文件消息（createFileMessage → sendMessage） | `https://cloud.tencent.com/document/product/269/75317` |
+| 自定义消息（createCustomMessage → sendMessage） | `https://cloud.tencent.com/document/product/269/75317` |
+| 表情消息（createFaceMessage → sendMessage） | `https://cloud.tencent.com/document/product/269/75315` |
+| 地理位置消息（createLocationMessage → sendMessage） | `https://cloud.tencent.com/document/product/269/75315` |
+| 合并消息（createMergerMessage → sendMessage） | `https://cloud.tencent.com/document/product/269/75326` |
+| 逐条转发消息（createForwardMessage → sendMessage） | `https://cloud.tencent.com/document/product/269/75326` |
+| 发送消息参数配置（sendMessage 参数） | `https://cloud.tencent.com/document/product/269/75317` |
+| 接收消息（addAdvancedMsgListener） | `https://cloud.tencent.com/document/product/269/75320` |
+| 获取历史消息（getC2CHistoryMessageList/getGroupHistoryMessageList/getHistoryMessageList） | `https://cloud.tencent.com/document/product/269/75323` |
+| 修改消息（modifyMessage） | `https://cloud.tencent.com/document/product/269/75329` |
+| 插入消息（insertC2CMessageToLocalStorage/insertGroupMessageToLocalStorage） | `https://cloud.tencent.com/document/product/269/75331` |
+| 删除消息（deleteMessageFromLocalStorage/deleteMessages） | `https://cloud.tencent.com/document/product/269/75334` |
+| 清空消息（clearC2CHistoryMessage/clearGroupHistoryMessage） | `https://cloud.tencent.com/document/product/269/75336` |
+| 撤回消息（revokeMessage） | `https://cloud.tencent.com/document/product/269/75339` |
+| 在线消息 | `https://cloud.tencent.com/document/product/269/75342` |
+| 已读回执（单聊/群聊） | `https://cloud.tencent.com/document/product/269/75345` |
+| 查询消息（findMessages） | `https://cloud.tencent.com/document/product/269/75347` |
+| 群定向消息(createXXXMessage -> createTargetedGroupMessage -> sendMessage) | `https://cloud.tencent.com/document/product/269/75352` |
+| 消息免打扰（setC2CReceiveMessageOpt/setGroupReceiveMessageOpt） | `https://cloud.tencent.com/document/product/269/75355` |
+| 消息扩展（投票/接龙场景） | `https://cloud.tencent.com/document/product/269/83722` |
+| 会话存储限制 | `https://cloud.tencent.com/document/product/269/75365` |
+| 会话列表（getConversationList） | `https://cloud.tencent.com/document/product/269/75368` |
+| 会话资料（getConversation） | `https://cloud.tencent.com/document/product/269/75371` |
+| 会话未读数（getTotalUnreadMessageCount） | `https://cloud.tencent.com/document/product/269/75374` |
+| 置顶会话（pinConversation） | `https://cloud.tencent.com/document/product/269/75377` |
+| 删除会话（deleteConversation） | `https://cloud.tencent.com/document/product/269/75380` |
+| 会话草稿（setConversationDraft） | `https://cloud.tencent.com/document/product/269/75382` |
+| 会话标记（markConversation） | `https://cloud.tencent.com/document/product/269/79694` |
+| 会话分组 | `https://cloud.tencent.com/document/product/269/79695` |
+| 群组类型和不同群类型能力介绍 | `https://cloud.tencent.com/document/product/269/75697` |
+| 普通群管理 | `https://cloud.tencent.com/document/product/269/75396` |
+| 群资料（getGroupsInfo / setGroupInfo） | `https://cloud.tencent.com/document/product/269/75399` |
+| 群成员管理 | `https://cloud.tencent.com/document/product/269/75402` |
+| 群成员资料 | `https://cloud.tencent.com/document/product/269/75405` |
+| 群自定义属性 | `https://cloud.tencent.com/document/product/269/75408` |
+| 社群（Community / 话题） | `https://cloud.tencent.com/document/product/269/75411` |
+| 社群（权限组） | `https://cloud.tencent.com/document/product/269/127846` |
+| 用户资料（getUsersInfo / setSelfInfo） | `https://cloud.tencent.com/document/product/269/75418` |
+| 用户状态（getUserStatus / subscribeUserStatus） | `https://cloud.tencent.com/document/product/269/105469` |
+| 好友管理 | `https://cloud.tencent.com/document/product/269/75421` |
+| 好友分组 | `https://cloud.tencent.com/document/product/269/75424` |
+| 用户黑名单 | `https://cloud.tencent.com/document/product/269/75427` |
+| 关注和粉丝 | `https://cloud.tencent.com/document/product/269/110774` |
+| 本地搜索消息（searchLocalMessages） | `https://cloud.tencent.com/document/product/269/75438` |
+| 本地搜索好友（searchFriends） | `https://cloud.tencent.com/document/product/269/75440` |
+| 本地搜索群组（searchGroups） | `https://cloud.tencent.com/document/product/269/75442` |
+| 本地搜索群成员（searchGroupMembers） | `https://cloud.tencent.com/document/product/269/75444` |
+## D — 错误码（SDK 错误码）
+> 错误码查询策略见 `references/14-official-docs.md §14.4`
+| 子问题 | 目标文档 |
+|--------|---------|
+| Flutter SDK 错误码表 | `https://cloud.tencent.com/document/product/269/1671` |

package/knowledge-base/docs/chat/sdk/ios/faq.md ADDED Viewed

@@ -0,0 +1,7 @@
+# Web — 高频问题预检清单
+> dispatcher 检索前先判断是否属于已知高频问题，可节省一次 ios 请求。
+| 高频问题 | 快速答案（预埋） |
+|---------|----------------|

package/knowledge-base/docs/chat/sdk/ios/index.md ADDED Viewed

@@ -0,0 +1,94 @@
+# Web — SDK 官方文档 URL 映射
+> 知识咨询时 `read_file` 本文件，按问题匹配领域和子问题，获取目标 URL。检索方式和兜底策略见 `references/14-official-docs.md`。
+## A — SDK 集成和初始化（iOS）
+| 子问题 | 目标文档 |
+|--------|---------|
+| iOS SDK 集成 | `https://cloud.tencent.com/document/product/269/75284` |
+| iOS SDK 初始化 | `https://cloud.tencent.com/document/product/269/75291` |
+## B — 登录
+| 子问题 | 目标文档 |
+|--------|---------|
+| 登录（`login` API） | `https://cloud.tencent.com/document/product/269/75294` |
+| 登出（`logout` API） | `https://cloud.tencent.com/document/product/269/75294` |
+## C — SDK API 使用
+| 子问题 | 目标文档 |
+|--------|---------|
+| SDK 消息类型介绍 | `https://cloud.tencent.com/document/product/269/75313` |
+| 文本消息（sendC2CMessage/sendGroupTextMessage） | `https://cloud.tencent.com/document/product/269/75315` |
+| 群 @ 消息（createAtSignedGroupMessage → sendMessage） | `https://cloud.tencent.com/document/product/269/75349` |
+| 图片消息（createImageMessage → sendMessage） | `https://cloud.tencent.com/document/product/269/75315` |
+| 语音消息（createSoundMessage → sendMessage） | `https://cloud.tencent.com/document/product/269/75315` |
+| 视频消息（createVideoMessage → sendMessage） | `https://cloud.tencent.com/document/product/269/75315` |
+| 文件消息（createFileMessage → sendMessage） | `https://cloud.tencent.com/document/product/269/75315` |
+| 自定义消息（sendC2CCustomMessage/sendGroupCustomMessage） | `https://cloud.tencent.com/document/product/269/75315` |
+| 表情消息（createFaceMessage → sendMessage） | `https://cloud.tencent.com/document/product/269/75315` |
+| 地理位置消息（createLocationMessage → sendMessage） | `https://cloud.tencent.com/document/product/269/75315` |
+| 合并消息（createMergerMessage → sendMessage） | `https://cloud.tencent.com/document/product/269/75324` |
+| 逐条转发消息（createForwardMessage → sendMessage） | `https://cloud.tencent.com/document/product/269/75324` |
+| 发送消息参数配置（sendMessage 参数） | `https://cloud.tencent.com/document/product/269/75315` |
+| 接收消息（addSimpleMsgListener/addAdvancedMsgListener） | `https://cloud.tencent.com/document/product/269/75318` |
+| 获取历史消息（getC2CHistoryMessageList/getGroupHistoryMessageList/getHistoryMessageList） | `https://cloud.tencent.com/document/product/269/75321` |
+| 修改消息（modifyMessage） | `https://cloud.tencent.com/document/product/269/75327` |
+| 插入消息（insertC2CMessageToLocalStorage/insertGroupMessageToLocalStorage） | `https://cloud.tencent.com/document/product/269/75330` |
+| 删除消息（deleteMessageFromLocalStorage/deleteMessages） | `https://cloud.tencent.com/document/product/269/75332` |
+| 清空消息（clearC2CHistoryMessage/clearGroupHistoryMessage） | `https://cloud.tencent.com/document/product/269/75335` |
+| 撤回消息（revokeMessage） | `https://cloud.tencent.com/document/product/269/75337` |
+| 在线消息 | `https://cloud.tencent.com/document/product/269/75340` |
+| 已读回执（单聊/群聊） | `https://cloud.tencent.com/document/product/269/75343` |
+| 查询消息（findMessages） | `https://cloud.tencent.com/document/product/269/75346` |
+| 群定向消息 | `https://cloud.tencent.com/document/product/269/75351` |
+| 消息免打扰（setC2CReceiveMessageOpt/setGroupReceiveMessageOpt/setAllReceiveMessageOpt） | `https://cloud.tencent.com/document/product/269/75353` |
+| 消息扩展（投票/接龙场景） | `https://cloud.tencent.com/document/product/269/81038` |
+| 消息回应（表情回应） | `https://cloud.tencent.com/document/product/269/96241` |
+| 消息翻译（translateText） | `https://cloud.tencent.com/document/product/269/85380` |
+| 语音转文字（convertVoiceToText） | `https://cloud.tencent.com/document/product/269/96280` |
+| 消息置顶（pinGroupMessage） | `https://cloud.tencent.com/document/product/269/106050` |
+| 流式消息（V2TIM_ELEM_TYPE_STREAM） | `https://cloud.tencent.com/document/product/269/129557` |
+| 文字转语音 | `https://cloud.tencent.com/document/product/269/131939` |
+| 会话存储限制 | `https://cloud.tencent.com/document/product/269/75363` |
+| 会话列表（getConversationList） | `https://cloud.tencent.com/document/product/269/75366` |
+| 会话资料（getConversation） | `https://cloud.tencent.com/document/product/269/75369` |
+| 会话未读数（getTotalUnreadMessageCount） | `https://cloud.tencent.com/document/product/269/75372` |
+| 置顶会话（pinConversation） | `https://cloud.tencent.com/document/product/269/75375` |
+| 删除会话（deleteConversation） | `https://cloud.tencent.com/document/product/269/75378` |
+| 会话草稿（setConversationDraft） | `https://cloud.tencent.com/document/product/269/75381` |
+| 会话标记（markConversation） | `https://cloud.tencent.com/document/product/269/77389` |
+| 会话分组 | `https://cloud.tencent.com/document/product/269/77392` |
+| 群组类型和不同群类型能力介绍 | `https://cloud.tencent.com/document/product/269/75697` |
+| 普通群管理 | `https://cloud.tencent.com/document/product/269/75395` |
+| 群资料（getGroupsInfo / setGroupInfo） | `https://cloud.tencent.com/document/product/269/75397` |
+| 群成员管理 | `https://cloud.tencent.com/document/product/269/75400` |
+| 群成员资料 | `https://cloud.tencent.com/document/product/269/75403` |
+| 群自定义属性 | `https://cloud.tencent.com/document/product/269/75406` |
+| 群计数器（groupCounter） | `https://cloud.tencent.com/document/product/269/85676` |
+| 社群（Community / 话题） | `https://cloud.tencent.com/document/product/269/75409` |
+| 社群（权限组） | `https://cloud.tencent.com/document/product/269/104417` |
+| 用户资料（getUsersInfo / setSelfInfo） | `https://cloud.tencent.com/document/product/269/75416` |
+| 用户状态（getUserStatus / subscribeUserStatus） | `https://cloud.tencent.com/document/product/269/75511` |
+| 好友管理 | `https://cloud.tencent.com/document/product/269/75419` |
+| 好友分组 | `https://cloud.tencent.com/document/product/269/75422` |
+| 用户黑名单 | `https://cloud.tencent.com/document/product/269/75425` |
+| 关注和粉丝 | `https://cloud.tencent.com/document/product/269/105494` |
+| 云端搜索消息（searchCloudMessages） | `https://cloud.tencent.com/document/product/269/115824` |
+| 云端搜索用户（searchUsers） | `https://cloud.tencent.com/document/product/269/115825` |
+| 云端搜索群组（searchGroups） | `https://cloud.tencent.com/document/product/269/115826` |
+| 云端搜索群成员（searchGroupMembers） | `https://cloud.tencent.com/document/product/269/115827` |
+| 本地搜索消息（searchLocalMessages） | `https://cloud.tencent.com/document/product/269/75436` |
+| 本地搜索好友（searchFriends） | `https://cloud.tencent.com/document/product/269/75439` |
+| 本地搜索群组（searchGroups） | `https://cloud.tencent.com/document/product/269/75441` |
+| 本地搜索群成员（searchGroupMembers） | `https://cloud.tencent.com/document/product/269/75443` |
+## D — 错误码（SDK 错误码）
+> 错误码查询策略见 `references/14-official-docs.md §14.4`
+| 子问题 | 目标文档 |
+|--------|---------|
+| iOS SDK 错误码表 | `https://cloud.tencent.com/document/product/269/1671` |

package/knowledge-base/docs/chat/sdk/web/faq.md ADDED Viewed

@@ -0,0 +1,8 @@
+# Web — 高频问题预检清单
+> dispatcher 检索前先判断是否属于已知高频问题，可节省一次 web 请求。
+| 高频问题 | 快速答案（预埋） |
+|---------|----------------|
+| UserSig 是什么 | 用于验证用户身份的签名，由 SDKAppID + SecretKey + UserID 生成，有效期可配 |