@yfwu2020/dsh-selection-explain

dsh plugin --profile web add @yfwu2020/dsh-selection-explain

<div align="center">

划词解读

划一下，说一句。把不懂的地方，就地问明白。

DSH 中的翻译、上下文解读与语音追问。

[快速安装](#install) · [语音输入](#voice) · [功能一览](#read) · [使用与设置](#settings)

DSH 插件 · v0.13.1 · MIT

</div>

---

<a id="voice"></a>

01 / 划完，直接说

选中一句话，直接用语音问“它在这里是什么意思？”——问题留在选区旁，回答接着出现在小窗里。

从划词到提问，一口气完成

小窗还没打开：划选文字后启动输入法语音，选区旁会出现临时卡片，承接你说的话。结束语音、文字定稿后，默认自动发送，直接进入追问。

选区通过青色下划线和虚线连接到临时输入卡片。

小窗已经打开：划选新的文字，再启动输入法语音。这段文字会作为引用加入小窗，你说的话写入追问框。

在小窗里，也能直接开口

点击输入框旁的麦克风开始录音，查看实时波形与转写；点击停止完成输入，或按 Esc 取消本次录音。实时转写不可用时，会在停止后识别。

英文例句的解读小窗中，直接启动语音追问。

语音卡片默认开启说完直接发送和空录音时收起。在 设置 → 界面 → 语音输入 中可以分别关闭。

输入法联动需要 macOS 14.4+ 与支持的语音输入法（已适配豆包）。小窗麦克风需要 DSH 启用语音识别服务。未配置语音时，文字解读与键盘追问仍可使用。

<details>

<summary>小窗麦克风提示不可用？</summary>

请检查 DSH 宿主是否启用了 @deepseek-ai/dsh-experimental-speech-to-text，以及识别模型是否已就绪。首次使用时，如果小窗显示 准备模型，点击后按提示准备；下载与识别在宿主运行。

这与输入法语音是两个独立入口：输入法联动使用输入法本身的识别能力。

</details>

<a id="read"></a>

02 / 先读懂，再深入

在 DSH 中选中文字，点击 解读。英文先给译文，中文按内容给解读，代码则生成注释；需要更多背景时，再点 展开详解。

选中 “The migration ran long, so we will ship on Wednesday”，先得到译文。

展开后，模型结合前后文与可用的会话背景解释术语、语气和承接关系。你可以直接在底部继续追问。

接着问“ran long 是说迁移失败了吗？”，把问题留在同一段讨论里。

<a id="quotes"></a>

03 / 把相关内容，一起带进来

小窗打开时，在主界面、小窗正文或支持的侧边栏网页预览中划选文字，点 引用，就能带着新材料继续问。一次最多加入 4 段引用，每段都可以单独移除。

图片和文件，直接拖进来

追问时可以把图片或文件拖进小窗，也可以直接粘贴（⌘V）或用输入框左下角的 + 选择。一次最多 10 件，单件不超过 20 MB。

• 图片显示为缩略图：点一下就在当前窗口里放大预览（输入框上方的待发送图与已经发出的气泡图一致；一组图里用 ← / → 或两侧按钮左右翻，Esc / 点空白处 / 点 ✕ 关闭；⌘/中键仍可新标签打开）。文件显示为可下载的卡片。发送后仍留在消息气泡里，关掉小窗再打开也在 —— 存的是引用而不是字节，历史文件不会因为几张截图变胖。
• 拖到小窗上的文件只会进小窗，不会同时落进主会话的输入框；拖到小窗外面则照常归主会话。
• 模型可以直接读取你附带的文件（读它的只读副本），不必你复制路径过去。
• 追问时最近 2 张图片会重新带给模型，更早的图片自动降级成一行文字说明（避免请求超限）；文件不占这个额度。
• 升格时这些附件会一并带进正式会话，继续在主会话里追问同一张图、同一个文件。

截图提问（⌘⇧X）

按 ⌘⇧X 框选屏幕上的任意区域，松手后可以直接提问；小窗开着时，截图会直接进入输入框的待发送附件。截图范围在 设置 → 截图 里按两种触发方式分别设置：

范围 · 发给模型的图

全屏 · 选区中心所在的那块屏幕

整窗 · 选区所属的整个窗口（默认：截图后弹语音卡时）

选区 + 留白 · 选区向四周外扩「留白」指定的逻辑像素

仅选区 · 选区本身（默认：截图直接进输入框时）

留白两模式共用，默认 48pt；外扩不会超出选区中心所在的那块屏。仅选区不画红框（图就是选区），其余范围会在图里用红色实线框标出问题焦点。需要 macOS 的屏幕录制权限。

不必每次从头来：

想做什么 · 入口

回到刚才的解读 · 右下角悬浮胶囊，或小窗里的 最近

把讨论继续做下去 · 升格，将解读与追问带入正式会话

阅读代码 · 选中代码，查看注释与原代码交替呈现的解释

用图表理解复杂问题 · 将输出偏好切为网页，模型可生成 HTML 页面

长对话默认显示最近 40 条消息，点击消息区顶部的 显示更早的消息 可继续往前查看。收起小窗会释放回答区域的网页预览，重开后恢复显示；完整对话、输入草稿和待发送附件仍会保留。

小窗追问按容量预算组织模型上下文，不再固定截取最近 20 条消息。预算内保留原文和图片顺序；接近上限时，将较早的完整问答分批整理为摘要，最近问答优先保持原文；最近一组也无法容纳时，会将其一并整理为摘要。可在 设置 → 模型 → 对话记忆 调整输入预算，默认 200,000 tokens；宿主能提供模型容量时还会自动收紧，并预留回答与工具空间。用量为估算，整理摘要会产生额外模型调用；摘要失败会明确报错，不静默丢弃原文。

图片与文件保存在宿主附件库，历史只存引用。图片不再按“两张／4 MiB”、文件不再按“八个”滚动淘汰，而是随上下文段一起保留或压缩。启用工具时，模型可用小窗材料工具重新取得旧图、旧文件路径或已压缩的原始消息；文件正文仍由宿主读取工具按需解析。附件丢失或格式不支持时会说明原因。引用保留选中原文；较早的小窗引用会补充附近内容，主会话引用在加入时取得一次上下文快照。

<a id="install"></a>

快速安装

这是 DSH 环境中的插件。请先安装 DSH、配置一个可用模型，再运行：

dsh plugin --profile web add @yfwu2020/dsh-selection-explain

安装后刷新 DSH 页面，选中一段文字，点击 解读 即可。

也可在 GitHub Releases 下载构建包，按下方说明安装。

<details>

<summary>安装 Release 构建包</summary>

将下载的 .tgz 放到当前目录，以 v0.13.1 为例：

mkdir -p ~/.dsh/plugins/dsh-selection-explain
tar -xzf yfwu2020-dsh-selection-explain-0.13.1.tgz -C ~/.dsh/plugins/dsh-selection-explain --strip-components=1
dsh plugin --profile web add ~/.dsh/plugins/dsh-selection-explain

安装完成后刷新 DSH 页面。其他版本请替换文件名中的版本号。

</details>

<details>

<summary>从源码安装 / 卸载</summary>

git clone https://github.com/yfwu2020/dsh-selection-explain.git
cd dsh-selection-explain
npm ci
npm run build
dsh plugin --profile web add .

源码构建需要 package.json 中列出的 DSH 开发依赖可用。

卸载 npm 安装的插件：

dsh plugin --profile web remove @yfwu2020/dsh-selection-explain

</details>

<a id="settings"></a>

使用与设置

Enter 发送 · Shift+Enter 换行 · Esc 收起小窗。录音期间，第一次 Esc 只取消录音，再按一次才关闭小窗。

点击小窗顶部的 设置，修改会自动保存：

设置 · 可以调整什么

模型 · 跟随主会话，或为解读单独指定模型

思考强度 · 首轮、次轮与追问分别选择 关 / 低 / 高 / 最高；按模型实际能力映射

背景 · 是否附带会话消息，以及引用的上下文范围

联网 · 是否允许模型调用工具，以及允许的工具范围

界面 · 语音卡片收尾、侧边栏网页划词与悬浮胶囊

数据 · 保留多少条最近解读

与完整视图、最近会话共存（0.10.2）

解读小窗使用自己的浮层，显示在最近会话列表和完整视图工作面板上方，空白区域仍可点击原界面。在完整视图里，解读插件自行隐藏悬浮胶囊；返回分栏后恢复。

聊天与解读可以同时打开。与 dsh-full-view 0.1.6、dsh-recent-sessions 0.2.3 配合时，Esc 先退出最后操作的小窗；点击两窗之外后先退解读，再按一次收起聊天。此次调整需一起更新两个插件，未改变 Harness 的公共浮层或设置。

快捷键与 Esc 层级（0.10.3）

模型菜单收起后不再被 DSH 识别为弹层，避免设置等快捷键失效。官方设置等模态浮层打开时，Esc 优先交给官方浮层处理，保留解读小窗、插件设置抽屉、模型菜单和语音卡；官方浮层关闭后，再按 Esc 继续退出插件层级。

数据与使用范围

选中文字、必要的前后文，以及开启的会话背景会交给你配置的模型。可在设置中关闭会话背景或工具调用。

插件不将录音保存为音频文件，也不把音频附到会话；小窗录音由 DSH 配置的识别服务处理，是否经过云端取决于该服务。输入法语音由输入法本身处理，插件接收输入框中写入的文字。

解读历史默认保留最近 20 条，以明文存储在 ~/.dsh/selection-explain/history.json。可在 设置 → 数据 中调整，设为 0 停止保存新历史；已有历史不会因此清空。数量超过上限时，按最后更新时间淘汰最旧的小窗历史，已升格的记录也参与淘汰；升格后的正式会话不受影响。

支持 DSH 界面与可注入的侧边栏 HTML 预览。输入框、源码视图、外部站点浏览器标签页，以及部分第三方预览不触发划词（直接通过独立 URL 加载、无法注入划词桥的页面）。模型回答与联网查证仍可能出错。

<details>

<summary>开发与兼容性</summary>

依赖 DSH 的 webServer、llm 等宿主服务；具体版本范围见 package.json。

npm test
npm run typecheck
npm run build

项目结构见 架构说明，验证

…(truncated)