dsh-file-handover
将本地文件交给任意程序的文件选择器：等待原生“打开”对话框，通过 UI Automation 填入路径，读回路径进行验证，然后确认。目标始终明确指定，绝不猜测。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:7gzgn/dsh-file-handover#babd678ce8835d0cb79f87132760682d586122b0File Handover 以 dsh-file-handover 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
把一个本地文件交给系统"打开文件"对话框 —— 网页上传、微信发文件、Photoshop 打开， 凡是"点一下、再在对话框里选文件"的地方，都由它代劳。
由来：AI 会点按钮、会打字，但不会在文件选择器里选文件 —— 这是 GUI 自动化的最后一块空白。 我是在给自己做"发抖音"的时候撞上它的：投稿页的上传按钮点得响，弹出的系统对话框却进不去。
| 步 | 动作 | 为什么要这样 |
|---|---|---|
| ① 等 | 轮询等 #32770 文件对话框出现（默认 30 秒） | 实测从点击到弹窗可以超过 15 秒，抢跑只会拿到空 |
| ② 认 | 在候选窗口里找带文件名控件（automation id 1148）的那个 | 只认结构、不认标题 —— 跨语言，也绕开 .ps1 编码坑 |
| ③ 填 | 剪贴板粘贴（全选 → 清空 → 粘贴）；另有 Win32 SetWindowText 与 UIA ValuePattern 两条备用路 | 打字不可信：这台机器的中文输入法会把打进去的 \ : 变成全角标点和候选词（实测读回 谢谢D：、但是、workspace、…），剪贴板不过 IME |
| ④ 校 | 读回来逐字比对，不一致就再来一轮（默认 3 轮） | 实测第 1、2 轮读回都是脏的，第 3 轮才一致 —— 单次尝试真的不可信 |
| ⑤ 确认 | 按控件 id 找按钮（1=打开/保存、2=取消）并点击 | 盲发 Enter 不可靠，也挡不住输入法 |
失败会带现场：它把"看到过的每个候选窗口"和"每次尝试读回的实际值"一起返回， 所以排错不用猜。
path）必须是绝对路径；它不会自己去找"最像的对话框"。expectTitle 显式给。dryRun 只探测（找对话框、报结构），不填不点。市场收录后在 DSH 里搜 dsh-file-handover 安装。手动安装：
New-Item -ItemType Junction -Path "$env:USERPROFILE\.dsh\profiles\desktop\node_modules\dsh-file-handover" -Target "D:\dsh\projects\dsh-file-handover"
# profile 的 package.json：dependencies 加 "dsh-file-handover": "link:D:/dsh/projects/dsh-file-handover"
# 并把 "dsh-file-handover" 加进 dsh.profile.bundles（漏了不加载）→ 重启 DSH
handover_file path=<绝对路径> [timeoutSec] [dryRun] [expectTitle] [maxAttempts] [click]
典型配合（以网页上传为例）：
input.click() 不会弹出系统对话框）；handover_file 递文件；dsh-file-handover handover --path "D:\videos\a.mp4"
dsh-file-handover probe --path "D:\videos\a.mp4"
dsh-file-handover handover --path "D:\a.mp4" --expect-title "Open" --no-click
退出码：0 已交付 / 1 未完成 / 2 用法错误。
宿主侧（Node）只做编排：校验参数、检查文件、起一个 PowerShell 子进程、解析它返回的 JSON。
真正碰 GUI 的是包内的 lib/handover.ps1（UIAutomationClient + EnumWindows）。
两个刻意的选择：
.ps1 若为无 BOM 的 UTF-8，Windows PowerShell 会按 GBK 读，
脚本里的中文会变乱码、所有按标题匹配的逻辑会静默失效（实测：打开 → 鎵撳紑）。
自测里有一条硬断言守着这个文件必须全 ASCII。在一张真实的网页上传页上递一个 1MB 文件，这台机器上实际发生的事：
谢谢D：、但是、workspace、——test、upload-payload。斌谢谢D：D:\dsh\workspace\_test\upload-payload.bin
—— 中文输入法把打进去的字符变成了候选词和全角标点，而"全选"没生效，内容还在往后追加。谢谢D：、但D:\dsh\workspace\_test\upload-payload.bin —— 清空只生效了一半。upload-payload.bin:1000000。所以这三件事不是设计洁癖，是被逼出来的：③ 走剪贴板（绕开输入法）、④ 必须回读（一次永远不算数）、 ⑤ 只认控件 id（标题随语言变，认不起）。
EnumWindows / UI Automation / powershell.exe。#32770）：应用自己画的（自绘）选择器不适用。node test/smoke.mjs # 不碰真实 GUI：PowerShell 用假 spawn 顶替；含干活脚本的静态检查
MIT