dsh-plugin-zotero 0.3.0 → 0.4.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.
Files changed (214) hide show
  1. package/README.md +31 -20
  2. package/client/client.js +25683 -787
  3. package/client/pdfjs/cmaps/78-EUC-H.bcmap +0 -0
  4. package/client/pdfjs/cmaps/78-EUC-V.bcmap +0 -0
  5. package/client/pdfjs/cmaps/78-H.bcmap +0 -0
  6. package/client/pdfjs/cmaps/78-RKSJ-H.bcmap +0 -0
  7. package/client/pdfjs/cmaps/78-RKSJ-V.bcmap +0 -0
  8. package/client/pdfjs/cmaps/78-V.bcmap +0 -0
  9. package/client/pdfjs/cmaps/78ms-RKSJ-H.bcmap +0 -0
  10. package/client/pdfjs/cmaps/78ms-RKSJ-V.bcmap +0 -0
  11. package/client/pdfjs/cmaps/83pv-RKSJ-H.bcmap +0 -0
  12. package/client/pdfjs/cmaps/90ms-RKSJ-H.bcmap +0 -0
  13. package/client/pdfjs/cmaps/90ms-RKSJ-V.bcmap +0 -0
  14. package/client/pdfjs/cmaps/90msp-RKSJ-H.bcmap +0 -0
  15. package/client/pdfjs/cmaps/90msp-RKSJ-V.bcmap +0 -0
  16. package/client/pdfjs/cmaps/90pv-RKSJ-H.bcmap +0 -0
  17. package/client/pdfjs/cmaps/90pv-RKSJ-V.bcmap +0 -0
  18. package/client/pdfjs/cmaps/Add-H.bcmap +0 -0
  19. package/client/pdfjs/cmaps/Add-RKSJ-H.bcmap +0 -0
  20. package/client/pdfjs/cmaps/Add-RKSJ-V.bcmap +0 -0
  21. package/client/pdfjs/cmaps/Add-V.bcmap +0 -0
  22. package/client/pdfjs/cmaps/Adobe-CNS1-0.bcmap +0 -0
  23. package/client/pdfjs/cmaps/Adobe-CNS1-1.bcmap +0 -0
  24. package/client/pdfjs/cmaps/Adobe-CNS1-2.bcmap +0 -0
  25. package/client/pdfjs/cmaps/Adobe-CNS1-3.bcmap +0 -0
  26. package/client/pdfjs/cmaps/Adobe-CNS1-4.bcmap +0 -0
  27. package/client/pdfjs/cmaps/Adobe-CNS1-5.bcmap +0 -0
  28. package/client/pdfjs/cmaps/Adobe-CNS1-6.bcmap +0 -0
  29. package/client/pdfjs/cmaps/Adobe-CNS1-UCS2.bcmap +0 -0
  30. package/client/pdfjs/cmaps/Adobe-GB1-0.bcmap +0 -0
  31. package/client/pdfjs/cmaps/Adobe-GB1-1.bcmap +0 -0
  32. package/client/pdfjs/cmaps/Adobe-GB1-2.bcmap +0 -0
  33. package/client/pdfjs/cmaps/Adobe-GB1-3.bcmap +0 -0
  34. package/client/pdfjs/cmaps/Adobe-GB1-4.bcmap +0 -0
  35. package/client/pdfjs/cmaps/Adobe-GB1-5.bcmap +0 -0
  36. package/client/pdfjs/cmaps/Adobe-GB1-UCS2.bcmap +0 -0
  37. package/client/pdfjs/cmaps/Adobe-Japan1-0.bcmap +0 -0
  38. package/client/pdfjs/cmaps/Adobe-Japan1-1.bcmap +0 -0
  39. package/client/pdfjs/cmaps/Adobe-Japan1-2.bcmap +0 -0
  40. package/client/pdfjs/cmaps/Adobe-Japan1-3.bcmap +0 -0
  41. package/client/pdfjs/cmaps/Adobe-Japan1-4.bcmap +0 -0
  42. package/client/pdfjs/cmaps/Adobe-Japan1-5.bcmap +0 -0
  43. package/client/pdfjs/cmaps/Adobe-Japan1-6.bcmap +0 -0
  44. package/client/pdfjs/cmaps/Adobe-Japan1-UCS2.bcmap +0 -0
  45. package/client/pdfjs/cmaps/Adobe-Korea1-0.bcmap +0 -0
  46. package/client/pdfjs/cmaps/Adobe-Korea1-1.bcmap +0 -0
  47. package/client/pdfjs/cmaps/Adobe-Korea1-2.bcmap +0 -0
  48. package/client/pdfjs/cmaps/Adobe-Korea1-UCS2.bcmap +0 -0
  49. package/client/pdfjs/cmaps/B5-H.bcmap +0 -0
  50. package/client/pdfjs/cmaps/B5-V.bcmap +0 -0
  51. package/client/pdfjs/cmaps/B5pc-H.bcmap +0 -0
  52. package/client/pdfjs/cmaps/B5pc-V.bcmap +0 -0
  53. package/client/pdfjs/cmaps/CNS-EUC-H.bcmap +0 -0
  54. package/client/pdfjs/cmaps/CNS-EUC-V.bcmap +0 -0
  55. package/client/pdfjs/cmaps/CNS1-H.bcmap +0 -0
  56. package/client/pdfjs/cmaps/CNS1-V.bcmap +0 -0
  57. package/client/pdfjs/cmaps/CNS2-H.bcmap +0 -0
  58. package/client/pdfjs/cmaps/CNS2-V.bcmap +3 -0
  59. package/client/pdfjs/cmaps/ETHK-B5-H.bcmap +0 -0
  60. package/client/pdfjs/cmaps/ETHK-B5-V.bcmap +0 -0
  61. package/client/pdfjs/cmaps/ETen-B5-H.bcmap +0 -0
  62. package/client/pdfjs/cmaps/ETen-B5-V.bcmap +0 -0
  63. package/client/pdfjs/cmaps/ETenms-B5-H.bcmap +3 -0
  64. package/client/pdfjs/cmaps/ETenms-B5-V.bcmap +0 -0
  65. package/client/pdfjs/cmaps/EUC-H.bcmap +0 -0
  66. package/client/pdfjs/cmaps/EUC-V.bcmap +0 -0
  67. package/client/pdfjs/cmaps/Ext-H.bcmap +0 -0
  68. package/client/pdfjs/cmaps/Ext-RKSJ-H.bcmap +0 -0
  69. package/client/pdfjs/cmaps/Ext-RKSJ-V.bcmap +0 -0
  70. package/client/pdfjs/cmaps/Ext-V.bcmap +0 -0
  71. package/client/pdfjs/cmaps/GB-EUC-H.bcmap +0 -0
  72. package/client/pdfjs/cmaps/GB-EUC-V.bcmap +0 -0
  73. package/client/pdfjs/cmaps/GB-H.bcmap +4 -0
  74. package/client/pdfjs/cmaps/GB-V.bcmap +0 -0
  75. package/client/pdfjs/cmaps/GBK-EUC-H.bcmap +0 -0
  76. package/client/pdfjs/cmaps/GBK-EUC-V.bcmap +0 -0
  77. package/client/pdfjs/cmaps/GBK2K-H.bcmap +0 -0
  78. package/client/pdfjs/cmaps/GBK2K-V.bcmap +0 -0
  79. package/client/pdfjs/cmaps/GBKp-EUC-H.bcmap +0 -0
  80. package/client/pdfjs/cmaps/GBKp-EUC-V.bcmap +0 -0
  81. package/client/pdfjs/cmaps/GBT-EUC-H.bcmap +0 -0
  82. package/client/pdfjs/cmaps/GBT-EUC-V.bcmap +0 -0
  83. package/client/pdfjs/cmaps/GBT-H.bcmap +0 -0
  84. package/client/pdfjs/cmaps/GBT-V.bcmap +0 -0
  85. package/client/pdfjs/cmaps/GBTpc-EUC-H.bcmap +0 -0
  86. package/client/pdfjs/cmaps/GBTpc-EUC-V.bcmap +0 -0
  87. package/client/pdfjs/cmaps/GBpc-EUC-H.bcmap +0 -0
  88. package/client/pdfjs/cmaps/GBpc-EUC-V.bcmap +0 -0
  89. package/client/pdfjs/cmaps/H.bcmap +0 -0
  90. package/client/pdfjs/cmaps/HKdla-B5-H.bcmap +0 -0
  91. package/client/pdfjs/cmaps/HKdla-B5-V.bcmap +0 -0
  92. package/client/pdfjs/cmaps/HKdlb-B5-H.bcmap +0 -0
  93. package/client/pdfjs/cmaps/HKdlb-B5-V.bcmap +0 -0
  94. package/client/pdfjs/cmaps/HKgccs-B5-H.bcmap +0 -0
  95. package/client/pdfjs/cmaps/HKgccs-B5-V.bcmap +0 -0
  96. package/client/pdfjs/cmaps/HKm314-B5-H.bcmap +0 -0
  97. package/client/pdfjs/cmaps/HKm314-B5-V.bcmap +0 -0
  98. package/client/pdfjs/cmaps/HKm471-B5-H.bcmap +0 -0
  99. package/client/pdfjs/cmaps/HKm471-B5-V.bcmap +0 -0
  100. package/client/pdfjs/cmaps/HKscs-B5-H.bcmap +0 -0
  101. package/client/pdfjs/cmaps/HKscs-B5-V.bcmap +0 -0
  102. package/client/pdfjs/cmaps/Hankaku.bcmap +0 -0
  103. package/client/pdfjs/cmaps/Hiragana.bcmap +0 -0
  104. package/client/pdfjs/cmaps/KSC-EUC-H.bcmap +0 -0
  105. package/client/pdfjs/cmaps/KSC-EUC-V.bcmap +0 -0
  106. package/client/pdfjs/cmaps/KSC-H.bcmap +0 -0
  107. package/client/pdfjs/cmaps/KSC-Johab-H.bcmap +0 -0
  108. package/client/pdfjs/cmaps/KSC-Johab-V.bcmap +0 -0
  109. package/client/pdfjs/cmaps/KSC-V.bcmap +0 -0
  110. package/client/pdfjs/cmaps/KSCms-UHC-H.bcmap +0 -0
  111. package/client/pdfjs/cmaps/KSCms-UHC-HW-H.bcmap +0 -0
  112. package/client/pdfjs/cmaps/KSCms-UHC-HW-V.bcmap +0 -0
  113. package/client/pdfjs/cmaps/KSCms-UHC-V.bcmap +0 -0
  114. package/client/pdfjs/cmaps/KSCpc-EUC-H.bcmap +0 -0
  115. package/client/pdfjs/cmaps/KSCpc-EUC-V.bcmap +0 -0
  116. package/client/pdfjs/cmaps/Katakana.bcmap +0 -0
  117. package/client/pdfjs/cmaps/LICENSE +36 -0
  118. package/client/pdfjs/cmaps/NWP-H.bcmap +0 -0
  119. package/client/pdfjs/cmaps/NWP-V.bcmap +0 -0
  120. package/client/pdfjs/cmaps/RKSJ-H.bcmap +0 -0
  121. package/client/pdfjs/cmaps/RKSJ-V.bcmap +0 -0
  122. package/client/pdfjs/cmaps/Roman.bcmap +0 -0
  123. package/client/pdfjs/cmaps/UniCNS-UCS2-H.bcmap +0 -0
  124. package/client/pdfjs/cmaps/UniCNS-UCS2-V.bcmap +0 -0
  125. package/client/pdfjs/cmaps/UniCNS-UTF16-H.bcmap +0 -0
  126. package/client/pdfjs/cmaps/UniCNS-UTF16-V.bcmap +0 -0
  127. package/client/pdfjs/cmaps/UniCNS-UTF32-H.bcmap +0 -0
  128. package/client/pdfjs/cmaps/UniCNS-UTF32-V.bcmap +0 -0
  129. package/client/pdfjs/cmaps/UniCNS-UTF8-H.bcmap +0 -0
  130. package/client/pdfjs/cmaps/UniCNS-UTF8-V.bcmap +0 -0
  131. package/client/pdfjs/cmaps/UniGB-UCS2-H.bcmap +0 -0
  132. package/client/pdfjs/cmaps/UniGB-UCS2-V.bcmap +0 -0
  133. package/client/pdfjs/cmaps/UniGB-UTF16-H.bcmap +0 -0
  134. package/client/pdfjs/cmaps/UniGB-UTF16-V.bcmap +0 -0
  135. package/client/pdfjs/cmaps/UniGB-UTF32-H.bcmap +0 -0
  136. package/client/pdfjs/cmaps/UniGB-UTF32-V.bcmap +0 -0
  137. package/client/pdfjs/cmaps/UniGB-UTF8-H.bcmap +0 -0
  138. package/client/pdfjs/cmaps/UniGB-UTF8-V.bcmap +0 -0
  139. package/client/pdfjs/cmaps/UniJIS-UCS2-H.bcmap +0 -0
  140. package/client/pdfjs/cmaps/UniJIS-UCS2-HW-H.bcmap +0 -0
  141. package/client/pdfjs/cmaps/UniJIS-UCS2-HW-V.bcmap +0 -0
  142. package/client/pdfjs/cmaps/UniJIS-UCS2-V.bcmap +0 -0
  143. package/client/pdfjs/cmaps/UniJIS-UTF16-H.bcmap +0 -0
  144. package/client/pdfjs/cmaps/UniJIS-UTF16-V.bcmap +0 -0
  145. package/client/pdfjs/cmaps/UniJIS-UTF32-H.bcmap +0 -0
  146. package/client/pdfjs/cmaps/UniJIS-UTF32-V.bcmap +0 -0
  147. package/client/pdfjs/cmaps/UniJIS-UTF8-H.bcmap +0 -0
  148. package/client/pdfjs/cmaps/UniJIS-UTF8-V.bcmap +0 -0
  149. package/client/pdfjs/cmaps/UniJIS2004-UTF16-H.bcmap +0 -0
  150. package/client/pdfjs/cmaps/UniJIS2004-UTF16-V.bcmap +0 -0
  151. package/client/pdfjs/cmaps/UniJIS2004-UTF32-H.bcmap +0 -0
  152. package/client/pdfjs/cmaps/UniJIS2004-UTF32-V.bcmap +0 -0
  153. package/client/pdfjs/cmaps/UniJIS2004-UTF8-H.bcmap +0 -0
  154. package/client/pdfjs/cmaps/UniJIS2004-UTF8-V.bcmap +0 -0
  155. package/client/pdfjs/cmaps/UniJISPro-UCS2-HW-V.bcmap +0 -0
  156. package/client/pdfjs/cmaps/UniJISPro-UCS2-V.bcmap +0 -0
  157. package/client/pdfjs/cmaps/UniJISPro-UTF8-V.bcmap +0 -0
  158. package/client/pdfjs/cmaps/UniJISX0213-UTF32-H.bcmap +0 -0
  159. package/client/pdfjs/cmaps/UniJISX0213-UTF32-V.bcmap +0 -0
  160. package/client/pdfjs/cmaps/UniJISX02132004-UTF32-H.bcmap +0 -0
  161. package/client/pdfjs/cmaps/UniJISX02132004-UTF32-V.bcmap +0 -0
  162. package/client/pdfjs/cmaps/UniKS-UCS2-H.bcmap +0 -0
  163. package/client/pdfjs/cmaps/UniKS-UCS2-V.bcmap +0 -0
  164. package/client/pdfjs/cmaps/UniKS-UTF16-H.bcmap +0 -0
  165. package/client/pdfjs/cmaps/UniKS-UTF16-V.bcmap +0 -0
  166. package/client/pdfjs/cmaps/UniKS-UTF32-H.bcmap +0 -0
  167. package/client/pdfjs/cmaps/UniKS-UTF32-V.bcmap +0 -0
  168. package/client/pdfjs/cmaps/UniKS-UTF8-H.bcmap +0 -0
  169. package/client/pdfjs/cmaps/UniKS-UTF8-V.bcmap +0 -0
  170. package/client/pdfjs/cmaps/V.bcmap +0 -0
  171. package/client/pdfjs/cmaps/WP-Symbol.bcmap +0 -0
  172. package/client/pdfjs/pdf.worker.min.mjs +29 -0
  173. package/client/pdfjs/standard_fonts/FoxitDingbats.pfb +0 -0
  174. package/client/pdfjs/standard_fonts/FoxitFixed.pfb +0 -0
  175. package/client/pdfjs/standard_fonts/FoxitFixedBold.pfb +0 -0
  176. package/client/pdfjs/standard_fonts/FoxitFixedBoldItalic.pfb +0 -0
  177. package/client/pdfjs/standard_fonts/FoxitFixedItalic.pfb +0 -0
  178. package/client/pdfjs/standard_fonts/FoxitSerif.pfb +0 -0
  179. package/client/pdfjs/standard_fonts/FoxitSerifBold.pfb +0 -0
  180. package/client/pdfjs/standard_fonts/FoxitSerifBoldItalic.pfb +0 -0
  181. package/client/pdfjs/standard_fonts/FoxitSerifItalic.pfb +0 -0
  182. package/client/pdfjs/standard_fonts/FoxitSymbol.pfb +0 -0
  183. package/client/pdfjs/standard_fonts/LICENSE_FOXIT +27 -0
  184. package/client/pdfjs/standard_fonts/LICENSE_LIBERATION +363 -0
  185. package/client/pdfjs/standard_fonts/LiberationSans-Bold.ttf +0 -0
  186. package/client/pdfjs/standard_fonts/LiberationSans-BoldItalic.ttf +0 -0
  187. package/client/pdfjs/standard_fonts/LiberationSans-Italic.ttf +0 -0
  188. package/client/pdfjs/standard_fonts/LiberationSans-Regular.ttf +0 -0
  189. package/client/pdfjs/wasm/LICENSE_JBIG2 +196 -0
  190. package/client/pdfjs/wasm/LICENSE_OPENJPEG +39 -0
  191. package/client/pdfjs/wasm/LICENSE_PDFJS_JBIG2 +13 -0
  192. package/client/pdfjs/wasm/LICENSE_PDFJS_OPENJPEG +22 -0
  193. package/client/pdfjs/wasm/LICENSE_PDFJS_QCMS +19 -0
  194. package/client/pdfjs/wasm/LICENSE_QCMS +21 -0
  195. package/client/pdfjs/wasm/jbig2.wasm +0 -0
  196. package/client/pdfjs/wasm/jbig2_nowasm_fallback.js +15 -0
  197. package/client/pdfjs/wasm/openjpeg.wasm +0 -0
  198. package/client/pdfjs/wasm/openjpeg_nowasm_fallback.js +17 -0
  199. package/client/pdfjs/wasm/qcms_bg.wasm +0 -0
  200. package/client/pdfjs/wasm/quickjs-eval.js +16 -0
  201. package/client/pdfjs/wasm/quickjs-eval.wasm +0 -0
  202. package/lib/host/router.d.ts +1 -0
  203. package/lib/host/router.js +163 -5
  204. package/lib/host/static.d.ts +9 -0
  205. package/lib/host/static.js +100 -0
  206. package/lib/index.js +7 -1
  207. package/lib/zotero/annotations.d.ts +6 -1
  208. package/lib/zotero/annotations.js +6 -1
  209. package/lib/zotero/client.d.ts +12 -2
  210. package/lib/zotero/client.js +113 -5
  211. package/lib/zotero/config.d.ts +4 -0
  212. package/lib/zotero/config.js +4 -0
  213. package/lib/zotero/types.d.ts +22 -2
  214. package/package.json +3 -2
