koishi-plugin-fimtale-api 1.0.7 → 1.0.9

package/lib/index.d.ts

@@ -23,6 +23,7 @@ export interface Config {
     deviceWidth: number;
     deviceHeight: number;
     fontSize: number;
+    debug: boolean;
 }
 export declare const Config: Schema<Config>;
 export declare function apply(ctx: Context, config: Config): void;

package/lib/index.js

@@ -49,9 +49,16 @@ var Config = import_koishi.Schema.object({
   autoParseLink: import_koishi.Schema.boolean().default(true).description("自动解析链接为预览卡片"),
   deviceWidth: import_koishi.Schema.number().default(390).description("阅读器渲染宽度(px)"),
   deviceHeight: import_koishi.Schema.number().default(844).description("阅读器渲染高度(px)"),
-  fontSize: import_koishi.Schema.number().default(20).description("正文字号(px)")
+  fontSize: import_koishi.Schema.number().default(20).description("正文字号(px)"),
+  debug: import_koishi.Schema.boolean().default(false).description("开启详细调试日志")
 });
 function apply(ctx, config) {
+  const logger = ctx.logger("fimtale");
+  const debugLog = /* @__PURE__ */ __name((msg, ...args) => {
+    if (config.debug) {
+      logger.info(`[DEBUG] ${msg}`, ...args);
+    }
+  }, "debugLog");
   ctx.model.extend("fimtale_subs", {
     id: "unsigned",
     cid: "string",
@@ -109,48 +116,67 @@ function apply(ctx, config) {
   const fontStack = '"Noto Sans SC", "Microsoft YaHei", "PingFang SC", sans-serif';
   const fontSerif = '"Noto Serif SC", "Source Han Serif SC", "SimSun", serif';
   const injectCookies = /* @__PURE__ */ __name(async (page) => {
-    if (!config.cookies) return;
+    if (!config.cookies) {
+      debugLog("No cookies configured, skipping injection.");
+      return;
+    }
     const cookies = config.cookies.split(";").map((pair) => {
       const parts = pair.trim().split("=");
       if (parts.length < 2) return null;
       return { name: parts[0].trim(), value: parts.slice(1).join("=").trim(), domain: "fimtale.com", path: "/" };
     }).filter((c) => c !== null);
-    if (cookies.length) await page.setCookie(...cookies);
+    if (cookies.length) {
+      debugLog(`Injecting ${cookies.length} cookies into Puppeteer page.`);
+      await page.setCookie(...cookies);
+    }
   }, "injectCookies");
   const fetchThread = /* @__PURE__ */ __name(async (threadId) => {
+    const startTime = Date.now();
     try {
       const url = `${config.apiUrl}/t/${threadId}`;
+      debugLog(`Fetching thread info: ${url}`);
       const params = { APIKey: config.apiKey, APIPass: config.apiPass };
       const res = await ctx.http.get(url, { params });
-      if (res.Status !== 1 || !res.TopicInfo) return { valid: false, msg: res.ErrorMessage || "API Error" };
+      debugLog(`Fetch thread ${threadId} completed in ${Date.now() - startTime}ms. Status: ${res.Status}`);
+      if (res.Status !== 1 || !res.TopicInfo) {
+        debugLog(`Fetch error for ${threadId}: ${res.ErrorMessage}`);
+        return { valid: false, msg: res.ErrorMessage || "API Error" };
+      }
       return { valid: true, data: res.TopicInfo, parent: res.ParentInfo, menu: res.Menu || [] };
     } catch (e) {
+      logger.error(`Failed to fetch thread ${threadId}:`, e);
       return { valid: false, msg: "Request Failed" };
     }
   }, "fetchThread");
   const fetchRandomId = /* @__PURE__ */ __name(async () => {
     try {
+      debugLog("Fetching random thread ID...");
       const headers = config.cookies ? { Cookie: config.cookies } : {};
       const html = await ctx.http.get("https://fimtale.com/rand", { responseType: "text", headers });
       let match = html.match(/FimTale\.topic\.init\((\d+)/) || html.match(/data-clipboard-text=".*?\/t\/(\d+)"/);
-      return match ? match[1] : null;
+      const result = match ? match[1] : null;
+      debugLog(`Random ID result: ${result}`);
+      return result;
     } catch (e) {
+      logger.error("Failed to fetch random ID:", e);
       return null;
     }
   }, "fetchRandomId");
   const searchThreads = /* @__PURE__ */ __name(async (keyword) => {
     let page;
+    debugLog(`Starting search for keyword: "${keyword}"`);
     try {
       page = await ctx.puppeteer.page();
       await page.setUserAgent("Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/114.0.0.0 Safari/537.36");
       await injectCookies(page);
       const searchUrl = `https://fimtale.com/topics?q=${encodeURIComponent(keyword)}`;
+      debugLog(`Navigating to: ${searchUrl}`);
       await page.goto(searchUrl, { waitUntil: "networkidle2", timeout: 25e3 });
       try {
         await page.waitForSelector(".card", { timeout: 5e3 });
       } catch {
       }
-      return await page.evaluate(() => {
+      const results = await page.evaluate(() => {
         const items = [];
         document.querySelectorAll(".card.topic-card").forEach((card) => {
           if (items.length >= 6) return;
@@ -184,24 +210,48 @@ function apply(ctx, config) {
         });
         return items;
       });
+      debugLog(`Search found ${results.length} items.`);
+      return results;
     } catch (e) {
+      logger.error("Search error:", e);
       return [];
     } finally {
-      if (page) await page.close();
+      if (page) {
+        await page.close();
+        debugLog("Search page closed.");
+      }
     }
   }, "searchThreads");
   const renderCard = /* @__PURE__ */ __name(async (info, parent) => {
+    debugLog(`Rendering Card for ID: ${info.ID}`);
     const isChapter = info.IsChapter || !!parent && parent.ID !== info.ID;
     const displayTitle = isChapter && parent ? parent.Title : info.Title;
     let displayCover = info.Background || extractImage(info.Content);
     if (!displayCover && parent) {
-      displayCover = parent.Background || extractImage(parent.Content);
+      displayCover = parent.Background;
+      if (!displayCover) {
+        if (parent.Content) {
+          displayCover = extractImage(parent.Content);
+        } else {
+          try {
+            debugLog(`Missing parent content/cover for chapter ${info.ID}, fetching parent ${parent.ID}...`);
+            const parentRes = await fetchThread(parent.ID.toString());
+            if (parentRes.valid && parentRes.data) {
+              displayCover = parentRes.data.Background || extractImage(parentRes.data.Content);
+            }
+          } catch (e) {
+            debugLog("Fetch parent for cover failed (non-critical).");
+          }
+        }
+      }
     }
     const displayTagsObj = isChapter && parent ? parent.Tags : info.Tags;
     const subTitle = isChapter ? info.Title : null;
     const bgStyle = displayCover ? `background-image: url('${displayCover}');` : `background: ${generateGradient(displayTitle)};`;
     let summary = stripHtml(info.Content);
-    if (summary.length < 10 && parent && isChapter) summary = stripHtml(parent.Content);
+    if (summary.length < 10 && parent && isChapter) {
+      summary = stripHtml(parent.Content);
+    }
     if (summary.length > 150) summary = summary.substring(0, 150) + "...";
     if (!summary) summary = "暂无简介";
     const tagsArr = [];
@@ -213,8 +263,6 @@ function apply(ctx, config) {
         body { margin: 0; padding: 0; font-family: ${fontStack}; background: transparent; }
         .card { width: 620px; min-height: 420px; background: #fff; border-radius: 16px; box-shadow: 0 10px 30px rgba(0,0,0,0.15); display: flex; overflow: hidden; }
         .cover { width: 220px; min-height: 100%; ${bgStyle} background-size: cover; background-position: center; position: relative; flex-shrink: 0; }
-        
-        /* ID Badge 分体式：使用 flex 强制垂直居中，消除字体基线差异 */
         .id-badge-container {
             position: absolute; top: 15px; left: 15px;
             display: flex;
@@ -222,7 +270,7 @@ function apply(ctx, config) {
             border-radius: 6px;
             overflow: hidden;
             border: 1px solid rgba(255,255,255,0.3);
-            height: 28px; /* 强制高度 */
+            height: 28px;
         }
         .id-label {
             background: #EE6E73;
@@ -234,7 +282,7 @@ function apply(ctx, config) {
             text-transform: uppercase;
             display: flex; align-items: center; justify-content: center;
             height: 100%;
-            line-height: 1; margin: 0; /* 修复对齐 */
+            line-height: 1; margin: 0;
         }
         .id-val {
             background: #fff;
@@ -245,23 +293,17 @@ function apply(ctx, config) {
             font-weight: 900;
             display: flex; align-items: center; justify-content: center;
             height: 100%;
-            line-height: 1; margin: 0; /* 修复对齐 */
+            line-height: 1; margin: 0;
         }
-
         .info { flex: 1; padding: 26px; display: flex; flex-direction: column; overflow: hidden; position: relative; }
-        
         .header-group { flex-shrink: 0; margin-bottom: 16px; border-bottom: 2px solid #f5f5f5; padding-bottom: 12px; }
         .title { font-size: 24px; font-weight: 700; color: #333; line-height: 1.4; display: -webkit-box; -webkit-line-clamp: 2; -webkit-box-orient: vertical; overflow: hidden; margin-bottom: 6px; }
         .subtitle { font-size: 16px; color: #78909C; font-weight: 500; white-space: nowrap; overflow: hidden; text-overflow: ellipsis; padding-left: 12px; border-left: 4px solid #EE6E73; margin-top: 6px; }
-        
         .author { font-size: 14px; color: #78909C; margin-top: 12px; font-weight: 400; display:flex; align-items:center; }
-        
         .tags { display: flex; flex-wrap: wrap; gap: 6px; margin-bottom: 14px; flex-shrink: 0; }
         .tag { background: #eff2f5; color: #5c6b7f; padding: 3px 9px; border-radius: 4px; font-size: 11px; font-weight: 500; }
-        
         .summary-box { flex: 1; position: relative; overflow: hidden; min-height: 0; margin-bottom: 16px; }
         .summary { font-size: 14px; color: #546e7a; line-height: 1.7; display: -webkit-box; -webkit-line-clamp: 6; -webkit-box-orient: vertical; overflow: hidden; text-align: justify; }
-        
         .footer { border-top: 1px solid #eee; padding-top: 14px; display: flex; justify-content: space-between; font-size: 13px; color: #78909C; margin-top: auto; flex-shrink: 0; }
         .stat b { color: #455a64; font-weight: bold; margin-right: 3px;}
       </style></head><body>
@@ -280,18 +322,24 @@ function apply(ctx, config) {
             <span class="stat"><b style="color:#009688">热度</b>${info.Views || 0}</span><span class="stat"><b style="color:#7e57c2">评论</b>${info.Comments || 0}</span>
             <span class="stat"><b style="color:#4caf50">赞</b>${likes}</span><span class="stat"><b style="color:#8d6e63">字数</b>${info.WordCount || 0}</span>
           </div></div></div></body></html>`;
+    debugLog(`Card HTML prepared (approx ${html.length} chars). Launching Puppeteer...`);
     const page = await ctx.puppeteer.page();
     try {
       await injectCookies(page);
       await page.setContent(html);
       await page.setViewport({ width: 660, height: 480, deviceScaleFactor: 3 });
       const img = await page.$(".card").then((e) => e.screenshot({ type: "jpeg", quality: 100 }));
+      debugLog("Card screenshot captured successfully.");
       return img;
+    } catch (e) {
+      logger.error("Error rendering card:", e);
+      throw e;
     } finally {
       await page.close();
     }
   }, "renderCard");
   const renderSearchResults = /* @__PURE__ */ __name(async (keyword, results) => {
+    debugLog(`Rendering search results: ${results.length} items`);
     const html = `<!DOCTYPE html><html><head><style>
         body { margin: 0; padding: 0; font-family: ${fontStack}; width: 500px; background: transparent; }
         .container { background: #fff; border-radius: 12px; overflow: hidden; box-shadow: 0 4px 20px rgba(0,0,0,0.15); margin: 10px; }
@@ -304,8 +352,6 @@ function apply(ctx, config) {
         .content { flex: 1; display: flex; flex-direction: column; justify-content: space-between; height: 100%; min-width: 0; }
         .top-row { display: flex; justify-content: space-between; align-items: flex-start; }
         .title { font-size: 16px; font-weight: bold; color: #222; line-height: 1.3; display: -webkit-box; -webkit-line-clamp: 2; -webkit-box-orient: vertical; overflow: hidden; flex:1; margin-right: 8px;}
-        
-        /* ID Badge Search: 迷你分体式，保持与大图风格一致但更紧凑 */
         .id-badge { 
             display: flex;
             border-radius: 4px;
@@ -323,7 +369,7 @@ function apply(ctx, config) {
             font-weight: bold;
             display: flex; align-items: center; justify-content: center;
             height: 100%;
-            line-height: 1; margin: 0; /* 修复对齐 */
+            line-height: 1; margin: 0;
         }
         .id-val {
             background: #fff;
@@ -334,9 +380,8 @@ function apply(ctx, config) {
             font-weight: bold;
             display: flex; align-items: center; justify-content: center;
             height: 100%;
-            line-height: 1; margin: 0; /* 修复对齐 */
+            line-height: 1; margin: 0;
         }
-        
         .author { font-size: 12px; color: #78909C; }
         .tags { display: flex; gap: 4px; flex-wrap: wrap; height: 18px; overflow: hidden; margin-top: 4px; }
         .tag { background: #f3f3f3; color: #666; padding: 0 5px; border-radius: 3px; font-size: 10px; white-space: nowrap; line-height: 1.6;}
@@ -363,12 +408,14 @@ function apply(ctx, config) {
       await page.setContent(html);
       await page.setViewport({ width: 550, height: 800, deviceScaleFactor: 3 });
       const img = await page.$(".container").then((e) => e.screenshot({ type: "jpeg", quality: 100 }));
+      debugLog("Search results screenshot taken.");
       return img;
     } finally {
       await page.close();
     }
   }, "renderSearchResults");
   const renderReadPages = /* @__PURE__ */ __name(async (info) => {
+    debugLog(`Rendering read pages for ${info.ID} (${info.Title})`);
     const content = cleanContent(info.Content);
     const headerHeight = 40;
     const footerHeight = 30;
@@ -384,10 +431,8 @@ function apply(ctx, config) {
     const marginTop = Math.floor((maxContentHeight - optimalContentHeight) / 2) + headerHeight;
     const html = `<!DOCTYPE html><html><head><style>
         body { margin: 0; padding: 0; width: ${config.deviceWidth}px; height: ${config.deviceHeight}px; background-color: #f6f4ec; color: #2c2c2c; font-family: ${fontSerif}; overflow: hidden; position: relative;}
-        /* Header Padding reduced to 12px to align closer to left edge */
         .fixed-header { position: absolute; top: 0; left: 0; width: 100%; height: ${headerHeight}px; border-bottom: 2px solid #EE6E73; box-sizing: border-box; padding: 0 12px; display: flex; align-items: center; justify-content: space-between; font-size: 12px; color: #EE6E73; background: #f6f4ec; z-index: 5; font-weight: bold; }
         .fixed-footer { position: absolute; bottom: 0; left: 0; width: 100%; height: ${footerHeight}px; display: flex; align-items: center; justify-content: center; font-size: 12px; color: #78909C; background: #f6f4ec; z-index: 5; }
-        /* 修复1: 强制重置 header 和 footer 的缩进，防止 p, div 全局规则影响 */
         .fixed-header, .fixed-footer, .header-title, .header-author { text-indent: 0 !important; }
 
         #viewport { position: absolute; top: ${marginTop}px; left: ${paddingX}px; width: ${contentWidth}px; height: ${optimalContentHeight}px; overflow: hidden; }
@@ -397,11 +442,8 @@ function apply(ctx, config) {
         .align-center { text-align: center !important; text-align-last: center !important; text-indent: 0 !important; margin: 0.8em 0; font-weight: bold; color: #5d4037; }
         .align-right { text-align: right !important; text-indent: 0 !important; margin-top: 0.5em; color: #666; font-style: italic; }
         .no-indent { text-indent: 0 !important; }
-        
-        /* Header Title absolute left */
         .header-title { flex: 1; white-space: nowrap; overflow: hidden; text-overflow: ellipsis; text-align: left; min-width: 0; margin-right: 10px; }
         .header-author { flex-shrink: 0; color: #78909C; max-width: 35%; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; text-align: right; }
-
         blockquote { margin: 1em 0.5em; padding-left: 1em; border-left: 4px solid #EE6E73; color: #666; }
         blockquote p { text-indent: 0; margin: 0.3em 0; }
         ul, ol { margin: 0.5em 0; padding-left: 1.5em; }
@@ -436,6 +478,7 @@ function apply(ctx, config) {
       await injectCookies(page);
       await page.setContent(html);
       await page.setViewport({ width: config.deviceWidth, height: config.deviceHeight, deviceScaleFactor: 3 });
+      debugLog("Waiting for fonts and images...");
       await page.evaluate(async () => {
         await document.fonts.ready;
         await new Promise((resolve) => {
@@ -460,6 +503,7 @@ function apply(ctx, config) {
       const step = contentWidth + columnGap;
       const totalPages = Math.floor((scrollWidth + columnGap - 10) / step) + 1;
       const finalPages = Math.max(1, totalPages);
+      debugLog(`Content width calculated: ${scrollWidth}px. Splitting into ${finalPages} pages.`);
       const imgs = [];
       for (let i = 0; i < finalPages; i++) {
         await page.evaluate((idx, stepPx, curr, total) => {
@@ -469,18 +513,24 @@ function apply(ctx, config) {
         }, i, step, i + 1, finalPages);
         imgs.push(await page.screenshot({ type: "jpeg", quality: 100 }));
       }
+      debugLog("All pages captured.");
       return imgs;
+    } catch (e) {
+      logger.error("Error rendering read pages:", e);
+      throw e;
     } finally {
       await page.close();
     }
   }, "renderReadPages");
   ctx.command("ft.info <threadId:string>", "预览作品").action(async ({ session }, threadId) => {
+    debugLog(`CMD ft.info triggered by ${session.userId} for ID: ${threadId}`);
     if (!threadId) return "请输入ID";
     const res = await fetchThread(threadId);
     if (!res.valid) return `[错误] ${res.msg}`;
     return session.send(import_koishi.h.image(await renderCard(res.data, res.parent), "image/jpeg"));
   });
   ctx.command("ft.read <threadId:string>", "阅读章节").action(async ({ session }, threadId) => {
+    debugLog(`CMD ft.read triggered by ${session.userId} for ID: ${threadId}`);
     if (!threadId) return "请输入ID";
     const res = await fetchThread(threadId);
     if (!res.valid) return `[错误] 读取失败: ${res.msg}`;
@@ -501,11 +551,12 @@ function apply(ctx, config) {
       if (navs.length) nodes.push((0, import_koishi.h)("message", import_koishi.h.text("章节导航:\n" + navs.join("\n"))));
       return session.send((0, import_koishi.h)("message", { forward: true }, nodes));
     } catch (e) {
-      ctx.logger("fimtale").error(e);
+      logger.error("ft.read rendering failed:", e);
       return "[错误] 渲染失败";
     }
   });
   ctx.command("ft.random", "随机作品").action(async ({ session }) => {
+    debugLog(`CMD ft.random triggered by ${session.userId}`);
     const id = await fetchRandomId();
     if (!id) return "[错误] 获取失败";
     const res = await fetchThread(id);
@@ -514,6 +565,7 @@ function apply(ctx, config) {
     return `Tip: 发送 /ft.read ${res.data.ID} 阅读全文`;
   });
   ctx.command("ft.search <keyword:text>", "搜索作品").action(async ({ session }, keyword) => {
+    debugLog(`CMD ft.search triggered by ${session.userId} for "${keyword}"`);
     if (!keyword) return "请输入关键词";
     await session.send("[加载中] 搜索中...");
     const results = await searchThreads(keyword);
@@ -523,6 +575,7 @@ function apply(ctx, config) {
     return `Tip: 发送 /ft.read [ID] 阅读 (例: /ft.read ${exampleId})`;
   });
   ctx.command("ft.sub <threadId:string>", "订阅").action(async ({ session }, threadId) => {
+    debugLog(`CMD ft.sub triggered by ${session.userId} for ID: ${threadId}`);
     if (!/^\d+$/.test(threadId)) return "ID错误";
     const exist = await ctx.database.get("fimtale_subs", { cid: session.cid, threadId });
     if (exist.length) return "已订阅";
@@ -533,6 +586,7 @@ function apply(ctx, config) {
     return session.send(import_koishi.h.image(await renderCard(res.data, res.parent), "image/jpeg"));
   });
   ctx.command("ft.unsub <threadId:string>", "退订").action(async ({ session }, threadId) => {
+    debugLog(`CMD ft.unsub triggered by ${session.userId} for ID: ${threadId}`);
     const res = await ctx.database.remove("fimtale_subs", { cid: session.cid, threadId });
     return res.matched ? "[成功] 已退订" : "未找到订阅";
   });
@@ -540,6 +594,7 @@ function apply(ctx, config) {
     if (!config.autoParseLink) return next();
     const matches = [...session.content.matchAll(/fimtale\.(?:com|net)\/t\/(\d+)/g)];
     if (matches.length === 0) return next();
+    debugLog(`Middleware matched link in channel ${session.channelId}`);
     const uniqueIds = [...new Set(matches.map((m) => m[1]))];
     if (session.userId === session.selfId) return next();
     const messageNodes = [];
@@ -551,6 +606,7 @@ function apply(ctx, config) {
           messageNodes.push((0, import_koishi.h)("message", import_koishi.h.image(img, "image/jpeg")));
         }
       } catch (e) {
+        logger.error(`Middleware failed to process link ${id}:`, e);
       }
     }
     if (messageNodes.length === 0) return next();
@@ -563,12 +619,14 @@ function apply(ctx, config) {
   ctx.setInterval(async () => {
     const subs = await ctx.database.get("fimtale_subs", {});
     if (!subs.length) return;
+    debugLog(`Polling check started for ${subs.length} subscriptions.`);
     const tids = [...new Set(subs.map((s) => s.threadId))];
     for (const tid of tids) {
       const res = await fetchThread(tid);
       if (!res.valid) continue;
       const targets = subs.filter((s) => s.threadId === tid && s.lastCount < res.data.Comments);
       if (targets.length) {
+        debugLog(`Update found for thread ${tid} (Old: ${targets[0].lastCount}, New: ${res.data.Comments})`);
         const msg = `[更新] ${res.data.Title} 更新了！
 回复: ${res.data.Comments}
 https://fimtale.com/t/${tid}`;
@@ -576,7 +634,8 @@ https://fimtale.com/t/${tid}`;
           try {
             await ctx.broadcast([sub.cid], import_koishi.h.parse(msg));
             await ctx.database.set("fimtale_subs", { id: sub.id }, { lastCount: res.data.Comments });
-          } catch {
+          } catch (e) {
+            logger.error(`Broadcast failed for sub ${sub.id}:`, e);
           }
         }
       }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "koishi-plugin-fimtale-api",
   "description": "Koishi插件，从fimtale搜索/订阅/随机获取小说/解析链接等",
-  "version": "1.0.7",
+  "version": "1.0.9",
   "main": "lib/index.js",
   "typings": "lib/index.d.ts",
   "files": [