Skip to content

dsh-better-quotes

Verified

dsh-better-quotes · v0.5.0 · MIT · Web UI

Quote or forward whole messages in DeepSeek Harness Web — one-action quoting, right-Sidebar multi-select, durable message metadata, and cross-session forwarding

Install

dsh plugin add dsh-better-quotes

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

Source

Tags

Creators

Readme

dsh-better-quotes

npm version CI License: MIT

dsh-better-quotes — DeepSeek Harness 整条消息引用

在 DeepSeek Harness Web 中引用或转发整条消息——一次点击,一个 bundle,模型回查所需的全部身份。

官方划词引用只复制文本片段,转头就忘了它从哪来。本插件引用整条消息——用户、插话或助手——连同发送人、时间、身份、模型路由、Skill、引用和附件,打成一个模型可读、可回查的有界 bundle。

特点

  • 一个控件,两种结果。 点击 Copy 与 Fork 之间的引用图标立即引用该消息;长按(或按 Shift+Enter)进入多选。会话区不增加任何复选框或工具条。
  • 整条消息多选。 在右侧边栏「引用」标签页里自由多选用户、插话和已完成的助手消息;选择过程中对话区不动、不白屏、不被遮挡。
  • 持久元数据。 每条被引用的消息都带发送人角色、时间、session_id、seq、message_id、provider/model、已加载 Skill、@session 引用,以及含名称、大小和尺寸的图片/文件附件。
  • 一个有界 bundle。 单个 <quoted_messages> 信封替代 N 条散落的引用块——模型把引用当上下文读,并能按身份回查原事件。
  • 跨会话转发。 从同一个面板把同一个 bundle 作为非指令参考上下文发给任意本地 Session。
  • 点击定位。 发送后的引用卡默认折叠;点击条目滚动到原消息并短暂高亮,折叠的过程组会先展开。跨会话的卡会注明并隐藏来源导航。
  • 读得懂的引用芯片。 输入框里显示一行摘要(引用条数与消息预览),而不是生硬的信封标签。
  • 本地优先。 无外部请求、无遥测、无远程服务——一切都在你的 DSH 进程内运行。

快速开始

npm ci
npm run build
npm pack
dsh plugin --profile web add /absolute/path/to/dsh-better-quotes-0.5.0.tgz

从 DSH 源码仓库运行时把 dsh plugin 换成 pnpm dsh plugin。重启 dsh web 或刷新浏览器。支持 DSH >=0.2.1-rc.3 <0.3.0-0。

发布到 npm 后可直接:

dsh plugin --profile web add dsh-better-quotes

使用

单条引用

点击 Copy 与 Fork 之间的引用图标,消息立即进入输入框,交互与官方划词引用一致。引用芯片显示一行摘要(引用条数与消息预览),bundle 附在同一个引用里。

多条引用或转发

  1. 长按同一个图标约半秒,或按 Shift+Enter。
  2. 右侧边栏打开「引用」标签页,并已预选该消息,列表停在最新消息。点击行切换选择,搜索缩小列表,单个全选/清空控件操作当前可见结果。
  3. 点击 插入引用(N) 得到一个 bundle,或点击 转发 选择另一个本地 Session 并发送同一个 bundle;任一动作完成后侧边栏自动收起。
  4. 目标列表不包含当前 Session 和 subagent Session。

定位

发送后的引用卡默认折叠。展开后点击同会话条目,会滚动到原消息并短暂高亮;折叠的过程组会先展开。转发卡显示 来自其他会话,不提供来源导航。

Bundle 格式

一次插入生成一个信封;输入框草稿在其前加上引用芯片显示的摘要行,发送后该行并入引用卡,会话里只显示卡:

<quoted_messages version="1" source_session="…" count="2">
<quoted_message role="user" time="2026-10-26T04:05:06.789Z" seq="12" message_id="…" session_id="…">
<metadata>
<skill name="pdf" />
<reference name="Spec" />
</metadata>
The deployment failed after the schema change.
[attachment kind=file name="deploy.log" bytes=4096 id="…"]
</quoted_message>
<quoted_message role="assistant" time="2026-10-26T04:05:08.000Z" seq="13" message_id="…" session_id="…">
<metadata provider="deepseek" model="deepseek-chat">
</metadata>
It fails because the migration dropped the index.
</quoted_message>
</quoted_messages>

