@kirigaya/openclaw-onebot 1.0.2 → 1.0.4

package/dist/connection.js

@@ -1,16 +1,21 @@
 /**
  * OneBot WebSocket 连接与 API 调用
  *
- * 图片消息：网络 URL 会先下载到本地再发送（兼容 Lagrange.Core retcode 1200），
+ * 图片消息：
+ * - 本机回环连接时：网络 URL 会先下载到本地再发送（兼容部分实现的 retcode 1200）
+ * - 跨机器连接时：本地文件会自动转成 base64://，避免把宿主机绝对路径发给远端 OneBot
  * 并定期清理临时文件。
  */
+import Fuse from "fuse.js";
 import WebSocket from "ws";
 import { createServer } from "http";
 import https from "https";
 import http from "http";
-import { writeFileSync, mkdirSync, readdirSync, statSync, unlinkSync } from "fs";
+import { writeFileSync, mkdirSync, readdirSync, readFileSync, statSync, unlinkSync } from "fs";
 import { join } from "path";
 import { tmpdir } from "os";
+import { logSend } from "./send-debug-log.js";
+import { shouldBlockSendInForwardMode, getActiveReplyTarget, getActiveReplySessionId } from "./reply-context.js";
 const IMAGE_TEMP_DIR = join(tmpdir(), "openclaw-onebot");
 const DOWNLOAD_TIMEOUT_MS = 30000;
 /** 使用 Node 内置 http(s) 下载 URL，避免 fetch 在某些环境下的兼容性问题 */
@@ -94,6 +99,48 @@ async function resolveImageToLocalPath(image) {
     }
     return trimmed.replace(/\\/g, "/");
 }
