@imweapp/openclaw-imwe 2026.4.12-alpha.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Lark Technologies Pte. Ltd.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,172 @@
+# @openclaw/imwe
+
+imwe 即时通讯渠道插件，AppKey/AppSecret HMAC-SHA256 签名认证，支持多账号、私聊文字消息。
+
+## 目录结构
+
+```
+extensions/imwe/
+├── proto/                        # Protobuf 消息定义（语言无关的契约文件）
+│   ├── PbPacket.proto            # 传输层：PbPacket / PbRequest / PbResponse
+│   ├── PbChatDeliverMsg.proto    # 投递层：PbChatMsgDeliverBody
+│   ├── PbChatMsg.proto           # 信封层：PbChatMsgEnvelope / PbMsgRspBody
+│   ├── PbChatTextContent.proto   # 内容层：PbChatTextContent / BodyRange
+│   ├── PbSingleChatMsg.proto     # 发送层：PbSingleChatMsgReqBody
+│   └── PbBoxPullProto.proto      # 事件箱：PbBoxPullReq / PbBoxPullRsp
+├── index.ts                      # 插件主入口（defineChannelPluginEntry）
+├── setup-entry.ts                # 轻量入口（setup-only 模式）
+├── package.json                  # npm 包配置
+└── src/
+    ├── proto/                    # Protobuf 编解码层（TypeScript）
+    │   ├── codec.ts              # encode/decode 统一导出入口
+    │   ├── registry.ts           # protobufjs 类型注册表（单例）
+    │   ├── proto-types.ts        # decode 结果的 TypeScript 接口（仅用于类型断言）
+    │   ├── inbound.codec.ts      # 入站消息四层解包
+    │   └── send.codec.ts         # 出站消息编码 + 发送响应解码
+    ├── types.ts                  # 类型定义（三层：Config / ImweConfig / ResolvedAccount）
+    ├── accounts.ts               # 账号解析（listAccountIds / resolveImweAccount）
+    ├── config-schema.ts          # Zod 配置 schema
+    ├── api-client.ts             # HTTP API 客户端（签名 + protobuf 传输）
+    ├── monitor.ts                # 事件箱短轮询消息监听器
+    ├── send.ts                   # 发送文字消息（outbound 适配器入口）
+    ├── setup-core.ts             # setup 适配器（openclaw setup imwe）
+    ├── channel.ts                # ChannelPlugin 主对象（组装所有适配器）
+    └── channel.runtime.ts        # 运行时模块统一导出（懒加载目标）
+```
+
+## 认证方式
+
+每次 HTTP 请求携带以下签名头（对应文档 §1）：
+
+```
+X-Api-Key:   <appKey>
+X-Timestamp: <毫秒时间戳>
+X-Signature: Base64(HMAC-SHA256(appSecret, signString))
+```
+
+签名原文（signString）：
+
+```
+{METHOD}&{PATH}&{TIMESTAMP}&{BODY_HASH}
+```
+
+- `METHOD`：HTTP 方法大写，固定为 `POST`
+- `PATH`：请求路径，如 `/api/im/open/bot/sendMessage`
+- `TIMESTAMP`：与 `X-Timestamp` 相同的毫秒时间戳字符串
+- `BODY_HASH`：`hex(SHA-256(body))`，body 为空时对空字符串 `""` 哈希
+
+无需登录流程，无需持久化任何凭证，AppKey/AppSecret 写入 config 即可。
+
+## 数据流
+
+```
+用户消息
+  → imwe 平台
+    → monitor.ts (long polling POST /messages/poll)
+      → channelRuntime.reply.dispatchReply(...)
+        → OpenClaw AI 推理
+          → outbound.sendText(...)
+            → api-client.sendTextMessage (POST /messages/send + HMAC 签名)
+              → imwe 平台 → 用户
+```
+
+## 配置示例
+
+### 单账号
+
+```json
+{
+  "channels": {
+    "imwe": {
+      "apiBaseUrl": "https://api.imwe.example.com",
+      "appKey": "your-app-key",
+      "appSecret": "your-app-secret",
+      "dmPolicy": "pairing"
+    }
+  }
+}
+```
+
+### 多账号
+
+```json
+{
+  "channels": {
+    "imwe": {
+      "apiBaseUrl": "https://api.imwe.example.com",
+      "defaultAccount": "bot1",
+      "accounts": {
+        "bot1": {
+          "appKey": "key-a",
+          "appSecret": "secret-a",
+          "dmPolicy": "pairing"
+        },
+        "bot2": {
+          "appKey": "key-b",
+          "appSecret": "secret-b",
+          "dmPolicy": "allowlist",
+          "allowFrom": ["123456"]
+        }
+      }
+    }
+  }
+}
+```
+
+### 环境变量（单账号 default）
+
+```bash
+IMWE_API_BASE_URL=https://api.imwe.example.com
+IMWE_APP_KEY=your-app-key
+IMWE_APP_SECRET=your-app-secret
+```
+
+## E2EE 端到端加密
+
+单聊消息默认启用 E2EE（端到端加密），与 imwe iOS 客户端完全互通。无需额外配置，插件启动时自动完成密钥协商。
+
+### 安全边界
+
+- **加密范围**：单聊文本 / Markdown / 媒体消息的 `PbChatMsgEnvelope`（含 URL、caption、blurHash 等元数据）均经 E2EE 加密
+- **不在加密范围内**：媒体文件正文（CDN 资源本身以明文上传/下载，仅信令层走 E2EE）；typing signal 保持明文
+- 加解密失败时消息**不会降级为明文**发送或投递
+
+### 本地状态
+
+首次启动时，插件会在以下路径创建 E2EE 状态目录：
+
+```
+~/.openclaw/channel-data/imwe/<accountId>/e2ee/
+├── state.json          # 密钥、session、PreKey 批次等持久化状态
+├── state.json.tmp      # 两阶段写临时文件
+└── state.lock          # proper-lockfile 进程锁
+```
+
+`state.json` 损坏时会自动重命名为 `state.json.corrupt-<timestamp>` 并重新 bootstrap。
+
+### Mock Server（开发/测试）
+
+项目提供了一个轻量 mock E2EE 服务端，用于本地开发与集成测试：
+
+```bash
+# 启动（默认端口 3456）
+node tests/mock-server/server.js
+
+# 自定义端口
+PORT=4000 node tests/mock-server/server.js
+```
+
+mock server 覆盖 `getMe` / `pullMessages` / `sendMessage` + 5 个 E2EE 端点（create / replenish / apply / queryRequireNum / query），状态机行为详见 `tests/mock-server/README.md`。
+
+在集成测试中可 programmatic 引入：
+
+```js
+import { server, PORT, resetState } from './tests/mock-server/server.js';
+```
+
+## 安装与配置
+
+```bash
+openclaw plugins install @openclaw/imwe
+openclaw setup imwe --http-url https://api.imwe.example.com --token <appKey> --private-key <appSecret>
+```

