koishi-plugin-rocom 1.0.9 → 1.0.11

package/lib/commands/community.js

@@ -0,0 +1,323 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createCommunityHandlers = createCommunityHandlers;
+const koishi_1 = require("koishi");
+const logger = new koishi_1.Logger('rocom-community');
+function trimText(value) {
+    return String(value ?? '').trim();
+}
+function formatPostTime(value) {
+    const text = trimText(value);
+    if (!text)
+        return '未知时间';
+    const date = new Date(text);
+    if (Number.isNaN(date.getTime()))
+        return text;
+    const pad = (num) => String(num).padStart(2, '0');
+    return `${pad(date.getMonth() + 1)}-${pad(date.getDate())} ${pad(date.getHours())}:${pad(date.getMinutes())}`;
+}
+function pageNumber(value, defaultValue = 1) {
+    const num = Number(value);
+    if (!Number.isFinite(num) || num < 1)
+        return defaultValue;
+    return Math.min(50, Math.floor(num));
+}
+function normalizeItems(payload) {
+    if (Array.isArray(payload?.items))
+        return payload.items;
+    if (Array.isArray(payload?.posts))
+        return payload.posts;
+    if (Array.isArray(payload?.data?.items))
+        return payload.data.items;
+    return [];
+}
+function postId(item) {
+    return trimText(item?.post_id || item?.id || item?.postId);
+}
+function buildExchangeListText(data, pageNo) {
+    const items = normalizeItems(data);
+    if (!items.length)
+        return pageNo > 1 ? '该页没有更多换蛋帖了。' : '当前换蛋广场暂无帖子。';
+    const lines = ['换蛋广场'];
+    for (const [index, item] of items.entries()) {
+        const pinned = trimText(item?.pinned_until) ? '[置顶]' : '';
+        const roleId = trimText(item?.id) || '-';
+        const have = trimText(item?.have_text) || '未填写';
+        const want = trimText(item?.want_text) || '未填写';
+        const note = trimText(item?.want_note);
+        const remark = trimText(item?.remark);
+        const id = postId(item);
+        lines.push(`${index + 1}. ${pinned}[${id || roleId}] 我有：${have} -> 想要：${want}`);
+        if (note)
+            lines.push(`   补充：${note}`);
+        if (remark)
+            lines.push(`   备注：${remark}`);
+        lines.push(`   学号：${roleId} | ${formatPostTime(item?.created_at)}`);
+    }
+    const total = Number(data?.total);
+    const totalPages = Number(data?.total_pages);
+    const current = Number(data?.page_no) || pageNo;
+    if (Number.isFinite(totalPages) && totalPages > 1) {
+        lines.push(`第 ${current}/${totalPages} 页，共 ${Number.isFinite(total) ? total : items.length} 条`);
+    }
+    lines.push('翻页：换蛋广场 <页码>');
+    return lines.join('\n');
+}
+function statusLabel(value) {
+    const map = {
+        active: '生效中',
+        closed: '已关闭',
+        deleted: '已删除',
+    };
+    return map[value] || value || '未知';
+}
+function reviewLabel(value) {
+    const map = {
+        pending: '待审核',
+        manual_pending: '人工审核中',
+        approved: '已通过',
+        rejected: '已拒绝',
+    };
+    return map[value] || value || '未知';
+}
+function buildMyPostsText(data) {
+    const items = normalizeItems(data);
+    if (!items.length)
+        return '你当前没有换蛋帖。';
+    const lines = ['我的换蛋帖'];
+    for (const [index, item] of items.entries()) {
+        const have = trimText(item?.have_text) || '未填写';
+        const want = trimText(item?.want_text) || '未填写';
+        const id = postId(item);
+        lines.push(`${index + 1}. [${id || '-'}] 我有：${have} -> 想要：${want}`);
+        lines.push(`   状态：${statusLabel(item?.status)} | 审核：${reviewLabel(item?.review_status)} | ${formatPostTime(item?.created_at)}`);
+    }
+    lines.push('关闭帖子：关闭换蛋帖 <帖子ID> [traded/cancel]');
+    return lines.join('\n');
+}
+function parsePostArgs(raw) {
+    const text = trimText(raw);
+    const match = text.match(/^(\d{4,20})\s+(.+)$/);
+    if (!match) {
+        throw new Error('格式：发布换蛋帖 <学号> <我有>|<想要>|[补充]|[备注]');
+    }
+    const parts = match[2].split(/[|｜]/).map(part => trimText(part)).filter(Boolean);
+    if (parts.length < 2) {
+        throw new Error('请用 | 分隔“我有”和“想要”，例如：发布换蛋帖 470557585 雪怪果实|上岸蛙|固执|全天在线');
+    }
+    return {
+        id: match[1],
+        have_text: parts[0],
+        want_text: parts[1],
+        want_note: parts[2] || '',
+        remark: parts.slice(3).join(' | '),
+    };
+}
+function parseSubscribeFilters(raw) {
+    const filters = {};
+    const keyMap = {
+        '想要': 'want_text',
+        '我有': 'have_text',
+        '补充': 'want_note',
+        '学号': 'id',
+        '搜索': 'q',
+    };
+    for (const token of trimText(raw).split(/\s+/).filter(Boolean)) {
+        const match = token.match(/^(.+?)[:：](.+)$/);
+        if (match) {
+            const key = keyMap[trimText(match[1])] || trimText(match[1]);
+            const value = trimText(match[2]);
+            if (key && value)
+                filters[key] = value;
+            continue;
+        }
+        filters.want_text = filters.want_text ? `${filters.want_text} ${token}` : token;
+    }
+    return filters;
+}
+function buildSubscriptionsText(data) {
+    const subscriptions = Array.isArray(data?.subscriptions) ? data.subscriptions : [];
+    if (!subscriptions.length)
+        return '当前没有换蛋订阅。';
+    const lines = ['换蛋订阅列表'];
+    subscriptions.forEach((subscription, index) => {
+        const id = trimText(subscription?.subscription_id);
+        const filters = subscription?.filters && typeof subscription.filters === 'object'
+            ? Object.entries(subscription.filters).map(([key, value]) => `${key}=${value}`).join('、')
+            : '无筛选';
+        lines.push(`${index + 1}. [${id || '-'}] ${filters}`);
+        lines.push(`   状态：${subscription?.status || '未知'} | ${formatPostTime(subscription?.updated_at || subscription?.created_at)}`);
+    });
+    return lines.join('\n');
+}
+function buildEventsText(data) {
+    const items = Array.isArray(data?.items) ? data.items : [];
+    if (!items.length)
+        return `暂未拉取到新的换蛋事件。next_event_id=${data?.next_event_id ?? 0}`;
+    const lines = [`换蛋订阅事件 next_event_id=${data?.next_event_id ?? '-'}`];
+    for (const item of items) {
+        const post = item?.post || {};
+        lines.push(`[${item?.event_id ?? '-'}] ${formatPostTime(item?.created_at)} 我有：${trimText(post?.have_text) || '未填写'} -> 想要：${trimText(post?.want_text) || '未填写'}`);
+        if (post?.want_note)
+            lines.push(`   补充：${post.want_note}`);
+        if (postId(post))
+            lines.push(`   帖子ID：${postId(post)}`);
+    }
+    if (data?.has_more)
+        lines.push('还有更多事件，可继续使用 next_event_id 拉取。');
+    return lines.join('\n');
+}
+function ensureGroupAdmin(session, adminUserIds) {
+    if (!session?.guildId)
+        return '';
+    if (adminUserIds.includes(session?.userId || ''))
+        return '';
+    return '群聊中仅 Bot 管理员可以管理换蛋订阅。';
+}
+function createCommunityHandlers(deps) {
+    const { ctx, client, config } = deps;
+    const queryExchangeList = async ({ session }, page = 1) => {
+        const pageNo = pageNumber(page);
+        const data = await client.getEggExchanges(ctx, { page_no: pageNo, page_size: 10 }, session?.userId || '');
+        if (!data)
+            return `换蛋广场查询失败：${client.getLastErrorBrief()}`;
+        return buildExchangeListText(data, pageNo);
+    };
+    const postExchange = async ({ session }, args = '') => {
+        try {
+            const payload = parsePostArgs(args);
+            const data = await client.postEggExchange(ctx, payload, session?.userId || '');
+            if (!data)
+                return `发布换蛋帖失败：${client.getLastErrorBrief()}`;
+            const id = trimText(data?.post_id || data?.id || data?.post?.post_id);
+            const similarPosts = Array.isArray(data?.similar_posts) ? data.similar_posts : [];
+            const lines = [
+                '换蛋帖发布成功，帖子已进入审核。',
+                `学号：${payload.id}`,
+                `我有：${payload.have_text}`,
+                `想要：${payload.want_text}`,
+            ];
+            if (payload.want_note)
+                lines.push(`补充：${payload.want_note}`);
+            if (payload.remark)
+                lines.push(`备注：${payload.remark}`);
+            if (id)
+                lines.push(`帖子ID：${id}`);
+            if (similarPosts.length) {
+                lines.push('相似帖子：');
+                similarPosts.slice(0, 3).forEach((post) => {
+                    lines.push(`  [${postId(post) || '-'}] 我有：${trimText(post?.have_text)} -> 想要：${trimText(post?.want_text)}`);
+                });
+            }
+            return lines.join('\n');
+        }
+        catch (error) {
+            logger.warn(`发布换蛋帖失败: ${error}`);
+            return `发布换蛋帖失败：${error?.message || error}`;
+        }
+    };
+    const queryMyPosts = async ({ session }) => {
+        const data = await client.getMyEggExchanges(ctx, { page_no: 1, page_size: 20 }, session?.userId || '');
+        if (!data)
+            return `查询我的换蛋帖失败：${client.getLastErrorBrief()}`;
+        return buildMyPostsText(data);
+    };
+    const closePost = async ({ session }, postIdArg, reason = 'cancel') => {
+        const id = trimText(postIdArg);
+        if (!id)
+            return '请提供帖子 ID。用法：关闭换蛋帖 <帖子ID> [traded/cancel]';
+        const normalizedReason = reason === 'traded' ? 'traded' : 'cancel';
+        const data = await client.closeEggExchange(ctx, id, normalizedReason, session?.userId || '');
+        if (!data)
+            return `关闭换蛋帖失败：${client.getLastErrorBrief()}`;
+        return `换蛋帖 ${id} 已关闭，原因：${normalizedReason === 'traded' ? '成交关闭' : '取消关闭'}。`;
+    };
+    const reviewStatus = async ({ session }, postIdArg) => {
+        const id = trimText(postIdArg);
+        if (!id)
+            return '请提供帖子 ID。用法：换蛋审核 <帖子ID>';
+        const data = await client.getEggExchangeReviewStatus(ctx, id, session?.userId || '');
+        if (!data)
+            return `查询换蛋审核状态失败：${client.getLastErrorBrief()}`;
+        const post = data?.post || data;
+        return [
+            `帖子ID：${id}`,
+            `状态：${statusLabel(post?.status)}`,
+            `审核：${reviewLabel(post?.review_status)}`,
+            post?.review_reason ? `原因：${post.review_reason}` : '',
+        ].filter(Boolean).join('\n');
+    };
+    const subscribeEgg = async ({ session }, filtersText = '') => {
+        const adminError = ensureGroupAdmin(session, config.adminUserIds);
+        if (adminError)
+            return adminError;
+        const filters = parseSubscribeFilters(filtersText);
+        if (!Object.keys(filters).length) {
+            return '用法：订阅换蛋 想要:上岸蛙 补充:固执\n支持筛选键：想要、我有、补充、学号、搜索';
+        }
+        const data = await client.createEggExchangeSubscription(ctx, filters, session?.userId || '');
+        if (!data)
+            return `订阅换蛋失败：${client.getLastErrorBrief()}`;
+        const subscription = data?.subscription || data;
+        const id = trimText(subscription?.subscription_id);
+        const filterText = Object.entries(filters).map(([key, value]) => `${key}=${value}`).join('、');
+        return [
+            '换蛋订阅创建成功。',
+            `筛选条件：${filterText}`,
+            id ? `订阅ID：${id}` : '',
+            '可使用“换蛋事件 <订阅ID>”手动拉取新通过帖子。',
+        ].filter(Boolean).join('\n');
+    };
+    const listSubscriptions = async ({ session }) => {
+        const data = await client.getEggExchangeSubscriptions(ctx, session?.userId || '');
+        if (!data)
+            return `查询换蛋订阅失败：${client.getLastErrorBrief()}`;
+        return buildSubscriptionsText(data);
+    };
+    const unsubscribeEgg = async ({ session }, subscriptionId = '') => {
+        const adminError = ensureGroupAdmin(session, config.adminUserIds);
+        if (adminError)
+            return adminError;
+        const id = trimText(subscriptionId);
+        if (id) {
+            const ok = await client.deleteEggExchangeSubscription(ctx, id, session?.userId || '');
+            return ok ? `已取消换蛋订阅 ${id}。` : `取消换蛋订阅失败：${client.getLastErrorBrief()}`;
+        }
+        const data = await client.getEggExchangeSubscriptions(ctx, session?.userId || '');
+        if (!data)
+            return `查询换蛋订阅失败：${client.getLastErrorBrief()}`;
+        const subscriptions = Array.isArray(data?.subscriptions) ? data.subscriptions : [];
+        if (!subscriptions.length)
+            return '当前没有换蛋订阅。';
+        let deleted = 0;
+        for (const subscription of subscriptions) {
+            const subId = trimText(subscription?.subscription_id);
+            if (!subId)
+                continue;
+            const ok = await client.deleteEggExchangeSubscription(ctx, subId, session?.userId || '');
+            if (ok)
+                deleted++;
+        }
+        return deleted ? `已取消 ${deleted} 个换蛋订阅。` : '没有成功取消任何换蛋订阅。';
+    };
+    const queryEvents = async ({ session }, subscriptionId, afterEventId = '') => {
+        const id = trimText(subscriptionId);
+        if (!id)
+            return '请提供订阅 ID。用法：换蛋事件 <订阅ID> [after_event_id]';
+        const data = await client.getEggExchangeEvents(ctx, id, afterEventId, 20, session?.userId || '');
+        if (!data)
+            return `拉取换蛋事件失败：${client.getLastErrorBrief()}`;
+        return buildEventsText(data);
+    };
+    return {
+        queryExchangeList,
+        postExchange,
+        queryMyPosts,
+        closePost,
+        reviewStatus,
+        subscribeEgg,
+        listSubscriptions,
+        unsubscribeEgg,
+        queryEvents,
+    };
+}

