yjh248619/dsh-select-assist ↗★ 0

dsh-select-assist

DSH plugin: select text in any Windows app to explain, summarize, or translate it with DeepSeek Harness — answered in a native always-on-top overlay (draggable, resizable). · DeepSeek Harness 划词工具:任意应用里选中文字即在锚点右下角弹出菜单,用 Harness 解释/总结/翻译(自动带上选区所在的上下文段落),流式落在零依赖的原生置顶浮窗里(可拖动/缩放)。0.9.5:本机接口加 Origin/JSON 校验、流空闲超时、配额错误直接换模型、双客户端只投一次。0.9.6:朗读相关代码与图标彻底删除,解释/总结/翻译换新图标。0.9.7:兜底模型默认留空,由用户自己配置,不再内置任何服务商默认值。 0.9.8:翻译优先走 Bing/Google 机译(匿名端点,失败自动回落到模型座位)。

套件
dsh-select-assist
相容性
待驗證
版本
0.9.8
授權
MIT
最近更新
2026年11月10日

同名套件的其他儲存庫

安裝

$npx -p @deepseek-ai/dsh dsh plugin --profile web add github:yjh248619/dsh-select-assist

使用

  1. 任意应用里选中文字(拖选 / 双击选词)——这一步不碰剪贴板。
  2. 选区右下角弹出菜单(大约几十毫秒后就可见;DSH_SELECTION_MENU_DECIDE_MS 说明见下),点 解释、总结、翻译 或 问问(Esc 可收起)。
  3. 回答窗口先显示「正在读取选区…」,随即流式显示结果(带着选区所在的上下文一起问);生成中可 停止,完成后可 复制 或 关闭(✕);标题栏可拖动,四条边与四个角都能用鼠标拖着改大小(指针会变成对应的双箭头)。取不到选中的文字时会显示「失败 · 未能读取选中的文字」,而不是"点了没反应"。

翻译方向自动判定:源文本含中日韩字符 → 译成英文;否则译成中文。

开关与配置(环境变量)

变量默认说明
DSH_SELECTION_DISABLE_SYSTEM未设置设为 1 关闭系统级划词(保留页内划词,伴生进程不再启动)。
DSH_SELECTION_HOOK1伴生进程侧开关:0 = 只起浮层不做全局手势检测。
DSH_SELECTION_POLL_MS40鼠标轮询间隔(毫秒)。
DSH_SELECTION_MAX_TEXT12000单次划词字符上限。
DSH_SELECTION_MENU_DECIDE_MS280手势落下后给 UIA 的决策窗口:这么长时间内读到"有没有选中文字"就按它办(有选区 → 弹;落在桌面/任务栏这类系统外壳上 → 不弹;普通元素报出空选区 → 不表态,交给剪贴板核实);超时就**再宽限三倍时长(上限 1s)**等探针的结论(探针还在跑,只是慢),宽限也用完才按"未知"照弹(0 = 手势一到就弹,不做任何过滤)。
DSH_SELECTION_TEXT_SOURCEauto选区文字从哪来:auto = UIA 优先、读不到才用剪贴板;uia = 只用 UIA(读不到就报错,绝不碰剪贴板);clipboard = 直接用剪贴板(某个应用 UIA 读得不准时的逃生舱)。
DSH_SELECTION_MENU_PROBE_RETRIES3菜单弹出时 UIA 预读的重试次数(Chromium/WebView2 冷启动第一次必失败,重试同时替后面的解析把无障碍树焐热)。
DSH_SELECTION_PRESS_PROBE1鼠标按下时要不要拍一张"手势之前的选区"快照:只有它能把"拖动一个已选中的元素"(WPS/Office 的 PPT 形状、Excel 单元格)和"拖选文字"分开。0 = 不拍(每次按下少一次 UIA 读取,代价是拖动已选中的元素又会弹菜单)。
DSH_SELECTION_PRESS_WAIT_MS120等这张按下快照的上限(毫秒):正常早就回来了,只有"按下到松开特别快"的拖拽才会真等;超时按"没拍到"处理。
DSH_SELECTION_CONFIRM1UIA 说不出话、或只报出一个空选区时(WPS/Office 的 Qt 版这类不暴露文档文本的应用),要不要用剪贴板核实"这次手势到底有没有选中文字":注入一次 Ctrl+C,真选中文字就会复制出文字,拖动形状/窗口则什么都复制不出来。核实还挡掉两种"复制出来的是文字、但其实没在选文字"的情形:表格网格里的选区(XLMAIN + EXCEL7,注入 Ctrl+C 之前就挡掉,不让这一下搅乱复制模式)和剪贴板里挂着原生表格格式(WPS Spreadsheets … Format / XML Spreadsheet / Biff*)的复制。0 = 不核实(退回老行为:拖选照弹、双击不弹)。
DSH_SELECTION_CLICK_PROBE_RETRIES1点菜单项时补读 UIA 的重试次数;再多只是拖延剪贴板兜底。
DSH_SELECTION_CLIPBOARD_OWNER1取词时是否核对"这次剪贴板写入不是别的进程写的";0 = 退回老行为(只看序号变化)——核对误伤了某个应用、取不到词时才关。
DSH_SELECTION_MENU_TIMEOUT_MS3600划词菜单的显示时限(毫秒)。
DSH_SELECTION_CONTEXT1UI Automation 开关;0 = 关掉"读选区 + 读段落"(菜单不再过滤手势,选区只能走剪贴板兜底,等于退回老行为)。
DSH_SELECTION_CONTEXT_TIMEOUT_MS1800单次 UIA 读取的时间预算;超时直接丢掉 worker。
DSH_SELECTION_LOCALE由插件传入回答语言提示(zh/en)。
DSH_SELECTION_DSH_ORIGINhttp://127.0.0.1:3080伴生进程调用 DSH 路由的地址(插件自动传对)。