paper-search 是做什麼的？
搜尋官方 API 並讀取合法 PDF。只有在本次工作階段中已讀取的摘要或 PDF 頁面中包含的科學主張才被允許。請勿憑記憶、部落格或任何其他次要文章提供。每個主張都必須追溯至其原始論文。
年份、DOI 和引用次數皆來自腳本輸出。若 citations=-，表示該來源未提供引用次數。請如實說明，不要自行估計。
委派閱讀工作
對於文獻回顧、最新技術調查或任何需要多篇論文的報告，請啟動一個背景代理來進行閱讀，以便本次對話可以繼續進行。單篇論文或已知 DOI 則留在這裡處理。
背景代理的任務：
- 針對論文本身（而非次要文章）調查問題。
- 將發現結果寫入單一 Markdown 檔案，並為每個主張標註來源。
- 將檔案存入儲存庫中原有放置此類筆記的位置。遵循既有的命名慣例。若無現存慣例，則寫入
docs/notes/<主題>.md並告知儲存位置。
提供給它 scripts/papers.py 的絕對路徑、問題、領域以及輸出路徑。它使用下方腳本，不會重新實作 API。
腳本
scripts/papers.py 位於此檔案旁。僅使用標準函式庫。請使用絕對路徑執行。
python3 scripts/papers.py search "QUERY" [--domain auto|ml|phys|math|bio|psy|chem] [--limit N] [--year 2020|2020-2024|2020-] [--sort relevance|citations|date] [--abstract]
python3 scripts/papers.py read PDF_URL --pages 1-3 [--out notes.txt]
python3 scripts/papers.py oa 10.xxxx/yyyy
oa 會從 Unpaywall 印出 is_oa= 和 pdf=。一次查詢，--limit 最多 10。如果結果列表不正確，請變更查詢。不要翻頁。
可選用環境變數：SEMANTIC_SCHOLAR_API_KEY（減少 429 錯誤）和 PAPER_SEARCH_EMAIL（用於 OpenAlex 和 Unpaywall）。
路由
在搜尋前先將查詢翻譯成英文。
| 主題 | --domain | 首要來源 | 若失敗則使用 |
|---|---|---|---|
| AI / ML / NLP / 視覺 / 機器人 / 資訊科學 | ml | arXiv | Semantic Scholar，再來 OpenAlex |
| 物理 / 天文 | phys | arXiv | Semantic Scholar，再來 OpenAlex |
| 數學 | math | arXiv | Semantic Scholar，再來 OpenAlex |
| 生物 / 醫學 / 遺傳學 / 藥學 | bio | Europe PMC | Semantic Scholar，再來 OpenAlex |
| 心理學 / 認知科學 | psy | Europe PMC | Semantic Scholar，再來 OpenAlex |
| 化學 / 材料 | chem | Semantic Scholar | OpenAlex |
| 混合或不確定 | auto | Semantic Scholar | OpenAlex |
- 最新技術或「引用最多」：使用
--sort citations。arXiv 沒有引用次數，因此此排序會從 Semantic Scholar 開始。 - 什麼是新的：使用
--sort date或--year 2023-。 - 已知標題的論文：直接以英文標題搜尋。搭配
--sort relevance，完全相同的標題會排在首位。
篩選
使用 --abstract 執行搜尋。只保留你會用到的論文。
- 里程碑式論文：被大量引用且發表超過兩年。
- 近期論文：近兩年內發表且與問題相關，即使引用次數不多。
- 邊緣論文：僅稍微相關。將其排除在筆記之外。
讀取
- 除非使用者要求特定方法、數值或引用，否則摘要已足夠。
- 只有在必要時才打開 PDF：
read URL --pages 1-3。對於結尾部分，請讀取最後 2–4 頁。若不知道總頁數，則停留在 1–3 頁。不要猜測頁碼。 - 出現
ERROR: not a PDF或pdf=(no open PDF…)：執行oa <DOI>並讀取其輸出的pdf=。如果pdf=-，表示沒有合法的直接 PDF。保留摘要。請勿將url=的登陸頁面視為論文本身。 - 以下主機可以直接讀取：
arxiv.org、europepmc.org、ncbi.nlm.nih.gov以及大學儲存庫。任何其他主機都必須先透過oa處理。 - 請勿使用 Sci-Hub、Library Genesis 或其他影子圖書館鏡像站。
每次執行最多讀取三個 PDF。如果問題需要更多，請從摘要完成，並列出你未打開的論文。
筆記
# <問題>
## 發現
- 主張，僅限於摘要或指定頁面中有提及的內容。(Vaswani et al. 2017, 10.48550/arXiv.1706.03762, 摘要)
## 論文
- **Attention Is All You Need** (2017) — 120404 引用，OpenAlex
- doi: 10.48550/arXiv.1706.03762
- pdf: https://arxiv.org/pdf/1706.03762
- 讀取：僅摘要
- 選用原因：來自該文的一行文字
## 未讀取
- 因離題而排除的論文，或未打開的 PDF。
在對話中，指向該檔案。不要直接貼回內容。單篇論文回覆（從未存成檔案）也遵守相同的引用規則：作者、年份、DOI，以及資訊來自摘要或哪幾頁。