dsh-selection-explain

01 / 划完，直接说

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

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

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

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

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

在小窗里，也能直接开口

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

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

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

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

02 / 先读懂，再深入

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

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

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

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

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

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

图片和文件，直接拖进来

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

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

截图提问（⌘⇧X）

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

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

不必每次从头来：

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

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

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

快速安装

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

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

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

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

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

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

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

使用与设置

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 加载、无法注入划词桥的页面）。模型回答与联网查证仍可能出错。

npm test
npm run typecheck
npm run build

MIT License · 反馈问题