'/%3e%3cuse%20xlink:href='%23cn-a'%20width='30'%20height='20'%20transform='matrix(-12.33562%20-20.5871%2020.58684%20-12.33577%20240.3%2048)'/%3e%3cuse%20xlink:href='%23cn-a'%20width='30'%20height='20'%20transform='matrix(-3.38573%20-23.75998%2023.75968%20-3.38578%20288%2095.8)'/%3e%3cuse%20xlink:href='%23cn-a'%20width='30'%20height='20'%20transform='matrix(6.5991%20-23.0749%2023.0746%206.59919%20288%20168)'/%3e%3cuse%20xlink:href='%23cn-a'%20width='30'%20height='20'%20transform='matrix(14.9991%20-18.73557%2018.73533%2014.99929%20240%20216)'/%3e%3c/svg%3e)
语言: 简体中文完整教程和参考
通过我们的综合指南学习如何有效使用 FilePulse，涵盖基本操作到高级配置。
如何首次运行 FilePulse
FilePulse 可运行在 Windows、macOS 和 Linux。默认本地 Web 控制台使用 80（HTTP）和 443（HTTPS）端口；如果其中任一端口被占用，FilePulse 通常会在 80–10000 范围内自动寻找一组可用的 HTTP/HTTPS 端口，将新端口写入 config.json，并自动重启加载。启动提示会显示新的访问地址。只有自动选择或写入失败，或者网络环境要求固定端口时，才需要手动修改 config.json。
平台指南
在独立目录中运行 FilePulse.exe。磁盘索引、文件操作或绑定低端口需要管理员权限时，FilePulse 会自动提权。
请先将发布包完整解压到单独目录再运行。版本升级时建议使用新的独立目录，避免旧配置或运行文件与新版本发生冲突。
双击 FilePulse.exe 启动。不要在“兼容性”选项卡中强制勾选“以管理员身份运行此程序”；正常启动器会管理提权，同时保留以普通权限打开文件的能力。
FilePulse.exe下载程序后如果FilePulse.exe图标上显示一个盾牌，请将其放置到其他文件夹直到没有盾牌为止，否则会影响以普通权限打开某一个目标，如果你不需要这个功能可以忽略。
如果出现"卷更改日志处于非活动状态"则说明有一个盘符有问题，你需要修改config.json将drive_list移除有问题的盘符。
平台指南
macOS 的 Gatekeeper 可能会阻止从互联网下载的应用。请根据您下载的版本参考以下步骤：
建议：下载后请将应用移动到其他目录（如 /Applications）运行，不要在下载目录直接运行，以免被系统拦截。
打开终端进入应用所在目录并执行：
xattr -dr com.apple.quarantine FilePulse.appchmod +x FilePulse.app/Contents/MacOS/*如果无法打开：打开「系统设置」→「隐私与安全性」→ 滚动到最下方 → 找到 FilePulse 并点击「仍要打开」。
在程序目录下打开终端并执行：
chmod +x FilePulse如果运行受阻：打开「系统设置」→「隐私与安全性」→ 点击「仍要打开」。
使用 sudo 启动标准版可以正常显示托盘图标并获得完整权限：
sudo ./FilePulse使用以下脚本后台运行（每次运行都需要输入 sudo 密码）：
平台指南
已在 Debian、Ubuntu、Arch Linux 和 CachyOS 上完成验证，FilePulse 整体运行正常。
解压 zip 后，在包含 AppImage 文件的目录中打开终端并执行：
chmod +x ./FilePulse.AppImage如果当前目录下只有一个 AppImage 文件，可直接执行：
sudo ./FilePulse.AppImage在程序目录下打开终端并执行：
chmod +x FilePulse请在终端中执行以下命令（Ubuntu/Debian）：
sudo apt install -y libxdo3 libunwind-15 libayatana-appindicator3-1 libwebkit2gtk-4.1-0建议使用 root 权限启动程序以确保功能正常：
sudo ./FilePulse您可以使用以下脚本以 sudo 权限启动 FilePulse 并在后台运行，无需等待程序结束。每次运行都需要输入 sudo 密码：
默认端口被占用时，FilePulse 通常会自动选择可用端口、写入 config.json 并自动重启；只有需要固定端口或自动恢复失败时才需手动配置。
打开浏览器，访问 http://127.0.0.1 然后输入默认用户名和密码都是"root"即可进入系统
http://127.0.0.1用户名：root，密码：root新用户30天免费试用
下载程序后如果FilePulse.exe图标上显示一个盾牌，请将其放置到其他文件夹直到没有盾牌为止，否则会影响以普通权限打开某一个目标，如果你不需要这个功能可以忽略。
如果以普通方式运行，程序会自动切换至管理员权限，但是请不要在FilePulse.exe属性的兼容性标签中设置以管理员身份运行此程序，如果设置兼容性将会和前面提到的一样无法使用普通权限打开某一目标，如果你不需要这个功能可以忽略。
如果出现"卷更改日志处于非活动状态"则说明有一个盘符有问题，你需要修改config.json将drive_list移除有问题的盘符。
版本升级后最好将新下载的FilePulse单独放到一个新文件夹，以免旧的配置和新的配置冲突。
在 Windows、macOS 和 Linux 上，操作系统的文件事件队列容量有限。短时间内批量修改大量文件（例如 1 秒内删除 10,000 个文件）时，部分事件可能无法送达 FilePulse，导致个别文件信息暂时遗漏。这属于操作系统限制，并非 FilePulse 故障；重启 FilePulse 即可重新同步。
探索 FilePulse 的主要功能
类似everything，带有各种复杂筛选条件，主要用于用户的复杂搜索，可以毫秒级响应
可搜索文本、Office 文档、PDF、电子书、网页，以及通过 OCR 识别的图片内容。截图、扫描 PDF、文档内嵌图片中的文字在索引后也可以被检索。
支持使用图片、截图或视频作为查询，查找视觉相似图片和匹配的视频片段，并查看缩略图、路径、服务器和目标时间段。
类似listary，输入关键字结果提前按照大多数习惯排序过，快速定位目标位置并启动
按大小与特征快速比对重复文件，安全复核后高效清理冗余。
支持文档、电子书、压缩包、图片、音视频等格式的快速预览，并可进行远程下载、上传与定位。
本地与远程映射目录可持续自动同步，支持周期更新、稳定重连与删除记录追踪。
支持 LLM 配置管理、多会话持久化、图像上传与一键清空全部会话。
类似音速启动，提前将常用软件进行添加（由于采用浏览器，所以拖拽无法获得完整路径，目前需要输入，未来打造原生应用则可使用拖拽）
使用核心搜索与远程能力，启动面板在集群中为可选项。
支持通过快捷键在 Windows、macOS、Linux 自动带入当前文件管理器路径，并在 Windows 下衔接受支持的打开对话框，也可以继续细化当前搜索范围或返回上级范围。
支持通过持久化搜索注解、分组、置顶项、自定义排序、启动恢复和更顺滑的键盘导航来管理持续进行中的搜索任务。
选择要完成的任务，然后打开对应的分步实战案例。
用这些轻量工具快速复用查询、并行整理任务，并更高效地浏览结果。
FilePulse 支持多种文件格式的内容搜索
不同类型的文件由专门的处理器处理，也包括用于图片、扫描 PDF、Office 文档内嵌图片的 OCR 处理器。你可以在「设置 -> 内容规则 / 处理器配置」中按文件类型选择合适的处理器。
当文档已经包含可选中文本、结构化文档文本、电子书内容或网页文本时，使用这些处理器。
所有文本类型文件原样读取
Microsoft Word 文档所有文本
Microsoft Excel 表格所有文本
Microsoft PowerPoint 演示文稿所有文本
PDF 文档所有文本
RTF 富文本格式文档的全部文本内容
EPUB 电子书文件中的可搜索内容
FB2 电子书文件中的可搜索内容
HTML 网页文件去掉标签后内容
当重要信息出现在截图、照片、扫描页、图片型 PDF 或 Office 文档内嵌图片中时，使用这些处理器。
Word 文档文本，加上内嵌图片中 OCR 识别出的文字
Excel 表格文本，加上内嵌图片中 OCR 识别出的文字
PowerPoint 幻灯片文本，加上幻灯片图片中 OCR 识别出的文字
PDF 文本，加上扫描页和内嵌图片中 OCR 识别出的文字
从图片文件中 OCR 识别文字，让截图和照片也可以通过内容搜索找到
当图片或视频需要参与视觉搜索、截图匹配和视频片段查看时使用这些类型。视频视觉搜索需要 FFmpeg 可用。
图片和常见视频文件可作为视觉搜索目标或查询文件。图片搜索可直接使用，视频索引和查询需要 FFmpeg。
提示：当可搜索信息以图片而非可选中文本形式存在时，请使用 OCR 处理器。
掌握这些快捷键，提升您的工作效率
解锁 FilePulse 的全部潜能
自带证书为开发证书，如需更换真实证书，替换 certs 目录下的文件。
默认同时开启 HTTP2 / HTTP3，但由于开发证书问题，可能会自动降级为 HTTP2。更换为真实证书后，即可正常使用 HTTP3。
Search Content和Path编辑框，支持非（!）,与（空格），或（
Search Content和Path编辑框，支持非<not>，与<and>，或<or>，左括号<left>，右括号<right>
对应四种搜索模式：普通模式，正则表达式，前缀匹配，模糊匹配。其中模糊匹配性能最差，尽量避免使用。前缀匹配必须要有两个分词开始，而在简单表达式又以空格分隔，所以前缀匹配需要用高级表达式。
对应两种搜索模式：通配符搜索，正则表达式搜索。两者都是对所有需要查询的文件进行逐个匹配，性能会变差。
在「设置 → 远程服务器」中填写地址、协议、用户名和密码。成功保存的服务器会持久保留；FilePulse 启动后会自动尝试重新连接，连接失败时按逐步延长的间隔继续重试。请通过设置中的连接状态判断服务器当前是否在线。
配置并选择一个已保存且在线的远程服务器，然后确认远程实例能够访问的回调协议和地址。
启用自动挂载后，挂载配置会跨重启保留。首次挂载所需时间取决于远程服务器中的文件数量。
FilePulse 会检查远程实例、回调健康状态和挂载租约。远程实例重启、断线或挂载状态失效时，会清除过期的远程数据并尝试重新挂载；恢复期间远程结果可能暂时不可见。
在 Windows 上通过 WebDAV 挂载时，主要注意 HTTP 连接支持和文件大小限制。
按 Win + R，输入 regedit，打开注册表编辑器。
定位到 HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\WebClient\Parameters。
找到 BasicAuthLevel，将数值数据改为 2。
按 Win + R，输入 services.msc，打开服务管理器。
找到 WebClient，右键选择重新启动。
Windows WebDAV 传输文件大小限制默认为 50M。
在同一路径下找到 FileSizeLimitInBytes。
将默认的值 2faf080 修改为 ffffffff，即可将 WebDAV 可传输的最大值从 50M 调整为 4G。
找到 WebClient，右键选择重新启动。
Windows 使用共享前，请先在注册表中开启 WebClient 基本认证。
右键单击开始，然后选择运行。
键入 regedit 并单击确定。
在注册表编辑器中，转到 HKEY_LOCAL_MACHINE > SYSTEM > CurrentControlSet > Services > WebClient > Parameters。
打开 BasicAuthLevel，将数值数据更改为 2。
重新启动计算机，并再次使用共享。
通过设置页导出或导入配置、检查内置更新，并迁移搜索工作区、共享、同步、LLM、内容规则和远程服务器数据。
查看下载与发布包 →通过需要鉴权的本地 HTTP API，让 AI Agent、脚本、启动器和内部工具调用 FilePulse 的搜索、预览和下载能力。
阅读开发者 API 指南 →config.json 控制本地服务名称、登录、端口、索引位置、快捷键、启动行为和部分运行偏好。大多数用户只需要在默认环境不适合时调整端口、drive_list、hot_keys、多实例策略或启动选项。
端口、drive_list、hot_keys、多实例策略和启动选项适合手动调整。账号密码优先在 Web 界面中修改。修改端口、监听位置、快捷键或 max_batch 后，建议重启 FilePulse 让新设置稳定生效。
server_name本地 FilePulse 节点显示名称。使用远程节点或集群工作流时建议保持唯一，方便识别结果和远程操作来源。
port_http / port_https本地 Web 控制台和服务 API 使用的 HTTP / HTTPS 端口。如果 80 或 443 被占用，请在启动前修改端口，并访问对应地址。
drive_listFilePulse 监控并建立索引的位置。Windows 通常是盘符，macOS 和 Linux 通常是 /Users、/home 等路径。
hot_keys全局快捷键定义，可关联当前文件夹搜索、内容搜索、快速启动器、启动器面板和上下文搜索。
open_link_after_boot控制本地服务启动后是否自动打开浏览器。后台启动、服务器部署或希望手动打开控制台时可以关闭。
max_batch内容索引批处理大小。数值越大可能构建越快，但需要更多内存和 CPU；如果内容索引无法分配内存，请调小。
ffmpeg_max_parallelism限制视频视觉搜索和预览可并行执行的 FFmpeg 任务数。保持 null 时自动选择；媒体索引造成 CPU 或内存压力时可调低。
ocr_max_parallelism限制可并行执行的 OCR 提取任务数。保持 null 时自动选择；设备 CPU 或内存有限时可调低。
hide_console_on_startup在支持的环境中控制启动 FilePulse 时是否隐藏控制台窗口。
native_log_enabled控制原生侧日志，方便排查启动、快捷键或桌面集成相关问题。
instance_policy.allow_multi_filepulse控制是否允许同时运行多个 FilePulse 服务实例。
instance_policy.allow_multi_native控制是否允许同时运行多个桌面原生助手实例。
boot_root_autostart_enabled控制开机或登录后自动启动相关设置，需要 FilePulse 随系统启动时使用。
password / last_password_change / saved_system_password敏感或由系统维护的字段，请不要手动修改；账号密码和系统密码保存应通过 FilePulse 设置界面操作。
设置导入/导出可以连同 config.json、共享、同步、LLM、内容规则、远程服务器和搜索工作区数据一起迁移。本节只说明 config.json，因为其他文件更适合在 Web 界面中管理。
如果机器从睡眠等状态恢复后出现 FilePulse 自行关闭，这通常不是程序故障，而是 FilePulse 的联网验证在终端进入睡眠等状态后中断，程序因此自动退出。重新启动 FilePulse 即可。
如果搜索内容构建的时候无法分配内存，是max_batch设置过大，只需要修改config.json文件，将max_batch设置为更小的值即可。然后重新运行。
如果搜索内容就构建卡住了，可以把rules.json里面的rules里面条目都删掉，相当于清理掉所有的规则，然后重新运行。
构建结果在index目录下，可以随时删掉目录，重新构建，个人建议不要构建过大的纯文本，比如一个word文档500MB，但是里面大多是图片不会有问题，但是如果一个500MB的纯文本文件，内容是纯文字，那么搜索系统可能会花费很长的时间构建。而且这么大的纯文本文件在构建期间会花费巨量内存。