koishi-plugin-ai-puzzle 0.0.1

package/lib/ai.d.ts

@@ -0,0 +1,17 @@
+import { EndpointConfig, AIMessage } from './types';
+export interface Logger {
+    debug: (...args: any[]) => void;
+    info: (...args: any[]) => void;
+    warn: (...args: any[]) => void;
+    error: (...args: any[]) => void;
+}
+export declare class AIClient {
+    private logger?;
+    constructor(logger?: Logger);
+    generate(messages: AIMessage[], endpoints: EndpointConfig[]): Promise<string>;
+    /** 轮询模式：按顺序轮询，每个端点失败后重试一次，还失败则尝试下一个 */
+    private generateRoundRobin;
+    /** 故障转移模式：优先用第一个，失败后依次尝试其余端点 */
+    private generateFailover;
+    private callEndpoint;
+}

package/lib/game.d.ts

@@ -0,0 +1,60 @@
+import { Context, Session } from 'koishi';
+import { ChannelStateManager } from './state';
+import { PromptManager } from './prompt';
+import { AIClient } from './ai';
+import { AnswerMatcher } from './matcher';
+import { ImageRenderer } from './render';
+import { Config } from './types';
+import type { Logger } from './ai';
+export declare class GameOrchestrator {
+    private ctx;
+    private config;
+    private stateManager;
+    private promptManager;
+    private aiClient;
+    private matcher;
+    private renderer;
+    private logger;
+    constructor(ctx: Context, config: Config, stateManager: ChannelStateManager, promptManager: PromptManager, aiClient: AIClient, matcher: AnswerMatcher, renderer: ImageRenderer, logger?: Logger);
+    /** 开始游戏 */
+    startGame(session: Session, extensionRule?: string, userPuzzleCode?: string): Promise<string>;
+    /** 手动获取下一条线索 */
+    nextClue(session: Session): Promise<string>;
+    /** 处理猜测（开放模式中间件 / 限制模式 guess 命令） */
+    processGuess(session: Session, guessText: string): Promise<string | null>;
+    /** 停止游戏 */
+    stopGame(session: Session): Promise<string>;
+    /** 切换模板 */
+    switchTemplate(session: Session, keyword: string): string;
+    /** 切换模式（通用） */
+    switchMode(session: Session, modeUpdate: Partial<{
+        manualMode: boolean;
+        autoInterval: number;
+        autoExtraDelay: number;
+        openMode: boolean;
+        restrictPuzzle: number;
+        restrictClue: number;
+        preMode: boolean;
+    }>): string;
+    /** 列出模板：当前频道已选 + 可切换的模板 */
+    listTemplates(session: Session): string;
+    /** 添加用户出题（交互式） */
+    addUserPuzzle(session: Session, code: string): Promise<void>;
+    /** 删除用户出题 */
+    deleteUserPuzzle(session: Session, code: string): Promise<string>;
+    /** 预生成切换 */
+    togglePreMode(session: Session): string;
+    /** 检查超时并结束游戏（由定时器调用） */
+    checkAndEndTimeout(channelId: string): Promise<boolean>;
+    private startAIPuzzle;
+    private startUserPuzzle;
+    private beginPlaying;
+    private throwNextClue;
+    private endGame;
+    private scheduleAutoClue;
+    private preGenerate;
+    private promptWithCancel;
+    private buildFullTextResult;
+    private getHistory;
+    private updateHistory;
+}

package/lib/index.d.ts

@@ -0,0 +1,22 @@
+import { Context, Schema } from 'koishi';
+export declare const name = "ai-puzzle";
+export declare const inject: string[];
+export interface Config {
+    endpoints: {
+        baseURL: string;
+        apiKey: string;
+        model: string;
+    }[];
+    templates: {
+        keyword: string;
+        clueLevels: number[];
+        fuzzyEnabled: boolean;
+        fuzzyThreshold: number;
+        globalHistory: boolean;
+    }[];
+    imageOutput: boolean;
+    /** 日志显示级别：debug=0 全部, info=1 一般, warn=2 警告, error=3 仅错误 */
+    logLevel: number;
+}
+export declare const Config: Schema<Config>;
+export declare function apply(ctx: Context, config: Config): void;