@openclaw/qqbot 2026.6.5-beta.1 → 2026.6.5-beta.3

package/dist/{channel-BLMrGYfg.js → channel-CcN43bPL.js}

@@ -1,6 +1,9 @@
-import { c as getPlatformAdapter, t as asOptionalObjectRecord } from "./string-normalize-R_0cKO7Q.js";
-import { a as qqbotSetupAdapterShared, c as listQQBotAccountIds, i as qqbotMeta, m as getBridgeLogger, n as qqbotSetupWizard, o as DEFAULT_ACCOUNT_ID$1, p as ensurePlatformAdapter, r as qqbotConfigAdapter, s as applyQQBotAccountConfig, t as qqbotChannelConfigSchema, u as resolveQQBotAccount } from "./config-schema-BI7AYP6Q.js";
-import { T as debugWarn, t as getQQBotRuntime, w as debugLog, z as formatErrorMessage } from "./runtime-BSgtMZ6G.js";
+import { t as asOptionalObjectRecord } from "./string-normalize-R_0cKO7Q.js";
+import { a as qqbotSetupAdapterShared, i as qqbotMeta, n as qqbotSetupWizard, o as ensurePlatformAdapter, r as qqbotConfigAdapter, s as getBridgeLogger, t as qqbotChannelConfigSchema } from "./config-schema-BFLNZ8Nf.js";
+import { a as resolveQQBotAccount, n as applyQQBotAccountConfig, r as listQQBotAccountIds, t as DEFAULT_ACCOUNT_ID$1 } from "./config-ZEfgeoL4.js";
+import { t as getQQBotRuntime } from "./runtime-B9UoQ5NI.js";
+import { n as normalizeCompatibilityConfig, t as legacyConfigRules } from "./doctor-contract-BYTS8-ia.js";
+import { n as normalizeTarget, s as getQQBotDataPath, t as looksLikeQQBotTarget } from "./target-parser-BdCUmxK7.js";
 import { getExecApprovalReplyMetadata } from "openclaw/plugin-sdk/approval-runtime";
 import { createMessageReceiptFromOutboundResults, defineChannelMessageAdapter } from "openclaw/plugin-sdk/channel-outbound";
 import { sanitizeAssistantVisibleText } from "openclaw/plugin-sdk/text-chunking";
@@ -11,14 +14,12 @@ import { normalizeLowercaseStringOrEmpty, normalizeOptionalString } from "opencl
 import { markImplicitSameChatApprovalAuthorization, resolveApprovalApprovers } from "openclaw/plugin-sdk/approval-auth-runtime";
 import { createChannelExecApprovalProfile, isChannelExecApprovalClientEnabledFromConfig, matchesApprovalRequestFilters } from "openclaw/plugin-sdk/approval-client-runtime";
 import { normalizeAccountId } from "openclaw/plugin-sdk/routing";
-import * as fs$1 from "node:fs";
 import fs from "node:fs";
-import * as os$1 from "node:os";
 import crypto from "node:crypto";
-import * as path$1 from "node:path";
 import path from "node:path";
 import { loadJsonFile } from "openclaw/plugin-sdk/json-store";
 import { resolveStateDir } from "openclaw/plugin-sdk/state-paths";
+import { resolveChannelGroupToolsPolicy } from "openclaw/plugin-sdk/channel-policy";
 //#region extensions/qqbot/src/engine/approval/index.ts
 function buildExecApprovalText(request) {
 	const expiresIn = Math.max(0, Math.round((request.expiresAtMs - Date.now()) / 1e3));
@@ -376,7 +377,7 @@ function createQQBotApprovalCapability() {
 			},
 			load: async () => {
 				ensurePlatformAdapter();
-				return (await import("./handler-runtime-CjXwuNlq.js")).qqbotApprovalNativeRuntime;
+				return (await import("./handler-runtime-JKYDlRdq.js")).qqbotApprovalNativeRuntime;
 			}
 		})
 	});
