MIT 授權的 TypeScript DSH 外掛程式,把本機 Zotero 文獻庫變成 DeepSeek Harness 裡的閱讀與引用工作台 —— PDF 閱讀頁、引用膠囊、由 MCP 支援的模型工具,以及預設關閉的寫入權限。
DSH 整合
原生執行環境
作者聲明
安全稽核
未稽核
最後核實
2026-11-16
授權條款
MIT
01它能幫你完成什麼?
在同一個視窗裡和模型一起讀文獻:右側欄瀏覽文獻庫,雙擊條目把它開成獨立閱讀頁,劃選一段摘錄直接落進目前工作階段的草稿變成引用
PDF 整頁呈現、註記原位疊加的閱讀頁,寫進草稿(不自動送出)的引用膠囊,以及模型根據被引原文接續給出的回答
邊讀文獻邊和模型討論的研究者、學生與寫作者,不想在 Zotero 視窗和對話視窗之間來回切換
把整理文獻庫的雜事交給模型:檢索文獻庫、精讀 PDF、彙整註記與筆記、依主題新增分類並把條目歸進去,或把手邊已下載的論文匯入 Zotero
新增、改名、填好的分類,進出分類的條目,匯入的本機 PDF,以及掛回原條目作為附件的譯文
Zotero 裡已經堆成一團的使用者,以及想不開 Zotero 就把回顧文獻的素材收攏起來的人
寫入權限一直關著直到你自己決定:只讀只引用,或開啟寫入權限後在 DSH 閱讀頁裡劃螢光標記、寫筆記,也讓模型幫忙改文獻庫
預設嚴格唯讀的面板;開啟開關並完成 Zotero 授權後,螢光標記、底線與筆記直接落在本機真實的 Zotero 資料庫裡,外掛不留副本
不希望貼著 AI 的工具動自己文獻庫的人,以及確實想在 DSH 裡就地註記、不想切回 Zotero 的使用者
02如何將外掛接入 DeepSeek Harness?
先決條件
- 本機已裝好 Zotero 桌面版而且正在執行 —— 外掛讀的是你本機 Zotero 裡的文獻,不是雲端
- DSH 桌面版 ≥ 0.2.1-rc.3 —— `engines.dsh` 為 `>=0.2.1-rc.3 <0.3.0-0`
- 已開啟 Zotero 本機 API:Zotero → 設定 → 進階 → 勾選「允許此電腦上的其他應用程式與 Zotero 通訊」
- 想讓模型動手時:Zotero 裡已裝 Zotero MCP Plugin(`zotero-integrated-mcp`),在 `http://127.0.0.1:23120/mcp` 待命,並勾選「允許寫操作」
安裝步驟
- 01
開啟 DSH,進「設定」→「外掛程式市集」;如果提示「還沒有外掛索引」,點「新增索引來源」把這個位址填進去再點「新增」:`https://awesome-dsh-plugin.com/index.json`(只需一次)
- 02
在「探索」裡搜尋 `zotero`,找到 dsh-plugin-zotero(作者 peijiping)並點開
- 03
點「安裝」,在確認框中確認,等安裝跑完,再依提示重新啟動 DSH
- 04
命令列等效做法:`dsh plugin --profile <profile> add dsh-plugin-zotero` —— 套件內是預先建置的產物(`lib/` + `client/client.js`),安裝時不會執行建置腳本,也不需要 `allowBuilds` 授權
$ dsh plugin --profile <profile> add dsh-plugin-zotero
- 05
在 Zotero 的「工具 → 外掛」裡安裝 Zotero MCP Plugin(外掛市集搜 `mcp`,安裝清單第一列,套件名 `zotero-integrated-mcp`),並在它的設定裡勾選「允許寫操作」
- 06
在 Zotero「設定 → 進階」裡勾選「允許此電腦上的其他應用程式與 Zotero 通訊」
驗證整合成功
- 重新啟動後 DSH 右側欄多出「Zotero 文獻庫」入口,「設定」左側清單多出「Zotero文獻庫」一頁
- 開啟「設定 → Zotero文獻庫」:寫入權限、API 設定、MCP 設定(含 MCP 工具清單)、劃詞翻譯四塊用預設值就是對的;改完自動儲存、立即生效,不必重新啟動
- 用瀏覽器開啟 `http://127.0.0.1:23119/api/`,看到 `Zotero is running` 就代表本機通訊已通
- 點開右側欄的「Zotero 文獻庫」:狀態列顯示連線狀態,左側列出你在 Zotero 裡的分類
03DSH 整合程度與能力邊界
DSH 外掛程式 —— 在右側欄註冊「Zotero 文獻庫」面板,並在「設定」裡註冊獨立的一頁「Zotero文獻庫」,面板資料走外掛在宿主 web server 上自行註冊的 `/dsh-zotero/api/*` 路由,同時把整合 MCP 的工具以 `mcp__zotero__*` 註冊給模型;安裝指令為 `dsh plugin --profile <profile> add dsh-plugin-zotero`
右側欄文獻庫面板
在每個工作階段旁邊的右側欄增加一個「Zotero 文獻庫」面板區塊只做瀏覽與引用:面板裡沒有新增 / 改名 / 刪除分類的按鈕,整理分類是模型的工作選取的分類、展開狀態與分隔線寬度依本機記住就地閱讀頁與統一目錄
在右側欄最上層為條目新開一個分頁,同一個條目再雙擊只會回到既有分頁同時開著多個詳情頁時,各自保留展開狀態與捲動位置Zotero 本機 API 與整合 MCP 都沒有目錄資料,這份大綱由外掛自行解析寫進工作階段草稿的引用膠囊
只寫進工作階段草稿:不自動送出、不搶焦點草稿裡的膠囊靠此外掛展開,停用或移除外掛後送出會因找不到引用來源而失敗走整合 MCP 的模型端工具
把整合 MCP 的工具以 `mcp__zotero__*` 註冊給模型,並依設定頁裡的逐項開關過濾外掛自有的註記與筆記寫入工具只在寫入權限開啟後才註冊劃詞翻譯浮層
把選取的文字送給所選服務:Bing 的翻譯介面,或選 DeepSeek 精翻時走你目前帳號的模型正文截圖加入對話
以同一則訊息送出:一張圖片附件 + 一枚 `截圖:` 膠囊圖片底部烙一條以「Zotero 截圖」開頭的水印,寫明標題與頁碼,圖片被單獨轉傳也不丟出處
04適合誰?何時不該用?
適合
- 邊讀文獻邊和模型討論的研究者、學生與寫作者,不想在 Zotero 視窗和對話視窗之間來回切換
- Zotero 裡已經堆成一團的使用者,以及想不開 Zotero 就把回顧文獻的素材收攏起來的人
- 不希望貼著 AI 的工具動自己文獻庫的人,以及確實想在 DSH 裡就地註記、不想切回 Zotero 的使用者
不適合
- 它讀的是你本機 Zotero 裡的文獻,永遠不走雲端;DSH 桌面版至少 0.2.1-rc.3,`engines.dsh` 把範圍釘在 `>=0.2.1-rc.3 <0.3.0-0`。
- Zotero 預設不允許其他程式讀它的文獻庫:沒在「設定 → 進階」裡勾選「允許此電腦上的其他應用程式與 Zotero 通訊」之前,面板會顯示「Zotero 未連線」,模型端同樣取不到資料。
- 寫入能力要兩道都過:先開啟「允許寫入 Zotero」開關,再在 Zotero 授權視窗裡選「永遠允許」;即使都做了,刪除仍是硬刪、不進資源回收筒、無法復原,而選「允許」拿到的一次性金鑰在第一個寫入請求後就被 Zotero 刪掉。
- 模型端的 Zotero 工具全看橋接小外掛:沒裝或沒起在 23120 上就一個工具都沒有;裝了但沒在裡面勾選「允許寫操作」,讀取照常,一讓模型新增分類就回報「寫操作已禁用」。
05相容性、維護與安全提醒
- 它讀的是你本機 Zotero 裡的文獻,永遠不走雲端;DSH 桌面版至少 0.2.1-rc.3,`engines.dsh` 把範圍釘在 `>=0.2.1-rc.3 <0.3.0-0`。
- Zotero 預設不允許其他程式讀它的文獻庫:沒在「設定 → 進階」裡勾選「允許此電腦上的其他應用程式與 Zotero 通訊」之前,面板會顯示「Zotero 未連線」,模型端同樣取不到資料。
- 寫入能力要兩道都過:先開啟「允許寫入 Zotero」開關,再在 Zotero 授權視窗裡選「永遠允許」;即使都做了,刪除仍是硬刪、不進資源回收筒、無法復原,而選「允許」拿到的一次性金鑰在第一個寫入請求後就被 Zotero 刪掉。
- 模型端的 Zotero 工具全看橋接小外掛:沒裝或沒起在 23120 上就一個工具都沒有;裝了但沒在裡面勾選「允許寫操作」,讀取照常,一讓模型新增分類就回報「寫操作已禁用」。
MIT · 最新發佈 v0.7.0(2026-11-12)· TypeScript 外掛程式,最近推送 2026-11-13
06常見問題
怎麼把 dsh-plugin-zotero 裝進 DeepSeek Harness?
開啟 DSH 的「設定」→「外掛程式市集」,先把 `https://awesome-dsh-plugin.com/index.json` 加為索引來源(只需一次),再到「探索」裡搜尋 `zotero` 安裝 dsh-plugin-zotero,最後重新啟動 DSH。命令列等效做法是 `dsh plugin --profile <profile> add dsh-plugin-zotero`:套件內是預先建置的 `lib/` + `client/client.js`,安裝時不執行建置腳本,也不需要 `allowBuilds` 授權。要求 DSH ≥ 0.2.1-rc.3。
它在 DSH 工作階段裡到底加了什麼?
右側欄多一個「Zotero 文獻庫」面板、「設定」裡多一頁「Zotero文獻庫」,條目可以開成獨立閱讀分頁(PDF 整頁呈現、註記原位疊加),摘錄等內容會以引用膠囊寫進目前工作階段的草稿 —— 膠囊不會自動送出,只在你按下送出時才展開成完整引用文字。草稿膠囊由此外掛負責展開:草稿裡還留著膠囊時停用或移除外掛,送出會失敗並提示找不到引用來源,把膠囊刪掉即可。
模型能改哪些東西、我要怎麼控管?
兩層,缺一不可。「Zotero 寫入權限」開關決定面板有沒有寫入入口、外掛要不要把自有的註記 / 筆記寫入工具註冊給模型;Zotero 那邊的授權決定它認不認這次寫入,所以視窗裡要選「永遠允許」—— 選「允許」拿到的一次性金鑰在第一個寫入請求後就被刪掉。整合 MCP 的 25 個工具有 10 個寫入工具(`write_item`、`create_collection`、`delete_collection` 等),可在「設定 → Zotero文獻庫 → MCP 工具」裡逐項關掉。寫入直接進你本機的 Zotero 資料庫,外掛不留副本,刪除是硬刪、不進 Zotero 資源回收筒。
寫入權限的授權憑證存在哪裡?
存在本機 `~/.dsh/storages/dsh-plugin-zotero/local-api-key.json`,權限 `0600`,只在 Host 程序內讀寫 —— 不進設定儲存,也不在任何表單裡回顯。要收回權限,在 Zotero 裡清掉本機 API 授權即可:下一次寫入被拒後外掛會自動刪掉本機副本並回到「未授權」;把「允許寫入 Zotero」關掉則徹底回到嚴格唯讀。
有哪些實際限制?
面板要求本機 Zotero 正開著並勾選了「允許此電腦上的其他應用程式與 Zotero 通訊」—— 瀏覽器開啟 `http://127.0.0.1:23119/api/` 應該看到 `Zotero is running`;模型端還要求 Zotero MCP Plugin 在 `http://127.0.0.1:23120/mcp` 上待命並勾選「允許寫操作」。預設給模型的全文上限是 204800 位元組,單次劃詞翻譯上限 4000 字,截圖單一工作階段最多 20 張、單張 50 MB;截圖還要求目前模型支援讀圖(`deepseek-flash` 可以,`deepseek-v4-pro` 送出時會被拒)。
07相關的 DSH 工作流程
dsh-univer-office
作者 dream-num
在 DSH 內預覽、建立與編輯表格、文件和幻燈片,由 Univer 驅動
clearai-dsh
作者 clearailhc
ClearAI:以本體為綱的原生 DSH 外掛 —— 經證據核驗的研究長成可瀏覽的領域本體。 · ClearAI: an ontology-first DSH agent preset — evidence-checked research that grows into a domain ontology.
dsh-fish-memory
作者 yuuyuko-uu
🐋 DSH 魚的記憶:給會話一份會淡忘的長期記憶,每條都帶時間。名字裡的「魚」來自 DeepSeek 的鯨魚。
dsh-trading
作者 zhu1090093659
基於 DeepSeek Harness 的智慧體原生交易終端,三欄介面聚合幣圈、美股、A股與港股,內建 19+ 可熱插拔聯結器,預設模擬交易並需人工確認。
08資料與來源
dsh plugin --profile <profile> add dsh-plugin-zotero
插件自持连接集成 MCP,把工具以 `mcp__zotero__*` 注册进 dsh,可在「设置 → Zotero文献库 → MCP 工具」里逐项启用 / 禁用。
Host 路由为 `GET /dsh-zotero/api/<action>`,action 有 `health` / `tree` / `items` / `tags` / `item` / `collection-bib` / `mcp…
此頁面根據專案公開文件、儲存庫中繼資料與 DSH Plugins 的結構化解析所產生;最後核實於 2026-11-16。發現錯誤?提交更正。
最佳 DeepSeek Harness 外掛
從全目錄挑出的 12 個值得優先安裝的外掛,涵蓋各個分類。
