B 站下载助手 menghuanshiguang/bilibili-downloader-dsh

⬇️ dsh-bilibili-downloader — DeepSeek Harness 的B站音视频下载插件

把 bilibili-downloader-skill(交互技能)与 bilibili-downloader-cli(bilidown CLI)整合成一个 DeepSeek Harness Agent Preset(插件):安装后新建会话选择「B站下载助手」,给链接/BV号/歌名即可下载。

内置 HTTP 412 反爬规避 + 扫码登录解锁高清 + 官方 API 直链秒下(561P 大合集不卡死) + AV1 自动规避(H.264 优先) + 片段截取。

你: 下载这个视频 https://www.bilibili.com/video/BV1GJ411x7h7 助手: 🎬 在线预览该视频共 3 个分P: ... 下载哪个P？(数字/全部/取消) 你: 1 助手: 1. 音频 2. 视频+音频 ...

🖥️ 支持环境

| 环境 | 说明 |
| Linux / macOS | ✅ 原生支持(bash 工具直接可用) |
| Windows | ✅ 需 Git Bash 或 WSL。bilidown CLI 已做 Windows 适配(bilidown.cmd 入口,cmd/PowerShell 通用;代理通过 pwsh 工具直接执行 bilidown ...) |

依赖

| 工具 | 用途 | 安装示例 |
| bash | 脚本运行 | Git Bash / WSL / 各平台自带 |
| yt-dlp | 核心下载引擎 | pip install -U yt-dlp / apk add yt-dlp |
| curl | API 请求、获取 cookies | 各平台自带 |
| python3 | JSON 解析 | 各平台自带(Windows 只有 python 时脚本自动回退,无需配置) |
| ffmpeg / ffprobe | 视频合并 / 转码 | brew install ffmpeg / apt install ffmpeg / winget install Gyan.FFmpeg |

⚠️ ffmpeg 为硬性依赖:脚本启动时检测 ffmpeg/ffprobe,缺失时给出各平台安装指引(不再静默崩溃);音频/视频模式都需要。

🚀 安装

方式一:一键安装脚本(推荐)

Linux / macOS / WSL
git clone https://github.com/menghuanshiguang/bilibili-downloader-dsh.git
cd bilibili-downloader-dsh
bash install.sh # 安装到 ~/.dsh/.agent-presets/bilibili-downloader/

Windows PowerShell
git clone https://github.com/menghuanshiguang/bilibili-downloader-dsh.git
cd bilibili-downloader-dsh
powershell -ExecutionPolicy Bypass -File install.ps1

方式二:手动复制

把本仓库整个目录复制到 ~/.dsh/.agent-presets/bilibili-downloader/($DSH_HOME 已设置时用 $DSH_HOME/.agent-presets/)。

方式三:只装技能(已有其他 preset)

把 skills/bilibili-downloader/ 复制到 ~/.dsh/skills/,任何带 skill 工具的 preset 都能加载该技能(但不带专用 persona 与交互规则提示)。

方式四:官方 bundle 安装(全局生效,推荐给所有会话)

本仓库同时是官方标准插件 bundle(遵循 DeepSeek Harness 架构文档 § Profiles and bundles): package.json 声明 dsh.bundle.patch → cordis.bundle.yml,安装后所有会话自动获得 bilibili-downloader 技能(技能目录随包自包含分发):

1. 安装依赖(bundle 通过 npm/pnpm 解析到 profile): 把仓库目录加入 profile 的依赖与 bundles 列表: ~/.dsh/profiles//package.json
"dependencies": { "bilibili-downloader-dsh": "file:/path/to/仓库" }
"dsh": { "profile": { "bundles": [ ..., "bilibili-downloader-dsh" ] } }
(npm 发布后可改用: dsh plugin --profile add bilibili-downloader-dsh)
2. 重启 dsh 生效。验证: dsh --profile web --dump-config | grep skill-filesystem

三种形态的关系:preset(会话级,可选)/ 技能目录(手动)/ bundle(全局,官方分发格式)。核心技能内容共用 skills/bilibili-downloader/ 一份。

安装 bilidown CLI(推荐,功能最全)

Linux / macOS / WSLbash
git clone https://github.com/menghuanshiguang/bilibili-downloader-cli.git
cd bilibili-downloader-cli
bash install.sh # 软链到 /usr/local/bin/bilidown bilidown --version powershell Windows: 自动把 bin/ 加入用户 PATH, 提供 bilidown.cmd 入口
git clone https://github.com/menghuanshiguang/bilibili-downloader-cli.git
cd bilibili-downloader-cli
powershell -ExecutionPolicy Bypass -File install.ps1
新开终端后: bilidown --version

不装也行:代理可以用 python /bin/bilidown.py ... 直接运行(v2.0.0 起为 Python 单文件,无需安装即可用)。

💡 单一实现:v2.0.0 起 bilidown CLI 为 Python 单文件跨平台实现(不再有 bash 脚本版本),本插件不再内置脚本拷贝,只引用 CLI。

📖 使用

1. 重启 DeepSeek Harness(或直接新建会话)。
2. 会话选择器中选择 「B站下载助手」。
3. 直接发链接 / BV号 / b23.tv 短链 / UP主空间 / 歌名(如"去B站搜《兰花草》下载")。

代理会严格遵守技能硬性规则:先给在线预览 → 分P/音频视频/画质逐步单独询问(一次只问一个问题)→ 下载到工作区 bilibili-downloads/ → 用紧凑格式 + 可点击链接回复。

📁 仓库结构

bilibili-downloader-dsh/
├── agent.cordis.yml # Preset 组合(会话级,插件本体) ├── preset.yml # 显示元数据(名称/描述) ├── package.json # 官方 bundle 声明(dsh.bundle.patch) ├── cordis.bundle.yml # 官方 bundle patch(全局技能注入) ├── install.sh / install.ps1 # 安装脚本 ├── skills/bilibili-downloader/ # 技能包(三种形态共用一份) │ ├── SKILL.md # 交互技能(硬性规则:先预览/逐步询问/紧凑输出) │ └── references/后处理.md # 转码/命名参考 └── README.md / LICENSE

🔗 与上游仓库的关系

| 仓库 | 角色 | 本插件 |
| bilibili-downloader-cli | bilidown CLI 唯一实现(Python 单文件) | 只引用,不内置拷贝 |
| bilibili-downloader-skill | 交互流程技能 | 适配为 DSH 技能(minis:// 播放链接 → DSH 工作区文件链接) |

⚠️ 注意事项

1. 游客模式视频仅 360P/480P;720P+ 需扫码登录(bilidown login)。
2. 不绕过版权/付费墙:仅下载用户有权访问的内容。
3. B站风控:批量勿高频,list 模式自带 3-6s 间隔。
4. Windows:bilidown 为 Python 实现,DSH 代理通过 pwsh 工具直接执行 bilidown ... 即可(无需 Git Bash)。
5. 短链 p 参数不可信:b23.tv 的 p=N 只是分享停留位置,合集找歌用 bilidown find。

📄 许可证

MIT License(整合自两个上游 MIT 仓库,版权归 menghuanshiguang)。