Repository navigation
环境自检
v1.8.8 — Edge 侧边栏修复、OpenAI 供应商、设置页与安装体验全面修复
v1.8.8 已包含 v1.8.1 ~ v1.8.8 的全部改动，升级只需装这一个。请使用 v1.8.8（不要发 v1.8.5）。
浏览器插件必须重新加载并刷新页面：插件已升到 2.3.0。 打开 edge://extensions/（或 chrome://extensions/）→ 在插件卡片上点一次 🔄 重新加载 → 回到 B 站按一次 F5。 （不重载插件，或重载后不刷新已打开的 B 站页面，都会继续报错——内容脚本是页面加载时注入的。）
首次启动会自动安装依赖：解压后双击 BiliLearn-AI-Launcher.exe → 「启动服务」。新版会先并发测速挑最快的 PyPI 镜像再并发下载，界面显示真实进度、速度与预计剩余时间（旧版这里看起来像卡死）。
笔记不会丢：笔记数据一直放在 C:\Users<你的用户名>\BiliLearn-AI，与程序目录分离，升级或重新解压都不受影响。
✨ 新增：环境自检（v1.8.8）
「设置 → 环境自检」→ 点「开始自检」，一次过完生成笔记链路上的每个环节，逐项给出结论和处理建议：
后端版本 / Python / 数据目录；关键依赖版本（yt-dlp、huggingface_hub、hf_xet、faster-whisper、av）
B站连通性与登录态；大模型供应商 / 模型 / Key，勾选「深度检测」会真调一次模型验证连通
离线语音转写开关与依赖；语音模型缓存（没下载就会走"首次下载"这条高风险路）
模型下载环境：端点、Xet 是否已禁用、下载超时
填上 BV 号后：视频能否解析 + 有没有官方字幕（直接告诉你走「抓字幕」还是「本地转写」）
勾选「深度检测」后：真实试拉 1MB 音频，验证「音频下载」这一环
结果可「复制结果」或「下载 txt」发给开发者，不含任何 API Key / Cookie。 遇到生成失败，先跑一次自检再反馈，定位会快很多。
🐛 重要修复
修复：B站短链（b23.tv）无法生成笔记（v1.8.8 重新打包）
复制 B站「分享」出来的短链（形如
https://b23.tv/SPap0F0
）去解析时，会报： 音频下载失败：ERROR: Unsupported URL: https://www.bilibili.com/video/https://b23.tv/SPap0F0?p=1 原因是短链本身不含 BV 号，而旧代码在取不到编号时会把原始链接当成 BV 号存下去，最后拼出畸形地址。 现在会先跟随跳转把短链展开成真实地址（连 ?p=7 这种分P参数也能正确识别），所有拼地址的地方统一校验编号； 取不到编号时给出可读提示，而不是拿畸形 URL 去问 yt-dlp。
模型下载报 401 / 音频下载超时（v1.8.8）
两个用户反馈的错误，都属于「无字幕视频走本地转写」这条路：
CAS Client Error ... 401 Unauthorized, domain: https://cas-server.xethub.hf.co/... HuggingFace 新的 Xet 存储协议：huggingface_hub 1.x 下载大文件会走 Xet，而国内镜像不代理 Xet，于是去连真实的 xethub 服务器并 401（小文件正常、大权重失败）。 v1.8.8 起自动禁用 Xet（同时禁用隐式 token、下载超时 10 秒 → 60 秒），无需手动处理。
音频下载失败：ERROR: [download] Got error: The read operation timed out yt-dlp 默认读超时只有 20 秒且没有重试。现已放宽到 60 秒、重试次数拉满，并额外自动重试 3 次（支持断点续传）。
临时规避（旧版本用户）：设置环境变量 HF_HUB_DISABLE_XET=1 后重启程序；或直接用"有官方字幕"的视频——有字幕就不需要下载语音模型、也不需要下载音频，这条路完全绕开上面两个问题。
Edge 插件：从合集点进视频读不到信息（v1.8.8，插件 2.3.0）
现象：Edge 下侧边栏提示「已找到视频页，但读不到视频信息（Receiving end does not exist）」；从合集点进视频时笔记「闪一下就消失」。 根因：B 站合集/播放列表点进视频是站内 SPA 跳转（不重新加载页面），而插件原先只在 bilibili.com/video/* 页面注入内容脚本 —— 页面从未在 /video/ 上加载过，脚本就不存在，侧边栏发消息没人应答。 修复：注入范围扩大到整个 *.bilibili.com；消息失败时自动补注入并重试；内容脚本暂时读不到时不再清空已显示的笔记。 配套：插件 2.2.0 还修好了「Edge 拿不到当前活动标签页」（四级兜底：活动标签页 → 最近聚焦窗口 → 按 URL 查找 → 上次记住的标签页）。