DOCS · 项目文档 PROJECT← 返回索引 · Index

CLAUDE.md — video 仓库工作指南

项目定位

视频转写 AI 工具(video2md):任意视频(本地文件/录屏/B 站链接)→ 语音/画面提取转写 → 结构化 Markdown → HTML 阅读。B 站下载(bili_dl)是可选前置。 ref/ 下持续积累转写文档(长鑫存储、泡泡玛特、AI 行业等)。

目录速览

tools/            # 三件套:bili_dl.py / video2md.py / md2html.py(用法详见 tools/README.md)
ref/              # 视频与转写文档;BV*.mp4 大文件不入库,<BV>.title.txt sidecar 入库
html/             # md2html 输出(临时,不入库,可随时重建)
requirements.txt  # 依赖统一安装
README.md / README.en.md   # 项目说明(中/英双语,改动需同步两份)

标准工作流

python3 tools/bili_dl.py <BV号或链接>                 # 下到 ref/,自动写 <BV>.title.txt
python3 tools/video2md.py ref/<BV>.mp4 --model small --auto-crop [--interval 10]
python3 tools/md2html.py                              # 全量重建 html/(会清理过期页面)
# 然后 git add -A && commit && push(见 Git 约定)

环境要点

Git 约定(重要)

设计语言(md2html 样式)

「QUANT WORKFLOW 信息卡」体系:终端绿 #39E6A8 结构件 + 金黄 #FFC83D 强调 + 等宽眉标/时间戳 + H1 进度线签名;浅色纸面优先、暗色随系统。改样式保持此风格。