ZotMax

給護理研究生的 Zotero 10 文獻外掛：把 Zotero 裡的文獻、PDF 劃線、筆記和評讀，整理成好讀、好找的 Obsidian 筆記或 Notion 資料庫；要的話，AI 先替每篇寫一份研讀筆記，沒有 API key 也可以。

⬇️ 下載最新版 · 🧭 安裝精靈 · 醫學文獻快速搜尋 · 文獻評讀表

需要 Zotero 10；Obsidian 建議 1.14 以上（彩色劃線與 Bases 看板）。裝一次之後，Zotero 會自動更新。快速搜尋和評讀表是網頁，不用安裝，手機也能用。

它幫你做什麼

• 📄 每篇一頁重點：研究設計、樣本數、證據等級、PICO、評讀燈號、主要發現排成卡片，10 秒看完；長的內容收在四個摺疊區塊，手機上也好讀；你的劃線依顏色的意義分組，點一下回到 PDF 原位置。重新同步不會蓋掉你寫的東西。
• 🗂️ 資料夾跟 Zotero 分類一樣：文獻筆記、全文、圖片放在同一個資料夾。00 首頁 告訴你接下來讀哪篇、哪些評讀還沒核對；每個分類有主題頁和證據地圖。
• 🤖 AI 研讀筆記（選用）：沒有 API key 也行，把提示詞貼到 ChatGPT、Claude、Gemini 網頁，再把回答貼回來。也可以用 OpenRouter 的免費模型，或自己的 Claude／OpenAI key 在同步時自動產生。可引用句都回原文核對。
• ✅ 從篩選、評讀到寫作：篩選與 PRISMA 2020、CASP／JBI 評讀表、PICO 表、GRADE、中文 APA 7（含 Word 引用樣式）、給 Pandoc 的參考文獻檔、給指導教授的進度報告。

整理、追蹤、評讀交給它；找文獻和寫作留給你。 新安裝預設是「研究生引導」模式：自動找文獻和 AI 寫草稿的功能先關著，每個功能都能單獨開關。

5 分鐘開始 · 兩種模式與功能開關 · 功能導覽 · 常見問題 · 隱私與費用 · 給開發者 · 版本紀錄

5 分鐘開始

1. 下載安裝：下載最新版的 zotero-bridge-x.y.z.xpi（用 Firefox 請在連結上按右鍵 →「另存連結」，不然 Firefox 會把它當成自己的擴充功能），然後 Zotero → 工具 → 附加元件（英文介面：Tools → Plugins）→ 右上角齒輪 → Install Plugin From File…。
2. 跟著設定精靈走：裝好後自動打開，約 3 分鐘。選模式 → 選筆記放哪裡（Obsidian vault、Notion，或兩個都要）→ 選 AI 怎麼用（見下表）→ 用一篇文獻試同步一次（不呼叫 AI、不花錢）。每一步的細節。
3. 同步：在文獻清單選幾篇文獻，按清單上方工具列（「新增筆記」右邊）的 ZotMax 按鈕 → 同步所選文獻（Notion + Obsidian）。
4. 看結果：打開 Obsidian 的 Zotero/00 首頁，從「▶️ 從這裡開始」挑一篇；每篇文獻筆記最上面是導覽列和「重點」。用 Notion 的話，資料庫每篇一頁，欄位可以排序、篩選。

AI 要選哪一個？（之後可以在 設定 → ZotMax → AI 改）

你的情況	選	費用
不會申請 API key，或已經有 ChatGPT、Claude、Gemini（免費或訂閱）、學校提供的 AI	網頁版 AI（複製貼上）：在文獻上按右鍵 → ZotMax ▸ AI 筆記（複製貼上，免 API key）…，見網頁版 AI	不用另外付費
想讓同步時自動產生，但不想花錢	OpenRouter 的免費模型：用 Google 帳號註冊，不用綁信用卡	免費；沒有儲值時每天約 50 篇（額度）
要穩定的品質，或一次很多篇	Claude、OpenAI 的 API key，或 OpenRouter 的付費模型	依用量計費；一次超過 5 篇會先確認
先不用	「先不用 AI」	不花錢

ChatGPT Plus、Claude Pro 這類訂閱不能當 API key 用，但可以用網頁版 AI。Notion integration 怎麼建、API key 去哪裡拿，安裝精靈有逐步說明。不想用精靈，就到 Zotero → 設定 → ZotMax →「同步」和「AI」分頁自己設定。以下是設定頁的細節，需要時再展開。

首次設定精靈

第一次安裝 ZotMax 後，Zotero 會打開一個「ZotMax 設定精靈」視窗，不必自己去找設定頁，大約 3 分鐘：

1. 歡迎：ZotMax 做什麼、不做什麼（找文獻和寫作留給你；AI 只在你打開後出現；每個功能都能關）。
2. 選模式：研究生引導（建議新手）或進階，之後可在 設定 → 功能 改。
3. 筆記放哪裡：Obsidian（選 vault 資料夾，精靈會檢查它是不是資料夾、有沒有 .obsidian）、Notion（貼 token 和資料庫連結，按「測試連線」；還沒有資料庫，可以按「找可以放資料庫的頁面」→ 選一個已分享給 integration 的頁面 →「在這個頁面建立資料庫」，連結會自動填好並測試連線）、兩個都要，或先不用。
4. AI（選填）：選 Claude、OpenAI、OpenRouter 並貼 API key，或選「不用 key：網頁版 AI（複製貼上）」。key 存在系統的登入管理員，不寫進設定檔；精靈只檢查格式，不會為了測試去呼叫 API 花你的錢。不確定就按「先不用 AI」。
5. 試一次：用你選取的文獻（沒選就用清單第一篇）同步一次，不呼叫 AI、不花錢，完成後顯示筆記寫到哪裡，可以直接「在 Obsidian 開啟」。
6. 完成：告訴你工具列按鈕、右側面板、快速指令和設定頁在哪。

每一步按「下一步」才會存，「略過」和「上一步」什麼都不改；中途按 Esc 或關掉視窗，已經存下的設定都會留著。之後想再跑一次：快速指令（Ctrl+Shift+P，macOS ⇧⌘P）搜「設定精靈」、工具列 ZotMax 按鈕選單的 設定精靈…，或 設定 → ZotMax → 功能 最上面的 開啟設定精靈。從舊版更新、已經設定過的人不會看到它跳出來。

1. 到 https://www.notion.so/profile/integrations 建立一個 Internal integration，複製 token（ntn_ 開頭）。
2. 在 Notion 建立一個資料庫（空白的 Table 就可以），右上角 ••• → Connections → 加入剛剛的 integration。
3. 複製資料庫連結（https://www.notion.so/...），貼到「預設資料庫連結」或分流規則。
4. 按 測試連線並補齊資料庫欄位。新資料庫用中文欄位（括號裡是舊版的英文名稱）：

讓 ZotMax 幫你建資料庫（取代上面第 2、3 步）：integration 只能在分享給它的頁面裡建立東西，所以還是要先在 Notion 打開一個頁面（例如「碩論文獻」），右上角 ⋯ → Connections → 選你的 integration。然後在設定精靈的 Notion 欄位按 找可以放資料庫的頁面 → 選那個頁面 → 在這個頁面建立資料庫，或在設定頁按「預設資料庫連結」旁的 建立新的資料庫… 選頁面。ZotMax 會在那個頁面底下建立「ZotMax 文獻」資料庫（下表的欄位全部建好）、填好連結並測試連線；只有你按下去才會建，一次一個。integration 一個頁面都看不到時，會告訴你怎麼分享。設定好的資料庫被刪除、移到垃圾桶或取消分享時，測試連線和同步會說找不到，並提醒你可以用同一個按鈕重新建立（不會自己建）。

類別	欄位
書目資料	標題（沿用資料庫原本的標題欄）、作者（Authors）、年份（Year）、出版日期（Date）、期刊（Publication）、卷（Volume）、期（Issue）、頁碼（Pages）、出版者（Publisher）、文獻類型（Item Type）、DOI、網址（URL）、摘要（Abstract）
整理用	閱讀狀態（Status；單選：待讀／閱讀中／已讀／已引用／已刪除）、標籤（Tags）、分類（Collections）、文獻庫（Library）、引用鍵（Citation Key）、APA 7（APA）、一句話摘要（Summary）、全文狀態（Full Text）
研讀欄位（AI）	研究設計（Study Design；RCT、quasi-experimental、cohort、case-control、cross-sectional、qualitative、mixed methods、systematic review、meta-analysis、scoping review、guideline、other）、樣本數（Sample Size）、證據等級（Evidence Level；Oxford CEBM 2011，1–5）、JBI 證據等級（JBI Level）、評讀工具（Appraisal Tool）、評讀結果（Appraisal；納入／排除／需更多資訊）、評讀已核對（Appraisal Verified）、P 族群、I 介入措施、C 對照、O 結果指標、研究場域（Setting）、測量工具（Measures，多選）、國家（Country）
連結與同步	Zotero 連結（Zotero）、Obsidian 連結（Obsidian）、Zotero 識別碼（Zotero Key）、加入日期（Date Added）、最後同步（Last Synced）

• 欄位可以改名，但不要刪除或改類型：外掛記得每個欄位的 ID，改名後照樣找得到，中英文名稱也都認得。你可以自由加自己的欄位（例如「評分」），外掛不會動。
• 舊的英文欄位照常運作：再按一次「測試連線並補齊資料庫欄位」會用原本的語言補上缺的欄位。想改成中文，按 把 Notion 欄位改成中文…：先列出每個要改的欄位（例如 Authors → 作者），確認後才依欄位 ID 改名，資料不動。已有同名中文欄位的不會改。Notion 公式、篩選或其他整合用到這些名稱的，要自己跟著改。
• DOI、APA、JBI、PICO 的 P／I／C／O 這類慣用英文的詞保留英文。
• 舊的 AI 筆記沒有結構化資料時，研讀欄位維持原值，不會被清空。
• 文獻比較表、PRISMA、進度報告要建成 Notion 頁面時，另外填「文獻比較表的 Notion 父頁面」（也要分享給 integration）。

• 預設子資料夾：例如 Zotero。
• 檔名格式：建議用 Citation key（沒有時用「作者 年份 - 標題」）。Zotero 10 有內建 Citation Key 欄位；有裝 Better BibTeX 也會讀取。
• 建立「Zotero 文獻庫.base」總表（預設開啟，放在 90 系統/；舊版平鋪結構放在預設子資料夾）：只建立一次，之後不覆寫你的修改。想要新版的欄位就刪掉舊檔，下次同步重建。
  • 「文獻總表」：標題、作者、年份、期刊、研究設計、樣本數、證據等級、閱讀狀態、分類。
  • 「閱讀進度」：依 status 分成待讀／閱讀中／已讀／已引用的看板，拖曳卡片就改了 status，下次同步 Zotero 與 Notion 也跟著改。
• 由外掛管理的 frontmatter：study_design、sample_size、evidence_level、jbi_level、appraisal_tool、appraisal_overall、appraisal_verified、setting、population、intervention、comparison、outcomes、measures、country、effect_direction、full_text、fulltext。有新資料時會覆寫，請不要用這些名稱存自己的資料。你自己加的其他欄位（例如 aliases）會保留。
• 一併同步 Zotero 子筆記（預設開啟）。
• Graph view：AI 筆記的 [[關鍵概念]] 會把談同一件事的文獻串起來；有了概念卡片，每個概念都是真正的節點。

服務商	API key 取得處	備註
Anthropic（Claude）	https://console.anthropic.com	可調思考深度（effort：low～max）；批次 API、圖片劃線只支援 Claude
OpenAI	https://platform.openai.com	可填相容服務的 API base URL
OpenRouter	https://openrouter.ai（Google 帳號即可註冊 → Keys）	一個 key 用 Claude、GPT、Gemini、DeepSeek 等數百個模型。預設 openrouter/free 自動挑免費模型：不用錢、不用綁信用卡，品質較不穩定；次數限制見下方OpenRouter 免費額度；按「載入模型清單」可以選付費模型（費用從 OpenRouter 儲值扣，用量表直接記 OpenRouter 回報的金額）。只送文字，掃描版 PDF 不送檔案
網頁版 AI（免 API key）	不需要	不呼叫 API：用複製貼上的方式產生 AI 文獻筆記，見下方網頁版 AI。其他 AI 功能（比較表、文獻探討草稿、評讀陪練、讀懂統計、AI 主題分類）仍需要 API key

• 預設模型可以在設定頁改。
• 全文最多送出字元數：預設 150,000。超過會截斷，frontmatter 標 fulltext_truncated: true，也會告訴 AI 後段沒有提供。設成 0 表示只送摘要與註記，最省錢。
• 自動重試：API 暫時忙碌或網路中斷（HTTP 408／409／429／500／502／503／504、Claude 的 529）最多重試 4 次，間隔以指數退避並遵守 retry-after；金鑰錯誤（401）、請求錯誤（400）或模型拒絕處理不重試。
• 筆記模板：「AI 文獻筆記 → 筆記模板（system prompt）」可以照課程或指導教授的要求改；按「載入內建模板來修改」從內建版開始。改了模板，外掛仍會要求 AI 附上結構化資料。

OpenRouter 免費額度

免費模型不用綁信用卡。依 OpenRouter 的說明：沒有儲值時每天 50 次、每分鐘 20 次；帳戶累計儲值滿 US$10 後提高到每天 1000 次（儲值有手續費；數字可能調整，以 OpenRouter 公告為準）。一篇文獻的 AI 筆記算一次。免費次數以 UTC 日計算，台灣時間每天早上 8 點重置。

• 當天用完時（HTTP 429 free-models-per-day）：外掛不再重試，直接說「OpenRouter 今天的免費額度用完了」和重置時間；同一批後面的文獻照常同步、先不產生 AI 筆記，額度重置後再同步一次就會補上。急的話改用網頁版 AI。
• 免費模型太多人在用（其他 429）：照常自動重試，最後請你過幾分鐘再試或換模型。
• 付費模型餘額不足（402）：請你到 OpenRouter 儲值，或把模型改回 openrouter/free。

由上往下比對，第一條符合的規則生效；欄位留空時用預設值。分類路徑會包含子分類，例如 碩論 也比對到 碩論/文獻回顧。

名稱	文獻庫	分類路徑	Notion 資料庫	Obsidian 子資料夾
碩論	我的文獻庫	碩論	碩論 DB 連結	Zotero/碩論
實驗室	群組：XX Lab	（空白）	實驗室 DB 連結	Zotero/Lab
其他	全部文獻庫	（空白）	（空白 = 預設）	Zotero/Inbox

兩種模式與功能開關

設定 → ZotMax 的第一個分頁是「功能」。先選一個起點，再逐項調整：

• 研究生引導（新安裝預設）：找文獻與寫作留給你自己。自動找新文獻、引文追蹤和 AI 寫的草稿先關著，整理、評讀和搜尋連結照常幫你。
• 進階：全部打開，包括 AI 草稿、批次 API 和自動追蹤新文獻。
• 自訂：改了任何一個開關、跟兩種模式都不完全一樣時，自動顯示。

開關馬上生效，不用重新啟動。關掉的功能，選單（右鍵、工具列按鈕、快速指令裡標成關閉）、右側面板的列、背景工作和設定頁裡的相關設定都會一起收起來，也不會連網或呼叫 AI。切換模式後可以按「復原」回到切換前。

設定在哪裡：設定頁依研究流程分成六個分頁，功能 · 同步（Obsidian、Notion、分流規則、自動同步、閱讀狀態、中文 APA、參考文獻檔）· 整理（全文筆記、劃線顏色、概念卡片、文獻自動分類）· 找文獻（醫學文獻快速搜尋、NCBI、PubMed 追蹤、引文追蹤）· 篩選與評讀 · AI（AI 服務、本月 AI 用量、Gemini Notebook），下次打開會回到上次的分頁。不確定在哪一頁，就在最上面的「找設定」輸入關鍵字，中英文都可以（例如 Notion、API key、分類）：所有分頁裡符合的區塊會一起列出，按 Esc 回到分頁；關著的功能也會列出，按一下就跳到它在「功能」的開關。Zotero 設定視窗上方的搜尋框也找得到這些設定。

開關	做什麼	標記	研究生引導	進階
整理與同步
同步到 Obsidian／Notion	把書目、劃線、你的筆記和評讀整理進自己的筆記空間，是外掛的核心	連網	✅	✅
閱讀狀態	待讀、閱讀中、已讀、已引用，在 Zotero、Notion、Obsidian 三邊一致		✅	✅
中文 APA	中文文獻改用中文 APA 7，不改動 Zotero 條目		✅	✅
圖片劃線	PDF 上框選的圖表截圖一起放進筆記		✅	✅
參考文獻檔	匯出 references.json（可加 BibTeX），寫作時用 Pandoc 引用		✅	✅
研究儀表板	在 Obsidian 整理閱讀進度、待讀清單和資料缺漏；只讀 vault		✅	✅
概念卡片	把筆記裡的 [[概念]] 整理成卡片和索引；不呼叫 AI		✅	✅
全文筆記 ¹	PDF 全文整理成 Markdown，劃線依顏色標在原文；送給 AI 的全文也改用它，省 token		✅	✅
文獻自動分類	依研究設計、PICO 和你的規則建議 Zotero 子分類，你勾選後才放進去，可整批復原		✅	✅
工具列按鈕	文獻清單上方的 ZotMax 按鈕，常用功能依研究流程分組		✅	✅
中文文獻補強	檢查匯入的中文文獻資料（作者拆錯、民國年、卷期頁、DOI、語言），你勾選後才修正，可復原；不連網、不呼叫 AI		✅	✅
找文獻
醫學資料庫搜尋連結	把題目、MeSH、PICO 帶到 PubMed、CINAHL、Cochrane、華藝等資料庫	連網	✅	✅
PubMed 新文獻追蹤	定期用你存的檢索式查 PubMed，新文獻自動匯入 Zotero	連網	—	✅
引文追蹤	用 OpenAlex 找納入研究的參考文獻和引用它的文獻，列成候選清單

• 標記和設定頁一致：「AI・要付費」會呼叫 AI（用你的 API key 付費；OpenRouter 的免費模型不收錢），也都會連網；「連網」會連到外部服務。AI 文獻筆記也可以用網頁版 AI 複製貼上，不呼叫 API。
• ¹ 要先開另一個開關：全文筆記、AI 文獻筆記要「同步」；批次 API、AI 標重點要「AI 文獻筆記」；概念卡片 AI 綜整要「概念卡片」；AI 主題分類要「文獻自動分類」和「AI 文獻筆記」；評讀陪練要「文獻評讀表」和「AI 文獻筆記」；讀懂統計要「AI 文獻筆記」。前面的關掉時，後面的會變灰並說明原因。
• ² 關掉「文獻評讀表」只是隱藏表單，已填的評讀照樣同步。
• ³ 進度報告的「本期摘要」是另外勾選的 AI 選項（AI・要付費，產生前先確認費用）；不勾就完全不呼叫 AI。「連網」是因為可以選擇建成 Notion 頁面。劃線顏色的意義和筆記版面是同步的一部分，沒有另外的開關。

• 第一次有開關的版本：如果你已經用過外掛（設定了 vault、Notion 資料庫、分流規則、PubMed 追蹤，或有 AI 用量紀錄），新的開關全部打開，原本的行為不變；原本就有的設定（AI 文獻筆記、批次 API、閱讀狀態、中文 APA、圖片劃線）維持你的選擇，所以模式可能顯示「自訂」。全新安裝則是研究生引導。
• 之後版本新增的開關（全文筆記、文獻自動分類、工具列按鈕、AI 標重點、AI 主題分類，0.12 的評讀陪練、讀懂統計，0.14 的中文文獻補強，以及 0.17 的匯出給 Gemini Notebook）：原本在「進階」的，新開關也打開，維持「進階」；「研究生引導」或「自訂」的，新開關用研究生引導的預設值。你自己設過的開關不會被改。
• 這兩個檢查都只做一次。

依研究流程的功能導覽

入口：所有功能都在同一份清單裡，三個地方看到的分組和名稱都一樣：

• 文獻清單上方工具列的 ZotMax 按鈕（橋形圖示，在「新增筆記」右邊）：第一項是「快速指令…」，接著依流程分成 同步／整理／找文獻／篩選與評讀／AI 輔助與寫作，最下面是「設定…」。作用在你選取的文獻；找重複、PRISMA、評讀總表、引文追蹤納入研究、匯出此分類的參考文獻這類作用在左側選取的分類。

• 條目或分類按右鍵 → ZotMax ▸：只有一個子選單，裡面同樣依流程分組，只列出能用在所選文獻（或這個分類）的功能。

• 快速指令：按 Ctrl+Shift+P（macOS：⇧⌘P），打字找功能（見下面）。

• 側邊面板：選一篇文獻（或在 PDF 閱讀器裡），右側的 ZotMax 面板就是這一篇的重點、劃線、狀態和常用動作（見下面）。

Zotero 的「工具」選單只留「ZotMax 設定…」、「ZotMax 快速指令…」，以及同步或 AI 批次進行中才出現的停止／繼續／放棄、檢查／取消。

側邊面板

選一篇文獻，Zotero 右側面板的右緣有一排直立的圖示，橋形的那個就是 ZotMax；在 PDF 閱讀器裡，右邊的側欄也有同一個圖示，顯示這份 PDF 所屬的文獻。面板分成五段（開了「讀懂統計」並解釋過選取時多一段「統計解釋」），都可以折起來，外掛會記住你開了哪幾段（預設開「重點」和「動作」）：

段落	內容
重點	和文獻筆記最上面的「重點」同一份資料：一句話摘要；研究設計 · 樣本數 · 證據等級 · 評讀結果；2–3 點主要發現。下面是「在 Obsidian 開啟筆記」「開啟全文筆記」「在 Notion 開啟」（有才出現），以及折起來的完整 AI 筆記。還沒有 AI 筆記時說明怎麼產生（「AI 文獻筆記」關著時告訴你去哪裡打開）
統計解釋	「讀懂統計」開著、這篇有解釋過的 PDF 選取時才出現（緊接在「重點」下面）：選的原文、這是什麼／這段在說什麼／臨床上代表什麼／要注意的地方、存到筆記、再解釋得簡單一點；見讀懂統計
我的劃線	依顏色的意義分組，每組的數量與前三則；點一則就在 PDF 打開那個位置
狀態	閱讀狀態、篩選、文獻評讀表（開啟評讀表、對照 AI）、這篇在哪些「自動分類」子分類、上次同步時間
動作	同步、同步但不呼叫 AI、重新產生 AI 筆記、文獻自動分類、搜尋資料庫、引文追蹤、對照 AI（評讀陪練）、快速指令，和工具列按鈕是同一份功能清單，只作用在這一篇；關掉的功能不會出現
延伸搜尋	搜尋連結與 PICO 檢索連結

• 面板會跟著變：改了劃線、標籤、筆記、分類，同步或執行完一個動作，或在設定裡開關功能，內容馬上更新。
• 面板標題列右邊的「⋯」可以開快速指令或 ZotMax 設定。不需要時按標題列把整個面板收起來，Zotero 會記住。
• 一次選很多篇時，Zotero 會改顯示多篇文獻的畫面，沒有個別文獻的面板。

快速指令

不知道某個功能在哪裡？按 Ctrl+Shift+P（macOS：⇧⌘P），或工具列按鈕的第一項、工具 → ZotMax 快速指令…，輸入功能名稱：中文、英文都可以，大小寫、全形半形不拘，打錯一兩個字母也找得到（例如「分類」、「PRISMA」、「流程圖」、「評讀」、「CASP」、「sync」）。上下鍵選擇、Enter 執行、Esc 關閉；執行時用的是你當下在 Zotero 選取的文獻或分類。

