koishi-plugin-rocom 1.0.18 → 1.0.19

package/lib/merchant-service.js

@@ -0,0 +1,148 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.numberOrNull = void 0;
+exports.livePrice = livePrice;
+exports.merchantTimestampMs = merchantTimestampMs;
+exports.normalizeLiveMerchant = normalizeLiveMerchant;
+exports.normalizeLegacyMerchant = normalizeLegacyMerchant;
+exports.isLiveMerchantPayload = isLiveMerchantPayload;
+exports.normalizeMerchant = normalizeMerchant;
+const client_1 = require("./client");
+const numberOrNull = (v) => {
+    if (v === undefined || v === null || v === '')
+        return null;
+    const n = Number(v);
+    return Number.isFinite(n) ? n : null;
+};
+exports.numberOrNull = numberOrNull;
+// 价格可能直接是数字，也可能是 { real, origin } 或 { amount }（上游 v4.1.0）。
+function livePrice(value) {
+    const selected = value && typeof value === 'object'
+        ? value.real ?? value.origin : value;
+    return (0, exports.numberOrNull)(selected && typeof selected === 'object'
+        ? selected.amount : selected);
+}
+// 秒/毫秒时间戳统一为毫秒；0/空值视为无时间。
+function merchantTimestampMs(value) {
+    if (value === null || value === undefined || value === '' || value === 0 || value === '0')
+        return null;
+    const timestamp = Number(value);
+    if (!Number.isFinite(timestamp))
+        return null;
+    return Math.abs(timestamp) < 100_000_000_000 ? timestamp * 1000 : timestamp;
+}
+function mappingById(payload) {
+    const mapping = payload?._goods_mapping ?? payload?.goods_mapping;
+    const list = Array.isArray(mapping) ? mapping : [];
+    const map = new Map();
+    for (const item of list) {
+        if ((0, client_1.isObject)(item) && item.goods_id !== undefined && item.goods_id !== null) {
+            map.set(String(item.goods_id), item);
+        }
+    }
+    return map;
+}
+function liveGoodsName(meta, item, goodsId) {
+    const name = String(meta?.goods_name || meta?.name || item?.name || item?.goods_name || '').trim();
+    if (name)
+        return name;
+    return goodsId !== undefined && goodsId !== null && goodsId !== '' ? `商品 ${goodsId}` : '未知商品';
+}
+function liveGoodsIcon(meta, item) {
+    return String(item?.icon_url || item?.iconUrl || meta?.icon_url || meta?.icon || '').trim();
+}
+// 实时商人 goods 结构：按 mapping 补齐名称/图标，递归 sub_goods，按“商品 ID + 时间窗口 + 父商品”去重。
+function normalizeLiveMerchant(payload, nowMs = Date.now()) {
+    const map = mappingById(payload);
+    const items = [];
+    const seen = new Set();
+    const add = (raw, parentId) => {
+        if (!(0, client_1.isObject)(raw))
+            return;
+        const goodsId = raw.goods_id ?? raw.id;
+        const meta = map.get(String(goodsId)) || {};
+        const startsAt = merchantTimestampMs(raw.start_time ?? payload?.start_time);
+        const endsAt = merchantTimestampMs(raw.disable_time ?? raw.end_time);
+        const key = `${String(goodsId)}|${startsAt ?? ''}|${endsAt ?? ''}|${parentId ?? ''}`;
+        if (seen.has(key))
+            return;
+        seen.add(key);
+        items.push({
+            id: String(goodsId ?? ''),
+            parentId,
+            name: liveGoodsName(meta, raw, goodsId),
+            icon: liveGoodsIcon(meta, raw),
+            price: livePrice(raw.price) ?? (0, exports.numberOrNull)(meta.price),
+            limit: (0, exports.numberOrNull)(raw.limit_buy_num ?? raw.buy_limit_num ?? meta.buy_limit_num),
+            startsAt,
+            endsAt,
+            active: (startsAt === null || nowMs >= startsAt) && (endsAt === null || nowMs < endsAt),
+            category: parentId ? '子商品' : '商品',
+            source: 'live',
+        });
+        const children = Array.isArray(raw.sub_goods) ? raw.sub_goods : [];
+        for (const child of children)
+            add(child, String(goodsId ?? ''));
+    };
+    const goods = Array.isArray(payload?.goods) ? payload.goods : [];
+    for (const raw of goods)
+        add(raw);
+    return items;
+}
+// 旧接口：merchantActivities 下 products/get_props/get_extra_props/get_pets 合并，random_goods 补价格/限购。
+function normalizeLegacyMerchant(payload, nowMs = Date.now()) {
+    const activities = payload?.merchantActivities || payload?.merchant_activities || [];
+    const activity = activities[0] || {};
+    const randomGoods = Array.isArray(payload?.random_goods) ? payload.random_goods : [];
+    const metaByName = new Map();
+    for (const item of randomGoods) {
+        const name = String(item?.goods_name || item?.name || '').trim();
+        if (name)
+            metaByName.set(name, item);
+    }
+    const buckets = [
+        ['道具', activity.get_props || []],
+        ['额外道具', activity.get_extra_props || []],
+        ['精灵', activity.get_pets || []],
+        ['商品', activity.products || []],
+        ['商品', activity.product_list || []],
+    ];
+    const items = [];
+    const seen = new Set();
+    for (const [category, list] of buckets) {
+        for (const raw of Array.isArray(list) ? list : []) {
+            if (!(0, client_1.isObject)(raw))
+                continue;
+            const name = String(raw.name || raw.goods_name || '未知商品').trim() || '未知商品';
+            const startsAt = merchantTimestampMs(raw.start_time) ?? merchantTimestampMs(activity.start_time);
+            const endsAt = merchantTimestampMs(raw.end_time) ?? merchantTimestampMs(activity.end_time);
+            const key = `${raw.id ?? ''}|${name}|${startsAt ?? 0}|${endsAt ?? 'inf'}`;
+            if (seen.has(key))
+                continue;
+            seen.add(key);
+            const meta = metaByName.get(name) || {};
+            items.push({
+                id: String(raw.id ?? ''),
+                name,
+                icon: String(raw.icon_url || raw.iconUrl || meta.icon_url || meta.icon || '').trim(),
+                price: (0, exports.numberOrNull)(raw.price) ?? (0, exports.numberOrNull)(meta.price),
+                limit: (0, exports.numberOrNull)(raw.buy_limit_num ?? raw.limit_buy_num) ?? (0, exports.numberOrNull)(meta.buy_limit_num),
+                startsAt,
+                endsAt,
+                active: (startsAt === null || nowMs >= startsAt) && (endsAt === null || nowMs < endsAt),
+                category,
+                source: 'legacy',
+            });
+        }
+    }
+    return items;
+}
+function isLiveMerchantPayload(payload) {
+    return (0, client_1.isObject)(payload) && Array.isArray(payload.goods);
+}
+function normalizeMerchant(payload, nowMs = Date.now()) {
+    if (isLiveMerchantPayload(payload)) {
+        return { source: 'live', items: normalizeLiveMerchant(payload, nowMs) };
+    }
+    return { source: 'legacy', items: normalizeLegacyMerchant(payload, nowMs) };
+}