@@ -412,6 +413,12 @@ async function writeOpenClawConfigThroughRuntime(runtime, cfg) {
 	});
 }
 //#endregion
+//#region extensions/qqbot/src/doctor.ts
+const qqbotDoctor = {
+	legacyConfigRules,
+	normalizeCompatibilityConfig
+};
+//#endregion
 //#region extensions/qqbot/src/engine/utils/data-paths.ts
 /**
 * Centralised filename helpers for persisted QQBot state.
@@ -447,215 +454,6 @@ function getLegacyCredentialBackupFile() {
 	return path.join(getCredentialBackupRoot(), "credential-backup.json");
 }
 //#endregion
-//#region extensions/qqbot/src/engine/utils/platform.ts
-/**
-* Cross-platform path and detection helpers for core/ modules.
-*
-* Provides home/data/media directory helpers, platform detection,
-* silk-wasm availability checks — all without importing `openclaw/plugin-sdk`.
-* The temp-directory fallback is delegated to the PlatformAdapter.
-*/
-/**
-* Resolve the current user's OS home directory safely across platforms.
-*
-* Priority:
-* 1. `os.homedir()`
-* 2. `$HOME` or `%USERPROFILE%`
-* 3. PlatformAdapter.getTempDir() as a last resort
-*
-* This is the *operating-system* home and intentionally ignores
-* `OPENCLAW_HOME`. QQ Bot still checks this tree for legacy state imports and
-* media-path remaps from older releases.
-*/
-function getHomeDir() {
-	try {
-		const home = os$1.homedir();
-		if (home && fs$1.existsSync(home)) return home;
-	} catch {}
-	const envHome = process.env.HOME || process.env.USERPROFILE;
-	if (envHome && fs$1.existsSync(envHome)) return envHome;
-	return getPlatformAdapter().getTempDir();
-}
-/**
-* Resolve the effective OpenClaw home directory.
-*
-* Mirrors the contract from core (`src/infra/home-dir.ts::resolveEffectiveHomeDir`)
-* so QQ Bot media roots live under the same tree the rest of OpenClaw treats as
-* `~`. The extension cannot import the core helper directly (it is a separate
-* package with `openclaw` as a peer dependency), so this re-implements the
-* minimal contract:
-*
-* 1. `OPENCLAW_HOME` when set (with `~` / `~/...` expanded against the OS home).
-* 2. Otherwise fall back to {@link getHomeDir} so existing single-home
-*    deployments are unaffected.
-*
-* Empty / `"undefined"` / `"null"` strings are treated as unset to match how
-* core normalizes the variable.
-*/
-function resolveOpenClawHome() {
-	const raw = process.env.OPENCLAW_HOME?.trim();
-	if (!raw || raw === "undefined" || raw === "null") return getHomeDir();
-	if (raw === "~" || raw.startsWith("~/") || raw.startsWith("~\\")) {
-		const osHome = getHomeDir();
-		if (raw === "~") return osHome;
-		return path$1.join(osHome, raw.slice(2));
-	}
-	return raw;
-}
-/**
-* Return a legacy path under `~/.openclaw/qqbot` without creating it.
-*
-* Current QQ Bot runtime state lives in plugin SQLite KV. This path remains for
-* legacy imports and media-path remaps from older releases.
-*/
-function getQQBotDataPath(...subPaths) {
-	return path$1.join(getHomeDir(), ".openclaw", "qqbot", ...subPaths);
-}
-/** Return a path under `~/.openclaw/qqbot`, creating it on demand. */
-function getQQBotDataDir(...subPaths) {
-	const dir = getQQBotDataPath(...subPaths);
-	if (!fs$1.existsSync(dir)) fs$1.mkdirSync(dir, { recursive: true });
-	return dir;
-}
-/**
-* Return a path under `<openclaw-home>/.openclaw/media/qqbot` without creating it.
-*
-* Unlike `getQQBotDataPath`, this lives under OpenClaw's core media allowlist
-* so downloaded images and audio can be accessed by framework media tooling.
-* The base honors `OPENCLAW_HOME` (when set) so files written by agents into
-* the OpenClaw-managed media tree are reachable by this plugin even when
-* `HOME` and `OPENCLAW_HOME` differ (Docker, multi-user hosts). Fixes #83562.
-*/
-function getQQBotMediaPath(...subPaths) {
-	return path$1.join(resolveOpenClawHome(), ".openclaw", "media", "qqbot", ...subPaths);
-}
-/** Return a path under `<openclaw-home>/.openclaw/media/qqbot`, creating it on demand. */
-function getQQBotMediaDir(...subPaths) {
-	const dir = getQQBotMediaPath(...subPaths);
-	if (!fs$1.existsSync(dir)) fs$1.mkdirSync(dir, { recursive: true });
-	return dir;
-}
-/**
-* Return `<openclaw-home>/.openclaw/media`, OpenClaw's shared media root.
-*
-* This mirrors the directory that core's `buildMediaLocalRoots` exposes as an
-* allowlisted location (see `openclaw/src/media/local-roots.ts`). Using it as a
-* QQ Bot payload root lets the plugin trust framework-produced files that live
-* in sibling subdirectories such as `outbound/` (written by
-* `saveMediaBuffer(..., "outbound", ...)`) or `inbound/`, while still keeping
-* the check anchored to a single, well-known directory. Like
-* {@link getQQBotMediaPath}, the base honors `OPENCLAW_HOME`.
-*/
-function getOpenClawMediaDir() {
-	return path$1.join(resolveOpenClawHome(), ".openclaw", "media");
-}
-function isWindows() {
-	return process.platform === "win32";
-}
-/** Return the preferred temporary directory. */
-function getTempDir() {
-	return getPlatformAdapter().getTempDir();
-}
-let silkWasmAvailable = null;
-/** Check whether silk-wasm can run in the current environment. */
-async function checkSilkWasmAvailable() {
-	if (silkWasmAvailable !== null) return silkWasmAvailable;
-	try {
-		const { isSilk } = await import("silk-wasm");
-		isSilk(new Uint8Array(0));
-		silkWasmAvailable = true;
-		debugLog("[platform] silk-wasm: available");
-	} catch (err) {
-		silkWasmAvailable = false;
-		debugWarn(`[platform] silk-wasm: NOT available (${formatErrorMessage(err)})`);
-	}
-	return silkWasmAvailable;
-}
-/** Expand `~` to the current user's home directory. */
-function expandTilde(p) {
-	if (!p) return p;
-	if (p === "~") return getHomeDir();
-	if (p.startsWith("~/") || p.startsWith("~\\")) return path$1.join(getHomeDir(), p.slice(2));
-	return p;
-}
-/** Normalize a user-provided path by trimming, stripping `file://`, and expanding `~`. */
-function normalizePath(p) {
-	let result = p.trim();
-	if (result.startsWith("file://")) {
-		result = result.slice(7);
-		try {
-			result = decodeURIComponent(result);
-		} catch {}
-	}
-	return expandTilde(result);
-}
-/** Return true when the string looks like a local filesystem path rather than a URL. */
-function isLocalPath(p) {
-	if (!p) return false;
-	if (p.startsWith("file://")) return true;
-	if (p === "~" || p.startsWith("~/") || p.startsWith("~\\")) return true;
-	if (p.startsWith("/")) return true;
-	if (/^[a-zA-Z]:[\\/]/.test(p)) return true;
-	if (p.startsWith("\\\\")) return true;
-	if (p.startsWith("./") || p.startsWith("../")) return true;
-	if (p.startsWith(".\\") || p.startsWith("..\\")) return true;
-	return false;
-}
-function isPathWithinRoot(candidate, root) {
-	const relative = path$1.relative(root, candidate);
-	return relative === "" || !relative.startsWith("..") && !path$1.isAbsolute(relative);
-}
-/** Remap legacy or hallucinated QQ Bot local media paths to real files when possible. */
-function resolveQQBotLocalMediaPath(p) {
-	const normalized = normalizePath(p);
-	if (!isLocalPath(normalized) || fs$1.existsSync(normalized)) return normalized;
-	const osHomeDir = getHomeDir();
-	const openclawHomeDir = resolveOpenClawHome();
-	const mediaRoot = getQQBotMediaPath();
-	const dataRoot = getQQBotDataPath();
-	const candidateRoots = [
-		...Array.from(new Set([path$1.join(osHomeDir, ".openclaw", "workspace", "qqbot"), path$1.join(openclawHomeDir, ".openclaw", "workspace", "qqbot")])).map((from) => ({
-			from,
-			to: mediaRoot
-		})),
-		{
-			from: dataRoot,
-			to: mediaRoot
-		},
-		{
-			from: mediaRoot,
-			to: dataRoot
-		}
-	];
-	for (const { from, to } of candidateRoots) {
-		if (!isPathWithinRoot(normalized, from)) continue;
-		const relative = path$1.relative(from, normalized);
-		const candidate = path$1.join(to, relative);
-		if (fs$1.existsSync(candidate)) {
-			debugWarn(`[platform] Remapped missing QQBot media path ${normalized} -> ${candidate}`);
-			return candidate;
-		}
-	}
-	return normalized;
-}
-/**
-* Resolve a structured-payload local file path and enforce that it stays within
-* QQ Bot-owned storage roots.
-*/
-function resolveQQBotPayloadLocalFilePath(p) {
-	const candidate = resolveQQBotLocalMediaPath(p);
-	if (!candidate.trim()) return null;
-	const resolvedCandidate = path$1.resolve(candidate);
-	if (!fs$1.existsSync(resolvedCandidate)) return null;
-	const canonicalCandidate = fs$1.realpathSync(resolvedCandidate);
-	const allowedRoots = [getOpenClawMediaDir(), getQQBotMediaPath()];
-	for (const root of allowedRoots) {
-		const resolvedRoot = path$1.resolve(root);
-		if (isPathWithinRoot(canonicalCandidate, fs$1.existsSync(resolvedRoot) ? fs$1.realpathSync(resolvedRoot) : resolvedRoot)) return canonicalCandidate;
-	}
-	return null;
-}
-//#endregion
 //#region extensions/qqbot/src/engine/utils/sqlite-state.ts
 function resolveStoreEnv(options) {
 	if (!options.stateDir) return options.env;
@@ -851,85 +649,30 @@ function clearAccountCredentials(cfg, accountId) {
 	};
 }
 //#endregion