package/lib/commands/egg.js

@@ -110,10 +110,18 @@ function register(deps) {
             let data = null;
             let fallback = '';
             if (height != null && weight != null) {
-                const backendResults = await client.queryPetSize(ctx, heightMeters ?? height / 100, weight);
-                if (backendResults) {
-                    data = eggService.buildSizeSearchDataFromApi(height, weight, backendResults, heightDisplay);
-                    fallback = eggService.buildSizeSearchTextFromApi(height, weight, backendResults, heightDisplay);
+                const heightInMeters = heightMeters ?? height / 100;
+                const eggSearchResults = await client.getEggSearch(ctx, heightInMeters, weight, 1, 20, session?.userId || '');
+                if (eggSearchResults) {
+                    data = eggService.buildEggSearchData(heightInMeters, weight, eggSearchResults, heightDisplay);
+                    fallback = eggService.buildEggSearchText(heightInMeters, weight, eggSearchResults, heightDisplay);
+                }
+                if (!data) {
+                    const backendResults = await client.queryPetSize(ctx, heightInMeters, weight, false, session?.userId || '');
+                    if (backendResults) {
+                        data = eggService.buildSizeSearchDataFromApi(height, weight, backendResults, heightDisplay);
+                        fallback = eggService.buildSizeSearchTextFromApi(height, weight, backendResults, heightDisplay);
+                    }
                 }
             }
             if (!data) {

package/lib/commands/merchant.js

@@ -158,7 +158,7 @@ async function checkMerchantSubscriptions(deps) {
     const { products, roundInfo, data, fallback } = buildMerchantRenderPayload(res);
     const productNames = products.map((p) => p.name || '').filter(Boolean);
     const rendered = await renderer.renderHtml(ctx, 'yuanxing-shangren', data);
-    const renderedPng = rendered ? (0, send_image_1.compressPngImage)(rendered, config) : null;
+    const renderedImage = rendered ? (0, send_image_1.compressPngImage)(rendered, config) : null;
     const subs = merchantSubMgr.getAll();
     let matchedCount = 0;
     let pushedCount = 0;
@@ -195,7 +195,7 @@ async function checkMerchantSubscriptions(deps) {
             channelId,
             guildId: sub.group_id || '',
             userId: sub.user_id || '',
-        }, renderedPng, fallbackText, !!sub.mention_all);
+        }, renderedImage, fallbackText, !!sub.mention_all);
         if (!sent)
             continue;
         pushedCount++;
@@ -271,8 +271,24 @@ function register(deps) {
         return `远行商人订阅检查完成：订阅 ${result.subscriptions} 条，命中 ${result.matched} 条，推送 ${result.pushed} 条。`;
     });
     if (config.merchantSubscriptionEnabled) {
-        ctx.setInterval(async () => {
-            await checkMerchantSubscriptions(deps);
-        }, config.merchantCheckInterval);
+        if (config.merchantCheckMode === 'times' && config.merchantCheckTimes.length > 0) {
+            let lastMerchantCheckKey = '';
+            ctx.setInterval(async () => {
+                const now = new Date();
+                const timeStr = `${String(now.getHours()).padStart(2, '0')}:${String(now.getMinutes()).padStart(2, '0')}`;
+                if (!config.merchantCheckTimes.includes(timeStr))
+                    return;
+                const checkKey = `${now.toDateString()}-${timeStr}`;
+                if (checkKey === lastMerchantCheckKey)
+                    return;
+                lastMerchantCheckKey = checkKey;
+                await checkMerchantSubscriptions(deps);
+            }, 60000);
+        }
+        else {
+            ctx.setInterval(async () => {
+                await checkMerchantSubscriptions(deps);
+            }, config.merchantCheckInterval);
+        }
     }
 }

