跳转到主要内容
先阅读 适配器 v6 契约。Node.js worker 按 aut_echo 管理双向调用,平台事件和出站 payload 使用标准结构。

创建 worker

保存为 plugin/adapters/adapter_demo_http.js。下面使用 Node.js 22 内置 WebSocket,是生命周期骨架;实现平台处理后再声明对应能力。
每个连接持有独立的账号快照、pending 和取消信号。先处理响应再分派请求,保证 handler 内 await call(...) 时仍能接收响应。平台请求同时设置超时,例如 AbortSignal.any([session.abort.signal, AbortSignal.timeout(10000)])。

实现平台动作

主动上报、自执行发送的 worker 完成四项核心 codec 和 execute 后,将对应 ready 布尔值设为 true,并声明:
在 handleAction 中分派:
  • adapter_codec_resolve_account:检查原始请求与账号索引,返回 { account_id }。
  • adapter_codec_normalize_inbound:返回 { events },使用请求的 instance_id。
  • adapter_codec_build_outbound:检查 params.action 与目标,转换 params.payload;自发送返回 { executor: 'worker', transport: 'ws', await_receipt: false, raw_payload }。
  • adapter_codec_decode_receipt:返回 { matched: false },或回执的 matched、request_id、ok、data。
  • adapter_execute_outbound:按 params.account_id 取凭据,发送 params.raw_payload。平台失败返回 { ok: false, error },成功返回 { ok: true, data }。
按 动作映射实现 sendText、stopTyping 等 worker 动作,能力名和平台 API 名分别处理。

上报事件与游标

按 标准事件构造 events,填入当前账号配置的 instance_id:
超时或断线时不推进游标,重试未确认批次;拒绝时停在缺口前,重试缺口与后续事件。保持事件 ID 和 dedupe_key 稳定。平台 ID 使用字符串,避免超过 JavaScript 安全整数范围。

媒体与回执

媒体使用 MediaRef。需要上传文件时,先检查 session.hostCapabilities.media_resolve,在当前 build 内调用:
execute 分支从自己构造的 raw_payload 读取媒体,保留解析需要的 MediaRef。复用当前 execution_id,不跨执行缓存临时资源。 支持撤回的发送返回:
部分发送失败仍保留成功项。处理 recallMessage 时读取 payload.message_id 和 payload.recall_context。

验证

手动启动需要本机 autClaw 已发现该适配器。正常使用时由“适配器管理”启停。覆盖握手、事件校验、媒体、回执、部分拒绝和断线重连;日志不输出 token 或完整签名。
最后修改于 2026年10月12日