package/README.md CHANGED
@@ -1,10 +1,10 @@
1
1
  # dsh-plugin-zotero
2
2
 
3
- **装上它,DSH 就能直接操控你的 Zotero。**
3
+ **把 Zotero 文献库映射进 DSH:在同一个界面里精读文献,与 AI 同步作业。**
4
4
 
5
- 打通之后,Zotero 不再是一个要你手动点开、一层层翻找的软件,而是 DSH 随手可用的资料库:你可以直接让 DSH 去检索文库、精读某篇 PDF、汇总整理高亮标注与笔记、按主题新建分类并把文献归类;也可以把下载好的论文交给它导入,让它读完外文文献后把译文作为附件挂回对应条目。凡是 Zotero 本地接口和 MCP 插件能提供的操作,DSH 都可以替你做。
5
+ 本插件把 Zotero 的文库结构、元数据、PDF 全文、笔记与标注接入 DSH,将「检索文献 — 精读全文 — 摘录标注 — 与模型讨论 — 形成稿子」收进同一条工作流:右侧栏按分类与标签浏览文库,按标题 / 摘要筛选当前范围,双击条目即在 DSH 内打开独立阅读页,PDF 整页渲染、高亮原位叠加,同一篇文献的原文与译本附件可在页内切换;读到关键段落时可直接划词摘录,或引用该条标注、笔记乃至整篇文献,以引用胶囊写进当前会话草稿,模型随即基于原文接续完成综述、方法对比、数据提取与引文核对。
6
6
 
