跳转到主要内容
先阅读 适配器 v6 契约。SDK 的 contract 提供 wire 常量和结构体,worker 提供连接、握手、重连、并发处理与主动调用。

创建 worker

保存为 plugin/adapters/adapter_demo_http.go。autClaw 启动时提供内置 SDK 构建依赖,无需在 manifest 声明 SDK dependency。 下面是生命周期骨架。它尚未实现平台协议,因此能力数组为空;实现功能后再增加声明。
Runner 自动写入 contract: "v6" 并把空的能力集合序列化为 []。OnInit 失败时不发 ready。每次重连重新读取配置,平台循环随 Session.Context() 取消。

声明并实现能力

主动上报、自执行发送的 worker 实现四项 codec 和执行动作后,使用:
将它赋给 sdk.Config.Capabilities,在 Handle 中分派: 出站 action 使用 worker 动作表中的名称,例如 sendText、sendTyping;ready 数组使用对应语义能力。handler 返回 error 会自动生成失败信封。

构造与上报事件

以下片段放在平台接收循环中。ID 和文本取自当前账号及平台更新,导入 time:
通知、申请、撤回和支付使用 contract 专用结构,按 规范事件表填充。

解析媒体与返回回执

从 payload.media 或混合消息 items[].media 读取 contract.MediaRef。平台需要上传文件时,在当前 build 或 execute 内调用:
media 是本次待发送的 contract.MediaRef。先检查初始化中的 host_capabilities.media_resolve;在当前执行结束前完成上传,不缓存临时路径。音视频需转换时选择 opus、amr 或 mp4。 支持撤回的发送返回实际成功消息:
拆分发送或部分失败时保留成功项;处理 recallMessage 时读取 payload.message_id 和 payload.recall_context。

并发与持久化

Handle 并发运行,账号快照与平台状态需同步保护。SDK 默认处理并发为 8,主动 pending 上限为 128,调用超时为 15 秒,control 帧上限为 2 MiB。平台 HTTP 调用还需单独设置超时并绑定 context。 使用 session.StorageGet、StorageSet、StorageDelete 保存私有字符串值,键不得为空。游标只在事件确认后持久化。

验证

在 autClaw 源码工作区显式指定适配器与测试文件:
测试文件使用相同构建约束。覆盖事件校验、能力声明、回执、媒体、断线取消和部分拒绝,再在“适配器管理”配置账号并联调。
最后修改于 2026年10月12日