koishi-plugin-emojiluna-plus 0.0.1 → 0.0.2

package/lib/adapters/autoCommands.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.registerAutoCollectCommands = registerAutoCollectCommands;
 const koishi_1 = require("koishi");
 const render_1 = require("./render");
+const types_1 = require("../types");
 const RECENT_RECORDS = 6;
 const DEBUG_LINES = 15;
 function registerAutoCollectCommands(ctx, config, autoCollector) {
@@ -69,16 +70,16 @@ function formatTrace(trace) {
 }
 function formatStatus(config, autoCollector) {
     const stats = autoCollector.stats();
-    const scope = config.groupScope === 'whitelist'
+    const scope = config.groupScope === types_1.GROUP_SCOPES.whitelist
         ? `群聊仅白名单（${config.whitelistGroups.length} 个）`
-        : config.groupScope === 'blacklist'
+        : config.groupScope === types_1.GROUP_SCOPES.blacklist
             ? `群聊排除黑名单（${config.blacklistGroups.length} 个）`
             : '群聊为所有群';
     const lines = [
         '自动获取状态',
         `运行: ${stats.enabled ? '开启' : '关闭'}（配置 ${stats.configured ? '开启' : '关闭'}）`,
         `范围: ${scope} | 私聊 ${config.collectDirect ? '开启' : '关闭'}`,
-        `模式: ${stats.mode === 'instant' ? '出现即收集' : `窗口 ${config.frequencyWindow} 分钟内满 ${config.emojiFrequencyThreshold} 次`}`,
+        `模式: ${stats.mode === types_1.COLLECT_MODES.instant ? '出现即收集' : `窗口 ${config.frequencyWindow} 分钟内满 ${config.emojiFrequencyThreshold} 次`}`,
         `条件: ${config.minEmojiSize}KB-${config.maxEmojiSize}MB${config.minEdgePixels ? ` | 短边≥${config.minEdgePixels}px` : ''} | 相似度阈值 ${config.similarityThreshold}`,
         `取源: HTTP ${config.fetchTimeout}ms 超时 | 本地路径 ${config.allowLocalPaths ? '允许' : '禁止'}${config.localPathRoots.length ? `（限定 ${config.localPathRoots.length} 个目录）` : ''}`,
         `AI: 类型过滤 ${config.enableImageTypeFilter ? `开启（超时 ${config.aiFilterTimeout}ms，兜底 ${config.aiFilterFallback}）` : '关闭'} | 入库后分析 ${config.autoAnalyze ? '开启' : '关闭'}`,

package/lib/adapters/commands.js

@@ -163,7 +163,7 @@ function registerLibraryCommands(ctx, config, emojiluna) {
             `状态: ${flag(config.autoCollect)}`,
             `范围: ${config.groupScope} / 私聊 ${flag(config.collectDirect)}`,
             `模式: ${config.autoCollectMode} / 阈值 ${config.emojiFrequencyThreshold} 次每 ${config.frequencyWindow} 分钟`,
-            `调试日志: ${flag(config.debug)}（范围 ${config.debugOnly}）`,
+            `调试日志: ${flag(config.debug)}，范围 ${config.debugOnly}`,
         ];
         return lines.join('\n');
     });

package/lib/adapters/consoleListeners.js

@@ -5,6 +5,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.applyConsoleListeners = applyConsoleListeners;
 const path_1 = __importDefault(require("path"));
+const fs_1 = __importDefault(require("fs"));
 const DIRECT_EVENTS = {
     'emojiluna/getEmojiList': 'getEmojiList',
     'emojiluna/getEmojiPage': 'getEmojiPage',
@@ -31,6 +32,20 @@ const DIRECT_EVENTS = {
     'emojiluna/retryAiTask': 'retryAiTask',
 };
 const MAX_REQUESTED_EMOJI_NAME = 64;
+function resolveClientRoot(fromDir) {
+    let current = fromDir;
+    for (let depth = 0; depth < 5; depth++) {
+        if (fs_1.default.existsSync(path_1.default.join(current, 'package.json')) &&
+            fs_1.default.existsSync(path_1.default.join(current, 'dist'))) {
+            return current;
+        }
+        const parent = path_1.default.dirname(current);
+        if (parent === current)
+            break;
+        current = parent;
+    }
+    return path_1.default.resolve(fromDir, '..', '..', '..');
+}
 function applyConsoleListeners(ctx, config) {
     ctx.inject(['console', 'emojiluna'], (ctx) => {
         void registerListeners(ctx, config);
@@ -40,9 +55,10 @@ async function registerListeners(ctx, config) {
     const emojiluna = ctx.emojiluna;
     const invoke = emojiluna;
     await emojiluna.ready;
+    const clientRoot = resolveClientRoot(__dirname);
     ctx.console.addEntry({
-        dev: path_1.default.resolve(__dirname, '../../client/index.ts'),
-        prod: path_1.default.resolve(__dirname, '../dist'),
+        dev: path_1.default.join(clientRoot, 'client', 'index.ts'),
+        prod: path_1.default.join(clientRoot, 'dist'),
     });
     for (const [event, method] of Object.entries(DIRECT_EVENTS)) {
         ctx.console.addListener(event, invoke[method]);

package/lib/collectors/autoCollector.d.ts

@@ -1,5 +1,6 @@
 import { Context, h, Session } from 'koishi';
 import { Config } from '../config';
+import { CollectMode } from '../types';
 import { DebugLogger } from '../debug';
 export interface CollectTrace {
     gate: string;
@@ -9,7 +10,7 @@ export interface CollectTrace {
 export interface CollectStats {
     enabled: boolean;
     configured: boolean;
-    mode: 'instant' | 'frequency';
+    mode: CollectMode;
     seen: number;
     collected: number;
     rejected: Record<string, number>;

package/lib/collectors/autoCollector.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AutoCollector = void 0;
 const koishi_1 = require("koishi");
+const types_1 = require("../types");
 const image_1 = require("../image");
 const utils_1 = require("../utils");
 const HOUR_MS = 3_600_000;
@@ -293,7 +294,7 @@ class AutoCollector {
         const whitelist = this.config.whitelistGroups.map(String);
         const blacklist = this.config.blacklistGroups.map(String);
         const listed = (list) => list.includes(guildId) || list.includes(String(session.channelId));
-        if (this.config.groupScope === 'whitelist') {
+        if (this.config.groupScope === types_1.GROUP_SCOPES.whitelist) {
             return {
                 gate: '生效范围',
                 ok: listed(whitelist),
@@ -302,7 +303,7 @@ class AutoCollector {
                     : `群 ${guildId} 不在白名单内`,
             };
         }
-        if (this.config.groupScope === 'blacklist') {
+        if (this.config.groupScope === types_1.GROUP_SCOPES.blacklist) {
             return {
                 gate: '生效范围',
                 ok: !listed(blacklist),
@@ -394,7 +395,7 @@ class AutoCollector {
         stamps.push(now);
         this.frequency.set(key, stamps);
         const reached = stamps.length >= this.config.emojiFrequencyThreshold;
-        if (this.config.autoCollectMode !== 'frequency') {
+        if (this.config.autoCollectMode !== types_1.COLLECT_MODES.frequency) {
             return {
                 gate: '频次',
                 ok: true,
@@ -457,7 +458,7 @@ class AutoCollector {
             const { gate, ok, detail } = cached;
             return { gate, ok, detail: `复用上次判定：${detail}` };
         }
-        const fallbackOk = this.config.aiFilterFallback === 'accept';
+        const fallbackOk = this.config.aiFilterFallback === types_1.AI_FILTER_FALLBACKS.accept;
         let verdict = {
             gate: 'AI过滤',
             ok: fallbackOk,

package/lib/config.d.ts

@@ -1,5 +1,5 @@
 import { Schema } from 'koishi';
-import { ImageContentType } from './types';
+import { AiFilterFallback, CollectMode, DebugScopeName, GroupScope } from './types';
 export declare const Config: Schema<Schemastery.ObjectS<{
     maxEmojiCount: Schema<number, number>;
     maxFileSize: Schema<number, number>;
@@ -11,7 +11,7 @@ export declare const Config: Schema<Schemastery.ObjectS<{
     autoCollect: Schema<boolean, boolean>;
     collectGroup: Schema<boolean, boolean>;
     collectDirect: Schema<boolean, boolean>;
-    groupScope: Schema<"all" | "whitelist" | "blacklist", "all" | "whitelist" | "blacklist">;
+    groupScope: Schema<"所有群" | "仅白名单群" | "排除黑名单群", "所有群" | "仅白名单群" | "排除黑名单群">;
     triggerWithName: Schema<boolean, boolean>;
 }> | Schemastery.ObjectS<{
     model: Schema<any, any>;
@@ -40,7 +40,7 @@ export declare const Config: Schema<Schemastery.ObjectS<{
     similarityThreshold: Schema<number, number>;
     whitelistGroups: Schema<string[], string[]>;
     blacklistGroups: Schema<string[], string[]>;
-    autoCollectMode: Schema<"instant" | "frequency", "instant" | "frequency">;
+    autoCollectMode: Schema<"立即收集" | "频次达标后收集", "立即收集" | "频次达标后收集">;
     emojiFrequencyThreshold: Schema<number, number>;
     frequencyWindow: Schema<number, number>;
     minEdgePixels: Schema<number, number>;
@@ -61,11 +61,11 @@ export declare const Config: Schema<Schemastery.ObjectS<{
     }>, string>>;
     enableImageTypeFilter: Schema<boolean, boolean>;
     aiFilterTimeout: Schema<number, number>;
-    aiFilterFallback: Schema<"accept" | "reject", "accept" | "reject">;
-    acceptedImageTypes: Schema<ImageContentType[], ImageContentType[]>;
+    aiFilterFallback: Schema<"接受" | "拒绝", "接受" | "拒绝">;
+    acceptedImageTypes: Schema<string[], string[]>;
 }> | Schemastery.ObjectS<{
     debug: Schema<boolean, boolean>;
-    debugOnly: Schema<"all" | "collect" | "ai" | "http" | "service", "all" | "collect" | "ai" | "http" | "service">;
+    debugOnly: Schema<"全部" | "自动获取" | "AI调用" | "HTTP接口" | "服务内部", "全部" | "自动获取" | "AI调用" | "HTTP接口" | "服务内部">;
     logLimit: Schema<number, number>;
 }>, {
     maxEmojiCount: number;
@@ -78,7 +78,7 @@ export declare const Config: Schema<Schemastery.ObjectS<{
     autoCollect: boolean;
     collectGroup: boolean;
     collectDirect: boolean;
-    groupScope: "all" | "whitelist" | "blacklist";
+    groupScope: "所有群" | "仅白名单群" | "排除黑名单群";
     triggerWithName: boolean;
 } & import("cosmokit").Dict & {
     model: any;
@@ -107,7 +107,7 @@ export declare const Config: Schema<Schemastery.ObjectS<{
     similarityThreshold: number;
     whitelistGroups: string[];
     blacklistGroups: string[];
-    autoCollectMode: "instant" | "frequency";
+    autoCollectMode: "立即收集" | "频次达标后收集";
     emojiFrequencyThreshold: number;
     frequencyWindow: number;
     minEdgePixels: number;
@@ -125,11 +125,11 @@ export declare const Config: Schema<Schemastery.ObjectS<{
     }>, string>;
     enableImageTypeFilter: boolean;
     aiFilterTimeout: number;
-    aiFilterFallback: "accept" | "reject";
-    acceptedImageTypes: ImageContentType[];
+    aiFilterFallback: "接受" | "拒绝";
+    acceptedImageTypes: string[];
 } & {
     debug: boolean;
-    debugOnly: "all" | "collect" | "ai" | "http" | "service";
+    debugOnly: "全部" | "自动获取" | "AI调用" | "HTTP接口" | "服务内部";
     logLimit: number;
 }>;
 export interface Config {
@@ -153,9 +153,9 @@ export interface Config {
     similarityThreshold: number;
     whitelistGroups: string[];
     collectDirect: boolean;
-    groupScope: 'all' | 'whitelist' | 'blacklist';
+    groupScope: GroupScope;
     blacklistGroups: string[];
-    autoCollectMode: 'instant' | 'frequency';
+    autoCollectMode: CollectMode;
     emojiFrequencyThreshold: number;
     frequencyWindow: number;
     minEdgePixels: number;
@@ -168,9 +168,9 @@ export interface Config {
     autoCollectCategory: string;
     autoCollectNameTemplate: string;
     aiFilterTimeout: number;
-    aiFilterFallback: 'accept' | 'reject';
+    aiFilterFallback: AiFilterFallback;
     debug: boolean;
-    debugOnly: 'all' | 'collect' | 'ai' | 'http' | 'service';
+    debugOnly: DebugScopeName;
     logLimit: number;
     injectVariables: boolean;
     injectVariablesLimit: number;
@@ -183,7 +183,7 @@ export interface Config {
         dayLimit: number;
     }>;
     enableImageTypeFilter: boolean;
-    acceptedImageTypes: ImageContentType[];
+    acceptedImageTypes: string[];
     batchSize: number;
     aiConcurrency: number;
     AIBatchDelay: number;

package/lib/config.js

@@ -51,12 +51,8 @@ exports.Config = koishi_1.Schema.intersect([
         collectDirect: koishi_1.Schema.boolean()
             .default(true)
             .description('私聊也自动获取表情包'),
-        groupScope: koishi_1.Schema.union([
-            koishi_1.Schema.const('all').description('所有群'),
-            koishi_1.Schema.const('whitelist').description('仅白名单群'),
-            koishi_1.Schema.const('blacklist').description('排除黑名单群'),
-        ])
-            .default('all')
+        groupScope: koishi_1.Schema.union(Object.values(types_1.GROUP_SCOPES))
+            .default(types_1.GROUP_SCOPES.all)
             .description('群聊生效范围'),
         triggerWithName: koishi_1.Schema.boolean()
             .default(false)
@@ -188,7 +184,7 @@ ${types_1.IMAGE_CONTENT_TYPES.map((item) => `- ${item.type}: ${item.label} - ${i
 {emojis}
 
 使用方式：在回复中使用 [表情包名称](URL) 的格式来插入表情包。`)
-            .description('变量注入提示词（用于 ChatLuna 集成）')
+            .description('变量注入提示词')
     }).description('提示词配置'),
     koishi_1.Schema.object({
         injectVariables: koishi_1.Schema.boolean()
@@ -206,7 +202,7 @@ ${types_1.IMAGE_CONTENT_TYPES.map((item) => `- ${item.type}: ${item.label} - ${i
             .description('后端服务器路径')
             .default('/emojiluna'),
         uploadToken: koishi_1.Schema.string()
-            .description('上传接口 API Token（可选）')
+            .description('上传接口 API Token，留空则自动生成')
             .default(''),
         folderImportRoots: koishi_1.Schema.array(koishi_1.Schema.string())
             .description('允许扫描/导入的服务端目录前缀，为空表示不限制')
@@ -215,7 +211,7 @@ ${types_1.IMAGE_CONTENT_TYPES.map((item) => `- ${item.type}: ${item.label} - ${i
     }).description('API 配置'),
     koishi_1.Schema.object({
         batchSize: koishi_1.Schema.number()
-            .description('批量处理大小（上传/分析）')
+            .description('上传与分析的批量处理大小')
             .min(1)
             .max(20)
             .default(6),
@@ -263,23 +259,23 @@ ${types_1.IMAGE_CONTENT_TYPES.map((item) => `- ${item.type}: ${item.label} - ${i
             .role('slider')
             .default(0.9),
         whitelistGroups: koishi_1.Schema.array(koishi_1.Schema.string())
-            .description('白名单群号（仅 groupScope=whitelist 时生效）')
+            .description('白名单群号')
             .role('table')
             .default([]),
         blacklistGroups: koishi_1.Schema.array(koishi_1.Schema.string())
-            .description('黑名单群号（仅 groupScope=blacklist 时生效）')
+            .description('黑名单群号')
             .role('table')
             .default([]),
-        autoCollectMode: koishi_1.Schema.union(['instant', 'frequency'])
-            .default('instant')
-            .description('instant 表示出现即收集，frequency 表示窗口内达到次数才收集'),
+        autoCollectMode: koishi_1.Schema.union(Object.values(types_1.COLLECT_MODES))
+            .default(types_1.COLLECT_MODES.instant)
+            .description('收集触发方式'),
         emojiFrequencyThreshold: koishi_1.Schema.number()
-            .description('frequency 模式下的窗口内发送次数阈值')
+            .description('频次模式下窗口内的发送次数阈值')
             .min(2)
             .max(20)
             .default(3),
         frequencyWindow: koishi_1.Schema.number()
-            .description('发送次数统计窗口（分钟）')
+            .description('发送次数统计窗口，单位分钟')
             .min(1)
             .max(1440)
             .default(10),
@@ -289,7 +285,7 @@ ${types_1.IMAGE_CONTENT_TYPES.map((item) => `- ${item.type}: ${item.label} - ${i
             .max(4096)
             .default(0),
         fetchTimeout: koishi_1.Schema.number()
-            .description('拉取图片超时（毫秒）')
+            .description('拉取图片超时，单位毫秒')
             .min(1000)
             .max(120000)
             .default(20000),
@@ -317,7 +313,7 @@ ${types_1.IMAGE_CONTENT_TYPES.map((item) => `- ${item.type}: ${item.label} - ${i
             .default(1000),
         autoCollectCategory: koishi_1.Schema.string()
             .default('其他')
-            .description('自动获取入库时的初始分类（AI 分析成功后自动改写）'),
+            .description('自动获取入库时的初始分类'),
         autoCollectNameTemplate: koishi_1.Schema.string()
             .default('自动获取_{date}_{index}')
             .description('自动获取入库名称模板，支持 {date} {time} {sender} {chat} {index}'),
@@ -333,37 +329,31 @@ ${types_1.IMAGE_CONTENT_TYPES.map((item) => `- ${item.type}: ${item.label} - ${i
             .description('群组自动获取表情包限制'),
         enableImageTypeFilter: koishi_1.Schema.boolean()
             .default(true)
-            .description('是否启用 AI 图片类型过滤（过滤无用图片）'),
+            .description('是否启用 AI 图片类型过滤'),
         aiFilterTimeout: koishi_1.Schema.number()
-            .description('AI 图片类型过滤超时（毫秒）')
+            .description('AI 图片类型过滤超时，单位毫秒')
             .min(1000)
             .max(120000)
             .default(20000),
-        aiFilterFallback: koishi_1.Schema.union(['accept', 'reject'])
-            .default('accept')
+        aiFilterFallback: koishi_1.Schema.union(Object.values(types_1.AI_FILTER_FALLBACKS))
+            .default(types_1.AI_FILTER_FALLBACKS.accept)
             .description('AI 过滤超时或模型不可用时的兜底策略'),
-        acceptedImageTypes: koishi_1.Schema.array(koishi_1.Schema.union(types_1.IMAGE_CONTENT_TYPES.map((item) => koishi_1.Schema.const(item.type).description(item.label))))
-            .description('接受的图片类型（只有这些类型的图片会被收集）')
-            .default(types_1.DEFAULT_ACCEPTED_IMAGE_TYPES)
+        acceptedImageTypes: koishi_1.Schema.array(koishi_1.Schema.union(types_1.IMAGE_CONTENT_TYPES.map((item) => koishi_1.Schema.const(item.label))))
+            .description('允许自动获取入库的图片类型')
+            .default(types_1.DEFAULT_ACCEPTED_IMAGE_TYPES.map((type) => types_1.IMAGE_TYPE_LABELS[type]))
     }).description('自动获取配置'),
     koishi_1.Schema.object({
         debug: koishi_1.Schema.boolean()
             .default(false)
-            .description('输出调试日志（自动获取判定、AI 调用、HTTP 接口、服务初始化）'),
-        debugOnly: koishi_1.Schema.union([
-            koishi_1.Schema.const('all').description('全部'),
-            koishi_1.Schema.const('collect').description('仅自动获取'),
-            koishi_1.Schema.const('ai').description('仅 AI 调用'),
-            koishi_1.Schema.const('http').description('仅 HTTP 接口'),
-            koishi_1.Schema.const('service').description('仅服务内部'),
-        ])
-            .default('all')
+            .description('输出调试日志'),
+        debugOnly: koishi_1.Schema.union(Object.values(types_1.DEBUG_SCOPES))
+            .default(types_1.DEBUG_SCOPES.all)
             .description('调试日志范围'),
         logLimit: koishi_1.Schema.number()
             .default(200)
             .min(10)
             .max(200)
-            .description('调试日志环形缓冲条数（供 emojiluna.debug 命令回看）'),
+            .description('调试日志环形缓冲条数'),
     }).description('调试配置')
 ]);
 exports.name = 'emojiluna-plus';

package/lib/debug.d.ts

@@ -1,6 +1,7 @@
 import { Context } from 'koishi';
 import { Config } from './config';
-export type DebugScope = 'collect' | 'ai' | 'http' | 'service';
+import { DEBUG_SCOPES } from './types';
+export type DebugScope = keyof typeof DEBUG_SCOPES;
 export declare class DebugLogger {
     private ctx;
     private config;

package/lib/debug.js

@@ -1,12 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DebugLogger = void 0;
-const SCOPE_LABELS = {
-    collect: '自动获取',
-    ai: 'AI',
-    http: 'HTTP',
-    service: '服务',
-};
+const types_1 = require("./types");
 const RING_MAX = 200;
 class DebugLogger {
     ctx;
@@ -22,12 +17,14 @@ class DebugLogger {
     log(scope, message, extra) {
         if (!this.active)
             return;
-        if (this.config.debugOnly !== 'all' && this.config.debugOnly !== scope)
+        if (this.config.debugOnly !== types_1.DEBUG_SCOPES.all &&
+            this.config.debugOnly !== types_1.DEBUG_SCOPES[scope]) {
             return;
+        }
         const suffix = extra === undefined
             ? ''
             : ` ${typeof extra === 'string' ? extra : JSON.stringify(extra)}`;
-        const line = `[debug][${SCOPE_LABELS[scope]}] ${message}${suffix}`;
+        const line = `[调试][${types_1.DEBUG_SCOPES[scope]}] ${message}${suffix}`;
         this.ctx.logger.info(line);
         this.records.push(line);
         const limit = Math.min(this.config.logLimit, RING_MAX);

package/lib/services/aiAnalyzer.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AIAnalyzer = void 0;
+const types_1 = require("../types");
 const utils_1 = require("../utils");
 const image_1 = require("../image");
 const messages_1 = require("@langchain/core/messages");
@@ -145,7 +146,8 @@ class AIAnalyzer {
             if (!parsedResult)
                 return null;
             const isAcceptable = parsedResult.isUseful &&
-                this.config.acceptedImageTypes.includes(parsedResult.imageType);
+                this.config.acceptedImageTypes.includes(types_1.IMAGE_TYPE_LABELS[parsedResult.imageType] ??
+                    parsedResult.imageType);
             return {
                 imageType: parsedResult.imageType,
                 isAcceptable,

package/lib/types.d.ts

@@ -106,6 +106,31 @@ export declare const IMAGE_CONTENT_TYPES: {
     description: string;
 }[];
 export declare const DEFAULT_ACCEPTED_IMAGE_TYPES: ImageContentType[];
+export declare const GROUP_SCOPES: {
+    readonly all: "所有群";
+    readonly whitelist: "仅白名单群";
+    readonly blacklist: "排除黑名单群";
+};
+export declare const COLLECT_MODES: {
+    readonly instant: "立即收集";
+    readonly frequency: "频次达标后收集";
+};
+export declare const AI_FILTER_FALLBACKS: {
+    readonly accept: "接受";
+    readonly reject: "拒绝";
+};
+export declare const DEBUG_SCOPES: {
+    readonly all: "全部";
+    readonly collect: "自动获取";
+    readonly ai: "AI调用";
+    readonly http: "HTTP接口";
+    readonly service: "服务内部";
+};
+export type GroupScope = (typeof GROUP_SCOPES)[keyof typeof GROUP_SCOPES];
+export type CollectMode = (typeof COLLECT_MODES)[keyof typeof COLLECT_MODES];
+export type AiFilterFallback = (typeof AI_FILTER_FALLBACKS)[keyof typeof AI_FILTER_FALLBACKS];
+export type DebugScopeName = (typeof DEBUG_SCOPES)[keyof typeof DEBUG_SCOPES];
+export declare const IMAGE_TYPE_LABELS: Record<ImageContentType, string>;
 export interface AIImageFilterResult {
     imageType: ImageContentType;
     isAcceptable: boolean;

package/lib/types.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DEFAULT_ACCEPTED_IMAGE_TYPES = exports.IMAGE_CONTENT_TYPES = void 0;
+exports.IMAGE_TYPE_LABELS = exports.DEBUG_SCOPES = exports.AI_FILTER_FALLBACKS = exports.COLLECT_MODES = exports.GROUP_SCOPES = exports.DEFAULT_ACCEPTED_IMAGE_TYPES = exports.IMAGE_CONTENT_TYPES = void 0;
 exports.IMAGE_CONTENT_TYPES = [
     {
         type: 'emoji',
@@ -67,3 +67,27 @@ exports.DEFAULT_ACCEPTED_IMAGE_TYPES = [
     'pet',
     'artwork'
 ];
+exports.GROUP_SCOPES = {
+    all: '所有群',
+    whitelist: '仅白名单群',
+    blacklist: '排除黑名单群',
+};
+exports.COLLECT_MODES = {
+    instant: '立即收集',
+    frequency: '频次达标后收集',
+};
+exports.AI_FILTER_FALLBACKS = {
+    accept: '接受',
+    reject: '拒绝',
+};
+exports.DEBUG_SCOPES = {
+    all: '全部',
+    collect: '自动获取',
+    ai: 'AI调用',
+    http: 'HTTP接口',
+    service: '服务内部',
+};
+exports.IMAGE_TYPE_LABELS = exports.IMAGE_CONTENT_TYPES.reduce((labels, item) => {
+    labels[item.type] = item.label;
+    return labels;
+}, {});

package/package.json

@@ -1,10 +1,13 @@
 {
   "name": "koishi-plugin-emojiluna-plus",
   "description": "Koishi 智能表情包管理插件（emojiluna fork），支持群聊/私聊自动获取表情包、AI自动分类打标、WebUI管理与HTTP API",
-  "version": "0.0.1",
+  "version": "0.0.2",
   "main": "lib/index.js",
   "typings": "lib/index.d.ts",
-  "files": ["lib", "dist"],
+  "files": [
+    "lib",
+    "dist"
+  ],
   "license": "MIT",
   "scripts": {
     "build": "tsc",
@@ -43,8 +46,8 @@
     "限流"
   ],
   "devDependencies": {
-    "typescript": "^5.3.3",
-    "rimraf": "^5.0.5"
+    "rimraf": "^5.0.5",
+    "typescript": "^5.3.3"
   },
   "dependencies": {
     "@jimp/core": "^1.6.0",

package/readme.md

@@ -8,66 +8,66 @@
 ## 项目介绍 (Project Introduction)
 
 ### 中文
-这是一个为 Koishi 机器人框架开发的**智能表情包管理插件**：自动从群聊与私聊中收集表情包，交给 ChatLuna 的视觉模型完成分类、命名与打标，提供分类/标签管理、按名称与标签检索、文件夹批量导入、WebUI 管理界面与 HTTP 接口。相对上游，本 fork 重写了自动获取，支持私聊，群聊无需配置白名单。
+这是一个为 Koishi 机器人框架开发的**智能表情包管理插件**：自动从群聊与私聊中收集表情包，交给 ChatLuna 的视觉模型完成分类、命名与打标，并提供分类与标签管理、按名称和标签检索、文件夹批量导入、WebUI 管理界面与 HTTP 接口。相对上游，本 fork 重写了自动获取链路。
 
 ### English
-This is an **intelligent meme management plugin** developed for the Koishi bot framework. It automatically collects memes from group chats and private messages, utilizing ChatLuna's vision models to classify, name, and tag them. Features include category and tag management, search by name or tag, batch folder imports, a WebUI management interface, and an HTTP API. Compared to the upstream version, this fork rewrites the automatic collection logic, adds support for private chats, and eliminates the need for a whitelist in group chats.
+This is an **intelligent meme management plugin** developed for the Koishi bot framework. It automatically collects memes from group chats and private messages, utilizes ChatLuna's vision models to classify, name, and tag them, and offers features such as category and tag management, retrieval by name and tag, batch folder importing, a WebUI management interface, and an HTTP API. Compared to the upstream version, this fork features a rewritten automatic acquisition pipeline.
 
 ## 项目仓库 (Repository)
-- GitHub: `https://github.com/Minecraft-1314/koishi-plugin-emojiluna-plus`
+- GitHub: `https://github.com/Minecraft-1314/koishi-plugin-emojiluna-plus.git`
 - Issues: `https://github.com/Minecraft-1314/koishi-plugin-emojiluna-plus/issues`
 
 ## 核心指令 (Core Commands)
 
 | 指令 (Command) | 说明 (Description) | 示例 (Example) |
 |----------------|--------------------|----------------|
-| `emojiluna.get <name>` | 按名称/标签/分类/ID 取图 (Fetch one sticker) | `emojiluna.get 派蒙吃惊` |
-| `emojiluna.add <name>` | 添加表情包，支持 `-c 分类 -t 标签1,标签2 -n 不分析` | `emojiluna.add 测试 -c 动物萌宠 -t 猫,可爱` |
+| `emojiluna.get <name>` | 按名称、标签、分类或 ID 取图 | `emojiluna.get 派蒙吃惊` |
+| `emojiluna.add <name>` | 添加表情包，支持 `-c 分类`、`-t 标签`、`-n 不分析` | `emojiluna.add 测试 -c 动物萌宠 -t 猫,可爱` |
 | `emojiluna.list` | 列表，支持 `-c -t -l -o -T` | `emojiluna.list -c 动物萌宠 -l 5` |
 | `emojiluna.search <keyword>` | 关键词搜索，支持 `-l -o -T` | `emojiluna.search 柴犬 -l 5` |
 | `emojiluna.delete <id>` | 删除指定表情包 | `emojiluna.delete 3f2a…` |
-| `emojiluna.wipe -y` | 清空全库（必须显式 `-y`） | `emojiluna.wipe -y` |
+| `emojiluna.wipe -y` | 清空全库，必须显式确认 | `emojiluna.wipe -y` |
 | `emojiluna.info` | 库存、AI 与自动获取概览 | `emojiluna.info` |
-| `emojiluna.category.add/list/delete/update/cleanup` | 分类管理（删除可用 `-e` 连带删图） | `emojiluna.category.list -l 20` |
-| `emojiluna.tags.list/update/cleanup` | 标签管理 | `emojiluna.tags.update <id> 猫,搞笑` |
+| `emojiluna.category.add / list / delete / update / cleanup` | 分类管理，删除可用 `-e` 连带删图 | `emojiluna.category.list -l 20` |
+| `emojiluna.tags.list / update / cleanup` | 标签管理 | `emojiluna.tags.update <id> 猫,搞笑` |
 | `emojiluna.ai.categorize / analyze <id> / retry` | 批量分类、单图分析、重试失败任务 | `emojiluna.ai.retry` |
 | `emojiluna.auto.status` | 自动获取运行状态与拦截统计 | `emojiluna.auto.status` |
-| `emojiluna.auto.probe [-s]` | 逐闸门判定当前/引用消息中的图片（默认试运行） | `emojiluna.auto.probe -s` |
-| `emojiluna.auto.toggle [on/off/auto]` | 运行时临时开关 | `emojiluna.auto.toggle off` |
+| `emojiluna.auto.probe [-s]` | 逐闸门判定当前或引用消息中的图片，默认试运行 | `emojiluna.auto.probe -s` |
+| `emojiluna.auto.toggle [state]` | 运行时临时开关，取值 on / off / auto | `emojiluna.auto.toggle off` |
 | `emojiluna.auto.reset` | 清零统计、限流与调试日志 | `emojiluna.auto.reset` |
 | `emojiluna.debug [-l]` | 回看调试日志环形缓冲 | `emojiluna.debug -l 30` |
 
 ## 自动获取行为 (Auto Collect Behaviour)
 
-判定顺序如下，任一步不通过即拦截并计数（可在 `emojiluna.auto.status` 的“拦截”行看到）：
+判定顺序如下，任一步不通过即拦截并计数，可在 `emojiluna.auto.status` 的“拦截”行查看：
 
-1. **生效范围**：群聊看 `collectGroup` 与 `groupScope`（`all` / `whitelist` / `blacklist`），私聊看 `collectDirect`。
-2. **取图**：依次尝试元素的 `url → src → file → path`，支持 `http(s)://`、`file://`、Windows/POSIX 本地路径、`data:`、`base64://`。
+1. **生效范围**：群聊看 `collectGroup` 与 `groupScope`，私聊看 `collectDirect`。
+2. **取图**：依次尝试元素的 `url`、`src`、`file`、`path` 属性。
 3. **格式**：按文件魔数校验，非图片直接拒绝，避免把错误页存成表情包。
-4. **大小 / 分辨率**：`minEmojiSize`、`maxEmojiSize`、`minEdgePixels`。
-5. **内容去重**：sha256 命中缓存或数据库即拦截。
-6. **频次**：`autoCollectMode=frequency` 时要求窗口内达到 `emojiFrequencyThreshold` 次。
-7. **感知去重**：多帧抽样 + aHash/dHash + 亮度/对比度惩罚，超过 `similarityThreshold` 视为同一张图。
+4. **大小与分辨率**：`minEmojiSize`、`maxEmojiSize`、`minEdgePixels`。
+5. **内容去重**：sha256 命中内存缓存或数据库即拦截。
+6. **频次**：`autoCollectMode` 为“频次达标后收集”时要求窗口内达到 `emojiFrequencyThreshold` 次。
+7. **感知去重**：多帧抽样 + 均值哈希 + 差值哈希 + 亮度对比度惩罚，超过 `similarityThreshold` 视为同一张图。
 8. **AI 类型过滤**：`enableImageTypeFilter` 开启时调用模型判定类型，超时或无模型按 `aiFilterFallback` 兜底，结果按内容哈希缓存。
-9. **库存与限流**：`maxEmojiCount`、单会话 `groupAutoCollectLimit`、`globalDayLimit`。
-10. **入库**：写入 `data/emojiluna-plus`（可配置），打上 `自动获取` + `群:<id>` / `私聊` 标签，并按 `autoAnalyze` 排队 AI 命名打标。
+9. **库存与限流**：`maxEmojiCount`、按会话的 `groupAutoCollectLimit`、全局 `globalDayLimit`。
+10. **入库**：写入存储目录，打上 `自动获取` 与 `群:<群号>` 或 `私聊` 标签，并按 `autoAnalyze` 排队 AI 命名打标。
 
 ## 配置项说明 (Configuration)
 
 ### 基础设置 (Basic Settings)
 | 配置项 (Config) | 类型 (Type) | 默认值 (Default) | 说明 (Description) |
 |----------------|-------------|-------------------|---------------------|
-| `maxEmojiCount` | number | 100 | 表情包库存上限（自动获取与上传均生效） |
-| `maxFileSize` | number | 4 | 单个文件大小上限 (MB) |
+| `maxEmojiCount` | number | 100 | 表情包库存上限，自动获取与上传都受限于此值 |
+| `maxFileSize` | number | 4 | 单个文件大小上限，单位 MB |
 | `selfUrl` | string | 空 | 服务器地址，用于生成表情包外链 |
-| `storagePath` | path | `./data/emojiluna` | 存储目录（相对应用根目录解析） |
+| `storagePath` | path | `./data/emojiluna` | 存储目录，相对应用根目录解析 |
 | `categories` | string[] | 10 个预设 | 预定义分类 |
 | `autoCategorize` | boolean | true | 启用 AI 自动分类 |
-| `autoAnalyze` | boolean | true | 启用 AI 信息解析（命名/标签/描述） |
+| `autoAnalyze` | boolean | true | 启用 AI 信息解析，含命名、标签与描述 |
 | `autoCollect` | boolean | false | 启用自动获取表情包 |
 | `collectGroup` | boolean | true | 群聊也自动获取 |
 | `collectDirect` | boolean | true | 私聊也自动获取 |
-| `groupScope` | string | `all` | 群聊范围：`all` / `whitelist` / `blacklist` |
+| `groupScope` | string | 所有群 | 取值：所有群、仅白名单群、排除黑名单群 |
 | `triggerWithName` | boolean | false | 消息文本命中表情包名时自动发图 |
 
 ### 提示词与注入 (Prompts & Injection)
@@ -76,60 +76,61 @@ This is an **intelligent meme management plugin** developed for the Koishi bot f
 | `categorizePrompt` | textarea | 见预设 | 分类提示词，占位符 `{categories}` |
 | `analyzePrompt` | textarea | 见预设 | 解析提示词，占位符 `{categories}` |
 | `imageFilterPrompt` | textarea | 见预设 | 图片类型过滤提示词 |
-| `injectVariablesPrompt` | textarea | 见预设 | ChatLuna 变量注入模板，占位符 `{emojis}` |
-| `injectVariables` | boolean | true | 注入 `{emojis}` 变量（需启用后端服务器） |
+| `injectVariablesPrompt` | textarea | 见预设 | ChatLuna 变量注入提示词，占位符 `{emojis}` |
+| `injectVariables` | boolean | true | 注入 `{emojis}` 变量，需要启用后端服务器 |
 | `injectVariablesLimit` | number | 50 | 注入的表情包数量 |
 
 ### API 配置 (API Settings)
 | 配置项 (Config) | 类型 (Type) | 默认值 (Default) | 说明 (Description) |
 |----------------|-------------|-------------------|---------------------|
-| `backendServer` | boolean | false | 启用 HTTP 接口（WebUI 批量上传依赖它） |
+| `backendServer` | boolean | false | 启用 HTTP 接口，WebUI 批量上传依赖它 |
 | `backendPath` | string | `/emojiluna` | HTTP 接口前缀 |
-| `uploadToken` | string | 空 | 上传接口令牌；留空时自动随机生成，仅 WebUI 可用 |
-| `folderImportRoots` | string[] | `[]` | 允许扫描导入的服务端目录前缀，空为不限制 |
+| `uploadToken` | string | 空 | 上传接口令牌，留空时自动生成，仅控制台可用 |
+| `folderImportRoots` | string[] | `[]` | 允许扫描导入的服务端目录前缀，为空表示不限制 |
 
 ### 性能与并发 (Performance & Concurrency)
 | 配置项 (Config) | 类型 (Type) | 默认值 (Default) | 说明 (Description) |
 |----------------|-------------|-------------------|---------------------|
-| `model` | dynamic | 空 | ChatLuna 模型（列表由 chatluna 注入） |
-| `batchSize` | number | 6 | 批量上传/导入的并发批大小 |
+| `model` | dynamic | 空 | ChatLuna 模型，列表由 chatluna 注入 |
+| `batchSize` | number | 6 | 上传与分析的批量处理大小 |
 | `aiConcurrency` | number | 3 | AI 分析并发数 |
-| `AIBatchDelay` | number | 300 | AI 任务派发间隔 (ms) |
+| `AIBatchDelay` | number | 300 | AI 任务派发间隔，单位毫秒 |
 | `AIMaxAttempts` | number | 3 | AI 任务最大重试次数 |
-| `AIRequestTimeout` | number | 90000 | 单次 AI 请求超时 (ms)，防止占死并发额度 |
-| `AIBackoffBase` | number | 1000 | AI 重试退避基数 (ms) |
+| `AIRequestTimeout` | number | 90000 | 单次 AI 请求超时，单位毫秒 |
+| `AIBackoffBase` | number | 1000 | AI 重试退避基数，单位毫秒 |
 
 ### 自动获取配置 (Auto Collect Settings)
 | 配置项 (Config) | 类型 (Type) | 默认值 (Default) | 说明 (Description) |
 |----------------|-------------|-------------------|---------------------|
-| `minEmojiSize` | number | 10 | 最小体积 (KB) |
-| `maxEmojiSize` | number | 2 | 最大体积 (MB) |
+| `minEmojiSize` | number | 10 | 最小体积，单位 KB |
+| `maxEmojiSize` | number | 2 | 最大体积，单位 MB |
 | `similarityThreshold` | slider | 0.9 | 感知相似度阈值 |
-| `whitelistGroups` / `blacklistGroups` | string[] | `[]` | 白名单 / 黑名单群号 |
-| `autoCollectMode` | string | `instant` | `instant` 出现即收集，`frequency` 需达频次 |
-| `emojiFrequencyThreshold` | number | 3 | 窗口内达到该次数才收集 |
-| `frequencyWindow` | number | 10 | 频次统计窗口（分钟） |
-| `minEdgePixels` | number | 0 | 最短边像素下限，0 不限制 |
-| `fetchTimeout` | number | 20000 | 拉图超时 (ms) |
-| `allowLocalPaths` | boolean | true | 允许读取适配器给出的本地路径 |
-| `localPathRoots` | string[] | `[]` | 本地读取目录白名单，空为不限制 |
-| `autoCollectQueue` | number | 2 | 后台处理并发数 |
-| `autoCollectQueueSize` | number | 64 | 后台队列上限，超出丢弃并计数 |
-| `globalDayLimit` | number | 1000 | 全局每日收集上限，0 不限制 |
-| `groupAutoCollectLimit` | dict | `{}` | 按群覆盖每小时 / 每日上限（默认 20 / 100） |
-| `autoCollectCategory` | string | `其他` | 入库初始分类 |
-| `autoCollectNameTemplate` | string | `自动获取_{date}_{index}` | 入库名称模板 |
+| `whitelistGroups` | string[] | `[]` | 白名单群号 |
+| `blacklistGroups` | string[] | `[]` | 黑名单群号 |
+| `autoCollectMode` | string | 立即收集 | 取值：立即收集、频次达标后收集 |
+| `emojiFrequencyThreshold` | number | 3 | 频次模式下窗口内的发送次数阈值 |
+| `frequencyWindow` | number | 10 | 频次统计窗口，单位分钟 |
+| `minEdgePixels` | number | 0 | 图片最短边像素下限，0 表示不限制 |
+| `fetchTimeout` | number | 20000 | 拉取图片超时，单位毫秒 |
+| `allowLocalPaths` | boolean | true | 允许读取适配器给出的本地图片路径 |
+| `localPathRoots` | string[] | `[]` | 允许读取的本地目录前缀，为空表示不限制 |
+| `autoCollectQueue` | number | 2 | 自动获取后台并发数 |
+| `autoCollectQueueSize` | number | 64 | 自动获取后台队列上限，超出丢弃并计数 |
+| `globalDayLimit` | number | 1000 | 全局每天自动获取上限，0 表示不限制 |
+| `groupAutoCollectLimit` | dict | `{}` | 按群覆盖每小时与每日上限，默认 20 与 100 |
+| `autoCollectCategory` | string | 其他 | 自动获取入库时的初始分类 |
+| `autoCollectNameTemplate` | string | `自动获取_{date}_{index}` | 自动获取入库名称模板 |
 | `enableImageTypeFilter` | boolean | true | 启用 AI 图片类型过滤 |
-| `acceptedImageTypes` | string[] | emoji/sticker/meme/comic/anime/pet/artwork | 允许入库的图片类型 |
-| `aiFilterTimeout` | number | 20000 | AI 过滤超时 (ms) |
-| `aiFilterFallback` | string | `accept` | AI 不可用或超时时的兜底策略 |
+| `acceptedImageTypes` | string[] | 表情包、贴纸、梗图、漫画、动漫图片、宠物图片、艺术作品 | 允许自动获取入库的图片类型 |
+| `aiFilterTimeout` | number | 20000 | AI 图片类型过滤超时，单位毫秒 |
+| `aiFilterFallback` | string | 接受 | AI 过滤超时或模型不可用时的兜底策略，取值：接受、拒绝 |
 
 ### 调试配置 (Debug Settings)
 | 配置项 (Config) | 类型 (Type) | 默认值 (Default) | 说明 (Description) |
 |----------------|-------------|-------------------|---------------------|
-| `debug` | boolean | false | 输出调试日志：自动获取判定、AI 调用、HTTP 接口、服务初始化 |
-| `debugOnly` | string | `all` | 日志范围：`all` / `collect` / `ai` / `http` / `service` |
-| `logLimit` | number | 200 | 环形缓冲条数，供 `emojiluna.debug` 回看 |
+| `debug` | boolean | false | 输出调试日志 |
+| `debugOnly` | string | 全部 | 调试日志范围，取值：全部、自动获取、AI调用、HTTP接口、服务内部 |
+| `logLimit` | number | 200 | 调试日志环形缓冲条数 |
 
 ## 名称模板变量 (Name Template Variables)
 
@@ -137,29 +138,29 @@ This is an **intelligent meme management plugin** developed for the Koishi bot f
 
 | 变量 (Variable) | 说明 (Description) |
 |----------------|--------------------|
-| `{date}` | 年月日 `20260915` |
-| `{time}` | 时分秒 `153012` |
+| `{date}` | 年月日，形如 20260915 |
+| `{time}` | 时分秒，形如 153012 |
 | `{sender}` | 发送者昵称，缺省回退到 ID |
-| `{chat}` | 群号；私聊为 `direct` |
+| `{chat}` | 群号，私聊时为 direct |
 | `{index}` | 递增序号 |
 
 ## 支持的图片来源 (Supported Image Sources)
 
 | 来源 (Source) | 示例 (Example) | 处理方式 (Handling) |
 |---------------|----------------|---------------------|
-| HTTP/HTTPS | `https://gchat.qpic.cn/…` | `ctx.http` 拉取，带 UA 与 `fetchTimeout` 超时 |
-| 本地绝对路径 | `C:\Users\…\Pic\xx.jpg`、`/data/x.png` | 直接读盘（`allowLocalPaths`、`localPathRoots` 约束） |
+| HTTP 与 HTTPS | `https://gchat.qpic.cn/…` | 走 `ctx.http` 拉取，带 UA 与超时 |
+| 本地绝对路径 | `C:\Users\…\Pic\xx.jpg`、`/data/x.png` | 直接读盘，受 `allowLocalPaths` 与 `localPathRoots` 约束 |
 | file URI | `file:///C:/…/x.png` | 解析为本地路径后读取 |
 | data URI | `data:image/png;base64,…` | 就地解码 |
 | Koishi 内联 | `base64://…` | 就地解码 |
-| 缺失属性 | 元素无 `url/src/file/path` | 拦截并记为“取图”失败 |
+| 缺失属性 | 元素没有 `url`、`src`、`file`、`path` | 拦截并记为取图失败 |
 
 ## 项目贡献者 (Contributors)
 
 | 贡献者 (Contributor) | 贡献内容 (Contribution) |
 |----------------------|-------------------------|
 | ChatLunaLab | 上游 emojiluna 全部原始功能 (Original upstream work) |
-| Minecraft-1314 | fork 改造：自动获取重写、缺陷修复、调试模式与测试 (Fork, fixes, debug mode, tests) |
+| Minecraft-1314 | fork 改造 |
 
 （欢迎通过 Issues 或 PR 加入贡献者列表）