Skip to content
dsh marketplace

dsh-cite-lens

Verified

dsh-cite-lens · v0.3.1 · MIT · Web UI

Cite Lens for dsh: select text in a PDF in the Files tab to quote or ask about it in the current chat, and turn the model's [main.pdf p.7 "exact words"] citations into links that open the PDF and highlight the passage; /cite-links makes a chat cite every

Install

dsh plugin add dsh-cite-lens

Confirm the layer applied with dsh --profile default --dump-config — see the install guide.

Source

Tags

Readme

dsh-cite-lens

dsh-cite-lens

English | 中文

language license node dsh runtime tests

一个 DeepSeek Harness 插件：就在你已经打开的 PDF 里，和模型一起改论文。

  • 在 PDF 里选中文字，就它提问。 Files 标签页里的 PDF 以可选中的文字打开。选中一段话，把它发到当前这个对话里——带引用，并标上文件和页码。
  • 点模型的引用就能跳过去。 当模型写出 [main.pdf p.7 "exact words"] 这样的引用时，它就是一个链接：点一下会打开 PDF、滚到那几句话，并用一层渐隐的标记高亮它们。
  • /cite-links 让这个对话里关于论文的每一句都带上这样的链接——审稿时很好用，也能用来核对模型改了你的 LaTeX 之后到底改了什么。

一切都留在你自己的机器上。 PDF 用 PDF.js 在你的浏览器里渲染，不上传任何东西；插件本身从不发送消息——它只往你的输入框里填内容。

点击引用：PDF 滚到被引用的那几句话并高亮它们

安装

dsh plugin --profile web add dsh-cite-lens

重启 dsh web。此后从 Files 标签页打开的 PDF 都走 Cite Lens。想回到 dsh 内置的 PDF 视图，把插件移除即可。

你会得到什么

选中一段话，就它提问

选中文字后，上方会出现一条工具栏：

按钮 放进你输入框的内容
Quote（引用） 那段话，标上 main.pdf · p.17，留给你在下面接着写
Ask（提问） 那段话，光标停在 Question: 之后
Explain（解释） 那段话，外加一句请它解释的要求
Check this（核对） 那段话，外加一句请它对照论文核对论点的要求

每一样都追加在你已经打的内容下面，并且落在你当前所在的对话里。你不发送，它就不会发出去。

选中文字：两端有拖拽手柄，以及 Quote / Ask / Explain / Check this 工具栏

Quote 在输入框里放进了什么

这里的选中行为像编辑器，而不像 PDF 的原始文字层：

  • 光标划过行间空隙或页边时，不会一下子跳到整页；
  • 两端的手柄可以把选区拉长或缩短，并对齐到最近的字；
  • Shift+点击扩展或收缩选区；Shift+←/→ 按字符移动末端，Shift+Alt+←/→ 按词移动。

能打开 PDF 的引用

插件会往每个对话的系统提示里加一小段说明，告诉模型这套引用格式，于是它可以这样指向具体位置：

模型写 点它会
[p.7] 你正在读的那个 PDF 的第 7 页
[main.pdf p.7] 打开 main.pdf（或切过去）到第 7 页
[main.pdf "exact words"] 打开它，在整个 PDF 里找到这些词并高亮
[main.pdf p.7 "exact words"] 同上，先在第 7 页里找

页码是故意做成可选的：模型改过你的 LaTeX 之后，很少知道某句话落在了哪一页，所以它引原话，由 Cite Lens 去找。匹配很宽容——换行、跨行连字符、连字（ligature）、弯引号和大小写都会被忽略——而且对还没画出来的页也有效。如果 PDF 里没有这些词（比如改动之后还没重新编译），链接会告诉你，而不是跳到错误的地方。

路径相对于对话的工作区（[build/main.pdf "…"]）。没有打开的 PDF 会通过 dsh 的 Files 标签页打开。什么都没打开时，一个光秃秃的 [p.7] 会重新打开你上次用过的 PDF。

/cite-links

/cite-links          本对话开 / 关
/cite-links on|off   直接设定
/cite-links status   查看状态

打开期间，你发出的每条消息都会附带一段简短提醒，要求模型把关于论文的每条陈述都用链接支撑起来——正文、列表和表格都一样。对话顶栏上的一个链接图标显示当前状态（开启时带一个圆点），点一下即可切换。这个设置按对话保存，重启后仍然有效。

顶栏指示器，引用链接已开启

环境要求

  • dsh 0.1.5-rc.2 或更新的版本，web profile（dsh web）。开发基于 0.1.5 线，并在 0.2.1-rc.3 上核对过：PDF 预览以外部队列（external band）的渲染器注册，并声明 binaryExtensions: ['pdf']，这是两条线共有的契约。
  • Node.js 22 或更新版本
  • 一个较新的浏览器。引用的下划线用 CSS Custom Highlight API 绘制；在不支持它的浏览器里，链接照样能点，只是没有下划线。已在 Chrome 中测试。

工作原理

部分 用到的 dsh 接口
PDF 视图 ctx.documentPreviews.register({ extensions: ['pdf'], priority: 'extension' }) 与带 key 的 sidebar.right.tab.document 插槽——外部队列排在内置视图之前
写入你的输入框 当前对话（ctx.sessions.list）→ 它的 scope（ctx.sessions.scope）→ ctx.conversation.input.for(scope)：读取草稿并追加，从不替换，也从不在一句话正在发送时去动它
打开被引用的 PDF ctx.sidebarRight.openResource(address)
引用链接 用 ::highlight() 上色的文本范围，点击时做命中测试——对话的 DOM 从不被修改，所以流式回复不受影响
引用说明 每个对话系统提示里的一节（agent/session-start）
/cite-links 一个 dsh 命令；开启期间，提醒会附在承载你新提示的那一步上（agent/pre-step），每条提示一次

长论文上的渲染依然顺滑：页面按离你阅读位置最近优先、一页一页地画，先 1× 起手，滚动停止后再变清晰；远处页面会被释放；文字层在空闲时间里构建。

开发

npm install      # PDF.js 和 esbuild（仅开发用——运行时没有依赖）
npm run build    # src/client → lib/client.js
npm test         # 引用、写入对话、引用解析、/cite-links、PDF.js 取文字

lib/client.js 是生成的：改 src/client/，然后重新构建。它打包了 PDF.js（Apache-2.0）及其 worker，所以插件不需要任何静态文件路由。

许可

MIT——见 LICENSE，其中也包含随包分发的 PDF.js 的声明。