package/index.ts

@@ -0,0 +1,16 @@
+/**
+ * index.ts — 插件主入口（full 模式）
+ *
+ * 使用 defineChannelPluginEntry 定义入口。
+ * AppKey/AppSecret 签名认证无需 runtime 注入，故省略 setRuntime。
+ */
+
+import { defineChannelPluginEntry } from 'openclaw/plugin-sdk/channel-core';
+import { imwePlugin } from './src/channel.js';
+
+export default defineChannelPluginEntry({
+  id: 'imwe',
+  name: 'imwe',
+  description: 'imwe 即时通讯渠道插件，AppKey/AppSecret 签名认证，支持多账号',
+  plugin: imwePlugin,
+});

package/openclaw.plugin.json

@@ -0,0 +1,58 @@
+{
+  "id": "imwe",
+  "channels": ["imwe"],
+  "channelEnvVars": {
+    "imwe": ["IMWE_API_BASE_URL", "IMWE_APP_KEY", "IMWE_APP_SECRET"]
+  },
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "accounts": {
+        "type": "object",
+        "description": "多账号配置，key 为 accountId",
+        "additionalProperties": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "name": { "type": "string" },
+            "enabled": { "type": "boolean" },
+            "apiBaseUrl": { "type": "string" },
+            "appKey": { "type": "string" },
+            "appSecret": { "type": "string" },
+            "dmPolicy": {
+              "type": "string",
+              "enum": ["pairing", "allowlist", "open", "disabled"]
+            },
+            "allowFrom": {
+              "type": "array",
+              "items": { "type": ["string", "number"] }
+            },
+            "pollIntervalMs": {
+              "type": "number",
+              "description": "短轮询间隔（毫秒），默认 3000"
+            }
+          }
+        }
+      },
+      "defaultAccount": { "type": "string" },
+      "name": { "type": "string" },
+      "enabled": { "type": "boolean" },
+      "apiBaseUrl": { "type": "string" },
+      "appKey": { "type": "string" },
+      "appSecret": { "type": "string" },
+      "dmPolicy": {
+        "type": "string",
+        "enum": ["pairing", "allowlist", "open", "disabled"]
+      },
+      "allowFrom": {
+        "type": "array",
+        "items": { "type": ["string", "number"] }
+      },
+      "pollIntervalMs": {
+        "type": "number",
+        "description": "短轮询间隔（毫秒），默认 3000"
+      }
+    }
+  }
+}

