DSH Plugins Marketplace

DSH Plugins

Plugins

/

dsh-global-selection

r

dsh-global-selection

Discovered

全局划词 · dsh-global-selection

DeepSeek Harness(DSH)插件:在任意应用里选中文字,旁边弹出工具栏。点「翻译 / 解释 / 总结」后,消息发进该动作对应的固定 DSH 会话(「划词 · 翻译」「划词 · 解释」「划词 · 总结」),由 DSH 的 Agent 回答,回答实时显示在小窗里,还可以在小窗里继续追问;点「在 DSH 中继续」直接打开那个会话接着聊。

English — System-wide text selection for DeepSeek Harness. Select text in any application and a toolbar appears; Translate / Explain / Summarize post the text into a fixed DSH session per action, answered by your DSH agent and streamed into a floating window where you can ask follow-ups. "Continue in DSH" opens that session in the DSH window. Tested on Windows; the macOS and Linux code paths are ported but untested.

状态:0.3.0。已在 Windows 上测试(DeepSeek Harness 0.2.1-rc.3);macOS / Linux 的代码路径已移植,尚未测试,可能无法使用。

功能

  • 全局划词:浏览器、编辑器、PDF、聊天软件里划词都能触发(基于 selection-hook,其预编译二进制随包分发,安装时不执行任何构建脚本)。
  • 两种触发方式:划词即弹出,或划词后长按 Ctrl 才弹出。
  • 内置动作:翻译、解释、总结、复制。翻译使用 Cherry Studio 的翻译提示词,单向翻译成 targetLanguage(默认简体中文),只输出译文;可在设置里添加自定义动作(自己的提示词),每个自定义动作也有自己的固定会话。
  • 固定会话:每个动作一个 DSH 会话,第一次使用时自动创建;会话被删除或归档后会自动重建。同一个会话里的请求排队依次执行,不会被合并成一轮。模型跟随该会话在 DSH 中的设置,可以直接在 DSH 里切换。
  • 结果小窗:实时显示会话的回答(Markdown),底部输入框可以继续追问(Enter 发送,Shift+Enter 换行),追问发进同一个固定会话,并注明针对哪段选中文字;停止 / 重试(重做最后一轮)、复制(最后一轮回答)、固定在最前、Esc 关闭。「停止」会中断 DSH 里的这一轮;直接关闭小窗不会中断,回答照常写进会话。
  • 在 DSH 中继续:把 DSH 窗口切到前台并打开该动作的固定会话。
  • 新会话打开:新建一个 DSH 会话,带上选中文字和小窗里的全部问答,并打开它,适合单独展开讨论。
  • 应用过滤:默认屏蔽截图工具、Office、设计软件等容易冲突的程序;支持黑名单 / 白名单。
  • 在 Windows 上,小窗使用本机 DSH 安装目录里的图标,并在任务栏中归入 DSH 的按钮(图标运行时读取,不随插件分发)。

工作原理

DSH 插件运行在一个没有 Electron API 的 Node 进程里,DSH 桌面壳也不给插件开放创建窗口的接口,所以插件会拉起一个独立的 Electron 侧车进程来负责划词和窗口:

DSH host (Node)
 └─ 本插件 host 端            动作 / 追问:sessionController.prompt 发进固定会话
     │                        回答:订阅 agent/assistant-stream、turn/end 等事件转发给小窗
     │                        打开会话:长轮询接口 → 本插件的 DSH 界面部分(lib/client.js)
     └─ 侧车 Electron 进程    selection-hook + 工具栏窗口 + 结果窗口
          ↕ 本地命名管道(Windows)/ Unix socket,逐行 JSON,一次性 token 鉴权

侧车进程只负责显示,不直接访问任何模型或网络;所有请求都是 DSH 会话里的普通一轮对话,使用你在 DSH 里配置的模型和凭据。插件停用或 DSH 退出时,侧车随之退出;侧车异常崩溃会自动重启(退避重试,2 分钟内崩溃 5 次后停止)。侧车从 ~/.dsh/storages/dsh-global-selection/sidecar-<hash>/ 下的副本启动,这样运行中的原生模块不会锁住插件安装目录,DSH 可以正常升级或卸载插件。

固定会话的 id 保存在 ~/.dsh/storages/dsh-global-selection/sessions.json。会话会随使用不断变长,每次请求都带着历史;DSH 会按自己的策略压缩上下文,你也可以在 DSH 里清空或删除这些会话,插件下次会重建。

安装

在 DSH 的「插件 → 市场」中搜索 dsh-global-selection 安装,或使用命令行:

dsh plugin --profile desktop add dsh-global-selection

首次启动会下载 Electron 45.2.2(约 100MB),存放在 ~/.dsh/storages/dsh-global-selection/。默认先从官方地址(GitHub)下载,失败时自动改用 https://npmmirror.com/mirrors/electron/;也可以在设置里指定镜像,或在「Electron 路径」里填一个已有的 electron.exe。

