PART 1
第一部分 · 单机版
只在这一台电脑上查自己的文件。不装服务器、不联网也能用。
1. 它是什么
把"这台电脑上有哪些文件"做成一张表，然后用网页去查它。
1
单机版 = 一个扫描程序 + 一个网页文件。
扫描程序读一遍硬盘，把文件名、路径、大小、修改时间记成一份清单；
网页把这份清单装进去，你就能像搜索引擎一样查它。
原件一个都不搬、不改、不删。
适合：只有一台常用电脑、或者出差时带着走、或者单位网络不方便连服务器。
2. 三步上手
第一次做一次，以后想更新再跑一遍扫描就行。
1
下载 — 到「下载」页拿两个文件：文件快搜.exe（扫描用）和 文件快搜-离线版.html（查询用）。两个放在同一个文件夹里最省事。
2
设置 — 第一次双击 exe 会进入对话式设置向导：选要扫描的盘符、加自定义分类、定联机目录（可选填服务器地址）。答完自动存成 set.ini，以后双击直接扫，想改设置就跑 文件快搜.exe --setup。
3
扫描 — 双击 文件快搜.exe 按设置读一遍硬盘，在 manifests 文件夹里生成 manifest-你的电脑名.jsonl。第一次几分钟，之后只扫新增和改动，几秒完成。
4
查询 — 双击 文件快搜-离线版.html，浏览器打开就是一个搜索框。输入关键词回车即可，点文件名直接打开文件；每条结果都带内容摘要和分类标签。
3. 离线页怎么用
一个 HTML 文件，断网也能查，拷到 U 盘换台电脑也能查。
| 你想做的事 | 怎么做 |
|---|
| 搜文件 | 输入关键词回车。多个词用空格隔开，命中的词越多排越前。 |
| 只看某类文件 | 用上方的类型、年份筛选；勾「仅中文」滤掉英文名的安装包和日志。 |
| 打开文件 | 点文件名即可，用的是本机默认程序（Word / Excel / 看图）。 |
| 换台电脑用 | 把 html 和同目录的 jsonl 一起拷过去，双击 html 即可。 |
| 更新数据 | 再跑一次扫描程序，然后用新生成的 jsonl 重新导出一次离线页。 |
离线页是纯静态文件，数据就在页面里，不会往外发任何请求。发给别人时注意：清单里有完整的文件路径。
4. 多机联查（不联网也能拼出"全网"）
把每台电脑扫出来的清单 jsonl 集中到一个文件夹，离线页就自动合并成"多台电脑一起查"。
1
各扫各的 — 每台电脑都跑一次 文件快搜.exe，各自的 manifests 文件夹里就有 manifest-电脑名.jsonl。
2
集中清单 — 把其他电脑的 jsonl 拷进来（U 盘 / 微信 / 共享目录都行），放进本机 manifests 文件夹。
3
重新生成 — 执行 文件快搜.exe --html-only，离线页自动合并所有清单：顶部显示「N 台电脑 · M 个文件」，可按电脑筛选。
外来电脑的记录带蓝色电脑名标签，只提供「复制路径」（那台电脑上才打得开）；
本机自己的记录照旧点文件名直接打开。清单很小（2 万个文件约 6 MB），随便传。
5. 边界与注意
· 单机版只有搜索：收藏、云端、排除都是服务器上的功能，单机版没有。
· 不联网也能多机联查（见上一节）；想让所有电脑在网页里实时汇总查，才需要第二部分的服务器。
· 每条记录都有摘要：文档类摘正文前 200 字，抽不到正文的（图片/视频/加密件）给"类型 + 目录"的虚拟摘要。
· 清单是"扫描那一刻"的快照。文件后来移动或改名，要重扫一次才准。
· exe 第一次运行可能被 Windows 安全中心拦一下，选「更多信息 → 仍要运行」。
PART 2
第二部分 · 网络版
多台电脑的清单汇总到一台服务器上，在一个网页里搜遍所有电脑，并告诉你在哪台机的哪个盘。
1. 它是什么
每台电脑把自己的清单传上来，服务器合成一张总表。
⇅
每台电脑跑一次扫描 → 把 manifest-机器名.jsonl 传到服务器 → 服务器入库 → 任何一个浏览器（电脑、手机都行）登录后就能搜全部。
每条结果都标着 在哪台电脑、哪个盘的哪个路径。
适合：办公室 + 家里 + 笔记本三台机器，找文件时不用先想"那东西在哪台电脑上"。
2. 服务器与数据库环境
先确认你的空间满足下面这些，再往下装。全部是常见配置，普通虚拟主机就够。
| 项目 | 要求 | 说明 |
|---|
| PHP |
7.4 及以上（推荐 8.0 / 8.1 / 8.2） |
不需要 root 权限，普通虚拟主机即可 |
| PHP 扩展 |
pdo_mysql、mbstring、json |
这三个缺一不可：连库、处理中文、接口返回都靠它们 |
| Web 服务器 |
Nginx 或 Apache |
能跑 PHP 就行；不限定用什么面板 |
| 数据库 |
MySQL 5.7.6+ 或 8.0；字符集 utf8mb4 |
必须是 5.7.6 以上：中文搜索用的是 ngram 全文索引，5.7.6 才内置。
MariaDB 默认不带 ngram 解析器，中文检索会不准，不建议。
|
| 数据库权限 |
建库建表、改表结构、加索引、增删改查 |
安装脚本会自动建 6 张表并加字段，权限不够会卡在第一步 |
| 数据库容量 |
2 万条文件约 8 MB；10 万条约 40 MB |
只存文件名和路径，不存文件内容，占用很小 |
| PHP 上传限制 |
upload_max_filesize ≥ 20M
post_max_size ≥ 24M
max_execution_time ≥ 120 |
清单文件一般几 MB；超过单次上限会自动分片上传，但这两个值别设太小 |
| 目录可写 |
so/upload/、so/upload/done/、so/cloud_files/ |
前两个放上传的清单，第三个放「传云端」的文件。脚本会尝试自动创建 |
| HTTPS |
可选，建议开 |
不开也能用；但登录密码是明文提交的，公网访问强烈建议配证书 |
| 端口 / 域名 |
80 / 443，一个域名或 IP 即可 |
程序都放在 so/ 目录下，访问 http://你的域名/so/ |
怎么快速确认环境够不够：把文件传上去后，打开 so/check.php，
它会逐项列出 PHP 版本、扩展、数据库连接、目录可写状态，缺什么一眼就能看到。
3. 一次到位安装
六步。第 4 步会自动把表、字段、索引全部建好，可重复执行。
1
建库 — 在主机面板里新建一个数据库（字符集选 utf8mb4），记下库名、用户名、密码。
2
传文件 — 把部署包里 so/ 目录下的全部文件传到网站的 so/ 目录，保持子目录结构不变。
3
改配置 — 打开 so/yxcon.php，只改三处：数据库地址/库名/账号密码、上传密钥、首页访问密码的哈希（文件里有生成命令）。
4
跑安装 — 浏览器打开 http://你的域名/so/install/upgrade.php，看到「全部就绪」即可。它会自动建表、加字段、建索引，老数据原样保留；可以反复打开，已做的会跳过。
5
传清单 — 每台电脑跑扫描，登录后点右上角 ↑ 上传清单 拖进去（或命令行上传）。文件大时会自动分片。重复上传不会重复入库，同机同路径只做覆盖更新，清单里没了的文件会自动清掉。
下面的「已导入的电脑」里可以给每台电脑写备注（放在哪个房间、什么品牌），鼠标点一下就能改。
6
验证 — 打开 so/filter_check.php 应全绿；回首页按 Ctrl + F5 强刷，搜一个词试试。
安装脚本会建哪些东西（都在一个库里，不碰别的数据）：
fm_machine 电脑清单 · fm_file 文件总表（含排除标记字段） ·
fm_synonym 同义词 · fm_history 搜索历史 ·
fm_fav 收藏 · fm_cloud 云端文件 · fm_exclude 排除规则 · 若干索引。
装好后建议把 install/ 目录改名或删掉，免得别人打开安装页看到库结构。
4. 怎么搜才准
不用记语法，按平时的说法写就行。
| 你输入 | 会发生什么 |
|---|
师德 考核 2026 |
三个词都要命中排最前；一条都没有时自动放宽为"命中任意一个"。 |
师 |
单字也能搜。返回所有文件名或路径里带这个字的文件。 |
向氏 族谱 |
自动带出同义词：家谱、宗谱、世系。 |
3月的培训通知 word |
识别出：培训/通知 + Word 类型 + 今年 3 月。 |
（什么都不输） |
列出全部文件，按修改时间倒序。 |
三个筛选小开关：机器（哪台电脑）、年份、文件类型；勾「仅中文」可以滤掉英文名的安装包和日志。
5. 结果上的按钮
每条结果右侧，按需要点。
打开
用这台电脑的 Word / Excel 直接开文件。需要先装"打开小工具"（见下载页）。
复制路径
把完整路径复制走，粘到资源管理器地址栏就能定位。
☆ 收藏
收进收藏夹。收藏存在服务器上，换电脑登录还是这一份。
⇪ 传云端
把文件本体传到服务器，另一台电脑在「云端」页下载。
排除
弹出这条路径的每一层，选一层就把它底下（含子文件夹）的文件都藏起来；也可以只排除这一个文件。
6. 收藏 / 云端 / 排除
三个跨电脑功能，各自一个独立页面，都在导航条上。除下载和说明外，其它列表都要登录才显示。
收藏
在 A 电脑搜到想要的，点「☆ 收藏」；
到 B 电脑打开导航「收藏」，列表里就在。
每一条都能打开、复制路径、移除。
云端
收藏只记"文件在哪"，云端存的是"文件本身"。
在 A 电脑点「⇪ 传云端」，到 B 电脑点「下载」拿到文件。
删除会同时清掉服务器上的文件，不可恢复。
排除（记录级标记，不是删记录）
点结果上的「排除」→ 弹出这条路径的每一层：
D:\ → D:\Work → D:\Work\项目A → 只这一个文件
选哪一层，那一层底下（含子文件夹）的文件就不再出现在搜索结果里。
被排除的文件还在库里，只是打了标记，所以：
| 想干什么 | 在哪做 |
|---|
| 整批恢复 | 首页「排除中」那条右边的 × ，或「排除」页规则行的「恢复」 |
| 只恢复一条 | 「排除」页下半部分，找到那条记录点「恢复」 |
| 全部恢复 | 首页「全部恢复」或「排除」页右上角 |
| 看框住了多少 | 「排除」页每条规则后面写着命中条数，实时统计 |
标记存在服务器上，换台电脑登录照样生效；重新扫描上传清单也不会把标记冲掉
—— 相当于在不改动扫描结果的前提下，维护了一套"我关心的范围"。
在 B 电脑点收藏里的「打开」，用的是 B 电脑 的程序。文件只在 A 电脑上时，B 电脑会提示找不到 —— 这时改用「复制路径」，回 A 电脑再取，或者提前「传云端」。
7. 常见问题
对上号就能自己解决。
安装页说「连不上数据库」
yxcon.php 里的地址、库名、用户名、密码有一处不对，或者数据库还没建。改完刷新安装页重试。
安装页某项标红「失败」
多半是数据库账号没有 ALTER 权限（加字段、加索引要它）。让空间商放开，或用 phpMyAdmin 执行 install/upgrade-exclude.sql。
排除功能点了没反应
数据库还没升级。打开 install/upgrade.php 点一次就好，页面上也会直接提示这句话。
搜不到某台电脑的文件
那台电脑还没跑过扫描，或者清单没上传。按「一次到位安装」第 5 步走一遍。
点「打开」弹出"还没装小工具"
去下载页下「打开本地文件 · 注册工具」，解压后双击 注册打开协议.bat。装完不用重开网页，直接再点一次。
提示"文件不存在"
清单是上次扫描时的快照，文件后来被移动、改名或删除了。重新扫描上传一次就同步了。
上传清单失败
清单超过服务器单次上传上限时会自动分片；如果仍失败，检查网络或换用浏览器重试。
同一份清单传了两次，会有重复吗
不会。服务器按「电脑 + 文件路径」判重，重复上传只做覆盖更新；清单里没出现的文件（已删或移走）会被自动清理。
改了电脑名，搜索里同一批文件出现两份
登录后进「上传清单」页，在旧电脑名那一行点「删除」，按提示手输电脑名确认即可。删除只清这台电脑的清单，收藏、云端文件、排除规则都保留，重新上传就能恢复。
手机能打开吗
能查、能收藏、能下载云端文件；「打开」「传云端」「排除」需要登录后台，手机上也能操作排除。
收藏页、云端页、排除页打不开
这三个页面需要登录。点页面中间的输入框，输访问密码即可。
隐私与安全
· 清单只记录 文件名、路径、大小、修改时间，以及少量正文摘要，不复制、不上传文件本身。
· 只有主动点「⇪ 传云端」的文件，文件内容才会存到服务器上。
· 本系统部署在单位内网/自有服务器上，数据不出本单位。
· 收藏、云端、排除都是共享的一份 —— 同一套访问密码，不区分个人账号，请勿放涉密文件。
· 离线页是纯静态文件，数据就在页面里；发给别人前想清楚，清单里有完整路径。