package/package.json

@@ -0,0 +1,73 @@
+{
+  "name": "@imweapp/openclaw-imwe",
+  "version": "2026.4.12-alpha.1",
+  "description": "OpenClaw imwe 渠道插件 —— AppKey/AppSecret 签名认证，支持多账号、私聊文字消息",
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "proto/",
+    "src/",
+    "!src/**/*.test.ts",
+    "!src/**/node_modules/",
+    "index.ts",
+    "setup-entry.ts",
+    "openclaw.plugin.json",
+    "README.md"
+  ],
+  "scripts": {
+    "test": "vitest run --config vitest.config.ts",
+    "test:watch": "vitest --config vitest.config.ts"
+  },
+  "dependencies": {
+    "blurhash": "^2.0.5",
+    "proper-lockfile": "^4.1.2",
+    "protobufjs": "^7.4.0",
+    "sharp": "^0.34.5",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "fast-check": "^4.7.0",
+    "vite-plugin-top-level-await": "^1.6.0",
+    "vite-plugin-wasm": "^3.6.0",
+    "vitest": "^3.1.0"
+  },
+  "peerDependencies": {
+    "openclaw": ">=2026.4.11"
+  },
+  "peerDependenciesMeta": {
+    "openclaw": {
+      "optional": true
+    }
+  },
+  "license": "MIT",
+  "openclaw": {
+    "extensions": [
+      "./index.ts"
+    ],
+    "setupEntry": "./setup-entry.ts",
+    "channel": {
+      "id": "imwe",
+      "label": "ImWe",
+      "selectionLabel": "ImWe",
+      "docsPath": "",
+      "docsLabel": "documentation",
+      "blurb": "imwe 即时通讯平台机器人。",
+      "aliases": [
+        "iw"
+      ],
+      "order": 95,
+      "quickstartAllowFrom": true
+    },
+    "install": {
+      "npmSpec": "@imwe/opencalw-imwe",
+      "defaultChoice": "npm",
+      "minHostVersion": ">=2026.4.11"
+    },
+    "compat": {
+      "pluginApi": ">=2026.4.11"
+    }
+  },
+  "gitHead": "0feb00ac2bc3a2bbd3e7a5ade033c5319f574a68"
+}

package/proto/PbBoxPullProto.proto

