dsh-plugin-zotero 0.6.9 → 0.8.0

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
@@ -24,7 +24,7 @@
24
24
  - **读文献**:双击条目就在 DSH 内开独立阅读页,PDF 整页渲染、高亮原位叠加,原文与译本附件随时切换;摘要、全文、笔记与标注都能在这里读完,写综述、做对比、提取数据都行,需要精确引用时会保留原文措辞。开启写权限后,正文里划选即选颜色落一条高亮或下划线(跨页自动按页拆条)、随手带一句评论,改色、改评论、改页码、加标签、高亮↔划线互转、删除都在同一处;笔记也能新建、编辑、删除。改动直接进 Zotero 库,不是插件里的副本。
25
25
  - **整理文库**:新建、重命名、移动、删除分类,批量把条目加入或移出分类。你说一句「把这几篇归到『待读』里」,它就照做。
26
26
  - **帮你入库**:把本地下载好的论文、PDF 交给 DSH 导入 Zotero;也可以让它读完外文文献后,把译文作为附件挂回条目。
27
- - **带进对话**:右侧面板单条目引用、列表多选批量引用、阅读页划词摘录与点高亮引用、单标签或多标签引用、整分类引用,一键写进当前会话草稿(不自动发送),你再接着说要求。全部都以「引用胶囊」的形式出现,草稿里一眼看清引了哪几篇 / 哪几段,单独删掉某一条也不影响其他内容;完整文本在发送那一刻才展开给模型。
27
+ - **带进对话**:右侧面板单条目引用、列表多选批量引用、阅读页划词摘录与点高亮引用、单标签或多标签引用、整分类引用、划词翻译,一键写进当前会话草稿(不自动发送),你再接着说要求。全部都以「引用胶囊」的形式出现,草稿里一眼看清引了哪几篇 / 哪几段,单独删掉某一条也不影响其他内容;完整文本在发送那一刻才展开给模型。读到公式、图表、版式这类没法划选的内容时,用左上角的**取景框按钮**框一块正文——微信式定格框选,截图与出处说明(文献、页码、章节、区域文字)作为同一条消息发出。
28
28
  - **安全可控**:写能力默认全关 —— 「设置 → Zotero文献库」里的「Zotero 写权限」不开启,面板就是纯只读,模型也看不到任何写工具。开启后写操作优先走集成 MCP(在 Zotero 进程内执行,不触发本地 API 授权弹窗),标注与笔记这两类 MCP 覆盖不到的才走本地 API,需要一次性点「始终允许」授权;模型侧每一项工具都能单独开关。
29
29
 
30
30
  面板布局与 Zotero 本体一致:顶部状态栏显示连接状态并提供刷新;左侧是分类树,树下是可拖高、可折叠的标签面板;右侧列表显示当前范围(分类 / 全库 / 标签筛选后)的条目。分类树与条目列表之间的分隔条可拖动,宽度按本机记住。列表里单击条目选中、`Ctrl` / `Cmd` 点选多选,双击才在右侧栏顶层单开一个标签页看详情。阅读页就开在会话旁边的标签里,边读边摘、边问边改,不必在 Zotero 与 AI 两个窗口之间来回切换。
@@ -197,7 +197,8 @@ Zotero → **设置** → **高级** → 勾选「**允许此计算机上的其
197
197
  - **文档目录**:`i` 左边的列表按钮展开 PDF 自带书签的大纲树,按层级缩进,点一条即跳到对应页(跳完自动收起);没有书签的 PDF 显示「这篇 PDF 没有目录」。Zotero 本地 API 与集成 MCP 都没有目录数据,这份大纲由插件从 PDF 文件里自己解析(上限 8 层 / 800 条)。
198
198
  - **笔记可读**:独立笔记(文库里的全局笔记)打开后正文直接占据文档区,跟普通条目一样阅读;子笔记在信息面板的「笔记」块里折叠呈现,正文保留 Zotero 的引用块、标注高亮、表格与外链图片。Host 侧已清洗脚本与事件属性,避免注入。「引用」把该条笔记作为一枚胶囊写进会话草稿,发送时展开成完整纯文本。
199
199
  - **标注可读**:PDF 上的高亮与划线原位叠加在页面上,点页内标注弹出卡片,可当场「引用」或跳回 Zotero 对应页;「标注」块按类型 / 颜色筛选,点条目可跨附件定位、滚动并闪烁,「引用」把该条标注作为胶囊写进会话草稿。
