前言¶
DeepSeek Harness（DSH）的「一切皆插件」理念讓開發者可以按需組合能力。在學術研究場景中，一個常見痛點是：多篇論文需要快速橫向對比，但缺乏統一的拆解框架和頁碼引用。手工做表既耗時又容易遺漏細節。下面介紹一個面向 DSH 的文獻拆解插件。
插件定位與解決問題¶
Paper Matrix 是一個本地 SQLite 庫的論文閱讀矩陣工具，支持中英雙語拆解，併爲每一項拆解保留 PDF 頁碼與原文引用。它面向經管與計算機交叉研究，也適合數據集和基準論文的橫向初讀。這是獨立社區插件，由 cvnices8-byte 維護，當前首版爲本地單人試用版 0.1.1，使用 Harness 原生插件和側欄接口。
核心功能¶
插件在一張總表中維護 11 個字段：
- 文獻類型
- 研究問題
- 數據與樣本
- 方法與構建
- 底層證據設計
- 評測範圍
- 實驗或識別設計
- 評價指標
- 核心發現
- 侷限與邊界
- 代碼與數據
中文默認概括，保留原題名、譯題、專業術語、原語言引用；論文語言與數據語言分開。AI 草稿與人工修訂分兩層，重跑分析時保留人工修訂；版本衝突時會拒絕覆蓋。閱讀狀態與覈驗狀態獨立，分析完成不會自動把文獻標爲已讀。
PDF 匹配按物理頁碼進行，逐頁提取文本查看和原 PDF 下載。CSV 是工作臺預覽，JSON 是當前快照，保留證據、實驗子記錄、爭議與人工層，但不含全部歷史。
安裝與啓用¶
環境要求：DeepSeek Harness 0.2.1-rc.2（驗證版本），dsh 命令可用，Python 3.9+，系統命令 python3 可用；從源碼構建時需 Node 22.13+ 和 npm。
桌面端安裝：
打開 插件 → 添加插件，在「包名或地址」輸入：
https://github.com/cvnices8-byte/dsh-paper-matrix
點擊「安裝」，完成後在會話右側欄打開「文獻拆解」。
獨立網頁端 / CLI 安裝：
dsh plugin --profile paper-matrix add https://github.com/cvnices8-byte/dsh-paper-matrix
也可從 Releases 下載對應版本的預編譯 .tgz。首次安裝推薦建立新的 Harness 配置，不要對已有配置使用 --from-default-profile，它會重建該配置。
啓動：
dsh --profile paper-matrix --port 3147
瀏覽器打開 Harness 後：右側邊欄 → 文獻拆解 → 全屏（可選）。使用終端輸出的登錄鏈接，保持終端運行，按 Ctrl+C 停止。
如需固定文獻庫位置，在配置的 cordis.patch.yml 添加：
- id: paper-matrix
config:
libraryDir: /absolute/path/your-research-project/文獻庫
# python: /absolute/path/python3
也可使用 DSH_PAPER_MATRIX_LIBRARY_DIR 環境變量；配置文件的顯式設置優先。
典型用法¶
- 批量導入可搜索 PDF；相同文件按 SHA-256 去重，同名/同縮寫不自動合併。
- 點標題進入詳情，選擇 Harness 已配置的模型，按需勾選「雙語拆解」，開始分析。
- 覈對原文頁，按格修訂。閱讀狀態、個人筆記、字段覈驗分別保存。
- 返回總表搜索、篩選、排序，導出 CSV 雙語寬表或完整 JSON。
分析會將論文全文發送給所選模型提供方，消耗其額度。插件複用 Harness 模型接口，不收集或另存 API Key。不同提供方的路由和憑據分別由 Harness 管理。
能力邊界與注意事項¶
每篇最多 25 MB / 300 頁 / 180,000 字符，超限拒絕，不靜默截斷。不含 OCR，掃描 PDF 需先轉成可搜索 PDF。複雜表格、公式、雙欄、腳註的文本層可能丟失佈局；文本查看器不是原 PDF 排版渲染器。「原文匹配」僅指指定頁內的規範化文字匹配，忽略空白、兼容字符和字母間斷詞連字符，保留原 quote，不等於語義支持或正確率。模型可能誤寫數字、遺漏條件或誤稱源文衝突，初讀草稿需要人工檢查，不宜直接作爲論文引用。經管變量、識別策略和獨立實驗子記錄目前沒有專用編輯器；統一庫已有額外字段仍保留在完整 JSON。尚無多用戶、雲同步、Zotero 同步、後臺監控或自動批量分析。
macOS 未將 dsh 加入 PATH 時，把上面的 dsh 替換爲完整 CLI 路徑，例如：
"/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh" plugin --profile paper-matrix add /absolute/path/dsh-paper-matrix-0.1.1.tgz
不要同時啓動兩個插件實例指向同一個緩存目錄。
開發與維護¶
源碼可獨立構建，不依賴作者的技能目錄、論文文件、數據庫或絕對路徑。vendor/literature.py 隨源碼提供，僅依賴 Python 標準庫。lib/ 的預編譯產物同時提交到倉庫並隨發行包提供。
主要入口：src/host.mjs、src/client.jsx、src/core/canonical-store.mjs、src/core/pdf.mjs、src/core/analysis.mjs。測試使用合成 PDF 與臨時庫，不上傳用戶論文、不調用收費模型。可運行 node examples/create-sample.mjs 生成一頁原創合成 PDF，用於導入驗證。
卸載：dsh plugin --profile paper-matrix remove dsh-paper-matrix；文獻庫獨立保留。
總結¶
Paper Matrix 在 DeepSeek Harness 中提供了一個本地 SQLite 驅動的論文拆解框架，支持雙語拆解、頁碼引用和人工修訂分層，適合需要橫向對比多篇論文的研究場景。安裝與使用不依賴雲服務，數據與模型接口均由 Harness 管理。
插件目錄：https://www.skillhub.cn/plugins/cvnices8-byte/dsh-paper-matrix
GitHub：https://github.com/cvnices8-byte/dsh-paper-matrix
