koishi-plugin-custom-image 0.1.5

package/lib/index.d.ts

@@ -0,0 +1,32 @@
+import { Context, Schema } from 'koishi';
+import axios from 'axios';
+declare module 'koishi' {
+    interface Context {
+        axios: typeof axios;
+    }
+}
+export declare const name = "custom-image";
+export interface Config {
+    enable: boolean;
+    showWaitingTip: boolean;
+    waitingTipText: string;
+    sameImageApiInterval: number;
+    timeout: number;
+    customImageApis: string[];
+    customImageEnabled: boolean;
+    hsjpEnabled: boolean;
+    dmjpEnabled: boolean;
+    ignoreSendError: boolean;
+    retryTimes: number;
+    retryInterval: number;
+    imageSendTimeout: number;
+    autoClearCacheInterval: number;
+    imageParseFormat: string;
+}
+export declare const Config: Schema<Config>;
+export declare function apply(ctx: Context, config: Config): void;
+export declare const inject: {
+    required: string[];
+    optional: string[];
+};
+export declare const using: readonly ["axios"];

package/lib/index.js

@@ -0,0 +1,296 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.using = exports.inject = exports.Config = exports.name = void 0;
+exports.apply = apply;
+const koishi_1 = require("koishi");
+const crypto_1 = __importDefault(require("crypto"));
+// 插件名称（必须导出）
+exports.name = 'custom-image';
+// ==================== 2. 配置 Schema 声明（关键修复：移除冗余断言） ====================
+// 核心修复：去掉 as Schema<Config>，直接使用 Schema.object 构建，符合 Koishi 规范
+exports.Config = koishi_1.Schema.object({
+    // 基础设置
+    enable: koishi_1.Schema.boolean()
+        .default(true)
+        .description('【基础设置】启用插件'),
+    showWaitingTip: koishi_1.Schema.boolean()
+        .default(true)
+        .description('【基础设置】请求图片时显示等待提示'),
+    waitingTipText: koishi_1.Schema.string()
+        .default('正在获取图片，请稍候...')
+        .description('【基础设置】请求等待时发送的提示文本'),
+    sameImageApiInterval: koishi_1.Schema.number()
+        .default(60)
+        .min(0)
+        .description('【基础设置】重复API调用间隔：相同API的最小调用间隔（秒）'),
+    timeout: koishi_1.Schema.number()
+        .default(10000)
+        .min(0)
+        .description('【基础设置】API请求超时时间（毫秒）'),
+    customImageApis: koishi_1.Schema.array(koishi_1.Schema.string())
+        .default([])
+        .role('textarea') // 控制台显示为多行文本框（更友好）
+        .description('【基础设置】自定义图片API列表（每行一个地址）'),
+    // 功能开关
+    customImageEnabled: koishi_1.Schema.boolean()
+        .default(true)
+        .description('【功能开关】启用自定义图片API功能'),
+    hsjpEnabled: koishi_1.Schema.boolean()
+        .default(true)
+        .description('【功能开关】启用黑丝举牌功能'),
+    dmjpEnabled: koishi_1.Schema.boolean()
+        .default(true)
+        .description('【功能开关】启用动漫举牌功能'),
+    // 容错设置
+    ignoreSendError: koishi_1.Schema.boolean()
+        .default(true)
+        .description('【容错设置】忽略发送错误：避免插件因消息发送失败崩溃'),
+    retryTimes: koishi_1.Schema.number()
+        .default(1)
+        .min(0)
+        .description('【容错设置】API重试次数：请求失败时的重试次数'),
+    retryInterval: koishi_1.Schema.number()
+        .default(500)
+        .min(0)
+        .description('【容错设置】重试间隔（毫秒）'),
+    imageSendTimeout: koishi_1.Schema.number()
+        .default(15000)
+        .min(0)
+        .description('【容错设置】图片发送超时（毫秒），0表示不限制'),
+    // 缓存设置
+    autoClearCacheInterval: koishi_1.Schema.number()
+        .default(60)
+        .min(0)
+        .description('【缓存设置】自动清理缓存间隔（分钟），0表示不自动清理'),
+    // 格式设置
+    imageParseFormat: koishi_1.Schema.string()
+        .default('✅ 图片获取成功')
+        .description('【格式设置】图片发送前的提示文本')
+});
+// ==================== 全局缓存与工具函数 ====================
+const processedApi = new Map();
+const imageBuffer = new Map();
+const delay = (ms) => new Promise(r => setTimeout(r, ms));
+async function sendTimeout(session, content, config) {
+    if (config.imageSendTimeout <= 0) {
+        return session.send(content).catch(err => {
+            if (config.ignoreSendError)
+                return null;
+            throw err;
+        });
+    }
+    return Promise.race([
+        session.send(content),
+        new Promise((_, reject) => setTimeout(() => reject(new Error('发送超时')), config.imageSendTimeout))
+    ]).catch(err => {
+        if (config.ignoreSendError)
+            return null;
+        throw err;
+    });
+}
+function clearAllCache() {
+    processedApi.clear();
+    imageBuffer.forEach(buf => clearTimeout(buf.timer));
+    imageBuffer.clear();
+    return true;
+}
+// ==================== 核心业务函数 ====================
+function randomSelectApi(customImageApis) {
+    const validApis = customImageApis.filter(api => api.trim());
+    if (validApis.length === 0)
+        return null;
+    return validApis[Math.floor(Math.random() * validApis.length)];
+}
+async function fetchImage(ctx, url, config) {
+    const http = ctx.axios.create({
+        timeout: config.timeout,
+        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'
+        }
+    });
+    for (let retry = 0; retry <= config.retryTimes; retry++) {
+        try {
+            const res = await http.get(url, { responseType: 'arraybuffer' });
+            if (res.status === 200 && res.data) {
+                const imgBase64 = Buffer.from(res.data).toString('base64');
+                return { success: true, data: imgBase64, msg: '图片获取成功' };
+            }
+        }
+        catch (err) {
+            if (retry === config.retryTimes) {
+                return { success: false, data: null, msg: `请求失败：${err.message}` };
+            }
+            await delay(config.retryInterval);
+        }
+    }
+    return { success: false, data: null, msg: '重试次数用尽，图片获取失败' };
+}
+async function fetchHsjpImage(ctx, msg, msg1, msg2, config) {
+    const encodedMsg = encodeURIComponent(msg);
+    const encodedMsg1 = encodeURIComponent(msg1);
+    const encodedMsg2 = encodeURIComponent(msg2);
+    const url = `https://api.suyanw.cn/api/hsjp/?msg=${encodedMsg}&msg1=${encodedMsg1}&msg2=${encodedMsg2}`;
+    return fetchImage(ctx, url, config);
+}
+async function fetchDmjpImage(ctx, text, config) {
+    const encodedText = encodeURIComponent(text);
+    const url = `https://api.suyanw.cn/api/dmjp.php?text=${encodedText}`;
+    return fetchImage(ctx, url, config);
+}
+async function processCustomImage(ctx, session, apiUrl, config) {
+    const hash = crypto_1.default.createHash('md5').update(apiUrl).digest('hex');
+    const now = Date.now();
+    if (processedApi.get(hash) && now - processedApi.get(hash) < config.sameImageApiInterval * 1000) {
+        return { success: false, msg: '请勿重复调用该API' };
+    }
+    processedApi.set(hash, now);
+    const result = await fetchImage(ctx, apiUrl, config);
+    if (result.success && result.data) {
+        await sendTimeout(session, config.imageParseFormat, config);
+        await sendTimeout(session, koishi_1.h.image(result.data), config);
+        return { success: true, msg: result.msg };
+    }
+    else {
+        await sendTimeout(session, `❌ ${result.msg}`, config);
+        return { success: false, msg: result.msg };
+    }
+}
+async function flush(ctx, session, config, manualApi) {
+    const key = `${session.platform}:${session.userId}:${session.channelId}`;
+    const buf = imageBuffer.get(key);
+    const apis = manualApi ? [manualApi] : buf?.apis || [];
+    if (buf) {
+        clearTimeout(buf.timer);
+        imageBuffer.delete(key);
+    }
+    if (config.customImageEnabled && apis.length) {
+        const apiUrl = randomSelectApi(apis);
+        if (!apiUrl) {
+            await sendTimeout(session, '❌ 自定义图片API列表为空', config);
+            return;
+        }
+        await processCustomImage(ctx, session, apiUrl, config);
+    }
+}
+// ==================== 插件主逻辑 ====================
+function apply(ctx, config) {
+    // 初始化：清空缓存
+    clearAllCache();
+    ctx.logger.info('[custom-image] 自定义图片插件已加载');
+    // 声明依赖服务（Koishi 会自动检查）
+    ctx.plugin(require('@koishijs/plugin-axios'));
+    // 随机图片指令
+    ctx.command('random-image [apis...]', '随机获取自定义图片API的图片')
+        .option('api', '-a <api> 指定单个API地址')
+        .action(async ({ session, options = {} }, ...apis) => {
+        if (!config.enable || !config.customImageEnabled) {
+            return '❌ 自定义图片功能已禁用';
+        }
+        if (!session)
+            return;
+        const targetApi = options.api || (apis.length ? apis.join(' ') : null);
+        if (targetApi) {
+            await flush(ctx, session, config, targetApi);
+        }
+        else {
+            const key = `${session.platform}:${session.userId}:${session.channelId}`;
+            // 显示等待提示
+            let tipId;
+            if (config.showWaitingTip) {
+                const m = await sendTimeout(session, config.waitingTipText, config);
+                tipId = m?.messageId || m?.id || m;
+            }
+            // 消息缓冲
+            if (imageBuffer.has(key)) {
+                const b = imageBuffer.get(key);
+                clearTimeout(b.timer);
+                b.timer = setTimeout(() => flush(ctx, session, config), 1000);
+            }
+            else {
+                imageBuffer.set(key, {
+                    apis: config.customImageApis,
+                    timer: setTimeout(() => flush(ctx, session, config), 1000),
+                    tipMsgId: tipId
+                });
+            }
+        }
+    });
+    // 黑丝举牌指令
+    ctx.command('hsjp <msg> [msg1] [msg2]', '生成黑丝举牌图片')
+        .action(async ({ session }, msg, msg1 = '', msg2 = '') => {
+        if (!config.enable || !config.hsjpEnabled) {
+            return '❌ 黑丝举牌功能已禁用';
+        }
+        if (!session || !msg) {
+            return '❌ 请输入举牌文字！格式：hsjp <第一行> [第二行] [第三行]';
+        }
+        if (config.showWaitingTip) {
+            await sendTimeout(session, config.waitingTipText, config);
+        }
+        const result = await fetchHsjpImage(ctx, msg, msg1, msg2, config);
+        if (result.success && result.data) {
+            await sendTimeout(session, config.imageParseFormat, config);
+            await sendTimeout(session, koishi_1.h.image(result.data), config);
+        }
+        else {
+            await sendTimeout(session, `❌ ${result.msg}`, config);
+        }
+    });
+    // 动漫举牌指令
+    ctx.command('dmjp <text>', '生成动漫举牌图片')
+        .action(async ({ session }, text) => {
+        if (!config.enable || !config.dmjpEnabled) {
+            return '❌ 动漫举牌功能已禁用';
+        }
+        if (!session || !text) {
+            return '❌ 请输入举牌文字！格式：dmjp <文本>';
+        }
+        if (config.showWaitingTip) {
+            await sendTimeout(session, config.waitingTipText, config);
+        }
+        const result = await fetchDmjpImage(ctx, text, config);
+        if (result.success && result.data) {
+            await sendTimeout(session, config.imageParseFormat, config);
+            await sendTimeout(session, koishi_1.h.image(result.data), config);
+        }
+        else {
+            await sendTimeout(session, `❌ ${result.msg}`, config);
+        }
+    });
+    // 清空缓存指令
+    ctx.command('clear-image-cache', '清空图片插件缓存')
+        .action(() => {
+        clearAllCache();
+        return '✅ 图片插件缓存已清空';
+    });
+    // 定时清理过期缓存（每小时）
+    setInterval(() => {
+        const now = Date.now();
+        processedApi.forEach((time, hash) => {
+            if (now - time > 86400000) { // 24小时过期
+                processedApi.delete(hash);
+            }
+        });
+    }, 3600000);
+    // 自动清理缓存（按配置）
+    if (config.autoClearCacheInterval > 0) {
+        setInterval(() => {
+            clearAllCache();
+            ctx.logger.info('[custom-image] 自动清理缓存完成');
+        }, config.autoClearCacheInterval * 60000);
+    }
+    // 进程退出清理
+    process.on('exit', () => {
+        clearAllCache();
+        ctx.logger.info('[custom-image] 插件缓存已清理，进程退出');
+    });
+}
+// ==================== 补充：插件元信息（Koishi 控制台显示） ====================
+exports.inject = {
+    required: ['axios'],
+    optional: ['i18n']
+};
+exports.using = ['axios'];

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "koishi-plugin-custom-image",
+  "version": "0.1.5",
+  "description": "Koishi插件：自定义图片API随机调用 + 内置黑丝/动漫举牌功能",
+  "main": "lib/index.js",
+  "typings": "lib/index.d.ts",
+  "files": [
+    "lib",
+    "src",
+    "package.json",
+    "README.md",
+    "src/locales"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc -w",
+    "prepack": "npm run build"
+  },
+  "keywords": [
+    "koishi",
+    "plugin",
+    "image",
+    "api",
+    "sign",
+    "举牌",
+    "黑丝举牌",
+    "动漫举牌"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Minecraft-1314/koishi-plugin-custom-image-api.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Minecraft-1314/koishi-plugin-custom-image-api/issues"
+  },
+  "homepage": "https://github.com/Minecraft-1314/koishi-plugin-custom-image-api#readme",
+  "author": "",
+  "license": "MIT",
+  "peerDependencies": {
+    "koishi": "^4.0.0"
+  },
+  "dependencies": {
+    "yaml": "^2.3.4"
+  },
+  "devDependencies": {
+    "typescript": "^5.3.3",
+    "@types/node": "^20.11.17",
+    "@koishijs/typings": "^4.0.0",
+    "@types/js-yaml": "^4.0.9"
+  },
+  "koishi": {
+    "description": {
+      "zh-CN": "自定义图片API随机调用 + 内置黑丝/动漫举牌功能，支持本地化配置和独立开关控制"
+    },
+    "service": {
+      "required": [
+        "axios",
+        "i18n"
+      ]
+    }
+  }
+}