package/lib/permissions.d.ts

@@ -0,0 +1,16 @@
+import type { PluginConfig } from './types';
+export type GroupRole = 'owner' | 'admin' | 'member' | 'unknown';
+export interface SubscriptionPermissionInput {
+    privateChat: boolean;
+    privateAllowed: boolean;
+    groupRole: GroupRole;
+    groupAdminEnabled: boolean;
+    botAdminEnabled: boolean;
+    whitelisted: boolean;
+    authority: number;
+    botAdminAuthority: number;
+}
+export declare function mayManageSubscription(p: SubscriptionPermissionInput): boolean;
+export declare function groupRoleFromSession(session: any): GroupRole;
+export declare function isDirectSession(session: any): boolean;
+export declare function canManageSubscription(config: PluginConfig, session: any, privateAllowed?: boolean): boolean;

package/lib/permissions.js

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mayManageSubscription = mayManageSubscription;
+exports.groupRoleFromSession = groupRoleFromSession;
+exports.isDirectSession = isDirectSession;
+exports.canManageSubscription = canManageSubscription;
+// 统一订阅权限策略：群主/管理员与 Bot 管理员按独立开关生效。
+function mayManageSubscription(p) {
+    if (p.privateChat)
+        return p.privateAllowed;
+    if (p.botAdminEnabled && (p.whitelisted || p.authority >= p.botAdminAuthority))
+        return true;
+    return p.groupAdminEnabled && (p.groupRole === 'owner' || p.groupRole === 'admin');
+}
+// 从平台会话中读取可信角色；只接受适配器规范化的字符串角色。
+function groupRoleFromSession(session) {
+    const collect = (value, output) => {
+        if (value === undefined || value === null)
+            return;
+        if (Array.isArray(value)) {
+            for (const item of value)
+                collect(item, output);
+            return;
+        }
+        output.push(String(value));
+    };
+    const roles = [];
+    const member = session?.event?.member || session?.member;
+    collect(member?.roles, roles);
+    collect(member?.role, roles);
+    const sender = session?.event?.sender || session?.sender;
+    collect(sender?.role, roles);
+    const author = session?.event?.author || session?.author;
+    collect(author?.member_role, roles);
+    collect(author?.memberRole, roles);
+    collect(member?.member_role, roles);
+    // OneBot 原始事件由适配器提供；不从消息正文读取角色。
+    collect(session?.onebot?.sender?.role, roles);
+    const normalized = roles.map(role => role.trim().toLowerCase());
+    if (normalized.some(role => ['owner', '群主', '创建者'].includes(role)))
+        return 'owner';
+    if (normalized.some(role => ['admin', 'administrator', '管理员'].includes(role)))
+        return 'admin';
+    if (normalized.some(role => ['member', '普通成员'].includes(role)))
+        return 'member';
+    return 'unknown';
+}
+function isDirectSession(session) {
+    if (typeof session?.isDirect === 'boolean')
+        return session.isDirect;
+    const type = session?.event?.channel?.type;
+    if (type !== undefined)
+        return type === 1 || type === 'DIRECT';
+    return !session?.guildId;
+}
+function canManageSubscription(config, session, privateAllowed = true) {
+    return mayManageSubscription({
+        privateChat: isDirectSession(session), privateAllowed,
+        groupRole: groupRoleFromSession(session),
+        groupAdminEnabled: config.subscriptionGroupAdminEnabled !== false,
+        botAdminEnabled: config.subscriptionBotAdminEnabled !== false,
+        whitelisted: config.adminUserIds.includes(session?.userId || ''),
+        authority: Number(session?.user?.authority ?? 0) || 0,
+        botAdminAuthority: Math.max(1, Number(config.subscriptionBotAdminAuthority) || 4),
+    });
+}

