LUFFY / VIDEO v0.4.4

看到的视频，
留在自己手里。

发现、预览、下载。打开网页就能用，也可以交给本地 Agent。无需账号，视频在本机处理。

下载插件 ZIP ↓查看安装教程 ↘

手动安装 · 当前未在扩展商店上架

Chrome / Edge；YouTube、X 与 MCP 的本机助手目前仅支持 macOS。

GitHub 源码 ↗

网页视频

直链、HLS 分段视频，在列表里预览并选择下载。

本机处理

浏览器内合并 HLS；YouTube / X 可交给本机助手解析。

Agent 也能用

通过 MCP 查看当前页面、下载视频和查询保存路径。

01 / INSTALL

从压缩包安装

不需要自己编译。按下面四步，将插件加载到浏览器。首次安装约需几分钟。

下载并解压

点击上方「下载插件 ZIP」，解压 Luffy-Video-Download-Helper-0.4.4.zip。里面有 extension/、native/ 和安装说明。不要选择 GitHub 自动生成的 Source code 压缩包，它需要自行构建。

打开扩展管理页

在 Chrome 地址栏粘贴 chrome://extensions；Edge 使用 edge://extensions。打开页面上的「开发者模式」。

加载 extension 文件夹

点击「加载已解压的扩展程序」，选择解压目录里的 extension 文件夹，不是 ZIP，也不是最外层文件夹。把这个目录保留在固定位置，浏览器之后仍会读取它。

固定插件，播放视频

在工具栏扩展菜单中固定 Luffy。打开目标网页并播放视频，再点击 Luffy。默认显示「发现视频」；没有结果时点击「重新扫描」或刷新原网页再播放。

解压后选择这一层

Luffy-Video-Download-Helper-0.4.4/
├── extension/ ← 加载已解压的扩展程序
├── native/
├── Install-Luffy-Helper.command
└── README.md

02 / LOCAL HELPER

YouTube / X / MCP：安装本机助手

只下载普通直链或浏览器内 HLS 时，可跳过这一步。本机助手安装器目前支持 macOS，需要 Python 3.10+、Node.js、FFmpeg。

如果尚未安装依赖，可先用 Homebrew 运行下面的命令。然后在解压后的目录双击 Install-Luffy-Helper.command，等待「安装完成」。也可在终端进入该目录运行 python3 native/install.py。首次安装需要联网。

brew install python node ffmpeg

安装后刷新扩展；更新旧助手后如仍提示「未知操作」或版本过旧，请重启浏览器。普通浏览器下载遵循浏览器保存设置；本机下载默认保存在 ~/Downloads/Luffy/。

03 / AGENT ACCESS

让本地 Agent 来下载

打开「MCP 服务」Tab，点击「开启服务」。
点击「复制安装说明，发给 Agent」，把完整说明粘贴给你的本地 Agent。
手动配置时，直接查看下方 JSON 框并点击「复制 JSON」。按客户端提示重新连接。
让 Agent 先列出当前页面的视频，指定一个下载，再查询任务直到完成。

绿色：正常运行 · 灰色：未开启 · 红色：异常。服务默认关闭，开关会记住选择。

“用 Luffy 查看当前页面的视频，下载我选中的那个，完成后告诉我保存路径。”

04 / FAQ

使用前，了解这些

更新时怎么做？

下载新版并解压到固定目录，再在扩展管理页刷新插件。如果更换了路径，移除旧扩展后重新加载新目录；新路径安装可能重置扩展设置。助手有更新时重新运行安装器。

为什么不能直接从商店安装？

当前采用 GitHub 压缩包分发，尚未提供商店安装入口。这里提供的是手动安装方式，不代表已经收到商店拒绝。

所有视频都能下载吗？

不支持 DRM、SAMPLE-AES 和直播。浏览器 HLS 输入上限为 256 MiB；大文件可尝试本机助手。DASH 已有本机入口但未专项验收。源站登录、地区和签名限制仍可能影响下载。

会读取浏览器登录状态吗？

默认不读取 Cookie。仅在下载设置里明确选择登录来源后，yt-dlp 才在本机读取相应浏览器 Cookie。

关闭弹窗或 MCP，下载会停止吗？

关闭弹窗不影响下载。关闭 MCP 会停止新的 Agent 调用，已开始的任务继续运行；任务记录保留至浏览器会话结束。

下载插件 ZIP ↓v0.4.4 · GitHub Release ↗

看到的视频，留在自己手里。