GithubBackup/BiliNote
1
0
Fork 0
mirror of https://github.com/JefferyHcool/BiliNote.git synced 2026-09-08 17:16:40 +08:00
Code Issues Packages Projects Releases Wiki Activity
462 Commits 4 Branches 25 Tags
release/2.3.4
Commit Graph
100 Commits
This Branch
This Branch
All Branches
Author SHA1 Message Date
huangjianwuandClaude Opus 4.7 2e3fda7df4 feat: 新增 BiliNote AI笔记系统一对一搭建服务二维码（README + 关于页），bump 版本至 2.3.4 
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
 2026-05-27 02:51:15 +08:00
huangjianwu 717df2af7b Merge branch 'release/2.3.3' into develop 
回合并 v2.3.3 版本号。
 2026-05-22 14:07:00 +08:00
huangjianwu db556b8991 Merge branch 'release/2.3.3' 
v2.3.3：预构建镜像持久化数据库/笔记，修升级丢配置与历史。
 2026-05-22 14:07:00 +08:00
huangjianwuandClaude Opus 4.7 b431db545a docs: v2.3.3 CHANGELOG + README + tauri 版本 
Docker 镜像数据持久化修复版本。

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
 2026-05-22 14:07:00 +08:00
huangjianwu 25face4b67 Merge branch 'fix/docker-data-persistence' into develop 
v2.3.3：预构建镜像持久化数据库/笔记，修升级丢配置与历史。
 2026-05-22 14:06:24 +08:00
huangjianwuandClaude Opus 4.7 edfd6e4765 fix(docker): 预构建镜像持久化数据库/笔记，修升级丢配置与历史 
README 的 docker run 只挂了 -v …:/app/backend/data（仅媒体缓存），但
SQLite 库在 /app/backend/bili_note.db、笔记在 /app/backend/note_results
都不在该卷下 → 用户删容器重建（如 docker pull 升级镜像）会丢失 LLM
供应商配置和全部笔记历史。

- Dockerfile.complete：DATABASE_URL 重定向到 /app/backend/data/bili_note.db、
  NOTE_OUTPUT_DIR 改到 data/note_results，并预建 /app/backend/data 目录；
  两条 supervisord environment 行同步（兜底默认值 + %(ENV_*)s 透传）。
- README：docker run 改挂 data（库+笔记）/ config（供应商·Cookie·转写配置）/
  static（截图）/ models（模型缓存，可选）四个数据卷，并警告不要挂整个
  /app/backend（命名卷会固化镜像内代码，导致 docker pull 升级不生效）。
- docker-build.yml：同步发布说明里 echo 的 run 命令。

截图仍留在 /app/backend/static（static_dir 硬编码服务，不能重定向），单独挂卷。

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
 2026-05-22 13:30:42 +08:00
huangjianwu b53cafda5a Merge branch 'release/2.3.2' into develop 
回合并 v2.3.2 版本号。
 2026-05-22 11:41:17 +08:00
huangjianwu adda5fd240 Merge branch 'release/2.3.2' 
v2.3.2：修后端启动崩溃(ctranslate2 4.6.0) + whisper 模型路径 + 桌面端版本号。
 2026-05-22 11:41:04 +08:00
huangjianwuandClaude Opus 4.7 3e28f1fe38 docs: v2.3.2 CHANGELOG + README + tauri 版本 
docker 启动崩溃 / whisper 模型路径 / 桌面端版本号 修复版本。

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
 2026-05-22 11:40:55 +08:00
huangjianwu bffa285cd0 Merge branch 'fix/docker-startup-and-qr' into develop 
v2.3.2 修复集：
- ctranslate2 4.5.0→4.6.0 修后端启动崩溃（可执行栈 / glibc 2.41）
- whisper 模型下载/加载统一 HF cache 布局
- 桌面端构建版本号从 tag 注入（修产物恒为 2.0.0）
 2026-05-22 11:40:21 +08:00
huangjianwuandClaude Opus 4.7 b740e70068 fix(desktop): 构建时从 tag 注入版本号，修产物版本恒为 2.0.0 
桌面端构建产物（.dmg/.msi 文件名 + app 内部版本）一直是 2.0.0：
Tauri 取 tauri.conf.json 的静态 version 字段作为产物版本，而 Release
工作流只把 tag 名用作 Release 标题，没同步到 conf → 产物版本与 Release
版本错位。

在 pnpm tauri build 前新增 Sync version 步骤，从 github.ref_name（形如
v2.3.2，去掉前缀 v）注入版本到 tauri.conf.json。以后每次 tag 发版自动
对齐；workflow_dispatch 手动构建无 tag 时跳过，保留静态值不破坏。

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
 2026-05-22 11:40:04 +08:00
huangjianwuandClaude Opus 4.7 261c95cf12 fix(transcriber): whisper 模型下载/加载统一走 HF cache 布局 
此前用 modelscope 下到自定义目录 whisper-{size}/ 再把该路径传给
WhisperModel。但 faster-whisper 1.1.1 只要 path 含 '/' 就当成 HF
repo_id 处理，没有「本地目录直接返回」分支 → 在线请求失败后 fallback
local_files_only，又因 modelscope 布局命不中 HF cache → LocalEntryNotFound，
误导用户以为是「离线模式」。

改为下载与加载路径对齐：
- 下载：huggingface_hub.snapshot_download(cache_dir=model_dir)，落到 HF
  cache 布局 models--Systran--faster-whisper-{size}/snapshots/<hash>/
- 加载：WhisperModel(model_size_or_path=size, download_root=model_dir)，
  让 faster-whisper 自己映射到 Systran/faster-whisper-* 并命中同一 cache
- 完整性检测 / 损坏自愈(_purge_cache) 同步按 HF cache 布局，并兼容老
  modelscope 目录（向后兼容已下载的老用户）

HF_ENDPOINT 已在 Dockerfile 指向 hf-mirror.com，国内可用。

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
 2026-05-22 11:27:03 +08:00
huangjianwuandClaude Opus 4.7 1cc7f38e14 fix(backend): 升级 ctranslate2 4.5.0→4.6.0 修复后端启动崩溃 
Docker 容器反复重启，启动即报：
  ImportError: libctranslate2-*.so.4.5.0: cannot enable executable
  stack as shared object requires: Invalid argument

根因：ctranslate2 4.5.0 预编译 wheel 把共享库标记为「需要可执行栈」，
新内核 / glibc 2.41+ 加载时拒绝并返回 EINVAL。faster-whisper 在
whisper.py 顶层 import，import 失败直接拖垮整个后端启动 → 重启死循环。

ctranslate2 4.6.0 加入 noexecstack 链接标志（OpenNMT/CTranslate2 #1852、
#1861）从 wheel 层根治。faster-whisper 1.1.1 依赖 ctranslate2<5,>=4.0，
4.6.0 兼容；同时覆盖 web / GPU / 桌面 三条构建链。

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
 2026-05-22 11:26:49 +08:00
huangjianwu 7fffd6873b Merge branch 'release/2.3.1' into develop 
回合并 v2.3.1 版本号（CHANGELOG + README）。
 2026-05-22 10:51:49 +08:00
huangjianwu 7b927db363 Merge branch 'release/2.3.1' 
v2.3.1：更新微信交流群二维码（群 1-5）。
 2026-05-22 10:51:39 +08:00
huangjianwuandClaude Opus 4.7 c42ceaaa32 docs: v2.3.1 CHANGELOG + README 版本 
二维码热修补丁版本。

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
 2026-05-22 10:51:30 +08:00
huangjianwu 177ee4ba3a Merge branch 'fix/docker-startup-and-qr' into develop 
更新微信交流群二维码（群 1-5，旧码即将失效）。
同步 master 上的二维码热修（README 二维码区块 + 5 张入群图）到 develop。
 2026-05-22 10:51:05 +08:00