package/lib/pet-data-service.js

@@ -24,6 +24,7 @@ exports.petDataSkills = petDataSkills;
 exports.petDataCardItems = petDataCardItems;
 exports.petDataExtractItems = petDataExtractItems;
 exports.buildPetDataRenderData = buildPetDataRenderData;
+const pet_size_1 = require("./pet-size");
 const CN_TIME_ZONE = 'Asia/Shanghai';
 function petDataDisplay(value, defaultText = '--') {
     if (value === undefined || value === null || value === '')
@@ -105,12 +106,14 @@ function petDataKgCompact(grams) {
     const text = (number / 1000).toFixed(2).replace(/0+$/, '').replace(/\.$/, '');
     return `${text}kg`;
 }
-// 上游 v3.7.0：接入 Wiki 精灵体重范围，前 5% 标小块头、后 5% 标大块头。
+// 上游 v3.7.0：接入 Wiki 精灵体重范围，与查蛋共用同一判定。
 function petDataWeightSizeInfo(pet, wikiPet) {
     const bodySize = wikiPet && typeof wikiPet === 'object' ? wikiPet.body_size : null;
     const weightRange = bodySize && typeof bodySize === 'object' ? bodySize.weight : null;
     if (!weightRange || typeof weightRange !== 'object')
         return {};
+    if ([pet?.weight, weightRange.min_g, weightRange.max_g].some(value => value == null || value === ''))
+        return {};
     const current = Number(pet?.weight);
     const low = Number(weightRange.min_g);
     const high = Number(weightRange.max_g);
@@ -118,15 +121,10 @@ function petDataWeightSizeInfo(pet, wikiPet) {
         return {};
     if (high <= low)
         return {};
-    const span = high - low;
-    const smallCut = low + span * 0.05;
-    const largeCut = high - span * 0.05;
+    const size = (0, pet_size_1.classifyWeight)(current / 1000, low / 1000, high / 1000);
     const rangeText = `${petDataKgCompact(low)}-${petDataKgCompact(high)}`;
-    if (current <= smallCut) {
-        return { label: '小块头', className: 'size-small', hint: `小块头 · ≤${petDataKgCompact(smallCut)} · 范围 ${rangeText}` };
-    }
-    if (current >= largeCut) {
-        return { label: '大块头', className: 'size-large', hint: `大块头 · ≥${petDataKgCompact(largeCut)} · 范围 ${rangeText}` };
+    if (size) {
+        return { label: size.label, className: size.css, hint: `${size.label} · ${size.css === 'size-small' ? '≤' : '≥'}${petDataKgCompact(size.threshold * 1000)} · 范围 ${rangeText}` };
     }
     return { label: '', className: '', hint: `范围 ${rangeText}` };
 }

package/lib/pet-size.d.ts

@@ -0,0 +1,13 @@
+export interface WeightClass {
+    label: '小块头' | '大块头';
+    css: 'size-small' | 'size-large';
+    threshold: number;
+}
+export declare function classifyWeight(weightKg: number, minKg: number, maxKg: number): WeightClass | null;
+export interface SizeVariant {
+    size_variant: string;
+    size_variant_label: string;
+    size_variant_class: string;
+    size_variant_hint: string;
+}
+export declare function sizeVariantPayload(queryWeight: unknown, minKg: unknown, maxKg: unknown, rangeText?: string): SizeVariant;

package/lib/pet-size.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.classifyWeight = classifyWeight;
+exports.sizeVariantPayload = sizeVariantPayload;
+// 体重范围下端 5% / 上端 5% 判定大小块头；使用未四舍五入的数值比较。
+function classifyWeight(weightKg, minKg, maxKg) {
+    if (![weightKg, minKg, maxKg].every(Number.isFinite) || maxKg <= minKg)
+        return null;
+    if (weightKg < minKg || weightKg > maxKg)
+        return null;
+    const span = maxKg - minKg;
+    const small = minKg + span * 0.05;
+    const large = maxKg - span * 0.05;
+    if (weightKg <= small)
+        return { label: '小块头', css: 'size-small', threshold: small };
+    if (weightKg >= large)
+        return { label: '大块头', css: 'size-large', threshold: large };
+    return null;
+}
+function num(value) {
+    if (value === null || value === undefined || value === '')
+        return null;
+    const parsed = Number(value);
+    return Number.isFinite(parsed) ? parsed : null;
+}
+function formatNumber(value, digits = 3) {
+    return String(Number(value.toFixed(digits)));
+}
+const EMPTY_VARIANT = {
+    size_variant: '',
+    size_variant_label: '',
+    size_variant_class: '',
+    size_variant_hint: '',
+};
+function sizeVariantPayload(queryWeight, minKg, maxKg, rangeText = '') {
+    const query = num(queryWeight);
+    const low = num(minKg);
+    const high = num(maxKg);
+    if (query === null || low === null || high === null || high <= low)
+        return EMPTY_VARIANT;
+    const cls = classifyWeight(query, low, high);
+    if (!cls)
+        return EMPTY_VARIANT;
+    const limit = formatNumber(cls.threshold);
+    const range = rangeText || `${formatNumber(low)}-${formatNumber(high)}kg`;
+    return {
+        size_variant: cls.css === 'size-small' ? 'small' : 'large',
+        size_variant_label: cls.label,
+        size_variant_class: cls.css,
+        size_variant_hint: cls.label === '小块头'
+            ? `小块头区间：≤ ${limit} kg（体重范围 ${range} 的前 5%）`
+            : `大块头区间：≥ ${limit} kg（体重范围 ${range} 的后 5%）`,
+    };
+}

package/lib/player-service.d.ts

@@ -0,0 +1,37 @@
+export interface PlayerRow {
+    field?: string;
+    label?: string;
+    value?: unknown;
+}
+export type IngamePlayerPayload = {
+    rows?: PlayerRow[];
+    notes?: unknown[];
+    title?: string;
+    player_info?: Record<string, any>;
+    player_card_brief_info?: Record<string, any>;
+    [key: string]: any;
+};
+export declare function resourceUrl(value: unknown, apiBaseUrl: string): string;
+export declare function playerRows(payload: any, uid: string): PlayerRow[];
+/** 玩家时间统一按北京时间展示，不依赖 Bot 所在服务器的时区。 */
+export declare function formatPlayerTime(value: unknown): string;
+export declare function cleanPlayerFieldValue(field: string, value: unknown): string;
+export interface ParsedPlayer {
+    title: string;
+    nickname: string;
+    uid: string;
+    level: string;
+    signature: string;
+    rowMap: Record<string, string>;
+    labelMap: Record<string, string>;
+}
+export declare function parseIngamePlayerPayload(payload: IngamePlayerPayload | null | undefined, uid: string): ParsedPlayer;
+export declare function playerField(parsed: ParsedPlayer | null, field: string, defaultValue?: string): string;
+export interface PlayerView {
+    parsed: ParsedPlayer;
+    cardImageUrl: string;
+}
+export declare function buildPlayerView(searchPayload: any, cardPayload: any, uid: string, apiBaseUrl: string): PlayerView;
+export declare function mergePlayerPayloads(searchPayload: any, cardPayload: any): any;
+export declare function playerPayloadUid(payload: any): string;
+export declare function buildPlayerText(payload: any, uid: string): string;

package/lib/player-service.js

@@ -0,0 +1,201 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resourceUrl = resourceUrl;
+exports.playerRows = playerRows;
+exports.formatPlayerTime = formatPlayerTime;
+exports.cleanPlayerFieldValue = cleanPlayerFieldValue;
+exports.parseIngamePlayerPayload = parseIngamePlayerPayload;
+exports.playerField = playerField;
+exports.buildPlayerView = buildPlayerView;
+exports.mergePlayerPayloads = mergePlayerPayloads;
+exports.playerPayloadUid = playerPayloadUid;
+exports.buildPlayerText = buildPlayerText;
+const client_1 = require("./client");
+// 相对资源地址转绝对地址（上游 v4.1.0）；非字符串/非法协议返回空串，避免渲染裂图。
+function resourceUrl(value, apiBaseUrl) {
+    if (typeof value !== 'string' || !value.trim())
+        return '';
+    // `relative/` 是后端资源标记，不属于资源路径。
+    const text = value.trim().replace(/^relative\//, '');
+    if (!text)
+        return '';
+    if (/^data:/i.test(text))
+        return text;
+    try {
+        const url = new URL(text, apiBaseUrl.replace(/\/$/, '') + '/');
+        return ['https:', 'http:'].includes(url.protocol) ? url.href : '';
+    }
+    catch {
+        return '';
+    }
+}
+// 将 v4.1.0 玩家嵌套结构与旧 rows 统一成 IngamePlayerRow[] 目标展示。
+// 值为 0/false 需要保留，不能用 `value || ''` 清空。
+function playerRows(payload, uid) {
+    const legacy = Array.isArray(payload?.rows) ? payload.rows : [];
+    const p = payload?.player_info ?? {};
+    const c = payload?.player_card_brief_info ?? {};
+    const stats = c.card_pet_info ?? {};
+    const home = p.home_info ?? {};
+    const visit = p.visit_info ?? {};
+    const appearance = c.card_appearance_info ?? {};
+    const business = c.business_card_info ?? {};
+    const fields = [
+        ['uin', 'UID', p.uin ?? p.uid ?? legacy.find(row => row.field === 'uin')?.value ?? uid],
+        ['name', '昵称', p.name],
+        ['level', '等级', p.level],
+        ['online', '在线状态', p.online ?? p.is_online ?? payload?.online],
+        ['sex', '性别', p.sex ?? p.gender],
+        ['gender', '性别', p.gender ?? p.sex],
+        ['signature', '个性签名', p.signature ?? c.card_signature],
+        ['home_name', '家园名称', home.home_name ?? home.name],
+        ['home_level', '家园等级', home.home_level],
+        ['room_level', '房间等级', home.room_level],
+        ['home_experience', '家园经验', home.home_experience],
+        ['home_comfort_level', '舒适度', home.home_comfort_level ?? home.comfort_level],
+        ['visitor_num', '访客数量', visit.visitor_num],
+        ['world_level', '世界等级', p.world_level],
+        ['card_handbook_collect_num', '图鉴收集', p.card_handbook_collect_num ?? c.card_handbook_collect_num],
+        ['last_logout_time', '最后离线', p.last_logout_time],
+        ['collected_shining_pet_count', '异色收集', stats.collected_shining_pet_count],
+        ['collected_glass_pet_count', '炫彩收集', stats.collected_glass_pet_count],
+        ['card_skin_selected', '名片皮肤', appearance.card_skin_selected ?? p.card_skin_selected ?? business.card_skin_selected],
+        ['card_icon_selected', '名片头像', c.card_icon_selected ?? p.card_icon_selected ?? appearance.card_icon_selected ?? business.card_icon_selected],
+        ['card_bussiness_card_url', '名片图片', business.cur_card_url ?? c.cur_card_url ?? p.card_bussiness_card_url],
+    ];
+    const mapped = fields
+        .filter(([, , v]) => v !== undefined && v !== null)
+        .map(([field, label, value]) => ({ field, label, value }));
+    return [...new Map([...legacy, ...mapped].map(row => [row.field, row])).values()];
+}
+/** 玩家时间统一按北京时间展示，不依赖 Bot 所在服务器的时区。 */
+function formatPlayerTime(value) {
+    if (typeof value !== 'string' && typeof value !== 'number')
+        return '未知';
+    const text = String(value).trim();
+    if (!text)
+        return '未知';
+    let timestamp;
+    if (/^[+-]?\d+(?:\.\d+)?$/.test(text)) {
+        const numeric = Number(text);
+        if (!Number.isFinite(numeric) || numeric <= 0)
+            return '未知';
+        timestamp = numeric < 100_000_000_000 ? numeric * 1000 : numeric;
+    }
+    else {
+        // 已格式化的无时区文本视作北京时间；带 Z/偏移的 ISO 日期按原偏移解析。
+        const match = /^(\d{4})[-/](\d{2})[-/](\d{2})(?:[ T](\d{2}:\d{2}(?::\d{2}(?:\.\d+)?)?))?(Z|[+-]\d{2}:?\d{2})?(?:（北京时间）)?$/i.exec(text);
+        if (!match)
+            return '未知';
+        timestamp = Date.parse(`${match[1]}-${match[2]}-${match[3]}T${match[4] || '00:00:00'}${match[5] || '+08:00'}`);
+    }
+    const beijing = new Date(timestamp + 8 * 3600_000);
+    if (!Number.isFinite(beijing.getTime()))
+        return '未知';
+    return `${beijing.toISOString().slice(0, 19).replace('T', ' ')}（北京时间）`;
+}
+function cleanPlayerFieldValue(field, value) {
+    if (field === 'last_logout_time')
+        return formatPlayerTime(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 = playerRows(payload, uid);
+    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 (field === 'last_logout_time')
+        return formatPlayerTime(raw);
+    if (raw == null || raw === '')
+        return defaultValue;
+    const value = cleanPlayerFieldValue(field, raw);
+    return value && value !== '-' && value !== '未设置' ? value : defaultValue;
+}
+// 合并搜索结果与名片结果；名片失败时保留基础信息（上游 v4.1.0）。
+function buildPlayerView(searchPayload, cardPayload, uid, apiBaseUrl) {
+    const merged = mergePlayerPayloads(searchPayload, cardPayload);
+    const parsed = parseIngamePlayerPayload(merged, uid);
+    const cardRaw = playerField(parsed, 'card_bussiness_card_url', '');
+    return {
+        parsed,
+        cardImageUrl: cardRaw ? resourceUrl(cardRaw, apiBaseUrl) : '',
+    };
+}
+function mergePlayerPayloads(searchPayload, cardPayload) {
+    const result = { ...(searchPayload || {}) };
+    const searchUid = playerPayloadUid(searchPayload);
+    const cardUid = playerPayloadUid(cardPayload);
+    if (searchUid && cardUid && searchUid !== cardUid)
+        return result;
+    if (!(0, client_1.isObject)(cardPayload))
+        return result;
+    const searchInfo = (0, client_1.isObject)(result.player_info) ? result.player_info : {};
+    const cardInfo = (0, client_1.isObject)(cardPayload.player_info) ? cardPayload.player_info : {};
+    if (Object.keys(cardInfo).length)
+        result.player_info = { ...searchInfo, ...cardInfo };
+    for (const key of ['home_info', 'visit_info', 'battle_brief_info', 'pos_info']) {
+        if ((0, client_1.isObject)(searchInfo[key]) && (0, client_1.isObject)(cardInfo[key])) {
+            result.player_info[key] = { ...searchInfo[key], ...cardInfo[key] };
+        }
+    }
+    if ((0, client_1.isObject)(cardPayload.player_card_brief_info)) {
+        const base = (0, client_1.isObject)(result.player_card_brief_info) ? result.player_card_brief_info : {};
+        result.player_card_brief_info = { ...base, ...cardPayload.player_card_brief_info };
+        for (const key of ['card_pet_info', 'business_card_info', 'card_appearance_info']) {
+            if ((0, client_1.isObject)(base[key]) && (0, client_1.isObject)(cardPayload.player_card_brief_info[key])) {
+                result.player_card_brief_info[key] = { ...base[key], ...cardPayload.player_card_brief_info[key] };
+            }
+        }
+    }
+    if (Array.isArray(result.rows) && result.rows.length && !(0, client_1.isObject)(cardPayload.player_card_brief_info)) {
+        return result;
+    }
+    return result;
+}
+function playerPayloadUid(payload) {
+    return String(payload?.player_info?.uin ?? payload?.player_info?.uid ?? payload?.uin ?? payload?.uid
+        ?? payload?.rows?.find((row) => row.field === 'uin')?.value ?? '');
+}
+function buildPlayerText(payload, uid) {
+    const p = parseIngamePlayerPayload(payload, uid);
+    return ['洛克玩家 ' + p.nickname + ' · UID ' + p.uid,
+        ...Object.entries(p.rowMap).filter(([key]) => !['uin', 'name'].includes(key))
+            .map(([key, value]) => (p.labelMap[key] || key) + '：' + cleanPlayerFieldValue(key, value))].join('\n');
+}

package/lib/ranking-service.d.ts

@@ -0,0 +1,46 @@
+export type RankingKind = 'shining' | 'glass';
+interface RankingMeta {
+    title: string;
+    subtitle: string;
+    label: string;
+    otherLabel: string;
+    countField: string;
+    otherCountField: string;
+    theme: string;
+}
+export declare const RANKING_META: Record<RankingKind, RankingMeta>;
+export interface RankingArgs {
+    uid: string;
+    limit: number;
+}
+export declare function parseRankingArgs(text: string, primaryUid?: string): RankingArgs;
+export declare function formatRankingTime(value: unknown): string;
+export declare function buildRankingView(payload: any, rankType: RankingKind, baseUrl: string, requestedUid?: string, now?: Date): {
+    total: number;
+    items: {
+        rank: number;
+        podiumClass: string;
+        playerName: string;
+        avatar: string;
+        signature: string;
+        primaryCount: number;
+        secondaryCount: number;
+        sampleCount: number;
+        lastSeen: string;
+    }[];
+    current: any;
+    requestedUid: string;
+    shownCount: number;
+    updatedAt: string;
+    commandHint: string;
+    copyright: string;
+    title: string;
+    subtitle: string;
+    label: string;
+    otherLabel: string;
+    countField: string;
+    otherCountField: string;
+    theme: string;
+};
+export declare function buildRankingText(data: any): string;
+export {};