mioku-plugin-admin 2.3.0 → 2.3.2

package/commands/verify.ts

@@ -1,13 +1,20 @@
 import type { MiokiContext } from "mioki";
-import { getAtUserId, getMemberRole } from "../config";
+import { extractImageUrls, getAtUserId, getMemberRole } from "../config";
 import {
   getGroupVerifyConfig,
+  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;
@@ -44,7 +51,9 @@ export function registerVerifyCommands(options: VerifyCommandOptions) {
       text.startsWith("/绕过验证") ||
       text.startsWith("#绕过验证") ||
       text.startsWith("/重新验证") ||
-      text.startsWith("#重新验证");
+      text.startsWith("#重新验证") ||
+      text.startsWith("/入群提示") ||
+      text.startsWith("#入群提示");
 
     try {
       const selfId = event.self_id;
@@ -238,6 +247,104 @@ export function registerVerifyCommands(options: VerifyCommandOptions) {
         }
         return;
       }
+
+      // /入群提示 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 imageUrls = extractImageUrls(event.message);
+
+        if (rawArg === "关闭" || rawArg === "清空" || rawArg === "关") {
+          if (!hasCustomPrompt(groupCfg)) {
+            await event.reply("本群还没设置自定义入群提示哦～", true);
+            return;
+          }
+          const removedFiles = [...groupCfg.promptImages];
+          const next = upsertGroupVerifyConfig(current, groupId, {
+            customPrompt: "",
+            promptImages: [],
+          });
+          await setVerifyConfig(next);
+          await pruneGroupPromptImages(groupId, []).catch(() => {});
+          ctx.logger.info(
+            `admin verify 关闭群 ${groupId} 自定义入群提示，清理图片 ${removedFiles.join(", ")}`,
+          );
+          await event.reply("已关闭本群自定义入群提示～", true);
+          return;
+        }
+
+        if (!rawArg && !imageUrls.length) {
+          if (!hasCustomPrompt(groupCfg)) {
+            await event.reply(
+              "用法：/入群提示 xxx（最多 50 字），可附带图片一起发送；/入群提示 关闭 关闭自定义提示～",
+              true,
+            );
+            return;
+          }
+          const summary = [
+            `已开启本群自定义入群提示`,
+            groupCfg.customPrompt
+              ? `文字：${groupCfg.customPrompt}`
+              : "文字：（未设置）",
+            `图片：${groupCfg.promptImages.length} 张`,
+          ].join("\n");
+          await event.reply(summary, true);
+          return;
+        }
+
+        let nextPrompt = groupCfg.customPrompt;
+        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;
+          }
+          nextPrompt = normalizeCustomPrompt(rawArg);
+        }
+
+        const saved: string[] = [];
+        const failed: number = imageUrls.length;
+        for (const url of imageUrls) {
+          const savedImage = await saveRemoteImageAsPrompt(groupId, url);
+          if (savedImage) saved.push(savedImage.filename);
+        }
+
+        const nextImages = imageUrls.length
+          ? [...groupCfg.promptImages, ...saved]
+          : groupCfg.promptImages;
+
+        const next = upsertGroupVerifyConfig(current, groupId, {
+          customPrompt: nextPrompt,
+          promptImages: nextImages,
+        });
+        await setVerifyConfig(next);
+        await pruneGroupPromptImages(groupId, nextImages).catch(() => {});
+
+        const lines: string[] = ["已更新本群自定义入群提示～"];
+        if (rawArg) lines.push(`文字：${nextPrompt}`);
+        else if (groupCfg.customPrompt)
+          lines.push(`文字（保持）：${groupCfg.customPrompt}`);
+        if (imageUrls.length) {
+          lines.push(
+            saved.length
+              ? `新增图片 ${saved.length} 张${failed > saved.length ? `，${failed - saved.length} 张保存失败` : ""}`
+              : `图片保存失败 ${failed} 张，请稍后重试`,
+          );
+        }
+        lines.push(`当前共 ${nextImages.length} 张图片`);
+        await event.reply(lines.join("\n"), true);
+        return;
+      }
     } catch (err) {
       ctx.logger.error(`[admin verify] 未捕获异常: ${String(err)}`);
       if (!isVerifyCommand) return;

package/config.md

@@ -74,9 +74,43 @@ fields:
 
   - key: verify.groups
     label: 各群入群验证配置
-    type: json
-    description: 每个群的验证配置数组，元素形如 {"groupId":123,"enabled":true,"mode":"reaction"}。推荐通过 /开启验证、/关闭验证、/切换验证模式 指令管理，直接编辑需填写合法 JSON 数组。
-    placeholder: '[]'
+    type: array
+    description: 
+    itemFields:
+      - key: groupId
+        label: 群号
+        type: number
+        description: 该配置对应的 QQ 群号，每个群只能出现一次
+        placeholder: 123456789
+
+      - key: enabled
+        label: 启用验证
+        type: switch
+        description: 是否对该群开启入群验证
+
+      - key: mode
+        label: 验证模式
+        type: select
+        options:
+          - value: reaction
+            label: 回应
+          - value: number
+            label: 数字
+          - value: chiral
+            label: 手性碳
+        description: 该群入群验证使用的模式
+
+      - key: customPrompt
+        label: 群自定义入群提示词
+        type: textarea
+        description: 一旦设置该群将跳过 AI 生成欢迎，验证通过后直接发送这段文字（可附带本地图片一起）。上限 50 字，建议在群里直接用 /入群提示 xxx 设置或 /入群提示 关闭 关闭。
+        placeholder: 例：欢迎来到本群，请先看群公告～
+
+      - key: promptImages
+        label: 群自定义入群提示图片
+        type: textarea
+        description: 图片文件名列表（保存在 data/admin/<群号>/prompt-images/），与文字一起发送。在群里发送 /入群提示 xxx 时附带图片即可追加；/入群提示 关闭 会一并清空图片。
+        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,11 +74,40 @@ 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, aiService, config, selfId, groupId, groupName, members, promptInjections } =
-    options;
+  const {
+    ctx,
+    aiService,
+    config,
+    selfId,
+    groupId,
+    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(", ");
@@ -106,7 +135,7 @@ async function flushBatch(options: {
       groupId,
       send: true,
       instruction: [
-        `当前有 ${members.length} 位新成员同时入群，请一次性发送一段统一的欢迎语（不要逐个 @ 欢迎、不要重复点名）。`,
+        `当前有 ${members.length} 位新成员同时入群，请一次性发送一段统一的欢迎语（不要逐个 @ 欢迎、不要重复点名）不要长篇大论，精简即可。`,
         `新成员昵称：${userList}`,
         `新成员 QQ：${userIdList}`,
         `所在群：${groupName}`,
@@ -132,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,
@@ -143,6 +178,7 @@ async function sendSingleWelcome(options: {
     userId,
     memberName,
     promptInjections,
+    tryCustomPrompt,
   } = options;
   const welcomeMessage = await flushBatch({
     ctx,
@@ -153,6 +189,7 @@ async function sendSingleWelcome(options: {
     groupName,
     members: [{ userId, memberName }],
     promptInjections,
+    tryCustomPrompt,
   });
   if (!welcomeMessage) return;
   const bot = ctx.pickBot(selfId);
@@ -174,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 ||
@@ -193,6 +236,7 @@ export async function triggerSingleWelcome(options: {
     userId: options.userId,
     memberName,
     promptInjections: options.promptInjections,
+    tryCustomPrompt: options.tryCustomPrompt,
   });
 }
 
@@ -206,90 +250,56 @@ 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();
 
-  const dispose = ctx.handle("notice.group.increase" as any, async (event: any) => {
-    const cfg = getConfig();
-    const selfId = Number(event?.self_id || ctx.self_id);
-    const groupId = Number(event?.group_id || 0);
-    const userId = Number(event?.user_id || 0);
-    if (!groupId || !userId) return;
-    if (userId === selfId) return;
-
-    const groupName =
-      String(event?.group?.group_name || "").trim() || String(groupId);
-
-    if (
-      shouldSuppress &&
-      (await shouldSuppress({ selfId, groupId, userId, groupName }))
-    ) {
-      return;
-    }
-
-    if (!cfg.welcome.enabled) return;
+  const dispose = ctx.handle(
+    "notice.group.increase" as any,
+    async (event: any) => {
+      const cfg = getConfig();
+      const selfId = Number(event?.self_id || ctx.self_id);
+      const groupId = Number(event?.group_id || 0);
+      const userId = Number(event?.user_id || 0);
+      if (!groupId || !userId) return;
+      if (userId === selfId) return;
 
-    const batchWindowMs = Math.max(0, Number(cfg.welcome.batchWindowMs) || 0);
+      const groupName =
+        String(event?.group?.group_name || "").trim() || String(groupId);
 
-    if (batchWindowMs === 0) {
-      const memberName = await resolveMemberName(ctx, groupId, userId, selfId);
-      const welcomeMessage = await flushBatch({
-        ctx,
-        aiService,
-        config: cfg,
-        selfId,
-        groupId,
-        groupName,
-        members: [{ userId, memberName }],
-      });
-      if (!welcomeMessage) return;
-      const bot = ctx.pickBot(selfId);
-      if (!bot) return;
-      try {
-        await bot.sendGroupMsg(groupId, [ctx.segment.text(welcomeMessage)]);
-      } catch (error) {
-        ctx.logger.warn(`发送入群欢迎失败: ${error}`);
+      if (
+        shouldSuppress &&
+        (await shouldSuppress({ selfId, groupId, userId, groupName }))
+      ) {
+        return;
       }
-      return;
-    }
 
-    const key = batchKey(selfId, groupId);
-    let state = batches.get(key);
-    if (!state) {
-      state = { members: [], timer: null, groupName };
-      batches.set(key, state);
-    }
-    if (groupName && groupName !== String(groupId)) {
-      state.groupName = groupName;
-    }
+      if (!cfg.welcome.enabled) return;
 
-    const memberName = await resolveMemberName(ctx, groupId, userId, selfId);
-    if (!state.members.some((m) => m.userId === userId)) {
-      state.members.push({ userId, memberName });
-    }
-
-    if (state.timer) {
-      return;
-    }
-
-    state.timer = setTimeout(async () => {
-      try {
-        const pending = state;
-        batches.delete(key);
-        if (!pending || !pending.members.length) return;
+      const batchWindowMs = Math.max(0, Number(cfg.welcome.batchWindowMs) || 0);
 
-        const currentConfig = getConfig();
+      if (batchWindowMs === 0) {
+        const memberName = await resolveMemberName(
+          ctx,
+          groupId,
+          userId,
+          selfId,
+        );
         const welcomeMessage = await flushBatch({
           ctx,
           aiService,
-          config: currentConfig,
+          config: cfg,
           selfId,
           groupId,
-          groupName: pending.groupName,
-          members: pending.members,
+          groupName,
+          members: [{ userId, memberName }],
         });
         if (!welcomeMessage) return;
-
         const bot = ctx.pickBot(selfId);
         if (!bot) return;
         try {
@@ -297,11 +307,60 @@ export function registerWelcomeHandler(
         } catch (error) {
           ctx.logger.warn(`发送入群欢迎失败: ${error}`);
         }
-      } catch (error) {
-        ctx.logger.error(`admin welcome 批次处理失败: ${error}`);
+        return;
       }
-    }, batchWindowMs);
-  });
+
+      const key = batchKey(selfId, groupId);
+      let state = batches.get(key);
+      if (!state) {
+        state = { members: [], timer: null, groupName };
+        batches.set(key, state);
+      }
+      if (groupName && groupName !== String(groupId)) {
+        state.groupName = groupName;
+      }
+
+      const memberName = await resolveMemberName(ctx, groupId, userId, selfId);
+      if (!state.members.some((m) => m.userId === userId)) {
+        state.members.push({ userId, memberName });
+      }
+
+      if (state.timer) {
+        return;
+      }
+
+      state.timer = setTimeout(async () => {
+        try {
+          const pending = state;
+          batches.delete(key);
+          if (!pending || !pending.members.length) return;
+
+          const currentConfig = getConfig();
+          const welcomeMessage = await flushBatch({
+            ctx,
+            aiService,
+            config: currentConfig,
+            selfId,
+            groupId,
+            groupName: pending.groupName,
+            members: pending.members,
+            tryCustomPrompt,
+          });
+          if (!welcomeMessage) return;
+
+          const bot = ctx.pickBot(selfId);
+          if (!bot) return;
+          try {
+            await bot.sendGroupMsg(groupId, [ctx.segment.text(welcomeMessage)]);
+          } catch (error) {
+            ctx.logger.warn(`发送入群欢迎失败: ${error}`);
+          }
+        } catch (error) {
+          ctx.logger.error(`admin welcome 批次处理失败: ${error}`);
+        }
+      }, batchWindowMs);
+    },
+  );
 
   return () => {
     for (const state of batches.values()) {
@@ -310,4 +369,4 @@ export function registerWelcomeHandler(
     batches.clear();
     dispose();
   };
-}
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mioku-plugin-admin",
-  "version": "2.3.0",
+  "version": "2.3.2",
   "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/config.ts

@@ -1,9 +1,13 @@
 export type VerifyMode = "reaction" | "number" | "chiral";
 
+export const MAX_CUSTOM_PROMPT_LENGTH = 50;
+
 export interface VerifyGroupConfig {
   groupId: number;
   enabled: boolean;
   mode: VerifyMode;
+  customPrompt: string;
+  promptImages: string[];
 }
 
 export interface VerifyConfig {
@@ -39,6 +43,35 @@ export const DEFAULT_VERIFY_CONFIG: VerifyConfig = {
   kickOnTimeout: true,
 };
 
+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_CUSTOM_PROMPT_LENGTH).join("");
+}
+
+export function normalizePromptImages(value: unknown): string[] {
+  if (!Array.isArray(value)) return [];
+  const seen = new Set<string>();
+  const result: string[] = [];
+  for (const item of value) {
+    if (typeof item !== "string") continue;
+    const name = item.trim();
+    if (!name || seen.has(name)) continue;
+    seen.add(name);
+    result.push(name);
+  }
+  return result;
+}
+
+export function hasCustomPrompt(groupCfg: VerifyGroupConfig | undefined): boolean {
+  if (!groupCfg) return false;
+  return (
+    Boolean(groupCfg.customPrompt && groupCfg.customPrompt.trim()) ||
+    groupCfg.promptImages.length > 0
+  );
+}
+
 export function normalizeVerifyMode(value: unknown): VerifyMode {
   const v = String(value || "").trim();
   if (v === "number" || v === "数字") return "number";
@@ -52,6 +85,12 @@ function normalizeVerifyGroup(raw: any): VerifyGroupConfig {
     groupId: groupId > 0 ? groupId : 0,
     enabled: raw?.enabled === true,
     mode: normalizeVerifyMode(raw?.mode),
+    customPrompt: normalizeCustomPrompt(
+      raw?.customPrompt ?? raw?.custom_prompt ?? raw?.extraPrompt,
+    ),
+    promptImages: normalizePromptImages(
+      raw?.promptImages ?? raw?.prompt_images ?? raw?.images,
+    ),
   };
 }
 
@@ -113,7 +152,13 @@ export function getGroupVerifyConfig(
 ): VerifyGroupConfig {
   const found = config.groups.find((g) => g.groupId === groupId);
   if (found) return found;
-  return { groupId, enabled: false, mode: "reaction" };
+  return {
+    groupId,
+    enabled: false,
+    mode: "reaction",
+    customPrompt: "",
+    promptImages: [],
+  };
 }
 
 export function upsertGroupVerifyConfig(
@@ -123,14 +168,30 @@ export function upsertGroupVerifyConfig(
 ): VerifyConfig {
   const idx = config.groups.findIndex((g) => g.groupId === groupId);
   const next = { ...config };
+  const normalizedPatch: Partial<Omit<VerifyGroupConfig, "groupId">> = {
+    ...patch,
+  };
+  if (patch.customPrompt !== undefined) {
+    normalizedPatch.customPrompt = normalizeCustomPrompt(patch.customPrompt);
+  }
+  if (patch.promptImages !== undefined) {
+    normalizedPatch.promptImages = normalizePromptImages(patch.promptImages);
+  }
   if (idx >= 0) {
     next.groups = config.groups.map((g, i) =>
-      i === idx ? { ...g, ...patch } : g,
+      i === idx ? { ...g, ...normalizedPatch } : g,
     );
   } else {
     next.groups = [
       ...config.groups,
-      { groupId, enabled: false, mode: "reaction", ...patch },
+      {
+        groupId,
+        enabled: false,
+        mode: "reaction",
+        customPrompt: "",
+        promptImages: [],
+        ...normalizedPatch,
+      },
     ];
   }
   return next;

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,
@@ -344,10 +357,41 @@ 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));
+    }
+    for (const filename of groupCfg.promptImages) {
+      const imagePath = getGroupPromptImagePath(info.groupId, filename);
+      if (!existsSync(imagePath)) {
+        ctx.logger.warn(
+          `admin verify 自定义入群提示图片缺失: ${imagePath}`,
+        );
+        continue;
+      }
+      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/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;
 }