-//#region extensions/qqbot/src/engine/messaging/target-parser.ts
-/**
-* Parse a qqbot target string into a structured delivery target.
-*
-* Supported formats:
-* - `qqbot:c2c:openid` → C2C direct message
-* - `qqbot:group:groupid` → Group message
-* - `qqbot:channel:channelid` → Channel message
-* - `c2c:openid` → C2C (without qqbot: prefix)
-* - `group:groupid` → Group (without qqbot: prefix)
-* - `channel:channelid` → Channel (without qqbot: prefix)
-* - `openid` → C2C (bare openid, default)
-*
-* @param to - Raw target string.
-* @returns Parsed target with type and id.
-* @throws {Error} When the target format is invalid.
-*/
-function parseTarget(to) {
-	const id = to.replace(/^qqbot:/i, "");
-	if (id.startsWith("c2c:")) {
-		const userId = id.slice(4);
-		if (!userId) throw new Error(`Invalid c2c target format: ${to} - missing user ID`);
-		return {
-			type: "c2c",
-			id: userId
-		};
-	}
-	if (id.startsWith("group:")) {
-		const groupId = id.slice(6);
-		if (!groupId) throw new Error(`Invalid group target format: ${to} - missing group ID`);
-		return {
-			type: "group",
-			id: groupId
-		};
-	}
-	if (id.startsWith("channel:")) {
-		const channelId = id.slice(8);
-		if (!channelId) throw new Error(`Invalid channel target format: ${to} - missing channel ID`);
-		return {
-			type: "channel",
-			id: channelId
-		};
-	}
-	if (!id) throw new Error(`Invalid target format: ${to} - empty ID after removing qqbot: prefix`);
-	return {
-		type: "c2c",
-		id
-	};
-}
-/**
-* Normalize a QQ Bot target string into the canonical `qqbot:...` form.
-*
-* Returns `undefined` when the target does not look like a QQ Bot address.
-*/
-function normalizeTarget(target) {
-	const id = target.replace(/^qqbot:/i, "");
-	if (id.startsWith("c2c:") || id.startsWith("group:") || id.startsWith("channel:")) return `qqbot:${id}`;
-	if (/^[0-9a-fA-F]{32}$/.test(id)) return `qqbot:c2c:${id}`;
-	if (/^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/.test(id)) return `qqbot:c2c:${id}`;
-}
-/**
-* Return true when the string looks like a QQ Bot target ID.
-*/
-function looksLikeQQBotTarget(id) {
-	if (/^qqbot:(c2c|group|channel):/i.test(id)) return true;
-	if (/^(c2c|group|channel):/i.test(id)) return true;
-	if (/^[0-9a-fA-F]{32}$/.test(id)) return true;
-	return /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/.test(id);
+//#region extensions/qqbot/src/group-policy.ts
+function resolveQQBotGroupToolPolicy(params) {
+	return resolveChannelGroupToolsPolicy({
+		cfg: params.cfg,
+		channel: "qqbot",
+		groupId: params.groupId,
+		groupIdCaseInsensitive: true,
+		accountId: params.accountId,
+		senderId: params.senderId,
+		senderName: params.senderName,
+		senderUsername: params.senderUsername,
+		senderE164: params.senderE164
+	});
 }
 //#endregion
 //#region extensions/qqbot/src/channel.ts
 let gatewayModulePromise;
 function loadGatewayModule() {
-	gatewayModulePromise ??= import("./gateway-iL9SWAED.js");
+	gatewayModulePromise ??= import("./gateway-DdM2k3ss.js");
 	return gatewayModulePromise;
 }
 let outboundMessagingModulePromise;
 function loadOutboundMessagingModule() {
-	outboundMessagingModulePromise ??= import("./outbound-CEqyriPT.js").then((n) => n.t);
+	outboundMessagingModulePromise ??= import("./outbound-C9wV892v.js").then((n) => n.t);
 	return outboundMessagingModulePromise;
 }
 function createQQBotSendReceipt(params) {
@@ -1045,6 +788,7 @@ const qqbotPlugin = {
 	},
 	reload: { configPrefixes: ["channels.qqbot"] },
 	configSchema: qqbotChannelConfigSchema,
+	doctor: qqbotDoctor,
 	config: {
 		...qqbotConfigAdapter,
 		/**
@@ -1062,6 +806,7 @@ const qqbotPlugin = {
 	},
 	setup: { ...qqbotSetupAdapterShared },
 	approvalCapability: getQQBotApprovalCapability(),
+	groups: { resolveToolPolicy: resolveQQBotGroupToolPolicy },
 	message: qqbotMessageAdapter,
 	messaging: {
 		targetPrefixes: ["qqbot"],
@@ -1203,4 +948,4 @@ const qqbotPlugin = {
 	}
 };
 //#endregion
-export { buildExecApprovalText as C, resolveApprovalTarget as E, buildApprovalKeyboard as S, parseApprovalButtonData as T, authorizeQQBotApprovalAction as _, checkSilkWasmAvailable as a, resolveQQBotExecApprovalConfig as b, getQQBotDataPath as c, getTempDir as d, isLocalPath as f, toGatewayAccount as g, resolveQQBotPayloadLocalFilePath as h, openQQBotSyncKeyedStore as i, getQQBotMediaDir as l, normalizePath as m, parseTarget as n, getHomeDir as o, isWindows as p, buildQQBotStateKey as r, getQQBotDataDir as s, qqbotPlugin as t, getQQBotMediaPath as u, isQQBotExecApprovalClientEnabled as v, buildPluginApprovalText as w, shouldHandleQQBotExecApprovalRequest as x, matchesQQBotApprovalAccount as y };
+export { authorizeQQBotApprovalAction as a, resolveQQBotExecApprovalConfig as c, buildExecApprovalText as d, buildPluginApprovalText as f, toGatewayAccount as i, shouldHandleQQBotExecApprovalRequest as l, resolveApprovalTarget as m, buildQQBotStateKey as n, isQQBotExecApprovalClientEnabled as o, parseApprovalButtonData as p, openQQBotSyncKeyedStore as r, matchesQQBotApprovalAccount as s, qqbotPlugin as t, buildApprovalKeyboard as u };

package/dist/channel-entry-api.js

@@ -0,0 +1,2 @@
+import { t as registerQQBotFull } from "./channel-entry-fUBLXKPr.js";
+export { registerQQBotFull };

package/dist/channel-entry-fUBLXKPr.js

@@ -0,0 +1,143 @@
+import { a as resolveQQBotAccount } from "./config-ZEfgeoL4.js";
+import { t as getFrameworkCommands } from "./slash-commands-impl-FRw-Dl44.js";
+import { t as registerQQBotTools } from "./tools-2d9t-N1b.js";
+import { h as sendDocument } from "./outbound-C9wV892v.js";
+//#region extensions/qqbot/src/bridge/commands/framework-context-adapter.ts
+/**
+* Default queue snapshot used for framework-registered commands.
+*
+* Framework-side command dispatch runs outside the per-sender queue, so
+* handlers observe an empty snapshot by design.
+*/
+const DEFAULT_QUEUE_SNAPSHOT = {
+	totalPending: 0,
+	activeUsers: 0,
+	maxConcurrentUsers: 10,
+	senderPending: 0
+};
+function buildFrameworkSlashContext({ ctx, account, from, commandName }) {
+	const args = ctx.args ?? "";
+	const rawContent = args ? `/${commandName} ${args}` : `/${commandName}`;
+	return {
+		type: from.msgType,
+		senderId: ctx.senderId ?? "",
+		messageId: "",
+		eventTimestamp: (/* @__PURE__ */ new Date()).toISOString(),
+		receivedAt: Date.now(),
+		rawContent,
+		args,
+		accountId: account.accountId,
+		appId: account.appId,
+		accountConfig: account.config,
+		commandAuthorized: ctx.isAuthorizedSender,
+		queueSnapshot: { ...DEFAULT_QUEUE_SNAPSHOT }
+	};
+}
+//#endregion
+//#region extensions/qqbot/src/bridge/commands/from-parser.ts
+const MSG_TYPE_MAP = {
+	c2c: "c2c",
+	dm: "dm",
+	group: "group",
+	channel: "guild"
+};
+const TARGET_TYPE_MAP = {
+	c2c: "c2c",
+	dm: "dm",
+	group: "group",
+	channel: "channel"
+};
+function isFromKind(value) {
+	return value === "c2c" || value === "dm" || value === "group" || value === "channel";
+}
+/**
+* Parse `ctx.from` into the structured fields the QQBot bridge expects.
+*
+* Unknown or missing prefixes fall back to c2c. The remainder after the first
+* `:` is returned verbatim as the target id, matching what the previous inline
+* implementation did.
+*/
+function parseQQBotFrom(from) {
+	const stripped = (from ?? "").replace(/^qqbot:/iu, "");
+	const colonIdx = stripped.indexOf(":");
+	const rawPrefix = colonIdx === -1 ? stripped : stripped.slice(0, colonIdx);
+	const targetId = colonIdx === -1 ? stripped : stripped.slice(colonIdx + 1);
+	const kind = isFromKind(rawPrefix) ? rawPrefix : "c2c";
+	return {
+		msgType: MSG_TYPE_MAP[kind],
+		targetType: TARGET_TYPE_MAP[kind],
+		targetId
+	};
+}
+//#endregion
+//#region extensions/qqbot/src/bridge/commands/result-dispatcher.ts
+const UNEXPECTED_RESULT_TEXT = "⚠️ 命令返回了意外结果。";
+function hasFilePath(value) {
+	return typeof value === "object" && value !== null && "filePath" in value && typeof value.filePath === "string";
+}
+function buildMediaTarget(account, from) {
+	return {
+		targetType: from.targetType,
+		targetId: from.targetId,
+		account
+	};
+}
+async function dispatchFrameworkSlashResult({ result, account, from, logger }) {
+	if (typeof result === "string") return { text: result };
+	if (hasFilePath(result)) {
+		const mediaCtx = buildMediaTarget(account, from);
+		try {
+			await sendDocument(mediaCtx, result.filePath, { allowQQBotDataDownloads: true });
+		} catch (err) {
+			logger?.warn(`framework slash file send failed: ${String(err)}`);
+		}
+		return { text: result.text };
+	}
+	return { text: UNEXPECTED_RESULT_TEXT };
+}
+//#endregion
+//#region extensions/qqbot/src/bridge/commands/framework-registration.ts
+const PRIVATE_CHAT_ONLY_TEXT = "💡 请在私聊中使用此指令";
+function isExplicitQQBotC2cFrom(from) {
+	const raw = (from ?? "").trim();
+	const stripped = raw.replace(/^qqbot:/iu, "");
+	const colonIdx = stripped.indexOf(":");
+	if (colonIdx === -1) return false;
+	const kind = stripped.slice(0, colonIdx).toLowerCase();
+	const targetId = stripped.slice(colonIdx + 1).trim();
+	return /^qqbot:/iu.test(raw) && kind === "c2c" && targetId.length > 0;
+}
+function registerQQBotFrameworkCommands(api) {
+	for (const cmd of getFrameworkCommands()) api.registerCommand({
+		name: cmd.name,
+		description: cmd.description,
+		channels: ["qqbot"],
+		requireAuth: true,
+		acceptsArgs: true,
+		handler: async (ctx) => {
+			if (cmd.c2cOnly && !isExplicitQQBotC2cFrom(ctx.from)) return { text: PRIVATE_CHAT_ONLY_TEXT };
+			const from = parseQQBotFrom(ctx.from);
+			const account = resolveQQBotAccount(ctx.config, ctx.accountId ?? void 0);
+			const slashCtx = buildFrameworkSlashContext({
+				ctx,
+				account,
+				from,
+				commandName: cmd.name
+			});
+			return await dispatchFrameworkSlashResult({
+				result: await cmd.handler(slashCtx),
+				account,
+				from,
+				logger: api.logger
+			});
+		}
+	});
+}
+//#endregion
+//#region extensions/qqbot/src/bridge/channel-entry.ts
+function registerQQBotFull(api) {
+	registerQQBotTools(api);
+	registerQQBotFrameworkCommands(api);
+}
+//#endregion
+export { registerQQBotFull as t };

package/dist/channel-plugin-api.js

@@ -1,2 +1,2 @@
-import { t as qqbotPlugin } from "./channel-BLMrGYfg.js";
+import { t as qqbotPlugin } from "./channel-CcN43bPL.js";
 export { qqbotPlugin };

package/dist/{channel.setup-xBlmSU4X.js → channel.setup-CQ_DFfPx.js}

@@ -1,4 +1,4 @@
-import { a as qqbotSetupAdapterShared, i as qqbotMeta, n as qqbotSetupWizard, r as qqbotConfigAdapter, t as qqbotChannelConfigSchema } from "./config-schema-BI7AYP6Q.js";
+import { a as qqbotSetupAdapterShared, i as qqbotMeta, n as qqbotSetupWizard, r as qqbotConfigAdapter, t as qqbotChannelConfigSchema } from "./config-schema-BFLNZ8Nf.js";
 //#region extensions/qqbot/src/channel.setup.ts
 /**
 * Setup-only QQBot plugin — lightweight subset used during `openclaw onboard`