ディレクトリに戻る

dsh-plugin-zotero

キュレーションリスト掲載メンテナンス: 活発

peijiping/dsh-plugin-zotero

Zoteroの文献を読み取り専用サイドバーで閲覧・検索し、書誌情報や全文を確認できます。引用、選択箇所、コレクションを会話の下書きへ挿入でき、各MCPツールの有効・無効も切り替えられます。

GitHub で見る
$ dsh plugin --profile <profile> add dsh-plugin-zotero

19

スター

1

フォーク

TypeScript

言語

MIT

ライセンス

2026-10-08

作成日

2026-11-20

最終プッシュ

MIT ライセンスの TypeScript 製 DSH プラグイン。ローカルの Zotero ライブラリを DeepSeek Harness のなかの閲覧・引用ワークスペースに変えます —— PDF 閲覧タブ、引用カプセル、MCP 経由のモデルツール、そして既定でオフの書き込み権限。

DSH 統合

ネイティブ実行

作者による申告

安全性監査

未監査

最終検証日

2026-11-16

ライセンス

MIT

01どんなタスクに使えるのか?

  • 同じウィンドウでモデルと一緒に文献を読む — 右サイドバーでライブラリを眺め、項目をダブルクリックして独立した閲覧タブを開き、本文から抜き出した引用がそのままセッションの下書きに入る

    PDF がページ全体で描画され注釈が元の位置に重なる閲覧タブ、下書きに書き込まれた(自動送信はされない)引用カプセル、そして引用した原文を受けてモデルが続ける回答

    文献を読みながらモデルと議論する研究者・学生・書き手で、Zotero のウィンドウとチャットのウィンドウを行き来したくない人

  • ライブラリの片付けをモデルに任せる — 検索、PDF の精読、ハイライトとノートの集約、テーマ別のコレクション作成と振り分け、ダウンロード済みの論文の取り込みまで

    作成・改名・整理されたコレクション、コレクションに入れ直された項目、取り込まれたローカル PDF、そして元の項目に添付として戻された翻訳版

    Zotero が散らかってしまった人、そして Zotero をクリックして回らずにレビューの素材を集めたい人

  • 書き込みは自分で決めるまでオフのまま — 閲覧と引用だけにするか、書き込みを有効にして DSH の閲覧ページでハイライトやノートを付け、モデルにもライブラリを触らせる

    既定では厳密に読み取り専用のパネル。スイッチを入れ、Zotero 側で認可すると、ハイライト・下線・ノートは手元の実際の Zotero ライブラリに入り、プラグイン側に写しは残らない

    AI に近い道具に自分の文献ライブラリを書き換えられたくない人、逆に DSH を出ずにその場で注釈を付けたい人

02DeepSeek 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` で待ち受け、その設定で「允许写操作」にチェック

インストール手順

  1. 01

    DSH を開き「设置」→「插件市场」へ。プラグイン索引がまだ無いと表示されたら「添加索引源」を押し、`https://awesome-dsh-plugin.com/index.json` を追加(一度だけ)

  2. 02

    「发现」で `zotero` を検索し、dsh-plugin-zotero(作者 peijiping)を開く

  3. 03

    「安装」を押して確認ダイアログで確定し、完了したら指示に従って DSH を再起動

  4. 04

    コマンドラインでの同等手順:`dsh plugin --profile <profile> add dsh-plugin-zotero` —— パッケージにはビルド済みの `lib/` と `client/client.js` が入っており、インストール時にビルドスクリプトは走らず `allowBuilds` の許可も不要

    $ dsh plugin --profile <profile> add dsh-plugin-zotero

  5. 05

    Zotero の「工具 → 插件」で Zotero MCP Plugin を入れる(マーケットで `mcp` を検索、一覧の先頭、パッケージ名 `zotero-integrated-mcp`)。その設定で「允许写操作」にチェック

  6. 06

    Zotero の「设置 → 高级」で「允许此计算机上的其他应用程序与 Zotero 通信」にチェック

