完整教程和参考
通过我们的综合指南学习如何有效使用 FilePulse，涵盖基本操作到高级配置。
如何首次运行 FilePulse
FilePulse 可运行在 Windows、macOS 和 Linux。默认本地 Web 控制台使用 80 和 443 端口；如果端口被占用，或你的环境需要不同网络设置，请在启动前调整 config.json。
如需更改端口，请修改 config.json 文件
Windows 下如需磁盘索引、文件操作或绑定低端口，请以管理员权限运行 FilePulse.exe。macOS 和 Linux 请按照下载页中对应包类型的启动指引运行。
FilePulse.exe打开浏览器，访问 http://127.0.0.1 然后输入默认用户名和密码都是"root"即可进入系统
http://127.0.0.1用户名：root，密码：root下载程序后如果FilePulse.exe图标上显示一个盾牌，请将其放置到其他文件夹直到没有盾牌为止，否则会影响以普通权限打开某一个目标，如果你不需要这个功能可以忽略。
如果以普通方式运行，程序会自动切换至管理员权限，但是请不要在FilePulse.exe属性的兼容性标签中设置以管理员身份运行此程序，如果设置兼容性将会和前面提到的一样无法使用普通权限打开某一目标，如果你不需要这个功能可以忽略。
如果出现"卷更改日志处于非活动状态"则说明有一个盘符有问题，你需要修改config.json将drive_list移除有问题的盘符。
版本升级后最好将新下载的FilePulse单独放到一个新文件夹，以免旧的配置和新的配置冲突。
软件目前加了壳，可能会引起杀毒软件误报，请将FilePulse.exe添加为白名单即可解决。
探索 FilePulse 的主要功能
类似everything，带有各种复杂筛选条件，主要用于用户的复杂搜索，可以毫秒级响应
可搜索文本、Office 文档、PDF、电子书、网页，以及通过 OCR 识别的图片内容。截图、扫描 PDF、文档内嵌图片中的文字在索引后也可以被检索。
支持使用图片、截图或视频作为查询，查找视觉相似图片和匹配的视频片段，并查看缩略图、路径、服务器和目标时间段。
类似listary，输入关键字结果提前按照大多数习惯排序过，快速定位目标位置并启动
按大小与特征快速比对重复文件，安全复核后高效清理冗余。
支持文档、电子书、压缩包、图片、音视频等格式的快速预览，并可进行远程下载、上传与定位。
本地与远程映射目录可持续自动同步，支持周期更新、稳定重连与删除记录追踪。
支持 LLM 配置管理、多会话持久化、图像上传与一键清空全部会话。
类似音速启动，提前将常用软件进行添加（由于采用浏览器，所以拖拽无法获得完整路径，目前需要输入，未来打造原生应用则可使用拖拽）
使用核心搜索与远程能力，启动面板在集群中为可选项。
支持通过快捷键在 Windows、macOS、Linux 自动带入当前文件管理器路径，并在 Windows 下衔接受支持的打开对话框，也可以继续细化当前搜索范围或返回上级范围。
支持通过持久化搜索注解、分组、置顶项、自定义排序、启动恢复和更顺滑的键盘导航来管理持续进行中的搜索任务。
从发现到远程自动同步、快速预览、AI会话、清理与交付，流程清晰可控。
通过筛选、正则、拼音快速定位目标。
检索文档文本与 OCR 识别出的图片文字，支持索引、评分排序、高亮与快速预览。
上传图片或视频，或直接粘贴截图，用于查找相似图片并定位匹配的视频片段。
按关键字秒开应用和文件夹。
快速找出重复文件，释放空间。
跨节点上传、下载、定位文件，远程操作顺畅。
本地与远程映射目录持续自动同步，更新更省心。
轻量预览文档、图片与多媒体内容。
支持上下文会话与图像上传，并保留历史会话。
需要协作时可生成共享入口，访问更便捷。
从当前文件夹更快进入搜索，并可继续手动细化范围或返回上级范围。
通过持久化注解、分组、置顶项、自定义排序和更顺滑的结果导航来持续整理复杂搜索任务。
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>
对应四种搜索模式：普通模式，正则表达式，前缀匹配，模糊匹配。其中模糊匹配性能最差，尽量避免使用。前缀匹配必须要有两个分词开始，而在简单表达式又以空格分隔，所以前缀匹配需要用高级表达式。
对应两种搜索模式：通配符搜索，正则表达式搜索。两者都是对所有需要查询的文件进行逐个匹配，性能会变差。
在登入界面直接的API Base URL中直接输入远程服务器的地址和端口号，例如 https://abc.com:443，然后输入用户名和密码即可连接到远程服务器。
Remote Servers中添加目标服务器的地址和端口号用户名和密码，系统会自动连接到目标服务器。http2和http3在写地址的时候用https://，http1.1用http://。
连接后需要将目标服务器的盘符挂载到本地盘符，点击Mount Servers，选择刚才连接的server name，在回调的地址写正在访问的服务器地址。
mount需要大约几秒根据目标服务器文件多少而定，完成后就可以搜索远程服务器的文件名和文件内容了，就像在本地一样，搜索远程文件内容会传输大量数据，建议使用score模式只取top10。
在 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。
重新启动计算机，并再次使用共享。
config.json 控制本地服务名称、登录、端口、索引位置、快捷键、启动行为和部分运行偏好。大多数用户只需要在默认环境不适合时调整端口、drive_list、hot_keys、多实例策略或启动选项。
端口、drive_list、hot_keys、多实例策略和启动选项适合手动调整。账号密码优先在 Web 界面中修改。修改端口、监听位置、快捷键或 max_batch 后，建议重启 FilePulse 让新设置稳定生效。
server_name本地 FilePulse 节点显示名称。使用远程节点或集群工作流时建议保持唯一，方便识别结果和远程操作来源。
username / password / last_password_change管理员登录信息，以及密码变更后用于让旧会话失效的时间戳。用户名和密码优先在 Web 界面中修改。
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；如果内容索引无法分配内存，请调小。
hide_console在支持的环境中控制启动 FilePulse 时是否隐藏控制台窗口。
native_log控制原生侧日志，方便排查启动、快捷键或桌面集成相关问题。
allow_multi_filepulse控制是否允许同时运行多个 FilePulse 服务实例。
allow_multi_native控制是否允许同时运行多个桌面原生助手实例。
boot_autostart控制开机或登录后自动启动相关设置，需要 FilePulse 随系统启动时使用。
设置导入/导出可以连同 config.json、共享、同步、LLM、内容规则、远程服务器和搜索工作区数据一起迁移。本节只说明 config.json，因为其他文件更适合在 Web 界面中管理。
如果机器从睡眠等状态恢复后出现 FilePulse 自行关闭，这通常不是程序故障，而是 FilePulse 的联网验证在终端进入睡眠等状态后中断，程序因此自动退出。重新启动 FilePulse 即可。
如果搜索内容构建的时候无法分配内存，是max_batch设置过大，只需要修改config.json文件，将max_batch设置为更小的值即可。然后重新运行。
如果搜索内容就构建卡住了，可以把rules.json里面的rules里面条目都删掉，相当于清理掉所有的规则，然后重新运行。
构建结果在index目录下，可以随时删掉目录，重新构建，个人建议不要构建过大的纯文本，比如一个word文档500MB，但是里面大多是图片不会有问题，但是如果一个500MB的纯文本文件，内容是纯文字，那么搜索系统可能会花费很长的时间构建。而且这么大的纯文本文件在构建期间会花费巨量内存。