「表格关键词检索」用于在一个文件夹内批量查找表格内容，也能按条件分出命中和未命中的完整数据行。支持标准 .xls、.xlsx、.csv，处理在本机完成，无需安装 Microsoft Excel，也不修改原始文件。请使用带有 XLS 解析能力的工具箱版本（1.9.0 或以上）。
快速开始
打开插件的「操作」页，在「源文件夹」点击「选择」，选中存放表格的目录。也可输入绝对路径，或拖入文件夹、一个表格文件；拖入文件时使用它所在的目录。
需要处理下级目录时勾选「含子文件夹」。默认只扫描当前目录，扩展名不区分大小写，忽略
~$临时文件、符号链接和目录联接。点击顶部「配置」标签，或操作页的「修改配置」。在「检索方式」选择「关键词检索」，在「关键词设置」输入关键词后按回车。可输入多个关键词，任意一个命中即显示该单元格；一个单元格命中多个词仍只显示一条。
选择「包含」或「完全相等」，按需要关闭「区分大小写」，点击「返回操作」或「返回操作页」，核对配置摘要后点击「开始检索」。默认使用包含匹配并区分大小写。
结果显示文件相对路径、工作表、单元格位置、内容和命中关键词。点击「详情」查看同一行的所有列，点击「复制」复制该条内容。
例如，关键词为「北京」时，包含匹配可以找到「北京市」，完全相等只匹配内容恰好为「北京」的单元格。空格保留为短语的一部分；批量粘贴时，以换行、中文或英文逗号、分号分隔，重复项自动去除。若关键词本身包含逗号，请直接在关键词框中完整输入后按回车。
操作页与配置页
「操作」页放置源文件夹、含子文件夹开关、当前配置摘要、任务控制、三种导出和结果列表。「配置」页集中放置常用方案、检索方式、关键词或组合条件、检索范围及 CSV 读取设置，不需要在结果区域内展开高级选项。
配置使用分组卡片，宽窗口下「检索范围」和「CSV 读取」并排显示，小窗口自动上下排列。配置内容可独立滚动，顶部工具箱的操作/配置标签及返回、置顶按钮保持可用。
每项配置和方案操作旁都有问号按钮。将鼠标停在问号上，或用 Tab 键聚焦，可查看具体用途、输入规则、限制与示例；即使对应选项因任务运行或选择了「全部」而禁用，问号仍可查看。条件行中的列、匹配方式、关键词和移除操作也各有说明。
两个页面共用当前设置，切换标签不会清空已输入的条件或检索结果，也不会启动、取消任务。运行或暂停时仍可进入配置页查看说明，但不能编辑设置。条件修改后用于下一次检索；操作页会提示旧结果已失效，重新检索后才能导出。每次重新打开插件默认进入操作页，并恢复最近有效设置。
结果、进度与筛选
基础关键词检索包括表头；组合条件筛选只检查数据行。结果的行号、列字母始终是原文件中的位置。
文件、工作表和命中关键词筛选针对全部已保留结果，支持分页。文件路径筛选忽略大小写，工作表和命中关键词筛选按文本包含判断。
状态栏显示已处理文件数、总文件数、命中文件数、命中行数、命中单元格数及用时。组合筛选中一行只显示一条；纯排除条件没有正向命中单元格，单元格数可为 0。
点击「失败/跳过」查看明细。损坏文件为失败；缺少指定工作表、缺少列名、列名重名或条件列不在所选列范围为跳过，不计入未命中导出。
最多保留 50000 条结果。遇到更多匹配结果会提前停止并明确提示不完整；已扫描数只统计完整处理的文件。清单只导出已保留结果，整行导出会重新遍历绑定文件的全部数据行。
修改检索条件后，旧结果仍可查看，但会提示重新检索；完成重新检索前，不能用新条件导出旧快照。
组合条件筛选
在「配置」页的「检索方式」选择「组合条件筛选」，在分别展示的「包含条件」「排除条件」分组中创建条件。每条条件包含列、匹配方式和一个完整关键词，不按空格拆词。
例：包含「地区 完全相等 北京」和「B 完全相等 VIP」，选择「同时满足全部」，再排除「* 包含 禁用」。只有北京的 VIP 且整行所选列均未出现「禁用」的记录属于命中。
可以只设置排除条件，此时所有未被排除的非空数据行都属于命中。包含、排除都为空时无法执行。每组最多 100 条。纯英文字母且长度为 1–3 的列标识按 Excel 列字母解释；如果表头本身为 ID 等短英文名称，可先在「检索列范围」选择「按列名」并填写 ID，再使用 * 条件，或直接填写它实际对应的列字母。
检索范围与 CSV 读取
在「配置」页向下滚动，分别查看「检索范围」与「CSV 读取」卡片。各项直接展示，无需展开折叠面板。
工作表：默认全部，包括隐藏工作表；可按准确名称或从 1 开始的序号选择多个，用逗号分隔。CSV 视为名为
CSV的第 1 张工作表。检索列：默认全部；支持列字母和范围，如
A,C,F:H，或按准确表头名称选择。列名在每张工作表分别解析，重名时该表会跳过，请改用列字母。表头行数：默认 1，允许 0–100。0 表示所有行都是数据；多行表头会原样保留前 N 行，并用第 N 行作为列名来源。按列名检索时不能设为 0。
CSV 编码：自动模式优先 UTF-8（含 BOM），无效 UTF-8 字节时尝试 GBK；也可手动指定 UTF-8 或 GBK。仅凭文件无法保证所有编码都自动识别正确，乱码时请选择编码并预览。
CSV 分隔符：可自动检测英文逗号、分号、制表符，或手动指定。自动检测取第一条记录中引号外最常见的分隔符。支持双引号转义、引号内分隔符和跨行内容。
CSV 预览：显示扫描顺序中第一个 CSV 的前 5 行、前 20 列，用于核对解析效果；不会开始检索或导出。
三种导出
选择一个已经存在、有写入权限的输出目录。输出目录不能与源目录相同，也不能位于源目录内部。
整行导出保留源目录的相对子目录、各工作表名称和指定表头，并保留选中行的全部列，即使检索时仅指定了部分列。没有符合条件的数据行时不输出空工作簿；空数据行不参与导出。CSV 的跨行记录视为一个数据行。
未命中是最终行判断的补集：被排除条件命中的行也属于未命中。解析失败或跳过的文件/工作表不会被当作未命中。
已有检索结果时，导出绑定当时的文件列表及条件；执行前和读取后会核对源文件真实路径、大小、修改时间和创建/变更时间，发现变化时提示重新检索。源目录新增文件不会自动加入旧快照，需要重新检索。尚未检索时，可以直接点击命中行或未命中行导出，弹窗会说明使用当前条件扫描；清单导出必须先检索。
已有同名输出不会覆盖。如果同一个相对目录下同时存在 客户.xls 和 客户.xlsx，它们会生成同名目标，整批导出在开始前拒绝并提示重名。请选择新的输出目录，或自行调整源文件名称后重新检索。
单元格内容与限制
数值使用实际存储值，不使用货币、百分比等显示格式；文本形式的前导零保留。布尔检索文本为 TRUE / FALSE。日期检索文本为 ISO 格式，纯日期例如 2026-01-02，包含时间时带 UTC 时间；导出行保留日期值。
公式只读取已保存的缓存计算值，不重新计算，不执行宏。没有缓存值时视为空。富文本拼接成普通文本。导出只保留数据值，不保留源样式、字体、图片、合并区域、公式或宏；清单中的长行展示内容最多 32767 字。
单文件上限 64 MB，每个工作簿已用矩形范围累计最多 200 万单元格；CSV 最多 200 万字段、16384 列，每个字段最多 32767 字。源文件数量最多 50000，关键词最多 500 条、每条最多 1000 字。解析库需要内存，压缩后很小但包含大量图片、格式或共享字符串的 XLSX 仍可能占用较多内存，建议先拆分。
不支持密码加密工作簿、.xlsm、.xlsb，以及把 HTML/XML/CSV 直接改成 .xls 后缀的文件；请先用 Excel 另存为标准格式。超大文件解析并非流式无限处理。
常用方案与任务控制
在「配置」页顶部的「常用方案」点击「另存为」保存名称唯一的方案。方案包含路径、检索模式、关键词、组合条件、范围、表头和 CSV 设置、命中/未命中输出目录，不包含结果、进度和后台任务。选择方案后可以「保存」更新、「改名」或「删除」。方案有改动时显示「方案有修改」，保存按钮显示 *；切换前可选择保存、放弃或取消。最多保存 100 个方案，加载只恢复设置，不自动执行任务；路径失效会提示重新选择。
最近有效设置会自动保存。未填写完整的条件不会覆盖最近有效配置；请填写完条件再保存方案。重启插件不恢复上一次结果或中途进度。
检索与导出互斥。暂停会在下一个检查点生效；XLS/CSV 解析或 XLSX 解压写入期间可能需要等待当前解析操作返回。继续会接着处理，取消会清理当前临时文件，保留已完成的输出，可在「已导出」中查看准确路径。强制结束软件或断电可能留下临时文件。
右上角保留工具箱统一的「返回」「置顶」。有运行或暂停任务时返回会由工具箱提醒，确认离开后取消并收尾。错误同时记录到工具箱统一 error.log，反馈时可提供错误明细及对应时段日志。