導入成功の確認

  • 再起動後、DSH の右サイドバーに「Zotero 文献库」の入口が増え、設定の一覧に「Zotero文献库」ページが増える
  • 「设置 → Zotero文献库」を開く:書き込み権限・API 設定・MCP 設定(MCP ツール一覧を含む)・選択範囲の翻訳の 4 ブロックは既定値のままで正しく、変更は自動保存され再起動なしで反映される
  • ブラウザで `http://127.0.0.1:23119/api/` を開き `Zotero is running` と出ればローカル通信は開通している
  • 右サイドバーの「Zotero 文献库」を開く:ステータスバーに接続状態が出て、左側に Zotero のコレクションが並ぶ

03DSH 統合と能力の範囲

DSH 統合ネイティブ実行

DSH プラグイン —— 右サイドバーに「Zotero 文献库」パネルを、設定ダイアログに独立した「Zotero文献库」ページを登録し、パネルのデータはホスト web サーバーに自前登録する `/dsh-zotero/api/*` ルート経由で取得、さらに統合 MCP のツールを `mcp__zotero__*` としてモデルに登録します。導入は `dsh plugin --profile <profile> add dsh-plugin-zotero`

  • 右サイドバーのライブラリパネル

    各セッションの隣、右サイドバーに「Zotero 文献库」パネルを追加します閲覧と引用だけ:コレクションの作成・改名・削除ボタンはパネルに無く、整理はモデルの仕事です選択中のコレクション、展開状態、分割バーの幅はこのマシンに記憶されます
  • その場で開く閲覧ページと統合アウトライン

    右サイドバーの最上位に項目のタブを開き、同じ項目をもう一度ダブルクリックしても既存タブに戻るだけです複数の詳細タブを開いても、切り替え時に各タブの展開状態とスクロール位置は保たれますZotero のローカル API にも統合 MCP にもアウトラインのデータが無いため、この目次はプラグイン自身が解析します
  • セッションの下書きに入る引用カプセル

    書き込み先はセッションの下書きだけ:自動送信もせず、フォーカスも奪いません下書きのカプセルは本プラグインが展開するため、無効化・アンインストールすると送信が引用元不明で失敗します
  • 統合 MCP 経由のモデル側ツール

    統合 MCP のツールを `mcp__zotero__*` としてモデルに登録し、設定ページのツール別スイッチで絞り込みますプラグイン自身の注釈・ノート書き込みツールは、書き込み権限がオンのときだけ登録されます
  • 選択範囲の翻訳オーバーレイ

    選択したテキストを選んだサービスへ送ります:Bing の翻訳エンドポイント、または DeepSeek 精翻を選んだ場合は現在のアカウントのモデル
  • 本文のスクリーンショットを会話へ

    1 つのメッセージとして、画像添付 1 枚と `截图:` カプセル 1 つを送ります画像の下端に「Zotero 截图」で始まる透かし(タイトルとページ範囲)を焼き込むため、画像だけ転送されても出典が残ります

04誰に向いているのか?使うべきでない場面は?

向いている用途

  • 文献を読みながらモデルと議論する研究者・学生・書き手で、Zotero のウィンドウとチャットのウィンドウを行き来したくない人
  • Zotero が散らかってしまった人、そして Zotero をクリックして回らずにレビューの素材を集めたい人
  • AI に近い道具に自分の文献ライブラリを書き換えられたくない人、逆に DSH を出ずにその場で注釈を付けたい人

不向きな用途

  • 読むのは手元の Zotero ライブラリで、クラウドは経由しません。DSH デスクトップ版は 0.2.1-rc.3 以上が必要で、`engines.dsh` は `>=0.2.1-rc.3 <0.3.0-0` に固定されています。
  • Zotero は既定で他のプログラムからのライブラリ読み取りを許しません。「设置 → 高级」で「允许此计算机上的其他应用程序与 Zotero 通信」を入れるまで、パネルは「Zotero 未连接」を表示し、モデル側もデータを取得できません。
  • 書き込みは 2 段階の関門です。「允许写入 Zotero」スイッチと、Zotero の確認ダイアログで「始终允许」を選ぶこと。それでも削除はハード削除でゴミ箱に入らず元に戻せず、「允许」で得た一時キーは最初の書き込みで Zotero に消されます。
  • モデル側の Zotero ツールはブリッジ用の小プラグイン次第です。23120 で動いていなければツールは 1 つも無く、動いていても「允许写操作」が入っていないと読み取りはできても、コレクション作成を頼んだ瞬間に「写操作已禁用」が返ります。

