dsh-plugin-zotero 0.1.5 → 0.1.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,8 +1,10 @@
1
1
  # dsh-plugin-zotero
2
2
 
3
- **把 Zotero 和 DSH 连起来。**
3
+ **装上它,DSH 就能直接操控你的 Zotero。**
4
4
 
5
- 装好这个插件,大模型就能直接查看、检索和读取你 Zotero 里的文献、笔记和 PDF 全文;你也可以在 DSH 右侧栏浏览自己的文库,把条目、摘录或整个目录一键带进对话。
5
+ 打通之后,Zotero 不再是一个要你手动点开、一层层翻找的软件,而是 DSH 随手可用的资料库:你可以直接让 DSH 去检索文库、精读某篇 PDF、汇总高亮与笔记、按主题新建分类并把文献归类;也可以把下载好的论文交给它导入,让它读完外文文献后把译文作为附件挂回对应条目。凡是 Zotero 本地接口和 MCP 插件能提供的操作,DSH 都可以替你做。
6
+
7
+ 除了模型侧的能力,DSH 右侧栏还会多出一块「Zotero 文献库」面板:随时浏览自己的文库,把条目、摘录或整个分类一键带进对话。
6
8
 
7
9
  不用写代码,也不用记命令。第一次使用前,只需在 Zotero 里完成两项一次性设置(装一个桥接小插件、打开通信开关),步骤见[使用前提](#使用前提)。
8
10
 
@@ -12,14 +14,16 @@
12
14
 
13
15
  <sub>上图为 DSH 会话与右侧「Zotero 文献库」面板:上方正文区展示元数据与全文,下方分区 tab 展示参考文献、笔记与附件,点击图片可查看原图。</sub>
14
16
 
15
- 一句话概括它能做什么:
17
+ 它能替你做的事,举几个常见例子:
16
18
 
17
- - **浏览与检索**:按 Zotero 分类逐级浏览文库,按标题 / 摘要搜索,查看条目的元数据、摘要、参考文献、笔记、附件与 PDF 全文。
18
- - **带进对话**:单条目引用、全文划词摘录或整目录引用,一键写进当前会话草稿(不自动发送),模型可以接着基于它工作。
19
- - **交给模型**:让大模型帮你找文献、读全文、整理笔记,必要时按你的要求调整分类;不想让模型改文库,可以逐个关掉写操作。
20
- - **安全可控**:浏览面板严格只读;模型能做什么可以逐项开关。
19
+ - **找文献**:按标题、年份、全文关键词检索,也能跨库搜高亮和批注,快速回答「我收过哪些讲 XX 的文章」。
20
+ - **读文献**:读摘要、PDF 全文、笔记与标注,写综述、做对比、提取数据都行;需要精确引用时会保留原文措辞。
21
+ - **整理文库**:新建、重命名、移动、删除分类,批量把条目加入或移出分类。你说一句「把这几篇归到『待读』里」,它就照做。
22
+ - **帮你入库**:把本地下载好的论文、PDF 交给 DSH 导入 Zotero;也可以让它读完外文文献后,把译文作为附件挂回条目。
23
+ - **带进对话**:右侧面板单条目引用、全文划词摘录或整分类引用,一键写进当前会话草稿(不自动发送),你再接着说要求。
24
+ - **安全可控**:浏览面板严格只读;模型能用的每一项工具都能单独开关,想彻底只读就把写操作关掉。
21
25
 
22
- 面板分三块:顶部状态栏显示连接状态并提供刷新;左侧分类树按分类浏览与搜索;右侧详情区展示正文与「参考文献 / 笔记 / 附件」标签页。
26
+ 面板分三块:顶部状态栏显示连接状态并提供刷新;左侧分类树按分类浏览与搜索;右侧详情区展示正文与「参考文献 / 笔记 / 标注 / 附件」标签页。
23
27
 
24
28
  > 面向使用者的完整说明(入口、交互、toast 与错误对照表)见 [插件使用说明](docs/插件使用说明/dsh-plugin-zotero使用说明.zh.md)。
25
29
 
@@ -72,10 +76,11 @@ curl http://127.0.0.1:23119/api/ # 期望输出:Zotero is running
72
76
  ## 特性
73
77
 
74
78
  - **右侧栏面板「Zotero 文献库」**:顶部状态栏(Zotero / 模型工具探活)+ 左侧分类树(按需拉取、标题摘要搜索)+ 右侧条目详情或分类概要。
75
- - **详情区上下分区**:上方正文区展示标题、元数据、摘要与 PDF 全文;下方用 tab 切换「参考文献 / 笔记 / 附件」。两个区域之间的分隔条可拖动,正文占比默认 85% 并按会话记住;没有次级内容的条目正文独占整栏。
79
+ - **详情区上下分区**:上方正文区展示标题、元数据、摘要与 PDF 全文;下方用 tab 切换「参考文献 / 笔记 / 标注 / 附件」。两个区域之间的分隔条可拖动,正文占比默认 85% 并按会话记住;没有次级内容的条目正文独占整栏。
76
80
  - **摘要默认折叠**:标题行右侧的箭头按钮展开 / 收起摘要,默认把空间留给正文与全文。
77
- - **笔记可读**:笔记以折叠列表呈现(默认收起,点击标题展开),正文保留 Zotero 的引用块、标注高亮、表格与外链图片;Host 侧已清洗脚本与事件属性,避免注入。
78
- - **三种插入方式**:单条目引用、全文划词摘录、整目录引用,均只写进会话草稿(不自动发送、不抢焦点),文本携带 `itemKey` / `collectionKey` 供模型接续操作。
81
+ - **笔记可读**:独立笔记(文库里的全局笔记)打开后正文直接占据上方正文区,跟普通条目一样阅读;条目下的子笔记仍进「笔记」tab,以折叠列表呈现(默认收起,点击标题展开),正文保留 Zotero 的引用块、标注高亮、表格与外链图片。Host 侧已清洗脚本与事件属性,避免注入。「引用」把该条笔记转成纯文本写进会话草稿。
82
+ - **标注可读**:PDF 上的高亮与划线汇总进「标注」tab(带颜色、页码、原文与评论,可按类型 / 颜色筛选);全文块里原位标出底色与下划线,点列表条目可滚动定位并闪烁,「引用」把该条标注写进会话草稿。
83
+ - **五种插入方式**:单条目引用、全文划词摘录、单条标注、单条笔记、整目录引用,均只写进会话草稿(不自动发送、不抢焦点),文本携带 `itemKey` / `collectionKey` 供模型接续操作。
79
84
  - **面板严格只读**:不提供任何新建 / 改名 / 删除分类的按钮。
80
85
  - **模型侧工具可逐个开关**:插件自持连接集成 MCP,把工具以 `mcp__zotero__*` 注册进 dsh,可在插件页按工具启用 / 禁用。
81
86
 
@@ -117,7 +122,7 @@ MCP 组下方是 **「MCP 工具」** 区:现场列出集成 MCP 的全部工
117
122
 
118
123
  | 半边 | 能力 | 通道 |
119
124
  |---|---|---|
120
- | **人侧面板** | 在 DSH 右侧栏只读浏览 Zotero 文库(分类树 / 搜索 / 条目详情 / 笔记 / PDF 全文),把条目、摘录或整目录引用写进会话草稿 | 插件在宿主 web server 自注册的 `/dsh-zotero/api/*` 路由 |
125
+ | **人侧面板** | 在 DSH 右侧栏只读浏览 Zotero 文库(分类树 / 搜索 / 条目详情 / 笔记 / 标注 / PDF 全文),把条目、摘录、标注、笔记或整目录引用写进会话草稿 | 插件在宿主 web server 自注册的 `/dsh-zotero/api/*` 路由 |
121
126
  | **模型侧** | 检索、精读、按需操作文库 | 插件**自持**连接本机 Zotero 集成 MCP,工具以 `mcp__zotero__*` 注册给模型 |
122
127
 
123
128
  MCP 没起,面板照常可用;Zotero 没开,模型工具自然也不可用。
@@ -160,7 +165,7 @@ src/ # 插件源码(主包,ESM / NodeNext / strict)
160
165
  ├── ZoteroCard.tsx # 插件页配置卡(API 设置 / MCP 设置 / 工具开关)
161
166
  ├── ZoteroPane.tsx # 面板容器:状态栏 + 分类树 + 详情
162
167
  ├── CollectionTree.tsx / ItemDetail.tsx
163
- ├── DetailTabs.tsx # 详情底部分区 tab(参考文献 / 笔记 / 附件)
168
+ ├── DetailTabs.tsx # 详情底部分区 tab(参考文献 / 笔记 / 标注 / 附件)
164
169
  ├── NoteList.tsx # 笔记折叠列表与正文渲染
165
170
  ├── styles.ts # 分区小标题 / 展开按钮等共用样式
166
171
  ├── paneStore.ts # 跨会话共享的面板状态