﻿============================================================
  FindDoc  ——  按后缀找文档
  使用说明
============================================================

它能干什么
------------------------------------------------------------
  告诉你硬盘上哪里有你要的文档，按修改时间从新到旧列出来，
  同时在桌面存一份 CSV 表格报告。

  它只读不写：不改你的文件、不删东西、不联网。


============================================================
  最简单的用法：双击（不用打任何命令）
============================================================
  双击  一键查找.bat    （从网页单独下载的话，这个文件叫 Run.bat，同一个东西）
  然后照着屏幕上的 4 个问题回答，不想填的直接按回车：

      【1/4】要找什么后缀的文档？   输入  docx      按回车
      【2/4】在哪个位置找？         直接回车 = 全盘所有硬盘
      【3/4】文件名里包含什么字？   直接回车 = 不限
      【4/4】正文里包含什么字？     直接回车 = 不限

  结束以后：
      · 屏幕上列出找到的文档
      · 桌面上多一个「找到的文档_日期时间.csv」，双击就是表格


============================================================
  一行命令的用法（更快）
============================================================
  在脚本所在文件夹里，按住 Shift 点右键 →
  选「在此处打开 PowerShell 窗口」，然后敲：

      .\FindDoc.ps1 docx

  这一行就是「全盘找所有 .docx」。没有别的了。


  +----------------------------------------------------------+
  |  你想干什么                  ->   就敲这一行             |
  +----------------------------------------------------------+
  |  全盘找 Word 文档            ->   .\FindDoc.ps1 docx
  |  全盘找 PDF                  ->   .\FindDoc.ps1 pdf
  |  一次找好几种格式            ->   .\FindDoc.ps1 doc,docx,pdf
  |  只在 D 盘找                 ->   .\FindDoc.ps1 docx -目录 D:\
  |  文件名里有"论文"的          ->   .\FindDoc.ps1 docx -名称 论文
  |  正文里有"参考文献"的        ->   .\FindDoc.ps1 docx -内容 参考文献
  |  最近 30 天改过的            ->   .\FindDoc.ps1 doc,docx -天数 30
  |  大于 1 MB 的                ->   .\FindDoc.ps1 docx -大小 1
  |  连回收站一起翻              ->   .\FindDoc.ps1 docx -回收站
  |  论文丢了这样找              ->   .\FindDoc.ps1 doc,docx -内容 参考文献
  +----------------------------------------------------------+


============================================================
  规则就两条，记住就行
============================================================
  1. 第一段永远写「后缀」，不写路径就是全盘。
  2. 后面想加条件，就一个空格接一个 -参数。

  可以连着加，顺序随便：

      .\FindDoc.ps1 docx -目录 D:\ -名称 论文 -天数 30


============================================================
  参数表
============================================================
  后缀           必填。docx / doc / pdf / xlsx / pptx / txt ...
                 多个用逗号隔开：doc,docx,pdf
                 写 * 表示所有文件（必须再加别的条件）

  -目录 路径     在哪里找。省略 = 全盘所有硬盘。
                 例：-目录 D:\     -目录 "D:\我的文件"

  -名称 字       文件名里包含这个字才算。
                 例：-名称 论文
                 竖线表示"或"，但必须用引号包住，否则会被当成管道符：
                     -名称 '论文|毕设|thesis'

  -内容 字       打开文档，正文里包含这个字才算。
                 例：-内容 参考文献
                 它不看后缀，是直接读文件头判断真实格式的 ——
                 所以被改名成 .tmp 的 Word 文档、后缀是 .asd 的
                 自动恢复文件，照样能把正文搜出来。
                 能搜：docx docm odt pptx xlsx、老式 doc/wps/asd/wbk、
                       纯文本和各类代码文件
                 搜不了：pdf、扫描图片、音视频 —— 只能按文件名找

  -天数 数字     只要最近这么多天改过的。例：-天数 7

  -大小 数字     只要大于这么多 MB 的。例：-大小 1

  -回收站        连回收站一起找。
                 别人账户的回收站要管理员权限才看得到。

  -报告 路径     报告存到哪。省略 = 存到桌面。
                 例：-报告 D:\结果.csv

  -含系统目录    连 Windows、Program Files 里面也翻。
                 默认会跳过这些，因为它们只有软件自带模板，
                 没有你的文档，翻了只是浪费时间。

  英文名也能用：-Ext -Path -Name -Text -Days -Min -Out