huangjianwuandClaude Opus 4.7 aae17abf9a docs: 更新微信交流群二维码（群 1-5，有效期至 5/29） 
旧二维码即将失效，替换 README 中 5 个交流群的入群二维码。

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
 2026-05-22 10:42:12 +08:00
huangjianwuandClaude Opus 4.7 33d44e32d2 docs: 突出 BiliNote Pro 在线版 + 更新微信交流群二维码 
- README 顶部新增 BiliNote Pro 在线版推广区块（www.bilinote.app），
  项目简介后加引导提示，「在线使用」章节改为「在线使用（推荐）」
- 微信交流群二维码更新为 5 个群，doc/wechat-group-1~5.png

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
 2026-05-14 21:45:34 +08:00
huangjianwuandClaude Opus 4.7 56e075253a docs: v2.3.0 CHANGELOG + README 版本 
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
 2026-05-14 19:05:46 +08:00
huangjianwuandClaude Opus 4.7 f1b091b846 chore(deploy): docker 镜像源/restart 策略 + .env 修正 + 文档 
- 所有 Dockerfile 加 BASE_REGISTRY build-arg，国内拉不到 docker.io
  时可换 daocloud 等镜像源；compose 透传该 arg
- docker-compose: restart 从 on-failure:3 改 unless-stopped（避免短暂
  崩溃后永久打死）；gpu compose 补齐 healthcheck/restart/mem_limit
- Dockerfile.complete: supervisord 用 %(ENV_*)s 透传环境变量给 backend
  子进程（之前只白名单 2 个，docker run -e 配的变量后端看不到）
- .env.example: 修正 VITE_API_BASE_URL 端口（8000→8483）、
  WHISPER_MODEL_SIZE medium→tiny（首次启动不被大模型下载卡住）、
  补 Docker 部署说明注释
- README: 新增 Docker 部署常见问题 FAQ（镜像源/restart/数据持久化等）
- CLAUDE.md: 勘误（移除不存在的 messaging/i18n/worker_registry 描述，
  修正 events 路径），补 pytest/typecheck 命令

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
 2026-05-14 19:01:55 +08:00
huangjianwuandClaude Opus 4.7 37f7ee6e15 feat(desktop): 后端健康监控韧性 + onboarding 修复 + 全局代理 UI 
- useCheckBackend 重写：60s 总超时取代 while(true) 死轮询，订阅 Tauri
  backend-ready/terminated/startup-timeout 事件，裸 fetch 探测避免
  启动期 toast 叠堆
- Tauri lib.rs：spawn 后 HTTP 探针轮询 /api/sys_check 拿 200 才算就绪
  （之前 TCP connect 会被孤儿进程误判）；RunEvent::Exit 钩子退出前
  kill sidecar，修孤儿进程占端口；restart 前发 backend-restarting
  让前端忽略主动 kill 引发的 terminated
- BackendInitDialog：失败态展示原因 + 最近 stderr + 重启/复制日志按钮
- StartupBanner：收到 restarted/ready 自动清「已退出」横幅
- BackendHealthIndicator：修 /api/api/sys_health 双前缀 404
- Onboarding：step1 后端连通改自动重试 + 事件触发 + 手动按钮；step2
  撞预置供应商名时改为更新已存在供应商；errText 统一错误文案
- 全局代理 UI：下载配置页新增代理卡片（services/proxy.ts + ProxyConfig）
- request.ts 加 suppressToast 配置位，预期失败不弹全局红 toast
- NoteForm/taskStore：捕获就绪门禁错误，引导去音频转写配置页下载
- providerCard：整行可点切换（之前只有 icon 区域响应）
- Monitor 页 Whisper 卡显示模型本地下载状态
- tauri/api 升级对齐 2.11，修 vite build 版本不匹配

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
 2026-05-14 19:01:37 +08:00
huangjianwuandClaude Opus 4.7 41f17592c2 fix(backend): 部署韧性——模型自愈/就绪门禁/全局代理/启动诊断 
- whisper: model.bin 截断/损坏时删目录重下重试一次，修「Unable to
  open file model.bin」死循环；mlx 同样按 config.json 判完整性
- /generate_note 加就绪门禁：本地转写引擎模型没下好直接拦截，返回
  reason=transcriber_model_not_ready，不让任务静默卡在首次下载
- 全局代理：新增 ProxyConfigManager（JSON 配置 + HTTP_PROXY env 兜底）
  + build_openai_client，统一注入代理到 LLM/Groq 客户端；yt-dlp 与
  youtube-transcript-api 也走代理
- build_openai_client 校验 api_key 非空，空 key 给「xxx 的 API Key
  未配置」而不是天书般的 Illegal header value b'Bearer '
- universal_gpt: 模型拒绝自定义 temperature（o1/o3/gpt-5 系列）时
  就地去掉参数重试，不消耗重试预算
- connect_test 改用真实 chat completion 而非 /v1/models 探测
- main.py: lifespan 拆 [startup 1/5..5/5] 分段日志 + 异常清晰定位
- /sys_health 重构为结构化返回 {backend,ffmpeg,db,whisper_model}

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
 2026-05-14 19:01:14 +08:00
huangjianwu de630dadb3 chore(release): merge hotfix/tauri-api-dep into develop 2026-05-09 14:53:18 +08:00
huangjianwu 7b5e6099e8 chore(release): v2.2.3 
补 P1/P2 用了 @tauri-apps/api 但没声明为直接依赖导致的 vite build CI 失败。
 2026-05-09 14:53:01 +08:00
huangjianwuandClaude Opus 4.7 bb9a70eee2 fix(frontend): @tauri-apps/api 提升为直接依赖，修 vite build CI 失败 
v2.2.0 加的 P1/P2 桌面端组件（StartupBanner / useBackendEvents）用了
'await import(\"@tauri-apps/api/event\")' 与 '@tauri-apps/api/core'，但
@tauri-apps/api 只是 @tauri-apps/plugin-shell 的 transitive，没在
BillNote_frontend/package.json 直接声明。

本地开发能跑（pnpm 节点解析容忍 transitive），但 vite 6 的 production
rollup 静态分析时报：
  Rollup failed to resolve import "@tauri-apps/api/event"

之前我只跑了 typecheck 没跑 build，所以这个问题先在 v2.2.0 / v2.2.1 / v2.2.2
的 CI 上才暴露出来。本地 DOCKER_BUILD=1 pnpm run build 已复现并修复验证。

修：BillNote_frontend/package.json 把 '@tauri-apps/api' 加为直接依赖
（^2.10.1，与 lockfile 中已存在的 transitive 版本对齐），lockfile 同步更新。

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
 2026-05-09 14:52:56 +08:00
huangjianwu e9d4740cc7 chore(release): merge hotfix/desktop-pnpm-version into develop 2026-05-09 14:49:53 +08:00
huangjianwu c5900a9026 chore(release): v2.2.2 
补 v2.2.1 漏掉的桌面端 Tauri 构建 pnpm 版本 pin。
 2026-05-09 14:49:39 +08:00
huangjianwuandClaude Opus 4.7 63577aa1aa fix(ci): pin pnpm 9.15.0 in main.yml，修 v2.2.0 桌面端 Tauri 构建失败 
v2.2.1 hotfix 只 pin 了 Docker 那两个 Dockerfile 里的 pnpm，但 .github/workflows/main.yml
（Tauri 桌面端 macOS + Windows 构建）的 'pnpm/action-setup@v4 with: version: latest' 没改，
于是 v2.2.1 tag 触发的桌面端 build 仍然挂在 'Install frontend dependencies' 步：

  ERR_UNKNOWN_BUILTIN_MODULE: No such built-in module: node:sqlite
  Node.js v20.20.2

修：main.yml 的 pnpm version 'latest' → '9.15.0'，与 Docker 侧 + extension workflow
保持一致（lockfile 是 pnpm 9 生成的）。

release-extension.yml 已经是 pinned 9，无需改。

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
 2026-05-09 14:49:33 +08:00
