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