mioku-plugin-admin 2.3.1 → 2.3.3

package/commands/verify.ts

@@ -1,15 +1,20 @@
 import type { MiokiContext } from "mioki";
-import { getAtUserId, getMemberRole } from "../config";
+import { extractImageUrls, getAtUserId, getMemberRole } from "../config";
 import {
   getGroupVerifyConfig,
-  MAX_EXTRA_PROMPT_LENGTH,
-  normalizeExtraPrompt,
+  hasCustomPrompt,
+  MAX_CUSTOM_PROMPT_LENGTH,
+  normalizeCustomPrompt,
   normalizeVerifyMode,
   upsertGroupVerifyConfig,
   type VerifyConfig,
 } from "../verify/config";
 import { replyAdminErrorNotice } from "./notice";
 import type { VerifyController } from "../verify/types";
+import {
+  pruneGroupPromptImages,
+  saveRemoteImageAsPrompt,
+} from "../utils/prompt-image-store";
 
 export interface VerifyCommandOptions {
   ctx: MiokiContext;
@@ -24,6 +29,13 @@ const VERIFY_MODE_LABELS: Record<string, string> = {
   chiral: "手性碳",
 };
 
+async function extractQuoteImageUrls(event: any): Promise<string[]> {
+  if (!event || typeof event.getQuoteMsg !== "function") return [];
+  const quoteMsg = await event.getQuoteMsg().catch(() => null);
+  if (!quoteMsg || !Array.isArray(quoteMsg.message)) return [];
+  return extractImageUrls(quoteMsg.message);
+}
+
 export function registerVerifyCommands(options: VerifyCommandOptions) {
   const { ctx, getVerifyConfig, setVerifyConfig, verifyController } = options;
 
@@ -244,44 +256,113 @@ export function registerVerifyCommands(options: VerifyCommandOptions) {
       }
 
       // /入群提示 xxx
+      // /入群提示 关闭
+      // /入群提示（带图片，可来自当前消息或引用消息）— 仅图片也可
       if (text.startsWith("/入群提示") || text.startsWith("#入群提示")) {
         if (!(await ensureAdminPermission())) return;
 
         const rawArg = text.replace(/^[/#]入群提示\s*/, "").trim();
         const current = getVerifyConfig();
         const groupCfg = getGroupVerifyConfig(current, groupId);
+        const directImageUrls = extractImageUrls(event.message);
+        const quoteImageUrls = await extractQuoteImageUrls(event).catch(() => []);
+        const imageUrls =
+          directImageUrls.length > 0 ? directImageUrls : quoteImageUrls;
 
-        if (!rawArg) {
-          if (!groupCfg.extraPrompt) {
-            await event.reply("本群还没设置额外的入群提示词哦～", true);
+        if (rawArg === "关闭" || rawArg === "清空" || rawArg === "关") {
+          if (!hasCustomPrompt(groupCfg)) {
+            await event.reply("本群还没设置自定义入群提示哦～", true);
             return;
           }
-          await setVerifyConfig(
-            upsertGroupVerifyConfig(current, groupId, { extraPrompt: "" }),
+          const removedFile = groupCfg.promptImage;
+          const next = upsertGroupVerifyConfig(current, groupId, {
+            customPrompt: "",
+            promptImage: "",
+          });
+          await setVerifyConfig(next);
+          await pruneGroupPromptImages(groupId, []).catch(() => {});
+          ctx.logger.info(
+            `admin verify 关闭群 ${groupId} 自定义入群提示，清理图片 ${removedFile}`,
           );
-          await event.reply("已清空本群额外入群提示词～", true);
+          await event.reply("已关闭本群自定义入群提示～", true);
           return;
         }
 
-        const argLength = Array.from(rawArg).length;
-        if (argLength > MAX_EXTRA_PROMPT_LENGTH) {
-          await replyAdminErrorNotice({
-            ctx,
-            event,
-            instruction: `用户想设置本群入群提示词，但内容长度 ${argLength} 超过了上限 ${MAX_EXTRA_PROMPT_LENGTH} 字，请明确告诉用户最多 ${MAX_EXTRA_PROMPT_LENGTH} 字。`,
-            fallbackMessage: `最多 ${MAX_EXTRA_PROMPT_LENGTH} 字哦～当前 ${argLength} 字`,
-          });
+        if (!rawArg && !imageUrls.length) {
+          if (!hasCustomPrompt(groupCfg)) {
+            await event.reply(
+              "用法：/入群提示 xxx（最多 50 字），可附带图片（当前消息或引用消息中的图片）一起发送；/入群提示 关闭 关闭自定义提示～",
+              true,
+            );
+            return;
+          }
+          const lines = ["已开启本群自定义入群提示"];
+          lines.push(
+            groupCfg.customPrompt
+              ? `文字：${groupCfg.customPrompt}`
+              : "文字：（未设置）",
+          );
+          lines.push(
+            groupCfg.promptImage
+              ? `图片：已设置（filename=${groupCfg.promptImage}）`
+              : "图片：（未设置）",
+          );
+          await event.reply(lines.join("\n"), true);
           return;
         }
 
+        if (rawArg) {
+          const argLength = Array.from(rawArg).length;
+          if (argLength > MAX_CUSTOM_PROMPT_LENGTH) {
+            await replyAdminErrorNotice({
+              ctx,
+              event,
+              instruction: `用户想设置本群入群提示，但内容长度 ${argLength} 超过了上限 ${MAX_CUSTOM_PROMPT_LENGTH} 字，请明确告诉用户最多 ${MAX_CUSTOM_PROMPT_LENGTH} 字。`,
+              fallbackMessage: `最多 ${MAX_CUSTOM_PROMPT_LENGTH} 字哦～当前 ${argLength} 字`,
+            });
+            return;
+          }
+        }
+        const nextPrompt = rawArg
+          ? normalizeCustomPrompt(rawArg)
+          : groupCfg.customPrompt;
+
+        let nextImage = groupCfg.promptImage;
+        let imageNote = "";
+        if (imageUrls.length) {
+          const targetUrl = imageUrls[0];
+          const savedImage = await saveRemoteImageAsPrompt(groupId, targetUrl);
+          if (savedImage) {
+            const previousImage = groupCfg.promptImage;
+            nextImage = savedImage.filename;
+            imageNote = previousImage
+              ? `图片已替换（旧文件 ${previousImage} 已删除）`
+              : `图片已设置（${savedImage.filename}）`;
+            if (previousImage) {
+              ctx.logger.info(
+                `admin verify 替换群 ${groupId} 入群提示图片：${previousImage} -> ${savedImage.filename}`,
+              );
+            }
+          } else {
+            imageNote = "图片下载失败，请稍后重试";
+          }
+        }
+
         const next = upsertGroupVerifyConfig(current, groupId, {
-          extraPrompt: normalizeExtraPrompt(rawArg),
+          customPrompt: nextPrompt,
+          promptImage: nextImage,
         });
         await setVerifyConfig(next);
-        await event.reply(
-          `已设置本群额外入群提示词：${normalizeExtraPrompt(rawArg)}`,
-          true,
+        await pruneGroupPromptImages(groupId, nextImage ? [nextImage] : []).catch(
+          () => {},
         );
+
+        const lines = ["已更新本群自定义入群提示"];
+        if (rawArg) lines.push(`文字：${nextPrompt}`);
+        else if (groupCfg.customPrompt)
+          lines.push(`文字（保持）：${groupCfg.customPrompt}`);
+        if (imageUrls.length && imageNote) lines.push(imageNote);
+        await event.reply(lines.join("\n"), true);
         return;
       }
     } catch (err) {

package/config.md

@@ -100,11 +100,17 @@ fields:
             label: 手性碳
         description: 该群入群验证使用的模式
 
-      - key: extraPrompt
-        label: 群额外入群提示词
+      - key: customPrompt
+        label: 群自定义入群提示词
         type: textarea
-        description: 拼接在该群默认验证提示词之后发送，上限 50 字。可在群里直接用 /入群提示 xxx 设置或清空。
-        placeholder: 例：本群禁止复读机器人消息，请自觉
+        description: 一旦设置该群将跳过 AI 生成欢迎，验证通过后直接发送这段文字（可附带本地图片一起）。上限 50 字，建议在群里直接用 /入群提示 xxx 设置或 /入群提示 关闭 关闭。
+        placeholder: 例：欢迎来到本群，请先看群公告～
+
+      - key: promptImage
+        label: 群自定义入群提示图片
+        type: text
+        description: 单张图片文件名（保存在 data/admin/<群号>/prompt-images/），与文字一起发送。在群里发送 /入群提示 时附带图片（当前消息或引用消息中的图片均可）即可替换；/入群提示 关闭 会一并清空。
+        placeholder: 例：prompt-l8t9a-3f2c.png
 
   - key: verify.reactionEmojiId
     label: 回应模式表态表情ID

package/config.ts

@@ -113,6 +113,19 @@ export function extractImageUrl(message: RecvElement[]): string | undefined {
   return undefined;
 }
 
+export function extractImageUrls(message: RecvElement[]): string[] {
+  if (!Array.isArray(message)) return [];
+  const urls: string[] = [];
+  for (const seg of message) {
+    if (seg.type === "image") {
+      const imageSeg = seg as RecvImageElement;
+      const url = String(imageSeg.url || imageSeg.file || "").trim();
+      if (url) urls.push(url);
+    }
+  }
+  return urls;
+}
+
 // 从消息中提取被@的人的QQ号
 export function getAtUserId(message: RecvElement[]): number | undefined {
   if (!Array.isArray(message)) return undefined;

package/index.ts

@@ -81,6 +81,7 @@ export default definePlugin({
       aiService,
       getConfig,
       (info) => verifyController.handleMemberJoin(info),
+      (info) => verifyController.trySendCustomWelcome(info),
     );
 
     // 注册入群验证指令

package/notify/welcome.ts

@@ -74,6 +74,12 @@ async function flushBatch(options: {
   groupName: string;
   members: PendingMember[];
   promptInjections?: { content: string; title?: string }[];
+  tryCustomPrompt?: (info: {
+    selfId: number;
+    groupId: number;
+    userId: number;
+    groupName: string;
+  }) => Promise<boolean>;
 }): Promise<string> {
   const {
     ctx,
@@ -84,9 +90,24 @@ async function flushBatch(options: {
     groupName,
     members,
     promptInjections,
+    tryCustomPrompt,
   } = options;
   if (!members.length) return "";
 
+  if (tryCustomPrompt) {
+    let anyCustom = false;
+    for (const m of members) {
+      const handled = await tryCustomPrompt({
+        selfId,
+        groupId,
+        userId: m.userId,
+        groupName,
+      });
+      if (handled) anyCustom = true;
+    }
+    if (anyCustom) return "";
+  }
+
   const names = members.map((m) => m.memberName || String(m.userId));
   const userList = names.join("、");
   const userIdList = members.map((m) => String(m.userId)).join(", ");
@@ -140,6 +161,12 @@ async function sendSingleWelcome(options: {
   userId: number;
   memberName: string;
   promptInjections?: { content: string; title?: string }[];
+  tryCustomPrompt?: (info: {
+    selfId: number;
+    groupId: number;
+    userId: number;
+    groupName: string;
+  }) => Promise<boolean>;
 }): Promise<void> {
   const {
     ctx,
@@ -151,6 +178,7 @@ async function sendSingleWelcome(options: {
     userId,
     memberName,
     promptInjections,
+    tryCustomPrompt,
   } = options;
   const welcomeMessage = await flushBatch({
     ctx,
@@ -161,6 +189,7 @@ async function sendSingleWelcome(options: {
     groupName,
     members: [{ userId, memberName }],
     promptInjections,
+    tryCustomPrompt,
   });
   if (!welcomeMessage) return;
   const bot = ctx.pickBot(selfId);
@@ -182,6 +211,12 @@ export async function triggerSingleWelcome(options: {
   userId: number;
   memberName?: string;
   promptInjections?: { content: string; title?: string }[];
+  tryCustomPrompt?: (info: {
+    selfId: number;
+    groupId: number;
+    userId: number;
+    groupName: string;
+  }) => Promise<boolean>;
 }): Promise<void> {
   const memberName =
     options.memberName ||
@@ -201,6 +236,7 @@ export async function triggerSingleWelcome(options: {
     userId: options.userId,
     memberName,
     promptInjections: options.promptInjections,
+    tryCustomPrompt: options.tryCustomPrompt,
   });
 }
 
@@ -214,6 +250,12 @@ export function registerWelcomeHandler(
     userId: number;
     groupName: string;
   }) => Promise<boolean> | boolean,
+  tryCustomPrompt?: (info: {
+    selfId: number;
+    groupId: number;
+    userId: number;
+    groupName: string;
+  }) => Promise<boolean>,
 ): () => void {
   const batches = getBatchMap();
 
@@ -302,6 +344,7 @@ export function registerWelcomeHandler(
             groupId,
             groupName: pending.groupName,
             members: pending.members,
+            tryCustomPrompt,
           });
           if (!welcomeMessage) return;
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mioku-plugin-admin",
-  "version": "2.3.1",
+  "version": "2.3.3",
   "description": "管理插件，提供事件通知与群管/个人管理指令",
   "main": "index.ts",
   "type": "module",

package/utils/prompt-image-store.ts

@@ -0,0 +1,202 @@
+import * as path from "path";
+import * as crypto from "crypto";
+import * as https from "https";
+import * as http from "http";
+import {
+  createWriteStream,
+  existsSync,
+  mkdirSync,
+  promises as fsp,
+} from "fs";
+import { getPluginDataDir } from "mioku";
+
+const PROMPT_IMAGE_SUBDIR = "prompt-images";
+
+const ALLOWED_EXTENSIONS = [".jpg", ".jpeg", ".png", ".gif", ".webp"];
+
+export interface SavedPromptImage {
+  filename: string;
+  sourceUrl: string;
+  size: number;
+}
+
+export function getGroupPromptImageDir(groupId: number): string {
+  return path.join(
+    getPluginDataDir("admin"),
+    String(groupId),
+    PROMPT_IMAGE_SUBDIR,
+  );
+}
+
+export function ensureGroupPromptImageDir(groupId: number): string {
+  const dir = getGroupPromptImageDir(groupId);
+  if (!existsSync(dir)) mkdirSync(dir, { recursive: true });
+  return dir;
+}
+
+export function getGroupPromptImagePath(groupId: number, filename: string): string {
+  return path.join(getGroupPromptImageDir(groupId), filename);
+}
+
+function inferExtension(source: string): string {
+  try {
+    const url = new URL(source);
+    const ext = path.extname(url.pathname).toLowerCase();
+    if (ALLOWED_EXTENSIONS.includes(ext)) return ext;
+  } catch {
+    const ext = path.extname(String(source || "")).toLowerCase();
+    if (ALLOWED_EXTENSIONS.includes(ext)) return ext;
+  }
+  return ".jpg";
+}
+
+function generateFilename(ext: string): string {
+  const stamp = Date.now().toString(36);
+  const rand = crypto.randomBytes(4).toString("hex");
+  return `prompt-${stamp}-${rand}${ext}`;
+}
+
+export async function saveRemoteImageAsPrompt(
+  groupId: number,
+  sourceUrl: string,
+): Promise<SavedPromptImage | null> {
+  const trimmed = String(sourceUrl || "").trim();
+  if (!trimmed) return null;
+
+  let downloadUrl = trimmed;
+  if (/^file:\/\//i.test(trimmed)) {
+    try {
+      const filePath = decodeURIComponent(
+        trimmed.replace(/^file:\/\//i, ""),
+      );
+      return await copyLocalFileAsPrompt(groupId, filePath);
+    } catch (err) {
+      return null;
+    }
+  }
+
+  if (!/^https?:\/\//i.test(downloadUrl)) return null;
+
+  const dir = ensureGroupPromptImageDir(groupId);
+  const filename = generateFilename(inferExtension(downloadUrl));
+  const savePath = path.join(dir, filename);
+
+  try {
+    const size = await downloadToFile(downloadUrl, savePath);
+    if (size <= 0) {
+      await fsp.unlink(savePath).catch(() => {});
+      return null;
+    }
+    return { filename, sourceUrl: trimmed, size };
+  } catch {
+    await fsp.unlink(savePath).catch(() => {});
+    return null;
+  }
+}
+
+async function copyLocalFileAsPrompt(
+  groupId: number,
+  filePath: string,
+): Promise<SavedPromptImage | null> {
+  try {
+    const stat = await fsp.stat(filePath);
+    if (!stat.isFile() || stat.size <= 0) return null;
+    const dir = ensureGroupPromptImageDir(groupId);
+    const filename = generateFilename(inferExtension(filePath));
+    const dest = path.join(dir, filename);
+    await fsp.copyFile(filePath, dest);
+    return { filename, sourceUrl: filePath, size: stat.size };
+  } catch {
+    return null;
+  }
+}
+
+function downloadToFile(url: string, savePath: string): Promise<number> {
+  return new Promise((resolve, reject) => {
+    let parsed: URL;
+    try {
+      parsed = new URL(url);
+    } catch (err) {
+      reject(err);
+      return;
+    }
+    const client = parsed.protocol === "https:" ? https : http;
+    const req = client.get(
+      url,
+      {
+        headers: {
+          "User-Agent":
+            "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36",
+          Referer: "https://q.qq.com/",
+        },
+      },
+      (res) => {
+        if (
+          res.statusCode &&
+          res.statusCode >= 300 &&
+          res.statusCode < 400 &&
+          res.headers.location
+        ) {
+          res.resume();
+          const redirected = new URL(res.headers.location, url).toString();
+          downloadToFile(redirected, savePath).then(resolve, reject);
+          return;
+        }
+        if (!res.statusCode || res.statusCode >= 400) {
+          res.resume();
+          reject(new Error(`HTTP ${res.statusCode}`));
+          return;
+        }
+        const file = createWriteStream(savePath);
+        let total = 0;
+        res.on("data", (chunk: Buffer) => {
+          total += chunk.length;
+        });
+        res.pipe(file);
+        file.on("finish", () => {
+          file.close(() => resolve(total));
+        });
+        file.on("error", (err) => {
+          reject(err);
+        });
+      },
+    );
+    req.on("error", (err) => {
+      reject(err);
+    });
+    req.setTimeout(20000, () => {
+      req.destroy(new Error("download timeout"));
+    });
+  });
+}
+
+export async function deletePromptImage(
+  groupId: number,
+  filename: string,
+): Promise<void> {
+  if (!filename) return;
+  const safe = path.basename(filename);
+  if (!safe || safe !== filename) return;
+  const target = getGroupPromptImagePath(groupId, safe);
+  await fsp.unlink(target).catch(() => {});
+}
+
+export async function pruneGroupPromptImages(
+  groupId: number,
+  keep: readonly string[],
+): Promise<void> {
+  const dir = getGroupPromptImageDir(groupId);
+  if (!existsSync(dir)) return;
+  const keepSet = new Set(keep.map((name) => path.basename(name)));
+  let entries: string[];
+  try {
+    entries = await fsp.readdir(dir);
+  } catch {
+    return;
+  }
+  await Promise.all(
+    entries
+      .filter((name) => !keepSet.has(name))
+      .map((name) => fsp.unlink(path.join(dir, name)).catch(() => {})),
+  );
+}

package/verify/chiral.ts

@@ -1,9 +1,5 @@
 import type { MiokiContext } from "mioki";
-import {
-  resolveVerifyPrompt,
-  type VerifyConfig,
-  type VerifyGroupConfig,
-} from "./config";
+import type { VerifyConfig } from "./config";
 import type { PendingVerify } from "./types";
 
 interface ChiralCaptcha {
@@ -47,7 +43,6 @@ async function fetchChiralCaptcha(
 export async function prepareChiral(
   ctx: MiokiContext,
   cfg: VerifyConfig,
-  groupCfg: VerifyGroupConfig,
   p: PendingVerify,
 ): Promise<boolean> {
   const bot = ctx.pickBot(p.selfId);
@@ -56,11 +51,10 @@ export async function prepareChiral(
     const captcha = await fetchChiralCaptcha(cfg.chiralApiUrl, cfg.chiralDifficulty);
     p.requiredRegions = captcha.regions;
     p.matchedRegions = new Set<string>();
-    const basePrompt = cfg.chiralPrompt.replace(
+    const prompt = cfg.chiralPrompt.replace(
       "{count}",
       String(captcha.regions.length),
     );
-    const prompt = resolveVerifyPrompt(basePrompt, groupCfg);
     await bot.sendGroupMsg(p.groupId, [
       ctx.segment.at(String(p.userId)),
       ctx.segment.text(` ${prompt}`),

package/verify/config.ts

@@ -1,12 +1,13 @@
 export type VerifyMode = "reaction" | "number" | "chiral";
 
-export const MAX_EXTRA_PROMPT_LENGTH = 50;
+export const MAX_CUSTOM_PROMPT_LENGTH = 50;
 
 export interface VerifyGroupConfig {
   groupId: number;
   enabled: boolean;
   mode: VerifyMode;
-  extraPrompt: string;
+  customPrompt: string;
+  promptImage: string;
 }
 
 export interface VerifyConfig {
@@ -42,20 +43,24 @@ export const DEFAULT_VERIFY_CONFIG: VerifyConfig = {
   kickOnTimeout: true,
 };
 
-export function normalizeExtraPrompt(value: unknown): string {
+export function normalizeCustomPrompt(value: unknown): string {
   if (typeof value !== "string") return "";
   const trimmed = value.trim();
   if (!trimmed) return "";
-  return Array.from(trimmed).slice(0, MAX_EXTRA_PROMPT_LENGTH).join("");
+  return Array.from(trimmed).slice(0, MAX_CUSTOM_PROMPT_LENGTH).join("");
 }
 
-export function resolveVerifyPrompt(
-  basePrompt: string,
-  groupCfg: VerifyGroupConfig | undefined,
-): string {
-  const extra = String(groupCfg?.extraPrompt || "").trim();
-  if (!extra) return basePrompt;
-  return `${basePrompt}\n${extra}`;
+export function normalizePromptImage(value: unknown): string {
+  if (typeof value !== "string") return "";
+  return value.trim();
+}
+
+export function hasCustomPrompt(groupCfg: VerifyGroupConfig | undefined): boolean {
+  if (!groupCfg) return false;
+  return (
+    Boolean(groupCfg.customPrompt && groupCfg.customPrompt.trim()) ||
+    Boolean(groupCfg.promptImage && groupCfg.promptImage.trim())
+  );
 }
 
 export function normalizeVerifyMode(value: unknown): VerifyMode {
@@ -67,11 +72,19 @@ export function normalizeVerifyMode(value: unknown): VerifyMode {
 
 function normalizeVerifyGroup(raw: any): VerifyGroupConfig {
   const groupId = Number(raw?.groupId || raw?.group_id || 0);
+  const promptImageRaw =
+    raw?.promptImage ??
+    raw?.prompt_image ??
+    (Array.isArray(raw?.promptImages) ? raw.promptImages[0] : undefined) ??
+    (Array.isArray(raw?.images) ? raw.images[0] : undefined);
   return {
     groupId: groupId > 0 ? groupId : 0,
     enabled: raw?.enabled === true,
     mode: normalizeVerifyMode(raw?.mode),
-    extraPrompt: normalizeExtraPrompt(raw?.extraPrompt ?? raw?.extra_prompt),
+    customPrompt: normalizeCustomPrompt(
+      raw?.customPrompt ?? raw?.custom_prompt ?? raw?.extraPrompt,
+    ),
+    promptImage: normalizePromptImage(promptImageRaw),
   };
 }
 
@@ -133,7 +146,13 @@ export function getGroupVerifyConfig(
 ): VerifyGroupConfig {
   const found = config.groups.find((g) => g.groupId === groupId);
   if (found) return found;
-  return { groupId, enabled: false, mode: "reaction", extraPrompt: "" };
+  return {
+    groupId,
+    enabled: false,
+    mode: "reaction",
+    customPrompt: "",
+    promptImage: "",
+  };
 }
 
 export function upsertGroupVerifyConfig(
@@ -146,8 +165,11 @@ export function upsertGroupVerifyConfig(
   const normalizedPatch: Partial<Omit<VerifyGroupConfig, "groupId">> = {
     ...patch,
   };
-  if (patch.extraPrompt !== undefined) {
-    normalizedPatch.extraPrompt = normalizeExtraPrompt(patch.extraPrompt);
+  if (patch.customPrompt !== undefined) {
+    normalizedPatch.customPrompt = normalizeCustomPrompt(patch.customPrompt);
+  }
+  if (patch.promptImage !== undefined) {
+    normalizedPatch.promptImage = normalizePromptImage(patch.promptImage);
   }
   if (idx >= 0) {
     next.groups = config.groups.map((g, i) =>
@@ -160,7 +182,8 @@ export function upsertGroupVerifyConfig(
         groupId,
         enabled: false,
         mode: "reaction",
-        extraPrompt: "",
+        customPrompt: "",
+        promptImage: "",
         ...normalizedPatch,
       },
     ];

package/verify/index.ts

@@ -1,7 +1,12 @@
 import type { MiokiContext } from "mioki";
+import { existsSync } from "fs";
 import { getMemberRole } from "../config";
 import { resolveMemberName, triggerSingleWelcome } from "../notify/welcome";
-import { getGroupVerifyConfig, upsertGroupVerifyConfig } from "./config";
+import {
+  getGroupVerifyConfig,
+  hasCustomPrompt,
+  upsertGroupVerifyConfig,
+} from "./config";
 import type {
   MemberJoinInfo,
   PendingVerify,
@@ -12,6 +17,7 @@ import { clearTimers, getPendingMap, pendingKey } from "./state";
 import { isReactionPass, sendReactionPrompt } from "./reaction";
 import { isNumberAnswerCorrect, sendNumberPrompt } from "./number";
 import { checkChiralAnswer, prepareChiral } from "./chiral";
+import { getGroupPromptImagePath } from "../utils/prompt-image-store";
 
 const PASS_REACTION_EMOJI_ID = "144";
 
@@ -91,6 +97,13 @@ export function createVerifyController(
 
     if (!getWelcomeEnabled()) return;
     try {
+      const customSent = await trySendCustomWelcome({
+        selfId: p.selfId,
+        groupId: p.groupId,
+        userId: p.userId,
+        groupName: p.groupName,
+      });
+      if (customSent) return;
       await triggerSingleWelcome({
         ctx,
         aiService,
@@ -204,12 +217,12 @@ export function createVerifyController(
       const delay = skipDelay ? 0 : Math.max(0, cfg.reactionDelayMs);
       entry.delayTimer = setTimeout(() => {
         entry.delayTimer = null;
-        void sendReactionPrompt(ctx, cfg, groupCfg, entry);
+        void sendReactionPrompt(ctx, cfg, entry);
       }, delay);
     } else if (mode === "number") {
-      void sendNumberPrompt(ctx, cfg, groupCfg, entry);
+      void sendNumberPrompt(ctx, cfg, entry);
     } else if (mode === "chiral") {
-      const ok = await prepareChiral(ctx, cfg, groupCfg, entry);
+      const ok = await prepareChiral(ctx, cfg, entry);
       if (!ok) {
         // 验证服务不可用时放行，避免误伤
         removePending(key);
@@ -344,10 +357,42 @@ export function createVerifyController(
     removePending(pendingKey(info.selfId, info.groupId, info.userId));
   }
 
+  async function trySendCustomWelcome(info: MemberJoinInfo): Promise<boolean> {
+    const groupCfg = getGroupVerifyConfig(getVerifyConfig(), info.groupId);
+    if (!hasCustomPrompt(groupCfg)) return false;
+    const bot = ctx.pickBot(info.selfId);
+    if (!bot) return false;
+    const segments: any[] = [];
+    const prompt = String(groupCfg.customPrompt || "").trim();
+    if (prompt) {
+      segments.push(ctx.segment.text(prompt));
+    }
+    const filename = String(groupCfg.promptImage || "").trim();
+    if (filename) {
+      const imagePath = getGroupPromptImagePath(info.groupId, filename);
+      if (!existsSync(imagePath)) {
+        ctx.logger.warn(
+          `admin verify 自定义入群提示图片缺失: ${imagePath}`,
+        );
+      } else {
+        segments.push(ctx.segment.image(`file://${imagePath}`));
+      }
+    }
+    if (!segments.length) return false;
+    try {
+      await bot.sendGroupMsg(info.groupId, segments);
+      return true;
+    } catch (err) {
+      ctx.logger.error(`admin verify 发送自定义入群提示失败: ${err}`);
+      return false;
+    }
+  }
+
   return {
     handleMemberJoin: startVerification,
     restartVerification,
     bypassVerification,
+    trySendCustomWelcome,
     dispose() {
       for (const p of pending.values()) clearTimers(p);
       pending.clear();

package/verify/number.ts

@@ -1,9 +1,5 @@
 import type { MiokiContext } from "mioki";
-import {
-  resolveVerifyPrompt,
-  type VerifyConfig,
-  type VerifyGroupConfig,
-} from "./config";
+import type { VerifyConfig } from "./config";
 import type { PendingVerify } from "./types";
 
 function genNumberQuestion(): { question: string; answer: number } {
@@ -23,15 +19,13 @@ function extractNumbers(text: string): number[] {
 export async function sendNumberPrompt(
   ctx: MiokiContext,
   cfg: VerifyConfig,
-  groupCfg: VerifyGroupConfig,
   p: PendingVerify,
 ): Promise<void> {
   const bot = ctx.pickBot(p.selfId);
   if (!bot) return;
   const { question, answer } = genNumberQuestion();
   p.numberAnswer = answer;
-  const basePrompt = cfg.numberPrompt.replace("{question}", question);
-  const prompt = resolveVerifyPrompt(basePrompt, groupCfg);
+  const prompt = cfg.numberPrompt.replace("{question}", question);
   try {
     await bot.sendGroupMsg(p.groupId, [
       ctx.segment.at(String(p.userId)),

package/verify/reaction.ts

@@ -1,25 +1,19 @@
 import type { MiokiContext } from "mioki";
-import {
-  resolveVerifyPrompt,
-  type VerifyConfig,
-  type VerifyGroupConfig,
-} from "./config";
+import type { VerifyConfig } from "./config";
 import type { PendingVerify } from "./types";
 
 export async function sendReactionPrompt(
   ctx: MiokiContext,
   cfg: VerifyConfig,
-  groupCfg: VerifyGroupConfig,
   p: PendingVerify,
 ): Promise<void> {
   const bot = ctx.pickBot(p.selfId);
   if (!bot) return;
-  const prompt = resolveVerifyPrompt(cfg.reactionPrompt, groupCfg);
   let messageId: number | undefined;
   try {
     const res = await bot.sendGroupMsg(p.groupId, [
       ctx.segment.at(String(p.userId)),
-      ctx.segment.text(` ${prompt}`),
+      ctx.segment.text(` ${cfg.reactionPrompt}`),
     ]);
     messageId = Number(res?.message_id || 0) || undefined;
   } catch (err) {

package/verify/types.ts

@@ -42,5 +42,6 @@ export interface VerifyController {
   handleMemberJoin(info: MemberJoinInfo): Promise<boolean>;
   restartVerification(info: MemberJoinInfo): Promise<boolean>;
   bypassVerification(info: MemberJoinInfo): Promise<void>;
+  trySendCustomWelcome(info: MemberJoinInfo): Promise<boolean>;
   dispose(): void;
 }