koishi-plugin-game-mini 0.3.0 → 0.3.2

package/lib/index.d.ts

@@ -45,6 +45,9 @@ export interface Config {
             showTotalStats: boolean;
         };
     };
+    debug: {
+        enableLog: boolean;
+    };
     guessNumber: {
         min: number;
         max: number;
@@ -82,7 +85,6 @@ export interface Config {
         messages: {
             usage: string;
             start: string;
-            startUsage: string;
             stop: string;
             notStarted: string;
             hint: string;
@@ -107,7 +109,6 @@ export interface Config {
             usage: string;
             start: string;
             stop: string;
-            submitUsage: string;
             notStarted: string;
             next: string;
             hintGet: string;
@@ -136,7 +137,6 @@ export interface Config {
             start: string;
             stop: string;
             notStarted: string;
-            joinUsage: string;
             apiError: string;
             botTurn: string;
             botWin: string;

package/lib/index.js

@@ -32,7 +32,6 @@ const defaultMessages = {
     wzHero: {
         usage: "用法错误！正确用法：猜王者英雄 开始 | [答案] | 提示 | 结束",
         start: "猜王者英雄开始！本次共 {0} 回合～当前难度：{1}",
-        startUsage: "用法错误！正确用法：猜王者英雄 开始 | [答案] | 提示 | 结束",
         stop: "猜王者英雄比赛已停止",
         notStarted: "猜王者英雄比赛尚未开始，请输入 猜王者英雄 开始 开始游戏",
         hint: "提示",
@@ -50,7 +49,6 @@ const defaultMessages = {
         usage: "用法错误！正确用法：看图猜成语 开始 | [答案] | 提示 | 结束",
         start: "看图猜成语比赛开始！本次共 {0} 回合～当前提示级别：{1}",
         stop: "看图猜成语比赛已停止",
-        submitUsage: "用法错误！正确用法：看图猜成语 开始 | [答案] | 提示 | 结束",
         notStarted: "看图猜成语比赛尚未开始，请输入 看图猜成语 开始 开始游戏",
         next: "第 {0} 题来啦！",
         hintGet: "【提示】{0}",
@@ -70,7 +68,6 @@ const defaultMessages = {
         start: "成语接龙比赛开始！本次共 {0} 回合～我先来～",
         stop: "成语接龙比赛已停止",
         notStarted: "成语接龙比赛尚未开始，请输入 成语接龙 开始 开始游戏",
-        joinUsage: "用法错误！正确用法：成语接龙 开始 | [成语] | 结束",
         apiError: "API请求失败，请稍后再试",
         botTurn: "该我了！我接：{0}",
         botWin: "哈哈我接不上了！本轮结束～",
@@ -148,6 +145,11 @@ exports.Config = koishi_1.Schema.intersect([
             }).description('📊 排行榜消息配置'),
         }).description('📊 排行榜配置'),
     }),
+    koishi_1.Schema.object({
+        debug: koishi_1.Schema.object({
+            enableLog: koishi_1.Schema.boolean().default(false).description('📝 启用调试日志输出'),
+        }).description('🔧 调试配置'),
+    }),
     koishi_1.Schema.object({
         guessNumber: koishi_1.Schema.object({
             min: koishi_1.Schema.number().min(0).default(0).description('最小值'),
@@ -188,7 +190,6 @@ exports.Config = koishi_1.Schema.intersect([
             messages: koishi_1.Schema.object({
                 usage: koishi_1.Schema.string().default(defaultMessages.wzHero.usage).description('用法错误提示'),
                 start: koishi_1.Schema.string().default(defaultMessages.wzHero.start).description('游戏开始提示\n{0}-总回合数, {1}-难度'),
-                startUsage: koishi_1.Schema.string().default(defaultMessages.wzHero.startUsage).description('开始用法提示'),
                 stop: koishi_1.Schema.string().default(defaultMessages.wzHero.stop).description('游戏停止提示'),
                 notStarted: koishi_1.Schema.string().default(defaultMessages.wzHero.notStarted).description('游戏未开始提示'),
                 hint: koishi_1.Schema.string().default(defaultMessages.wzHero.hint).description('提示命令'),
@@ -215,7 +216,6 @@ exports.Config = koishi_1.Schema.intersect([
                 usage: koishi_1.Schema.string().default(defaultMessages.chengyuImage.usage).description('用法错误提示'),
                 start: koishi_1.Schema.string().default(defaultMessages.chengyuImage.start).description('游戏开始提示\n{0}-总回合数, {1}-提示级别'),
                 stop: koishi_1.Schema.string().default(defaultMessages.chengyuImage.stop).description('游戏停止提示'),
-                submitUsage: koishi_1.Schema.string().default(defaultMessages.chengyuImage.submitUsage).description('提交答案用法提示'),
                 notStarted: koishi_1.Schema.string().default(defaultMessages.chengyuImage.notStarted).description('游戏未开始提示'),
                 next: koishi_1.Schema.string().default(defaultMessages.chengyuImage.next).description('下一题提示\n{0}-当前回合'),
                 hintGet: koishi_1.Schema.string().default(defaultMessages.chengyuImage.hintGet).description('获取提示成功\n{0}-提示内容'),
@@ -246,7 +246,6 @@ exports.Config = koishi_1.Schema.intersect([
                 start: koishi_1.Schema.string().default(defaultMessages.chengyuJielong.start).description('游戏开始提示\n{0}-总回合数'),
                 stop: koishi_1.Schema.string().default(defaultMessages.chengyuJielong.stop).description('游戏停止提示'),
                 notStarted: koishi_1.Schema.string().default(defaultMessages.chengyuJielong.notStarted).description('游戏未开始提示'),
-                joinUsage: koishi_1.Schema.string().default(defaultMessages.chengyuJielong.joinUsage).description('参与用法提示'),
                 apiError: koishi_1.Schema.string().default(defaultMessages.chengyuJielong.apiError).description('API错误提示'),
                 botTurn: koishi_1.Schema.string().default(defaultMessages.chengyuJielong.botTurn).description('机器人回合提示\n{0}-成语'),
                 botWin: koishi_1.Schema.string().default(defaultMessages.chengyuJielong.botWin).description('机器人赢提示'),
@@ -318,11 +317,6 @@ exports.Config = koishi_1.Schema.intersect([
 const logger = new koishi_1.Logger('game-mini');
 const gameStates = new Map();
 const getSessionKey = (s) => s.channelId ? `g:${s.channelId}` : `p:${s.userId}`;
-const getIntUserId = (session) => {
-    const userIdStr = session.userId || '0';
-    const hash = userIdStr.split('').reduce((acc, char) => acc + char.charCodeAt(0), 0);
-    return hash || 1000000;
-};
 async function apply(ctx, cfg) {
     ctx.model.extend('game_mini_player', {
         id: 'unsigned',
@@ -372,6 +366,35 @@ async function apply(ctx, cfg) {
             return cfg.privateGame.enableCalc24;
         return false;
     };
+    const getUserId = (session) => {
+        return session.userId || '0';
+    };
+    const logDebug = (message, data) => {
+        if (cfg.debug.enableLog) {
+            if (data) {
+                logger.info(`${message} ${JSON.stringify(data)}`);
+            }
+            else {
+                logger.info(message);
+            }
+        }
+    };
+    const logError = (message, error) => {
+        logger.error(message);
+        if (cfg.debug.enableLog && error) {
+            logger.error(JSON.stringify(error));
+        }
+    };
+    const logWarn = (message, data) => {
+        if (cfg.debug.enableLog) {
+            if (data) {
+                logger.warn(`${message} ${JSON.stringify(data)}`);
+            }
+            else {
+                logger.warn(message);
+            }
+        }
+    };
     const getPlayerData = async (session) => {
         if (!session.channelId) {
             return {
@@ -678,19 +701,26 @@ async function apply(ctx, cfg) {
         if (!st.chengyuJielong.started)
             return;
         try {
-            const intUserId = getIntUserId(session);
-            logger.info(`[成语接龙] 开始调用API，用户ID: ${intUserId}`);
+            const userId = getUserId(session);
+            logDebug(`[成语接龙] 开始调用API，平台: ${session.platform}, 用户ID: ${userId}`);
+            const params = {
+                id: userId,
+            };
+            if (st.chengyuJielong.jielongCount === 0) {
+                params.msg = '开始成语接龙';
+            }
+            else {
+                params.msg = '我接';
+            }
             const r = await axios_1.default.get('https://api.suol.cc/v1/game_cyjl.php', {
-                params: {
-                    id: intUserId,
-                    msg: '我接'
-                },
+                params: params,
                 timeout: cfg.apiConfig.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'
                 }
             });
-            logger.info(`[成语接龙] API返回状态码: ${r.status}`);
+            logDebug(`[成语接龙] API返回状态码: ${r.status}`);
+            logDebug(`[成语接龙] API返回数据:`, r.data);
             const dt = r.data;
             let m = '';
             if (dt.code === 200 && dt.data?.system) {
@@ -699,47 +729,19 @@ async function apply(ctx, cfg) {
                 st.chengyuJielong.lastChar = dt.data.current_char || '';
                 st.chengyuJielong.jielongCount += 1;
                 st.chengyuJielong.botTurn = false;
-                logger.info(`[成语接龙] 成功获取成语: ${sys.idiom}`);
+                logDebug(`[成语接龙] 成功获取成语: ${sys.idiom}`);
                 await session.send(m);
+                await session.send('请输入要接的成语');
             }
             else {
-                logger.warn(`[成语接龙] API返回异常: code=${dt.code}, msg=${dt.msg}`);
+                logWarn(`[成语接龙] API返回异常: code=${dt.code}, msg=${dt.msg}`);
                 m = dt.msg || d.chengyuJielong.botWin;
-                st.chengyuJielong.currentRound += 1;
-                st.chengyuJielong.botTurn = true;
                 await session.send(m);
-                if (st.chengyuJielong.currentRound > st.chengyuJielong.totalRounds) {
-                    st.chengyuJielong.started = false;
-                    clearAllTimers(st);
-                    await session.send(d.chengyuJielong.gameEnd);
-                    if (cfg.chengyuJielong.showRank && !isPrivate(session)) {
-                        const rankText = generateGameRankText(st.chengyuJielong.players, d.chengyuJielong.rankTitle, d.chengyuJielong.rankEmpty);
-                        await session.send(rankText);
-                    }
-                    clearGameData(st.chengyuJielong);
-                    gameStates.set(key, st);
-                    return;
-                }
-                else {
-                    await session.send(d.chengyuJielong.roundEnd.replace('{0}', st.chengyuJielong.currentRound.toString()).replace('{1}', (st.chengyuJielong.totalRounds - st.chengyuJielong.currentRound).toString()));
-                }
-            }
-            if (cfg.chengyuJielong.maxRounds > 0 && st.chengyuJielong.jielongCount >= cfg.chengyuJielong.maxRounds) {
-                st.chengyuJielong.started = false;
-                clearAllTimers(st);
-                await session.send(d.chengyuJielong.gameEnd);
-                if (cfg.chengyuJielong.showRank && !isPrivate(session)) {
-                    const rankText = generateGameRankText(st.chengyuJielong.players, d.chengyuJielong.rankTitle, d.chengyuJielong.rankEmpty);
-                    await session.send(rankText);
-                }
-                clearGameData(st.chengyuJielong);
-                gameStates.set(key, st);
-                return;
             }
         }
         catch (error) {
             const err = error;
-            logger.error(`[成语接龙] API调用失败: ${err.message}`);
+            logError(`[成语接龙] API调用失败: ${err.message}`, err);
             await session.send(d.chengyuJielong.apiError);
         }
         gameStates.set(key, st);
@@ -787,11 +789,11 @@ async function apply(ctx, cfg) {
                 return;
             }
             try {
-                const intUserId = getIntUserId(session);
-                logger.info(`[成语接龙玩家] 开始调用API，用户ID: ${intUserId}, 内容: ${content}`);
+                const userId = getUserId(session);
+                logDebug(`[成语接龙玩家] 开始调用API，平台: ${session.platform}, 用户ID: ${userId}, 内容: ${content}`);
                 const r = await axios_1.default.get('https://api.suol.cc/v1/game_cyjl.php', {
                     params: {
-                        id: intUserId,
+                        id: userId,
                         msg: `我接${content}`
                     },
                     timeout: cfg.apiConfig.timeout,
@@ -799,7 +801,8 @@ async function apply(ctx, cfg) {
                         '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'
                     }
                 });
-                logger.info(`[成语接龙玩家] API返回状态码: ${r.status}`);
+                logDebug(`[成语接龙玩家] API返回状态码: ${r.status}`);
+                logDebug(`[成语接龙玩家] API返回数据:`, r.data);
                 const dt = r.data;
                 let m = '';
                 if (dt.code === 200) {
@@ -808,20 +811,25 @@ async function apply(ctx, cfg) {
                         m += d.chengyuJielong.correct + '\n';
                         m += `你的成语：${dt.data.user.idiom}\n`;
                         st.chengyuJielong.botTurn = true;
-                        logger.info(`[成语接龙玩家] 接龙成功: ${dt.data.user.idiom}`);
+                        st.chengyuJielong.currentRound += 1;
+                        logDebug(`[成语接龙玩家] 接龙成功: ${dt.data.user.idiom}`);
                     }
                     else {
                         m += d.chengyuJielong.wrong + '\n';
-                        logger.info(`[成语接龙玩家] 接龙失败`);
+                        logDebug(`[成语接龙玩家] 接龙失败`);
                     }
                     if (dt.data?.system) {
                         m += `我的接龙：${dt.data.system.idiom}`;
                         st.chengyuJielong.lastChar = dt.data.current_char || '';
                         st.chengyuJielong.jielongCount += 1;
-                        logger.info(`[成语接龙玩家] 机器人接龙: ${dt.data.system.idiom}`);
+                        st.chengyuJielong.botTurn = false;
+                        logDebug(`[成语接龙玩家] 机器人接龙: ${dt.data.system.idiom}`);
+                        await session.send(m);
+                        await session.send('请输入要接的成语');
+                    }
+                    else {
+                        await session.send(m);
                     }
-                    st.chengyuJielong.currentRound += 1;
-                    await session.send(m);
                     if (cfg.chengyuJielong.botParticipate && st.chengyuJielong.botTurn) {
                         setTimeout(() => {
                             doAutoPlay(session, key, st);
@@ -829,7 +837,7 @@ async function apply(ctx, cfg) {
                     }
                 }
                 else {
-                    logger.warn(`[成语接龙玩家] API返回异常: code=${dt.code}, msg=${dt.msg}`);
+                    logWarn(`[成语接龙玩家] API返回异常: code=${dt.code}, msg=${dt.msg}`);
                     m = dt.msg || '接龙失败';
                     m += '\n' + d.chengyuJielong.wrong;
                     await session.send(m);
@@ -837,7 +845,7 @@ async function apply(ctx, cfg) {
             }
             catch (error) {
                 const err = error;
-                logger.error(`[成语接龙玩家] API调用失败: ${err.message}`);
+                logError(`[成语接龙玩家] API调用失败: ${err.message}`, err);
                 await session.send(d.chengyuJielong.apiError);
             }
             setupAutoStop(session, st.chengyuJielong, 'chengyuJielong', d.chengyuJielong.autoStop, cfg.chengyuJielong.showRank, d.chengyuJielong.rankTitle, d.chengyuJielong.rankEmpty);
@@ -854,6 +862,7 @@ async function apply(ctx, cfg) {
             }
             if (content === '提示') {
                 try {
+                    logDebug(`[看图猜成语] 开始调用获取提示API，题目ID: ${st.chengyuImage.currentId}, 提示级别: ${cfg.chengyuImage.defaultHintLevel}`);
                     const r = await axios_1.default.get('https://jcy.lvlong.xyz/api/api/chengyu.php', {
                         params: {
                             action: 'get_hint',
@@ -862,15 +871,21 @@ async function apply(ctx, cfg) {
                         },
                         timeout: cfg.apiConfig.timeout
                     });
+                    logDebug(`[看图猜成语] 获取提示API返回状态码: ${r.status}`);
+                    logDebug(`[看图猜成语] 获取提示API返回数据:`, r.data);
                     const dt = r.data;
                     if (dt.success) {
+                        logDebug(`[看图猜成语] 成功获取提示: ${dt.data.hint}`);
                         await session.send(d.chengyuImage.hintGet.replace('{0}', dt.data.hint));
                     }
                     else {
+                        logWarn(`[看图猜成语] 获取提示失败: ${dt.message}`);
                         await session.send(d.chengyuImage.hintError);
                     }
                 }
                 catch (error) {
+                    const err = error;
+                    logError(`[看图猜成语] 获取提示API调用失败: ${err.message}`, err);
                     await session.send(d.chengyuImage.hintError);
                 }
                 setupAutoStop(session, st.chengyuImage, 'chengyuImage', d.chengyuImage.autoStop, cfg.chengyuImage.showRank, d.chengyuImage.rankTitle, d.chengyuImage.rankEmpty);
@@ -882,6 +897,7 @@ async function apply(ctx, cfg) {
                 return;
             }
             try {
+                logDebug(`[看图猜成语] 开始调用提交答案API，题目ID: ${st.chengyuImage.currentId}, 答案: ${content}`);
                 const r = await axios_1.default.get('https://jcy.lvlong.xyz/api/api/chengyu.php', {
                     params: {
                         action: 'submit_answer',
@@ -890,6 +906,8 @@ async function apply(ctx, cfg) {
                     },
                     timeout: cfg.apiConfig.timeout
                 });
+                logDebug(`[看图猜成语] 提交答案API返回状态码: ${r.status}`);
+                logDebug(`[看图猜成语] 提交答案API返回数据:`, r.data);
                 const dt = r.data;
                 if (dt.success) {
                     let reply = '';
@@ -898,6 +916,7 @@ async function apply(ctx, cfg) {
                         st.chengyuImage.players[playerKey].correctCount += 1;
                         await savePlayerData(session, st.chengyuImage.players[playerKey]);
                         reply = d.chengyuImage.correct.replace('{0}', st.chengyuImage.players[playerKey].score.toString());
+                        logDebug(`[看图猜成语] 回答正确，当前得分: ${st.chengyuImage.players[playerKey].score}`);
                         st.chengyuImage.currentRound += 1;
                         if (st.chengyuImage.currentRound > st.chengyuImage.totalRounds) {
                             st.chengyuImage.started = false;
@@ -913,6 +932,7 @@ async function apply(ctx, cfg) {
                         else {
                             await session.send(reply);
                             await session.send(d.chengyuImage.roundEnd.replace('{0}', st.chengyuImage.currentRound.toString()).replace('{1}', (st.chengyuImage.totalRounds - st.chengyuImage.currentRound).toString()));
+                            logDebug(`[看图猜成语] 开始调用下一题API，页码: ${st.chengyuImage.currentPage + 1}`);
                             const nextR = await axios_1.default.get('https://jcy.lvlong.xyz/api/api/chengyu.php', {
                                 params: {
                                     action: 'next_question',
@@ -920,17 +940,21 @@ async function apply(ctx, cfg) {
                                 },
                                 timeout: cfg.apiConfig.timeout
                             });
+                            logDebug(`[看图猜成语] 下一题API返回状态码: ${nextR.status}`);
+                            logDebug(`[看图猜成语] 下一题API返回数据:`, nextR.data);
                             const nextDt = nextR.data;
                             if (nextDt.success) {
                                 st.chengyuImage.currentId = nextDt.data.question.id;
                                 st.chengyuImage.currentPage = nextDt.data.question.page;
                                 st.chengyuImage.options = nextDt.data.question.options;
                                 st.chengyuImage.answer = nextDt.data.question.answer || '';
+                                logDebug(`[看图猜成语] 获取到新题目，ID: ${st.chengyuImage.currentId}, 答案: ${st.chengyuImage.answer}`);
                                 await session.send(d.chengyuImage.next.replace('{0}', st.chengyuImage.currentRound.toString()));
                                 await session.send(`请从选项中选择4个字组成成语\n选项：${nextDt.data.question.options.join('、')}`);
                                 await session.send(koishi_1.segment.image(nextDt.data.question.image_url));
                             }
                             else {
+                                logWarn(`[看图猜成语] 获取下一题失败: ${nextDt.message}`);
                                 await session.send('获取下一题失败，比赛结束！');
                                 st.chengyuImage.started = false;
                                 clearGameTimer(st.chengyuImage);
@@ -945,14 +969,18 @@ async function apply(ctx, cfg) {
                     else {
                         const correctAnswer = dt.data?.correct_answer || st.chengyuImage.answer;
                         reply = d.chengyuImage.wrong.replace('{0}', correctAnswer).replace('{1}', st.chengyuImage.players[playerKey].score.toString());
+                        logDebug(`[看图猜成语] 回答错误，正确答案: ${correctAnswer}`);
                         await session.send(reply);
                     }
                 }
                 else {
+                    logWarn(`[看图猜成语] 提交答案失败: ${dt.message}`);
                     await session.send('提交答案失败，请稍后再试');
                 }
             }
             catch (error) {
+                const err = error;
+                logError(`[看图猜成语] 提交答案API调用失败: ${err.message}`, err);
                 await session.send(d.chengyuImage.apiError);
             }
             setupAutoStop(session, st.chengyuImage, 'chengyuImage', d.chengyuImage.autoStop, cfg.chengyuImage.showRank, d.chengyuImage.rankTitle, d.chengyuImage.rankEmpty);
@@ -974,9 +1002,12 @@ async function apply(ctx, cfg) {
                 return;
             }
             try {
+                logDebug(`[王者英雄] 开始调用API，用户ID: ${getUserId(session)}, 内容: ${content}`);
                 const r = await axios_1.default.get('https://api.suol.cc/v1/game_wz.php', {
-                    params: { id: getIntUserId(session), msg: content }, timeout: cfg.apiConfig.timeout
+                    params: { id: getUserId(session), msg: content }, timeout: cfg.apiConfig.timeout
                 });
+                logDebug(`[王者英雄] API返回状态码: ${r.status}`);
+                logDebug(`[王者英雄] API返回数据:`, r.data);
                 const dt = r.data;
                 if (dt.status === 'success') {
                     let text = `${dt.message || ''}\n${dt.hint || ''}\n剩余提示次数：${dt.remaining_hints}\n${dt.guide || ''}`;
@@ -986,6 +1017,7 @@ async function apply(ctx, cfg) {
                         st.wzHero.players[playerKey].correctCount += 1;
                         await savePlayerData(session, st.wzHero.players[playerKey]);
                         text += '\n' + d.wzHero.correct.replace('{0}', st.wzHero.players[playerKey].score.toString());
+                        logDebug(`[王者英雄] 回答正确，当前得分: ${st.wzHero.players[playerKey].score}`);
                         st.wzHero.currentRound += 1;
                         if (st.wzHero.currentRound > st.wzHero.totalRounds) {
                             st.wzHero.started = false;
@@ -1002,28 +1034,36 @@ async function apply(ctx, cfg) {
                         }
                         else {
                             text += '\n' + d.wzHero.roundEnd.replace('{0}', st.wzHero.currentRound.toString()).replace('{1}', (st.wzHero.totalRounds - st.wzHero.currentRound).toString());
+                            logDebug(`[王者英雄] 开始调用下一题API`);
                             const nextR = await axios_1.default.get('https://api.suol.cc/v1/game_wz.php', {
-                                params: { id: getIntUserId(session), msg: `开始游戏${st.wzHero.difficulty}` }, timeout: cfg.apiConfig.timeout
+                                params: { id: getUserId(session), msg: `开始游戏${st.wzHero.difficulty}` }, timeout: cfg.apiConfig.timeout
                             });
+                            logDebug(`[王者英雄] 下一题API返回状态码: ${nextR.status}`);
+                            logDebug(`[王者英雄] 下一题API返回数据:`, nextR.data);
                             const nextDt = nextR.data;
                             if (nextDt.status === 'success') {
                                 let nextText = `${nextDt.message || ''}\n${nextDt.hint || ''}\n剩余提示次数：${nextDt.remaining_hints}\n${nextDt.guide || ''}`;
                                 nextText = nextText.replace(/\\n/g, '\n');
                                 text += '\n' + nextText;
                                 st.wzHero.currentAnswer = nextDt.hint || '';
+                                logDebug(`[王者英雄] 获取到新题目，答案提示: ${st.wzHero.currentAnswer}`);
                             }
                         }
                     }
                     else if (content !== '提示' && dt.message.includes('错误')) {
                         text += '\n' + d.wzHero.wrong.replace('{0}', st.wzHero.currentAnswer).replace('{1}', st.wzHero.players[playerKey].score.toString());
+                        logDebug(`[王者英雄] 回答错误，正确答案: ${st.wzHero.currentAnswer}`);
                     }
                     await session.send(text);
                 }
                 else {
+                    logWarn(`[王者英雄] API返回异常:`, dt);
                     await session.send((dt.message || '出错').replace(/\\n/g, '\n'));
                 }
             }
             catch (error) {
+                const err = error;
+                logError(`[王者英雄] API调用失败: ${err.message}`, err);
                 await session.send(d.wzHero.apiError);
             }
             setupAutoStop(session, st.wzHero, 'wzHero', d.wzHero.autoStop, cfg.wzHero.showRank, d.wzHero.rankTitle, d.wzHero.rankEmpty);
@@ -1222,18 +1262,24 @@ async function apply(ctx, cfg) {
             st.wzHero.difficulty = cfg.wzHero.defaultDifficulty;
             st.wzHero.currentRound = 1;
             try {
+                logDebug(`[王者英雄] 开始游戏，难度: ${st.wzHero.difficulty}`);
                 const r = await axios_1.default.get('https://api.suol.cc/v1/game_wz.php', {
-                    params: { id: getIntUserId(session), msg: `开始游戏${st.wzHero.difficulty}` },
+                    params: { id: getUserId(session), msg: `开始游戏${st.wzHero.difficulty}` },
                     timeout: cfg.apiConfig.timeout
                 });
+                logDebug(`[王者英雄] 开始游戏API返回状态码: ${r.status}`);
+                logDebug(`[王者英雄] 开始游戏API返回数据:`, r.data);
                 const dt = r.data;
                 let text = `${dt.message || ''}\n${dt.hint || ''}\n剩余提示次数：${dt.remaining_hints}\n${dt.guide || ''}`;
                 text = text.replace(/\\n/g, '\n');
                 await session.send(d.wzHero.start.replace('{0}', st.wzHero.totalRounds.toString()).replace('{1}', st.wzHero.difficulty));
                 await session.send(text);
                 st.wzHero.currentAnswer = dt.hint || '';
+                logDebug(`[王者英雄] 获取到题目，答案提示: ${st.wzHero.currentAnswer}`);
             }
             catch (e) {
+                const err = e;
+                logError(`[王者英雄] 开始游戏API调用失败: ${err.message}`, err);
                 await session.send(d.wzHero.apiError);
             }
             gameStates.set(key, st);
@@ -1267,25 +1313,32 @@ async function apply(ctx, cfg) {
             st.chengyuImage.started = true;
             st.chengyuImage.currentRound = 1;
             try {
+                logDebug(`[看图猜成语] 开始游戏，获取第一题`);
                 const r = await axios_1.default.get('https://jcy.lvlong.xyz/api/api/chengyu.php', {
                     params: { action: 'next_question', page: 1 },
                     timeout: cfg.apiConfig.timeout
                 });
+                logDebug(`[看图猜成语] 获取题目API返回状态码: ${r.status}`);
+                logDebug(`[看图猜成语] 获取题目API返回数据:`, r.data);
                 const dt = r.data;
                 if (dt.success) {
                     st.chengyuImage.currentId = dt.data.question.id;
                     st.chengyuImage.currentPage = dt.data.question.page;
                     st.chengyuImage.options = dt.data.question.options;
                     st.chengyuImage.answer = dt.data.question.answer || '';
+                    logDebug(`[看图猜成语] 获取到题目，ID: ${st.chengyuImage.currentId}, 答案: ${st.chengyuImage.answer}`);
                     await session.send(d.chengyuImage.start.replace('{0}', st.chengyuImage.totalRounds.toString()).replace('{1}', cfg.chengyuImage.defaultHintLevel.toString()));
                     await session.send(`请从选项中选择4个字组成成语\n选项：${dt.data.question.options.join('、')}`);
                     await session.send(koishi_1.segment.image(dt.data.question.image_url));
                 }
                 else {
+                    logWarn(`[看图猜成语] 获取题目失败: ${dt.message}`);
                     await session.send(d.chengyuImage.apiError);
                 }
             }
             catch (e) {
+                const err = e;
+                logError(`[看图猜成语] 获取题目API调用失败: ${err.message}`, err);
                 await session.send(d.chengyuImage.apiError);
             }
             gameStates.set(key, st);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "koishi-plugin-game-mini",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "description": "Koishi多功能小游戏合集：猜数字、猜王者英雄、看图猜成语、成语接龙、算24点",
   "main": "lib/index.js",
   "typings": "lib/index.d.ts",

package/readme.md

@@ -86,6 +86,8 @@ This is a lightweight, multi-functional mini-game plugin developed for the Koish
 | `rank.maxDisplay` | 排行榜最多显示人数 | 10 |
 | `rank.clearDataPermission` | 清零数据所需权限等级 | 5 |
 | `rank.messages.showTotalStats` | 是否显示总统计数据 | true |
+| **🔧 调试配置** | | |
+| `debug.enableLog` | 启用调试日志输出 | false |
 | **🎲 猜数字游戏配置** | | |
 | `guessNumber.min` | 最小值 | 0 |
 | `guessNumber.max` | 最大值 | 100 |
@@ -154,6 +156,8 @@ This is a lightweight, multi-functional mini-game plugin developed for the Koish
 | `rank.maxDisplay` | Maximum display count in rank | 10 |
 | `rank.clearDataPermission` | Authority level required to clear data | 5 |
 | `rank.messages.showTotalStats` | Whether to show total statistics | true |
+| **🔧 Debug Configuration** | | |
+| `debug.enableLog` | Enable debug log output | false |
 | **🎲 Number Guessing Configuration** | | |
 | `guessNumber.min` | Minimum value | 0 |
 | `guessNumber.max` | Maximum value | 100 |