返回目录

dsh-plugin-zotero

精选清单收录维护状态: 活跃

peijiping/dsh-plugin-zotero

DSH的zotero插件

前往 GitHub
$ dsh plugin --profile <profile> add dsh-plugin-zotero

19

星标

1

Fork

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、汇总高亮与笔记、按主题新建分类并把条目归进去,或者把已经下载好的论文导入 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` 待命,并勾选「允许写操作」

安装步骤

  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 工具清单)、划词翻译四块默认值就是对的;改完自动保存、立即生效,不用重启
  • 在浏览器里打开 `http://127.0.0.1:23119/api/`,看到 `Zotero is running` 说明本机通信已经通了
  • 点开右侧栏的「Zotero 文献库」:状态栏显示连接状态,左侧列出你在 Zotero 里的分类

03DSH 适配与能力边界

DSH 适配原生运行时

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 的授权弹窗里选「始终允许」;即便都做了,删除也是硬删、不进回收站、撤销不了,而选「允许」拿到的一次性 key 在首个写请求后就被 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 的授权弹窗里选「始终允许」;即便都做了,删除也是硬删、不进回收站、撤销不了,而选「允许」拿到的一次性 key 在首个写请求后就被 Zotero 删掉。
  • 模型侧的 Zotero 工具全看桥接小插件:没装或没起在 23120 上就一个工具都没有;装了但没在里面勾选「允许写操作」,读类照常,一让模型新建分类就报「写操作已禁用」。
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 整页渲染、高亮原位叠加),摘录等内容会以引用胶囊写进当前会话草稿 —— 胶囊不会自动发送,只在你点发送的那一刻才展开成完整引用文本。草稿胶囊由本插件负责展开:草稿里还留着胶囊时禁用或卸载插件,发送会失败并提示找不到引用来源,把胶囊删掉即可。

模型能改哪些东西、我怎么控?

两层,缺一不可。「Zotero 写权限」开关决定面板有没有写入口、插件要不要把自有的标注 / 笔记写工具注册给模型;Zotero 那边的授权决定它认不认这次写入,所以弹窗里要选「始终允许」—— 选「允许」拿到的一次性 key 在首个写请求后就被删掉。集成 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` 发送时会被拒)。

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。发现错误?提交更正。

🏆

最佳 DeepSeek Harness 插件

从全目录挑出的 12 个值得优先安装的插件,覆盖各个分类。

DSH Plugins 是独立的 DeepSeek Harness 插件目录,与 DeepSeek 官方无关,也不代表官方背书。第三方插件未经安全审计,安装前请审查源码。

每周获取最新的 DeepSeek Harness 插件,绝不滥发。