• 每個結果旁邊標出它在哪一組。現在不能用的會說原因：功能關著時寫「到 設定 → 功能 打開『…』」，按 Enter 或「打開設定」直接到那個開關（關著的功能找得到，但不會執行）；需要選取時寫「先選取文獻」或「先選取分類」。
• 也能找設定頁的區段，例如「設定：Notion」、「設定：文獻自動分類」，Enter 直接打開那一段。
• 快速指令一直都在，關掉「工具列按鈕」只是收起按鈕。快捷鍵只在主視窗的文獻庫畫面有效；如果你把 Zotero 自己的快捷鍵改成用 P，外掛就不佔用它。

分組	工具列按鈕與快速指令	條目右鍵 ZotMax ▸	分類右鍵 ZotMax ▸
同步	同步到 Notion + Obsidian、同步但不呼叫 AI、只同步到 Obsidian／Notion、同步閱讀狀態；有未完成的同步時多「繼續」「停止」「放棄」	四種同步	四種同步（整個分類，含子分類）
整理	文獻自動分類、復原上次分類（套用過才出現）、更新研究儀表板、更新概念卡片、匯出參考文獻到 Obsidian、匯出目前分類的參考文獻	文獻自動分類	文獻自動分類、匯出此分類的參考文獻
找文獻	醫學文獻快速搜尋、在醫學資料庫搜尋 ▸、檢查新文獻（PubMed 追蹤）、引文追蹤（所選文獻、目前分類全文納入的研究、匯入勾選的文獻）	在醫學資料庫搜尋 ▸、引文追蹤所選文獻	引文追蹤全文納入的研究、匯入勾選的文獻
篩選與評讀	篩選所選文獻 ▸、找出可能重複的文獻、產生 PRISMA 流程圖與證據表、匯出文獻評讀總表	篩選所選文獻 ▸	找重複、PRISMA、評讀總表
AI 輔助與寫作	重新產生 AI 筆記並同步、文獻比較表、文獻探討草稿、進度報告、為概念卡片產生 AI 綜整；有 AI 批次時多「檢查」「取消」	重新產生 AI 筆記、比較表、文獻探討草稿	同左（整個分類）

關掉的功能不會出現，整組都關掉時連分組標題一起收起來。「篩選所選文獻 ▸」裡是標題摘要與全文的決定，全文排除的每個原因各一項。鍵盤：在工具列用方向鍵移到這個按鈕，按 Enter、空白鍵或向下鍵打開。沒選文獻就按需要文獻的項目，會提示「請先選取文獻。」。

同步的四個選項：

選項	什麼時候用
同步到 Notion + Obsidian（沒有 AI 筆記才產生）	日常使用
重新產生 AI 筆記並同步	讀完、劃完線後重新整理；舊的 AI 筆記先另存成「🤖 AI 文獻筆記（舊版 日期）」子筆記
同步但不呼叫 AI（沿用既有 AI 筆記）	只更新書目、劃線與筆記，不花 token
只同步到 Obsidian ／ 只同步到 Notion

收集與同步

同步把每篇文獻的書目、摘要、PDF 劃線（含頁碼連結）、你的 Zotero 子筆記、評讀和 AI 筆記，寫成 Obsidian 的一份筆記和 Notion 的一頁。APA 7 引文由 Zotero 內建的 CSL 引文處理器產生，不讓 AI 編參考文獻。Notion 頁面有開 Obsidian 的連結，Obsidian 筆記有開 Notion 和 Zotero 的連結，每條劃線都能點回 PDF 原位置。

重新同步不會蓋掉你寫的東西。 Obsidian 只改寫 %% zotero-bridge:start %% 到 %% zotero-bridge:end %% 之間，區塊外的文字、「✍️ 我的筆記」和你自己的 frontmatter 都保留；Notion 只替換標題為「📚 ZotMax｜…」的那個區塊。改了 Citation key 或標題，外掛靠 zotero_key 找到原本的筆記並改檔名；你把筆記搬到規則資料夾底下的其他子資料夾也找得到。

文獻筆記的版面（看板）：最上面是 10 秒看完的「重點」看板。第一行是作者 · 年份 · 期刊；下面是卡片：研究概要（研究設計、樣本數、場域、證據等級的數字方塊）、一句話、PICO、評讀（每題一個燈號 ✅❌❓➖⬜、「是」的比例長條、整體評價和核對狀態）、主要發現（最多 3 點）、我的劃線（一排依顏色比例的色塊 🟨🟥🟩🟦，加上兩句重點劃線）、下一步（依這篇缺什麼列出：附上 PDF、OCR、產生 AI 筆記、劃線、評讀、核對）。最後一行是全文、Zotero、Notion、DOI 連結。看板下面只有四個摺疊區塊：我的劃線與筆記、文獻評讀表、AI 文獻筆記、摘要與書目，不用一直往下捲。

• 看起來像儀表板：第一次同步到 vault 時，ZotMax 會把 CSS 片段 .obsidian/snippets/zotmax.css 放進 vault 並啟用，卡片就會排成格狀；所有卡片同一種樣式、標題用你佈景主題的強調色，只有代表意義的顏色（劃線色塊、閱讀狀態、「下一步」）才上色；深色模式、平板和手機（兩欄）也會跟著調整。Obsidian 開著的話，到 設定 → 外觀 → CSS 片段 按重新整理。你在 Obsidian 關掉它，ZotMax 不會再自己打開；設定 → 同步 → Obsidian 的 安裝看板樣式到 Obsidian 可以重新安裝。不裝片段也能讀，只是卡片會上下排。

• 屬性區變短：看板筆記最上面的屬性區只顯示閱讀狀態、標籤和你自己加的屬性；研究設計、PICO 等其他資料已經在卡片上，仍留在 frontmatter 給 Bases、Dataview 和搜尋用。想看全部：設定 → 同步 → Obsidian，取消「看板：文獻筆記最上面的屬性區只顯示…」（需要 ZotMax 樣式）。

• 想要舊版：設定 → 同步 → Obsidian → 文獻筆記最上面的「重點」選「精簡（一個區塊，舊版）」，下次同步就換回一個區塊的「重點」。Notion 不受這個設定影響（它的四組收合區塊在 設定 → 同步 → Notion 另外切換）。

• 閱讀狀態：待讀／閱讀中／已讀／已引用，在 Zotero（標籤）、Notion（閱讀狀態 欄位）、Obsidian（status，可在看板拖曳）任一邊改，下次同步另外兩邊跟著改。右側面板也能直接改。→ 設定 → 同步 → 閱讀狀態

• 自動同步（選用，預設關閉）：條目、劃線或筆記變更後自動同步。自動同步不會呼叫 AI。 → 設定 → 同步 → 自動同步

• 中途停止與接續：一次同步很多篇時，工具 → 停止 ZotMax 同步；之後 繼續未完成的 ZotMax 同步（N 筆）。Zotero 關閉或當掉也不會從頭來過，失敗的會一起重試。

• 圖片劃線：在 PDF 用「選取區域」框選的表格、圖和手繪註記，連同截圖一起同步（Obsidian 存在筆記旁的 附件/，Notion 上傳成圖片）。

• 中文 APA：中文期刊、學位論文自動改用中文 APA 7（陳美玲、林小華（2023）。題目。護理雜誌，70(2)，45–56。，內文「陳美玲等，2023」），參考文獻可以中文在前。→ 設定 → 同步 → 中文文獻與中文 APA

• Word 的中文 APA 引用：Zotero 官方 APA 樣式會把中文寫成「陳, 美. & 林, 小.」「et al.」。ZotMax 附兩個 Word 用的引用樣式「APA 7 中英混排（臺灣，ZotMax）」和台灣護理學會版：中文文獻用中文 APA 7，英文文獻和官方樣式一樣，中文排前面（依筆畫）。在 Word 繼續用 Zotero 外掛插入引用，按 Refresh 就更新。→ ZotMax 按鈕或快速指令 → 安裝 Word 中文 APA 樣式。見下方。

• 中文文獻補強：從華藝、臺灣期刊論文索引、博碩士論文系統匯入的資料常有錯（兩位作者擠在一格、民國年、「４５－５６頁」、DOI 只在「其他」欄），會讓中文 APA 出錯。選取文獻或分類 → ZotMax 按鈕或右鍵 → 檢查中文文獻資料…，在確認視窗勾選要修正的地方才寫回 Zotero，可以復原。右側面板的「狀態」也會提醒「中文資料：3 個地方要檢查」。

看板版（預設）：