+async function resolveImageToBuffer(image) {
+    const trimmed = image?.trim();
+    if (!trimmed)
+        throw new Error("Empty image");
+    if (/^https?:\/\//i.test(trimmed)) {
+        return downloadUrl(trimmed);
+    }
+    if (trimmed.startsWith("base64://")) {
+        return Buffer.from(trimmed.slice(9), "base64");
+    }
+    if (trimmed.startsWith("file://")) {
+        return readFileSync(trimmed.slice(7));
+    }
+    return readFileSync(trimmed);
+}
+function normalizePeerHost(host) {
+    const trimmed = String(host ?? "").trim().toLowerCase();
+    if (!trimmed)
+        return "";
+    const unwrapped = trimmed.replace(/^\[/, "").replace(/\]$/, "");
+    return unwrapped.startsWith("::ffff:") ? unwrapped.slice(7) : unwrapped;
+}
+function isLoopbackHost(host) {
+    const normalized = normalizePeerHost(host);
+    return normalized === "127.0.0.1" || normalized === "::1" || normalized === "localhost";
+}
+function getSocketPeerHost(socket, getConfig) {
+    const peerHost = socket.__onebotPeerHost;
+    if (peerHost)
+        return peerHost;
+    return getConfig?.()?.host ?? "";
+}
+function shouldEncodeImageAsBase64(socket, getConfig) {
+    const peerHost = getSocketPeerHost(socket, getConfig);
+    return !!peerHost && !isLoopbackHost(peerHost);
+}
+async function resolveImageFileForSend(image, socket, getConfig) {
+    if (shouldEncodeImageAsBase64(socket, getConfig)) {
+        return `base64://${(await resolveImageToBuffer(image)).toString("base64")}`;
+    }
+    return resolveImageToLocalPath(image);
+}
 /** 启动临时图片定期清理（每小时执行一次） */
 export function startImageTempCleanup() {
     stopImageTempCleanup();
@@ -206,6 +253,18 @@ export async function ensureConnection(getConfig, timeoutMs = 30000) {
     return waitForConnection(timeoutMs);
 }
 export async function sendPrivateMsg(userId, text, getConfig) {
+    if (shouldBlockSendInForwardMode("private", userId)) {
+        logSend("connection", "sendPrivateMsg", { targetId: userId, blocked: true, sessionId: getActiveReplyTarget(), replySessionId: getActiveReplySessionId() });
+        return undefined;
+    }
+    logSend("connection", "sendPrivateMsg", {
+        targetType: "user",
+        targetId: userId,
+        textPreview: text?.slice(0, 80),
+        textLen: text?.length,
+        sessionId: getActiveReplyTarget(),
+        replySessionId: getActiveReplySessionId(),
+    });
     const socket = getConfig
         ? await ensureConnection(getConfig)
         : await waitForConnection();
@@ -213,9 +272,23 @@ export async function sendPrivateMsg(userId, text, getConfig) {
     if (res?.retcode !== 0) {
         throw new Error(res?.msg ?? `OneBot send_private_msg failed (retcode=${res?.retcode})`);
     }
-    return res?.data?.message_id;
+    const mid = res?.data?.message_id;
+    logSend("connection", "sendPrivateMsg", { targetId: userId, messageId: mid, sessionId: getActiveReplyTarget(), replySessionId: getActiveReplySessionId() });
+    return mid;
 }
 export async function sendGroupMsg(groupId, text, getConfig) {
+    if (shouldBlockSendInForwardMode("group", groupId)) {
+        logSend("connection", "sendGroupMsg", { targetId: groupId, blocked: true, sessionId: getActiveReplyTarget(), replySessionId: getActiveReplySessionId() });
+        return undefined;
+    }
+    logSend("connection", "sendGroupMsg", {
+        targetType: "group",
+        targetId: groupId,
+        textPreview: text?.slice(0, 80),
+        textLen: text?.length,
+        sessionId: getActiveReplyTarget(),
+        replySessionId: getActiveReplySessionId(),
+    });
     const socket = getConfig
         ? await ensureConnection(getConfig)
         : await waitForConnection();
@@ -223,14 +296,27 @@ export async function sendGroupMsg(groupId, text, getConfig) {
     if (res?.retcode !== 0) {
         throw new Error(res?.msg ?? `OneBot send_group_msg failed (retcode=${res?.retcode})`);
     }
-    return res?.data?.message_id;
+    const mid = res?.data?.message_id;
+    logSend("connection", "sendGroupMsg", { targetId: groupId, messageId: mid, sessionId: getActiveReplyTarget(), replySessionId: getActiveReplySessionId() });
+    return mid;
 }
 export async function sendGroupImage(groupId, image, log = getLogger(), getConfig) {
+    if (shouldBlockSendInForwardMode("group", groupId)) {
+        logSend("connection", "sendGroupImage", { targetId: groupId, blocked: true, sessionId: getActiveReplyTarget(), replySessionId: getActiveReplySessionId() });
+        return undefined;
+    }
+    logSend("connection", "sendGroupImage", {
+        targetType: "group",
+        targetId: groupId,
+        imagePreview: image?.slice?.(0, 60),
+        sessionId: getActiveReplyTarget(),
+        replySessionId: getActiveReplySessionId(),
+    });
     log.info?.(`[onebot] sendGroupImage entry: groupId=${groupId} image=${image?.slice?.(0, 80) ?? ""}`);
     const socket = getConfig ? await ensureConnection(getConfig) : await waitForConnection();
     log.info?.(`222[onebot] sendGroupImage entry: groupId=${groupId} image=${image?.slice?.(0, 80) ?? ""}`);
     try {
-        const filePath = image.startsWith("[") ? null : await resolveImageToLocalPath(image);
+        const filePath = image.startsWith("[") ? null : await resolveImageFileForSend(image, socket, getConfig);
         const seg = image.startsWith("[")
             ? JSON.parse(image)
             : [{ type: "image", data: { file: filePath } }];
@@ -240,16 +326,61 @@ export async function sendGroupImage(groupId, image, log = getLogger(), getConfi
             throw new Error(res?.msg ?? `OneBot send_group_msg (image) failed (retcode=${res?.retcode})`);
         }
         log.info?.(`[onebot] sendGroupImage done: retcode=${res?.retcode ?? "?"}`);
-        return res?.data?.message_id;
+        const mid = res?.data?.message_id;
+        logSend("connection", "sendGroupImage", { targetId: groupId, messageId: mid, sessionId: getActiveReplyTarget(), replySessionId: getActiveReplySessionId() });
+        return mid;
     }
     catch (error) {
         log.warn?.(`[onebot] sendGroupImage error: ${error}`);
     }
 }
+/** 发送群合并转发消息。messages 为节点数组，每节点 { type: "node", data: { id } } 或 { type: "node", data: { user_id, nickname, content } } */
+export async function sendGroupForwardMsg(groupId, messages, getConfig) {
+    logSend("connection", "sendGroupForwardMsg", {
+        targetType: "group",
+        targetId: groupId,
+        nodeCount: messages.length,
+        isForward: true,
+        sessionId: getActiveReplyTarget(),
+        replySessionId: getActiveReplySessionId(),
+    });
+    const socket = getConfig ? await ensureConnection(getConfig) : await waitForConnection();
+    const res = await sendOneBotAction(socket, "send_group_forward_msg", { group_id: groupId, messages });
+    if (res?.retcode !== 0) {
+        throw new Error(res?.msg ?? `OneBot send_group_forward_msg failed (retcode=${res?.retcode})`);
+    }
+}
+/** 发送私聊合并转发消息 */
+export async function sendPrivateForwardMsg(userId, messages, getConfig) {
+    logSend("connection", "sendPrivateForwardMsg", {
+        targetType: "user",
+        targetId: userId,
+        nodeCount: messages.length,
+        isForward: true,
+        sessionId: getActiveReplyTarget(),
+        replySessionId: getActiveReplySessionId(),
+    });
+    const socket = getConfig ? await ensureConnection(getConfig) : await waitForConnection();
+    const res = await sendOneBotAction(socket, "send_private_forward_msg", { user_id: userId, messages });
+    if (res?.retcode !== 0) {
+        throw new Error(res?.msg ?? `OneBot send_private_forward_msg failed (retcode=${res?.retcode})`);
+    }
+}
 export async function sendPrivateImage(userId, image, log = getLogger(), getConfig) {
+    if (shouldBlockSendInForwardMode("private", userId)) {
+        logSend("connection", "sendPrivateImage", { targetId: userId, blocked: true, sessionId: getActiveReplyTarget(), replySessionId: getActiveReplySessionId() });
+        return undefined;
+    }
+    logSend("connection", "sendPrivateImage", {
+        targetType: "user",
+        targetId: userId,
+        imagePreview: image?.slice?.(0, 60),
+        sessionId: getActiveReplyTarget(),
+        replySessionId: getActiveReplySessionId(),
+    });
     log.info?.(`[onebot] sendPrivateImage entry: userId=${userId} image=${image?.slice?.(0, 80) ?? ""}`);
     const socket = getConfig ? await ensureConnection(getConfig) : await waitForConnection();
-    const filePath = image.startsWith("[") ? null : await resolveImageToLocalPath(image);
+    const filePath = image.startsWith("[") ? null : await resolveImageFileForSend(image, socket, getConfig);
     const seg = image.startsWith("[")
         ? JSON.parse(image)
         : [{ type: "image", data: { file: filePath } }];
@@ -258,17 +389,27 @@ export async function sendPrivateImage(userId, image, log = getLogger(), getConf
         throw new Error(res?.msg ?? `OneBot send_private_msg (image) failed (retcode=${res?.retcode})`);
     }
     log.info?.(`[onebot] sendPrivateImage done: retcode=${res?.retcode ?? "?"}`);
-    return res?.data?.message_id;
+    const mid = res?.data?.message_id;
+    logSend("connection", "sendPrivateImage", { targetId: userId, messageId: mid, sessionId: getActiveReplyTarget(), replySessionId: getActiveReplySessionId() });
+    return mid;
 }
-export async function uploadGroupFile(groupId, file, name) {
-    if (!ws || ws.readyState !== WebSocket.OPEN)
-        throw new Error("OneBot WebSocket not connected");
-    await sendOneBotAction(ws, "upload_group_file", { group_id: groupId, file, name });
+export async function uploadGroupFile(groupId, file, name, getConfig) {
+    const socket = getConfig
+        ? await ensureConnection(getConfig)
+        : await waitForConnection();
+    const res = await sendOneBotAction(socket, "upload_group_file", { group_id: groupId, file, name });
+    if (res?.retcode !== 0) {
+        throw new Error(res?.msg ?? `OneBot upload_group_file failed (retcode=${res?.retcode})`);
+    }
 }
-export async function uploadPrivateFile(userId, file, name) {
-    if (!ws || ws.readyState !== WebSocket.OPEN)
-        throw new Error("OneBot WebSocket not connected");
-    await sendOneBotAction(ws, "upload_private_file", { user_id: userId, file, name });
+export async function uploadPrivateFile(userId, file, name, getConfig) {
+    const socket = getConfig
+        ? await ensureConnection(getConfig)
+        : await waitForConnection();
+    const res = await sendOneBotAction(socket, "upload_private_file", { user_id: userId, file, name });
+    if (res?.retcode !== 0) {
+        throw new Error(res?.msg ?? `OneBot upload_private_file failed (retcode=${res?.retcode})`);
+    }
 }
 /** 撤回消息 */
 export async function deleteMsg(messageId) {
@@ -316,6 +457,49 @@ export async function getGroupMemberInfo(groupId, userId) {
         return null;
     }
 }
+/**
+ * 获取群成员列表（OneBot get_group_member_list）
+ */
+export async function getGroupMemberList(groupId) {
+    if (!ws || ws.readyState !== WebSocket.OPEN)
+        return [];
+    try {
+        const res = await sendOneBotAction(ws, "get_group_member_list", { group_id: groupId });
+        if (res?.retcode !== 0 || !Array.isArray(res?.data))
+            return [];
+        return res.data.map((m) => ({
+            user_id: Number(m.user_id),
+            nickname: String(m.nickname ?? ""),
+            card: String(m.card ?? ""),
+        }));
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * 按名字模糊匹配群成员（匹配群名片 card 与昵称 nickname），返回匹配到的 QQ 与展示名。
+ * 使用 Fuse.js 模糊匹配，结果按相关度排序。
+ */
+export async function searchGroupMemberByName(groupId, name) {
+    const list = await getGroupMemberList(groupId);
+    const keyword = (name || "").trim();
+    if (!keyword)
+        return [];
+    const fuse = new Fuse(list, {
+        keys: ["card", "nickname"],
+        includeScore: true,
+        threshold: 0.4,
+        ignoreLocation: true,
+    });
+    const results = fuse.search(keyword);
+    return results.map(({ item: m }) => ({
+        user_id: m.user_id,
+        nickname: m.nickname,
+        card: m.card,
+        displayName: m.card || m.nickname || String(m.user_id),
+    }));
+}
 /** 获取群信息（含 group_name） */
 export async function getGroupInfo(groupId) {
     if (!ws || ws.readyState !== WebSocket.OPEN)
@@ -349,20 +533,24 @@ export async function getMsg(messageId) {
     }
 }
 /**
- * 获取群聊历史消息（Lagrange.Core 扩展 API，go-cqhttp 等可能不支持）
+ * 获取群聊历史消息（Lagrange.Core 扩展 API，与 Lagrange.onebot context 一致）
+ * 仅使用 message_seq 分页（不传 message_id），与 Tiphareth getLast24HGroupMessages 调用方式一致。
  * @param groupId 群号
- * @param opts message_seq 起始序号；message_id 起始消息 ID；count 数量
+ * @param opts message_seq 起始序号（不传表示从最新一页）；count 本页条数；reverse_order true 表示从旧到新，便于用 batch[0].message_seq 向前翻页
  */
 export async function getGroupMsgHistory(groupId, opts = { count: 20 }) {
     if (!ws || ws.readyState !== WebSocket.OPEN)
         return [];
     try {
-        const res = await sendOneBotAction(ws, "get_group_msg_history", {
+        const params = {
             group_id: groupId,
-            message_seq: opts.message_seq,
-            message_id: opts.message_id,
             count: opts.count ?? 20,
-        });
+            reverse_order: opts.reverse_order !== false,
+        };
+        if (opts.message_seq != null && Number.isFinite(opts.message_seq)) {
+            params.message_seq = opts.message_seq;
+        }
+        const res = await sendOneBotAction(ws, "get_group_msg_history", params);
         if (res?.retcode === 0 && res?.data?.messages)
             return res.data.messages;
         return [];
@@ -371,6 +559,56 @@ export async function getGroupMsgHistory(groupId, opts = { count: 20 }) {
         return [];
     }
 }
+/** 单页请求之间的延迟（毫秒），与 Tiphareth historyMessages 一致 */
+const HISTORY_PAGE_DELAY_MS = 500;
+/**
+ * 按时间范围分页获取群历史消息，严格对齐 Tiphareth getLast24HGroupMessages 算法：
+ * getGroupMsgHistory(groupId, messageSeq, chunkSize, true)，用 batch[0] 的 message_seq 向前翻页，去重与时间截断。
+ * @param groupId 群号
+ * @param opts startTime 仅保留 >= startTime 的消息（Unix 秒）；limit 最多条数；chunkSize 每页条数
+ */
+export async function getGroupMsgHistoryInRange(groupId, opts = {}) {
+    const { startTime = 0, limit = 3000, chunkSize = 100 } = opts;
+    let messageSeq = undefined;
+    const allMessages = [];
+    const seenMessageIds = new Set();
+    let stopLoop = false;
+    let pageCount = 0;
+    while (!stopLoop) {
+        pageCount++;
+        const batch = await getGroupMsgHistory(groupId, {
+            message_seq: messageSeq,
+            count: chunkSize,
+            reverse_order: true,
+        });
+        if (!batch.length) {
+            break;
+        }
+        await new Promise((r) => setTimeout(r, HISTORY_PAGE_DELAY_MS));
+        for (const msg of batch) {
+            if (seenMessageIds.has(msg.message_id))
+                continue;
+            seenMessageIds.add(msg.message_id);
+            if (msg.time < startTime) {
+                stopLoop = true;
+            }
+            else {
+                allMessages.push(msg);
+            }
+        }
+        const oldest = batch[0];
+        const nextSeq = oldest.message_seq ?? oldest.message_id;
+        if (nextSeq == null || nextSeq === messageSeq) {
+            break;
+        }
+        messageSeq = nextSeq;
+        if (allMessages.length >= limit) {
+            break;
+        }
+    }
+    allMessages.sort((a, b) => a.time - b.time);
+    return allMessages;
+}
 export async function connectForward(config) {
     const path = config.path ?? "/onebot/v11/ws";
     const pathNorm = path.startsWith("/") ? path : `/${path}`;
@@ -384,6 +622,7 @@ export async function connectForward(config) {
         w.on("open", () => resolve());
         w.on("error", reject);
     });
+    w.__onebotPeerHost = config.host;
     return w;
 }
 export async function createServerAndWait(config) {
@@ -398,7 +637,8 @@ export async function createServerAndWait(config) {
     server.listen(config.port, host);
     wsServer = wss;
     return new Promise((resolve) => {
-        wss.on("connection", (socket) => {
+        wss.on("connection", (socket, req) => {
+            socket.__onebotPeerHost = req.socket.remoteAddress ?? undefined;
             resolve(socket);
         });
     });

package/dist/handlers/group-increase.d.ts

@@ -3,7 +3,8 @@
  *
  * 支持：
  * 1. 简单文本模板（message），占位符：{name}、{userId}、{groupName}、{groupId}、{avatarUrl}
- * 2. 自定义 handler 脚本，可生成图片并返回，接收完整上下文
+ * 2. 自定义 command：在 cwd 下用系统 shell 执行命令，通过环境变量传入上下文
+ *    命令自行负责发送（如调用 openclaw message send），或向 stdout 输出 JSON 行供本 handler 发送
  */
 import type { OneBotMessage } from "../types.js";
 export interface GroupIncreaseContext {

package/dist/handlers/group-increase.js

@@ -3,11 +3,14 @@
  *
  * 支持：
  * 1. 简单文本模板（message），占位符：{name}、{userId}、{groupName}、{groupId}、{avatarUrl}
- * 2. 自定义 handler 脚本，可生成图片并返回，接收完整上下文
+ * 2. 自定义 command：在 cwd 下用系统 shell 执行命令，通过环境变量传入上下文
+ *    命令自行负责发送（如调用 openclaw message send），或向 stdout 输出 JSON 行供本 handler 发送
  */
 import { sendGroupMsg, sendGroupImage, getStrangerInfo, getGroupMemberInfo, getGroupInfo, getAvatarUrl, } from "../connection.js";
-import { loadScript } from "../load-script.js";
+import { getRenderMarkdownToPlain } from "../config.js";
+import { markdownToPlain } from "../markdown.js";
 import { resolve } from "path";
+import { spawn } from "child_process";
 async function resolveContext(groupId, userId) {
     const [groupInfo, memberInfo] = await Promise.all([
         getGroupInfo(groupId),
@@ -38,6 +41,49 @@ function applyTemplate(template, ctx) {
         .replace(/\{groupId\}/g, String(ctx.groupId))
         .replace(/\{avatarUrl\}/g, ctx.avatarUrl);
 }
+function escapeForShell(s) {
+    const str = String(s);
+    if (process.platform === "win32") {
+        return '"' + str.replace(/"/g, '""') + '"';
+    }
+    return '"' + str.replace(/\\/g, "\\\\").replace(/"/g, '\\"') + '"';
+}
+function runCommand(command, cwd, args, env) {
+    const fullCmd = `${command} --userId ${args.userId} --username ${escapeForShell(args.username)} --groupId ${args.groupId}`;
+    return new Promise((resolvePromise) => {
+        const isWin = process.platform === "win32";
+        const shell = isWin ? "cmd.exe" : "sh";
+        const shellArg = isWin ? "/c" : "-c";
+        const child = spawn(shell, [shellArg, fullCmd], {
+            cwd,
+            env: { ...process.env, ...env },
+            stdio: ["ignore", "pipe", "pipe"],
+        });
+        let stdout = "";
+        let stderr = "";
+        child.stdout?.on("data", (d) => { stdout += d.toString(); });
+        child.stderr?.on("data", (d) => { stderr += d.toString(); });
+        child.on("close", (code) => {
+            resolvePromise({ stdout, stderr, code });
+        });
+    });
+}
+function parseCommandOutput(stdout) {
+    const line = stdout.trim().split("\n").pop();
+    if (!line)
+        return null;
+    try {
+        const data = JSON.parse(line);
+        return {
+            text: typeof data.text === "string" ? data.text : undefined,
+            imagePath: typeof data.imagePath === "string" ? data.imagePath : undefined,
+            imageUrl: typeof data.imageUrl === "string" ? data.imageUrl : undefined,
+        };
+    }
+    catch {
+        return null;
+    }
+}
 export async function handleGroupIncrease(api, msg) {
     const cfg = api.config;
     const gi = cfg?.channels?.onebot?.groupIncrease;
@@ -54,24 +100,43 @@ export async function handleGroupIncrease(api, msg) {
         return;
     }
     let result = {};
-    const handlerPath = gi?.handler;
-    if (handlerPath?.trim()) {
+    const command = gi?.command?.trim();
+    const cwd = gi?.cwd?.trim();
+    if (command && cwd) {
+        const env = {
+            GROUP_ID: String(ctx.groupId),
+            GROUP_NAME: ctx.groupName,
+            USER_ID: String(ctx.userId),
+            USER_NAME: ctx.userName,
+            AVATAR_URL: ctx.avatarUrl,
+        };
+        const args = {
+            userId: String(ctx.userId),
+            username: ctx.userName,
+            groupId: String(ctx.groupId),
+        };
         try {
-            const mod = await loadScript(handlerPath);
-            const fn = mod?.default ?? mod?.generate ?? mod;
-            if (typeof fn === "function") {
-                result = (await fn(ctx)) ?? {};
+            const { stdout, stderr, code } = await runCommand(command, resolve(cwd), args, env);
+            if (stderr)
+                api.logger?.warn?.(`[onebot] groupIncrease command stderr: ${stderr}`);
+            if (code !== 0)
+                api.logger?.warn?.(`[onebot] groupIncrease command exit code: ${code}`);
+            const parsed = parseCommandOutput(stdout);
+            if (parsed && (parsed.text || parsed.imagePath || parsed.imageUrl)) {
+                result = parsed;
             }
         }
         catch (e) {
-            api.logger?.error?.(`[onebot] groupIncrease handler failed: ${e?.message}`);
+            api.logger?.error?.(`[onebot] groupIncrease command failed: ${e?.message}`);
         }
     }
     const message = gi?.message;
-    if (message?.trim() && !result.text) {
+    if (message?.trim() && !result.text && !command) {
         result.text = applyTemplate(message, ctx);
     }
-    const text = (result.text ?? "").trim();
+    let text = (result.text ?? "").trim();
+    if (text && getRenderMarkdownToPlain(cfg))
+        text = markdownToPlain(text);
     const imagePath = result.imagePath?.trim();
     const imageUrl = result.imageUrl?.trim();
     if (!text && !imagePath && !imageUrl)
@@ -80,9 +145,10 @@ export async function handleGroupIncrease(api, msg) {
         if (text)
             await sendGroupMsg(groupId, text);
         if (imagePath) {
+            const baseDir = cwd || process.cwd();
             const abs = imagePath.startsWith("file://") || imagePath.startsWith("http://") || imagePath.startsWith("https://")
                 ? imagePath
-                : resolve(process.cwd(), imagePath);
+                : resolve(baseDir, imagePath);
             await sendGroupImage(groupId, abs);
         }
         if (imageUrl && !imagePath)

package/dist/handlers/process-inbound.d.ts

@@ -8,4 +8,22 @@ export declare const sessionHistories: Map<string, {
     timestamp: number;
     messageId: string;
 }[]>;
+export declare function startForwardCleanupTimer(): void;
 export declare function processInboundMessage(api: any, msg: OneBotMessage): Promise<void>;
+/** 回复会话上下文，供 onReplySessionEnd 钩子使用 */
+export interface ReplySessionContext {
+    /** 本次回复会话的唯一 ID，同一用户问题下的多次 deliver 共享此 ID */
+    replySessionId: string;
+    /** 会话标识，如 onebot:group:123 或 onebot:456 */
+    sessionId: string;
+    /** 回复目标，如 onebot:group:123 或 onebot:456 */
+    to: string;
+    /** 本次回复中已发送的所有块（按顺序） */
+    chunks: Array<{
+        index: number;
+        text?: string;
+        mediaUrl?: string;
+    }>;
+    /** 用户原始消息 */
+    userMessage: string;
+}