huangjianwu ec33ae35ed chore(release): merge hotfix/docker-pnpm-version into develop 2026-05-09 14:47:25 +08:00
huangjianwu 2e69d1179b chore(release): v2.2.1 
补 v2.2.0 ghcr.io 镜像构建失败（pnpm 版本不兼容 Node 20）。
 2026-05-09 14:47:11 +08:00
huangjianwuandClaude Opus 4.7 7e5be46cda fix(docker): pin pnpm 到 9.15.0，修复 v2.2.0 ghcr.io 镜像构建失败 
v2.2.0 tag 触发的 ghcr.io 推送挂在 frontend-builder 第 5/7 步
'pnpm install --frozen-lockfile'，错误：

  code: 'ERR_UNKNOWN_BUILTIN_MODULE'
  Node.js v20.20.2

根因：'corepack prepare pnpm@latest' 拉到 pnpm 11.0.9，pnpm 11+ 要求 Node 22+，
跟我们 node:20-alpine 不兼容。lockfile 本身是 lockfileVersion '9.0' 由 pnpm 9
生成，理应跟 pnpm 9 配。

修：Dockerfile.complete + BillNote_frontend/Dockerfile 都 pin 到 pnpm@9.15.0；
不再用 @latest，避免上游再次升级悄悄破坏 CI。

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
 2026-05-09 14:47:06 +08:00
huangjianwu 0742387235 chore(release): merge release/2.2.0 back into develop 2026-05-09 14:43:48 +08:00
huangjianwu 604cdefa15 chore(release): v2.2.0 
主线：浏览器插件功能与 web 端 NoteForm 完整对齐；桌面客户端 UX 与错误恢复一波重炼。
详见 CHANGELOG.md。
 2026-05-09 14:43:38 +08:00
huangjianwuandClaude Opus 4.7 ff91f74bef docs: v2.2.0 CHANGELOG + README 版本 
主线：浏览器插件功能与 web 端 NoteForm 完整对齐；桌面客户端 UX 与错误恢复一波重炼。
详见 CHANGELOG.md。

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
 2026-05-09 14:43:25 +08:00
huangjianwu 9bbae2c0c4 fix(backend): 把 deploy-resilience 合入 release/2.2.0 
P0 修：whisper 半成品目录死循环 + /deploy_status 硬依赖 torch。
原 PR fix/backend-deploy-resilience 未走 develop，直接随本次发版上 master，
回灌时 develop 也拿到。
 2026-05-09 14:42:11 +08:00
huangjianwuandClaude Opus 4.7 721bda5280 feat(transcriber): 默认 size 改 tiny + 切本地引擎前 confirm 模型下载 
桌面端用户首次跑视频时挂在 fast-whisper 模型下载（默认 medium ~1.5GB），
两处改动：

1. backend/app/services/transcriber_config_manager.py:
   默认 whisper_model_size 从 'medium' (~1.5GB) → 'tiny' (~75MB)。
   新装用户没主动设置时不再被首次下载卡住；想要更高精度的用户去配置页主动切。

2. BillNote_frontend/src/pages/SettingPage/transcriber.tsx:
   handleSave 在保存前判断：选了 fast-whisper / mlx-whisper 且当前 size 在
   modelStatuses 里既未下载也不在下载中 → window.confirm 弹一个体积提示，
   推荐改用 Groq / 必剪 / 快手 等在线引擎；用户取消则不保存。

不改业务逻辑；零回归风险（已有用户 transcriber.json 里写了什么就还是什么）。

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
 2026-05-09 14:32:41 +08:00
huangjianwuandClaude Opus 4.7 a928e0e38f feat(desktop): 桌面端首启 4 步引导 
桌面端用户安装后空白进 web 主页面，提示填模型但不知道从哪填、转写引擎从哪选、
为什么 fast-whisper 在下东西。新增首启 onboarding wizard，把四件事拉成一条线：

1. 后端连通性自检（启动后调 /api/get_all_providers，OK 才能进下一步）
2. LLM 供应商 + 模型：填 OpenAI 兼容 base_url + key + model_name，调
   /add_provider 创建并 addModel 默认 model，附带 testConnection
3. 转写引擎：四选一，**默认推荐 Groq**（在线、免下载本地模型）；
   选 fast-whisper 时显式提示"将下载模型"
4. Cookie 同步说明：桌面端无 chrome.cookies API，引导手动配；并指向插件版

实现：
- 新页 src/pages/Onboarding/index.tsx，单文件 stateful wizard
- App.tsx 加 /onboarding 路由 + OnboardingGuard 路由守卫：
  · 仅 Tauri 桌面端（__TAURI_INTERNALS__）拦截，纯 web 端透传，不打扰
  · localStorage('bilinote-onboarded') 不为 '1' 时强制跳 /onboarding
- 完成第 4 步 markOnboarded() 写 localStorage 后 navigate('/')

回归风险：纯 web 用户无感知；旧桌面端用户的 localStorage 没这个 key，
首次升级到含此 PR 的版本时会跳一次 onboarding（建议在升级 release notes 里
说明，避免老用户疑惑）。

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
 2026-05-09 14:30:05 +08:00
huangjianwuandClaude Opus 4.7 1329390f98 feat(desktop): Sidecar 健康度面板 + 重启后端能力 
P1 已经把 backend-warning / backend-terminated 横幅做出来了；P2 把
lib.rs 那条 stdout/stderr/terminated 信息流真正落到一个常驻 UI 上：
- 右下角浮动状态点（绿/黄/红），轮询 /api/sys_health 决定颜色
- 点开抽屉看最近 200 行日志（ring buffer），含「重启后端」「复制日志」按钮

Rust：
- src-tauri/src/lib.rs：把 sidecar 启动抽出 spawn_backend_sidecar()，
  CommandChild 存进 SidecarHandle(Mutex<Option<CommandChild>>) 这个 state
- 新增 #[tauri::command] restart_backend_sidecar：kill 旧 child + 重新 spawn +
  emit 'backend-restarted' 给前端
- 监听任务 stdout/stderr emit 时不再用 format!("'{}'", ...) 包引号，原文直传；
  前端 hook 同时兼容旧形式（兜底剥引号）

前端：
- components/BackendHealth/useBackendEvents.ts：listen 四个事件 +
  ring buffer (MAX 200 行) + invoke restart + clipboard 复制日志
- BackendHealthIndicator.tsx：右下角浮动状态点，5s 轮询 /api/sys_health；
  连续 3 次失败或 backend-terminated 触发 → 红
- BackendLogPanel.tsx：右侧抽屉，深色 monospace 日志区 + 操作按钮
- 纯 web 环境（无 __TAURI_INTERNALS__）下静默不挂载

P3 / P4 还在路上。

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
 2026-05-09 14:27:02 +08:00
huangjianwuandClaude Opus 4.7 9a64a2da8e feat(desktop): 启动期路径诊断 + 顶端横幅，主动暴露已知失败因素 
桌面端历史痛点：PyInstaller sidecar 在含非 ASCII / 含空格 / 不可写的安装路径下
直接炸（README:36 仅文字警告"不要中文路径"，无主动防御）。Sidecar 退出事件 lib.rs
已 emit 但前端没 listener 消化，用户看到的是空白主页。

- src-tauri/src/lib.rs：
  · setup 中 env::current_exe() 之后做 InstallPathDiagnostics（is_ascii / 空格 /
    父目录 write_probe），命中任一异常就 emit 'backend-warning' 给前端
  · 用 std::thread::spawn + 1500ms sleep 等首屏 listener 挂上再 emit，避免事件丢失
  · 新增 Tauri command get_install_path_diagnostics，前端可主动重查（用户卸载到
    新目录后首次启动）
