hydro-ai-helper 1.8.5

package/dist/handlers/teacherHandler.js

@@ -0,0 +1,246 @@
+"use strict";
+/**
+ * 教师端 Handler
+ * 处理教师查看对话列表和详情的请求
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConversationDetailHandlerPriv = exports.ConversationListHandlerPriv = exports.ConversationDetailHandler = exports.ConversationListHandler = void 0;
+const hydrooj_1 = require("hydrooj");
+const mongo_1 = require("../utils/mongo");
+const httpHelpers_1 = require("../lib/httpHelpers");
+const queryHelpers_1 = require("../lib/queryHelpers");
+const domainHelper_1 = require("../utils/domainHelper");
+/**
+ * 批量获取用户名映射
+ * @param uids 用户 ID 数组
+ * @returns uid -> uname 映射表
+ */
+async function getUserNameMap(uids) {
+    const uniqueUids = [...new Set(uids)];
+    const userMap = new Map();
+    if (uniqueUids.length === 0) {
+        return userMap;
+    }
+    try {
+        // 直接使用 HydroOJ db 访问 user 集合
+        const userColl = hydrooj_1.db.collection('user');
+        const users = await userColl.find({ _id: { $in: uniqueUids } }).toArray();
+        for (const user of users) {
+            const u = user;
+            userMap.set(u._id, u.uname || '已删除用户');
+        }
+        // 对于不存在的用户，设置默认值
+        for (const uid of uniqueUids) {
+            if (!userMap.has(uid)) {
+                userMap.set(uid, '已删除用户');
+            }
+        }
+    }
+    catch (err) {
+        console.error('[AI Helper] Failed to fetch user names:', err);
+        // 出错时全部使用默认值
+        for (const uid of uniqueUids) {
+            userMap.set(uid, '已删除用户');
+        }
+    }
+    return userMap;
+}
+/**
+ * T031/T032: 生成题目详情页 URL
+ * @param domainId 域 ID
+ * @param problemId 题目 ID
+ * @returns 题目详情页 URL
+ */
+function buildProblemUrl(domainId, problemId) {
+    if (!problemId)
+        return '';
+    // 域前缀格式：/d/:domainId/p/:problemId
+    // 主站格式：/p/:problemId
+    if (domainId && domainId !== 'system') {
+        return `/d/${domainId}/p/${problemId}`;
+    }
+    return `/p/${problemId}`;
+}
+/**
+ * ConversationListHandler - 获取对话列表
+ * GET /ai-helper/conversations
+ * GET /d/:domainId/ai-helper/conversations
+ */
+class ConversationListHandler extends hydrooj_1.Handler {
+    async get() {
+        try {
+            const wantJson = (0, httpHelpers_1.expectsJson)(this);
+            const conversationModel = this.ctx.get('conversationModel');
+            // 获取当前域 ID（用于域隔离）
+            const domainId = (0, domainHelper_1.getDomainId)(this);
+            // 从查询参数读取筛选条件
+            const { startDate, endDate, problemId, classId, userId, page = '1', limit = '50' } = this.request.query;
+            // 解析分页参数
+            const { page: pageNum, limit: limitNum } = (0, queryHelpers_1.parsePaginationParams)(page, limit);
+            // 构造筛选条件（始终包含 domainId 以实现域隔离）
+            const filters = {
+                domainId // 域隔离：只查询当前域的对话
+            };
+            if (startDate) {
+                filters.startDate = startDate;
+            }
+            if (endDate) {
+                filters.endDate = endDate;
+            }
+            if (problemId) {
+                filters.problemId = problemId;
+            }
+            if (classId) {
+                filters.classId = classId;
+            }
+            if (userId) {
+                filters.userId = parseInt(userId, 10);
+            }
+            // 查询对话列表（已通过 domainId 实现域隔离）
+            const { conversations, total } = await conversationModel.findByFilters(filters, pageNum, limitNum);
+            // 批量获取用户名（避免 N+1 查询）
+            const uids = conversations.map(conv => conv.userId);
+            const userNameMap = await getUserNameMap(uids);
+            // T048: 批量获取每个会话的第一条学生消息
+            const messageModel = this.ctx.get('messageModel');
+            const conversationIds = conversations.map(conv => conv._id);
+            const firstMessagesMap = await messageModel.findFirstStudentMessagesForConversations(conversationIds);
+            // T031: 转换为响应格式（包含 problemUrl 和 firstMessageSummary）
+            const conversationSummaries = conversations.map(conv => {
+                const convIdStr = conv._id.toString();
+                const firstMsg = firstMessagesMap.get(convIdStr);
+                // T048: 截取前100字作为摘要
+                let firstMessageSummary;
+                if (firstMsg?.content) {
+                    firstMessageSummary = firstMsg.content.length > 100
+                        ? firstMsg.content.substring(0, 100) + '...'
+                        : firstMsg.content;
+                }
+                return {
+                    _id: convIdStr,
+                    userId: conv.userId,
+                    userName: userNameMap.get(conv.userId) || '已删除用户',
+                    classId: conv.classId,
+                    problemId: conv.problemId,
+                    problemUrl: buildProblemUrl(domainId, conv.problemId), // T031: 题目链接
+                    startTime: conv.startTime.toISOString(),
+                    endTime: conv.endTime.toISOString(),
+                    messageCount: conv.messageCount,
+                    isEffective: conv.isEffective,
+                    tags: conv.tags,
+                    teacherNote: conv.teacherNote,
+                    metadata: conv.metadata,
+                    firstMessageSummary // T048: 学生问题摘要
+                };
+            });
+            if (wantJson) {
+                (0, httpHelpers_1.setJsonResponse)(this, {
+                    conversations: conversationSummaries,
+                    total,
+                    page: pageNum,
+                    limit: limitNum
+                });
+                return;
+            }
+            (0, httpHelpers_1.setTemplateResponse)(this, 'ai-helper/teacher_conversations.html', {
+                total,
+                page: pageNum,
+                limit: limitNum
+            });
+        }
+        catch (err) {
+            console.error('[AI Helper] ConversationListHandler error:', err);
+            (0, httpHelpers_1.setErrorResponse)(this, 'INTERNAL_ERROR', err instanceof Error ? err.message : '服务器内部错误', 500);
+        }
+    }
+}
+exports.ConversationListHandler = ConversationListHandler;
+/**
+ * ConversationDetailHandler - 获取对话详情
+ * GET /ai-helper/conversations/:id
+ * GET /d/:domainId/ai-helper/conversations/:id
+ */
+class ConversationDetailHandler extends hydrooj_1.Handler {
+    async get({ id }) {
+        try {
+            const wantJson = (0, httpHelpers_1.expectsJson)(this);
+            const conversationModel = this.ctx.get('conversationModel');
+            const messageModel = this.ctx.get('messageModel');
+            // 获取当前域 ID（用于域隔离验证）
+            const domainId = (0, domainHelper_1.getDomainId)(this);
+            if (!mongo_1.ObjectId.isValid(id)) {
+                (0, httpHelpers_1.setErrorResponse)(this, 'INVALID_ID', '无效的会话 ID');
+                return;
+            }
+            // 查询会话详情
+            const conversation = await conversationModel.findById(id);
+            if (!conversation) {
+                (0, httpHelpers_1.setErrorResponse)(this, 'NOT_FOUND', '会话不存在', 404);
+                return;
+            }
+            // 域隔离验证：确保对话属于当前域
+            // 特殊处理：
+            // 1. 对话的 domainId 为 'system'（历史数据迁移默认值）时，允许任何域访问
+            // 2. 当前访问域为 'system'（主站访问）时，允许访问所有域的对话
+            const conversationDomain = conversation.domainId || 'system';
+            if (conversationDomain !== domainId && conversationDomain !== 'system' && domainId !== 'system') {
+                (0, httpHelpers_1.setErrorResponse)(this, 'FORBIDDEN', '无权访问此对话', 403);
+                return;
+            }
+            // 查询会话的所有消息 (按时间升序)
+            const messages = await messageModel.findByConversationId(id);
+            // 转换消息格式
+            const messagesFormatted = messages.map(msg => ({
+                _id: msg._id.toString(),
+                role: msg.role,
+                content: msg.content,
+                timestamp: msg.timestamp.toISOString(),
+                questionType: msg.questionType,
+                attachedCode: msg.attachedCode,
+                attachedError: msg.attachedError,
+                metadata: msg.metadata
+            }));
+            // 获取用户名
+            const userNameMap = await getUserNameMap([conversation.userId]);
+            const userName = userNameMap.get(conversation.userId) || '已删除用户';
+            // T032: 对话详情响应（包含 problemUrl）
+            const conversationData = {
+                _id: conversation._id.toString(),
+                userId: conversation.userId,
+                userName,
+                classId: conversation.classId,
+                problemId: conversation.problemId,
+                problemUrl: buildProblemUrl(domainId, conversation.problemId), // T032: 题目链接
+                startTime: conversation.startTime.toISOString(),
+                endTime: conversation.endTime.toISOString(),
+                messageCount: conversation.messageCount,
+                isEffective: conversation.isEffective,
+                tags: conversation.tags,
+                teacherNote: conversation.teacherNote,
+                metadata: conversation.metadata
+            };
+            if (wantJson) {
+                (0, httpHelpers_1.setJsonResponse)(this, {
+                    conversation: conversationData,
+                    messages: messagesFormatted
+                });
+                return;
+            }
+            (0, httpHelpers_1.setTemplateResponse)(this, 'ai-helper/teacher_conversation_detail.html', {
+                conversation: conversationData,
+                messages: messagesFormatted
+            });
+        }
+        catch (err) {
+            console.error('[AI Helper] ConversationDetailHandler error:', err);
+            (0, httpHelpers_1.setErrorResponse)(this, 'INTERNAL_ERROR', err instanceof Error ? err.message : '服务器内部错误', 500);
+        }
+    }
+}
+exports.ConversationDetailHandler = ConversationDetailHandler;
+// 导出路由权限配置
+// 使用 PRIV.PRIV_EDIT_SYSTEM (root-only 权限)
+// AI 对话数据敏感，目前仅允许系统管理员访问
+exports.ConversationListHandlerPriv = hydrooj_1.PRIV.PRIV_EDIT_SYSTEM;
+exports.ConversationDetailHandlerPriv = hydrooj_1.PRIV.PRIV_EDIT_SYSTEM;
+//# sourceMappingURL=teacherHandler.js.map

