前言¶
DeepSeek Harness(DSH)常作为桌面宿主长期运行,模型和 API 已在宿主里配好。若只为「选中一段文字 → 翻译 / 解释 / 总结」再单独装一套带划词能力的聊天客户端,会多占一套进程和界面,模型配置也要维护两份。
下面介绍社区插件 dsh-selection-assistant(仓库 bjcdeshu/dsh-selection-assistant):在 Windows 10/11 上提供全局划词工具条与快捷翻译窗口,取词基础复用 Cherry Studio 同款的 MIT selection-hook,模型调用走 DSH 已配置的 LLM,不另起完整 Agent 会话。维护者为 bjcdeshu,分类为客户端插件,MIT 开源。当前 README 标明为开发预览版,兼容 DSH Desktop 0.2.x(自 0.2.0-rc.2 起,含 0.2.1-rc.2);跨到 0.3 需重新验证。package.json 版本为 0.1.1。
这是什么¶
DSH Selection Assistant 是 DSH 的 Windows 划词助手插件:选中文字后弹出原生工具条,可执行翻译、解释、总结;另有可输入或粘贴 OCR 文字的快捷翻译窗口。界面、提示词与 DSH 集成由本仓库独立实现,不复制 Cherry 应用源码或长提示词,也不宣称 Cherry / DeepSeek 官方出品。
设计要点:选中文字只弹工具条,点击动作后才调用模型;通过 ctx.llm.stream 使用 DSH 已配置模型,不复制 API Key,不启动完整 Agent,不开放文件/命令工具,不批量创建「未分组」会话。
核心功能¶
划词工具条与结果窗¶
- 三种模型操作:翻译、解释、总结;单次请求无历史。
- 语言:英文默认译中文、明显中文默认译英文;解释/总结默认中文,也可固定输出语言;支持 96 种目标语言(可按中文、英文或本地名称搜索)及自定义语言。
- 可自定义三类提示词,支持占位符
{{targetLanguage}};可为每类操作指定独立模型,或跟随 DSH 全局默认模型(不跟随当前打开的会话)。 - 非激活时工具条尽量不抢原窗口焦点;结果窗可选中、复制、停止、置顶、拖动与缩放;支持轻量 Markdown 展示,不执行 HTML、不自动打开链接。
快捷翻译¶
Ctrl+Alt+T或双击托盘图标打开;支持输入、粘贴、清空、选目标语言、复制、停止、重试,Ctrl+Enter触发翻译。- 打开、粘贴、改语言均不自动发请求;关闭后本次进程内保留内容,清空或退出后释放,不写入历史文件。剪贴板仅有图片时会提示先 OCR(首版不含 OCR 能力)。
监听、热键与托盘¶
- 首次加载处于暂停;须在设置中勾选「启用全局划词监听」后才开始监听。
- 托盘可暂停全局划词;
Ctrl+Alt+D可手动取词。 - 浮条默认在鼠标松开点左下方,靠屏幕边缘自动避让;支持系统、浅色、深色主题,窗口透明度与尺寸分别持久化。
架构与资源¶
DSH Host 插件 Node 取词伴生进程 C# WPF 原生界面
模型/设置/取消 ← stdio → selection-hook 2.1.1 ← stdio → 工具条/结果/设置/托盘
相对「再开一个 Chromium 划词客户端」,本插件增加两个辅助进程,不增加 Chromium/WebView2 进程;取词 native addon 不装入 DSH 主宿主。WPF 使用系统 .NET Framework 4.8,首次加载由系统 C# 编译器从仓库源码构建并缓存到插件数据目录,不下载编译器、不要求管理员。
隐私边界:无公开 HTTP 端口、无网页脚本桥、无遥测、无原文/结果历史文件;剪贴板兜底默认关闭,密码管理器与终端默认排除。选区可能含敏感信息,不需要时应暂停,勿把敏感选区提交云模型。
安装与启用¶
安装前请确认 DSH Desktop 版本在 0.2.x 兼容范围内,并已配置可用模型。
优先在 DSH 界面 插件 → 添加插件,输入:
github:bjcdeshu/dsh-selection-assistant
若你的实例确实使用 desktop profile,也可用 CLI(profile 名以你当前实例为准,勿盲目改其他 profile):
dsh plugin --profile desktop add github:bjcdeshu/dsh-selection-assistant
仓库无需 JavaScript 构建步骤;依赖 selection-hook 含 Windows 预编译 native 包,包管理器可能询问是否允许 node-gyp-build 安装脚本,请先审阅再授权,不要授权无关生命周期脚本。
宿主提示需要重启时,请先保存任务再重启;本插件不会自行重启 DSH。
首次加载会出现托盘图标,右键打开设置,建议按下面顺序操作:
- 确认 DSH 已配置可用模型。
- 阅读隐私说明,勾选「启用全局划词监听」,保存。
- 在普通文本应用或浏览器中选中文字,点击翻译、解释或总结。
- 取不到词时先试
Ctrl+Alt+D;仅对必须模拟复制的应用再显式开启剪贴板兜底。
典型用法¶
日常划词:在记事本、浏览器或文档中选中一段文字 → 在工具条点「翻译」「解释」或「总结」→ 在结果窗查看流式输出,必要时停止或复制。
手动取词:自动监听未命中时按 Ctrl+Alt+D。
长段或 OCR 文本:按 Ctrl+Alt+D 或双击托盘打开快捷翻译,粘贴内容,选目标语言后 Ctrl+Enter 翻译。
暂时不用划词:托盘 → 暂停全局划词(hook 与取词热键停止,快捷翻译仍可用)。
停用、卸载与数据位置¶
- 完全停止:在当前 DSH 插件页关闭或卸载;卸载会清理自有进程。
- 设置保存在
$DSH_HOME/plugin-data/dsh-selection-assistant/settings.json(未定义DSH_HOME时为用户目录下.dsh同路径);含偏好与自定义提示词,不含模型密钥、选区或结果。 - 窗口宽高与不透明度在同级
window-state.json;原生编译缓存在native-cache。清除数据前应先停用插件,再删除该插件数据目录,勿删整个 DSH 数据目录。
适用场景与注意¶
适合:已在 Windows 上长期使用 DSH Desktop 0.2.x、希望划词翻译/解释/总结复用同一套模型与计费策略的开发者或写作者。
注意:
- 插件以当前 DSH 进程权限运行;安装前建议阅读 GitHub 仓库 源码与 MIT 许可证及
THIRD_PARTY_NOTICES.md。 - 提权应用、部分 PDF/canvas/特殊编辑器可能无法取词;自动化测试不等于所有应用兼容,详见仓库
docs/VERIFICATION.md。 - 首版不包含 OCR、原文替换、翻译历史、自动联网搜索或自动执行工具;翻译质量取决于所选模型。
DSH 生态强调「一切皆插件」;SkillHub 目录页 为社区收录,与 DeepSeek / 幻方无官方从属关系。
结尾¶
若你希望常开的 DSH 顺便承担 Windows 全局划词,而不为多这一个功能再留一整套客户端,可以在确认版本兼容后安装 dsh-selection-assistant,在设置里显式启用监听,再按场景使用工具条或快捷翻译。
- 目录页:https://www.skillhub.cn/plugins/bjcdeshu/dsh-selection-assistant
- GitHub:https://github.com/bjcdeshu/dsh-selection-assistant
- 问题反馈:https://github.com/bjcdeshu/dsh-selection-assistant/issues(请勿上传 API Key、私人选区或完整本机配置)