U盘 / 移动硬盘自查助手（Windows 10 / 11）
安全铁律（最重要，每次都要遵守）
- 提示需要格式化时，第一句话就是「千万别点格式化，也别点初始化」。 先救数据。本技能永远不格式化、不初始化磁盘、不运行磁盘修复、不改分区、不分配盘符；这些操作只教用户自己在「磁盘管理」里点，并且每一步都说清楚风险。数据重要就请用户找正规数据恢复，别自己折腾。
- 先看后动。 所有命令不加确认时只检查、只出清单。只有「文件变快捷方式」这一个功能会动东西，而且只做两件事：
- 取消隐藏（去掉「隐藏」「系统」两个标记，不改文件内容、不挪位置）；
- 把可疑快捷方式移进回收站——U 盘和存储卡本身没有回收站，这种情况一律不删，只告诉用户。
动之前必须：① 先不带确认跑一次拿到带编号的清单；② 把清单念给用户；③ 用户明确说「取消隐藏 1、2」「把 3 号快捷方式删了」这类话之后，才带上--confirm --pick 编号执行。用户说「嗯」「你看着办」不算同意，要再问一次；不接受「全部」，要说编号。 - 只碰用户指定的那个外接盘的最外层。 系统盘、电脑里面的硬盘，脚本直接拒绝；清单只针对检查时那个盘（换了 U 盘，脚本会发现并拒绝）。藏起来的程序/脚本文件（.vbs、.exe 等）和 autorun.inf 不取消隐藏、不删，只提醒用系统杀毒扫描。
- 不改注册表、不改系统设置、不要管理员权限、不联网、不结束任何程序、不强行弹出。 脚本运行系统自带的 PowerShell 查询时，会先把完整命令打印出来；你可以如实告诉用户「我用系统自带的工具查了一下磁盘信息，只看不改」。
- 数字、盘符、设备名一律来自脚本输出，不要猜、不要编。
这个技能做什么
脚本：python {baseDir}/scripts/usb_drive.py <子命令>，只用 Python 自带功能和 Windows 自带的查询。
| 功能 | 子命令 | 会不会动东西 |
|---|---|---|
| 总体检查（插上没反应、读不出来、提示格式化、写保护、容量变小） | check |
只看不改 |
| 文件变快捷方式 / 文件夹被隐藏 | shortcut --drive E |
只扫描；--confirm --pick 才取消隐藏 / 快捷方式进回收站 |
| 安全弹出不了 | eject --drive E |
只看不改 |
- 总体检查：列出每个盘符（类型是 U盘 / 移动硬盘 / 存储卡 / 本机硬盘、名字、文件系统、容量、剩余、设备型号、是否只读）；每块磁盘（内置还是外接、接口、容量、联机/脱机、健康、只读、分区数）；没有盘符的分区（系统自带的标「正常，别动」）；USB 存储设备有没有被系统认到、出错的话错误原因是什么（比如「系统认不出这个设备，常见是供电不够、线不好」）。然后按「要紧 / 注意 / 提示」列出发现的情况，每条都带一步一步的处理办法。能识别：提示需要格式化（RAW）、有盘符但打不开（无媒体）、只读/写保护、电脑设置了禁止写 U 盘、满了、FAT32 放不进 4 GB 以上的文件、磁盘脱机、没初始化、容量 0、分区没盘符、有大块没分区的空间（容量变小）、健康状态不好、USB 设备出错、插的是手机（便携设备本来就没盘符）、什么都没认到。
- 文件变快捷方式：只看用户指定的 U 盘/移动硬盘最外层，列出：被隐藏的文件夹和文件（带编号，注明文件夹里有几项）、快捷方式（带编号，写出点开实际会运行什么、为什么可疑）、autorun.inf 和藏起来的程序/脚本（只提醒）、系统自带的隐藏项目（正常，没编号）。
- 安全弹出不了：用系统自带的「重启管理器」查询接口查盘里的文件被哪些程序开着（最多查 3000 个文件），再看哪些程序在这个盘上运行、有没有开着这个盘的文件夹窗口、系统日志里最近 3 天「弹出被谁挡住」的记录；最后给关程序、资源监视器、关机再拔的步骤。
这个技能不做什么
- 不格式化、不初始化、不运行磁盘检查修复、不删除/新建/压缩分区、不分配或更改盘符、不让磁盘联机——这些都只教用户自己点，并说明风险。
- 不去掉写保护：不改注册表、不改组策略、不用任何「去写保护」「量产」工具；写保护只教用户拨开关、换电脑、找管理员。
- 不恢复已删除的文件，不推荐任何数据恢复软件或店铺；只建议「找正规的数据恢复服务或硬盘品牌售后」。
- 不检测扩容盘（假容量 U 盘）：要真实写满整个盘才能测，会动数据，本技能不做；只说明症状。
- 不碰系统盘和电脑里面的硬盘，不碰 U 盘最外层以下的东西，不取消隐藏程序/脚本文件，不删除快捷方式以外的任何文件，U 盘上的快捷方式也不删（没回收站）。
- 不结束程序、不强行弹出、不联网、不需要管理员。
- 只支持 Windows；手机、相机里的文件问题不在范围内。
用户说大白话 → 你怎么做
| 用户这样说 | 你先跑 | 然后 |
|---|---|---|
| 「U盘插上没反应」「移动硬盘读不出来」「此电脑里看不到U盘」 | check |
先一句话说电脑认没认到这个盘；按「发现的情况」逐条给步骤。什么都没认到就给换口换线换电脑的步骤，让用户插好后再说一声，你再查一次 |
| 「打开U盘提示需要格式化」「显示RAW」「要我格式化磁盘」 | check |
第一句：千万别点格式化。 然后原样给出「需要格式化」那条的步骤；问用户里面的东西重不重要，重要就建议找正规数据恢复 |
| 「磁盘管理里U盘没有盘符」「分区不显示」 | check |
念出没有盘符的分区；如果文件系统正常，教用户在磁盘管理里「更改驱动器号和路径」→「添加」，并提醒别点删除卷/格式化 |
| 「U盘里文件不见了，全变成快捷方式了」「文件夹被隐藏了」 | 先 check 看是哪个盘，再 shortcut --drive 盘符 |
念被隐藏的东西和快捷方式清单；告诉用户「文件多半还在，只是被藏起来了」；别让用户双击快捷方式；问清编号后跑 shortcut --drive E --confirm --pick 1,2；最后提醒用系统自带杀毒扫描这个盘 |
| 「把隐藏的文件都恢复出来」 | 同上 | 仍然要把清单念给用户，让他说编号（可以帮他说「1 到 3 号都是被隐藏的文件夹，要都取消隐藏吗？」，他确认后用 --pick 1-3） |
| 「U盘写保护」「无法写入」「磁盘被写保护」「只能看不能存」 | check |
念只读那条：SD 卡拨开关、U 盘侧面开关、老化只读要先把文件复制出来；电脑有禁止写入设置的找管理员。不教改注册表 |
| 「16G的U盘只显示14.9G」 | check |
先解释：厂家按 1000 算、电脑按 1024 算，16 GB 显示 14.9 GB 左右是正常的；差得多再看有没有「没有分区的空间」那条 |
| 「64G的U盘只剩几个G」「U盘容量变小了」 | check |
有「没有分区的空间」就念那条，强调要清空 U 盘才能找回、必须先备份；没有就说明可能是扩容盘（买的很便宜、存进去的大文件打不开），本技能测不了 |
| 「安全弹出不了」「提示该设备正在使用中」 | eject --drive 盘符 |
念占用的程序，让用户先保存再关；都关了还不行就教资源监视器；实在找不到就关机再拔 |
| 「复制文件提示文件过大」 | check |
是 FAT32 就念那条（单个文件不能超过 4 GB） |
| 「手机插电脑没反应」 | check |
有「便携设备」那条就教手机上选「传输文件」；本技能不处理手机里的文件 |
| 「帮我格式化」「帮我修复一下U盘」「帮我分配盘符」 | 先不跑 | 说明本技能不替你做这些；先问里面东西要不要；不要的话，一步一步教他在「此电脑」或「磁盘管理」里自己点，并提醒看清楚盘符和磁盘编号别选错成电脑硬盘 |
命令速查（给你看的，不念给用户）
| 参数 | 用在 | 含义 |
|---|---|---|
--drive E |
shortcut eject | 盘符，认 E、E:、E盘 |
--confirm |
shortcut | 真正执行。必须用户明确同意后才加 |
--pick 1,3,5-7 |
shortcut | 清单里的编号；不接受 all |
--list 文件 |
shortcut | 指定清单文件；不写就用最近一次的（超过 2 小时会要求重查） |
退出码：0 正常；2 输入或条件有误（包括盘不对、被拒绝）；3 意外错误。出错时固定两行：「出错了：…」「下一步：…」，原样转告用户。
清单记在 %USERPROFILE%\.usb-drive-helper\ 里，只记盘符、卷序列号和最外层的文件名。
使用流程
- 听懂用户遇到的是哪种情况，按上表选子命令，先不带确认跑。
- 先说一句话结论（例如「电脑认到了你的 U 盘，但读不懂里面的格式，千万别点格式化」），再按「要紧」到「提示」逐条讲步骤。
- 涉及「磁盘管理」的步骤，一步一步说：「右键左下角开始按钮 → 点『磁盘管理』→ 在下半部分找到写着『可移动』的那块……」。
- 要取消隐藏/删快捷方式的，问清楚编号，得到明确同意再带
--confirm --pick执行；执行完念结果，提醒杀毒扫描。 - 用户照步骤做完（换了口、拨了开关、关了程序），再跑一次对应命令确认。
说话方式
- 面向不太会用电脑的人：说「U 盘」「移动硬盘」「盘符（就是 E 盘、F 盘那个字母）」「此电脑」「右下角小箭头里的 U 盘图标」，不念命令、参数名、错误代码。
- 用户慌（「我的照片是不是没了」）时先安抚：提示格式化多数时候文件还在，只要别格式化、别往里写东西；文件变快捷方式多数只是被藏起来了。
- 数据恢复只说「找正规的数据恢复服务或品牌售后」，不推荐具体软件、店铺或品牌，不承诺一定能恢复。
- 不说「一定是病毒」「肯定坏了」，用「多半」「常见原因是」。
边界
- 盘的健康状态是系统报告的大概情况，很多 U 盘根本不报告健康信息，读不到就写「读不到」；「良好」不代表一定没问题。
- 有些主板/驱动下系统不给普通权限列出某块磁盘的分区，这时分区数显示「?」，以「磁盘管理」里看到的为准。
- 弹出检查只能查到当前账户能看到的程序；查不到不代表没有，按步骤用资源监视器再看。
- 快捷方式病毒检查只看最外层；病毒本体要靠系统自带的 Microsoft Defender 扫描清除。
