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

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 (432) hide show
  1. package/.cursor/rules/main.mdc +12 -0
  2. package/AGENTS.md +14 -104
  3. package/CLAUDE.md +15 -127
  4. package/CODEBUDDY.md +15 -125
  5. package/README.md +7 -5
  6. package/README.zh.md +7 -5
  7. package/bin/cli.js +151 -46
  8. package/hooks/__pycache__/cursor-adapter.cpython-313.pyc +0 -0
  9. package/hooks/cursor-adapter.py +45 -18
  10. package/hooks/hooks-cursor.json +5 -18
  11. package/hooks/hooks.json +6 -31
  12. package/knowledge-base/chat/web/index.yaml +168 -0
  13. package/knowledge-base/chat/web/path-d-signals.yaml +4 -0
  14. package/knowledge-base/conference/web/index.yaml +143 -0
  15. package/knowledge-base/docs/chat/debug/GenerateTestUserSig.js +23 -0
  16. package/knowledge-base/docs/chat/debug/lib-generate-test-usersig.min.js +1 -0
  17. package/knowledge-base/docs/chat/gen-usersig.md +129 -0
  18. package/knowledge-base/docs/chat/product.md +61 -0
  19. package/knowledge-base/docs/chat/restapi.md +227 -0
  20. package/knowledge-base/docs/chat/sdk/android/faq.md +7 -0
  21. package/knowledge-base/docs/chat/sdk/android/index.md +94 -0
  22. package/knowledge-base/docs/chat/sdk/flutter/faq.md +7 -0
  23. package/knowledge-base/docs/chat/sdk/flutter/index.md +83 -0
  24. package/knowledge-base/docs/chat/sdk/ios/faq.md +7 -0
  25. package/knowledge-base/docs/chat/sdk/ios/index.md +94 -0
  26. package/knowledge-base/docs/chat/sdk/web/faq.md +8 -0
  27. package/knowledge-base/docs/chat/sdk/web/index.md +97 -0
  28. package/knowledge-base/docs/chat/uikit/android/index.md +28 -0
  29. package/knowledge-base/docs/chat/uikit/flutter/index.md +17 -0
  30. package/knowledge-base/docs/chat/uikit/ios/index.md +28 -0
  31. package/knowledge-base/docs/chat/uikit/react/index.md +6 -0
  32. package/knowledge-base/docs/chat/uikit/uniapp/index.md +6 -0
  33. package/knowledge-base/docs/chat/uikit/vue3/index.md +6 -0
  34. package/knowledge-base/docs/chat/webhook.md +73 -0
  35. package/knowledge-base/platform-slice-template.md +1041 -133
  36. package/knowledge-base/products.yaml +76 -0
  37. package/knowledge-base/scenario-spec.md +1316 -115
  38. package/knowledge-base/scenarios/conference/base/general-conference.md +22 -2
  39. package/knowledge-base/scenarios/conference/base/webinar-conference.md +14 -0
  40. package/knowledge-base/scenarios/conference/medical/1v1-video-consultation.md +19 -0
  41. package/knowledge-base/scenarios/conference/medical/medical-multidoctor-consultation.md +13 -0
  42. package/knowledge-base/scenarios/live/entertainment-live-room.md +12 -0
  43. package/knowledge-base/slice-spec.md +2377 -299
  44. package/knowledge-base/slices/chat/web/at-mention.md +417 -0
  45. package/knowledge-base/slices/chat/web/conversation-actions.md +178 -0
  46. package/knowledge-base/slices/chat/web/conversation-list.md +368 -0
  47. package/knowledge-base/slices/chat/web/detect-integration.md +36 -0
  48. package/knowledge-base/slices/chat/web/detect-style.md +88 -0
  49. package/knowledge-base/slices/chat/web/direct-chat-entry.md +210 -0
  50. package/knowledge-base/slices/chat/web/login-auth.md +244 -0
  51. package/knowledge-base/slices/chat/web/message-base-actions.md +273 -0
  52. package/knowledge-base/slices/chat/web/message-input.md +209 -0
  53. package/knowledge-base/slices/chat/web/message-list.md +532 -0
  54. package/knowledge-base/slices/chat/web/send-custom-message.md +189 -0
  55. package/knowledge-base/slices/chat/web/send-media.md +214 -0
  56. package/knowledge-base/slices/chat/web/state-api-skeleton.md +60 -0
  57. package/knowledge-base/slices/chat/web/style-guide.md +210 -0
  58. package/knowledge-base/slices/conference/web/integration-audit.md +1 -1
  59. package/knowledge-base/slices/conference/web/login-auth.md +14 -1
  60. package/knowledge-base/tooling/aliases.yaml +92 -0
  61. package/knowledge-base/tooling/intent-signals.yaml +181 -0
  62. package/knowledge-base/tooling/symptom-keywords.yaml +21 -0
  63. package/package.json +4 -1
  64. package/skills/trtc/SKILL.md +249 -258
  65. package/skills/trtc/hooks/__pycache__/report_prompt.cpython-313.pyc +0 -0
  66. package/skills/{trtc-topic/guardrails → trtc/hooks}/gate_slice_read.py +12 -8
  67. package/skills/{trtc-topic/guardrails → trtc/hooks}/gate_slice_write.py +16 -12
  68. package/skills/{trtc-topic/guardrails → trtc/hooks}/stop_require_apply_evidence.py +22 -14
  69. package/skills/trtc/hooks/topic_phase_gate.py +166 -0
  70. package/skills/{trtc-topic → trtc}/runtime/README.md +2 -2
  71. package/skills/{trtc-onboarding/reference/reporting-protocol.md → trtc/runtime/REPORTING.md} +5 -5
  72. package/skills/{trtc-topic → trtc}/runtime/RUNTIME.md +5 -5
  73. package/skills/trtc/runtime/lib/__init__.py +0 -0
  74. package/skills/{trtc-topic → trtc}/runtime/package-lock.json +2 -2
  75. package/skills/{trtc-topic → trtc}/runtime/package.json +2 -2
  76. package/skills/{trtc-topic → trtc}/runtime/telemetry-bridge.mjs +1 -1
  77. package/skills/{trtc-topic/scripts → trtc/tools}/STATE-MACHINE-GUIDE.md +23 -23
  78. package/skills/trtc/tools/__init__.py +2 -0
  79. package/skills/trtc/tools/__pycache__/__init__.cpython-313.pyc +0 -0
  80. package/skills/trtc/tools/__pycache__/query_classifier.cpython-313.pyc +0 -0
  81. package/skills/trtc/tools/__pycache__/reporting.cpython-313.pyc +0 -0
  82. package/skills/trtc/tools/__pycache__/search.cpython-313.pyc +0 -0
  83. package/skills/trtc/tools/__pycache__/session.cpython-313.pyc +0 -0
  84. package/skills/trtc/tools/apply.py +540 -0
  85. package/skills/trtc/tools/docs.py +712 -0
  86. package/skills/trtc/tools/docsbot.py +182 -0
  87. package/skills/trtc/tools/entry/render_ai_instructions.py +92 -0
  88. package/skills/trtc/tools/flow.py +1089 -0
  89. package/skills/{trtc-topic/scripts → trtc/tools}/init_slice_queue.py +5 -4
  90. package/skills/trtc/tools/kb.py +130 -0
  91. package/skills/{trtc-topic/scripts → trtc/tools}/next_slice.py +5 -4
  92. package/skills/trtc/tools/query_classifier.py +301 -0
  93. package/skills/trtc/tools/reporting.py +468 -0
  94. package/skills/trtc/tools/reporting_v2.py +263 -0
  95. package/skills/trtc/tools/search.py +817 -0
  96. package/skills/trtc/tools/session.py +1261 -0
  97. package/skills/trtc/tools/state_machine.py +690 -0
  98. package/skills/trtc-ai-service/README.ja.md +199 -0
  99. package/skills/trtc-ai-service/README.md +199 -0
  100. package/skills/trtc-ai-service/README.zh-CN.md +197 -0
  101. package/skills/trtc-ai-service/SKILL.md +945 -0
  102. package/skills/trtc-ai-service/auto_adapters/README.md +40 -0
  103. package/skills/trtc-ai-service/auto_adapters/frontend-spa/README.md +27 -0
  104. package/skills/trtc-ai-service/auto_adapters/frontend-spa/angular/voice-agent.component.ts.tpl +131 -0
  105. package/skills/trtc-ai-service/auto_adapters/frontend-spa/manifest.yaml +57 -0
  106. package/skills/trtc-ai-service/auto_adapters/frontend-spa/react/VoiceAgent.tsx.tpl +142 -0
  107. package/skills/trtc-ai-service/auto_adapters/frontend-spa/vue/VoiceAgent.vue.tpl +121 -0
  108. package/skills/trtc-ai-service/auto_adapters/integration_templates/generic-backend.md +45 -0
  109. package/skills/trtc-ai-service/auto_adapters/integration_templates/generic-frontend.md +51 -0
  110. package/skills/trtc-ai-service/auto_adapters/integration_templates/generic-rest-api.md +93 -0
  111. package/skills/trtc-ai-service/auto_adapters/java-backend/README.md +25 -0
  112. package/skills/trtc-ai-service/auto_adapters/java-backend/manifest.yaml +30 -0
  113. package/skills/trtc-ai-service/auto_adapters/java-backend/quarkus/VoiceAgentFilter.java.tpl +64 -0
  114. package/skills/trtc-ai-service/auto_adapters/java-backend/springboot/VoiceAgentFilter.java.tpl +91 -0
  115. package/skills/trtc-ai-service/auto_adapters/manifest.yaml +43 -0
  116. package/skills/trtc-ai-service/auto_adapters/node-backend/README.md +25 -0
  117. package/skills/trtc-ai-service/auto_adapters/node-backend/express.js.tpl +40 -0
  118. package/skills/trtc-ai-service/auto_adapters/node-backend/fastify.js.tpl +27 -0
  119. package/skills/trtc-ai-service/auto_adapters/node-backend/koa.js.tpl +31 -0
  120. package/skills/trtc-ai-service/auto_adapters/node-backend/manifest.yaml +47 -0
  121. package/skills/trtc-ai-service/auto_adapters/python-backend/README.md +22 -0
  122. package/skills/trtc-ai-service/auto_adapters/python-backend/django.py.tpl +32 -0
  123. package/skills/trtc-ai-service/auto_adapters/python-backend/fastapi.py.tpl +35 -0
  124. package/skills/trtc-ai-service/auto_adapters/python-backend/flask.py.tpl +31 -0
  125. package/skills/trtc-ai-service/auto_adapters/python-backend/manifest.yaml +45 -0
  126. package/skills/trtc-ai-service/capabilities/__init__.py +43 -0
  127. package/skills/trtc-ai-service/capabilities/conversation-core/.env.example +29 -0
  128. package/skills/trtc-ai-service/capabilities/conversation-core/INTEGRATION.md +134 -0
  129. package/skills/trtc-ai-service/capabilities/conversation-core/INTERFACE_ADAPT.md +111 -0
  130. package/skills/trtc-ai-service/capabilities/conversation-core/QUICK_START.md +62 -0
  131. package/skills/trtc-ai-service/capabilities/conversation-core/manifest.yaml +250 -0
  132. package/skills/trtc-ai-service/capabilities/conversation-core/requirements.txt +6 -0
  133. package/skills/trtc-ai-service/capabilities/conversation-core/src/__init__.py +10 -0
  134. package/skills/trtc-ai-service/capabilities/conversation-core/src/_capability_loader.py +218 -0
  135. package/skills/trtc-ai-service/capabilities/conversation-core/src/agent.py +231 -0
  136. package/skills/trtc-ai-service/capabilities/conversation-core/src/credentials.py +132 -0
  137. package/skills/trtc-ai-service/capabilities/conversation-core/src/health.py +355 -0
  138. package/skills/trtc-ai-service/capabilities/conversation-core/src/log_filter.py +76 -0
  139. package/skills/trtc-ai-service/capabilities/conversation-core/src/modality.py +109 -0
  140. package/skills/trtc-ai-service/capabilities/conversation-core/src/server.py +312 -0
  141. package/skills/trtc-ai-service/capabilities/conversation-core/src/trtc_client.py +315 -0
  142. package/skills/trtc-ai-service/capabilities/conversation-core/src/usersig.py +90 -0
  143. package/skills/trtc-ai-service/capabilities/conversation-core/tests/test_skeleton.py +216 -0
  144. package/skills/trtc-ai-service/capabilities/conversation-core/web-demo/README.md +48 -0
  145. package/skills/trtc-ai-service/capabilities/conversation-core/web-demo/app.js +415 -0
  146. package/skills/trtc-ai-service/capabilities/conversation-core/web-demo/index.html +68 -0
  147. package/skills/trtc-ai-service/capabilities/conversation-core/web-demo/styles.css +136 -0
  148. package/skills/trtc-ai-service/capabilities/digital-human/README.md +31 -0
  149. package/skills/trtc-ai-service/capabilities/digital-human/manifest.yaml +64 -0
  150. package/skills/trtc-ai-service/capabilities/digital-human/src/__init__.py +2 -0
  151. package/skills/trtc-ai-service/capabilities/digital-human/src/router.py +43 -0
  152. package/skills/trtc-ai-service/capabilities/human-handoff/INTERFACE_ADAPT.md +353 -0
  153. package/skills/trtc-ai-service/capabilities/human-handoff/README.md +44 -0
  154. package/skills/trtc-ai-service/capabilities/human-handoff/manifest.yaml +227 -0
  155. package/skills/trtc-ai-service/capabilities/human-handoff/src/__init__.py +2 -0
  156. package/skills/trtc-ai-service/capabilities/human-handoff/src/adapters/__init__.py +9 -0
  157. package/skills/trtc-ai-service/capabilities/human-handoff/src/adapters/default_rest.py +242 -0
  158. package/skills/trtc-ai-service/capabilities/human-handoff/src/adapters/factory.py +89 -0
  159. package/skills/trtc-ai-service/capabilities/human-handoff/src/adapters/local_queue.py +258 -0
  160. package/skills/trtc-ai-service/capabilities/human-handoff/src/adapters/mock.py +132 -0
  161. package/skills/trtc-ai-service/capabilities/human-handoff/src/core/__init__.py +25 -0
  162. package/skills/trtc-ai-service/capabilities/human-handoff/src/core/intent_detector.py +75 -0
  163. package/skills/trtc-ai-service/capabilities/human-handoff/src/core/models.py +163 -0
  164. package/skills/trtc-ai-service/capabilities/human-handoff/src/core/service.py +192 -0
  165. package/skills/trtc-ai-service/capabilities/human-handoff/src/feedback_store.py +54 -0
  166. package/skills/trtc-ai-service/capabilities/human-handoff/src/ports/__init__.py +4 -0
  167. package/skills/trtc-ai-service/capabilities/human-handoff/src/ports/handoff_client.py +86 -0
  168. package/skills/trtc-ai-service/capabilities/human-handoff/src/queue.py +62 -0
  169. package/skills/trtc-ai-service/capabilities/human-handoff/src/router.py +201 -0
  170. package/skills/trtc-ai-service/capabilities/human-handoff/src/summary_link.py +77 -0
  171. package/skills/trtc-ai-service/capabilities/human-handoff/src/trigger.py +25 -0
  172. package/skills/trtc-ai-service/capabilities/knowledge-base/INTERFACE_ADAPT.md +297 -0
  173. package/skills/trtc-ai-service/capabilities/knowledge-base/README.md +51 -0
  174. package/skills/trtc-ai-service/capabilities/knowledge-base/data/faq.json +20 -0
  175. package/skills/trtc-ai-service/capabilities/knowledge-base/manifest.yaml +211 -0
  176. package/skills/trtc-ai-service/capabilities/knowledge-base/src/__init__.py +8 -0
  177. package/skills/trtc-ai-service/capabilities/knowledge-base/src/adapters/__init__.py +9 -0
  178. package/skills/trtc-ai-service/capabilities/knowledge-base/src/adapters/default_rest.py +209 -0
  179. package/skills/trtc-ai-service/capabilities/knowledge-base/src/adapters/factory.py +86 -0
  180. package/skills/trtc-ai-service/capabilities/knowledge-base/src/adapters/local_json.py +172 -0
  181. package/skills/trtc-ai-service/capabilities/knowledge-base/src/adapters/mock.py +91 -0
  182. package/skills/trtc-ai-service/capabilities/knowledge-base/src/core/__init__.py +12 -0
  183. package/skills/trtc-ai-service/capabilities/knowledge-base/src/core/models.py +77 -0
  184. package/skills/trtc-ai-service/capabilities/knowledge-base/src/core/scoring.py +73 -0
  185. package/skills/trtc-ai-service/capabilities/knowledge-base/src/core/service.py +78 -0
  186. package/skills/trtc-ai-service/capabilities/knowledge-base/src/ports/__init__.py +4 -0
  187. package/skills/trtc-ai-service/capabilities/knowledge-base/src/ports/kb_client.py +61 -0
  188. package/skills/trtc-ai-service/capabilities/knowledge-base/src/retriever.py +56 -0
  189. package/skills/trtc-ai-service/capabilities/knowledge-base/src/router.py +85 -0
  190. package/skills/trtc-ai-service/capabilities/session-summary/INTERFACE_ADAPT.md +99 -0
  191. package/skills/trtc-ai-service/capabilities/session-summary/README.md +47 -0
  192. package/skills/trtc-ai-service/capabilities/session-summary/data/test_session.json +18 -0
  193. package/skills/trtc-ai-service/capabilities/session-summary/manifest.yaml +165 -0
  194. package/skills/trtc-ai-service/capabilities/session-summary/src/__init__.py +2 -0
  195. package/skills/trtc-ai-service/capabilities/session-summary/src/adapters/__init__.py +5 -0
  196. package/skills/trtc-ai-service/capabilities/session-summary/src/adapters/base.py +31 -0
  197. package/skills/trtc-ai-service/capabilities/session-summary/src/adapters/default_rest.py +67 -0
  198. package/skills/trtc-ai-service/capabilities/session-summary/src/adapters/factory.py +51 -0
  199. package/skills/trtc-ai-service/capabilities/session-summary/src/adapters/local_json.py +42 -0
  200. package/skills/trtc-ai-service/capabilities/session-summary/src/adapters/mock.py +22 -0
  201. package/skills/trtc-ai-service/capabilities/session-summary/src/recorder.py +210 -0
  202. package/skills/trtc-ai-service/capabilities/session-summary/src/router.py +93 -0
  203. package/skills/trtc-ai-service/capabilities/session-summary/src/summarizer.py +163 -0
  204. package/skills/trtc-ai-service/capabilities/tool-calling/INTERFACE_ADAPT.md +158 -0
  205. package/skills/trtc-ai-service/capabilities/tool-calling/README.md +50 -0
  206. package/skills/trtc-ai-service/capabilities/tool-calling/data/tools.yaml +58 -0
  207. package/skills/trtc-ai-service/capabilities/tool-calling/examples/__init__.py +1 -0
  208. package/skills/trtc-ai-service/capabilities/tool-calling/examples/local_tools.py +101 -0
  209. package/skills/trtc-ai-service/capabilities/tool-calling/manifest.yaml +146 -0
  210. package/skills/trtc-ai-service/capabilities/tool-calling/src/__init__.py +8 -0
  211. package/skills/trtc-ai-service/capabilities/tool-calling/src/dispatcher.py +54 -0
  212. package/skills/trtc-ai-service/capabilities/tool-calling/src/registry.py +219 -0
  213. package/skills/trtc-ai-service/capabilities/tool-calling/src/router.py +50 -0
  214. package/skills/trtc-ai-service/references/business-contract-spec.md +263 -0
  215. package/skills/trtc-ai-service/scenarios/custom-builder/README.md +86 -0
  216. package/skills/trtc-ai-service/scenarios/custom-builder/output-templates/recipe.yaml.j2 +194 -0
  217. package/skills/trtc-ai-service/scenarios/custom-builder/prompts/q1-business-scenario.md +43 -0
  218. package/skills/trtc-ai-service/scenarios/custom-builder/prompts/q2-io-modality.md +57 -0
  219. package/skills/trtc-ai-service/scenarios/custom-builder/prompts/q3-ui-form.md +55 -0
  220. package/skills/trtc-ai-service/scenarios/custom-builder/prompts/q4-capabilities.md +78 -0
  221. package/skills/trtc-ai-service/scenarios/customer-service/README.md +114 -0
  222. package/skills/trtc-ai-service/scenarios/customer-service/recipe.yaml +154 -0
  223. package/skills/trtc-ai-service/scenarios/customer-service/sample-data/README.md +32 -0
  224. package/skills/trtc-ai-service/scenarios/customer-service/sample-data/faq-sample.json +37 -0
  225. package/skills/trtc-ai-service/scenarios/customer-service/system-prompt.template.md +94 -0
  226. package/skills/trtc-ai-service/scenarios/customer-service/ui/admin-board/app.js +347 -0
  227. package/skills/trtc-ai-service/scenarios/customer-service/ui/admin-board/index.html +125 -0
  228. package/skills/trtc-ai-service/scenarios/customer-service/ui/admin-board/styles.css +487 -0
  229. package/skills/trtc-ai-service/scenarios/customer-service/ui/admin-board/tokens.css +71 -0
  230. package/skills/trtc-ai-service/scenarios/customer-service/ui/design-system/DESIGN_GUIDELINES.md +370 -0
  231. package/skills/trtc-ai-service/scenarios/customer-service/ui/voice-customer-service/README.md +68 -0
  232. package/skills/trtc-ai-service/scenarios/customer-service/ui/voice-customer-service/app.js +1307 -0
  233. package/skills/trtc-ai-service/scenarios/customer-service/ui/voice-customer-service/data.js +40 -0
  234. package/skills/trtc-ai-service/scenarios/customer-service/ui/voice-customer-service/index.html +233 -0
  235. package/skills/trtc-ai-service/scenarios/customer-service/ui/voice-customer-service/mock-shop.json +21 -0
  236. package/skills/trtc-ai-service/scenarios/customer-service/ui/voice-customer-service/styles.css +603 -0
  237. package/skills/trtc-ai-service/scenarios/customer-service/ui/voice-customer-service/tokens.css +71 -0
  238. package/skills/trtc-ai-service/scenarios/customer-service/ui/widget-floating/agent-link.js +323 -0
  239. package/skills/trtc-ai-service/scenarios/customer-service/ui/widget-floating/app.js +458 -0
  240. package/skills/trtc-ai-service/scenarios/customer-service/ui/widget-floating/index.html +109 -0
  241. package/skills/trtc-ai-service/scenarios/customer-service/ui/widget-floating/styles.css +489 -0
  242. package/skills/trtc-ai-service/scenarios/customer-service/ui/widget-floating/tokens.css +59 -0
  243. package/skills/trtc-ai-service/scripts/add-capability.py +364 -0
  244. package/skills/trtc-ai-service/scripts/contract-adapt.py +334 -0
  245. package/skills/trtc-ai-service/scripts/detect-stack.py +40 -0
  246. package/skills/trtc-ai-service/scripts/lib/__init__.py +20 -0
  247. package/skills/trtc-ai-service/scripts/lib/adapter_codegen.py +509 -0
  248. package/skills/trtc-ai-service/scripts/lib/arbitrator.py +152 -0
  249. package/skills/trtc-ai-service/scripts/lib/contract_resolver.py +519 -0
  250. package/skills/trtc-ai-service/scripts/lib/credential_validators.py +253 -0
  251. package/skills/trtc-ai-service/scripts/lib/curl_parser.py +303 -0
  252. package/skills/trtc-ai-service/scripts/lib/degrader.py +140 -0
  253. package/skills/trtc-ai-service/scripts/lib/injector.py +347 -0
  254. package/skills/trtc-ai-service/scripts/lib/manifest_resolver.py +288 -0
  255. package/skills/trtc-ai-service/scripts/lib/openapi_parser.py +289 -0
  256. package/skills/trtc-ai-service/scripts/lib/stack_detector.py +159 -0
  257. package/skills/trtc-ai-service/scripts/lib/tokens_compile.py +204 -0
  258. package/skills/trtc-ai-service/scripts/post-install-patch.py +225 -0
  259. package/skills/trtc-ai-service/scripts/setup-credentials.py +393 -0
  260. package/skills/trtc-ai-service/scripts/verify-credentials.py +108 -0
  261. package/skills/trtc-ai-service/start.sh +111 -0
  262. package/skills/trtc-ai-service/tests/__init__.py +1 -0
  263. package/skills/trtc-ai-service/tests/test_arbitrator.py +64 -0
  264. package/skills/trtc-ai-service/tests/test_capability_overlay.py +85 -0
  265. package/skills/trtc-ai-service/tests/test_contract_resolver.py +190 -0
  266. package/skills/trtc-ai-service/tests/test_handoff_ports.py +195 -0
  267. package/skills/trtc-ai-service/tests/test_kb_ports.py +195 -0
  268. package/skills/trtc-ai-service/tests/test_manifest_resolver.py +95 -0
  269. package/skills/trtc-ai-service/tests/test_recipe_assembly.py +175 -0
  270. package/skills/trtc-ai-service/tests/test_stack_and_degrader.py +101 -0
  271. package/skills/trtc-ai-service/tests/test_verify_credentials.py +285 -0
  272. package/skills/trtc-ai-service/triggers.yaml +29 -0
  273. package/skills/trtc-chat/.docs-query.yaml +8 -0
  274. package/skills/trtc-chat/SKILL.md +186 -0
  275. package/skills/trtc-chat/docs/SKILL.md +31 -0
  276. package/skills/trtc-chat/flows/maintenance.md +19 -0
  277. package/skills/trtc-chat/flows/onboarding.md +79 -0
  278. package/skills/trtc-chat/references/01-detect-project.md +136 -0
  279. package/skills/trtc-chat/references/02-path-a-questions.md +182 -0
  280. package/skills/trtc-chat/references/02-path-a-scaffold-template.md +59 -0
  281. package/skills/trtc-chat/references/02-path-a-script.md +266 -0
  282. package/skills/trtc-chat/references/02-path-a-templates.md +159 -0
  283. package/skills/trtc-chat/references/03-path-b-script.md +226 -0
  284. package/skills/trtc-chat/references/04-path-c-script.md +95 -0
  285. package/skills/trtc-chat/references/04-uikit-redirect.md +32 -0
  286. package/skills/trtc-chat/references/05-path-d-script.md +647 -0
  287. package/skills/trtc-chat/references/05-slice-loading.md +139 -0
  288. package/skills/trtc-chat/references/06-a-defensive-coding.md +139 -0
  289. package/skills/trtc-chat/references/06-hard-rules.md +190 -0
  290. package/skills/trtc-chat/references/08-state-config.md +229 -0
  291. package/skills/trtc-chat/references/09-troubleshoot.md +91 -0
  292. package/skills/trtc-chat/references/10-references-index.md +63 -0
  293. package/skills/trtc-chat/references/11-what-to-do-next-template.md +338 -0
  294. package/skills/trtc-chat/references/12-page-composition.md +73 -0
  295. package/skills/trtc-chat/references/13-reporting.md +128 -0
  296. package/skills/trtc-chat/references/14-official-docs.md +169 -0
  297. package/skills/trtc-chat/references/execution-units.yaml +27 -0
  298. package/skills/trtc-chat/references/vue3.md +104 -0
  299. package/skills/trtc-chat/tests/test_chat_bundle_contract.py +293 -0
  300. package/skills/trtc-chat/tools/__init__.py +5 -0
  301. package/skills/trtc-chat/tools/_delegate.py +32 -0
  302. package/skills/trtc-chat/tools/flow.py +8 -0
  303. package/skills/trtc-chat/tools/kb.py +8 -0
  304. package/skills/trtc-chat/tools/reporting_v2.py +8 -0
  305. package/skills/trtc-chat/tools/session.py +8 -0
  306. package/skills/trtc-conference/SKILL.md +324 -0
  307. package/skills/trtc-conference/flows/onboarding.md +205 -0
  308. package/skills/trtc-conference/flows/topic.md +474 -0
  309. package/skills/trtc-conference/flows/troubleshoot.md +85 -0
  310. package/skills/trtc-conference/hooks/pretooluse_require_business_decisions.py +213 -0
  311. package/skills/trtc-conference/playbooks/medical-quickstart.md +84 -0
  312. package/skills/trtc-conference/playbooks/official-roomkit.md +97 -0
  313. package/skills/trtc-conference/references/local-usersig/basic-info-config.ts +39 -0
  314. package/skills/trtc-conference/references/usersig-handling.md +134 -0
  315. package/skills/trtc-conference/templates/medical-consultation/src/config/lib-generate-test-usersig-es.min.d.ts +4 -0
  316. package/skills/trtc-conference/templates/medical-consultation/src/config/lib-generate-test-usersig-es.min.js +2 -0
  317. package/skills/trtc-conference/tests/__pycache__/test_conference_onboarding_contract.cpython-313-pytest-9.0.2.pyc +0 -0
  318. package/skills/trtc-conference/tests/__pycache__/test_conference_topic_flow_contract.cpython-313-pytest-9.0.2.pyc +0 -0
  319. package/skills/trtc-conference/tests/test_conference_index_contract.py +43 -0
  320. package/skills/trtc-conference/tests/test_conference_onboarding_contract.py +103 -0
  321. package/skills/trtc-conference/tests/test_conference_template_contract.py +25 -0
  322. package/skills/trtc-conference/tests/test_conference_topic_flow_contract.py +132 -0
  323. package/skills/trtc-conference/tools/apply_checks.py +328 -0
  324. package/skills/trtc-conference/verify_lib/__init__.py +0 -0
  325. package/skills/{trtc-apply/guardrails/apply_lib → trtc-conference/verify_lib}/rule_parser.py +1 -1
  326. package/skills/trtc-docs/SKILL.md +91 -119
  327. package/.cursor/rules/ui-mode.mdc +0 -99
  328. package/ai-instructions/base.md +0 -13
  329. package/ai-instructions/ui-mode.md +0 -93
  330. package/knowledge-base/index.yaml +0 -462
  331. package/skills/trtc/room-builder/SKILL.md +0 -133
  332. package/skills/trtc/room-builder/templates/scenarios/medical-consultation/README.md +0 -108
  333. package/skills/trtc/room-builder/tools/render_ai_instructions.py +0 -226
  334. package/skills/trtc-apply/SKILL.md +0 -97
  335. package/skills/trtc-onboarding/SKILL.md +0 -841
  336. package/skills/trtc-onboarding/reference/path-a1-demo.md +0 -103
  337. package/skills/trtc-onboarding/reference/path-a2-integrate.md +0 -737
  338. package/skills/trtc-onboarding/reference/path-b-troubleshoot.md +0 -186
  339. package/skills/trtc-onboarding/reference/path-c-expand.md +0 -43
  340. package/skills/trtc-onboarding/reference/supported-matrix.md +0 -100
  341. package/skills/trtc-search/SKILL.md +0 -228
  342. package/skills/trtc-topic/SKILL.md +0 -622
  343. package/skills/trtc-topic/scripts/apply.py +0 -581
  344. package/skills/trtc-topic/scripts/lib/state_machine.py +0 -328
  345. package/skills/trtc-topic/tests/README.md +0 -70
  346. package/skills/trtc-topic/tests/conftest.py +0 -72
  347. package/skills/trtc-topic/tests/test_apply_cli.py +0 -480
  348. package/skills/trtc-topic/tests/test_end_to_end.py +0 -305
  349. package/skills/trtc-topic/tests/test_finalize_session.py +0 -51
  350. package/skills/trtc-topic/tests/test_gates.py +0 -316
  351. package/skills/trtc-topic/tests/test_session_resolver.py +0 -260
  352. package/skills/trtc-topic/tests/test_state_machine.py +0 -414
  353. package/skills/trtc-topic/tests/test_stop_require_apply.py +0 -99
  354. package/skills/trtc-topic/tests/test_topic_skill_invariants.py +0 -130
  355. /package/skills/{trtc-topic → trtc}/runtime/lib/platforms.py +0 -0
  356. /package/skills/{trtc-topic → trtc}/runtime/telemetry_collector.py +0 -0
  357. /package/skills/{trtc-onboarding/reference → trtc/runtime}/usersig-handling.md +0 -0
  358. /package/skills/{trtc-topic/scripts → trtc/tools}/finalize_session.py +0 -0
  359. /package/skills/{trtc-apply/guardrails/apply_lib → trtc-ai-service/capabilities/conversation-core/tests}/__init__.py +0 -0
  360. /package/skills/{trtc-topic → trtc-conference}/references/execution-units.yaml +0 -0
  361. /package/skills/{trtc/room-builder/templates/scenarios/medical-consultation/src/config → trtc-conference/references/local-usersig}/lib-generate-test-usersig-es.min.d.ts +0 -0
  362. /package/skills/{trtc/room-builder/templates/scenarios/medical-consultation/src/config → trtc-conference/references/local-usersig}/lib-generate-test-usersig-es.min.js +0 -0
  363. /package/skills/{trtc/room-builder/templates/scenarios → trtc-conference/templates}/medical-consultation/docs/backend-contract.zh-CN.md +0 -0
  364. /package/skills/{trtc/room-builder/templates/scenarios → trtc-conference/templates}/medical-consultation/docs/integration.zh-CN.md +0 -0
  365. /package/skills/{trtc/room-builder/templates/scenarios → trtc-conference/templates}/medical-consultation/docs/theme.zh-CN.md +0 -0
  366. /package/skills/{trtc/room-builder/templates/scenarios → trtc-conference/templates}/medical-consultation/index.html +0 -0
  367. /package/skills/{trtc/room-builder/templates/scenarios → trtc-conference/templates}/medical-consultation/package.json +0 -0
  368. /package/skills/{trtc/room-builder/templates/scenarios → trtc-conference/templates}/medical-consultation/postcss.config.js +0 -0
  369. /package/skills/{trtc/room-builder/templates/scenarios → trtc-conference/templates}/medical-consultation/src/App.vue +0 -0
  370. /package/skills/{trtc/room-builder/templates/scenarios → trtc-conference/templates}/medical-consultation/src/components/ConsultationManagePanel.vue +0 -0
  371. /package/skills/{trtc/room-builder/templates/scenarios → trtc-conference/templates}/medical-consultation/src/components/LanguageSwitch.vue +0 -0
  372. /package/skills/{trtc/room-builder/templates/scenarios → trtc-conference/templates}/medical-consultation/src/components/LoadingSpinner.vue +0 -0
  373. /package/skills/{trtc/room-builder/templates/scenarios → trtc-conference/templates}/medical-consultation/src/components/MedicalAlert.vue +0 -0
  374. /package/skills/{trtc/room-builder/templates/scenarios → trtc-conference/templates}/medical-consultation/src/components/MedicalBusinessPanel.vue +0 -0
  375. /package/skills/{trtc/room-builder/templates/scenarios → trtc-conference/templates}/medical-consultation/src/components/MedicalButton.vue +0 -0
  376. /package/skills/{trtc/room-builder/templates/scenarios → trtc-conference/templates}/medical-consultation/src/components/MedicalConfirmDialog.vue +0 -0
  377. /package/skills/{trtc/room-builder/templates/scenarios → trtc-conference/templates}/medical-consultation/src/components/MedicalDataPanel.vue +0 -0
  378. /package/skills/{trtc/room-builder/templates/scenarios → trtc-conference/templates}/medical-consultation/src/components/MedicalRecordPanel.vue +0 -0
  379. /package/skills/{trtc/room-builder/templates/scenarios → trtc-conference/templates}/medical-consultation/src/components/PrescriptionPanel.vue +0 -0
  380. /package/skills/{trtc/room-builder/templates/scenarios → trtc-conference/templates}/medical-consultation/src/config/basic-info-config.ts +0 -0
  381. /package/skills/{trtc/room-builder/templates/scenarios → trtc-conference/templates}/medical-consultation/src/config/runtime-config.ts +0 -0
  382. /package/skills/{trtc/room-builder/templates/scenarios → trtc-conference/templates}/medical-consultation/src/env.d.ts +0 -0
  383. /package/skills/{trtc/room-builder/templates/scenarios → trtc-conference/templates}/medical-consultation/src/features/consultation/components/ConsultationChatPanel.vue +0 -0
  384. /package/skills/{trtc/room-builder/templates/scenarios → trtc-conference/templates}/medical-consultation/src/features/consultation/components/ConsultationMembersPanel.vue +0 -0
  385. /package/skills/{trtc/room-builder/templates/scenarios → trtc-conference/templates}/medical-consultation/src/features/consultation/components/ConsultationTranscriptionPanel.vue +0 -0
  386. /package/skills/{trtc/room-builder/templates/scenarios → trtc-conference/templates}/medical-consultation/src/features/consultation/components/ConsultationVideoStage.vue +0 -0
  387. /package/skills/{trtc/room-builder/templates/scenarios → trtc-conference/templates}/medical-consultation/src/features/consultation/components/InviteDoctorDialog.vue +0 -0
  388. /package/skills/{trtc/room-builder/templates/scenarios → trtc-conference/templates}/medical-consultation/src/features/consultation/components/KickMemberConfirmDialog.vue +0 -0
  389. /package/skills/{trtc/room-builder/templates/scenarios → trtc-conference/templates}/medical-consultation/src/features/consultation/types.ts +0 -0
  390. /package/skills/{trtc/room-builder/templates/scenarios → trtc-conference/templates}/medical-consultation/src/features/consultation/useConsultationChat.ts +0 -0
  391. /package/skills/{trtc/room-builder/templates/scenarios → trtc-conference/templates}/medical-consultation/src/features/consultation/useConsultationDevices.ts +0 -0
  392. /package/skills/{trtc/room-builder/templates/scenarios → trtc-conference/templates}/medical-consultation/src/features/consultation/useConsultationParticipants.ts +0 -0
  393. /package/skills/{trtc/room-builder/templates/scenarios → trtc-conference/templates}/medical-consultation/src/features/consultation/useConsultationPermissions.ts +0 -0
  394. /package/skills/{trtc/room-builder/templates/scenarios → trtc-conference/templates}/medical-consultation/src/features/consultation/utils.ts +0 -0
  395. /package/skills/{trtc/room-builder/templates/scenarios → trtc-conference/templates}/medical-consultation/src/i18n/en-US/index.ts +0 -0
  396. /package/skills/{trtc/room-builder/templates/scenarios → trtc-conference/templates}/medical-consultation/src/i18n/index.ts +0 -0
  397. /package/skills/{trtc/room-builder/templates/scenarios → trtc-conference/templates}/medical-consultation/src/i18n/medicalTranslate.ts +0 -0
  398. /package/skills/{trtc/room-builder/templates/scenarios → trtc-conference/templates}/medical-consultation/src/i18n/state.ts +0 -0
  399. /package/skills/{trtc/room-builder/templates/scenarios → trtc-conference/templates}/medical-consultation/src/i18n/zh-CN/index.ts +0 -0
  400. /package/skills/{trtc/room-builder/templates/scenarios → trtc-conference/templates}/medical-consultation/src/main.ts +0 -0
  401. /package/skills/{trtc/room-builder/templates/scenarios → trtc-conference/templates}/medical-consultation/src/mock/appointments.ts +0 -0
  402. /package/skills/{trtc/room-builder/templates/scenarios → trtc-conference/templates}/medical-consultation/src/mock/users.ts +0 -0
  403. /package/skills/{trtc/room-builder/templates/scenarios → trtc-conference/templates}/medical-consultation/src/router/index.ts +0 -0
  404. /package/skills/{trtc/room-builder/templates/scenarios → trtc-conference/templates}/medical-consultation/src/services/adapters/index.ts +0 -0
  405. /package/skills/{trtc/room-builder/templates/scenarios → trtc-conference/templates}/medical-consultation/src/services/adapters/integration/appointmentService.ts +0 -0
  406. /package/skills/{trtc/room-builder/templates/scenarios → trtc-conference/templates}/medical-consultation/src/services/adapters/integration/authService.ts +0 -0
  407. /package/skills/{trtc/room-builder/templates/scenarios → trtc-conference/templates}/medical-consultation/src/services/adapters/integration/launchContext.ts +0 -0
  408. /package/skills/{trtc/room-builder/templates/scenarios → trtc-conference/templates}/medical-consultation/src/services/adapters/integration/userService.ts +0 -0
  409. /package/skills/{trtc/room-builder/templates/scenarios → trtc-conference/templates}/medical-consultation/src/services/adapters/mock/appointmentService.ts +0 -0
  410. /package/skills/{trtc/room-builder/templates/scenarios → trtc-conference/templates}/medical-consultation/src/services/adapters/mock/authService.ts +0 -0
  411. /package/skills/{trtc/room-builder/templates/scenarios → trtc-conference/templates}/medical-consultation/src/services/adapters/mock/userService.ts +0 -0
  412. /package/skills/{trtc/room-builder/templates/scenarios → trtc-conference/templates}/medical-consultation/src/services/adapters/types.ts +0 -0
  413. /package/skills/{trtc/room-builder/templates/scenarios → trtc-conference/templates}/medical-consultation/src/shared/icons.ts +0 -0
  414. /package/skills/{trtc/room-builder/templates/scenarios → trtc-conference/templates}/medical-consultation/src/styles/index.css +0 -0
  415. /package/skills/{trtc/room-builder/templates/scenarios → trtc-conference/templates}/medical-consultation/src/styles/tailwind.css +0 -0
  416. /package/skills/{trtc/room-builder/templates/scenarios → trtc-conference/templates}/medical-consultation/src/styles/theme.css +0 -0
  417. /package/skills/{trtc/room-builder/templates/scenarios → trtc-conference/templates}/medical-consultation/src/utils/auth.ts +0 -0
  418. /package/skills/{trtc/room-builder/templates/scenarios → trtc-conference/templates}/medical-consultation/src/utils/format.ts +0 -0
  419. /package/skills/{trtc/room-builder/templates/scenarios → trtc-conference/templates}/medical-consultation/src/utils/navigation.ts +0 -0
  420. /package/skills/{trtc/room-builder/templates/scenarios → trtc-conference/templates}/medical-consultation/src/utils/session.ts +0 -0
  421. /package/skills/{trtc/room-builder/templates/scenarios → trtc-conference/templates}/medical-consultation/src/views/DoctorConsultationView.vue +0 -0
  422. /package/skills/{trtc/room-builder/templates/scenarios → trtc-conference/templates}/medical-consultation/src/views/DoctorDashboardView.vue +0 -0
  423. /package/skills/{trtc/room-builder/templates/scenarios → trtc-conference/templates}/medical-consultation/src/views/LoginView.vue +0 -0
  424. /package/skills/{trtc/room-builder/templates/scenarios → trtc-conference/templates}/medical-consultation/src/views/PatientConsultationFinishedView.vue +0 -0
  425. /package/skills/{trtc/room-builder/templates/scenarios → trtc-conference/templates}/medical-consultation/src/views/PatientConsultationView.vue +0 -0
  426. /package/skills/{trtc/room-builder/templates/scenarios → trtc-conference/templates}/medical-consultation/src/views/PatientSelectDoctorView.vue +0 -0
  427. /package/skills/{trtc/room-builder/templates/scenarios → trtc-conference/templates}/medical-consultation/src/views/PatientWaitingView.vue +0 -0
  428. /package/skills/{trtc/room-builder/templates/scenarios → trtc-conference/templates}/medical-consultation/tsconfig.json +0 -0
  429. /package/skills/{trtc/room-builder/templates/scenarios → trtc-conference/templates}/medical-consultation/tsconfig.node.json +0 -0
  430. /package/skills/{trtc/room-builder/templates/scenarios → trtc-conference/templates}/medical-consultation/vite.config.ts +0 -0
  431. /package/skills/{trtc/room-builder/templates/scenarios → trtc-conference/templates}/medical-consultation//346/216/245/345/205/245/350/257/264/346/230/216.md" +0 -0
  432. /package/skills/{trtc-topic/runtime/lib → trtc-conference/tools}/__init__.py +0 -0
