前言¶

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 倉庫
- 社區目錄