koishi-plugin-go-bank 0.0.1

package/lib/api.d.ts

@@ -0,0 +1,44 @@
+import type { Problem, ReviewResult, TodayReviewItem, ReviewStats, PlanOut, PlanDailyOut, PlanSessionResult, PlanProgressRender } from './types';
+export declare class GoBankAPI {
+    private baseUrl;
+    constructor(baseUrl: string);
+    private get;
+    private post;
+    private del;
+    randomProblem(params: {
+        type?: string;
+        difficulty?: string;
+        difficulty_match?: string;
+    }): Promise<Problem>;
+    randomProblems(difficulty: string, type: string, count: number): Promise<Problem[]>;
+    submitReview(data: {
+        qq_number: string;
+        problem_id: number;
+        quality: number;
+    }): Promise<ReviewResult>;
+    getTodayReview(qqNumber: string): Promise<{
+        total: number;
+        items: TodayReviewItem[];
+    }>;
+    getReviewStats(qqNumber: string): Promise<ReviewStats>;
+    getPlan(qqNumber: string): Promise<PlanOut>;
+    savePlan(data: {
+        qq_number: string;
+        difficulty: string;
+        daily_groups: number;
+        problems_per_group: number;
+    }): Promise<PlanOut>;
+    resetPlan(qqNumber: string): Promise<PlanProgressRender>;
+    generateDailyPlan(data: {
+        qq_number: string;
+        difficulty: string;
+        daily_groups: number;
+        problems_per_group: number;
+    }): Promise<PlanDailyOut>;
+    getDailyPlan(qqNumber: string): Promise<PlanDailyOut>;
+    planSessionSubmit(data: {
+        qq_number: string;
+        session_id: number;
+        quality: number;
+    }): Promise<PlanSessionResult>;
+}

package/lib/index.d.ts

@@ -0,0 +1,26 @@
+import { Context, Schema } from 'koishi';
+export declare const name = "go-bank";
+export interface Config {
+    apiBaseUrl: string;
+    dailyPush: {
+        enabled: boolean;
+        time: string;
+        difficulty: string;
+        type: string;
+        count: number;
+        groups: string[];
+        message: string;
+    };
+    hourlyPush: {
+        enabled: boolean;
+        startHour: number;
+        endHour: number;
+        difficulty: string;
+        type: string;
+        count: number;
+        groups: string[];
+        message: string;
+    };
+}
+export declare const Config: Schema<Config>;
+export declare function apply(ctx: Context, config: Config): void;

package/lib/middleware.d.ts

@@ -0,0 +1,4 @@
+import { GoBankAPI } from './api';
+type GetUserIdFn = (userId: string) => string;
+export declare function createMiddleware(api: GoBankAPI, getUserId: GetUserIdFn): (session: any, next: () => Promise<void>) => Promise<void>;
+export {};

package/lib/parser.d.ts

@@ -0,0 +1,13 @@
+import { QuickCommand } from './types';
+/**
+ * Parse quick commands like:
+ *   !8k          → difficulty=8K, count=1
+ *   !8k 10       → difficulty=8K, count=10
+ *   !官子         → type=guanzi, count=1
+ *   !官子 10      → type=guanzi, count=10
+ *   !官子-8k      → type=guanzi, difficulty=8K, count=1
+ *   !官子-8k 5    → type=guanzi, difficulty=8K, count=5
+ *
+ * Returns null if not a valid quick command.
+ */
+export declare function parseQuickCommand(text: string): QuickCommand | null;

package/lib/scheduler.d.ts

@@ -0,0 +1,24 @@
+import { Context } from 'koishi';
+export interface DailyPushConfig {
+    enabled: boolean;
+    time: string;
+    difficulty: string;
+    type: string;
+    count: number;
+    groups: string[];
+    message: string;
+}
+export interface HourlyPushConfig {
+    enabled: boolean;
+    startHour: number;
+    endHour: number;
+    difficulty: string;
+    type: string;
+    count: number;
+    groups: string[];
+    message: string;
+}
+/**
+ * Start push schedulers. Checks every 60 seconds.
+ */
+export declare function startScheduler(ctx: Context, daily: DailyPushConfig, hourly: HourlyPushConfig, fetchRandom: (difficulty: string, type: string, count: number) => Promise<any[]>): void;

package/lib/session.d.ts