package/src/index.ts

@@ -0,0 +1,351 @@
+import { Context, Schema, h, Session } from 'koishi'
+import axios, { AxiosInstance } from 'axios'
+import crypto from 'crypto'
+import fs from 'fs'
+import path from 'path'
+
+// 扩展 Context 类型，添加 axios 属性（解决 ctx.axios 类型问题）
+declare module 'koishi' {
+  interface Context {
+    axios: typeof axios;
+  }
+}
+
+// 插件名称（必须导出）
+export const name = 'custom-image'
+
+// ==================== 1. 配置接口声明（规范写法） ====================
+export interface Config {
+  // 基础设置
+  enable: boolean
+  showWaitingTip: boolean
+  waitingTipText: string
+  sameImageApiInterval: number
+  timeout: number
+  customImageApis: string[] // 自定义图片API列表（核心配置项）
+  // 功能开关
+  customImageEnabled: boolean
+  hsjpEnabled: boolean
+  dmjpEnabled: boolean
+  // 容错设置
+  ignoreSendError: boolean
+  retryTimes: number
+  retryInterval: number
+  imageSendTimeout: number
+  // 缓存设置
+  autoClearCacheInterval: number
+  // 格式设置
+  imageParseFormat: string
+}
+
+// ==================== 2. 配置 Schema 声明（关键修复：移除冗余断言） ====================
+// 核心修复：去掉 as Schema<Config>，直接使用 Schema.object 构建，符合 Koishi 规范
+export const Config: Schema<Config> = Schema.object({
+  // 基础设置
+  enable: Schema.boolean()
+    .default(true)
+    .description('【基础设置】启用插件'),
+  showWaitingTip: Schema.boolean()
+    .default(true)
+    .description('【基础设置】请求图片时显示等待提示'),
+  waitingTipText: Schema.string()
+    .default('正在获取图片，请稍候...')
+    .description('【基础设置】请求等待时发送的提示文本'),
+  sameImageApiInterval: Schema.number()
+    .default(60)
+    .min(0)
+    .description('【基础设置】重复API调用间隔：相同API的最小调用间隔（秒）'),
+  timeout: Schema.number()
+    .default(10000)
+    .min(0)
+    .description('【基础设置】API请求超时时间（毫秒）'),
+  customImageApis: Schema.array(Schema.string())
+    .default([])
+    .role('textarea') // 控制台显示为多行文本框（更友好）
+    .description('【基础设置】自定义图片API列表（每行一个地址）'),
+  // 功能开关
+  customImageEnabled: Schema.boolean()
+    .default(true)
+    .description('【功能开关】启用自定义图片API功能'),
+  hsjpEnabled: Schema.boolean()
+    .default(true)
+    .description('【功能开关】启用黑丝举牌功能'),
+  dmjpEnabled: Schema.boolean()
+    .default(true)
+    .description('【功能开关】启用动漫举牌功能'),
+  // 容错设置
+  ignoreSendError: Schema.boolean()
+    .default(true)
+    .description('【容错设置】忽略发送错误：避免插件因消息发送失败崩溃'),
+  retryTimes: Schema.number()
+    .default(1)
+    .min(0)
+    .description('【容错设置】API重试次数：请求失败时的重试次数'),
+  retryInterval: Schema.number()
+    .default(500)
+    .min(0)
+    .description('【容错设置】重试间隔（毫秒）'),
+  imageSendTimeout: Schema.number()
+    .default(15000)
+    .min(0)
+    .description('【容错设置】图片发送超时（毫秒），0表示不限制'),
+  // 缓存设置
+  autoClearCacheInterval: Schema.number()
+    .default(60)
+    .min(0)
+    .description('【缓存设置】自动清理缓存间隔（分钟），0表示不自动清理'),
+  // 格式设置
+  imageParseFormat: Schema.string()
+    .default('✅ 图片获取成功')
+    .description('【格式设置】图片发送前的提示文本')
+})
+
+// ==================== 全局缓存与工具函数 ====================
+const processedApi = new Map<string, number>()
+const imageBuffer = new Map<string, { apis: string[], timer: NodeJS.Timeout, tipMsgId?: string | number }>()
+
+const delay = (ms: number) => new Promise(r => setTimeout(r, ms))
+
+async function sendTimeout(session: Session, content: any, config: Config) {
+  if (config.imageSendTimeout <= 0) {
+    return session.send(content).catch(err => {
+      if (config.ignoreSendError) return null
+      throw err
+    })
+  }
+  return Promise.race([
+    session.send(content),
+    new Promise((_, reject) => setTimeout(() => reject(new Error('发送超时')), config.imageSendTimeout))
+  ]).catch(err => {
+    if (config.ignoreSendError) return null
+    throw err
+  })
+}
+
+function clearAllCache() {
+  processedApi.clear()
+  imageBuffer.forEach(buf => clearTimeout(buf.timer))
+  imageBuffer.clear()
+  return true
+}
+
+// ==================== 核心业务函数 ====================
+function randomSelectApi(customImageApis: string[]): string | null {
+  const validApis = customImageApis.filter(api => api.trim())
+  if (validApis.length === 0) return null
+  return validApis[Math.floor(Math.random() * validApis.length)]
+}
+
+async function fetchImage(ctx: Context, url: string, config: Config) {
+  const http: AxiosInstance = ctx.axios.create({
+    timeout: config.timeout,
+    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'
+    }
+  })
+
+  for (let retry = 0; retry <= config.retryTimes; retry++) {
+    try {
+      const res = await http.get(url, { responseType: 'arraybuffer' })
+      if (res.status === 200 && res.data) {
+        const imgBase64 = Buffer.from(res.data).toString('base64')
+        return { success: true, data: imgBase64, msg: '图片获取成功' }
+      }
+    } catch (err) {
+      if (retry === config.retryTimes) {
+        return { success: false, data: null, msg: `请求失败：${(err as Error).message}` }
+      }
+      await delay(config.retryInterval)
+    }
+  }
+
+  return { success: false, data: null, msg: '重试次数用尽，图片获取失败' }
+}
+
+async function fetchHsjpImage(ctx: Context, msg: string, msg1: string, msg2: string, config: Config) {
+  const encodedMsg = encodeURIComponent(msg)
+  const encodedMsg1 = encodeURIComponent(msg1)
+  const encodedMsg2 = encodeURIComponent(msg2)
+  const url = `https://api.suyanw.cn/api/hsjp/?msg=${encodedMsg}&msg1=${encodedMsg1}&msg2=${encodedMsg2}`
+  
+  return fetchImage(ctx, url, config)
+}
+
+async function fetchDmjpImage(ctx: Context, text: string, config: Config) {
+  const encodedText = encodeURIComponent(text)
+  const url = `https://api.suyanw.cn/api/dmjp.php?text=${encodedText}`
+  
+  return fetchImage(ctx, url, config)
+}
+
+async function processCustomImage(ctx: Context, session: Session, apiUrl: string, config: Config) {
+  const hash = crypto.createHash('md5').update(apiUrl).digest('hex')
+  const now = Date.now()
+  
+  if (processedApi.get(hash) && now - processedApi.get(hash)! < config.sameImageApiInterval * 1000) {
+    return { success: false, msg: '请勿重复调用该API' }
+  }
+  processedApi.set(hash, now)
+
+  const result = await fetchImage(ctx, apiUrl, config)
+  if (result.success && result.data) {
+    await sendTimeout(session, config.imageParseFormat, config)
+    await sendTimeout(session, h.image(result.data), config)
+    return { success: true, msg: result.msg }
+  } else {
+    await sendTimeout(session, `❌ ${result.msg}`, config)
+    return { success: false, msg: result.msg }
+  }
+}
+
+async function flush(ctx: Context, session: Session, config: Config, manualApi?: string) {
+  const key = `${session.platform}:${session.userId}:${session.channelId}`
+  const buf = imageBuffer.get(key)
+  const apis = manualApi ? [manualApi] : buf?.apis || []
+
+  if (buf) {
+    clearTimeout(buf.timer)
+    imageBuffer.delete(key)
+  }
+
+  if (config.customImageEnabled && apis.length) {
+    const apiUrl = randomSelectApi(apis)
+    if (!apiUrl) {
+      await sendTimeout(session, '❌ 自定义图片API列表为空', config)
+      return
+    }
+    await processCustomImage(ctx, session, apiUrl, config)
+  }
+}
+
+// ==================== 插件主逻辑 ====================
+export function apply(ctx: Context, config: Config) {
+  // 初始化：清空缓存
+  clearAllCache()
+  ctx.logger.info('[custom-image] 自定义图片插件已加载')
+
+  // 声明依赖服务（Koishi 会自动检查）
+  ctx.plugin(require('@koishijs/plugin-axios'))
+
+  // 随机图片指令
+  ctx.command('random-image [apis...]', '随机获取自定义图片API的图片')
+    .option('api', '-a <api> 指定单个API地址')
+    .action(async ({ session, options = {} }, ...apis) => {
+      if (!config.enable || !config.customImageEnabled) {
+        return '❌ 自定义图片功能已禁用'
+      }
+      if (!session) return
+
+      const targetApi = options.api || (apis.length ? apis.join(' ') : null)
+      if (targetApi) {
+        await flush(ctx, session, config, targetApi)
+      } else {
+        const key = `${session.platform}:${session.userId}:${session.channelId}`
+        
+        // 显示等待提示
+        let tipId
+        if (config.showWaitingTip) {
+          const m = await sendTimeout(session, config.waitingTipText, config)
+          tipId = (m as any)?.messageId || (m as any)?.id || m
+        }
+
+        // 消息缓冲
+        if (imageBuffer.has(key)) {
+          const b = imageBuffer.get(key)!
+          clearTimeout(b.timer)
+          b.timer = setTimeout(() => flush(ctx, session, config), 1000)
+        } else {
+          imageBuffer.set(key, {
+            apis: config.customImageApis,
+            timer: setTimeout(() => flush(ctx, session, config), 1000),
+            tipMsgId: tipId
+          })
+        }
+      }
+    })
+
+  // 黑丝举牌指令
+  ctx.command('hsjp <msg> [msg1] [msg2]', '生成黑丝举牌图片')
+    .action(async ({ session }, msg, msg1 = '', msg2 = '') => {
+      if (!config.enable || !config.hsjpEnabled) {
+        return '❌ 黑丝举牌功能已禁用'
+      }
+      if (!session || !msg) {
+        return '❌ 请输入举牌文字！格式：hsjp <第一行> [第二行] [第三行]'
+      }
+
+      if (config.showWaitingTip) {
+        await sendTimeout(session, config.waitingTipText, config)
+      }
+
+      const result = await fetchHsjpImage(ctx, msg, msg1, msg2, config)
+      if (result.success && result.data) {
+        await sendTimeout(session, config.imageParseFormat, config)
+        await sendTimeout(session, h.image(result.data), config)
+      } else {
+        await sendTimeout(session, `❌ ${result.msg}`, config)
+      }
+    })
+
+  // 动漫举牌指令
+  ctx.command('dmjp <text>', '生成动漫举牌图片')
+    .action(async ({ session }, text) => {
+      if (!config.enable || !config.dmjpEnabled) {
+        return '❌ 动漫举牌功能已禁用'
+      }
+      if (!session || !text) {
+        return '❌ 请输入举牌文字！格式：dmjp <文本>'
+      }
+
+      if (config.showWaitingTip) {
+        await sendTimeout(session, config.waitingTipText, config)
+      }
+
+      const result = await fetchDmjpImage(ctx, text, config)
+      if (result.success && result.data) {
+        await sendTimeout(session, config.imageParseFormat, config)
+        await sendTimeout(session, h.image(result.data), config)
+      } else {
+        await sendTimeout(session, `❌ ${result.msg}`, config)
+      }
+    })
+
+  // 清空缓存指令
+  ctx.command('clear-image-cache', '清空图片插件缓存')
+    .action(() => {
+      clearAllCache()
+      return '✅ 图片插件缓存已清空'
+    })
+
+  // 定时清理过期缓存（每小时）
+  setInterval(() => {
+    const now = Date.now()
+    processedApi.forEach((time, hash) => {
+      if (now - time > 86400000) { // 24小时过期
+        processedApi.delete(hash)
+      }
+    })
+  }, 3600000)
+
+  // 自动清理缓存（按配置）
+  if (config.autoClearCacheInterval > 0) {
+    setInterval(() => {
+      clearAllCache()
+      ctx.logger.info('[custom-image] 自动清理缓存完成')
+    }, config.autoClearCacheInterval * 60000)
+  }
+
+  // 进程退出清理
+  process.on('exit', () => {
+    clearAllCache()
+    ctx.logger.info('[custom-image] 插件缓存已清理，进程退出')
+  })
+}
+
+// ==================== 补充：插件元信息（Koishi 控制台显示） ====================
+export const inject = {
+  required: ['axios'],
+  optional: ['i18n']
+}
+
+export const using = ['axios'] as const

package/src/locales/zh-CN.yml

@@ -0,0 +1,9 @@
+customImage:
+  noApi: 自定义图片API列表为空，请先在插件配置中添加！
+  error: 图片获取失败：{{msg}}
+  hsjpDisabled: 黑丝举牌功能已禁用，请联系管理员开启！
+  hsjpNoText: 请输入举牌文字！格式：hsjp <第一行> [第二行] [第三行]
+  hsjpError: 黑丝举牌生成失败：{{msg}}
+  dmjpDisabled: 动漫举牌功能已禁用，请联系管理员开启！
+  dmjpNoText: 请输入举牌文字！格式：dmjp <文本>
+  dmjpError: 动漫举牌生成失败：{{msg}}