package/dist/handlers/teacherHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"teacherHandler.js","sourceRoot":"","sources":["../../src/handlers/teacherHandler.ts"],"names":[],"mappings":"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"}

package/dist/handlers/testHandler.js

@@ -0,0 +1,27 @@
+"use strict";
+/**
+ * 测试路由 Handler
+ * 用于验证插件加载和路由注册是否成功
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HelloHandlerPriv = exports.HelloHandler = void 0;
+const hydrooj_1 = require("hydrooj");
+/**
+ * Hello 测试 Handler
+ * GET /ai-helper/hello - 返回插件状态信息
+ */
+class HelloHandler extends hydrooj_1.Handler {
+    async get() {
+        this.response.body = {
+            message: 'AI Helper Plugin Loaded',
+            version: '0.1.0',
+            timestamp: new Date().toISOString(),
+            status: 'ok'
+        };
+        this.response.type = 'application/json';
+    }
+}
+exports.HelloHandler = HelloHandler;
+// 导出路由权限配置（最低权限 - 任何人可访问）
+exports.HelloHandlerPriv = hydrooj_1.PRIV.PRIV_NONE;
+//# sourceMappingURL=testHandler.js.map

package/dist/handlers/testHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"testHandler.js","sourceRoot":"","sources":["../../src/handlers/testHandler.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,qCAAwC;AAExC;;;GAGG;AACH,MAAa,YAAa,SAAQ,iBAAO;IACvC,KAAK,CAAC,GAAG;QACP,IAAI,CAAC,QAAQ,CAAC,IAAI,GAAG;YACnB,OAAO,EAAE,yBAAyB;YAClC,OAAO,EAAE,OAAO;YAChB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,MAAM,EAAE,IAAI;SACb,CAAC;QACF,IAAI,CAAC,QAAQ,CAAC,IAAI,GAAG,kBAAkB,CAAC;IAC1C,CAAC;CACF;AAVD,oCAUC;AAED,0BAA0B;AACb,QAAA,gBAAgB,GAAG,cAAI,CAAC,SAAS,CAAC"}