macOS 需要在「系统设置 → 隐私与安全性 → 辅助功能」中允许 Electron(侧车进程),授权后重启 DSH。

权限与安全

划词需要监听全局输入,这里说明插件具体做了什么:

  • 全局鼠标 / 键盘钩子(selection-hook):用于检测选中文字,以及在你点击别处、滚动或打字时隐藏工具栏;「长按 Ctrl」触发模式下用于判断 Ctrl 是否被单独按住。按键内容不会被记录、保存或发送。
  • 读取选中文字:优先通过系统辅助功能接口(Windows UI Automation / IAccessible,macOS Accessibility)读取。只有这些接口都读不到时,才会使用剪贴板兜底:先保存当前剪贴板,模拟一次 Ctrl+Insert(失败再试 Ctrl+C),读取后恢复原剪贴板内容。
  • 何时发出文字:选中的文字只在你点击动作按钮或发送追问后,作为一条消息写进对应的 DSH 会话,由 DSH 发给你配置的模型。仅仅选中文字、弹出工具栏不会发送任何内容。
  • 网络:插件自身只在首次运行时下载 Electron(见上文);其余网络请求都由 DSH 发起。
  • 本地进程间通信:插件与侧车通过本地命名管道 / Unix socket 通信,连接需要启动时生成的一次性 token。DSH 界面用来接收「打开会话」请求的 HTTP 接口(/dsh-global-selection/api/open-wait)会拒绝跨站的浏览器请求,它只返回待打开的会话 id,不接受任何输入。
  • 应用过滤:默认不在截图工具、Office、设计软件、远程桌面等程序中触发(见 src/sidecar/selectionConfig.ts),可在设置中调整黑名单 / 白名单。

配置

在 DSH 设置页的 global-selection 下修改;每次修改后插件会自动重启。

配置项默认值说明
enabledtrue总开关
triggerModeselectedselected 划词即弹出;ctrlkey 划词后长按 Ctrl
enabledActions翻译、解释、总结、复制工具栏上的内置动作及顺序
customActions空自定义动作:名称 + 提示词,可用 {{text}}、{{language}}
targetLanguage简体中文翻译的目标语言,也是解释、总结的回复语言
maxSelectionChars4000发进会话的选中文字最大字数
followToolbartrue结果窗口出现在工具栏旁;关闭则居中
autoClosefalse结果窗口失焦自动关闭(固定的除外)
filterMode / filterListdefault / 空应用过滤:默认、黑名单、白名单;程序名如 chrome.exe
electronPath / electronMirror空侧车 Electron 的路径 / 下载镜像
debugfalse输出侧车调试日志

隐私

选中的文字只有在你点击动作按钮或发送追问后才会发出:它作为一条消息写进该动作的固定 DSH 会话(会话历史保存在 DSH 本地,可随时删除),再由 DSH 发给你在 DSH 中配置的模型提供方。插件自身只保存这几个会话的 id,不保存选中内容和结果。「复制」动作只在本机操作剪贴板。

开发

npm install
npm run check          # 类型检查 + 测试 + 构建
npm run dev:sidecar    # 不装进 DSH,用模拟的 DSH 上下文直接跑侧车,验证划词和窗口

设置环境变量 DSH_GLOBAL_SELECTION_DEMO_DIR=<目录> 再运行 dev:sidecar,侧车会模拟一次划词、点击第一个模型动作、在小窗里发一次追问,并把截图和日志(demo.log)保存到该目录,便于无人值守地检查整条链路;再加 DSH_GLOBAL_SELECTION_DEMO_PROMOTE=1 会同时点击「在 DSH 中继续」。

装进 DSH 后也可以这样自检:写入 ~/.dsh/storages/dsh-global-selection/demo.json(内容如 {"dir": "C:/tmp/dgs-demo", "promote": false}),然后重启 DSH。侧车启动时会读取并删除这个文件、执行一次上述流程,模型调用走 DSH 的真实链路(动作和追问各一轮,写进对应的固定会话;promote: true 会把 DSH 窗口切到该会话)。

插件图标的源文件是 assets/icon.svg,修改后用 npx electron scripts/render-icon.cjs 128 重新生成 assets/icon.png。

目录:

路径说明
src/host/DSH 插件本体:配置、固定会话、打开会话的接口、侧车进程管理
src/client/DSH 界面部分:收到请求后切换到指定会话
src/sidecar/Electron 侧车:划词控制、窗口、预加载脚本
src/sidecar/renderer/工具栏和结果窗口页面
src/shared/两端共享的协议、动作和提示词、行分帧

许可

AGPL-3.0-or-later。划词控制、定位算法、窗口配置和翻译提示词移植自 Cherry Studio(AGPL-3.0),详见 NOTICE.md。

Comments

Loading…