package/knowledge-base/docs/chat/product.md ADDED
@@ -0,0 +1,61 @@
1
+ # 产品计费与配置 — 官方文档 URL 映射
2
+
3
+ ## 计费与购买
4
+
5
+ | 子问题 | 目标文档 |
6
+ |--------|---------|
7
+ | 计费说明 | `https://cloud.tencent.com/document/product/269/11673` |
8
+ | 购买指引 | `https://cloud.tencent.com/document/product/269/32458` |
9
+ | 套餐包功能差异 | `https://cloud.tencent.com/document/product/269/112884` |
10
+ | 购买套餐后变更配置 | `https://cloud.tencent.com/document/product/269/81908` |
11
+ | 续费指引（含自动续费） | `https://cloud.tencent.com/document/product/269/32472` |
12
+ | 退费指引 | `https://cloud.tencent.com/document/product/269/32473` |
13
+
14
+ ## 产品能力与配置
15
+
16
+ | 子问题 | 目标文档 |
17
+ |--------|---------|
18
+ | 多端登录配置指引 | `https://cloud.tencent.com/document/product/269/1499` |
19
+ | 控制台功能介绍 | `https://cloud.tencent.com/document/product/269/1499` |
20
+ | 用户在线状态管理 | `https://cloud.tencent.com/document/product/269/3665` |
21
+ | 用户资料管理（标准资料字段/自定义资料字段/自定义资料字段的命名规范） | `https://cloud.tencent.com/document/product/269/1500` |
22
+ | 关系链管理（标配好友字段/自定义好友字段/添加好友/删除好友功能介绍） | `https://cloud.tencent.com/document/product/269/1501` |
23
+ | 漫游消息存储时长说明 | `https://cloud.tencent.com/document/product/269/81908` |
24
+ | 单聊消息权限控制与配置 | `https://cloud.tencent.com/document/product/269/3662` |
25
+ | 群组消息管理（App 管理员发送消息/群消息发送控制/消息优先级与频率控制
26
+ ） | `https://cloud.tencent.com/document/product/269/3663` |
27
+ | 不同类型群组基础能力操作差异 | `https://cloud.tencent.com/document/product/269/1502` |
28
+ | 不同类型群组加群方式差异 | `https://cloud.tencent.com/document/product/269/1502` |
29
+ | 不同类型群组成员管理能力差异 | `https://cloud.tencent.com/document/product/269/1502` |
30
+ | 不同类型群组群组限制差异 | `https://cloud.tencent.com/document/product/269/1502` |
31
+ | 不同类型群组消息能力差异 | `https://cloud.tencent.com/document/product/269/1502` |
32
+ | 群组/群成员/群消息导入 | `https://cloud.tencent.com/document/product/269/1502` |
33
+ | 群组自动回收能力 | `https://cloud.tencent.com/document/product/269/1502` |
34
+ | 自定义群组ID(话题 ID) | `https://cloud.tencent.com/document/product/269/1502` |
35
+ | 群组自定义字段 | `https://cloud.tencent.com/document/product/269/1502` |
36
+ | 云端审核能力介绍 | `https://cloud.tencent.com/document/product/269/83795` |
37
+
38
+ ### 使用限制
39
+
40
+ | 子问题 | 目标文档 |
41
+ |--------|---------|
42
+ | 业务特性限制（UserID 命名规则/格式要求/长度上限/允许字符、单个 App 可创建群组数/用户加入群组上限/群成员数/好友数上限等） | `https://cloud.tencent.com/document/product/269/32429` |
43
+ | 接口通用限制（REST API QPS 限制/请求频率/消息体大小 12KB 限制（不可修改）/单次拉取与批量接口上限等） | `https://cloud.tencent.com/document/product/269/32429` |
44
+ | 账号管理限制（导入账号上限/批量导入多个账号上限/删除与查询账号限制数等） | `https://cloud.tencent.com/document/product/269/32429` |
45
+ | 单聊消息限制（离线消息漫游存储时长/单聊单条消息已读回执限制等） | `https://cloud.tencent.com/document/product/269/32429` |
46
+ | 关系链管理限制（添加与删除好友限制/好友分组限制/黑名单限制/批量好友接口上限等） | `https://cloud.tencent.com/document/product/269/32429` |
47
+ | 群组管理限制（群主转让/群成员禁言/群封禁人数限制/群计数器限制/群自定义字段数等） | `https://cloud.tencent.com/document/product/269/32429` |
48
+
49
+ ## 出海解决方案
50
+
51
+ | 子问题 | 目标文档 |
52
+ |--------|---------|
53
+ | 海外接入指南 | `https://cloud.tencent.com/document/product/269/81906` |
54
+ | 海外节点全球加速 | `https://cloud.tencent.com/document/product/269/86463` |
55
+ | 海外数据安全合规 | `https://cloud.tencent.com/document/product/269/86464` |
56
+
57
+ ## 场景解决方案
58
+
59
+ | 子问题 | 目标文档 |
60
+ |--------|---------|
61
+ | 内网代理实现方案 | `https://cloud.tencent.com/document/product/269/122408` |
package/knowledge-base/docs/chat/restapi.md ADDED
@@ -0,0 +1,227 @@
1
+ # 服务端 REST API — 官方文档 URL 映射
2
+
3
+ ### 通用技术
4
+
5
+ | 子问题 | 目标文档 |
6
+ |--------|---------|
7
+ | UserSig 生成方法（登录鉴权） | `https://cloud.tencent.com/document/product/269/32688` |
8
+ | 服务端错误码表 | `https://cloud.tencent.com/document/product/269/1671` |
9
+ | 服务端消息格式 | `https://cloud.tencent.com/document/product/269/2720` |
10
+
11
+ ## 消息相关 REST API
12
+
13
+ ### 发送消息
14
+
15
+ | 子问题 | 目标文档 |
16
+ |--------|---------|
17
+ | 单发单聊消息 | `https://cloud.tencent.com/document/product/269/2282` |
18
+ | 批量发单聊消息 | `https://cloud.tencent.com/document/product/269/1612` |
19
+ | 在群组中发送普通消息 | `https://cloud.tencent.com/document/product/269/1629` |
20
+ | 发送 C2C 流式消息 | `https://cloud.tencent.com/document/product/269/128596` |
21
+ | 发送群流式消息 | `https://cloud.tencent.com/document/product/269/128597` |
22
+ | 直播群广播消息 | `https://cloud.tencent.com/document/product/269/77402` |
23
+ | 导入群消息 | `https://cloud.tencent.com/document/product/269/1635` |
24
+ | 导入单聊消息 | `https://cloud.tencent.com/document/product/269/2568` |
25
+ | 公众号用户发送广播消息 | `https://cloud.tencent.com/document/product/269/102298` |
26
+
27
+ ### 历史消息
28
+
29
+ | 子问题 | 目标文档 |
30
+ |--------|---------|
31
+ | 修改单聊历史消息 | `https://cloud.tencent.com/document/product/269/74740` |
32
+ | 修改群聊历史消息 | `https://cloud.tencent.com/document/product/269/74741` |
33
+ | 拉取单聊历史消息 | `https://cloud.tencent.com/document/product/269/42794` |
34
+ | 拉取群聊历史消息 | `https://cloud.tencent.com/document/product/269/2738` |
35
+ | 拉取公众号用户历史消息 | `https://cloud.tencent.com/document/product/269/102299` |
36
+
37
+ ### 删除消息
38
+
39
+ | 子问题 | 目标文档 |
40
+ |--------|---------|
41
+ | 单向删除单聊历史消息 | `https://cloud.tencent.com/document/product/269/101439` |
42
+ | 清空群聊历史消息 | `https://cloud.tencent.com/document/product/269/95617` |
43
+ | 删除指定用户发送的消息 | `https://cloud.tencent.com/document/product/269/2359` |
44
+
45
+ ### 撤回消息
46
+
47
+ | 子问题 | 目标文档 |
48
+ |--------|---------|
49
+ | 撤回单聊消息 | `https://cloud.tencent.com/document/product/269/38980` |
50
+ | 撤回群消息 | `https://cloud.tencent.com/document/product/269/12341` |
51
+ | 撤回公众号消息 | `https://cloud.tencent.com/document/product/269/102327` |
52
+
53
+ ### 已读回执
54
+
55
+ | 子问题 | 目标文档 |
56
+ |--------|---------|
57
+ | 群消息已读回执 | `https://cloud.tencent.com/document/product/269/107478` |
58
+ | 发送单聊消息已读回执 | `https://cloud.tencent.com/document/product/269/104121` |
59
+ | 拉取群消息已读回执详情 | `https://cloud.tencent.com/document/product/269/77693` |
60
+ | 拉取群消息已读回执信息 | `https://cloud.tencent.com/document/product/269/77694` |
61
+
62
+ ### 消息扩展
63
+
64
+ | 子问题 | 目标文档 |
65
+ |--------|---------|
66
+ | 拉取单聊消息扩展 | `https://cloud.tencent.com/document/product/269/82029` |
67
+ | 设置单聊消息扩展 | `https://cloud.tencent.com/document/product/269/82030` |
68
+ | 拉取群消息扩展 | `https://cloud.tencent.com/document/product/269/82031` |
69
+ | 设置群消息扩展 | `https://cloud.tencent.com/document/product/269/82032` |
70
+
71
+ ## 会话相关 REST API
72
+
73
+ ### 会话基础能力
74
+
75
+ | 子问题 | 目标文档 |
76
+ |--------|---------|
77
+ | 拉取会话列表 | `https://cloud.tencent.com/document/product/269/62118` |
78
+ | 设置群成员未读消息计数 | `https://cloud.tencent.com/document/product/269/1637` |
79
+ | 清理单聊会话的未读消息计数 | `https://cloud.tencent.com/document/product/269/50349` |
80
+ | 设置置顶会话 | `https://cloud.tencent.com/document/product/269/103772` |
81
+ | 删除单个会话 | `https://cloud.tencent.com/document/product/269/62119` |
82
+
83
+ ### 会话分组标记
84
+
85
+ | 子问题 | 目标文档 |
86
+ |--------|---------|
87
+ | 创建会话分组数据 | `https://cloud.tencent.com/document/product/269/85791` |
88
+ | 更新会话分组数据 | `https://cloud.tencent.com/document/product/269/85793` |
89
+ | 删除会话分组数据 | `https://cloud.tencent.com/document/product/269/85795` |
90
+ | 创建或更新会话标记数据 | `https://cloud.tencent.com/document/product/269/85792` |
91
+ | 搜索会话分组标记 | `https://cloud.tencent.com/document/product/269/85796` |
92
+ | 拉取会话分组标记数据 | `https://cloud.tencent.com/document/product/269/85794` |
93
+
94
+ ## 群组相关 REST API
95
+
96
+ ### 群组管理
97
+
98
+ | 子问题 | 目标文档 |
99
+ |--------|---------|
100
+ | 创建群组 | `https://cloud.tencent.com/document/product/269/1615` |
101
+ | 解散群组 | `https://cloud.tencent.com/document/product/269/1624` |
102
+ | 获取用户所加入的群组 | `https://cloud.tencent.com/document/product/269/1625` |
103
+ | 获取 App 中的所有群组 | `https://cloud.tencent.com/document/product/269/1614` |
104
+
105
+ ### 群资料
106
+
107
+ | 子问题 | 目标文档 |
108
+ |--------|---------|
109
+ | 获取群详细资料 | `https://cloud.tencent.com/document/product/269/1616` |
110
+ | 修改群基础资料 | `https://cloud.tencent.com/document/product/269/1620` |
111
+ | 导入群基础资料 | `https://cloud.tencent.com/document/product/269/1634` |
112
+
113
+ ### 群成员管理
114
+
115
+ | 子问题 | 目标文档 |
116
+ |--------|---------|
117
+ | 增加群成员 | `https://cloud.tencent.com/document/product/269/1621` |
118
+ | 删除群成员 | `https://cloud.tencent.com/document/product/269/1622` |
119
+ | 群成员封禁 | `https://cloud.tencent.com/document/product/269/79249` |
120
+ | 群成员解封 | `https://cloud.tencent.com/document/product/269/79250` |
121
+ | 获取封禁群成员列表 | `https://cloud.tencent.com/document/product/269/79248` |
122
+ | 批量禁言和取消禁言 | `https://cloud.tencent.com/document/product/269/1627` |
123
+ | 获取被禁言群成员列表 | `https://cloud.tencent.com/document/product/269/2925` |
124
+ | 转让群主 | `https://cloud.tencent.com/document/product/269/1633` |
125
+ | 查询用户在群组中的身份 | `https://cloud.tencent.com/document/product/269/1626` |
126
+ | 导入群成员 | `https://cloud.tencent.com/document/product/269/1636` |
127
+
128
+ ### 群成员资料
129
+
130
+ | 子问题 | 目标文档 |
131
+ |--------|---------|
132
+ | 获取群成员详细资料 | `https://cloud.tencent.com/document/product/269/1617` |
133
+ | 获取指定群成员详细资料 | `https://cloud.tencent.com/document/product/269/112002` |
134
+ | 修改群成员资料 | `https://cloud.tencent.com/document/product/269/1623` |
135
+
136
+ ### 群自定义属性
137
+
138
+ | 子问题 | 目标文档 |
139
+ |--------|---------|
140
+ | 获取群自定义属性 | `https://cloud.tencent.com/document/product/269/67012` |
141
+ | 修改群自定义属性 | `https://cloud.tencent.com/document/product/269/67010` |
142
+ | 清空群自定义属性 | `https://cloud.tencent.com/document/product/269/67009` |
143
+ | 重置群自定义属性 | `https://cloud.tencent.com/document/product/269/67011` |
144
+ | 删除群自定义属性 | `https://cloud.tencent.com/document/product/269/104440` |
145
+
146
+ ### 直播群管理
147
+
148
+ | 子问题 | 目标文档 |
149
+ |--------|---------|
150
+ | 设置直播群机器人 | `https://cloud.tencent.com/document/product/269/103784` |
151
+ | 取消直播群机器人 | `https://cloud.tencent.com/document/product/269/103785` |
152
+ | 设置/取消直播群管理员 | `https://cloud.tencent.com/document/product/269/102857` |
153
+ | 获取直播群管理员列表 | `https://cloud.tencent.com/document/product/269/102858` |
154
+ | 获取直播群在线人数 | `https://cloud.tencent.com/document/product/269/49180` |
155
+ | 获取直播群在线成员列表 | `https://cloud.tencent.com/document/product/269/77266` |
156
+ | 设置直播群成员标记 | `https://cloud.tencent.com/document/product/269/79267` |
157
+
158
+ ### 社群管理
159
+
160
+ | 子问题 | 目标文档 |
161
+ |--------|---------|
162
+ | 创建话题 | `https://cloud.tencent.com/document/product/269/78203` |
163
+ | 解散话题 | `https://cloud.tencent.com/document/product/269/78202` |
164
+ | 获取话题资料 | `https://cloud.tencent.com/document/product/269/78204` |
165
+ | 修改话题资料 | `https://cloud.tencent.com/document/product/269/78205` |
166
+ | 导入话题基础资料 | `https://cloud.tencent.com/document/product/269/85313` |
167
+ | 获取社群在线人数 | `https://cloud.tencent.com/document/product/269/102707` |
168
+
169
+ ### 群计数器
170
+
171
+ | 子问题 | 目标文档 |
172
+ |--------|---------|
173
+ | 获取群计数器 | `https://cloud.tencent.com/document/product/269/85953` |
174
+ | 更新群计数器 | `https://cloud.tencent.com/document/product/269/85952` |
175
+ | 删除群计数器 | `https://cloud.tencent.com/document/product/269/85954` |
176
+
177
+ ## 用户相关 REST API
178
+
179
+ ### 账号管理
180
+
181
+ | 子问题 | 目标文档 |
182
+ |--------|---------|
183
+ | 导入单个账号 | `https://cloud.tencent.com/document/product/269/1608` |
184
+ | 导入多个账号 | `https://cloud.tencent.com/document/product/269/4919` |
185
+ | 查询账号 | `https://cloud.tencent.com/document/product/269/38417` |
186
+ | 删除账号 | `https://cloud.tencent.com/document/product/269/36443` |
187
+
188
+ ### 用户资料管理
189
+
190
+ | 子问题 | 目标文档 |
191
+ |--------|---------|
192
+ | 获取用户资料 | `https://cloud.tencent.com/document/product/269/1639` |
193
+ | 设置用户资料 | `https://cloud.tencent.com/document/product/269/1640` |
194
+
195
+ ### 用户在线状态
196
+
197
+ | 子问题 | 目标文档 |
198
+ |--------|---------|
199
+ | 查询账号在线状态 | `https://cloud.tencent.com/document/product/269/2566` |
200
+ | 失效账号登录状态 | `https://cloud.tencent.com/document/product/269/3853` |
201
+
202
+
203
+ ### 全局禁言管理
204
+
205
+ | 子问题 | 目标文档 |
206
+ |--------|---------|
207
+ | 设置全局禁言 | `https://cloud.tencent.com/document/product/269/4230` |
208
+ | 查询全局禁言 | `https://cloud.tencent.com/document/product/269/4229` |
209
+
210
+ ### 云端搜索
211
+
212
+ | 子问题 | 目标文档 |
213
+ |--------|---------|
214
+ | 用户搜索 | `https://cloud.tencent.com/document/product/269/114547` |
215
+ | 群成员搜索 | `https://cloud.tencent.com/document/product/269/114548` |
216
+ | 群组搜索 | `https://cloud.tencent.com/document/product/269/114549` |
217
+ | 隐藏搜索对象 | `https://cloud.tencent.com/document/product/269/114550` |
218
+ | 查询隐藏搜索对象 | `https://cloud.tencent.com/document/product/269/114551` |
219
+
220
+ ### 机器人
221
+
222
+ | 子问题 | 目标文档 |
223
+ |--------|---------|
224
+ | 发送流式响应消息 | `https://cloud.tencent.com/document/product/269/104537` |
225
+ | 创建机器人 | `https://cloud.tencent.com/document/product/269/89991` |
226
+ | 删除机器人 | `https://cloud.tencent.com/document/product/269/89992` |
227
+ | 获取取所有机器人 | `https://cloud.tencent.com/document/product/269/89993` |
package/knowledge-base/docs/chat/sdk/android/faq.md ADDED
@@ -0,0 +1,7 @@
1
+ # Web — 高频问题预检清单
2
+
3
+ > dispatcher 检索前先判断是否属于已知高频问题，可节省一次 android 请求。
4
+
5
+ | 高频问题 | 快速答案（预埋） |
6
+ |---------|----------------|
7
+
package/knowledge-base/docs/chat/sdk/android/index.md ADDED
@@ -0,0 +1,94 @@
1
+ # Web — SDK 官方文档 URL 映射
2
+
3
+ > 知识咨询时 `read_file` 本文件，按问题匹配领域和子问题，获取目标 URL。检索方式和兜底策略见 `references/14-official-docs.md`。
4
+
5
+ ## A — SDK 集成和初始化（Android）
6
+
7
+ | 子问题 | 目标文档 |
8
+ |--------|---------|
9
+ | Android SDK 集成 | `https://cloud.tencent.com/document/product/269/75283` |
10
+ | Android SDK 初始化 | `https://cloud.tencent.com/document/product/269/75291` |
11
+
12
+ ## B — 登录
13
+
14
+ | 子问题 | 目标文档 |
15
+ |--------|---------|
16
+ | 登录（`login` API） | `https://cloud.tencent.com/document/product/269/75294` |
17
+ | 登出（`logout` API） | `https://cloud.tencent.com/document/product/269/75294` |
18
+
19
+ ## C — SDK API 使用
20
+
21
+ | 子问题 | 目标文档 |
22
+ |--------|---------|
23
+ | SDK 消息类型介绍 | `https://cloud.tencent.com/document/product/269/75313` |
24
+ | 文本消息（sendC2CMessage/sendGroupTextMessage） | `https://cloud.tencent.com/document/product/269/75315` |
25
+ | 群 @ 消息（createAtSignedGroupMessage → sendMessage） | `https://cloud.tencent.com/document/product/269/75349` |
26
+ | 图片消息（createImageMessage → sendMessage） | `https://cloud.tencent.com/document/product/269/75315` |
27
+ | 语音消息（createSoundMessage → sendMessage） | `https://cloud.tencent.com/document/product/269/75315` |
28
+ | 视频消息（createVideoMessage → sendMessage） | `https://cloud.tencent.com/document/product/269/75315` |
29
+ | 文件消息（createFileMessage → sendMessage） | `https://cloud.tencent.com/document/product/269/75315` |
30
+ | 自定义消息（sendC2CCustomMessage/sendGroupCustomMessage） | `https://cloud.tencent.com/document/product/269/75315` |
31
+ | 表情消息（createFaceMessage → sendMessage） | `https://cloud.tencent.com/document/product/269/75315` |
32
+ | 地理位置消息（createLocationMessage → sendMessage） | `https://cloud.tencent.com/document/product/269/75315` |
33
+ | 合并消息（createMergerMessage → sendMessage） | `https://cloud.tencent.com/document/product/269/75324` |
34
+ | 逐条转发消息（createForwardMessage → sendMessage） | `https://cloud.tencent.com/document/product/269/75324` |
35
+ | 发送消息参数配置（sendMessage 参数） | `https://cloud.tencent.com/document/product/269/75315` |
36
+ | 接收消息（addSimpleMsgListener/addAdvancedMsgListener） | `https://cloud.tencent.com/document/product/269/75318` |
37
+ | 获取历史消息（getC2CHistoryMessageList/getGroupHistoryMessageList/getHistoryMessageList） | `https://cloud.tencent.com/document/product/269/75321` |
38
+ | 修改消息（modifyMessage） | `https://cloud.tencent.com/document/product/269/75327` |
39
+ | 插入消息（insertC2CMessageToLocalStorage/insertGroupMessageToLocalStorage） | `https://cloud.tencent.com/document/product/269/75330` |
40
+ | 删除消息（deleteMessageFromLocalStorage/deleteMessages） | `https://cloud.tencent.com/document/product/269/75332` |
41
+ | 清空消息（clearC2CHistoryMessage/clearGroupHistoryMessage） | `https://cloud.tencent.com/document/product/269/75335` |
42
+ | 撤回消息（revokeMessage） | `https://cloud.tencent.com/document/product/269/75337` |
43
+ | 在线消息 | `https://cloud.tencent.com/document/product/269/75340` |
44
+ | 已读回执（单聊/群聊） | `https://cloud.tencent.com/document/product/269/75343` |
45
+ | 查询消息（findMessages） | `https://cloud.tencent.com/document/product/269/75346` |
46
+ | 群定向消息 | `https://cloud.tencent.com/document/product/269/75351` |
47
+ | 消息免打扰（setC2CReceiveMessageOpt/setGroupReceiveMessageOpt/setAllReceiveMessageOpt） | `https://cloud.tencent.com/document/product/269/75353` |
48
+ | 消息扩展（投票/接龙场景） | `https://cloud.tencent.com/document/product/269/81038` |
49
+ | 消息回应（表情回应） | `https://cloud.tencent.com/document/product/269/96241` |
50
+ | 消息翻译（translateText） | `https://cloud.tencent.com/document/product/269/85380` |
51
+ | 语音转文字（convertVoiceToText） | `https://cloud.tencent.com/document/product/269/96280` |
52
+ | 消息置顶（pinGroupMessage） | `https://cloud.tencent.com/document/product/269/106050` |
53
+ | 流式消息（V2TIM_ELEM_TYPE_STREAM） | `https://cloud.tencent.com/document/product/269/129557` |
54
+ | 文字转语音 | `https://cloud.tencent.com/document/product/269/131939` |
55
+ | 会话存储限制 | `https://cloud.tencent.com/document/product/269/75363` |
56
+ | 会话列表（getConversationList） | `https://cloud.tencent.com/document/product/269/75366` |
57
+ | 会话资料（getConversation） | `https://cloud.tencent.com/document/product/269/75369` |
58
+ | 会话未读数（getTotalUnreadMessageCount） | `https://cloud.tencent.com/document/product/269/75372` |
59
+ | 置顶会话（pinConversation） | `https://cloud.tencent.com/document/product/269/75375` |
60
+ | 删除会话（deleteConversation） | `https://cloud.tencent.com/document/product/269/75378` |
61
+ | 会话草稿（setConversationDraft） | `https://cloud.tencent.com/document/product/269/75381` |
62
+ | 会话标记（markConversation） | `https://cloud.tencent.com/document/product/269/77389` |
63
+ | 会话分组 | `https://cloud.tencent.com/document/product/269/77392` |
64
+ | 群组类型和不同群类型能力介绍 | `https://cloud.tencent.com/document/product/269/75697` |
65
+ | 普通群管理 | `https://cloud.tencent.com/document/product/269/75395` |
66
+ | 群资料（getGroupsInfo / setGroupInfo） | `https://cloud.tencent.com/document/product/269/75397` |
67
+ | 群成员管理 | `https://cloud.tencent.com/document/product/269/75400` |
68
+ | 群成员资料 | `https://cloud.tencent.com/document/product/269/75403` |
69
+ | 群自定义属性 | `https://cloud.tencent.com/document/product/269/75406` |
70
+ | 群计数器（groupCounter） | `https://cloud.tencent.com/document/product/269/85676` |
71
+ | 社群（Community / 话题） | `https://cloud.tencent.com/document/product/269/75409` |
72
+ | 社群（权限组） | `https://cloud.tencent.com/document/product/269/104417` |
73
+ | 用户资料（getUsersInfo / setSelfInfo） | `https://cloud.tencent.com/document/product/269/75416` |
74
+ | 用户状态（getUserStatus / subscribeUserStatus） | `https://cloud.tencent.com/document/product/269/75511` |
75
+ | 好友管理 | `https://cloud.tencent.com/document/product/269/75419` |
76
+ | 好友分组 | `https://cloud.tencent.com/document/product/269/75422` |
77
+ | 用户黑名单 | `https://cloud.tencent.com/document/product/269/75425` |
78
+ | 关注和粉丝 | `https://cloud.tencent.com/document/product/269/105494` |
79
+ | 云端搜索消息（searchCloudMessages） | `https://cloud.tencent.com/document/product/269/115824` |
80
+ | 云端搜索用户（searchUsers） | `https://cloud.tencent.com/document/product/269/115825` |
81
+ | 云端搜索群组（searchGroups） | `https://cloud.tencent.com/document/product/269/115826` |
82
+ | 云端搜索群成员（searchGroupMembers） | `https://cloud.tencent.com/document/product/269/115827` |
83
+ | 本地搜索消息（searchLocalMessages） | `https://cloud.tencent.com/document/product/269/75436` |
84
+ | 本地搜索好友（searchFriends） | `https://cloud.tencent.com/document/product/269/75439` |
85
+ | 本地搜索群组（searchGroups） | `https://cloud.tencent.com/document/product/269/75441` |
86
+ | 本地搜索群成员（searchGroupMembers） | `https://cloud.tencent.com/document/product/269/75443` |
87
+
88
+ ## D — 错误码（SDK 错误码）
89
+
90
+ > 错误码查询策略见 `references/14-official-docs.md §14.4`
91
+
92
+ | 子问题 | 目标文档 |
93
+ |--------|---------|
94
+ | Android SDK 错误码表 | `https://cloud.tencent.com/document/product/269/1671` |
package/knowledge-base/docs/chat/sdk/flutter/faq.md ADDED
@@ -0,0 +1,7 @@
1
+ # Web — 高频问题预检清单
2
+
3
+ > dispatcher 检索前先判断是否属于已知高频问题，可节省一次 flutter 请求。
4
+
5
+ | 高频问题 | 快速答案（预埋） |
6
+ |---------|----------------|
7
+
package/knowledge-base/docs/chat/sdk/flutter/index.md ADDED
@@ -0,0 +1,83 @@
1
+ # Web — SDK 官方文档 URL 映射
2
+
3
+ > 知识咨询时 `read_file` 本文件，按问题匹配领域和子问题，获取目标 URL。检索方式和兜底策略见 `references/14-official-docs.md`。
4
+
5
+ ## A — SDK 集成和初始化（Flutter）
6
+
7
+ | 子问题 | 目标文档 |
8
+ |--------|---------|
9
+ | Flutter SDK 集成 | `https://cloud.tencent.com/document/product/269/75286` |
10
+ | Flutter SDK 初始化 | `https://cloud.tencent.com/document/product/269/75293` |
11
+
12
+ ## B — 多端登录配置与 UserSig 鉴权
13
+
14
+ | 子问题 | 目标文档 |
15
+ |--------|---------|
16
+ | 登录（`login` API） | `https://cloud.tencent.com/document/product/269/75296` |
17
+ | 登出（`logout` API） | `https://cloud.tencent.com/document/product/269/75296` |
18
+
19
+ ## C — SDK API 使用
20
+
21
+ | 子问题 | 目标文档 |
22
+ |--------|---------|
23
+ | SDK 消息类型介绍 | `https://cloud.tencent.com/document/product/269/75674` |
24
+ | 文本消息（createTextMessage → sendMessage） | `https://cloud.tencent.com/document/product/269/75317` |
25
+ | 群 @ 消息（createTextAtMessage → sendMessage） | `https://cloud.tencent.com/document/product/269/75350` |
26
+ | 图片消息（createImageMessage → sendMessage） | `https://cloud.tencent.com/document/product/269/75317` |
27
+ | 语音消息（createSoundMessage → sendMessage） | `https://cloud.tencent.com/document/product/269/75317` |
28
+ | 视频消息（createVideoMessage → sendMessage） | `https://cloud.tencent.com/document/product/269/75317` |
29
+ | 文件消息（createFileMessage → sendMessage） | `https://cloud.tencent.com/document/product/269/75317` |
30
+ | 自定义消息（createCustomMessage → sendMessage） | `https://cloud.tencent.com/document/product/269/75317` |
31
+ | 表情消息（createFaceMessage → sendMessage） | `https://cloud.tencent.com/document/product/269/75315` |
32
+ | 地理位置消息（createLocationMessage → sendMessage） | `https://cloud.tencent.com/document/product/269/75315` |
33
+ | 合并消息（createMergerMessage → sendMessage） | `https://cloud.tencent.com/document/product/269/75326` |
34
+ | 逐条转发消息（createForwardMessage → sendMessage） | `https://cloud.tencent.com/document/product/269/75326` |
35
+ | 发送消息参数配置（sendMessage 参数） | `https://cloud.tencent.com/document/product/269/75317` |
36
+ | 接收消息（addAdvancedMsgListener） | `https://cloud.tencent.com/document/product/269/75320` |
37
+ | 获取历史消息（getC2CHistoryMessageList/getGroupHistoryMessageList/getHistoryMessageList） | `https://cloud.tencent.com/document/product/269/75323` |
38
+ | 修改消息（modifyMessage） | `https://cloud.tencent.com/document/product/269/75329` |
39
+ | 插入消息（insertC2CMessageToLocalStorage/insertGroupMessageToLocalStorage） | `https://cloud.tencent.com/document/product/269/75331` |
40
+ | 删除消息（deleteMessageFromLocalStorage/deleteMessages） | `https://cloud.tencent.com/document/product/269/75334` |
41
+ | 清空消息（clearC2CHistoryMessage/clearGroupHistoryMessage） | `https://cloud.tencent.com/document/product/269/75336` |
42
+ | 撤回消息（revokeMessage） | `https://cloud.tencent.com/document/product/269/75339` |
43
+ | 在线消息 | `https://cloud.tencent.com/document/product/269/75342` |
44
+ | 已读回执（单聊/群聊） | `https://cloud.tencent.com/document/product/269/75345` |
45
+ | 查询消息（findMessages） | `https://cloud.tencent.com/document/product/269/75347` |
46
+ | 群定向消息(createXXXMessage -> createTargetedGroupMessage -> sendMessage) | `https://cloud.tencent.com/document/product/269/75352` |
47
+ | 消息免打扰（setC2CReceiveMessageOpt/setGroupReceiveMessageOpt） | `https://cloud.tencent.com/document/product/269/75355` |
48
+ | 消息扩展（投票/接龙场景） | `https://cloud.tencent.com/document/product/269/83722` |
49
+ | 会话存储限制 | `https://cloud.tencent.com/document/product/269/75365` |
50
+ | 会话列表（getConversationList） | `https://cloud.tencent.com/document/product/269/75368` |
51
+ | 会话资料（getConversation） | `https://cloud.tencent.com/document/product/269/75371` |
52
+ | 会话未读数（getTotalUnreadMessageCount） | `https://cloud.tencent.com/document/product/269/75374` |
53
+ | 置顶会话（pinConversation） | `https://cloud.tencent.com/document/product/269/75377` |
54
+ | 删除会话（deleteConversation） | `https://cloud.tencent.com/document/product/269/75380` |
55
+ | 会话草稿（setConversationDraft） | `https://cloud.tencent.com/document/product/269/75382` |
56
+ | 会话标记（markConversation） | `https://cloud.tencent.com/document/product/269/79694` |
57
+ | 会话分组 | `https://cloud.tencent.com/document/product/269/79695` |
58
+ | 群组类型和不同群类型能力介绍 | `https://cloud.tencent.com/document/product/269/75697` |
59
+ | 普通群管理 | `https://cloud.tencent.com/document/product/269/75396` |
60
+ | 群资料（getGroupsInfo / setGroupInfo） | `https://cloud.tencent.com/document/product/269/75399` |
61
+ | 群成员管理 | `https://cloud.tencent.com/document/product/269/75402` |
62
+ | 群成员资料 | `https://cloud.tencent.com/document/product/269/75405` |
63
+ | 群自定义属性 | `https://cloud.tencent.com/document/product/269/75408` |
64
+ | 社群（Community / 话题） | `https://cloud.tencent.com/document/product/269/75411` |
65
+ | 社群（权限组） | `https://cloud.tencent.com/document/product/269/127846` |
66
+ | 用户资料（getUsersInfo / setSelfInfo） | `https://cloud.tencent.com/document/product/269/75418` |
67
+ | 用户状态（getUserStatus / subscribeUserStatus） | `https://cloud.tencent.com/document/product/269/105469` |
68
+ | 好友管理 | `https://cloud.tencent.com/document/product/269/75421` |
69
+ | 好友分组 | `https://cloud.tencent.com/document/product/269/75424` |
70
+ | 用户黑名单 | `https://cloud.tencent.com/document/product/269/75427` |
71
+ | 关注和粉丝 | `https://cloud.tencent.com/document/product/269/110774` |
72
+ | 本地搜索消息（searchLocalMessages） | `https://cloud.tencent.com/document/product/269/75438` |
73
+ | 本地搜索好友（searchFriends） | `https://cloud.tencent.com/document/product/269/75440` |
74
+ | 本地搜索群组（searchGroups） | `https://cloud.tencent.com/document/product/269/75442` |
75
+ | 本地搜索群成员（searchGroupMembers） | `https://cloud.tencent.com/document/product/269/75444` |
76
+
77
+ ## D — 错误码（SDK 错误码）
78
+
79
+ > 错误码查询策略见 `references/14-official-docs.md §14.4`
80
+
81
+ | 子问题 | 目标文档 |
82
+ |--------|---------|
83
+ | Flutter SDK 错误码表 | `https://cloud.tencent.com/document/product/269/1671` |
package/knowledge-base/docs/chat/sdk/ios/faq.md ADDED
@@ -0,0 +1,7 @@
1
+ # Web — 高频问题预检清单
2
+
3
+ > dispatcher 检索前先判断是否属于已知高频问题，可节省一次 ios 请求。
4
+
5
+ | 高频问题 | 快速答案（预埋） |
6
+ |---------|----------------|
7
+
package/knowledge-base/docs/chat/sdk/ios/index.md ADDED
@@ -0,0 +1,94 @@
1
+ # Web — SDK 官方文档 URL 映射
2
+
3
+ > 知识咨询时 `read_file` 本文件，按问题匹配领域和子问题，获取目标 URL。检索方式和兜底策略见 `references/14-official-docs.md`。
4
+
5
+ ## A — SDK 集成和初始化（iOS）
6
+
7
+ | 子问题 | 目标文档 |
8
+ |--------|---------|
9
+ | iOS SDK 集成 | `https://cloud.tencent.com/document/product/269/75284` |
10
+ | iOS SDK 初始化 | `https://cloud.tencent.com/document/product/269/75291` |
11
+
12
+ ## B — 登录
13
+
14
+ | 子问题 | 目标文档 |
15
+ |--------|---------|
16
+ | 登录（`login` API） | `https://cloud.tencent.com/document/product/269/75294` |
17
+ | 登出（`logout` API） | `https://cloud.tencent.com/document/product/269/75294` |
18
+
19
+ ## C — SDK API 使用
20
+
21
+ | 子问题 | 目标文档 |
22
+ |--------|---------|
23
+ | SDK 消息类型介绍 | `https://cloud.tencent.com/document/product/269/75313` |
24
+ | 文本消息（sendC2CMessage/sendGroupTextMessage） | `https://cloud.tencent.com/document/product/269/75315` |
25
+ | 群 @ 消息（createAtSignedGroupMessage → sendMessage） | `https://cloud.tencent.com/document/product/269/75349` |
26
+ | 图片消息（createImageMessage → sendMessage） | `https://cloud.tencent.com/document/product/269/75315` |
27
+ | 语音消息（createSoundMessage → sendMessage） | `https://cloud.tencent.com/document/product/269/75315` |
28
+ | 视频消息（createVideoMessage → sendMessage） | `https://cloud.tencent.com/document/product/269/75315` |
29
+ | 文件消息（createFileMessage → sendMessage） | `https://cloud.tencent.com/document/product/269/75315` |
30
+ | 自定义消息（sendC2CCustomMessage/sendGroupCustomMessage） | `https://cloud.tencent.com/document/product/269/75315` |
31
+ | 表情消息（createFaceMessage → sendMessage） | `https://cloud.tencent.com/document/product/269/75315` |
32
+ | 地理位置消息（createLocationMessage → sendMessage） | `https://cloud.tencent.com/document/product/269/75315` |
33
+ | 合并消息（createMergerMessage → sendMessage） | `https://cloud.tencent.com/document/product/269/75324` |
34
+ | 逐条转发消息（createForwardMessage → sendMessage） | `https://cloud.tencent.com/document/product/269/75324` |
35
+ | 发送消息参数配置（sendMessage 参数） | `https://cloud.tencent.com/document/product/269/75315` |
36
+ | 接收消息（addSimpleMsgListener/addAdvancedMsgListener） | `https://cloud.tencent.com/document/product/269/75318` |
37
+ | 获取历史消息（getC2CHistoryMessageList/getGroupHistoryMessageList/getHistoryMessageList） | `https://cloud.tencent.com/document/product/269/75321` |
38
+ | 修改消息（modifyMessage） | `https://cloud.tencent.com/document/product/269/75327` |
39
+ | 插入消息（insertC2CMessageToLocalStorage/insertGroupMessageToLocalStorage） | `https://cloud.tencent.com/document/product/269/75330` |
40
+ | 删除消息（deleteMessageFromLocalStorage/deleteMessages） | `https://cloud.tencent.com/document/product/269/75332` |
41
+ | 清空消息（clearC2CHistoryMessage/clearGroupHistoryMessage） | `https://cloud.tencent.com/document/product/269/75335` |
42
+ | 撤回消息（revokeMessage） | `https://cloud.tencent.com/document/product/269/75337` |
43
+ | 在线消息 | `https://cloud.tencent.com/document/product/269/75340` |
44
+ | 已读回执（单聊/群聊） | `https://cloud.tencent.com/document/product/269/75343` |
45
+ | 查询消息（findMessages） | `https://cloud.tencent.com/document/product/269/75346` |
46
+ | 群定向消息 | `https://cloud.tencent.com/document/product/269/75351` |
47
+ | 消息免打扰（setC2CReceiveMessageOpt/setGroupReceiveMessageOpt/setAllReceiveMessageOpt） | `https://cloud.tencent.com/document/product/269/75353` |
48
+ | 消息扩展（投票/接龙场景） | `https://cloud.tencent.com/document/product/269/81038` |
49
+ | 消息回应（表情回应） | `https://cloud.tencent.com/document/product/269/96241` |
50
+ | 消息翻译（translateText） | `https://cloud.tencent.com/document/product/269/85380` |
51
+ | 语音转文字（convertVoiceToText） | `https://cloud.tencent.com/document/product/269/96280` |
52
+ | 消息置顶（pinGroupMessage） | `https://cloud.tencent.com/document/product/269/106050` |
53
+ | 流式消息（V2TIM_ELEM_TYPE_STREAM） | `https://cloud.tencent.com/document/product/269/129557` |
54
+ | 文字转语音 | `https://cloud.tencent.com/document/product/269/131939` |
55
+ | 会话存储限制 | `https://cloud.tencent.com/document/product/269/75363` |
56
+ | 会话列表（getConversationList） | `https://cloud.tencent.com/document/product/269/75366` |
57
+ | 会话资料（getConversation） | `https://cloud.tencent.com/document/product/269/75369` |
58
+ | 会话未读数（getTotalUnreadMessageCount） | `https://cloud.tencent.com/document/product/269/75372` |
59
+ | 置顶会话（pinConversation） | `https://cloud.tencent.com/document/product/269/75375` |
60
+ | 删除会话（deleteConversation） | `https://cloud.tencent.com/document/product/269/75378` |
61
+ | 会话草稿（setConversationDraft） | `https://cloud.tencent.com/document/product/269/75381` |
62
+ | 会话标记（markConversation） | `https://cloud.tencent.com/document/product/269/77389` |
63
+ | 会话分组 | `https://cloud.tencent.com/document/product/269/77392` |
64
+ | 群组类型和不同群类型能力介绍 | `https://cloud.tencent.com/document/product/269/75697` |
65
+ | 普通群管理 | `https://cloud.tencent.com/document/product/269/75395` |
66
+ | 群资料（getGroupsInfo / setGroupInfo） | `https://cloud.tencent.com/document/product/269/75397` |
67
+ | 群成员管理 | `https://cloud.tencent.com/document/product/269/75400` |
68
+ | 群成员资料 | `https://cloud.tencent.com/document/product/269/75403` |
69
+ | 群自定义属性 | `https://cloud.tencent.com/document/product/269/75406` |
70
+ | 群计数器（groupCounter） | `https://cloud.tencent.com/document/product/269/85676` |
71
+ | 社群（Community / 话题） | `https://cloud.tencent.com/document/product/269/75409` |
72
+ | 社群（权限组） | `https://cloud.tencent.com/document/product/269/104417` |
73
+ | 用户资料（getUsersInfo / setSelfInfo） | `https://cloud.tencent.com/document/product/269/75416` |
74
+ | 用户状态（getUserStatus / subscribeUserStatus） | `https://cloud.tencent.com/document/product/269/75511` |
75
+ | 好友管理 | `https://cloud.tencent.com/document/product/269/75419` |
76
+ | 好友分组 | `https://cloud.tencent.com/document/product/269/75422` |
77
+ | 用户黑名单 | `https://cloud.tencent.com/document/product/269/75425` |
78
+ | 关注和粉丝 | `https://cloud.tencent.com/document/product/269/105494` |
79
+ | 云端搜索消息（searchCloudMessages） | `https://cloud.tencent.com/document/product/269/115824` |
80
+ | 云端搜索用户（searchUsers） | `https://cloud.tencent.com/document/product/269/115825` |
81
+ | 云端搜索群组（searchGroups） | `https://cloud.tencent.com/document/product/269/115826` |
82
+ | 云端搜索群成员（searchGroupMembers） | `https://cloud.tencent.com/document/product/269/115827` |
83
+ | 本地搜索消息（searchLocalMessages） | `https://cloud.tencent.com/document/product/269/75436` |
84
+ | 本地搜索好友（searchFriends） | `https://cloud.tencent.com/document/product/269/75439` |
85
+ | 本地搜索群组（searchGroups） | `https://cloud.tencent.com/document/product/269/75441` |
86
+ | 本地搜索群成员（searchGroupMembers） | `https://cloud.tencent.com/document/product/269/75443` |
87
+
88
+ ## D — 错误码（SDK 错误码）
89
+
90
+ > 错误码查询策略见 `references/14-official-docs.md §14.4`
91
+
92
+ | 子问题 | 目标文档 |
93
+ |--------|---------|
94
+ | iOS SDK 错误码表 | `https://cloud.tencent.com/document/product/269/1671` |
package/knowledge-base/docs/chat/sdk/web/faq.md ADDED
@@ -0,0 +1,8 @@
1
+ # Web — 高频问题预检清单
2
+
3
+ > dispatcher 检索前先判断是否属于已知高频问题，可节省一次 web 请求。
4
+
5
+ | 高频问题 | 快速答案（预埋） |
6
+ |---------|----------------|
7
+ | UserSig 是什么 | 用于验证用户身份的签名，由 SDKAppID + SecretKey + UserID 生成，有效期可配 |
8
+