dsh-selection-group

Selection Toolbar

简体中文 · English

选中对话文字，批注、引用或放入侧边对话。

一个为 DeepSeek Harness 提供选区工具条的插件。单条消息和跨消息选区共用一个工具条，包含「批注 / 引用 / 侧边对话」，不再创建独立引用浮窗。

功能

• 批注：为选中文字添加备注，随下一条消息发送。待发送批注入口位于输入区左侧的预留行。
• 引用：把摘录插入当前输入框，优先使用原生引用，不支持时使用文本引用。
• 侧边对话：创建空线程，把摘录放入新线程草稿，编辑后自行发送。需要 dsh-better-sidebar，未启用时不显示该按钮；摘录超过 4000 个字符时截断。
• 支持同一主会话内跨消息选择，包括跨过复制、状态按钮的选区。
• 鼠标松开后显示工具条；键盘选区立即显示。取消选区时关闭，流式重渲染导致选区丢失时保留原始摘录。
• 侧边栏、文件预览、输入框和编辑区不弹框；直接选择按钮文字也不处理。

批注和引用功能已内置，无需另装上游插件。请勿同时启用 @changfenhuang/dsh-annotation 或 dsh-quote-followup 的独立实例，以免重复显示或争用状态。

演示

这张图来自加载真实 v1.6.5 插件客户端的模拟对话页面。

安装

从 GitHub 安装

1. 打开 DSH 的 插件 页面，先检查是否已安装 dsh-selection-group。已安装时使用更新入口，避免重复添加。

2. 点击 添加插件，在“包名或地址”中填写：

   https://github.com/jabingu/dsh-selection-group
   

3. 按应用提示完成加载并启用，重启 DSH。

4. 在主对话中选中文字，松开鼠标，确认工具条出现。

仓库包含构建好的 lib/ 和 client.js，安装前无需自行构建。本包通过 GitHub 分发，不通过 npm registry 发布。

从本地目录安装

下载仓库 ZIP 并解压，或克隆仓库。检查插件尚未安装后，在同一添加入口填写包含 package.json 的目录绝对路径，启用后重启 DSH。

验证尚未推送到仓库的修改时，请使用本地目录。更新已链接目录中的文件并重启 DSH 即可，无需重复安装；GitHub 来源需更新仓库对应版本后才能获得这些修改。

官方桌面 profile 由应用管理，请使用桌面插件页面。使用 dsh web 的用户可在插件目录执行：

dsh plugin --profile web list --depth=0
# 确认尚未安装后再添加：
dsh plugin --profile web add .

使用示例

在助手回复中选中：

插件是一段可以插进现有软件里的附加程序，让软件多出一项功能。

松开鼠标后，在同一个工具条中选择：

• 批注：写下“给一个更具体的例子”，保存后随下一条消息发送。
• 引用：将这段文字放入当前输入框，再输入追问。
• 侧边对话：将文字放入新线程草稿，补充问题后自行发送。

跨用户消息和助手回复选择时，操作方式相同。

开发与验证

使用 Node.js 22.19.0 或更新的 22.x，或 Node.js 24 及以上版本，在项目目录执行：

npm install
npm run build
npm test

当前 115 项自动化测试通过，覆盖跨消息选区、批注首次显示与布局清理、取消与流式恢复、侧边线程归属和插件生命周期。批注布局另在模拟本机 DSH 贴底结构的 Chrome 测试页中检查了普通、窄窗口和队列场景；最新修改仍需在实际 DSH 中验证。

client.js 由 src/、vendor/ 和 patches/ 生成，请勿手动修改。npm test 会先检查构建产物与源码是否一致，再运行测试。

诊断入口：window.__DSH_SELECTION_GROUP__。构建补丁和兼容性说明见 第三方声明，变更记录见 CHANGELOG。

许可证

MIT。内置上游代码的许可见 第三方声明。