7
- 除了模型侧的能力,DSH 右侧栏还会多出一块「Zotero 文献库」面板:随时浏览自己的文库,把条目、摘录、标签或整个分类一键带进对话。
7
+ 模型侧同样具备完整的检索与整理能力:检索文库、精读 PDF、汇总高亮与笔记、按主题新建分类并归类,也可以把本地下载的论文导入 Zotero,读完外文文献后把译文作为附件回挂到对应条目。凡 Zotero 本地接口与集成 MCP 能提供的操作,均可由模型代劳。
8
8
 
9
9
  不用写代码,也不用记命令。第一次使用前,只需在 Zotero 里完成两项一次性设置(装一个桥接小插件、打开通信开关),步骤见[使用前提](#使用前提)。
10
10
 
@@ -12,18 +12,22 @@
12
12
 
13
13
  [![DSH 右侧栏中的 Zotero 文献库面板](docs/images/zotero-pane.png)](docs/images/zotero-pane.png)
14
14
 
15
- <sub>上图为 DSH 会话与右侧「Zotero 文献库」面板:上方正文区展示元数据与全文,下方分区 tab 展示参考文献、笔记与附件,点击图片可查看原图。</sub>
15
+ <sub>上图为 DSH 会话与右侧「Zotero 文献库」面板:左侧分类树与标签面板,右侧是当前范围的条目列表;双击条目会在右侧栏顶层单开一个标签页,整页展示 PDF(可缩放、叠加高亮标注),元数据、摘要、笔记、标注与附件收进左上角的信息按钮。点击图片可查看原图。</sub>
16
+
17
+ [![在 DSH 内边读 PDF 边与 AI 交互](docs/images/zotero-reading-with-ai.png)](docs/images/zotero-reading-with-ai.png)
18
+
19
+ <sub>上图为 DSH 内的文献阅读现场:右侧标签页整页渲染 PDF(图为译文附件,原文与译本可在信息面板切换),点正文里的高亮标注即弹出标注卡片,原文、类型与「引用 / Zotero」入口都在手边;左侧会话里该段原文已作为引用写入草稿,模型据此继续作答。点击图片可查看原图。</sub>
16
20
 
17
21
  它能替你做的事,举几个常见例子:
18
22
 
19
- - **找文献**:按标题、年份、全文关键词检索,也能跨库搜高亮和批注,快速回答「我收过哪些讲 XX 的文章」。
20
- - **读文献**:读摘要、PDF 全文、笔记与标注,写综述、做对比、提取数据都行;需要精确引用时会保留原文措辞。
23
+ - **找文献**:按标题、年份、全文关键词检索,也能跨库搜高亮和批注,快速回答「我收过哪些讲 XX 的文章」;右侧栏里还能按分类、标签和标题 / 摘要逐层缩小范围。
24
+ - **读文献**:双击条目就在 DSH 内开独立阅读页,PDF 整页渲染、高亮原位叠加,原文与译本附件随时切换;摘要、全文、笔记与标注都能在这里读完,写综述、做对比、提取数据都行,需要精确引用时会保留原文措辞。
21
25
  - **整理文库**:新建、重命名、移动、删除分类,批量把条目加入或移出分类。你说一句「把这几篇归到『待读』里」,它就照做。
22
26
  - **帮你入库**:把本地下载好的论文、PDF 交给 DSH 导入 Zotero;也可以让它读完外文文献后,把译文作为附件挂回条目。
23
- - **带进对话**:右侧面板单条目引用、全文划词摘录、单标签或多标签引用、整分类引用,一键写进当前会话草稿(不自动发送),你再接着说要求。条目、标签和整分类以「引用胶囊」的形式出现,草稿里一眼看清引了哪几篇,单独删掉某一条也不影响其他内容。
27
+ - **带进对话**:右侧面板单条目引用、列表多选批量引用、阅读页划词摘录与点高亮引用、单标签或多标签引用、整分类引用,一键写进当前会话草稿(不自动发送),你再接着说要求。条目、标签和整分类以「引用胶囊」的形式出现,草稿里一眼看清引了哪几篇,单独删掉某一条也不影响其他内容。
24
28
  - **安全可控**:浏览面板严格只读;模型能用的每一项工具都能单独开关,想彻底只读就把写操作关掉;写操作优先走集成 MCP,它在 Zotero 进程内直接执行,不触发本地 API 的授权弹窗。
25
29
 
26
- 面板布局与 Zotero 本体一致:顶部状态栏显示连接状态并提供刷新;左侧是分类树,树下是可拖高的标签面板;中间列表显示当前范围(分类 / 全库 / 标签筛选后)的条目;点条目在右侧栏顶层单开一个标签页看详情。
30
+ 面板布局与 Zotero 本体一致:顶部状态栏显示连接状态并提供刷新;左侧是分类树,树下是可拖高、可折叠的标签面板;右侧列表显示当前范围(分类 / 全库 / 标签筛选后)的条目。分类树与条目列表之间的分隔条可拖动,宽度按本机记住。列表里单击条目选中、`Ctrl` / `Cmd` 点选多选,双击才在右侧栏顶层单开一个标签页看详情。阅读页就开在会话旁边的标签里,边读边摘、边问边改,不必在 Zotero 与 AI 两个窗口之间来回切换。
27
31
 
28
32
  > 面向使用者的完整说明(入口、交互、toast 与错误对照表)见 [插件使用说明](docs/插件使用说明/dsh-plugin-zotero使用说明.zh.md)。
29
33
 
@@ -75,14 +79,16 @@ curl http://127.0.0.1:23119/api/ # 期望输出:Zotero is running
75
79
 
76
80
  ## 特性
77
81
 
78
- - **右侧栏面板「Zotero 文献库」**:顶部状态栏(Zotero / 模型工具探活)+ 左侧分类树与标签面板 + 中间条目列表;与 Zotero 本体同构,条目不再挤在分类行下面。分类树顶部可按名称筛选目录(同 Zotero 左栏:只筛目录名,命中项与祖先保留、自动展开,不影响右侧条目搜索)。
79
- - **标签面板**:树下方独立面板,标签跟随当前目录:选中分类时只列该分类自身条目里出现过的标签(不含子目录,自动标签弱化显示),选中文库根时列出全库标签;可按名称筛选、多选,并切换「全部(AND)/ 任一(OR)」。筛选作用于当前选择的范围,列表头部会显示已选标签胶囊与「清除筛选」;切换目录会自动清除已选标签,避免旧筛选作用到新范围。
80
- - **条目详情独立成页**:点条目在右侧栏顶层新开一个标签页,同一条目再次点击只回到已有页;详情页可同时开多个,切换标签页时各自的展开状态与滚动位置都保留(正文常驻挂载)。
81
- - **详情区上下分区**:上方正文区展示标题、元数据、摘要与 PDF 全文;下方用 tab 切换「参考文献 / 笔记 / 标注 / 附件」。两个区域之间的分隔条可拖动,正文占比默认 85% 并按会话记住;没有次级内容的条目正文独占整栏。
82
- - **摘要默认折叠**:标题行右侧的箭头按钮展开 / 收起摘要,默认把空间留给正文与全文。
83
- - **笔记可读**:独立笔记(文库里的全局笔记)打开后正文直接占据上方正文区,跟普通条目一样阅读;条目下的子笔记仍进「笔记」tab,以折叠列表呈现(默认收起,点击标题展开),正文保留 Zotero 的引用块、标注高亮、表格与外链图片。Host 侧已清洗脚本与事件属性,避免注入。「引用」把该条笔记转成纯文本写进会话草稿。
84
- - **标注可读**:PDF 上的高亮与划线汇总进「标注」tab(带颜色、页码、原文与评论,可按类型 / 颜色筛选);全文块里原位标出底色与下划线,点列表条目可滚动定位并闪烁,「引用」把该条标注写进会话草稿。
85
- - **多种插入方式**:单条目、单标签、多标签(合并成一枚「标签组」胶囊,AND/OR 在插入那一刻定格)与整目录引用都以「引用胶囊」写进草稿——胶囊只显示标题,发送那一刻才展开成完整引用文本,模型拿到的内容与以前一致;全文划词摘录、单条标注、单条笔记仍按纯文本插入。所有方式都只写进会话草稿(不自动发送、不抢焦点),文本携带 `itemKey` / `collectionKey` / 标签名供模型接续操作。标签类引用始终按全库范围展开,不受你当时选中哪个分类影响。
82
+ - **右侧栏面板「Zotero 文献库」**:与 Zotero 本体同构——顶部状态栏(Zotero / 模型工具探活 + 刷新),左侧分类树与标签面板,右侧是当前范围的条目列表;条目独立成列。分类树与条目列表之间的分隔条可拖动,宽度按本机记住。
83
+ - **分类筛选**:分类树顶部可按名称筛选目录(同 Zotero 左栏:只筛目录名,命中项与祖先保留、自动展开,不影响右侧条目搜索)。
84
+ - **条目列表**:每行显示文献类型图标与作者 / 年份;读过的文献类型图标转为粉色、标题略淡,悬停补上类型名与最后阅读时间。单击选中、`Ctrl` / `Cmd` 点选多选,双击在右侧栏顶层开独立详情页,右键单行可直接插引用;头部搜索框针对当前范围(分类 / 全库 / 标签筛选后)按标题与摘要过滤,列表可分页「加载更多」,选中多条时右上角一次「引用 N」。
85
+ - **标签面板**:树下方独立面板,可拖高 / 折叠;标签按 Zotero 的换行胶囊排布并跟随当前目录:选中分类时只列该分类自身条目里出现过的标签(不含子目录,自动标签弱化显示),选中文库根时列出全库标签;可按名称筛选、多选,并切换「全部(AND)/ 任一(OR)」。筛选作用于当前选择的范围,列表头部会显示已选标签胶囊与「清除筛选」;切换目录会自动清除已选标签,避免旧筛选作用到新范围。已选标签可从摘要行合并成一枚「标签组」胶囊引用。
86
+ - **条目详情独立成页**:双击条目在右侧栏顶层新开一个标签页,同一条目再次双击只回到已有页;详情页可同时开多个,切换标签页时各自的展开状态与滚动位置都保留(正文常驻挂载)。
87
+ - **文档优先版面**:详情页整页显示文献本体——PDF 走 PDF.js 渲染(顶部工具栏缩放、页码、当前页在 Zotero 中打开),没有 PDF 时回退到 API 全文文本。左侧固定的 30px 工具栏不遮挡正文。选中正文即浮出「摘录」按钮,点正文里的高亮则弹出标注卡片(类型、原文、「引用」与「在 Zotero 中打开」)。
88
+ - **左上角信息面板**:点左上角 `i` 按钮弹出浮层,把文献信息 / 摘要 / 标注 / 笔记 / 附件 / 参考文献分块竖排,每块可单独折叠;点浮层外或按 `Esc` 关闭,点标注定位时自动关闭把焦点还给文档。
89
+ - **笔记可读**:独立笔记(文库里的全局笔记)打开后正文直接占据文档区,跟普通条目一样阅读;子笔记在信息面板的「笔记」块里折叠呈现,正文保留 Zotero 的引用块、标注高亮、表格与外链图片。Host 侧已清洗脚本与事件属性,避免注入。「引用」把该条笔记转成纯文本写进会话草稿。
90
+ - **标注可读**:PDF 上的高亮与划线原位叠加在页面上,点页内标注弹出卡片,可当场「引用」或跳回 Zotero 对应页;「标注」块按类型 / 颜色筛选,点条目可跨附件定位、滚动并闪烁,「引用」把该条标注写进会话草稿。
91
+ - **多种插入方式**:单条目、列表多选批量、单标签、多标签(合并成一枚「标签组」胶囊,AND/OR 在插入那一刻定格)与整目录引用都以「引用胶囊」写进草稿——胶囊只显示标题,发送那一刻才展开成完整引用文本,模型拿到的内容与以前一致;全文划词摘录、单条标注、单条笔记仍按纯文本插入。所有方式都只写进会话草稿(不自动发送、不抢焦点),文本携带 `itemKey` / `collectionKey` / 标签名供模型接续操作。标签类引用始终按全库范围展开,不受你当时选中哪个分类影响。
86
92
  - **胶囊依赖本插件展开**:草稿里留着引用胶囊时禁用或卸载本插件,发送会失败并提示找不到引用来源,把胶囊删掉即可继续正常发送。
87
93
  - **面板严格只读**:不提供任何新建 / 改名 / 删除分类的按钮。
88
94
  - **模型侧工具可逐个开关**:插件自持连接集成 MCP,把工具以 `mcp__zotero__*` 注册进 dsh,可在插件页按工具启用 / 禁用。
@@ -125,7 +131,7 @@ MCP 组下方是 **「MCP 工具」** 区:现场列出集成 MCP 的全部工
125
131
 
126
132
  | 半边 | 能力 | 通道 |
127
133
  |---|---|---|
128
- | **人侧面板** | 在 DSH 右侧栏只读浏览 Zotero 文库(分类树 / 标签面板 / 条目列表 / 搜索 / 条目详情 / 笔记 / 标注 / PDF 全文),把条目、摘录、标注、笔记、标签或整目录引用写进会话草稿 | 插件在宿主 web server 自注册的 `/dsh-zotero/api/*` 路由 |
134
+ | **人侧面板** | 在 DSH 右侧栏只读浏览 Zotero 文库(分类树 / 标签面板 / 条目列表 / 搜索 / 条目详情 / 笔记 / 标注 / PDF 阅读),把条目(含多选批量)、摘录、标注、笔记、标签或整目录引用写进会话草稿 | 插件在宿主 web server 自注册的 `/dsh-zotero/api/*` 路由 |
129
135
  | **模型侧** | 检索、精读、按需操作文库 | 插件**自持**连接本机 Zotero 集成 MCP,工具以 `mcp__zotero__*` 注册给模型 |
130
136
 
131
137
  MCP 没起,面板照常可用;Zotero 没开,模型工具自然也不可用。
@@ -168,12 +174,17 @@ src/ # 插件源码(主包,ESM / NodeNext / strict)
168
174
  ├── ZoteroCard.tsx # 插件页配置卡(API 设置 / MCP 设置 / 工具开关)
169
175
  ├── ZoteroPane.tsx # 面板容器:状态栏 + 分类树 / 标签面板 + 条目列表
170
176
  ├── CollectionTree.tsx / TagPanel.tsx / ItemList.tsx
177
+ ├── SearchField.tsx # 目录筛选 / 条目搜索 / 标签筛选共用的紧凑搜索框
178
+ ├── itemType.tsx / readState.tsx # 文献类型图标与已读标记
171
179
  ├── ZoteroItemPane.tsx # 条目详情 tab 的正文与标题
172
- ├── ItemDetail.tsx / DetailTabs.tsx # 详情正文与底部分区 tab(参考文献 / 笔记 / 标注 / 附件)
173
- ├── NoteList.tsx # 笔记折叠列表与正文渲染
180
+ ├── ItemDetail.tsx # 文档优先详情:选附件 / 跨附件定位 / 打开 Zotero
181
+ ├── InfoPanel.tsx # 左上角悬浮信息面板(可分块折叠)
182
+ ├── viewer/ # 渲染器注册表 + PDF.js 渲染 / 文本回退 / 标注叠加与几何换算
183
+ ├── AnnotationList.tsx / NoteList.tsx # 标注与笔记列表
184
+ ├── Toast.tsx # 插入结果等轻提示
174
185
  ├── reference.ts / cite.ts # 引用胶囊的 ref 编码与提交时的文本展开
175
186
  ├── useInsertion.ts / inline.ts # 往会话草稿插入胶囊或纯文本
176
- ├── styles.ts # 分区小标题 / 展开按钮等共用样式
187
+ ├── styles.ts # 强调色等共用样式常量
177
188
  ├── paneStore.ts # 跨会话共享的面板状态
178
189
  ├── compose.ts # 插入文本模板
179
190
  ├── api.ts # 调 Host 端点