VidBee全平台部署指南：从环境配置到功能精通

VidBee作为一款开源视频工具，支持从全球几乎任何网站下载视频，本文将提供多系统安装的详细步骤，帮助您快速实现跨平台部署并掌握核心功能。无论您使用Windows、macOS还是Linux系统，都能通过以下指南轻松上手这款强大的视频下载工具。

🔧 环境准备：系统兼容性自检与配置

在开始部署VidBee前，我们需要确保系统环境满足基本要求。就像为工具配备专用零件一样，正确的环境配置是顺利使用VidBee的基础。

如何检测系统兼容性？

执行以下环境检测命令，快速确认您的系统是否满足安装条件：

node -v && pnpm -v

[!TIP] 系统需满足Node.js 18+和pnpm 8+。若未安装这些依赖，可访问Node.js官方网站下载安装Node.js（会自动安装npm），然后通过npm install -g pnpm命令安装pnpm。

环境配置三步曲

通过以下命令完成基础环境配置：

# 安装核心依赖
pnpm install

# 验证安装结果
pnpm list --depth=0

📱 多平台极速部署：Windows/macOS/Linux安装指南

本章节将介绍三种主流操作系统的部署方法，让您体验VidBee的跨平台兼容特性。我们采用预构建包安装作为主要方式，将克隆仓库方式作为可选高级安装方案。

Windows系统部署

# 安装应用
pnpm install

# 构建Windows版本
pnpm build:win

# 启动应用
pnpm start

构建完成后，可在dist目录找到生成的可执行文件。

macOS系统部署

# 安装应用
pnpm install

# 构建macOS版本
pnpm build:mac

# 启动应用
pnpm start

Linux系统部署

# 安装应用
pnpm install

# 构建Linux版本
pnpm build:linux

# 启动应用
pnpm start

可选高级安装：源码编译方式

如果您需要自定义构建或参与开发，可以通过以下方式克隆仓库并编译：

git clone https://gitcode.com/GitHub_Trending/vi/VidBee
cd VidBee
pnpm install
pnpm build

更多高级参数配置可查看docs/advanced.md。

🚀 增强功能体验：界面介绍与浏览器扩展

成功安装VidBee后，让我们一起探索其核心功能和增强体验方式。

主界面功能概览

VidBee的主界面简洁直观，主要包含以下功能区域：

• 视频URL输入框：用于粘贴要下载的视频链接
• 一键下载按钮：使用默认设置直接下载视频
• 下载队列：显示当前正在下载、已完成和出错的任务

下载任务管理

当您添加多个下载任务时，下载队列会清晰地展示每个任务的进度和状态：

浏览器扩展安装与使用

安装浏览器扩展后，您可以在浏览网页时快速下载视频：

1. 进入扩展目录：cd extension
2. 安装依赖：pnpm install
3. 构建扩展：pnpm build
4. 在浏览器中打开扩展管理页面，启用"开发者模式"，加载extension/dist目录

安装完成后，浏览视频网站时会看到"Download with VidBee"按钮：

❓ 问题诊断：常见问题与解决方法

如何解决依赖安装错误？

如果安装依赖时出现错误，请确保Node.js和pnpm版本符合要求。可以尝试删除node_modules目录和pnpm-lock.yaml文件，然后重新运行pnpm install。

如何解决构建时缺少ffmpeg或yt-dlp的问题？

VidBee需要ffmpeg和yt-dlp来处理视频下载和转换。您可以手动下载这些工具，放在resources/ffmpeg/目录下，或设置YTDLP_PATH和FFMPEG_PATH环境变量指向已安装位置。

浏览器扩展无法连接到VidBee应用怎么办？

请确保VidBee桌面应用正在运行，且没有防火墙阻止扩展与应用的通信。如问题持续，可尝试重新安装扩展或重启浏览器。

通过以上步骤，您已完成VidBee的全平台部署并掌握了基本使用方法。如需了解更多高级功能和定制选项，请查阅项目文档或参与社区讨论。