DownKyi Core 是基于哔哩下载姬 Windows 版与 Avalonia 的跨平台 B 站视频下载工具。项目使用 .NET 11、Avalonia 12、Microsoft Generic Host、Microsoft DI 与 CommunityToolkit MVVM。
- Windows:
DownKyi-*-win-x64.zip或DownKyi-*-win-x86.zip - macOS:
DownKyi-*-osx-arm64.dmg或DownKyi-*-osx-x64.dmg - Linux:AppImage / deb / rpm
Windows ZIP 必须完整解压到新目录后再运行。DownKyi.exe 旁必须保留 ffmpeg 子目录;若程序报告文件不完整,请重新下载官方 Release 并完整解压,不要单独补放执行文件。
版本变化见 CHANGELOG.md,安装包见 GitHub Releases。
后续正式版本另提供 DownKyi-<版本>-verification.zip,集中保存各安装包原有的 .sha256 与 publish-manifest-*.json。需要验证时,将 ZIP 内容解压到下载的安装包所在目录,再使用对应文件核对安装包哈希和逐文件内容。
- 解析视频、合集、番剧、课程、收藏、历史记录和稍后再看等入口。
- 下载音频、视频、封面、弹幕、普通字幕和 AI 字幕。
- 桌面界面支持简体中文、繁體中文、English 和日本語;在「设置 → 基本 → 界面语言」选择,重新启动后生效。
- 内建下载器会按顺序规划文件分段,再以多连接并行下载,并保存严格校验的断点续传状态。
- 删除下载中任务时,同步停止下载器并清理已产生的媒体和临时文件。
- 导出会遮蔽认证凭据、URL 查询参数、邮箱、账号标识和文件路径的诊断日志,保留请求的网域与接口路径。
发布包已包含 .NET 和 FFmpeg,不需要另外安装运行环境。FFmpeg 优先无损 stream copy;必须转码时会探测可用的硬件 encoder,失败则记录原因并回退到软件编码。
默认数据目录:
- Windows:
%APPDATA%\DownKyi - macOS:
~/Library/Application Support/DownKyi - Linux:
$XDG_CONFIG_HOME/DownKyi,未设置时通常为~/.config/DownKyi
常用子目录:
Media:默认下载目录Logs:应用和诊断日志Storage:SQLite 下载数据库Config:设置与登录信息Cache:图片和运行缓存
设置 DOWNKYI_DATA_DIR 可指定数据根目录。设置 DOWNKYI_PORTABLE=1,或在程序目录放置 portable、.portable、DownKyi.portable,可启用便携模式。
无法扫码时,可在登录页面粘贴已登录 Bilibili 请求中的 Cookie header。程序会沿用二维码登录的保存和验证流程;验证失败、网络异常或取消时恢复原有凭据。Cookie 会保持已经编码的传输形式,正式 Login 文件由程序管理,无需手动编辑。
关于页面可打开日志目录或导出诊断日志,用于排查网络请求、下载器启停和续传、字幕/弹幕/封面处理、音视频合并以及退出清理。诊断 ZIP 的 events.jsonl 包含操作信息、警告、错误及经过相同规则脱敏的异常文字,不按条数、组件或消息句型筛选。导出从保留的日志读取事件并再次遮蔽敏感信息,以实际写入的 UTF-8 事件数据 24 MB 为上限,给 GitHub 的 25 MB 附件限制预留封装空间;超过时保留最新事件,并在 manifest.json 的 truncated 字段注明。诊断包不附加完整请求/回应正文、数据库或设置文件。公开上传前请检查诊断包内容。
开发需要 .NET 11 SDK。按问题类型进入唯一 owner:
- AGENTS.md:修改协议、导航顺序和禁止事项。
- ARCHITECTURE.md:当前拓扑、边界、invariant 与可执行防线。
- docs/maintenance.md:按领域组织的维护卡。
- docs/testing/README.md:测试基础设施和失败分类。
- docs/operations/verification-and-rollback.md:正式验证与回滚命令。
- DownKyiCore 工作項目:唯一工作管理入口,负责 Priority、Status、排序、Draft/待验证/待决定、In Progress 与 Done;单项工作的背景、范围、证据、验收与 PR 关联保存在对应 Issue。
本机运行:
dotnet run --project .\src\DownKyi\DownKyi.csproj- 本软件只提供视频解析,不提供资源上传或服务器存储功能。
- 本软件仅解析来自 B 站的内容;格式修复、分段拼接或硬件加速流程可能进行转码和索引重建。
- 解析内容的版权归原作者所有,内容提供者与上传者应承担相应责任。
- 所有内容仅供学习交流;未经授权不得用于其他用途,请支持原始发布者与原创内容。
- 因使用本软件产生的版权问题,软件作者概不负责。
许可与第三方归属见 LICENSE 和 THIRD-PARTY-NOTICES.md。