package/lib/commands/query.js

@@ -1866,23 +1866,6 @@ function register(deps) {
             return `好友关系查询失败：${client.getLastErrorBrief()}`;
         await sendImage(deps, session, 'friendship', buildFriendshipRenderData(res, userIds), `【好友关系】${userIds}`);
     });
-    ctx.command('洛克').subcommand('.学生 [area:number] [accountType:number]', '查询学生认证状态与学生活动福利')
-        .alias('洛克学生')
-        .action(async ({ session }, area = 101, accountType = 0) => {
-        const fwToken = await (0, account_1.getPrimaryToken)(deps, session.userId);
-        if (!fwToken)
-            return (0, account_1.notLoggedInHint)();
-        const userIdentifier = session.userId;
-        const [stateRes, perksRes] = await Promise.all([
-            client.getStudentState(ctx, fwToken, accountType, userIdentifier),
-            client.getStudentPerks(ctx, fwToken, area, accountType, userIdentifier),
-        ]);
-        if (!stateRes)
-            return `学生认证状态查询失败：${client.getLastErrorBrief()}`;
-        if (!perksRes)
-            return `学生活动福利查询失败：${client.getLastErrorBrief()}`;
-        await sendImage(deps, session, 'student', buildStudentRenderData(stateRes, perksRes, area, accountType), '【洛克学生】认证与福利信息');
-    });
     ctx.command('订阅家园菜园 [uid:string]', '订阅指定 UID 的家园菜园成熟提醒')
         .action(async ({ session }, uid = '') => subscribeHome(deps, session, uid, 'garden'));
     ctx.command('订阅家园灵感 [uid:string]', '订阅指定 UID 的家园精灵灵感完成提醒')