package/dist/handlers/updateHandler.js

@@ -0,0 +1,84 @@
+"use strict";
+/**
+ * UpdateHandler - 插件更新 API 处理器
+ *
+ * 提供插件在线更新接口：
+ * GET /ai-helper/admin/update/info - 获取更新信息
+ * POST /ai-helper/admin/update - 执行更新
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UpdateHandlerPriv = exports.UpdateHandler = exports.UpdateInfoHandlerPriv = exports.UpdateInfoHandler = void 0;
+const hydrooj_1 = require("hydrooj");
+const updateService_1 = require("../services/updateService");
+const httpHelpers_1 = require("../lib/httpHelpers");
+/**
+ * UpdateInfoHandler - 获取更新信息
+ * GET /ai-helper/admin/update/info
+ *
+ * 响应：
+ * {
+ *   pluginPath: string,      // 插件安装路径
+ *   isValid: boolean,        // 路径是否有效
+ *   message: string          // 验证消息
+ * }
+ */
+class UpdateInfoHandler extends hydrooj_1.Handler {
+    async get() {
+        try {
+            const updateService = new updateService_1.UpdateService();
+            const info = updateService.getPluginInfo();
+            (0, httpHelpers_1.setJsonResponse)(this, info);
+        }
+        catch (err) {
+            console.error('[UpdateInfoHandler] Error:', err);
+            (0, httpHelpers_1.setErrorResponse)(this, 'UPDATE_INFO_FAILED', err instanceof Error ? err.message : '获取更新信息失败', 500);
+        }
+    }
+}
+exports.UpdateInfoHandler = UpdateInfoHandler;
+// 导出路由权限配置 - root-only
+exports.UpdateInfoHandlerPriv = hydrooj_1.PRIV.PRIV_EDIT_SYSTEM;
+/**
+ * UpdateHandler - 执行更新
+ * POST /ai-helper/admin/update
+ *
+ * 响应：
+ * {
+ *   success: boolean,
+ *   step: string,
+ *   message: string,
+ *   logs: string[],
+ *   pluginPath?: string,
+ *   error?: string
+ * }
+ */
+class UpdateHandler extends hydrooj_1.Handler {
+    async post() {
+        try {
+            const updateService = new updateService_1.UpdateService();
+            // 收集所有日志
+            const allLogs = [];
+            // 执行更新
+            const result = await updateService.performUpdate((step, log) => {
+                allLogs.push(`[${step}] ${log}`);
+                console.log(`[UpdateHandler] ${step}: ${log}`);
+            });
+            (0, httpHelpers_1.setJsonResponse)(this, {
+                success: result.success,
+                step: result.step,
+                message: result.message,
+                logs: result.logs,
+                pluginPath: result.pluginPath,
+                error: result.error
+            });
+        }
+        catch (err) {
+            console.error('[UpdateHandler] Error:', err);
+            (0, httpHelpers_1.setErrorResponse)(this, 'UPDATE_FAILED', err instanceof Error ? err.message : '更新失败', 500);
+        }
+    }
+}
+exports.UpdateHandler = UpdateHandler;
+// 导出路由权限配置 - root-only
+exports.UpdateHandlerPriv = hydrooj_1.PRIV.PRIV_EDIT_SYSTEM;
+//# sourceMappingURL=updateHandler.js.map

package/dist/handlers/updateHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"updateHandler.js","sourceRoot":"","sources":["../../src/handlers/updateHandler.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAEH,qCAAwC;AACxC,6DAA0D;AAC1D,oDAAuE;AAEvE;;;;;;;;;;GAUG;AACH,MAAa,iBAAkB,SAAQ,iBAAO;IAC5C,KAAK,CAAC,GAAG;QACP,IAAI,CAAC;YACH,MAAM,aAAa,GAAG,IAAI,6BAAa,EAAE,CAAC;YAC1C,MAAM,IAAI,GAAG,aAAa,CAAC,aAAa,EAAE,CAAC;YAE3C,IAAA,6BAAe,EAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC9B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,4BAA4B,EAAE,GAAG,CAAC,CAAC;YACjD,IAAA,8BAAgB,EAAC,IAAI,EAAE,oBAAoB,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;QACrG,CAAC;IACH,CAAC;CACF;AAZD,8CAYC;AAED,uBAAuB;AACV,QAAA,qBAAqB,GAAG,cAAI,CAAC,gBAAgB,CAAC;AAE3D;;;;;;;;;;;;;GAaG;AACH,MAAa,aAAc,SAAQ,iBAAO;IACxC,KAAK,CAAC,IAAI;QACR,IAAI,CAAC;YACH,MAAM,aAAa,GAAG,IAAI,6BAAa,EAAE,CAAC;YAE1C,SAAS;YACT,MAAM,OAAO,GAAa,EAAE,CAAC;YAE7B,OAAO;YACP,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,aAAa,CAAC,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE;gBAC7D,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC,CAAC;gBACjC,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,KAAK,GAAG,EAAE,CAAC,CAAC;YACjD,CAAC,CAAC,CAAC;YAEH,IAAA,6BAAe,EAAC,IAAI,EAAE;gBACpB,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,UAAU,EAAE,MAAM,CAAC,UAAU;gBAC7B,KAAK,EAAE,MAAM,CAAC,KAAK;aACpB,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,wBAAwB,EAAE,GAAG,CAAC,CAAC;YAC7C,IAAA,8BAAgB,EAAC,IAAI,EAAE,eAAe,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAC5F,CAAC;IACH,CAAC;CACF;AA3BD,sCA2BC;AAED,uBAAuB;AACV,QAAA,iBAAiB,GAAG,cAAI,CAAC,gBAAgB,CAAC"}

