📈 GH Trending Explorer 🎲 Surprise me

← all repos

YuriyLin / PaperRead

git clone https://github.com/YuriyLin/PaperRead.git v1.5.0 · 2d ago

PaperRead|論文閱讀、研究探索與知識整理工作區

+4
stars, 24h · #6,836
+~33
stars, 7 days · #5,654
+310
stars, 30 days · #2,625
310
★ total · +12% this week
13
forks · 0 open issues

Star history (as recorded here)

2026-10-20 · 296 ★ 2026-10-23 · 310 ★
LanguagePython
LicenseMIT
Created2026-10-09 (13d ago)
Last push1d ago
Watchers0
OwnerUser

Links

README excerpt
# PaperRead
 從研究探索到論文精讀的個人研究工作區 
 以繁體中文介面閱讀論文、整理候選清單、規劃閱讀路徑,並保留可回到原文核對的研究脈絡。
 下載 PaperRead ·
 回報問題 ·
 English 
PaperRead 是以 EasyRead 為基礎整理的個人研究工具。它保留原有的 PDF 排版、雙語閱讀、原文定位、批註與 AI 對話能力,再加入研究探索和閱讀規劃流程,讓「找到論文」與「真正讀懂論文」接在同一個工作區裡。
## 這個版本和上游 EasyRead 的差異
| 面向 | PaperRead 的調整 |
|---|---|
| 介面語言 | 預設使用 `zh-TW`,介面用語根據臺灣語境做調整,例如「設定、匯入、匯出、儲存、資料夾、候選清單」。英文技術名詞與論文術語保留原文。 |
| 品牌與桌面程式 | 使用 PaperRead 名稱、新版標誌及 `YuriyLin` 發行者中繼資料;安裝檔為 `PaperRead-Setup-x.x.x.exe`。 |
| 論文閱讀 | 延續原文/譯文對照、公式、PDF 頁面定位、螢光筆、筆記、問 AI、模型切換和 token 使用量記錄。 |
| 研究流程 | 新增「研究探索、閱讀看板、候選清單、已整理摘要、閱讀路徑」工作區;閱讀路徑支援地圖/清單切換、引用關係與背景分析通知。 |
| 快速檢視 | 看板卡片可開啟 Quick Peek 抽屜,查看概覽、摘要、最近筆記、劃線與最近問題,並直接修改狀態、分類與星標。 |
| Obsidian 知識庫 | 摘要、論文分析、閱讀標註、心智圖與跨論文比較可直接匯入 Vault,使用穩定 ID、來源證據與 WikiLinks 持續累積。 |
| Linux/Docker 相容性 | 修正 Docker 版 Linux Firefox 閱讀器導覽按鈕與段落工具列操作,並改善 macOS 打包版研究資料查詢的憑證處理。 |
| 研究視覺化 | 可根據目前論文內容產生繁體中文 Mermaid 心智圖,協助理解研究問題、方法、發現、貢獻與限制。 |
| 智慧標註 | 可依全文、章節或研究目的產生 AI 標註建議;接受前先逐筆審閱,不會覆蓋手動標註。 |
| 影像與表格 | 論文圖片和表格保留版面佔位,直接回到原 PDF 檢視;不把裁切結果硬塞進譯文排版。 |
| 資料相容性 | 使用者資料遷移至 `PaperRead` 資料夾;Python package、CLI、舊資料格式與 `easyread://` 連結協定仍保留相容層。 |
## 主要工作流程
 [code] 
這些狀態彼此分開:搜尋結果不等於候選論文,候選論文不等於已整理摘要,也不會因為加入候選就自動加入閱讀看板。
## 研究探索
研究探索是 PaperRead 的研究入口,提供兩種搜尋方式:
### 主題搜尋
輸入研究概念或問題,例如:
- `Long Video Understanding`
- `Vision-Language Models`
- `3D Scene Understanding`
PaperRead 會先取得可用的公開書目資料,再顯示標題、作者、年份、摘要、來源、DOI、引用資訊和 PDF 可用性。搜尋結果會標示資料來源,缺少的欄位顯示「未提供」,不把缺漏資料當成零。
### 會議/期刊搜尋
可一次輸入一個或多個出版來源,例如:
 [code] 
