# ⚠️ 安装前必读（Ubui 浏览器插件 v2.0.1）

## 关键：加载时必须选「本文件夹」，不是里面的子文件夹

```
Ubui-下载助手-v2.0.1\
└── ubui-cookie-ext\        ← ★ 选这个（有 manifest.json 的这一层）
    ├── manifest.json       ← 判断依据：有这个文件才是插件根目录
    ├── background.js
    ├── popup.html
    └── ffmpeg\             ← 不要选这里！只有 wasm 核心，会报「清单文件丢失」
        ├── ffmpeg-core.wasm
        └── ...
```

如果 Chrome 报 **「清单文件丢失或不可读取」**，99% 是选到了 `ffmpeg` 子目录。
往上退一级，选有 `manifest.json` 的那个文件夹即可。

---

## 安装步骤（3 步）

1. 打开 Chrome（或 Edge）→ 地址栏输入 `chrome://extensions/`
   （Edge 用 `edge://extensions/`）
2. 右上角打开 **「开发者模式」** 开关
3. 点 **「加载已解压的扩展程序」** → 在文件对话框里
   **选中 `ubui-cookie-ext` 这一层**（就是本文件夹）→ 「选择文件夹」

## 装好后

- 点浏览器右上角的拼图图标，找到 **Ubui 下载器**，点图钉固定
- 快捷键 `Alt+Shift+Y` 打开面板
- **不需要填后端地址、不需要填配对码**，会自动连接 ubui.cn 并自动配对

## 常见报错对照

| 报错 | 原因 | 解决 |
|---|---|---|
| 清单文件丢失或不可读取 | 选到了 `ffmpeg` 子目录 | 往上退一级，选有 manifest.json 的 `ubui-cookie-ext` |
| Insecure CSP value "https://unpkg.com" | 装的是 2.0.0 及更早版本 | 下载 v2.0.1 以上（已完全离线，不含任何远程代码引用） |
| 后端未运行（localhost:3000） | 浏览器里存着早期的本机地址 | v2.0.1 会自动丢弃；或到插件「选项」页把地址存为 `https://ubui.cn` |

---

版本号以插件页面显示为准（站点会实时读取安装包内 manifest.json 的 version）。