@@ -0,0 +1,43 @@
+// PbBoxPullProto.proto — 事件箱消息拉取协议
+//
+// 来源：im_proto/Core/PbBoxPullProto.proto（原样拷贝）
+// 插件通过 POST /api/im/open/bot/pullMessages 拉取机器人待处理消息。
+//
+// 请求体：PbBoxPullReq（直接序列化，不包装在 PbPacket 中）
+// 响应体：PbBoxPullRsp
+//
+// 增量拉取流程：
+//   1. 首次：startSeq=0，拉取全部历史消息
+//   2. 收到响应后：若 milestone=true，将 endSeq 落库
+//   3. 下次：startSeq=上次落库的 endSeq+1
+//   4. 若 hasMore=true，立即继续拉取；否则等待轮询间隔
+
+syntax = "proto3";
+
+package proto;
+
+option java_outer_classname = "BoxPullProto";
+option java_package = "com.imwe.im.proto";
+
+// 事件箱拉取请求
+message PbBoxPullReq {
+  string boxId = 1;                  // 事件箱 ID（机器人的 mainAcctId）
+  optional bool onlyLastSeq = 2;     // 仅返回最新序列号（用于初始化游标）
+  optional uint64 startSeq = 3;      // 起始序列号（0=从头同步）
+  optional uint64 endSeq = 4;        // 结束序列号（可选，不填则拉到最新）
+  repeated uint64 excludeSeqs = 5;   // 排除的序列号列表
+  optional uint64 startTime = 6;     // 指定时间后的消息（onlyLastSeq=true 时使用）
+}
+
+// 事件箱拉取响应
+message PbBoxPullRsp {
+  string boxId = 1;              // 事件箱 ID
+  uint64 startSeq = 2;           // 本次同步起始序列号
+  uint64 endSeq = 3;             // 本次同步结束序列号（0=无新消息）
+  bool milestone = 4;            // 是否里程碑（true 时应将 endSeq 落库，下次从 endSeq+1 开始）
+  bool hasMore = 5;              // 是否还有更多数据（true 时应立即继续拉取）
+  repeated PbRequest items = 6;  // 事件列表（每个 item.body 为 PbChatMsgDeliverBody）
+}
+
+// PbRequest 在此文件中引用，需与 PbPacket.proto 中的定义一致
+// protobufjs 加载时会自动合并同名消息，无需重复定义

package/proto/PbChatAudioContent.proto

@@ -0,0 +1,23 @@
+// PbChatAudioContent.proto — 音频消息内容
+//
+// 来源：im_proto/MsgCore/PbChatAudioContent.proto（精简拷贝，保留插件所需字段）
+// 作为 PbChatMsgEnvelope.audioContent（字段4）的消息体。
+
+syntax = "proto3";
+
+package proto;
+
+option java_package = "com.imwe.im.proto";
+
+import "PbChatFileMeta.proto";
+
+message PbChatAudioContent {
+  message AttachmentMeta {
+    string attachmentId = 1;
+    int64 duration = 2;                       // 语音时长（秒）
+    optional PbChatFileMeta fileMeta = 4;     // 音频文件元数据
+  }
+
+  optional AttachmentMeta meta = 1;           // 音频文件信息
+  optional string speech = 2;                 // 语音转文字内容
+}

package/proto/PbChatDeliverMsg.proto

@@ -0,0 +1,38 @@
+// PbChatDeliverMsg.proto — 聊天消息投递体
+//
+// 来源：im_proto/Core/PbChatDeliverMsg.proto（原样拷贝）
+// 服务端向客户端投递消息的统一载体，对所有会话类型通用。
+// PbRequest.body 按 path 反序列化后得到 PbChatMsgDeliverBody。
+
+syntax = "proto3";
+
+package proto;
+
+option java_outer_classname = "ChatDeliverProto";
+option java_package = "com.imwe.im.proto";
+
+// 聊天消息投递body（对客户端投递消息）
+message PbChatMsgDeliverBody {
+  int32 convType = 1;   // 会话类型，单聊/群聊/系统服务号/公众号
+  string fromId = 2;    // 发送方IM账户id
+  string toId = 3;      // 消息接收id，单聊接收账户id/密聊接收账户id/群组id
+  string toAcctId = 4;  // 消息接收者IM账户id：个人投递时是多分ID(imAcctId)；服务号投递时是主账号(mainAcctId)
+  optional string winId = 5; // 窗口id：密聊会话id
+
+  int64 envelopeType = 6;   // 信封类型：1-聊天加密类型信封，2-操作内容信封，3-支付内容信封，4-服务号通知消息
+  string clientMsgId = 7;   // 客户端消息ID
+  int64 clientStamp = 8;    // 客户端消息时间戳
+  string serverMsgId = 9;   // 服务端消息ID
+  int64 serverStamp = 10;   // 服务端处理时间戳
+  bool e2eeFlag = 11;       // 消息e2ee加密开关
+  bytes envelope = 12;      // 消息内容（按envelopeType二次反序列化）
+
+  optional int64 msgAutoDeleteInterval = 13; // 自动删除时间长度配置
+  optional int64 msgTimingDeleteStamp = 14;  // 定时删除时间
+
+  optional string fromE2eeId = 15; // 非必需，发送者端对端设备id
+  optional string toE2eeId = 16;   // 非必需，接收者端对端设备id
+  optional string e2eeSid = 17;    // 非必需，加密通道SessionId
+
+  optional int64 envelopeSubType = 18; // 信封子类型
+}

