DEPENDENCIES.md

VidkNot 依赖说明

本文档只列出项目直接依赖和用途。完整版本约束以 pyproject.toml 为准。

运行依赖

依赖	版本约束	用途
yt-dlp	>=2026.3.17	视频/音频下载
fastapi	>=0.136.0	HTTP API
uvicorn[standard]	>=0.27.0	ASGI 服务运行
httpx	>=0.27.0	HTTP 请求
pyyaml	>=6.0.1	读取 config.yaml
openai	>=1.0.0	OpenAI 兼容 LLM 调用
faster-whisper	>=1.0.0	本地 ASR 交叉验证

可选依赖

依赖	版本约束	用途
feishu-docx	>=0.2.7	飞书文档写入
opencc-python-reimplemented	>=0.1.7	自动繁体 → 简体（Hermes实战 2026-08-25: 台湾/香港创作者视频源）

安装飞书支持：

pip install "vidknot[feishu] @ git+https://github.com/suonian/vidknot.git@v0.2.1"

开发依赖

依赖	版本约束	用途
pytest	>=8.0.0	单元测试
ruff	>=0.2.0	代码检查和格式化

开发安装：

pip install -e ".[all]"

外部工具

工具	必需	用途
FFmpeg	是	音视频处理
mmx CLI	否	双 ASR 校正中的联网搜证与差异仲裁

mmx 不可用时，VidkNot 会保留主转写结果并继续执行主流程。

Python 版本

pyproject.toml 声明 requires-python = ">=3.10"。当前测试环境覆盖仓库 CI 和本地开发环境，新增 Python 版本适配时应先跑完整测试。