前言¶
在 DeepSeek Harness（dsh）裏做論文修訂，常見的問題是：PDF 批註、LaTeX 源碼編輯、編譯結果和 git 歷史分散在不同步驟裏。PaperLab（maple-pwn/paperlab）把這些步驟放在同一個工作臺裏：在渲染後的 PDF 上選中文字寫批註，再由 dsh agent 按批註修改源碼、檢查編譯並提交 git。PaperLab 的 AI 執行引擎完全運行在 DeepSeek Harness 裏，工作臺從不直接調用模型 API。
這是什麼¶
PaperLab 是一個 Overleaf 式論文迭代修改工作臺，AI 引擎是 DeepSeek Harness 插件。倉庫由 maple-pwn 維護，許可證爲 MIT © 2026 PaperLab contributors。
它解決的問題很具體：讓“讀批註、改論文、看真實 PDF、回滾版本”在同一個流程中完成，同時把模型執行、工具調用和版本管理交給 dsh 的 agent 流程。
核心功能¶
界面與批註¶
- Overleaf 式三欄佈局，面板可拖動。
- 在 PDF 上選中任意文字寫意見。
- 黃色高亮精確落位，基於頁面座標。
- 真實 PDF 渲染，公式圖表排版一致。
- 源碼編輯即自動保存、自動編譯。
AI 修訂¶
AI 修訂基於 dsh agent，流程是：
讀批註 → 唯一匹配編輯 → 編譯檢查 → git 提交
工作臺提供寬屏軌跡，直播思考過程、工具調用和輸出，並帶計時與 LIVE 狀態。也可以在工作臺內切換模型、思考強度和編排模式。
版本管理與工程能力¶
- 每個項目即 git 倉庫，AI 修訂自動 checkpoint。
- 支持歷史瀏覽、任意 diff、一鍵 revert 回滾。
- 一鍵導出：源文件（含批註）/ PDF / git 歷史。
- 自動識別 XeLaTeX，尊重
latexmkrc，並提供多編譯引擎降級鏈。
安裝與啓用¶
先確認前置環境：
Node.js ≥ 20
pnpm ≥ 10
Python ≥ 3.11
git
DeepSeek Harness（dsh）
LaTeX 可選
將插件安裝到 paperlab profile：
dsh plugin --profile paperlab add github:maple-pwn/paperlab
倉庫根即符合官方規範的 dsh bundle，包含：
dsh.bundle
cordis.patch.yml
lib/
注意：安裝插件等於運行第三方代碼。請先閱讀源碼，並在不保存密鑰的環境中試用。
典型用法¶
先做克隆和進入倉庫：
git clone https://github.com/maple-pwn/paperlab.git
cd paperlab
再啓動工作臺。可運行啓動腳本：
./start.sh
也可以運行 Make 目標：
make start
start.sh 自動完成：裝依賴 → 構建 → 安裝插件到 dsh profile → 啓動 dsh → 啓動工作臺。
啓動後打開瀏覽器工作臺：
http://127.0.0.1:8210
模型憑據屬於 dsh。在 dsh Web UI 的「模型」頁配置即可：
http://127.0.0.1:3080
PaperLab 不接觸任何 API key。
如果需要驗證構建或測試，可運行：
make test
適用場景與注意¶
PaperLab 適合這類場景：
- 需要在瀏覽器中迭代 LaTeX 論文。
- 希望在真實 PDF 上做批註，而不是隻改源碼。
- 希望 AI 修改有編譯檢查、git 提交和可回滾記錄。
- 希望模型憑據和模型調用都留在
dsh側。
使用注意：
- PaperLab 的 AI 執行引擎完全運行在 DeepSeek Harness 裏，工作臺從不直接調用模型 API。
- 插件運行時會處於當前
dsh進程的權限上下文中；安裝前應檢查源碼、許可證和運行環境。 - 模型憑據配置在
dsh的「模型」頁，不要將密鑰放入 PaperLab 項目。 LaTeX是可選前置；實際編譯能力仍依賴本地環境。
相關資源¶
GitHub 倉庫：
https://github.com/maple-pwn/paperlab