package/proto/PbChatFileMeta.proto

@@ -0,0 +1,34 @@
+// PbChatFileMeta.proto — 文件元数据
+//
+// 来源：im_proto/MsgCore/PbChatFileMeta.proto（精简拷贝，保留插件所需字段）
+// 包含文件 URL、加密信息、文件类型等元数据，被 PbChatRichMediaContent 和 PbChatAudioContent 引用。
+
+syntax = "proto3";
+
+package proto;
+
+option java_package = "com.imwe.im.proto";
+
+// 文件类型枚举
+enum PbChatFileMetaType {
+  MEDIA_TYPE_UNKNOWN = 0;     // 未知类型
+  MEDIA_TYPE_IMAGE = 1;       // 图片类型，如jpg, png等
+  MEDIA_TYPE_VIDEO = 2;       // 视频类型，如mp4, mov等
+  MEDIA_TYPE_AUDIO = 3;       // 音频类型，如mp3, aac等
+  MEDIA_TYPE_FILE = 4;        // 文件类型，需根据文件后缀名区分具体文件类型
+}
+
+// 文件元数据（上传/下载后的文件信息）
+message PbChatFileMeta {
+  string url = 1;                    // 服务端存储的url
+  bytes key = 2;                     // 加密密钥(Algorithm: kCCAlgorithmAES)
+  bytes iv = 3;                      // 加密密钥(Algorithm: AES/CTR)
+  string fileType = 4;               // 文件类型(jpg, png, mp4, mp3等)
+  string digest = 5;                 // 文件摘要(用于文件校验)
+  int64 length = 6;                  // 密文长度
+  int64 plaintextLength = 7;         // 明文长度
+  int64 expireTime = 8;              // 过期时间，单位：毫秒
+  string attachmentId = 9;
+  PbChatFileMetaType mediaType = 10; // 1: 图片，2: 视频，3: 音频
+  string opCreds = 11;               // 操作凭证，单聊文件上传时由服务端返回，接收方下载后用于回调删除
+}

package/proto/PbChatMsg.proto