> [!zm-board] 重點
> Lee、Chen · 2024 · *Journal of Advanced Nursing*
>
> > [!zm-stats|wide] 研究概要
> > - 研究設計：**RCT**
> > - 樣本數：**N = 120**
> > - 場域：**內科病房 · Taiwan**
> > - 證據等級：**CEBM 2** ▰▰▰▰▱
>
> > [!zm-summary|wide] 一句話
> > 護理師帶的運動課讓住院長者跌倒率下降 30%。
>
> > [!zm-pico] PICO
> > - **P** 65 歲以上住院長者
> > - **I** 護理師主導 12 週運動課
> > - **C** 常規照護
> > - **O** 跌倒發生率、跌倒自我效能
>
> > [!zm-appraisal] 評讀
> > CASP 隨機對照試驗評讀表（2024 版）・已核對
> > ✅✅✅❓✅ ❌✅✅✅✅ ✅✅✅
> > ▰▰▰▰▰▰▰▰▱▱ 是 11／13
> > **整體**：納入
>
> > [!zm-findings|wide] 主要發現
> > - 跌倒率下降 30%
>
> > [!zm-highlights|wide] 我的劃線（3）
> > 🟨🟨🟨🟨🟨🟨🟨🟨🟨🟨🟨🟨🟨🟥🟥🟥🟥🟥🟥🟥
> >
> > 🟡 重要發現 2 · 🔴 限制／疑問 1
>
> > [!zm-next|wide] 下一步
> > - 評讀答完了：勾「我已核對」，評讀結果才會取代 AI 的值
>
> [[Zotero/10 文獻/碩論/lee2024 · 全文|全文與劃線]] · [Zotero](zotero://…) · [DOI](https://doi.org/…)

> [!zm-mine]- 我的劃線與筆記（劃線 3 · 筆記 1）
> [!zm-form]- 文獻評讀表
> [!zm-ai]- AI 文獻筆記（模型 · 日期）
> [!zm-ref]- 摘要與書目

精簡版（設定裡選「精簡」）的「重點」是一個區塊：

> [!abstract] 重點
> **一句話**：護理師帶的運動課讓住院長者跌倒率下降 30%。
>
> RCT · N = 120 · CEBM 2 · JBI 1.c · 評讀：納入（AI 初評）
>
> **主要發現**
> - 跌倒率下降 30%
> - 遵從度高、沒有嚴重不良事件
>
> **我的劃線**
> - ==🟡reduced the rate of falls by thirty percent== 重要發現 · [p. 2](zotero://…)
> - ==🔴no serious adverse events were reported== 限制／疑問 · [p. 2](zotero://…)
>
> [[Zotero/10 文獻/碩論/lee2024 · 全文|全文與劃線]] · [Zotero](zotero://…) · [Notion](https://…) · [DOI](https://doi.org/…)

> [!quote]- 🟡 重要發現（1）
> [!quote]- 🔴 限制／疑問（1）
> [!note]- 我的 Zotero 筆記（1）
> [!example]- 文獻評讀表
> [!tip]- AI 標的重點（僅供參考）
> [!note]- AI 文獻筆記（模型 · 日期）
> [!info]- 摘要（Abstract）
> [!search]- 🔎 延伸搜尋
> [!info]- 書目資訊

• 重點：評讀結果以核對過的評讀表優先（標「已核對」），只有 AI 的標「AI 初評」；「我的劃線」依顏色意義的順序，每種意義先挑一條（看板 2 條、精簡版 3 條）。看板裡沒有資料的卡片不出現；「下一步」一定在，什麼都齊了會說「這篇的資料都齊了」。
• 研究儀表板：看板版一打開就是三排卡片：「總覽」（文獻篇數、已讀完成率、AI 筆記、評讀已核對、待讀、回顧專案六張數字卡）、「圖表」（閱讀進度色塊、研究設計圓餅圖、證據等級（CEBM，1 在最上面，像證據金字塔）、評讀結果、近 8 年出版年份的長條圖，和近 12 個月每月新增的走勢線 ▁▂▅█）、「待處理」（待讀最久、資料要補、回顧專案、本週新增，各 5 篇）；證據缺口地圖之後，完整的表格都收在摺疊區塊裡。
• 摺疊區塊：先放你的東西（各顏色的劃線、Zotero 子筆記、評讀表），再放 AI 的，最後是參考資料；看板版把它們收成四組，精簡版一段一個。沒有內容的區塊不出現。一句話和 Zotero／Notion 連結只出現在「重點」；全文不貼進筆記，用連結開全文筆記。
• Notion：和 Obsidian 看板一樣收成四個收合區塊（我的劃線與筆記、文獻評讀表、AI 文獻筆記、摘要與書目）；裡面每一段用小標題分開，劃線的小標題帶著該顏色的底色。想要每一段一個收合區塊：設定 → 同步 → Notion，取消「文獻頁面的收合區塊分成四組」。

地方	存在哪裡	怎麼改
Zotero	標籤 狀態/已讀 ✅（每篇只留一個）	右側面板的「閱讀狀態」選單，或直接改標籤
Notion	閱讀狀態（舊資料庫：Status）單選欄位	在資料庫改
Obsidian	frontmatter 的 status	在「閱讀進度」看板拖曳，或直接改

• 什麼時候同步：每次一般同步都會比對三邊。自動同步只在 Zotero 有變更時觸發，所以 Notion／Obsidian 的改動會在下次同步時帶回；想一次更新全部，用 ZotMax 按鈕或快速指令 → 同步閱讀狀態（只更新已同步過的文獻的狀態，不呼叫 AI、不新增 Notion 頁面）。
• 以哪邊為準：外掛記得上次三邊一致的狀態（Obsidian 的 status_synced；沒設定 Obsidian 時記在 Zotero 設定）。只有一邊改過就以那邊為準；不同地方改成不同狀態時，依 Obsidian > Zotero > Notion，進度視窗顯示「⚠️ 閱讀狀態衝突」。自動同步時改以 Zotero 優先。
• 只同步到 Obsidian 或只同步到 Notion 時，沒選的那邊下次一般同步再補上。
• 移到 Zotero 垃圾桶的文獻不會被狀態同步恢復；「已刪除」只由外掛設定。
• 標籤：前綴可以改（舊標籤不會自動改名）。標籤含 emoji（預設：閱讀中 📖、已讀 ✅、已引用 📝）時，Zotero 會顯示在標題旁。替狀態標籤指定顏色後，可以用數字鍵快速標記；同時有兩個狀態標籤時，同步會留下新加的那個。
• 為什麼 Notion 用「單選」：Notion API 不能把選項放進「狀態」類型的分組，也不能填入還不存在的狀態選項。資料庫原本就有「狀態」類型的 Status 欄位時外掛不會動它，會提示你改名後再按「測試連線並補齊資料庫欄位」。
• 不想同步閱讀狀態：關掉「閱讀狀態」開關（Zotero 不會再加標籤）。

• 刪除條目：條目移到 Zotero 垃圾桶或刪除時，Notion 頁面移到 Notion 垃圾桶；Obsidian 筆記不會刪除，只把 status 改成「已刪除」並在區塊最上方加提示。從垃圾桶還原再同步，筆記恢復原本的狀態（Notion 會建新頁面）。
• 停止：正在處理的那一篇完成後才停，不會留下寫到一半的筆記。
• Zotero 關閉或當掉：下次開啟會提醒還有幾筆沒同步，從工具選單接續；不想接續就選 放棄未完成的 ZotMax 同步。
• 開始新的多篇同步時會取代上一次未完成的紀錄；單篇同步和自動同步不記錄。
• 選「同步到兩邊」但只設定了一邊時，沒設定的那邊自動略過。某一步失敗（例如 AI 逾時）時，其他步驟照常完成。

• Obsidian：截圖存在筆記所在資料夾的 附件/<條目KEY>-<註記KEY>.png（舊版平鋪結構是 attachments/），嵌入對應顏色的劃線區，上方是頁碼連結、下方是你的評註。內容沒變不重寫；用條目 KEY 命名，所以改 citekey 也不用改名。
• 刪除：在 Zotero 刪掉圖片劃線後再同步，對應的截圖會刪除。只刪這篇文獻 條目KEY-註記KEY.png 格式的檔案，你自己放的圖片不會動；筆記自己搬到別的資料夾後，舊的截圖不會跟著搬（在 Zotero 換分類、由 ZotMax 搬的會一起搬）。
• Notion：用檔案上傳 API 上傳成圖片區塊。上傳的檔案沒馬上放進頁面一小時後就失效，而自動同步區每次重建，所以每次同步到 Notion 都會重新上傳（每張圖多 2 次 API 請求）。單檔上限 20 MB（Notion 免費方案 5 MB）；失敗時頁面照常同步，只是少了圖。
• 截圖從哪來：Zotero 的快取；沒有時請 Zotero 當場從 PDF 產生，產生不了（例如這台電腦沒有 PDF）就保留顏色、頁碼與評註。
• AI 也看圖片劃線（設定 → AI → AI 服務 → AI 文獻筆記，預設關閉）：把截圖一起傳給 Claude 讀表格裡的數字。一次最多 20 張，單張超過約 3.7 MB 或 8000 像素略過；只有 Claude 收圖片，OpenAI、OpenRouter 不送。評註文字不論如何都會送給 AI。
• 不想要截圖：關掉「圖片劃線」開關。

哪些算中文文獻：標題含中文字（且沒有日文假名、韓文）。標題是英文就算英文文獻，即使「語言」欄是 zh（華藝的匯入器會把所有文獻都標成 zh）。沒有標題時看作者是不是中文姓名，再看「語言」欄。

類型	輸出（筆記裡期刊名稱、卷數、書名與論文名稱是斜體）
期刊，1 位作者	陳美玲（2023）。護理人員跌倒預防衛教之成效。護理雜誌，70(2)，45–56。https://doi.org/10.6224/JN.xxxx
期刊，2–20 位作者	陳美玲、林小華、王大明（2023）。題目。護理雜誌，70(2)，45–56。
期刊，21 位以上	前 19 位、…、最後一位
期刊沒有卷數	陳美玲（2023）。題目。護理雜誌，2，45–56。
碩博士論文（未出版）	陳美玲（2020）。題目〔未出版之碩士論文〕。國防醫學院。
碩博士論文（資料庫）	陳美玲（2020）。題目〔碩士論文，國防醫學院〕。華藝線上圖書館。https://doi.org/…
書籍／編輯書	王大明（2019）。護理研究概論（第3版）。華杏。／王大明（主編）（2019）。書名。華杏。
書中章節	李志明（2019）。章名。載於王大明（主編），老人護理學（頁 101–120）。華杏。
網頁、報告	衛生福利部（2024）。長期照顧統計。https://…（出版者與作者相同時省略）
沒有作者／日期	報告名稱（2022）。出版者。／陳美玲（無日期）。…

• 內文引用：（陳美玲，2023）、（陳美玲、林小華，2023）、3 位以上（陳美玲等，2023）。英文文獻維持（Chen et al., 2023）。
• 學位論文：網址來自華藝或臺灣博碩士論文系統（hdl.handle.net/11296/…）、或有 DOI（含「其他」欄的 DOI: …）時用資料庫版本，否則用「未出版」。學位從「論文類型」判斷。
• 期刊文章只附 DOI，不附資料庫網址（APA 7 規則）。
• 標點：預設「。」分隔（多數學校的指引）；投稿台灣護理學會期刊可改成「．」。
• 作者姓名：寫成完整姓名。Zotero 裡姓／名分欄、單一欄位、前後顛倒、複姓被拆錯（歐／陽志明）、姓名後附英文拼音，都會處理。
• 用在哪裡：筆記的「APA 7」與 frontmatter authors、Notion 的 APA 與作者欄位、文獻比較表的引文與參考文獻、references.json。
• 中文文獻排在英文前（預設開啟）：中文依筆畫、英文依字母。
• citekey 和檔名不受影響。

依據：台灣護理學會「APA 第七版參考文獻快速指引」（2022.01.25 版、2023.02.13 版）、《台大護理雜誌》APA 第七版範例、國立臺東大學APA 第七版參考文獻範例、國立臺中教育大學論文參考文獻第七版 APA 格式、德育護理健康學院圖書館APA 第七版常用之格式規範。學位論文的〔未出版之碩士論文〕寫法參考大學指引常見形式（台灣護理學會範例另有「（未發表的碩士論文）．城市：學校系所。」）。各校與期刊細節不同，請以學校或投稿期刊的最新規定為準。

尚未處理：《護理雜誌》要求的中文文獻英譯、翻譯書的排序、同姓作者的內文區分。

中文 APA 用的是 Zotero 裡的資料；資料錯了，格式再對也沒用。從華藝（Airiti Library）、臺灣期刊論文索引、臺灣博碩士論文知識加值系統、《護理雜誌》《長庚護理》《榮總護理》等網站匯入的條目常有下面這些問題。中文文獻補強只檢查中文文獻（判斷方式和中文 APA 一樣：篇名有中文字）；英文篇名的文獻只看語言欄是不是誤標成中文（表格最後兩列），其他一律不動。

怎麼用：選取文獻，或在左側選一個分類（沒選文獻時就檢查整個分類），ZotMax 按鈕／快速指令／右鍵 → 檢查中文文獻資料（選取項目或分類）…。確認視窗依文獻列出每個問題、現在的值 → 建議的值，以及為什麼：

• 有把握的修正（機械式、不需要判斷）先勾好；請確認的（要你看原文才知道）沒有勾；要你補上的只告訴你去哪裡找，沒有勾選框。
• 按 套用勾選的修正 才寫回 Zotero（每篇一次交易）；取消或 Esc 什麼都不改。視窗開著時你在 Zotero 改過的欄位，套用時會跳過。
• 想反悔：ZotMax 按鈕或快速指令 → 復原上一次中文文獻修正。只能復原最後一次；之後你又自己改過的欄位會保留新值。
• 右側面板的「狀態」：中文文獻有要檢查的地方時，會多一行「中文資料：3 個地方要檢查」和「檢查並修正…」按鈕；沒有問題就不出現。同步時不會自動檢查，也不會自動改任何東西。

檢查什麼	例子	建議	預設
幾位作者擠在同一格	「陳美玲、林小華」（、；，分隔）	拆成每人一筆（單一欄位、完整姓名）	勾
同上，但用空白分隔	「陳美玲 林小華」	拆開（也可能是一個人）	不勾
姓名有空白	「陳 美玲」	「陳美玲」	勾
姓、名前後顛倒	名「陳」姓「美玲」	姓「陳」名「美玲」	勾（兩邊都像姓時不勾）
複姓被拆錯	姓「歐」名「陽志明」	姓「歐陽」名「志明」（也可能姓歐）	不勾
中文姓名混英文拼音	「陳美玲(Chen, Mei-Ling)」	只留「陳美玲」；拼音先以 original-author: Chen || Mei-Ling 記在「其他」欄（分不出姓和名時照原樣記；已記過就不重複）	不勾
民國年	「民國112年」「112年4月」	「2023」「2023-04」（沒有「年」字的 112/04/01 不勾）	勾
卷期寫在一起	卷「70(2)」「第70卷第2期」	卷「70」期「2」（期數欄已有不同的值時不勾）	勾
頁碼	「４５－５６頁」「p. 45~56」	「45-56」	勾
DOI 不在 DOI 欄或格式不對	只在「其他」欄（DOI: 10.6224/…）或網址裡（https://doi.org/10.3966/…）；DOI 欄前面多了 https://doi.org/、結尾多了句點	填進 DOI 欄，只留 10. 開頭的部分（華藝 DOI 裡的括號保留）	勾
語言	空白、zh、Chinese、中文、zh_TW	zh-TW（篇名是簡體字時建議 zh-CN、不勾）	勾
篇名	結尾句點、前後空白、中文之間的半形「:」	拿掉／改全形「：」	勾
篇名後面接英文篇名、篇名中間有空白	「題目 The Effect of…」「主標題 副標題」	只留中文／改成「：」	不勾
期刊名	「《護理雜誌》」	「護理雜誌」	勾
中英文期刊名擠在一起	「護理雜誌 The Journal of Nursing」	「護理雜誌」	不勾
學位論文被匯入成期刊文章	網址是 hdl.handle.net/11296/…、期刊名寫「…碩士論文」	改成學位論文（期刊名、卷期欄會清空）	不勾
缺卷期頁、缺年份、缺學位類別、缺校名	—	不會自動填，只告訴你去哪裡找（華藝文章頁、期刊目次、PDF 頁首、論文封面）	沒有勾選框
英文文章的語言標成中文	英文篇名，語言 zh	en（語言是中文時，Word 的「APA 7 中英混排」會用中文格式）	不勾

不會做的事：這個版本不連網查資料，也不呼叫 AI；找不到的資料不會猜。姓名在 Zotero 裡用「姓／名分欄」或「單一欄位」都可以，中文 APA 都會寫成完整姓名，所以不算問題。

整理

• 文獻自動分類：依研究設計／證據等級、你列的主題、你寫的規則和 PICO，建議把文獻放進哪些 Zotero 子分類（例如 自動分類/研究設計/RCT）。每項建議標明來源與信心，你勾選後按「套用」才寫進 Zotero；只會新增子分類和加入文獻，不會移出文獻或改你原本的分類。ZotMax 按鈕或快速指令 → 復原上次分類 可以整批復原。主題要 AI 判斷（「AI 主題分類」開關）。→ 工具列「整理」、條目或分類右鍵、設定 → 整理 → 文獻自動分類
• 研究儀表板：Obsidian 裡一頁 01 研究儀表板.md，看閱讀進度、證據等級分布、待讀最久與資料待補的文獻、回顧專案的 PRISMA 篇數、AI 用量和本週新增。只讀 vault，不連網、不花錢。→ ZotMax 按鈕或快速指令 → 更新研究儀表板（預設手動同步後也會更新）
• Obsidian 資料夾結構：文獻筆記依 Zotero 分類放在 10 文獻/<分類>/，全文緊跟在旁邊，概念、評讀與綜整、寫作各有編號資料夾；在 Zotero 換分類，下次同步筆記跟著搬。舊版（0.22 以前）的 vault 用 整理 Obsidian 資料夾結構… 一次搬好，連結全部更新。見下方。
• 首頁與主題頁：和研究儀表板一起產生。00 首頁.md 是 vault 的入口：「從這裡開始」（繼續閱讀、待核對的評讀、最近加入）、總覽數字卡、每個 Zotero 分類一張主題卡（篇數、已讀、證據說什麼、最強證據、趨勢、下一步）和快速入口；每個分類的資料夾第一個檔是主題總覽 00 <分類> 總覽.md，整理這個主題的證據方向、研究趨勢和研究缺口，旁邊還有一張「證據地圖」Canvas。有子分類的主題是一顆星球、子分類是島，看每座島的開發度和缺口，還有一張可在瀏覽器打開的群島地圖。見下方。
• 概念卡片：把 AI 筆記「關鍵概念」裡的 [[概念]]（也可加上測量工具、結果指標）整理成 Zotero/20 概念/ 的卡片：別名、MeSH／PubMed 連結、提到它的文獻表、常一起出現的概念，加上「概念索引」與 Mermaid 關係圖。→ ZotMax 按鈕或快速指令 → 更新概念卡片、設定 → 整理 → 概念卡片（Obsidian）
• 全文筆記：每篇文獻旁緊跟著一份 <同檔名> · 全文.md，由 Zotero 已抽出的文字整理成 Markdown（接回斷字、分段、標出 Abstract／Methods／Results 等段落、去掉頁首頁尾），你的劃線依顏色標在原文。它每次同步都重新產生，想法請寫在文獻筆記。→ 設定 → 整理 → 全文筆記
• 劃線顏色有意義：Zotero 的 8 種劃線顏色各代表一種意義（預設黃＝重要發現、紅＝限制／疑問…），筆記裡的劃線依意義分組。→ 設定 → 整理 → 劃線顏色與意義

怎麼開始：條目或分類右鍵 → ZotMax ▸ 文獻自動分類（所選文獻或目前分類）…（分類含子分類）；或 ZotMax 按鈕或快速指令 → 同一項。

確認視窗：每篇列出建議的子分類（核取方塊），每一項寫出來源與信心，例如「規則推測・高｜標題有「randomized」」「AI 筆記・中｜AI 筆記的證據等級，請對照原文確認」「你的規則・高｜符合第 2 行：…」。信心高的和規則符合的先勾好，信心低的先不勾。下方即時顯示「已勾選 N 項：會建立 X 個子分類，加入 Y 筆」。按 套用 才寫進 Zotero；按取消（或 Esc）什麼都不改。

放在哪裡：預設在文獻庫最上層建立 自動分類，底下依面向分資料夾：

自動分類/
  研究設計/   RCT、Quasi-experimental、Cohort、Case-control、Cross-sectional、Qualitative、Mixed methods、
              Systematic review & meta-analysis、Scoping review、Guideline、其他設計
  證據等級/   CEBM Level 2、JBI Level 1.c …
  主題/       你列的主題
  規則/       你寫的規則名稱
  族群 P/、介入 I/、結果 O/

上層名稱和位置可以改（例如放在 碩論/文獻回顧 底下；找不到時確認視窗會說明並改放最上層）。名稱相同（不分大小寫、全半形）的子分類會沿用，同一篇可以在好幾個子分類裡。

四個面向（各自可在設定關掉）：

• 研究設計與證據等級：有 AI 筆記就用它的結構化資料，不另外花錢。沒有時從 Zotero 標籤與 Extra（例如 PubMed 的 Publication Type；MeSH 的「… as Topic」不算）、標題、摘要找設計的關鍵字，標「規則推測」：標籤與標題信心高；摘要只有一種設計信心中，提到好幾種信心低、不先勾。證據等級只取自 AI 筆記，不用猜的。

• 自訂主題（要打開「AI 主題分類」，會產生費用）：一行一個主題，冒號後可寫說明或關鍵字，例如 跌倒預防: 跌倒、fall prevention、hip protector。AI 只看標題、摘要和一句話摘要，一次判斷 10 篇；送出前顯示篇數、呼叫次數與預估費用，可以「用 AI 判斷主題」「跳過主題，只看其他建議」或「取消分類」。清單外的主題會被忽略並告訴你。沒開開關、沒有 API key 或 AI 失敗時，確認視窗最上方寫明原因，其他面向照常。

• 規則（不用 AI，結果每次都一樣）：一行一條 子分類名稱 = 條件：

  跌倒 = title:falls OR tag:跌倒
  近五年 RCT = year>=2021 AND (title:randomized OR tag:"Randomized Controlled Trial")
  中文文獻 = language:zh
  非質性 = NOT (title:qualitative OR abstract:質性)
  

  • 欄位：title:、abstract:、journal:、author: 包含這個字就符合；tag: 要完全相同，結尾加 * 比對開頭（tag:篩選/*）；year>=2020、year<2015、year=2020、year:2018-2022；language:zh（沒填語言但標題是中文也算）、language:en；type:journalArticle、type:thesis 或 type:學位論文。也可以用中文欄位名：標題、摘要、標籤、期刊、年份、語言、類型、作者。
  • 不寫欄位的字詞在標題和摘要裡找；有空格的詞用引號（"fall prevention" 或「」）。不分大小寫和全半形。
  • NOT 先算，再 AND，最後 OR；不確定就加括號。兩個條件中間沒寫運算子就是 AND。# 開頭的行是註解。
  • 設定頁即時檢查，寫錯的行會標出「第 N 行：少了右括號 )」這類說明；執行時略過並提醒。

• PICO：取自 AI 筆記的族群 P、介入 I、結果 O（以頓號、逗號拆開，沒有 outcomes 時用 measures）。不同寫法會合併，並沿用 設定 → 整理 → 概念卡片 的「同義詞合併」。只有一篇用到、又沒有同義詞或既有子分類的說法先不勾，免得子分類太零碎。沒有 AI 筆記的文獻沒有 PICO 建議。

復原：ZotMax 按鈕或快速指令 → 復原上次分類 把最後一次套用加入的文獻從那些子分類移出，並刪除那次新建、現在又是空的子分類（你後來放了東西的會保留並告訴你）。只能復原最後一次；關掉「文獻自動分類」後仍然可以用。

看板版（預設）一打開是「總覽」「圖表」「待處理」三排卡片，下面這些完整的表格收在摺疊區塊裡；精簡版照舊一段一段排開。只用 Obsidian 內建功能（Mermaid、Bases、連結），不需要 Dataview。不想手動同步後自動更新：設定 → 同步 → Obsidian，取消「手動同步後更新『研究儀表板』筆記」（自動同步不會更新它）。

• 📖 閱讀進度：各狀態篇數與比例、已讀完成率（已讀 + 已引用）、各分類的完成率；看板版在「圖表」用一排狀態色塊（⬜ 待讀、🟨 閱讀中、🟩 已讀、🟦 已引用），精簡版是圓餅圖
• 🔬 證據概況：研究設計、證據等級（CEBM 與 JBI）、評讀結果的分布；還沒有 AI 筆記的篇數；全文狀態（none／partial 是掃描檔，建議先 OCR）
• 🗺️ 證據缺口地圖（evidence gap map）：列是介入（I）、欄是結果指標（O），取自各篇 AI 筆記的 PICO；每格是篇數的熱度方塊（⬜ 沒有研究、🟨 1 篇、🟧 2–3 篇、🟥 4 篇以上）和最強的 CEBM 等級。⬜ 的組合可能就是研究缺口；下面列出證據最多的 5 個組合和連結。名稱只做字面合併，同一件事寫法不同（「運動」「Exercise」）時，到 設定 → 概念卡片 → 別名 合成一組，地圖也會跟著合併。這是字詞層級的整理，不是系統性回顧。
• 📝 待處理清單：待讀最久的 10 篇（看板版另有「待處理」卡片，各列 5 篇）；資料待補的文獻：沒有 AI 筆記、掃描檔、期刊文章缺 DOI、中文作者姓名可疑（例如「陳, 美玲」，通常是 Zotero 作者欄要修正）
• 🗂️ 回顧專案：30 評讀與綜整/ 的 PRISMA 筆記與 40 寫作/文獻探討/ 的草稿
• 🧠 熱門概念：文獻數最多的 10 張概念卡片
• 🤖 AI 用量：本月與前兩個月的呼叫次數、tokens 與估計費用
• 🆕 本週新增：最近 7 天加入的文獻（看板版在「待處理」的卡片裡）
• 開頭連到最新一份進度報告。

只改寫 %% zotero-bridge:start/end %% 之間，區塊上方的研究目標、「✍️ 我的筆記」和你的 frontmatter 都保留。

Obsidian 資料夾結構

從 0.23.0 起，vault 裡的檔案依 Zotero 分類整理，資料夾加上編號，在檔案總管裡依閱讀順序排列：

Zotero/
├─ 00 首頁.md                    ← 從這裡開始
├─ 01 研究儀表板.md
├─ 10 文獻/
│  ├─ 碩論/
│  │  └─ 跌倒/                   ← 和 Zotero 的分類一樣
│  │     ├─ 00 跌倒 總覽.md       ← 主題頁
│  │     ├─ 00 跌倒 證據地圖.canvas
│  │     ├─ lee2024.md           ← 文獻筆記
│  │     ├─ lee2024 · 全文.md     ← 全文緊跟在旁邊
│  │     └─ 附件/                 ← 圖片劃線
│  └─ 未分類/
├─ 20 概念/                      ← 概念卡片與概念索引
├─ 30 評讀與綜整/                 ← PRISMA、PICO 表、GRADE、評讀總表、引文追蹤、文獻比較/
├─ 40 寫作/                      ← 文獻探討/（草稿）、進度報告/
├─ 50 新文獻/                    ← PubMed 每日清單
└─ 90 系統/                      ← .base 總表、references.json、整理紀錄

• 放在哪個分類：一篇在好幾個分類時，放在最深的那個（同時在 碩論 和 碩論/跌倒 → 碩論/跌倒），一樣深就依中文排序取第一個；其他分類的主題頁會連過去。沒有分類的放 未分類。有設定分流規則（設定 → 同步 → 分流規則）且規則指定了 Obsidian 資料夾的，照規則放。
• 在 Zotero 換分類：下次同步時，筆記連同全文和圖片搬到新分類的資料夾，所有指向它的連結（包含你自己的筆記、Canvas、書籤）一起更新，空掉的資料夾會刪掉。你自己搬到 10 文獻 以外的筆記不會被搬回來。
• 文獻筆記最上面的導覽列：🏠 首頁 › 碩論 › 跌倒，下一行「跳到：劃線 · 評讀表 · AI 筆記 · 摘要 · 全文 · ✍️ 我的筆記」，點了就捲到那一段（收合的段落點開即可）。
• 舊版的 vault（0.22 以前同步的）：升級後維持原本的平鋪結構，什麼都不會自己搬。準備好時：ZotMax 按鈕或快速指令 → 整理 Obsidian 資料夾結構…（或 設定 → 同步 → Obsidian →「整理 vault 資料夾…」）。
  1. 先列出要搬幾個檔案（文獻筆記、全文、圖片、首頁與儀表板、主題頁、概念與評讀、系統檔），按確定才搬。建議先關閉 Obsidian，搬完再打開。
  2. 只搬 ZotMax 產生的檔案；你自己放在 Zotero/ 裡的筆記、分流規則的資料夾都留在原處，目標位置已有同名檔案的也不搬。
  3. 整個 vault 裡指向這些檔案的 [[連結]]、![[嵌入]]、Markdown 連結、Canvas 卡片和書籤都改成新位置；你寫的內容不會被改動。
  4. 紀錄存在 90 系統/整理紀錄 <日期時間>.md，每個檔案的原位置與新位置都在裡面，要還原可以照表搬回，再到設定把資料夾結構改回「舊版平鋪」。看板版的紀錄上面是搬動、更新連結、沒有搬動的數字卡和依類型的長條，搬動清單收在摺疊區塊。
• 不想換：設定 → 同步 → Obsidian →「資料夾結構」選「舊版平鋪」，一切照舊。

首頁與主題頁

每個有筆記的 Zotero 分類有一頁主題頁，再用一頁首頁把它們串起來，ZotMax 依每篇筆記 frontmatter 的 collections 產生。只讀 vault、不連網、不呼叫 AI，和研究儀表板一起更新（不要的話：設定 → 同步 → Obsidian，取消「一起產生『首頁』和每個 Zotero 分類的『主題頁』」）。

00 首頁.md

• ▶️ 從這裡開始：三張卡片，打開 Obsidian 就知道下一步：繼續閱讀（閱讀中的文獻；沒有的話是最新的待讀）、待核對的評讀（AI 初評還沒對照原文核對的）、最近 14 天加入。每張最多 5 篇。
• 總覽：文獻、已讀完成率、AI 筆記、評讀已核對四張數字卡（看板版）。
• 🪐 我的星球（還沒有星球時，告訴你星球從哪裡來、可以對哪個分類用「建造星球」）：每顆星球一張卡片：幾座島、篇數、已讀、各等級幾座島（🏙️ 2 · 🏘️ 1 · 🌱 1）、最需要開墾的島和它還差什麼、🎯 本週任務完成幾項，附星球 Canvas 和群島地圖的連結。
• 主題卡：每個分類一張，依篇數排序（最多 12 張，其餘列在下面）：篇數與已讀比例、🧭 證據說什麼（例如「多數有效（5／7）」）和最強的 CEBM 等級、📈 近 5 年篇數與趨勢箭頭、➡️ 最該做的下一步。卡片標題連到主題頁。精簡版是一張表格。
• 快速入口：一排按鈕：研究儀表板、回顧專案（PRISMA、PICO 表）、概念索引、最新進度報告、文獻總表。
• 想一打開 Obsidian 就看到首頁：把它加入書籤（Bookmarks），或用 Homepage 社群外掛設成首頁。

00 <分類> 總覽.md（在分類自己的資料夾裡，例如 10 文獻/碩論/跌倒/00 跌倒 總覽.md；舊版平鋪結構是 主題/碩論／跌倒.md）

• 看板版一打開：上面是「前往」按鈕（首頁、研究儀表板、證據地圖）和「主題總覽」四張數字卡（文獻篇數、已讀、最強證據、證據說什麼）；接著是「證據」卡片：結論方向色塊（🟩 有效、🟦 無差異、🟥 有害、🟧 不一致、⬜ 未判定，每格一篇）、依介入的色塊、各年研究量、證據等級最高的 5 篇；再來是「研究缺口與下一步」和證據缺口地圖。下面這些完整的表格收在摺疊區塊裡；精簡版照舊一段一段排開。
• 🧭 證據說什麼：各篇 AI 筆記判斷的結論方向（有效／無差異／有害／不一致）合計，和「依介入」的分表（每個介入有幾篇有效、幾篇無差異、最強證據等級）。結論方向取自 AI 筆記的新欄位 effect_direction；舊的 AI 筆記沒有這個欄位，會算在「未判定」，重新產生 AI 筆記後就有。
• 📈 趨勢：近 5 年和再往前 5 年的篇數比較（↑ 上升、→ 持平、↓ 下降）、各年篇數、常見的介入和結果指標。
• 🕳️ 研究缺口與下一步：依規則列出：還沒有 AI 筆記、還沒有 RCT 或系統性回顧、已有多篇 RCT 卻沒有系統性回顧（可能是寫回顧的機會）、結論分歧、還沒有研究的介入 × 結果組合、最新研究已超過 5 年、樣本數偏小、評讀還沒核對、待讀；下面是這個主題的證據缺口地圖。
• 📚 文獻：每篇的年份、研究設計、證據等級、結論方向、閱讀狀態，證據最強、最新的在前。
• 🗺️ 證據地圖（00 <分類> 證據地圖.canvas，主題頁上方有連結）：Obsidian Canvas，主題頁在最上面，下面依結論方向（有效、無差異、有害、不一致、未判定）分成彩色群組，每篇一張卡片：研究設計、樣本數、證據等級、閱讀狀態、介入與結果，點標題打開筆記。每次更新會重新排列；你在 Canvas 上加了自己的卡片後，ZotMax 就不再覆寫它（想自己排，另存一份）。設定 → 同步 → Obsidian 可以關掉。
• 分類改名或刪除後，舊的主題頁不會被刪，只會標示「目前沒有文獻筆記」，你的筆記保留。

🪐 星球與島嶼

一個研究主題是一顆星球，它的 Zotero 子分類是島：用來看每個子題的進度、找缺口。有兩個以上（含）有文獻筆記的子分類，那個分類就是星球；和主題頁一起更新，只讀 vault、不連網、不呼叫 AI。不要的話：設定 → 同步 → Obsidian，取消「主題頁加上星球與島嶼」。

• 🏗️ 建造星球：分類還沒有子分類時，在分類上按右鍵 → ZotMax ▸ 建造星球：把這個分類分成島（目前分類）…。ZotMax 依這些文獻 AI 筆記的介入（依概念卡片的別名合併）和 Zotero 標籤（PubMed 的 MeSH、關鍵詞）建議分成幾座島：每次挑能涵蓋最多「還沒分到島」文獻的詞（至少 2 篇；幾乎每篇都有的詞是主題本身，不當島；Humans、Aged 這類檢查標籤不算），最多 6 座。視窗裡可以取消勾選、改名；確定後建立子分類、把文獻加入（不會從原分類移出），再把這些筆記重新同步到 Obsidian（不呼叫 AI）並更新研究儀表板，星球就出現了。不滿意：快速指令 → 復原上次建造星球（收回那次加入的、刪掉又變空的子分類）。

• 文獻自動分類放建議的「自動分類」資料夾不算島，也不會變成星球。

• 開發度＝已讀 40% ＋ 評讀已核對 30% ＋ 有 AI 筆記 30%（以島上的篇數計）：🌱 荒島 <25、🏕️ 開墾中 25–49、🏘️ 聚落 50–74、🏙️ 城鎮 ≥75（LV1–4）。子分類底下更深的分類，算在同一座島。

• 升級提示：每座島都算出升到下一階最少要做什麼，例如「⬆️ 再讀 2 篇、補 1 篇 AI 筆記 → 🏘️ 聚落」（先算讀文獻，再算 AI 筆記、核對評讀）；已是城鎮的島提示你去補缺口。

• 星球的主題頁多一個「🪐 星球」看板：每座島一張卡片（階段、開發度長條、篇數／已讀／核對／AI、升級提示、最強證據、這座島的缺口），加上 🌊 未探索海域和 ⛵ 港口（搜尋機器人待看幾篇）。分類本身沒有筆記、文獻都在子分類的，也會有一頁整顆星球的主題頁。精簡版是一張表格。

• 📝 文獻探討大綱（依島）（星球主題頁的摺疊區塊）：每座島一個小標題（篇數、研究設計、結論方向），下面是這一段要回答的問題和先讀、先引用的 3 篇（證據等級最高、較新的先）。問題依規則產生，例如結論分歧時「結果為什麼不一致？比較族群、介入劑量和測量工具」，證據最高只到 CEBM 3 時「要說明證據強度有限」，有缺口時「為什麼重要？誰會在乎？既有研究背後有什麼你不同意的假設？」（不只找沒人做過的，也挑戰既有假設；Sandberg & Alvesson, 2011）。ZotMax 只列問題和文獻，段落由你寫。

  • 主張鷹架（0.39.0，預設開啟）：每座島第一題是「✍️ 這一段你的主張是什麼？」，請用一句話寫在星球主題頁最下面的「✍️ 我的筆記」（大綱裡有連結；大綱每次更新都會重寫，寫在那裡才留得住）。
  • 🧭 方向（AI 初判）：島上的研究依 AI 筆記的結論方向分組（有效、無差異、有害、不一致、未判定），每組最多列 4 篇（證據等級高的先），標出 CEBM 等級和「已核對」，其餘寫「另 n 篇」。
  • 已核對的研究怎麼說：評讀表勾了「我已核對」、且有結論方向的研究至少 2 篇，它們最多的方向只有一個，而且不是其他研究最多的方向時，多問一題「品質較好的研究怎麼說？」，並列出兩邊的篇數。
  • 證據確定性：大綱最上面一行。星球的分類有 GRADE 證據確定性表時，列出每個結果指標的確定性（例如「跌倒發生率 ⊕⊕◯◯ 低」；還沒評升降級的標「起始等級」，沒勾研究的標「尚未評等」）；沒有時提醒「CEBM 等級是研究設計，不是證據確定性」，確定性要用 GRADE 判斷。
  • 你的情境：PICO 問題卡填了「我的情境」時，最上面多問一題「這些研究的場域和你的有什麼不同（護病比、病人特性、健保給付）？結果能套用到你的場域嗎？」（Burchett et al., 2011）；群島地圖的島嶼面板每座島都列這題。
  • 只提問、不代寫。不要的話：設定 → 同步 → Obsidian，取消「星球的「文獻探討大綱」加上主張鷹架…」，大綱就回到只有規則問題和先讀文獻。

• 島的主題頁在「前往」多一顆「🪐 回到星球「跌倒」（這座島 LV2 🏕️ 開墾中）」。

• 🎯 本週任務：每週一，ZotMax 從最需要開墾的島（還不是城鎮的，開發度最低的先）挑 2–4 件具體的事，例如「讀完《Wang 2025 藥師主導的用藥審查》」「補 AI 筆記《Hsu 2024》」「核對評讀《Chen 2023》」。挑的是升級提示需要的步驟，同一步驟先挑證據等級高、較新的文獻；核對評讀只挑已經填好評讀表的。

  • 一整週不換；你在 Zotero 改成已讀、產生 AI 筆記、評讀表勾「我已核對」後，下次更新研究儀表板就自動打勾 ✅（不用回 Obsidian 勾）。
  • 出現在星球主題頁（🎯 本週任務 卡片）、首頁的星球卡（🎯 本週任務 1／3）、群島地圖（有任務的島插一面橘色小旗，面板列出任務、點標題開筆記）；完成的會記進島嶼日誌和進度報告。

• 🪐 星球 Canvas（00 <分類> 星球.canvas，看板上有連結）：同一顆星球放進 Obsidian，手機也能看。中間是研究問題，每座島一個彩色群組（綠 LV1、橘 LV2、藍 LV3、紫 LV4），卡片寫開發度、升級提示和缺口，點島名進島的主題頁；橋是有標籤的連線，旁邊是未探索海域和港口。你在上面加了自己的卡片後，ZotMax 就不再覆寫它。

⚠️ 「證據說什麼」是 AI 初判：「有效」只代表主要結果有統計上顯著的差異，不等於臨床上有意義，也不代表證據確定性高。寫進報告前請回原文核對，再用 GRADE 判斷整體證據確定性。

研究儀表板.base（勾選「建立 Zotero 文獻庫.base」時一併建立，也在 90 系統/）：「證據等級表」（依研究設計分組）、「掃描檔待 OCR」、「待讀（依分類）」。只在不存在時建立，可以自由修改；想恢復預設就刪掉它。也可以用 ![[研究儀表板.base#證據等級表]] 嵌入其中一個檢視。

• 從哪裡來：只看文獻筆記自動區塊裡「關鍵概念」的 [[…]]（你在「✍️ 我的筆記」寫的連結不算）；預設也把測量工具（measures）做成卡片，可選擇加上結果指標（outcomes）。只讀 vault，不連網、不呼叫 AI；沒有任何概念時不建立檔案。

• 同一個概念的不同寫法：全形／半形、大小寫、空白與連字號視為同一個；卡片名稱用最常出現的寫法。中英文或同義詞在「同義詞合併」一行寫一組，第一個是卡片名稱：

  跌倒 = Accidental Falls = falls
  自我效能 = Self-efficacy
  

  其他寫法寫進卡片的 aliases，所以 [[falls]] 也會連到「跌倒」。

• 卡片內容：類型（概念／測量工具／結果指標）、文獻數、年份範圍、MeSH 與 PubMed 連結、提到它的文獻表（研究設計、證據等級、一句話摘要）、常一起出現的前 10 個概念。frontmatter 有 type: "concept"、papers、aliases，可以用 Bases 篩選。

• 概念索引（20 概念/概念索引.md；舊版平鋪結構是 概念/）：全部概念依文獻數排序，加上前 15 個概念的 Mermaid 關係圖。

• 看板版（預設）：卡片和索引跟文獻筆記同一套樣式。卡片最上面是「前往」按鈕（概念索引、MeSH、PubMed、Google Scholar），接著是「概念總覽」：文獻篇數、最強證據、研究設計和常一起出現的概念長條、證據等級最高的 5 篇；完整的文獻表收在摺疊區塊。屬性區只留別名和你自己加的屬性。索引是概念數、依類型、出現最多的前 10 名和關係圖，全部概念的表格摺起來。

• 你的內容不會被覆寫：新卡片有「📖 我的定義」與「✍️ 我的筆記」兩段；aliases 只增不減。你先建的同名筆記會在第一個標題下方加上自動區塊。

• 卡片不會被刪除：沒有文獻再提到的概念，卡片改成「目前沒有文獻筆記提到這個概念」，papers 設為 0，要不要刪由你決定。

• AI 綜整（「概念卡片 AI 綜整」開關，會產生費用）：ZotMax 按鈕或快速指令 → 為概念卡片產生 AI 綜整… → 選一個概念（至少 2 篇）→ 確認預估費用。AI 讀這些文獻的 AI 筆記（最多 30 篇，最新的優先），寫「定義與內涵、測量方式、相關因素與介入、研究結果的一致與分歧、研究缺口」。和文獻探討草稿一樣只能用 [S#] 代號引用、數字對不上的列在「⚠️ 查核清單」。結果放在「🤖 AI 綜整（草稿）」區塊。提示詞可在 Zotero 進階設定（Config Editor）的 extensions.zotero-bridge.concepts.aiPrompt 改。

• 設定（設定 → 整理 → 概念卡片（Obsidian））：手動同步後是否更新、卡片資料夾（預設 概念，新的資料夾結構放在 20 概念/；改成別的名稱就照你填的）、測量工具／結果指標是否做成卡片、同義詞合併。

• vault 裡其他地方已有同名筆記時，[[Self-efficacy]] 可能連到那一份；卡片本身用完整路徑連結。

• 檔案：和文獻筆記同一個資料夾，檔名多 · 全文（舊版平鋪結構是 全文/ 子資料夾，名稱可改），最上面有提示框並連回文獻筆記（看板版是一條「← 文獻筆記」導覽列加劃線圖例，沒有屬性區，行距放寬好讀；對不上的劃線收在最後的摺疊區塊）；文獻筆記的 frontmatter 有 fulltext: "[[Zotero/10 文獻/碩論/lee2024 · 全文]]"。它沒有 zotero_key，不會出現在 Bases 總表、儀表板與概念卡片。文獻筆記改名時跟著改名；同名但不是外掛產生的檔案不會被覆寫。
• 怎麼轉成 Markdown：用 Zotero 已抽出的全文，不用另外裝東西。接回行尾斷字（interven- tion → intervention，self-reported 這類保留連字號）、跨頁段落接回、整行是段落名稱的才當標題（Abstract、Background、Methods、Results、Discussion、Conclusion(s)、Limitations、References、Acknowledgements、Funding、Conflict of interest；摘要、前言、緒論、研究方法、結果、討論、結論、研究限制、參考文獻、誌謝），刪掉多頁重複的頁首／頁尾和頁緣頁碼。不確定的就保留。
• 劃線標在原文：依顏色標成 ==🟡…==，比對時忽略換行、斷字與少數字的差異；對不上的（跨頁、圖表裡的字、掃描檔）列在檔案最後，不會遺失。
• 送給 AI 的全文：產生 AI 筆記時改送這份 Markdown，並先刪掉 References、Acknowledgements、Funding、Conflict of interest（設定可關；印在參考文獻後面的表格與圖保留）。進度視窗會顯示省下多少（見隱私與費用）。
• Notion 全文子頁面（預設關閉）：在文獻頁面底下建「全文：標題」子頁面，劃線變成對應的底色。一篇通常要 5–10 次 API 請求，同步會變慢；內容有變時舊子頁面移到垃圾桶、建新的（連結會變）。
• 快取：依附件、修改時間與大小快取在 Zotero 資料夾的 zotero-bridge/fulltext/，重新同步不會重做。
• 掃描版 PDF：沒有文字層就沒有全文筆記，先 OCR。

markitdown（選用）：markitdown 是 Microsoft 的開源轉換工具，要自己安裝（pip install 'markitdown[pdf]'），然後在 設定 → 整理 → 全文筆記 →「選用：用 markitdown 轉換 PDF」填執行檔路徑（只填 markitdown 會在 PATH 裡找）。老實說它能幫的有限：表格、表單類的頁面會保留成 Markdown 表格，其餘頁面輸出純文字；一般論文的段落標題它不會標（仍由外掛偵測），掃描檔也不會 OCR。執行失敗、超過 2 分鐘或輸出超過 8 MB 時自動改用內建轉換，進度視窗會說明（同一個檔案不會每次重試）。

顏色	預設意義
🟡 黃	重要發現
🔴 紅	限制／疑問
🟢 綠	研究方法
🔵 藍	可引用句
🟣 紫	定義／概念
🟠 橘	待查證
🩷 洋紅	我的想法
⚪ 灰	其他

可以改名稱（最多 40 字）、用「上移／下移」排順序、「恢復預設」。每組一個區塊（例如「🟡 重要發現（3）」；看板版和 Notion 放在「我的劃線與筆記」摺疊區塊裡，精簡版各自摺疊），保留頁碼連結、評註與標籤；「重點」裡的「我的劃線」依同一個順序挑選。Obsidian 只有 6 種螢光筆顏色，洋紅顯示成紫色、灰色用預設顏色；Notion 轉成對應的背景色。不在這 8 色裡的顏色歸到「其他顏色」。

找文獻

• 醫學文獻快速搜尋：內建 PubMed、Cochrane、CINAHL、Embase、Google Scholar、華藝、臺灣博碩士論文等 24 個資料庫（可自訂、可設學校的 EZproxy）。出現在四個地方：條目右鍵 ZotMax ▸ 在醫學資料庫搜尋（找這篇、PubMed 相似文獻）、右側面板的搜尋連結與 PICO 檢索連結、筆記的「🔎 延伸搜尋」（找這篇、MeSH、PICO 檢索式），以及 ZotMax 按鈕或快速指令 → 醫學文獻快速搜尋…（輸入關鍵字，英文會建議 MeSH 主題詞）。檢索式還是你自己決定。→ 設定 → 醫學文獻快速搜尋
• PubMed 新文獻追蹤（研究生引導預設關閉）：存好 PubMed 檢索式（可用 MeSH），手動或定期把新文獻用 Zotero 內建匯入器匯入指定分類，不會重複匯入，並在 Obsidian 產生每日清單。→ ZotMax 按鈕或快速指令 → 檢查新文獻（PubMed 追蹤）、設定 → PubMed 新文獻追蹤
• 引文追蹤（研究生引導預設關閉）：從納入研究用 OpenAlex（免費；API key 選填）往回查參考文獻、往前查引用它的文獻，去重後列成 Obsidian 勾選清單與 CSV；只列候選，不自動匯入，勾選的再一鍵匯入。→ 工具列「找文獻」、分類右鍵 → ZotMax：引文追蹤
• 主題搜尋機器人（研究生引導預設關閉）：主題確定之後，把它變成自己的文獻搜尋機器人。存好檢索式（預設取自 PICO 問題卡）和幾篇核心文獻，機器人每天查 PubMed、每週查「引用核心文獻的新研究」，依你的 PICO 打分數並寫出理由，列成 Obsidian 勾選清單；只有你勾選的才匯入，不用 AI。→ 分類右鍵 → ZotMax ▸ 主題搜尋機器人：建立或修改
• 網頁版搜尋：bobyu89.github.io/ZotMax/search.html，不用 Zotero、手機也能用，含 PICO 檢索式產生器。

1. 條目右鍵 → ZotMax ▸ 在醫學資料庫搜尋：找這篇在各資料庫的紀錄。

• PubMed：有 PMID（Extra 的 PMID: …）直接開該篇；沒有用 DOI；再沒有用題名的每個字（Hospital[ti] AND nurse[ti] …，最多 10 個字）。整句題名加引號在 PubMed 只比對片語索引，實測找不到原文，所以不用。
• Europe PMC 用 PMID／DOI／題名；CINAHL 用 TI "題名"；其他用加引號的題名。有 PMID 時多一項 PubMed 相似文獻。
• 選單只列前 8 個（可改），其他在「更多資料庫…」，可以連續開好幾個。中文題名只列中文與跨語言的資料庫。

2. 右側面板：ZotMax 面板的「延伸搜尋」有搜尋連結一列；有 AI 筆記且有 PICO 時，下一列是 PICO 檢索連結（PubMed、CINAHL、Google Scholar）和「複製檢索式」。

3. 筆記的「🔎 延伸搜尋」（收合區塊，Notion 也有）：找這篇、相似文獻、MeSH（從 PubMed 匯入的 MeSH 標籤，連到 MeSH Database 與 "主題詞"[Mesh] 搜尋；Humans、Aged 這類檢查標籤略過）、PICO 檢索式（P AND I AND O，同一欄多個詞用 OR，設定可加入 C）。AI 筆記的 PICO 是中文（術語保留英文），所以英文檢索式只取英文詞，缺的欄位會提醒你補；另有中文原樣的版本連到 Google Scholar。

4. ZotMax 按鈕或快速指令 → 醫學文獻快速搜尋…：輸入關鍵字（不同概念用逗號分隔，例如 fall prevention, older adults），選資料庫開啟，開完回到清單。

• 英文關鍵字：先向 NCBI 查 MeSH 建議，例如 falls, older adults 組成 ("Accidental Falls"[Mesh] OR falls[tiab]) AND ("Frail Elderly"[Mesh] OR "Aged"[Mesh] OR "older adults"[tiab])；可以「複製 PubMed 檢索式」或「存成 PubMed 新文獻追蹤」。查不到時用原本的關鍵字。
• 中文關鍵字：華藝、博碩士論文、國圖期刊、衛福部／國健署排前面。
• MeSH 建議只是起點，請到 MeSH Database 看 Scope Note 與樹狀結構確認。「主題＋目的」的片語（fall prevention）常查不到，改用核心詞（falls）就會對到 Accidental Falls。

範例

• 寫實證報告：pressure injury, repositioning → 先開 PubMed（MeSH 檢索式），再開 Cochrane、CINAHL、TRIP，最後存成 PubMed 追蹤。
• 中文文獻：壓力性損傷 翻身 → 選華藝，在開啟的頁面貼上（Ctrl+V／⌘V）；再選臺灣博碩士論文系統。
• 讀到好研究：在筆記展開「🔎 延伸搜尋」→ 點 PICO 的 PubMed 連結或「相似文獻」。

• 資料庫順序：ID 以逗號分隔，例如 pubmed, cinahl, cochrane, airiti, scholar。隱藏的資料庫：例如 embase, uptodate。設定頁下方列出所有 ID 與狀態。

• 自訂資料庫（JSON 陣列）：name、url（{q} 換成檢索詞；沒有 {q} 的網址會開啟並複製檢索詞）、needsAccess（true 才套用代理）。選填：id（用內建 ID 可改內建資料庫）、query（檢索詞外框，例如 "{q} AND nursing"）、find: true（也用來找這篇）、lang（zh／en／any）。

  [
    { "name": "學校館藏查詢", "url": "https://<學校的館藏系統>/search?q={q}", "needsAccess": false },
    { "id": "cinahl", "url": "https://search.ebscohost.com/login.aspx?direct=true&db=ccm&bquery={q}&type=1&site=ehost-live" }
  ]
  

• 圖書館代理伺服器前綴（EZproxy）：填了之後，只有需要機構權限的資料庫（CINAHL、Embase、JBI、UpToDate 與 needsAccess: true 的自訂資料庫）經由代理開啟，在校外也能用學校帳號登入；例外填在「不套用代理的資料庫 ID」。前綴通常是 https://<代理伺服器>/login?url=（也支援 …?qurl= 與含 {url} 的前綴）。怎麼找：

  1. 學校圖書館網站的「校外連線」「遠端存取」說明頁；
  2. 或在校外從圖書館的電子資料庫清單點一個資料庫，看網址列：https://xxx.yyy.edu.tw/login?url=https://search.ebscohost.com/… 的前綴就是 https://xxx.yyy.edu.tw/login?url=；
  3. 學校用 VPN 或 OpenAthens（網址裡沒有 login?url=）就留空，連上 VPN 後直接用。不確定請問圖書館。

• 其他：右鍵選單最多列出幾個（1–8）、右側面板的搜尋連結、筆記的「🔎 延伸搜尋」、PICO 包含對照組（C，預設不含：C 常是「常規照護」，加進去會漏掉很多文獻）、MeSH 建議（預設開啟；關掉就不連 NCBI）。

每個網址都由 GitHub Actions 實際連線測試（.github/workflows/link-check.yml，每週一次）。「CI 實測 2026-10-08」：OK＝有搜尋結果頁（開首頁的＝首頁可開）；需登入＝轉到訂閱資料庫的登入頁（預期，在校內或經 EZproxy 才進得去）；被擋＝網站擋掉雲端主機的自動連線，在一般瀏覽器通常正常。「網址格式」：實測可帶入檢索詞、常見公開格式（測試被擋）、依圖書館指南範例格式（EBSCO 官方直接連結）、開首頁＋複製檢索詞（沒有公開搜尋網址，貼上即可）。

ID	資料庫	需機構權限	網址格式	CI 實測 2026-10-08	搜尋網址
pubmed	PubMed（預設 Best Match 排序）	否	實測可帶入檢索詞	OK	https://pubmed.ncbi.nlm.nih.gov/?term={q}；單篇 …/<PMID>/；相似文獻 …/?linkname=pubmed_pubmed&from_uid=<PMID>
pubmed-cq	PubMed Clinical Queries	否	實測可帶入檢索詞	OK	https://pubmed.ncbi.nlm.nih.gov/clinical/?term={q}
pubmed-sr	PubMed 系統性回顧	否	實測可帶入檢索詞	—（0.39.0 新增，尚未測試）	https://pubmed.ncbi.nlm.nih.gov/?term=({q}) AND systematic[sb]
mesh	MeSH Database	否	實測可帶入檢索詞	OK	https://www.ncbi.nlm.nih.gov/mesh/?term={q}
cochrane	Cochrane Library	否（全文部分需訂閱）	實測可帶入檢索詞	OK	https://www.cochranelibrary.com/search?…searchText={q}
cinahl	CINAHL（EBSCOhost）	是	依圖書館指南範例格式	需登入	https://search.ebscohost.com/login.aspx?direct=true&db=rzh&bquery={q}&type=1&searchMode=And&site=ehost-live
embase	Embase	是	開首頁＋複製檢索詞	需登入	https://www.embase.com/
scholar	Google Scholar	否	實測可帶入檢索詞	OK（常被擋）	https://scholar.google.com/scholar?hl=zh-TW&q={q}
europepmc	Europe PMC	否	常見公開格式	被擋	https://europepmc.org/search?query={q}（「找這篇」的 EXT_ID:…、DOI:"…"、TITLE:"…" 經 API 實測可找到）
semantic	Semantic Scholar	否	常見公開格式	被擋	https://www.semanticscholar.org/search?q={q}
trip	TRIP Database

{q} 是 URL 編碼後的檢索詞。連結裡只有檢索詞，不帶你的 email、API key 或其他資料。CINAHL 預設是 CINAHL Plus with Full Text（db=rzh）；學校訂的是 CINAHL Complete 時，用自訂資料庫把 cinahl 改成 db=ccm。學校改用新版 EBSCO 介面時這個連結可能轉到登入頁；最穩的作法是在 EBSCO 搜尋一次後用「分享 → 永久連結」複製網址，把檢索詞換成 {q} 存成自訂資料庫。

1. 設定：設定 → 找文獻 → PubMed 新文獻追蹤 →「新增追蹤」：

欄位	說明
名稱	例如「跌倒預防」，成為標籤 追蹤/跌倒預防
PubMed 檢索式	和 PubMed 網站一樣的語法，例如 ("Accidental Falls"[Mesh]) AND nurs*[tiab]；建議先在網站調好再貼上
存到 Zotero 分類	留空 = 📥 新文獻/<名稱>；可填 碩論/新文獻，沒有的分類會自動建立
第一次檢查回溯天數	預設 30 天；之後只查上次檢查以後的
只要出版日期在此之後（選填）	例如 2020 或 2023/01/01

按「測試檢索式」看符合篇數、最近新增的篇數，以及 PubMed 怎麼解讀你的檢索式（拼錯的 MeSH 詞會顯示警告）。

• NCBI（PubMed）連線：Email（NCBI 要求附上聯絡信箱，只送給 NCBI）；NCBI API key（選填，每秒查詢從 3 次提高到 10 次，存在密碼管理員）。MeSH 建議也用這組設定。
• 每個追蹤每次最多匯入：預設 50 篇（最多 200），其餘排隊（最多 500 篇）下次繼續。
• 自動檢查（預設關閉）：Zotero 啟動約 2 分鐘後與之後每小時看一次，距上次檢查超過設定時數（預設 24 小時）才查，所以一天開關很多次也不會重複查。
• 每日新文獻清單（預設開啟）；手動檢查後產生 AI 筆記（預設關閉，超過 5 篇先顯示費用預估）。自動檢查一律不呼叫 AI。

2. 檢查：ZotMax 按鈕或快速指令 → 檢查新文獻（PubMed 追蹤），或設定頁「立即檢查全部」。自動檢查不顯示進度視窗，有新文獻或錯誤才通知。

3. 匯入的文獻：

• 用 Zotero 內建的 PubMed 匯入器建立條目（和魔術棒輸入 PMID 一樣），書目完整，Extra 有 PMID: …。不附 PDF，需要時用 Zotero 的「尋找全文」。
• 加上標籤 新文獻、追蹤/<名稱>、來源/PubMed（PRISMA 計數會算進 PubMed 來源）。
• 不會重複匯入：已有相同 PMID 或 DOI 的略過；外掛記得每個追蹤看過的 PMID，你丟進垃圾桶的不會再回來。兩個追蹤找到同一篇只匯入一次。
• 單篇匯入失敗下次重試，連續 3 次失敗就放棄（進度視窗列出 PMID）。某個追蹤出錯時，下次從原本的時間點重查，其他追蹤照常。

4. Obsidian 每日清單：Zotero/50 新文獻/YYYY-MM-DD.md（舊版平鋪結構是 新文獻/），依追蹤分段，每篇一行待辦（標題、期刊、年份、Zotero／DOI／PubMed 連結）。同一天再檢查只加新的，已勾選的項目和區塊外的筆記保留。看板版（預設）的清單上面多一排「今日新文獻」卡片：今天幾篇、來自幾個追蹤、各追蹤幾篇、最多的期刊；勾選清單照常展開。

注意：依「加入 PubMed 的日期」（Entrez Date）查詢，晚收錄的舊文獻也會出現，只要近年的請填出版日期限制。匯入一律存到「我的文獻庫」。改了檢索式仍從上次時間點開始；想重新回溯就刪掉追蹤再新增。

主題確定之後（例如一個 Zotero 分類「跌倒」，裡面有你讀過、納入的研究），機器人幫你持續找新文獻；它只找、只排序，要不要讀、要不要納入由你決定。

1. 建立：在主題分類上按右鍵 → ZotMax ▸ 主題搜尋機器人：建立或修改（或快速指令、工具列「找文獻」）。

• 檢索式：這個分類有 PICO 問題卡時，帶入問題卡的英文檢索式；可以直接改，按「測試檢索式」看符合幾篇、最近 30 天新收錄幾篇。請到 MeSH Database 確認主題詞。
• 核心文獻（最多 15 篇）：預設勾選全文納入的研究，沒有的話勾已讀、已引用的；要有 DOI 或 PMID。
• 排除詞（選填）：例如 children, pediatric, animal。標題或摘要有這些字的文獻扣 40 分、排到後面（不會刪掉），理由寫出是哪個字。整個字比對（含複數，rat 不會誤中 rate）；字尾加 * 表示開頭相同的字都算（child* 包含 children、childhood）。
• 來源：PubMed（每天一次）、引用核心文獻的新研究（OpenAlex，每週一次）。按「儲存並立即搜尋」第一次會往回找 30 天。

2. 怎麼排序（0–100 分，規則計算、不用 AI，每篇都寫出理由）：

• 主題詞出現在標題或摘要：用 PICO 問題卡的 P、I、C、O（介入權重最高，出現在標題加重）；沒有問題卡時用檢索式的每一組 AND 概念。每個概念都出現再加分。
• 研究設計：系統性回顧／統合分析 > RCT > 其他臨床試驗、觀察性與質性研究（PubMed 的出版類型優先，沒有再看標題與摘要的字詞）。
• 引用了幾篇你的核心文獻；近一年發表。
• 含排除詞的扣 40 分。
• ⭐⭐⭐ 60 分以上、⭐⭐ 35 分以上、⭐ 其餘。分數只幫你排順序，不代表品質，評讀還是要你做。

3. 清單：Zotero/50 新文獻/<分類> 搜尋機器人.md（舊版平鋪結構是 新文獻/）。看板版上面是「本次搜尋」卡片（新候選幾篇、高相關幾篇、待看幾篇、分數與研究設計的分布），下面是 待看 勾選清單：已勾選的在最前面，其餘依分數；每行有分數、理由、來源（PubMed／被引用）和 DOI、PubMed 連結。再次搜尋只加新的，你的勾選和清單外的筆記都保留；已在文獻庫的不列。

• 中文文獻：華藝、臺灣博碩士論文沒有 API，機器人查不到；PICO 問題卡有中文詞時，清單上方有一排「中文文獻」連結（Google Scholar 直接帶入，華藝和博碩士論文開首頁並列出要貼上的字），自己點開查。
• 🏝️ 靠岸到哪座島：主題分類底下有兩個以上子分類（例如「跌倒」底下有「運動」「衛教」「用藥」）時，每篇候選多一段「🏝️ 建議放：運動（Exercise Therapy、balance）」。比對方式：各子分類文獻的 Zotero 標籤（PubMed 的 MeSH、關鍵詞）、標題用詞，和 AI 筆記的介入與結果；只出現在某個子分類的詞分量最重，MeSH 完全相同的加倍。分不出明顯贏家時不建議。匯入時就放進那個子分類；不同意就把名字改成別的子分類（例如 🏝️ 衛教），或刪掉這段，就放在主題分類本身。確認視窗會列出各放幾篇。
• 在其他頁面：主題頁的「前往」多一顆「🤖 搜尋機器人（待看 n · ⭐⭐⭐ k）」；首頁「從這裡開始」有「🤖 搜尋機器人的新候選」卡片（有待看時才出現）；進度報告的「新文獻追蹤」列出本期從機器人匯入幾篇、還有幾篇待看。

4. 匯入：在 Obsidian 勾選（- [x]），回到 Zotero 在分類上按右鍵 → ZotMax ▸ 匯入主題搜尋機器人勾選的文獻。用 Zotero 的「依識別碼新增」匯入到這個分類，加標籤 新文獻、追蹤/<分類> 和來源（來源/PubMed 或 來源/引文追蹤，PRISMA 會分別算進資料庫和「其他方法」），不加篩選標籤、不下載 PDF；匯入的那一行標「✅ 已匯入」，下次搜尋移到「已匯入」區塊。

5. 排程：Zotero 開著時，啟動 3 分鐘後、之後每小時檢查一次哪個機器人到期（PubMed 每天、被引用每週）。不想自動跑：設定 → 找文獻 → 主題搜尋機器人，取消「自動搜尋」，改用 主題搜尋機器人：立即搜尋（在分類上用只跑這個主題，從快速指令用會跑全部）。

注意：PubMed 依「加入 PubMed 的日期」查詢，每次最多看最新的 200 篇；OpenAlex 每篇核心文獻每次取最近發表的 200 篇（沒有 API key 時 OpenAlex 不給更後面的頁；可在 設定 → 找文獻 → 引文追蹤 填入免費的 OpenAlex API key）。中文資料庫（華藝、臺灣博碩士論文）沒有可用的 API，機器人不會查，請用清單上方的「中文文獻」連結或醫學文獻快速搜尋自己查。

PRISMA 2020 要求報告「其他方法」找到的文獻，最常見的就是引文追蹤：查納入研究的參考文獻（往回）與引用它們的文獻（往前）。

1. 查詢：全文篩選有了「全文：納入」之後，分類右鍵 → ZotMax ▸ 引文追蹤：目前分類全文納入的研究（或工具列「找文獻」、快速指令）。也可以選幾篇文獻 → 右鍵 → ZotMax ▸ 引文追蹤所選文獻（OpenAlex）。

• 以 DOI（或 Extra 的 PMID）找到該研究，兩者都沒有的標「沒有 DOI 或 PMID，無法查詢」。
• 背景查詢（每秒最多 5 次），不卡住 Zotero。每次最多 100 次請求，每篇每個方向最多 200 篇（依被引次數排序），超過時標「已達上限」。可在 設定 → 找文獻 → 引文追蹤（OpenAlex） 調整，也可以只查往回或往前。
• 建議填 email：OpenAlex 會把帶 email 的請求放到較穩定的 polite pool（只送給 OpenAlex）。
• OpenAlex API key（選填，免費）：到 openalex.org 註冊，在帳號設定取得，貼到 設定 → 找文獻 → 引文追蹤。有 key 才拿得到第 2 頁以後，被引用很多的核心文獻才查得完整；主題搜尋機器人的「被引用」也會用它。key 存在 Zotero 的密碼管理（和其他 API key 一樣），只送給 OpenAlex，也不會寫進任何紀錄。
• CI 實測 2026-10-08：不需 API key 仍可使用；回應標頭顯示每個 IP 每天 1000 次的免費額度。用到的查詢參數都實際連線驗證過。
• 2026 年 10 月 CI 發現：OpenAlex 對沒有 API key 的請求不給第 2 頁以後（回應 401）。預設每篇每個方向最多 200 篇，一頁就抓完，不受影響；把上限調到 200 以上時，ZotMax 保留第 1 頁的 200 篇，查詢結果標「部分完成：…只取到前 200 篇」，其他研究照常查詢。

2. 候選清單：Zotero/30 評讀與綜整/<分類> 引文追蹤.md 與同名 .csv。

• 查詢結果（每篇找到幾篇、有沒有失敗）；候選文獻（不在文獻庫的，一篇一行勾選清單，標明來自哪篇研究；多篇研究都找到的排前面）；總表（標示「已在本回顧」或「已在文獻庫」，以 DOI、PMID 或標題＋年份比對）。
• 重新查詢只覆寫自動區塊，已勾選的保留。
• 看板版（預設）：上面是「引文追蹤」四張數字卡（查詢的研究、候選文獻、已在文獻庫、已勾選）和「候選概況」（往回／往前各找到幾篇新的、候選的出版年份）；候選清單照常展開方便勾選，查詢結果與總表收在摺疊區塊。

3. 匯入勾選的文獻：在 Obsidian 勾選（- [x]），回到 Zotero 在分類上按右鍵 → ZotMax ▸ 匯入引文追蹤勾選的文獻。用 Zotero 的「依識別碼新增」（DOI／PMID）建立條目，加標籤 來源/引文追蹤，不加篩選標籤、不下載 PDF。已匯入的那一行標「✅ 已匯入」；沒有 DOI／PMID 的候選沒有勾選框，請手動加入。

4. 篩選與 PRISMA：匯入的文獻照常篩選；來源/引文追蹤 算在 PRISMA 右側「其他方法」欄。網站、機構來源請自己加 來源/網站、來源/機構 標籤。

注意：OpenAlex 的資料並不完整（尤其中文期刊與較舊的文獻），請搭配原文的參考文獻列表確認。

bobyu89.github.io/ZotMax/search.html：輸入一次檢索詞，按資料庫就在新分頁開；「全部開啟」一次開一組（護理實證常用、免費資源、中文文獻、臨床指引、臨床試驗登錄）。

• PICO 檢索式產生器：P、I、C（選填）、O 各填同義詞與 MeSH，產生 PubMed 版（[tiab]／[Mesh]，可加出版年、語言、RCT／系統性回顧／指引、排除只有動物的研究）、CINAHL 版（TI／AB／MH "…+"）和一般版，一鍵複製或「在 PubMed 執行」。
• 中文檢索詞：中文資料庫排最前面，並提示常見護理詞的英文關鍵字（只是對照，不是翻譯）。
• 校外連線（EZproxy）：填學校的前綴，🔒 需權限的資料庫（CINAHL、Embase、JBI EBP、UpToDate）經學校登入開啟。
• 已存檢索：存在這台裝置的瀏覽器，可匯出／匯入 JSON；無痕視窗不能儲存時會提醒。
• 本頁不會把檢索詞送到任何伺服器。

分組	資料庫	狀態	CI 實測 2026-10-08	權限
英文資料庫	PubMed、MeSH Database	確定	OK	免費
	Google Scholar	確定	OK（常被擋）	免費
	Europe PMC、Semantic Scholar	確定	被擋	免費
	CINAHL（db=rzh 直接連結，和外掛相同）	推測	需登入	需機構權限
	Embase	首頁	需登入	需機構權限
實證與指引	Cochrane Library	確定	OK	摘要免費、全文需訂閱
	TRIP Database、NICE、CDC	確定	OK	免費
	UpToDate	確定	OK（結果清單免登入）	需機構權限
	Google 指引 PDF	確定	被擋	免費
	JBI EBP Database（Ovid）	首頁	需登入	需機構權限
中文資料庫	華藝線上圖書館	首頁	OK	摘要免費、全文需訂閱
	臺灣博碩士論文知識加值系統	首頁	OK	免費
	國家圖書館期刊文獻資訊網	首頁	被擋（不接受境外連線）	免費
臨床試驗登錄	ClinicalTrials.gov	確定	OK	免費
	WHO ICTRP	首頁	OK	免費

確定＝實測帶得進檢索詞；推測＝要先登入、無法實測到結果頁，開啟時也會複製檢索詞；首頁＝沒有可靠的搜尋網址，開首頁並複製檢索詞。完整網址在頁面最下方「網址格式與狀態」。打不開或沒帶入檢索詞，請到 Issues 回報。

篩選與評讀

• 篩選與 PRISMA 2020：一個回顧專案就是一個 Zotero 分類。在條目上按右鍵（或右側面板的按鈕）標記標題摘要與全文的納入／排除（排除原因可自訂），決定存成 Zotero 標籤；找出可能重複的文獻；一鍵產生 PRISMA 2020 計數、Mermaid 流程圖、一致性檢查與納入研究的證據表（Obsidian 筆記 + Excel 可開的 CSV，可選 Notion 頁面）。決定由你做，外掛只記錄與計數。→ 右鍵 ZotMax：篩選（系統性／範圍回顧）、分類右鍵 ZotMax：系統性回顧篩選
• 文獻評讀表：右側面板逐題點選 是／否／不清楚／不適用，寫評析根據，可選 CASP 或 JBI 清單；AI 筆記的嚴格評讀會預先帶入並標「AI 初評」。勾選「我已核對」後，你的評讀取代 AI 的值，同步到筆記與 PRISMA 證據表。可加第二位評讀者算 Cohen's κ，並匯出分類的評讀總表（燈號矩陣、CSV、Word）。→ 右側面板「文獻評讀表」、分類右鍵 ZotMax：匯出文獻評讀總表
• 評讀陪練：先自己答完評讀表，再按「對照 AI」看 AI 只讀原文會怎麼答；只列出跟你不同的題目，由你決定保留或修改。見下方。
• PICO 問題卡：替每個研究專案（分類）寫一張 PICO／PICOT 問題卡：問題類型（治療、診斷、預後、病因、質性）、P、I、C、O、時間、你的情境、完整問題句。每個欄位下有一個引導問題，「聚焦檢查」只看你寫了什麼（不呼叫 AI）；檢索式直接帶到 PubMed、CINAHL、Cochrane、Google Scholar、華藝。問題由你寫。→ ZotMax 按鈕或快速指令、分類右鍵 ZotMax ▸ PICO 問題卡（目前分類）…
• PICO 表：把選取的文獻或分類整理成一張表：文獻、研究設計與樣本數、P、I、C、O、主要結果、證據等級（CEBM／JBI）、評讀，分類有問題卡時多一欄「對照本題」。值取自各篇 AI 筆記（標明 AI 初填），核對過的評讀表會取代 AI 的評讀。產出 Obsidian 筆記（或資料夾裡的 Markdown）、CSV、Word 可開的 HTML，匯出後可「複製成表格」直接貼進 Word。→ ZotMax 按鈕或快速指令、右鍵 ZotMax ▸ 匯出 PICO 表（選取項目或分類）…。見下方。
• GRADE 證據確定性：系統性文獻回顧的多篇評讀：每個結果指標分開評，隨機試驗從「高」、觀察性研究從「低」開始，偏誤風險、不一致性、間接性、不精確性、發表偏誤要不要降級由你選並寫理由；ZotMax 依各篇評讀結果、AI 筆記的結論方向、樣本數和 PICO 問題卡給提示。產出證據摘要表（Summary of Findings）、證據剖面和納入研究的評讀，可貼進 Word。→ 在分類上按右鍵或快速指令 GRADE 證據確定性（目前分類）…。見下方。
• 評讀表網頁：不用 Zotero 也能評讀，見下方。

清單題目是外掛的中文意譯，不是官方原文；評讀時請開官方表單對照，報告中引用官方清單。

1. 標記資料庫來源（選用）：匯入時替文獻加標籤 來源/PubMed、來源/CINAHL…（可以全選該批文獻拖到標籤上）。沒有來源標籤時用條目的「圖書館目錄」（Library Catalog）欄。

2. 找重複：分類右鍵 → ZotMax ▸ 找出目前分類中可能重複的文獻。比對 DOI、PMID（「其他」欄的 PMID: …）、「標題（忽略大小寫、標點、重音）＋年份」，以及「期刊＋年＋卷＋起始頁」（四項都要有且相同；期刊用全名或縮寫都可以，忽略大小寫、空白、標點和全形；期數都填了但不同時不算）。DOI 不同的不會因標題或期刊卷頁相同被當成重複。一組裡有中文篇名也有英文篇名時，確認視窗會註明「可能是中英文版本，請確認」（例如同一篇《護理雜誌》文章從華藝和 PubMed 各匯入一次）。每組保留一筆（優先已篩選、有 DOI、有摘要、有附件、較早加入的），其餘加 篩選/重複。外掛不會合併或刪除條目；要合併請用 Zotero 的「重覆的項目」，合併後 Records identified 會減少，建議 PRISMA 計數定案後再合併。

3. 篩選：右鍵 → ZotMax ▸ 篩選所選文獻 ▸：

選項	標籤
標題摘要：納入／排除／待定	篩選/標題摘要/納入、篩選/標題摘要/排除、篩選/標題摘要/待定
全文：納入	篩選/全文/納入
全文：排除（選擇原因）	篩選/全文/排除 ＋ 排除原因/<原因>
全文：無法取得全文	篩選/全文/無法取得（PRISMA 的 Reports not retrieved）
標記為重複／清除篩選決定	篩選/重複／移除所有篩選標籤

• 以最新的決定為準：給全文決定時一併記為「標題摘要：納入」；改成「標題摘要：排除」時移除全文決定。每篇只留一個排除原因。
• 開始篩選後，右側 ZotMax 面板的「狀態」裡有一列「篩選：…」與「納入／排除／待定」按鈕。
• 是標籤，所以可以用標籤選擇器篩出還沒篩的，也能指定顏色用數字鍵標記（數字鍵不會移除舊決定，衝突會列在一致性檢查）。
• 篩選標籤不觸發自動同步；下次同步時才帶到 Notion 與 Obsidian。
• 排除原因在 設定 → 篩選與評讀 → 系統性／範圍回顧篩選 修改（內建：族群不符、介入不符、結果指標不符、研究設計不符、非全文／研討會摘要、語言不符、重複發表）。改了前綴或原因，舊標籤不會自動改名。

4. 產生 PRISMA 流程圖與證據表：分類右鍵 → ZotMax ▸ 產生 PRISMA 流程圖與證據表（目前分類）（或 ZotMax 按鈕或快速指令）。

• Obsidian Zotero/30 評讀與綜整/<分類>.md：PRISMA 2020 計數（Records identified 分資料庫、Duplicate records removed、Records screened／excluded、Reports sought／not retrieved／assessed／excluded 分原因、Studies included；frontmatter 也有 prisma_identified、prisma_included 等）、Mermaid 流程圖（還沒篩完的以虛線框標出）、一致性檢查（例如全文排除沒有原因、重複文獻卻有篩選決定，每項可點回 Zotero）、證據表（研究設計、樣本數、場域／國家、族群、介入／對照、結果指標、證據等級、評讀，取自各篇 AI 筆記；還沒有 AI 筆記的欄位留空並列在一致性檢查）。
• 看板版（預設）：上面是辨識、標題摘要篩選、全文評估、納入四張數字卡，接著是「篩選進度」卡片（兩個階段已決定的比例、全文排除原因、納入研究的設計與證據等級的長條，以及一致性檢查），流程圖保持展開，計數表和證據表收在摺疊區塊。Notion 頁面照舊。

注意

• 同一篇在 Zotero 只有一組標籤，放在兩個回顧專案會共用篩選決定；需要各自決定時請用不同的文獻庫（例如群組文獻庫）。
• 流程圖是新版 systematic review 的版本。來源/引文追蹤、來源/網站、來源/機構（設定「其他方法的來源」可改）算在右側「其他方法」欄，直接給全文決定不會警告；有重複或標題摘要排除時會多一個 Records excluded 框讓數字對得起來（PRISMA 範本沒有這個框，可自行刪除）。外掛分辨不出同一研究的多篇報告，「Studies included」與「Reports of included studies」顯示相同數字，需要時請手動改。
• 計數依標籤計算，投稿前請對照一致性檢查確認。

1. 開啟：選一篇文獻，右側 ZotMax 面板的「狀態」裡有一列「文獻評讀表：…」，按「開啟評讀表」。

2. 選評讀工具：預設是 AI 筆記用的清單；AI 沒有評讀時依研究設計選，CASP 優先（台灣護理學會實證報告撰寫指引要求最新版 CASP：RCT 用 2024 版、SR 用 2018 版）。可隨時換：

研究設計	CASP	JBI
RCT	CASP RCT（2024，13 項：1–3、4a–4c、5–11）	JBI RCT（2023 修訂版，13 題）
類實驗（含單組前後測）	—	JBI Quasi-Experimental（9 題）
世代研究	CASP Cohort（2018）	JBI Cohort（11 題）
病例對照	CASP Case Control（2018）	JBI Case Control（10 題）
橫斷性研究	—	JBI Analytical Cross Sectional（8 題）、JBI Prevalence（9 題）
質性研究	CASP Qualitative（2018）	JBI Qualitative（10 題）
系統性回顧／統合分析	CASP Systematic Review（2018）	JBI Systematic Reviews and Research Syntheses（11 題）
診斷性研究	CASP Diagnostic（2018）	—
個案報告／專家意見	—	JBI Case Reports、JBI Text and Opinion

混合方法建議用 MMAT、臨床指引用 AGREE II（未內建）。

3. 逐題評讀：每題按 是／否／不清楚／不適用（再按一次取消），在「評析根據」引用文中的方法或數字（例如「電腦亂數分派，信封保密」）。題目下方的「看什麼」是判讀重點，滑鼠停在題目上看英文提示。CASP 的開放式題目不計分。

• AI 初評：AI 筆記用同一份清單時，逐題答案與理由預先帶入（橘色「AI」）；你點過或改過的標綠色「✓」。換成另一份清單只帶入整體評價；「帶入 AI 初評（只填空白題）」可再帶入一次。
• 整體評價：納入／排除／需更多資訊，寫理由。
• 我已核對：逐題確認後勾選，記下日期。只有勾選後，評讀工具與整體評價才取代 AI 筆記的值。
• 雙人評讀（選用）：勾「雙人評讀（評讀者 B）」後每題多一列 B 的答案，顯示 Cohen's κ 與不一致的題目；定案答案填在 A 列。

4. 儲存：「儲存評讀表」存成子筆記「📝 文獻評讀表」（標籤 zotero-bridge-appraisal），AI 筆記不會被修改。儲存不觸發自動同步，下次同步（或「儲存並同步」）才更新 Notion 與 Obsidian。這則子筆記不會當成你的 Zotero 筆記同步，也不會送給 AI；請在面板修改，不要直接改子筆記的 JSON。

5. 同步到哪裡

• Obsidian：摺疊區塊「文獻評讀表」：狀態（綠色「已核對（日期）」／黃色「AI 初評，尚未核對」）、評讀工具與出處、「評讀項目｜評讀結果｜評析根據」表、整體評價、κ。frontmatter appraisal_verified；核對後 appraisal_tool、appraisal_overall 改為你的值。
• Notion：同樣一個收合區塊（真正的 Notion 表格）；評讀工具、評讀結果 在核對後改為你的值，勾選欄位 評讀已核對。舊資料庫請按「測試連線並補齊資料庫欄位」加上。
• PRISMA 證據表：已核對的評讀取代 AI 的評讀。

6. 評讀總表：分類右鍵 → ZotMax ▸ 匯出文獻評讀總表（目前分類）（或 ZotMax 按鈕或快速指令）。分類有篩選標籤時只用全文納入的研究。產出在 Zotero/30 評讀與綜整/：

• <分類> 評讀總表.md：評讀概況、燈號總表（每份清單一張表，✅ 是 ❌ 否 ❓ 不清楚 ➖ 不適用 ⬜ 未評）、各篇評讀表、雙人評讀一致性、沒有評讀的文獻。
• <分類> 評讀總表.csv：每篇 × 每題一列（UTF-8 BOM）。
• <分類> 評讀總表（Word）.md：在同一資料夾執行 pandoc "<分類> 評讀總表（Word）.md" -o "<分類> 評讀總表.docx" 轉成 Word。
• 看板版（預設）：上面是「評讀概況」卡片：篇數、已核對幾篇（長條）、雙人評讀的 κ、整體評價，以及常見弱點——最多篇研究答「否」或「不清楚」的前 5 題，寫文獻探討的研究限制時可以從這裡開始。燈號總表照常展開，各篇評讀表、κ 計算和 Pandoc 指令收在摺疊區塊；Word 版不變。

Cohen's κ 怎麼算：只計入兩人都作答、不是開放式的題目，答案分是／否／不清楚／不適用四類。p_o = 答案相同的題數 ÷ 題數；p_e = Σ（A 選該類的比例 × B 選該類的比例）；κ = (p_o − p_e) ÷ (1 − p_e)。兩人都只用同一類答案時 p_e = 1，κ 無法計算（只顯示一致率）。解讀依 Landis & Koch（1977）：≤ 0.20 輕微、0.21–0.40 尚可、0.41–0.60 中等、0.61–0.80 高度、> 0.80 幾乎完全一致。題數少時 κ 不穩定，請搭配一致率與不一致清單討論。

清單出處與授權

• CASP checklists（https://casp-uk.net/casp-tools-checklists/）：© CASP，CC BY-NC-SA 4.0（2024 版；舊版 PDF 標示 3.0）。CASP RCT 2024 的段落與部分題號已經網路搜尋比對，其餘依 2020 版結構；其他 CASP 清單依 2018 版整理，未連線核對官方 PDF。
• JBI Critical Appraisal Tools（https://jbi.global/critical-appraisal-tools）：© JBI，可免費使用，請標示出處。JBI RCT 為 2023 修訂版（Barker et al., 2023, JBI Evidence Synthesis, 21(3), 494–506）；偏差領域分組與盛行率、個案報告、文本與意見清單依既有資料整理，未連線核對。
• 清單資料在 content/appraisal-tools.js，外掛和網頁共用。

評讀陪練

先自己做，再看 AI。打開「評讀陪練」開關（進階預設開；要先開「文獻評讀表」和「AI 文獻筆記」，並設定 API key）後：

1. 在評讀表自己答完每一題（AI 初評帶入的題目要點一下你的答案確認，或勾「我已核對」）。還沒答完時「對照 AI」是灰的，滑鼠停在按鈕上會告訴你還差哪幾題。
2. 按「對照 AI」（評讀表裡、面板「狀態」那一列、「動作」或快速指令 評讀陪練：對照 AI）。先顯示預估費用，確認後才送出，並會先儲存評讀表。
3. AI 只拿到這篇的全文（和 AI 筆記一樣整理過、刪掉參考文獻；沒有全文時改用摘要，並先告訴你）和評讀工具的題目，看不到你的答案和評析；它逐題回答、寫 1–2 句理由並引用原文。比對差異的是 ZotMax，不是 AI。
4. AI 的引文會回全文核對：核對不到的直接略過（顯示略過幾句），一題沒有任何可核對的引文時標「低可信（無原文佐證）」。核對到的引文標出 PDF 頁數，點一下就在那一頁打開 PDF。
5. 評讀表只列出 AI 跟你不同的題目：你的答案、AI 的答案、AI 的理由與原文。每題選「保留我的判斷」或「改成 AI 的答案」，可以寫一句「為什麼」。一致的題目折在下面，想看也看得到。上方一行「13 題中 11 題一致，2 題不同（一致 85%）」。

你的答案只有在按「改成 AI 的答案」時才會改。每次對照（日期、模型、評讀工具、每題 AI 的答案、理由、核對過的引文，以及你的決定和時間）都記在「📝 文獻評讀表」子筆記的 JSON 裡（保留最近 5 次）；同步到 Obsidian／Notion 的評讀區塊只多一行「評讀陪練：一致 11/13，修改 1 題」，AI 的答案不會當成你的評讀。AI 的答案只是另一個角度，不是標準答案；不同的地方正好是回原文再讀一次的地方。

PICO 問題卡與 PICO 表

實證流程的第一步是把臨床問題寫成 PICO；ZotMax 讓這張卡跟著研究專案走，後面的搜尋、PRISMA 筆記和證據表都帶著它。兩個功能都不連網、不呼叫 AI，在兩種模式都預設開啟（開關「PICO 問題卡與 PICO 表」）。

1. 寫問題卡：左側選一個分類（回顧專案），ZotMax 按鈕或快速指令 → PICO 問題卡（目前分類）…（沒選分類就是整個文獻庫的卡）。

• 問題類型：治療／預防、診斷、預後、病因／危害、意義／經驗（質性，依 PICo：對象、關注的現象、情境）。標籤和提示跟著類型變。不確定是哪一種：展開「不確定是哪一種？看這幾個問題」，每種類型一個是非題和說明；只是解釋，類型還是你自己選。
• 要素：P、I、C、O 各一格，下面一句引導問題（例如「誰？年齡、疾病或狀況、場域。只寫『病人』太寬」）；時間（T）和「我的情境」選填，情境之後判斷研究能不能應用時會用到。
• 完整問題句：按「用欄位組一句」拿一個起點（例如「在 65 歲以上住院病人中，護理師主導運動相較於常規照護，對跌倒發生率的效果如何？」），再改成你的話。
• 聚焦檢查：即時列出會讓問題難搜、難答的地方：沒寫族群或結果、介入和對照一樣、一張卡放了兩個介入、結果超過 3 個、P／I／O 都沒有英文詞（英文資料庫會找不到）、沒寫情境。意義／經驗的問題，P、I、C、O 都沒有質性研究的詞時，建議加上 qualitative、interview*、phenomenolog*、grounded theory、focus group* 並查 CINAHL（Booth, 2016；Methley et al., 2014）；診斷的問題，欄位裡寫了 sensitivity、specificity、準確度這類詞時，提醒這些詞通常不放進檢索式，用檢測／工具（I）和要診斷的狀況（O）去找。只是規則，不是 AI。
• 帶到資料庫搜尋：先上層：「醫學資料庫搜尋連結」開著時，顯示要素組成的檢索式（英文詞版 P AND I AND O，和原文詞彙版），可複製；資料庫依 6S 證據金字塔由上往下分四層（DiCenso et al., 2009；Alonso-Coello et al., 2010），沒有搜尋網址的會開首頁並複製檢索式：
  1. 指引：NICE、RNAO 最佳實務指引、G-I-N 國際指引圖書館、衛福部／國健署、Google 指引 PDF，加上你的自訂指引網址。
  2. 摘要型資源：TRIP、JBI、UpToDate（後兩個需機構權限）。
  3. 系統性回顧：Cochrane、PubMed 系統性回顧（systematic[sb]）。
  4. 單篇研究：PubMed、CINAHL、Google Scholar、華藝、臺灣博碩士論文。
  • 指引和摘要這兩層只用 P 和 I 的詞（這些網站的搜尋比較粗），下面兩層用完整檢索式。是否加入 C，跟「醫學文獻快速搜尋」設定裡的 PICO 對照選項一樣；在那裡隱藏的資料庫不會列出。檢索式只是起點，MeSH 請到 MeSH Database 確認。
  • 這張卡用來做什麼？：選「臨床問題」，每層標「這層找到可用的就可以停」；選「論文／系統性回顧」，每層標「每一層都要查，並記下查了什麼」（檢索式、日期、筆數，PRISMA 和方法章節會用到）。新卡預設臨床問題；舊卡的問題句寫到系統性回顧、統合分析、scoping review 這類字時預設論文／系統性回顧。
  • 自訂指引網址（設定 → 篩選與評讀 → PICO 問題卡與 PICO 表）：一行一個「名稱|URL」，例如學會或醫院實證中心的指引頁，最多 10 個；網址裡的 {q} 會換成搜尋詞，沒有 {q} 的會開啟網頁並複製搜尋詞。
• 檢索詞建議（pearl growing）：卡片下方列出這個分類的文獻常用、但問題卡和檢索式還沒有的主題詞（最多 8 個，括號是幾篇有），取自各篇在 Zotero 的標籤：從 PubMed 匯入的 MeSH（* 和 /prevention & control 這類副標題會去掉）、其他資料庫的作者關鍵字。按一下複製，再決定要不要加成同義詞；工作流程標籤（狀態/、篩選/…）和 Humans、Aged 這類檢查標籤不算。
• 儲存後，這個分類的 PRISMA 筆記最上面會多一節「本題 PICO」，PICO 表也會帶上它。卡存在 Zotero 設定裡（pico.cards），可以隨時回來改或刪除。

2. 匯出 PICO 表：選取文獻，或選一個分類 → 匯出 PICO 表（選取項目或分類）…。分類開始篩選後只列全文納入的研究。視窗裡會看到篇數、幾篇還沒有 AI 筆記（那幾列會是空的）、本題 PICO、放在哪裡，以及要不要一起產生 CSV、Word 版和 Notion 頁面。

• 欄位：文獻（Obsidian 筆記的連結）、研究設計與樣本數、P 族群、I 介入、C 對照、O 結果、主要結果（AI 筆記「主要結果」的前三點）、證據等級（CEBM／JBI）、評讀（結果、工具，加上「已核對」「評讀中」或「AI 初評」）、對照本題（有問題卡時）。
• 對照本題只是字詞比對：✓ 這篇的該要素和問題卡有共同字詞（英文單字或中文兩字詞），？ 沒有共同字詞（換個說法也可能是同一件事），— 這篇沒有該要素的資料。符不符合，由你讀原文判斷。
• 🔎 檢索詞建議：筆記裡表格下方多一張「從這些文獻反推」的檢索詞表：詞、幾篇有（長條）、是否已在問題卡（✓）。文獻 4 篇以上時只列至少 2 篇共有的詞。沒打勾的就是可以補進檢索式的候選，記得到 MeSH Database 確認。
• 看板版（預設）：表格上面多兩排卡片：「本題 PICO」（研究問題、P／I／C／O、各要素有幾篇和問題卡有共同字詞、檢索式）和「文獻」（篇數、最強證據、研究設計、前 8 個檢索詞建議）；PICO 表本身保持展開，說明和完整的檢索詞表收在摺疊區塊。Notion 頁面照舊。
• 放在哪裡：有 Obsidian vault 時放 Zotero/30 評讀與綜整/<分類> PICO 表.md（和 PRISMA 筆記一起，可用 [[ ]] 連到各篇筆記）；沒有 vault 時放設定裡指定的資料夾，再沒有就放「下載」。重新匯出只覆寫自動區塊，「✍️ 我的筆記」保留。
• 也產生：<分類> PICO 表.csv（Excel 直接開，欄位更多：作者、DOI、場域、測量工具、評讀狀態…）、<分類> PICO 表.html（用 Word 開啟就是表格，可另存 .docx）；填了「PRISMA 頁面的 Notion 父頁面」時可一併更新 Notion 頁面。
• 匯出之後：對話框列出寫了什麼、幾篇沒有資料；按 複製成表格 把本題 PICO 和整張表以 HTML 放到剪貼簿，到 Word 直接貼上就是表格；打開資料夾 打開輸出位置。

⚠️ 表裡的 P、I、C、O、主要結果和證據等級是 AI 筆記初填的，不是你核對過的資料；寫進報告前每一格都要回原文核對，證據等級請依你採用的分級系統重判。評讀欄只有標「已核對」的才是你自己的結論。

GRADE 證據確定性

GRADE 評的不是單篇文獻，而是某個結果指標的整體證據有多可信（Guyatt et al., 2008）。單篇的品質用文獻評讀表（CASP、JBI；隨機試驗可用 RoB 2、非隨機研究用 ROBINS-I），GRADE 再把同一個結果的多篇研究合起來看。不連網、不呼叫 AI，在兩種模式都預設開啟（開關「GRADE 證據確定性」）。

開啟：左側選一個分類（回顧專案）→ 右鍵或快速指令 → GRADE 證據確定性（目前分類）…。分類開始篩選後只列全文納入的研究。

1. 結果指標：GRADE 建議只評對決策最關鍵的結果（最多 7 個）。按建議加入（PICO 問題卡的 O，和各篇 AI 筆記最常出現的結果），或自己輸入；每個標「關鍵／重要／不重要」。

2. 研究：AI 筆記的結果欄提到這個結果的研究會先勾好，再自己增減。每篇旁邊列出研究設計、樣本數、評讀結果（含是否已核對）和 AI 判斷的結論方向。

3. 起始：隨機對照試驗從「高」⊕⊕⊕⊕ 開始，觀察性研究從「低」⊕⊕◯◯ 開始。隨機試驗和觀察性研究混在一起、或有質性研究（請改用 GRADE-CERQual）時會提醒。

4. 五個降級面向：每個面向選「不降級／降一級（嚴重）／降兩級（非常嚴重）」並寫理由，理由會成為證據摘要表下的註腳。每個面向下面有 GRADE 的判斷問題，和 ZotMax 依現有資料的提示：

面向	提示從哪裡來
偏誤風險（Risk of bias）	各篇的評讀結果：幾篇是「需更多資訊」或「排除」、幾篇還沒核對；沒有評讀時提醒先逐篇評讀
不一致性（Inconsistency）	各篇 AI 筆記的結論方向（有效、無差異…）是否一致；只有 1 篇時無法評估
間接性（Indirectness）	各篇的 P、I、O 和 PICO 問題卡有沒有共同字詞
不精確性（Imprecision）	總樣本數和 GRADE 的經驗法則（連續變項約 400 人、二元變項約 300 個事件）；也提醒看 95% CI
發表偏誤（Publication bias）	研究篇數：少於約 10 篇無法用漏斗圖檢定，提醒查試驗登錄和灰色文獻

5. 升級（只用於觀察性研究，通常在沒有降級時）：效果很大（+1 或 +2）、劑量反應（+1）、干擾因素反而會減弱效果（+1）。

6. 效果與人數：相對效果（例如 RR 0.70（95% CI 0.55–0.89）或 SMD）和絕對效果（例如每 1000 人少 45 人）從原文或統合分析抄寫；參與人數預設是 AI 筆記樣本數的加總，可以改。

評等即時顯示（例如「⊕⊕◯◯ 低（從「高」開始；偏誤風險 −1、不精確性 −1）」），下面列出還要補的地方（降級沒寫理由、效果沒填）。儲存把評等存在這個分類（之後加了研究可以回來改）；儲存並匯出證據摘要表再產生：

• <分類> GRADE 證據摘要.md（有 Obsidian vault 時在 30 評讀與綜整/，和 PRISMA 筆記、PICO 表一起；沒有 vault 時放 PICO 表的資料夾或「下載」）：證據摘要表（Summary of Findings：結果指標、重要性、研究數與設計、參與人數、效果、證據確定性加註腳）、證據剖面（每個結果在五個面向的判斷）、納入研究的評讀、備註。重新匯出只覆寫自動區塊。看板版（預設）上面是每個結果指標一張卡片（⊕⊕⊕◯ 中、重要性與研究數、效果）和證據確定性分布，各張表格收在摺疊區塊。
• .csv（每個面向和理由一欄，Excel 直接開）、.html（用 Word 開就是表格）。匯出後按 複製成表格，把證據摘要表貼進 Word。

⚠️ 評等是你的判斷，ZotMax 的提示只是依現有資料的提醒，不是評等。AI 筆記的結論方向和樣本數是 AI 初填，效果值請從原文或統合分析抄寫並核對。正式的系統性回顧通常由兩位研究者分別評等再討論。

評讀表網頁

bobyu89.github.io/ZotMax/appraisal.html：不用 Zotero、不用安裝，手機也能填 CASP、JBI 評讀表，適合課堂作業、讀書會和 EBHC 報告。題目和外掛共用同一份清單；評讀內容只存在你的瀏覽器，不會送到任何伺服器。

• 論文資料：填第一作者、年份、篇名，選研究設計後推薦評讀工具（例如 RCT → CASP RCT 2024、系統性回顧 → CASP SR 2018），也可改用其他工具。工具名稱下方有官方表單連結和授權；可另外記錄證據等級（Oxford CEBM 2011）。
• 逐題評讀：是／否／不清楚／不適用，「評析根據」引用原文（例如：電腦亂數分派、信封密封；流失率 8%，採 ITT 分析）；有提示的題目按「提示」。
• 整體判定：納入／排除／需更多資訊，加上評讀者與日期。
• 多篇論文：「我的評讀」可新增、複製、刪除；換電腦或和同學交換用「匯出 JSON／匯入 JSON」（同一篇會更新，不重複）。無痕視窗不能儲存時會提醒先匯出。
• 輸出：複製到 Word（含框線的「評讀項目｜評讀結果｜評析根據」三欄表格，和 EBHC 報告的評讀表相同；瀏覽器不支援時改成 Tab 分隔文字，可用 Word 的「文字轉換為表格」）、複製 Markdown 表格、下載 CSV（UTF-8 BOM）、列印／存 PDF（「列印全部」先印燈號總覽，再每篇一頁）。
• 燈號總覽：依評讀工具分組，一列一篇、一欄一題（✓ 是、✗ 否、? 不清楚、– 不適用）。
• 雙人評讀：兩人答案不同的題目標黃，計算 Cohen's κ（算法與解讀同上）；一篇只有 10 題左右時 κ 很不穩定，報告時請同時寫一致率，並說明不一致的題目怎麼討論決定。燈號總覽下方有全部雙人評讀論文合計的 κ。

AI 輔助與寫作

AI 功能要開關打開、也設定了 API key 才會用到（AI 文獻筆記也可以用網頁版 AI，不用 key）。所有 AI 產出都是初稿：每個數字、每個引用都要對照原文。

• AI 文獻筆記：同步時（沒有 AI 筆記才產生）請 AI 讀書目、摘要、全文和你的劃線與筆記，寫成固定格式的研讀筆記：一句話摘要、背景與目的、設計與方法（樣本、工具信效度、統計）、主要結果、作者結論、研究限制、嚴格評讀（依研究設計選 JBI 或 CASP 清單逐題作答，給整體評價）、證據等級、對我研究的啟發、關鍵概念 [[ ]]、可引用句。AI 筆記存回 Zotero 子筆記，之後同步不再花 token，你也可以直接在 Zotero 修改。→ 工具列「AI 輔助與寫作」→ 重新產生 AI 筆記並同步；右側 ZotMax 面板的「重點」可直接看摘要與主要發現
• 研讀欄位：AI 同時輸出研究設計、樣本數、場域、PICO、測量工具、證據等級（Oxford CEBM 2011 與 JBI）、評讀結果、國家，寫進 Notion 欄位與 Obsidian frontmatter，可以篩選「研究設計 = RCT 且樣本數 > 100」。
• 可引用句查證：每一句都和全文、摘要、劃線比對，找到標 ✅，找不到標 ⚠️。
• AI 標重點（研究生引導預設關閉）：同一次呼叫順便挑 3–6 句關鍵原句，和全文核對後在全文筆記用「🤖＋底線」標出，跟你的彩色劃線分開，僅供參考。
• 文獻比較表（預設關閉）：選 2 篇以上或整個分類，AI 讀各篇 AI 筆記，產生比較表、主題整理、方法學品質與研究缺口，存成 Obsidian、Zotero 獨立筆記和 Notion 頁面。→ 產生文獻比較表（AI）
• 文獻探討草稿（預設關閉）：依你填的研究問題與主題大綱，把一個分類寫成第二章的草稿。AI 只能用 [S#] 代號引用，由外掛換成 citekey，附數字查核清單與 Pandoc 指令。→ 產生文獻探討草稿（AI）
• 進度報告（預設關閉）：和指導教授開會前，整理兩次會議之間讀完哪些文獻、PRISMA 計數變化、草稿字數、下次目標。資料都來自 Zotero 與 vault，不需要 AI；AI 摘要可選。→ ZotMax 按鈕或快速指令 → 產生進度報告（給指導教授）
• 讀懂統計（研究生引導預設關閉）：在 PDF 閱讀器選一段文字，選取框裡按 ZotMax：解釋統計（或快速指令 → 解釋所選統計），右側 ZotMax 面板多出「統計解釋」。詳見下方「讀懂統計」。
• 匯出給 Gemini Notebook（研究生引導預設關閉）：把一個分類或選取的文獻整理成可以上傳到 Gemini Notebook（原 NotebookLM）的資料夾，只寫入你的電腦。詳見下方「匯出給 Gemini Notebook」。
• 研究大腦：research-brain/ 是給 Obsidian vault 用的 Claude Code／Codex CLI 設定檔，用斜線指令做跨文獻的工作（/lit-compare、/research-gaps、/lit-review-draft、/inbox-triage、/review-prisma）。外掛負責每一篇的固定流程，研究大腦負責跨文獻的思考。

⚠️ 草稿不是作業。 AI 可能誤解結果、把結論套到錯誤的文獻、漏掉重要研究或寫出過度概括的句子；查核清單只抓得到部分數字問題。每一句、每個數字、每個引用都要對照原文，改寫成你自己的論述，也請遵守學校、課程或期刊對 AI 使用的規定。

網頁版 AI（免 API key）

不會申請 API key、不想綁信用卡，或已經有 ChatGPT、Claude、Gemini（免費版或訂閱）、學校提供的 AI 帳號：用複製貼上的方式產生 AI 文獻筆記，不呼叫任何 API，也不產生 API 費用。

1. 在文獻上按右鍵 → ZotMax ▸ AI 筆記（複製貼上，免 API key）…（或快速指令、右側 ZotMax 面板的「產生 AI 筆記」）。選好幾篇時一篇一篇來，可以「跳過這篇」。
2. 複製提示詞（含全文）：和 API 送出的完全一樣——筆記模板、結構化資料（JSON）的規則、書目、摘要、你的劃線與 Zotero 筆記、整理過的全文（參考文獻等段落已省略）。太長時視窗會提醒；這時（或 PDF 是掃描版）改按 只複製指令（我自己上傳 PDF），在 AI 網站把 PDF 一起附上。
3. 按 開啟 ChatGPT／Claude／Gemini（或打開學校的 AI），貼上送出。等它寫完，按回答下面的「複製」按鈕（自己反白容易掉格式）。
4. 貼回視窗。下面會即時檢查：有沒有分段、有沒有最後的 JSON 資料區塊、是不是被截斷。缺 JSON 時可以請 AI「補上最後的 ```json 區塊」再貼一次。填「用的是哪個 AI」（選填）會記在筆記上。
5. 儲存 AI 筆記並同步：和 API 產生的走同一條路——存成 Zotero 的 AI 子筆記、取出研讀欄位、可引用句和摘要與劃線比對（✅／⚠️），再同步到 Obsidian／Notion，看板、儀表板、主題頁和 GRADE 提示都用得到。

• 設成預設：設定 → AI → 服務商選「網頁版 AI（複製貼上，免 API key）」。這時同步不會呼叫 AI，也不會因為沒有 key 卡住；面板的「產生 AI 筆記」會打開這個視窗。有 API key 時也可以隨時用這個指令（例如想用網頁版比較強的模型）。
• 全文會送到你選的網站：含病人資料或未發表的資料，請先確認可以分享（醫院或學校的規定），必要時先去識別化；免費方案的內容可能被拿去訓練模型。
• 其他 AI 功能（比較表、文獻探討草稿、評讀陪練、讀懂統計、AI 主題分類、概念 AI 綜整）目前仍需要 API key；沒有 key 又想用，可以選 OpenRouter 的免費模型。

讀懂統計

論文裡的 OR、95% CI、p 值、HR、ITT、效果量、I² 看不懂時，在 PDF 上選那一段，按選取框裡的 ZotMax：解釋統計。右側 ZotMax 面板的「統計解釋」分成四塊：

• 這是什麼：這段出現的每個統計量或術語（英文術語保留），在這段裡的值代表什麼。
• 這段在說什麼：整段用白話重說一次。
• 臨床上代表什麼：對照顧病人的意義，效果小或不確定也會直說。
• 要注意的地方：例如信賴區間跨過 1、區間很寬、統計上顯著但效果很小、多重比較、per-protocol 和 ITT 的差別。

AI 會看你選的文字，加上論文「方法／統計分析」段落的節錄（從全文整理出來；沒有全文時用摘要），以及 AI 文獻筆記裡的研究設計與樣本數。數字核對：AI 寫的每個數字都要原樣出現在你選的文字或送出的節錄裡（1·8 和 1.8、.001 和 0.001、全形數字都算同一個數字）；對不上的直接刪掉，換成「［數字已移除］」，並標示「⚠ 這個數字不在原文裡，已移除」。AI 也被要求不自己計算新數字（NNT、百分比變化等），只告訴你怎麼用原文的數字算；唯一例外是說明信賴區間有沒有跨過 0 或 1。

• 再解釋得簡單一點：再呼叫一次，用更短的句子和臨床例子重講，數字一樣核對。
• 存到筆記：把這次解釋加進 Obsidian 文獻筆記的「統計筆記」摺疊區塊，附上回到 PDF 那一頁的連結。這個區塊在 ZotMax 管理的區塊之外，是你的：重新同步不會改它，你可以在裡面補自己的理解。文獻筆記要先同步過一次。
• 紀錄：每篇保留最近 5 次解釋（Zotero 子筆記，標籤 zotero-bridge-stats，會跟著 Zotero 同步），最新的展開，舊的摺起來。這份子筆記不會當成你的筆記同步，也不會送給 AI。
• 費用：一段選取通常是一次很短的呼叫，預設不跳確認視窗，預估費用直接顯示在「AI 解釋中…」旁邊；超過門檻（預設 US$0.05）才先問你。設定 → AI → 讀懂統計 可以改成每次都問或不問。

• 研讀欄位存在哪裡：Zotero AI 子筆記最後的「📋 結構化資料」JSON 區塊。之後不呼叫 AI 的同步也沿用；你可以直接在 Zotero 改那段 JSON。它不會出現在 Obsidian／Notion 的內文。
• 可引用句查證的規則：忽略大小寫、彎引號、PDF 換行斷字、中文字間空白；省略號 … 前後分段比對；九成以上的字依序相符就算找到。找不到標「⚠️ 未在全文中找到」；沒有全文標「⚠️ 無全文可查證」。進度視窗會顯示查證結果。
• AI 標重點：存在結構化資料裡；和你的劃線重疊時以你的為準；文獻筆記另列「AI 標的重點（僅供參考）」，排在你的劃線與評讀之後；對不上全文的直接刪掉，進度視窗會說刪了幾句。
• 重新產生：會覆寫 AI 子筆記（標籤 zotero-bridge-ai）；舊內容另存成子筆記（標籤 zotero-bridge-ai-history），只留在 Zotero，不同步、不送給 AI，不需要時可以刪。
• 右側面板：ZotMax 面板的「重點」顯示一句話摘要、研究設計與主要發現，完整的 AI 筆記折在下面；整個面板收合時標題列顯示摘要。還沒有 AI 筆記時可以直接按「產生 AI 筆記」。

掃描版 PDF（沒有文字層）：外掛先判斷每篇的全文狀況，寫進 frontmatter full_text 與 Notion 的 全文狀態（由外掛管理）：

值	意思	判斷方式
ok	有全文	PDF（或 EPUB、網頁快照）有文字層
partial	部分掃描	平均每頁不到 600 個字元（不含空白）
none	掃描版	平均每頁不到 100 個字元：沒有文字，或只有下載浮水印
no_pdf	沒有 PDF	沒有附件，或檔案不在這台電腦上

• 頁數取自 Zotero 的全文索引或 PDF 工具；讀不到頁數時，少於 20 字元才判為 none。多個附件取最好的那個。
• 產生 AI 筆記時，進度視窗在該篇顯示 ⚠️，例如「掃描版 PDF（沒有文字層），AI 只讀了摘要與劃線」。
• 掃描版 PDF 直接傳給 AI 讀（設定 → AI → AI 服務 → AI 文獻筆記，預設開啟）：none／partial 的 PDF 把檔案本身傳給 AI 看每一頁（Claude；OpenAI 官方 API 也支援，自訂 API base URL 時不傳；OpenRouter 不傳，網頁版 AI 可以按「只複製指令」自己在網站上傳 PDF）。上限 20 MB、100 頁，可在 Config Editor 改 extensions.zotero-bridge.llm.pdfMaxMB、llm.pdfMaxPages；超過或 API 拒絕時改用摘要與劃線。比較耗 token：每頁都當影像計費，費用預估可能低估。AI 讀的是影像，所以摘要與劃線裡也找不到的可引用句標「⚠️ 無全文可查證」。
• 比較省錢的做法是讓 PDF 有文字層：用 OCRmyPDF（ocrmypdf --language eng+chi_tra 掃描.pdf 輸出.pdf）或 Adobe Acrobat 的「辨識文字」處理後放回 Zotero，或重新下載有文字的版本；重新索引後再「重新產生 AI 筆記」。
• 沒有東西可讀就不呼叫 AI：沒有全文、沒有傳 PDF、沒有摘要、也沒有劃線或筆記時略過 AI 筆記，避免 AI 只憑標題編內容；Notion／Obsidian 照常同步。
• 「全文最多送出字元數」設成 0 時不送全文也不傳 PDF。

1. 選 2 篇以上的文獻（或在分類上按右鍵），選 產生文獻比較表（AI）。一次最多 60 篇，每次一次 API 費用。建議先替各篇產生 AI 筆記（沒有的改用摘要與劃線）。
2. 產出：
   • Obsidian：Zotero/30 評讀與綜整/文獻比較/文獻比較：<分類>（N 篇） <日期時間>.md，連回各篇文獻筆記，附 APA 7 參考文獻（引文由 Zotero 書目轉換，不讓 AI 寫）。
   • Zotero：獨立筆記（標籤 zotero-bridge-synthesis），放在該分類並關聯來源文獻。
   • Notion：填了「文獻比較表的 Notion 父頁面」時，建成它的子頁面（含真正的表格）。
3. 格式可在 設定 → AI → AI 服務 → 文獻比較表 的「比較表模板」修改。
4. 看板版（預設）：比較表上面是「比較的文獻」卡片：篇數與年份範圍、最強證據、研究設計和證據等級的長條（取自各篇的 AI 筆記）；參考文獻收在摺疊區塊，最後是「✍️ 我的筆記」。精簡版照舊。

1. 分類右鍵（或選 2 篇以上），選 產生文獻探討草稿（AI）。

2. 對話框填 研究問題／目的（用在最後一節「文獻小結與研究缺口」）和 主題大綱（每行一個小節；留空由 AI 歸納 3–6 個主題）。兩欄記在這個分類，下次自動帶出。

3. 確認預估費用後送出（一次 API 呼叫，記入「本月 AI 用量」）。

4. 產出：

   • Obsidian Zotero/40 寫作/文獻探討/文獻探討-<分類>.md：引文是 [@citekey]，和 references.json、各篇筆記的 citekey 相同；文末有「⚠️ 查核清單」與「Pandoc 指令」。缺少引用的文獻時會自動重新匯出 references.json。
   • Notion：填了父頁面時建子頁面，引文是一般文字，附 APA 參考文獻與查核清單；重新產生更新同一頁。

5. 轉成 Word：在 Zotero/40 寫作/文獻探討 執行筆記裡的指令，例如

   pandoc 文獻探討-碩論.md --citeproc --bibliography "../../90 系統/references.json" --csl ../../../apa.csl --lua-filter zotero-bridge-draft.lua -o 文獻探討-碩論.docx
   

   apa.csl 放在 vault 根目錄（見在 Obsidian 寫論文並用 Pandoc 產生 APA Word）。zotero-bridge-draft.lua 由外掛放在同一資料夾，轉檔時略過 %% 標記、提示框、查核清單與「我的筆記」。

外掛怎麼把關

• 優先用各篇的 AI 筆記（含研究設計、樣本數、證據等級、評讀）；沒有的改用摘要與劃線。
• AI 只能用 [S1]、[S2] 代號，由外掛換成 citekey，AI 不會自己寫作者、年份或參考文獻。清單外的代號標成 【⚠️ 未知來源 S9】 並列入查核清單。
• 草稿裡的數字（樣本數、百分比、p 值、效應量）和所引文獻的 AI 筆記、結構化資料、摘要與劃線比對，找不到的列在查核清單，內文不改。比對的不是 PDF 全文，所以「沒列出」不等於「正確」。
• 重新產生只覆寫自動區塊；要修改草稿，請複製到標記外或你的論文檔再改。

看板版（預設）：草稿上面是「草稿狀態」卡片：研究問題、引用幾篇（幾篇沒有 AI 筆記）、篇幅（約多少字）、要回原文確認幾項，查核清單就在旁邊；草稿與「參考文獻」照常展開，引用對照和 Pandoc 指令收在摺疊區塊。卡片都是提示框，轉成 Word 時會被略過，Word 版只有草稿和參考文獻。

ZotMax 按鈕或快速指令 → 產生進度報告（給指導教授） → 產生 Zotero/40 寫作/進度報告/<日期>.md。

• 對話框：報告期間（預設從上一份報告的日期到今天；第一次是近 14 天）、包含的段落、本次想討論的問題、下次目標（每行一項）、AI 本期摘要（預設不勾；只根據報告資料寫 120–220 字，先顯示預估費用；摘要裡出現報告中找不到的數字會標 ⚠️）、複製純文字（預設勾選，直接貼到 LINE 或 Email）、寫入 Notion（有 token 與父頁面時可勾；同一天更新同一頁）。
• 內容：
  • 本期閱讀：期間內改成已讀／已引用的文獻、新加入的文獻、新產生 AI 筆記的、評讀表勾選「我已核對」的。閱讀狀態的變更從外掛開始記錄後才有（每篇最多 20 筆、保留兩年），更早的不會出現。
  • 🪐 島嶼開發度（有星球時）：每座島從期間開始到結束的開發度，例如「跌倒 › 運動：🌱 LV1 24 → 🏘️ LV3 60（+36，升級）」，升級的排前面；看板版的「本期重點」多一張「島嶼開發」卡片。開發度在每次更新研究儀表板時記錄（有變化才記一筆），所以從 0.35.0 之後才開始有資料。期間內完成的 🎯 島嶼任務也列在這裡。
  • 系統性回顧進度：每個回顧專案的辨識 → 篩選 → 全文評估 → 納入篇數，和上一份相比的增減（例如「納入 6（+2）」）。數字取自最近一次產生的 PRISMA，要最新請先重新產生。
  • 寫作進度：40 寫作/文獻探討/ 裡期間內改過的草稿，以及你自己寫的字數（自動區塊以外，中文每字算 1、英文每個單字算 1）的變化。
  • 新文獻追蹤：PubMed 每日清單匯入與已勾選看過的篇數；有主題搜尋機器人時，加上本期從機器人匯入幾篇、清單上還有幾篇待看。
  • 問題與下次目標：上一份的「下次目標」變成「上次目標回顧」勾選清單。
• 重新產生同一天的報告：只改寫自動區塊；勾選與你改過的問題、目標會保留。
• 轉成 Word：報告最後的 Pandoc 指令（在 進度報告 資料夾執行；外掛放了 zotero-bridge-report.lua）。40 寫作/文獻探討/ 裡有 reference.docx（或檔名含 reference、範本、樣板、template 的 .docx）時，指令會加上 --reference-doc 沿用它的 Word 樣式。
• 看板版（預設）：上面是「本期進度」四張數字卡（讀完、新加入、AI 文獻筆記、評讀已核對）和「本期重點」卡片（上次目標完成幾項、各回顧專案的納入篇數與增減、寫作、新文獻追蹤）；下面是完整的報告，Pandoc 指令收在摺疊區塊。卡片不會出現在 Word 版和複製的純文字裡。

匯出

匯出給 Gemini Notebook

Gemini Notebook（2026 年 7 月以前叫 NotebookLM）可以只根據你上傳的來源回答問題、做摘要。個人帳號沒有官方的 Gemini Notebook API，所以 ZotMax 只把檔案整理好，上傳由你自己來；這個功能不連網、不呼叫 AI，也不會送出任何東西。

• 怎麼用：在「功能」打開 匯出給 Gemini Notebook（研究生引導預設關閉）。選取文獻，或選一個分類 → ZotMax 按鈕、右鍵 ZotMax ▸ 或快速指令 → 匯出給 Gemini Notebook（選取項目或分類）…。視窗裡確認篇數、選要放在哪個資料夾（預設見下方「放在哪裡」），再決定兩個選項：
  • 也複製 PDF（預設不勾）：Gemini Notebook 把每個檔案算成一個來源，PDF 和 Markdown 都放會讓來源數加倍、內容重複。掃描檔沒有文字時才特別需要 PDF。
  • 加入「我的劃線與評讀」（預設不勾）：你的劃線（依顏色意義分組）和你自己填的評讀表，明確標成你的筆記，不是原文也不是 AI 寫的。
• 放在哪裡：你用「選擇資料夾…」（或設定 → AI → Gemini Notebook 的「匯出到」）指定過的資料夾優先；沒有指定時，偵測到 Google 雲端硬碟電腦版（Drive for desktop）就放進 我的雲端硬碟/ZotMax/Gemini Notebook/（第一次匯出時建立），否則放「下載」。視窗裡在雲端硬碟時會標出「這個資料夾會同步到 Google 雲端硬碟」，可以按 改存到下載 只改這一次；有好幾個 Google 帳號時，用第一個並讓你選。不想預設用雲端硬碟，就在設定取消勾選「偵測到 Google 雲端硬碟時，預設匯出到雲端硬碟」。
  • 偵測的位置：macOS 的 ~/Library/CloudStorage/GoogleDrive-<帳號>/My Drive（較舊版本是 /Volumes/GoogleDrive/My Drive）；Windows 串流模式的磁碟機（預設 G:\My Drive），或鏡像模式的 %USERPROFILE%\My Drive；舊版「備份與同步」的 Google Drive 資料夾。中文介面的「我的雲端硬碟」等各語言名稱也認得。ZotMax 只確認這些資料夾在不在，不會讀雲端硬碟裡的任何檔案。
• 會產生：Gemini Notebook - <分類名稱或「選取的文獻」> - <日期>/ 資料夾，裡面有
  • 每篇一個 作者 年份 - 短標題.md：標題、作者、年份、出處、DOI、APA 7，接著是全文（和「全文筆記」同一套轉換：去掉頁首頁尾、頁碼、斷字）；沒有全文的（掃描檔、沒有 PDF）放摘要並說明原因
  • 00 參考文獻（APA 7）.md：這些文獻的參考文獻清單（中文文獻用中文 APA 7，排在前面）
  • 01 我的劃線與評讀.md（有勾才有）、PDF 檔（有勾才有，連結檔找不到的會略過並說明）
  • README - 如何加入 Gemini Notebook.txt：步驟、限制和提醒
• 來源上限：Gemini Notebook 每本筆記本約 50 個來源（依方案而異）。視窗會算出這次會產生幾個來源，超過上限（設定 → AI → Gemini Notebook，預設 50）時直接告訴你，請分成幾本筆記本或不要勾 PDF。
• 匯出之後：對話框列出寫了什麼、哪些篇只有摘要，按 打開資料夾。到 notebook.google.com（舊網址 notebooklm.google.com 也會轉過去）建立或打開筆記本 → 新增來源 → 上傳檔案，把 .md（和要用的 PDF）拖進去；README 不用上傳。
• 匯出到雲端硬碟時：不用上傳。先等雲端硬碟同步完成（要一點時間，同步好之前 Gemini Notebook 看不到檔案），再到筆記本 → 新增來源 → Google 雲端硬碟 → 找到 ZotMax/Gemini Notebook/<這次的資料夾> 選檔案。清單裡看不到某些檔案（例如 .md）時，改用 上傳檔案。README 和對話框也會照這個寫。
  • 依 Google 2026 年 5 月的公告，從雲端硬碟加入的來源只有 會自動跟著更新。ZotMax 匯出的 Markdown 和 PDF 加入後是當時的副本，：論文、劃線或評讀改了，請重新匯出，再把新檔案加入筆記本（舊的來源可以刪掉）。

⚠️ 上傳到 Gemini Notebook 就是把文獻全文交給 Google：未發表的研究資料、病人資訊不要上傳，也請確認期刊或學校對全文分享的規定。Gemini Notebook 的摘要和回答可能出錯或漏掉重點，寫進報告或論文前一定要回到原文核對，引用要用原文的頁碼。

• 參考文獻檔：把文獻庫匯出成 vault 裡的 Zotero/90 系統/references.json（CSL JSON，可加 BibTeX），條目 id 就是筆記的 citekey。在 Obsidian 用 [@citekey] 寫，再用 Pandoc 轉成 APA 7 的 Word。→ ZotMax 按鈕或快速指令 → 匯出參考文獻到 Obsidian、分類右鍵 ZotMax ▸ 匯出目前分類的參考文獻、設定 → 參考文獻檔
• 文獻比較表、PRISMA、評讀總表、PICO 表、引文追蹤的 CSV（UTF-8 BOM）都能直接用 Excel 開；PICO 表另有 Word 可開的 HTML 和「複製成表格」。

Word 的中文 APA 引用

用 Zotero 的 Word（或 LibreOffice）外掛寫論文時，官方 APA 樣式只有英文規則：中文文獻會變成「陳, 美., & 林, 小. (2023)」、內文「(陳 et al., 2023)」。ZotMax 附兩個引用樣式，中文文獻改用中文 APA 7，英文文獻維持官方 APA 7：

	中文文獻（語言 zh-TW）	英文文獻
參考文獻	陳美玲、林小華（2023）。題目。護理雜誌，70(2)，45–56。https://doi.org/…	Lee, A., Smith, J., & Brown, K. (2021). Title. Journal, 12(3), 100–110.
內文	(陳美玲、林小華，2023)、(王大明等，2021)、(陳美玲，2023，頁 5)	(Lee et al., 2021)

• 兩個版本：「APA 7 中英混排（臺灣，ZotMax）」各部分之間用「。」（各校論文 APA 7 指引常用）；「APA 7 中英混排（臺灣護理學會，ZotMax）」用「．」、最後是「。」。
• 其他規則：作者全名、以「、」相連，三位以上內文用「等」，參考文獻 21 位以上列前 19 位、「…」和最後一位；期刊名和卷號斜體；書名、學位論文斜體，學位論文寫〔未出版之碩士論文〕或〔碩士論文，校名〕；書的版次（第3版）、編者（主編）、章節「載於…（主編），書名（頁 x–y）」。參考文獻中文在前（依筆畫），英文在後（依字母）。

用法

1. ZotMax 按鈕或快速指令 → 安裝 Word 中文 APA 樣式（或 設定 → 中文 APA 的同名按鈕）。兩個樣式會裝進 Zotero 設定 → 引用 → 樣式；之後 ZotMax 更新樣式時會自動換成新版。
2. 先用 檢查中文文獻資料…（中文文獻補強）整理中文文獻：姓名改成單欄全名、語言設成 zh-TW。語言欄是關鍵：語言不是 zh／zh-TW 的文獻會用英文規則；反過來，華藝常把英文文章也標成中文，補強也會提醒改成 en；從 PubMed 匯入的《護理雜誌》中文文章例外（篇名是英譯，但語言 chi 是對的），補強會請你貼上中文篇名和作者，不會建議 en。
3. Word → Zotero 分頁 → Document Preferences → 選「APA 7 中英混排（臺灣，ZotMax）」→ OK，再按 Refresh。已經插入的引用會一起更新，不用重插。
4. 中文變成方框 □：那是字型沒有中文字。Word → 常用 → 樣式 →「書目」（Bibliography）→ 修改 → 格式 → 字型，把亞洲文字字型設成新細明體或標楷體；內文引用跟著段落的字型。

沒有裝 ZotMax 的同學也能用：到 ZotMax 網站下載 .csl 檔（護理學會版），在 Zotero 設定 → 引用 → 樣式按「+」加入。Zotero 會說它「不是有效的 CSL 1.0.2 檔」，這是正常的：中英混排用到 Zotero 支援的 CSL-M 擴充，按確定安裝即可。

限制

• 題目以「？」「！」結尾時會變成「？。」，交稿前把「。」刪掉（Zotero 會提醒你改過，選保留）。
• 網頁的網站名和作者相同時，APA 會省略網站名，這個樣式不會；可以把 Zotero 的「網站標題」留空。
• 只認語言欄：中文題名、語言是空白的文獻仍用英文規則，所以第 2 步不能省。
• Pandoc 不支援 CSL-M，所以這兩個樣式只能在 Zotero 的 Word／LibreOffice 外掛使用；Pandoc 的限制見下一段。
• 樣式以 Zotero 官方「APA Style 7th edition」（CC BY-SA 3.0）為基礎改作，同樣以 CC BY-SA 3.0 授權；英文文獻的輸出與官方樣式相同。

在 Obsidian 寫論文並用 Pandoc 產生 APA Word

1. 匯出參考文獻檔

方式	產出
ZotMax 按鈕或快速指令 → 匯出參考文獻到 Obsidian	Zotero/90 系統/references.json：我的文獻庫和群組文獻庫的所有文獻
分類右鍵 → ZotMax ▸ 匯出目前分類的參考文獻	Zotero/90 系統/references-<分類>.json（含子分類），citekey 和主檔相同
設定 → 同步 → 參考文獻檔 →「同步時自動更新參考文獻檔」（預設關閉）	每次同步後更新 references.json，內容沒變不寫入

• 主檔包含整個文獻庫：Pandoc 只列內文真的有引用的，還沒建筆記的文獻也能直接引用。
• 要 BibTeX（例如寫 LaTeX）就勾「同時匯出 references.bib」，用 Zotero 內建匯出器，citekey 一樣。

citekey 從哪裡來（和文獻筆記 frontmatter 的 citekey 相同）：

1. Zotero 10 的 Citation Key 欄位
2. Better BibTeX 的 citekey（有安裝時）
3. 都沒有時自動產生：第一作者姓氏 + 年份 + 標題第一個字（略過 the、a、of 等），例如 chen2024effects；中文取標題前四個字，例如 陳2023護理人員。撞名時較晚加入的加 a、b、c。

自動產生的 citekey 記在 Zotero/90 系統/.zotero-bridge-citekeys.json，之後不變；文獻刪除後也不會轉給別篇。修改第一作者、年份或標題第一個字時會換成新的。論文要長期引用的文獻，建議直接在 Zotero 填 Citation Key。

2. 安裝 Pandoc 與 APA 7 樣式：安裝 Pandoc（2.11 以上），從官方 CSL 樣式庫下載 apa.csl（直接下載）放在 vault 根目錄。

3. 在 Obsidian 引用

寫法	APA 7 輸出
[@chen2024effects]	(Chen, 2024)
[@chen2024effects, p. 5]	(Chen, 2024, p. 5)
@chen2024effects	Chen (2024)：敘述式引用
[@chen2024effects; @lee2021sleep]	(Chen, 2024; Lee, 2021)

Pandoc 會把參考文獻列表放在文件最後，在論文最後寫一個 # 參考文獻 標題即可。

4. 產生 Word 檔（在 vault 根目錄執行）：

pandoc 論文.md --citeproc --bibliography "Zotero/90 系統/references.json" --csl apa.csl -o 論文.docx

• 套用學校的字型、行距與邊界：準備一份格式正確的 Word 檔，加上 --reference-doc 範本.docx。
• [[內部連結]] Pandoc 不會轉換，交稿用的檔案請改成一般文字。

5.（選用）邊寫邊預覽：安裝社群外掛 Pandoc Reference List，填入 Zotero/90 系統/references.json 的完整路徑與 apa.csl，側欄會列出這份筆記引用的文獻，方便檢查 citekey 有沒有打錯。

中文文獻在 Pandoc 的限制：references.json 裡中文姓名寫成完整姓名（"literal": "陳美玲"），中文文獻加 "language": "zh-TW"，所以內文是 (陳美玲 et al., 2023)、參考文獻 陳美玲, 林小華, & 歐陽志明. (2023). …：姓名對了，但標點與用語仍是英文規則，中文文獻也排在英文後面。目前沒有 Pandoc 能用的中文 APA 樣式（Zotero 中文社群的樣式用 CSL-M，Pandoc 的 citeproc 不支援，見 citeproc 更新紀錄）；ZotMax 的「APA 7 中英混排」也是 CSL-M，只能在 Word／LibreOffice 的 Zotero 外掛使用（見上一段）。用 Pandoc 交稿前建議：英文文獻用 Pandoc 的結果；中文文獻從文獻筆記的「APA 7」或比較表的參考文獻複製（Obsidian 閱讀模式複製會保留斜體），放在最前面，並把內文的 et al. 改成「等」、& 改成「、」。

回報問題與試用回饋

遇到問題或想給意見，用 ZotMax 裡的這兩個指令最方便（都需要 GitHub 帳號；GitHub 上的內容是公開的）：

• 回報問題…：先跳出對話框，列出會附上的環境資訊，可以按「複製」，或「在瀏覽器開啟 GitHub」打開回報問題表單並自動填進「環境」欄。你做了什麼、發生了什麼事，再自己寫。
• 試用回饋…：打開試用問卷（約 5 分鐘，只有「整體來說有沒有用」必填），版本和模式會先填好。

在哪裡：工具列 ZotMax 按鈕選單的最下面（設定精靈…上方）、快速指令搜「回報」或「回饋」，以及 設定 → ZotMax →「功能」分頁最下面。

環境資訊有什麼：ZotMax、Zotero 版本、作業系統、介面語言、模式（研究生引導／進階／自訂）與跟模式不同的開關、Obsidian／Notion／AI 有沒有設定（只有「有／沒有」）、設定精靈有沒有走完、文獻數的大概範圍（<100、100–1000、>1000），以及最近 5 則 ZotMax 錯誤訊息。錯誤訊息會先拿掉路徑、網址、email、token、Notion ID、引號裡的文字（常是標題）和你的 vault、分類、使用者名稱。不會附上文獻內容、筆記、API key、Notion token 或電腦裡的路徑；送出前在 GitHub 上也還能修改或刪掉。請不要在表單裡貼未發表的研究資料或病人資訊。

常見問題與疑難排解

沒有 API key 可以用嗎？ 可以。同步、閱讀狀態、評讀表、篩選與 PRISMA、儀表板、搜尋連結都不需要 AI。AI 文獻筆記也可以不用 key：設定 → AI → 服務商選「網頁版 AI（複製貼上）」，用網頁版 AI 產生。想自動批次又不想花錢：OpenRouter 有免費模型（不用信用卡，沒儲值時每天約 50 次）。

我有 ChatGPT Plus／Claude Pro，可以直接用嗎？ 訂閱不能當 API key，但可以用網頁版 AI：把提示詞貼到 ChatGPT／Claude 網頁，再把回答貼回來，AI 文獻筆記一樣完整。

重新同步會蓋掉我寫的東西嗎？ 不會。外掛只改自己的區塊（見收集與同步）。直接改 AI 子筆記也沒問題，下次同步會沿用你改過的內容。

更新後 Obsidian 的筆記還是舊樣子，或卡片上下排、沒有排成格狀？ 版面在下次同步時才會換，先在 Zotero 同步一次（研究儀表板和首頁可以用 ZotMax 按鈕 → 更新研究儀表板）。卡片要排成格狀需要 ZotMax 的 CSS 片段：Obsidian 開著時到 設定 → 外觀 → CSS 片段 按重新整理，確認 zotmax 是打開的；被關掉或刪掉的話，到 Zotero 設定 → 同步 → Obsidian 按 安裝看板樣式到 Obsidian。

可以在平板（iPad）上看嗎？ 可以。ZotMax 在電腦的 Zotero 裡產生筆記，平板負責看和劃線；要做的是把 Obsidian vault 同步到平板，三種方式擇一：

方式	費用	優點	缺點
Obsidian Sync（推薦）	付費（以 Obsidian 官網為準）	穩定，CSS 片段和設定也能同步	電腦的 Obsidian 開著時才會上傳
iCloud for Windows	免費	不開 Obsidian 也在背景同步	在 Windows 上偶爾變慢或產生「(1)」衝突檔
Notion	免費	不用處理 Obsidian 同步，iPad 裝 Notion app 就能看	是 Notion 的版面，不是 Obsidian 看板

Obsidian Sync

1. 到 obsidian.md 登入並購買 Sync。
2. Windows 的 Obsidian：設定 → 核心外掛 → 打開「同步」→ 建立新的遠端 vault（設一組加密密碼並記住）；同步設定裡勾「主題與 CSS 片段」和「外觀設定」。
3. iPad：App Store 裝 Obsidian → 建立一個不存在 iCloud 的空 vault → 設定 → 同步 → 連到剛才的遠端 vault，等下載完。
4. iPad 的 設定 → 外觀 → CSS 片段，確認 zotmax 是打開的。
5. ZotMax 的 vault 路徑不用改。ZotMax 同步完後，打開一下電腦的 Obsidian，iPad 才會收到新筆記。

iCloud for Windows

1. iPad：裝 Obsidian，建立 vault 時勾「存在 iCloud」，iCloud Drive 會出現 Obsidian 資料夾。
2. Windows：從 Microsoft Store 裝 iCloud，登入並打開 iCloud Drive。
3. 先關掉 Zotero 和 Obsidian，把原本的 vault 整個資料夾搬進 iCloud Drive\Obsidian\，在資料夾上按右鍵 →「一律保留在此裝置上」（沒有這一步，ZotMax 可能讀不到檔案）。
4. Windows 的 Obsidian 改開新位置的 vault；Zotero → ZotMax 設定 → 同步 → Obsidian，把 vault 路徑改到新位置（有分流規則的話一起檢查）。
5. 不要在電腦和 iPad 同時改同一篇筆記；你的想法寫在「✍️ 我的筆記」裡。

在 iPad 讀 PDF、劃線：裝 Zotero 官方 app、登入同一個帳號（PDF 要同步需要 Zotero 檔案同步：官方空間或 WebDAV），在 iPad 上用顏色劃線，劃線會同步回電腦；電腦的 Zotero 下次同步時，ZotMax 把新劃線寫進文獻筆記，iPad 的 Obsidian 也跟著更新。

還要知道：看板在平板和手機上會自動改成兩欄或一欄，寬表格可以左右滑；文獻總表和研究儀表板的 Bases 檢視需要 iPad 的 Obsidian 也是 1.14 以上；筆記裡點回 PDF 的 zotero:// 連結是給電腦用的，在 iPad 上可能打不開。Mac 配 iPad 時，直接把 vault 放在 iCloud Drive 最簡單。

文獻筆記最上面的屬性區少了研究設計、PICO 等欄位？ 看板版預設只顯示閱讀狀態、標籤和你自己加的屬性，其他資料已經在卡片上；它們仍在 frontmatter，Bases、Dataview 和搜尋都讀得到。想全部顯示：設定 → 同步 → Obsidian，取消「看板：文獻筆記最上面的屬性區只顯示…」，下次同步生效。

選單裡找不到某個功能？ 先到 設定 → ZotMax → 功能 看開關是不是關著（研究生引導有些預設關閉）。找重複、PRISMA、評讀總表、引文追蹤納入研究要先在左側選一個分類；其他功能要先選文獻。

AI 筆記看起來只讀了摘要？ 多半是掃描版 PDF 或沒有 PDF，進度視窗會顯示 ⚠️，frontmatter 的 full_text 也會標出。先用 OCR 讓 PDF 有文字層，再「重新產生 AI 筆記」。

同步到一半想停，或 Zotero 當掉了？ 工具 → 停止 ZotMax 同步；之後 繼續未完成的 ZotMax 同步，失敗的會一起重試。

同步到 Notion 很慢？ Notion API 大約每秒 3 次請求。圖片劃線每次都要重新上傳，Notion 全文子頁面每篇也要 5–10 次請求，不需要的話可以關掉。

Notion 已經有一個「狀態」類型的 Status 欄位？ 外掛不會動它。把它改名後再按「測試連線並補齊資料庫欄位」，外掛會建立單選的閱讀狀態欄位。

可以和 Notero 一起用嗎？ 可以並存，但不要讓兩者寫入同一個 Notion 資料庫，不然同一篇會有兩頁。建議改用本外掛的分流規則。

Zotero 刪掉的文獻，筆記會怎樣？ Notion 頁面移到 Notion 垃圾桶；Obsidian 筆記不會刪，只把 status 改成「已刪除」。

出錯了去哪裡看？ 進度視窗會列出每一篇的結果；詳細記錄在 Zotero 的 說明 → 除錯輸出記錄。仍然有問題，請用「回報問題…」（見回報問題與試用回饋）或到 GitHub Issues 回報。

Zotero 出新的大版本後外掛被停用？ 外掛宣告支援到 Zotero 10.x，依 Zotero 規定不能預先宣告未來版本。Zotero 11 推出時會先停用外掛，確認相容後會自動恢復，不用重新安裝。

隱私與費用

API key 存在哪裡：AI 的 API key（Claude、OpenAI、OpenRouter）、Notion token 和 NCBI API key 都存在 Zotero 的密碼管理員（和 Zotero 同步帳號的 key 同一套機制；有作業系統鑰匙圈時會再加密），不會寫進設定檔 prefs.js。舊版存在 prefs.js 的金鑰會在啟動時自動搬過去並刪除。

什麼時候送什麼給 AI：只有你打開對應開關、而且有 API key 時才會送。用 OpenRouter 時，請求經過 OpenRouter 轉給你選的模型提供者；免費模型的提供者可能保留內容。用網頁版 AI 時外掛什麼都不送，是你自己貼到網站。

什麼時候	送出什麼
同步時產生 AI 筆記（沒有 AI 筆記的文獻）、重新產生 AI 筆記	書目、摘要、全文（見下）、你的劃線評註和 Zotero 子筆記；掃描版 PDF 的檔案本身（預設開啟）；圖片劃線截圖（預設關閉，只限 Claude）
文獻比較表、文獻探討草稿、概念卡片 AI 綜整	各篇的 AI 筆記與結構化資料（沒有的用摘要與劃線）；草稿另外送你在對話框填的研究問題與大綱
AI 主題分類	標題、摘要、一句話摘要和你的主題清單
評讀陪練（按「對照 AI」）	這篇的標題、年份、全文（沒有全文時用摘要）和評讀工具的題目；不送你的答案和評析
讀懂統計	你在 PDF 選的文字、論文方法／統計分析段落的節錄（沒有全文時用摘要）、AI 筆記的研究設計與樣本數
進度報告的 AI 摘要（預設不勾）	報告裡列出的資料

不會呼叫 AI 的：自動同步、PubMed 自動檢查、研究儀表板、概念卡片（不含 AI 綜整）、全文筆記、篩選與 PRISMA、評讀表（不含評讀陪練）、進度報告本身、匯出給 Gemini Notebook（只寫入你電腦上的檔案，上傳由你自己決定）。評讀表子筆記和舊版 AI 筆記不會送給 AI。

其他連網：Notion（同步時）；NCBI（PubMed 追蹤與 MeSH 建議，附你填的 email 與 NCBI API key）；OpenAlex（引文追蹤與搜尋機器人的被引用，附你填的 email 和選填的 OpenAlex API key）。群島地圖打開時不連網。搜尋連結只是在瀏覽器開資料庫的網址，裡面只有檢索詞。網站上的快速搜尋與評讀表不會把資料送到任何伺服器。

費用：AI 費用由你自己的帳號支付。

• 一次替超過 5 篇產生 AI 筆記前會先確認；有用量紀錄時附上預估費用（依過去的平均用量估算，掃描版 PDF 可能低估）。文獻比較表、草稿、AI 主題分類、評讀陪練也都先確認。
• 用量：設定 → AI → 本月 AI 用量 顯示呼叫次數、tokens、估計費用（美元），可重設；每次 AI 執行後進度視窗也有一行摘要，研究儀表板列出近三個月。估計用的價格表可以在同一區修改；OpenAI 沒有內建價格，只顯示 tokens；OpenRouter 直接記它回報的實際金額，免費模型記 0 元。網頁版 AI 不經過外掛，不列入用量。估計值僅供參考，以服務商帳單為準。
• 全文先刪參考文獻：「全文筆記」開著時，送給 AI 的全文是整理好的 Markdown，並先刪掉 References、Acknowledgements、Funding、Conflict of interest（設定 → 整理 → 全文筆記 可關）。同步完成時進度視窗會顯示「全文整理成 Markdown 後送給 AI：N 字（原本 M 字，省下 X%）」。
• 全文最多送出字元數：預設 150,000，在刪減之後才截斷；設成 0 只送摘要與註記，最省。
• 提示快取（Claude，自動）：每篇請求開頭相同的筆記模板會被快取，連續產生多篇時後面幾篇的開頭便宜很多。
• 批次 API（Claude，「批次 API」開關）：大量產生 AI 筆記時約半價，但最久等 24 小時。

提示快取（prompt caching）

• 每篇筆記的請求開頭都一樣：筆記模板（含嚴格評讀規則）＋結構化資料的說明，約數千 tokens。外掛把這段標成可快取，每篇的書目、摘要、全文、註記、PDF、圖片都放在快取點之後，所以連續產生時後面幾篇的開頭以快取讀取計費（遠低於一般輸入）；第一次寫入快取要多付 25%（5 分鐘快取）。
• 快取約 5 分鐘內有效（每次讀取重新計時），逐篇產生時通常一路命中。文獻比較表、草稿等其他 Claude 呼叫也快取各自的模板。
• 開頭太短不會被快取（不會出錯也不多收費）：最短長度依模型而定，約 512–4096 tokens。內建模板夠長；自訂一個很短的模板時可能就不會快取。
• 「本月 AI 用量」顯示快取讀取／寫入的 tokens 與「提示快取：省下約 US$…」。
• OpenAI 也有自動的提示快取，外掛不需設定。

批次 API（Message Batches）

• 開啟後，手動同步時需要產生 AI 筆記的文獻達門檻（預設 10 篇，設定 → AI → AI 服務 → 批次 API 可改），確認視窗同時列出一般模式與批次 API 的預估費用，讓你選「批次 API（約半價）」「一般模式（立即產生）」或取消。
• 選批次：每篇請求（和一般模式內容相同，含掃描版 PDF 與圖片劃線）打包送出，所有 tokens 都是一般價格的 50%。不需要 AI 的文獻照常立即同步。
• 通常 1 小時內完成，最長 24 小時。外掛每 2–5 分鐘檢查一次；Zotero 關閉也沒關係，下次開啟會繼續檢查。完成後寫入 AI 筆記、記入用量，再自動「同步但不呼叫 AI」並通知你。
• 失敗的（請求錯誤、超過 24 小時、取消、模型拒絕處理）加入接續清單：工具 → 繼續未完成的 ZotMax 同步 用一般模式重試。
• 工具 → 檢查 AI 批次進度（已完成幾篇、等了多久、最晚何時結束）；工具 → 取消 AI 批次（已完成的仍會寫入，尚未處理的不收費）。
• 批次請求用 1 小時的快取，寫入費為一般輸入的 2 倍（再打五折）；批次中的快取命中不保證。
• 只支援 Claude；選 OpenAI 或 OpenRouter 時一律用一般模式。「本月 AI 用量」會分開列出「批次 API：N 次呼叫，比一般模式省下約 US$…」。

給開發者

npm install
npm test         # 單元測試 + 模擬 Zotero 環境的整合測試
npm run build    # 產生 dist/zotero-bridge-<version>.xpi，並更新 updates.json

• 名稱：ZotMax 舊名 Zotero Bridge（0.10 以前）。改的只是顯示名稱：外掛 ID [email protected]、偏好設定 extensions.zotero-bridge.*、儲存 API key 的登入資料、chrome://zotero-bridge/、Fluent 檔名與訊息 ID、repo 與網址、.xpi 檔名都沒變，所以舊版會自動更新並保留設定；舊版寫的筆記標記（例如 Notion 頁面上「Zotero Bridge｜…」的區塊）仍會被認得並就地更新。
• 產品與設計：PRODUCT.md（使用者、定位、原則）、DESIGN.md（設定頁與網站的視覺規範）。功能開關的目錄在 content/features.js，字串在 locale/*/zotero-bridge.ftl，預設值在 prefs.js。
• 發布新版本：改 manifest.json 的 version → npm run build（.xpi 與 updates.json 都要提交；test/release.test.cjs 會檢查兩者一致）→ 推送到 main，GitHub Actions（release.yml）建立 Release，Zotero 自動更新。已發布版本在 updates.json 的項目不可更動。
• Zotero 出新的大版本：在新版 beta 上安裝外掛，照安裝精靈第 7 步試跑一篇文獻、一次文獻比較表；沒問題就執行 npm run compat -- 11.*，把 manifest.json 與 updates.json 推到 main，已安裝的使用者會自動恢復啟用，不用發新版。有問題就修正後發新版。依 Zotero 規定，相容版本只能宣告到目前已測試的大版本。

檔案	用途
bootstrap.js	外掛生命週期、載入腳本、註冊設定頁
content/main.js	同步流程、自動同步
content/sidepanel.js、sidepanel.css	右側 ZotMax 面板（項目窗格與 PDF 閱讀器的側欄）
content/commands.js	指令目錄：每個指令的分組、開關、作用對象、搜尋關鍵字；工具列、右鍵選單、快速指令都由它產生
content/menus.js	條目與分類右鍵的「ZotMax ▸」子選單、工具選單（設定、快速指令、批次項目）
content/palette.js／palette.xhtml／.css	快速指令視窗：搜尋、鍵盤操作、不能用的原因、快捷鍵
content/setup.js／setup.xhtml／.css	首次設定精靈：第一次安裝時自動開啟一次、每步確認才存、試同步一篇
content/toolbar.js／.css	工具列的 ZotMax 按鈕：快速指令、依研究流程分組、依開關即時隱藏、方向鍵焦點
content/features.js	功能開關目錄、兩種模式、自訂判斷、一次性升級遷移、依開關隱藏選單
content/preferences.xhtml／.js／.css	設定頁（「功能」區塊、依開關收合的區段）
content/zotero-adapter.js	讀取條目、註記、全文、APA；存 AI 筆記
content/llm.js	筆記模板、評讀與結構化資料的提示詞、JSON 解析、服務商表、Claude／OpenAI／OpenRouter API（重試、用量、OpenRouter 免費額度）
content/manual-ai.js／manual-ai.xhtml／.css	網頁版 AI（複製貼上）：提示詞、整理與檢查貼回的回答（純函式）、視窗、存成 AI 筆記
content/verify.js	可引用句查證
content/scanned.js	掃描版 PDF：全文狀態、傳 PDF 給 AI、沒有內容時略過 AI
content/secrets.js	API key／token 存取（Gecko 密碼管理員）
content/usage.js	AI 用量月報、價格表與費用估算
content/ai-batch.js	批次 API：打包送出、輪詢、重新啟動後續查、結果套用、取消
content/notion.js	Notion API（2025-09-03，data sources）、中英文欄位與依 ID 對應、收合區塊
content/status.js	閱讀狀態三邊合併與同步
content/core.js	Obsidian 筆記組裝（導覽列、「重點」看板卡片＋四組摺疊區塊、cssclasses、劃線顏色意義）、frontmatter 合併、分流規則、資料夾結構（依 Zotero 分類）

真實 Zotero 測試（e2e）

npm test 用模擬的 Zotero；.github/workflows/e2e.yml 則把建置好的 .xpi 裝進真正的 Zotero 10（Linux 版、當下最新的正式版）跑一次。每次 push、PR 自動執行，也可以在 GitHub → Actions → e2e → Run workflow 手動跑。不連 Notion 或任何 AI 服務。

test/e2e/run.sh 建立全新的 Zotero 設定檔，把外掛和測試用的小外掛（test/e2e/harness/）放進去，在 Xvfb 下啟動（另開一個已解鎖的 gnome-keyring）。Zotero 啟動兩次：先不裝外掛記下 Zotero 本身的主控台錯誤（baseline.json），再裝外掛執行檢查，結果寫進 results.json。結果表格在該次 Actions 的摘要；失敗時另外上傳 results.json、zotero.log 和測試用的 vault。

• 外掛已啟用、所有模組都載入；啟動時沒有外掛的錯誤，也沒有「不裝外掛時不會出現」的錯誤
• 右鍵（各一個 ZotMax 子選單）／工具選單、設定頁、條目窗格區塊都有註冊；快速指令視窗打得開、找「分類」第一個是文獻自動分類、Esc 關閉、快捷鍵有效；所有 Fluent 字串在 en-US 與 zh-TW 都找得到
• API key 經由真正的密碼管理員存取並有作業系統鑰匙圈加密；舊版設定的搬移
• 在真的文獻庫建立條目（中文作者、子筆記、標籤、分類）與 PDF 附件（有文字層的與純圖片的），由 Zotero 的 PDF worker 判斷 ok／none／no_pdf
• 同步到 Obsidian（不呼叫 AI）：筆記、frontmatter、.base 檔、中文 APA 與 Zotero citeproc 的英文 APA
• 閱讀狀態寫回 Zotero 標籤；references.json 與 references.bib
• 篩選決定寫到標籤，產生 PRISMA 筆記與證據表 CSV
• 自動同步；AI 筆記（只把外掛內的 fetch 換成假的 Claude 回應）
• 文獻自動分類（只用規則與研究設計推測）：建立子分類、不重複建立、復原後清乾淨、原本的分類不變；確認視窗按「取消」不寫入
• 匯出給 Gemini Notebook：關掉「預設匯出到雲端硬碟」，確認預設位置不在 Google 雲端硬碟；把測試條目匯出到工作資料夾，檢查 Markdown、參考文獻清單、README 都有寫出，PDF 只有勾選時才複製；匯出視窗從 chrome://zotero-bridge/ 打開、樣式有載入、取消不寫入
• 中文文獻補強：一筆資料凌亂的中文條目（民國年、全形頁碼、兩位作者擠一格、DOI 在「其他」欄、語言空白）在確認視窗套用後欄位正確、存進資料庫，復原後回到原樣，測完刪除
• 條目窗格顯示 AI 筆記；設定頁能開啟、值與已存的 token 正確，關閉後新輸入的 key 有存下
• 工具列按鈕的位置、名稱、圖示、方向鍵；兩種模式下選單依開關顯示；關掉「工具列按鈕」即時隱藏
• 網頁版 AI：視窗從 chrome://zotero-bridge/ 打開、樣式有載入，「複製提示詞」含這篇的資料，貼回的回答即時檢查後存成 AI 子筆記並同步到 Obsidian
• 整理 vault：把前面測試寫出的平鋪 vault 搬到 10 文獻/<分類>、00 首頁、90 系統，使用者自己的連結跟著改，之後的同步寫在新位置
• 停用再啟用外掛：選單、區塊、FTL、工具列按鈕都清掉再註冊回來

Zotero 10.0.6 每註冊一次外掛的語系檔就會在主控台記一筆 uncaught exception: undefined（不裝外掛時一樣會發生，由 baseline 驗證），不算外掛的錯誤。Zotero 的背景搜尋索引在測試期間關掉：測試用的掃描版 PDF 索引不了，它幾秒後會在主控台記「Full-text index queues aren't draining」，落在剛好在跑的測試上；外掛不使用這個索引。

開發環境連不到 PubMed、OpenAlex 和各資料庫，所以 .github/workflows/link-check.yml 在 GitHub Actions 上實際連線（每週一自動執行；改了 content/search-links.js、pubmed-watch.js、citation-chase.js、site/search.html 也會跑；可在 Actions → link-check → Run workflow 手動執行）。

• test/live/check-links.mjs 用外掛與網頁的資料庫清單組出每個搜尋網址，以 fall prevention older adults（中文資料庫用 跌倒 預防）實際開啟：一般 HTTP 連線加上無頭 Chromium，判斷是結果頁、首頁、登入頁、被擋或壞掉。不確定的會試其他網址寫法，開首頁的會在網站搜尋框實際輸入。
• NCBI E-utilities：用外掛自己的函式組網址、解析回應，確認用到的欄位都還在。
• OpenAlex：引文追蹤用到的每個參數，最後用 chase() 對一篇常被引用的護理研究（Aiken et al., 2002, JAMA）實際跑一次。
• 結果在該次執行的摘要與 link-check-report 附件。只有明確壞掉（404、網址錯誤、NCBI／OpenAlex 欄位不符）才算失敗；擋雲端主機的網站標成「被擋」，不算失敗。