package/dist/handlers/versionHandler.js

@@ -0,0 +1,61 @@
+"use strict";
+/**
+ * Version Handler - 版本检测 API 处理器
+ *
+ * T051: 提供版本检测接口
+ * GET /ai-helper/version/check - 检查版本更新
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VersionCheckHandlerPriv = exports.VersionCheckHandler = void 0;
+const hydrooj_1 = require("hydrooj");
+const httpHelpers_1 = require("../lib/httpHelpers");
+/**
+ * VersionCheckHandler - 检查版本更新
+ * GET /ai-helper/version/check
+ * GET /d/:domainId/ai-helper/version/check
+ *
+ * 查询参数：
+ * - refresh: 是否强制刷新（忽略缓存），默认 false
+ *
+ * 响应：
+ * {
+ *   currentVersion: string,    // 当前安装版本
+ *   latestVersion: string,     // 远程最新版本
+ *   hasUpdate: boolean,        // 是否有可用更新
+ *   releaseUrl: string,        // 发布页面 URL
+ *   releaseNotes?: string,     // 更新说明（如有）
+ *   checkedAt: string,         // 检查时间（ISO 格式）
+ *   fromCache: boolean         // 是否来自缓存
+ * }
+ */
+class VersionCheckHandler extends hydrooj_1.Handler {
+    async get() {
+        try {
+            const versionService = this.ctx.get('versionService');
+            // 检查是否强制刷新
+            const refresh = this.request.query.refresh === 'true';
+            // 检查版本更新
+            const result = await versionService.checkForUpdates(refresh);
+            (0, httpHelpers_1.setJsonResponse)(this, {
+                currentVersion: result.currentVersion,
+                latestVersion: result.latestVersion,
+                hasUpdate: result.hasUpdate,
+                releaseUrl: result.releaseUrl,
+                releaseNotes: result.releaseNotes,
+                checkedAt: result.checkedAt.toISOString(),
+                fromCache: result.fromCache,
+                source: result.source
+            });
+        }
+        catch (err) {
+            console.error('[VersionCheckHandler] Error:', err);
+            (0, httpHelpers_1.setErrorResponse)(this, 'VERSION_CHECK_FAILED', err instanceof Error ? err.message : '版本检查失败', 500);
+        }
+    }
+}
+exports.VersionCheckHandler = VersionCheckHandler;
+// 导出路由权限配置
+// 使用 PRIV.PRIV_EDIT_SYSTEM (root-only 权限)
+// 版本检查仅限管理员访问
+exports.VersionCheckHandlerPriv = hydrooj_1.PRIV.PRIV_EDIT_SYSTEM;
+//# sourceMappingURL=versionHandler.js.map

