前言¶

DeepSeek Harness（DSH）将智能体能力集成到应用中，开发者常需要在非 DSH 环境下获取上下文。本插件填补了这一空白，无需额外浏览器即可实现系统级划词。

插件定位¶

任意 Windows 应用里划词，用 DeepSeek Harness 自己的 agent 解释/翻译，结果落在原生置顶浮窗（GDI+，零依赖、零额外进程）。

核心能力¶

1. 系统级手势检测
   伴生进程轮询鼠标状态，识别“拖选（位移 ≥5px）”与“双击选词”。手势落点不触发自身点击。

2. 取词（UI Automation 优先）
   主路径通过 UI Automation 读取选区及所在段落，全程不注入按键。仅在 UI Automation 读不到时才注入一次 Ctrl+C 兜底。一份选区仅弹一次菜单。

3. 原生置顶浮窗（GDI+）
   使用伴生进程创建原生 Win32 分层窗口，GDI+ 自绘。支持拖动、四边及四角缩放。无浏览器依赖。

4. Agent 集成
   不注册模型可见的工具，使用 Harness 宿主的 ctx.agents 跑一轮真实会话回合。每次划词生成一条新会话，结果流式显示。

安装与启用¶

安装命令：

dsh plugin --profile web add "github:fyisgod/dsh-selection-tools"

安装后重启 dsh web 生效。

典型用法¶

1. 在任意 Windows 应用里选中文字（拖选 / 双击）。
2. 选区右下角弹出菜单，点击“解释”或“翻译”。
3. 回答窗口流式显示结果，支持手动停止、复制或关闭。

技术细节¶

• 不碰剪贴板：UI Automation 优先，Ctrl+C 仅作为兜底手段，且会校验剪贴板序号变化以确认复制成功。
• 翻译逻辑：源文本含中日韩字符 → 译成英文；否则译成中文。词/短语按词典条目输出，句子/段落先给整段译文再解释关键术语。
• 零外部依赖：伴生进程使用 DSH 自带的 koffi（FFI）调用 user32/gdi32/gdiplus，不安装任何运行时。

配置与扩展¶

可在 DSH 设置 -> 划词工具中修改翻译方向、模型及推理等级。插件提供 API 端点：
* POST /api/dsh-selection-tools/run：SSE 流式输出。
* POST /api/dsh-selection-tools/stop：停止当前会话。
* GET /api/dsh-selection-tools/system/status：查询伴生进程状态。

结尾¶

本插件是 DeepSeek Harness 生态中的客户端工具，通过原生窗口与 UI Automation 实现无干扰的划词交互。源码与文档见下方链接。
- GitHub 仓库
- 社区目录