PaperRead 會依來源拆分查詢,支援常見的學術會議與期刊。結果會保留出版來源、DOI 和可查證連結,並區分正式出版資料與預印本;搜尋結果中的會議名稱不會被直接當成正式發表證明。
目前探索資料主要使用 OpenAlex,會議/期刊書目查詢也可使用 DBLP 與 Crossref 補充。服務限流或網路中斷時會保留既有結果並提供重試,不會把「服務失敗」誤顯示成「沒有論文」。
每張論文卡片只保留研究探索階段需要的操作:
- **加入候選**:先儲存論文,不會立刻生成摘要或下載 PDF。
- **論文來源**:開啟可查證的出版頁、DOI 或來源連結。
## 閱讀看板
閱讀看板是研究探索頁面的主要工作區。論文可以拖曳到不同狀態列位,狀態由使用者決定,不會因為開啟 PDF 或讀到最後一頁而自動改變。
預設狀態包含:
- 待閱讀
- 閱讀中
- 待整理
- 已完成
閱讀進度百分比獨立顯示,只代表閱讀位置,不代表已經理解或完成筆記。看板支援分類、PDF 可用性、感興趣標記與手動優先順序篩選;首頁、閱讀器研究面板和看板的星標會同步。
加入閱讀看板時,分類使用可複選的分類卡片,不需要使用鍵盤搭配下拉選單。一次可以將論文放入多個研究方向;沒有分類時也可以先加入看板,之後再整理。
點擊卡片空白處會從右側開啟 **Quick Peek**,不離開看板即可查看完整書目、摘要、分類、閱讀狀態、星標、進度與來源資訊。閱讀紀錄區會分開顯示最近筆記、劃線與最近問題;點擊紀錄可回到閱讀器對應段落。抽屜底部提供上一篇、下一篇與繼續閱讀,背景更新時會保留目前的論文與捲動位置。
## 候選清單
候選清單用來儲存「值得之後研究」的論文。它會跨頁面保留,與閱讀看板及已整理摘要分開管理。
加入候選後,PaperRead 會在背景批次整理來源摘要。一次加入多篇時會排入佇列,避免同時傳送大量請求。你仍然可以自行決定:
1. 檢視候選論文。
2. 移除不再需要的論文。
3. 對個別論文重新整理摘要。
4. 檢視 Markdown 摘要。
5. 使用「匯出摘要」儲存檔案。
6. 將選定論文加入閱讀看板。
候選論文不會自動變成已讀,也不會自動覆蓋你的正式筆記。
## 已整理摘要
已整理摘要會獨立儲存,即使論文之後移出候選清單,摘要仍可保留。摘要內容以 Markdown 儲存並使用與筆記一致的安全渲染方式,支援:
- 標題與副標題
- 粗體、斜體
- 有序與無序清單
- 程式碼區塊
- 表格
- 系統已支援的數學公式
主要操作順序是:
 [code] 
摘要由模型根據實際取得的論文資料產生;缺少的來源資訊會標示「未提供」,不捏造研究結果或出版資訊。
摘要可直接匯入已設定的 Obsidian Vault,檔案會寫入 `Research/05-論文摘要`,使用英文論文名作為受限制長度的檔名,不額外建立子資料夾。下載時,單一項目輸出 Markdown,多個項目輸出包含完整資料夾結構的 ZIP。
## 閱讀路徑
閱讀路徑可以從研究主題或指定論文開始。例如:
 [code] 
PaperRead 會依目前可取得的論文資料,將推薦結果整理成有順序的路徑。每篇論文會附上:
- 閱讀順序
- 閱讀角色,例如基礎入門、方法理解、代表性研究、延伸探索或前沿研究
- 推薦理由
- 與主題或起點論文的關聯
- 年份與出版來源(可取得時)
AI 只能重組已查詢到的論文資料,不能自行新增不存在的論文。資料不足時會明確說明,基礎搜尋與看板功能也不會因 AI 不可用而停止。
產生後可在地圖/清單之間切換,使用縮放、平移、節點選取與提前/延後調整閱讀順序。虛線箭頭表示建議閱讀順序,實線箭頭表示目前路徑內可由 OpenAlex 確認的引用關係。閱讀路徑與