先不用装
只拖拽本地文件、切换输出目录，或粘贴普通公开链接时，桌面端已经够用。
浏览器扩展
你可以先只使用 Ameow 桌面端。浏览器扩展是可选增强，用来把网页里的任务、页面上下文、Cookies 和部分下载偏好发送给正在运行的桌面端。
[示意图：网页页面、浏览器扩展、本地 Ameow 桌面端之间的连接关系]
先判断要不要装
Section titled “先判断要不要装”建议安装
网页能播放但复制链接失败、内容需要登录态或 Cookies，或你要从当前页面资源里选择媒体。
可独立下载直链
桌面端未连接时，扩展可以用浏览器下载器保存普通图片、音频、视频直链和文件直链。
最短使用路径
Section titled “最短使用路径”- 先安装并启动 Ameow 桌面端。
- 从 GitHub Release 下载同版本的
Ameow_<version>_browser_extension.zip。 - 解压扩展 zip。
- 在 Chrome 或 Edge 的扩展管理页开启开发者模式。
- 点击
Load unpacked，选择解压后的扩展目录。 - 打开扩展弹窗。若桌面端已运行，确认状态为
Connected；若未运行，普通直链仍可由浏览器下载器兜底。 - 进入具体视频页、帖子页、作品页或图片详情页，再通过扩展发送任务。
[截图：浏览器扩展弹窗显示 Connected 状态、当前页面资源和 2x2 快捷按钮]
成功状态：扩展弹窗显示 Connected，Ameow 桌面端正在运行，网页发送任务后桌面端能看到下载状态或队列变化。
Connected 和 Disconnected 是什么意思？
Section titled “Connected 和 Disconnected 是什么意思？”Connected：扩展已经连上本机 Ameow 桌面端，可以发送任务。Disconnected：扩展没有连上桌面端。普通直链资源仍可尝试由浏览器下载；带有[桌面端]标记的资源需要先启动桌面端。
从网页发送任务时会发生什么？
Section titled “从网页发送任务时会发生什么？”当你在支持站点页面上使用扩展入口时，扩展会把当前页面相关信息发送给 Ameow。桌面端负责创建下载任务、显示进度、写入输出目录，并根据你的下载质量偏好处理格式。
你应该看到：
- 扩展侧保持
Connected。 - 桌面端出现任务状态，例如准备中、下载中、转换中、完成或失败。
- 完成后文件进入当前输出目录。
如果网页内容需要登录态，请先确认你在浏览器里已经登录该站点，再从扩展发送任务。你也可以在桌面端启用“下载时自动同步登录态”，之后 Ameow 会在下载匹配站点时尝试按站点同步 Cookies，而不是在启用时同步所有站点。
弹窗里的快捷按钮
Section titled “弹窗里的快捷按钮”扩展弹窗在当前页面资源列表下方提供 4 个快捷入口：
下载设置：打开弹窗内抽屉，只调整默认下载质量。拾取下载：进入页面拾取模式。点击网页中要下载的内容；右键或按Esc取消。登录态：打开弹窗内抽屉，顶部可以同步或启用当前站点登录态，下方只显示你已经主动同步过的站点。帮助文档：打开本页面。
登录态抽屉是信息展示和当前页同步入口，不是桌面端“站点登录态”设置页的完整复刻。扩展不会接管桌面端的下载能力，也不会把所有支持站点都列出来；未同步过的站点不会显示在这个小列表里。
[桌面端] 标记是什么意思？
Section titled “[桌面端] 标记是什么意思？”扩展弹窗里的资源行如果没有额外标记，通常表示扩展可以在桌面端离线时直接调用浏览器下载器保存这个资源。
如果资源旁边显示橙色 [桌面端] 标记，表示它需要或更适合由桌面端接管，例如：
- 需要登录态、Cookies 或站点解析；
m3u8、mpd、分片流、blob:等浏览器无法直接保存成完整文件的资源；- 高清视频、音视频分离或需要合并/转码的下载。
桌面端已连接时，扩展默认仍把下载交给桌面端处理。桌面端未连接时，只有没有 [桌面端] 标记的直链资源会走浏览器下载兜底。
浏览器兜底下载会交给浏览器自己的下载管理器；扩展弹窗不额外显示完成提示，最终开始、完成、失败或冲突处理以浏览器下载栏/下载页面为准。
可以把能力边界理解成：扩展负责识别和保存“已经是完整文件”的普通直链；桌面端负责需要解析、登录态、高清轨道、合并、转码或后处理的下载。
“当前页面资源”怎么用？
Section titled ““当前页面资源”怎么用？”扩展弹窗扫描的是当前活动标签页里已经打开的页面资源。除了页面 DOM 里的 <video>、<audio>、<img>、链接和浏览器 performance 记录，扩展后台也会被动记录最近的媒体响应，并在你刷新弹窗扫描结果时合并进去。
扫描结果可以直接在弹窗里检查：普通视频资源可展开原生播放器预览，音频可试听，图片会以缩略图网格展示格式和分辨率，点击图片缩略图可以在弹窗内放大查看。资源详情优先显示格式、大小、时长、分辨率等媒体信息，而不是内部来源链接。带有 [桌面端] 标记的复杂资源仍需要桌面端接管下载。
这个后台发现只保存有限的媒体候选元数据，例如 URL、媒体类型、Content-Type、Content-Length、标签页和页面 URL、捕获时间。它不会保存请求头、Cookies、Referer 或响应内容；缓存也会按时间、标签页和总数量自动裁剪。
它最适合这些页面：
- 具体视频页、帖子页、作品页或图片详情页。
- 目标内容已经加载完成，并且你能在浏览器里正常播放或查看。
- 你想从当前页面里挑一个更准确的媒体资源发送到 Ameow。
不建议直接在首页、推荐流、搜索结果页、作者主页、合集页或列表页上判断是否支持。那些页面往往同时包含当前卡片、旁路推荐、预加载封面和其他媒体请求，弹窗看到的不一定是你想要的资源。
更稳的做法是：先点进具体内容页，再打开扩展弹窗或页面内入口发送任务。
支持哪些浏览器？
Section titled “支持哪些浏览器？”当前扩展面向 Chromium 内核浏览器，例如 Chrome 和 Edge。安装方式使用开发者模式下的 Load unpacked。如果你的浏览器不支持加载 Manifest V3 扩展，可能无法使用。
扩展需要读取当前网页资源、调用浏览器下载器，并被动观察网页里的媒体响应。因此更新扩展时，浏览器可能提示新增下载或网络请求相关权限。这些权限用于识别当前标签页里的可下载候选，不会让扩展上传你的 Cookies 或登录态内容。
我把 zip 直接选进浏览器了，为什么失败？
Section titled “我把 zip 直接选进浏览器了，为什么失败？”浏览器需要选择解压后的扩展目录，而不是 zip 文件本身。先解压，再选择包含扩展 manifest 的文件夹。
扩展装好了但显示 Disconnected
Section titled “扩展装好了但显示 Disconnected”如果要下载带 [桌面端] 标记的资源，先启动 Ameow 桌面端，再重新打开扩展弹窗。如果仍未连接，重新加载扩展并重启 Ameow。防火墙或安全软件也可能阻止本地连接。普通直链资源可以在离线状态下由浏览器下载器兜底。
网页里没有下载入口
Section titled “网页里没有下载入口”确认当前站点和页面类型在支持范围内。优先在具体内容页上尝试，不要先在首页、推荐流、搜索结果页或合集页判断“扩展没反应”。站点支持会随版本变化，页面改版、登录限制、会员限制、地区限制都可能影响结果。
下一步：
- 需要逐步安装：阅读 安装扩展。
- 连接不稳定：阅读 连接桌面端。
- 站点失败：阅读 支持站点 和 Cookies 与登录态。