dsh-zotero-plugin
通过 localhost 本地 API（读取）和连接器 saveItems 端点（写入）为 DeepSeek Harness 提供 Zotero 文库工具。不使用云服务，无需 API 密钥。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:evanliu3594/dsh-zotero-plugin#25016b08c83d4600044da5548167a95461412423Zotero Plugin 以 dsh-zotero-plugin 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
中文
DeepSeek Harness 的 Zotero 文献库插件：10 个模型可直接调用的工具，全部通过本机 Zotero 桌面端（127.0.0.1:23119）读写文献库——不访问云端、不需要 API Key。
/connector/saveItems）：一次保存一条新文献（含标签、子笔记），保存后自动读回校验。| 工具 | 作用 |
|---|---|
zotero_status | 自检：Zotero 是否运行、本地 API 是否开启、版本与文库 |
zotero_search_items | 搜索（qmode=everything 含全文）、按标签/类型/集合过滤、翻页、垃圾桶 |
zotero_get_item | 单条完整元数据，可选带子项 |
zotero_get_children | 条目的子笔记与附件（PDF 文件名/路径） |
zotero_list_collections | 全部集合 + 层级路径 + 计数 |
zotero_list_tags | 标签列表（前缀过滤） |
zotero_recent_items | 最近添加 |
zotero_get_bibtex | BibTeX / CSL-JSON 导出（Zotero 本地直出，≤50 条/次） |
zotero_get_selected_collection | Zotero 当前选中集合（写入落点）与全部可选目标 |
zotero_add_item | 保存一条新文献（connector saveItems；含标签、子笔记），自动读回校验 |
# 1. 准备依赖链接（指向你的 deepseek-harness checkout）
node scripts/link-harness.mjs /path/to/deepseek-harness
node scripts/probe-runtime-resolution.mjs # 应输出 PASS
# 2. 装入 profile（Windows 桌面版 CLI 示例）
"%LOCALAPPDATA%\Programs\DeepSeek Harness\resources\runtime\cli\bin\dsh.cmd" ^
plugin --profile <你的profile> add /path/to/dsh-zotero
# 3. 完全重启 Harness，在对话里即可使用全部 zotero_* 工具
pnpm install
node scripts/link-harness.mjs # 依赖链接（见上）
pnpm smoke # 十个工具对真实 Zotero 逐个执行（只读）
pnpm smoke:write # 额外保存一条明确标注可删除的测试条目
pnpm verify # 裸 cordis Context + 真实 ToolRuntime 验证注册
源码方式加载（无需打包，loader 直接吃 TS）：
cp cordis.example.yml cordis.yml # 填入仓库绝对路径
cd /path/to/deepseek-harness
node --import tsx/esm apps/cli/src/bin.ts --profile web --patch /path/to/dsh-zotero/cordis.yml
全部可调参数在 src/config.ts（schema 带默认值），可在 profile 的插件 config 里覆盖：
| 字段 | 默认 | 说明 |
|---|---|---|
host / port | 127.0.0.1 / 23119 | Zotero 本地服务地址 |
libraryId | '0' | 本地 API 文库 id，0 = 当前用户文库 |
timeoutMs | 15000 | 单请求超时 |
defaultLimit / maxLimit | 25 / 100 | 列表页大小 |
abstractPreviewChars | 300 | 搜索结果摘要截断（0 = 不返回摘要） |
listCap | 1000 | 集合/标签全量拉取上限（自动分页） |
zotero_add_item 一次只保存一条，且读回校验后才报告成功。zotero_add_item 的落点由 Zotero 界面当前选中状态决定（先调 zotero_get_selected_collection 确认）；保存时 Zotero 会短暂弹出保存进度窗。@deepseek-ai/dsh-tools 等）尚未发布到公共 npm，插件需靠近 harness checkout 使用（scripts/link-harness.mjs 负责链接）；包发布后此步骤可删。