进入源码目录，使用与当前插件版本相同的 requirements.txt

git clone --branch v0.2.0 --depth 1 https://github.com/icyaaaww/dsh-bili-vision.git cd dsh-bili-vision python -m venv "$HOME/.dsh/bili-vision-venv" & "$HOME/.dsh/bili-vision-venv/Scripts/python.exe" -m pip install -r requirements.txt


Linux/macOS 对应解释器为 `~/.dsh/bili-vision-venv/bin/python`；这两个平台尚未完成宿主集成验证。使用自定义 `DSH_HOME` 时将上述环境建在该目录下，或设置 `BILI_VISION_PYTHON` 为已有解释器绝对路径。首次 ASR 使用可能需要下载模型，默认 CPU 运行，无须独显。

标准安装的卸载方式：

```powershell
dsh plugin --profile web remove bili-vision

桌面版用户请使用桌面插件管理界面或该版本提供的内置命令运行时；npm CLI 不能管理保留的 desktop profile。

Windows 源码安装器（替代方式）

在解压的 Release 源码包或 Git 克隆目录运行。选择一种安装方式即可；标准包管理安装后不要再用源码安装器覆盖其包目录。

.\install.ps1 -Profile web

## 配置

| 环境变量 | 作用 |
|---|---|
| `BILI_VISION_PYTHON` | Python 解释器；安装器会保存实际选择 |
| `BILI_VISION_FFMPEG` / `BILI_VISION_FFPROBE` | 媒体工具路径，默认 PATH / 同目录 |
| `BILI_VISION_CACHE` | 缓存目录，默认 `~/.dsh/bili-vision-cache` |
| `BILI_SESSDATA` | 可选官方字幕登录态，不写入缓存明文、不通过子进程命令行传递 |
| `BILI_VISION_ASR_MODEL` | 默认 `small`；`base` 更快，识别效果通常有取舍 |
| `BILI_VISION_ASR_DEVICE` / `BILI_VISION_ASR_COMPUTE` | 默认 `cpu` / `int8` |
| `BILI_VISION_LANG` | 可选转写语言，不设时自动识别 |
| `HF_ENDPOINT` | 模型下载源，默认 `hf-mirror.com`，可自行更换 |
| `DEEPSEEK_API_KEY` | 仅独立 `run` 需要 |
| `DEEPSEEK_BASE_URL` | 独立 API 地址，默认 `https://api.deepseek.com` |
| `BILI_VISION_MODEL` | 独立模型名称，默认沿用 `deepseek-flash`；应按实际账户支持情况设置 |
| `BILI_VISION_IMAGE_TOKENS` | 预算时每图 token 假设，默认 1024；不是实际计费保证 |
| `BILI_VISION_INPUT_PRICE` / `BILI_VISION_OUTPUT_PRICE` | 可选人民币/百万 token 单价；不设置则只估 token，不编造金额 |

不承诺单图固定 384 token，也不假设两次请求必然命中前缀缓存。`run` 记录实际 API `usage`；图像与当前 DSH 对话的实际费用以供应商账单为准。

安装

说明文档

进入源码目录，使用与当前插件版本相同的 requirements.txt

Windows 源码安装器（替代方式）