200
- - **多种插入方式**:单条目、列表多选批量、单标签、多标签(合并成一枚「标签组」胶囊,AND/OR 在插入那一刻定格)、整目录、全文划词摘录、单条标注与单条笔记**全部**以「引用胶囊」写进草稿——胶囊只显示短标签,发送那一刻才展开成完整引用文本,模型拿到的内容与以前一致。所有方式都只写进会话草稿(不自动发送、不抢焦点),文本携带 `itemKey` / `collectionKey` / 标签名供模型接续操作。标签类引用始终按全库范围展开,不受你当时选中哪个分类影响;摘录胶囊把 `itemKey`、标题与原文一起定格在胶囊里,重开 DSH 后仍可展开,发送时不依赖 Zotero 在线(单段上限 4000 字)。
200
+ - **多种插入方式**:单条目、列表多选批量、单标签、多标签(合并成一枚「标签组」胶囊,AND/OR 在插入那一刻定格)、整目录、全文划词摘录、单条标注与单条笔记**全部**以「引用胶囊」写进草稿——胶囊只显示短标签,发送那一刻才展开成完整引用文本,模型拿到的内容与以前一致;发出去之后,会话历史里仍是一枚胶囊,悬停即可预览完整引用,点击胶囊还能打开完整面板。所有方式都只写进会话草稿(不自动发送、不抢焦点),文本携带 `itemKey` / `collectionKey` / 标签名供模型接续操作。标签类引用始终按全库范围展开,不受你当时选中哪个分类影响;摘录胶囊把 `itemKey`、标题与原文一起定格在胶囊里,重开 DSH 后仍可展开,发送时不依赖 Zotero 在线(单段上限 4000 字)。
201
+ - **正文截图加入对话**:文献详情左上角「加入对话」右边多一枚「截图加入对话」文字按钮,点一下正文定格压暗,拖框圈出要截的区域,只有「取消 / 加入对话」两枚按钮。截图范围固定是正文显示区(不含工具条与浮层),PDF 直接取 pdf.js 页面位图(跨页也能一次框),纯文本与笔记按可见区渲染。插入后是**一张图片附件 + 一枚 `截图:` 胶囊**,同一条消息;图片底部烙一条出处水印(标题 · 页码 · 章节),即使图片被单独转发也不丢出处。模型同时收到文献身份、起止页码、最近章节与框选区域的文字摘要。网页快照也支持:由快照里的桥接脚本把整页交给面板重绘,中文、表格、内联图片都能还原,滚到哪儿截哪儿。
201
202
  - **胶囊依赖本插件展开**:草稿里留着引用胶囊时禁用或卸载本插件,发送会失败并提示找不到引用来源,把胶囊删掉即可继续正常发送。
202
203
  - **分类只读**:不提供任何新建 / 改名 / 删除分类的按钮——整理分类是模型的活,人在面板里只管浏览与引用。
203
204
  - **标注与笔记可写(默认关)**:在「设置 → Zotero文献库」打开「Zotero 写权限」并授权后,阅读页划选即写高亮 / 下划线(Zotero 色板七色 + 评论一次点明),点页内高亮弹出的标注卡片可当场「添加评论 / 改评论」,「标注」块还支持改色、改页码、加标签、高亮↔划线、删除,「笔记」块支持新建 / 编辑 / 删除。所有写入都直接进 Zotero 本地库,插件不存副本;含 Zotero 引文或标注锚点的笔记只给删除、不给编辑,改正文会让锚点失联。删除是**硬删**,不进 Zotero 回收站,面板里要点两次才会真删。开关关着时上述入口一个都不出现。
@@ -269,6 +270,7 @@ src/ # 插件源码(主包,ESM / NodeNext / strict)
269
270
  ├── InfoPanel.tsx # 左上角悬浮信息面板(可分块折叠)
270
271
  ├── OutlinePanel.tsx # 左上角目录浮层(PDF 书签,点条目跳页)
271
272
  ├── viewer/ # 渲染器注册表 + PDF.js 渲染 / 文本回退 / 标注叠加与几何换算
273
+ ├── viewer/shot/ # 截图加入对话:状态机 / 定格遮罩 / 裁切水印 / PDF、DOM、iframe 三种采集适配器
272
274
  ├── AnnotationList.tsx / NoteList.tsx # 标注与笔记列表
273
275
  ├── Toast.tsx # 插入结果等轻提示
274
276
  ├── reference.ts / cite.ts # 引用胶囊的 ref 编码与提交时的文本展开