koishi-plugin-dynamic-bot 0.0.5 → 0.0.7

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) {
@@ -6128,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 }));
       }
@@ -6149,10 +6258,17 @@ 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");
     }
@@ -6165,9 +6281,12 @@ async function sendMessage(ctx, request) {
     } catch (error) {
       if (aborted) return;
       if (isTimeoutError(error)) {
-        unknownReasons.push(errorMessage2(error) || "media fetch timed out");
+        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;
@@ -6288,30 +6407,85 @@ async function forwardNodeElements(ctx, node, options) {
 `), ...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"));
-  }
-  let file;
-  try {
-    file = await http.file(uri);
-  } catch (error) {
-    throw mediaFetchError(kind, uri, error);
-  }
+  ctx.logger.debug("message.send: fetch %s %s", kind, displayUri(uri));
   let buffer;
+  let mime;
   try {
-    buffer = mediaBytes(file.data);
+    const inline = decodeInlineMedia(uri, kind);
+    if (inline) {
+      buffer = inline.buffer;
+      mime = inline.mime;
+    } else {
+      const fetched = await fetchRemoteMedia(ctx, kind, uri);
+      buffer = fetched.buffer;
+      mime = fetched.mime;
+    }
   } 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);
 }
+async function fetchRemoteMedia(ctx, kind, uri) {
+  const http = ctx.http;
+  if (typeof http?.file !== "function") {
+    throw new Error("Koishi http service is required to send media");
+  }
+  const file = await http.file(uri);
+  const buffer = mediaBytes(file.data);
+  const mime = (file.mime ?? file.type ?? "").trim() || MEDIA_FALLBACK_TYPE[kind];
+  return { buffer, mime };
+}
+function decodeInlineMedia(uri, kind) {
+  if (/^data:/i.test(uri)) {
+    const parsed = decodeDataUri(uri);
+    if (!parsed) throw new Error("invalid data URI");
+    return { buffer: parsed.buffer, mime: parsed.mime || sniffMime(parsed.buffer, kind) };
+  }
+  const base64 = /^base64:\/\//i.exec(uri);
+  if (base64) {
+    const buffer = decodeBase64Payload(uri.slice(base64[0].length));
+    return { buffer, mime: sniffMime(buffer, kind) };
+  }
+  return void 0;
+}
+function decodeDataUri(uri) {
+  const comma = uri.indexOf(",");
+  if (comma < 5) return void 0;
+  const parts = uri.slice(5, comma).split(";").map((part) => part.trim()).filter(Boolean);
+  const isBase64 = parts.some((part) => part.toLowerCase() === "base64");
+  const mime = parts.find((part) => part.includes("/")) ?? "";
+  const payload = uri.slice(comma + 1);
+  const buffer = isBase64 ? decodeBase64Payload(payload) : Buffer.from(decodeURIComponent(payload.replace(/\+/g, " ")));
+  return { buffer, mime };
+}
+function decodeBase64Payload(payload) {
+  const cleaned = payload.replace(/\s/g, "").replace(/-/g, "+").replace(/_/g, "/");
+  if (!cleaned) throw new Error("empty base64 payload");
+  const buffer = Buffer.from(cleaned, "base64");
+  if (buffer.length === 0) throw new Error("invalid base64 payload");
+  return buffer;
+}
+function sniffMime(buffer, kind) {
+  if (buffer.length >= 8 && buffer[0] === 137 && buffer[1] === 80 && buffer[2] === 78 && buffer[3] === 71) {
+    return "image/png";
+  }
+  if (buffer.length >= 3 && buffer[0] === 255 && buffer[1] === 216 && buffer[2] === 255) {
+    return "image/jpeg";
+  }
+  if (buffer.length >= 6 && buffer.toString("ascii", 0, 6).startsWith("GIF8")) {
+    return "image/gif";
+  }
+  if (buffer.length >= 12 && buffer.toString("ascii", 0, 4) === "RIFF" && buffer.toString("ascii", 8, 12) === "WEBP") {
+    return "image/webp";
+  }
+  return MEDIA_FALLBACK_TYPE[kind];
+}
 function mediaBytes(data) {
   if (Buffer.isBuffer(data)) return data;
   if (data instanceof ArrayBuffer) return Buffer.from(data);
@@ -6326,7 +6500,8 @@ function mediaFetchError(kind, uri, cause) {
   return error;
 }
 function displayUri(uri) {
-  if (uri.startsWith("data:")) return "data:...";
+  if (/^data:/i.test(uri)) return "data:...";
+  if (/^base64:\/\//i.test(uri)) return "base64://...";
   return uri.length > 200 ? `${uri.slice(0, 200)}...` : uri;
 }
 function withQuote(elements, quoteId) {
@@ -6487,18 +6662,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.5",
+  "version": "0.0.7",
   "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

@@ -77,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 }));
       }
@@ -98,10 +107,17 @@ 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");
     }
@@ -115,9 +131,12 @@ export async function sendMessage(ctx: Context, request: SendParams): Promise<Se
     } catch (error) {
       if (aborted) return;
       if (isTimeoutError(error)) {
-        unknownReasons.push(errorMessage(error) || "media fetch timed out");
+        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;
@@ -257,31 +276,97 @@ async function forwardNodeElements(
 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"));
-  }
-  let file: { data?: unknown; mime?: string; type?: string };
-  try {
-    file = await http.file(uri);
-  } catch (error) {
-    throw mediaFetchError(kind, uri, error);
-  }
+  ctx.logger.debug("message.send: fetch %s %s", kind, displayUri(uri));
   let buffer: Buffer;
+  let mime: string;
   try {
-    buffer = mediaBytes(file.data);
+    const inline = decodeInlineMedia(uri, kind);
+    if (inline) {
+      buffer = inline.buffer;
+      mime = inline.mime;
+    } else {
+      const fetched = await fetchRemoteMedia(ctx, kind, uri);
+      buffer = fetched.buffer;
+      mime = fetched.mime;
+    }
   } 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);
 }
 
+async function fetchRemoteMedia(
+  ctx: Context,
+  kind: MediaKind,
+  uri: string,
+): Promise<{ buffer: Buffer; mime: string }> {
+  const http = ctx.http;
+  if (typeof http?.file !== "function") {
+    throw new Error("Koishi http service is required to send media");
+  }
+  const file = await http.file(uri);
+  const buffer = mediaBytes(file.data);
+  const mime = (file.mime ?? file.type ?? "").trim() || MEDIA_FALLBACK_TYPE[kind];
+  return { buffer, mime };
+}
+
+function decodeInlineMedia(uri: string, kind: MediaKind): { buffer: Buffer; mime: string } | undefined {
+  if (/^data:/i.test(uri)) {
+    const parsed = decodeDataUri(uri);
+    if (!parsed) throw new Error("invalid data URI");
+    return { buffer: parsed.buffer, mime: parsed.mime || sniffMime(parsed.buffer, kind) };
+  }
+  const base64 = /^base64:\/\//i.exec(uri);
+  if (base64) {
+    const buffer = decodeBase64Payload(uri.slice(base64[0].length));
+    return { buffer, mime: sniffMime(buffer, kind) };
+  }
+  return undefined;
+}
+
+function decodeDataUri(uri: string): { buffer: Buffer; mime: string } | undefined {
+  const comma = uri.indexOf(",");
+  if (comma < 5) return undefined;
+  const parts = uri.slice(5, comma).split(";").map((part) => part.trim()).filter(Boolean);
+  const isBase64 = parts.some((part) => part.toLowerCase() === "base64");
+  const mime = parts.find((part) => part.includes("/")) ?? "";
+  const payload = uri.slice(comma + 1);
+  const buffer = isBase64
+    ? decodeBase64Payload(payload)
+    : Buffer.from(decodeURIComponent(payload.replace(/\+/g, " ")));
+  return { buffer, mime };
+}
+
+function decodeBase64Payload(payload: string): Buffer {
+  const cleaned = payload.replace(/\s/g, "").replace(/-/g, "+").replace(/_/g, "/");
+  if (!cleaned) throw new Error("empty base64 payload");
+  const buffer = Buffer.from(cleaned, "base64");
+  if (buffer.length === 0) throw new Error("invalid base64 payload");
+  return buffer;
+}
+
+function sniffMime(buffer: Buffer, kind: MediaKind): string {
+  if (buffer.length >= 8 && buffer[0] === 0x89 && buffer[1] === 0x50 && buffer[2] === 0x4e && buffer[3] === 0x47) {
+    return "image/png";
+  }
+  if (buffer.length >= 3 && buffer[0] === 0xff && buffer[1] === 0xd8 && buffer[2] === 0xff) {
+    return "image/jpeg";
+  }
+  if (buffer.length >= 6 && buffer.toString("ascii", 0, 6).startsWith("GIF8")) {
+    return "image/gif";
+  }
+  if (buffer.length >= 12 && buffer.toString("ascii", 0, 4) === "RIFF" && buffer.toString("ascii", 8, 12) === "WEBP") {
+    return "image/webp";
+  }
+  return MEDIA_FALLBACK_TYPE[kind];
+}
+
 function mediaBytes(data: unknown): Buffer {
   if (Buffer.isBuffer(data)) return data;
   if (data instanceof ArrayBuffer) return Buffer.from(data);
@@ -298,7 +383,8 @@ function mediaFetchError(kind: MediaKind, uri: string, cause: unknown): Error {
 }
 
 function displayUri(uri: string): string {
-  if (uri.startsWith("data:")) return "data:...";
+  if (/^data:/i.test(uri)) return "data:...";
+  if (/^base64:\/\//i.test(uri)) return "base64://...";
   return uri.length > 200 ? `${uri.slice(0, 200)}...` : uri;
 }
 

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(