============================================================
  结果在哪里
============================================================
  1. 屏幕上直接列出来，路径可以选中复制。
     超过 100 个时，屏幕只显示前 100 个。

  2. 桌面上的 CSV 文件（完整结果，一个不漏）。
     双击用 Excel 或 WPS 打开就是表格。
     按「修改时间」那一列排序，最新动过的排最前面 ——
     找丢失的文档，看这个最有用。

  3. 屏幕最后会打印报告路径，也可以自己指定到别的地方。


============================================================
  论文 / 文档丢了？先翻这几个目录
============================================================
  Word 和 WPS 一直在偷偷给你存备份，救命的往往就是它们。
  这些文件名字古怪、位置隐蔽、后缀还经常是错的，所以按名字找不到。

  后缀            它到底是什么
  ------------------------------------------------------------
  .asd            Word 自动恢复文件（崩溃、断电时自动存下的）
  .wbk            Word 备份副本（每次保存都留下上一版）
  ~WRL####.tmp    Word 崩溃残留的临时文件，内容其实是完整文档
  .wps / .wpt     WPS 文字文档 / WPS 文字模板
  .et / .dps      WPS 表格 / WPS 演示
  .bak / .old     备份文件 / 手动改名留下的旧版本
  ~$xxx.docx      Word 锁文件，只有几十字节，不是文档（已自动跳过）

  直接开搜（三行，复制粘贴即可）：

      .\FindDoc.ps1 asd,wbk,tmp,docx -目录 "$env:APPDATA\Microsoft\Word"

      .\FindDoc.ps1 docx,wps,wpt,doc -目录 "$env:APPDATA\kingsoft\office6\backup"

      .\FindDoc.ps1 asd,wbk,tmp,wps,wpt,docx,doc -目录 "$env:APPDATA\Microsoft\Word","$env:APPDATA\kingsoft\office6\backup" -内容 参考文献

  找到之后怎么打开：
      复制一份出来（别动原文件），把后缀改成 .doc 或 .docx，再用 Word 打开。
      .tmp / .asd / .wbk 直接双击是打不开的，Windows 不知道用什么软件开。
      .wps 用 WPS 打开，不用改名。

  网页上有完整的后缀对照表：https://114.215.190.71/


============================================================
  常见问题
============================================================

  Q：扫全盘要多久？
  A：看硬盘多大。一般电脑 20 秒到 1 分钟。
     加了 -内容 会慢一些，因为要一个个打开文档看正文。

  Q：屏幕上刷了一堆红字？
  A：那是没权限读的系统文件夹，正常现象，脚本会自动跳过，
     不影响结果。

  Q：一个都没找到？
  A：屏幕上会给 5 条建议，照着试。最常见的两个原因：
     · doc 和 docx 是两种不同格式，写错了就找不到
     · 条件加太多，去掉 -名称 -内容 再试一次

  Q：为什么搜不到 PDF 里的字？
  A：PDF 是压缩的二进制格式，不装专门的库读不出正文。
     网页上推荐的 AnyTXT Searcher 支持，建议装一个。

  Q：会不会误删我的文件？
  A：不会。这个脚本从头到尾只做「读取」和「列出」，
     一个字节都不会写进你的文档。

  Q：能不能只找某个文件夹？
  A：可以。  -目录 "C:\Users\你的名字\Desktop"

  Q：回收站里找出来的文件能用吗？
  A：能。那就是原文件本身，复制出来改个名就能用。

  Q：正文搜索为什么搜不到"新建 Microsoft Word 文档"里的字？
  A：能搜到。脚本会把 docx 的正文抽出来再匹配，
     哪怕字被 Word 拆成了好几段也能连起来找到。


============================================================
  网页（一行命令速查、正则速查表、Everything 等工具）
      https://114.215.190.71/
============================================================