package/dist/handlers/versionHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"versionHandler.js","sourceRoot":"","sources":["../../src/handlers/versionHandler.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,qCAAwC;AAExC,oDAAuE;AAEvE;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAa,mBAAoB,SAAQ,iBAAO;IAC9C,KAAK,CAAC,GAAG;QACP,IAAI,CAAC;YACH,MAAM,cAAc,GAAmB,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;YAEtE,WAAW;YACX,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,KAAK,MAAM,CAAC;YAEtD,SAAS;YACT,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;YAE7D,IAAA,6BAAe,EAAC,IAAI,EAAE;gBACpB,cAAc,EAAE,MAAM,CAAC,cAAc;gBACrC,aAAa,EAAE,MAAM,CAAC,aAAa;gBACnC,SAAS,EAAE,MAAM,CAAC,SAAS;gBAC3B,UAAU,EAAE,MAAM,CAAC,UAAU;gBAC7B,YAAY,EAAE,MAAM,CAAC,YAAY;gBACjC,SAAS,EAAE,MAAM,CAAC,SAAS,CAAC,WAAW,EAAE;gBACzC,SAAS,EAAE,MAAM,CAAC,SAAS;gBAC3B,MAAM,EAAE,MAAM,CAAC,MAAM;aACtB,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,8BAA8B,EAAE,GAAG,CAAC,CAAC;YACnD,IAAA,8BAAgB,EAAC,IAAI,EAAE,sBAAsB,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QACrG,CAAC;IACH,CAAC;CACF;AA1BD,kDA0BC;AAED,WAAW;AACX,0CAA0C;AAC1C,cAAc;AACD,QAAA,uBAAuB,GAAG,cAAI,CAAC,gBAAgB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * HydroOJ AI Learning Assistant Plugin
+ *
+ * 教学优先的 AI 辅助学习插件
+ * - 引导式学习，不提供完整代码
+ * - 对话记录可追踪
+ * - 符合教学研究需求
+ */
+import { Context } from 'hydrooj';
+/**
+ * 插件配置接口
+ */
+export interface AIHelperConfig {
+}
+/**
+ * 插件入口函数
+ * @param ctx HydroOJ Context
+ * @param config 插件配置
+ */
+export declare function apply(ctx: Context, config?: AIHelperConfig): void;
+export declare const Config: {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAElC;;GAEG;AACH,MAAM,WAAW,cAAc;CAE9B;AAED;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,GAAE,cAAmB,QAK9D;AAGD,eAAO,MAAM,MAAM,IAElB,CAAC"}

package/dist/index.js

@@ -0,0 +1,151 @@
+"use strict";
+/**
+ * HydroOJ AI Learning Assistant Plugin
+ *
+ * 教学优先的 AI 辅助学习插件
+ * - 引导式学习，不提供完整代码
+ * - 对话记录可追踪
+ * - 符合教学研究需求
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.apply = exports.Config = void 0;
+console.log('[AI-Helper] Loading plugin...');
+const hydrooj_1 = require("hydrooj");
+console.log('[AI-Helper] hydrooj imports OK');
+const testHandler_1 = require("./handlers/testHandler");
+console.log('[AI-Helper] testHandler OK');
+const studentHandler_1 = require("./handlers/studentHandler");
+console.log('[AI-Helper] studentHandler OK');
+const teacherHandler_1 = require("./handlers/teacherHandler");
+console.log('[AI-Helper] teacherHandler OK');
+const analyticsHandler_1 = require("./handlers/analyticsHandler");
+console.log('[AI-Helper] analyticsHandler OK');
+const adminConfigHandler_1 = require("./handlers/adminConfigHandler");
+console.log('[AI-Helper] adminConfigHandler OK');
+const dashboardHandler_1 = require("./handlers/dashboardHandler");
+console.log('[AI-Helper] dashboardHandler OK');
+const exportHandler_1 = require("./handlers/exportHandler");
+console.log('[AI-Helper] exportHandler OK');
+const adminHandler_1 = require("./handlers/adminHandler");
+console.log('[AI-Helper] adminHandler OK');
+const versionHandler_1 = require("./handlers/versionHandler");
+console.log('[AI-Helper] versionHandler OK');
+const updateHandler_1 = require("./handlers/updateHandler");
+console.log('[AI-Helper] updateHandler OK');
+const conversation_1 = require("./models/conversation");
+const message_1 = require("./models/message");
+const rateLimitRecord_1 = require("./models/rateLimitRecord");
+const aiConfig_1 = require("./models/aiConfig");
+const jailbreakLog_1 = require("./models/jailbreakLog");
+const versionCache_1 = require("./models/versionCache");
+const pluginInstall_1 = require("./models/pluginInstall");
+console.log('[AI-Helper] models OK');
+const migrationService_1 = require("./services/migrationService");
+const versionService_1 = require("./services/versionService");
+const telemetryService_1 = require("./services/telemetryService");
+console.log('[AI-Helper] services OK');
+console.log('[AI-Helper] All imports completed successfully');
+/**
+ * 插件入口函数
+ * @param ctx HydroOJ Context
+ * @param config 插件配置
+ */
+const configSchema = hydrooj_1.Schema.object({}).description('AI 助手插件配置（预留）').default({});
+const aiHelperPlugin = (0, hydrooj_1.definePlugin)({
+    name: 'hydro-ai-helper',
+    schema: configSchema,
+    async apply(ctx) {
+        // 初始化数据库模型
+        const db = ctx.db;
+        const conversationModel = new conversation_1.ConversationModel(db);
+        const messageModel = new message_1.MessageModel(db);
+        const rateLimitRecordModel = new rateLimitRecord_1.RateLimitRecordModel(db);
+        const aiConfigModel = new aiConfig_1.AIConfigModel(db);
+        const jailbreakLogModel = new jailbreakLog_1.JailbreakLogModel(db);
+        const versionCacheModel = new versionCache_1.VersionCacheModel(db);
+        const pluginInstallModel = new pluginInstall_1.PluginInstallModel(db);
+        // 创建数据库索引
+        await conversationModel.ensureIndexes();
+        await messageModel.ensureIndexes();
+        await rateLimitRecordModel.ensureIndexes();
+        await aiConfigModel.ensureIndexes();
+        await jailbreakLogModel.ensureIndexes();
+        await versionCacheModel.ensureIndexes();
+        await pluginInstallModel.ensureIndexes();
+        // 执行数据迁移（为历史数据添加 domainId）
+        const migrationService = new migrationService_1.MigrationService(db);
+        await migrationService.runAllMigrations();
+        // 初始化插件安装记录
+        const packageJson = require('../package.json');
+        const currentVersion = packageJson.version || '1.8.0';
+        await pluginInstallModel.createIfMissing(currentVersion);
+        // 将模型实例注入到 ctx 中,供 Handler 使用
+        ctx.provide('conversationModel', conversationModel);
+        ctx.provide('messageModel', messageModel);
+        ctx.provide('rateLimitRecordModel', rateLimitRecordModel);
+        ctx.provide('aiConfigModel', aiConfigModel);
+        ctx.provide('jailbreakLogModel', jailbreakLogModel);
+        ctx.provide('versionCacheModel', versionCacheModel);
+        ctx.provide('pluginInstallModel', pluginInstallModel);
+        // 初始化版本服务
+        const versionService = new versionService_1.VersionService(versionCacheModel);
+        ctx.provide('versionService', versionService);
+        // 初始化遥测服务（延迟 5 秒启动，避免阻塞插件加载）
+        const telemetryService = new telemetryService_1.TelemetryService(pluginInstallModel, conversationModel);
+        setTimeout(() => {
+            telemetryService.init().catch(err => {
+                console.error('[AI-Helper] Telemetry service initialization failed:', err);
+            });
+        }, 5000);
+        // 注册测试路由
+        // GET /ai-helper/hello - 返回插件状态
+        ctx.Route('ai_helper_hello', '/ai-helper/hello', testHandler_1.HelloHandler, testHandler_1.HelloHandlerPriv);
+        // 注册学生端对话路由 (支持域前缀)
+        // POST /ai-helper/chat - 学生提交问题获得 AI 回答
+        ctx.Route('ai_helper_chat', '/ai-helper/chat', studentHandler_1.ChatHandler, studentHandler_1.ChatHandlerPriv);
+        // 域前缀路由: /d/:domainId/ai-helper/chat
+        ctx.Route('ai_helper_chat_domain', '/d/:domainId/ai-helper/chat', studentHandler_1.ChatHandler, studentHandler_1.ChatHandlerPriv);
+        // GET /ai-helper/problem-status/:problemId - 查询用户在该题的提交状态（是否已 AC）
+        ctx.Route('ai_helper_problem_status', '/ai-helper/problem-status/:problemId', studentHandler_1.ProblemStatusHandler, studentHandler_1.ProblemStatusHandlerPriv);
+        ctx.Route('ai_helper_problem_status_domain', '/d/:domainId/ai-helper/problem-status/:problemId', studentHandler_1.ProblemStatusHandler, studentHandler_1.ProblemStatusHandlerPriv);
+        // 注册教师端路由 (支持域前缀)
+        // 当前设计：AI 学习助手对话统计非常敏感，仅允许 root 访问。
+        // 注意：这里使用的是 root-only 的系统权限（PRIV.PRIV_EDIT_SYSTEM），普通老师也无权访问。
+        // TODO(如需求变更): 未来若有专门的教师统计角色，再考虑降低权限。
+        // 注入控制面板菜单项（统一入口）
+        ctx.injectUI('ControlPanel', 'ai_helper');
+        // AI 助手统一入口路由
+        ctx.Route('ai_helper', '/ai-helper', dashboardHandler_1.AIHelperDashboardHandler, dashboardHandler_1.AIHelperDashboardHandlerPriv);
+        ctx.Route('ai_helper_domain', '/d/:domainId/ai-helper', dashboardHandler_1.AIHelperDashboardHandler, dashboardHandler_1.AIHelperDashboardHandlerPriv);
+        // GET /ai-helper/conversations - 获取对话列表
+        ctx.Route('ai_helper_conversations', '/ai-helper/conversations', teacherHandler_1.ConversationListHandler, teacherHandler_1.ConversationListHandlerPriv);
+        ctx.Route('ai_helper_conversations_domain', '/d/:domainId/ai-helper/conversations', teacherHandler_1.ConversationListHandler, teacherHandler_1.ConversationListHandlerPriv);
+        // GET /ai-helper/conversations/:id - 获取对话详情
+        ctx.Route('ai_helper_conversation_detail', '/ai-helper/conversations/:id', teacherHandler_1.ConversationDetailHandler, teacherHandler_1.ConversationDetailHandlerPriv);
+        ctx.Route('ai_helper_conversation_detail_domain', '/d/:domainId/ai-helper/conversations/:id', teacherHandler_1.ConversationDetailHandler, teacherHandler_1.ConversationDetailHandlerPriv);
+        // GET /ai-helper/analytics - AI 使用统计页面
+        ctx.Route('ai_helper_analytics', '/ai-helper/analytics', analyticsHandler_1.AnalyticsHandler, analyticsHandler_1.AnalyticsHandlerPriv);
+        ctx.Route('ai_helper_analytics_domain', '/d/:domainId/ai-helper/analytics', analyticsHandler_1.AnalyticsHandler, analyticsHandler_1.AnalyticsHandlerPriv);
+        // GET /ai-helper/admin/config - AI 配置页面 & JSON API（通过 Accept 头区分）
+        ctx.Route('ai_helper_admin_config', '/ai-helper/admin/config', adminConfigHandler_1.AdminConfigHandler, adminConfigHandler_1.AdminConfigHandlerPriv);
+        // GET /ai-helper/export - 数据导出 API
+        ctx.Route('ai_helper_export', '/ai-helper/export', exportHandler_1.ExportHandler, exportHandler_1.ExportHandlerPriv);
+        ctx.Route('ai_helper_export_domain', '/d/:domainId/ai-helper/export', exportHandler_1.ExportHandler, exportHandler_1.ExportHandlerPriv);
+        // POST /ai-helper/admin/test-connection - 测试连接
+        ctx.Route('ai_helper_admin_test_connection', '/ai-helper/admin/test-connection', adminHandler_1.TestConnectionHandler, adminHandler_1.TestConnectionHandlerPriv);
+        // POST /ai-helper/admin/fetch-models - 获取可用模型列表
+        ctx.Route('ai_helper_admin_fetch_models', '/ai-helper/admin/fetch-models', adminHandler_1.FetchModelsHandler, adminHandler_1.FetchModelsHandlerPriv);
+        // T052: GET /ai-helper/version/check - 版本检测
+        ctx.Route('ai_helper_version_check', '/ai-helper/version/check', versionHandler_1.VersionCheckHandler, versionHandler_1.VersionCheckHandlerPriv);
+        ctx.Route('ai_helper_version_check_domain', '/d/:domainId/ai-helper/version/check', versionHandler_1.VersionCheckHandler, versionHandler_1.VersionCheckHandlerPriv);
+        // 插件更新路由
+        // GET /ai-helper/admin/update/info - 获取更新信息
+        ctx.Route('ai_helper_update_info', '/ai-helper/admin/update/info', updateHandler_1.UpdateInfoHandler, updateHandler_1.UpdateInfoHandlerPriv);
+        // POST /ai-helper/admin/update - 执行更新
+        ctx.Route('ai_helper_update', '/ai-helper/admin/update', updateHandler_1.UpdateHandler, updateHandler_1.UpdateHandlerPriv);
+    }
+});
+exports.Config = configSchema;
+exports.apply = aiHelperPlugin.apply;
+exports.default = aiHelperPlugin;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AAEH,OAAO,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC;AAE7C,qCAAwD;AACxD,OAAO,CAAC,GAAG,CAAC,gCAAgC,CAAC,CAAC;AAE9C,wDAAwE;AACxE,OAAO,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;AAE1C,8DAAyH;AACzH,OAAO,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC;AAE7C,8DAKmC;AACnC,OAAO,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC;AAE7C,kEAAqF;AACrF,OAAO,CAAC,GAAG,CAAC,iCAAiC,CAAC,CAAC;AAE/C,sEAA2F;AAC3F,OAAO,CAAC,GAAG,CAAC,mCAAmC,CAAC,CAAC;AAEjD,kEAAqG;AACrG,OAAO,CAAC,GAAG,CAAC,iCAAiC,CAAC,CAAC;AAE/C,4DAA4E;AAC5E,OAAO,CAAC,GAAG,CAAC,8BAA8B,CAAC,CAAC;AAE5C,0DAAuI;AACvI,OAAO,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAC;AAE3C,8DAAyF;AACzF,OAAO,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC;AAE7C,4DAAsH;AACtH,OAAO,CAAC,GAAG,CAAC,8BAA8B,CAAC,CAAC;AAE5C,wDAA0D;AAC1D,8CAAgD;AAChD,8DAAgE;AAChE,gDAAkD;AAClD,wDAA0D;AAC1D,wDAA0D;AAC1D,0DAA4D;AAC5D,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;AAErC,kEAA+D;AAC/D,8DAA2D;AAC3D,kEAA+D;AAC/D,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;AAEvC,OAAO,CAAC,GAAG,CAAC,gDAAgD,CAAC,CAAC;AAS9D;;;;GAIG;AACH,MAAM,YAAY,GAAG,gBAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,WAAW,CAAC,eAAe,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;AAEhF,MAAM,cAAc,GAAG,IAAA,sBAAY,EAAiB;IAClD,IAAI,EAAE,iBAAiB;IACvB,MAAM,EAAE,YAAY;IACpB,KAAK,CAAC,KAAK,CAAC,GAAY;QACtB,WAAW;QACX,MAAM,EAAE,GAAG,GAAG,CAAC,EAAE,CAAC;QAClB,MAAM,iBAAiB,GAAG,IAAI,gCAAiB,CAAC,EAAE,CAAC,CAAC;QACpD,MAAM,YAAY,GAAG,IAAI,sBAAY,CAAC,EAAE,CAAC,CAAC;QAC1C,MAAM,oBAAoB,GAAG,IAAI,sCAAoB,CAAC,EAAE,CAAC,CAAC;QAC1D,MAAM,aAAa,GAAG,IAAI,wBAAa,CAAC,EAAE,CAAC,CAAC;QAC5C,MAAM,iBAAiB,GAAG,IAAI,gCAAiB,CAAC,EAAE,CAAC,CAAC;QACpD,MAAM,iBAAiB,GAAG,IAAI,gCAAiB,CAAC,EAAE,CAAC,CAAC;QACpD,MAAM,kBAAkB,GAAG,IAAI,kCAAkB,CAAC,EAAE,CAAC,CAAC;QAEtD,UAAU;QACV,MAAM,iBAAiB,CAAC,aAAa,EAAE,CAAC;QACxC,MAAM,YAAY,CAAC,aAAa,EAAE,CAAC;QACnC,MAAM,oBAAoB,CAAC,aAAa,EAAE,CAAC;QAC3C,MAAM,aAAa,CAAC,aAAa,EAAE,CAAC;QACpC,MAAM,iBAAiB,CAAC,aAAa,EAAE,CAAC;QACxC,MAAM,iBAAiB,CAAC,aAAa,EAAE,CAAC;QACxC,MAAM,kBAAkB,CAAC,aAAa,EAAE,CAAC;QAEzC,2BAA2B;QAC3B,MAAM,gBAAgB,GAAG,IAAI,mCAAgB,CAAC,EAAE,CAAC,CAAC;QAClD,MAAM,gBAAgB,CAAC,gBAAgB,EAAE,CAAC;QAE1C,YAAY;QACZ,MAAM,WAAW,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;QAC/C,MAAM,cAAc,GAAG,WAAW,CAAC,OAAO,IAAI,OAAO,CAAC;QACtD,MAAM,kBAAkB,CAAC,eAAe,CAAC,cAAc,CAAC,CAAC;QAEzD,8BAA8B;QAC9B,GAAG,CAAC,OAAO,CAAC,mBAAmB,EAAE,iBAAiB,CAAC,CAAC;QACpD,GAAG,CAAC,OAAO,CAAC,cAAc,EAAE,YAAY,CAAC,CAAC;QAC1C,GAAG,CAAC,OAAO,CAAC,sBAAsB,EAAE,oBAAoB,CAAC,CAAC;QAC1D,GAAG,CAAC,OAAO,CAAC,eAAe,EAAE,aAAa,CAAC,CAAC;QAC5C,GAAG,CAAC,OAAO,CAAC,mBAAmB,EAAE,iBAAiB,CAAC,CAAC;QACpD,GAAG,CAAC,OAAO,CAAC,mBAAmB,EAAE,iBAAiB,CAAC,CAAC;QACpD,GAAG,CAAC,OAAO,CAAC,oBAAoB,EAAE,kBAAkB,CAAC,CAAC;QAEtD,UAAU;QACV,MAAM,cAAc,GAAG,IAAI,+BAAc,CAAC,iBAAiB,CAAC,CAAC;QAC7D,GAAG,CAAC,OAAO,CAAC,gBAAgB,EAAE,cAAc,CAAC,CAAC;QAE9C,6BAA6B;QAC7B,MAAM,gBAAgB,GAAG,IAAI,mCAAgB,CAAC,kBAAkB,EAAE,iBAAiB,CAAC,CAAC;QACrF,UAAU,CAAC,GAAG,EAAE;YACd,gBAAgB,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE;gBAClC,OAAO,CAAC,KAAK,CAAC,sDAAsD,EAAE,GAAG,CAAC,CAAC;YAC7E,CAAC,CAAC,CAAC;QACL,CAAC,EAAE,IAAI,CAAC,CAAC;QAET,SAAS;QACT,gCAAgC;QAChC,GAAG,CAAC,KAAK,CAAC,iBAAiB,EAAE,kBAAkB,EAAE,0BAAY,EAAE,8BAAgB,CAAC,CAAC;QAEjF,oBAAoB;QACpB,wCAAwC;QACxC,GAAG,CAAC,KAAK,CAAC,gBAAgB,EAAE,iBAAiB,EAAE,4BAAW,EAAE,gCAAe,CAAC,CAAC;QAC7E,qCAAqC;QACrC,GAAG,CAAC,KAAK,CAAC,uBAAuB,EAAE,6BAA6B,EAAE,4BAAW,EAAE,gCAAe,CAAC,CAAC;QAEhG,kEAAkE;QAClE,GAAG,CAAC,KAAK,CAAC,0BAA0B,EAAE,sCAAsC,EAAE,qCAAoB,EAAE,yCAAwB,CAAC,CAAC;QAC9H,GAAG,CAAC,KAAK,CAAC,iCAAiC,EAAE,kDAAkD,EAAE,qCAAoB,EAAE,yCAAwB,CAAC,CAAC;QAEjJ,kBAAkB;QAClB,oCAAoC;QACpC,8DAA8D;QAC9D,sCAAsC;QAEtC,kBAAkB;QAClB,GAAG,CAAC,QAAQ,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC;QAE1C,cAAc;QACd,GAAG,CAAC,KAAK,CAAC,WAAW,EAAE,YAAY,EAAE,2CAAwB,EAAE,+CAA4B,CAAC,CAAC;QAC7F,GAAG,CAAC,KAAK,CAAC,kBAAkB,EAAE,wBAAwB,EAAE,2CAAwB,EAAE,+CAA4B,CAAC,CAAC;QAEhH,wCAAwC;QACxC,GAAG,CAAC,KAAK,CAAC,yBAAyB,EAAE,0BAA0B,EAAE,wCAAuB,EAAE,4CAA2B,CAAC,CAAC;QACvH,GAAG,CAAC,KAAK,CAAC,gCAAgC,EAAE,sCAAsC,EAAE,wCAAuB,EAAE,4CAA2B,CAAC,CAAC;QAE1I,4CAA4C;QAC5C,GAAG,CAAC,KAAK,CAAC,+BAA+B,EAAE,8BAA8B,EAAE,0CAAyB,EAAE,8CAA6B,CAAC,CAAC;QACrI,GAAG,CAAC,KAAK,CAAC,sCAAsC,EAAE,0CAA0C,EAAE,0CAAyB,EAAE,8CAA6B,CAAC,CAAC;QAExJ,uCAAuC;QACvC,GAAG,CAAC,KAAK,CAAC,qBAAqB,EAAE,sBAAsB,EAAE,mCAAgB,EAAE,uCAAoB,CAAC,CAAC;QACjG,GAAG,CAAC,KAAK,CAAC,4BAA4B,EAAE,kCAAkC,EAAE,mCAAgB,EAAE,uCAAoB,CAAC,CAAC;QAEpH,kEAAkE;QAClE,GAAG,CAAC,KAAK,CAAC,wBAAwB,EAAE,yBAAyB,EAAE,uCAAkB,EAAE,2CAAsB,CAAC,CAAC;QAE3G,mCAAmC;QACnC,GAAG,CAAC,KAAK,CAAC,kBAAkB,EAAE,mBAAmB,EAAE,6BAAa,EAAE,iCAAiB,CAAC,CAAC;QACrF,GAAG,CAAC,KAAK,CAAC,yBAAyB,EAAE,+BAA+B,EAAE,6BAAa,EAAE,iCAAiB,CAAC,CAAC;QAExG,+CAA+C;QAC/C,GAAG,CAAC,KAAK,CAAC,iCAAiC,EAAE,kCAAkC,EAAE,oCAAqB,EAAE,wCAAyB,CAAC,CAAC;QAEnI,gDAAgD;QAChD,GAAG,CAAC,KAAK,CAAC,8BAA8B,EAAE,+BAA+B,EAAE,iCAAkB,EAAE,qCAAsB,CAAC,CAAC;QAEvH,4CAA4C;QAC5C,GAAG,CAAC,KAAK,CAAC,yBAAyB,EAAE,0BAA0B,EAAE,oCAAmB,EAAE,wCAAuB,CAAC,CAAC;QAC/G,GAAG,CAAC,KAAK,CAAC,gCAAgC,EAAE,sCAAsC,EAAE,oCAAmB,EAAE,wCAAuB,CAAC,CAAC;QAElI,SAAS;QACT,4CAA4C;QAC5C,GAAG,CAAC,KAAK,CAAC,uBAAuB,EAAE,8BAA8B,EAAE,iCAAiB,EAAE,qCAAqB,CAAC,CAAC;QAC7G,sCAAsC;QACtC,GAAG,CAAC,KAAK,CAAC,kBAAkB,EAAE,yBAAyB,EAAE,6BAAa,EAAE,iCAAiB,CAAC,CAAC;IAC7F,CAAC;CACF,CAAC,CAAC;AAEU,QAAA,MAAM,GAAG,YAAY,CAAC;AACtB,QAAA,KAAK,GAAG,cAAc,CAAC,KAAK,CAAC;AAC1C,kBAAe,cAAc,CAAC"}