@@ -0,0 +1,5 @@
+import { UserSession, SessionMode } from './types';
+export declare function getSession(userId: string): UserSession | undefined;
+export declare function setSession(userId: string, session: UserSession): void;
+export declare function clearSession(userId: string): void;
+export declare function createSession(mode: SessionMode, overrides?: Partial<UserSession>): UserSession;

package/lib/types.d.ts

@@ -0,0 +1,121 @@
+export interface Problem {
+    id: number;
+    problem_number: string;
+    difficulty: string;
+    type: string;
+    image_url: string;
+    answer_image_url: string | null;
+    is_active: boolean;
+}
+export interface ReviewResult {
+    problem_id: number;
+    problem_number: string;
+    quality: number;
+    ease_factor: number;
+    interval_days: number;
+    repetitions: number;
+    status: string;
+    next_review_time: string;
+}
+export interface TodayReviewItem {
+    problem_id: number;
+    problem_number: string;
+    difficulty: string;
+    type: string;
+    image_url: string;
+    answer_image_url: string | null;
+    status: string;
+}
+export interface ReviewStats {
+    total_problems: number;
+    new_count: number;
+    learning_count: number;
+    review_count: number;
+    mastered_count: number;
+    today_reviewed: number;
+    today_remaining: number;
+    total_reviews: number;
+    accuracy_rate: number;
+}
+export interface PlanOut {
+    id: number;
+    user_id: number;
+    difficulty: string;
+    daily_groups: number;
+    problems_per_group: number;
+    is_active: boolean;
+}
+export interface PlanDailyItem {
+    session_id: number;
+    problem: Problem;
+    group_num: number;
+    order_in_group: number;
+    source: 'new' | 'review';
+    completed: boolean;
+}
+export interface PlanDailyOut {
+    plan_date: string;
+    difficulty: string;
+    daily_groups: number;
+    problems_per_group: number;
+    total_new: number;
+    total_review: number;
+    total_done: number;
+    current_group: number;
+    group_progress: number;
+    carryover: number;
+    items: PlanDailyItem[];
+}
+export interface PlanSessionResult {
+    session_id: number;
+    quality: number;
+    next_problem: PlanDailyItem | null;
+    group_complete: boolean;
+    all_complete: boolean;
+    daily_progress: string;
+}
+export interface PlanProgressRender {
+    plan: PlanOut | null;
+    total_done_today: number;
+    total_done_all: number;
+    status_text: string;
+}
+export type SessionMode = 'idle' | 'immersive' | 'review' | 'plan';
+export interface UserSession {
+    mode: SessionMode;
+    currentProblem: Problem | PlanDailyItem;
+    lastInteraction: Date;
+    immersiveCriteria?: {
+        type?: string;
+        difficulty?: string;
+    };
+    reviewQueue?: TodayReviewItem[];
+    reviewIndex?: number;
+    reviewTotal?: number;
+    planSession?: {
+        difficulty: string;
+        dailyGroups: number;
+        problemsPerGroup: number;
+        currentGroup: number;
+        groupProgress: number;
+        dailyTotal: number;
+        dailyDone: number;
+    };
+    pendingPlanTemplate?: boolean;
+}
+export interface QuickCommand {
+    type: 'difficulty' | 'type' | 'both';
+    difficulty?: string;
+    problemType?: string;
+    count: number;
+}
+export declare const TYPE_MAP: Record<string, string>;
+export declare const TYPE_REVERSE_MAP: Record<string, string>;
+export declare const STATUS_MAP: Record<string, string>;
+export declare const DIFFICULTY_HIERARCHY: string[];
+export declare const VALID_TYPES: string[];
+export declare function getTypeName(type: string): string;
+export declare function getTypeCode(name: string): string;
+export declare function getStatusName(status: string): string;
+/** Get the next harder difficulty tier. Returns null if already at max. */
+export declare function getNextDifficulty(diff: string): string | null;

package/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "koishi-plugin-go-bank",
+  "description": "围棋题库管理与训练插件",
+  "version": "0.0.1",
+  "main": "lib/index.js",
+  "typings": "lib/index.d.ts",
+  "files": [
+    "lib",
+    "dist"
+  ],
+  "license": "MIT",
+  "keywords": [
+    "chatbot",
+    "koishi",
+    "plugin",
+    "go",
+    "围棋"
+  ],
+  "peerDependencies": {
+    "koishi": "^4.18.7"
+  }
+}