# 🚀 快速开始 - 打包版本

## ✅ 包已成功构建!

当前版本: **v1.1.0**

生成的文件:
- `dist/bilibili_dl-1.1.0-py3-none-any.whl` (18KB) - Wheel 包
- `dist/bilibili-dl-1.1.0.tar.gz` (21KB) - 源码包

---

## 📦 三种安装方式

### 1️⃣ 从本地 Wheel 包安装(推荐)

**最快速、最可靠的安装方式**

```bash
# 直接安装
pip install dist/bilibili_dl-1.1.0-py3-none-any.whl

# 或者指定用户安装
pip install --user dist/bilibili_dl-1.1.0-py3-none-any.whl
```

### 2️⃣ 从本地源码包安装

```bash
pip install dist/bilibili-dl-1.1.0.tar.gz
```

### 3️⃣ 开发模式安装

**开发调试时使用,修改代码会立即生效**

```bash
# 进入项目目录
cd /Users/kc/Documents/ai/generate-report

# 以可编辑模式安装
pip install -e .
```

---

## ✅ 验证安装

安装完成后,测试命令是否可用:

```bash
# 查看版本
bili-dl --version
# 或
bilibili-dl --version

# 查看帮助
bili-dl --help
```

**预期输出:**
```
bili-dl version 1.1.0
```

---

## 🎯 使用示例

### 1. 登录 B 站

```bash
# 扫码登录
bili-dl login

# 或手动导入 Cookie
bili-dl import-cookie
```

### 2. 下载视频

```bash
# 使用 BV 号下载
bili-dl download BV1ms4y1Y76i

# 指定清晰度
bili-dl download BV1ms4y1Y76i --quality 1080p

# 同时下载封面
bili-dl download BV1ms4y1Y76i --with-cover
```

### 3. 查看视频信息

```bash
bili-dl info BV1ms4y1Y76i
```

---

## 🗑️ 卸载

```bash
pip uninstall bilibili-dl
```

---

## 📂 下载目录

安装后,视频默认下载到:

```bash
# macOS/Linux
~/Downloads/bilibili/

# Windows
C:\Users\你的用户名\Downloads\bilibili\
```

目录结构:
```
bilibili/
└── 2026-02-27/
    └── BV1ms4y1Y76i_细胞聚团原因剖析/
        ├── 细胞聚团原因剖析.mp4
        ├── BV1ms4y1Y76i_video.m4s
        ├── BV1ms4y1Y76i_audio.m4s
        └── BV1ms4y1Y76i_cover.jpg
```

---

## 🔧 高级功能

### 批量下载

创建 `videos.txt`:
```
BV1ms4y1Y76i
BV1abc123def
BV1xyz789
```

然后:
```bash
cat videos.txt | while read bv; do bili-dl download $bv; done
```

### 自动合并视频

如果需要手动合并音视频:

```bash
# 安装 ffmpeg(如未安装)
# macOS: brew install ffmpeg
# Ubuntu: sudo apt install ffmpeg

# 使用项目自带的合并工具
cd /Users/kc/Documents/ai/generate-report
python3 merge_video.py ~/Downloads/bilibili/
```

---

## 🆘 故障排除

### 问题1: 命令找不到

```bash
# 检查安装路径
pip show bilibili-dl

# 添加到 PATH
export PATH="$HOME/.local/bin:$PATH"

# 或使用 python -m 方式
python3 -m bilibili_dl.cli --help
```

### 问题2: 权限错误

```bash
# 使用用户安装
pip install --user dist/bilibili_dl-1.1.0-py3-none-any.whl
```

### 问题3: 依赖缺失

```bash
# 手动安装依赖
pip install -r requirements.txt
```

---

## 📊 与源码运行对比

| 特性 | 源码运行 | 安装包 |
|------|---------|--------|
| **安装方式** | `./bili-dl.py` | `bili-dl` |
| **路径依赖** | ✅ 需要在项目目录 | ❌ 任意目录可用 |
| **命令简洁** | ❌ 需要完整路径 | ✅ 全局命令 |
| **更新方式** | `git pull` | `pip install --upgrade` |
| **适用场景** | 开发调试 | 日常使用 |

---

## 🎉 安装完成!

现在你可以在任何目录直接使用 `bili-dl` 命令了!

```bash
# 任意目录下使用
cd ~
bili-dl download BV1ms4y1Y76i

cd /tmp
bili-dl info BV1abc123
```

---

## 📖 更多文档

- **完整使用手册**: [README.md](README.md)
- **打包发布指南**: [BUILD_AND_PUBLISH.md](BUILD_AND_PUBLISH.md)
- **故障排除**: [TROUBLESHOOTING.md](TROUBLESHOOTING.md)
- **目录结构说明**: [DIRECTORY_STRUCTURE.md](DIRECTORY_STRUCTURE.md)

---

**享受便捷的视频下载体验!** 🚀