@@ -0,0 +1,93 @@
+// PbChatMsg.proto — 聊天消息信封定义
+//
+// 来源：im_proto/Core/PbChatMsg.proto（精简拷贝，仅保留插件所需消息）
+// 插件处理 envelopeType=1（PbChatMsgEnvelope）中的文本消息（textContent 字段3）、
+// 音频消息（audioContent 字段4）、图片/视频消息（richMediaContent 字段9）、文件消息（fileContent 字段13）。
+// 其他 oneof 分支（callContent 等）保留字段号定义，解码时跳过。
+//
+// 注意：原始文件 import 了大量其他 proto，此处仅保留插件实际用到的消息定义，
+// 未用到的消息类型（callContent 等）以 bytes 占位，不影响字段编号。
+
+syntax = "proto3";
+
+package proto;
+
+import "PbChatTextContent.proto";
+import "PbChatAudioContent.proto";
+import "PbChatRichMediaContent.proto";
+import "PbMarkdownContent.proto";
+import "PbMsgReadStampContent.proto";
+
+option java_outer_classname = "ChatMessageProto";
+option java_package = "com.imwe.im.proto";
+
+// 聊天消息信封（envelopeType=1）
+// PbChatMsgDeliverBody.envelope 按 envelopeType=1 反序列化后得到此消息。
+message PbChatMsgEnvelope {
+  optional bytes senderKey = 1;      // 群聊senderKey消息
+  optional int32 autoDeleteType = 2; // 阅后即焚类型：0（默认），1（火焰）
+
+  // oneof envelope — 13种消息内容，插件处理 textContent/audioContent/richMediaContent/fileContent
+  // 其余字段保留编号，解码时遇到会被 protobufjs 跳过（unknown field）
+  oneof envelope {
+    PbChatTextContent textContent = 3;              // 文本消息内容（插件处理）
+    PbChatAudioContent audioContent = 4;            // 语音消息（插件处理）
+    bytes callContent = 5;                          // 音视频呼叫（占位，不解析）
+    bytes businessCardContent = 6;                  // 个人名片（占位，不解析）
+    bytes forwardContent = 7;                       // 合并转发（占位，不解析）
+    bytes emoteContent = 8;                         // 表情消息（占位，不解析）
+    PbChatRichMediaContent richMediaContent = 9;    // 图片/视频（插件处理）
+    bytes locationRequestContent = 10;              // 位置请求（占位，不解析）
+    bytes locationContent = 11;                     // 位置消息（占位，不解析）
+    bytes groupInviteContent = 12;                  // 群邀请（占位，不解析）
+    PbChatRichMediaContent fileContent = 13;        // 文件消息（插件处理）
+    bytes aiNoteSummaryContent = 14;                // AI笔记总结（占位，不解析）
+    bytes interactiveContent = 15;                  // 互动消息（占位，不解析）
+    PbMarkdownContent markdownContent = 16;         // Markdown 消息内容（插件处理）
+  }
+}
+
+// 消息响应（服务端返回给客户端的发送结果）
+message PbMsgRspBody {
+  string clientMsgId = 1; // 客户端消息ID
+  int64 clientStamp = 2;  // 客户端消息时间戳
+  string serverMsgId = 3; // 服务端消息ID
+  int64 serverStamp = 4;  // 服务端处理时间戳
+}
+
+// 操作消息信封（envelopeType=2）
+// PbSingleChatMsgReqBody.envelope 按 envelopeType=2 序列化后得到此消息。
+// 字段号与 docs/im_proto/MsgCore/PbChatMsg.proto 中的 PbChatOperationEnvelope 一致。
+// 插件仅处理 botThinking（字段9），其余操作类型以 bytes 占位。
+message PbChatOperationEnvelope {
+  oneof content {
+    bytes msgRecall = 1;                    // 消息撤回（占位，不解析）
+    bytes bidirectionalDelete = 2;          // 双向删除（占位，不解析）
+    bytes bidirectionalDeleteAnswer = 3;    // 双向删除回复（占位，不解析）
+    bytes announcement = 4;                 // 群公告（占位，不解析）
+    PbMessageDecryptErrorSendContent decryptError = 5; // 单聊解密失败回执信令（插件处理）
+    bytes groupDecryptError = 6;            // 群聊解密失败（占位，不解析）
+    PbMsgReadStampSendContent msgRead = 7;  // 消息已读
+    bytes msgArrived = 8;                   // 消息已送达（占位，不解析）
+    PbBotThinkingSignal botThinking = 9;    // Bot thinking 信号（插件处理）
+  }
+}
+
+// Bot thinking 信号
+// status: 1=begin（开始输入），2=end（结束输入）
+// botImAcctId: Bot 的 imAcctId，标识哪个 bot 正在输入
+message PbBotThinkingSignal {
+  int32 status = 1;         // 1=begin, 2=end
+  string botImAcctId = 2;   // Bot 的 imAcctId
+}
+
+// 单聊解密失败信令内容（envelopeType=2 / oneof content case 5）
+// 本端对收到的加密单聊消息解密失败时，回发给原发送方。
+// 字段方向语义：由"信令发送方"视角填充：
+//   - e2eeId：信令发送方自己（= 解密失败消息的接收者设备）
+//   - otherE2eeId：失败消息的原发送方（= 信令接收方，应 == 对方 local.e2eeId）
+message PbMessageDecryptErrorSendContent {
+  string clientMsgId = 1;   // 失败的那条消息的 clientMsgId
+  string e2eeId = 2;        // 信令发送方自己的 e2eeId
+  string otherE2eeId = 3;   // 失败消息的原发送方 e2eeId
+}