- BillNote_frontend/src/components/SystemDiagnostic/StartupBanner.tsx（新建）：
  · 监听 backend-warning（路径警告，可关闭）+ backend-terminated（致命，常驻）
  · 纯 web 环境（无 __TAURI_INTERNALS__）下静默不挂载，对桌面端定向起效
  · backend-error（stderr 噪音）暂不展示，留给后续 P2 日志面板
- App.tsx：StartupBanner 在 BackendInitDialog 之前就挂载，让"后端还在初始化时"
  也能看见路径警告（正是该场景容易炸）

不改任何业务逻辑；纯桌面端 UX 加固。

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
 2026-05-09 14:22:41 +08:00
huangjianwuandClaude Opus 4.7 2bb69d1581 fix(backend): 部署友好性——whisper 半成品目录与 deploy_status 硬依赖 torch 
两处部署反馈来的问题：

1. WhisperTranscriber 反复抛 'Unable to open file model.bin in
   model whisper-base'
   · 原因：__init__ 只看目录是否存在判定模型已下载（Path(model_path).exists()），
     但首次下载若中断 / 网络异常会留下空 / 半成品目录，下次启动绕过下载分支直接
     进 WhisperModel 加载，于是死循环报错
   · 修：判定条件换成 'model.bin' 落盘存在；目录在但 model.bin 缺失时打 warn
     并触发重新下载
   · routers/config.py 的 _check_whisper_model_exists 同步改用 model.bin 判定，
     避免「已下载」状态在监控页误报

2. /api/deploy_status 在没装 torch 的部署上 500
     ModuleNotFoundError: No module named 'torch'
   · 原因：endpoint 顶部直接 import torch，仅 fast-whisper 才用得到的依赖被强制为
     全局必需。轻量部署 / 用户切到 Groq / 必剪 / 快手 在线引擎时无 torch 也合理
   · 修：torch 改为 try/except，未装或 cuda 检测异常时返回
     {available: false, torch_installed: false}；同时把 transcriber 配置 +
     ffmpeg 都包在 try 里，保证整个监控 endpoint 不会被任一子项打死

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
 2026-05-09 13:57:34 +08:00
huangjianwuandClaude Opus 4.7 a7c717abbd feat(extension): 多模态视频理解开关 + 抽帧/拼图参数（对齐 web NoteForm） 
web 端 NoteForm 早就有 video_understanding / video_interval / grid_size 三件套，
插件之前没有，导致用户在视觉模型上想用「画面理解」时只能去 web 端发任务。

新增字段（types.ts Settings 与 GenerateRequest 同步）：
- video_understanding: boolean，默认 false（关）
- video_interval: number，1-30 秒，默认 6（与 web NoteForm 默认一致）
- grid_size: [number, number]，1-10，默认 [2,2]

UI 落地：
- popup 「高级」折叠区：开关 + interval + grid_size 行/列三栏，启用时才显示后两个，
  并提示需要选视觉模型
- options General 页：单独一节「视频理解（多模态）」展开同样字段
- popup start() 与 background startTask() 在 generate_note 请求里带上这三个字段；
  关闭时不传（避免覆盖 backend 默认）

回归风险：默认 false，对现有用户行为不变。

依赖：feature/extension-form-parity（叠加在它之上，因为 Settings 是同一片字段域）。

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
 2026-05-07 17:22:57 +08:00
huangjianwuandClaude Opus 4.7 799ab64a28 feat(extension): NoteForm 字段对齐 web 端（style 预设 + format 完整 + extras） 
之前插件 popup / options 的笔记选项跟 web 端 NoteForm 不齐，存在三处差距：

1. style 字段实质 broken
   · backend prompt_builder.get_style_format 是 enum 映射（minimal/detailed/
     academic/tutorial/xiaohongshu/life_journal/task_oriented/business/
     meeting_minutes 共 9 个），不命中直接 return ''
   · 插件原来给的是自由文本框，用户填什么都对不上 enum，等于没传
   · 改：popup + options 都换成 9 个预设的下拉框，与 backend 严格对齐
2. format 字段缺一半
   · backend 支持 toc / link / screenshot / summary 四个
   · 插件只暴露了 screenshot / link 两个 checkbox
   · 改：types.ts 新增 NOTE_FORMATS 常量，UI 渲染完整 4 个 checkbox。
     生成请求时 format 数组、screenshot/link 单布尔由 settings.formats 派生，单一真相源
3. 缺 extras 字段
   · backend VideoRequest.extras 直接拼到 prompt 末尾给 LLM
   · 改：popup 折叠的"高级"区 + options 默认生成选项区都加 textarea

Settings 默认值：style='minimal'、formats=['toc','summary']、extras=''。
旧 settings 里若 style 是无效字符串，下拉会显示空白，用户重选一次即可。

logic/types.ts：
- 新增 NoteStyle / NoteFormat type alias 与 NOTE_STYLES / NOTE_FORMATS 常量
- Settings 接口加 formats: NoteFormat[] / extras: string，style 改为 NoteStyle
- 老的 screenshot / link 布尔保留（向后兼容旧 storage），但 UI 不再绑定，submit 时也由 formats 派生

popup / background / options 三处提交 generate_note 的逻辑同步收口。

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
 2026-05-07 17:18:28 +08:00
huangjianwu c0837e0132 chore(release): merge release/2.1.4 back into develop 2026-05-07 16:45:11 +08:00
huangjianwu c9497b502c chore(release): v2.1.4 
CI 工程化修复，无运行时行为变化。详见 CHANGELOG.md。
 2026-05-07 16:44:59 +08:00
huangjianwuandClaude Opus 4.7 1aea86a8d6 docs: v2.1.4 CHANGELOG + README 版本 
CI 工程化修复，无运行时行为变化。详见 CHANGELOG.md。

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
 2026-05-07 16:44:49 +08:00
huangjianwuandClaude Opus 4.7 ac72cc6d6e ci(tauri): 桌面端构建去掉 Linux，只保留 macOS + Windows 
Tauri Linux 构建 (ubuntu-22.04, x86_64-unknown-linux-gnu) 在 v2.1.x 这几次发版上
持续 17m+ 才完成，相比 macOS / Windows 更慢，且没有面向 Linux 桌面端用户的实际分发渠道。
直接从 matrix 里去掉。

清理：
- matrix 删除 ubuntu-22.04 条目
- 'Install Linux Dependencies' step（仅 ubuntu 触发）整段移除
- artifact 收集步里的 .deb / .AppImage 两条 find 命令移除

Linux 用户继续可以走 Docker 镜像 (ghcr.io/jefferyhcool/bilinote)，那条线没变。

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
 2026-05-07 14:30:07 +08:00
huangjianwuandClaude Opus 4.7 7358cd0123 fix(ci): commitlint workflow 去掉伪 input + 规范 release merge commit 格式 
v2.1.3 push master 时 Lint commit messages job 红了，根因两条：

1. workflow 里写了 'firstParent: false'，但 wagoid/commitlint-github-action@v6
   的合法 input 列表里没这个字段，被 ignore 同时打 warn

2. release merge commit 标题 'Release v2.1.3' 不符合 type(scope): subject 格式，
   commitlint 报 subject-empty + type-empty
   · @commitlint/config-conventional 默认 ignore 'Merge ' 前缀的 commit，
     但我们手动 -m 把标题写成 'Release vX.Y.Z' 跳过了豁免

修：
- 去掉 .github/workflows/commitlint.yml 里那条 firstParent 假 input
- RELEASING.md §3 加入 merge commit 标题模板：
  · 合 master 用 'chore(release): vX.Y.Z'
  · 回灌 develop 用 'chore(release): merge release/X.Y.Z back into develop'
- CONTRIBUTING.md §6.3 同步加这条提醒

历史上 master / develop 的 'Release v2.1.x' 那几个 merge commit 已经在 history
里，没法回头改（不能强推 master）。但 commitlint 在 push 时只 lint 推送范围里的
新 commit，旧 commit 不会重新校验，所以不会持续报错。

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
 2026-05-07 14:19:39 +08:00
