bilinote-cli 0.1.0__py3-none-any.whl

bilinote_cli-0.1.0.dist-info/METADATA

@@ -0,0 +1,205 @@
+Metadata-Version: 2.4
+Name: bilinote-cli
+Version: 0.1.0
+Summary: AI 视频笔记生成 CLI 工具
+License-File: LICENSE
+Requires-Python: >=3.12
+Requires-Dist: bilibili-api-python>=17.4.1
+Requires-Dist: browser-cookie3>=0.20.1
+Requires-Dist: ffmpeg-python>=0.2.0
+Requires-Dist: gmssl>=3.2.2
+Requires-Dist: httpx>=0.28.1
+Requires-Dist: keyring>=25.7.0
+Requires-Dist: openai>=2.32.0
+Requires-Dist: pillow>=12.2.0
+Requires-Dist: pydantic>=2.13.2
+Requires-Dist: pyyaml>=6.0.3
+Requires-Dist: requests>=2.33.1
+Requires-Dist: youtube-transcript-api>=1.2.4
+Requires-Dist: yt-dlp>=2026.3.17
+Description-Content-Type: text/markdown
+
+# BiliNote-CLI
+[English](README.en.md) | 简体中文
+
+AI 视频笔记生成工具 - 让 AI 为你的视频做笔记
+
+> **项目说明**：本项目基于 [BiliNote](https://github.com/JefferyHcool/BiliNote) fork 并进行大量重构。  
+> 原项目采用 MIT 许可证，感谢原作者 Jeffery Huang 的杰出工作。
+
+
+## 功能
+
+让 ai 自动把视频转换为 markdown 格式笔记
+- 多平台支持：Bilibili、YouTube、抖音、快手、本地视频
+- AI 笔记生成：支持 DeepSeek、OpenAI、Qwen 等
+- 截图插入、视频跳转链接、多模态理解
+- 批量执行、关键词搜索
+
+## 安装
+
+```bash
+# 安装 CLI
+cd BiliNote-cli
+uv tool install .
+
+# 安装 FFmpeg（必需）
+brew install ffmpeg  # macOS
+winget install ffmpeg # Windows
+# Windows还可以：从 ffmpeg.org 下载，解压后，再将 bin 文件夹路径添加到系统环境变量 PATH 中
+```
+
+## 配置
+
+```bash
+# 设置 API Key（必需）
+bilinote config set DEEPSEEK_API_KEY sk-your-api-key
+
+# 设置 Cookie（推荐，用于获取平台字幕、避免被反爬虫）
+bilinote config set BILIBILI_COOKIE "SESSDATA=xxx; ..."
+
+# 查看配置状态
+bilinote config list
+```
+
+
+非敏感配置在 `~/.bilinote/config.yaml`：
+```yaml
+transcriber:
+  default_type: "bcut" # 默认音频转写器
+  whisper_model_size: "base"
+```
+
+### 【教程】提取 Safari Cookie
+
+1. 打开 Safari 的开发者模式。
+2. 在浏览器中打开目标网站，按 F12（或 Cmd + Opt + I）打开开发者工具。
+3. 切换到 **Network (网络)** 标签页。
+4. 刷新页面，随便找一个请求，**右键**点击该请求。
+5. 选择 **Copy** -> **Copy as cURL**。
+6. 在你的剪贴板里，你会看到一串完整的命令，其中 `-H 'cookie: ...'` 后面就是该网站的所有 Cookie。
+
+## 使用
+
+```bash
+# 基础用法
+bilinote process "https://www.bilibili.com/video/BV1mQ9jBcEf4"
+
+# 带截图和链接
+bilinote process "<url>" --screenshot --link --style 学术风
+
+# 多模态理解（AI 看画面）
+bilinote process "<url>" --video-understanding --model gpt-4o
+
+# 自定义输出目录
+bilinote process "<url>" --output-dir ./notes/
+
+# 搜索视频
+bilinote search "Python 教程" --platform bilibili
+
+# 其他命令
+bilinote model-list            # 列出可用模型
+bilinote model-set-default deepseek  # 设置默认模型
+```
+
+## 命令说明
+
+| 命令 | 说明 |
+|------|------|
+| `process <url>` | 处理视频生成笔记 |
+| `search <keyword>` | 搜索视频并批量生成 |
+| `model-list` | 列出可用模型 |
+| `model-set-default <model>` | 设置默认模型 |
+| `config set <key> <value>` | 设置密钥 |
+| `config list` | 查看配置状态 |
+
+### process 参数
+
+| 参数 | 说明 |
+|------|------|
+| `--model` | AI 模型，如 `deepseek-chat`, `gpt-4o` |
+| `--quality` | 音频质量：`fast`, `medium`, `slow` |
+| `--screenshot` | 插入视频截图 |
+| `--link` | 插入视频跳转链接 |
+| `--style` | 笔记风格：学术风、口语风等 |
+| `--video-understanding` | 启用多模态理解 |
+| `--output` | 输出文件路径 |
+
+## 目录结构
+
+```bash
+~/.bilinote/ #windows： C:\Users\<user_name>\.bilinote\
+├── data/
+│   ├── downloads/     # 下载的音频
+│   ├── cache/         # 转写缓存
+│   ├── output/notes/  # 生成的笔记★
+│   └── state/         # 任务状态
+├── config.yaml        # 用户配置★
+└── logs/
+```
+
+## 【指南】配置 whisper-cpp 作为本地音频转写器
+
+### macOS 安装 whisper.cpp 指南
+
+#### 1. 安装 whisper-cpp
+```bash
+brew install whisper-cpp
+```
+#### 2. 下载模型
+```bash
+# 创建目录并进入
+mkdir -p ~/whisper-models && cd ~/whisper-models
+# 下载模型（以 base 模型为例）
+curl -L -o ggml-base.bin 'https://huggingface.co/ggerganov/whisper.cpp/resolve/main/ggml-base.bin?download=true'
+```
+- 或：到 [huggingface 网站](https://huggingface.co/ggerganov/whisper.cpp/tree/main) 下载 whisper 模型。手动移动到模型存储目录。
+- ⚠️ **注意**：如果你选择把模型放入其他目录，那么需在 `config.yaml` 内修改模型地址。
+
+### Windows 安装 whisper.cpp 指南
+
+#### 1. 下载程序
+
+- 访问 [whisper.cpp Github Releases 页面](https://github.com/ggerganov/whisper.cpp/releases)
+- 下载软件压缩包：
+	- CPU 版：`whisper-bin-x64.zip`
+	- NVIDIA 显卡加速版：`whisper-cublas-12.4.0-bin-x64.zip`
+- 解压到固定目录，如 `D:\ProgramFiles\whispercpp`
+
+#### 2. 下载模型
+
+- 访问 [Huggingface 模型页面](https://huggingface.co/ggerganov/whisper.cpp/tree/main)
+- 下载 `ggml-base.bin`（或其他模型）
+- 建议放入 `D:\ProgramFiles\whispercpp\models\`
+
+#### 3. 添加到 PATH
+
+以**管理员**身份打开命令提示符，执行：
+```cmd
+setx /M PATH "D:\ProgramFiles\whispercpp;%PATH%"
+```
+
+- ⚠️ **注意**：上面的 `D:\ProgramFiles\whispercpp` 需替换为 `whisper-cli.exe` 所在的目录。
+- **重启命令提示符**后生效。  
+- 验证是否安装成功：`whisper-cli --help`
+- 如果安装遇到问题，建议手动在系统环境变量中添加。
+
+### 配置 whisper-cpp（macOS / Windows 通用）
+
+在 `config.yaml` 中填写模型文件（如`ggml-base.bin`）的路径：
+
+```yaml
+
+transcriber:
+  default_type: "whisper-cpp"
+  whisper-cpp:
+    model_path: "D:/ProgramFiles/whispercpp/models/ggml-base.bin"  # Win
+    # model_path: "~/whisper-models/ggml-base.bin"                 # macOS
+```
+
+- ⚠️ **注意**：地址应该使用 `/` 而不是 `\`
+- ⚠️ **注意**：如果模型放在其他位置，`model_path` 需相应修改。
+
+## License
+
+MIT

bilinote_cli-0.1.0.dist-info/RECORD

@@ -0,0 +1,89 @@
+src/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+src/cli.py,sha256=ntGHEGqU8wGg9OP6x3eAdjv79Kxcl7u7zkzlg3Ve0kw,22538
+src/ffmpeg_helper.py,sha256=G8HG5vKjcP47WojunOeHZX9fVHiFuvIQ5j7MVwwEJ3o,2097
+src/app/config_manager.py,sha256=WGstP1m6ZUvPVgtXr2Oc-ifAWK23ah8uAGNdrQBC11M,10212
+src/app/secret_manager.py,sha256=JgZ9TMuMTjx8tia2BjnhiEMWhc3NdM9I57X-nwaD5Zg,3370
+src/app/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+src/app/decorators/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+src/app/decorators/timeit.py,sha256=xCxkqASysjs8XfTJRp5O4PRsv-v3ubd8Ilw8qOh30vE,418
+src/app/downloaders/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+src/app/downloaders/base.py,sha256=b63JEpNTXFe-YKNaRsjL-qdeBrCSa_5cKhwhqsZ-Y_Y,1663
+src/app/downloaders/bilibili_downloader.py,sha256=mZO79Mu2VbX-CB2rIIiJq8fKA2p2fWwg_WQkc_s6QBQ,13349
+src/app/downloaders/common.py,sha256=3PZFCaeZbClO1Nd92A3dsaloBf1NR7ED5k3SorexaaU,18
+src/app/downloaders/douyin_downloader.py,sha256=rN2rtWncEz0ThS6Y3sWEBqlFTJsEyFpTt2C8IrwY9Dc,14627
+src/app/downloaders/kuaishou_downloader.py,sha256=c-aBOMhwiT6F6yucg_sbhQLS2LZm96cvoDBvnLOpxtg,3377
+src/app/downloaders/local_downloader.py,sha256=SMbdZYJvoa6XeGObjJoDiQBL8ziYIQKSk4Qzi3iuC-8,4973
+src/app/downloaders/xiaoyuzhoufm_download.py,sha256=f4cezJ1S2KhCo18D559CjXqQTwsWECxaUCoyhiBO6aI,822
+src/app/downloaders/youtube_downloader.py,sha256=NPWOO6KQH1coHh3Em-OyljPKNBu1ugUuZ6ja_OJ9PFw,4132
+src/app/downloaders/youtube_subtitle.py,sha256=OpMzi8CuXikx5kABnxiy9esZHVeDkn9c_vw_Cr1j8dY,3784
+src/app/downloaders/douyin_helper/abogus.py,sha256=hIczkIx66XuR-VaXhM8iJVz_kKjEJnh87jUMaSAR_k4,17980
+src/app/downloaders/kuaishou_helper/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+src/app/downloaders/kuaishou_helper/kuaishou.py,sha256=G5XwYDwOWaSNgHsw_itYFSr9vkQCnwULoKYOg1uSg_k,4914
+src/app/enmus/exception.py,sha256=K2-0TKu2wW5w0yrzIWCQ2sw9bFYkL9UJTiPQ4TD3hTY,679
+src/app/enmus/note_enums.py,sha256=B2TXZyfjyK9OR-a3ymkF-1MfifxXLBVg1dT4S2ksrus,111
+src/app/enmus/task_status_enums.py,sha256=yRgcBmZj3NzibVbsJWU4rDKsW2bumG9boZklVGZkxWQ,783
+src/app/exceptions/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+src/app/exceptions/biz_exception.py,sha256=kroC6RlhauYcoFrca_-u5GUZiA3xmm_bkdnojBn8cgA,183
+src/app/exceptions/note.py,sha256=MGBg6JMobfaLdo42nzEWCjofD1du1lns7oFCTSDLHCQ,253
+src/app/exceptions/provider.py,sha256=MUqP4eaJhoCNOTl0kusBS4rYStV1zQnIe9rJG0ib7aw,277
+src/app/gpt/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+src/app/gpt/base.py,sha256=O3ruJfFJ3qQaPsHViMTSApW2v4fRBS2L5LB4MV-xlTs,338
+src/app/gpt/gpt_factory.py,sha256=bc8x0ECE1WsgP9rlcrCid5xDyIvph-3rT456wQcT-qc,489
+src/app/gpt/prompt.py,sha256=XIeSsbsCWCXQ1TKeD0WxDqFziA8i6gkzAJ-6d1qoeTE,2946
+src/app/gpt/prompt_builder.py,sha256=2YOI73E2F2GlBDF2BH7XBMaXNU91uKdpOkQ3n4ZEO_0,5418
+src/app/gpt/request_chunker.py,sha256=3Mxn7EZqhBoz-GX56Srbf74aOV0mWGGj8Y3xhsP3x7A,6034
+src/app/gpt/universal_gpt.py,sha256=5IKvHRw4NM5qBJXs2fG2e9dVThlzT-ykHCrAPzICIXI,13534
+src/app/gpt/utils.py,sha256=EMw4iPrRJZc0XTnwuiO66E2AdbjSiHafYWkWiMYKF8c,107
+src/app/gpt/provider/OpenAI_compatible_provider.py,sha256=_yaJ7VIRFD8GXxGvumDZ27VJ8gbJ_k9dcZaNbIQ0sLU,951
+src/app/models/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+src/app/models/audio_model.py,sha256=I_U9F6zKTbsr4HUWA23p7a_GQEmjmhbFKQg5rWKKq9s,567
+src/app/models/gpt_model.py,sha256=f_rgUKQJX5hIcFqZUgG-Mk9uwdGB0OfmvY8qS8_za9E,500
+src/app/models/model_config.py,sha256=ZP8QO4GkyQreBFW0op4Lj70GmH9hkBUzH2Swfbcap-4,757
+src/app/models/notes_model.py,sha256=nJDqBS7FzWnmeuVtnN67UhswXrgj0-tZd6PavGv3Jtc,442
+src/app/models/pipeline_model.py,sha256=s8tBFcHTqvbFY6YtNrddgee5AIO-sBfC680TrTauQL0,812
+src/app/models/provide_model.py,sha256=74r5Anoq2YgOKLqNjdkL7J86u3-OF5fb_-IynoljAXY,708
+src/app/models/transcriber_model.py,sha256=YasqQlXKVZU0n3kR9GfrkvMvDoYRFespnJGcytr9RBo,636
+src/app/models/video_record.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+src/app/services/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+src/app/services/batch_processor.py,sha256=cKH-OmLJA_r9qfxdFnw2iQZwAAaFFyQpkXj4RgN9Xuc,12985
+src/app/services/constant.py,sha256=qqsay72goXNDdFrd9S4k8vZGm30-72iIx5oiiu-rA64,716
+src/app/services/note.py,sha256=Ztdh3AcG3xSVYeZafXHq0kvsPw5NPWdK4jt6DEgRjqs,5045
+src/app/services/postprocessing.py,sha256=PGBYWAam0z1OcI_5KgF50wUhtlIH_SAOaAvuP5vAbQo,2048
+src/app/services/searcher.py,sha256=yNsxiUNgm43eKlb8Ygm5bKxoRET8IZSBaTBzk5_Jbfs,3703
+src/app/services/serial_executor.py,sha256=BmdUWc9075Pcv9-70L9teFGq4Wok-Riq28ESWUzplzA,440
+src/app/services/cache/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+src/app/services/cache/task_cache.py,sha256=Onx95-gsxecUCIJlCnrG-hn6Of7re7_xu7CoKeskz7U,4814
+src/app/services/pipeline/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+src/app/services/pipeline/ai_processor.py,sha256=EmRcl42PLUGIY68ahz1buvc_CbpauHjR-TvsZBJ8Td0,3866
+src/app/services/pipeline/preparer.py,sha256=xU3wvo75TJA198Vn-ZuSyb053lOujlaP4uaKOIpIH9A,10610
+src/app/transcriber/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+src/app/transcriber/base.py,sha256=7-7mnXW7QWZi-hznS6rw__K0pzKfyCQnxfgrlCpROEg,325
+src/app/transcriber/bcut.py,sha256=l4G7yhP3KbW4bTyDAdhTlB8s-9vFpc2ZRqdjfjWhzdc,8575
+src/app/transcriber/groq.py,sha256=rn0MURUGDelSokFKnlr-gfRu83QRG2j8ZG60O2LpkpQ,2721
+src/app/transcriber/kuaishou.py,sha256=JpeucAnQ0kzp5uLJyZxiPmSFplbyzWL0sa5V9Rk3Sv0,3806
+src/app/transcriber/transcriber_provider.py,sha256=xldB30Cdf-qbPy9_RZ7zg7C7yzMwzKf-SquY2--o8p8,4243
+src/app/transcriber/whisper_cpp.py,sha256=bJGC5qK-TKUv1W2f3PsG7DqVkDqRngg0Kx-4sfXaw7Y,4218
+src/app/utils/cookie_helper.py,sha256=rnkNTV5MfAI3M03IyDVLHNZucrlLbl8BFb2tfHnO4sk,434
+src/app/utils/env_checker.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+src/app/utils/file_cleanup.py,sha256=bJPxvz_5nOux4-UfSAug3Km7wAr_4MV8XTu2UYT75Lo,1142
+src/app/utils/logger.py,sha256=qOg1f5RMHW-bv5Aklb7FLAKlLklpASIeQFAqf-0fsxw,1095
+src/app/utils/note_helper.py,sha256=XakHdblX4dyXFbPqp7qMYW07PZFcs1973FHxrp22RdY,2407
+src/app/utils/path_helper.py,sha256=S0qRkVa_aFr3atL8ujic3wiGyj86B9HWk0uajp0Qq00,5798
+src/app/utils/screenshot_marker.py,sha256=ucR4B0xsHl3I-zGl23Z8T6HAqrUUg_AAy_UWYIYugb8,494
+src/app/utils/status_code.py,sha256=_g9QNLamsBKfab2ivBp4ia-D_lwbT2tlYK_-EW1Uvik,209
+src/app/utils/url_parser.py,sha256=YWSve0g4mH0_25pxBoaaAeUN7orXUTUciXuwRhJi_Pk,2253
+src/app/utils/video_helper.py,sha256=n6PnK-kqqI8Usd9v0fd1iJZhxX6ZxmagcNWnoPoH_Fc,2207
+src/app/utils/video_reader.py,sha256=xpZps6o34_DzCP_Zr9MWdkO4wG2R8EUR0RI_oa8sMDk,8111
+src/app/validators/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+src/app/validators/video_url_validator.py,sha256=syKDVAHDUDC_h62_NvGNZ8Tq1DTXKRKQecsi7R5A43Y,1051
+src/config/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+src/config/config.yaml.example,sha256=7Qh1DSDg4M1eQu1sP1n1xZ5HFocaqzWHSUW1kWryZm0,1392
+src/config/dev_config.json,sha256=Qm28vNH8i1SVTNbpte9L5yQ0RZVZbfAwx3DcKpFcu-w,79
+src/config/model_config_manager.py,sha256=gOv6UFIoiocl8O-hNcq1MP2V9-f9Z2iyLOFi1jcOr-Y,6884
+src/config/models.json,sha256=cBr4Rd99Ctvlw7TV1Wowr6N3wqaFLT4A8wAWuF_tzTk,2471
+src/config/transcriber.json,sha256=ULE5bkegXwTxOM5QBVy3jkrUjIvSWLZyLsRQgsUpYdQ,862
+bilinote_cli-0.1.0.dist-info/METADATA,sha256=yn5c5eBLzQNHlbyuAiYbqGbTILw58o0TBQSV3vhaipw,6240
+bilinote_cli-0.1.0.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+bilinote_cli-0.1.0.dist-info/entry_points.txt,sha256=jUTT2VYH131wUA3I179HSGGASG_pgNsWntm-r_QrrC0,42
+bilinote_cli-0.1.0.dist-info/licenses/LICENSE,sha256=6v2Mq4O6Bfqb0qIs4w6Q4-xbV5bWzaSYozkI7cxO58g,1071
+bilinote_cli-0.1.0.dist-info/RECORD,,

bilinote_cli-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.29.0
+Root-Is-Purelib: true
+Tag: py3-none-any

bilinote_cli-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+bilinote = src.cli:main

bilinote_cli-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Jeffery Huang
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

src/app/config_manager.py

@@ -0,0 +1,287 @@
+"""
+配置管理器
+使用 YAML 文件管理非敏感配置，存储在 ~/.bilinote/config.yaml
+同时加载 transcriber.json 作为转写器默认配置
+"""
+import json
+import logging
+import os
+import platform
+from pathlib import Path
+from typing import Any, Optional, Dict, List
+
+import yaml
+
+logger = logging.getLogger(__name__)
+
+def _get_config_example_path() -> Path:
+    """获取 config.yaml.example 模板文件路径"""
+    # 从当前文件位置推导: app/config_manager.py -> src/config/config.yaml.example
+    base_dir = Path(__file__).parent.parent
+    return base_dir / "config" / "config.yaml.example"
+
+
+def _get_default_config() -> str:
+    """根据操作系统读取配置模板并填充占位符"""
+    example_path = _get_config_example_path()
+    if not example_path.exists():
+        raise FileNotFoundError(f"配置文件模板不存在: {example_path}")
+
+    template = example_path.read_text(encoding="utf-8")
+
+    
+
+    # macOS 默认 whisper 模型路径
+    if platform.system() == "Darwin":
+        default_whisper_model_path = str(Path.home() / "whisper-models" / "ggml-base.bin")
+    else:
+        default_whisper_model_path = ""
+
+    # 填充占位符
+    return template.format(
+        default_whisper_model_path=default_whisper_model_path,
+        example_whisper_model_path="~/whisper-models/ggml-base.bin",
+    )
+
+
+def _get_config_path() -> Path:
+    """获取配置文件路径"""
+    bilinote_home = Path.home() / ".bilinote"
+    return bilinote_home / "config.yaml"
+
+
+def _deep_merge(base: dict, override: dict) -> dict:
+    """深度合并字典，override 覆盖 base"""
+    result = dict(base)
+    for key, value in override.items():
+        if key in result and isinstance(result[key], dict) and isinstance(value, dict):
+            result[key] = _deep_merge(result[key], value)
+        else:
+            result[key] = value
+    return result
+
+
+def _get_by_path(data: dict, path: str, default: Any = None) -> Any:
+    """通过点号路径获取嵌套字典值，如 'models.openai.base_url'"""
+    keys = path.split(".")
+    current = data
+    for key in keys:
+        if not isinstance(current, dict) or key not in current:
+            return default
+        current = current[key]
+    return current
+
+
+def _set_by_path(data: dict, path: str, value: Any) -> dict:
+    """通过点号路径设置嵌套字典值"""
+    keys = path.split(".")
+    current = data
+    for key in keys[:-1]:
+        if key not in current or not isinstance(current[key], dict):
+            current[key] = {}
+        current = current[key]
+    current[keys[-1]] = value
+    return data
+
+
+def _load_default_config() -> dict:
+    """加载默认配置"""
+    return yaml.safe_load(_get_default_config())
+
+
+def _get_transcriber_json_path() -> Path:
+    """获取 transcriber.json 路径"""
+    # 从当前文件位置推导: app/config_manager.py -> src/config/transcriber.json
+    base_dir = Path(__file__).parent.parent
+    return base_dir / "config" / "transcriber.json"
+
+
+def _load_transcriber_defaults() -> dict:
+    """加载 transcriber.json 作为默认配置"""
+    path = _get_transcriber_json_path()
+    if not path.exists():
+        return {}
+    try:
+        with open(path, "r", encoding="utf-8") as f:
+            return json.load(f)
+    except Exception as e:
+        logger.warning(f"加载 transcriber.json 失败: {e}")
+        return {}
+
+
+def _get_dev_config_json_path() -> Path:
+    """获取 dev_config.json 路径"""
+    base_dir = Path(__file__).parent.parent
+    return base_dir / "config" / "dev_config.json"
+
+
+def _load_dev_config_defaults() -> dict:
+    """加载 dev_config.json 作为开发者默认配置"""
+    path = _get_dev_config_json_path()
+    if not path.exists():
+        return {}
+    try:
+        with open(path, "r", encoding="utf-8") as f:
+            return json.load(f)
+    except Exception as e:
+        logger.warning(f"加载 dev_config.json 失败: {e}")
+        return {}
+
+
+class ConfigManager:
+    """YAML 配置管理器，单例模式"""
+
+    _instance: Optional["ConfigManager"] = None
+
+    def __init__(self):
+        self._config_path = _get_config_path()
+        self._config: Optional[dict] = None
+
+    @classmethod
+    def get_instance(cls) -> "ConfigManager":
+        if cls._instance is None:
+            cls._instance = cls()
+        return cls._instance
+
+    def _load(self) -> dict:
+        """加载配置文件，与默认配置合并（优先级：config.yaml > dev_config.json > transcriber.json > 代码默认值）"""
+        # 1. 代码默认配置
+        defaults = _load_default_config()
+        # 2. transcriber.json 覆盖
+        transcriber_defaults = _load_transcriber_defaults()
+        defaults = _deep_merge(defaults, transcriber_defaults)
+        # 3. dev_config.json 开发者配置覆盖
+        dev_defaults = _load_dev_config_defaults()
+        defaults = _deep_merge(defaults, dev_defaults)
+        # 4. 用户 config.yaml 覆盖
+        if not self._config_path.exists():
+            return defaults
+        try:
+            with open(self._config_path, "r", encoding="utf-8") as f:
+                user_config = yaml.safe_load(f) or {}
+            return _deep_merge(defaults, user_config)
+        except Exception as e:
+            logger.error(f"加载配置文件失败 {self._config_path}: {e}")
+            return defaults
+
+    def get_config(self) -> dict:
+        """获取完整配置"""
+        if self._config is None:
+            self._config = self._load()
+        return dict(self._config)
+
+    def get(self, key: str, default: Any = None) -> Any:
+        """
+        获取配置项，优先级：
+        1. 系统环境变量（最高优先级，兼容 CI/CD）
+        2. config.yaml 用户配置
+        3. 默认值
+        """
+        # 系统环境变量优先
+        env_key = key.upper().replace(".", "_")
+        env_val = os.getenv(env_key)
+        if env_val is not None:
+            # 尝试类型转换
+            if default is not None:
+                try:
+                    if isinstance(default, int):
+                        return int(env_val)
+                    elif isinstance(default, float):
+                        return float(env_val)
+                    elif isinstance(default, bool):
+                        return env_val.lower() in ("true", "1", "yes")
+                except (ValueError, TypeError):
+                    pass
+            return env_val
+
+        # config.yaml 回退
+        config = self.get_config()
+        return _get_by_path(config, key, default)
+
+    def set(self, key: str, value: Any) -> None:
+        """设置配置项并保存到文件"""
+        # 加载当前文件内容（不含默认值）
+        file_config: dict = {}
+        if self._config_path.exists():
+            try:
+                with open(self._config_path, "r", encoding="utf-8") as f:
+                    file_config = yaml.safe_load(f) or {}
+            except Exception:
+                file_config = {}
+
+        # 设置值
+        _set_by_path(file_config, key, value)
+
+        # 保存
+        self._config_path.parent.mkdir(parents=True, exist_ok=True)
+        with open(self._config_path, "w", encoding="utf-8") as f:
+            yaml.dump(file_config, f, default_flow_style=False, allow_unicode=True, sort_keys=False)
+
+        # 清除缓存
+        self._config = None
+        logger.info(f"已设置配置项: {key}")
+
+    def ensure_default_config(self) -> None:
+        """首次运行时创建默认配置文件（根据操作系统选择不同配置）"""
+        if not self._config_path.exists():
+            self._config_path.parent.mkdir(parents=True, exist_ok=True)
+            with open(self._config_path, "w", encoding="utf-8") as f:
+                f.write(_get_default_config())
+            system = platform.system()
+            logger.info(f"已创建默认配置文件 ({system}): {self._config_path}")
+
+    def reload(self) -> None:
+        """重新加载配置"""
+        self._config = None
+
+    # ========== 转写器配置相关方法（从 TranscriberConfigManager 合并）==========
+
+    def get_transcriber_config(self, transcriber_type: str) -> Dict[str, Any]:
+        """获取指定转写器的配置，支持环境变量覆盖"""
+        config = self.get_config()
+        transcriber_config = config.get("transcribers", {}).get(transcriber_type, {})
+        
+        # 环境变量覆盖 → config.yaml 覆盖
+        if transcriber_type == "groq":
+            from app.secret_manager import get_secret
+            transcriber_config["api_key"] = get_secret("GROQ_API_KEY") or transcriber_config.get("api_key")
+            transcriber_config["base_url"] = self.get(
+                "models.groq.base_url",
+                transcriber_config.get("base_url")
+            )
+            transcriber_config["model"] = self.get(
+                "transcriber.groq_model",
+                transcriber_config.get("model")
+            )
+        elif transcriber_type == "whisper-cpp":
+            cli_path = self.get(
+                "transcriber.whisper-cpp.cli_path",
+                transcriber_config.get("cli_path", "whisper-cli")
+            )
+            # cli_path 为空字符串时回退到 whisper-cli
+            transcriber_config["cli_path"] = cli_path or "whisper-cli"
+            transcriber_config["model_path"] = self.get(
+                "transcriber.whisper-cpp.model_path",
+                transcriber_config.get("model_path", "")
+            )
+
+        return transcriber_config
+
+    def get_fallback_priority(self) -> List[str]:
+        """获取 fallback 优先级列表"""
+        config = self.get_config()
+        return config.get("fallback_priority", ["bcut", "kuaishou","whisper-cpp","groq"])
+
+    def get_default_transcriber(self) -> str:
+        """获取默认转写器类型"""
+        return self.get("transcriber.default_type", "bcut")
+
+    def is_transcriber_enabled(self, transcriber_type: str) -> bool:
+        """检查转写器是否启用"""
+        config = self.get_transcriber_config(transcriber_type)
+        return config.get("enabled", True)
+
+
+def get_config_manager() -> ConfigManager:
+    """获取全局 ConfigManager 单例"""
+    return ConfigManager.get_instance()

src/app/decorators/timeit.py

@@ -0,0 +1,16 @@
+import time
+import functools
+import logging
+
+logger = logging.getLogger(__name__)
+
+def timeit(func):
+    @functools.wraps(func)
+    def wrapper(*args, **kwargs):
+        start = time.perf_counter()
+        result = func(*args, **kwargs)
+        end = time.perf_counter()
+        duration = end - start
+        logger.info(f"{func.__name__} executed in {duration:.4f} seconds")
+        return result
+    return wrapper