package/proto/PbChatRichMediaContent.proto

@@ -0,0 +1,31 @@
+// PbChatRichMediaContent.proto — 图片/视频/文件混合消息内容
+//
+// 来源：im_proto/MsgCore/PbChatRichMediaContent.proto（精简拷贝，保留插件所需字段）
+// 作为 PbChatMsgEnvelope.richMediaContent（字段9）和 fileContent（字段13）的消息体。
+
+syntax = "proto3";
+
+package proto;
+
+option java_package = "com.imwe.im.proto";
+
+import "PbChatFileMeta.proto";
+
+message PbChatRichMediaContent {
+  message AttachmentMeta {
+    string attachmentId = 1;
+    PbChatFileMetaType mediaType = 2;        // 文件类型，1: 图片，2: 视频
+    optional PbChatFileMeta fileMeta = 3;     // 媒体文件元数据
+    optional int64 width = 4;                 // 宽度（像素）
+    optional int64 height = 5;                // 高度（像素）
+    optional string blurHash = 6;             // 模糊哈希（仅图片和视频截图）
+    optional int64 duration = 8;              // 视频时长（秒）
+    optional AttachmentMeta snapshot = 9;     // 视频缩略图
+    optional string caption = 11;             // 文字描述
+    optional string fileName = 13;            // 文件名
+    optional int64 fileSize = 14;             // 文件大小（字节）
+  }
+
+  repeated AttachmentMeta meta = 1;
+  optional string caption = 2;               // 文字描述
+}

package/proto/PbChatTextContent.proto

@@ -0,0 +1,38 @@
+// PbChatTextContent.proto — 文本消息内容
+//
+// 来源：im_proto/Core/PbChatTextContent.proto（原样拷贝）
+// 文本消息内容，作为 PbChatMsgEnvelope.textContent（字段3）的消息体。
+
+syntax = "proto3";
+
+package proto;
+
+option java_package = "com.imwe.im.proto";
+
+// 精确表示消息正文（content）中某一段字符范围，比如@，超链接、格式化文字等
+message BodyRange {
+  // 消息正文范围类型
+  enum BodyRangeKey {
+    UNKNOWN = 0;
+    AT_USER = 1;
+    LINK = 2;
+  }
+
+  BodyRangeKey key = 1;     // 例如 @、超链接 等
+  string payload = 2;       // 当key==AT_USER时，value是被@的人的acctId
+  optional int32 start = 3;  // 开始位置，UTF-16 单位
+  optional int32 length = 4; // 长度，UTF-16 单位
+}
+
+// 文本消息内容
+message PbChatTextContent {
+  string text = 1;                          // 文本内容
+  repeated BodyRange bodyRanges = 2;        // 消息正文范围（@、超链接、格式化等）
+  optional string referenceClientMsgId = 3; // 引用消息的clientID
+}
+
+// 文本消息落库的 pb（插件不使用，保留完整性）
+message PbChatTextStoreContent {
+  repeated BodyRange bodyRanges = 1;  // 消息正文范围（@、超链接、格式化等）
+  optional string translation = 2;    // 消息的翻译
+}

package/proto/PbMarkdownContent.proto

@@ -0,0 +1,18 @@
+// PbMarkdownContent.proto — Markdown 消息内容
+//
+// 来源：im_proto/MsgCore/PbMarkdownContent.proto（原样拷贝）
+// 作为 PbChatMsgEnvelope.markdownContent（字段16）的消息体。
+
+syntax = "proto3";
+
+package proto;
+
+option java_package = "com.imwe.im.proto";
+
+// mark消息
+message PbMarkdownContent {
+    // 摘要标题
+    string digest = 1;
+    // markdown内容
+    string markdown = 2;
+}