前言¶
在 DeepSeek Harness（DSH）里读英文文档、对照外文界面时，常见做法是复制到翻译工具里再看结果，或者截图后另开窗口对照。译文和原文分离，截图翻译也很难把排版和引用样式留在原位。dsh-translate-pin 是社区插件，面向 Windows 上的 DSH 用户：在会话里划词出译文卡片，在桌面任意区域框选后由 DeepSeek 读图翻译，并把中文按段落回填到原区域；划词结果还可以钉在桌面做置顶对照。下面按安装、用法和注意点说明。
这是什么¶
- 名称：
dsh-translate-pin（bundle id：translate-pin） - 维护者：zhaopw5
- 分类：联网工具（社区目录 SkillHub 插件页）
- 仓库：github.com/zhaopw5/dsh-translate-pin，许可证 MIT；
package.json版本 0.8.4 - 平台：仅 Windows（OCR 依赖
Windows.Media.Ocr，浮标与全局快捷键依赖 Win32）
插件在 DSH 内提供划词翻译；同时拉起桌面助手（pinwin.py），负责全局划词、截图框选、原地译文窗和桌面浮标。翻译优先走 DSH 已配置的 DeepSeek（支持图片输入的模型直接读图）；不可用时回退 Bing / Google / MyMemory，并结合 Windows OCR。
核心功能¶
划词翻译（DSH 页面内）¶
在对话或文章内容里选中外文（输入框、contenteditable 内不触发），松手后选区旁出现「译」，点击后显示源语言 → 简体中文、译文与服务商。卡片支持复制、查看原文、钉在桌面。纯中文选区会自动跳过。快捷键：Ctrl+Shift+T。
全局划词（浏览器、PDF、Word 等）¶
在 DSH 外的任意应用中拖动选中文字（拖动超过约 6px），松手后光标旁出现「译」。也可用 Ctrl+Shift+T。原理是模拟 Ctrl+C 读剪贴板并在读后恢复；部分终端、游戏等不支持 Ctrl+C 的场景无法取词。
截图翻译（译文贴回原区域）¶
通过右下角「截图翻译」、桌面「译」浮标，或全局 Ctrl+Shift+S（DSH 最小化仍可用）进入框选。确认「✓ 翻译」后：OCR 分行并按行距/缩进/字号分段，DeepSeek 整段翻译，再合成图把每段中文排回对应矩形，尽量保留引用框底色、左侧竖线与文字主色。静止时译文区外有灰色渐变边框；鼠标移入显示图钉、复制、原文等工具条。支持拖动译文框，双击切换译文/原文。
表格模式¶
框选整张表格时，按单元格翻译，保留表格线、列宽与数字，只替换文字单元格。复杂合并单元格或 OCR 并列失败时会退回段落模式。
问 AI（截图对话）¶
框选后点「✨ 问 AI」，在独立窗口里带截图预览与对话；问题发给 DSH 配置的 DeepSeek，可连续追问。截图只发给该模型，不上传其他服务（每次提问消耗图片与文本 token）。
桌面浮标与钉在桌面¶
屏幕右侧常驻圆形「译 · 截图」浮标，单击开始框选。划词卡片的「钉在桌面」生成始终置顶、可拖动、可复制的对照小窗。
环境要求¶
| 依赖 | 说明 |
|---|---|
| Windows 10 / 11 | OCR、置顶窗（tkinter） |
| DeepSeek Harness | 桌面端或 dsh web（需 Connection / WebServer） |
| Python 3.10+（tkinter、Pillow） | DSH 桌面端自带运行时时可不再单独安装 |
| Windows PowerShell 5.1 | 系统自带 |
| RapidOCR（可选） | python -m pip install rapidocr_onnxruntime，未装则回退 Windows OCR |
| 中文 OCR 语言包 | Windows 设置 → 语言 → 中文(简体) 的「光学字符识别」可选功能 |
插件启动时会自动查找 $DSH_HOME/dsh-runtimes/*/dependencies/python/pythonw.exe 等路径，也可用环境变量 DSH_TRANSLATE_PYTHON 指定 Python。
安装与启用¶
DSH 生态里插件通过 profile 的 bundle 加载；社区目录 SkillHub 与 DeepSeek / 幻方无官方从属关系，安装前建议查看仓库源码与 MIT 许可证。插件以当前 DSH 进程权限运行，涉及剪贴板、截图与联网翻译，请自行评估环境是否合适。
从 GitHub 安装（推荐）¶
在 DSH「插件」页选择「从 GitHub 安装」，填写：
github:zhaopw5/dsh-translate-pin
或在允许 dsh plugin 管理的 profile 中执行：
dsh plugin --profile <profile> add github:zhaopw5/dsh-translate-pin
安装后 cordis.patch.yml 会自动插入 translate-pin。桌面端若 dsh plugin 被拒，应优先用应用内「插件」页安装。
装完重启客户端¶
客户端插件模块清单在启动时注入，需完全退出 DeepSeek Harness 再打开。验证：
- 任意会话右下角出现「截图翻译」；
- 选中外文后选区旁出现「译」；
- 控制台无
dsh-translate-pin报错。
配置¶
bundle 安装后，在 profile patch 里按 id 覆盖配置（勿重复 insert）：
- id: translate-pin
config:
targetLanguage: zh-Hans # 默认简体中文；可填 en / ja / zh-Hant ...
| 字段 | 默认 | 说明 |
|---|---|---|
targetLanguage |
zh-Hans |
目标语言码（DeepSeek 与 Bing/Google 回退共用） |
修改后已打开页面需刷新；host 行可随 HMR 重载。
典型用法速览¶
划词：页面内选中外文 → 点「译」→ 可选「钉在桌面」。
全局划词：其他应用里拖动选词 → 点「译」或 Ctrl+Shift+T。
截图：Ctrl+Shift+S 或浮标 → 拖拽框选 → 「✓ 翻译」→ 在原区域查看回填译文；需要对话时点「✨ 问 AI」。
表格：框选含表线的整表，等待按格翻译。
排查时可查看日志：%USERPROFILE%\.dsh\translate-pin\host.log。
适用场景与限制¶
适合：Windows 上长期使用 DSH、需要外文网页/文档/截图快速中文化且希望译文落在原位的用户；已配置 DeepSeek 且模型支持读图时，截图翻译质量更稳。
需注意：
- 仅 Windows；DSH 完全退出后桌面浮标与快捷键一并退出（子进程随宿主结束）。
- 样式还原为启发式，一行内多种颜色/字号时只取占比最大样式。
- 全局划词与部分应用剪贴板限制；
Ctrl+Shift+S若被占用，日志会有RegisterHotKey ... failed，可改用浮标或页面按钮。 - OCR 主要负责版面；正文翻译以 DeepSeek 读图为主，模型不可用时精度会下降。
- 卸载：插件页卸载或
dsh plugin --profile <profile> remove dsh-translate-pin，重启客户端；可选删除%USERPROFILE%\.dsh\translate-pin日志目录。
结尾¶
dsh-translate-pin 把 DSH 会话划词、系统级选词和「框选 → DeepSeek 读图 → 原位回填」串成一条链路，并支持桌面钉住对照。需要安装与细节时，以仓库 README 为准：
