划词引用工具 hjthjt4210/dsh-selection-tools

dsh-selection-tools

面向 DSH web 客户端的对话页选中文字工具。

演示

dsh-selection-tools 演示

查看高清演示视频

在对话页面用鼠标或键盘选中任意文字时，选区旁会出现一个迷你工具条，提供两个动作：

| 动作 | 行为 |
| 引用 | 把选中文字加入注释胶囊,悬停可查看原文,点击 × 可删除,发送时展开为附加上下文 |
| 复制 | 把选中文字写入系统剪贴板 |

功能

- 选中文字后显示「引用」和「复制」。
- 引用内容以「N 条注释」胶囊显示在输入栏。
- 悬停胶囊可查看每条引用的完整内容。
- 点击胶囊右侧 × 可删除全部注释。
- 发送消息时，注释会作为 上下文提交。
- 已发送的消息会把 协议正文替换为「N 条注释」胶囊；悬停或键盘聚焦胶囊可查看每条引用，消息中的普通正文仍会保留。

安装

在 PowerShell 中执行：

git clone https://github.com/hjthjt4210/dsh-selection-tools.git
Copy-Item -Recurse -Force .\dsh-selection-tools "$env:USERPROFILE\.dsh\profiles\web\node_modules\dsh-selection-tools"

然后在 %USERPROFILE%\.dsh\profiles\web\package.json 的 dsh.profile.bundles 数组中加入 "dsh-selection-tools"，最后重启 DSH。

DSH Desktop 用同一个 package.json 结构，把上面两处的 web 换成 desktop 即可（%USERPROFILE%\.dsh\profiles\desktop\）。只需要往 bundles 里加，不要写进 dependencies——那个数组里的条目会走 pnpm 解析。

本插件的 lib/index.js 是无操作的宿主入口,浏览器功能位于 lib/client.js。
这种双入口结构可避免 DSH 启动时在 Node.js 环境执行浏览器代码。

原理

- 选区工具条注册在官方 shell.overlay 全框架浮层槽。
mouseup/Shift+方向键 keyup 后取 window.getSelection() 的非空选区，用选区 getBoundingClientRect() 定位浮层。
- 注释胶囊显示在输入栏左侧。多次引用会更新同一个胶囊的计数,悬停可查看每条
- 引用的完整内容，点击 × 会删除全部注释，也不会显示成功提示条。
- 引用数据通过官方 conversation 服务的 shell.insertReference() 写入，正文不会直接塞进可见草稿。
- 发送序列化通过 inputTriggers 注册专用 codec。DSH 提交草稿时把芯片展开为上下文；删除芯片会同时取消这些引用。选中文字按 XML 实体转义（& ）后再写入信封，回读时还原，因此引用一段含标签的文本不会提前闭合协议。
- 已发送消息渲染通过客户端 DOM 观察器识别协议片段，只替换可见协议文本，发送给模型的原始上下文不变。
观察器只处理变更所在的子树，不做全文档扫描。
- 复制优先使用 Clipboard API，并为不支持的环境提供本地复制回退。
- 样式只用 --dsw-* 主题令牌，自动跟随深浅色模式。

开发

无构建步骤，lib/client.js 是标准 window.__ModuleLoader__.load 客户端插件（React 18 + react/jsx-runtime）。

npm test
等价于：
node --check lib/index.js
node --check lib/client.js
node test/render.smoke.mjs

test/render.smoke.mjs 自带一个最小 DOM 桩，直接跑 lib/client.js 里的真实函数，覆盖转义往返、胶囊渲染和每次变动的扫描开销，不需要装任何依赖。

License

MIT