前言¶

用 DeepSeek Harness（DSH）寫論文筆記或做文獻綜述時，常見做法是開 Zotero 查條目、再切回對話貼標題或路徑。Zotero 本地 API 或 zotero MCP 能取正文，但瀏覽集合、預覽 PDF、把引用寫進當前草稿往往仍要來回切換窗口。

下面介紹社區客戶端插件 dsh-zotero-workspace（維護者 hudsonhou）：在 DSH 右側欄註冊原生 Tab，只讀連接本機 Zotero（127.0.0.1:23119），用集合樹和條目列表選文獻，側欄打開渲染版 PDF 或解析後的 Markdown，並一鍵把引用行寫入當前會話草稿。插件不寫入文庫、不碰 SQLite、不依賴 MCP，與現有 zotero MCP 可並存。

這是什麼¶

dsh-zotero-workspace 是 DSH 右側欄的 Zotero 文獻工作臺。倉庫：GitHub — hudsonhou/dsh-zotero-workspace；社區目錄：SkillHub 插件頁。分類爲客戶端插件，當前版本 0.1.0，許可證 MIT。插件以當前 DSH 進程權限運行，安裝前請自行閱讀源碼與許可證。

核心功能¶

Zotero 頁與檢索¶

右側欄新增「Zotero 文獻工作臺」頁：集合樹、條目列表、詳情；支持在 Zotero 服務端按標題、摘要、全文檢索，帶總數與分頁。

可拖動分區與持久化¶

集合樹、文獻列表、詳情三塊邊界可拖動調整，雙擊邊界恢復默認；佈局按用戶持久化。

側欄閱讀¶

選中條目可在 DSH 內打開渲染版 PDF 或 text/markdown 附件（解析後的 Markdown），走 DSH 原生文件預覽。若已安裝 dsh-better-sidebar，打開 PDF/Markdown 會優先複用其 openFile 預覽，否則回退到 DSH 原生 Session 文件地址。

帶入對話¶

一鍵向當前草稿寫入一行純文本，形如：

[Zotero] 標題 — 作者 (年份) | itemKey=… | PDF: … | MD: …

模型可對路徑執行 read，也可配合 zotero MCP 按 itemKey 取正文。

只讀本地 API¶

僅調用 Zotero 本地 API，不寫文庫。Host 側提供只讀 HTTP 路由（health、tree、items、tags、item、file、mdtext 等），帶回環柵欄、僅 GET。

安裝與啓用¶

前提¶

1. Zotero 桌面版運行中，且在 設置 → 高級 中勾選 允許此計算機上的其他應用程序與 Zotero 通信。
2. 條目宜掛 PDF 附件；解析後的 Markdown 建議以 text/markdown 附件掛回條目（例如 PDF 解析流程產出的 MD）。

自測本地 API：

curl --noproxy "*" http://127.0.0.1:23119/api/

應返回 Nothing to see here.，響應頭含 Zotero-API-Version: 3。

從 GitHub Release 安裝（推薦）¶

桌面 profile：

cd ~/.dsh && dsh plugin --profile desktop add "github:hudsonhou/dsh-zotero-workspace#v0.1.0"

Web profile 將 --profile desktop 換成 --profile web。安裝後重啓 DSH（客戶端 bundle 在啓動時裝配），右側欄應出現「Zotero 文獻工作臺」。

卸載：

cd ~/.dsh && dsh plugin --profile desktop remove dsh-zotero-workspace

或在插件頁停用。package.json 聲明 DSH 引擎 >=0.2.2-rc.1 <0.3.0-0。

配置¶

默認可在 cordis.patch.yml 中由插件行提供。需要覆蓋時，在 profile 的 cordis.patch.yml 裏按 id zotero-workspace 寫 config：

- id: zotero-workspace
  config:
    zoteroBaseUrl: http://127.0.0.1:23119
    storageRoot: ''      # 空 = ~/Zotero/storage
    pageSize: 50
    requestTimeoutMs: 8000

典型用法¶

1. 啓動 Zotero 與 DSH，打開右側欄「Zotero 文獻工作臺」。
2. 在集合樹中選分類，在列表中點條目；必要時用檢索縮小範圍。
3. 在詳情中打開 PDF 或 Markdown 預覽閱讀。
4. 需要讓模型引用該文獻時，使用「帶入對話」，在草稿中得到含 itemKey 與絕對路徑的引用行，再在對話中讓模型讀文件或配合 MCP。

與本插件並存時，可繼續安裝 dsh-better-sidebar；本插件註冊的是 DSH 原生右側欄 Tab。在 better-sidebar 設置裏通過「添加 Tab 插件」發現本插件需等上游目錄 PR 合併發版；此前用上方 Release 命令安裝即可。上游 PR：DSH-better-sidebar #1140。

適用場景與注意¶

適合：本機維護 Zotero 庫、在 DSH 裏寫綜述或復現實驗、希望不離開對話即可瀏覽集合並預覽 PDF/MD 的開發者或研究者。

v0.1 已知限制（以 README 爲準）：

• 無標籤面板、標註瀏覽、整分類引用、摘錄（/tags 接口已就緒，計劃 v0.2）。
• 一個條目默認打開第一個 PDF 與第一個 Markdown 附件；PDF 與 MD 各開一個預覽 tab，無並排分屏。
• 引用爲純文本，非結構化 chip。
• 修改 client.js 後需重載頁面（dsh-unlag 刷新）或重啓 DSH。

故障排查要點：

• 面板顯示「Zotero 未連接」：確認 Zotero 運行、本地 API 已開啓，並用上述 curl 自測。
• Host 加載狀態：讀 ~/.dsh/zotero-workspace/status.json。
• Host 健康檢查：curl --noproxy "*" http://127.0.0.1:<GUI端口>/dsh-zotero-workspace/api/health。
• Tab 未出現：確認插件 dsh-zotero-workspace 已啓用並已重啓 DSH。

DSH 生態強調「一切皆插件」；SkillHub 等社區目錄爲獨立站點，與 DeepSeek / 幻方無官方從屬關係。

結尾¶

dsh-zotero-workspace 把 Zotero 集合瀏覽、PDF/Markdown 側欄閱讀和引用寫入草稿收進 DSH 右側欄，只讀本地 API，便於在對話中直接接着讀文獻。安裝與配置以倉庫 README 爲準。

• 目錄頁：https://www.skillhub.cn/plugins/hudsonhou/dsh-zotero-workspace
• 源碼與說明：https://github.com/hudsonhou/dsh-zotero-workspace