LocalSend接收文件类型异常时，可通过五种方法解决：一、设置中开启“显示未知文件类型”并关闭“仅接收已知类型”；二、系统级关联目标扩展名至任意程序；三、编辑config.json禁用fileTypeFilter；四、启动时加--no-file-type-check参数；五、删除file_types.db缓存重建。

如果您在使用LocalSend接收文件时发现某些类型文件未被识别、无法预览或被自动忽略，则可能是由于LocalSend默认启用了文件类型过滤机制，或系统级文件关联策略限制了特定扩展名的处理行为。以下是针对该问题的多种进阶设置方法：

一、通过LocalSend设置界面禁用/调整文件类型过滤

LocalSend本身不提供图形化“白名单/黑名单”开关，但其接收逻辑依赖于底层文件类型识别模块（app/lib/util/file_type_ext.dart）与系统默认程序注册状态。用户可通过设置页面间接影响文件类型可见性与处理方式。

1、启动LocalSend客户端，点击右上角齿轮图标进入“设置”页面。

2、切换至“文件管理”选项卡（若未显示，请确认已更新至v1.9.0或更高版本）。

3、查找“显示未知文件类型”选项，将其切换为开启状态。

4、在“默认保存路径”下方，检查是否存在“仅接收已知类型文件”复选框；如存在，确保其处于未勾选状态。

5、完成设置后，无需重启应用，新配置将在下一次接收操作中即时生效。

二、修改系统级文件类型关联以扩展可接收范围

LocalSend在接收文件时会调用操作系统API查询某扩展名是否具有默认打开程序。若系统未注册对应程序，LocalSend可能跳过该文件类型或隐藏其图标。通过强制注册任意程序（包括LocalSend自身）可解除此限制。

1、准备一个测试文件，扩展名为需放开的类型（例如.psd、.cr2或.epub）。

2、在Windows系统中：右键该文件 → “打开方式” → “选择其他应用” → 勾选“始终使用此应用打开.xxx文件” → 选择“记事本”或“LocalSend”（若已出现在列表中）。

3、在macOS系统中：右键文件 → “显示简介” → 展开“打开方式”下拉菜单 → 选择“Other…” → 浏览并选中LocalSend.app → 勾选“全部更改”。

4、执行完毕后，LocalSend在下次扫描接收到的同类型文件时，将正确识别并显示该文件，且支持点击保存操作。

三、手动编辑LocalSend配置文件启用全扩展名支持

LocalSend v1.8.0+版本支持通过JSON配置文件覆盖默认文件类型过滤行为。该方法绕过UI限制，直接干预核心识别逻辑，适用于高级用户及批量部署场景。

1、定位LocalSend配置目录：
Windows路径为%APPDATA%LocalSendconfig.json；
macOS路径为~/Library/Application Support/LocalSend/config.json；
Linux路径为~/.config/LocalSend/config.json。

2、用文本编辑器打开config.json，查找"fileTypeFilter"字段；若不存在，则在根对象内新增该键值对。

'>

Suna

全球首个开源的通用型AI Agent项目

下载

3、将该字段设为："fileTypeFilter": {"enabled": false}。

4、保存文件，关闭并重新启动LocalSend客户端。

5、重启后，LocalSend将不再依据扩展名过滤接收文件，所有传入文件均会在接收列表中完整呈现。

四、利用命令行参数临时禁用类型校验

对于调试或一次性传输特殊格式文件（如自制工具生成的.bin、.dat等），可在启动LocalSend时附加运行参数，强制跳过文件类型合法性检查流程。

1、关闭正在运行的LocalSend进程。

2、在终端或命令提示符中执行以下命令：
Windows：localsend.exe --no-file-type-check；
macOS/Linux：localsend --no-file-type-check。

3、确认窗口标题栏或日志输出中出现[DEBUG] FileType checking disabled提示。

4、此时发起的任何接收任务都将忽略扩展名合法性验证，所有文件均可正常保存至指定路径。

五、重置LocalSend文件类型缓存数据库

LocalSend内部维护一个轻量级文件类型缓存（基于SQLite），用于加速扩展名匹配。当缓存损坏或残留旧规则时，可能导致部分类型被错误拦截。清除缓存可恢复原始识别行为。

1、完全退出LocalSend所有实例，包括后台服务进程。

2、导航至LocalSend数据目录：
Windows：%APPDATA%LocalSendcachefile_types.db；
macOS：~/Library/Caches/LocalSend/file_types.db；
Linux：~/.cache/LocalSend/file_types.db。

3、将file_types.db文件彻底删除（而非重命名）。

4、重新启动LocalSend，首次接收文件时将自动重建缓存，采用当前系统最新注册的文件类型信息。