05互換性・メンテナンス・セキュリティ上の注意

  • 読むのは手元の Zotero ライブラリで、クラウドは経由しません。DSH デスクトップ版は 0.2.1-rc.3 以上が必要で、`engines.dsh` は `>=0.2.1-rc.3 <0.3.0-0` に固定されています。
  • Zotero は既定で他のプログラムからのライブラリ読み取りを許しません。「设置 → 高级」で「允许此计算机上的其他应用程序与 Zotero 通信」を入れるまで、パネルは「Zotero 未连接」を表示し、モデル側もデータを取得できません。
  • 書き込みは 2 段階の関門です。「允许写入 Zotero」スイッチと、Zotero の確認ダイアログで「始终允许」を選ぶこと。それでも削除はハード削除でゴミ箱に入らず元に戻せず、「允许」で得た一時キーは最初の書き込みで Zotero に消されます。
  • モデル側の Zotero ツールはブリッジ用の小プラグイン次第です。23120 で動いていなければツールは 1 つも無く、動いていても「允许写操作」が入っていないと読み取りはできても、コレクション作成を頼んだ瞬間に「写操作已禁用」が返ります。
2026-10-082026-11-13v0.7.0

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 をページ全体で描画しハイライトを重ねます)、そして現在のセッションの下書きに書き込まれる引用カプセルです。カプセルは自動送信されず、送信した瞬間に初めて完全な引用テキストへ展開されます。下書きのカプセルは本プラグインが展開する仕組みなので、カプセルが残ったまま無効化・アンインストールすると、送信が引用元不明で失敗します(カプセルを消せば送信できます)。

モデルに何を変更させるかはどう管理しますか?

関門は 2 つあり、両方必要です。「Zotero 写权限」スイッチはパネルに書き込み口を作るか、プラグイン自身の注釈・ノート書き込みツールをモデルに登録するかを決め、Zotero 側の認可はその書き込みを受け付けるかを決めます。ですから確認ダイアログでは「始终允许」を選んでください(「允许」で得た一時キーは最初の書き込みで消えます)。統合 MCP の 25 ツールのうち 10 が書き込み系(`write_item`、`create_collection`、`delete_collection` など)で、「设置 → Zotero文献库 → MCP 工具」から 1 つずつ切れます。書き込みは手元の Zotero ライブラリに直接入り、プラグイン側に写しは残りません。削除はハード削除でゴミ箱には入りません。

書き込みの認可情報はどこに保存されますか?

`~/.dsh/storages/dsh-plugin-zotero/local-api-key.json` にパーミッション `0600` で保存され、ホストプロセスだけが読み書きします —— 設定ストアにも入らず、どのフォームにも表示されません。権限を戻すには 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 バイトまで、1 回の選択範囲翻訳は 4000 文字まで、スクリーンショットは 1 セッション 20 枚・1 枚 50 MB まで。スクリーンショットには画像を読めるモデルが必要です(`deepseek-flash` は可、`deepseek-v4-pro` は送信時に拒否されます)。

08データと出典

  • 作者による申告github.com5ac3ffe07ffc…

    dsh plugin --profile <profile> add dsh-plugin-zotero

  • 作者による申告github.com5ac3ffe07ffc…

    插件自持连接集成 MCP,把工具以 `mcp__zotero__*` 注册进 dsh,可在「设置 → Zotero文献库 → MCP 工具」里逐项启用 / 禁用。

  • 作者による申告github.com5ac3ffe07ffc…

    Host 路由为 `GET /dsh-zotero/api/<action>`,action 有 `health` / `tree` / `items` / `tags` / `item` / `collection-bib` / `mcp…

このページは、プロジェクトの公開ドキュメント、リポジトリのメタデータ、および DSH Plugins の構造化解析に基づいて生成されています。最終検証日:2026-11-16。誤りを見つけた場合は、修正を送信してください。

🏆

dsh プラグイン おすすめ

最初に入れたい 12 のプラグイン。全カタログ・全カテゴリから厳選しました。

DSH Plugins は DeepSeek Harness プラグインの独立したコミュニティ ディレクトリです。DeepSeek との提携・公認はありません。サードパーティ製プラグインはセキュリティ監査を受けていません。インストール前にソースコードをご確認ください。

DeepSeek Harnessの新着プラグインを毎週お届け。スパムはありません。