koishi-plugin-dynamic-bot 0.0.4 → 0.0.6

package/lib/dbk/send.d.ts

@@ -12,5 +12,5 @@ export interface SegmentRenderOptions {
     mentionAll?: boolean;
 }
 export declare function sendMessage(ctx: Context, request: SendParams): Promise<SendResult>;
-export declare function segmentsToElements(segments: Segment[], options?: SegmentRenderOptions): El[];
+export declare function segmentsToElements(ctx: Context, segments: Segment[], options?: SegmentRenderOptions): Promise<El[]>;
 export {};

package/lib/index.js

@@ -2817,8 +2817,8 @@ function findFileDependencies(proto, reg) {
     return dep;
   });
 }
-function findEnumSharedPrefix(enumName, values) {
-  const prefix = camelToSnakeCase(enumName) + "_";
+function findEnumSharedPrefix(enumName2, values) {
+  const prefix = camelToSnakeCase(enumName2) + "_";
   for (const value of values) {
     if (!value.name.toLowerCase().startsWith(prefix)) {
       return void 0;
@@ -4577,6 +4577,29 @@ function listValueFromJson(listValue, json, ctx) {
 var file_dbk_v1_common = /* @__PURE__ */ fileDesc("ChNkYmsvdjEvY29tbW9uLnByb3RvEgZkYmsudjEiSAoGVGFyZ2V0EiAKBGtpbmQYASABKA4yEi5kYmsudjEuVGFyZ2V0S2luZBIKCgJpZBgCIAEoCRIQCghndWlsZF9pZBgDIAEoCSI7CghScGNFcnJvchIfCgRjb2RlGAEgASgOMhEuZGJrLnYxLkVycm9yQ29kZRIOCgZkZXRhaWwYAiABKAkqhwEKClRhcmdldEtpbmQSGwoXVEFSR0VUX0tJTkRfVU5TUEVDSUZJRUQQABIUChBUQVJHRVRfS0lORF9VU0VSEAESFQoRVEFSR0VUX0tJTkRfR1JPVVAQAhIXChNUQVJHRVRfS0lORF9DSEFOTkVMEAMSFgoSVEFSR0VUX0tJTkRfVEhSRUFEEAQqdAoJQm90U3RhdHVzEhoKFkJPVF9TVEFUVVNfVU5TUEVDSUZJRUQQABIUChBCT1RfU1RBVFVTX1JFQURZEAESGgoWQk9UX1NUQVRVU19VTkFWQUlMQUJMRRACEhkKFUJPVF9TVEFUVVNfQ09OTkVDVElORxADKocBCgpTZW5kU3RhdHVzEhsKF1NFTkRfU1RBVFVTX1VOU1BFQ0lGSUVEEAASEgoOU0VORF9TVEFUVVNfT0sQARIXChNTRU5EX1NUQVRVU19QQVJUSUFMEAISFwoTU0VORF9TVEFUVVNfVU5LTk9XThADEhYKElNFTkRfU1RBVFVTX0ZBSUxFRBAEKqwBCglFcnJvckNvZGUSGgoWRVJST1JfQ09ERV9VTlNQRUNJRklFRBAAEhsKF0VSUk9SX0NPREVfVU5BVVRIT1JJWkVEEAESFwoTRVJST1JfQ09ERV9QUk9UT0NPTBACEhgKFEVSUk9SX0NPREVfTk9UX0ZPVU5EEAMSGgoWRVJST1JfQ09ERV9VTlNVUFBPUlRFRBAEEhcKE0VSUk9SX0NPREVfSU5URVJOQUwQBSqFAQoNQm90Q2hhbmdlVHlwZRIfChtCT1RfQ0hBTkdFX1RZUEVfVU5TUEVDSUZJRUQQABIZChVCT1RfQ0hBTkdFX1RZUEVfQURERUQQARIbChdCT1RfQ0hBTkdFX1RZUEVfVVBEQVRFRBACEhsKF0JPVF9DSEFOR0VfVFlQRV9SRU1PVkVEEANiBnByb3RvMw");
 var TargetSchema = /* @__PURE__ */ messageDesc(file_dbk_v1_common, 0);
 var RpcErrorSchema = /* @__PURE__ */ messageDesc(file_dbk_v1_common, 1);
+var TargetKind = /* @__PURE__ */ ((TargetKind2) => {
+  TargetKind2[TargetKind2["UNSPECIFIED"] = 0] = "UNSPECIFIED";
+  TargetKind2[TargetKind2["USER"] = 1] = "USER";
+  TargetKind2[TargetKind2["GROUP"] = 2] = "GROUP";
+  TargetKind2[TargetKind2["CHANNEL"] = 3] = "CHANNEL";
+  TargetKind2[TargetKind2["THREAD"] = 4] = "THREAD";
+  return TargetKind2;
+})(TargetKind || {});
+var BotStatus = /* @__PURE__ */ ((BotStatus2) => {
+  BotStatus2[BotStatus2["UNSPECIFIED"] = 0] = "UNSPECIFIED";
+  BotStatus2[BotStatus2["READY"] = 1] = "READY";
+  BotStatus2[BotStatus2["UNAVAILABLE"] = 2] = "UNAVAILABLE";
+  BotStatus2[BotStatus2["CONNECTING"] = 3] = "CONNECTING";
+  return BotStatus2;
+})(BotStatus || {});
+var SendStatus = /* @__PURE__ */ ((SendStatus2) => {
+  SendStatus2[SendStatus2["UNSPECIFIED"] = 0] = "UNSPECIFIED";
+  SendStatus2[SendStatus2["OK"] = 1] = "OK";
+  SendStatus2[SendStatus2["PARTIAL"] = 2] = "PARTIAL";
+  SendStatus2[SendStatus2["UNKNOWN"] = 3] = "UNKNOWN";
+  SendStatus2[SendStatus2["FAILED"] = 4] = "FAILED";
+  return SendStatus2;
+})(SendStatus || {});
 var ErrorCode = /* @__PURE__ */ ((ErrorCode2) => {
   ErrorCode2[ErrorCode2["UNSPECIFIED"] = 0] = "UNSPECIFIED";
   ErrorCode2[ErrorCode2["UNAUTHORIZED"] = 1] = "UNAUTHORIZED";
@@ -4586,6 +4609,13 @@ var ErrorCode = /* @__PURE__ */ ((ErrorCode2) => {
   ErrorCode2[ErrorCode2["INTERNAL"] = 5] = "INTERNAL";
   return ErrorCode2;
 })(ErrorCode || {});
+var BotChangeType = /* @__PURE__ */ ((BotChangeType2) => {
+  BotChangeType2[BotChangeType2["UNSPECIFIED"] = 0] = "UNSPECIFIED";
+  BotChangeType2[BotChangeType2["ADDED"] = 1] = "ADDED";
+  BotChangeType2[BotChangeType2["UPDATED"] = 2] = "UPDATED";
+  BotChangeType2[BotChangeType2["REMOVED"] = 3] = "REMOVED";
+  return BotChangeType2;
+})(BotChangeType || {});
 
 // src/gen/dbk/v1/rpc_pb.ts
 var file_dbk_v1_rpc = /* @__PURE__ */ fileDesc("ChBkYmsvdjEvcnBjLnByb3RvEgZkYmsudjEiTAoMSGVsbG9SZXF1ZXN0Eg0KBXRva2VuGAEgASgJEhMKC2FwcF92ZXJzaW9uGAIgASgJEhgKEHByb3RvY29sX3ZlcnNpb24YAyABKAkiXQoNSGVsbG9SZXNwb25zZRIYChBwcm90b2NvbF92ZXJzaW9uGAEgASgJEhcKD2dhdGV3YXlfdmVyc2lvbhgCIAEoCRIZCgRib3RzGAMgAygLMgsuZGJrLnYxLkJvdCIRCg9MaXN0Qm90c1JlcXVlc3QiLQoQTGlzdEJvdHNSZXNwb25zZRIZCgRib3RzGAEgAygLMgsuZGJrLnYxLkJvdCKMAQoDQm90Eg8KB2JvdF9rZXkYASABKAkSEAoIcGxhdGZvcm0YAiABKAkSDwoHc2VsZl9pZBgDIAEoCRIMCgRuYW1lGAQgASgJEg4KBmF2YXRhchgFIAEoCRIhCgZzdGF0dXMYBiABKA4yES5kYmsudjEuQm90U3RhdHVzEhAKCGZlYXR1cmVzGAcgAygJIlAKD0JvdENoYW5nZWRFdmVudBIjCgR0eXBlGAEgASgOMhUuZGJrLnYxLkJvdENoYW5nZVR5cGUSGAoDYm90GAIgASgLMgsuZGJrLnYxLkJvdCJHChJMaXN0VGFyZ2V0c1JlcXVlc3QSDwoHYm90X2tleRgBIAEoCRIgCgRraW5kGAIgASgOMhIuZGJrLnYxLlRhcmdldEtpbmQiTgoTTGlzdFRhcmdldHNSZXNwb25zZRIjCgd0YXJnZXRzGAEgAygLMhIuZGJrLnYxLlRhcmdldEluZm8SEgoKaW5jb21wbGV0ZRgCIAEoCCJDChBHZXRUYXJnZXRSZXF1ZXN0Eg8KB2JvdF9rZXkYASABKAkSHgoGdGFyZ2V0GAIgASgLMg4uZGJrLnYxLlRhcmdldCJLChFHZXRUYXJnZXRSZXNwb25zZRIiCgZ0YXJnZXQYASABKAsyEi5kYmsudjEuVGFyZ2V0SW5mbxISCgp1bnJlc29sdmVkGAIgASgIIoIBCgpUYXJnZXRJbmZvEh4KBnRhcmdldBgBIAEoCzIOLmRiay52MS5UYXJnZXQSDAoEbmFtZRgCIAEoCRIQCghndWlsZF9pZBgDIAEoCRISCgpndWlsZF9uYW1lGAQgASgJEhAKCGJvdF9rZXlzGAUgAygJEg4KBmF2YXRhchgGIAEoCSJ7CgpTZW5kUGFyYW1zEg8KB2JvdF9rZXkYASABKAkSHgoGdGFyZ2V0GAIgASgLMg4uZGJrLnYxLlRhcmdldBIbChNyZXBseV90b19tZXNzYWdlX2lkGAMgASgJEh8KBXVuaXRzGAQgAygLMhAuZGJrLnYxLlNlbmRVbml0ImAKCFNlbmRVbml0EiQKBm5vcm1hbBgBIAEoCzISLmRiay52MS5Ob3JtYWxVbml0SAASJgoHZm9yd2FyZBgCIAEoCzITLmRiay52MS5Gb3J3YXJkVW5pdEgAQgYKBGJvZHkiLwoKTm9ybWFsVW5pdBIhCghzZWdtZW50cxgBIAMoCzIPLmRiay52MS5TZWdtZW50IjEKC0ZvcndhcmRVbml0EiIKBW5vZGVzGAEgAygLMhMuZGJrLnYxLkZvcndhcmROb2RlIn0KC0ZvcndhcmROb2RlEhEKCXNlbmRlcl9pZBgBIAEoCRITCgtzZW5kZXJfbmFtZRgCIAEoCRIVCg1zZW5kZXJfYXZhdGFyGAMgASgJEgwKBHRpbWUYBCABKAMSIQoIc2VnbWVudHMYBSADKAsyDy5kYmsudjEuU2VnbWVudCL/AgoHU2VnbWVudBIjCgR0ZXh0GAEgASgLMhMuZGJrLnYxLlRleHRTZWdtZW50SAASJQoFaW1hZ2UYAiABKAsyFC5kYmsudjEuSW1hZ2VTZWdtZW50SAASJQoFdmlkZW8YAyABKAsyFC5kYmsudjEuVmlkZW9TZWdtZW50SAASJQoFYXVkaW8YBCABKAsyFC5kYmsudjEuQXVkaW9TZWdtZW50SAASKQoHbWVudGlvbhgFIAEoCzIWLmRiay52MS5NZW50aW9uU2VnbWVudEgAEjAKC21lbnRpb25fYWxsGAYgASgLMhkuZGJrLnYxLk1lbnRpb25BbGxTZWdtZW50SAASJQoFcmVwbHkYByABKAsyFC5kYmsudjEuUmVwbHlTZWdtZW50SAASIwoEbGluaxgIIAEoCzITLmRiay52MS5MaW5rU2VnbWVudEgAEikKB3Vua25vd24YCSABKAsyFi5kYmsudjEuVW5rbm93blNlZ21lbnRIAEIGCgRib2R5IhsKC1RleHRTZWdtZW50EgwKBHRleHQYASABKAkiNgoMSW1hZ2VTZWdtZW50EgsKA3VyaRgBIAEoCRIMCgRmaWxlGAIgASgJEgsKA2FsdBgDIAEoCSI2CgxWaWRlb1NlZ21lbnQSCwoDdXJpGAEgASgJEgwKBGZpbGUYAiABKAkSCwoDYWx0GAMgASgJIjYKDEF1ZGlvU2VnbWVudBILCgN1cmkYASABKAkSDAoEZmlsZRgCIAEoCRILCgNhbHQYAyABKAkiHAoOTWVudGlvblNlZ21lbnQSCgoCaWQYASABKAkiEwoRTWVudGlvbkFsbFNlZ21lbnQiIgoMUmVwbHlTZWdtZW50EhIKCm1lc3NhZ2VfaWQYASABKAkiKQoLTGlua1NlZ21lbnQSCwoDdXJsGAEgASgJEg0KBXRpdGxlGAIgASgJIisKDlVua25vd25TZWdtZW50EgwKBHR5cGUYASABKAkSCwoDcmF3GAIgASgJInoKClNlbmRSZXN1bHQSIgoGc3RhdHVzGAEgASgOMhIuZGJrLnYxLlNlbmRTdGF0dXMSDgoGcmVhc29uGAIgASgJEhEKCXJldHJ5YWJsZRgDIAEoCBIlCghyZWNlaXB0cxgEIAMoCzITLmRiay52MS5TZW5kUmVjZWlwdCI1CgtTZW5kUmVjZWlwdBISCgptZXNzYWdlX2lkGAEgASgJEhIKCnJlY2FsbGFibGUYAiABKAgiUwoMUmVjYWxsUGFyYW1zEg8KB2JvdF9rZXkYASABKAkSHgoGdGFyZ2V0GAIgASgLMg4uZGJrLnYxLlRhcmdldBISCgptZXNzYWdlX2lkGAMgASgJIlUKDFJlY2FsbFJlc3VsdBIiCgZzdGF0dXMYASABKA4yEi5kYmsudjEuU2VuZFN0YXR1cxIOCgZyZWFzb24YAiABKAkSEQoJcmV0cnlhYmxlGAMgASgIIvsBCg9JbmNvbWluZ01lc3NhZ2USDwoHYm90X2tleRgBIAEoCRIQCghwbGF0Zm9ybRgCIAEoCRIeCgZ0YXJnZXQYAyABKAsyDi5kYmsudjEuVGFyZ2V0EhEKCXNlbmRlcl9pZBgEIAEoCRISCgptZXNzYWdlX2lkGAUgASgJEhEKCXRpbWVzdGFtcBgGIAEoAxIMCgR0ZXh0GAcgASgJEhsKE3JlcGx5X3RvX21lc3NhZ2VfaWQYCCABKAkSEAoIbWVudGlvbnMYCSADKAkSIQoIc2VnbWVudHMYCiADKAsyDy5kYmsudjEuU2VnbWVudBILCgNyYXcYCyABKAliBnByb3RvMw", [file_dbk_v1_common]);
@@ -5001,8 +5031,12 @@ var DbkGatewaySession = class {
     this.fail("DBK frame could not be decoded");
   }
   emit(method, event) {
-    if (!this.isHandshook) return;
+    if (!this.isHandshook) {
+      this.options.logger.debug("drop EVENT before handshake: method=%s", method);
+      return;
+    }
     this.seq += 1n;
+    this.options.logger.debug("DBK EVENT %s seq=%s", method, this.seq.toString());
     this.enqueueFrame(
       createFrame({
         op: 4 /* EVENT */,
@@ -5056,6 +5090,7 @@ var DbkGatewaySession = class {
       this.replyError(frame.id, 4 /* UNSUPPORTED */, `unknown method: ${frame.method}`);
       return;
     }
+    this.options.logger.debug("DBK CALL %s id=%s", frame.method, frame.id);
     try {
       const payload = await this.dispatchCall(frame.method, frame.payload);
       this.enqueueFrame(
@@ -5217,11 +5252,19 @@ var DbkGateway = class {
     return this.session?.isHandshook ?? false;
   }
   emit(method, event) {
-    this.session?.emit(method, event);
+    if (!this.session) {
+      this.ctx.logger.debug("drop EVENT without session: method=%s", method);
+      return;
+    }
+    this.session.emit(method, event);
   }
   startForward() {
     const path = normalizePath(this.config.path);
-    this.ctx.logger.info("DBK forward WebSocket mounted on Koishi HTTP at %s", path);
+    this.ctx.logger.info(
+      "DBK forward WebSocket mounted on Koishi HTTP at %s encoding=%s",
+      path,
+      this.config.encoding
+    );
     this.ctx.server.ws(path, (socket) => {
       this.attach("replaced", socket);
     });
@@ -5237,11 +5280,16 @@ var DbkGateway = class {
     this.session = void 0;
     this.socket?.close(1e3, "plugin stop");
     this.socket = void 0;
+    this.ctx.logger.debug("DBK gateway stopped");
   }
   connectReverse() {
     if (this.closing) return;
     const url = `ws://${this.config.host}:${this.config.port}`;
-    this.ctx.logger.info("DBK reverse WebSocket connecting to %s", url);
+    this.ctx.logger.info(
+      "DBK reverse WebSocket connecting to %s encoding=%s",
+      url,
+      this.config.encoding
+    );
     const socket = this.ctx.http.ws(url);
     const onOpen = () => {
       this.reconnectAttempts = 0;
@@ -5279,6 +5327,7 @@ var DbkGateway = class {
     });
     this.session = session;
     attachSocket(socket, session, this.config.encoding);
+    this.ctx.logger.debug("DBK connection attached encoding=%s", this.config.encoding);
   }
   onReverseClosed() {
     this.session?.close("ws close");
@@ -5302,9 +5351,16 @@ var DbkGateway = class {
 function watchBots(ctx, gateway) {
   const emit = (type, bot) => {
     if (bot.hidden && type !== 3 /* REMOVED */) return;
+    const mapped = toDbkBot(bot);
+    ctx.logger.debug(
+      "bot.changed: %s %s status=%s",
+      BotChangeType[type] ?? type,
+      mapped.botKey || "-",
+      BotStatus[mapped.status] ?? mapped.status
+    );
     gateway.emit(DbkEvent.BOT_CHANGED, create(BotChangedEventSchema, {
       type,
-      bot: toDbkBot(bot)
+      bot: mapped
     }));
   };
   ctx.on("bot-added", (bot) => emit(1 /* ADDED */, bot));
@@ -5383,12 +5439,26 @@ async function getTarget(ctx, request) {
       throw new DbkRpcError(3 /* NOT_FOUND */, `bot not found: ${botKey}`);
     }
     const info = await resolveOnBot(bot, target);
-    return info ? resolved(info) : unresolved(target);
+    if (info) {
+      ctx.logger.debug("targets.get: resolved on %s kind=%s id=%s", botKey, TargetKind[info.target?.kind ?? 0], info.target?.id);
+      return resolved(info);
+    }
+    ctx.logger.debug("targets.get: unresolved on %s id=%s", botKey, target?.id.trim() || "-");
+    return unresolved(target);
   }
   for (const bot of listSearchableBots(ctx)) {
     const info = await resolveOnBot(bot, target);
-    if (info) return resolved(info);
+    if (info) {
+      ctx.logger.debug(
+        "targets.get: resolved on %s kind=%s id=%s",
+        botKeyOf(bot),
+        TargetKind[info.target?.kind ?? 0],
+        info.target?.id
+      );
+      return resolved(info);
+    }
   }
+  ctx.logger.debug("targets.get: unresolved id=%s", target?.id.trim() || "-");
   return unresolved(target);
 }
 function findBot(ctx, botKey) {
@@ -5567,7 +5637,10 @@ async function listTargets(ctx, request) {
   const merged = /* @__PURE__ */ new Map();
   let incomplete = false;
   for (const bot of bots) {
-    if (isQq(bot)) continue;
+    if (isQq(bot)) {
+      ctx.logger?.debug("targets.list: skip qq bot %s", botKeyOf2(bot));
+      continue;
+    }
     const listed = await listTargetsForBot(ctx, bot, kindFilter);
     incomplete = incomplete || listed.incomplete;
     for (const target of listed.targets) {
@@ -5616,6 +5689,12 @@ async function listTargetsForBot(ctx, bot, kindFilter) {
   const nested = hasNestedChannels(bot);
   const supported = botTargetKinds(bot);
   if (kindFilter !== 0 /* UNSPECIFIED */ && supported.length > 0 && !supported.includes(kindFilter)) {
+    ctx.logger?.debug(
+      "targets.list: %s skip kind=%s supported=%s",
+      botKey,
+      TargetKind[kindFilter] ?? kindFilter,
+      supported.map((kind) => TargetKind[kind] ?? kind).join(",")
+    );
     return { targets, incomplete: false };
   }
   let incomplete = hasGuildSurface(bot) && !nested;
@@ -5625,7 +5704,12 @@ async function listTargetsForBot(ctx, bot, kindFilter) {
     const guilds = await paginate((next) => callBotList(bot, "getGuildList", next));
     if (guilds.unsupported || guilds.failed || guilds.truncated) incomplete = true;
     if (guilds.failed && !guilds.unsupported) {
-      ctx.logger?.debug("targets.list: %s getGuildList failed", botKey);
+      ctx.logger?.debug(
+        "targets.list: %s getGuildList failed items=%d truncated=%s",
+        botKey,
+        guilds.items.length,
+        guilds.truncated
+      );
     }
     let channelMode = nested ? "unknown" : "flat";
     for (const guild of guilds.items) {
@@ -5694,6 +5778,13 @@ async function listTargetsForBot(ctx, bot, kindFilter) {
       incomplete = true;
     }
   }
+  ctx.logger?.debug(
+    "targets.list: %s listed=%d incomplete=%s nested=%s",
+    botKey,
+    targets.length,
+    incomplete,
+    nested
+  );
   return { targets, incomplete };
 }
 function classifyGuildChannels(channels, guildId, guildName, guildAvatar, botKey) {
@@ -5938,15 +6029,24 @@ async function recallMessage(ctx, params) {
   if (!channelId) {
     return failed("target id is empty", false);
   }
+  ctx.logger.debug("message.recall: deleteMessage channel=%s message=%s", channelId, messageId);
   try {
     await withTimeout(Promise.resolve(bot.deleteMessage(channelId, messageId)), RECALL_TIMEOUT_MS);
+    ctx.logger.debug("message.recall: adapter ok");
     return create(RecallResultSchema, {
       status: 1 /* OK */,
       reason: "",
       retryable: false
     });
   } catch (error) {
-    return classifyRecallError(error);
+    const result = classifyRecallError(error);
+    ctx.logger.debug(
+      "message.recall: adapter error status=%s retryable=%s: %s",
+      SendStatus[result.status] ?? result.status,
+      result.retryable,
+      result.reason || errorMessage(error) || "message.recall failed"
+    );
+    return result;
   }
 }
 function findBot3(ctx, botKey) {
@@ -6086,6 +6186,11 @@ function withTimeout(promise, ms) {
 var import_koishi = require("koishi");
 var SEND_TIMEOUT_MS = 25e3;
 var MENTION_ALL_FALLBACK = "@\u5168\u4F53\u6210\u5458";
+var MEDIA_FALLBACK_TYPE = {
+  image: "image/png",
+  video: "video/mp4",
+  audio: "audio/mpeg"
+};
 async function sendMessage(ctx, request) {
   const bot = findBot4(ctx, request.botKey);
   if (!bot) {
@@ -6123,20 +6228,29 @@ async function sendMessage(ctx, request) {
   const sendElements = async (elements) => {
     if (aborted) return;
     if (elements.length === 0) {
+      ctx.logger.debug("message.send: no sendable segments");
       failuresRetryable = false;
       failures.push("no sendable segments");
       return;
     }
     const outgoing = withQuote(elements, nextQuoteId());
+    ctx.logger.debug(
+      "message.send: bot.sendMessage channel=%s guild=%s elements=%d",
+      channelId,
+      guildId || "-",
+      outgoing.length
+    );
     try {
       const ids = await bot.sendMessage(channelId, outgoing, guildId);
       if (aborted) return;
       quoteUsed = true;
       const kept = normalizeMessageIds(ids);
       if (kept.length === 0) {
+        ctx.logger.debug("message.send: adapter returned no message id");
         unknownReasons.push("send returned no message id");
         return;
       }
+      ctx.logger.debug("message.send: adapter ids=%s", kept.join(","));
       for (const messageId of kept) {
         receipts.push(create(SendReceiptSchema, { messageId, recallable }));
       }
@@ -6144,19 +6258,46 @@ async function sendMessage(ctx, request) {
       if (aborted) return;
       if (isTimeoutError(error)) {
         quoteUsed = true;
-        unknownReasons.push(errorMessage2(error) || "send timed out");
+        const reason = errorMessage2(error) || "send timed out";
+        ctx.logger.debug("message.send: adapter timeout: %s", reason);
+        unknownReasons.push(reason);
         return;
       }
       const retryable = isRetryableSendError(error);
+      ctx.logger.debug(
+        "message.send: adapter error retryable=%s: %s",
+        retryable,
+        errorMessage2(error) || "send failed"
+      );
       failuresRetryable = failuresRetryable && retryable;
       failures.push(errorMessage2(error) || "send failed");
     }
   };
+  const sendRendered = async (render) => {
+    if (aborted) return;
+    let elements;
+    try {
+      elements = await render;
+    } catch (error) {
+      if (aborted) return;
+      if (isTimeoutError(error)) {
+        const reason = errorMessage2(error) || "media fetch timed out";
+        ctx.logger.debug("message.send: media timeout: %s", reason);
+        unknownReasons.push(reason);
+        return;
+      }
+      ctx.logger.debug("message.send: media error: %s", errorMessage2(error) || "media fetch failed");
+      failuresRetryable = failuresRetryable && isRetryableSendError(error);
+      failures.push(errorMessage2(error) || "media fetch failed");
+      return;
+    }
+    await sendElements(elements);
+  };
   const work = (async () => {
     for (const unit of request.units) {
       if (aborted) break;
       if (unit.body.case === "normal") {
-        await sendElements(segmentsToElements(unit.body.value.segments, { mentionAll }));
+        await sendRendered(segmentsToElements(ctx, unit.body.value.segments, { mentionAll }));
       } else if (unit.body.case === "forward") {
         const nodes = unit.body.value.nodes;
         if (nodes.length === 0) {
@@ -6166,7 +6307,7 @@ async function sendMessage(ctx, request) {
         }
         for (const node of nodes) {
           if (aborted) break;
-          await sendElements(forwardNodeElements(node, { mentionAll }));
+          await sendRendered(forwardNodeElements(ctx, node, { mentionAll }));
         }
       } else {
         failuresRetryable = false;
@@ -6196,7 +6337,7 @@ async function sendMessage(ctx, request) {
     });
   }
 }
-function segmentsToElements(segments, options) {
+async function segmentsToElements(ctx, segments, options) {
   const elements = [];
   const quoted = /* @__PURE__ */ new Set();
   const addQuote = (id) => {
@@ -6214,17 +6355,17 @@ function segmentsToElements(segments, options) {
       }
       case "image": {
         const uri = segment.body.value.uri.trim();
-        if (uri) elements.push(import_koishi.h.image(uri));
+        if (uri) elements.push(await fetchMediaElement(ctx, "image", uri));
         break;
       }
       case "video": {
         const uri = segment.body.value.uri.trim();
-        if (uri) elements.push(import_koishi.h.video(uri));
+        if (uri) elements.push(await fetchMediaElement(ctx, "video", uri));
         break;
       }
       case "audio": {
         const uri = segment.body.value.uri.trim();
-        if (uri) elements.push(import_koishi.h.audio(uri));
+        if (uri) elements.push(await fetchMediaElement(ctx, "audio", uri));
         break;
       }
       case "mention": {
@@ -6258,13 +6399,57 @@ function segmentsToElements(segments, options) {
   }
   return elements;
 }
-function forwardNodeElements(node, options) {
-  const body = segmentsToElements(node.segments, options);
+async function forwardNodeElements(ctx, node, options) {
+  const body = await segmentsToElements(ctx, node.segments, options);
   const name2 = node.senderName.trim();
   if (!name2) return body;
   return [import_koishi.h.text(`${name2}
 `), ...body];
 }
+async function fetchMediaElement(ctx, kind, uri) {
+  const http = ctx.http;
+  if (typeof http?.file !== "function") {
+    throw mediaFetchError(kind, uri, new Error("Koishi http service is required to send media"));
+  }
+  ctx.logger.debug("message.send: fetch %s %s", kind, displayUri(uri));
+  let file;
+  try {
+    file = await http.file(uri);
+  } catch (error) {
+    throw mediaFetchError(kind, uri, error);
+  }
+  let buffer;
+  try {
+    buffer = mediaBytes(file.data);
+  } catch (error) {
+    throw mediaFetchError(kind, uri, error);
+  }
+  if (buffer.length === 0) {
+    throw mediaFetchError(kind, uri, new Error("empty body"));
+  }
+  const mime = (file.mime ?? file.type ?? "").trim() || MEDIA_FALLBACK_TYPE[kind];
+  ctx.logger.debug("message.send: fetched %s bytes=%d mime=%s", kind, buffer.length, mime);
+  if (kind === "image") return import_koishi.h.image(buffer, mime);
+  if (kind === "video") return import_koishi.h.video(buffer, mime);
+  return import_koishi.h.audio(buffer, mime);
+}
+function mediaBytes(data) {
+  if (Buffer.isBuffer(data)) return data;
+  if (data instanceof ArrayBuffer) return Buffer.from(data);
+  if (ArrayBuffer.isView(data)) {
+    return Buffer.from(data.buffer, data.byteOffset, data.byteLength);
+  }
+  throw new Error("media body is not binary");
+}
+function mediaFetchError(kind, uri, cause) {
+  const error = new Error(`failed to fetch ${kind} ${displayUri(uri)}: ${errorMessage2(cause) || "unknown error"}`);
+  error.cause = cause;
+  return error;
+}
+function displayUri(uri) {
+  if (uri.startsWith("data:")) return "data:...";
+  return uri.length > 200 ? `${uri.slice(0, 200)}...` : uri;
+}
 function withQuote(elements, quoteId) {
   if (!quoteId) return elements;
   if (hasQuote(elements, quoteId)) return elements;
@@ -6328,28 +6513,33 @@ function failed2(reason, retryable) {
   });
 }
 function isRetryableSendError(error) {
-  const text = errorMessage2(error);
-  const lower = text.toLowerCase();
-  const status = httpStatusOf2(error);
-  if (status === 401 || status === 403 || isForbidden2(lower)) return false;
-  if (status === 400 || status === 404) return false;
-  if (status === 429 || status !== void 0 && status >= 500) return true;
-  if (isRetryableNetwork2(error, lower)) return true;
-  if (/\brate.?limit\b|too many requests/.test(lower)) return true;
+  for (const item of errorChain(error)) {
+    const text = errorMessage2(item);
+    const lower = text.toLowerCase();
+    const status = httpStatusOf2(item);
+    if (status === 401 || status === 403 || isForbidden2(lower)) return false;
+    if (status === 400 || status === 404) return false;
+    if (status === 429 || status !== void 0 && status >= 500) return true;
+    if (isRetryableNetwork2(item, lower)) return true;
+    if (/\brate.?limit\b|too many requests/.test(lower)) return true;
+  }
   return false;
 }
 function isTimeoutError(error) {
-  const text = errorMessage2(error).toLowerCase();
-  const status = httpStatusOf2(error);
-  if (error instanceof SendTimeoutError) return true;
-  if (status === 408 || status === 504) return true;
-  if (error && typeof error === "object") {
-    const name2 = error.name;
-    if (name2 === "TimeoutError" || name2 === "AbortError") return true;
-    const code = error.code;
-    if (code === "ETIMEDOUT" || code === "UND_ERR_CONNECT_TIMEOUT" || code === "ABORT_ERR") return true;
+  for (const item of errorChain(error)) {
+    const text = errorMessage2(item).toLowerCase();
+    const status = httpStatusOf2(item);
+    if (item instanceof SendTimeoutError) return true;
+    if (status === 408 || status === 504) return true;
+    if (item && typeof item === "object") {
+      const name2 = item.name;
+      if (name2 === "TimeoutError" || name2 === "AbortError") return true;
+      const code = item.code;
+      if (code === "ETIMEDOUT" || code === "UND_ERR_CONNECT_TIMEOUT" || code === "ABORT_ERR") return true;
+    }
+    if (text.includes("timed out") || text.includes("timeout")) return true;
   }
-  return text.includes("timed out") || text.includes("timeout");
+  return false;
 }
 function httpStatusOf2(error) {
   if (!error || typeof error !== "object") return void 0;
@@ -6364,6 +6554,17 @@ function httpStatusOf2(error) {
   if (typeof record.code === "number" && record.code >= 400 && record.code < 600) return record.code;
   return void 0;
 }
+function errorChain(error) {
+  const seen = /* @__PURE__ */ new Set();
+  const chain = [];
+  let current = error;
+  while (current != null && !seen.has(current) && chain.length < 4) {
+    seen.add(current);
+    chain.push(current);
+    current = typeof current === "object" && "cause" in current ? current.cause : void 0;
+  }
+  return chain;
+}
 function errorMessage2(error) {
   if (error instanceof Error) return error.message.trim();
   if (typeof error === "string") return error.trim();
@@ -6407,18 +6608,114 @@ function withTimeout2(promise, ms) {
 function createGatewayHandlers(ctx) {
   const snapshot = () => create(ListBotsResponseSchema, { bots: listBots(ctx) });
   return {
-    [DbkMethod.SESSION_HELLO]: () => create(HelloResponseSchema, {
-      protocolVersion: PROTOCOL_VERSION,
-      gatewayVersion: GATEWAY_VERSION,
-      bots: snapshot().bots
-    }),
-    [DbkMethod.BOTS_LIST]: snapshot,
-    [DbkMethod.TARGETS_LIST]: (request) => listTargets(ctx, request),
-    [DbkMethod.TARGETS_GET]: (request) => getTarget(ctx, request),
-    [DbkMethod.MESSAGE_SEND]: (request) => sendMessage(ctx, request),
-    [DbkMethod.MESSAGE_RECALL]: (request) => recallMessage(ctx, request)
+    [DbkMethod.SESSION_HELLO]: (request) => {
+      const bots = snapshot().bots;
+      ctx.logger.debug(
+        "session.hello: app=%s protocol=%s gateway=%s bots=%d keys=%s",
+        request.appVersion || "-",
+        request.protocolVersion || "-",
+        GATEWAY_VERSION,
+        bots.length,
+        bots.map((bot) => bot.botKey).join(",") || "-"
+      );
+      return create(HelloResponseSchema, {
+        protocolVersion: PROTOCOL_VERSION,
+        gatewayVersion: GATEWAY_VERSION,
+        bots
+      });
+    },
+    [DbkMethod.BOTS_LIST]: () => {
+      const result = snapshot();
+      ctx.logger.debug(
+        "bots.list: count=%d keys=%s",
+        result.bots.length,
+        result.bots.map((bot) => bot.botKey).join(",") || "-"
+      );
+      return result;
+    },
+    [DbkMethod.TARGETS_LIST]: async (request) => {
+      ctx.logger.debug(
+        "targets.list: bot=%s kind=%s",
+        request.botKey.trim() || "*",
+        enumName(TargetKind, request.kind)
+      );
+      const result = await listTargets(ctx, request);
+      ctx.logger.debug(
+        "targets.list: count=%d incomplete=%s",
+        result.targets.length,
+        result.incomplete
+      );
+      return result;
+    },
+    [DbkMethod.TARGETS_GET]: async (request) => {
+      ctx.logger.debug(
+        "targets.get: bot=%s target=%s",
+        request.botKey.trim() || "*",
+        formatTarget(request.target)
+      );
+      const result = await getTarget(ctx, request);
+      ctx.logger.debug(
+        "targets.get: unresolved=%s name=%s bots=%s",
+        result.unresolved,
+        result.target?.name || "-",
+        result.target?.botKeys.join(",") || "-"
+      );
+      return result;
+    },
+    [DbkMethod.MESSAGE_SEND]: async (request) => {
+      ctx.logger.debug(
+        "message.send: bot=%s target=%s reply=%s units=%s",
+        request.botKey.trim() || "-",
+        formatTarget(request.target),
+        request.replyToMessageId.trim() || "-",
+        formatUnits(request)
+      );
+      const result = await sendMessage(ctx, request);
+      ctx.logger.debug(
+        "message.send: status=%s receipts=%d retryable=%s reason=%s",
+        enumName(SendStatus, result.status),
+        result.receipts.length,
+        result.retryable,
+        result.reason || "-"
+      );
+      return result;
+    },
+    [DbkMethod.MESSAGE_RECALL]: async (request) => {
+      ctx.logger.debug(
+        "message.recall: bot=%s target=%s message=%s",
+        request.botKey.trim() || "-",
+        formatTarget(request.target),
+        request.messageId.trim() || "-"
+      );
+      const result = await recallMessage(ctx, request);
+      ctx.logger.debug(
+        "message.recall: status=%s retryable=%s reason=%s",
+        enumName(SendStatus, result.status),
+        result.retryable,
+        result.reason || "-"
+      );
+      return result;
+    }
   };
 }
+function formatTarget(target) {
+  if (!target) return "-";
+  const kind = enumName(TargetKind, target.kind);
+  const id = target.id.trim() || "-";
+  const guild = target.guildId.trim();
+  return guild ? `${kind}:${id} guild=${guild}` : `${kind}:${id}`;
+}
+function formatUnits(request) {
+  if (request.units.length === 0) return "-";
+  return request.units.map((unit) => {
+    if (unit.body.case === "normal") return `normal:${unit.body.value.segments.length}`;
+    if (unit.body.case === "forward") return `forward:${unit.body.value.nodes.length}`;
+    return "empty";
+  }).join(",");
+}
+function enumName(map, value) {
+  return map[value] ?? String(value);
+}
 
 // src/index.ts
 var name = "dynamic-bot";

package/package.json

@@ -4,7 +4,7 @@
     "type": "git",
     "url": "https://github.com/incubator4/dynamic-bot-koishi"
   },
-  "version": "0.0.4",
+  "version": "0.0.6",
   "license": "Apache-2.0",
   "contributors": [
     "AresWang <incubator4@outlook.com>"

package/src/dbk/gateway.ts

@@ -1,6 +1,6 @@
 import { create } from "@bufbuild/protobuf";
 import type { Context } from "koishi";
-import { BotChangeType } from "../gen/dbk/v1/common_pb";
+import { BotChangeType, BotStatus } from "../gen/dbk/v1/common_pb";
 import { BotChangedEventSchema } from "../gen/dbk/v1/rpc_pb";
 import { toDbkBot } from "./bots";
 import { DbkEvent, type DbkEncoding, type DbkEventMap, type DbkGatewayHandlers } from "./protocol";
@@ -46,12 +46,20 @@ export class DbkGateway {
   }
 
   emit<K extends keyof DbkEventMap>(method: K, event: DbkEventMap[K]): void {
-    this.session?.emit(method, event);
+    if (!this.session) {
+      this.ctx.logger.debug("drop EVENT without session: method=%s", method);
+      return;
+    }
+    this.session.emit(method, event);
   }
 
   startForward(): void {
     const path = normalizePath(this.config.path);
-    this.ctx.logger.info("DBK forward WebSocket mounted on Koishi HTTP at %s", path);
+    this.ctx.logger.info(
+      "DBK forward WebSocket mounted on Koishi HTTP at %s encoding=%s",
+      path,
+      this.config.encoding,
+    );
     this.ctx.server.ws(path, (socket) => {
       this.attach("replaced", socket as DbkSocket);
     });
@@ -69,12 +77,17 @@ export class DbkGateway {
     this.session = undefined;
     this.socket?.close(1000, "plugin stop");
     this.socket = undefined;
+    this.ctx.logger.debug("DBK gateway stopped");
   }
 
   private connectReverse(): void {
     if (this.closing) return;
     const url = `ws://${this.config.host}:${this.config.port}`;
-    this.ctx.logger.info("DBK reverse WebSocket connecting to %s", url);
+    this.ctx.logger.info(
+      "DBK reverse WebSocket connecting to %s encoding=%s",
+      url,
+      this.config.encoding,
+    );
     const socket = this.ctx.http.ws(url) as DbkSocket;
     const onOpen = () => {
       this.reconnectAttempts = 0;
@@ -113,6 +126,7 @@ export class DbkGateway {
     });
     this.session = session;
     attachSocket(socket, session, this.config.encoding);
+    this.ctx.logger.debug("DBK connection attached encoding=%s", this.config.encoding);
   }
 
   private onReverseClosed(): void {
@@ -139,9 +153,16 @@ export class DbkGateway {
 export function watchBots(ctx: Context, gateway: DbkGateway): void {
   const emit = (type: BotChangeType, bot: Parameters<typeof toDbkBot>[0]) => {
     if (bot.hidden && type !== BotChangeType.REMOVED) return;
+    const mapped = toDbkBot(bot);
+    ctx.logger.debug(
+      "bot.changed: %s %s status=%s",
+      BotChangeType[type] ?? type,
+      mapped.botKey || "-",
+      BotStatus[mapped.status] ?? mapped.status,
+    );
     gateway.emit(DbkEvent.BOT_CHANGED, create(BotChangedEventSchema, {
       type,
-      bot: toDbkBot(bot),
+      bot: mapped,
     }));
   };
   ctx.on("bot-added", (bot) => emit(BotChangeType.ADDED, bot));

package/src/dbk/get-target.ts

@@ -59,14 +59,28 @@ export async function getTarget(ctx: Context, request: GetTargetRequest): Promis
       throw new DbkRpcError(ErrorCode.NOT_FOUND, `bot not found: ${botKey}`);
     }
     const info = await resolveOnBot(bot, target);
-    return info ? resolved(info) : unresolved(target);
+    if (info) {
+      ctx.logger.debug("targets.get: resolved on %s kind=%s id=%s", botKey, TargetKind[info.target?.kind ?? 0], info.target?.id);
+      return resolved(info);
+    }
+    ctx.logger.debug("targets.get: unresolved on %s id=%s", botKey, target?.id.trim() || "-");
+    return unresolved(target);
   }
 
   // Empty bot_key: search non-hidden, non-qq bots in ctx.bots order; first successful resolve wins.
   for (const bot of listSearchableBots(ctx)) {
     const info = await resolveOnBot(bot, target);
-    if (info) return resolved(info);
+    if (info) {
+      ctx.logger.debug(
+        "targets.get: resolved on %s kind=%s id=%s",
+        botKeyOf(bot),
+        TargetKind[info.target?.kind ?? 0],
+        info.target?.id,
+      );
+      return resolved(info);
+    }
   }
+  ctx.logger.debug("targets.get: unresolved id=%s", target?.id.trim() || "-");
   return unresolved(target);
 }
 

package/src/dbk/handlers.ts

@@ -1,8 +1,10 @@
 import { create } from "@bufbuild/protobuf";
 import type { Context } from "koishi";
+import { SendStatus, TargetKind, type Target } from "../gen/dbk/v1/common_pb";
 import {
   HelloResponseSchema,
   ListBotsResponseSchema,
+  type SendParams,
 } from "../gen/dbk/v1/rpc_pb";
 import { listBots } from "./bots";
 import { getTarget } from "./get-target";
@@ -15,15 +17,114 @@ export function createGatewayHandlers(ctx: Context): DbkGatewayHandlers {
   const snapshot = () => create(ListBotsResponseSchema, { bots: listBots(ctx) });
 
   return {
-    [DbkMethod.SESSION_HELLO]: () => create(HelloResponseSchema, {
-      protocolVersion: PROTOCOL_VERSION,
-      gatewayVersion: GATEWAY_VERSION,
-      bots: snapshot().bots,
-    }),
-    [DbkMethod.BOTS_LIST]: snapshot,
-    [DbkMethod.TARGETS_LIST]: (request) => listTargets(ctx, request),
-    [DbkMethod.TARGETS_GET]: (request) => getTarget(ctx, request),
-    [DbkMethod.MESSAGE_SEND]: (request) => sendMessage(ctx, request),
-    [DbkMethod.MESSAGE_RECALL]: (request) => recallMessage(ctx, request),
+    [DbkMethod.SESSION_HELLO]: (request) => {
+      const bots = snapshot().bots;
+      ctx.logger.debug(
+        "session.hello: app=%s protocol=%s gateway=%s bots=%d keys=%s",
+        request.appVersion || "-",
+        request.protocolVersion || "-",
+        GATEWAY_VERSION,
+        bots.length,
+        bots.map((bot) => bot.botKey).join(",") || "-",
+      );
+      return create(HelloResponseSchema, {
+        protocolVersion: PROTOCOL_VERSION,
+        gatewayVersion: GATEWAY_VERSION,
+        bots,
+      });
+    },
+    [DbkMethod.BOTS_LIST]: () => {
+      const result = snapshot();
+      ctx.logger.debug(
+        "bots.list: count=%d keys=%s",
+        result.bots.length,
+        result.bots.map((bot) => bot.botKey).join(",") || "-",
+      );
+      return result;
+    },
+    [DbkMethod.TARGETS_LIST]: async (request) => {
+      ctx.logger.debug(
+        "targets.list: bot=%s kind=%s",
+        request.botKey.trim() || "*",
+        enumName(TargetKind, request.kind),
+      );
+      const result = await listTargets(ctx, request);
+      ctx.logger.debug(
+        "targets.list: count=%d incomplete=%s",
+        result.targets.length,
+        result.incomplete,
+      );
+      return result;
+    },
+    [DbkMethod.TARGETS_GET]: async (request) => {
+      ctx.logger.debug(
+        "targets.get: bot=%s target=%s",
+        request.botKey.trim() || "*",
+        formatTarget(request.target),
+      );
+      const result = await getTarget(ctx, request);
+      ctx.logger.debug(
+        "targets.get: unresolved=%s name=%s bots=%s",
+        result.unresolved,
+        result.target?.name || "-",
+        result.target?.botKeys.join(",") || "-",
+      );
+      return result;
+    },
+    [DbkMethod.MESSAGE_SEND]: async (request) => {
+      ctx.logger.debug(
+        "message.send: bot=%s target=%s reply=%s units=%s",
+        request.botKey.trim() || "-",
+        formatTarget(request.target),
+        request.replyToMessageId.trim() || "-",
+        formatUnits(request),
+      );
+      const result = await sendMessage(ctx, request);
+      ctx.logger.debug(
+        "message.send: status=%s receipts=%d retryable=%s reason=%s",
+        enumName(SendStatus, result.status),
+        result.receipts.length,
+        result.retryable,
+        result.reason || "-",
+      );
+      return result;
+    },
+    [DbkMethod.MESSAGE_RECALL]: async (request) => {
+      ctx.logger.debug(
+        "message.recall: bot=%s target=%s message=%s",
+        request.botKey.trim() || "-",
+        formatTarget(request.target),
+        request.messageId.trim() || "-",
+      );
+      const result = await recallMessage(ctx, request);
+      ctx.logger.debug(
+        "message.recall: status=%s retryable=%s reason=%s",
+        enumName(SendStatus, result.status),
+        result.retryable,
+        result.reason || "-",
+      );
+      return result;
+    },
   };
 }
+
+function formatTarget(target: Target | undefined): string {
+  if (!target) return "-";
+  const kind = enumName(TargetKind, target.kind);
+  const id = target.id.trim() || "-";
+  const guild = target.guildId.trim();
+  return guild ? `${kind}:${id} guild=${guild}` : `${kind}:${id}`;
+}
+
+function formatUnits(request: SendParams): string {
+  if (request.units.length === 0) return "-";
+  return request.units.map((unit) => {
+    if (unit.body.case === "normal") return `normal:${unit.body.value.segments.length}`;
+    if (unit.body.case === "forward") return `forward:${unit.body.value.nodes.length}`;
+    return "empty";
+  }).join(",");
+}
+
+function enumName(map: Record<number, string>, value: number): string {
+  return map[value] ?? String(value);
+}

package/src/dbk/list-targets.ts

@@ -60,7 +60,10 @@ export async function listTargets(ctx: Context, request: ListTargetsRequest): Pr
   let incomplete = false;
 
   for (const bot of bots) {
-    if (isQq(bot)) continue;
+    if (isQq(bot)) {
+      ctx.logger?.debug("targets.list: skip qq bot %s", botKeyOf(bot));
+      continue;
+    }
     const listed = await listTargetsForBot(ctx, bot, kindFilter);
     incomplete = incomplete || listed.incomplete;
     for (const target of listed.targets) {
@@ -120,6 +123,12 @@ async function listTargetsForBot(
   const nested = hasNestedChannels(bot);
   const supported = botTargetKinds(bot);
   if (kindFilter !== TargetKind.UNSPECIFIED && supported.length > 0 && !supported.includes(kindFilter)) {
+    ctx.logger?.debug(
+      "targets.list: %s skip kind=%s supported=%s",
+      botKey,
+      TargetKind[kindFilter] ?? kindFilter,
+      supported.map((kind) => TargetKind[kind] ?? kind).join(","),
+    );
     return { targets, incomplete: false };
   }
 
@@ -134,7 +143,12 @@ async function listTargetsForBot(
     const guilds = await paginate<GuildLike>((next) => callBotList(bot, "getGuildList", next));
     if (guilds.unsupported || guilds.failed || guilds.truncated) incomplete = true;
     if (guilds.failed && !guilds.unsupported) {
-      ctx.logger?.debug("targets.list: %s getGuildList failed", botKey);
+      ctx.logger?.debug(
+        "targets.list: %s getGuildList failed items=%d truncated=%s",
+        botKey,
+        guilds.items.length,
+        guilds.truncated,
+      );
     }
 
     let channelMode: "unknown" | "nested" | "flat" = nested ? "unknown" : "flat";
@@ -209,6 +223,13 @@ async function listTargetsForBot(
     }
   }
 
+  ctx.logger?.debug(
+    "targets.list: %s listed=%d incomplete=%s nested=%s",
+    botKey,
+    targets.length,
+    incomplete,
+    nested,
+  );
   return { targets, incomplete };
 }
 

package/src/dbk/recall.ts

@@ -34,15 +34,24 @@ export async function recallMessage(ctx: Context, params: RecallParams): Promise
     return failed("target id is empty", false);
   }
 
+  ctx.logger.debug("message.recall: deleteMessage channel=%s message=%s", channelId, messageId);
   try {
     await withTimeout(Promise.resolve(bot.deleteMessage(channelId, messageId)), RECALL_TIMEOUT_MS);
+    ctx.logger.debug("message.recall: adapter ok");
     return create(RecallResultSchema, {
       status: SendStatus.OK,
       reason: "",
       retryable: false,
     });
   } catch (error) {
-    return classifyRecallError(error);
+    const result = classifyRecallError(error);
+    ctx.logger.debug(
+      "message.recall: adapter error status=%s retryable=%s: %s",
+      SendStatus[result.status] ?? result.status,
+      result.retryable,
+      result.reason || errorMessage(error) || "message.recall failed",
+    );
+    return result;
   }
 }
 

package/src/dbk/send.ts

@@ -1,5 +1,6 @@
 import { create } from "@bufbuild/protobuf";
 import { h, type Bot, type Context } from "koishi";
+import type {} from "@koishijs/plugin-http";
 import { BotStatus, ErrorCode, SendStatus } from "../gen/dbk/v1/common_pb";
 import {
   SendReceiptSchema,
@@ -15,6 +16,11 @@ import { DbkRpcError } from "./error";
 
 const SEND_TIMEOUT_MS = 25_000;
 const MENTION_ALL_FALLBACK = "@全体成员";
+const MEDIA_FALLBACK_TYPE = {
+  image: "image/png",
+  video: "video/mp4",
+  audio: "audio/mpeg",
+} as const;
 
 type El = ReturnType<typeof h>;
 
@@ -71,20 +77,29 @@ export async function sendMessage(ctx: Context, request: SendParams): Promise<Se
   const sendElements = async (elements: El[]): Promise<void> => {
     if (aborted) return;
     if (elements.length === 0) {
+      ctx.logger.debug("message.send: no sendable segments");
       failuresRetryable = false;
       failures.push("no sendable segments");
       return;
     }
     const outgoing = withQuote(elements, nextQuoteId());
+    ctx.logger.debug(
+      "message.send: bot.sendMessage channel=%s guild=%s elements=%d",
+      channelId,
+      guildId || "-",
+      outgoing.length,
+    );
     try {
       const ids = await bot.sendMessage(channelId, outgoing, guildId);
       if (aborted) return;
       quoteUsed = true;
       const kept = normalizeMessageIds(ids);
       if (kept.length === 0) {
+        ctx.logger.debug("message.send: adapter returned no message id");
         unknownReasons.push("send returned no message id");
         return;
       }
+      ctx.logger.debug("message.send: adapter ids=%s", kept.join(","));
       for (const messageId of kept) {
         receipts.push(create(SendReceiptSchema, { messageId, recallable }));
       }
@@ -92,20 +107,48 @@ export async function sendMessage(ctx: Context, request: SendParams): Promise<Se
       if (aborted) return;
       if (isTimeoutError(error)) {
         quoteUsed = true;
-        unknownReasons.push(errorMessage(error) || "send timed out");
+        const reason = errorMessage(error) || "send timed out";
+        ctx.logger.debug("message.send: adapter timeout: %s", reason);
+        unknownReasons.push(reason);
         return;
       }
       const retryable = isRetryableSendError(error);
+      ctx.logger.debug(
+        "message.send: adapter error retryable=%s: %s",
+        retryable,
+        errorMessage(error) || "send failed",
+      );
       failuresRetryable = failuresRetryable && retryable;
       failures.push(errorMessage(error) || "send failed");
     }
   };
 
+  const sendRendered = async (render: Promise<El[]>): Promise<void> => {
+    if (aborted) return;
+    let elements: El[];
+    try {
+      elements = await render;
+    } catch (error) {
+      if (aborted) return;
+      if (isTimeoutError(error)) {
+        const reason = errorMessage(error) || "media fetch timed out";
+        ctx.logger.debug("message.send: media timeout: %s", reason);
+        unknownReasons.push(reason);
+        return;
+      }
+      ctx.logger.debug("message.send: media error: %s", errorMessage(error) || "media fetch failed");
+      failuresRetryable = failuresRetryable && isRetryableSendError(error);
+      failures.push(errorMessage(error) || "media fetch failed");
+      return;
+    }
+    await sendElements(elements);
+  };
+
   const work = (async (): Promise<SendResult> => {
     for (const unit of request.units) {
       if (aborted) break;
       if (unit.body.case === "normal") {
-        await sendElements(segmentsToElements(unit.body.value.segments, { mentionAll }));
+        await sendRendered(segmentsToElements(ctx, unit.body.value.segments, { mentionAll }));
       } else if (unit.body.case === "forward") {
         // v1: never emit a single merged-forward receipt. Always one send per node.
         const nodes = unit.body.value.nodes;
@@ -116,7 +159,7 @@ export async function sendMessage(ctx: Context, request: SendParams): Promise<Se
         }
         for (const node of nodes) {
           if (aborted) break;
-          await sendElements(forwardNodeElements(node, { mentionAll }));
+          await sendRendered(forwardNodeElements(ctx, node, { mentionAll }));
         }
       } else {
         failuresRetryable = false;
@@ -148,7 +191,11 @@ export async function sendMessage(ctx: Context, request: SendParams): Promise<Se
   }
 }
 
-export function segmentsToElements(segments: Segment[], options?: SegmentRenderOptions): El[] {
+export async function segmentsToElements(
+  ctx: Context,
+  segments: Segment[],
+  options?: SegmentRenderOptions,
+): Promise<El[]> {
   const elements: El[] = [];
   const quoted = new Set<string>();
 
@@ -169,17 +216,17 @@ export function segmentsToElements(segments: Segment[], options?: SegmentRenderO
       }
       case "image": {
         const uri = segment.body.value.uri.trim();
-        if (uri) elements.push(h.image(uri));
+        if (uri) elements.push(await fetchMediaElement(ctx, "image", uri));
         break;
       }
       case "video": {
         const uri = segment.body.value.uri.trim();
-        if (uri) elements.push(h.video(uri));
+        if (uri) elements.push(await fetchMediaElement(ctx, "video", uri));
         break;
       }
       case "audio": {
         const uri = segment.body.value.uri.trim();
-        if (uri) elements.push(h.audio(uri));
+        if (uri) elements.push(await fetchMediaElement(ctx, "audio", uri));
         break;
       }
       case "mention": {
@@ -215,13 +262,67 @@ export function segmentsToElements(segments: Segment[], options?: SegmentRenderO
   return elements;
 }
 
-function forwardNodeElements(node: ForwardNode, options?: SegmentRenderOptions): El[] {
-  const body = segmentsToElements(node.segments, options);
+async function forwardNodeElements(
+  ctx: Context,
+  node: ForwardNode,
+  options?: SegmentRenderOptions,
+): Promise<El[]> {
+  const body = await segmentsToElements(ctx, node.segments, options);
   const name = node.senderName.trim();
   if (!name) return body;
   return [h.text(`${name}\n`), ...body];
 }
 
+type MediaKind = keyof typeof MEDIA_FALLBACK_TYPE;
+
+async function fetchMediaElement(ctx: Context, kind: MediaKind, uri: string): Promise<El> {
+  const http = ctx.http;
+  if (typeof http?.file !== "function") {
+    throw mediaFetchError(kind, uri, new Error("Koishi http service is required to send media"));
+  }
+  ctx.logger.debug("message.send: fetch %s %s", kind, displayUri(uri));
+  let file: { data?: unknown; mime?: string; type?: string };
+  try {
+    file = await http.file(uri);
+  } catch (error) {
+    throw mediaFetchError(kind, uri, error);
+  }
+  let buffer: Buffer;
+  try {
+    buffer = mediaBytes(file.data);
+  } catch (error) {
+    throw mediaFetchError(kind, uri, error);
+  }
+  if (buffer.length === 0) {
+    throw mediaFetchError(kind, uri, new Error("empty body"));
+  }
+  const mime = (file.mime ?? file.type ?? "").trim() || MEDIA_FALLBACK_TYPE[kind];
+  ctx.logger.debug("message.send: fetched %s bytes=%d mime=%s", kind, buffer.length, mime);
+  if (kind === "image") return h.image(buffer, mime);
+  if (kind === "video") return h.video(buffer, mime);
+  return h.audio(buffer, mime);
+}
+
+function mediaBytes(data: unknown): Buffer {
+  if (Buffer.isBuffer(data)) return data;
+  if (data instanceof ArrayBuffer) return Buffer.from(data);
+  if (ArrayBuffer.isView(data)) {
+    return Buffer.from(data.buffer, data.byteOffset, data.byteLength);
+  }
+  throw new Error("media body is not binary");
+}
+
+function mediaFetchError(kind: MediaKind, uri: string, cause: unknown): Error {
+  const error = new Error(`failed to fetch ${kind} ${displayUri(uri)}: ${errorMessage(cause) || "unknown error"}`);
+  error.cause = cause;
+  return error;
+}
+
+function displayUri(uri: string): string {
+  if (uri.startsWith("data:")) return "data:...";
+  return uri.length > 200 ? `${uri.slice(0, 200)}...` : uri;
+}
+
 function withQuote(elements: El[], quoteId: string | undefined): El[] {
   if (!quoteId) return elements;
   if (hasQuote(elements, quoteId)) return elements;
@@ -297,30 +398,35 @@ function failed(reason: string, retryable: boolean): SendResult {
 }
 
 function isRetryableSendError(error: unknown): boolean {
-  const text = errorMessage(error);
-  const lower = text.toLowerCase();
-  const status = httpStatusOf(error);
-
-  if (status === 401 || status === 403 || isForbidden(lower)) return false;
-  if (status === 400 || status === 404) return false;
-  if (status === 429 || (status !== undefined && status >= 500)) return true;
-  if (isRetryableNetwork(error, lower)) return true;
-  if (/\brate.?limit\b|too many requests/.test(lower)) return true;
+  for (const item of errorChain(error)) {
+    const text = errorMessage(item);
+    const lower = text.toLowerCase();
+    const status = httpStatusOf(item);
+
+    if (status === 401 || status === 403 || isForbidden(lower)) return false;
+    if (status === 400 || status === 404) return false;
+    if (status === 429 || (status !== undefined && status >= 500)) return true;
+    if (isRetryableNetwork(item, lower)) return true;
+    if (/\brate.?limit\b|too many requests/.test(lower)) return true;
+  }
   return false;
 }
 
 function isTimeoutError(error: unknown): boolean {
-  const text = errorMessage(error).toLowerCase();
-  const status = httpStatusOf(error);
-  if (error instanceof SendTimeoutError) return true;
-  if (status === 408 || status === 504) return true;
-  if (error && typeof error === "object") {
-    const name = (error as { name?: unknown }).name;
-    if (name === "TimeoutError" || name === "AbortError") return true;
-    const code = (error as { code?: unknown }).code;
-    if (code === "ETIMEDOUT" || code === "UND_ERR_CONNECT_TIMEOUT" || code === "ABORT_ERR") return true;
+  for (const item of errorChain(error)) {
+    const text = errorMessage(item).toLowerCase();
+    const status = httpStatusOf(item);
+    if (item instanceof SendTimeoutError) return true;
+    if (status === 408 || status === 504) return true;
+    if (item && typeof item === "object") {
+      const name = (item as { name?: unknown }).name;
+      if (name === "TimeoutError" || name === "AbortError") return true;
+      const code = (item as { code?: unknown }).code;
+      if (code === "ETIMEDOUT" || code === "UND_ERR_CONNECT_TIMEOUT" || code === "ABORT_ERR") return true;
+    }
+    if (text.includes("timed out") || text.includes("timeout")) return true;
   }
-  return text.includes("timed out") || text.includes("timeout");
+  return false;
 }
 
 function httpStatusOf(error: unknown): number | undefined {
@@ -337,6 +443,20 @@ function httpStatusOf(error: unknown): number | undefined {
   return undefined;
 }
 
+function errorChain(error: unknown): unknown[] {
+  const seen = new Set<unknown>();
+  const chain: unknown[] = [];
+  let current: unknown = error;
+  while (current != null && !seen.has(current) && chain.length < 4) {
+    seen.add(current);
+    chain.push(current);
+    current = typeof current === "object" && "cause" in current
+      ? (current as { cause?: unknown }).cause
+      : undefined;
+  }
+  return chain;
+}
+
 function errorMessage(error: unknown): string {
   if (error instanceof Error) return error.message.trim();
   if (typeof error === "string") return error.trim();

package/src/dbk/session.ts

@@ -68,8 +68,12 @@ export class DbkGatewaySession {
   }
 
   emit<K extends keyof DbkEventMap>(method: K, event: DbkEventMap[K]): void {
-    if (!this.isHandshook) return;
+    if (!this.isHandshook) {
+      this.options.logger.debug("drop EVENT before handshake: method=%s", method);
+      return;
+    }
     this.seq += 1n;
+    this.options.logger.debug("DBK EVENT %s seq=%s", method, this.seq.toString());
     this.enqueueFrame(
       createFrame({
         op: FrameOp.EVENT,
@@ -126,6 +130,7 @@ export class DbkGatewaySession {
       this.replyError(frame.id, ErrorCode.UNSUPPORTED, `unknown method: ${frame.method}`);
       return;
     }
+    this.options.logger.debug("DBK CALL %s id=%s", frame.method, frame.id);
     try {
       const payload = await this.dispatchCall(frame.method, frame.payload);
       this.enqueueFrame(