@trim21/personal-pi-extensions 0.1.611 → 0.1.613

package/src/talk/index.ts

@@ -86,7 +86,9 @@ function readTalkSettings(): { dbPath?: string; deliver?: "steer" | "queue" } {
     const raw = fs.readFileSync(path.join(getAgentDir(), "settings.json"), "utf8");
     const parsed = JSON.parse(raw) as { talk?: { db_path?: unknown; deliver?: unknown } };
     const talk = parsed.talk;
-    if (!talk) return {};
+    if (!talk) {
+      return {};
+    }
     const dbPath = typeof talk.db_path === "string" ? talk.db_path : undefined;
     const deliver = talk.deliver === "steer" || talk.deliver === "queue" ? talk.deliver : undefined;
     return { dbPath, deliver };
@@ -151,14 +153,18 @@ export default function talk(pi: ExtensionAPI) {
   });
 
   function requireInit(): string | undefined {
-    if (!core.selfAddr) return "Talk is not initialized (no session_start yet).";
+    if (!core.selfAddr) {
+      return "Talk is not initialized (no session_start yet).";
+    }
     return undefined;
   }
 
   /** Refresh the talk footer/status-bar text: "alias@group", or "@group" with no explicit alias. */
   function refreshGroupStatus(ui: ExtensionUIContext): void {
     void (async () => {
-      if (!self) return;
+      if (!self) {
+        return;
+      }
       try {
         const text = await core.groupStatus();
         ui.setStatus("talk", text && ui.theme.fg("accent", text));
@@ -205,7 +211,9 @@ export default function talk(pi: ExtensionAPI) {
   pi.on("session_info_changed", () => {
     // A name set explicitly via `--name` wins over pi's session title;
     // otherwise follow pi's session name.
-    if (self) core.setAgentName(explicitName ?? pi.getSessionName() ?? self.name);
+    if (self) {
+      core.setAgentName(explicitName ?? pi.getSessionName() ?? self.name);
+    }
   });
   pi.on("session_shutdown", () => {
     void core.stop();
@@ -223,7 +231,9 @@ export default function talk(pi: ExtensionAPI) {
     }),
     async execute(_toolCallId, params) {
       const initError = requireInit();
-      if (initError) return toolResult(initError);
+      if (initError) {
+        return toolResult(initError);
+      }
       return toolResult(params.cwd ? await core.listCwd(params.cwd) : await core.list());
     },
   });
@@ -243,7 +253,9 @@ export default function talk(pi: ExtensionAPI) {
     }),
     async execute(_toolCallId, params, signal) {
       const initError = requireInit();
-      if (initError) return toolResult(initError);
+      if (initError) {
+        return toolResult(initError);
+      }
       return toolResult(
         await core.ask(
           params.to,
@@ -267,7 +279,9 @@ export default function talk(pi: ExtensionAPI) {
     }),
     async execute(_toolCallId, params) {
       const initError = requireInit();
-      if (initError) return toolResult(initError);
+      if (initError) {
+        return toolResult(initError);
+      }
       return toolResult(await core.send(params.to, params.message));
     },
   });
@@ -417,7 +431,9 @@ export default function talk(pi: ExtensionAPI) {
         ctx,
         async (parsed) => {
           const agentName = parsed.flags.name?.trim() || undefined;
-          if (agentName !== undefined) explicitName = agentName;
+          if (agentName !== undefined) {
+            explicitName = agentName;
+          }
           return core.groupJoin(parsed.args[0], agentName);
         },
         { sendToContext: true },
@@ -433,7 +449,9 @@ export default function talk(pi: ExtensionAPI) {
         ctx,
         async (parsed) => {
           const agentName = parsed.flags.name?.trim() || undefined;
-          if (agentName !== undefined) explicitName = agentName;
+          if (agentName !== undefined) {
+            explicitName = agentName;
+          }
           return core.groupJoinLast(agentName);
         },
         { sendToContext: true },
@@ -496,7 +514,9 @@ export default function talk(pi: ExtensionAPI) {
   for (const type of [LIST_TYPE, NOTIFY_TYPE]) {
     pi.registerEntryRenderer<string>(type, (entry, _options, theme) => {
       const text = typeof entry.data === "string" ? entry.data : "";
-      if (!text) return;
+      if (!text) {
+        return;
+      }
       return {
         render: (width: number) =>
           truncateToVisualLines(text, Infinity, width, 1).visualLines.map((line) =>

package/src/talk/mailbox.ts

@@ -49,11 +49,19 @@ export type LetterKind = Letter["kind"];
  * unchanged; anything else returns null.
  */
 export function normalizeLetter(value: unknown): Letter | null {
-  if (Value.Check(LetterSchema, value)) return value;
-  if (!isRecord(value)) return null;
+  if (Value.Check(LetterSchema, value)) {
+    return value;
+  }
+  if (!isRecord(value)) {
+    return null;
+  }
   const from = value.from;
-  if (!isRecord(from)) return null;
-  if (typeof from.sessionId !== "string") return null;
+  if (!isRecord(from)) {
+    return null;
+  }
+  if (typeof from.sessionId !== "string") {
+    return null;
+  }
   const migrated = {
     ...value,
     from: { ...from, agentId: from.sessionId },
@@ -98,7 +106,9 @@ export function newMessageId(): string {
 }
 
 function assertMessageId(id: string): void {
-  if (!MESSAGE_ID_PATTERN.test(id)) throw new TypeError(`Invalid talk message id: ${id}`);
+  if (!MESSAGE_ID_PATTERN.test(id)) {
+    throw new TypeError(`Invalid talk message id: ${id}`);
+  }
 }
 
 /** The storage key for a letter: `<ts>-<id>.json`, sorted oldest-first. */
@@ -112,7 +122,9 @@ export function letterFileName(letter: Letter): string {
 
 /** Structural validation plus filename safety (id/timestamp shape). */
 export function isValidLetter(value: unknown): value is Letter {
-  if (!Value.Check(LetterSchema, value)) return false;
+  if (!Value.Check(LetterSchema, value)) {
+    return false;
+  }
   try {
     letterFileName(value);
     return true;
@@ -153,7 +165,9 @@ export async function listInbox(storage: TalkStorage, addr: string): Promise<Inb
   for (const fileName of await storage.listKeys(inboxNs(addr))) {
     const raw = await storage.readJson(inboxNs(addr), fileName);
     const letter = normalizeLetter(raw);
-    if (letter && isValidLetter(letter)) out.push({ fileName, letter });
+    if (letter && isValidLetter(letter)) {
+      out.push({ fileName, letter });
+    }
     // corrupt letters are skipped; the caller may remove them separately
   }
   return out; // keys are already sorted by listKeys
@@ -194,7 +208,9 @@ export async function awaitReceipt(
   while (Date.now() < deadline) {
     const inbox = await listInbox(storage, toAddr);
     const stillThere = inbox.some((i) => i.letter.id === letter.id);
-    if (!stillThere) return "delivered";
+    if (!stillThere) {
+      return "delivered";
+    }
     await sleep(100);
   }
   const inbox = await listInbox(storage, toAddr);
@@ -236,7 +252,9 @@ export async function clearAsk(storage: TalkStorage, addr: string, askId: string
 export async function outgoingAskIds(storage: TalkStorage, addr: string): Promise<string[]> {
   const out: string[] = [];
   for (const key of await storage.listKeys(asksNs(addr))) {
-    if (!key.startsWith("out-") || !key.endsWith(".json")) continue;
+    if (!key.startsWith("out-") || !key.endsWith(".json")) {
+      continue;
+    }
     out.push(key.slice("out-".length, -".json".length));
   }
   return out;
@@ -271,7 +289,9 @@ export async function readAudit(storage: TalkStorage, limit = 50): Promise<Audit
   for (const line of await storage.readLog(AUDIT_LOG)) {
     try {
       const parsed: unknown = JSON.parse(line);
-      if (Value.Check(AuditRecordSchema, parsed)) out.push(parsed);
+      if (Value.Check(AuditRecordSchema, parsed)) {
+        out.push(parsed);
+      }
     } catch {
       // skip corrupt line — append-only, never fatal
     }

package/src/talk/policy.ts

@@ -53,7 +53,9 @@ export class OutboundPolicy {
       };
     }
     const windowStart = now - RATE_LIMIT_WINDOW_MS;
-    while (this.sentAt.length > 0 && this.sentAt[0] < windowStart) this.sentAt.shift();
+    while (this.sentAt.length > 0 && this.sentAt[0] < windowStart) {
+      this.sentAt.shift();
+    }
     if (this.sentAt.length >= RATE_LIMIT_MAX) {
       return {
         ok: false,
@@ -68,10 +70,13 @@ export class OutboundPolicy {
     this.sentAt.push(this.now());
     this.recentBodies.set(`${body}\u0000${target ?? ""}`, this.now());
     // bound the dedupe map
-    if (this.recentBodies.size > 200) {
-      const cutoff = this.now() - DEDUPE_WINDOW_MS;
-      for (const [key, ts] of this.recentBodies) {
-        if (ts < cutoff) this.recentBodies.delete(key);
+    if (this.recentBodies.size <= 200) {
+      return;
+    }
+    const cutoff = this.now() - DEDUPE_WINDOW_MS;
+    for (const [key, ts] of this.recentBodies) {
+      if (ts < cutoff) {
+        this.recentBodies.delete(key);
       }
     }
   }

package/src/talk/registry.ts

@@ -81,7 +81,9 @@ export function deriveAddr(cwd: string, agentId: string): string {
 
 /** Validate a talk address before it becomes a storage key. */
 export function assertAddress(addr: string): void {
-  if (!ADDRESS_PATTERN.test(addr)) throw new TypeError(`Invalid talk address: ${addr}`);
+  if (!ADDRESS_PATTERN.test(addr)) {
+    throw new TypeError(`Invalid talk address: ${addr}`);
+  }
 }
 
 // ── Storage namespaces ───────────────────────────────────────────────────
@@ -111,7 +113,9 @@ export async function writeRecord(storage: TalkStorage, record: AgentRecord): Pr
 
 export async function readRecord(storage: TalkStorage, addr: string): Promise<AgentRecord | null> {
   const raw = await storage.readJson(RECORDS_NS, recordKey(addr));
-  if (Value.Check(AgentRecordSchema, raw)) return raw;
+  if (Value.Check(AgentRecordSchema, raw)) {
+    return raw;
+  }
   // Migrate legacy records in place of the `sessionId` → `agentId` rename.
   if (Value.Check(LegacyAgentRecordSchema, raw)) {
     // Value.Check 是类型守卫，raw 已收窄成 legacy 记录的形状，不需要再断言。
@@ -126,9 +130,13 @@ export async function listRecords(storage: TalkStorage): Promise<AgentRecord[]>
   const out: AgentRecord[] = [];
   for (const key of await storage.listKeys(RECORDS_NS)) {
     const addr = key.slice(0, -".json".length);
-    if (!ADDRESS_PATTERN.test(addr)) continue;
+    if (!ADDRESS_PATTERN.test(addr)) {
+      continue;
+    }
     const record = await readRecord(storage, addr);
-    if (record) out.push(record);
+    if (record) {
+      out.push(record);
+    }
   }
   return out.toSorted((a, b) => a.startedAt - b.startedAt);
 }
@@ -160,21 +168,30 @@ export function readStartTime(pid: number): number | undefined {
  * unreadable — we fall back to the bare pid check.
  */
 function pidAlive(pid: number, pidStart?: number): boolean {
-  if (!Number.isSafeInteger(pid) || pid <= 0) return false;
+  if (!Number.isSafeInteger(pid) || pid <= 0) {
+    return false;
+  }
   try {
     process.kill(pid, 0);
   } catch (error) {
     // EPERM means the process exists but isn't ours — still alive
     return (error as NodeJS.ErrnoException).code === "EPERM";
   }
-  if (pidStart === undefined) return true;
+  if (pidStart === undefined) {
+    return true;
+  }
   const start = readStartTime(pid);
-  return start === undefined ? true : start === pidStart;
+  // 读不到启动时间时保守认为「pid 还活着」，只有两边都读到且不同才判定被复用
+  return start === undefined || start === pidStart;
 }
 
 export function presenceOf(record: AgentRecord): Presence {
-  if (record.offline) return "offline";
-  if (!pidAlive(record.pid, record.pidStart)) return "offline";
+  if (record.offline) {
+    return "offline";
+  }
+  if (!pidAlive(record.pid, record.pidStart)) {
+    return "offline";
+  }
   return "live";
 }
 
@@ -195,12 +212,18 @@ export async function sweep(storage: TalkStorage, now: number = Date.now()): Pro
   for (const record of await listRecords(storage)) {
     // Without a heartbeat, lastSeenAt only tracks the last event, so an idle
     // live agent would look long-quiet — never reap a live process.
-    if (pidAlive(record.pid, record.pidStart)) continue;
+    if (pidAlive(record.pid, record.pidStart)) {
+      continue;
+    }
     const quietFor = now - record.lastSeenAt;
-    if (quietFor < SWEEP_OFFLINE_GRACE_MS) continue;
+    if (quietFor < SWEEP_OFFLINE_GRACE_MS) {
+      continue;
+    }
     const hasMail =
       (await storage.hasKeys(inboxNs(record.addr))) || (await storage.hasKeys(asksNs(record.addr)));
-    if (hasMail && quietFor < SWEEP_MAIL_KEEP_MS) continue;
+    if (hasMail && quietFor < SWEEP_MAIL_KEEP_MS) {
+      continue;
+    }
     await storage.removeNamespace(inboxNs(record.addr));
     await storage.removeNamespace(asksNs(record.addr));
     await storage.removeKey(RECORDS_NS, recordKey(record.addr));

package/src/talk/storage.ts

@@ -100,7 +100,9 @@ export class SqliteTalkStorage implements TalkStorage {
     const row = this.db
       .prepare("SELECT value FROM talk_kv WHERE namespace = ? AND key = ?")
       .get(namespace, key) as { value: string } | undefined;
-    if (row === undefined) return Promise.resolve(null);
+    if (row === undefined) {
+      return Promise.resolve(null);
+    }
     try {
       return Promise.resolve(JSON.parse(row.value) as unknown);
     } catch {

package/src/vision-agent.ts

@@ -120,7 +120,9 @@ export function resolveImagePaths(params: { path?: string | string[] }): string[
 }
 
 function toTrimmedList(value: string | string[] | undefined): string[] {
-  if (value === undefined) return [];
+  if (value === undefined) {
+    return [];
+  }
   const list = Array.isArray(value) ? value : [value];
   return list.map((s) => s.trim()).filter((s) => s.length > 0);
 }
@@ -143,9 +145,13 @@ export function loadVisionConfig(settingsPath = SETTINGS_PATH): VisionConfigSett
   } catch {
     return undefined;
   }
-  if (!Value.Check(visionSettingsSchema, parsed)) return undefined;
+  if (!Value.Check(visionSettingsSchema, parsed)) {
+    return undefined;
+  }
   const config = parsed.visionConfig;
-  if (config === undefined) return undefined;
+  if (config === undefined) {
+    return undefined;
+  }
   const provider = config.provider?.trim() || undefined;
   const defaultProvider = parsed.defaultProvider?.trim() || undefined;
   return {
@@ -210,9 +216,15 @@ export function buildPendantMarkdown(params: {
 
 /** 按文件头识别真实图片类型，识别不出返回 undefined */
 function sniffMime(buf: Buffer): string | undefined {
-  if (buf.length >= 8 && buf.readUInt32BE(0) === 0x89504e47) return "image/png";
-  if (buf.length >= 3 && buf[0] === 0xff && buf[1] === 0xd8 && buf[2] === 0xff) return "image/jpeg";
-  if (buf.length >= 6 && buf.toString("ascii", 0, 4) === "GIF8") return "image/gif";
+  if (buf.length >= 8 && buf.readUInt32BE(0) === 0x89504e47) {
+    return "image/png";
+  }
+  if (buf.length >= 3 && buf[0] === 0xff && buf[1] === 0xd8 && buf[2] === 0xff) {
+    return "image/jpeg";
+  }
+  if (buf.length >= 6 && buf.toString("ascii", 0, 4) === "GIF8") {
+    return "image/gif";
+  }
   if (
     buf.length >= 12 &&
     buf.toString("ascii", 0, 4) === "RIFF" &&
@@ -220,14 +232,18 @@ function sniffMime(buf: Buffer): string | undefined {
   ) {
     return "image/webp";
   }
-  if (buf.length >= 2 && buf[0] === 0x42 && buf[1] === 0x4d) return "image/bmp";
+  if (buf.length >= 2 && buf[0] === 0x42 && buf[1] === 0x4d) {
+    return "image/bmp";
+  }
   return undefined;
 }
 
 /** 读取图片文件 → base64 + mimeType + 展示名 */
 function loadImageBytes(path: string): { base64: string; mimeType: string; label: string } {
   const ext = extname(path).toLowerCase();
-  if (!IMAGE_EXTS.has(ext)) throw new Error(`不支持的文件格式: ${ext || "(无扩展名)"}`);
+  if (!IMAGE_EXTS.has(ext)) {
+    throw new Error(`不支持的文件格式: ${ext || "(无扩展名)"}`);
+  }
 
   let stat;
   try {
@@ -238,8 +254,12 @@ function loadImageBytes(path: string): { base64: string; mimeType: string; label
       { cause: error },
     );
   }
-  if (!stat.isFile()) throw new Error(`不是普通文件: ${path}`);
-  if (stat.size === 0) throw new Error(`文件为空: ${path}`);
+  if (!stat.isFile()) {
+    throw new Error(`不是普通文件: ${path}`);
+  }
+  if (stat.size === 0) {
+    throw new Error(`文件为空: ${path}`);
+  }
   if (stat.size > MAX_IMAGE_BYTES) {
     throw new Error(`图片过大 (${(stat.size / 1024 / 1024).toFixed(1)}MB)，上限 10MB`);
   }
@@ -293,7 +313,9 @@ export async function callVision(
     );
   } catch (error) {
     // 用户主动取消（signal abort）不是失败，转成 VisionAbortError 由调用方处理
-    if (error instanceof Error && error.name === "AbortError") throw new VisionAbortError();
+    if (error instanceof Error && error.name === "AbortError") {
+      throw new VisionAbortError();
+    }
     throw error;
   }
   const text = contentText(result.content).trim();
@@ -325,11 +347,14 @@ export default function visionAgent(pi: ExtensionAPI) {
     const hasTool = active.includes(TOOL_NAME);
     if (hasTool && isMultimodal(model)) {
       pi.setActiveTools(active.filter((t) => t !== TOOL_NAME));
-      if (notify) notify(`主模型 ${model?.id ?? "?"} 支持视觉 → 已隐藏 ${TOOL_NAME}，图片原生透传`);
+      if (notify) {
+        notify(`主模型 ${model?.id ?? "?"} 支持视觉 → 已隐藏 ${TOOL_NAME}，图片原生透传`);
+      }
     } else if (!hasTool && !isMultimodal(model)) {
       pi.setActiveTools([...active, TOOL_NAME]);
-      if (notify)
+      if (notify) {
         notify(`主模型 ${model?.id ?? "?"} 不支持视觉 → 已启用 ${TOOL_NAME}，由视觉模型代理识别`);
+      }
     }
   }
 
@@ -347,7 +372,9 @@ export default function visionAgent(pi: ExtensionAPI) {
   // baseUrl/apiKey 由 pi 的模型注册表在调用时解析（execute 里 find），
   // 配置好 settings.json / models.json 后重新加载（/reload）即可生效。
   const visionConfig = loadVisionConfig();
-  if (!visionConfig?.model) return;
+  if (!visionConfig?.model) {
+    return;
+  }
 
   pi.registerTool({
     name: TOOL_NAME,

package/src/web/config.ts

@@ -20,7 +20,9 @@ export function webSearchConfigPath(): string {
 /** ~/.pi/web-search.json 的 search1apiApiKey，或 SEARCH1API_KEY 环境变量。 */
 export async function loadSearch1ApiKey(path = webSearchConfigPath()): Promise<string | undefined> {
   const envKey = process.env.SEARCH1API_KEY;
-  if (envKey) return envKey;
+  if (envKey) {
+    return envKey;
+  }
   try {
     const raw = await readFile(path, "utf8");
     const parsed = Value.Parse(webSearchSchema, JSON.parse(raw));

package/src/web/fetch.ts

@@ -38,33 +38,65 @@ const MAX_MARKDOWN_BYTES = 100 * 1024;
 
 function isPrivateIpv4(ip: string): boolean {
   const parts = ip.split(".").map(Number);
-  if (parts.length !== 4 || parts.some((p) => Number.isNaN(p))) return false;
+  if (parts.length !== 4 || parts.some((p) => Number.isNaN(p))) {
+    return false;
+  }
   const [a, b, c] = parts;
-  if (a === 0) return true; // 0.0.0.0/8
-  if (a === 10) return true; // 10.0.0.0/8
-  if (a === 127) return true; // 127.0.0.0/8 loopback
-  if (a === 169 && b === 254) return true; // 169.254.0.0/16 link-local
-  if (a === 172 && b >= 16 && b <= 31) return true; // 172.16.0.0/12
-  if (a === 192 && b === 168) return true; // 192.168.0.0/16
-  if (a === 100 && b >= 64 && b <= 127) return true; // 100.64.0.0/10 CGNAT
-  if (a === 198 && (b === 18 || b === 19)) return true; // 198.18.0.0/15 benchmarking
-  if (a === 192 && b === 0 && c === 0) return true; // 192.0.0.0/24
+  if (a === 0) {
+    return true; // 0.0.0.0/8
+  }
+  if (a === 10) {
+    return true; // 10.0.0.0/8
+  }
+  if (a === 127) {
+    return true; // 127.0.0.0/8 loopback
+  }
+  if (a === 169 && b === 254) {
+    return true; // 169.254.0.0/16 link-local
+  }
+  if (a === 172 && b >= 16 && b <= 31) {
+    return true; // 172.16.0.0/12
+  }
+  if (a === 192 && b === 168) {
+    return true; // 192.168.0.0/16
+  }
+  if (a === 100 && b >= 64 && b <= 127) {
+    return true; // 100.64.0.0/10 CGNAT
+  }
+  if (a === 198 && (b === 18 || b === 19)) {
+    return true; // 198.18.0.0/15 benchmarking
+  }
+  if (a === 192 && b === 0 && c === 0) {
+    return true; // 192.0.0.0/24
+  }
   return a >= 224; // 224.0.0.0/3 multicast + reserved
 }
 
 function isPrivateIpv6(ip: string): boolean {
   const lower = ip.toLowerCase();
-  if (lower === "::" || lower === "::1") return true; // unspecified / loopback
-  if (lower.startsWith("fc") || lower.startsWith("fd")) return true; // fc00::/7 ULA
-  if (/^fe[89ab]/.test(lower)) return true; // fe80::/10 link-local
-  if (lower.startsWith("::ffff:")) return isPrivateIpv4(lower.slice(7));
+  if (lower === "::" || lower === "::1") {
+    return true; // unspecified / loopback
+  }
+  if (lower.startsWith("fc") || lower.startsWith("fd")) {
+    return true; // fc00::/7 ULA
+  }
+  if (/^fe[89ab]/.test(lower)) {
+    return true; // fe80::/10 link-local
+  }
+  if (lower.startsWith("::ffff:")) {
+    return isPrivateIpv4(lower.slice(7));
+  }
   return false;
 }
 
 export function isPrivateAddress(ip: string): boolean {
   const version = isIP(ip);
-  if (version === 4) return isPrivateIpv4(ip);
-  if (version === 6) return isPrivateIpv6(ip);
+  if (version === 4) {
+    return isPrivateIpv4(ip);
+  }
+  if (version === 6) {
+    return isPrivateIpv6(ip);
+  }
   return true; // 非 IP 一律拒绝
 }
 
@@ -181,7 +213,9 @@ export async function fetchPage(url: string, signal?: AbortSignal): Promise<Fetc
     const decoder = new TextDecoder();
     for (;;) {
       const chunk = (await reader.read()) as { done: boolean; value: Uint8Array };
-      if (chunk.done) break;
+      if (chunk.done) {
+        break;
+      }
       body += decoder.decode(chunk.value, { stream: true });
       if (Buffer.byteLength(body, "utf8") > MAX_BYTES) {
         throw new Error(`页面过大，上限 ${MAX_BYTES} bytes`);
@@ -222,7 +256,9 @@ export async function saveUrlToFile(
       const reader = response.body.getReader();
       for (;;) {
         const chunk = (await reader.read()) as { done: boolean; value: Uint8Array };
-        if (chunk.done) break;
+        if (chunk.done) {
+          break;
+        }
         bytes += chunk.value.byteLength;
         if (bytes > MAX_FILE_BYTES) {
           throw new Error(`文件过大，上限 ${MAX_FILE_BYTES} bytes`);
@@ -248,10 +284,18 @@ export async function saveUrlToFile(
 /** 按 mime 主体分类响应；html 走 readability，其余文本类原样返回 */
 function classifyContentType(contentType: string): "html" | "text" | null {
   const mime = contentType.split(";", 1)[0]?.trim().toLowerCase() ?? "";
-  if (mime === "text/html" || mime === "application/xhtml+xml") return "html";
-  if (mime.startsWith("text/")) return "text";
-  if (mime === "application/json" || mime.endsWith("+json")) return "text";
-  if (mime === "application/xml" || mime.endsWith("+xml")) return "text";
+  if (mime === "text/html" || mime === "application/xhtml+xml") {
+    return "html";
+  }
+  if (mime.startsWith("text/")) {
+    return "text";
+  }
+  if (mime === "application/json" || mime.endsWith("+json")) {
+    return "text";
+  }
+  if (mime === "application/xml" || mime.endsWith("+xml")) {
+    return "text";
+  }
   return null;
 }
 
@@ -272,7 +316,9 @@ interface ParsedDocument {
  */
 function unshadowReactStreaming(document: ParsedDocument): void {
   for (const el of document.querySelectorAll("[hidden]")) {
-    if (/^S:\d+$/.test(el.id ?? "")) el.removeAttribute("hidden");
+    if (/^S:\d+$/.test(el.id ?? "")) {
+      el.removeAttribute("hidden");
+    }
   }
 }
 
@@ -285,7 +331,9 @@ export function extractMarkdown(html: string, sourceUrl: string): FetchedPage {
   // linkedom document 的兼容方法，cast 桥接即可
   const article = new Readability(parsed.document).parse();
   let title = article?.title ?? document.title?.trim() ?? sourceUrl;
-  if (typeof title !== "string" || title.length === 0) title = sourceUrl;
+  if (typeof title !== "string" || title.length === 0) {
+    title = sourceUrl;
+  }
   let body = article?.content;
   if (!body || body.length === 0) {
     body = document.body?.textContent ?? "";
@@ -303,7 +351,9 @@ export function extractMarkdown(html: string, sourceUrl: string): FetchedPage {
 }
 
 function truncateMarkdown(text: string): { text: string; truncated: boolean } {
-  if (Buffer.byteLength(text, "utf8") <= MAX_MARKDOWN_BYTES) return { text, truncated: false };
+  if (Buffer.byteLength(text, "utf8") <= MAX_MARKDOWN_BYTES) {
+    return { text, truncated: false };
+  }
   const bytes = Buffer.from(text, "utf8");
   const sliced = bytes.subarray(0, MAX_MARKDOWN_BYTES).toString("utf8");
   const cut = sliced.lastIndexOf("\n", sliced.length - 1);