Merge pull request #314 from steven-jianhao-li/dev

Dev

Author: steven-jianhao-li

addon/prefs.js

@@ -51,6 +51,7 @@ pref("__prefsPrefix__.maxTokens", "8192");
 pref("__prefsPrefix__.enableMaxTokens", true);
 pref("__prefsPrefix__.topP", "1.0");
 pref("__prefsPrefix__.enableTopP", true);
+pref("__prefsPrefix__.reasoningEffort", "default");
 pref("__prefsPrefix__.stream", true);
 pref("__prefsPrefix__.requestTimeout", "300000"); // 5分钟超时
 // MINERU API KEY

docs/api-configuration.md

@@ -77,7 +77,8 @@ Google AI Studio 免费层级对不同模型有不同的速率限制。查看可
 2. 平台选择 **OpenAI**
 3. 粘贴 API 密钥
 4. 模型名称填写（从 [官方模型列表](https://platform.openai.com/docs/models) 获取，模型名在Snapshots下，例如：`gpt-5.2`、`gpt-5-mini`）
-5. 点击 **"测试连接"**
+5. 如使用支持推理的 GPT / o 系列模型，可在该模型平台详情中调整 **思维链长度**；OpenAI 官方端点默认使用 **斟酌**
+6. 点击 **"测试连接"**
 
 ![OpenAI 模型名获取](images/api-config-openai-models.png)
 

package-lock.json

@@ -1,7 +1,7 @@
 {
   "name": "zotero-ai-butler",
   "type": "module",
-  "version": "3.6.0-beta.6",
+  "version": "3.6.0-beta.8",
   "description": "Your personal AI butler, automatically and meticulously reads papers and summarizes notes.",
   "config": {
     "addonName": "zotero-ai-butler",

package.json

@@ -245,6 +245,7 @@ function initializeDefaultPrefsOnStartup() {
     maxApiSwitchCount: "3", // 最大切换次数
     failedKeyCooldown: "300000", // 失败密钥冷却时间(毫秒)，默认5分钟
     temperature: "0.7", // 默认温度参数,平衡创造性和准确性
+    reasoningEffort: "default",
     stream: true, // 默认启用流式输出,提供更好的用户体验
     summaryPrompt: getDefaultSummaryPrompt(), // 加载默认提示词模板
     promptVersion: PROMPT_VERSION, // 当前提示词版本号

src/hooks.ts

@@ -0,0 +1,52 @@
+export type NoteTag = { tag: string };
+
+const SUMMARY_NOTE_TAG = "AI-Generated";
+const TABLE_NOTE_TAG = "AI-Table";
+const CHAT_NOTE_TAG = "AI-Butler-Chat";
+const MINDMAP_NOTE_TAG = "AI-Mindmap";
+const IMAGE_NOTE_TAGS = ["AI-Image-Summary", "AI-ImageSummary"];
+
+const AI_BUTLER_SUMMARY_HEADING_RE = /<h2>\s*AI\s*管家\s*-\s*(?!后续追问)/;
+const AI_BUTLER_CHAT_HEADING_RE =
+  /<h2>\s*AI\s*管家\s*-\s*后续追问(?:\s*-|\s*笔记|[\s<])/;
+const AI_BUTLER_MINDMAP_HEADING_RE = /AI\s*管家思维导图\s*-/;
+const AI_BUTLER_IMAGE_HEADING_RE = /AI\s*管家一图总结\s*-/;
+
+export function hasNoteTag(tags: NoteTag[], tag: string): boolean {
+  return tags.some((t) => t.tag === tag);
+}
+
+export function isFollowUpChatNote(tags: NoteTag[], noteHtml: string): boolean {
+  const hasSummaryTag = hasNoteTag(tags, SUMMARY_NOTE_TAG);
+  return (
+    hasNoteTag(tags, CHAT_NOTE_TAG) ||
+    (!hasSummaryTag && AI_BUTLER_CHAT_HEADING_RE.test(noteHtml))
+  );
+}
+
+export function isRegularSummaryNote(
+  tags: NoteTag[],
+  noteHtml: string,
+): boolean {
+  const isTableNote = hasNoteTag(tags, TABLE_NOTE_TAG);
+  const isMindmapNote =
+    hasNoteTag(tags, MINDMAP_NOTE_TAG) ||
+    AI_BUTLER_MINDMAP_HEADING_RE.test(noteHtml);
+  const isImageNote =
+    IMAGE_NOTE_TAGS.some((tag) => hasNoteTag(tags, tag)) ||
+    AI_BUTLER_IMAGE_HEADING_RE.test(noteHtml);
+
+  if (
+    isTableNote ||
+    isMindmapNote ||
+    isImageNote ||
+    isFollowUpChatNote(tags, noteHtml)
+  ) {
+    return false;
+  }
+
+  return (
+    hasNoteTag(tags, SUMMARY_NOTE_TAG) ||
+    AI_BUTLER_SUMMARY_HEADING_RE.test(noteHtml)
+  );
+}

src/modules/aiNoteClassifier.ts

@@ -17,6 +17,7 @@
  */
 
 import { getPref } from "../utils/prefs";
+import { isRegularSummaryNote } from "./aiNoteClassifier";
 import { TaskQueueManager } from "./taskQueue";
 
 /**
@@ -288,14 +289,9 @@ export class AutoScanManager {
         const n = await Zotero.Items.getAsync(nid);
         if (!n) continue;
 
-        // 检查标签
         const tags: Array<{ tag: string }> = (n as any).getTags?.() || [];
-        const hasTag = tags.some((t) => t.tag === "AI-Generated");
-        if (hasTag) return true;
-
-        // 检查标题标记
         const noteHtml: string = (n as any).getNote?.() || "";
-        if (/<h2>\s*AI 管家\s*-/.test(noteHtml)) {
+        if (isRegularSummaryNote(tags, noteHtml)) {
           return true;
         }
       }