如果你在使用谷歌浏览器下载文件后，希望它能自动触发一个本地脚本——比如自动重命名、移动到指定文件夹、校验文件完整性，或者干脆给你发个通知——你会发现浏览器本身并没有提供“下载完成回调”这种原生支持。这确实是个痛点，但别担心，办法总比困难多。要实现这个自动化目标，核心思路就是借助外部机制来“感知”下载动作的完成。下面，我们就来详细拆解几种主流的实现方案，你可以根据自身的技术环境和需求灵活选择。

一、通过Chrome扩展监听downloads API

这是最“原生”、与浏览器集成度最高的方式。Chrome 为扩展程序提供了强大的 chrome.downloads API，允许你直接监听下载状态的变化。

操作步骤大致如下：

首先，你需要创建一个 Chrome 扩展。这离不开核心的 manifest.json 文件，你需要在其中声明必要的权限（特别是 "downloads" 和 "downloads.shelf"）并指定后台脚本。

接着，在后台脚本（例如 background.js）中，监听 chrome.downloads.onChanged 事件。这个事件会报告下载项的各类变化，你需要从中筛选出状态变为 "complete" 的事件。

一旦捕获到下载完成事件，你就可以在事件处理函数里大展拳脚了。通常，下一步是通过 chrome.runtime.sendNativeMessage 方法，将下载文件的路径等信息发送给一个预先在本地注册好的程序（Native Host），由这个本地程序来执行实际的脚本操作。

二、使用Native Messaging配合本地脚本

上面提到的 Native Host 是什么？这其实就是“Native Messaging”机制的一部分。它能让 Chrome 扩展安全地与本地安装的可执行程序进行通信，从而突破浏览器的沙箱限制，直接调用 Python 脚本、Shell 命令或任何二进制程序。

具体配置流程：

第一步，编写你的本地处理脚本（比如用 Python 写的 download_handler.py），让它能够接收标准输入（JSON格式）并执行文件移动、重命名、校验等操作。

第二步，创建一个清单文件（例如 com.example.downloadhandler.json），在其中指明本地脚本的路径，并规定允许连接它的 Chrome 扩展 ID。

第三步，将这个清单文件复制到系统特定的目录中完成注册：

• Windows：%LOCALAPPDATA%GoogleChromeUser DataNativeMessagingHosts
• macOS：~/Library/Application Support/Google/Chrome/NativeMessagingHosts/
• Linux：~/.config/google-chrome/NativeMessagingHosts/

最后，在扩展的 background.js 里，当下载完成时，使用 chrome.runtime.sendNativeMessage 并传入下载项的关键信息（如 filename、sa veAsFilename）即可触发本地脚本。

三、轮询监控默认下载目录

如果你觉得创建扩展太麻烦，或者希望有一个更轻量、不依赖浏览器扩展的独立方案，那么直接监控下载目录是个不错的选择。思路很简单：运行一个守护进程，定期检查 Chrome 的默认下载文件夹里有没有出现“新鲜出炉”的文件。

如何实现：

首先，确定 Chrome 的默认下载路径，通常就是系统标准的“下载”文件夹：

• Windows：%USERPROFILE%Downloads
• macOS/Linux：~/Downloads

然后，编写一个监控脚本。使用 Python 的 watchdog 库可以优雅地监听目录的 Created 和 Modified 事件。这里有个关键点：浏览器下载文件时可能会先创建临时文件（如 .tmp 后缀），写入完成后再重命名。因此，检测到新文件后最好加入一个短暂的延迟（比如1秒），并确认文件大小稳定、没有临时后缀，再判定为下载完成。

接下来，脚本可以根据文件的扩展名或读取到的 Content-Type 信息，匹配你预设的处理规则。例如，遇到 .zip 文件就自动解压，遇到 .pdf 就调用 OCR 转换文字。

处理完毕后，建议将文件移到一个如 processed/ 的子目录中，这样可以有效避免对同一文件进行重复处理。

四、利用Chrome启动参数配合外部调度器

最后这种方法更适合自动化测试或 CI/CD 等受控环境。其核心是通过特殊参数启动 Chrome，并利用远程调试协议，由外部进程（如 Selenium、Puppeteer）完全控制浏览器的下载行为。

实施步骤：

首先，确保关闭所有 Chrome 实例，然后通过命令行启动一个可被远程控制的 Chrome 进程：

google-chrome --remote-debugging-port=9222 --user-data-dir=/tmp/chrome-test-profile

接着，使用自动化工具（如 Puppeteer）连接到 localhost:9222 这个调试地址。你可以通过 Page.setDownloadBeha vior 方法，将下载行为设置为允许（"allow"），并指定一个明确的下载路径。

之后，当你的脚本通过 Page.na vigate 触发下载后，可以立即在同一个脚本中启动一个文件监控线程，专门等待指定下载路径中间出现目标文件。

一旦文件出现并稳定，你就可以执行后续的定制化脚本逻辑。完成后，可以选择关闭这个 Chrome 页面或整个实例，以保持每次任务的隔离性和清洁。

《夸克》非常好用的免费AI浏览器

下载APP查看