huangjianwu 80f081613b Merge branch 'release/2.1.3' back into develop 2026-05-07 14:14:43 +08:00
huangjianwu 26e23d0f2c Release v2.1.3 
修 issue #282 (DeepSeek 等非多模态供应商被 400 拒绝)。详见 CHANGELOG.md。
 2026-05-07 14:14:33 +08:00
huangjianwuandClaude Opus 4.7 234e3b9d2a docs: v2.1.3 CHANGELOG + README 版本 
修 issue #282（DeepSeek 等非多模态供应商被 400 拒绝）。详见 CHANGELOG.md。

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
 2026-05-07 14:14:22 +08:00
huangjianwu c19d462505 Merge branch 'release/2.1.2' back into develop 2026-05-07 14:06:35 +08:00
huangjianwu 64882e6a77 Release v2.1.2 
补 v2.1.1 ghcr.io 镜像构建失败。详见 CHANGELOG.md。
 2026-05-07 14:06:26 +08:00
huangjianwuandClaude Opus 4.7 f32a6944d1 docs: v2.1.2 CHANGELOG + README 版本 
补 v2.1.1 ghcr.io 镜像构建失败。详见 CHANGELOG.md。

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
 2026-05-07 14:06:16 +08:00
huangjianwuandClaude Opus 4.7 c4413c66a1 fix(docker): 修复 Tag push 触发的镜像构建失败 
ghcr.io 镜像推送在 v2.1.1 tag 上失败，停在 frontend-builder 第 7/7 步
'pnpm run build'：vite loadConfigFromBundledFile 1.5s 内挂掉，没具体行号——
典型现象是 vite.config.ts 顶部 import 的某个 plugin（@tailwindcss/vite）的
native binding 在容器里 require 失败。

三处修复：
1. Dockerfile.complete + BillNote_frontend/Dockerfile：node:18-alpine → node:20-alpine
   · Tailwind v4 已不再支持 Node 18（package 现实需要 20+）
   · Vite 6 也建议 Node 20+
2. Dockerfile.complete 的 frontend 阶段：复制 pnpm-lock.yaml + 改用 --frozen-lockfile
   · 之前没传 lockfile，每次 pnpm install 重解析 semver，有可能拉到比本地更新的 native dep
3. BillNote_frontend/pnpm-lock.yaml 强制入库（git add -f）
   · 之前根 .gitignore 有条诡异的 'BiliNote/pnpm-lock.yaml'（拼错的路径），
     虽然没真匹配上这个文件，但 lockfile 历史上一直没被提交，导致 CI 与本地依赖图持续漂移
   · lockfile 里 @tailwindcss/oxide 同时锁了 musl 与 gnu 变体，alpine 跑没问题

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
 2026-05-07 14:01:26 +08:00
huangjianwuandClaude Opus 4.7 29fa3d9540 docs(readme): 联系和加入社区段落补上微信群二维码 
之前只写"年会恢复更新以后放出最新社区地址"，现在直接挂 doc/wechat.png 上去。
GitHub 渲染相对路径图片时按 raw.githubusercontent.com 自动转，无需 CDN。

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
 2026-05-07 13:57:40 +08:00
huangjianwu 61cb4ec9fa Merge branch 'release/2.1.1' back into develop 2026-05-07 13:55:01 +08:00
huangjianwu a46880f169 Release v2.1.1 
工程化与文档收尾，无运行时行为变化。详见 CHANGELOG.md。
 2026-05-07 13:54:50 +08:00
huangjianwuandClaude Opus 4.7 c187dce5cb docs: v2.1.1 CHANGELOG + README 版本 
工程化与文档收尾，无运行时行为变化。详见 CHANGELOG.md。

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
 2026-05-07 13:54:23 +08:00
huangjianwuandClaude Opus 4.7 f583f3cc8c chore(frontend): about 页移除 QQ 群联系方式，仅保留微信群 
QQ 群已不再活跃维护，关联展示也容易让用户搜不到。保留微信群入口即可。

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
 2026-05-07 13:50:23 +08:00
huangjianwuandClaude Opus 4.7 2e7fe8d3a8 chore(frontend): 关于页二维码改为 import 本地资源，不再依赖 CDN 
之前 about 页直接拉腾讯云 COS 上的 wechat.png，每次换码都要手动重新上传 CDN
+ 刷缓存。改成 import @/assets/wechat.png，由 Vite 打包，更新时只需替换文件。

doc/wechat.png 仍保留作为源 / 备份。

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
 2026-05-07 13:49:25 +08:00
huangjianwuandClaude Opus 4.7 1e055c3068 chore(docs): 更新群聊微信二维码 
doc/wechat.png 替换为最新版（396×396）。

⚠️ 前端 SettingPage/about.tsx:207 实际渲染的是腾讯云 COS 上的同名文件
   https://common-1304618721.cos.ap-chengdu.myqcloud.com/wechat.png
仓库这边只是源文件，CDN 那份需要项目维护者手动重新上传：
- 登录腾讯云 COS 控制台
- 找到 common-1304618721 桶
- 把根目录的 wechat.png 替换为 doc/wechat.png 这一份

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
 2026-05-07 13:47:23 +08:00
huangjianwuandClaude Opus 4.7 b2af0e4e53 chore(repo): 仓库工具链——issue/PR 模板 + commitlint CI + 插件发版工作流 
把 CONTRIBUTING.md 里写的规范落到 GitHub 工程化层。

Issue / PR 模板：
- .github/ISSUE_TEMPLATE/{config,bug_report,feature_request}.yml
  · yml 表单形式，跟随当前工作区分类（backend / frontend / extension / Tauri）
  · bug_report 强制选版本 + 部署方式 + 复现步骤；提交前自查不夹带 secrets
  · config.yml 禁用空白 issue，引导 Discussions
- .github/pull_request_template.md：把 CONTRIBUTING §5.2 的 PR 正文要求落成 checklist
- 删旧版 .md 模板（含中文文件名那条），避免新老两套并存

Commitlint：
- .commitlintrc.json：extend conventional + 自定义 type 白名单（feat/fix/docs/style/refactor/perf/test/build/ci/chore/ui/revert）
- .github/workflows/commitlint.yml：用 wagoid/commitlint-github-action@v6，PR + push develop/master 时校验
  · subject-case / subject-full-stop 关掉，兼容中文 subject
  · header-max-length 100 字符 warn 级别，不阻塞合并

插件发版工作流：
- .github/workflows/release-extension.yml：v* tag push 时
  · cd BillNote_extension && pnpm install + build
  · pack:zip / pack:xpi / pack:crx（crx 缺 key 自动跳过）
  · 产物重命名带版本后缀，挂到对应 GitHub Release