session_id + seq 让模型用 session_event_read 读取原事件;宿主没有 message_id 时该字段省略。<skill> / <reference> 记录已加载 Skill 和 @session 标签;[attachment …] 记录图片/文件的持久 id、名称、大小、媒体类型和尺寸。正文中的字面边界标签会被转义。

附件只引用、不复制。历史压缩移除原消息后,图片像素可能不可用;文件也只有在原始保存路径仍存在时可读。

模型回查

需要模型读取原事件时挂载可选工具:

- name: '@deepseek-ai/dsh-tool-session-query'

未挂载时 bundle 仍可读,但不能按身份查询原事件。

兼容性与隐私

  • 宿主提供 insertQuote 时使用原子引用;旧宿主回退到光标处 insertText。
  • 选择器通过标准 Session props 读取 Chat 快照,不抓取 DOM。
  • 转发只在同一本地 DSH 进程内、发送到客户端已列出的 Session。
  • 无外部 HTTP 请求、遥测或远程服务。
  • 所有文本由 React 渲染;样式类名统一加 bq- 前缀。

与热门插件对比

基于 2026-10-26 的公开 README。

插件 选择入口 引用形态 跨会话转发 持久身份
dsh-better-quotes 一个动作:点击引用,长按右侧边栏多选 单个 <quoted_messages> bundle 是,同一标签页 session_id、seq、message_id、时间、路由、Skill、引用
dsh-message-forward 长按多选;转发弹窗 转发上下文 是 来源会话与说话者
dsh-quote-followup 划词工具条;文本 引用 chip 否 文本选择
dsh-select-quote 划词工具条;文本 堆叠卡片 否 文本选择
dsh-quote-annotate-pro 划词工具条;文本与批注 锚点引用块 否 轮次/角色锚点
dsh-multi-selection-comments 划词工具条;多个文本片段 结构化上下文 否 片段与评论

设计

  • 一个控件承载两种结果:点击直接引用,长按进入多选。
  • 多选是 sidebar.right.pane.tab 标签页正文,选择消息时对话区保持不动。
  • 面板是一次事务:动作完成后收起侧边栏,再次进入列表停在最新消息。
  • 一个 bundle 替代 N 个散 quote,带来源、数量、顺序和逐条边界。
  • 引用卡默认折叠,点击条目即定位。
  • 定位会先展开折叠的过程组,再驱动真实滚动容器。
flowchart LR
  A[Click] --> B[formatBundle]
  B --> C[insertQuote / insertText]
  A2[Hold] --> D[Quotes tab]
  D --> E[select messages]
  E -->|Insert| C
  E -->|Forward| F[choose target Session]
  F --> G[sessions.using + prompt queue]
  C --> H[Collapsed bundle card]
  G --> H
  H --> I[Click item to locate]
  H --> J[session_event_read via session_id + seq]

限制与后续计划

  • 多选在右侧边栏,不向每条消息行注入复选框。
  • 定位只在来源 Session 内可用。
  • 附件只引用、不重新附加;缩略图和重新附加仍是后续工作。
  • 只列出当前已加载、可见的 Chat 窗口。
  • 暂无浏览器 E2E 或 GIF。

开发

npm ci
npm run typecheck
npm test
npm run build
npm pack
  • QuoteAction.tsx — 单击引用 / 长按多选。
  • QuoteDrawer.tsx、QuoteRow.tsx — 右侧边栏选择器与消息行。
  • bundle.ts、quote-rule.ts、BundleQuote.tsx — bundle 格式、解析与引用卡。
  • locate.ts — 展开与来源定位。
  • tests/ — 41 个聚焦测试。

许可证

MIT。见 LICENSE。

English documentation: README.md。