package/lib/commands/tools.d.ts

@@ -0,0 +1,2 @@
+import { PluginDeps } from '../types';
+export declare function register(deps: PluginDeps): void;

package/lib/commands/tools.js

@@ -0,0 +1,164 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.register = register;
+const koishi_1 = require("koishi");
+const activities_service_1 = require("../activities-service");
+const send_image_1 = require("../send-image");
+const logger = new koishi_1.Logger('rocom-tools');
+const activitiesService = new activities_service_1.ActivitiesService();
+function trimText(value) {
+    return String(value ?? '').trim();
+}
+function stripHtml(value) {
+    return trimText(value)
+        .replace(/<br\s*\/?>/gi, '\n')
+        .replace(/<\/p>/gi, '\n')
+        .replace(/<[^>]+>/g, '')
+        .replace(/&nbsp;/g, ' ')
+        .replace(/&amp;/g, '&')
+        .replace(/&lt;/g, '<')
+        .replace(/&gt;/g, '>')
+        .replace(/\n{3,}/g, '\n\n')
+        .trim();
+}
+function formatDate(value) {
+    const text = trimText(value);
+    if (!text)
+        return '未知时间';
+    const numeric = Number(text);
+    const date = Number.isFinite(numeric)
+        ? new Date(numeric > 10000000000 ? numeric : numeric * 1000)
+        : new Date(text);
+    if (Number.isNaN(date.getTime()))
+        return text;
+    const pad = (num) => String(num).padStart(2, '0');
+    return `${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())} ${pad(date.getHours())}:${pad(date.getMinutes())}`;
+}
+function pageNumber(value, defaultValue = 1) {
+    const num = Number(value);
+    if (!Number.isFinite(num) || num < 1)
+        return defaultValue;
+    return Math.min(50, Math.floor(num));
+}
+function firstArray(payload, keys) {
+    if (!payload || typeof payload !== 'object')
+        return [];
+    for (const key of keys) {
+        if (Array.isArray(payload[key]))
+            return payload[key];
+    }
+    if (payload.data && typeof payload.data === 'object')
+        return firstArray(payload.data, keys);
+    return [];
+}
+function announcementId(item) {
+    return trimText(item?.thread_id || item?.id);
+}
+function buildAnnouncementListText(data, page) {
+    const list = firstArray(data, ['list', 'items']);
+    if (!list.length)
+        return page > 1 ? '该页没有更多公告。' : '当前没有公告数据。';
+    const lines = ['洛克公告'];
+    for (const [index, item] of list.entries()) {
+        const title = trimText(item?.title) || '未命名公告';
+        const summary = trimText(item?.summary);
+        const id = announcementId(item);
+        const stick = Number(item?.isStick) === 1 ? '[置顶]' : '';
+        lines.push(`${index + 1}. ${stick}${title}${id ? ` #${id}` : ''}`);
+        if (summary)
+            lines.push(`   ${summary.length > 70 ? `${summary.slice(0, 67)}...` : summary}`);
+        lines.push(`   ${formatDate(item?.publishAt || item?.published_at || item?.createdAt)}`);
+    }
+    const current = Number(data?.page) || page;
+    if (data?.has_more || data?.next_page) {
+        lines.push(`当前第 ${current} 页，下一页：洛克.公告 ${data.next_page || current + 1}`);
+    }
+    lines.push('详情：洛克.公告详情 <公告ID>');
+    return lines.join('\n');
+}
+function buildAnnouncementDetailText(data) {
+    const item = data?.detail || data?.announcement || data;
+    if (!item || typeof item !== 'object')
+        return '公告详情为空。';
+    const title = trimText(item?.title) || '未命名公告';
+    const id = announcementId(item);
+    const summary = trimText(item?.summary);
+    const content = stripHtml(item?.content?.text || item?.text || item?.content);
+    const lines = [
+        `公告详情${id ? ` #${id}` : ''}`,
+        title,
+        `发布时间：${formatDate(item?.publishAt || item?.published_at || item?.createdAt)}`,
+    ];
+    if (summary)
+        lines.push(`摘要：${summary}`);
+    if (content) {
+        lines.push('');
+        lines.push(content.length > 900 ? `${content.slice(0, 900)}...` : content);
+    }
+    const images = Array.isArray(item?.content?.indexes)
+        ? item.content.indexes.flatMap((entry) => Array.isArray(entry?.imageUrl) ? entry.imageUrl : [])
+        : [];
+    if (images.length) {
+        lines.push('');
+        lines.push(`图片资源：${images.slice(0, 3).join('\n')}`);
+    }
+    return lines.join('\n');
+}
+function register(deps) {
+    const { ctx, client, config, renderer } = deps;
+    ctx.command('洛克').subcommand('.日历 [mode:string]', '查看洛克活动日历')
+        .alias('洛克日历')
+        .action(async ({ session }, mode = '') => {
+        const refresh = ['刷新', 'refresh', 'true', '1'].includes(String(mode || '').toLowerCase());
+        const data = await client.getActivitiesInfo(ctx, refresh, session?.userId || '');
+        if (!data)
+            return `活动日历查询失败：${client.getLastErrorBrief()}`;
+        const fallback = activitiesService.buildFallbackText(data);
+        if (!session?.send)
+            return fallback;
+        const image = await renderer.renderHtml(ctx, 'activities', activitiesService.buildRenderData(data));
+        await (0, send_image_1.sendImageWithFallback)(session, image, fallback, 'activities:calendar', config);
+    });
+    ctx.command('洛克').subcommand('.公告 [page:number]', '查看洛克公告列表')
+        .alias('洛克公告')
+        .action(async ({ session }, page = 1) => {
+        const currentPage = pageNumber(page);
+        const data = await client.getAnnouncementList(ctx, { category_id: 99, page: currentPage, limit: 10 }, session?.userId || '');
+        if (!data)
+            return `公告列表查询失败：${client.getLastErrorBrief()}`;
+        return buildAnnouncementListText(data, currentPage);
+    });
+    ctx.command('洛克').subcommand('.最新公告', '查看最新洛克公告')
+        .alias('洛克最新公告')
+        .action(async ({ session }) => {
+        const data = await client.getLatestAnnouncement(ctx, { category_id: 99 }, session?.userId || '');
+        if (!data)
+            return `最新公告查询失败：${client.getLastErrorBrief()}`;
+        return buildAnnouncementDetailText(data);
+    });
+    ctx.command('洛克').subcommand('.公告详情 <threadId:string>', '查看公告详情')
+        .alias('洛克公告详情')
+        .action(async ({ session }, threadId) => {
+        const id = trimText(threadId);
+        if (!/^\d+$/.test(id))
+            return '请提供公告 ID。用法：洛克.公告详情 <公告ID>';
+        const data = await client.getAnnouncementDetail(ctx, id, session?.userId || '');
+        if (!data)
+            return `公告详情查询失败：${client.getLastErrorBrief()}`;
+        return buildAnnouncementDetailText(data);
+    });
+    ctx.command('洛克').subcommand('.同步配置', '手动同步 RoCom 远端配置')
+        .alias('洛克同步配置')
+        .action(async ({ session }) => {
+        if (!config.adminUserIds.includes(session?.userId || ''))
+            return '此指令仅限管理员使用。';
+        const data = await client.syncConfig(ctx, session?.userId || '');
+        if (!data)
+            return `同步配置失败：${client.getLastErrorBrief()}`;
+        logger.info(`manual config sync requested by ${session?.userId || 'unknown'}`);
+        const skipped = Array.isArray(data?.skipped_resources) ? data.skipped_resources.length : 0;
+        return skipped
+            ? `配置同步完成，但有 ${skipped} 个资源跳过。`
+            : '配置同步完成。';
+    });
+}

package/lib/egg-service.d.ts

@@ -27,6 +27,8 @@ export declare class EggService {
     private rangeMatchScore;
     private formatPetCard;
     private formatSizeApiCard;
+    private formatEggSearchCard;
+    private formatEggSearchTextLine;
     private mergeCardsByName;
     private mergeSizeCard;
     private minValue;
@@ -47,6 +49,7 @@ export declare class EggService {
         range: any[];
     }, heightDisplay?: string): string;
     buildSizeSearchTextFromApi(height?: number, weight?: number, results?: any, heightDisplay?: string): string;
+    buildEggSearchText(heightMeters?: number, weight?: number, results?: any, heightDisplay?: string): string;
     buildSearchText(pet: any): string;
     buildCandidatesText(keyword: string, candidates: any[]): string;
     buildWantPetText(pet: any): string;
@@ -225,5 +228,14 @@ export declare class EggService {
         commandHint: string;
         copyright: string;
     };
+    buildEggSearchData(heightMeters?: number, weight?: number, results?: any, heightDisplay?: string): {
+        query_label: string;
+        perfect_matches: any;
+        range_matches: any[];
+        total_count: any;
+        has_results: boolean;
+        commandHint: string;
+        copyright: string;
+    };
     private buildEggDetails;
 }