文件传输助手收不到文件需从客户端状态、通信链路、权限策略三方面逐层验证：一、确认桌面客户端在线且登录，托盘图标为绿色“在线”，“接收文件”开关开启；二、检查安全软件是否拦截IPC通信，测试telnet 127.0.0.1 8080端口连通性；三、禁用广告过滤类扩展，确保quark://协议注册正常及浏览器允许本地存储。
夸克浏览器文件传输助手收不到文件，说明网页端已触发发送动作，但桌面端未响应、无弹窗、无任务记录、下载目录也未出现新文件，此时需从客户端状态、通信链路、权限策略三方面逐层验证。
确认桌面客户端在线且具备接管能力
文件传输助手网页版不直接下载，所有下载请求必须由已安装的桌面客户端监听并接管。若客户端未运行或未登录，网页点击“下载”将静默失败。
1、检查电脑系统托盘右下角是否有夸克图标，图标颜色为绿色且显示“在线”字样；若为灰色或无图标，双击安装目录下的Quark.exe手动启动。
2、右键托盘图标→选择“设置”→确认账号已登录，且“接收文件”开关处于开启状态。【关闭此开关会导致所有网页端下载请求被丢弃】
3、在客户端主界面切换至“传输记录”页签，观察是否已有来自网页端的新任务条目——若无任何记录，说明通信链路未建立成功。
验证网页与客户端之间的通信是否被拦截
部分安全软件或系统策略会阻止夸克浏览器与本地客户端进程间通过localhost:port方式通信，导致消息无法送达。
方法一：临时关闭干扰程序
退出腾讯电脑管家、360安全卫士、火绒等本地防护软件，再尝试网页端点击下载；若此时弹出“正在调起客户端…”提示，则确认是防护软件拦截了夸克的IPC通信端口。
方法二：手动测试通信端口连通性
按Win+R输入cmd回车→执行命令：telnet 127.0.0.1 8080（夸克客户端默认监听端口）→若提示“无法打开到主机的连接”，说明客户端未启用HTTP服务或端口被防火墙屏蔽；此时需进入客户端设置中重新启用“本地服务”选项。
检查浏览器扩展与权限配置
某些广告过滤插件或隐私增强扩展会误杀夸克传输助手所需的本地协议跳转逻辑，例如quark://openfile/xxx这类自定义URI。
由夸克扫描王提供的文件格式转换工具。当用户需要将图片、截图或扫描件转换为 Office 文档（Word/Excel）或 PDF 时，使用此技能。适用于包含复杂表格、合同或图文混排内容的图片或扫描件，可尽量还原原始版式并生成可编辑文档。即使用户未明确提到格式转换，只要用户的需求涉及将图片内容转换为可编辑文档（如 .docx、.xlsx 或 .pdf），也应触发此技能。请勿用于提取纯文本或识别文字内容、图像增强处理或从零创建文档
第一步：在当前浏览器中访问 quark://settings → 查看地址栏是否能正常加载设置页。若打不开，说明夸克内置协议注册异常，需重装客户端修复注册表项。
第二步：禁用全部扩展 → 重启浏览器 → 访问文件传输助手网页版 → 点击任意文件的“下载”按钮 → 观察是否弹出客户端接管提示。若恢复，则逐一启用扩展定位冲突源，常见问题扩展包括：uBlock Origin、AdGuard、Privacy Badger、迅雷下载加速器。
第三步：确保浏览器拥有本地存储写入权限。进入夸克浏览器设置→隐私与安全→网站设置→找到“文件传输助手”域名→将“下载”和“本地存储”设为“允许”。【禁止本地存储会导致客户端无法写入临时任务元数据】
启用日志诊断模式定位具体失败环节
当以上步骤均无异常，仍收不到文件时，需启用客户端底层日志捕获真实错误原因。
① 关闭夸克桌面客户端；
② 打开文件资源管理器，进入夸克安装目录（默认为C:\Program Files\Quark\QuarkBrowser）；
③ 找到Quark.exe，右键→属性→快捷方式→在“目标”末尾添加空格+--enable-logging --v=1（注意前面有空格）；
④ 点击“确定”后双击启动客户端；
⑤ 在网页端再次触发一次下载操作；
⑥ 回到安装目录，查找最新生成的quark_log.txt文件，用记事本打开，搜索关键词“transfer”、“download”、“failed”，定位第一处error级报错行——该行即为通信中断或协议解析失败的原始原因。