- 末尾保留 publish-chrome / publish-edge / publish-firefox 三段注释，配齐 secrets 即可启用商店自动发布
- RELEASING.md：发版执行手册，覆盖 release/* 流程 + 各商店人工上传步骤 + 自动发布所需 secrets

CONTRIBUTING.md 关联文档区指到新增的 RELEASING.md，commit 章节加 commitlint 落地说明。

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
 2026-05-07 13:45:32 +08:00
huangjianwuandClaude Opus 4.7 ee58a65bcd docs(contributing): 新增贡献指南，落地简化 Git Flow 分支管理 
落地分支模型：
- master：稳定主干，仅接受 release/hotfix 合入，禁止直接提交
- develop：长期开发集成分支，常规开发都从这里起
- feature/* / fix/*：短生命周期，基于 develop
- release/*：基于 develop，发版后合入 master + 回灌 develop
- hotfix/*：基于 master，处理线上紧急故障

同时收录：
- 多工作区命名 scope 约定（extension / frontend / backend / bilibili / ...）
- commit message 格式（type(scope): subject）+ PR 标题/正文要求
- 合并方式：feature/fix → develop 用 Squash；release/hotfix → master 用 --no-ff
- simple-git-hooks 残留 .git/hooks/pre-commit 的清理办法
- 语义化版本 + CHANGELOG.md 更新流程
- 禁止事项 + 历史分支迁移要求

适配自 emplai-ui doc/前端仓库分支管理办法.md，按本仓库实际情况调整：
master 不改名为 main、补充多工作区 scope、把发版与 tag 流程串联到 README/CHANGELOG。

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
 2026-05-07 13:13:32 +08:00
huangjianwu dbe7b89754 Release v2.1.0 
详见 CHANGELOG.md。主线：
- 浏览器插件（Chrome/Edge/Firefox MV3）
- B 站字幕优先链路
- mlx-whisper 仓库 ID 修复
- 后端 CORS regex 兼容扩展源
 2026-05-07 13:10:28 +08:00
huangjianwu cfc3053be8 Merge upstream master (PR #341) into develop 2026-05-07 13:10:28 +08:00
huangjianwu 4dc5b97f0b Merge branch 'feat/browser-extension' into develop 2026-05-07 13:06:44 +08:00
huangjianwuandClaude Opus 4.7 817bbd9807 docs: v2.1.0 CHANGELOG + README 版本更新 
详细变更见 CHANGELOG.md。本次发布主线：
- 浏览器插件（Chrome/Edge/Firefox MV3）
- B 站字幕优先链路（插件 + 后端兜底）
- mlx-whisper 仓库 ID 修复
- 后端 CORS regex 兼容扩展源

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
 2026-05-07 13:06:31 +08:00
huangjianwuandClaude Opus 4.7 406789f834 feat(extension+backend): 插件直接在浏览器里抓 B 站字幕，跳过后端 download_subtitles 
之前 B 站字幕优先逻辑放在后端的 BilibiliSubtitleFetcher，需要后端通过 CookieConfigManager
管理 SESSDATA cookie 才能拿 AI 字幕。这次改为：插件在用户浏览器里直接抓字幕，
天然带着用户当前登录态的 cookie；后端只负责把传过来的字幕当作转写缓存。

extension：
- 新增 logic/bilibili-subtitle.ts，调 /x/web-interface/view → /x/player/wbi/v2 → 字幕 URL JSON
  · service worker fetch 走 credentials:'include'，借 manifest host_permissions:'*://*/*'
    自动带 .bilibili.com 域 cookie，并绕过 CORS
  · 优先级：人工中文 > AI 中文 > 任意非空
- popup start() 与 background startTask() 在 platform === 'bilibili' 时先调一次抓取，
  结果作为 prefetched_transcript 字段塞到 /api/generate_note payload
- types.ts GenerateRequest 增加 prefetched_transcript 字段

backend：
- VideoRequest 增加可选 prefetched_transcript: dict
- generate_note endpoint 收到时调 _persist_prefetched_transcript() 写到
  NOTE_OUTPUT_DIR/<task_id>_transcript.json；NoteGenerator 的 cache-hit 逻辑天然命中，
  跳过 downloader.download_subtitles 和音频转写，直接走 GPT 总结
- 字幕清洗：去掉空 segment、必要时合成 full_text、language 默认 'zh'

效果：B 站登录用户的视频，从用户点击到 GPT 拿到全文，省掉一次后端 → B 站 API 的来回，
也彻底告别了 backend 那侧的 cookie 配置心智负担。

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
 2026-05-07 12:23:16 +08:00
huangjianwuandClaude Opus 4.7 d64741628b ui(extension): 渲染时剥掉 backend 注入的 '> 来源链接：URL' 行 
backend 的 note_helper 会在笔记开头加一行 '> 来源链接：<url>'。侧边栏顶部已经有
封面 + 标题 + 跳原片链接的卡片，再在正文里出现一遍是冗余还吃高度。
MindMap 也会把它当作根节点的兄弟节点，影响导图结构。

加 stripSourceLink() helper（regex 直接复刻 web 端 MarkdownViewer.tsx:468 的处理），
在 MarkdownView 与 MindMap 渲染前剥掉。复制 / 下载导出的 .md 仍保留原行，便于溯源。

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
 2026-05-07 12:18:55 +08:00
huangjianwuandClaude Opus 4.7 bb9637f30a ui(extension): 侧边栏布局收紧，给笔记内容更多呼吸空间 
之前侧边栏堆了：96×56 大封面 + 标题 + URL 链接 + 8 段进度条 + 'Markdown/思维导图/AI 问答' tab + MarkdownView 自带的复制/下载条 + 内容标题 …… 在窄侧栏里太挤，主内容被压到下半屏。

重做：
- 顶栏极简化：左边 'BiliNote'，右边「历史 N」按钮 + 「设置」按钮
- 历史任务从底部 details 改成顶栏触发的下拉面板，用了再展开
- 标题区压成一行：12×7 小封面 + 单行标题（hover 显示完整 URL，点击跳原片）+ 行尾状态徽章
  · 进行中：蓝色阶段名 + 脉冲动画
  · 完成：绿色 ✓
  · 失败：红色徽章 + tooltip 显示原因
- 进度条只在 isRunning 时渲染；完成后整段消失
- 视图 tab 与「复制 / 下载」按钮合并到同一行（仅 markdown 视图显示）
- MarkdownView 加 hideActions prop，去掉它自带的按钮区，避免重复；同时去掉 max-h-[400px]，撑满父容器

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
 2026-05-07 12:15:05 +08:00
huangjianwuandClaude Opus 4.7 0793949516 feat(extension): popup 改紧凑视图，markdown 详情挪到侧边栏 
之前 popup 直接在 400px 宽里渲染 markdown，看起来很挤。改成：
- popup：标题 + 封面缩略图 + 进度条 + 「在侧边栏查看」按钮，不再渲染 markdown
- 提交「生成笔记」后自动调 chrome.sidePanel.open 把侧边栏拉起来
- 最近任务列表显示标题（拿到时）而非 URL
- 新增 logic/api.resolveImageUrl：相对 /static 路径拼后端域名；hdslb / byteimg / kpcdn / ytimg 等带 referer 校验的封面走后端 /api/image_proxy 转发，避免 CORS / 防盗链问题
- 侧边栏顶部同样展示封面 + 标题 + 跳原片链接，方便用户辨识当前任务

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
 2026-05-07 12:11:48 +08:00
huangjianwuandClaude Opus 4.7 e694b460e8 fix(extension): /task_status 拆 ResponseWrapper，进度条不再为空 
backend /api/task_status/{id} 实际形状是 R.success({status, message, task_id, result?})
即外面再套一层 {code, msg, data}。原来 getTaskStatus 直接 fetch().json() 没拆包，
导致 res.status 一直是 undefined，TaskProgress 渲染不出阶段标签、进度条全灰，
"最近任务" 列表的状态字段也是空的。

同时把 backend 任务失败时的 R.error(message, code=500) 翻译成 {status:'FAILED', message}，
让 UI 能正确显示失败终态、停止轮询，而不是被 request() 抛错卡在那里循环重试。

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
 2026-05-07 12:07:45 +08:00
huangjianwuandClaude Opus 4.7 f37d2e95d1 feat(extension): 侧边栏接入思维导图（markmap）与 RAG 问答（P3 + P4） 
任务完成（status === SUCCESS）后，侧边栏顶部出现 Markdown / 思维导图 / AI 问答 三个 tab：

- 思维导图：用 markmap-lib + markmap-view 把 markdown 转成可缩放思维导图
- AI 问答：
  · 进入 tab 自动调 /api/chat/index 触发后台索引，按 2s 间隔轮询 /api/chat/status
  · 索引完成后开放输入框；调 /api/chat/ask 时带上 settings 里的默认 provider/model + 完整 history
  · Cmd/Ctrl + Enter 发送
  · 回答用 markdown-it 渲染，user 气泡用纯文本
- 切换任务时清空对话历史并重新检查索引

logic/api.ts 补 indexChatTask / getChatStatus / askChat 三件套。

