前言¶
用 DeepSeek Harness(DSH)跑任务时,报告、截图、导出文件往往落在运行 DSH 的那台 Windows 电脑上。若你在手机上远程连 DSH,或希望产物立刻出现在手机微信里,常见做法是回到电脑前复制,或自己找网盘/邮件中转。下面介绍的 dsh-wechat-transfer 是社区维护的 DSH 左侧栏插件(维护者 le0522,分类:联网工具),通过 Windows 版微信桌面客户端,把指定本地路径的文件送到指定聊天(默认「文件传输助手」),手机端微信即可收到并保存。
这是什么¶
dsh-wechat-transfer 在 DSH 左侧栏增加「微信传输」入口,并提供模型可调用的工具 wechat_send_file。它不替代微信客户端,而是在本机启动或唤起微信 4.x,用截屏与 Windows 自带中文 OCR 校验当前聊天与发送步骤,再通过微信原生的「选择文件」对话框把文件放进输入框;可选自动点击发送。插件仅支持 Windows(依赖 Windows PowerShell 5.1 与中文 OCR 语言包),与 SkillHub 目录页简介「Send local files to WeChat 文件传输助手 from DeepSeek Harness (Windows)」一致。
远程场景下,DSH 面板可走 /remote 网关,手机浏览器上的同一面板也能触发发送。
核心功能¶
面板与交付卡片¶
左侧栏「微信传输」面板可填写文件路径、目标聊天、是否自动发送,并提供「登录微信」「关闭微信」等操作。聊天里每个 present 交付文件卡片旁会多一个「发微信」按钮,点按即可把该文件发到默认或指定的聊天;成功或失败会显示在按钮上。
模型工具¶
注册工具 wechat_send_file 后,可在对话中直接要求把某个本地文件发到「文件传输助手」,由插件走同一套发送流程。
发送流程与安全策略¶
每次执行会置前微信主窗口(不按 Esc、不随意关窗、不在正常发送路径里启停进程),用 OCR 读标题栏确认当前聊天为目标聊天;不对则尝试在会话列表中点开目标名,仍不对则中止。存在多个同名会话时返回 chat-ambiguous 并中止。确认聊天后,点击输入栏左侧文件夹图标,在原生「选择文件」对话框的文件名框粘贴 "路径1" "路径2" 并确认,再 OCR 或像素方式校验文件是否出现在输入框;若 autoSend 为 true,会在确认发送按钮为可发送状态后点击,并校验消息是否进入聊天。默认 autoSend = false,文件只停留在输入框,由人工确认后再发。
微信 4.x 为 Qt Quick 自绘界面,无可用 UI Automation,插件采用「最小动作 + 逐步校验」的设计;校验依据的是聊天显示名(OCR),不是微信内部会话 ID,同名聊天、OCR 误判等边界在 README 中已有说明。
登录与微信进程¶
微信未运行时插件可启动 Weixin.exe 并尝试在登录窗点击「进入微信」;需要扫码时返回 login-qr。面板「关闭微信」会先请求微信缩到托盘,必要时结束 Weixin.exe,返回 closed-wechat。
HTTP 路由(宿主侧)¶
| 方法 | 路径 | 用途 |
|---|---|---|
| GET | /dsh-wechat-transfer/status |
引擎是否就绪、上次结果、截图年龄 |
| POST | /dsh-wechat-transfer/send |
{paths, chat?, autoSend?} 发送文件 |
| POST | /dsh-wechat-transfer/login |
处理登录窗口 |
| POST | /dsh-wechat-transfer/close |
关闭微信 |
| POST | /dsh-wechat-transfer/resolve |
交付卡片路径解析 |
| GET | /dsh-wechat-transfer/screenshot |
最近一次校验截图 |
非本机访问时,客户端会在收到 403/404 后自动改用 /remote/dsh-wechat-transfer/... 重试。
安装与启用¶
从 npm 安装(README 推荐):
dsh plugin --profile desktop add dsh-wechat-transfer
若需跟踪源码仓库最新提交:
dsh plugin --profile desktop add github:le0522/dsh-wechat-transfer
也可从 GitHub Releases 取 zip/tgz 离线安装,或 npm install dsh-wechat-transfer 装进任意 DSH profile。安装完成后重启 DSH,左侧栏应出现「微信传输」。资料中 package.json 标明版本 0.2.9、许可证 MIT、引擎要求 dsh >= 0.2.0-rc.1。
典型用法¶
- 在面板填写本地绝对路径,目标聊天留空则使用「文件传输助手」,按需勾选是否自动发送,执行发送。
- 在 DSH 聊天中让模型调用
wechat_send_file,或点交付卡片旁的「发微信」。 - 远程用手机浏览器打开 DSH 面板,同样可发;发送过程中面板约每 1.5 秒轮询
/status显示最新状态与时间戳。
失败时插件会返回明确 stage,例如 chat-not-open(未打开目标聊天且未粘贴)、paste-not-verified、send-not-verified、ocr-unavailable 等;成功时常见 staged(仅进输入框)或 sent(已确认发送)。
适用场景与注意¶
适合:Windows 上已装微信 4.x,希望 DSH 产物(尤其远程/手机驱动 DSH 时)快速进手机微信;愿意接受 OCR 校验而非绝对零误发的场景(敏感文件建议保持 autoSend 默认 false,人工点发送)。
前置:系统具备 zh-Hans OCR;目标聊天能在会话列表或全局搜索中被定位;窗口尺寸在 README 所述范围内插件会自行 normalize,最大化或过小窗口时可能临时调整尺寸并在发完后还原。
安全与权限:插件以当前 DSH 进程权限在本机操作微信窗口与文件路径,安装前请自行阅读 GitHub 仓库 源码与 MIT 许可证。DSH 社区插件目录(SkillHub)为独立站点,与 DeepSeek / 幻方无官方从属关系。
结尾¶
dsh-wechat-transfer 把「DSH 桌面产物 → 微信文件传输助手 → 手机微信」收成面板一键、交付卡片一键和模型工具三条路径,并围绕微信 4.x 无自动化 API 的现实做了分步校验。目录页:https://www.skillhub.cn/plugins/le0522/dsh-wechat-transfer;源码与完整说明:https://github.com/le0522/dsh-wechat-transfer。