koishi-plugin-rocom 1.0.18 → 1.0.24

package/lib/commands/query.js

@@ -3,69 +3,25 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractHomeEggStatus = extractHomeEggStatus;
 exports.register = register;
 const koishi_1 = require("koishi");
 const account_1 = require("./account");
 const send_image_1 = require("../send-image");
 const subscription_send_1 = require("../subscription-send");
 const pet_data_service_1 = require("../pet-data-service");
+const player_service_1 = require("../player-service");
+const merchant_service_1 = require("../merchant-service");
+const permissions_1 = require("../permissions");
+const render_1 = require("../render");
+const subscription_runner_1 = require("../subscription-runner");
 const node_fs_1 = __importDefault(require("node:fs"));
 const node_path_1 = __importDefault(require("node:path"));
 const logger = new koishi_1.Logger('rocom-query');
-async function sendImage(deps, session, templateName, data, fallback) {
-    const png = await deps.renderer.renderHtml(deps.ctx, templateName, data);
+async function sendImage(deps, session, templateName, data, fallback, options) {
+    const png = await deps.renderer.renderPages(deps.ctx, templateName, data, options);
     await (0, send_image_1.sendImageWithFallback)(session, png, fallback, `query:${templateName}`, deps.config);
 }
-function cleanPlayerFieldValue(field, value) {
-    const text = String(value ?? '').trim().replace(/^'+|'+$/g, '');
-    if (!text || ['<0B>', '<0b>', '<0B >', '<0b >'].includes(text))
-        return '未设置';
-    if (['is_online', 'online', 'chat_top_unlock', 'is_friend', 'is_black', 'is_black_role', 'is_chat_node_unlock'].includes(field)) {
-        return ['1', 'true', 'True', '是'].includes(text) ? '是' : '否';
-    }
-    if (['sex', 'gender'].includes(field)) {
-        return { '0': '未知', '1': '男', '2': '女' }[text] || text;
-    }
-    if (field === 'friend_type') {
-        return { '0': '默认', '1': '特殊' }[text] || text;
-    }
-    if (field === 'battle_state') {
-        return { '0': '空闲', '1': '对战中' }[text] || text;
-    }
-    return text;
-}
-function parseIngamePlayerPayload(payload, uid) {
-    const rows = payload?.rows || [];
-    const rowMap = {};
-    const labelMap = {};
-    for (const row of rows) {
-        const field = String(row.field || '');
-        if (!field)
-            continue;
-        rowMap[field] = String(row.value ?? '');
-        labelMap[field] = String(row.label || field);
-    }
-    const playerUid = cleanPlayerFieldValue('uin', rowMap.uin || uid);
-    const signature = cleanPlayerFieldValue('signature', rowMap.signature || '');
-    return {
-        title: String(payload?.title || '玩家搜索'),
-        nickname: cleanPlayerFieldValue('name', rowMap.name || '-'),
-        uid: playerUid,
-        level: cleanPlayerFieldValue('level', rowMap.level || '-'),
-        signature: signature === '未设置' ? '' : signature,
-        rowMap,
-        labelMap,
-    };
-}
-function playerField(parsed, field, defaultValue = '未设置') {
-    if (!parsed)
-        return defaultValue;
-    const raw = parsed.rowMap[field];
-    if (raw == null || raw === '')
-        return defaultValue;
-    const value = cleanPlayerFieldValue(field, raw);
-    return value && value !== '-' && value !== '未设置' ? value : defaultValue;
-}
 function tryParseJson(text) {
     try {
         return JSON.parse(text);
@@ -876,7 +832,7 @@ function extractHomePet(deps, raw, index, guard = false) {
     const feedRound = Number(homePet.feed_round || raw.feed_round || 0) || 0;
     const gender = Number(display.gender || raw.gender || 0) || 0;
     let mutationType = Number(display.mutation_type || raw.mutation_type || homePet.mutation_type || 0) || 0;
-    // 上游 v3.4.0：mutation_type 缺失时按 real_speciality_ids 识别变体（103=异色、502=炫彩、两者兼有=异色炫彩）。
+    // mutation_type 缺失时按 real_speciality_ids 识别变体（103=异色、502=炫彩、两者兼有=异色炫彩）。
     if (!mutationType) {
         const specialityValues = [];
         for (const value of [homePet.real_speciality_ids, raw.real_speciality_ids, homePet.speciality_id, raw.speciality_id]) {
@@ -1112,8 +1068,8 @@ function buildHomeRenderData(deps, res, uid) {
         updatedAt: new Date(createdAt ? createdAt * 1000 : Date.now()).toLocaleString('zh-CN'),
     };
 }
-function buildPlayerSearchRenderData(payload, uid) {
-    const parsed = parseIngamePlayerPayload(payload, uid);
+function buildPlayerSearchRenderData(payload, uid, cardImageUrl = '') {
+    const parsed = (0, player_service_1.parseIngamePlayerPayload)(payload, uid);
     const pack = (title, pairs) => {
         const items = pairs
             .filter(([, value]) => value && value !== '-' && value !== '未设置')
@@ -1123,27 +1079,27 @@ function buildPlayerSearchRenderData(payload, uid) {
     const sections = [
         pack('核心档案', [
             ['等级', parsed.level],
-            ['在线状态', playerField(parsed, 'online', playerField(parsed, 'is_online'))],
-            ['性别', playerField(parsed, 'gender', playerField(parsed, 'sex'))],
-            ['世界等级', playerField(parsed, 'world_level')],
-            ['图鉴收集', playerField(parsed, 'card_handbook_collect_num')],
-            ['最后离线', playerField(parsed, 'last_logout_time')],
+            ['在线状态', (0, player_service_1.playerField)(parsed, 'online', (0, player_service_1.playerField)(parsed, 'is_online'))],
+            ['性别', (0, player_service_1.playerField)(parsed, 'gender', (0, player_service_1.playerField)(parsed, 'sex'))],
+            ['世界等级', (0, player_service_1.playerField)(parsed, 'world_level')],
+            ['图鉴收集', (0, player_service_1.playerField)(parsed, 'card_handbook_collect_num')],
+            ['最后离线', (0, player_service_1.playerField)(parsed, 'last_logout_time')],
         ]),
         pack('家园信息', [
-            ['家园名称', playerField(parsed, 'home_name')],
-            ['家园等级', playerField(parsed, 'home_level')],
-            ['家园经验', playerField(parsed, 'home_experience')],
-            ['舒适度', playerField(parsed, 'home_comfort_level')],
-            ['访客数量', playerField(parsed, 'visitor_num')],
+            ['家园名称', (0, player_service_1.playerField)(parsed, 'home_name')],
+            ['家园等级', (0, player_service_1.playerField)(parsed, 'home_level')],
+            ['家园经验', (0, player_service_1.playerField)(parsed, 'home_experience')],
+            ['舒适度', (0, player_service_1.playerField)(parsed, 'home_comfort_level')],
+            ['访客数量', (0, player_service_1.playerField)(parsed, 'visitor_num')],
         ]),
     ].filter(Boolean);
     const summaryCards = [
         { label: '等级', value: parsed.level },
-        { label: '在线状态', value: playerField(parsed, 'online', playerField(parsed, 'is_online')) },
-        { label: '世界等级', value: playerField(parsed, 'world_level') },
-        { label: '图鉴收集', value: playerField(parsed, 'card_handbook_collect_num') },
-        { label: '家园等级', value: playerField(parsed, 'home_level') },
-        { label: '舒适度', value: playerField(parsed, 'home_comfort_level') },
+        { label: '在线状态', value: (0, player_service_1.playerField)(parsed, 'online', (0, player_service_1.playerField)(parsed, 'is_online')) },
+        { label: '世界等级', value: (0, player_service_1.playerField)(parsed, 'world_level') },
+        { label: '图鉴收集', value: (0, player_service_1.playerField)(parsed, 'card_handbook_collect_num') },
+        { label: '家园等级', value: (0, player_service_1.playerField)(parsed, 'home_level') },
+        { label: '舒适度', value: (0, player_service_1.playerField)(parsed, 'home_comfort_level') },
     ].filter(item => item.value && item.value !== '-');
     const signature = parsed.signature && parsed.signature !== '未设置' ? parsed.signature : '';
     return {
@@ -1155,15 +1111,38 @@ function buildPlayerSearchRenderData(payload, uid) {
         signature,
         showSignature: Boolean(signature),
         sections,
-        commandHint: '洛克.玩家 <UID>',
+        cardImageUrl: cardImageUrl || '',
+        collectedShining: (0, player_service_1.playerField)(parsed, 'collected_shining_pet_count', '未知'),
+        collectedGlass: (0, player_service_1.playerField)(parsed, 'collected_glass_pet_count', '未知'),
+        commandHint: '洛克.玩家 [UID]',
         copyright: 'Koishi & WeGame Locke Kingdom Plugin',
     };
 }
-function buildShopRenderData(payload, shopId) {
+function buildShopRenderData(payload, shopId, options = {}) {
     const sections = [];
     const detailItems = [];
     const summaryCards = [{ label: '商店 ID', value: shopId }];
-    if (Array.isArray(payload?.rows)) {
+    const shop = payload?.shop || {};
+    if (Array.isArray(payload?.goods)) {
+        const items = (0, merchant_service_1.normalizeLiveMerchant)(payload, Date.now(), { assetBaseUrl: options.assetBaseUrl });
+        summaryCards.push({ label: '商品数量', value: String(items.length) });
+        const shopName = String(shop.name || shop.title || '').trim();
+        if (shopName)
+            summaryCards.push({ label: '商店名称', value: shopName });
+        sections.push({
+            title: '商品列表',
+            cards: items.map((item) => ({
+                title: item.name,
+                image: item.icon,
+                meta: [
+                    item.price !== null ? { label: '价格', value: String(item.price) } : null,
+                    item.limit !== null ? { label: '限购', value: String(item.limit) } : null,
+                    item.active ? null : { label: '状态', value: '非在售' },
+                ].filter(Boolean),
+            })),
+        });
+    }
+    else if (Array.isArray(payload?.rows)) {
         detailItems.push(...payload.rows.filter((row) => Number(row.level || 0) === 0).map((row) => ({
             label: row.label || row.field || '-',
             value: stringifyInspectValue(row.value),
@@ -1171,6 +1150,8 @@ function buildShopRenderData(payload, shopId) {
     }
     else {
         for (const [key, value] of Object.entries(payload || {})) {
+            if (['_source', 'goods', 'shop', 'meta', '_goods_mapping', 'goods_mapping'].includes(key))
+                continue;
             if (Array.isArray(value)) {
                 summaryCards.push({ label: key, value: String(value.length) });
                 sections.push({
@@ -1194,12 +1175,12 @@ function buildShopRenderData(payload, shopId) {
         title: '洛克商店',
         subtitle: `shop_id = ${shopId}`,
         heroTitle: '商店查询',
-        heroValue: detailItems.find(item => ['name', 'title', '名称', '标题'].includes(item.label))?.value || shopId,
+        heroValue: String(shop.name || shop.title || '') || detailItems.find(item => ['name', 'title', '名称', '标题'].includes(item.label))?.value || shopId,
         heroSubvalue: `shop_id = ${shopId}`,
         summaryCards: summaryCards.slice(0, 3),
         sections,
         detailItems: detailItems.slice(0, 18),
-        commandHint: '洛克.商店 <shop_id>',
+        commandHint: '洛克.商店 [shop_id]',
         copyright: 'Koishi & WeGame Locke Kingdom Plugin',
     };
 }
@@ -1274,7 +1255,7 @@ function sessionTarget(session) {
     return {
         platform: session?.platform || session?.bot?.platform || '',
         channelId: session?.channelId || session?.guildId || '',
-        userId: session?.guildId ? '' : (session?.userId || ''),
+        userId: (0, permissions_1.isDirectSession)(session) ? (session?.userId || '') : '',
     };
 }
 function homeSubscriptionKey(session, uid, kind) {
@@ -1284,6 +1265,9 @@ function homeSubscriptionKey(session, uid, kind) {
 function isBotAdmin(session, adminUserIds) {
     return adminUserIds.includes(session?.userId || '');
 }
+function canManageGroupSubscription(deps, session) {
+    return (0, permissions_1.canManageSubscription)(deps.config, session);
+}
 async function resolveHomeUid(deps, session, uid = '') {
     const targetUid = String(uid || '').trim();
     if (targetUid)
@@ -1310,27 +1294,297 @@ const HOME_SUB_TEXT = {
         needUidHint: '请提供玩家 UID，或先完成绑定后再订阅家园生蛋。',
     },
 };
-async function subscribeHome(deps, session, uid, kind) {
+async function subscribeHome(deps, session, uid, kind, mentionAll = null) {
     const target = sessionTarget(session);
-    if (!target.userId && !isBotAdmin(session, deps.config.adminUserIds))
-        return '此指令仅限管理员使用。';
+    if (!target.userId && !canManageGroupSubscription(deps, session))
+        return '此指令仅限群管理员或机器人管理员使用。';
     const targetUid = await resolveHomeUid(deps, session, uid);
     if (!targetUid)
         return HOME_SUB_TEXT[kind].needUidHint;
     const key = homeSubscriptionKey(session, targetUid, kind);
+    const own = deps.userMgr.getUserBindings(session?.userId || '').find(binding => binding.role_id === targetUid);
+    const existing = deps.homeSubMgr.getAll()[key];
     deps.homeSubMgr.upsert(key, {
         key,
         kind,
         uid: targetUid,
+        notify_user_id: own ? session.userId : '',
+        nickname: own?.nickname || '',
         platform: target.platform,
+        self_id: session?.selfId || session?.bot?.selfId || '',
         channel_id: target.channelId,
         guild_id: session?.guildId || '',
         user_id: target.userId,
         updated_by: session?.userId || '',
-        notify_state: {},
+        // 群订阅支持命中后 @全体；未显式指定时沿用上次设置。
+        mention_all: target.userId ? false : (mentionAll ?? existing?.mention_all ?? false),
+        notify_state: existing?.notify_state || {},
         updated_at: Math.floor(Date.now() / 1000),
     });
-    return `已订阅 UID ${targetUid} ${HOME_SUB_TEXT[kind].subscribedHint}`;
+    const finalMentionAll = target.userId ? false : (mentionAll ?? existing?.mention_all ?? false);
+    const mentionHint = target.userId ? '' : (finalMentionAll ? '命中后会尝试 @全体。' : '命中后不会 @全体。');
+    return [`已订阅 UID ${targetUid} ${HOME_SUB_TEXT[kind].subscribedHint}`, mentionHint].filter(Boolean).join('');
+}
+// 订阅家园 的 @全体 写法与 UID 解析。
+const HOME_MENTION_ALL_ALIASES = new Set(['@全体', '全体', '@所有人', 'at全体', 'at所有人']);
+function parseHomeSubscribeArgs(args) {
+    const tokens = String(args || '').split(/\s+/).filter(Boolean);
+    let mentionAll = null;
+    const uids = [];
+    for (const token of tokens) {
+        if (HOME_MENTION_ALL_ALIASES.has(token.toLowerCase())) {
+            mentionAll = true;
+            continue;
+        }
+        uids.push(token);
+    }
+    return { mentionAll, uid: uids[0] || '' };
+}
+function pickEggStatusPayload(payload) {
+    const candidates = [payload?.data, payload?.result, payload?.data?.data, payload?.result?.data, payload];
+    for (const candidate of candidates) {
+        if (candidate && typeof candidate === 'object' && !Array.isArray(candidate))
+            return candidate;
+    }
+    return {};
+}
+function extractHomeEggPet(item, nowTs) {
+    const petInfo = item?.home_pet_info && typeof item.home_pet_info === 'object' ? item.home_pet_info : item;
+    const petId = petInfo?.pet_cfg_id || petInfo?.pet_id || item?.pet_cfg_id || item?.pet_id;
+    const name = String(petInfo?.name || petInfo?.pet_name || item?.name || item?.pet_name || '').trim();
+    if (!Number(petId) && !name)
+        return null;
+    const hasEgg = Boolean(item?.have_egg ?? petInfo?.have_egg);
+    const predictedEggTime = normalizeEpochSeconds(item?.predicted_egg_time ?? petInfo?.predicted_egg_time ?? item?.egg_ready_time);
+    const ready = hasEgg || (predictedEggTime > 0 && nowTs >= predictedEggTime);
+    const remaining = ready ? '' : (predictedEggTime > 0 ? formatEggRemaining(predictedEggTime, nowTs) : '未知');
+    return {
+        petId: String(petId || ''),
+        name: name || `精灵 ${petId || ''}`,
+        ready,
+        remaining,
+        predictedEggTime,
+        hasEgg,
+    };
+}
+/**
+ * 从 home/eggs 轻量接口响应中提取蛋状态。
+ * 接口仍在开发中，这里对多种可能的字段名做兼容。
+ */
+function extractHomeEggStatus(payload) {
+    const data = pickEggStatusPayload(payload);
+    const nowTs = Math.floor(Date.now() / 1000);
+    const eggLists = [
+        data?.eggs,
+        data?.egg_list,
+        data?.egg_info,
+        data?.home_eggs,
+        data?.home_egg_list,
+        data?.home_pets,
+        data?.pet_list,
+    ].filter(Array.isArray);
+    const pets = [];
+    for (const list of eggLists) {
+        for (const item of list) {
+            const pet = extractHomeEggPet(item, nowTs);
+            if (pet)
+                pets.push(pet);
+        }
+    }
+    const readyCount = pets.length > 0
+        ? pets.filter(pet => pet.ready).length
+        : Number(data?.ready_egg_count ?? data?.readyEggCount ?? data?.egg_ready_count ?? 0) || 0;
+    const totalEggs = pets.length > 0
+        ? pets.length
+        : Number(data?.total_egg_count ?? data?.totalEggCount ?? data?.egg_count ?? 0) || 0;
+    return { readyCount, totalEggs, pets };
+}
+// 与全量家园信息的蛋状态口径一致：只统计参与生蛋的精灵（有蛋或已排期）。
+function homeEggSubscriptionState(payload) {
+    const status = extractHomeEggStatus(payload);
+    const items = status.pets.filter(pet => pet.hasEgg || pet.predictedEggTime > 0);
+    const readyItems = items.filter(pet => pet.ready);
+    return { items, readyItems, names: readyItems.map(pet => pet.name) };
+}
+function buildHomeEggStatusText(uid, status) {
+    const lines = [
+        `家园蛋状态 - UID ${uid}`,
+        `可收蛋精灵：${status.readyCount} 只 / 共检测 ${status.totalEggs} 只`,
+    ];
+    const tracked = status.pets.filter(pet => pet.hasEgg || pet.predictedEggTime > 0);
+    if (tracked.length > 0) {
+        lines.push('');
+        for (const pet of tracked.slice(0, 30)) {
+            lines.push(`${pet.name}  ${pet.ready ? '✅ 可收蛋' : `⏳ ${pet.remaining}`}`);
+        }
+        if (tracked.length > 30)
+            lines.push(`…等共 ${tracked.length} 只`);
+    }
+    lines.push('');
+    lines.push(`更新时间：${new Date().toLocaleString('zh-CN', { timeZone: 'Asia/Shanghai' })}`);
+    return lines.join('\n');
+}
+// 家园精灵一览（home/pet-data），汇总体重、声音、变异与生蛋状态。
+function collectHomePetsViewSources(homeInfo, payload) {
+    const containers = [homeInfo?.friend_cell_home_brief_info, homeCellInfo(homeInfo), homeInfo?.cell_info, homeInfo, payload?.friend_cell_home_brief_info];
+    const result = [];
+    const seen = new Set();
+    for (const container of containers) {
+        if (!container || typeof container !== 'object' || !Array.isArray(container.home_pets))
+            continue;
+        for (const item of container.home_pets) {
+            const info = item?.home_pet_info && typeof item.home_pet_info === 'object' ? item.home_pet_info : item;
+            const key = String(info?.pet_gid || info?.furniture_guid || `${info?.pet_cfg_id || ''}:${info?.name || ''}`);
+            if (key && seen.has(key))
+                continue;
+            if (key)
+                seen.add(key);
+            result.push(item);
+        }
+    }
+    return result;
+}
+function homePetsViewPetFromNpc(raw) {
+    const npcPet = raw?.npc_pet && typeof raw.npc_pet === 'object' ? raw.npc_pet : {};
+    const pet = npcPet?.pet && typeof npcPet.pet === 'object' ? npcPet.pet : (raw?.pet && typeof raw.pet === 'object' ? raw.pet : raw?.display_info);
+    const petId = raw?.pet_cfg_id || raw?.pet_id || pet?.base_conf_id || pet?.pet_id || pet?.id;
+    return {
+        home_pet_info: {
+            pet_gid: raw?.pet_gid || pet?.pet_gid,
+            npc_id: raw?.npc_id || raw?.npcId,
+            pet_cfg_id: petId,
+            furniture_guid: raw?.furniture_guid,
+            name: raw?.name || pet?.name,
+            speciality_id: raw?.speciality_id || pet?.speciality_id,
+            real_speciality_ids: raw?.real_speciality_ids || pet?.real_speciality_ids || [],
+            status: raw?.status,
+        },
+        display_info: pet,
+    };
+}
+function isHomePetsViewGuard(homePetInfo, displayInfo, pet) {
+    const status = String(homePetInfo?.status ?? pet?.status ?? displayInfo?.status ?? '').toLowerCase();
+    const zeroCfgWithName = String(homePetInfo?.pet_cfg_id || '0') === '0'
+        && Boolean(String(homePetInfo?.name || homePetInfo?.pet_name || '').trim());
+    return zeroCfgWithName
+        || Boolean(homePetInfo?.is_guard || homePetInfo?.guard || pet?.is_guard || pet?.guard || displayInfo?.is_guard || displayInfo?.guard)
+        || status === '2' || status === 'guard';
+}
+// ingame 数据体重可能以克或千克记录：大数值按克换算成千克展示。
+function homePetsWeightText(value) {
+    const num = Number(value);
+    if (!Number.isFinite(num) || num <= 0)
+        return '--';
+    const kg = num >= 1000 ? num / 1000 : num;
+    const text = kg.toFixed(2).replace(/0+$/, '').replace(/\.$/, '');
+    return `${text}kg`;
+}
+function buildHomePetsViewData(deps, res, uid) {
+    const raw = res || {};
+    const payload = raw.result && typeof raw.result === 'object' ? raw.result : raw;
+    const homeInfo = homeInfoPayload(raw);
+    const homePets = collectHomePetsViewSources(homeInfo, payload);
+    const npcPets = Array.isArray(payload.npc_pets) ? payload.npc_pets : [];
+    const npcMap = new Map();
+    for (const entry of npcPets) {
+        const npcPet = entry?.npc_pet && typeof entry.npc_pet === 'object' ? entry.npc_pet : {};
+        const pet = npcPet?.pet && typeof npcPet.pet === 'object' ? npcPet.pet : entry?.pet;
+        const gid = String(entry?.pet_gid || entry?.petGid || npcPet?.pet_gid || pet?.pet_gid || '').trim();
+        if (gid)
+            npcMap.set(gid, entry);
+    }
+    const nowTs = Math.floor(Date.now() / 1000);
+    const petSources = homePets.length > 0 ? homePets : npcPets.map(entry => homePetsViewPetFromNpc(entry));
+    const pets = [];
+    for (const hp of petSources) {
+        const homePetInfo = hp?.home_pet_info && typeof hp.home_pet_info === 'object' ? hp.home_pet_info : hp;
+        const displayInfo = hp?.display_info && typeof hp.display_info === 'object' ? hp.display_info : {};
+        const petGid = String(homePetInfo?.pet_gid || displayInfo?.pet_gid || '').trim();
+        const npcRaw = npcMap.get(petGid) || {};
+        const npcPetObj = npcRaw?.npc_pet && typeof npcRaw.npc_pet === 'object' ? npcRaw.npc_pet : {};
+        const npcFullPet = npcPetObj?.pet && typeof npcPetObj.pet === 'object' ? npcPetObj.pet
+            : (npcRaw?.pet && typeof npcRaw.pet === 'object' ? npcRaw.pet : npcRaw?.display_info);
+        const npcStatus = String(npcRaw?.status || '');
+        const hasFull = npcFullPet && typeof npcFullPet === 'object' && Object.keys(npcFullPet).length > 0 && npcStatus !== 'error';
+        const pet = hasFull ? npcFullPet : displayInfo;
+        const petId = pet?.base_conf_id || pet?.pet_id || pet?.id || displayInfo?.base_conf_id || homePetInfo?.pet_cfg_id;
+        if (isHomePetsViewGuard(homePetInfo, displayInfo, pet) || !Number(petId))
+            continue;
+        const name = String(pet?.name || homePetInfo?.name || homePetInfo?.pet_name || `精灵 ${petId}`).trim();
+        const gender = Number(pet?.gender ?? displayInfo?.gender ?? 0) || 0;
+        const genderText = gender === 1 ? '♂ 雄性' : gender === 2 ? '♀ 雌性' : '未知';
+        let mutationType = Number(pet?.mutation_type ?? displayInfo?.mutation_type ?? 0) || 0;
+        if (!mutationType) {
+            // 与 extractHomePet 相同的变体兜底（real_speciality_ids 103=异色、502=炫彩）。
+            const specialityValues = [];
+            for (const value of [homePetInfo.real_speciality_ids, npcRaw.real_speciality_ids, homePetInfo.speciality_id, npcRaw.speciality_id]) {
+                if (Array.isArray(value))
+                    specialityValues.push(...value);
+                else if (value !== undefined && value !== null && value !== '')
+                    specialityValues.push(value);
+            }
+            const specialityIds = new Set(specialityValues.map(value => String(value).trim()).filter(Boolean));
+            if (specialityIds.has('103') && specialityIds.has('502'))
+                mutationType = 9;
+            else if (specialityIds.has('103'))
+                mutationType = 1;
+            else if (specialityIds.has('502'))
+                mutationType = 8;
+        }
+        const variantText = String(pet?.mutation_name || displayInfo?.mutation_name || '')
+            || (mutationType === 9 ? '异色炫彩' : mutationType === 1 ? '异色' : mutationType === 8 ? '炫彩' : '');
+        const hasEgg = Boolean(hp?.have_egg ?? pet?.have_egg);
+        const predictedEggTime = normalizeEpochSeconds(hp?.predicted_egg_time ?? pet?.predicted_egg_time);
+        const eggReady = hasEgg || (predictedEggTime > 0 && nowTs >= predictedEggTime);
+        const eggText = eggReady ? '可收蛋' : (predictedEggTime > 0 ? `${formatEggRemaining(predictedEggTime, nowTs)}后生蛋` : '');
+        pets.push({
+            id: String(petId || ''),
+            name,
+            level: pet?.level ?? displayInfo?.level ?? homePetInfo?.level ?? '--',
+            genderText,
+            weightText: homePetsWeightText(pet?.weight ?? displayInfo?.weight ?? homePetInfo?.weight ?? pet?.pet_weight),
+            voiceText: (0, pet_data_service_1.petDataVoiceInfo)(pet?.voice ?? displayInfo?.voice).value,
+            variantText,
+            eggReady,
+            eggText,
+            iconUrl: homePetIcon(petId, pet?.pet_icon_url || displayInfo?.pet_icon_url || npcRaw?.icon_url || ''),
+            starIconUrl: [1, 8, 9].includes(mutationType)
+                ? deps.renderer.resourceUrl(`render-templates/home/img/rocomuid/star_${mutationType}.png`)
+                : '',
+        });
+    }
+    pets.sort((a, b) => (a.eggReady === b.eggReady ? 0 : (a.eggReady ? -1 : 1)));
+    const brief = homeBriefInfo(homeInfo);
+    const homeName = String(brief?.home_name || brief?.name || payload?.player_info?.name || '').trim() || '洛克玩家';
+    return {
+        title: '家园精灵',
+        homeName,
+        uid,
+        pets,
+        total: pets.length,
+        eggCount: pets.filter(pet => pet.eggReady).length,
+        emptyText: '未获取到家园精灵信息。请确认目标玩家在线、家园可访问，或稍后重试。',
+        updatedAt: new Date().toLocaleString('zh-CN', { timeZone: 'Asia/Shanghai' }),
+    };
+}
+function buildHomePetsViewText(data) {
+    const lines = [
+        `【家园精灵】UID ${data.uid}（${data.homeName}）`,
+        `共 ${data.total} 只精灵，可收蛋 ${data.eggCount} 只`,
+    ];
+    for (const pet of (data.pets || []).slice(0, 12)) {
+        const bits = [pet.name, `Lv.${pet.level}`, pet.genderText, pet.weightText, pet.voiceText];
+        if (pet.variantText)
+            bits.push(pet.variantText);
+        if (pet.eggText)
+            bits.push(pet.eggText);
+        lines.push(`- ${bits.join(' ')}`);
+    }
+    if ((data.pets || []).length > 12)
+        lines.push(`…等共 ${data.pets.length} 只`);
+    if (!data.pets?.length)
+        lines.push(data.emptyText);
+    return lines.join('\n');
 }
 function homeSubscriptionState(data, kind) {
     if (kind === 'garden') {
@@ -1359,27 +1613,55 @@ function homeSubscriptionMessage(uid, kind, level, totalCount, readyItems, names
         names.length ? `已完成：${names.slice(0, 8).join('、')}` : '',
     ].filter(Boolean).join('\n');
 }
-async function checkHomeSubscriptions(deps) {
+async function checkHomeSubscriptions(deps, signal) {
     const subs = deps.homeSubMgr.getAll();
-    const cache = new Map();
+    const fullCache = new Map();
+    const eggsCache = new Map();
+    const nowSec = Math.floor(Date.now() / 1000);
     let checkedCount = 0;
     let pushedCount = 0;
+    const fetchFull = async (uid) => {
+        if (!fullCache.has(uid)) {
+            fullCache.set(uid, await deps.client.ingameHomeInfo(deps.ctx, uid, { timeoutMs: 30000, signal }).catch(() => null));
+        }
+        return fullCache.get(uid);
+    };
     for (const [key, sub] of Object.entries(subs)) {
+        if (signal?.aborted)
+            break;
         if (!sub.uid || !['garden', 'inspiration', 'egg'].includes(sub.kind))
             continue;
         checkedCount++;
-        if (!cache.has(sub.uid)) {
-            cache.set(sub.uid, await deps.client.ingameHomeInfo(deps.ctx, sub.uid, { timeoutMs: 30000 }));
+        const modified = () => JSON.stringify(deps.homeSubMgr.getAll()[key]) !== JSON.stringify(sub);
+        let state = null;
+        if (sub.kind === 'egg') {
+            // 蛋状态订阅走轻量 home/eggs 接口，降低轮询开销。
+            if (!eggsCache.has(sub.uid)) {
+                eggsCache.set(sub.uid, await deps.client.ingameHomeEggs(deps.ctx, sub.uid, { timeoutMs: 30000, signal }).catch(() => null));
+            }
+            if (signal?.aborted)
+                break;
+            if (modified())
+                continue;
+            const payload = eggsCache.get(sub.uid);
+            if (payload)
+                state = homeEggSubscriptionState(payload);
         }
-        const res = cache.get(sub.uid);
-        if (!res)
-            continue;
-        const data = buildHomeRenderData(deps, res, sub.uid);
-        const { items, readyItems, names } = homeSubscriptionState(data, sub.kind);
+        if (!state) {
+            const res = await fetchFull(sub.uid);
+            if (signal?.aborted)
+                break;
+            if (modified())
+                continue;
+            if (!res)
+                continue;
+            state = homeSubscriptionState(buildHomeRenderData(deps, res, sub.uid), sub.kind);
+        }
+        const { items, readyItems, names } = state;
         const totalCount = items.length;
         if (totalCount <= 0)
             continue;
-        const notifyState = sub.notify_state || {};
+        const notifyState = { ...sub.notify_state };
         const pushLevels = [];
         if (!readyItems.length) {
             notifyState.first = false;
@@ -1394,18 +1676,27 @@ async function checkHomeSubscriptions(deps) {
                 notifyState.all = false;
         }
         if (!pushLevels.length) {
-            deps.homeSubMgr.upsert(key, { ...sub, notify_state: notifyState });
+            deps.homeSubMgr.upsert(key, { ...sub, notify_state: notifyState, last_check_time: nowSec });
             continue;
         }
-        const messages = pushLevels.map(level => homeSubscriptionMessage(sub.uid, sub.kind, level, totalCount, readyItems, names));
+        const owned = deps.userMgr.getUserBindings(sub.updated_by).find(binding => binding.role_id === sub.uid);
+        const label = owned?.nickname || sub.uid;
+        const notifyUser = owned && sub.notify_user_id === sub.updated_by ? sub.notify_user_id : '';
+        const messages = pushLevels.map(level => homeSubscriptionMessage(label, sub.kind, level, totalCount, readyItems, names));
         try {
+            const body = messages.join('\n\n');
+            // 群订阅 mention_all 开启时命中后 @全体。
+            const content = !sub.user_id && sub.mention_all
+                ? [(0, koishi_1.h)('at', { type: 'all' }), koishi_1.h.text('\n' + body)]
+                : (!sub.user_id && notifyUser ? [koishi_1.h.at(notifyUser), koishi_1.h.text('\n' + body)] : body);
             const sent = await (0, subscription_send_1.sendScheduledMessage)(deps.ctx, {
                 platform: sub.platform,
                 channelId: sub.channel_id || sub.guild_id || sub.user_id || '',
                 guildId: sub.guild_id || '',
                 userId: sub.user_id || '',
-            }, messages.join('\n\n'));
-            if (!sent)
+                selfId: sub.self_id || '',
+            }, content, signal);
+            if (!sent || signal?.aborted || JSON.stringify(deps.homeSubMgr.getAll()[key]) !== JSON.stringify(sub))
                 continue;
         }
         catch (e) {
@@ -1415,12 +1706,13 @@ async function checkHomeSubscriptions(deps) {
         for (const level of pushLevels)
             notifyState[level] = true;
         pushedCount += pushLevels.length;
-        deps.homeSubMgr.upsert(key, { ...sub, notify_state: notifyState, last_push_time: Math.floor(Date.now() / 1000) });
+        deps.homeSubMgr.upsert(key, { ...sub, notify_state: notifyState, last_push_time: Math.floor(Date.now() / 1000), last_check_time: nowSec });
     }
     return { subscriptions: Object.keys(subs).length, checked: checkedCount, pushed: pushedCount };
 }
 function register(deps) {
     const { ctx, client } = deps;
+    const homeRunner = (0, subscription_runner_1.createRunner)(ctx);
     ctx.command('洛克').subcommand('.档案', '查看个人档案')
         .alias('洛克档案')
         .action(async ({ session }) => {
@@ -1444,28 +1736,30 @@ function register(deps) {
         const cl = collRes || {};
         const bo = boRes || {};
         const recentBattle = blRes?.battles?.[0];
-        const playerSearchRes = role?.id ? await client.ingamePlayerSearch(ctx, String(role.id)) : null;
-        const playerSearchData = parseIngamePlayerPayload(playerSearchRes, String(role.id || ''));
+        const auth = { fwToken, userIdentifier };
+        const playerSearchRes = role?.id ? await client.ingamePlayerSearch(ctx, String(role.id), { auth }) : null;
+        const playerCardRes = role?.id ? await client.ingamePlayerCard(ctx, String(role.id), { auth }).catch(() => null) : null;
+        const playerSearchData = (0, player_service_1.parseIngamePlayerPayload)((0, player_service_1.mergePlayerPayloads)(playerSearchRes, playerCardRes), String(role.id || ''));
         const profileSignature = playerSearchData?.signature || '';
         const profileHeadTags = playerSearchData ? [
-            { label: '在线', value: playerField(playerSearchData, 'online', '未知') },
-            { label: '性别', value: playerField(playerSearchData, 'gender', playerField(playerSearchData, 'sex', '未知')) },
-            { label: '世界等级', value: playerField(playerSearchData, 'world_level') },
-            { label: '家园等级', value: playerField(playerSearchData, 'home_level') },
+            { label: '在线', value: (0, player_service_1.playerField)(playerSearchData, 'online', '未知') },
+            { label: '性别', value: (0, player_service_1.playerField)(playerSearchData, 'gender', (0, player_service_1.playerField)(playerSearchData, 'sex', '未知')) },
+            { label: '世界等级', value: (0, player_service_1.playerField)(playerSearchData, 'world_level') },
+            { label: '家园等级', value: (0, player_service_1.playerField)(playerSearchData, 'home_level') },
         ].filter((item) => item.value && item.value !== '-' && item.value !== '未设置').slice(0, 4) : [];
         const profileHomeItems = playerSearchData ? [
-            { label: '家园名称', value: playerField(playerSearchData, 'home_name') },
-            { label: '家园等级', value: playerField(playerSearchData, 'home_level') },
-            { label: '家园经验', value: playerField(playerSearchData, 'home_experience') },
-            { label: '舒适度', value: playerField(playerSearchData, 'home_comfort_level') },
-            { label: '访客数量', value: playerField(playerSearchData, 'visitor_num') },
+            { label: '家园名称', value: (0, player_service_1.playerField)(playerSearchData, 'home_name') },
+            { label: '家园等级', value: (0, player_service_1.playerField)(playerSearchData, 'home_level') },
+            { label: '家园经验', value: (0, player_service_1.playerField)(playerSearchData, 'home_experience') },
+            { label: '舒适度', value: (0, player_service_1.playerField)(playerSearchData, 'home_comfort_level') },
+            { label: '访客数量', value: (0, player_service_1.playerField)(playerSearchData, 'visitor_num') },
         ].filter((item) => item.value && item.value !== '-' && item.value !== '未设置') : [];
         const profileCardItems = playerSearchData ? [
-            { label: '名片皮肤', value: playerField(playerSearchData, 'card_skin_selected') },
-            { label: '名片头像', value: playerField(playerSearchData, 'card_icon_selected') },
+            { label: '名片皮肤', value: (0, player_service_1.playerField)(playerSearchData, 'card_skin_selected') },
+            { label: '名片头像', value: (0, player_service_1.playerField)(playerSearchData, 'card_icon_selected') },
         ].filter((item) => item.value && item.value !== '-' && item.value !== '未设置') : [];
-        const profileCardImage = playerSearchData ? playerField(playerSearchData, 'card_bussiness_card_url', '') : '';
-        const profileStatusText = playerSearchData ? playerField(playerSearchData, 'online', '未知') : '未知';
+        const profileCardImage = playerSearchData ? (0, player_service_1.resourceUrl)((0, player_service_1.playerField)(playerSearchData, 'card_bussiness_card_url', ''), deps.config.apiBaseUrl) : '';
+        const profileStatusText = playerSearchData ? (0, player_service_1.playerField)(playerSearchData, 'online', '未知') : '未知';
         const hasExtraProfileData = Boolean(profileSignature || profileHomeItems.length || profileCardItems.length || profileCardImage);
         let degraded = false;
         if (!sm) {
@@ -1579,7 +1873,7 @@ function register(deps) {
             profileStatusText,
             profileStatusClass: profileStatusText === '是' ? 'online' : 'offline',
             commandHint: '洛克.背包 <筛选> <页码> | 洛克.战绩 <页码> | 洛克 查看菜单',
-            copyright: 'AstrBot & WeGame Locke Kingdom Plugin',
+            copyright: 'Koishi & WeGame Roco Kingdom Plugin',
         };
         if (recentBattle) {
             data.hasBattleData = true;
@@ -1593,7 +1887,7 @@ function register(deps) {
                 icon: pet.pet_img_url?.replace('/image.png', '/icon.png') || '',
             }));
         }
-        const fallback = `【${role.name}的档案】Lv.${role.level} UID:${role.id}\n评分:${ev.score || '0'} 收藏:${cl.current_collection_count || 0}/${cl.total_collection_count || 0}`;
+        const fallback = `【${role.name || '洛克玩家'}的档案】Lv.${role.level || '--'} UID:${role.id || '--'}\n评分:${ev.score || '0'} 收藏:${cl.current_collection_count || 0}/${cl.total_collection_count || 0}`;
         await sendImage(deps, session, 'personal-card', data, fallback);
     });
     ctx.command('洛克').subcommand('.战绩 [page:number]', '查看对战战绩')
@@ -1633,7 +1927,7 @@ function register(deps) {
         });
         const data = {
             userAvatarDisplay: role.avatar_url || '',
-            userName: role.name,
+            userName: role.name || '洛克玩家',
             userLevel: role.level || 1,
             userUid: role.id || '',
             winRate: `${bo.win_rate || 0}%`,
@@ -1642,7 +1936,7 @@ function register(deps) {
             commandHint: '洛克.战绩 <页码>',
             copyright: 'Koishi & WeGame 洛克王国插件',
         };
-        await sendImage(deps, session, 'record', data, `【${role.name}的战绩】胜率:${bo.win_rate || 0}% 场次:${bo.total_match || 0}`);
+        await sendImage(deps, session, 'record', data, `【${role.name || '洛克玩家'}的战绩】胜率:${bo.win_rate || 0}% 场次:${bo.total_match || 0}`);
     });
     ctx.command('洛克').subcommand('.背包 [arg1:string] [arg2:string]', '查看精灵背包')
         .alias('洛克背包')
@@ -1838,15 +2132,33 @@ function register(deps) {
         };
         await sendImage(deps, session, 'exchange-hall', data, `【交换大厅】第${page}页`);
     });
-    ctx.command('洛克').subcommand('.玩家 <uid:string>', '通过 ingame 接口查询玩家基础资料')
+    ctx.command('洛克').subcommand('.玩家 [uid:string]', '通过 ingame 接口查询玩家资料')
         .alias('洛克玩家')
-        .action(async ({ session }, uid) => {
-        if (!uid)
-            return '请提供玩家 UID。用法：洛克.玩家 <UID>';
-        const res = await client.ingamePlayerSearch(ctx, uid);
-        if (!res)
+        .action(async ({ session }, uid = '') => {
+        const userId = session.userId;
+        const explicitUid = String(uid || '').trim();
+        const binding = deps.userMgr.getPrimaryBinding(userId);
+        const targetUid = explicitUid || String(binding?.role_id || '');
+        const fwToken = await (0, account_1.getPrimaryToken)(deps, userId);
+        if (!targetUid && !fwToken) {
+            return '请提供玩家 UID，或先使用“洛克.QQ登录 / 洛克.微信登录”完成绑定。用法：洛克.玩家 [UID]';
+        }
+        const auth = { fwToken, userIdentifier: userId };
+        const search = await client.ingamePlayerSearch(ctx, targetUid, { auth });
+        if (!search)
             return `玩家搜索失败：${client.getLastErrorBrief()}`;
-        await sendImage(deps, session, 'player-search', buildPlayerSearchRenderData(res, uid), `【洛克玩家】UID ${uid}`);
+        // 显式 UID 与搜索返回 UID 不一致时不合并名片，避免混用两个角色数据。
+        const returnedUid = String(search?.player_info?.uin ?? search?.player_info?.uid ?? search?.uin ?? search?.uid ?? '');
+        const uidConsistent = !explicitUid || !returnedUid || returnedUid === explicitUid;
+        let card = uidConsistent
+            ? await client.ingamePlayerCard(ctx, targetUid, { auth }).catch(() => null)
+            : null;
+        const cardUid = (0, player_service_1.playerPayloadUid)(card);
+        if (cardUid && (targetUid || returnedUid) && cardUid !== (targetUid || returnedUid))
+            card = null;
+        const view = (0, player_service_1.buildPlayerView)(search, card, targetUid, deps.config.apiBaseUrl);
+        const merged = (0, player_service_1.mergePlayerPayloads)(search, card);
+        await sendImage(deps, session, 'player-search', buildPlayerSearchRenderData(merged, targetUid || view.parsed.uid, view.cardImageUrl), (0, player_service_1.buildPlayerText)(merged, targetUid || view.parsed.uid));
     });
     ctx.command('洛克').subcommand('.家园 [uid:string]', '通过 UID 查询家园菜园、守卫和室内精灵')
         .alias('洛克家园')
@@ -1856,10 +2168,12 @@ function register(deps) {
             const binding = deps.userMgr.getPrimaryBinding(session.userId);
             targetUid = String(binding?.role_id || '');
         }
-        if (!targetUid)
+        const fwToken = await (0, account_1.getPrimaryToken)(deps, session.userId);
+        if (!targetUid && !fwToken)
             return '请提供玩家 UID，或先完成绑定后使用 洛克.家园。';
         let queuedNotified = false;
         const res = await client.ingameHomeInfo(ctx, targetUid, {
+            auth: { fwToken, userIdentifier: session.userId },
             waitMs: deps.config.homeQueryWaitMs,
             intervalMs: deps.config.homeQueryPollIntervalMs,
             timeoutMs: deps.config.homeQueryTimeoutMs,
@@ -1914,7 +2228,9 @@ function register(deps) {
             ].join('\n');
         }
         const lowBandwidth = Boolean(deps.config.lowBandwidthMode);
-        // Wiki 补全（技能详情/精灵体重范围）；低带宽模式跳过技能图标但仍取技能名。
+        // classic 样式走 pet-detail-classic 模板（立绘 + 属性表 + 技能栏），
+        // 不需要精灵体重范围（sizeLookup）。
+        const useClassic = deps.config.homeDetailUiStyle !== 'panel';
         const [optionsPayload, skillLookup, sizeLookup] = await Promise.all([
             deps.wikiService.getOptionsPayload().catch(() => ({})),
             (async () => {
@@ -1928,6 +2244,8 @@ function register(deps) {
                 return lookup;
             })(),
             (async () => {
+                if (useClassic)
+                    return {};
                 const lookup = {};
                 const ids = (0, pet_data_service_1.petDataPetIdsFromPayload)(res);
                 await Promise.all(ids.map(async (id) => {
@@ -1938,7 +2256,16 @@ function register(deps) {
                 return lookup;
             })(),
         ]);
-        const data = (0, pet_data_service_1.buildPetDataRenderData)(res, targetUid || '当前绑定', {
+        const classicData = useClassic
+            ? (0, pet_data_service_1.buildPetDetailClassicView)(res, targetUid || '当前绑定', {
+                optionsPayload,
+                skillLookup,
+                baseUrl: deps.config.apiBaseUrl.replace(/\/$/, ''),
+                loadSkillIcons: !lowBandwidth,
+                variantIconPath: mutationType => `render-templates/pet-detail-classic/texture2D/star_${mutationType}.png`,
+            })
+            : null;
+        const data = classicData || (0, pet_data_service_1.buildPetDataRenderData)(res, targetUid || '当前绑定', {
             optionsPayload,
             skillLookup,
             sizeLookup,
@@ -1947,18 +2274,94 @@ function register(deps) {
             baseUrl: deps.config.apiBaseUrl.replace(/\/$/, ''),
         });
         const fallbackLines = [
-            `家园详情 - UID ${data.uid}（${data.onlineText}）`,
-            data.notice,
+            `家园详情 - UID ${data.uid}${data.onlineText ? `（${data.onlineText}）` : ''}`,
+            data.notice || '',
         ];
         for (const pet of (data.pets || []).slice(0, 8)) {
-            fallbackLines.push(`${pet.index}. ${pet.name} Lv.${pet.level} #${pet.baseId} ${pet.variantText} 分贝 ${pet.voiceText || '--'}`);
+            const bits = [
+                pet.index ? `${pet.index}.` : '',
+                `${pet.name} Lv.${pet.level}`,
+                pet.variantText,
+                `分贝 ${pet.voiceText || '--'}`,
+            ].filter(Boolean);
+            fallbackLines.push(bits.join(' '));
         }
         if (!data.pets?.length)
             fallbackLines.push(data.emptyText);
         fallbackLines.push('');
         fallbackLines.push('若服务器带宽过小导致生成超时，请在配置项打开低带宽模式。');
         fallbackLines.push('低带宽模式开启后，家园详情将不再加载技能图标。');
-        await sendImage(deps, session, 'pet-data', data, fallbackLines.join('\n'));
+        await sendImage(deps, session, classicData ? 'pet-detail-classic' : 'pet-data', data, fallbackLines.join('\n'), {
+            ...(lowBandwidth ? render_1.lowBandwidthRenderOptions : {}),
+            timeoutMs: deps.config.renderTimeout || 30000,
+        });
+    });
+    // 家园精灵一览（home/pet-data），体重、声音、变异与生蛋状态。
+    ctx.command('洛克').subcommand('.家园精灵 [uid:string]', '查看家园精灵列表（体重、声音、生蛋状态）')
+        .alias('洛克家园精灵')
+        .alias('家园精灵')
+        .action(async ({ session }, uid = '') => {
+        let targetUid = String(uid || '').trim();
+        if (!targetUid) {
+            const binding = deps.userMgr.getPrimaryBinding(session.userId);
+            targetUid = String(binding?.role_id || '');
+        }
+        const fwToken = await (0, account_1.getPrimaryToken)(deps, session.userId);
+        if (!targetUid && !fwToken)
+            return '请提供玩家 UID，或先完成绑定后使用 洛克.家园精灵。';
+        let queuedNotified = false;
+        const res = await client.ingameHomePetData(ctx, targetUid, {
+            auth: { fwToken, userIdentifier: session.userId },
+            waitMs: deps.config.homeQueryWaitMs,
+            intervalMs: deps.config.homeQueryPollIntervalMs,
+            timeoutMs: deps.config.homeQueryTimeoutMs,
+            onQueued: async () => {
+                if (queuedNotified)
+                    return;
+                queuedNotified = true;
+                await session?.send?.(`UID ${targetUid} 的家园精灵查询已进入队列，正在等待游戏侧返回，请稍候…`);
+            },
+        });
+        if (!res) {
+            return [
+                `家园精灵查询失败：${client.getLastErrorBrief()}`,
+                '提示：该接口需要目标玩家在线，且目标家园可访问。',
+            ].join('\n');
+        }
+        const data = buildHomePetsViewData(deps, res, targetUid || '当前绑定');
+        await sendImage(deps, session, 'home-pets', data, buildHomePetsViewText(data), {
+            timeoutMs: deps.config.renderTimeout || 30000,
+        });
+    });
+    // 立即查询指定 UID 的家园蛋状态。
+    ctx.command('洛克').subcommand('.家园状态 [uid:string]', '查询家园蛋状态（可收蛋精灵与倒计时）')
+        .alias('洛克家园状态')
+        .alias('家园状态')
+        .action(async ({ session }, uid = '') => {
+        let targetUid = String(uid || '').trim();
+        if (!targetUid) {
+            const binding = deps.userMgr.getPrimaryBinding(session.userId);
+            targetUid = String(binding?.role_id || '');
+        }
+        const fwToken = await (0, account_1.getPrimaryToken)(deps, session.userId);
+        if (!targetUid && !fwToken)
+            return `请提供玩家 UID，或先完成绑定后使用 洛克.家园状态。`;
+        let queuedNotified = false;
+        const res = await client.ingameHomeEggs(ctx, targetUid, {
+            auth: { fwToken, userIdentifier: session.userId },
+            waitMs: deps.config.homeQueryWaitMs,
+            intervalMs: deps.config.homeQueryPollIntervalMs,
+            timeoutMs: deps.config.homeQueryTimeoutMs,
+            onQueued: async () => {
+                if (queuedNotified)
+                    return;
+                queuedNotified = true;
+                await session?.send?.(`UID ${targetUid} 的家园蛋状态查询已进入队列，正在等待游戏侧返回，请稍候…`);
+            },
+        });
+        if (!res)
+            return `家园蛋状态查询失败：${client.getLastErrorBrief()}`;
+        return buildHomeEggStatusText(targetUid, extractHomeEggStatus(res));
     });
     ctx.command('洛克').subcommand('.刷新面板 [uid:string]', '刷新指定 UID 的精灵面板缓存')
         .alias('洛克刷新面板')
@@ -2041,15 +2444,16 @@ function register(deps) {
         const fallback = panelPetDetailFallback(targetUid, selected, updatedAtText);
         await sendImage(deps, session, 'pet-panel-detail', data, fallback);
     });
-    ctx.command('洛克').subcommand('.商店 <shopId:string>', '通过 ingame 接口查询商店信息')
+    ctx.command('洛克').subcommand('.商店 [shopId:string]', '通过 ingame 接口查询商店信息，默认商店 3009')
         .alias('洛克商店')
-        .action(async ({ session }, shopId) => {
-        if (!shopId)
-            return '请提供商店 ID。用法：洛克.商店 <shop_id>';
-        const res = await client.ingameMerchantInfo(ctx, shopId);
+        .action(async ({ session }, shopId = '3009') => {
+        const targetShopId = String(shopId || '3009').trim() || '3009';
+        if (!/^\d+$/.test(targetShopId))
+            return '商店 ID 必须是数字。用法：洛克.商店 [shop_id]，默认 3009';
+        const res = await client.ingameMerchantInfo(ctx, targetShopId);
         if (!res)
             return `商店查询失败：${client.getLastErrorBrief()}`;
-        await sendImage(deps, session, 'ingame-shop', buildShopRenderData(res, shopId), `【洛克商店】shop_id=${shopId}`);
+        await sendImage(deps, session, 'ingame-shop', buildShopRenderData(res, targetShopId, { assetBaseUrl: client.wikiAssetBaseUrl }), `【洛克商店】shop_id=${targetShopId}`);
     });
     ctx.command('洛克').subcommand('.好友关系 <userIds:string>', '查询好友关系')
         .alias('洛克好友关系')
@@ -2064,17 +2468,51 @@ function register(deps) {
             return `好友关系查询失败：${client.getLastErrorBrief()}`;
         await sendImage(deps, session, 'friendship', buildFriendshipRenderData(res, userIds), `【好友关系】${userIds}`);
     });
-    ctx.command('订阅家园菜园 [uid:string]', '订阅指定 UID 的家园菜园成熟提醒')
-        .action(async ({ session }, uid = '') => subscribeHome(deps, session, uid, 'garden'));
-    ctx.command('订阅家园灵感 [uid:string]', '订阅指定 UID 的家园精灵灵感完成提醒')
-        .action(async ({ session }, uid = '') => subscribeHome(deps, session, uid, 'inspiration'));
-    ctx.command('订阅家园生蛋 [uid:string]', '订阅指定 UID 的家园精灵生蛋提醒')
-        .action(async ({ session }, uid = '') => subscribeHome(deps, session, uid, 'egg'));
+    ctx.command('订阅家园菜园 [args:text]', '订阅指定 UID 的家园菜园成熟提醒')
+        .userFields(['authority'])
+        .action(async ({ session }, args = '') => {
+        const parsed = parseHomeSubscribeArgs(args);
+        return subscribeHome(deps, session, parsed.uid, 'garden', parsed.mentionAll);
+    });
+    ctx.command('订阅家园灵感 [args:text]', '订阅指定 UID 的家园精灵灵感完成提醒')
+        .userFields(['authority'])
+        .action(async ({ session }, args = '') => {
+        const parsed = parseHomeSubscribeArgs(args);
+        return subscribeHome(deps, session, parsed.uid, 'inspiration', parsed.mentionAll);
+    });
+    ctx.command('订阅家园生蛋 [args:text]', '订阅指定 UID 的家园精灵生蛋提醒')
+        .userFields(['authority'])
+        .action(async ({ session }, args = '') => {
+        const parsed = parseHomeSubscribeArgs(args);
+        return subscribeHome(deps, session, parsed.uid, 'egg', parsed.mentionAll);
+    });
+    // 查看当前会话的家园订阅列表。
+    ctx.command('我的家园订阅', '查看当前会话的家园订阅列表')
+        .userFields(['authority'])
+        .action(async ({ session }) => {
+        const target = sessionTarget(session);
+        const kindLabel = { garden: '菜园', inspiration: '灵感', egg: '生蛋' };
+        const subs = Object.values(deps.homeSubMgr.getAll()).filter(sub => sub.platform === target.platform
+            && (sub.channel_id || '') === (target.channelId || '')
+            && (sub.user_id || '') === (target.userId || ''));
+        if (!subs.length)
+            return (0, permissions_1.isDirectSession)(session) ? '你当前没有家园订阅。' : '本群当前没有家园订阅。';
+        const formatTime = (ts) => (ts ? new Date(ts * 1000).toLocaleString('zh-CN', { timeZone: 'Asia/Shanghai' }) : '从未');
+        const lines = [`当前家园订阅（共 ${subs.length} 个）：`, ''];
+        for (const sub of subs) {
+            const mentionText = sub.mention_all && !sub.user_id ? '，命中后 @全体' : '';
+            lines.push(`UID ${sub.uid}（${kindLabel[sub.kind] || sub.kind}${mentionText}）：上次检查 ${formatTime(sub.last_check_time)}，上次推送 ${formatTime(sub.last_push_time)}`);
+        }
+        lines.push('');
+        lines.push('发送 取消订阅家园 [菜园/灵感/生蛋] [UID] 取消订阅');
+        return lines.join('\n');
+    });
     ctx.command('取消订阅家园 [kind:string] [uid:string]', '取消当前会话的家园订阅')
+        .userFields(['authority'])
         .action(async ({ session }, kind = '全部', uid = '') => {
         const target = sessionTarget(session);
-        if (!target.userId && !isBotAdmin(session, deps.config.adminUserIds))
-            return '此指令仅限管理员使用。';
+        if (!target.userId && !canManageGroupSubscription(deps, session))
+            return '此指令仅限群管理员或机器人管理员使用。';
         const kindMap = { '菜园': 'garden', '灵感': 'inspiration', '生蛋': 'egg', '全部': '', all: '', garden: 'garden', inspiration: 'inspiration', egg: 'egg' };
         const deleted = deps.homeSubMgr.deleteMatching(target, kindMap[String(kind || '全部')] ?? '', String(uid || '').trim());
         return deleted ? `已取消 ${deleted} 条家园订阅。` : '当前会话没有匹配的家园订阅。';
@@ -2084,10 +2522,12 @@ function register(deps) {
         .action(async ({ session }) => {
         if (!isBotAdmin(session, deps.config.adminUserIds))
             return '此指令仅限管理员使用。';
-        const result = await checkHomeSubscriptions(deps);
+        const result = await homeRunner(signal => checkHomeSubscriptions(deps, signal));
+        if (!result)
+            return '订阅检查正在运行或插件已停止。';
         return `家园订阅检查完成：订阅 ${result.subscriptions} 条，检查 ${result.checked} 条，推送 ${result.pushed} 档提醒。`;
     });
     if (deps.config.homeSubscriptionEnabled) {
-        ctx.setInterval(() => checkHomeSubscriptions(deps).catch(err => logger.warn(`家园订阅检查失败: ${err}`)), Math.max(1, deps.config.homeSubscriptionIntervalMinutes || 5) * 60000);
+        ctx.setInterval(() => homeRunner(signal => checkHomeSubscriptions(deps, signal)).catch(err => logger.warn(`家园订阅检查失败: ${err}`)), Math.max(1, deps.config.homeSubscriptionIntervalMinutes || 5) * 60000);
     }
 }