🧭 總覽 · 怎麼開始
這是給忙碌醫師／醫學生的 PubMed 文獻巡房工作台：把抓到的文獻保存、去重、triage、逐篇導讀，
再聚成專題做跨篇合成、找缺口、寫裁決、匯出引用。這是文獻巡房與導讀，不是診療建議。
一分鐘運作
文獻進 Library → 把相關的聚成一個 Collection → 設研究框架 → 產生 跨篇合成（AI 跨篇＋規則式把關）
→ 你覆核／裁決分歧與缺口 → 分享／匯出。背後是一條 7 棒 agent relay 在接力（細節見最後一章「附錄」）。
怎麼開始（3 步）
- 進 Library 找論文：watchlist／Scout 會自動抓 PubMed；也可從 Scout 候選一鍵 ingest。
- 建一個 Collection、加入論文，到「🎯 研究框架」設 PICO ＋ 範圍邊界（框由你擁有，AI 只在框內動作）。
- 產生跨篇合成，然後照左側各章去讀懂答案、覆核分歧、分享。
這本手冊以「你當下要判斷什麼」分章（不是以 agent 分章）；每章會標出該答案由哪一棒 agent 產生，
想了解 agent 本身看最後一章附錄。
📋 這批文獻能下結論嗎？
由 Synthesizer（綜述官）產生 · 規則式計票，非 AI 自由發揮
在 collection 點「✦ 產生跨篇合成」，系統會跨每篇已驗證的導讀 claim做共識／分歧矩陣（強制 Claude Sonnet，數十秒）。
怎麼讀 brief 那一行
鴉片用量：4 支持／0 無差異／1 相反 · 5/6/8
- 前半（4／0／1）＝這個維度上各篇的立場票數。
- 後半（5/6/8）＝分析篇數／有導讀篇數／全集篇數。分母對「分析篇數」，不是全集——所以分母會小於你加進來的論文數，這是誠實，不是漏算。
哪些可信、哪些是詮釋
- 規則式計票（共識摘要、分母）＝可追溯的硬計算。
- ⚖ 分歧軸＝AI 詮釋層（哪裡可能分歧），明確圍欄、非原文事實。
- 覆蓋不足（有導讀的篇數未達門檻）→ 系統不下跨篇共識、只列覆蓋狀態（誠實退化，不硬湊）。
🚫 為什麼這篇不算 / 被排除？
由 Synthesizer ＋ Scout 的分類 ＋ Methodologist（QC）共同把關
一篇論文「顯示得到、但不計入共識分母」可能有幾種不同原因——它們意思不一樣，系統分開標：
- 🚫 框外·排除：這篇講的是你在 PICO 框裡排除的東西（scope_exclude）。顯示但不進分母。
≠ 不可比——框外是「超出你設的範圍」。
- 🧪 病例報告·不計入共識：case report／series 是 n=1／幾例，顯示其發現但不算共識證據。
- 不可比（not-comparable）：在範圍內，但量的不是同一件事（時間點／族群／指標／定義不同）。可拆成不同維度或並排裁決。
- 📉 僅低階證據（只在「證據調節＝strict」時）：某維度的共識只靠觀察研究、沒有 RCT／系統綜述撐 → 標為缺口，提示去找高階證據。
- 🔒 此類型禁用跨篇共識（如病例彙整 type）：這型本來就不下跨篇共識。≠「共識不足」（後者是證據不夠）。
- QC 降級：若某 claim 其實沒真的報這個維度（借用／離題），Methodologist 會把它降成 not-comparable。
⚖ 哪裡需要我（人）覆核？
由 Gap-finder（缺口偵察）指路 · 由你做最終裁決（Decision Ledger）
分歧 → 並排裁決
某維度立場不一致時，點「⚖ 並排裁決」：系統沿差異 facet（時間點／族群／比較組／指標／定義／era）把衝突的篇並排，
讓你判定是真分歧還是不可比。你的判定寫進 Decision Ledger（人工層），會流入分享 brief——
這是第三種來源（不是 AI 詮釋、不是規則計票）。
🔭 缺口偵察（規則式、零 AI）
從合成矩陣推導出缺口，並路由到對的下一棒：
- 證據薄／僅病例／僅低階 → 往前回 Scout：一鍵用建議 query 搜 PubMed（你再挑要不要 ingest，不自動入庫，避免主題漂移）。
- 抽取缺口（原文沒定位到）→ 往後回 Appraiser 重讀。
- 分歧／疑不可比 → 往旁開並排裁決。
缺口能停：「飽和（讀夠了可以停）」與「目前無法回答」都是一等發現，不是失敗。
🔁 重跑 · 接受 · 分享 · 匯出
由 Curator（策展／引用官）產生可分享 / 可引用的成果
- ⚠ 已過時：論文／導讀／框／類型 recipe 一變動，合成就標「已過時，建議重生」——不會把舊矩陣當現況。
- ✓ 接受版本：凍結一份不可變快照（給 guideline 類型的「🔬 變化」做基準）。
- 🔬 鏡頭切換：同一個 collection 可同時保留多個產出物鏡頭（跨篇共識／journal club／guideline 變化…），互不覆蓋、隨時切換或新增。
- 🔗 分享 brief：產生公開唯讀快照連結（自動剝除私人 review／筆記，全文 PDF 引文不轉載）。
- ⬇ 匯出：RIS／BibTeX／CSL 引用，或 journal-club .md outline。
大部分全域動作都在 collection 左側 nav 頂的 ⋯ 選單（改名／重生／分享／匯出／刪除）。
🧪 範例走一遍
主題：肋間神經冷凍消融 vs 一般神經阻斷——微創胸／食道手術後鎮痛（示意流程，數字為舉例）。
這個例子貫穿前面每一章的問題。
- 建 collection、加入論文（Library 搜尋加入，或到「📄 論文」分頁加）。
- 🎯 設框：P＝微創食道／胸手術成人；I＝肋間神經冷凍消融；C＝一般神經阻斷／標準鎮痛；
核心 outcome＝術後疼痛分數、鴉片用量；排除＝開胸大切除、主動脈、小兒。
- 🧭 選類型：選
journal_club（合成偏批判評讀視角）。換類型會把合成標「已過時」，重生即套用。
- 📋 產生跨篇合成 → 讀 brief：鴉片用量：4／0／1 · 5/6/8（6 篇有導讀中 5 篇測了此維度；全集 8）。
- 🚫 框外剔除：那篇「開胸大切除」被標框外·排除——仍看得到、但不進分母。
- ⚖ 分歧 → 並排裁決：某維度 supports vs opposes，沿 facet 發現是「時間點不同」→ 判不可比，記進 Decision Ledger。
- 🔭 缺口：「術後 3 個月慢性疼痛」證據薄 → 一鍵 (→ Scout) 搜，你再挑要不要 ingest。
- 📉 strict：「鴉片用量」共識若全是觀察研究 → 標「僅低階證據」，提示找 RCT。
- ✓ 接受 凍結基準 → 加新 RCT 重生 → 🔬 變化：⬆ 強化 鴉片用量：3 支持/0 相反·共3篇 → 5/0·共5篇（標明「PubMed 文獻信號，非官方指引」）。
- 🔗 分享 / ⬇ 匯出。
🔖 看不懂某個標記？
誠實慣例（為什麼這些數字可信）
- 「—」＝沒資料／算不出，不填預設、不腦補。
- AI 產出 vs 規則式分標：分歧軸是 AI 詮釋；共識計票是規則式，兩者分開呈現。
- 分母對「分析篇數」非全集；超上限未納入的論文會明白列出。
圖示 / 名詞速查
| 圖示／詞 | 意思 |
|---|
| 🎯 研究框架 | 你設的 PICO ＋ 範圍邊界；AI 只在框內動作 |
| 🧭 類型分流 | type＝一組行為 recipe（共識模式／產出物／證據調節已生效） |
| 📋 當前答案 | 跨篇合成 brief（規則式計票） |
| ⚖ 分歧軸 / 並排裁決 | AI 詮釋的分歧維度／你沿證據做的人工裁決 |
| 🔭 缺口偵察 | 規則式從矩陣推導的缺口，路由到對的下一棒 |
| 🔬 變化 | 相對上次接受版本的差異（PubMed 信號，非官方指引） |
| 🚫 框外·排除 | 超出框的論文，顯示但不計入共識 |
| 🧪 僅病例報告 · 📉 僅低階證據 | 證據階層偏弱（📉 只在 strict 模式出現） |
| 🔒 禁用共識 | 此類型不下跨篇共識（≠ 共識不足） |
| matched / snapped / absent | claim 原文定位：找到／貼近／未定位（方向性結論只採信前兩者） |
🤖 附錄：7 棒 agent 速查
系統內部是一條角色接力（role-agent relay）：
Scout → Screener → Appraiser → Synthesizer → Curator → Tutor → Gap-finder →（回 Scout）。
一般使用不需要記這個——前面各章已用「你要判斷什麼」帶你走。這張表是給想了解內部、debug 或追責時看的。
狀態誠實標註：✅ 全棧上線｜🟢 大致已做（有小尾）｜🟡 部分／併入別處。
| # | Agent | 做什麼 | 狀態 |
|---|
| 1 | Scout 探子 | PubMed 發現＋相關性打分＋分類（study_type/topics） | ✅ 上線 |
| 2 | Screener 篩選 | 相關性過濾＋triage | 🟡 併入 Scout／Library 手動 status |
| 3 | Appraiser 評讀 | 逐篇證據抽取（導讀 claim、study type、limitations） | 🟢 大致已做（尚未包成單一「評讀 verdict」） |
| 4 | Synthesizer 綜述官 | 跨篇共識／分歧矩陣＋證據分級 | ✅ 上線 |
| 5 | Curator 策展／引用 | 把成果存成可分享／可引用的 brief | ✅ 上線 |
| 6 | Tutor 陪讀 | 逐句解說＋epistemic 分層 | 🟢 大致已做（drill 後端就緒、前端未全浮出） |
| 7 | Gap-finder 缺口偵察 | 從矩陣缺口生下一個 query → 回對的上游 agent | ✅ 上線 |
支援角色
- Classifier（反向 relay）：合成遇到設計不明的論文 → 標旗 → 一鍵回去補分類 → 重生。
- Methodologist（QC）：合成內獨立再判每個方向性 cell 是否真報該維度，借用／離題的降級。
- 人工裁決（Decision Ledger）：你沿證據並排做的判斷——第三種來源，會流入分享 brief。
relay 迴路：正向（Scout→Synthesizer）、反向（Synthesizer→Classifier）、大迴路（Synthesizer→Gap-finder→Scout）三段皆通；
回 Scout 刻意留人為閘（缺口→一鍵 PubMed，不自動 ingest，防主題漂移）。