依赖新增：markmap-lib, markmap-view（生产依赖）

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
 2026-05-07 12:02:12 +08:00
huangjianwuandClaude Opus 4.7 be5e1637fa fix(mlx-whisper): 修正 huggingface 仓库 ID 命名 
mlx-community 上 Whisper 仓库的命名实际是 'whisper-{size}-mlx'（large-v3-turbo 例外，无 -mlx 后缀）。
之前 hardcode 拼成 'mlx-community/whisper-{size}' 在 HF 上不存在，下载会 404：

  Repository Not Found for url:
    https://huggingface.co/api/models/mlx-community/whisper-small/revision/main.

修复：
- 在 mlx_whisper_transcriber.py 加 MLX_MODEL_MAP（已用 huggingface API 核对过命名）+ resolve_mlx_repo_id() 帮助函数
- routers/config.py 的 _do_download_mlx_whisper 与 _check ... 路径生成都改用同一份映射表
- 给 transcriber_models_status 的每条 mlx 状态加 available 字段，避免后续若有不支持的 size 时静默失败

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
 2026-05-07 11:59:02 +08:00
huangjianwuandClaude Opus 4.7 702b57c165 feat(bilibili): 优先走官方 player API 直拉字幕 
之前 BilibiliDownloader.download_subtitles 走的是 yt-dlp 的 writesubtitles 路径，对 B 站签名/Cookie 的兼容性差，常常空手而归，落到音频下载 + Whisper 转写的慢路径。

新增 bilibili_subtitle.BilibiliSubtitleFetcher：
- /x/web-interface/view?bvid=... → 拿 cid
- /x/player/wbi/v2?bvid=...&cid=... → 拿 subtitle 列表（subtitle_url 已带 auth_key）
- 优先级：人工中文 > AI 中文 > 任意中文 > 任意非空
- fetch JSON body 解析为 TranscriptResult
- 通过 CookieConfigManager 自动注入 SESSDATA cookie（AI 字幕必需）

bilibili_downloader.download_subtitles 顺序改为：先试新 fetcher，失败再回退到原 yt-dlp 路径。NoteGenerator 的字幕优先逻辑无需改动——它本来就调 download_subtitles。

效果：
- B 站视频如果有字幕（人工或 AI），直接秒拿，跳过音频下载 + 转写
- 完全绕开 MLX Whisper 不可用 / 模型未下载 等转写器问题
- 拿不到字幕时仍可走原音频转写路径

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
 2026-05-07 11:55:50 +08:00
huangjianwuandClaude Opus 4.7 3bd8b670ca feat(extension): options 改为多 tab，搬入 web 端的全部设置项 
把原来一长条的 options 拆成五个 tab，覆盖 web 端 SettingPage 的全部能力。今后新功能优先在插件里做，web 端逐步退役。

- 通用：后端地址 + 默认供应商/模型 + 默认生成选项（原 Options.vue 内容）
- 模型供应商：完整 CRUD —— 列表 / 启用切换 / 编辑 / 测试连接 / 添加 / 模型增删
- 音频转写配置：转写器引擎切换（fast-whisper / mlx-whisper / Groq / 必剪 / 快手）+ Whisper 模型大小切换 + 模型本地下载状态 + 触发下载
  · 直接修复 'MLX Whisper 不可用' 报错——非 Mac 用户现在能切到 fast-whisper / Groq
- 下载配置：每平台 cookie 显示 / 浏览器一键同步 / 手动粘贴保存
- 部署监控：后端、FFmpeg、CUDA、Whisper 模型 当前状态

logic/api.ts 补齐：provider CRUD / model CRUD / connect_test / transcriber_config / transcriber_models_status / transcriber_download / get_downloader_cookie / deploy_status / sys_health。

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
 2026-05-07 11:53:08 +08:00
huangjianwuandClaude Opus 4.7 880587f2db feat(extension): P2 视频页悬浮按钮 + 右键菜单 + cookie 直通；P3 侧边栏首版 
- contentScripts: 仅在支持的视频平台（B 站 / YouTube / 抖音 / 快手）注入悬浮 BiliNote 按钮，点击通过 webext-bridge 发 'bilinote-start' 给 background
- background: 处理 bilinote-start 与右键菜单点击；调 /api/generate_note；写 chrome.storage；自动打开侧边栏。logic/storage 是 Vue 反应式版本，service worker 不能 import，因此把常量抽到 logic/constants.ts
- contextMenus: onInstalled 时注册"用 BiliNote 总结此视频"，限定 4 个支持平台域名
- 浏览器 Cookie 同步：options 页加按钮，按平台读 chrome.cookies.getAll，序列化为 'name=value; ...' 后 POST 给后端 /api/update_downloader_cookie。chrome.cookies + contextMenus 权限补到 manifest
- 侧边栏（P3 首版）：从 storage 读最近任务并轮询，复用 TaskProgress + MarkdownView。markmap 思维导图与 RAG 问答推到后续
- 修 P1 endpoint 拼错的 bug：/api/get_models_by_provider 实际是 /api/model_enable，404 来自这里

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
 2026-05-07 11:46:09 +08:00
huangjianwuandClaude Opus 4.7 b8f359e7e7 feat(extension): 浏览器插件 P1 MVP 
新建 BillNote_extension/ 工作空间（基于 vitesse-webext 骨架，Vue 3 + Vite + UnoCSS + MV3）。

P1 MVP 范围：
- popup：自动读当前 tab URL，识别 Bilibili / YouTube / 抖音 / 快手；提交 /generate_note 后轮询 /task_status；展示 markdown，复制 + 下载 .md
- options：后端地址输入与连通性测试；从 /get_all_providers + /get_models_by_provider 拉供应商/模型列表；默认画质、截图/跳转、笔记风格
- chrome.storage.local 持久化设置与最近 30 个任务，popup 重开恢复进行中任务
- markdown 里的 /static/screenshots 路径在渲染前重写为绝对地址

后端：CORS 改用 regex，新增允许 chrome-extension:// 与 moz-extension:// 源（同时保留 localhost / 127.0.0.1 / tauri.localhost）。无新增 backend endpoint。

P2-P4（content script 悬浮按钮、cookie 直通、side panel、思维导图、RAG 问答）保留 stub 文件，不在本次范围。

去掉 vitesse-webext 自带的 simple-git-hooks postinstall 配置——它会在仓库根装 pre-commit 钩子去跑 pnpm lint-staged，但仓库根没有 package.json，会破坏所有提交流。

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
 2026-05-07 11:40:15 +08:00
huangjianwuandClaude Opus 4.7 108ad270bf fix: 修复 AILogo 噪音、设置页滚动与供应商批量伪内置脏数据 
- AILogo: `custom` 名称为合法兜底场景，不再以 console.error 上报；其余未匹配名称降级为 console.warn
- SettingPage/Model: 双栏加 `min-h-0 overflow-y-auto`，让供应商列表与右侧表单各自可滚动
- ProviderService.add_provider: API 创建一律落到 `type='custom'`，并对同名供应商抛 ValueError，避免再产生伪内置行
- CLAUDE.md: 补充 v2.0.0 子系统（RAG/Chat、可选 Nacos+RabbitMQ、i18n、cookie/transcriber 管理器）

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
 2026-05-07 11:10:15 +08:00
