koishi-plugin-rocom 1.0.13 → 1.0.17

package/lib/index.js

@@ -36,9 +36,9 @@ __export(src_exports, {
   name: () => name
 });
 module.exports = __toCommonJS(src_exports);
-var import_koishi12 = require("koishi");
-var import_node_fs5 = __toESM(require("node:fs"));
-var import_node_path5 = __toESM(require("node:path"));
+var import_koishi15 = require("koishi");
+var import_node_fs7 = __toESM(require("node:fs"));
+var import_node_path6 = __toESM(require("node:path"));
 
 // src/client.ts
 var import_koishi = require("koishi");
@@ -174,14 +174,14 @@ var RocomClient = class _RocomClient {
       return String(value);
     }
   }
-  logRequestFailureDetails(method, path6, headers, params, body, errorOrResponse) {
+  logRequestFailureDetails(method, path7, headers, params, body, errorOrResponse) {
     const err = errorOrResponse;
     const response = err?.response;
     const details = {
       request: {
         method,
-        url: `${this.baseUrl}${path6}`,
-        path: path6,
+        url: `${this.baseUrl}${path7}`,
+        path: path7,
         params: this.sanitizeForLog(params),
         body: this.sanitizeForLog(body),
         headers: this.sanitizeForLog(headers),
@@ -201,21 +201,21 @@ var RocomClient = class _RocomClient {
         stack: err?.stack
       } : void 0
     };
-    logger.warn(`${method} ${path6} detailed failure
+    logger.warn(`${method} ${path7} detailed failure
 ${this.stringifyForLog(details)}`);
   }
-  async get(ctx, path6, headers, params, options) {
+  async get(ctx, path7, headers, params, options) {
     try {
-      const resp = await ctx.http.get(`${this.baseUrl}${path6}`, {
+      const resp = await ctx.http.get(`${this.baseUrl}${path7}`, {
         headers,
         params,
         timeout: this.timeout
       });
       if (resp?.code !== 0) {
         this.setLastError(resp?.message || "接口返回异常");
-        logger.warn(path6 + " error: " + (resp?.message || "unknown"));
+        logger.warn(path7 + " error: " + (resp?.message || "unknown"));
         if (!options?.silentFailureDetails) {
-          this.logRequestFailureDetails("GET", path6, headers, params, void 0, resp);
+          this.logRequestFailureDetails("GET", path7, headers, params, void 0, resp);
         }
         return null;
       }
@@ -224,40 +224,40 @@ ${this.stringifyForLog(details)}`);
       const message = this.formatHttpError(e);
       this.setLastError(message);
       if (!options?.silentFailureDetails) {
-        this.logRequestFailureDetails("GET", path6, headers, params, void 0, e);
+        this.logRequestFailureDetails("GET", path7, headers, params, void 0, e);
       }
       const err = e;
       if (err?.response) {
-        logger.warn("GET " + path6 + " failed: " + message);
+        logger.warn("GET " + path7 + " failed: " + message);
       } else {
-        logger.error("GET " + path6 + " failed: " + message);
+        logger.error("GET " + path7 + " failed: " + message);
       }
       return null;
     }
   }
-  async post(ctx, path6, headers, json, params) {
+  async post(ctx, path7, headers, json, params) {
     try {
-      const resp = await ctx.http.post(`${this.baseUrl}${path6}`, json, {
+      const resp = await ctx.http.post(`${this.baseUrl}${path7}`, json, {
         headers,
         params,
         timeout: this.timeout
       });
       if (resp?.code !== 0) {
         this.setLastError(resp?.message || "接口返回异常");
-        logger.warn(path6 + " error: " + (resp?.message || "unknown"));
-        this.logRequestFailureDetails("POST", path6, headers, params, json, resp);
+        logger.warn(path7 + " error: " + (resp?.message || "unknown"));
+        this.logRequestFailureDetails("POST", path7, headers, params, json, resp);
         return null;
       }
       return resp?.data ?? {};
     } catch (e) {
       const message = this.formatHttpError(e);
       this.setLastError(message);
-      this.logRequestFailureDetails("POST", path6, headers, params, json, e);
+      this.logRequestFailureDetails("POST", path7, headers, params, json, e);
       const err = e;
       if (err?.response) {
-        logger.warn("POST " + path6 + " failed: " + message);
+        logger.warn("POST " + path7 + " failed: " + message);
       } else {
-        logger.error("POST " + path6 + " failed: " + message);
+        logger.error("POST " + path7 + " failed: " + message);
       }
       return null;
     }
@@ -267,34 +267,34 @@ ${this.stringifyForLog(details)}`);
     if (userIdentifier) result.user_identifier = this.sanitizeUid(userIdentifier);
     return result;
   }
-  async delete(ctx, path6, headers, params) {
+  async delete(ctx, path7, headers, params) {
     try {
-      const resp = await ctx.http("DELETE", `${this.baseUrl}${path6}`, { headers, params, timeout: this.timeout });
+      const resp = await ctx.http("DELETE", `${this.baseUrl}${path7}`, { headers, params, timeout: this.timeout });
       if (resp?.code !== 0) {
         this.setLastError(resp?.message || "接口返回异常");
-        logger.warn(path6 + " error: " + (resp?.message || "unknown"));
-        this.logRequestFailureDetails("DELETE", path6, headers, params, void 0, resp);
+        logger.warn(path7 + " error: " + (resp?.message || "unknown"));
+        this.logRequestFailureDetails("DELETE", path7, headers, params, void 0, resp);
         return null;
       }
       return resp?.data ?? {};
     } catch (e) {
       const message = this.formatHttpError(e);
       this.setLastError(message);
-      this.logRequestFailureDetails("DELETE", path6, headers, params, void 0, e);
+      this.logRequestFailureDetails("DELETE", path7, headers, params, void 0, e);
       const err = e;
       if (err?.response) {
-        logger.warn("DELETE " + path6 + " failed: " + message);
+        logger.warn("DELETE " + path7 + " failed: " + message);
       } else {
-        logger.error("DELETE " + path6 + " failed: " + message);
+        logger.error("DELETE " + path7 + " failed: " + message);
       }
       return null;
     }
   }
   // Login and binding APIs.
-  async requestWithStatus(ctx, method, path6, headers, options = {}) {
+  async requestWithStatus(ctx, method, path7, headers, options = {}) {
     const acceptedStatuses = options.acceptedStatuses || [200];
     try {
-      const response = await ctx.http(method, `${this.baseUrl}${path6}`, {
+      const response = await ctx.http(method, `${this.baseUrl}${path7}`, {
         headers,
         params: options.params,
         data: options.json,
@@ -308,7 +308,7 @@ ${this.stringifyForLog(details)}`);
         const message = !acceptedStatuses.includes(status) ? `HTTP ${status}: ${rawMessage}` : rawMessage;
         this.setLastError(message);
         if (!options.silentFailureDetails) {
-          this.logRequestFailureDetails(method, path6, headers, options.params, options.json, body);
+          this.logRequestFailureDetails(method, path7, headers, options.params, options.json, body);
         }
         return { status: null, data: null };
       }
@@ -316,7 +316,7 @@ ${this.stringifyForLog(details)}`);
       if (!acceptedStatuses.includes(status)) {
         this.setLastError(`HTTP ${status}`);
         if (!options.silentFailureDetails) {
-          this.logRequestFailureDetails(method, path6, headers, options.params, options.json, response);
+          this.logRequestFailureDetails(method, path7, headers, options.params, options.json, response);
         }
         return { status: null, data: null };
       }
@@ -325,22 +325,22 @@ ${this.stringifyForLog(details)}`);
       const message = this.formatHttpError(e);
       this.setLastError(message);
       if (!options.silentFailureDetails) {
-        this.logRequestFailureDetails(method, path6, headers, options.params, options.json, e);
+        this.logRequestFailureDetails(method, path7, headers, options.params, options.json, e);
       }
       return { status: null, data: null };
     }
   }
