为 iOS IMKit 安装 rongcloud-im Skill

为 iOS IMKit 安装 rongcloud-im Skill：用 AI 工具（Skill / MCP / 提示词）按融云 iOS IMLib 的接口与约束生成接入代码，减少查文档与试错。

适用场景​

  • 新工程从 0 接入，需要可执行的初始化/连接/消息骨架
  • 存量工程补功能，需要按当前 SDK 版本生成正确签名
  • 团队希望把接入规范固化成可复用的 AI 指令

前置条件​

  • 已拿到 AppKey 与服务端地址（本地联调需可达）
  • 业务服务已能签发用户 Token
  • iOS 13+ / Xcode 15+，工程可编译

融云行为（对照）​

融云文档中「为 iOS IMKit 安装 rongcloud-im Skill」提供完整的页面/流程说明（原文见 ios-imkit/build-with-ai/install-skills）；其能力通常由 IMLib + 服务端或其他产品组件共同实现。

我们的实现与替代​

按「快速开始 → 初始化 → 连接 → 发送消息」的文档步骤人工接入；签名统一从 API 参考页核对。 本页「为 iOS IMKit 安装 rongcloud-im Skill」的替代路径：以 IMLib 已有能力组合实现，具体差异见「与融云对应页 / 差异」与功能列表。

差异与排期​

  • 当前 IMLib 契约未提供该主题的直接 op：AI 集成工具链不改变 IMLib 运行时；本站不提供 Skill/MCP 包本体，只记录等价的人工接入路径。
  • 本站不提供占位/伪造接口；页面只描述可验证的替代路径与需要宿主补齐的部分。
  • 如业务强依赖该能力，建议在服务端/宿主侧实现，并在「功能列表」页登记差异。

迁移建议​

  1. 先按现有 IMLib 能力把核心链路（连接/消息/会话）跑通。
  2. 把该主题拆为「服务端接口 + 客户端展示」两部分，分别排期。
  3. 实现后补充本页的 API、示例与验收用例，并更新功能列表。
不伪造已实现

本页是能力边界说明，不代表 SDK 已提供同名接口；接口面以 API 参考与冻结契约为准。

对应 IMKit 组件​

该主题由 ConversationListView 组件承载（会话列表）。

契约项内容
Propsconversations activeTargetId? theme? options?
Eventsselect longpress refresh
Behaviors排序：置顶优先，其余按 updatedAt 倒序；未读角标：unreadCount>0 显示；>99 显示 99+；mention count 独立角标；免打扰（notificationLevel=2）显示静音图标且不显示红点（保留数字可选）；空闲（无会话）显示空态；加载中显示骨架；点击会话触发 select，宿主负责跳转 ChatView

Swift / Objective-C 接入​

// ConversationListView：为 iOS IMKit 安装 rongcloud-im Skill
let installskillsView = ConversationListView(frame: .zero)
installskillsView.frame = container.bounds
container.addSubview(installskillsView)
// 数据/回调见组件 API：/docs/ios-imkit/components/conversation-list-view

该组件的 Objective-C 入口没有可解析的初始化选择器（绑定声明是说明文本，不是可编译代码），因此不展示 Objective-C 代码块；按下面接入表使用；组件页提供 Objective-C 接入表（helper 组件为 Swift 专用，无独立 ObjC 示例）。

项值
Objective-C 类未导出独立类（使用协议/渲染器）
初始化选择器init
接入方式按 ConversationListView 组件页 的 Objective-C 接入表与渲染器约定接入
组件边界

IMKit 只依赖 IMLib 公开协议与模型；不得在组件层直连传输/存储实现。宿主负责页面导航与权限。

与融云对应页 / 差异​

项内容
融云页面ios-imkit/build-with-ai/install-skills（为 iOS IMKit 安装 rongcloud-im Skill）
融云接口状态边界页（非接口页）
我方对应无直接 op（见差异说明）
差异说明Skill 安装步骤
能力缺口（如实标注）

融云该页描述的能力未完全在 IMLib 102 op / 16 事件中覆盖：Skill 安装步骤。本页不提供伪造接口。

相关错误码​

错误码名称含义处理
1001INVALID_PARAMETER参数错误修正参数/权限后重试
1002INVALID_TOKENToken 无效或已过期修正参数/权限后重试
1007MESSAGE_TOO_LARGE消息体过大（上限 5KB）修正参数/权限后重试
1009GROUP_MUTED你已被禁言修正参数/权限后重试
1010SENSITIVE_WORD内容包含敏感词修正参数/权限后重试
3001SDK_NOT_CONNECTED长连接未就绪可重试（退避）
3002SDK_TIMEOUT请求超时可重试（退避）
3003SDK_NETWORK_ERROR网络错误可重试（退避）

接入检查​

  • 确认已导入 ImpIaaSIMKit 并完成 IMLib 初始化/连接。
  • 组件挂载到宿主 UIView 后，按契约注入数据（props/数据源）并注册事件。
  • 自定义 Cell/菜单时保持消息模型为只读，避免直接修改 SDK 内部状态。

相关页面​