huangjianwuandClaude Sonnet 4.6 499366da02 fix(docker): 优化 Vite 配置以支持 Docker 构建环境 
- 修改 vite.config.ts 在 Docker 环境中使用当前目录加载 .env 文件
- 在 Dockerfile 中设置 DOCKER_BUILD 环境变量
- 移除不必要的 .env.example 复制步骤

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-03-23 18:54:16 +08:00
huangjianwuandClaude Sonnet 4.6 cb5c11d41a fix(ci): 移除 pnpm install 的 --frozen-lockfile 标志 
由于不提交 pnpm-lock.yaml 文件，移除 --frozen-lockfile 标志以修复桌面端构建失败

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-03-23 18:50:48 +08:00
huangjianwuandClaude Sonnet 4.6 8e2f74c0f5 fix(frontend): 修复 ESM 模式下 __dirname 未定义的问题 
在 vite.config.ts 中添加 ESM 兼容的 __dirname 定义，修复 Docker 构建时的配置加载错误

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-03-23 18:46:53 +08:00
huangjianwuandClaude Sonnet 4.6 c0f978bd77 fix(docker): 修复前端构建时缺少 .env 文件的问题 
在构建前端之前复制 .env.example 到父目录，供 vite.config.ts 加载环境变量使用

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-03-23 18:42:34 +08:00
huangjianwuandClaude Sonnet 4.6 4bff57c774 fix(docker): 修复 apt-get 安装失败问题 
将清华镜像源从 https 改为 http 协议，避免 SSL 证书验证问题导致的 apt-get update 失败

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-03-23 18:36:22 +08:00
huangjianwuandClaude Sonnet 4.6 341d3ded06 chore: 删除 ffmpeg 二进制文件并更新 .gitignore 
移除错误提交的 301MB ffmpeg 构建文件，并在 .gitignore 中添加 ffmpeg*/ 规则防止再次提交

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-03-23 18:31:32 +08:00
huangjianwuandClaude Sonnet 4.6 6d5d1ad373 fix(ci): 修复 GitHub Actions 构建错误 
移除 setup-node 中的 pnpm 缓存配置以修复 macOS 构建失败，修改 Dockerfile 不再依赖 pnpm-lock.yaml 以修复 Docker 构建失败

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-03-23 18:11:55 +08:00
huangjianwuandClaude Opus 4.6 3582e65dc5 feat(ci): 桌面端构建自动创建 GitHub Release 并附带安装包 
- 新增 release job：等所有平台构建完成后自动创建 Release
- 收集各平台产物（dmg/msi/exe/deb/AppImage）到统一目录
- 使用 softprops/action-gh-release 创建 Release 并上传产物
- 自动生成 SHA256 校验和文件
- 自动根据 commits 生成 Release Notes
- 仅在推送 tag 时触发 Release 创建

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-03-23 17:58:57 +08:00
huangjianwuandClaude Opus 4.6 6090982261 docs: 更新 README 至 v2.0.0，补充新功能说明和 Docker 部署方式 
- 版本号升级为 2.0.0（README、tauri.conf.json、about 页面）
- 新增 v2.0.0 功能说明：RAG 问答、Function Calling、封面 Banner、面板折叠等
- Docker 部署改为推荐方式，支持 docker pull 预构建镜像
- 补充源码部署为方式二，修正前端访问端口为 3015
- 更新功能特性列表，补充快手、AI 问答等新功能
- TODO 标记 RAG 问答为已完成

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-03-23 17:52:30 +08:00
huangjianwuandClaude Opus 4.6 f6a3438079 feat(build): 全面优化打包流程，Docker 镜像自动发布到 GHCR 
Docker 优化：
- Dockerfile 层缓存（requirements/lockfile 先复制再安装）
- ARG 可配置镜像源，国际用户可覆盖为默认源
- 前端 Dockerfile 改用 corepack + frozen-lockfile
- 精简 .dockerignore，排除 .git 和 Tauri 构建产物

CI/CD 优化：
- docker-build 自动推送到 GHCR，支持 amd64/arm64 双架构
- 桌面端 CI 增加 pip/pnpm/cargo 缓存，升级 actions 版本
- Python 版本对齐为 3.11，增加 Linux 构建矩阵
- build.sh 加 -y 覆盖标志

文档更新：
- README Docker 部署简化为 docker pull + docker run

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-03-23 17:48:34 +08:00
huangjianwuandClaude Opus 4.6 f4801d5be7 feat(youtube): 使用 youtube-transcript-api 优先获取字幕，有字幕时跳过音频下载 
- 新增 YouTubeSubtitleFetcher 模块，通过 youtube-transcript-api 获取字幕
- 重构笔记生成流程：缓存 → 平台字幕 → 按需下载 → 转写 fallback
- 有字幕时仅提取视频元信息，不下载音视频文件
- 添加 youtube-transcript-api 依赖

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-03-23 17:31:30 +08:00
huangjianwuandClaude Opus 4.6 27758f95dd feat(ui): 工作区和生成历史面板支持折叠/展开 
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-03-23 16:09:57 +08:00
huangjianwuandClaude Opus 4.6 795615f0f7 fix(ui): 修复 Banner 封面图不显示 
MarkdownViewer 的 baseURL 去掉了 /api 前缀，导致
image_proxy 请求路径错误。改为组件内部直接读取
VITE_API_BASE_URL，与 NoteHistory 保持一致。

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-03-23 15:59:02 +08:00
huangjianwuandClaude Opus 4.6 c46c971e64 fix(ui): Banner 封面通过后端代理加载，移除来源链接模块 
- 封面图通过 /image_proxy 代理请求，解决 B 站等 CDN 跨域问题
- 渲染 markdown 时过滤掉开头的「来源链接」行，
  该信息已由 VideoBanner 的「原视频」按钮替代

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-03-23 15:56:48 +08:00
huangjianwuandClaude Opus 4.6 55cc3bcd63 feat(ui): 笔记顶部新增视频封面 Banner 
- 视频封面做模糊暗色背景，上方叠加视频信息
- 显示视频标题、作者/UP主、平台
- 右侧「原视频」按钮跳转原始链接
- 无封面时降级为渐变背景

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-03-23 15:54:36 +08:00
huangjianwuandClaude Opus 4.6 05877a2197 feat(chat): 支持 function calling，模型可主动查询原文数据 
新增三个工具供 LLM 调用：
- lookup_transcript: 查询转录原文（按时间范围、关键词、位置筛选）
- get_video_info: 获取视频元信息（标题、作者、简介、标签等）
- get_note_content: 获取完整笔记 Markdown 内容

实现 tool calling 循环（最多 3 轮），LLM 可根据问题
主动调用工具获取所需信息，不再完全依赖 RAG 检索。

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-03-23 15:48:23 +08:00
huangjianwuandClaude Opus 4.6 3e9f908d7b fix(chat): 按固定配额检索，确保三种来源均被召回 
之前各来源各取 n_results 条再按距离排序取 top-n，
markdown 距离普遍更近导致 transcript 被挤掉。
改为固定配额：meta 1 条、markdown 2 条、transcript 3 条。

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-03-23 15:44:25 +08:00
huangjianwuandClaude Opus 4.6 8a8e448e22 feat(chat): 索引视频元信息（标题、作者、简介、标签等） 
- 新增 _build_meta_chunk，将 audio_meta 中的标题、UP主、
  简介、标签、时长、平台、链接等构建为可检索的 chunk
- query 时同时从 meta/markdown/transcript 三种来源检索
- is_indexed 检测旧索引缺少 meta 时返回 false，自动触发重建
- system prompt 新增 [视频信息] 来源说明

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-03-23 15:41:07 +08:00
huangjianwuandClaude Opus 4.6 a92c779dd6 fix(chat): RAG 检索同时召回笔记和转录内容 
之前 query 只做一次全局检索，embedding 模型倾向匹配笔记，
导致转录原文几乎不会被召回。

- 改为分别对 markdown 和 transcript 各检索 n_results 条，
  合并后按距离排序取 top-n
- 更新 system prompt，明确区分笔记和转录两种来源，
  引导 LLM 根据问题类型选择合适的来源回答

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-03-23 15:35:31 +08:00
huangjianwuandClaude Opus 4.6 ef1dec1e47 feat(chat): AI 回复支持 Markdown 渲染 
通过 Bubble role 的 contentRender 使用 ReactMarkdown
渲染 AI 回复内容，支持列表、加粗、代码块等格式。

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-03-23 15:31:55 +08:00