如何使用哔哩下载姬（DownKyi）：超详细视频下载工具安装与配置教程

哔哩下载姬（DownKyi）是一款功能强大的哔哩哔哩视频下载工具，支持批量下载8K、HDR及杜比视界视频，并提供音视频提取、去水印等实用工具箱功能。本教程将从环境准备到高级配置，全方位指导你完成软件的部署与使用。

一、开发环境搭建指南

1.1 基础依赖安装

💡 核心环境要求：该项目基于C#开发，需先安装.NET Framework运行时环境以支持程序执行。访问微软官方网站下载对应版本的.NET Framework安装包，按照向导完成基础环境配置。

1.2 辅助工具准备

⚠️ 必备组件：

• FFmpeg：用于视频混流与音视频处理的开源工具，需从官网获取适合系统的可执行文件
• Aria2：轻量级多线程下载器，提供高效的分片下载能力，需下载对应平台的二进制包

二、项目源码部署流程

2.1 源码获取与准备

通过Git工具克隆项目仓库到本地工作目录：

git clone https://gitcode.com/gh_mirrors/do/downkyi

进入项目根目录后，使用NuGet包管理器还原依赖项：

cd downkyi
dotnet restore

2.2 第三方工具配置

在项目根目录创建third_party文件夹，将下载的FFmpeg和Aria2可执行文件重命名为ffmpeg.exe和aria2c.exe后放入该目录。此步骤确保程序能正确调用外部工具进行视频处理和下载任务。

三、项目编译与运行教程

3.1 项目编译方法

使用Visual Studio或Rider等C#开发环境打开项目解决方案文件，在解决方案资源管理器中右键点击项目，选择"生成"选项。命令行用户可执行：

dotnet build

3.2 程序启动方式

编译成功后，可通过开发环境直接运行程序，或在项目根目录执行命令行启动：

dotnet run

首次启动时会自动检测必要组件，并引导完成初始配置向导。

四、高级功能配置技巧

4.1 下载参数优化

在程序设置界面可调整以下关键参数：

• 下载线程数：建议设置为CPU核心数的2-3倍以获得最佳性能
• 存储路径配置：选择剩余空间充足的磁盘分区作为默认下载目录
• 视频质量偏好：可预设默认下载清晰度，支持自动选择最高可用画质

4.2 故障排除方案

⚠️ 常见问题处理：

• 下载失败：检查Aria2可执行文件是否存在于third_party目录，尝试临时关闭防火墙后重试
• 混流异常：验证FFmpeg路径配置正确性，可通过命令行执行ffmpeg -version测试工具可用性
• 界面卡顿：在设置中降低同时下载任务数量，减少系统资源占用

五、功能扩展与工具使用

5.1 工具箱功能介绍

程序内置实用工具集：

• 音视频提取：可单独保存视频中的音频流或视频流
• 水印去除：支持对下载的视频进行水印清理处理
• 格式转换：提供多种输出格式选择，满足不同设备播放需求

5.2 批量下载操作

在主界面使用"添加批量任务"功能，可通过UP主主页URL或视频合集链接，一次性添加多个下载任务，并支持按发布时间、播放量等条件筛选内容。

通过以上步骤，你已完成哔哩下载姬的完整配置。如需获取更多高级使用技巧，可参考项目根目录下的guide.md文档，或在程序内通过"帮助"菜单访问在线教程。