-  async requestIngameWithFallback(ctx, path6, payload, options = {}) {
+  async requestIngameWithFallback(ctx, path7, payload, options = {}) {
     const acceptedStatuses = options.acceptedStatuses || [200, 202];
     const requestOnce = /* @__PURE__ */ __name(async (includeApiKey, silentFailureDetails) => {
       const headers = this.wegameHeaders("", "", "", "", includeApiKey);
-      let result2 = await this.requestWithStatus(ctx, "POST", path6, headers, {
+      let result2 = await this.requestWithStatus(ctx, "POST", path7, headers, {
         json: payload,
         acceptedStatuses,
         silentFailureDetails
       });
       if (result2.status === null) {
-        result2 = await this.requestWithStatus(ctx, "GET", path6, headers, {
+        result2 = await this.requestWithStatus(ctx, "GET", path7, headers, {
           params: payload,
           acceptedStatuses,
           silentFailureDetails
@@ -372,12 +372,15 @@ ${this.stringifyForLog(details)}`);
     return String(payload?.task_id || payload?.taskId || payload?.taskID || "").trim();
   }
   // 判断一份 payload 是否为“已完成的业务结果”（而非排队占位）。
-  // 家园接口完成时返回 rows/home_info；玩家、商店完成时返回 source/title/rows。
+  // 家园接口完成时返回 rows/home_info；玩家、商店完成时返回 source/title/rows；
+  // 家园详情（pet/data）完成时返回 npc_pets/npc_pet。
   static isCompletedGatewayPayload(payload) {
     if (!payload || typeof payload !== "object") return false;
     if (Array.isArray(payload.rows)) return true;
     if (payload.home_info !== void 0) return true;
     if (payload.source !== void 0) return true;
+    if (Array.isArray(payload.npc_pets)) return true;
+    if (payload.npc_pet && typeof payload.npc_pet === "object") return true;
     if (String(payload.title || "").trim()) return true;
     return false;
   }
@@ -563,9 +566,9 @@ ${this.stringifyForLog(details)}`);
       this.setLastError("UID 不能为空");
       return null;
     }
-    const path6 = "/api/v1/games/rocom/ingame/player/search";
+    const path7 = "/api/v1/games/rocom/ingame/player/search";
     const payload = { uid: sanitizedUid, wait_ms: 5e3 };
-    const { status, data, usedApiKey } = await this.requestIngameWithFallback(ctx, path6, payload);
+    const { status, data, usedApiKey } = await this.requestIngameWithFallback(ctx, path7, payload);
     if (status === 200 && data && this.isIngamePlayerPayload(data)) return data;
     if (!data) return null;
     if (this.isIngamePlayerPayload(data)) return data;
@@ -603,6 +606,22 @@ ${this.stringifyForLog(details)}`);
     });
   }
   async queryPetSize(ctx, diameter, weight, sameRideEgg = false, userIdentifier = "") {
+    const newParams = this.scopedParams({
+      diameter,
+      weight,
+      pool: sameRideEgg ? "ride" : "magic",
+      include_display_only: "false",
+      page_no: 1,
+      page_size: 30
+    }, userIdentifier);
+    const newRes = await this.get(
+      ctx,
+      "/api/v1/games/rocom/wiki/pet-size/query",
+      this.wegameHeaders("", userIdentifier, "bot", "koishi"),
+      newParams,
+      { silentFailureDetails: true }
+    );
+    if (newRes && Array.isArray(newRes.items)) return newRes;
     const params = this.scopedParams({ diameter, weight }, userIdentifier);
     if (sameRideEgg) params.sameRideEgg = 1;
     return this.get(ctx, "/api/v1/games/rocom/pet/size-query", this.wegameHeaders("", userIdentifier, "bot", "koishi"), params);
@@ -765,9 +784,9 @@ ${this.stringifyForLog(details)}`);
       return null;
     }
     const waitMs = Number(options.waitMs) || 5e3;
-    const path6 = "/api/v1/games/rocom/ingame/home/info";
+    const path7 = "/api/v1/games/rocom/ingame/home/info";
     const payload = { uid: sanitizedUid, wait_ms: waitMs };
-    const first = await this.requestIngameWithFallback(ctx, path6, payload);
+    const first = await this.requestIngameWithFallback(ctx, path7, payload);
     return this.pollIngameTask(ctx, first, options, {
       queuedNoTaskId: "家园查询任务已入队，但未返回 task_id",
       stillQueued: /* @__PURE__ */ __name((taskId) => `家园查询任务仍在排队，请稍后重试（task_id: ${taskId}）`, "stillQueued")
@@ -782,6 +801,25 @@ ${this.stringifyForLog(details)}`);
     );
     return status === null ? null : data;
   }
+  // 家园详情：批量或单只查询家园摆放精灵的完整 ingame 数据（上游 v3.6.1）。
+  // UID 参数名为 target_uin；单只查询需同时提供 pet_gid 和 npc_id。
+  async ingamePetData(ctx, uid, extras = {}, options = {}) {
+    const sanitizedUid = this.sanitizeUid(uid);
+    if (!sanitizedUid) {
+      this.setLastError("UID 不能为空");
+      return null;
+    }
+    const waitMs = Number(options.waitMs) || 2e4;
+    const payload = { target_uin: sanitizedUid, wait_ms: waitMs };
+    if (extras.petGid !== void 0 && extras.petGid !== null && String(extras.petGid) !== "") payload.pet_gid = extras.petGid;
+    if (extras.npcId !== void 0 && extras.npcId !== null && String(extras.npcId) !== "") payload.npc_id = extras.npcId;
+    const path7 = "/api/v1/games/rocom/ingame/pet/data";
+    const first = await this.requestIngameWithFallback(ctx, path7, payload);
+    return this.pollIngameTask(ctx, first, options, {
+      queuedNoTaskId: "家园详情任务已入队，但未返回 task_id",
+      stillQueued: /* @__PURE__ */ __name((taskId) => `家园详情任务仍在排队，请稍后重试（task_id: ${taskId}）`, "stillQueued")
+    });
+  }
   async getFriendship(ctx, fwToken, userIds, userIdentifier = "") {
     return this.get(
       ctx,
@@ -813,6 +851,66 @@ ${this.stringifyForLog(details)}`);
     if (options.name) params.name = options.name;
     return this.get(ctx, "/api/v1/games/rocom/pet/detail", this.wegameHeaders(), params);
   }
+  // ===== 新版 RoCom Wiki API（上游 v3.6.0）=====
+  wikiPagedParams(q = "", pageNo = 1, pageSize = 10, filters = {}) {
+    const params = {
+      page_no: Math.max(Number(pageNo) || 1, 1),
+      page_size: Math.min(Math.max(Number(pageSize) || 10, 1), 100)
+    };
+    if (q) params.q = q;
+    for (const [key, value] of Object.entries(filters)) {
+      if (value !== void 0 && value !== null && value !== "") params[key] = value;
+    }
+    return params;
+  }
+  async listWikiPets(ctx, q = "", pageNo = 1, pageSize = 10, filters = {}) {
+    return this.get(ctx, "/api/v1/games/rocom/wiki/pets", this.wegameHeaders(), this.wikiPagedParams(q, pageNo, pageSize, filters));
+  }
+  async getWikiPet(ctx, petId) {
+    return this.get(ctx, `/api/v1/games/rocom/wiki/pets/${petId}`, this.wegameHeaders());
+  }
+  async getWikiPetProfile(ctx, petId) {
+    return this.get(ctx, `/api/v1/games/rocom/wiki/pets/${petId}/profile`, this.wegameHeaders(), void 0, { silentFailureDetails: true });
+  }
+  async getWikiPetSkills(ctx, petId) {
+    return this.get(ctx, `/api/v1/games/rocom/wiki/pets/${petId}/skills`, this.wegameHeaders(), void 0, { silentFailureDetails: true });
+  }
+  async getWikiPetFamily(ctx, petId) {
+    return this.get(ctx, `/api/v1/games/rocom/wiki/pets/${petId}/family`, this.wegameHeaders(), void 0, { silentFailureDetails: true });
+  }
+  async getWikiPetHandbook(ctx, petId) {
+    return this.get(ctx, `/api/v1/games/rocom/wiki/pets/${petId}/handbook`, this.wegameHeaders(), void 0, { silentFailureDetails: true });
+  }
+  async listWikiSkills(ctx, q = "", pageNo = 1, pageSize = 10, filters = {}) {
+    return this.get(ctx, "/api/v1/games/rocom/wiki/skills", this.wegameHeaders(), this.wikiPagedParams(q, pageNo, pageSize, filters));
+  }
+  async getWikiSkill(ctx, skillId) {
+    return this.get(ctx, `/api/v1/games/rocom/wiki/skills/${skillId}`, this.wegameHeaders(), void 0, { silentFailureDetails: true });
+  }
+  async getWikiSkillPets(ctx, skillId) {
+    return this.get(ctx, `/api/v1/games/rocom/wiki/skills/${skillId}/pets`, this.wegameHeaders(), void 0, { silentFailureDetails: true });
+  }
+  async getWikiCatalogs(ctx) {
+    return this.get(ctx, "/api/v1/games/rocom/wiki/catalogs", this.wegameHeaders());
+  }
+  async getWikiOptions(ctx) {
+    return this.get(ctx, "/api/v1/games/rocom/wiki/options", this.wegameHeaders(), void 0, { silentFailureDetails: true });
+  }
+  async getWikiPath(ctx, path7, params = {}) {
+    const trimmed = String(path7 || "").trim();
+    if (!trimmed.startsWith("/api/v1/games/rocom/wiki/")) {
+      this.setLastError("非法 Wiki 路径");
+      return null;
+    }
+    return this.get(ctx, trimmed, this.wegameHeaders(), params);
+  }
+  async listWikiCatalogItems(ctx, path7, q = "", pageNo = 1, pageSize = 10, search = true) {
+    const params = this.wikiPagedParams(search ? q : "", pageNo, pageSize);
+    return this.getWikiPath(ctx, path7, params);
+  }
+  get wikiAssetBaseUrl() {
+    return this.baseUrl;
+  }
 };
 
 // src/user.ts
@@ -985,6 +1083,35 @@ var HomeSubscriptionManager = class {
     return JSON.parse(JSON.stringify(this.store.get()));
   }
 };
+var AnnouncementSubscriptionManager = class {
+  static {
+    __name(this, "AnnouncementSubscriptionManager");
+  }
+  store;
+  constructor(dataDir) {
+    this.store = new JsonStore(dataDir, "rocom_announcement_subscriptions.json", {});
+  }
+  upsert(key, sub) {
+    const data = this.store.get();
+    data[key] = { ...sub };
+    this.store.set(data);
+  }
+  deleteMatching(target) {
+    const data = this.store.get();
+    let deleted = 0;
+    for (const [key, sub] of Object.entries(data)) {
+      const sameTarget = sub.platform === target.platform && (sub.channel_id || "") === (target.channelId || "") && (sub.user_id || "") === (target.userId || "");
+      if (!sameTarget) continue;
+      delete data[key];
+      deleted++;
+    }
+    if (deleted) this.store.set(data);
+    return deleted;
+  }
+  getAll() {
+    return JSON.parse(JSON.stringify(this.store.get()));
+  }
+};
 
 // src/egg-service.ts
 var import_koishi3 = require("koishi");
@@ -1033,8 +1160,8 @@ __name(petType, "petType");
 function fmtDur(s) {
   if (!s || s <= 0) return "暂无数据";
   if (s % 86400 === 0) return `${s / 86400} 天`;
-  const h4 = s / 3600;
-  return h4 === Math.floor(h4) ? `${h4} 小时` : `${h4.toFixed(1)} 小时`;
+  const h5 = s / 3600;
+  return h5 === Math.floor(h5) ? `${h5} 小时` : `${h5.toFixed(1)} 小时`;
 }
 __name(fmtDur, "fmtDur");
 function wt(v) {
@@ -1240,20 +1367,29 @@ var EggService = class {
     };
   }
   formatSizeApiCard(item) {
-    const probability = num(item?.probability);
+    const petInfo = item?.pet && typeof item.pet === "object" ? item.pet : {};
+    const eggSize = item?.egg_size && typeof item.egg_size === "object" ? item.egg_size : {};
+    const heightRange = eggSize?.height && typeof eggSize.height === "object" ? eggSize.height : {};
+    const weightRange = eggSize?.weight && typeof eggSize.weight === "object" ? eggSize.weight : {};
+    const match = item?.match && typeof item.match === "object" ? item.match : {};
+    const petId = petInfo?.pet_id || item?.petId || item?.pet_id || "-";
+    const petName3 = petInfo?.name || (typeof item?.pet === "string" ? item.pet : "") || item?.name || "未知精灵";
+    const typeNames = Array.isArray(petInfo?.type_names) ? petInfo.type_names.filter(Boolean) : [];
+    const eggGroupNames = Array.isArray(petInfo?.egg_group_names) ? petInfo.egg_group_names.filter(Boolean) : [];
+    const probability = num(item?.probability) ?? num(match?.percent);
     const matchCount = num(item?.matchCount);
-    const heightMin = num(item?.diameterMin);
-    const heightMax = num(item?.diameterMax);
-    const weightMin = num(item?.weightMin);
-    const weightMax = num(item?.weightMax);
+    const heightMin = num(heightRange?.min_m ?? item?.diameterMin);
+    const heightMax = num(heightRange?.max_m ?? item?.diameterMax);
+    const weightMin = num(weightRange?.min_kg ?? item?.weightMin);
+    const weightMax = num(weightRange?.max_kg ?? item?.weightMax);
     return {
-      id: item?.petId || "-",
-      name: item?.pet || "未知精灵",
-      icon: item?.petIcon || petIconUrl(item?.petId),
-      image: item?.petImage || petImageUrl(item?.petId),
-      type_label: "后端未提供",
+      id: petId,
+      name: petName3,
+      icon: petInfo?.icon || item?.petIcon || petIconUrl(petId),
+      image: petInfo?.small_icon || item?.petImage || petImageUrl(petId),
+      type_label: typeNames.length ? typeNames.join(" / ") : "后端未提供",
       egg_group_ids: [],
-      egg_groups_label: "后端未提供",
+      egg_groups_label: eggGroupNames.length ? eggGroupNames.join(" / ") : "后端未提供",
       height_min: heightMin,
       height_max: heightMax,
       height_label: fmtRange(heightMin, heightMax, "m"),
@@ -1262,7 +1398,30 @@ var EggService = class {
       weight_label: fmtRange(weightMin, weightMax, "kg"),
       probability,
       match_count: matchCount,
-      match_info_label: this.formatMatchSummary(probability, matchCount)
+      match_info_label: String(match?.match_percent_text || "") || this.formatMatchSummary(probability, matchCount)
+    };
+  }
+  // 新版尺寸反查按 match.layer 划分完美/范围匹配。
+  splitNewSizeApiItems(items) {
+    const perfect = [];
+    const ranged = [];
+    for (const item of items) {
+      const match = item?.match && typeof item.match === "object" ? item.match : {};
+      const layer = String(match?.layer || "").toLowerCase();
+      const displayOnly = Boolean(match?.display_only);
+      if (["strict", "exact"].includes(layer) && !displayOnly) perfect.push(item);
+      else ranged.push(item);
+    }
+    return [perfect, ranged];
+  }
+  sizeApiResultGroups(results) {
+    if (Array.isArray(results?.items)) {
+      const [perfect, ranged] = this.splitNewSizeApiItems(results.items);
+      return { exact: perfect, candidates: ranged };
+    }
+    return {
+      exact: Array.isArray(results?.exactResults) ? results.exactResults : [],
+      candidates: Array.isArray(results?.candidates) ? results.candidates : []
     };
   }
   formatEggSearchCard(item) {
@@ -1421,8 +1580,7 @@ var EggService = class {
     if (height != null) cond.push(`身高=${heightDisplay || fmtRange(ht(height), ht(height), "m")}`);
     if (weight != null) cond.push(`体重=${weight}kg`);
     const condStr = cond.join(" + ") || "当前条件";
-    const exact = results?.exactResults || [];
-    const candidates = results?.candidates || [];
+    const { exact, candidates } = this.sizeApiResultGroups(results);
     if (!exact.length && !candidates.length) return `❌ 未找到符合 ${condStr} 的精灵。`;
     const lines = [];
     if (exact.length) {
@@ -1635,9 +1793,10 @@ var EggService = class {
     const conditions = [];
     if (height != null) conditions.push(`身高 ${heightDisplay || fmtRange(ht(height), ht(height), "m")}`);
     if (weight != null) conditions.push(`体重 ${weight} kg`);
+    const groups = this.sizeApiResultGroups(results);
     const [perfect, ranged] = this.mergeCardsByName(
-      (results?.exactResults || []).map((item) => this.formatSizeApiCard(item)),
-      (results?.candidates || []).map((item) => this.formatSizeApiCard(item))
+      groups.exact.map((item) => this.formatSizeApiCard(item)),
+      groups.candidates.map((item) => this.formatSizeApiCard(item))
     );
     const searchMode = results?.searchMode || "";
     const queryLabel = `${conditions.join(" / ") || "尺寸反查"}${searchMode ? ` · 模式 ${searchMode}` : ""}`;
@@ -1818,13 +1977,16 @@ var Renderer = class {
         try {
           await page.evaluate(async () => {
             const images = Array.from(document.images);
-            await Promise.all(images.map((img) => {
-              if (img.complete) return Promise.resolve();
-              return new Promise((resolve) => {
-                img.onload = () => resolve();
-                img.onerror = () => resolve();
-              });
-            }));
+            await Promise.race([
+              Promise.all(images.map((img) => {
+                if (img.complete) return Promise.resolve();
+                return new Promise((resolve) => {
+                  img.onload = () => resolve();
+                  img.onerror = () => resolve();
+                });
+              })),
+              new Promise((resolve) => setTimeout(resolve, 1e4))
+            ]);
             const fonts = document.fonts;
             if (fonts?.ready) {
               await fonts.ready;
@@ -1841,6 +2003,8 @@ var Renderer = class {
           ".searcheggs-cont",
           ".bwiki-shell",
           ".skill-shell",
+          ".wiki-page",
+          ".pet-data-page",
           ".lineup-page",
           ".lineup-detail-page",
           ".page-section-main",
@@ -1888,6 +2052,26 @@ var Renderer = class {
               deviceScaleFactor: initialViewport.deviceScaleFactor
             });
             await new Promise((resolve) => setTimeout(resolve, 100));
+            try {
+              const remeasured = await page.evaluate((el, visualBounds) => {
+                const rect = el.getBoundingClientRect();
+                const element = el;
+                return {
+                  x: rect.left + window.scrollX,
+                  y: rect.top + window.scrollY,
+                  width: visualBounds ? rect.width : Math.max(rect.width, element.scrollWidth, element.offsetWidth),
+                  height: visualBounds ? rect.height : Math.max(rect.height, element.scrollHeight, element.offsetHeight)
+                };
+              }, target, useVisualBounds);
+              if (remeasured && remeasured.width > 0 && remeasured.height > 0) {
+                elementMetrics.x = remeasured.x;
+                elementMetrics.y = remeasured.y;
+                elementMetrics.width = remeasured.width;
+                elementMetrics.height = remeasured.height;
+              }
+            } catch (err) {
+              logger4.warn(`element remeasure failed for ${templateName}: ${err}`);
+            }
             const hasOverflow = elementMetrics.width > box.width + 0.5 || elementMetrics.height > box.height + 0.5;
             if (capturePadding.left || capturePadding.right || capturePadding.top || capturePadding.bottom || hasOverflow) {
               const clipX = Math.max(0, elementMetrics.x - capturePadding.left);
@@ -1925,6 +2109,1981 @@ var Renderer = class {
   }
 };
 
+// src/wiki-service.ts
+var import_koishi5 = require("koishi");
+
+// src/wiki-catalog.ts
+function route(key, title, aliases, detailPath = "", idFields = [], search = null) {
+  return { key, title, aliases, detail_path: detailPath, id_fields: idFields, search };
+}
+__name(route, "route");
+var WIKI_CATALOG_ROUTES = [
+  route("pets", "精灵", ["精灵", "宠物", "pet", "pets"], "/api/v1/games/rocom/wiki/pets/{pet_id}", ["pet_id"]),
+  route("pet-skills", "精灵技能", ["精灵技能", "宠物技能"], "/api/v1/games/rocom/wiki/pets/{pet_id}/skills", ["pet_id"], false),
+  route("pet-features", "精灵特性", ["精灵特性", "宠物特性"], "/api/v1/games/rocom/wiki/pets/{pet_id}/features", ["pet_id"], false),
+  route("pet-family", "精灵家族", ["精灵家族", "进化链", "形态链"], "/api/v1/games/rocom/wiki/pets/{pet_id}/family", ["pet_id"], false),
+  route("pet-egg", "精灵蛋详情", ["精灵蛋详情", "宠物蛋详情"], "/api/v1/games/rocom/wiki/pets/{pet_id}/egg", ["pet_id"], false),
+  route("pet-handbook", "精灵图鉴课题", ["精灵图鉴课题", "图鉴课题"], "/api/v1/games/rocom/wiki/pets/{pet_id}/handbook", ["pet_id"], false),
+  route("pet-talents", "精灵天赋", ["精灵天赋", "同乘天赋"], "/api/v1/games/rocom/wiki/pets/{pet_id}/talents", ["pet_id"], false),
+  route("pet-natures", "精灵性格", ["精灵性格", "性格"], "/api/v1/games/rocom/wiki/pets/{pet_id}/natures", ["pet_id"], false),
+  route("pet-profile", "精灵资料", ["精灵资料", "资料页"], "/api/v1/games/rocom/wiki/pets/{pet_id}/profile", ["pet_id"], false),
+  route("pet-fruit-section", "精灵关联果实", ["精灵关联果实"], "/api/v1/games/rocom/wiki/pets/{pet_id}/fruit", ["pet_id"], false),
+  route("pet-ride", "精灵骑乘", ["精灵骑乘", "骑乘"], "/api/v1/games/rocom/wiki/pets/{pet_id}/ride", ["pet_id"], false),
+  route("pet-ecology", "精灵生态", ["精灵生态", "生态"], "/api/v1/games/rocom/wiki/pets/{pet_id}/ecology", ["pet_id"], false),
+  route("pet-stories", "精灵故事", ["精灵故事", "故事"], "/api/v1/games/rocom/wiki/pets/{pet_id}/stories", ["pet_id"], false),
+  route("pet-acquisition", "精灵获取方式", ["精灵获取", "获取方式"], "/api/v1/games/rocom/wiki/pets/{pet_id}/acquisition", ["pet_id"], false),
+  route("skills", "技能", ["技能", "skill", "skills"], "/api/v1/games/rocom/wiki/skills/{skill_id}", ["skill_id"]),
+  route("skill-pets", "技能可用精灵", ["技能可用精灵", "技能精灵"], "/api/v1/games/rocom/wiki/skills/{skill_id}/pets", ["skill_id"], false),
+  route("skill-stones", "技能石", ["技能石", "skillstone", "skill-stone"], "/api/v1/games/rocom/wiki/skill-stones/{item_id}", ["item_id"]),
+  route("skill-stone-recipes", "技能石配方", ["技能石配方", "技能配方", "skillstonerecipe"], "/api/v1/games/rocom/wiki/skill-stone-recipes/{item_id}", ["item_id"]),
+  route("items", "物品", ["物品", "道具", "item", "items"], "/api/v1/games/rocom/wiki/items/{item_kind}/{item_id}", ["item_kind", "item_id"]),
+  route("egg-items", "蛋物品", ["蛋物品", "蛋道具", "egg-item"], "/api/v1/games/rocom/wiki/egg-items/{item_id}", ["item_id"]),
+  route("pet-eggs", "精灵蛋", ["精灵蛋", "宠物蛋", "蛋图鉴", "pet-egg"], "/api/v1/games/rocom/wiki/pet-eggs/{egg_conf_id}", ["egg_conf_id"]),
+  route("random-eggs", "随机蛋", ["随机蛋", "随机蛋池", "random-egg"], "/api/v1/games/rocom/wiki/random-eggs/{random_egg_id}", ["random_egg_id"]),
+  route("pet-fruits", "精灵果实", ["精灵果实", "果实", "pet-fruit"], "/api/v1/games/rocom/wiki/pet-fruits/{item_id}", ["item_id"]),
+  route("pet-foods", "精灵食物", ["精灵食物", "食物", "pet-food"], "/api/v1/games/rocom/wiki/pet-foods/{item_id}", ["item_id"]),
+  route("pet-gifts", "精灵礼物", ["精灵礼物", "礼物", "pet-gift"], "/api/v1/games/rocom/wiki/pet-gifts/{item_id}", ["item_id"]),
+  route("pet-close-level-effects", "亲密等级效果", ["亲密等级", "亲密效果"], "", ["level"], false),
+  route("pet-action-close-exp", "行为亲密经验", ["行为亲密", "亲密经验"], "", [], false),
+  route("home-egg-lay-rates", "家园产蛋概率", ["家园产蛋", "产蛋概率"], "", [], false),
+  route("home-progression", "家园成长", ["家园成长", "家园升级"], "", [], false),
+  route("pet-levels", "精灵等级经验", ["精灵等级", "等级经验", "pet-level"], "/api/v1/games/rocom/wiki/pet-levels/{level}", ["level"], false),
+  route("handbook-areas", "图鉴区域", ["图鉴区域", "区域图鉴"], "", ["id"], false),
+  route("fruit-trees", "果实树", ["果实树", "树"], "/api/v1/games/rocom/wiki/fruit-trees/{tree_id}", ["tree_id"]),
+  route("fruit-refresh", "果实刷新精灵", ["果实刷新", "刷新精灵"], "/api/v1/games/rocom/wiki/fruit-refresh/{fruit_item_id}", ["fruit_item_id"], false),
+  route("medals", "奖章", ["奖章", "勋章", "medal"], "/api/v1/games/rocom/wiki/medals/{medal_id}", ["medal_id"]),
+  route("recipes", "食谱", ["食谱", "料理", "recipe"], "/api/v1/games/rocom/wiki/recipes/{item_id}", ["item_id"]),
+  route("balls", "咕噜球", ["咕噜球", "球", "ball"], "/api/v1/games/rocom/wiki/balls/{ball_id}", ["ball_id"]),
+  route("plants", "种植", ["种植", "作物", "植物", "plant"], "/api/v1/games/rocom/wiki/plants/{plant_id}", ["plant_id"]),
+  route("pet-carryons", "精灵携带物", ["精灵携带物", "携带物", "carryon"], "/api/v1/games/rocom/wiki/pet-carryons/{carryon_id}", ["carryon_id"]),
+  route("furniture", "家具", ["家具", "furniture"], "/api/v1/games/rocom/wiki/furniture/{furniture_id}", ["furniture_id"]),
+  route("fashion", "服装套装", ["服装", "套装", "fashion"], "/api/v1/games/rocom/wiki/fashion/{suit_id}", ["suit_id"]),
+  route("regions", "地区", ["地区", "区域", "region"], "/api/v1/games/rocom/wiki/regions/{region_id}", ["region_id"]),
+  route("dungeons", "副本", ["副本", "dungeon"], "/api/v1/games/rocom/wiki/dungeons/{dungeon_id}", ["dungeon_id"]),
+  route("mails", "邮件模板", ["邮件", "邮件模板", "mail"], "/api/v1/games/rocom/wiki/mails/{mail_id}", ["mail_id"]),
+  route("music", "音乐", ["音乐", "music"], "/api/v1/games/rocom/wiki/music/{music_id}", ["music_id"]),
+  route("profile-assets", "个人名片资产", ["名片", "名片资产", "profile-asset"], "/api/v1/games/rocom/wiki/profile-assets/{asset_type}/{asset_id}", ["asset_type", "asset_id"]),
+  route("chat-emojis", "聊天表情", ["表情", "聊天表情", "emoji"], "/api/v1/games/rocom/wiki/chat-emojis/{emoji_id}", ["emoji_id"]),
+  route("photo-actions", "拍照动作", ["拍照动作", "动作", "photo-action"], "/api/v1/games/rocom/wiki/photo-actions/{action_type}/{action_id}", ["action_type", "action_id"]),
+  route("tasks", "任务", ["任务", "task"], "/api/v1/games/rocom/wiki/tasks/{task_id}", ["task_id"]),
+  route("task-summaries", "剧情摘要", ["剧情", "剧情摘要", "task-summary"], "/api/v1/games/rocom/wiki/task-summaries/{summary_id}", ["summary_id"]),
+  route("shops", "商店", ["商店", "shop"], "/api/v1/games/rocom/wiki/shops/{shop_id}", ["shop_id"]),
+  route("exchanges", "兑换", ["兑换", "exchange"], "/api/v1/games/rocom/wiki/exchanges/{exchange_id}", ["exchange_id"])
+];
+var WIKI_CATALOG_ROUTES_BY_KEY = new Map(WIKI_CATALOG_ROUTES.map((item) => [item.key, item]));
+var WIKI_CATALOG_ROUTES_BY_ALIAS = /* @__PURE__ */ new Map();
+for (const item of WIKI_CATALOG_ROUTES) {
+  for (const alias of [item.key, item.title, ...item.aliases]) {
+    WIKI_CATALOG_ROUTES_BY_ALIAS.set(alias.toLowerCase(), item);
+  }
+}
+var WIKI_GLOBAL_PRIORITIES = {
+  "pets": 0,
+  "skills": 0,
+  "balls": 1,
+  "pet-carryons": 1,
+  "medals": 1,
+  "plants": 1,
+  "pet-fruits": 1,
+  "recipes": 1,
+  "pet-eggs": 1,
+  "random-eggs": 1,
+  "egg-items": 1,
+  "skill-stones": 1,
+  "skill-stone-recipes": 1,
+  "pet-foods": 1,
+  "pet-gifts": 1,
+  "furniture": 1,
+  "fashion": 1,
+  "regions": 1,
+  "dungeons": 1,
+  "tasks": 1,
+  "task-summaries": 1,
+  "shops": 1,
+  "exchanges": 1,
+  "mails": 2,
+  "music": 2,
+  "chat-emojis": 2,
+  "photo-actions": 2,
+  "items": 3,
+  "profile-assets": 4
+};
+function wikiGlobalCatalogPriority(catalog) {
+  const key = String(catalog?.key || "");
+  return WIKI_GLOBAL_PRIORITIES[key] ?? 2;
+}
+__name(wikiGlobalCatalogPriority, "wikiGlobalCatalogPriority");
+var WIKI_KEY_LABELS = {
+  pet_id: "精灵ID",
+  skill_id: "技能ID",
+  item_id: "物品ID",
+  item_kind: "物品类型",
+  egg_conf_id: "蛋配置ID",
+  random_egg_id: "随机蛋ID",
+  tree_id: "果实树ID",
+  medal_id: "奖章ID",
+  ball_id: "咕噜球ID",
+  plant_id: "种植ID",
+  carryon_id: "携带物ID",
+  furniture_id: "家具ID",
+  suit_id: "套装ID",
+  region_id: "地区ID",
+  dungeon_id: "副本ID",
+  mail_id: "邮件ID",
+  music_id: "音乐ID",
+  asset_type: "资产类型",
+  asset_id: "资产ID",
+  emoji_id: "表情ID",
+  action_type: "动作类型",
+  action_id: "动作ID",
+  task_id: "任务ID",
+  summary_id: "剧情ID",
+  shop_id: "商店ID",
+  exchange_id: "兑换ID",
+  handbook_no: "图鉴编号",
+  stage: "阶段",
+  quality: "品质",
+  cost: "能量",
+  power: "威力",
+  level: "等级",
+  total_exp: "累计经验",
+  next_level_exp: "升级所需",
+  next_level_total_exp: "下级累计",
+  hatch_label: "孵化时间",
+  hatch_seconds: "孵化秒数",
+  egg_type: "蛋类型",
+  egg_size: "蛋尺寸",
+  body_size: "体型",
+  type: "类型",
+  skill_type: "技能类型",
+  damage_type: "伤害类型",
+  element_type: "属性",
+  label_type: "标签",
+  families: "技能族",
+  pet_count: "可用精灵",
+  learnable_pet_count: "可学习精灵",
+  food_close_exp: "亲密经验",
+  close_exp: "亲密经验",
+  home_exp_num: "家园经验",
+  furniture_coin_num: "家具币",
+  need_time_label: "制作时间",
+  interaction_count: "交互次数",
+  comfort: "舒适度",
+  footprint: "占地",
+  gender: "性别",
+  grade: "品级",
+  bond: "羁绊",
+  category: "分类",
+  area: "区域",
+  source: "来源",
+  source_label: "来源",
+  summary: "摘要",
+  description: "说明",
+  flavor_text: "背景说明",
+  enabled: "启用",
+  banned: "禁用",
+  shareable: "可分享",
+  common: "通用",
+  nest_num: "巢穴数",
+  egg_laying_nest_num: "产蛋巢数",
+  pet_lay_egg_rate_percent: "产蛋概率",
+  close_level: "亲密等级",
+  action_label: "行为"
+};
+function wikiLabelForKey(key) {
+  return WIKI_KEY_LABELS[String(key || "")] || String(key || "").replace(/_/g, " ");
+}
+__name(wikiLabelForKey, "wikiLabelForKey");
+var WIKI_SECTION_TITLES = {
+  items: "条目",
+  members: "家族成员",
+  probabilities: "概率信息",
+  variants: "蛋型变体",
+  voice_percent: "语音概率",
+  topics: "图鉴课题",
+  rewards: "奖励",
+  reward_items: "奖励",
+  acquire_methods: "获取方式",
+  acquisition: "获取方式",
+  methods: "获取方式",
+  sources: "来源",
+  world_maps: "世界地图",
+  habitats: "栖息地",
+  effects: "效果",
+  rules: "规则",
+  parts: "套装部件",
+  tags: "标签",
+  goods: "商品",
+  mall_items: "商城商品",
+  get_items: "获得物品",
+  cost_items: "消耗物品",
+  comfort_levels: "舒适度收益",
+  levels: "等级成长",
+  pet_bond_counts: "精灵羁绊",
+  pet_home_limits: "入驻上限",
+  settled_bonuses: "入驻加成",
+  enjoy_field_types: "喜欢场景",
+  hate_field_types: "讨厌场景",
+  npc_reactions: "NPC 反应",
+  movements: "骑乘动作",
+  blood: "血脉技能",
+  level: "升级习得",
+  machine: "技能石习得",
+  field: "场景习得"
+};
+function wikiSectionTitle(key) {
+  return WIKI_SECTION_TITLES[String(key || "")] || wikiLabelForKey(key);
+}
+__name(wikiSectionTitle, "wikiSectionTitle");
+
+// src/wiki-service.ts
+var logger5 = new import_koishi5.Logger("rocom-wiki");
+var COPYRIGHT = "Koishi & WeGame 洛克王国插件";
+function normalizeQueryText(text) {
+  return String(text ?? "").replace(/\s+/g, "").trim().toLowerCase();
+}
+__name(normalizeQueryText, "normalizeQueryText");
+function wikiNamedValue(value) {
+  if (value && typeof value === "object" && !Array.isArray(value)) {
+    return String(value.name || value.label || value.value || "");
+  }
+  return String(value ?? "");
+}
+__name(wikiNamedValue, "wikiNamedValue");
+function wikiNames(values) {
+  if (!values) return [];
+  const list = Array.isArray(values) ? values : [values];
+  const result = [];
+  for (const value of list) {
+    const text = wikiNamedValue(value).trim();
+    if (text) result.push(text);
+  }
+  return result;
+}
+__name(wikiNames, "wikiNames");
+function wikiRangeLabel(data, keyMin, keyMax, unit) {
+  if (!data || typeof data !== "object") return "暂无";
+  const low = data[keyMin];
+  const high = data[keyMax];
+  const empty = /* @__PURE__ */ __name((v) => v === void 0 || v === null || v === "", "empty");
+  if (empty(low) && empty(high)) return "暂无";
+  if (empty(low)) return `${high}${unit}`;
+  if (empty(high) || low === high) return `${low}${unit}`;
+  return `${low}-${high}${unit}`;
+}
+__name(wikiRangeLabel, "wikiRangeLabel");
+function similarityRatio(a, b) {
+  if (!a || !b) return 0;
+  if (a === b) return 1;
+  const lenA = a.length;
+  const lenB = b.length;
+  const dp = Array.from({ length: lenB + 1 }, (_, j) => j);
+  for (let i = 1; i <= lenA; i++) {
+    let prev = dp[0];
+    dp[0] = i;
+    for (let j = 1; j <= lenB; j++) {
+      const temp = dp[j];
+      dp[j] = a[i - 1] === b[j - 1] ? prev : Math.min(prev, dp[j - 1], dp[j]) + 1;
+      prev = temp;
+    }
+  }
+  return 1 - dp[lenB] / Math.max(lenA, lenB);
+}
+__name(similarityRatio, "similarityRatio");
+function wikiSimilarityScore(query, item) {
+  const normalizedQuery = normalizeQueryText(query);
+  if (!normalizedQuery) return 0;
+  const candidates = [
+    wikiTitleForItem(item, ""),
+    item?.name || "",
+    item?.summary || "",
+    item?.description || item?.desc || ""
+  ];
+  let best = 0;
+  for (const text of candidates) {
+    const normalizedText = normalizeQueryText(text);
+    if (!normalizedText) continue;
+    if (normalizedQuery === normalizedText) best = Math.max(best, 1);
+    else if (normalizedText.includes(normalizedQuery) || normalizedQuery.includes(normalizedText)) best = Math.max(best, 0.82);
+    else best = Math.max(best, similarityRatio(normalizedQuery, normalizedText));
+  }
+  return best;
+}
+__name(wikiSimilarityScore, "wikiSimilarityScore");
+function wikiGenericValue(value, depth = 0) {
+  if (value === void 0 || value === null || value === "") return "";
+  if (typeof value === "boolean") return value ? "是" : "否";
+  if (typeof value === "number") return String(value);
+  if (Array.isArray(value)) {
+    const texts = value.slice(0, 6).map((item) => wikiGenericValue(item, depth + 1)).filter(Boolean);
+    const suffix = value.length > 6 ? " ..." : "";
+    return texts.join("、") + suffix;
+  }
+  if (typeof value === "object") {
+    for (const key of ["name", "label", "title", "summary", "description", "text"]) {
+      const text = String(value[key] || "").trim();
+      if (text) return text;
+    }
+    if ("min_m" in value || "max_m" in value) return wikiRangeLabel(value, "min_m", "max_m", "m");
+    if ("min_kg" in value || "max_kg" in value) return wikiRangeLabel(value, "min_kg", "max_kg", "kg");
+    if (depth >= 1) {
+      const pairs = [];
+      for (const [key, item] of Object.entries(value).slice(0, 4)) {
+        const text = wikiGenericValue(item, depth + 1);
+        if (text) pairs.push(`${wikiLabelForKey(key)}：${text}`);
+      }
+      return pairs.join("；");
+    }
+    return "";
+  }
+  return String(value);
+}
+__name(wikiGenericValue, "wikiGenericValue");
+function wikiSizeLabel(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return wikiGenericValue(value);
+  const parts = [];
+  if (value.height && typeof value.height === "object") {
+    const text = wikiRangeLabel(value.height, "min_m", "max_m", "m");
+    if (text && text !== "暂无") parts.push(`高 ${text}`);
+  }
+  if (value.weight && typeof value.weight === "object") {
+    const text = wikiRangeLabel(value.weight, "min_kg", "max_kg", "kg");
+    if (text && text !== "暂无") parts.push(`重 ${text}`);
+  }
+  return parts.join(" / ");
+}
+__name(wikiSizeLabel, "wikiSizeLabel");
+function wikiFootprintLabel(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return wikiGenericValue(value);
+  const width = value.width ?? value.x ?? value.cols;
+  const height = value.height ?? value.y ?? value.rows;
+  if (width !== void 0 && width !== null && width !== "" && height !== void 0 && height !== null && height !== "") {
+    return `${width} x ${height}`;
+  }
+  return wikiGenericValue(value, 1);
+}
+__name(wikiFootprintLabel, "wikiFootprintLabel");
+function wikiCountLabel(value, unit = "个") {
+  if (Array.isArray(value)) return `${value.length}${unit}`;
+  if (value === void 0 || value === null || value === "") return "";
+  return typeof value === "number" ? `${value}${unit}` : String(value);
+}
+__name(wikiCountLabel, "wikiCountLabel");
+function wikiPickImage(item) {
+  const imageKeys = [
+    "big_icon",
+    "image",
+    "cover_image",
+    "preview_image",
+    "checkout_icon",
+    "icon",
+    "small_icon",
+    "background_image",
+    "display_image",
+    "package_bg",
+    "package_cover"
+  ];
+  for (const key of imageKeys) {
+    const value = item?.[key];
+    if (typeof value === "string" && /^(https?:\/\/|\{\{)/.test(value)) return value;
+    if (value && typeof value === "object") {
+      const url = value.url || value.image || value.icon;
+      if (typeof url === "string" && /^(https?:\/\/|\{\{)/.test(url)) return url;
+    }
+  }
+  return "";
+}
+__name(wikiPickImage, "wikiPickImage");
+function wikiTitleForItem(item, fallback = "Wiki 条目") {
+  for (const key of ["name", "title", "display_name", "summary", "description"]) {
+    const value = String(item?.[key] || "").trim();
+    if (value) return value.slice(0, 48);
+  }
+  for (const key of [
+    "pet_id",
+    "skill_id",
+    "item_id",
+    "egg_conf_id",
+    "random_egg_id",
+    "tree_id",
+    "medal_id",
+    "ball_id",
+    "plant_id",
+    "furniture_id",
+    "suit_id",
+    "region_id",
+    "dungeon_id",
+    "mail_id",
+    "music_id",
+    "task_id",
+    "shop_id",
+    "exchange_id",
+    "id"
+  ]) {
+    const value = item?.[key];
+    if (value !== void 0 && value !== null && value !== "") return `${fallback} #${value}`;
+  }
+  return fallback;
+}
+__name(wikiTitleForItem, "wikiTitleForItem");
+function wikiSummaryForItem(item) {
+  for (const key of ["summary", "description", "desc", "effect", "flavor_text", "text", "content"]) {
+    const value = wikiGenericValue(item?.[key]);
+    if (value) return value.slice(0, 180);
+  }
+  return "";
+}
+__name(wikiSummaryForItem, "wikiSummaryForItem");
+function wikiBadgesForItem(item) {
+  const badges = [];
+  for (const key of ["type", "skill_type", "damage_type", "element_type", "category", "quality", "rarity", "label_type", "egg_type", "grade", "gender"]) {
+    const value = wikiGenericValue(item?.[key]);
+    if (value) badges.push(value);
+  }
+  for (const badge of item?.badges || []) {
+    const value = wikiGenericValue(badge);
+    if (value) badges.push(value);
+  }
+  for (const key of ["type_names", "egg_group_names", "tags", "source_counts"]) {
+    badges.push(...wikiNames(item?.[key]).slice(0, 4));
+  }
+  const output = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const badge of badges) {
+    const key = String(badge);
+    if (key && !seen.has(key)) {
+      output.push(key);
+      seen.add(key);
+    }
+  }
+  return output.slice(0, 8);
+}
+__name(wikiBadgesForItem, "wikiBadgesForItem");
+function wikiAddFact(rows, label, value) {
+  const text = wikiGenericValue(value);
+  if (text) rows.push({ label, value: text.slice(0, 96) });
+}
+__name(wikiAddFact, "wikiAddFact");
+function wikiMetaForItem(item, limit = 12, catalogKey = "") {
+  const rows = [];
+  if (catalogKey === "pets") {
+    wikiAddFact(rows, "图鉴编号", item?.handbook_no);
+    wikiAddFact(rows, "精灵ID", item?.pet_id);
+    wikiAddFact(rows, "属性", item?.type_names || item?.types);
+    wikiAddFact(rows, "蛋组", item?.egg_group_names || item?.egg_groups);
+  } else if (catalogKey === "skills") {
+    wikiAddFact(rows, "技能ID", item?.skill_id);
+    wikiAddFact(rows, "属性", item?.element_type || item?.type);
+    wikiAddFact(rows, "类型", item?.skill_type || item?.damage_type);
+    wikiAddFact(rows, "威力 / 能量", `${item?.power ?? "-"} / ${item?.cost ?? "-"}`);
+    wikiAddFact(rows, "可用精灵", item?.pet_count);
+  } else if (["pet-eggs", "egg-items", "random-eggs", "pet-egg"].includes(catalogKey)) {
+    wikiAddFact(rows, "蛋ID", item?.egg_conf_id || item?.random_egg_id || item?.item_id);
+    wikiAddFact(rows, "蛋类型", item?.egg_type);
+    wikiAddFact(rows, "孵化时间", item?.hatch_label);
+    wikiAddFact(rows, "尺寸", wikiSizeLabel(item?.egg_size));
+    wikiAddFact(rows, "关联精灵", item?.pet);
+  } else if (["pet-foods", "pet-gifts"].includes(catalogKey)) {
+    wikiAddFact(rows, "物品ID", item?.item_id);
+    wikiAddFact(rows, "亲密经验", item?.food_close_exp || item?.close_exp);
+    wikiAddFact(rows, "家园经验", item?.home_exp_num);
+    wikiAddFact(rows, "制作时间", item?.need_time_label);
+    wikiAddFact(rows, "交互次数", item?.interaction_count);
+  } else if (catalogKey === "home-egg-lay-rates") {
+    wikiAddFact(rows, "巢穴数", item?.nest_num);
+    wikiAddFact(rows, "产蛋巢", item?.egg_laying_nest_num);
+    const rate = item?.pet_lay_egg_rate_percent;
+    wikiAddFact(rows, "产蛋概率", rate !== void 0 && rate !== null && rate !== "" ? `${rate}%` : "");
+  } else if (catalogKey === "pet-levels") {
+    wikiAddFact(rows, "等级", item?.level);
+    wikiAddFact(rows, "累计经验", item?.total_exp);
+    wikiAddFact(rows, "下级所需", item?.next_level_exp);
+  } else if (catalogKey === "furniture") {
+    wikiAddFact(rows, "家具ID", item?.furniture_id);
+    wikiAddFact(rows, "分类", item?.category);
+    wikiAddFact(rows, "舒适度", item?.comfort);
+    wikiAddFact(rows, "占地", wikiFootprintLabel(item?.footprint));
+  } else if (catalogKey === "fashion") {
+    wikiAddFact(rows, "套装ID", item?.suit_id);
+    wikiAddFact(rows, "性别", item?.gender);
+    wikiAddFact(rows, "品级", item?.grade);
+    wikiAddFact(rows, "部件", wikiCountLabel(item?.parts));
+  } else if (catalogKey === "exchanges") {
+    wikiAddFact(rows, "兑换ID", item?.exchange_id);
+    wikiAddFact(rows, "获得", item?.get_items);
+    wikiAddFact(rows, "消耗", item?.cost_items);
+  } else if (catalogKey === "shops") {
+    wikiAddFact(rows, "商店ID", item?.shop_id);
+    wikiAddFact(rows, "页签", item?.tab_name);
+    wikiAddFact(rows, "商品数", wikiCountLabel(item?.goods));
+  } else if (["skill-stones", "skill-stone-recipes", "items", "pet-fruits", "recipes", "balls", "plants", "pet-carryons", "medals"].includes(catalogKey)) {
+    wikiAddFact(rows, "物品ID", item?.item_id || item?.medal_id || item?.ball_id || item?.plant_id || item?.carryon_id);
+    wikiAddFact(rows, "类型", item?.type || item?.label_type);
+    wikiAddFact(rows, "品质", item?.quality);
+    wikiAddFact(rows, "效果", item?.summary || item?.catch_effect || item?.carryon);
+  } else {
+    for (const key of [
+      "pet_id",
+      "skill_id",
+      "item_id",
+      "tree_id",
+      "level",
+      "close_level",
+      "action_label",
+      "region_id",
+      "dungeon_id",
+      "mail_id",
+      "music_id",
+      "emoji_id",
+      "task_id",
+      "summary_id",
+      "asset_type",
+      "asset_id",
+      "action_type",
+      "action_id",
+      "quality",
+      "type",
+      "category"
+    ]) {
+      if (item && key in item) wikiAddFact(rows, wikiLabelForKey(key), item[key]);
+    }
+  }
+  if (rows.length) return rows.slice(0, limit);
+  const skip = /* @__PURE__ */ new Set([
+    "name",
+    "title",
+    "description",
+    "desc",
+    "summary",
+    "icon",
+    "small_icon",
+    "big_icon",
+    "image",
+    "cover_image",
+    "preview_image",
+    "background_image",
+    "items",
+    "rewards",
+    "reward_items",
+    "tags",
+    "badges",
+    "catalog"
+  ]);
+  for (const [key, value] of Object.entries(item || {})) {
+    if (skip.has(key)) continue;
+    const text = wikiGenericValue(value);
+    if (!text) continue;
+    rows.push({ label: wikiLabelForKey(key), value: text.slice(0, 80) });
+    if (rows.length >= limit) break;
+  }
+  return rows;
+}
+__name(wikiMetaForItem, "wikiMetaForItem");
+function wikiCardForItem(item, fallback, catalog) {
+  const catalogKey = String(catalog?.key || "");
+  return {
+    title: wikiTitleForItem(item, fallback),
+    image: wikiPickImage(item),
+    summary: wikiSummaryForItem(item),
+    badges: wikiBadgesForItem(item),
+    meta: wikiMetaForItem(item, 5, catalogKey)
+  };
+}
+__name(wikiCardForItem, "wikiCardForItem");
+function wikiRowsFromDict(value, limit = 16) {
+  const rows = [];
+  for (const [key, item] of Object.entries(value)) {
+    if (["icon", "small_icon", "big_icon", "image", "display_image"].includes(key)) continue;
+    const text = wikiGenericValue(item);
+    if (text) rows.push({ label: wikiLabelForKey(key), value: text.slice(0, 120) });
+    if (rows.length >= limit) break;
+  }
+  return rows;
+}
+__name(wikiRowsFromDict, "wikiRowsFromDict");
+function wikiSectionsForPayload(payload, catalog) {
+  if (!payload || typeof payload !== "object" || Array.isArray(payload)) return [];
+  const sections = [];
+  const addList = /* @__PURE__ */ __name((title, value) => {
+    if (!Array.isArray(value) || !value.length) return;
+    const dictItems = value.filter((item) => item && typeof item === "object" && !Array.isArray(item));
+    if (dictItems.length) {
+      sections.push({
+        title,
+        cards: dictItems.slice(0, 12).map((item) => wikiCardForItem(item, title, catalog)),
+        rows: [],
+        total: dictItems.length
+      });
+      return;
+    }
+    const texts = value.slice(0, 16).map((item) => wikiGenericValue(item)).filter(Boolean);
+    if (!texts.length) return;
+    sections.push({
+      title,
+      cards: [],
+      rows: texts.map((text, idx) => ({ label: String(idx + 1), value: text })),
+      total: texts.length
+    });
+  }, "addList");
+  for (const [key, value] of Object.entries(payload)) {
+    const title = wikiSectionTitle(key);
+    if (value && typeof value === "object" && !Array.isArray(value) && ["probabilities", "npc_reactions", "catch_effect", "carryon", "planting", "limit", "bond", "mall_package"].includes(key)) {
+      const rows = wikiRowsFromDict(value);
+      if (rows.length) sections.push({ title, cards: [], rows, total: rows.length });
+      continue;
+    }
+    addList(title, value);
+    if (value && typeof value === "object" && !Array.isArray(value)) {
+      for (const [subkey, subvalue] of Object.entries(value)) {
+        addList(`${title} / ${wikiSectionTitle(subkey)}`, subvalue);
+      }
+    }
+  }
+  return sections.slice(0, 8);
+}
+__name(wikiSectionsForPayload, "wikiSectionsForPayload");
+function findExactWikiMatch(results, query) {
+  const normalizedQuery = normalizeQueryText(query);
+  if (!normalizedQuery) return null;
+  for (const item of results) {
+    const name2 = String(item?.name || "");
+    const form = String(item?.form || "");
+    const candidates = [
+      normalizeQueryText(name2),
+      normalizeQueryText(`${name2}${form}`),
+      normalizeQueryText(`${name2} ${form}`),
+      normalizeQueryText(`${form}${name2}`)
+    ];
+    if (candidates.includes(normalizedQuery)) return item;
+  }
+  return null;
+}
+__name(findExactWikiMatch, "findExactWikiMatch");
+function wikiCandidateText(query, items, kind) {
+  const lines = [`找到多个${kind}候选，请使用更精确名称：`];
+  items.slice(0, 10).forEach((item, idx) => {
+    const name2 = item?.name || "未知";
+    const form = item?.form || "";
+    const itemId = item?.pet_id || item?.skill_id || item?.id || "-";
+    const suffix = form && form !== "普通" ? `（${form}）` : "";
+    lines.push(`${idx + 1}. ${name2}${suffix} #${itemId}`);
+  });
+  lines.push(`
+你查询的是：${query}`);
+  return lines.join("\n");
+}
+__name(wikiCandidateText, "wikiCandidateText");
+function wikiBodySize(...sources) {
+  let bodySize = {};
+  for (const source of sources) {
+    if (source && typeof source === "object" && source.body_size && typeof source.body_size === "object") {
+      bodySize = source.body_size;
+      break;
+    }
+  }
+  return {
+    height: wikiRangeLabel(bodySize?.height, "min_m", "max_m", "m"),
+    weight: wikiRangeLabel(bodySize?.weight, "min_kg", "max_kg", "kg")
+  };
+}
+__name(wikiBodySize, "wikiBodySize");
+function wikiGenderLabel(value) {
+  if (value && typeof value === "object" && !Array.isArray(value)) {
+    const parts = [];
+    if (value.male_percent !== void 0 && value.male_percent !== null && value.male_percent !== "") parts.push(`雄 ${value.male_percent}%`);
+    if (value.female_percent !== void 0 && value.female_percent !== null && value.female_percent !== "") parts.push(`雌 ${value.female_percent}%`);
+    return parts.length ? parts.join(" / ") : "暂无";
+  }
+  return String(value || "暂无");
+}
+__name(wikiGenderLabel, "wikiGenderLabel");
+function wikiEcologyLabel(value, fallback = "") {
+  if (value && typeof value === "object" && !Array.isArray(value)) {
+    const parts = [];
+    for (const key of ["pet_text", "pet_style"]) {
+      const text = String(value[key] || "").trim();
+      if (text) parts.push(text);
+    }
+    const habitats = wikiNames(value.habitats);
+    if (habitats.length) parts.push("栖息：" + habitats.join(" / "));
+    return parts.join("；");
+  }
+  return String(value || fallback || "").trim();
+}
+__name(wikiEcologyLabel, "wikiEcologyLabel");
+function wikiSourceLabel(source, fallback = "") {
+  const mapping = { level: "升级", machine: "技能石", blood: "血脉", field: "特殊来源" };
+  const text = String(source || "").trim();
+  return String(fallback || mapping[text] || text || "");
+}
+__name(wikiSourceLabel, "wikiSourceLabel");
+function wikiTypeEffectiveness(profile) {
+  const data = profile?.type_effectiveness;
+  if (!data || typeof data !== "object") return [];
+  const rows = [];
+  const definitions = [
+    ["攻击克制", ["attack", "strong"]],
+    ["攻击弱效", ["attack", "weak"]],
+    ["防御弱点", ["defense", "weak"]],
+    ["防御抵抗", ["defense", "resist"]]
+  ];
+  for (const [label, [groupKey, itemKey]] of definitions) {
+    const group = data[groupKey] && typeof data[groupKey] === "object" ? data[groupKey] : {};
+    const names = wikiNames(group?.[itemKey]);
+    if (names.length) rows.push({ label, value: names.join(" / ") });
+  }
+  return rows;
+}
+__name(wikiTypeEffectiveness, "wikiTypeEffectiveness");
+function buildPetStats(profile) {
+  const attrs = profile?.attributes && typeof profile.attributes === "object" ? profile.attributes : {};
+  const defs = [
+    ["精力", "hp", "#42b883"],
+    ["物攻", "physical_attack", "#e86452"],
+    ["魔攻", "magic_attack", "#5987f5"],
+    ["物防", "physical_defense", "#d69a32"],
+    ["魔防", "magic_defense", "#25a6a6"],
+    ["速度", "speed", "#8d62d9"]
+  ];
+  return defs.map(([label, key, color]) => {
+    const value = Number(attrs[key]) || 0;
+    return { label, value, color, percent: Math.min(value / 160 * 100, 100) };
+  });
+}
+__name(buildPetStats, "buildPetStats");
+function buildPetSkillGroups(skillsData) {
+  const groups = [];
+  const sourceDefs = [
+    ["level", "升级习得"],
+    ["machine", "技能机"],
+    ["blood", "血脉技能"],
+    ["field", "场景习得"]
+  ];
+  for (const [key, label] of sourceDefs) {
+    const rawItems = Array.isArray(skillsData?.[key]) ? skillsData[key] : [];
+    const items = rawItems.slice(0, 10).map((skill) => ({
+      name: skill?.name || "未知技能",
+      icon: skill?.icon || "",
+      level: skill?.level || skill?.source_label || "",
+      type: wikiNamedValue(skill?.element_type || skill?.type) || "未知",
+      category: wikiNamedValue(skill?.skill_type) || wikiNamedValue(skill?.damage_type) || "未知",
+      cost: skill?.cost ?? "?",
+      power: skill?.power ?? "?",
+      desc: skill?.desc || skill?.description || skill?.flavor_text || "暂无说明"
+    }));
+    if (items.length) groups.push({ label, items });
+  }
+  return groups;
+}
+__name(buildPetSkillGroups, "buildPetSkillGroups");
+function buildPetFamily(familyData, currentId) {
+  let items = [];
+  if (familyData && typeof familyData === "object" && !Array.isArray(familyData)) {
+    if (Array.isArray(familyData.members)) items.push(...familyData.members);
+    for (const formGroup of familyData.forms || []) {
+      for (const member of formGroup?.members || []) {
+        const merged = { ...member };
+        if (formGroup?.name && !merged.form_group) merged.form_group = formGroup.name;
+        items.push(merged);
+      }
+    }
+    if (!items.length) {
+      for (const key of ["items", "family", "evolutions"]) {
+        if (Array.isArray(familyData[key])) {
+          items.push(...familyData[key]);
+          break;
+        }
+      }
+    }
+  } else if (Array.isArray(familyData)) {
+    items = familyData;
+  }
+  const result = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const item of items.slice(0, 12)) {
+    const petId = item?.pet_id ?? item?.id;
+    const key = String(petId ?? item?.name ?? "");
+    if (key && seen.has(key)) continue;
+    seen.add(key);
+    const conditionTexts = Array.isArray(item?.condition_texts) ? item.condition_texts : [];
+    result.push({
+      pet_id: petId ?? "-",
+      name: item?.name || "未知精灵",
+      form: item?.form || item?.form_group || "",
+      icon: item?.icon || item?.small_icon || "",
+      condition: item?.condition_summary || conditionTexts.filter(Boolean).join(" / ") || item?.evolution_description || item?.condition || item?.evolve_condition || item?.relation || "",
+      is_current: String(petId ?? "") === String(currentId ?? "")
+    });
+  }
+  return result;
+}
+__name(buildPetFamily, "buildPetFamily");
+function buildHandbookTopics(handbookData) {
+  const topics = Array.isArray(handbookData?.topics) ? handbookData.topics : [];
+  const result = [];
+  for (const item of topics.slice(0, 8)) {
+    const rewards = [];
+    let rewardItems = item?.rewards || item?.reward_items;
+    if (!rewardItems && item?.reward && typeof item.reward === "object") rewardItems = item.reward.items;
+    for (const reward of rewardItems || []) {
+      rewards.push({
+        name: reward?.name || "奖励",
+        count: reward?.count || "",
+        icon: reward?.icon || ""
+      });
+    }
+    result.push({
+      name: item?.name || item?.title || `课题 ${item?.topic_id || ""}`.trim(),
+      desc: item?.description || item?.desc || "",
+      rewards: rewards.slice(0, 4)
+    });
+  }
+  return result;
+}
+__name(buildHandbookTopics, "buildHandbookTopics");
+function buildWikiPetRenderData(overview, profile, skills, family, handbook, query) {
+  profile = profile || {};
+  skills = skills || {};
+  family = family || {};
+  handbook = handbook || {};
+  const petId = overview?.pet_id ?? profile?.pet_id;
+  const typeNames = wikiNames(overview?.type_names || overview?.types);
+  const eggGroups = wikiNames(overview?.egg_group_names || overview?.egg_groups);
+  const feature = overview?.feature || {};
+  const bodySize = wikiBodySize(profile, overview);
+  const stats = buildPetStats(profile);
+  const totalStats = profile?.attributes?.sum || stats.reduce((sum, item) => sum + item.value, 0);
+  const form = overview?.form || profile?.form || "";
+  const classis = wikiNamedValue(overview?.classis) || "暂无";
+  const habitats = wikiNames(profile?.habitats);
+  const areas = wikiNames(handbook?.areas);
+  return {
+    name: overview?.name || profile?.name || query,
+    query,
+    pet_id: petId ?? "-",
+    number: overview?.handbook_no || profile?.handbook_no || "---",
+    form,
+    formLine: `${form || "普通"}${classis && classis !== "暂无" ? ` · ${classis}` : ""}`,
+    quality: overview?.quality || profile?.quality || "",
+    stage: overview?.stage || profile?.stage || "",
+    pet_icon: overview?.icon || overview?.small_icon || "",
+    main_image: profile?.small_icon || overview?.small_icon || profile?.icon || overview?.icon || "",
+    type_names: typeNames,
+    egg_groups: eggGroups,
+    description: profile?.description || overview?.description || "暂无图鉴描述",
+    classis,
+    feature_name: feature?.name || "暂无",
+    feature_desc: feature?.desc || "暂无特性说明",
+    ride_talent: overview?.has_ride_talent ? "支持" : "不支持",
+    height_label: bodySize.height,
+    weight_label: bodySize.weight,
+    gender_ratio: wikiGenderLabel(profile?.gender_ratio),
+    move_type: profile?.move_type || "暂无",
+    habitats,
+    habitatsLabel: habitats.length ? habitats.join(" / ") : "暂无",
+    ecology: wikiEcologyLabel(profile?.ecology, profile?.pet_style),
+    type_effectiveness: wikiTypeEffectiveness(profile),
+    total_stats: totalStats,
+    pet_stats: stats,
+    skill_groups: buildPetSkillGroups(skills),
+    family_members: buildPetFamily(family, petId),
+    handbook_topics: buildHandbookTopics(handbook),
+    areas,
+    areasLabel: areas.join(" / "),
+    commandHint: "💡 洛克wiki <类型> <关键词或ID> | 示例：洛克wiki 技能 圣光斩",
+    copyright: COPYRIGHT
+  };
+}
+__name(buildWikiPetRenderData, "buildWikiPetRenderData");
+function buildWikiSkillRenderData(item, petsData, query) {
+  const pets = ((petsData || {}).items || []).slice(0, 30).map((pet) => {
+    const source = wikiSourceLabel(pet?.source, pet?.source_label);
+    const level = pet?.level || "";
+    return {
+      name: pet?.name || "未知精灵",
+      pet_id: pet?.pet_id ?? "-",
+      icon: pet?.icon || pet?.small_icon || "",
+      source,
+      level,
+      sourceLine: source || level ? `${source}${level ? ` · Lv.${level}` : ""}` : ""
+    };
+  });
+  const tags = (item?.tags || []).map((tag) => ({ name: tag?.name || "", icon: tag?.icon || "" }));
+  return {
+    name: item?.name || query,
+    skill_id: item?.skill_id ?? "-",
+    query,
+    icon: item?.icon || "",
+    type: wikiNamedValue(item?.type) || "未知",
+    skill_type: wikiNamedValue(item?.skill_type) || "未知",
+    damage_type: wikiNamedValue(item?.damage_type) || "未知",
+    element_type: wikiNamedValue(item?.element_type) || "未知",
+    cost: item?.cost ?? "?",
+    power: item?.power ?? "?",
+    families: item?.families || "暂无",
+    description: item?.description || "暂无说明",
+    flavor_text: item?.flavor_text || "",
+    tags,
+    pets,
+    pet_total: (petsData || {}).total || pets.length,
+    commandHint: "💡 洛克wiki 技能 <技能名或ID>",
+    copyright: COPYRIGHT
+  };
+}
+__name(buildWikiSkillRenderData, "buildWikiSkillRenderData");
+function splitWikiCommandParts(text) {
+  const parts = String(text || "").trim().split(/\s+/).filter(Boolean);
+  let pageNo = 1;
+  if (parts.length) {
+    const tail = parts[parts.length - 1];
+    const pageMatch = /^(?:(?:p|P|页|第)(\d+)(?:页)?|(\d+)页)$/.exec(tail);
+    if (pageMatch && parts.length > 1) {
+      const pageValue = pageMatch[1] || pageMatch[2];
+      pageNo = Math.max(parseInt(pageValue, 10), 1);
+      parts.pop();
+    }
+  }
+  return { parts, pageNo };
+}
+__name(splitWikiCommandParts, "splitWikiCommandParts");
+function wikiCatalogByToken(token) {
+  const text = String(token || "").trim().toLowerCase();
+  return WIKI_CATALOG_ROUTES_BY_ALIAS.get(text) || null;
+}
+__name(wikiCatalogByToken, "wikiCatalogByToken");
+var WikiService = class {
+  constructor(ctx, client) {
+    this.ctx = ctx;
+    this.client = client;
+  }
+  static {
+    __name(this, "WikiService");
+  }
+  catalogsCache = null;
+  catalogsCacheTs = 0;
+  optionsCache = null;
+  optionsCacheTs = 0;
+  skillDetailCache = /* @__PURE__ */ new Map();
+  petDetailCache = /* @__PURE__ */ new Map();
+  async getCatalogsPayload(force = false) {
+    const now = Date.now();
+    if (!force && this.catalogsCache !== null && now - this.catalogsCacheTs < 3e5) {
+      return this.catalogsCache;
+    }
+    const payload = await this.client.getWikiCatalogs(this.ctx);
+    if (payload && typeof payload === "object") {
+      this.catalogsCache = payload;
+      this.catalogsCacheTs = now;
+      return payload;
+    }
+    return this.catalogsCache || {};
+  }
+  async getOptionsPayload(force = false) {
+    const now = Date.now();
+    if (!force && this.optionsCache !== null && now - this.optionsCacheTs < 3e5) {
+      return this.optionsCache;
+    }
+    const payload = await this.client.getWikiOptions(this.ctx);
+    if (payload && typeof payload === "object") {
+      this.optionsCache = payload;
+      this.optionsCacheTs = now;
+      return payload;
+    }
+    return this.optionsCache || {};
+  }
+  backendCatalogItems(payload) {
+    if (!payload || typeof payload !== "object") return [];
+    const items = payload.items;
+    if (!Array.isArray(items)) return [];
+    return items.filter((item) => item && typeof item === "object");
+  }
+  catalogFromBackendItem(item) {
+    const key = String(item?.key || "").trim();
+    const base = WIKI_CATALOG_ROUTES_BY_KEY.get(key);
+    const catalog = base ? { ...base, aliases: [...base.aliases] } : { key, title: String(item?.name || key || "Wiki"), aliases: [], list_path: "", detail_path: "", id_fields: [], search: null };
+    const backendName = String(item?.name || "").trim();
+    if (backendName && !base) catalog.title = backendName;
+    for (const alias of [key, backendName, backendName.replace(/图鉴/g, "").trim()]) {
+      if (alias && !catalog.aliases.includes(alias)) catalog.aliases.push(alias);
+    }
+    const filters = Array.isArray(item?.filters) ? item.filters : [];
+    const hasQFilter = filters.some((f) => f && typeof f === "object" && f.key === "q");
+    const routeSearch = catalog.search;
+    catalog.search = routeSearch === null || routeSearch === void 0 ? hasQFilter : Boolean(routeSearch);
+    if (item?.path) catalog.list_path = String(item.path);
+    catalog._backend = item;
+    return catalog;
+  }
+  catalogForKeyFromPayload(key, catalogsPayload) {
+    const item = this.backendCatalogItems(catalogsPayload).find((it) => String(it?.key || "") === String(key || ""));
+    if (item) return this.catalogFromBackendItem(item);
+    const route2 = WIKI_CATALOG_ROUTES_BY_KEY.get(String(key || ""));
+    return route2 ? { ...route2, aliases: [...route2.aliases] } : null;
+  }
+  catalogsFromPayload(catalogsPayload) {
+    return this.backendCatalogItems(catalogsPayload).map((item) => this.catalogFromBackendItem(item));
+  }
+  async getCatalogByKey(key) {
+    return this.catalogForKeyFromPayload(key, await this.getCatalogsPayload());
+  }
+  dynamicCatalogByToken(token, catalogsPayload) {
+    const text = normalizeQueryText(token);
+    if (!text) return null;
+    for (const item of this.backendCatalogItems(catalogsPayload)) {
+      const candidates = [
+        item?.key,
+        item?.name,
+        String(item?.name || "").replace(/图鉴/g, "").trim()
+      ];
+      if (candidates.some((candidate) => candidate && normalizeQueryText(candidate) === text)) {
+        return this.catalogFromBackendItem(item);
+      }
+    }
+    return null;
+  }
+  parseWikiCommand(text) {
+    const trimmed = String(text || "").trim();
+    if (!trimmed) return { catalog: null, query: "", pageNo: 1 };
+    const { parts, pageNo } = splitWikiCommandParts(trimmed);
+    const catalog = parts.length ? wikiCatalogByToken(parts[0]) : null;
+    if (catalog) return { catalog: { ...catalog, aliases: [...catalog.aliases] }, query: parts.slice(1).join(" ").trim(), pageNo };
+    return { catalog: null, query: trimmed, pageNo };
+  }
+  catalogUsageText() {
+    const catalogs = this.catalogsFromPayload(this.catalogsCache || {});
+    const names = catalogs.slice(0, 24).map((item) => item.title || item.key).join("、");
+    return [
+      "Wiki 用法：",
+      "  洛克wiki <类型> [关键词或ID]",
+      "  洛克wiki <关键词或ID>",
+      "示例：洛克wiki 水灵、洛克wiki 技能 圣光斩、洛克wiki 物品 xx球、洛克wiki 种植 食谱名",
+      `后端目录：${names || "请稍后重试"}`
+    ].join("\n");
+  }
+  buildCatalogRenderData(catalogsPayload, optionsPayload) {
+    const catalogs = this.catalogsFromPayload(catalogsPayload);
+    const topicCard = /* @__PURE__ */ __name((catalog) => {
+      const backend = catalog._backend && typeof catalog._backend === "object" ? catalog._backend : {};
+      const filters = Array.isArray(backend.filters) ? backend.filters : [];
+      const filterText = filters.slice(0, 6).filter((item) => item && typeof item === "object").map((item) => String(item.label || item.key || "")).join("、");
+      const title = String(catalog.title || backend.name || catalog.key || "Wiki");
+      const key = String(catalog.key || "");
+      const count = backend.count;
+      let hint = `洛克wiki ${title} <关键词或ID>`;
+      if (key) hint = `${hint} / 洛克wiki ${key} <关键词或ID>`;
+      let coverage = String(backend.description || "").trim();
+      if (filterText) coverage = `${coverage} 筛选：${filterText}`.trim();
+      return {
+        title,
+        key,
+        summary: count !== void 0 && count !== null && count !== "" ? `${hint} · 条目 ${count}` : hint,
+        desc: key,
+        children: coverage
+      };
+    }, "topicCard");
+    const groups = [{
+      title: "后端 Wiki 图鉴入口",
+      desc: "",
+      items: catalogs.map(topicCard),
+      total: catalogs.length
+    }];
+    return {
+      title: "洛克 Wiki",
+      subtitle: "统一资料查询入口",
+      summary: "",
+      badges: [],
+      facts: [],
+      primary: [],
+      groups,
+      commandHint: "💡 示例：洛克wiki 水灵 | 洛克wiki 技能 圣光斩 | 洛克wiki 物品 国王球",
+      copyright: COPYRIGHT
+    };
+  }
+  globalSearchCatalogs(catalogsPayload) {
+    const catalogs = [];
+    const seen = /* @__PURE__ */ new Set();
+    for (const catalog of this.catalogsFromPayload(catalogsPayload)) {
+      const key = String(catalog.key || "");
+      if (seen.has(key) || !catalog.list_path || catalog.search === false) continue;
+      catalogs.push(catalog);
+      seen.add(key);
+    }
+    return catalogs;
+  }
+  resultCommandExamples(items, catalog, limit = 3) {
+    const examples = [];
+    const seen = /* @__PURE__ */ new Set();
+    for (const item of items) {
+      if (!item || typeof item !== "object") continue;
+      const child = this.catalogForKeyFromPayload(String(item._catalog_key || ""), this.catalogsCache || {}) || catalog || null;
+      const category = String(item._catalog_title || child?.title || "").trim();
+      const title = wikiTitleForItem(item, "").trim();
+      if (!category || !title) continue;
+      const command = `洛克wiki ${category} ${title}`;
+      if (seen.has(command)) continue;
+      examples.push(command);
+      seen.add(command);
+      if (examples.length >= limit) break;
+    }
+    return examples;
+  }
+  wikiPathParamsFromItem(catalog, item, rawText = "") {
+    const tokens = String(rawText || "").split(/\s+/).filter(Boolean);
+    const params = {};
+    const idFields = catalog.id_fields || [];
+    idFields.forEach((field, idx) => {
+      let value = item?.[field];
+      const empty = /* @__PURE__ */ __name((v) => v === void 0 || v === null || v === "", "empty");
+      if (empty(value) && ["item_id", "asset_id", "action_id"].includes(field)) value = item?.id;
+      if (empty(value) && ["ball_id", "plant_id", "carryon_id"].includes(field)) value = item?.item_id ?? item?.id;
+      if (empty(value) && idx < tokens.length) value = tokens[idx];
+      if (!empty(value)) params[field] = String(value);
+    });
+    return params;
+  }
+  fillDetailPath(catalog, params) {
+    let path7 = String(catalog.detail_path || "");
+    for (const field of catalog.id_fields || []) {
+      const value = params[field];
+      if (value === void 0 || value === null || value === "") return "";
+      path7 = path7.replace(`{${field}}`, String(value));
+    }
+    return path7;
+  }
+  itemMatchesQueryExact(catalog, item, query) {
+    const trimmed = String(query || "").trim();
+    if (!trimmed) return false;
+    const normalizedQuery = normalizeQueryText(trimmed);
+    for (const field of catalog.id_fields || []) {
+      let value = item?.[field];
+      if ((value === void 0 || value === null || value === "") && ["ball_id", "plant_id", "carryon_id"].includes(field)) {
+        value = item?.item_id ?? item?.id;
+      }
+      if (String(value ?? "") === trimmed) return true;
+    }
+    return normalizeQueryText(wikiTitleForItem(item, "")) === normalizedQuery;
+  }
+  findCatalogMatch(catalog, items, query, allowSingle = true) {
+    const trimmed = String(query || "").trim();
+    if (!trimmed) return null;
+    for (const item of items) {
+      if (this.itemMatchesQueryExact(catalog, item, trimmed)) return item;
+    }
+    if (allowSingle && items.length === 1) return items[0];
+    return null;
+  }
+  async suggestCatalogItems(catalog, query, limit = 10) {
+    if (!catalog || !catalog.list_path) return [];
+    const trimmed = String(query || "").trim();
+    if (!trimmed) return [];
+    const terms = [];
+    for (const term of [trimmed, trimmed.slice(0, 2), trimmed.slice(0, 1), trimmed.slice(0, -1)]) {
+      const cleaned = String(term || "").trim();
+      if (cleaned && !terms.includes(cleaned)) terms.push(cleaned);
+    }
+    const collected = /* @__PURE__ */ new Map();
+    for (const term of terms.slice(0, 4)) {
+      const res = await this.client.listWikiCatalogItems(
+        this.ctx,
+        catalog.list_path,
+        term,
+        1,
+        30,
+        Boolean(term && catalog.search !== false)
+      );
+      const items = res && typeof res === "object" ? res.items : [];
+      for (const item of items || []) {
+        if (!item || typeof item !== "object") continue;
+        const title = wikiTitleForItem(item, "");
+        const keyParts = [catalog.key || "", title];
+        for (const field of catalog.id_fields || []) {
+          if (item[field] !== void 0 && item[field] !== null && item[field] !== "") keyParts.push(String(item[field]));
+        }
+        const dedupeKey = keyParts.join("|");
+        if (!collected.has(dedupeKey)) collected.set(dedupeKey, item);
+      }
+      if (collected.size >= limit * 3) break;
+    }
+    const scored = [];
+    for (const item of collected.values()) {
+      const score = wikiSimilarityScore(trimmed, item);
+      if (score >= 0.18) scored.push([score, item]);
+    }
+    scored.sort((a, b) => b[0] - a[0]);
+    if (!scored.length) return [...collected.values()].slice(0, limit);
+    return scored.slice(0, limit).map(([, item]) => item);
+  }
+  buildGenericRenderData(catalog, payload, query, mode, pageNo = 1) {
+    payload = payload || {};
+    const fullCatalog = catalog;
+    if (mode === "global-search") {
+      const items = Array.isArray(payload?.items) ? payload.items : [];
+      const cards = [];
+      for (const item2 of items) {
+        if (!item2 || typeof item2 !== "object") continue;
+        const child = this.catalogForKeyFromPayload(String(item2._catalog_key || ""), this.catalogsCache || {}) || fullCatalog;
+        const card = wikiCardForItem(item2, child?.title || "Wiki", child);
+        if (item2._catalog_title) card.badges = [item2._catalog_title, ...card.badges];
+        cards.push(card);
+      }
+      return {
+        title: `全局搜索：${query}`,
+        subtitle: "Wiki / 全局搜索",
+        image: "",
+        summary: "未指定分类时，会在所有可搜索的大分类接口中使用后端 q 参数查询。",
+        badges: ["全局搜索", "可继续指定分类"],
+        facts: [
+          { label: "查询词", value: query || "-" },
+          { label: "结果数", value: String(payload?.total ?? cards.length) },
+          { label: "搜索接口", value: String(this.globalSearchCatalogs(this.catalogsCache || {}).length) }
+        ],
+        actionHint: "要查看具体条目，请按卡片绿色分类 tag 加名称继续查询。",
+        actionExamples: this.resultCommandExamples(items, fullCatalog),
+        cards,
+        sections: [],
+        commandHint: "💡 结果过多时可指定分类，例如 洛克wiki 技能 水花 或 洛克wiki 物品 国王球",
+        copyright: COPYRIGHT
+      };
+    }
+    if (mode === "suggestions") {
+      const items = Array.isArray(payload?.items) ? payload.items : [];
+      const cards = [];
+      for (const item2 of items) {
+        if (!item2 || typeof item2 !== "object") continue;
+        const child = this.catalogForKeyFromPayload(String(item2._catalog_key || ""), this.catalogsCache || {}) || fullCatalog;
+        const card = wikiCardForItem(item2, child?.title || fullCatalog.title, child);
+        if (item2._catalog_title) card.badges = [item2._catalog_title, ...card.badges];
+        cards.push(card);
+      }
+      return {
+        title: `没有找到「${query}」`,
+        subtitle: `Wiki / ${fullCatalog.title} / 联想结果`,
+        summary: "接口没有返回精确结果，下面是按名称、摘要和相似度整理的候选。",
+        image: "",
+        badges: [fullCatalog.title, "联想"],
+        facts: [
+          { label: "查询词", value: query || "-" },
+          { label: "候选数", value: String(cards.length) }
+        ],
+        actionHint: "接口没有精确命中时，可按候选卡片的绿色分类 tag 加名称继续查询。",
+        actionExamples: this.resultCommandExamples(items, fullCatalog),
+        cards,
+        sections: [],
+        commandHint: `💡 可使用 洛克wiki ${fullCatalog.title} <候选名称或ID> 继续查询`,
+        copyright: COPYRIGHT
+      };
+    }
+    if (mode === "list") {
+      const items = Array.isArray(payload?.items) ? payload.items : [];
+      const cards = items.filter((item2) => item2 && typeof item2 === "object").map((item2) => wikiCardForItem(item2, fullCatalog.title, fullCatalog));
+      const catalogInfo = payload?.catalog && typeof payload.catalog === "object" ? payload.catalog : {};
+      return {
+        title: `${fullCatalog.title}列表`,
+        subtitle: `Wiki / ${fullCatalog.title} / 第 ${pageNo} 页`,
+        image: "",
+        summary: catalogInfo.description || `共 ${payload?.total ?? cards.length} 条`,
+        badges: [fullCatalog.title, "列表"],
+        facts: [
+          { label: "当前页", value: String(payload?.page_no ?? pageNo) },
+          { label: "总页数", value: String(payload?.total_pages ?? "-") },
+          { label: "总数", value: String(payload?.total ?? cards.length) }
+        ],
+        actionHint: query ? "搜索结果较多时，可按分类加名称继续查询具体条目。" : "",
+        actionExamples: query ? this.resultCommandExamples(items, fullCatalog) : [],
+        cards,
+        sections: [],
+        commandHint: "💡 洛克wiki <类型> <关键词或ID> | 洛克wiki 查看支持类型",
+        copyright: COPYRIGHT
+      };
+    }
+    const item = payload && typeof payload === "object" ? payload : {};
+    return {
+      title: wikiTitleForItem(item, fullCatalog.title),
+      subtitle: `Wiki / ${fullCatalog.title}`,
+      image: wikiPickImage(item),
+      summary: wikiSummaryForItem(item),
+      badges: [fullCatalog.title, ...wikiBadgesForItem(item)],
+      facts: wikiMetaForItem(item, 16, String(fullCatalog.key || "")),
+      cards: [],
+      sections: wikiSectionsForPayload(item, fullCatalog),
+      commandHint: "💡 洛克wiki <类型> <关键词或ID> | 洛克wiki 查看支持类型",
+      copyright: COPYRIGHT
+    };
+  }
+  mergeDetailPayloads(base, extra) {
+    const merged = { ...base || {} };
+    for (const [key, value] of Object.entries(extra || {})) {
+      if (value === void 0 || value === null || value === "" || Array.isArray(value) && !value.length || typeof value === "object" && !Array.isArray(value) && !Object.keys(value).length) continue;
+      const oldValue = merged[key];
+      if (oldValue && typeof oldValue === "object" && !Array.isArray(oldValue) && value && typeof value === "object" && !Array.isArray(value)) {
+        merged[key] = this.mergeDetailPayloads(oldValue, value);
+      } else if (Array.isArray(oldValue) && Array.isArray(value)) {
+        const seen = /* @__PURE__ */ new Set();
+        const combined = [];
+        for (const item of [...oldValue, ...value]) {
+          const marker = typeof item === "object" ? JSON.stringify(item) : String(item);
+          if (seen.has(marker)) continue;
+          seen.add(marker);
+          combined.push(item);
+        }
+        merged[key] = combined;
+      } else {
+        merged[key] = value;
+      }
+    }
+    return merged;
+  }
+  itemDetailCompanionKeys(catalog, detail) {
+    const catalogKey = String(catalog?.key || "");
+    const itemId = detail?.item_id;
+    if (itemId === void 0 || itemId === null || itemId === "") return [];
+    if (["skill-stones", "skill-stone-recipes", "balls", "medals", "pet-carryons"].includes(catalogKey)) {
+      return detail?.item_kind ? ["items"] : [];
+    }
+    if (catalogKey !== "items") return [];
+    const flags = detail?.flags && typeof detail.flags === "object" ? detail.flags : {};
+    const typeLabel = wikiGenericValue(detail?.type || detail?.label_type);
+    if (flags.is_skill_stone || typeLabel === "技能石") return ["skill-stones"];
+    if (flags.is_skill_stone_recipe || String(detail?.name || "").startsWith("配方-")) return ["skill-stone-recipes"];
+    if (typeLabel === "咕噜球") return ["balls"];
+    if (["奖章", "勋章"].includes(typeLabel)) return ["medals"];
+    if (["携带物", "精灵携带物"].includes(typeLabel)) return ["pet-carryons"];
+    return [];
+  }
+  async enrichItemDetail(catalog, detail) {
+    if (!detail || typeof detail !== "object") return detail;
+    const itemId = detail.item_id;
+    if (itemId === void 0 || itemId === null || itemId === "") return detail;
+    let merged = { ...detail };
+    for (const key of this.itemDetailCompanionKeys(catalog, detail)) {
+      const companion = this.catalogForKeyFromPayload(key, this.catalogsCache || {});
+      if (!companion) continue;
+      if (key === "items") {
+        const itemKind = detail.item_kind;
+        if (itemKind === void 0 || itemKind === null || itemKind === "") continue;
+        const companionDetail2 = await this.client.getWikiPath(this.ctx, `/api/v1/games/rocom/wiki/items/${itemKind}/${itemId}`);
+        if (companionDetail2) merged = this.mergeDetailPayloads(companionDetail2, merged);
+        continue;
+      }
+      const companionDetail = await this.client.getWikiPath(this.ctx, `/api/v1/games/rocom/wiki/${key}/${itemId}`);
+      if (companionDetail) merged = this.mergeDetailPayloads(merged, companionDetail);
+    }
+    return merged;
+  }
+  async resolveWikiPet(query) {
+    const trimmed = String(query || "").trim();
+    if (!trimmed) return { detail: null, candidates: [], error: "请输入精灵名称或 ID。用法：洛克wiki 精灵 <精灵名或ID>" };
+    if (/^\d+$/.test(trimmed)) {
+      const detail2 = await this.client.getWikiPet(this.ctx, trimmed);
+      if (detail2) return { detail: detail2, candidates: [], error: "" };
+      return { detail: null, candidates: [], error: `获取 Wiki 精灵详情失败：${this.client.getLastError()}` };
+    }
+    const searchRes = await this.client.listWikiPets(this.ctx, trimmed, 1, 10);
+    const items = (searchRes || {}).items || [];
+    if (!items.length) {
+      const suggestions = await this.suggestCatalogItems(await this.getCatalogByKey("pets"), trimmed, 10);
+      if (suggestions.length) return { detail: null, candidates: suggestions, error: "" };
+      return { detail: null, candidates: [], error: `未找到「${trimmed}」的 Wiki 精灵资料：${this.client.getLastError("无匹配结果")}` };
+    }
+    let selected = findExactWikiMatch(items, trimmed);
+    if (!selected && items.length === 1) selected = items[0];
+    if (!selected) return { detail: null, candidates: items, error: "" };
+    const detail = await this.client.getWikiPet(this.ctx, selected.pet_id);
+    if (detail) return { detail, candidates: [], error: "" };
+    return { detail: null, candidates: [], error: `获取 Wiki 精灵详情失败：${this.client.getLastError()}` };
+  }
+  async resolveWikiSkill(query) {
+    const trimmed = String(query || "").trim();
+    if (!trimmed) return { detail: null, candidates: [], error: "请输入技能名称或 ID。用法：洛克wiki 技能 <技能名或ID>" };
+    if (/^\d+$/.test(trimmed)) {
+      const detail2 = await this.client.getWikiSkill(this.ctx, trimmed);
+      if (detail2) return { detail: detail2, candidates: [], error: "" };
+      return { detail: null, candidates: [], error: `获取技能详情失败：${this.client.getLastError()}` };
+    }
+    const searchRes = await this.client.listWikiSkills(this.ctx, trimmed, 1, 10);
+    const items = (searchRes || {}).items || [];
+    if (!items.length) {
+      const suggestions = await this.suggestCatalogItems(await this.getCatalogByKey("skills"), trimmed, 10);
+      if (suggestions.length) return { detail: null, candidates: suggestions, error: "" };
+      return { detail: null, candidates: [], error: `未找到「${trimmed}」的技能 Wiki 资料：${this.client.getLastError("无匹配结果")}。用法：洛克wiki 技能 <技能名或ID>` };
+    }
+    let selected = findExactWikiMatch(items, trimmed);
+    if (!selected && items.length === 1) selected = items[0];
+    if (!selected) return { detail: null, candidates: items, error: "" };
+    const detail = await this.client.getWikiSkill(this.ctx, selected.skill_id);
+    if (detail) return { detail, candidates: [], error: "" };
+    return { detail: null, candidates: [], error: `获取技能详情失败：${this.client.getLastError()}` };
+  }
+  async fetchWikiPetSections(petId) {
+    const [profile, skills, family, handbook] = await Promise.all([
+      this.client.getWikiPetProfile(this.ctx, petId).catch(() => null),
+      this.client.getWikiPetSkills(this.ctx, petId).catch(() => null),
+      this.client.getWikiPetFamily(this.ctx, petId).catch(() => null),
+      this.client.getWikiPetHandbook(this.ctx, petId).catch(() => null)
+    ]);
+    return {
+      profile: profile && typeof profile === "object" ? profile : {},
+      skills: skills && typeof skills === "object" ? skills : {},
+      family: family && typeof family === "object" ? family : {},
+      handbook: handbook && typeof handbook === "object" ? handbook : {}
+    };
+  }
+  // 通过缓存查询技能详情（供家园详情技能补全使用）
+  async getSkillDetailCached(skillId) {
+    const key = String(skillId || "").trim();
+    if (!key) return null;
+    if (this.skillDetailCache.has(key)) return this.skillDetailCache.get(key);
+    const detail = await this.client.getWikiSkill(this.ctx, key);
+    if (detail && typeof detail === "object") {
+      this.skillDetailCache.set(key, detail);
+      return detail;
+    }
+    return null;
+  }
+  // 通过缓存查询精灵详情（供家园详情体重范围使用）
+  async getPetDetailCached(petId) {
+    const key = String(petId || "").trim();
+    if (!key) return null;
+    if (this.petDetailCache.has(key)) return this.petDetailCache.get(key);
+    const detail = await this.client.getWikiPet(this.ctx, key);
+    if (detail && typeof detail === "object") {
+      this.petDetailCache.set(key, detail);
+      return detail;
+    }
+    return null;
+  }
+  async fetchGenericCatalog(catalog, query, pageNo) {
+    const trimmed = String(query || "").trim();
+    const detailPath = String(catalog.detail_path || "");
+    const listPath = String(catalog.list_path || "");
+    if (detailPath && trimmed) {
+      const directParams = this.wikiPathParamsFromItem(catalog, {}, trimmed);
+      const idFields = catalog.id_fields || [];
+      if (idFields.length === 1 && idFields[0] === "pet_id" && !/^\d+$/.test(trimmed)) {
+        const { detail: pet } = await this.resolveWikiPet(trimmed);
+        if (pet?.pet_id !== void 0 && pet?.pet_id !== null && pet?.pet_id !== "") directParams.pet_id = String(pet.pet_id);
+      }
+      if (idFields.length === 1 && idFields[0] === "skill_id" && !/^\d+$/.test(trimmed)) {
+        const { detail: skill } = await this.resolveWikiSkill(trimmed);
+        if (skill?.skill_id !== void 0 && skill?.skill_id !== null && skill?.skill_id !== "") directParams.skill_id = String(skill.skill_id);
+      }
+      const directPath = this.fillDetailPath(catalog, directParams);
+      const typeFields = /* @__PURE__ */ new Set(["item_kind", "asset_type", "action_type"]);
+      let directAllowed = Boolean(directPath) && Object.keys(directParams).length >= idFields.length;
+      for (const field of idFields) {
+        if (typeFields.has(field)) continue;
+        if (!/^\d+$/.test(String(directParams[field] || ""))) {
+          directAllowed = false;
+          break;
+        }
+      }
+      if (directAllowed) {
+        const detail = await this.client.getWikiPath(this.ctx, directPath);
+        if (detail) return { payload: await this.enrichItemDetail(catalog, detail), mode: "detail", error: "" };
+      }
+    }
+    if (!listPath) {
+      return { payload: null, mode: "detail", error: `${catalog.title} 需要提供 ID。用法：洛克wiki ${catalog.title} <ID>` };
+    }
+    const listRes = await this.client.listWikiCatalogItems(this.ctx, listPath, trimmed, pageNo, 12, catalog.search !== false);
+    if (listRes === null) {
+      return { payload: null, mode: "list", error: `获取 ${catalog.title} 失败：${this.client.getLastError()}` };
+    }
+    if (!listRes || typeof listRes !== "object" || !("items" in listRes)) {
+      return { payload: listRes, mode: "detail", error: "" };
+    }
+    const items = listRes.items || [];
+    if (trimmed && !items.length) {
+      const suggestions = await this.suggestCatalogItems(catalog, trimmed, 10);
+      if (suggestions.length) return { payload: { items: suggestions, query: trimmed }, mode: "suggestions", error: "" };
+    }
+    if (detailPath && trimmed && items.length) {
+      const selected = this.findCatalogMatch(catalog, items, trimmed);
+      if (selected) {
+        const params = this.wikiPathParamsFromItem(catalog, selected, trimmed);
+        const selectedPath = this.fillDetailPath(catalog, params);
+        if (selectedPath) {
+          const detail = await this.client.getWikiPath(this.ctx, selectedPath);
+          if (detail) return { payload: await this.enrichItemDetail(catalog, detail), mode: "detail", error: "" };
+        }
+      }
+    }
+    return { payload: listRes, mode: "list", error: "" };
+  }
+  async fetchDetailForCatalogItem(catalog, item, query) {
+    if (!catalog.detail_path) return null;
+    const params = this.wikiPathParamsFromItem(catalog, item, query);
+    const detailPath = this.fillDetailPath(catalog, params);
+    if (!detailPath) return null;
+    const detail = await this.client.getWikiPath(this.ctx, detailPath);
+    return this.enrichItemDetail(catalog, detail);
+  }
+  async fetchGlobalSearch(query, pageNo) {
+    const trimmed = String(query || "").trim();
+    if (!trimmed) return { payload: null, mode: "global-search", error: "请输入 Wiki 关键词。" };
+    const catalogsPayload = await this.getCatalogsPayload();
+    const catalogs = this.globalSearchCatalogs(catalogsPayload);
+    if (!catalogs.length) return { payload: null, mode: "global-search", error: "暂无可全局搜索的 Wiki 接口。" };
+    const results = [];
+    const concurrency = 8;
+    let index = 0;
+    const worker = /* @__PURE__ */ __name(async () => {
+      while (index < catalogs.length) {
+        const catalog = catalogs[index++];
+        try {
+          const res = await this.client.listWikiCatalogItems(this.ctx, catalog.list_path, trimmed, pageNo, 6, true);
+          if (res === null) {
+            results.push({ catalog, items: [], error: this.client.getLastError("") });
+          } else {
+            const items2 = res && typeof res === "object" ? res.items : [];
+            results.push({ catalog, items: (items2 || []).filter((item) => item && typeof item === "object"), error: "" });
+          }
+        } catch (e) {
+          results.push({ catalog, items: [], error: String(e) });
+        }
+      }
+    }, "worker");
+    await Promise.all(Array.from({ length: Math.min(concurrency, catalogs.length) }, worker));
+    const collected = /* @__PURE__ */ new Map();
+    const exactKeys = /* @__PURE__ */ new Set();
+    const errors = [];
+    for (const { catalog, items: items2, error } of results) {
+      if (error) {
+        errors.push(`${catalog.title || catalog.key}：${error}`);
+        continue;
+      }
+      for (const item of items2) {
+        const merged = { ...item, _catalog_key: catalog.key, _catalog_title: catalog.title };
+        const title = wikiTitleForItem(item, "");
+        const keyParts = [String(catalog.key || ""), title];
+        for (const field of catalog.id_fields || []) {
+          let value = item[field];
+          if ((value === void 0 || value === null || value === "") && ["ball_id", "plant_id", "carryon_id"].includes(field)) {
+            value = item.item_id ?? item.id;
+          }
+          if (value !== void 0 && value !== null && value !== "") keyParts.push(String(value));
+        }
+        const dedupeKey = keyParts.join("|");
+        if (collected.has(dedupeKey)) continue;
+        let score = wikiSimilarityScore(trimmed, merged);
+        if (this.itemMatchesQueryExact(catalog, item, trimmed)) {
+          score += 10 - wikiGlobalCatalogPriority(catalog) * 0.01;
+          exactKeys.add(dedupeKey);
+        }
+        merged._match_score = score;
+        collected.set(dedupeKey, merged);
+      }
+    }
+    const items = [...collected.values()];
+    items.sort((a, b) => (b._match_score || 0) - (a._match_score || 0));
+    const exactItems = [...exactKeys].filter((key) => collected.has(key)).map((key) => collected.get(key));
+    if (exactItems.length) {
+      const priorityOf = /* @__PURE__ */ __name((item) => wikiGlobalCatalogPriority(
+        this.catalogForKeyFromPayload(String(item._catalog_key || ""), catalogsPayload)
+      ), "priorityOf");
+      exactItems.sort((a, b) => priorityOf(a) - priorityOf(b) || (b._match_score || 0) - (a._match_score || 0));
+      const bestPriority = priorityOf(exactItems[0]);
+      const bestItems = exactItems.filter((item) => priorityOf(item) === bestPriority);
+      if (bestItems.length === 1) {
+        const exactItem = bestItems[0];
+        const catalog = this.catalogForKeyFromPayload(String(exactItem._catalog_key || ""), catalogsPayload);
+        if (catalog) {
+          const detail = await this.fetchDetailForCatalogItem(catalog, exactItem, trimmed);
+          if (detail) return { payload: { item: detail, _catalog: catalog }, mode: "global-detail", error: "" };
+        }
+      }
+    }
+    if (items.length) {
+      return { payload: { items: items.slice(0, 12), query: trimmed, total: items.length, _global: true }, mode: "global-search", error: "" };
+    }
+    if (errors.length) return { payload: null, mode: "global-search", error: `全局搜索失败：${errors[0]}` };
+    return { payload: { items: [], query: trimmed, total: 0, _global: true }, mode: "global-search", error: "" };
+  }
+};
+
+// src/atlas-service.ts
+var import_koishi6 = require("koishi");
+var import_node_child_process = require("node:child_process");
+var import_node_fs4 = __toESM(require("node:fs"));
+var import_node_path4 = __toESM(require("node:path"));
+var import_node_zlib = __toESM(require("node:zlib"));
+var logger6 = new import_koishi6.Logger("rocom-atlas");
+var DEFAULT_ATLAS_ZIP_URLS = [
+  "https://codeload.github.com/Entropy-Increase-Team/Rocom-Atlas/zip/refs/heads/main",
+  "https://github.com/Entropy-Increase-Team/Rocom-Atlas/archive/refs/heads/main.zip"
+];
+var DEFAULT_ATLAS_GIT_URL = "https://github.com/Entropy-Increase-Team/Rocom-Atlas.git";
+function extractZip(buffer, destDir) {
+  let eocd = -1;
+  const minEocd = Math.max(0, buffer.length - 65557);
+  for (let i = buffer.length - 22; i >= minEocd; i--) {
+    if (buffer.readUInt32LE(i) === 101010256) {
+      eocd = i;
+      break;
+    }
+  }
+  if (eocd < 0) throw new Error("ZIP 结构异常：找不到中央目录结尾");
+  const entryCount = buffer.readUInt16LE(eocd + 10);
+  let offset = buffer.readUInt32LE(eocd + 16);
+  for (let i = 0; i < entryCount; i++) {
+    if (buffer.readUInt32LE(offset) !== 33639248) throw new Error("ZIP 结构异常：中央目录签名错误");
+    const compressionMethod = buffer.readUInt16LE(offset + 10);
+    const compressedSize = buffer.readUInt32LE(offset + 20);
+    const nameLength = buffer.readUInt16LE(offset + 28);
+    const extraLength = buffer.readUInt16LE(offset + 30);
+    const commentLength = buffer.readUInt16LE(offset + 32);
+    const localHeaderOffset = buffer.readUInt32LE(offset + 42);
+    const name2 = buffer.subarray(offset + 46, offset + 46 + nameLength).toString("utf8");
+    offset += 46 + nameLength + extraLength + commentLength;
+    const normalized = name2.replace(/\\/g, "/");
+    if (normalized.includes("..")) continue;
+    const target = import_node_path4.default.join(destDir, ...normalized.split("/"));
+    if (!import_node_path4.default.resolve(target).startsWith(import_node_path4.default.resolve(destDir))) continue;
+    if (normalized.endsWith("/")) {
+      import_node_fs4.default.mkdirSync(target, { recursive: true });
+      continue;
+    }
+    if (buffer.readUInt32LE(localHeaderOffset) !== 67324752) throw new Error("ZIP 结构异常：本地文件头签名错误");
+    const localNameLength = buffer.readUInt16LE(localHeaderOffset + 26);
+    const localExtraLength = buffer.readUInt16LE(localHeaderOffset + 28);
+    const dataStart = localHeaderOffset + 30 + localNameLength + localExtraLength;
+    const compressed = buffer.subarray(dataStart, dataStart + compressedSize);
+    let content;
+    if (compressionMethod === 0) content = Buffer.from(compressed);
+    else if (compressionMethod === 8) content = import_node_zlib.default.inflateRawSync(compressed);
+    else throw new Error(`ZIP 不支持的压缩方式: ${compressionMethod}`);
+    import_node_fs4.default.mkdirSync(import_node_path4.default.dirname(target), { recursive: true });
+    import_node_fs4.default.writeFileSync(target, content);
+  }
+}
+__name(extractZip, "extractZip");
+function gitClone(dst, gitUrl) {
+  return new Promise((resolve, reject) => {
+    const child = (0, import_node_child_process.spawn)(
+      "git",
+      ["clone", "--depth", "1", "--single-branch", "--progress", gitUrl, dst],
+      { env: { ...process.env, GIT_TERMINAL_PROMPT: "0" } }
+    );
+    const stderrLines = [];
+    let stderrTail = "";
+    child.stderr.on("data", (chunk) => {
+      stderrTail += chunk.toString("utf8");
+      const lines = stderrTail.split(/[\r\n]+/);
+      stderrTail = lines.pop() || "";
+      for (const line of lines) {
+        const text = line.trim();
+        if (!text) continue;
+        stderrLines.push(text);
+        logger6.info(`git clone: ${text}`);
+      }
+    });
+    const timer = setTimeout(() => {
+      child.kill();
+      reject(new Error("git clone Rocom-Atlas 超时（180 秒）"));
+    }, 18e4);
+    child.on("error", (error) => {
+      clearTimeout(timer);
+      reject(new Error(`git clone Rocom-Atlas 失败：${error.message}`));
+    });
+    child.on("close", (code) => {
+      clearTimeout(timer);
+      if (code === 0) resolve();
+      else reject(new Error(`git clone Rocom-Atlas 失败（exit ${code}）：${stderrLines.slice(-3).join(" | ")}`));
+    });
+  });
+}
+__name(gitClone, "gitClone");
+var AtlasService = class {
+  constructor(dataDir, options = {}) {
+    this.dataDir = dataDir;
+    this.zipUrls = options.zipUrls?.length ? options.zipUrls : DEFAULT_ATLAS_ZIP_URLS;
+    this.gitUrl = options.gitUrl || DEFAULT_ATLAS_GIT_URL;
+  }
+  static {
+    __name(this, "AtlasService");
+  }
+  zipUrls;
+  gitUrl;
+  get atlasDir() {
+    return import_node_path4.default.join(this.dataDir, "rocom_atlas");
+  }
+  indexPath() {
+    return import_node_path4.default.join(this.atlasDir, "path.json");
+  }
+  petsDir() {
+    return import_node_path4.default.join(this.atlasDir, "pets");
+  }
+  aliasPath() {
+    return import_node_path4.default.join(this.atlasDir, "othername", "pets.yaml");
+  }
+  isReady() {
+    return import_node_fs4.default.existsSync(this.indexPath()) && import_node_fs4.default.existsSync(this.petsDir());
+  }
+  loadIndex() {
+    try {
+      const payload = JSON.parse(import_node_fs4.default.readFileSync(this.indexPath(), "utf-8"));
+      const pets = payload?.pets;
+      return pets && typeof pets === "object" ? pets : {};
+    } catch (e) {
+      logger6.warn(`读取本地图鉴索引失败: ${e}`);
+      return {};
+    }
+  }
+  stripYamlValue(value) {
+    const text = String(value || "").trim();
+    if (text.length >= 2 && text[0] === text[text.length - 1] && ["'", '"'].includes(text[0])) {
+      return text.slice(1, -1).trim();
+    }
+    return text;
+  }
+  // 解析上游简单结构的 pets.yaml：`正式名:` + 缩进 `- 别名` 列表。
+  loadPetAliases() {
+    const filePath = this.aliasPath();
+    if (!import_node_fs4.default.existsSync(filePath)) return {};
+    const aliases = {};
+    let currentName = "";
+    try {
+      const lines = import_node_fs4.default.readFileSync(filePath, "utf-8").split(/\r?\n/);
+      for (const line of lines) {
+        const stripped = line.trim();
+        if (!stripped || stripped.startsWith("#")) continue;
+        if (!/^\s/.test(line) && stripped.endsWith(":")) {
+          currentName = this.stripYamlValue(stripped.slice(0, -1));
+          if (currentName) {
+            const key = normalizeQueryText(currentName);
+            aliases[key] = aliases[key] || [];
+            if (!aliases[key].includes(currentName)) aliases[key].push(currentName);
+          }
+          continue;
+        }
+        if (currentName && stripped.startsWith("-")) {
+          const alias = this.stripYamlValue(stripped.slice(1));
+          if (!alias) continue;
+          const key = normalizeQueryText(alias);
+          aliases[key] = aliases[key] || [];
+          if (!aliases[key].includes(currentName)) aliases[key].push(currentName);
+        }
+      }
+    } catch (e) {
+      logger6.warn(`读取本地图鉴别名失败: ${e}`);
+      return {};
+    }
+    return aliases;
+  }
+  localImagePath(atlasRelPath) {
+    const rel = String(atlasRelPath || "").replace(/\\/g, "/").replace(/^\/+/, "");
+    if (!rel) return "";
+    const candidate = import_node_path4.default.resolve(this.atlasDir, ...rel.split("/"));
+    const root = import_node_path4.default.resolve(this.atlasDir);
+    if (!candidate.startsWith(root)) return "";
+    return candidate;
+  }
+  existingImagePath(index, name2) {
+    const filePath = this.localImagePath(index[name2] || "");
+    return filePath && import_node_fs4.default.existsSync(filePath) ? filePath : "";
+  }
+  findMatch(query) {
+    const trimmed = String(query || "").trim();
+    if (!trimmed) return { name: "", imagePath: "", candidates: [] };
+    if (/^\d+$/.test(trimmed)) {
+      const filePath = import_node_path4.default.join(this.petsDir(), `${trimmed}.png`);
+      if (import_node_fs4.default.existsSync(filePath)) return { name: `#${trimmed}`, imagePath: filePath, candidates: [] };
+    }
+    const index = this.loadIndex();
+    if (!Object.keys(index).length) return { name: "", imagePath: "", candidates: [] };
+    const normalizedQuery = normalizeQueryText(trimmed);
+    let exactKey = "";
+    for (const name2 of Object.keys(index)) {
+      if (normalizeQueryText(name2) === normalizedQuery) {
+        exactKey = name2;
+        break;
+      }
+    }
+    if (exactKey) {
+      const filePath = this.existingImagePath(index, exactKey);
+      if (filePath) return { name: exactKey, imagePath: filePath, candidates: [] };
+    }
+    const aliasMap = this.loadPetAliases();
+    const exactAliasCandidates = (aliasMap[normalizedQuery] || []).filter((name2) => this.existingImagePath(index, name2));
+    if (exactAliasCandidates.length) {
+      const only = exactAliasCandidates[0];
+      return { name: only, imagePath: this.existingImagePath(index, only), candidates: [] };
+    }
+    const candidates = [];
+    const addCandidate = /* @__PURE__ */ __name((name2) => {
+      if (!candidates.includes(name2) && this.existingImagePath(index, name2)) candidates.push(name2);
+    }, "addCandidate");
+    for (const name2 of Object.keys(index)) {
+      const normalizedName = normalizeQueryText(name2);
+      if (normalizedQuery && (normalizedName.includes(normalizedQuery) || normalizedQuery.includes(normalizedName))) {
+        addCandidate(name2);
+      }
+    }
+    for (const [alias, names] of Object.entries(aliasMap)) {
+      if (normalizedQuery && (alias.includes(normalizedQuery) || normalizedQuery.includes(alias))) {
+        for (const name2 of names) addCandidate(name2);
+      }
+    }
+    if (candidates.length === 1) {
+      const only = candidates[0];
+      return { name: only, imagePath: this.existingImagePath(index, only), candidates: [] };
+    }
+    return { name: "", imagePath: "", candidates: candidates.slice(0, 10) };
+  }
+  prepareAtlasDir(sourceRoot, preparedDir) {
+    import_node_fs4.default.mkdirSync(preparedDir, { recursive: true });
+    for (const name2 of ["path.json", "index", "othername", "pets"]) {
+      const src = import_node_path4.default.join(sourceRoot, name2);
+      const dst = import_node_path4.default.join(preparedDir, name2);
+      if (import_node_fs4.default.existsSync(src)) {
+        import_node_fs4.default.cpSync(src, dst, { recursive: true });
+      }
+    }
+    if (!import_node_fs4.default.existsSync(import_node_path4.default.join(preparedDir, "path.json"))) throw new Error("Atlas 缺少 path.json");
+    if (!import_node_fs4.default.existsSync(import_node_path4.default.join(preparedDir, "othername", "pets.yaml"))) throw new Error("Atlas 缺少 othername/pets.yaml");
+    const petsDir = import_node_path4.default.join(preparedDir, "pets");
+    if (!import_node_fs4.default.existsSync(petsDir)) throw new Error("Atlas 缺少 pets 图片目录");
+    const imageCount = import_node_fs4.default.readdirSync(petsDir).filter((name2) => name2.toLowerCase().endsWith(".png")).length;
+    let totalBytes = 0;
+    const walk = /* @__PURE__ */ __name((dir) => {
+      for (const entry of import_node_fs4.default.readdirSync(dir, { withFileTypes: true })) {
+        const entryPath = import_node_path4.default.join(dir, entry.name);
+        if (entry.isDirectory()) walk(entryPath);
+        else totalBytes += import_node_fs4.default.statSync(entryPath).size;
+      }
+    }, "walk");
+    walk(preparedDir);
+    return { imageCount, totalBytes };
+  }
+  replaceAtlasDir(preparedDir) {
+    const target = import_node_path4.default.resolve(this.atlasDir);
+    const dataRoot = import_node_path4.default.resolve(this.dataDir);
+    if (!target.startsWith(dataRoot)) throw new Error("图鉴目标目录不在插件数据目录内");
+    if (import_node_fs4.default.existsSync(target)) import_node_fs4.default.rmSync(target, { recursive: true, force: true });
+    import_node_fs4.default.mkdirSync(import_node_path4.default.dirname(target), { recursive: true });
+    try {
+      import_node_fs4.default.renameSync(preparedDir, target);
+    } catch (e) {
+      if (["EXDEV", "EPERM"].includes(e?.code)) {
+        logger6.info(`rename 失败（${e.code}），回退为复制方式迁移图鉴目录`);
+        import_node_fs4.default.cpSync(preparedDir, target, { recursive: true });
+      } else {
+        throw e;
+      }
+    }
+  }
+  // 流式下载压缩包：每 2 秒输出一次已下载字节数/速度，避免大文件下载期间毫无动静。
+  async downloadZipWithProgress(ctx, url) {
+    const started = Date.now();
+    const res = await ctx.http(url, { responseType: "stream", timeout: 18e4 });
+    const totalHeader = Number(res.headers?.get?.("content-length"));
+    const totalBytes = Number.isFinite(totalHeader) && totalHeader > 0 ? totalHeader : 0;
+    const totalText = totalBytes ? `${(totalBytes / 1024 / 1024).toFixed(1)} MB` : "未知大小";
+    logger6.info(`开始下载图鉴压缩包：${url}（${totalText}）`);
+    const chunks = [];
+    let received = 0;
+    let lastLogAt = Date.now();
+    const reader = res.data.getReader();
+    while (true) {
+      const { done, value } = await reader.read();
+      if (done) break;
+      if (value) {
+        chunks.push(Buffer.from(value));
+        received += value.byteLength;
+      }
+      const now = Date.now();
+      if (now - lastLogAt >= 2e3) {
+        lastLogAt = now;
+        const mb = (received / 1024 / 1024).toFixed(1);
+        const speed = (received / 1024 / (now - started) * 1e3 / 1024).toFixed(2);
+        const percentText = totalBytes ? `${Math.min(99, Math.round(received / totalBytes * 100))}%，` : "";
+        logger6.info(`图鉴压缩包下载中：${percentText}已收到 ${mb} MB，平均 ${speed} MB/s`);
+      }
+    }
+    const elapsed = ((Date.now() - started) / 1e3).toFixed(1);
+    logger6.info(`图鉴压缩包下载完成：共 ${(received / 1024 / 1024).toFixed(1)} MB，耗时 ${elapsed} 秒`);
+    return Buffer.concat(chunks);
+  }
+  async download(ctx, progressCb) {
+    const emit = /* @__PURE__ */ __name(async (percent, stage) => {
+      if (progressCb) await progressCb(Math.max(0, Math.min(100, Math.round(percent))), stage);
+    }, "emit");
+    import_node_fs4.default.mkdirSync(this.dataDir, { recursive: true });
+    for (const entry of import_node_fs4.default.readdirSync(this.dataDir, { withFileTypes: true })) {
+      if (entry.isDirectory() && entry.name.startsWith(".atlas_tmp_")) {
+        cleanupTempDir(import_node_path4.default.join(this.dataDir, entry.name));
+      }
+    }
+    const tmpRoot = import_node_fs4.default.mkdtempSync(import_node_path4.default.join(this.dataDir, ".atlas_tmp_"));
+    const extractDir = import_node_path4.default.join(tmpRoot, "extract");
+    let preparedDir = import_node_path4.default.join(tmpRoot, "rocom_atlas");
+    const cloneDir = import_node_path4.default.join(tmpRoot, "clone");
+    try {
+      let zipBuffer = null;
+      const zipErrors = [];
+      for (const url of this.zipUrls) {
+        try {
+          await emit(10, "正在下载图鉴压缩包");
+          zipBuffer = await this.downloadZipWithProgress(ctx, url);
+          await emit(80, "图鉴压缩包下载完成");
+          break;
+        } catch (e) {
+          logger6.warn(`图鉴压缩包下载失败：${url}: ${e}`);
+          zipErrors.push(`${url}: ${e}`);
+          zipBuffer = null;
+        }
+      }
+      let stats;
+      if (zipBuffer) {
+        await emit(80, "正在解压图鉴文件");
+        logger6.info("正在解压图鉴压缩包…");
+        import_node_fs4.default.mkdirSync(extractDir, { recursive: true });
+        extractZip(zipBuffer, extractDir);
+        logger6.info("图鉴压缩包解压完成");
+        const roots = import_node_fs4.default.readdirSync(extractDir, { withFileTypes: true }).filter((entry) => entry.isDirectory()).map((entry) => import_node_path4.default.join(extractDir, entry.name));
+        if (!roots.length) throw new Error("Atlas 压缩包结构异常");
+        stats = this.prepareAtlasDir(roots[0], preparedDir);
+      } else {
+        logger6.warn(`GitHub zip 下载失败，尝试 git clone：${zipErrors.join(" | ")}`);
+        await emit(20, "正在 git clone 图鉴仓库");
+        await gitClone(cloneDir, this.gitUrl);
+        await emit(80, "正在整理图鉴文件");
+        stats = this.prepareAtlasDir(cloneDir, preparedDir);
+      }
+      this.replaceAtlasDir(preparedDir);
+      preparedDir = "";
+      logger6.info(`本地图鉴缓存已更新：${stats.imageCount} 张图片，${(stats.totalBytes / 1024 / 1024).toFixed(1)} MB`);
+      await emit(100, "本地图鉴缓存已更新");
+      return stats;
+    } finally {
+      cleanupTempDir(tmpRoot);
+    }
+  }
+};
+function cleanupTempDir(tmpRoot) {
+  try {
+    import_node_fs4.default.rmSync(tmpRoot, { recursive: true, force: true, maxRetries: 3, retryDelay: 200 });
+  } catch {
+    try {
+      const clearReadonly = /* @__PURE__ */ __name((dir) => {
+        for (const entry of import_node_fs4.default.readdirSync(dir, { withFileTypes: true })) {
+          const entryPath = import_node_path4.default.join(dir, entry.name);
+          try {
+            import_node_fs4.default.chmodSync(entryPath, 438);
+          } catch {
+          }
+          if (entry.isDirectory()) clearReadonly(entryPath);
+        }
+      }, "clearReadonly");
+      clearReadonly(tmpRoot);
+      import_node_fs4.default.rmSync(tmpRoot, { recursive: true, force: true, maxRetries: 3, retryDelay: 200 });
+    } catch (e) {
+      logger6.warn(`清理图鉴临时目录失败（不影响下载结果）：${tmpRoot}: ${e}`);
+    }
+  }
+}
+__name(cleanupTempDir, "cleanupTempDir");
+
 // src/role-token.ts
 function normalize(value) {
   return String(value ?? "").trim();
@@ -2059,12 +4218,12 @@ async function migrateLegacyFrameworkTokens(ctx, userMgr) {
 __name(migrateLegacyFrameworkTokens, "migrateLegacyFrameworkTokens");
 
 // src/commands/account.ts
-var import_koishi6 = require("koishi");
+var import_koishi8 = require("koishi");
 
 // src/send-image.ts
-var import_koishi5 = require("koishi");
-var import_node_zlib = __toESM(require("node:zlib"));
-var logger5 = new import_koishi5.Logger("rocom-send");
+var import_koishi7 = require("koishi");
+var import_node_zlib2 = __toESM(require("node:zlib"));
+var logger7 = new import_koishi7.Logger("rocom-send");
 var PNG_SIGNATURE = Buffer.from([137, 80, 78, 71, 13, 10, 26, 10]);
 var JPEG_SIGNATURE = Buffer.from([255, 216, 255]);
 function formatSessionContext(session) {
@@ -2139,9 +4298,9 @@ function compressPngImage(image, config) {
       if (type === "IEND") break;
     }
     if (!idatChunks.length) return image;
-    const rawImageData = import_node_zlib.default.inflateSync(Buffer.concat(idatChunks));
+    const rawImageData = import_node_zlib2.default.inflateSync(Buffer.concat(idatChunks));
     const level = Math.max(0, Math.min(9, Math.floor(config.imageCompressionLevel ?? 9)));
-    const compressedIdat = import_node_zlib.default.deflateSync(rawImageData, { level });
+    const compressedIdat = import_node_zlib2.default.deflateSync(rawImageData, { level });
     const rebuiltChunks = [];
     let wroteIdat = false;
     for (const chunk of chunks) {
@@ -2157,7 +4316,7 @@ function compressPngImage(image, config) {
     const compressed = Buffer.concat([PNG_SIGNATURE, ...rebuiltChunks]);
     if (compressed.length < image.length) return compressed;
   } catch (err) {
-    logger5.warn(`PNG compression failed, sending original image: ${err}`);
+    logger7.warn(`PNG compression failed, sending original image: ${err}`);
   }
   return image;
 }
@@ -2165,36 +4324,36 @@ __name(compressPngImage, "compressPngImage");
 async function sendImageWithFallback(session, image, fallbackText, scene, compressionConfig) {
   const ctxInfo = formatSessionContext(session);
   if (!image) {
-    logger5.warn(`[${scene}] render returned empty image, fallback to text | ${ctxInfo}`);
+    logger7.warn(`[${scene}] render returned empty image, fallback to text | ${ctxInfo}`);
     try {
       await session.send(fallbackText);
     } catch (e) {
-      logger5.error(`[${scene}] text fallback send failed | ${ctxInfo} | ${e}`);
+      logger7.error(`[${scene}] text fallback send failed | ${ctxInfo} | ${e}`);
     }
     return;
   }
   const outputImage = compressionConfig ? compressPngImage(image, compressionConfig) : image;
   if (outputImage.length < image.length) {
-    logger5.info(`[${scene}] compressed image ${image.length}B -> ${outputImage.length}B | ${ctxInfo}`);
+    logger7.info(`[${scene}] compressed image ${image.length}B -> ${outputImage.length}B | ${ctxInfo}`);
   }
   try {
-    const result = await session.send(import_koishi5.h.image(outputImage, detectImageMime(outputImage)));
+    const result = await session.send(import_koishi7.h.image(outputImage, detectImageMime(outputImage)));
     if (!hasSendResult(result)) {
-      logger5.warn(`[${scene}] image send returned empty result | size=${outputImage.length}B | ${ctxInfo}`);
+      logger7.warn(`[${scene}] image send returned empty result | size=${outputImage.length}B | ${ctxInfo}`);
     }
   } catch (e) {
-    logger5.error(`[${scene}] image send failed | size=${outputImage.length}B | ${ctxInfo} | ${e}`);
+    logger7.error(`[${scene}] image send failed | size=${outputImage.length}B | ${ctxInfo} | ${e}`);
     try {
       await session.send(fallbackText);
     } catch (fallbackErr) {
-      logger5.error(`[${scene}] text fallback send failed after image send error | ${ctxInfo} | ${fallbackErr}`);
+      logger7.error(`[${scene}] text fallback send failed after image send error | ${ctxInfo} | ${fallbackErr}`);
     }
   }
 }
 __name(sendImageWithFallback, "sendImageWithFallback");
 
 // src/commands/account.ts
-var logger6 = new import_koishi6.Logger("rocom-account");
+var logger8 = new import_koishi8.Logger("rocom-account");
 async function recallMessages(session, messageIds) {
   if (!session?.bot?.deleteMessage || !session.channelId) return;
   for (const id of messageIds) {
@@ -2202,7 +4361,7 @@ async function recallMessages(session, messageIds) {
     try {
       await session.bot.deleteMessage(session.channelId, id);
     } catch (err) {
-      logger6.warn(`撤回消息 ${id} 失败：${err}`);
+      logger8.warn(`撤回消息 ${id} 失败：${err}`);
     }
   }
 }
@@ -2282,19 +4441,19 @@ async function saveBindingWithRoleInfo(deps, session, fwToken, loginType, userId
 __name(saveBindingWithRoleInfo, "saveBindingWithRoleInfo");
 function register(deps) {
   const { ctx, client, userMgr } = deps;
-  ctx.command("洛克").subcommand(".QQ登录", "QQ 扫码登录").alias("洛克QQ登录").action(async ({ session }) => {
+  ctx.command("洛克").subcommand(".QQ登录", "QQ 扫码登录").alias("洛克QQ登录").alias("洛克qq登录").action(async ({ session }) => {
     const userId = session.userId;
     const qrData = await client.qqQrLogin(ctx, userId);
     if (!qrData?.qr_image) return "获取 QQ 二维码失败。";
     const fwToken = qrData.frameworkToken;
     const qrB64 = qrData.qr_image;
     const imgData = qrB64.includes(",") ? qrB64.split(",")[1] : qrB64;
-    const qrSendResult = await session.send((0, import_koishi6.h)(
+    const qrSendResult = await session.send((0, import_koishi8.h)(
       "message",
       {},
-      import_koishi6.h.at(userId),
-      import_koishi6.h.text("\n请使用 QQ 扫描二维码登录（有效时间 2 分钟）\n注意需要双设备扫码。\n"),
-      import_koishi6.h.image(`data:image/png;base64,${imgData}`)
+      import_koishi8.h.at(userId),
+      import_koishi8.h.text("\n请使用 QQ 扫描二维码登录（有效时间 2 分钟）\n注意需要双设备扫码。\n"),
+      import_koishi8.h.image(`data:image/png;base64,${imgData}`)
     ));
     const qrMessageIds = Array.isArray(qrSendResult) ? qrSendResult.filter(Boolean).map(String) : qrSendResult ? [String(qrSendResult)] : [];
     const startTime = Date.now();
@@ -2481,11 +4640,11 @@ ${qrUrl}`);
 __name(register, "register");
 
 // src/commands/query.ts
-var import_koishi8 = require("koishi");
+var import_koishi10 = require("koishi");
 
 // src/subscription-send.ts
-var import_koishi7 = require("koishi");
-var logger7 = new import_koishi7.Logger("rocom-subscription-send");
+var import_koishi9 = require("koishi");
+var logger9 = new import_koishi9.Logger("rocom-subscription-send");
 function findBot(ctx, platform = "") {
   if (!ctx.bots?.length) return null;
   if (!platform) return ctx.bots[0];
@@ -2498,7 +4657,7 @@ async function sendScheduledMessage(ctx, target, message) {
   const userId = target.userId || "";
   const bot = findBot(ctx, platform);
   if (!bot) {
-    logger7.warn("no available bot, skip scheduled push");
+    logger9.warn("no available bot, skip scheduled push");
     return false;
   }
   try {
@@ -2521,29 +4680,458 @@ async function sendScheduledMessage(ctx, target, message) {
       return true;
     }
   } catch (err) {
-    logger7.warn(`scheduled push failed: ${err}`);
+    logger9.warn(`scheduled push failed: ${err}`);
     return false;
   }
-  logger7.warn(`scheduled push target is incomplete: ${JSON.stringify(target)}`);
+  logger9.warn(`scheduled push target is incomplete: ${JSON.stringify(target)}`);
   return false;
 }
 __name(sendScheduledMessage, "sendScheduledMessage");
 async function sendScheduledImageWithFallback(ctx, target, image, fallbackText, mentionAll = false) {
-  const buildContent = /* @__PURE__ */ __name((body) => mentionAll ? (0, import_koishi7.h)("message", {}, (0, import_koishi7.h)("at", { type: "all" }), import_koishi7.h.text("\n"), body) : body, "buildContent");
+  const buildContent = /* @__PURE__ */ __name((body) => mentionAll ? (0, import_koishi9.h)("message", {}, (0, import_koishi9.h)("at", { type: "all" }), import_koishi9.h.text("\n"), body) : body, "buildContent");
   if (!image) {
-    return sendScheduledMessage(ctx, target, buildContent(import_koishi7.h.text(fallbackText)));
+    return sendScheduledMessage(ctx, target, buildContent(import_koishi9.h.text(fallbackText)));
   }
-  const imageSegment = import_koishi7.h.image(image, detectImageMime(image));
+  const imageSegment = import_koishi9.h.image(image, detectImageMime(image));
   const sent = await sendScheduledMessage(ctx, target, buildContent(imageSegment));
   if (sent) return true;
-  return sendScheduledMessage(ctx, target, buildContent(import_koishi7.h.text(fallbackText)));
+  return sendScheduledMessage(ctx, target, buildContent(import_koishi9.h.text(fallbackText)));
 }
 __name(sendScheduledImageWithFallback, "sendScheduledImageWithFallback");
 
+// src/pet-data-service.ts
+var CN_TIME_ZONE = "Asia/Shanghai";
+function petDataDisplay(value, defaultText = "--") {
+  if (value === void 0 || value === null || value === "") return defaultText;
+  if (typeof value === "boolean") return value ? "是" : "否";
+  return String(value);
+}
+__name(petDataDisplay, "petDataDisplay");
+function petDataImageUrl(petId, imageType = "image") {
+  const assetIdRaw = parseInt(String(petId), 10);
+  if (!Number.isFinite(assetIdRaw) || assetIdRaw <= 0) return "";
+  const assetId = assetIdRaw < 3e3 ? assetIdRaw + 3e3 : assetIdRaw;
+  const type = imageType === "icon" ? "icon" : "image";
+  return `https://game.gtimg.cn/images/rocom/rocodata/jingling/${assetId}/${type}.png`;
+}
+__name(petDataImageUrl, "petDataImageUrl");
+function petDataWikiPetId(value) {
+  const petId = parseInt(String(value), 10);
+  if (!Number.isFinite(petId) || petId <= 0) return "";
+  return String(petId < 3e3 ? petId + 3e3 : petId);
+}
+__name(petDataWikiPetId, "petDataWikiPetId");
+function normalizeEpochSeconds(value) {
+  const num2 = Number(value);
+  if (!Number.isFinite(num2) || num2 <= 0) return 0;
+  return num2 > 1e10 ? Math.floor(num2 / 1e3) : Math.floor(num2);
+}
+__name(normalizeEpochSeconds, "normalizeEpochSeconds");
+function petDataTimeText(value) {
+  const ts = normalizeEpochSeconds(value);
+  if (!ts) return "--";
+  const date = new Date(ts * 1e3);
+  const formatter = new Intl.DateTimeFormat("zh-CN", {
+    timeZone: CN_TIME_ZONE,
+    year: "numeric",
+    month: "2-digit",
+    day: "2-digit",
+    hour: "2-digit",
+    minute: "2-digit",
+    hour12: false
+  });
+  const parts = Object.fromEntries(formatter.formatToParts(date).map((p) => [p.type, p.value]));
+  return `${parts.year}-${parts.month}-${parts.day} ${parts.hour}:${parts.minute}`;
+}
+__name(petDataTimeText, "petDataTimeText");
+function petDataSizeText(value, unit) {
+  const number = Number(value);
+  if (!Number.isFinite(number)) return "--";
+  if (unit === "g") return `${(number / 1e3).toFixed(2)} kg`;
+  if (unit === "cm") return `${number} cm`;
+  return `${number} ${unit}`.trim();
+}
+__name(petDataSizeText, "petDataSizeText");
+function petDataVoiceText(value) {
+  if (value === void 0 || value === null || value === "") return "--";
+  const number = Number(value);
+  if (!Number.isFinite(number)) return petDataDisplay(value);
+  return Number.isInteger(number) ? `${number} dB` : `${number} dB`;
+}
+__name(petDataVoiceText, "petDataVoiceText");
+function petDataVoiceInfo(value) {
+  const text = petDataVoiceText(value);
+  const number = Number(value);
+  if (!Number.isFinite(number)) return { value: text, hint: "", className: "" };
+  const intNumber = Math.trunc(number);
+  if (intNumber >= 96 && intNumber <= 100) {
+    return { value: `${text} · 婉转声`, hint: "婉转声 96~100", className: "voice-soft" };
+  }
+  if (intNumber >= -100 && intNumber <= -96) {
+    return { value: `${text} · 粗嗓门`, hint: "粗嗓门 -96~-100", className: "voice-rough" };
+  }
+  return { value: text, hint: "婉转声 96~100 / 粗嗓门 -96~-100", className: "" };
+}
+__name(petDataVoiceInfo, "petDataVoiceInfo");
+function petDataKgCompact(grams) {
+  const number = Number(grams);
+  if (!Number.isFinite(number)) return "--";
+  const text = (number / 1e3).toFixed(2).replace(/0+$/, "").replace(/\.$/, "");
+  return `${text}kg`;
+}
+__name(petDataKgCompact, "petDataKgCompact");
+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 {};
+  const current = Number(pet?.weight);
+  const low = Number(weightRange.min_g);
+  const high = Number(weightRange.max_g);
+  if (!Number.isFinite(current) || !Number.isFinite(low) || !Number.isFinite(high)) return {};
+  if (high <= low) return {};
+  const span = high - low;
+  const smallCut = low + span * 0.05;
+  const largeCut = high - span * 0.05;
+  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}` };
+  }
+  return { label: "", className: "", hint: `范围 ${rangeText}` };
+}
+__name(petDataWeightSizeInfo, "petDataWeightSizeInfo");
+function petDataOptionMaps(options) {
+  const petOptions = options && typeof options === "object" && options.pet && typeof options.pet === "object" ? options.pet : {};
+  const buildMap = /* @__PURE__ */ __name((key, preferShort = false) => {
+    const result = {};
+    const values = petOptions[key];
+    if (!Array.isArray(values)) return result;
+    for (const item of values) {
+      if (!item || typeof item !== "object") continue;
+      const itemId = item.id;
+      if (itemId === void 0 || itemId === null || itemId === "") continue;
+      const name2 = preferShort && item.short_name ? item.short_name : item.name;
+      if (name2) result[String(itemId)] = String(name2);
+    }
+    return result;
+  }, "buildMap");
+  const natures = {};
+  for (const item of petOptions.natures || []) {
+    if (!item || typeof item !== "object" || item.id === void 0 || item.id === null || item.id === "") continue;
+    const name2 = String(item.name || item.id);
+    const summary = String(item.summary || "").trim();
+    natures[String(item.id)] = summary ? `${name2}（${summary}）` : name2;
+  }
+  return {
+    natures,
+    bloodlines: buildMap("bloodlines", true),
+    types: buildMap("types"),
+    talent_ratings: buildMap("talent_ratings")
+  };
+}
+__name(petDataOptionMaps, "petDataOptionMaps");
+function petDataLookup(mapping, value, defaultText = "--") {
+  const key = String(value ?? "").trim();
+  if (!key) return defaultText;
+  return mapping[key] || key;
+}
+__name(petDataLookup, "petDataLookup");
+function petDataVariant(pet, fallback = {}) {
+  fallback = fallback || {};
+  const mutationName = String(
+    pet?.mutation_name || fallback?.mutation_name || fallback?.pet_mutation_name || ""
+  ).trim();
+  const mutationType = String(pet?.mutation_type ?? fallback?.mutation_type ?? "").trim();
+  const specialityValues = [];
+  for (const value of [pet?.real_speciality_ids, fallback?.real_speciality_ids, pet?.speciality_id, fallback?.speciality_id]) {
+    if (Array.isArray(value)) specialityValues.push(...value);
+    else if (value !== void 0 && value !== null && value !== "") specialityValues.push(value);
+  }
+  const specialityIds = new Set(specialityValues.map((value) => String(value).trim()).filter(Boolean));
+  if (mutationType === "9" || mutationName.includes("异色") && mutationName.includes("炫彩") || specialityIds.has("103") && specialityIds.has("502")) {
+    return { variantText: "异色炫彩", variantIcon: "异色炫彩.png" };
+  }
+  if (mutationType === "1" || mutationName.includes("异色") || specialityIds.has("103")) {
+    return { variantText: "异色", variantIcon: "异色.png" };
+  }
+  if (mutationType === "8" || mutationName.includes("炫彩") || specialityIds.has("502")) {
+    return { variantText: "炫彩", variantIcon: "炫彩.png" };
+  }
+  return { variantText: mutationName || "普通", variantIcon: "" };
+}
+__name(petDataVariant, "petDataVariant");
+function petDataAttributes(pet) {
+  const attributeInfo = pet?.attribute_info && typeof pet.attribute_info === "object" ? pet.attribute_info : {};
+  const fields = [
+    ["hp", "生命"],
+    ["attack", "物攻"],
+    ["special_attack", "魔攻"],
+    ["defense", "物防"],
+    ["special_defense", "魔防"],
+    ["speed", "速度"]
+  ];
+  return fields.map(([key, label]) => {
+    const raw = attributeInfo[key] && typeof attributeInfo[key] === "object" ? attributeInfo[key] : {};
+    let percent = 6;
+    const base = Number(raw.base_value);
+    if (Number.isFinite(base)) percent = Math.trunc(Math.max(6, Math.min(100, base / 200 * 100)));
+    return {
+      label,
+      value: petDataDisplay(raw.base_value),
+      race: petDataDisplay(raw.total_race),
+      talent: petDataDisplay(raw.talent),
+      percent
+    };
+  });
+}
+__name(petDataAttributes, "petDataAttributes");
+function petDataSkillItems(pet) {
+  const skillRoot = pet?.skill && typeof pet.skill === "object" ? pet.skill : {};
+  const skills = Array.isArray(skillRoot.skill_data) ? skillRoot.skill_data : [];
+  const sortKey = /* @__PURE__ */ __name((item) => {
+    const equippedRank = item?.is_equipped ? 0 : 1;
+    const learnedRank = item?.is_learned ? 0 : 1;
+    let pos = parseInt(String(item?.pos ?? 99), 10);
+    if (!Number.isFinite(pos)) pos = 99;
+    return [equippedRank, learnedRank, pos];
+  }, "sortKey");
+  return skills.filter((s) => s && typeof s === "object").sort((a, b) => {
+    const ka = sortKey(a);
+    const kb = sortKey(b);
+    return ka[0] - kb[0] || ka[1] - kb[1] || ka[2] - kb[2];
+  });
+}
+__name(petDataSkillItems, "petDataSkillItems");
+function extractRawItems(payload) {
+  const rawItems = [];
+  if (Array.isArray(payload?.npc_pets)) {
+    rawItems.push(...payload.npc_pets.filter((item) => item && typeof item === "object"));
+  } else if (payload?.npc_pet && typeof payload.npc_pet === "object") {
+    const query = payload?.query && typeof payload.query === "object" ? payload.query : {};
+    rawItems.push({
+      status: "ok",
+      npc_pet: payload.npc_pet,
+      pet_gid: query.pet_gid,
+      furniture_guid: query.npc_id || query.furniture_guid,
+      npc_id_source: "query"
+    });
+  }
+  return rawItems;
+}
+__name(extractRawItems, "extractRawItems");
+function petDataSkillIdsFromPayload(payload) {
+  let root = payload || {};
+  if (root.result && typeof root.result === "object") root = root.result;
+  const ids = [];
+  for (const raw of extractRawItems(root)) {
+    const npcPet = raw?.npc_pet && typeof raw.npc_pet === "object" ? raw.npc_pet : {};
+    const pet = npcPet?.pet && typeof npcPet.pet === "object" ? npcPet.pet : {};
+    for (const item of petDataSkillItems(pet).slice(0, 8)) {
+      const skillId = String(item?.id ?? "").trim();
+      if (skillId && !ids.includes(skillId)) ids.push(skillId);
+    }
+  }
+  return ids;
+}
+__name(petDataSkillIdsFromPayload, "petDataSkillIdsFromPayload");
+function petDataPetIdsFromPayload(payload) {
+  let root = payload || {};
+  if (root.result && typeof root.result === "object") root = root.result;
+  const ids = [];
+  for (const raw of extractRawItems(root)) {
+    const npcPet = raw?.npc_pet && typeof raw.npc_pet === "object" ? raw.npc_pet : {};
+    const pet = npcPet?.pet && typeof npcPet.pet === "object" ? npcPet.pet : {};
+    const petId = petDataWikiPetId(pet.base_conf_id || raw.pet_cfg_id || pet.catch_base_id || pet.conf_id);
+    if (petId && !ids.includes(petId)) ids.push(petId);
+  }
+  return ids;
+}
+__name(petDataPetIdsFromPayload, "petDataPetIdsFromPayload");
+function petDataSkillIconUrl(baseUrl, skillId, detail = null) {
+  const icon = String(detail?.icon || "").trim();
+  if (icon) return icon;
+  const skillText = String(skillId ?? "").trim();
+  if (!skillText) return "";
+  return `${baseUrl}/api/v1/resources/wiki/assets/skills/${skillText}.png`;
+}
+__name(petDataSkillIconUrl, "petDataSkillIconUrl");
+function wikiNamedValue2(value) {
+  if (value && typeof value === "object" && !Array.isArray(value)) {
+    return String(value.name || value.label || value.value || "");
+  }
+  return String(value ?? "");
+}
+__name(wikiNamedValue2, "wikiNamedValue");
+function petDataSkills(pet, skillLookup = {}, options = {}) {
+  const loadSkillIcons = options.loadSkillIcons !== false;
+  const baseUrl = options.baseUrl || "";
+  const result = [];
+  for (const item of petDataSkillItems(pet).slice(0, 8)) {
+    const skillId = petDataDisplay(item?.id);
+    const detail = skillId !== "--" ? skillLookup[String(skillId)] : null;
+    let status;
+    let statusClass;
+    if (item?.is_equipped) {
+      status = "已装备";
+      statusClass = "equipped";
+    } else if (item?.is_learned) {
+      status = "已学会";
+      statusClass = "learned";
+    } else {
+      status = "未学会";
+      statusClass = "locked";
+    }
+    const element = detail ? wikiNamedValue2(detail.element_type) : "";
+    const skillType = detail ? wikiNamedValue2(detail.skill_type || detail.damage_type) : "";
+    result.push({
+      id: skillId,
+      name: String(detail?.name || skillId),
+      icon: loadSkillIcons ? petDataSkillIconUrl(baseUrl, skillId, detail) : "",
+      element: element || "未知",
+      type: skillType || "技能",
+      power: petDataDisplay(detail?.power),
+      cost: petDataDisplay(detail?.cost),
+      pos: petDataDisplay(item?.pos),
+      status,
+      statusClass,
+      unlock: item?.unlock_need_lv !== void 0 && item?.unlock_need_lv !== null && item?.unlock_need_lv !== "" && item?.unlock_need_lv !== 0 ? `Lv.${item.unlock_need_lv}` : "--",
+      description: String(detail?.description || detail?.desc || "")
+    });
+  }
+  return result;
+}
+__name(petDataSkills, "petDataSkills");
+function petDataCardItems(pet, optionMaps, sizeInfo = {}) {
+  const genderMap = { "0": "未知", "1": "雄性", "2": "雌性" };
+  const gender = genderMap[String(pet?.gender ?? "")] || petDataDisplay(pet?.gender);
+  const nature = petDataLookup(optionMaps.natures, pet?.nature);
+  const blood = petDataLookup(optionMaps.bloodlines, pet?.blood_id);
+  const talentRank = petDataLookup(optionMaps.talent_ratings, pet?.talent_rank, petDataDisplay(pet?.talent_rank));
+  const voiceInfo = petDataVoiceInfo(pet?.voice);
+  let weightValue = petDataSizeText(pet?.weight, "g");
+  if (sizeInfo.label) weightValue = `${weightValue} · ${sizeInfo.label}`;
+  return [
+    { label: "等级", value: petDataDisplay(pet?.level) },
+    { label: "性别", value: gender },
+    { label: "分贝", ...voiceInfo },
+    { label: "性格", value: nature },
+    { label: "血脉", value: blood },
+    { label: "天赋评级", value: talentRank },
+    { label: "身高", value: petDataSizeText(pet?.height, "cm") },
+    {
+      label: "体重",
+      value: weightValue,
+      hint: sizeInfo.hint || "",
+      className: sizeInfo.className || ""
+    }
+  ];
+}
+__name(petDataCardItems, "petDataCardItems");
+function petDataExtractItems(payload, optionMaps, skillLookup = {}, sizeLookup = {}, options = {}) {
+  const rawItems = extractRawItems(payload);
+  const pets = [];
+  rawItems.forEach((raw, index) => {
+    const npcPet = raw?.npc_pet && typeof raw.npc_pet === "object" ? raw.npc_pet : {};
+    const pet = npcPet?.pet && typeof npcPet.pet === "object" ? npcPet.pet : {};
+    const status = String(raw?.status || (Object.keys(pet).length ? "ok" : "unknown"));
+    const { variantText, variantIcon } = petDataVariant(pet, raw);
+    const baseId = pet.base_conf_id || raw.pet_cfg_id || pet.catch_base_id || pet.conf_id;
+    const wikiPetId = petDataWikiPetId(baseId);
+    const sizeInfo = petDataWeightSizeInfo(pet, sizeLookup[wikiPetId]);
+    const name2 = pet.name || pet.pet_default_name || raw.pet_default_name || raw.name || `精灵 ${baseId || index + 1}`;
+    const defaultName = pet.pet_default_name || raw.pet_default_name || "";
+    const displayDefault = defaultName && defaultName !== name2 ? defaultName : "";
+    const petGid = pet.gid || raw.pet_gid;
+    const sceneInfo = pet.scene_info && typeof pet.scene_info === "object" ? pet.scene_info : null;
+    const furnitureGuid = raw.furniture_guid ?? (sceneInfo ? sceneInfo.npc_id : void 0);
+    pets.push({
+      index: index + 1,
+      status,
+      statusText: status === "ok" ? "成功" : status,
+      retCode: petDataDisplay(npcPet.ret_code),
+      name: String(name2),
+      defaultName: String(displayDefault),
+      level: petDataDisplay(pet.level),
+      baseId: petDataDisplay(baseId),
+      confId: petDataDisplay(pet.conf_id),
+      petGid: petDataDisplay(petGid),
+      npcId: petDataDisplay(furnitureGuid),
+      npcIdSource: petDataDisplay(raw.npc_id_source),
+      imageUrl: petDataImageUrl(baseId, "image"),
+      iconUrl: petDataImageUrl(baseId, "icon"),
+      variantText,
+      variantIcon,
+      voiceText: petDataVoiceText(pet.voice),
+      cards: petDataCardItems(pet, optionMaps, sizeInfo),
+      attributes: petDataAttributes(pet),
+      skills: petDataSkills(pet, skillLookup, options),
+      catchItems: [
+        { label: "捕捉等级", value: petDataDisplay(pet.catch_lv) },
+        { label: "捕捉方式", value: petDataDisplay(pet.catch_way) },
+        { label: "捕捉营地", value: petDataDisplay(pet.caught_camp) },
+        { label: "获得时间", value: petDataTimeText(pet.add_time) }
+      ],
+      specialityIds: (Array.isArray(pet.real_speciality_ids) ? pet.real_speciality_ids : []).map((x) => String(x)).join(" / ") || petDataDisplay(pet.speciality_id),
+      relationshipType: petDataDisplay(npcPet.relationship_type),
+      errorText: petDataDisplay(raw.error || raw.message || npcPet.error_message, "")
+    });
+  });
+  return pets;
+}
+__name(petDataExtractItems, "petDataExtractItems");
+function buildPetDataRenderData(res, uid, options = {}) {
+  let payload = res || {};
+  if (payload.result && typeof payload.result === "object") payload = payload.result;
+  const optionMaps = petDataOptionMaps(options.optionsPayload);
+  let playerInfo = payload.player_info && typeof payload.player_info === "object" ? payload.player_info : {};
+  if (!Object.keys(playerInfo).length && payload.npc_pet && typeof payload.npc_pet === "object") {
+    playerInfo = payload.npc_pet.player_info && typeof payload.npc_pet.player_info === "object" ? payload.npc_pet.player_info : {};
+  }
+  const pets = petDataExtractItems(payload, optionMaps, options.skillLookup || {}, options.sizeLookup || {}, {
+    loadSkillIcons: !options.lowBandwidthMode,
+    baseUrl: options.baseUrl || ""
+  });
+  const meta = payload.meta && typeof payload.meta === "object" ? payload.meta : {};
+  const finishedAt = normalizeEpochSeconds(meta.finished_at || meta.created_at);
+  const updatedAt = petDataTimeText(finishedAt || Math.floor(Date.now() / 1e3));
+  const online = playerInfo.online;
+  const onlineText = online === true ? "在线" : online === false ? "离线" : "未知";
+  const okCount = payload.npc_pet_ok_count;
+  const errorCount = payload.npc_pet_error_count;
+  const skippedCount = payload.npc_pet_skipped_count;
+  return {
+    title: "家园详情",
+    subtitle: "Ingame Pet Data",
+    uid: petDataDisplay(payload.uin || playerInfo.uin || uid),
+    playerName: petDataDisplay(playerInfo.name, "未知玩家"),
+    playerLevel: petDataDisplay(playerInfo.level),
+    worldLevel: petDataDisplay(playerInfo.world_level),
+    onlineText,
+    isOnline: online === true,
+    queryMode: options.singleQuery ? "单只精灵" : "家园批量",
+    lowBandwidthMode: Boolean(options.lowBandwidthMode),
+    summaryCards: [
+      { label: "目标状态", value: onlineText },
+      { label: "返回精灵", value: String(pets.length) },
+      { label: "成功/失败", value: `${petDataDisplay(okCount, String(pets.length))} / ${petDataDisplay(errorCount, "0")}` },
+      { label: "跳过", value: petDataDisplay(skippedCount, "0") }
+    ],
+    pets,
+    updatedAt,
+    notice: "该接口依赖目标玩家在线且家园可访问；离线或隐私/上游不可达时可能失败。",
+    emptyText: "未获取到家园精灵完整数据。请确认目标玩家在线、家园可访问，或稍后重试。",
+    commandHint: "💡 洛克.家园详情 <UID> | 洛克.家园详情 <UID> <pet_gid> <npc_id>",
+    copyright: "Koishi & WeGame 洛克王国插件"
+  };
+}
+__name(buildPetDataRenderData, "buildPetDataRenderData");
+
 // src/commands/query.ts
-var import_node_fs4 = __toESM(require("node:fs"));
-var import_node_path4 = __toESM(require("node:path"));
-var logger8 = new import_koishi8.Logger("rocom-query");
+var import_node_fs5 = __toESM(require("node:fs"));
+var import_node_path5 = __toESM(require("node:path"));
+var logger10 = new import_koishi10.Logger("rocom-query");
 async function sendImage(deps, session, templateName, data, fallback) {
   const png = await deps.renderer.renderHtml(deps.ctx, templateName, data);
   await sendImageWithFallback(session, png, fallback, `query:${templateName}`, deps.config);
@@ -2753,14 +5341,14 @@ function stringifyInspectValue(value) {
   return String(value);
 }
 __name(stringifyInspectValue, "stringifyInspectValue");
-function normalizeEpochSeconds(value) {
+function normalizeEpochSeconds2(value) {
   const ts = Number(value);
   if (!Number.isFinite(ts)) return 0;
   if (ts > 1e13) return Math.floor(ts / 1e6);
   if (ts > 1e10) return Math.floor(ts / 1e3);
   return Math.floor(ts);
 }
-__name(normalizeEpochSeconds, "normalizeEpochSeconds");
+__name(normalizeEpochSeconds2, "normalizeEpochSeconds");
 function formatHomeRemaining(targetTs, nowTs = Math.floor(Date.now() / 1e3)) {
   if (!targetTs) return "未开始";
   if (nowTs >= targetTs) return "已完成";
@@ -2824,12 +5412,12 @@ var PANEL_PET_STAT_DEFS = [
   { key: "special_defense", label: "魔防", addiType: 5, aliases: ["special_defense", "magic_defense", "sp_defense"] },
   { key: "speed", label: "速度", addiType: 6, aliases: ["speed", "spd"] }
 ];
-var PANEL_PET_CACHE_PATH = import_node_path4.default.join("data", "rocom", "rocom_pet_panel_cache.json");
+var PANEL_PET_CACHE_PATH = import_node_path5.default.join("data", "rocom", "rocom_pet_panel_cache.json");
 var PANEL_EMPTY_FEATURE = { id: "", name: "暂无特性", desc: "当前接口未返回特性描述。" };
 var PANEL_EMPTY_SKILL_HINT = "当前接口未返回技能详情。";
 var panelPetCacheMem = null;
 function panelPetCacheFilePath(deps) {
-  return import_node_path4.default.join(deps.ctx.baseDir, PANEL_PET_CACHE_PATH);
+  return import_node_path5.default.join(deps.ctx.baseDir, PANEL_PET_CACHE_PATH);
 }
 __name(panelPetCacheFilePath, "panelPetCacheFilePath");
 function ensureBloodlineLabel(raw, mutationLabel) {
@@ -2841,15 +5429,15 @@ function loadPanelPetCache(deps) {
   if (panelPetCacheMem) return panelPetCacheMem;
   const filePath = panelPetCacheFilePath(deps);
   try {
-    if (!import_node_fs4.default.existsSync(filePath)) {
+    if (!import_node_fs5.default.existsSync(filePath)) {
       panelPetCacheMem = {};
       return panelPetCacheMem;
     }
-    const text = import_node_fs4.default.readFileSync(filePath, "utf-8");
+    const text = import_node_fs5.default.readFileSync(filePath, "utf-8");
     const parsed = JSON.parse(text);
     panelPetCacheMem = parsed && typeof parsed === "object" ? parsed : {};
   } catch (err) {
-    logger8.warn(`加载精灵面板缓存失败: ${err}`);
+    logger10.warn(`加载精灵面板缓存失败: ${err}`);
     panelPetCacheMem = {};
   }
   return panelPetCacheMem;
@@ -2857,11 +5445,11 @@ function loadPanelPetCache(deps) {
 __name(loadPanelPetCache, "loadPanelPetCache");
 function savePanelPetCache(deps, data) {
   const filePath = panelPetCacheFilePath(deps);
-  const dir = import_node_path4.default.dirname(filePath);
-  import_node_fs4.default.mkdirSync(dir, { recursive: true });
+  const dir = import_node_path5.default.dirname(filePath);
+  import_node_fs5.default.mkdirSync(dir, { recursive: true });
   const tempPath = `${filePath}.tmp`;
-  import_node_fs4.default.writeFileSync(tempPath, JSON.stringify(data, null, 2), "utf-8");
-  import_node_fs4.default.renameSync(tempPath, filePath);
+  import_node_fs5.default.writeFileSync(tempPath, JSON.stringify(data, null, 2), "utf-8");
+  import_node_fs5.default.renameSync(tempPath, filePath);
   panelPetCacheMem = data;
 }
 __name(savePanelPetCache, "savePanelPetCache");
@@ -3358,11 +5946,22 @@ function extractHomePet(deps, raw, index, guard = false) {
   if (["", "0"].includes(String(petId || "0")) && !guard) return null;
   const nowTs = Math.floor(Date.now() / 1e3);
   const hasEgg = Boolean(raw.have_egg);
-  const predictedEggTime = normalizeEpochSeconds(raw.predicted_egg_time);
+  const predictedEggTime = normalizeEpochSeconds2(raw.predicted_egg_time);
   const eggReady = hasEgg || predictedEggTime > 0 && nowTs >= predictedEggTime;
   const feedRound = Number(homePet.feed_round || raw.feed_round || 0) || 0;
   const gender = Number(display.gender || raw.gender || 0) || 0;
-  const mutationType = Number(display.mutation_type || raw.mutation_type || homePet.mutation_type || 0) || 0;
+  let mutationType = Number(display.mutation_type || raw.mutation_type || homePet.mutation_type || 0) || 0;
+  if (!mutationType) {
+    const specialityValues = [];
+    for (const value of [homePet.real_speciality_ids, raw.real_speciality_ids, homePet.speciality_id, raw.speciality_id]) {
+      if (Array.isArray(value)) specialityValues.push(...value);
+      else if (value !== void 0 && 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 isMale = gender === 1;
   const status = homePet.status ?? raw.status;
   const isGuard = guard || Boolean(raw.is_guard || raw.guard) || ["2", "guard", "守卫"].includes(String(status).toLowerCase());
@@ -3397,6 +5996,9 @@ function extractHomePet(deps, raw, index, guard = false) {
     statusText,
     statusClass,
     note,
+    hasEgg,
+    eggReady,
+    eggTime: predictedEggTime || 0,
     inspireReady: eggReady,
     readyAt: predictedEggTime || 0,
     gender
@@ -3436,23 +6038,23 @@ function homePlantIcon(deps, iconId) {
 }
 __name(homePlantIcon, "homePlantIcon");
 var homePlantMapCache = null;
-var HOME_PLANT_MAP_RELATIVE_PATH = import_node_path4.default.join("render-templates", "home", "data", "home_item_list.json");
+var HOME_PLANT_MAP_RELATIVE_PATH = import_node_path5.default.join("render-templates", "home", "data", "home_item_list.json");
 function resolveHomePlantMapPath() {
   const candidates = [
-    import_node_path4.default.resolve(__dirname, "..", HOME_PLANT_MAP_RELATIVE_PATH),
-    import_node_path4.default.resolve(__dirname, HOME_PLANT_MAP_RELATIVE_PATH)
+    import_node_path5.default.resolve(__dirname, "..", HOME_PLANT_MAP_RELATIVE_PATH),
+    import_node_path5.default.resolve(__dirname, HOME_PLANT_MAP_RELATIVE_PATH)
   ];
-  return candidates.find((candidate) => import_node_fs4.default.existsSync(candidate)) || candidates[0];
+  return candidates.find((candidate) => import_node_fs5.default.existsSync(candidate)) || candidates[0];
 }
 __name(resolveHomePlantMapPath, "resolveHomePlantMapPath");
 function loadHomePlantMap() {
   if (homePlantMapCache) return homePlantMapCache;
   const filePath = resolveHomePlantMapPath();
   try {
-    const data = JSON.parse(import_node_fs4.default.readFileSync(filePath, "utf-8"));
+    const data = JSON.parse(import_node_fs5.default.readFileSync(filePath, "utf-8"));
     homePlantMapCache = data && typeof data === "object" ? data : {};
   } catch (err) {
-    logger8.warn(`加载家园作物映射失败: ${err}`);
+    logger10.warn(`加载家园作物映射失败: ${err}`);
     homePlantMapCache = {};
   }
   return homePlantMapCache;
@@ -3474,7 +6076,7 @@ function extractHomePlants(deps, homeInfo) {
     if (["", "0"].includes(String(plantId || "0"))) return null;
     const mappedPlant = plantMap[String(plantId)] || {};
     const iconId = plantData.icon_url || plantData.iconUrl || raw.icon_url || raw.iconUrl || plantData.iconid || raw.iconid || raw.icon_id || mappedPlant.iconid;
-    let readyAt = normalizeEpochSeconds(raw.plant_rip_time || raw.rip_time || raw.end_time);
+    let readyAt = normalizeEpochSeconds2(raw.plant_rip_time || raw.rip_time || raw.end_time);
     const leftTime = Number(raw.left_time || 0);
     if (!readyAt && leftTime > 0) readyAt = nowTs + leftTime;
     const ready = Boolean(readyAt && nowTs >= readyAt) || ["2", "ready", "mature"].includes(String(raw.status));
@@ -3527,7 +6129,7 @@ function buildHomeRenderData(deps, res, uid) {
     return 0;
   });
   const gardenPlots = extractHomePlants(deps, homeInfo);
-  const createdAt = normalizeEpochSeconds(res?.meta?.created_at);
+  const createdAt = normalizeEpochSeconds2(res?.meta?.created_at);
   return {
     title: "洛克家园",
     subtitle: "Home Information",
@@ -3688,11 +6290,31 @@ async function resolveHomeUid(deps, session, uid = "") {
   return String(deps.userMgr.getPrimaryBinding(session?.userId || "")?.role_id || "");
 }
 __name(resolveHomeUid, "resolveHomeUid");
+var HOME_SUB_TEXT = {
+  garden: {
+    kindText: "菜园作物",
+    actionText: "成熟",
+    subscribedHint: "的家园菜园提醒：首个成熟和全部成熟时各推送一次。",
+    needUidHint: "请提供玩家 UID，或先完成绑定后再订阅家园菜园。"
+  },
+  inspiration: {
+    kindText: "精灵灵感",
+    actionText: "完成",
+    subscribedHint: "的家园精灵灵感提醒：首个完成和全部完成时各推送一次。",
+    needUidHint: "请提供玩家 UID，或先完成绑定后再订阅家园灵感。"
+  },
+  egg: {
+    kindText: "精灵生蛋",
+    actionText: "可领取",
+    subscribedHint: "的家园精灵生蛋提醒：首个可领取和全部可领取时各推送一次。",
+    needUidHint: "请提供玩家 UID，或先完成绑定后再订阅家园生蛋。"
+  }
+};
 async function subscribeHome(deps, session, uid, kind) {
   const target = sessionTarget(session);
   if (!target.userId && !isBotAdmin(session, deps.config.adminUserIds)) return "此指令仅限管理员使用。";
   const targetUid = await resolveHomeUid(deps, session, uid);
-  if (!targetUid) return kind === "garden" ? "请提供玩家 UID，或先完成绑定后再订阅家园菜园。" : "请提供玩家 UID，或先完成绑定后再订阅家园灵感。";
+  if (!targetUid) return HOME_SUB_TEXT[kind].needUidHint;
   const key = homeSubscriptionKey(session, targetUid, kind);
   deps.homeSubMgr.upsert(key, {
     key,
@@ -3706,7 +6328,7 @@ async function subscribeHome(deps, session, uid, kind) {
     notify_state: {},
     updated_at: Math.floor(Date.now() / 1e3)
   });
-  return kind === "garden" ? `已订阅 UID ${targetUid} 的家园菜园提醒：首个成熟和全部成熟时各推送一次。` : `已订阅 UID ${targetUid} 的家园精灵灵感提醒：首个完成和全部完成时各推送一次。`;
+  return `已订阅 UID ${targetUid} ${HOME_SUB_TEXT[kind].subscribedHint}`;
 }
 __name(subscribeHome, "subscribeHome");
 function homeSubscriptionState(data, kind) {
@@ -3716,6 +6338,12 @@ function homeSubscriptionState(data, kind) {
     const names2 = readyItems2.map((item) => `田地${item.landIndex} ${item.plantName}`);
     return { items: items2, readyItems: readyItems2, names: names2 };
   }
+  if (kind === "egg") {
+    const items2 = [...data.indoorPets || [], ...data.guardPets || []].filter((item) => item.eggTime || item.hasEgg);
+    const readyItems2 = items2.filter((item) => item.eggReady);
+    const names2 = readyItems2.map((item) => item.name || "未知精灵");
+    return { items: items2, readyItems: readyItems2, names: names2 };
+  }
   const items = [...data.indoorPets || [], ...data.guardPets || []].filter((item) => item.readyAt);
   const readyItems = items.filter((item) => item.inspireReady);
   const names = readyItems.map((item) => item.name || "未知精灵");
@@ -3723,8 +6351,7 @@ function homeSubscriptionState(data, kind) {
 }
 __name(homeSubscriptionState, "homeSubscriptionState");
 function homeSubscriptionMessage(uid, kind, level, totalCount, readyItems, names) {
-  const kindText = kind === "garden" ? "菜园作物" : "精灵灵感";
-  const actionText = kind === "garden" ? "成熟" : "完成";
+  const { kindText, actionText } = HOME_SUB_TEXT[kind];
   const levelText = level === "first" ? "首个" : "全部";
   return [
     `家园${kindText}${levelText}${actionText}提醒：${uid}`,
@@ -3739,7 +6366,7 @@ async function checkHomeSubscriptions(deps) {
   let checkedCount = 0;
   let pushedCount = 0;
   for (const [key, sub] of Object.entries(subs)) {
-    if (!sub.uid || !["garden", "inspiration"].includes(sub.kind)) continue;
+    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: 3e4 }));
@@ -3774,7 +6401,7 @@ async function checkHomeSubscriptions(deps) {
       }, messages.join("\n\n"));
       if (!sent) continue;
     } catch (e) {
-      logger8.warn(`家园订阅推送失败: ${e}`);
+      logger10.warn(`家园订阅推送失败: ${e}`);
       continue;
     }
     for (const level of pushLevels) notifyState[level] = true;
@@ -3830,19 +6457,19 @@ function register2(deps) {
     const hasExtraProfileData = Boolean(profileSignature || profileHomeItems.length || profileCardItems.length || profileCardImage);
     let degraded = false;
     if (!sm) {
-      logger8.warn("[Rocom] 洛克.档案：pet-summary 接口不可用，已降级为基础档案渲染");
+      logger10.warn("[Rocom] 洛克.档案：pet-summary 接口不可用，已降级为基础档案渲染");
       degraded = true;
     }
     if (!ev) {
-      logger8.warn("[Rocom] 洛克.档案：evaluation 接口不可用，已降级为基础档案渲染");
+      logger10.warn("[Rocom] 洛克.档案：evaluation 接口不可用，已降级为基础档案渲染");
       degraded = true;
     }
     if (!cl) {
-      logger8.warn("[Rocom] 洛克.档案：collection 接口不可用，已降级为基础档案渲染");
+      logger10.warn("[Rocom] 洛克.档案：collection 接口不可用，已降级为基础档案渲染");
       degraded = true;
     }
     if (!bo) {
-      logger8.warn("[Rocom] 洛克.档案：battle-overview 接口不可用，已降级为基础档案渲染");
+      logger10.warn("[Rocom] 洛克.档案：battle-overview 接口不可用，已降级为基础档案渲染");
       degraded = true;
     }
     if (degraded) {
@@ -4194,6 +6821,81 @@ function register2(deps) {
     if (!res) return `家园查询失败：${client.getLastErrorBrief()}`;
     await sendImage(deps, session, "home", buildHomeRenderData(deps, res, targetUid), `【洛克家园】UID ${targetUid}`);
   });
+  ctx.command("洛克").subcommand(".家园详情 [uid:string] [petGid:string] [npcId:string]", "查询家园摆放精灵的完整 ingame 数据").alias("洛克家园详情").alias("家园详情").alias("洛克精灵数据").alias("精灵数据").action(async ({ session }, uid = "", petGid = "", npcId = "") => {
+    const petGidText = String(petGid || "").trim();
+    const npcIdText = String(npcId || "").trim();
+    if (petGidText && !npcIdText || npcIdText && !petGidText) {
+      return [
+        "请同时提供 pet_gid 和 npc_id。用法：洛克.家园详情 <UID> 或 洛克.家园详情 <UID> <pet_gid> <npc_id>",
+        "提示：该接口依赖目标玩家在线，npc_id 也可以使用 furniture_guid。"
+      ].join("\n");
+    }
+    let targetUid = String(uid || "").trim();
+    if (!targetUid) {
+      const binding = deps.userMgr.getPrimaryBinding(session.userId);
+      targetUid = String(binding?.role_id || "");
+    }
+    if (!targetUid) return "请提供玩家 UID，或先完成绑定后使用 洛克.家园详情。目标玩家需要在线。";
+    let queuedNotified = false;
+    const res = await client.ingamePetData(ctx, targetUid, { petGid: petGidText, npcId: npcIdText }, {
+      waitMs: 2e4,
+      intervalMs: deps.config.homeQueryPollIntervalMs,
+      timeoutMs: deps.config.homeQueryTimeoutMs,
+      onQueued: /* @__PURE__ */ __name(async () => {
+        if (queuedNotified) return;
+        queuedNotified = true;
+        await session?.send?.(`UID ${targetUid} 的家园详情查询已进入队列，正在等待游戏侧返回，请稍候…`);
+      }, "onQueued")
+    });
+    if (!res) {
+      return [
+        `家园详情查询失败：${client.getLastErrorBrief()}`,
+        "提示：该接口需要目标玩家在线，且目标家园可访问；离线时通常无法获取完整数据。"
+      ].join("\n");
+    }
+    const lowBandwidth = Boolean(deps.config.lowBandwidthMode);
+    const [optionsPayload, skillLookup, sizeLookup] = await Promise.all([
+      deps.wikiService.getOptionsPayload().catch(() => ({})),
+      (async () => {
+        const lookup = {};
+        const ids = petDataSkillIdsFromPayload(res);
+        await Promise.all(ids.map(async (id) => {
+          const detail = await deps.wikiService.getSkillDetailCached(id).catch(() => null);
+          if (detail) lookup[id] = detail;
+        }));
+        return lookup;
+      })(),
+      (async () => {
+        const lookup = {};
+        const ids = petDataPetIdsFromPayload(res);
+        await Promise.all(ids.map(async (id) => {
+          const detail = await deps.wikiService.getPetDetailCached(id).catch(() => null);
+          if (detail) lookup[id] = detail;
+        }));
+        return lookup;
+      })()
+    ]);
+    const data = buildPetDataRenderData(res, targetUid || "当前绑定", {
+      optionsPayload,
+      skillLookup,
+      sizeLookup,
+      singleQuery: Boolean(petGidText && npcIdText),
+      lowBandwidthMode: lowBandwidth,
+      baseUrl: deps.config.apiBaseUrl.replace(/\/$/, "")
+    });
+    const fallbackLines = [
+      `家园详情 - UID ${data.uid}（${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 || "--"}`);
+    }
+    if (!data.pets?.length) fallbackLines.push(data.emptyText);
+    fallbackLines.push("");
+    fallbackLines.push("若服务器带宽过小导致生成超时，请在配置项打开低带宽模式。");
+    fallbackLines.push("低带宽模式开启后，家园详情将不再加载技能图标。");
+    await sendImage(deps, session, "pet-data", data, fallbackLines.join("\n"));
+  });
   ctx.command("洛克").subcommand(".刷新面板 [uid:string]", "刷新指定 UID 的精灵面板缓存").alias("洛克刷新面板").alias("刷新面板").alias("刷新精灵").alias("强制刷新").action(async ({ session }, uid = "") => {
     const targetUid = panelUidFromBinding(deps, session, uid);
     if (!targetUid) return "请提供 UID，或先绑定账号后再使用 洛克.刷新面板。";
@@ -4271,10 +6973,11 @@ function register2(deps) {
   });
   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("取消订阅家园 [kind:string] [uid:string]", "取消当前会话的家园订阅").action(async ({ session }, kind = "全部", uid = "") => {
     const target = sessionTarget(session);
     if (!target.userId && !isBotAdmin(session, deps.config.adminUserIds)) return "此指令仅限管理员使用。";
-    const kindMap = { "菜园": "garden", "灵感": "inspiration", "全部": "", all: "", garden: "garden", inspiration: "inspiration" };
+    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} 条家园订阅。` : "当前会话没有匹配的家园订阅。";
   });
@@ -4284,14 +6987,14 @@ function register2(deps) {
     return `家园订阅检查完成：订阅 ${result.subscriptions} 条，检查 ${result.checked} 条，推送 ${result.pushed} 档提醒。`;
   });
   if (deps.config.homeSubscriptionEnabled) {
-    ctx.setInterval(() => checkHomeSubscriptions(deps).catch((err) => logger8.warn(`家园订阅检查失败: ${err}`)), Math.max(1, deps.config.homeSubscriptionIntervalMinutes || 5) * 6e4);
+    ctx.setInterval(() => checkHomeSubscriptions(deps).catch((err) => logger10.warn(`家园订阅检查失败: ${err}`)), Math.max(1, deps.config.homeSubscriptionIntervalMinutes || 5) * 6e4);
   }
 }
 __name(register2, "register");
 
 // src/commands/merchant.ts
-var import_koishi9 = require("koishi");
-var logger9 = new import_koishi9.Logger("rocom-merchant");
+var import_koishi11 = require("koishi");
+var logger11 = new import_koishi11.Logger("rocom-merchant");
 var TEXT = {
   merchant: "远行商人",
   todayMerchant: "今日远行商人",
@@ -4792,7 +7495,7 @@ async function checkMerchantSubscriptions(deps) {
     const platform = sub.platform || ctx.bots[0]?.platform;
     const channelId = sub.channel_id || sub.group_id || sub.user_id || key;
     if (!platform || !channelId) {
-      logger9.warn(`推送失败 ${key}: 无法确定平台或频道`);
+      logger11.warn(`推送失败 ${key}: 无法确定平台或频道`);
       continue;
     }
     const fallbackText = `${msg}
@@ -4816,7 +7519,7 @@ ${fallback}`;
 __name(checkMerchantSubscriptions, "checkMerchantSubscriptions");
 function register3(deps) {
   const { ctx, config, client, merchantSubMgr } = deps;
-  ctx.command(TEXT.merchant, "查看远行商人商品").action(async ({ session }) => {
+  ctx.command(TEXT.merchant, "查看远行商人商品").alias("yxsr").action(async ({ session }) => {
     const res = await client.getMerchantInfo(ctx, true);
     if (!res) return `获取远行商人数据失败：${client.getLastErrorBrief()}`;
     const { data, fallback, templateName } = buildConfiguredMerchantRenderPayload(deps, res);
@@ -4875,6 +7578,13 @@ function register3(deps) {
     return `远行商人订阅检查完成：订阅 ${result.subscriptions} 条，命中 ${result.matched} 条，推送 ${result.pushed} 条。`;
   });
   if (config.merchantSubscriptionEnabled) {
+    const MERCHANT_JITTER_MS = 3e4;
+    const runCheckWithJitter = /* @__PURE__ */ __name(() => {
+      const jitter = Math.floor(Math.random() * MERCHANT_JITTER_MS);
+      setTimeout(() => {
+        checkMerchantSubscriptions(deps).catch((err) => logger11.warn(`远行商人订阅检查失败: ${err}`));
+      }, jitter);
+    }, "runCheckWithJitter");
     if (config.merchantCheckMode === "times" && config.merchantCheckTimes.length > 0) {
       let lastMerchantCheckKey = "";
       ctx.setInterval(async () => {
@@ -4884,11 +7594,11 @@ function register3(deps) {
         const checkKey = `${now.toDateString()}-${timeStr}`;
         if (checkKey === lastMerchantCheckKey) return;
         lastMerchantCheckKey = checkKey;
-        await checkMerchantSubscriptions(deps);
+        runCheckWithJitter();
       }, 6e4);
     } else {
       ctx.setInterval(async () => {
-        await checkMerchantSubscriptions(deps);
+        runCheckWithJitter();
       }, config.merchantCheckInterval);
     }
   }
@@ -4896,11 +7606,156 @@ function register3(deps) {
 __name(register3, "register");
 
 // src/commands/wiki.ts
-var WIKI_CLOSED_MESSAGE = "该功能暂时关闭";
+var import_koishi12 = require("koishi");
+var import_node_fs6 = __toESM(require("node:fs"));
+var logger12 = new import_koishi12.Logger("rocom-wiki-cmd");
+async function sendImage2(deps, session, templateName, data, fallback) {
+  const png = await deps.renderer.renderHtml(deps.ctx, templateName, data);
+  await sendImageWithFallback(session, png, fallback, `wiki:${templateName}`, deps.config);
+}
+__name(sendImage2, "sendImage");
+async function handleWikiQuery(deps, session, rawText) {
+  const { ctx, wikiService } = deps;
+  const trimmed = String(rawText || "").trim();
+  const rawKey = trimmed.toLowerCase();
+  const catalogsMeta = await wikiService.getCatalogsPayload();
+  if (!trimmed || ["帮助", "help", "类型", "目录", "专题"].includes(rawKey)) {
+    const optionsMeta = await wikiService.getOptionsPayload();
+    const data2 = wikiService.buildCatalogRenderData(catalogsMeta, optionsMeta);
+    await sendImage2(deps, session, "wiki/menu", data2, wikiService.catalogUsageText());
+    return;
+  }
+  let { catalog, query, pageNo } = wikiService.parseWikiCommand(trimmed);
+  if (catalog) {
+    catalog = wikiService.catalogForKeyFromPayload(String(catalog.key || ""), catalogsMeta) || catalog;
+  }
+  if (!catalog) {
+    const { parts, pageNo: parsedPageNo } = splitWikiCommandParts(trimmed);
+    if (parts.length) {
+      const dynamicCatalog = wikiService.dynamicCatalogByToken(parts[0], catalogsMeta);
+      if (dynamicCatalog) {
+        catalog = dynamicCatalog;
+        query = parts.slice(1).join(" ").trim();
+        pageNo = parsedPageNo;
+      }
+    }
+  }
+  if (!catalog) {
+    const { payload: payload2, mode: mode2, error: error2 } = await wikiService.fetchGlobalSearch(query, pageNo);
+    if (error2) return error2;
+    if (mode2 === "global-detail") {
+      const sourceCatalog = payload2?._catalog || {};
+      const detail = payload2?.item && typeof payload2.item === "object" ? payload2.item : {};
+      const sourceKey = String(sourceCatalog?.key || "");
+      if (sourceKey === "pets") {
+        const sections = await wikiService.fetchWikiPetSections(detail.pet_id);
+        const data4 = buildWikiPetRenderData(detail, sections.profile, sections.skills, sections.family, sections.handbook, query);
+        await sendImage2(deps, session, "wiki/pet", data4, [
+          `${data4.name} #${data4.number}`,
+          `属性：${data4.type_names.join(" / ") || "暂无"}`,
+          `蛋组：${data4.egg_groups.join(" / ") || "暂无"}`,
+          data4.description
+        ].join("\n"));
+        return;
+      }
+      if (sourceKey === "skills") {
+        const pets = await deps.client.getWikiSkillPets(ctx, detail.skill_id);
+        const data4 = buildWikiSkillRenderData(detail, pets && typeof pets === "object" ? pets : {}, query);
+        await sendImage2(deps, session, "wiki/skill", data4, `${data4.name} #${data4.skill_id}
+${data4.description}`);
+        return;
+      }
+      const data3 = wikiService.buildGenericRenderData(sourceCatalog?.key ? sourceCatalog : { title: "全局搜索", key: "global" }, detail, query, "detail", pageNo);
+      await sendImage2(deps, session, "wiki/detail", data3, `${data3.title}
+${data3.summary || ""}`);
+      return;
+    }
+    const data2 = wikiService.buildGenericRenderData({ title: "全局搜索", key: "global" }, payload2, query, "global-search", pageNo);
+    await sendImage2(deps, session, "wiki/list", data2, `${data2.title}
+${data2.summary || ""}`);
+    return;
+  }
+  if (["pets", "pet"].includes(catalog.key) && query) {
+    const { detail: overview, candidates, error: error2 } = await wikiService.resolveWikiPet(query);
+    if (error2) return error2;
+    if (candidates.length) return wikiCandidateText(query, candidates, "精灵");
+    if (!overview) return "获取 Wiki 精灵详情失败：接口未返回有效数据。";
+    const sections = await wikiService.fetchWikiPetSections(overview.pet_id);
+    const data2 = buildWikiPetRenderData(overview, sections.profile, sections.skills, sections.family, sections.handbook, query);
+    await sendImage2(deps, session, "wiki/pet", data2, `${data2.name} #${data2.number}
+${data2.description}`);
+    return;
+  }
+  if (["skills", "skill"].includes(catalog.key) && query) {
+    const { detail, candidates, error: error2 } = await wikiService.resolveWikiSkill(query);
+    if (error2) return error2;
+    if (candidates.length) return wikiCandidateText(query, candidates, "技能");
+    if (!detail) return "获取技能详情失败：接口未返回有效数据。";
+    const pets = await deps.client.getWikiSkillPets(ctx, detail.skill_id);
+    const data2 = buildWikiSkillRenderData(detail, pets && typeof pets === "object" ? pets : {}, query);
+    await sendImage2(deps, session, "wiki/skill", data2, `${data2.name} #${data2.skill_id}
+${data2.description}`);
+    return;
+  }
+  const { payload, mode, error } = await wikiService.fetchGenericCatalog(catalog, query, pageNo);
+  if (error) return error;
+  const data = wikiService.buildGenericRenderData(catalog, payload, query, mode, pageNo);
+  let templateName = "wiki/detail";
+  if (mode === "list") templateName = "wiki/list";
+  else if (mode === "suggestions") templateName = "wiki/suggestions";
+  await sendImage2(deps, session, templateName, data, `${data.title}
+${data.summary || ""}`);
+}
+__name(handleWikiQuery, "handleWikiQuery");
 function register4(deps) {
-  const { ctx } = deps;
-  ctx.command("洛克").subcommand(".wiki <name:text>", "查询精灵 wiki").alias("洛克wiki").action(() => WIKI_CLOSED_MESSAGE);
-  ctx.command("洛克").subcommand(".技能 <name:text>", "查询技能 wiki").alias("洛克技能").action(() => WIKI_CLOSED_MESSAGE);
+  const { ctx, atlasService } = deps;
+  ctx.command("洛克").subcommand(".wiki [name:text]", "查询洛克 Wiki（精灵/技能/物品等，支持全局搜索）").alias("洛克wiki").alias("洛克百科").action(async ({ session }, name2 = "") => handleWikiQuery(deps, session, name2));
+  ctx.command("洛克").subcommand(".技能 <name:text>", "查询技能 Wiki").alias("洛克技能").action(async ({ session }, name2 = "") => handleWikiQuery(deps, session, `技能 ${String(name2 || "").trim()}`));
+  ctx.command("图鉴下载", "下载 Rocom-Atlas 精灵图鉴到本地缓存").alias("洛克图鉴下载").action(async ({ session }) => {
+    if (!deps.config.adminUserIds.includes(session?.userId || "")) return "此指令仅限管理员使用。";
+    await session?.send?.("开始下载 Rocom-Atlas 图鉴，请稍候…");
+    let lastPercent = -20;
+    try {
+      const { imageCount, totalBytes } = await atlasService.download(ctx, async (percent, stage) => {
+        if (percent - lastPercent >= 20 || percent >= 100) {
+          lastPercent = percent;
+          await session?.send?.(`图鉴下载进度 ${percent}%：${stage}`);
+        }
+      });
+      const sizeMb = (totalBytes / 1024 / 1024).toFixed(1);
+      return `图鉴下载完成：共 ${imageCount} 张精灵图片，占用约 ${sizeMb} MB。
+使用：精灵图鉴 <精灵名>`;
+    } catch (e) {
+      logger12.warn(`图鉴下载失败: ${e}`);
+      return `图鉴下载失败：${e instanceof Error ? e.message : e}`;
+    }
+  });
+  ctx.command("精灵图鉴 <name:text>", "使用本地 Rocom-Atlas 查询精灵图鉴图片").alias("洛克精灵图鉴").action(async ({ session }, name2 = "") => {
+    const query = String(name2 || "").trim();
+    if (!query) return "请输入精灵名称。用法：精灵图鉴 <精灵名>";
+    if (!atlasService.isReady()) {
+      return "本地图鉴尚未下载。请管理员先执行：图鉴下载";
+    }
+    const { name: matchedName, imagePath, candidates } = atlasService.findMatch(query);
+    if (imagePath) {
+      try {
+        const image = import_node_fs6.default.readFileSync(imagePath);
+        await session?.send?.((0, import_koishi12.h)("message", {}, import_koishi12.h.text(`【精灵图鉴】${matchedName}
+`), import_koishi12.h.image(image, "image/png")));
+        return;
+      } catch (e) {
+        logger12.warn(`读取图鉴图片失败: ${e}`);
+        return `读取图鉴图片失败：${e instanceof Error ? e.message : e}`;
+      }
+    }
+    if (candidates.length) {
+      const lines = [`未精确匹配「${query}」，可能是：`];
+      candidates.forEach((item, idx) => lines.push(`${idx + 1}. ${item}`));
+      lines.push("请使用更精确名称重新查询。");
+      return lines.join("\n");
+    }
+    return `未在本地图鉴中找到「${query}」。可尝试其他名称，或联系管理员更新图鉴（图鉴下载）。`;
+  });
 }
 __name(register4, "register");
 
@@ -5095,7 +7950,7 @@ function register5(deps) {
 __name(register5, "register");
 
 // src/commands/tools.ts
-var import_koishi10 = require("koishi");
+var import_koishi13 = require("koishi");
 
 // src/activities-service.ts
 var CHINA_TIMEZONE2 = "Asia/Shanghai";
@@ -5383,7 +8238,7 @@ var ActivitiesService = class {
 };
 
 // src/commands/tools.ts
-var logger10 = new import_koishi10.Logger("rocom-tools");
+var logger13 = new import_koishi13.Logger("rocom-tools");
 var activitiesService = new ActivitiesService();
 function trimText2(value) {
   return String(value ?? "").trim();
@@ -5422,6 +8277,63 @@ function announcementId(item) {
   return trimText2(item?.thread_id || item?.id);
 }
 __name(announcementId, "announcementId");
+function announcementTimestamp(item) {
+  for (const key of ["published_at_ts", "publish_at_ts", "created_at_ts"]) {
+    const value = Number(item?.[key]);
+    if (Number.isFinite(value) && value > 0) return value;
+  }
+  for (const key of ["publishAt", "published_at", "createdAt"]) {
+    const text = trimText2(item?.[key]);
+    if (!text) continue;
+    const date = new Date(text);
+    if (!Number.isNaN(date.getTime())) return Math.floor(date.getTime() / 1e3);
+  }
+  return 0;
+}
+__name(announcementTimestamp, "announcementTimestamp");
+function announcementSubscriptionKey(session) {
+  const privateChat = !session?.guildId;
+  return [session?.platform || "", session?.channelId || "private", privateChat ? session?.userId || "" : "", "announcement"].join(":");
+}
+__name(announcementSubscriptionKey, "announcementSubscriptionKey");
+async function checkAnnouncementSubscriptions(deps) {
+  const { ctx, client, announcementSubMgr } = deps;
+  const subs = announcementSubMgr.getAll();
+  const subEntries = Object.entries(subs);
+  if (!subEntries.length) return { subscriptions: 0, pushed: 0 };
+  const latest = await client.getLatestAnnouncement(ctx, { category_id: 99 });
+  const item = latest?.detail || latest?.announcement || latest;
+  const latestId = announcementId(item);
+  if (!latestId) return { subscriptions: subEntries.length, pushed: 0 };
+  const latestTs = announcementTimestamp(item);
+  let pushed = 0;
+  for (const [key, sub] of subEntries) {
+    if (latestId === String(sub.last_id || "")) continue;
+    if (latestTs && sub.since_ts && latestTs <= sub.since_ts) continue;
+    const message = [`【洛克王国新公告】`, buildAnnouncementDetailText(latest)].join("\n");
+    try {
+      const sent = await sendScheduledMessage(ctx, {
+        platform: sub.platform,
+        channelId: sub.channel_id || sub.guild_id || sub.user_id || "",
+        guildId: sub.guild_id || "",
+        userId: sub.user_id || ""
+      }, message);
+      if (!sent) continue;
+    } catch (e) {
+      logger13.warn(`公告订阅推送失败: ${e}`);
+      continue;
+    }
+    pushed++;
+    announcementSubMgr.upsert(key, {
+      ...sub,
+      last_id: latestId,
+      since_ts: latestTs || Math.floor(Date.now() / 1e3),
+      updated_at: Math.floor(Date.now() / 1e3)
+    });
+  }
+  return { subscriptions: subEntries.length, pushed };
+}
+__name(checkAnnouncementSubscriptions, "checkAnnouncementSubscriptions");
 function buildAnnouncementListText(data, page) {
   const list = firstArray(data, ["list", "items"]);
   if (!list.length) return page > 1 ? "该页没有更多公告。" : "当前没有公告数据。";
@@ -5497,11 +8409,45 @@ function register6(deps) {
     if (!data) return `公告详情查询失败：${client.getLastErrorBrief()}`;
     return buildAnnouncementDetailText(data);
   });
+  ctx.command("订阅洛克公告", "订阅洛克王国新公告推送").action(async ({ session }) => {
+    const privateChat = !session?.guildId;
+    if (!privateChat && !config.adminUserIds.includes(session?.userId || "")) return "此指令仅限管理员使用。";
+    const key = announcementSubscriptionKey(session);
+    const latest = await client.getLatestAnnouncement(ctx, { category_id: 99 }, session?.userId || "");
+    const item = latest?.detail || latest?.announcement || latest;
+    deps.announcementSubMgr.upsert(key, {
+      key,
+      platform: session?.platform || "",
+      channel_id: session?.channelId || "",
+      guild_id: session?.guildId || "",
+      user_id: privateChat ? session?.userId || "" : "",
+      updated_by: session?.userId || "",
+      last_id: announcementId(item),
+      since_ts: announcementTimestamp(item) || Math.floor(Date.now() / 1e3),
+      updated_at: Math.floor(Date.now() / 1e3)
+    });
+    return "已订阅洛克王国新公告推送，检测到新公告时会在当前会话提醒。";
+  });
+  ctx.command("取消订阅洛克公告", "取消洛克王国新公告推送").action(async ({ session }) => {
+    const privateChat = !session?.guildId;
+    if (!privateChat && !config.adminUserIds.includes(session?.userId || "")) return "此指令仅限管理员使用。";
+    const deleted = deps.announcementSubMgr.deleteMatching({
+      platform: session?.platform || "",
+      channelId: session?.channelId || "",
+      userId: privateChat ? session?.userId || "" : ""
+    });
+    return deleted ? "已取消洛克公告订阅。" : "当前会话没有洛克公告订阅。";
+  });
+  if (config.announcementSubscriptionEnabled) {
+    ctx.setInterval(() => {
+      checkAnnouncementSubscriptions(deps).catch((err) => logger13.warn(`公告订阅检查失败: ${err}`));
+    }, Math.max(1, config.announcementPollIntervalMinutes || 10) * 6e4);
+  }
   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()}`;
-    logger10.info(`manual config sync requested by ${session?.userId || "unknown"}`);
+    logger13.info(`manual config sync requested by ${session?.userId || "unknown"}`);
     const skipped = Array.isArray(data?.skipped_resources) ? data.skipped_resources.length : 0;
     return skipped ? `配置同步完成，但有 ${skipped} 个资源跳过。` : "配置同步完成。";
   });
@@ -5509,8 +8455,8 @@ function register6(deps) {
 __name(register6, "register");
 
 // src/commands/admin.ts
-var import_koishi11 = require("koishi");
-var logger11 = new import_koishi11.Logger("rocom-admin");
+var import_koishi14 = require("koishi");
+var logger14 = new import_koishi14.Logger("rocom-admin");
 function register7(deps) {
   const { ctx, config, client, userMgr } = deps;
   function isAdmin(userId) {
@@ -5556,7 +8502,7 @@ function register7(deps) {
     for (const [userId, bindings] of Object.entries(allUsers)) {
       const token = await getRoleToken(ctx, userId);
       if (!token?.fwt) {
-        logger11.warn(`用户 ${userId} 没有可用的 fwt，跳过失效检测`);
+        logger14.warn(`用户 ${userId} 没有可用的 fwt，跳过失效检测`);
         totalSkipped += bindings.length;
         continue;
       }
@@ -5583,7 +8529,7 @@ function register7(deps) {
           try {
             await client.deleteBinding(ctx, binding.binding_id, userId);
           } catch (e) {
-            logger11.warn(`删除用户 ${userId} 服务端绑定 ${binding.binding_id} 失败：${e}`);
+            logger14.warn(`删除用户 ${userId} 服务端绑定 ${binding.binding_id} 失败：${e}`);
           }
         }
         totalInvalid++;
@@ -5622,7 +8568,7 @@ function register7(deps) {
             });
           }
         } catch (e) {
-          logger11.warn(`自动刷新用户 ${userId} 失败: ${e}`);
+          logger14.warn(`自动刷新用户 ${userId} 失败: ${e}`);
         }
       }
     }, 3e4);
@@ -5633,7 +8579,7 @@ __name(register7, "register");
 // src/index.ts
 var name = "rocom";
 var inject = { required: ["puppeteer", "database"] };
-var logger12 = new import_koishi12.Logger("rocom");
+var logger15 = new import_koishi15.Logger("rocom");
 var MENU_PAGE_TITLE = "洛克王国帮助菜单";
 var MENU_PAGE_SUBTITLE = "输入对应命令可查看功能，部分数据查询需要先完成账号绑定。";
 var MENU_GROUPS = [
@@ -5661,6 +8607,7 @@ var MENU_GROUPS = [
       { cmd: "洛克.交换大厅", desc: "查看交换大厅" },
       { cmd: "洛克.玩家", desc: "查询 ingame 玩家资料" },
       { cmd: "洛克.家园", desc: "查询家园菜园" },
+      { cmd: "洛克.家园详情", desc: "家园精灵完整数据" },
       { cmd: "洛克.商店", desc: "查询 ingame 商店" },
       { cmd: "洛克.日历", desc: "查看活动日历" },
       { cmd: "洛克.公告", desc: "查看公告列表" },
@@ -5676,14 +8623,19 @@ var MENU_GROUPS = [
       { cmd: "取消订阅远行商人", desc: "取消商人提醒" },
       { cmd: "订阅家园菜园", desc: "菜园成熟提醒" },
       { cmd: "订阅家园灵感", desc: "精灵灵感提醒" },
-      { cmd: "取消订阅家园", desc: "取消家园订阅" }
+      { cmd: "订阅家园生蛋", desc: "精灵生蛋提醒" },
+      { cmd: "取消订阅家园", desc: "取消家园订阅" },
+      { cmd: "订阅洛克公告", desc: "新公告推送提醒" },
+      { cmd: "取消订阅洛克公告", desc: "取消公告订阅" }
     ]
   },
   {
     groupTitle: "百科与查蛋",
     menuItems: [
-      { cmd: "洛克.wiki", desc: "精灵 Wiki 查询" },
+      { cmd: "洛克.wiki", desc: "Wiki 全局/分类查询" },
       { cmd: "洛克.技能", desc: "技能 Wiki 查询" },
+      { cmd: "精灵图鉴", desc: "本地图鉴查图" },
+      { cmd: "图鉴下载", desc: "下载图鉴缓存(管理员)" },
       { cmd: "洛克.查蛋", desc: "精灵查蛋 / 尺寸反查" },
       { cmd: "洛克.配种", desc: "配种查询" }
     ]
@@ -5709,56 +8661,69 @@ function buildMenuFallbackText() {
   return lines.join("\n").trimEnd();
 }
 __name(buildMenuFallbackText, "buildMenuFallbackText");
-var Config = import_koishi12.Schema.intersect([
-  import_koishi12.Schema.object({
-    apiBaseUrl: import_koishi12.Schema.string().default("https://wegame.shallow.ink").description("API 基础地址"),
-    wegameApiKey: import_koishi12.Schema.string().default("").description("WeGame API Key（获取 key 查看 Github：https://github.com/Entropy-Increase-Team/koishi-plugin-rocom ）"),
-    qqLoginDebugMode: import_koishi12.Schema.boolean().default(false).description("QQ 扫码登录调试模式，仅调试时开启"),
-    adminUserIds: import_koishi12.Schema.array(String).default([]).description("管理员用户 ID 列表"),
-    autoRefreshEnabled: import_koishi12.Schema.boolean().default(false).description("启用自动刷新凭证"),
-    autoRefreshTime: import_koishi12.Schema.array(String).default(["00:00", "12:00"]).description("自动刷新时间")
+var Config = import_koishi15.Schema.intersect([
+  import_koishi15.Schema.object({
+    apiBaseUrl: import_koishi15.Schema.string().default("https://wegame.shallow.ink").description("API 基础地址"),
+    wegameApiKey: import_koishi15.Schema.string().default("").description("WeGame API Key（获取 key 查看 Github：https://github.com/Entropy-Increase-Team/koishi-plugin-rocom ）"),
+    qqLoginDebugMode: import_koishi15.Schema.boolean().default(false).description("QQ 扫码登录调试模式，仅调试时开启"),
+    adminUserIds: import_koishi15.Schema.array(String).default([]).description("管理员用户 ID 列表"),
+    autoRefreshEnabled: import_koishi15.Schema.boolean().default(false).description("启用自动刷新凭证"),
+    autoRefreshTime: import_koishi15.Schema.array(String).default(["00:00", "12:00"]).description("自动刷新时间")
   }).description("基础设置"),
-  import_koishi12.Schema.object({
-    imageCompressionEnabled: import_koishi12.Schema.boolean().default(true).description("发送图片前启用 PNG 无损压缩"),
-    imageCompressionMinBytes: import_koishi12.Schema.number().default(262144).description("触发压缩的最小图片大小，单位字节"),
-    imageCompressionLevel: import_koishi12.Schema.number().min(0).max(9).default(9).description("PNG zlib 压缩等级 0-9")
+  import_koishi15.Schema.object({
+    imageCompressionEnabled: import_koishi15.Schema.boolean().default(true).description("发送图片前启用 PNG 无损压缩"),
+    imageCompressionMinBytes: import_koishi15.Schema.number().default(262144).description("触发压缩的最小图片大小，单位字节"),
+    imageCompressionLevel: import_koishi15.Schema.number().min(0).max(9).default(9).description("PNG zlib 压缩等级 0-9")
   }).description("图片压缩设置"),
-  import_koishi12.Schema.object({
-    merchantSubscriptionEnabled: import_koishi12.Schema.boolean().default(true).description("启用远行商人订阅"),
-    merchantSubscriptionItems: import_koishi12.Schema.array(String).default(["国王球", "棱镜球", "炫彩精灵蛋"]).description("默认订阅商品"),
-    merchantUiStyle: import_koishi12.Schema.union(["new", "old"]).default("new").description("远行商人 UI 样式：new 为新版大图卡片，old 为旧版列表卡片"),
-    merchantCheckMode: import_koishi12.Schema.union(["interval", "times"]).default("interval").description("商人检查模式：interval 定期轮询 / times 指定时间点"),
-    merchantCheckInterval: import_koishi12.Schema.number().default(3e5).description("商人检查间隔，单位毫秒（仅 interval 模式生效）"),
-    merchantCheckTimes: import_koishi12.Schema.array(String).default([]).description("商人定时检查时间点（HH:MM 格式，如 08:00，仅 times 模式生效）"),
-    merchantPrivateSubscriptionEnabled: import_koishi12.Schema.boolean().default(true).description("允许个人私聊订阅远行商人推送"),
-    homeSubscriptionEnabled: import_koishi12.Schema.boolean().default(true).description("启用家园菜园和灵感订阅推送"),
-    homeSubscriptionIntervalMinutes: import_koishi12.Schema.number().default(5).description("家园订阅检查间隔，单位分钟")
+  import_koishi15.Schema.object({
+    merchantSubscriptionEnabled: import_koishi15.Schema.boolean().default(true).description("启用远行商人订阅"),
+    merchantSubscriptionItems: import_koishi15.Schema.array(String).default(["国王球", "棱镜球", "炫彩精灵蛋"]).description("默认订阅商品"),
+    merchantUiStyle: import_koishi15.Schema.union(["new", "old"]).default("new").description("远行商人 UI 样式：new 为新版大图卡片，old 为旧版列表卡片"),
+    merchantCheckMode: import_koishi15.Schema.union(["interval", "times"]).default("interval").description("商人检查模式：interval 定期轮询 / times 指定时间点"),
+    merchantCheckInterval: import_koishi15.Schema.number().default(3e5).description("商人检查间隔，单位毫秒（仅 interval 模式生效）"),
+    merchantCheckTimes: import_koishi15.Schema.array(String).default([]).description("商人定时检查时间点（HH:MM 格式，如 08:00，仅 times 模式生效）"),
+    merchantPrivateSubscriptionEnabled: import_koishi15.Schema.boolean().default(true).description("允许个人私聊订阅远行商人推送"),
+    homeSubscriptionEnabled: import_koishi15.Schema.boolean().default(true).description("启用家园菜园和灵感订阅推送"),
+    homeSubscriptionIntervalMinutes: import_koishi15.Schema.number().default(5).description("家园订阅检查间隔，单位分钟"),
+    announcementSubscriptionEnabled: import_koishi15.Schema.boolean().default(true).description("启用洛克公告订阅推送"),
+    announcementPollIntervalMinutes: import_koishi15.Schema.number().default(10).description("公告订阅检查间隔，单位分钟")
   }).description("订阅推送设置"),
-  import_koishi12.Schema.object({
-    homeQueryWaitMs: import_koishi12.Schema.number().default(5e3).description("家园查询服务端同步等待毫秒（long-poll，超过此时间未出结果则转入排队）"),
-    homeQueryPollIntervalMs: import_koishi12.Schema.number().default(3e3).description("家园查询进入排队后的轮询间隔，单位毫秒"),
-    homeQueryTimeoutMs: import_koishi12.Schema.number().default(18e4).description("家园查询排队等候的总超时，单位毫秒，超时后提示稍后重试")
-  }).description("家园查询排队设置")
+  import_koishi15.Schema.object({
+    homeQueryWaitMs: import_koishi15.Schema.number().default(5e3).description("家园查询服务端同步等待毫秒（long-poll，超过此时间未出结果则转入排队）"),
+    homeQueryPollIntervalMs: import_koishi15.Schema.number().default(3e3).description("家园查询进入排队后的轮询间隔，单位毫秒"),
+    homeQueryTimeoutMs: import_koishi15.Schema.number().default(18e4).description("家园查询排队等候的总超时，单位毫秒，超时后提示稍后重试"),
+    lowBandwidthMode: import_koishi15.Schema.boolean().default(false).description("低带宽模式：家园详情不再加载技能图标，降低长图生成压力")
+  }).description("家园查询排队设置"),
+  import_koishi15.Schema.object({
+    atlasZipUrls: import_koishi15.Schema.array(String).default([
+      "https://codeload.github.com/Entropy-Increase-Team/Rocom-Atlas/zip/refs/heads/main",
+      "https://github.com/Entropy-Increase-Team/Rocom-Atlas/archive/refs/heads/main.zip"
+    ]).description("图鉴压缩包下载地址列表（按顺序尝试，均失败后转 git clone）"),
+    atlasGitUrl: import_koishi15.Schema.string().default("https://github.com/Entropy-Increase-Team/Rocom-Atlas.git").description("图鉴 git clone 地址（压缩包下载失败时回退使用）")
+  }).description("图鉴下载设置")
 ]);
 function apply(ctx, config) {
   setupRoleTokenModel(ctx);
   const client = new RocomClient(config.apiBaseUrl, config.wegameApiKey);
-  const dataDir = import_node_path5.default.join(ctx.baseDir, "data", "rocom");
+  const dataDir = import_node_path6.default.join(ctx.baseDir, "data", "rocom");
   const userMgr = new UserManager(dataDir);
   const merchantSubMgr = new MerchantSubscriptionManager(dataDir);
   const homeSubMgr = new HomeSubscriptionManager(dataDir);
-  const resPath = import_node_path5.default.resolve(__dirname, "..");
+  const announcementSubMgr = new AnnouncementSubscriptionManager(dataDir);
+  const resPath = import_node_path6.default.resolve(__dirname, "..");
   const renderer = new Renderer(resPath);
-  const renderTemplateRoot = import_node_fs5.default.existsSync(import_node_path5.default.join(resPath, "lib", "render-templates")) ? import_node_path5.default.join(resPath, "lib", "render-templates") : import_node_path5.default.join(resPath, "src", "render-templates");
-  const searcheggsDir = import_node_path5.default.join(renderTemplateRoot, "searcheggs");
+  const renderTemplateRoot = import_node_fs7.default.existsSync(import_node_path6.default.join(resPath, "lib", "render-templates")) ? import_node_path6.default.join(resPath, "lib", "render-templates") : import_node_path6.default.join(resPath, "src", "render-templates");
+  const searcheggsDir = import_node_path6.default.join(renderTemplateRoot, "searcheggs");
   const eggService = new EggService(searcheggsDir);
-  const deps = { ctx, config, client, userMgr, merchantSubMgr, homeSubMgr, eggService, renderer };
+  const wikiService = new WikiService(ctx, client);
+  const atlasService = new AtlasService(dataDir, { zipUrls: config.atlasZipUrls, gitUrl: config.atlasGitUrl });
+  const deps = { ctx, config, client, userMgr, merchantSubMgr, homeSubMgr, announcementSubMgr, eggService, renderer, wikiService, atlasService };
   ctx.on("ready", () => {
     migrateRoleTokensToUserId(ctx).catch((err) => {
-      logger12.warn(`role token migration failed: ${err}`);
+      logger15.warn(`role token migration failed: ${err}`);
     });
     migrateLegacyFrameworkTokens(ctx, userMgr).catch((err) => {
-      logger12.warn(`legacy framework token migration failed: ${err}`);
+      logger15.warn(`legacy framework token migration failed: ${err}`);
     });
   });
   ctx.command("洛克", "洛克王国帮助菜单").action(async ({ session }) => {