koishi-plugin-steam-info-check 1.0.7 → 1.0.9

package/dist/index.js

@@ -12,11 +12,11 @@ const zh_CN_1 = __importDefault(require("./locales/zh-CN"));
 exports.name = 'steam-info';
 exports.inject = ['model', 'http', 'puppeteer', 'database'];
 exports.Config = koishi_1.Schema.object({
-    steamApiKey: koishi_1.Schema.array(String).required().description('Steam API Key (supports multiple)'),
-    proxy: koishi_1.Schema.string().description('Proxy URL (e.g., http://127.0.0.1:7890)'),
-    steamRequestInterval: koishi_1.Schema.number().default(300).description('Polling interval in seconds'),
-    steamBroadcastType: koishi_1.Schema.union(['all', 'part', 'none']).default('part').description('Broadcast type: all (list), part (gaming only), none (text only)'),
-    steamDisableBroadcastOnStartup: koishi_1.Schema.boolean().default(false).description('Disable broadcast on startup'),
+    steamApiKey: koishi_1.Schema.array(String).required().description('Steam API Key（支持多个）'),
+    proxy: koishi_1.Schema.string().description('代理地址，例如 http://127.0.0.1:7890'),
+    steamRequestInterval: koishi_1.Schema.number().default(300).description('轮询间隔（秒）'),
+    steamBroadcastType: koishi_1.Schema.union(['all', 'part', 'none']).default('part').description('播报类型：all（全部图片列表）、part（仅开始游戏时图片）、none（仅文字）'),
+    steamDisableBroadcastOnStartup: koishi_1.Schema.boolean().default(false).description('启动时禁用首次播报（仅预热缓存）'),
     fonts: koishi_1.Schema.object({
         regular: koishi_1.Schema.string().default('fonts/MiSans-Regular.ttf'),
         light: koishi_1.Schema.string().default('fonts/MiSans-Light.ttf'),
@@ -65,7 +65,7 @@ function apply(ctx, config) {
     // Commands and scheduler depend on steam/drawer being ready
     ctx.using(['steam', 'drawer'], (ctx) => {
         ctx.command('steam', 'Steam 信息');
-        ctx.command('steam.bind <steamId:string>', 'Bind Steam ID', { authority: config.commandAuthority.bind })
+        ctx.command('steam.bind <steamId:string>', '绑定 Steam ID', { authority: config.commandAuthority.bind })
             .alias('steambind', '绑定steam')
             .action(async ({ session }, steamId) => {
             if (!session)
@@ -75,6 +75,16 @@ function apply(ctx, config) {
             const targetId = await ctx.steam.getSteamId(steamId);
             if (!targetId)
                 return session.text('.id_not_found');
+            // 检查是否已绑定
+            try {
+                const existing = await ctx.database.get('steam_bind', { userId: session.userId, channelId: session.channelId });
+                if (existing.length) {
+                    return session.text('.already_bound');
+                }
+            }
+            catch (e) {
+                exports.logger.error('检查已绑定状态失败：' + String(e) + ' EEE');
+            }
             await ctx.database.upsert('steam_bind', [
                 {
                     userId: session.userId,
@@ -84,7 +94,7 @@ function apply(ctx, config) {
             ], ['userId', 'channelId']);
             return session.text('.bind_success', [targetId]);
         });
-        ctx.command('steam.unbind', 'Unbind Steam ID', { authority: config.commandAuthority.unbind })
+        ctx.command('steam.unbind', '解绑 Steam ID', { authority: config.commandAuthority.unbind })
             .alias('steamunbind', '解绑steam')
             .action(async ({ session }) => {
             if (!session)
@@ -95,7 +105,7 @@ function apply(ctx, config) {
             });
             return result ? session.text('.unbind_success') : session.text('.not_bound');
         });
-        ctx.command('steam.info [target:text]', 'View Steam Profile', { authority: config.commandAuthority.info })
+        ctx.command('steam.info [target:text]', '查看 Steam 资料', { authority: config.commandAuthority.info })
             .alias('steaminfo', 'steam信息')
             .action(async ({ session }, target) => {
             if (!session)
@@ -136,7 +146,7 @@ function apply(ctx, config) {
                 return session.text('.error');
             }
         });
-        ctx.command('steam.check', 'Check Friends Status', { authority: config.commandAuthority.check })
+        ctx.command('steam.check', '查看好友在线状态', { authority: config.commandAuthority.check })
             .alias('steamcheck', '查看steam', '查steam')
             .action(async ({ session }) => {
             if (!session)
@@ -164,7 +174,7 @@ function apply(ctx, config) {
                 return session.text('.error');
             }
         });
-        ctx.command('steam.enable', 'Enable Broadcast', { authority: config.commandAuthority.enable })
+        ctx.command('steam.enable', '启用播报', { authority: config.commandAuthority.enable })
             .alias('steamenable', '启用steam')
             .action(async ({ session }) => {
             if (!session)
@@ -177,7 +187,7 @@ function apply(ctx, config) {
                 }]);
             return session.text('.enable_success');
         });
-        ctx.command('steam.disable', 'Disable Broadcast', { authority: config.commandAuthority.disable })
+        ctx.command('steam.disable', '禁用播报', { authority: config.commandAuthority.disable })
             .alias('steamdisable', '禁用steam')
             .action(async ({ session }) => {
             if (!session)
@@ -190,7 +200,7 @@ function apply(ctx, config) {
                 }]);
             return session.text('.disable_success');
         });
-        ctx.command('steam.update [name:string] [avatar:image]', 'Update Group Info', { authority: config.commandAuthority.update })
+        ctx.command('steam.update [name:string] [avatar:image]', '更新群信息', { authority: config.commandAuthority.update })
             .alias('steamupdate', '更新群信息')
             .action(async ({ session }, name, avatar) => {
             if (!session)
@@ -212,7 +222,7 @@ function apply(ctx, config) {
             await ctx.database.upsert('steam_channel', [update]);
             return session.text('.update_success');
         });
-        ctx.command('steam.nickname <nickname:string>', 'Set Steam Nickname', { authority: config.commandAuthority.nickname })
+        ctx.command('steam.nickname <nickname:string>', '设置 Steam 昵称', { authority: config.commandAuthority.nickname })
             .alias('steamnickname', 'steam昵称')
             .action(async ({ session }, nickname) => {
             if (!session)
@@ -247,13 +257,52 @@ async function ensureChannelMeta(ctx, session) {
     }
     // OneBot 群名补充
     if (!name && session.platform?.includes('onebot') && session.bot?.internal?.getGroupInfo) {
-        try {
-            const info = await session.bot.internal.getGroupInfo({ group_id: channelId });
-            if (info?.group_name)
-                name = info.group_name;
-        }
-        catch {
-            /* ignore */
+        // 柔性尝试多种参数传递方式，记录每次调用结果以便定位 napcat/onebot 的参数格式差异
+        const argVariants = [
+            { group_id: channelId },
+            { group_id: { group_id: channelId } },
+            { group_id: Number(channelId) },
+            { group_id: { group_id: Number(channelId) } },
+        ];
+        for (const args of argVariants) {
+            try {
+                exports.logger.error(`getGroupInfo 尝试 args=${JSON.stringify(args)}`);
+                const info = await session.bot.internal.getGroupInfo(args);
+                exports.logger.error(`getGroupInfo 返回: ${JSON.stringify(info)}`);
+                if (!info)
+                    continue;
+                // 支持多种返回结构：直接 group_name、data.group_name（napcat）、或嵌套情况
+                if (info.group_name) {
+                    name = info.group_name;
+                    break;
+                }
+                if (info.data && info.data.group_name) {
+                    name = info.data.group_name;
+                    break;
+                }
+                if (info.data && info.data.group && info.data.group.group_name) {
+                    name = info.data.group.group_name;
+                    break;
+                }
+                // 某些实现会把返回包在 ret.data 或直接在 ret
+                if (info.ret && info.ret.data && info.ret.data.group_name) {
+                    name = info.ret.data.group_name;
+                    break;
+                }
+                // 如果未识别结构，记录并继续尝试下一个参数形态
+                exports.logger.error('getGroupInfo 返回了未识别结构（尝试 参数：' + JSON.stringify(args) + '）: ' + JSON.stringify(info) + ' EEE');
+            }
+            catch (err) {
+                // 记录详细错误以便分析 retcode/args
+                try {
+                    exports.logger.error('getGroupInfo 调用失败，args=' + JSON.stringify(args) + '，错误：' + String(err) + ' EEE');
+                }
+                catch (e) {
+                    exports.logger.error('getGroupInfo 调用失败但记录 args 时出错：' + String(e) + ' EEE');
+                }
+                // 如果错误中包含 retcode，记录方便排查
+                // 继续尝试下一个参数变体
+            }
         }
     }
     let avatar = current.avatar;
@@ -278,79 +327,92 @@ async function ensureChannelMeta(ctx, session) {
 }
 async function seedStatusCache(ctx) {
     const binds = await ctx.database.get('steam_bind', {});
+    exports.logger.error(`seedStatusCache: load binds count=${binds.length}`);
     if (!binds.length)
         return;
     const steamIds = [...new Set(binds.map(b => b.steamId))];
     const summaries = await ctx.steam.getPlayerSummaries(steamIds);
+    exports.logger.error(`seedStatusCache: fetched summaries=${summaries.length}`);
     for (const player of summaries) {
         statusCache.set(player.steamid, player);
     }
 }
 async function broadcast(ctx, config) {
-    const channels = await ctx.database.get('steam_channel', { enable: true });
-    if (channels.length === 0)
-        return;
-    const channelIds = channels.map(c => c.id);
-    const binds = await ctx.database.get('steam_bind', { channelId: channelIds });
-    if (binds.length === 0)
-        return;
-    const steamIds = [...new Set(binds.map(b => b.steamId))];
-    const currentSummaries = await ctx.steam.getPlayerSummaries(steamIds);
-    const currentMap = new Map(currentSummaries.map(p => [p.steamid, p]));
-    for (const channel of channels) {
-        const channelBinds = binds.filter(b => b.channelId === channel.id);
-        const msgs = [];
-        const startGamingPlayers = [];
-        for (const bind of channelBinds) {
-            const current = currentMap.get(bind.steamId);
-            const old = statusCache.get(bind.steamId);
-            if (!current)
-                continue;
-            if (!old)
-                continue;
-            const oldGame = old.gameextrainfo;
-            const newGame = current.gameextrainfo;
-            const name = bind.nickname || current.personaname;
-            if (newGame && !oldGame) {
-                msgs.push(`${name} 开始玩 ${newGame} 了`);
-                startGamingPlayers.push({ ...current, nickname: bind.nickname });
-            }
-            else if (!newGame && oldGame) {
-                msgs.push(`${name} 玩了 ${oldGame} 后不玩了`);
-            }
-            else if (newGame && oldGame && newGame !== oldGame) {
-                msgs.push(`${name} 停止玩 ${oldGame}，开始玩 ${newGame} 了`);
-            }
-        }
-        if (msgs.length > 0) {
-            const botKey = channel.platform && channel.assignee ? `${channel.platform}:${channel.assignee}` : undefined;
-            const bot = botKey ? ctx.bots[botKey] : Object.values(ctx.bots)[0];
-            if (!bot)
-                continue;
-            if (config.steamBroadcastType === 'none') {
-                await bot.sendMessage(channel.id, msgs.join('\n'));
-            }
-            else if (config.steamBroadcastType === 'part') {
-                if (startGamingPlayers.length > 0) {
-                    const images = await Promise.all(startGamingPlayers.map(p => ctx.drawer.drawStartGaming(p, p.nickname)));
-                    const combined = await ctx.drawer.concatImages(images);
-                    const img = combined ? (typeof combined === 'string' ? combined : koishi_1.h.image(combined, 'image/png')) : '';
-                    await bot.sendMessage(channel.id, msgs.join('\n') + img);
+    try {
+        const channels = await ctx.database.get('steam_channel', { enable: true });
+        exports.logger.error(`broadcast: enabled channels=${channels.length}`);
+        if (channels.length === 0)
+            return;
+        const channelIds = channels.map(c => c.id);
+        const binds = await ctx.database.get('steam_bind', { channelId: channelIds });
+        exports.logger.error(`broadcast: binds total=${binds.length}`);
+        if (binds.length === 0)
+            return;
+        const steamIds = [...new Set(binds.map(b => b.steamId))];
+        exports.logger.error(`broadcast: unique steamIds=${steamIds.length}`);
+        const currentSummaries = await ctx.steam.getPlayerSummaries(steamIds);
+        exports.logger.error(`broadcast: fetched summaries=${currentSummaries.length}`);
+        const currentMap = new Map(currentSummaries.map(p => [p.steamid, p]));
+        for (const channel of channels) {
+            exports.logger.error(`broadcast: channel=${channel.id} processing`);
+            const channelBinds = binds.filter(b => b.channelId === channel.id);
+            const msgs = [];
+            const startGamingPlayers = [];
+            for (const bind of channelBinds) {
+                const current = currentMap.get(bind.steamId);
+                const old = statusCache.get(bind.steamId);
+                if (!current)
+                    continue;
+                if (!old)
+                    continue;
+                const oldGame = old.gameextrainfo;
+                const newGame = current.gameextrainfo;
+                const name = bind.nickname || current.personaname;
+                if (newGame && !oldGame) {
+                    msgs.push(`${name} 开始玩 ${newGame} 了`);
+                    startGamingPlayers.push({ ...current, nickname: bind.nickname });
                 }
-                else {
-                    await bot.sendMessage(channel.id, msgs.join('\n'));
+                else if (!newGame && oldGame) {
+                    msgs.push(`${name} 玩了 ${oldGame} 后不玩了`);
+                }
+                else if (newGame && oldGame && newGame !== oldGame) {
+                    msgs.push(`${name} 停止玩 ${oldGame}，开始玩 ${newGame} 了`);
                 }
             }
-            else if (config.steamBroadcastType === 'all') {
-                const channelPlayers = channelBinds.map(b => currentMap.get(b.steamId)).filter(Boolean);
-                const parentAvatar = channel.avatar ? Buffer.from(channel.avatar, 'base64') : await ctx.drawer.getDefaultAvatar();
-                const image = await ctx.drawer.drawFriendsStatus(parentAvatar, channel.name || channel.id, channelPlayers, channelBinds);
-                const img = image ? (typeof image === 'string' ? image : koishi_1.h.image(image, 'image/png')) : '';
-                await bot.sendMessage(channel.id, msgs.join('\n') + img);
+            if (msgs.length > 0) {
+                exports.logger.error(`broadcast: channel=${channel.id} msgs=${msgs.length}`);
+                const botKey = channel.platform && channel.assignee ? `${channel.platform}:${channel.assignee}` : undefined;
+                const bot = botKey ? ctx.bots[botKey] : Object.values(ctx.bots)[0];
+                if (!bot)
+                    continue;
+                if (config.steamBroadcastType === 'none') {
+                    await bot.sendMessage(channel.id, msgs.join('\n'));
+                }
+                else if (config.steamBroadcastType === 'part') {
+                    if (startGamingPlayers.length > 0) {
+                        const images = await Promise.all(startGamingPlayers.map(p => ctx.drawer.drawStartGaming(p, p.nickname)));
+                        const combined = await ctx.drawer.concatImages(images);
+                        const img = combined ? (typeof combined === 'string' ? combined : koishi_1.h.image(combined, 'image/png')) : '';
+                        await bot.sendMessage(channel.id, msgs.join('\n') + img);
+                    }
+                    else {
+                        await bot.sendMessage(channel.id, msgs.join('\n'));
+                    }
+                }
+                else if (config.steamBroadcastType === 'all') {
+                    const channelPlayers = channelBinds.map(b => currentMap.get(b.steamId)).filter(Boolean);
+                    const parentAvatar = channel.avatar ? Buffer.from(channel.avatar, 'base64') : await ctx.drawer.getDefaultAvatar();
+                    const image = await ctx.drawer.drawFriendsStatus(parentAvatar, channel.name || channel.id, channelPlayers, channelBinds);
+                    const img = image ? (typeof image === 'string' ? image : koishi_1.h.image(image, 'image/png')) : '';
+                    await bot.sendMessage(channel.id, msgs.join('\n') + img);
+                }
             }
         }
+        for (const p of currentSummaries) {
+            statusCache.set(p.steamid, p);
+        }
     }
-    for (const p of currentSummaries) {
-        statusCache.set(p.steamid, p);
+    catch (err) {
+        exports.logger.error('broadcast 发生异常：' + String(err) + ' EEE');
     }
 }

package/dist/locales/zh-CN.d.ts

@@ -3,10 +3,12 @@ declare const _default: {
         steam: {
             bind: {
                 bind_success: string;
+                already_bound: string;
                 invalid_id: string;
                 id_not_found: string;
                 error: string;
                 messages: {
+                    already_bound: string;
                     invalid_id: string;
                     id_not_found: string;
                     bind_success: string;

package/dist/locales/zh-CN.js

@@ -5,10 +5,12 @@ exports.default = {
         steam: {
             bind: {
                 bind_success: '绑定成功！Steam ID: {0}',
+                already_bound: '您已经绑定过帐号了！',
                 invalid_id: '请输入有效的 Steam ID。',
                 id_not_found: '无法找到该 Steam ID。',
                 error: '发生错误。',
                 messages: {
+                    already_bound: '您已经绑定过帐号了！',
                     invalid_id: '请输入有效的 Steam ID。',
                     id_not_found: '无法找到该 Steam ID。',
                     bind_success: '绑定成功！Steam ID: {0}',

package/dist/service.js

@@ -43,7 +43,7 @@ class SteamService extends koishi_1.Service {
                     }
                 }
                 catch (e) {
-                    this.ctx.logger('steam').warn(`API key ${key} failed: ${e}`);
+                    this.ctx.logger('steam').error(`API key ${key} failed: ${e} EEE`);
                 }
             }
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "koishi-plugin-steam-info-check",
-  "version": "1.0.7",
+  "version": "1.0.9",
   "description": "Steam friends status broadcast plugin for Koishi",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/index.ts

@@ -31,11 +31,11 @@ export interface Config {
 }
 
 export const Config: Schema<Config> = Schema.object({
-  steamApiKey: Schema.array(String).required().description('Steam API Key (supports multiple)'),
-  proxy: Schema.string().description('Proxy URL (e.g., http://127.0.0.1:7890)'),
-  steamRequestInterval: Schema.number().default(300).description('Polling interval in seconds'),
-  steamBroadcastType: Schema.union(['all', 'part', 'none']).default('part').description('Broadcast type: all (list), part (gaming only), none (text only)'),
-  steamDisableBroadcastOnStartup: Schema.boolean().default(false).description('Disable broadcast on startup'),
+  steamApiKey: Schema.array(String).required().description('Steam API Key（支持多个）'),
+  proxy: Schema.string().description('代理地址，例如 http://127.0.0.1:7890'),
+  steamRequestInterval: Schema.number().default(300).description('轮询间隔（秒）'),
+  steamBroadcastType: Schema.union(['all', 'part', 'none']).default('part').description('播报类型：all（全部图片列表）、part（仅开始游戏时图片）、none（仅文字）'),
+  steamDisableBroadcastOnStartup: Schema.boolean().default(false).description('启动时禁用首次播报（仅预热缓存）'),
   fonts: Schema.object({
     regular: Schema.string().default('fonts/MiSans-Regular.ttf'),
     light: Schema.string().default('fonts/MiSans-Light.ttf'),
@@ -98,15 +98,25 @@ export function apply(ctx: Context, config: Config) {
   ctx.using(['steam', 'drawer'], (ctx) => {
     ctx.command('steam', 'Steam 信息')
 
-    ctx.command('steam.bind <steamId:string>', 'Bind Steam ID', { authority: config.commandAuthority.bind })
+    ctx.command('steam.bind <steamId:string>', '绑定 Steam ID', { authority: config.commandAuthority.bind })
       .alias('steambind', '绑定steam')
       .action(async ({ session }, steamId) => {
         if (!session) return
         if (!steamId || !/^\d+$/.test(steamId)) return session.text('.invalid_id')
-        
+
         const targetId = await ctx.steam.getSteamId(steamId)
         if (!targetId) return session.text('.id_not_found')
 
+        // 检查是否已绑定
+        try {
+          const existing = await ctx.database.get('steam_bind', { userId: session.userId, channelId: session.channelId })
+          if (existing.length) {
+            return session.text('.already_bound')
+          }
+        } catch (e) {
+          logger.error('检查已绑定状态失败：' + String(e) + ' EEE')
+        }
+
         await ctx.database.upsert('steam_bind', [
           {
             userId: session.userId,
@@ -118,7 +128,7 @@ export function apply(ctx: Context, config: Config) {
         return session.text('.bind_success', [targetId])
       })
 
-    ctx.command('steam.unbind', 'Unbind Steam ID', { authority: config.commandAuthority.unbind })
+    ctx.command('steam.unbind', '解绑 Steam ID', { authority: config.commandAuthority.unbind })
       .alias('steamunbind', '解绑steam')
       .action(async ({ session }) => {
         if (!session) return
@@ -129,7 +139,7 @@ export function apply(ctx: Context, config: Config) {
         return result ? session.text('.unbind_success') : session.text('.not_bound')
       })
 
-    ctx.command('steam.info [target:text]', 'View Steam Profile', { authority: config.commandAuthority.info })
+    ctx.command('steam.info [target:text]', '查看 Steam 资料', { authority: config.commandAuthority.info })
       .alias('steaminfo', 'steam信息')
       .action(async ({ session }, target) => {
         if (!session) return
@@ -166,7 +176,7 @@ export function apply(ctx: Context, config: Config) {
         }
       })
 
-    ctx.command('steam.check', 'Check Friends Status', { authority: config.commandAuthority.check })
+    ctx.command('steam.check', '查看好友在线状态', { authority: config.commandAuthority.check })
       .alias('steamcheck', '查看steam', '查steam')
       .action(async ({ session }) => {
         if (!session) return
@@ -194,7 +204,7 @@ export function apply(ctx: Context, config: Config) {
         }
       })
 
-    ctx.command('steam.enable', 'Enable Broadcast', { authority: config.commandAuthority.enable })
+    ctx.command('steam.enable', '启用播报', { authority: config.commandAuthority.enable })
       .alias('steamenable', '启用steam')
       .action(async ({ session }) => {
         if (!session) return
@@ -207,7 +217,7 @@ export function apply(ctx: Context, config: Config) {
         return session.text('.enable_success')
       })
 
-    ctx.command('steam.disable', 'Disable Broadcast', { authority: config.commandAuthority.disable })
+    ctx.command('steam.disable', '禁用播报', { authority: config.commandAuthority.disable })
       .alias('steamdisable', '禁用steam')
       .action(async ({ session }) => {
         if (!session) return
@@ -220,7 +230,7 @@ export function apply(ctx: Context, config: Config) {
         return session.text('.disable_success')
       })
     
-    ctx.command('steam.update [name:string] [avatar:image]', 'Update Group Info', { authority: config.commandAuthority.update })
+    ctx.command('steam.update [name:string] [avatar:image]', '更新群信息', { authority: config.commandAuthority.update })
       .alias('steamupdate', '更新群信息')
       .action(async ({ session }, name, avatar) => {
           if (!session) return
@@ -243,7 +253,7 @@ export function apply(ctx: Context, config: Config) {
           return session.text('.update_success')
       })
 
-    ctx.command('steam.nickname <nickname:string>', 'Set Steam Nickname', { authority: config.commandAuthority.nickname })
+    ctx.command('steam.nickname <nickname:string>', '设置 Steam 昵称', { authority: config.commandAuthority.nickname })
       .alias('steamnickname', 'steam昵称')
       .action(async ({ session }, nickname) => {
         if (!session) return
@@ -281,11 +291,54 @@ async function ensureChannelMeta(ctx: Context, session: Session) {
   }
   // OneBot 群名补充
   if (!name && session.platform?.includes('onebot') && session.bot?.internal?.getGroupInfo) {
-    try {
-      const info = await session.bot.internal.getGroupInfo({ group_id: channelId })
-      if (info?.group_name) name = info.group_name
-    } catch {
-      /* ignore */
+    // 柔性尝试多种参数传递方式，记录每次调用结果以便定位 napcat/onebot 的参数格式差异
+    const argVariants = [
+      { group_id: channelId },
+      { group_id: { group_id: channelId } },
+      { group_id: Number(channelId) },
+      { group_id: { group_id: Number(channelId) } },
+    ]
+
+    for (const args of argVariants) {
+      try {
+        logger.error(`getGroupInfo 尝试 args=${JSON.stringify(args)}`)
+        const info = await session.bot.internal.getGroupInfo(args)
+        logger.error(`getGroupInfo 返回: ${JSON.stringify(info)}`)
+
+        if (!info) continue
+
+        // 支持多种返回结构：直接 group_name、data.group_name（napcat）、或嵌套情况
+        if (info.group_name) {
+          name = info.group_name
+          break
+        }
+        if (info.data && info.data.group_name) {
+          name = info.data.group_name
+          break
+        }
+        if (info.data && info.data.group && info.data.group.group_name) {
+          name = info.data.group.group_name
+          break
+        }
+
+        // 某些实现会把返回包在 ret.data 或直接在 ret
+        if (info.ret && info.ret.data && info.ret.data.group_name) {
+          name = info.ret.data.group_name
+          break
+        }
+
+        // 如果未识别结构，记录并继续尝试下一个参数形态
+        logger.error('getGroupInfo 返回了未识别结构（尝试 参数：' + JSON.stringify(args) + '）: ' + JSON.stringify(info) + ' EEE')
+      } catch (err) {
+        // 记录详细错误以便分析 retcode/args
+        try {
+          logger.error('getGroupInfo 调用失败，args=' + JSON.stringify(args) + '，错误：' + String(err) + ' EEE')
+        } catch (e) {
+          logger.error('getGroupInfo 调用失败但记录 args 时出错：' + String(e) + ' EEE')
+        }
+        // 如果错误中包含 retcode，记录方便排查
+        // 继续尝试下一个参数变体
+      }
     }
   }
 
@@ -311,28 +364,36 @@ async function ensureChannelMeta(ctx: Context, session: Session) {
 
 async function seedStatusCache(ctx: Context) {
   const binds = await ctx.database.get('steam_bind', {})
+  logger.error(`seedStatusCache: load binds count=${binds.length}`)
   if (!binds.length) return
   const steamIds = [...new Set(binds.map(b => b.steamId))]
   const summaries = await ctx.steam.getPlayerSummaries(steamIds)
+  logger.error(`seedStatusCache: fetched summaries=${summaries.length}`)
   for (const player of summaries) {
     statusCache.set(player.steamid, player)
   }
 }
 
 async function broadcast(ctx: Context, config: Config) {
-  const channels = await ctx.database.get('steam_channel', { enable: true })
+  try {
+    const channels = await ctx.database.get('steam_channel', { enable: true })
+    logger.error(`broadcast: enabled channels=${channels.length}`)
   if (channels.length === 0) return
 
-  const channelIds = channels.map(c => c.id)
+    const channelIds = channels.map(c => c.id)
   const binds = await ctx.database.get('steam_bind', { channelId: channelIds })
+    logger.error(`broadcast: binds total=${binds.length}`)
   if (binds.length === 0) return
 
   const steamIds = [...new Set(binds.map(b => b.steamId))]
-  
-  const currentSummaries = await ctx.steam.getPlayerSummaries(steamIds)
+    logger.error(`broadcast: unique steamIds=${steamIds.length}`)
+
+    const currentSummaries = await ctx.steam.getPlayerSummaries(steamIds)
+    logger.error(`broadcast: fetched summaries=${currentSummaries.length}`)
   const currentMap = new Map(currentSummaries.map(p => [p.steamid, p]))
 
   for (const channel of channels) {
+      logger.error(`broadcast: channel=${channel.id} processing`)
     const channelBinds = binds.filter(b => b.channelId === channel.id)
     const msgs: string[] = []
     const startGamingPlayers: any[] = []
@@ -360,6 +421,7 @@ async function broadcast(ctx: Context, config: Config) {
     }
 
     if (msgs.length > 0) {
+          logger.error(`broadcast: channel=${channel.id} msgs=${msgs.length}`)
       const botKey = channel.platform && channel.assignee ? `${channel.platform}:${channel.assignee}` : undefined
       const bot = botKey ? ctx.bots[botKey] : Object.values(ctx.bots)[0]
         if (!bot) continue
@@ -388,4 +450,7 @@ async function broadcast(ctx: Context, config: Config) {
   for (const p of currentSummaries) {
       statusCache.set(p.steamid, p)
   }
+  } catch (err) {
+    logger.error('broadcast 发生异常：' + String(err) + ' EEE')
+  }
 }

package/src/locales/zh-CN.ts

@@ -3,10 +3,12 @@ export default {
     steam: {
       bind: {
         bind_success: '绑定成功！Steam ID: {0}',
+        already_bound: '您已经绑定过帐号了！',
         invalid_id: '请输入有效的 Steam ID。',
         id_not_found: '无法找到该 Steam ID。',
         error: '发生错误。',
         messages: {
+          already_bound: '您已经绑定过帐号了！',
           invalid_id: '请输入有效的 Steam ID。',
           id_not_found: '无法找到该 Steam ID。',
           bind_success: '绑定成功！Steam ID: {0}',

package/src/locales/zh-CN.yml

@@ -11,4 +11,24 @@ enable_success: "已开启本群播报。"
 disable_success: "已关闭本群播报。"
 args_missing: "参数缺失。"
 update_success: "更新群信息成功。"
-nickname_set: "昵称已设置为 {0}。"
+nickname_set: "昵称已设置为 {0}。"
+
+# 配置面板本地化
+fonts:
+	regular: "常规字体路径"
+	light: "细体字体路径"
+	bold: "粗体字体路径"
+
+steamDisableBroadcastOnStartup: "启动时禁用首次播报（仅预热缓存）"
+steamRequestInterval: "轮询间隔（秒）"
+steamBroadcastType: "播报类型（all/part/none）"
+
+commandAuthority:
+	bind: "绑定命令权限"
+	unbind: "解绑命令权限"
+	info: "查看资料命令权限"
+	check: "查看状态命令权限"
+	enable: "启用播报命令权限"
+	disable: "禁用播报命令权限"
+	update: "更新群信息命令权限"
+	nickname: "设置昵称命令权限"

package/src/service.ts

@@ -77,7 +77,7 @@ export class SteamService extends Service {
             break // Success for this chunk
           }
         } catch (e) {
-          this.ctx.logger('steam').warn(`API key ${key} failed: ${e}`)
+          this.ctx.logger('steam').error(`API key ${key} failed: ${e} EEE`)
         }
       }
     }