Repository navigation
Releases
Releases · achun1107/video-kit
v1.0.1 — 测试与质检补齐
[1.0.1] - 2026-11-08
补齐质检报告里「自动判不了」的三项,并修掉它们抓出来的 bug。
新增
- 60 个单元测试(
npm test)test_asrfix.py误听纠正、停用词过滤test_repo_finder.py中文数字解析、star 线索、公司→orgtest_tts.pySRT 时间解析、多块、重叠时间test_repo_structure.py仓库卫生、LICENSE 纯 MIT、README 图片存在、密钥扫描
tools/scan-history.py扫全部 commit 的 diff 找明文密钥(当前 0 命中)tools/check-links.py文档外链体检(7 个可达,0 死链)requirements.txt10 个 Python 依赖带用途注释package.json脚本:test / check / links / history / fonts / demo- CI 加了 pytest 步骤,README 加了 CI 徽章
修正
parse_cn_number('三万六')返回 30006 而不是 36000
万位之后的单个数字被当成个位加进去了。这个函数用来识别口播里的 star 数,
算错会选错仓库。同类问题在「一百八」(返回 108)、「一千三」(返回 1003),
一并加特判修复,三种形态都有测试覆盖。parse_cn_number('abc')返回 0 而不是 None(无效输入没被识别)
踩到的坑
tools/scan-history.py里写着 PATTERNS 正则,被自己的扫描规则命中,
CI 挂在这一步。本地 60 个全过是因为豁免列表漏了 scanner 本身 ——
这种差异只有真跑一遍 CI 才看得见。repo-finder.py文件名带连字符,测试里不能直接import,
要用importlib.util.spec_from_file_location加载。
v1.0.0 — 首个可用版本
[1.0.0] - 2026-11-08
首个可用版本。
新增
- 九步流水线:
tools/make-video.mjs一条命令从仓库/抖音链接跑到成片- 铺引擎骨架 → 仓库就位 → 抽内容 → 截图 → 配音 → 字幕 → 铺模板 → 渲染 → 混音 → 播放页
- 通用七卡模板
tools/film-template.js:只读window.CONTENT,不写死项目信息- 封面 / 数字墙 / GitHub 截图 / 特性列表 / 亮点数字 / 清单 / 结论
- 两种输入
--repo:GitHub 仓库地址或本地目录--douyin:抖音分享链接(视频分享和主页分享都支持)
- 抖音链路
tools/douyin-rank.py抓主页视频列表,带点赞数,按赞降序tools/douyin-download.py从页面提取 mp4 直链(绕过 yt-dlp 的 cookie 限制)tools/transcribe-local.pyfaster-whisper 本地转写tools/repo-finder.py从转写反查仓库(star 指纹 + jieba 关键词 + 置信度门槛)tools/asrfix.pywhisper 中文误听纠正表(Gatehub→GitHub、紫围斗树→紫微斗数 等)tools/reverse-batch.py批量逆向高赞视频
- 两档文案
tools/script-writer.py- 模板稿:只读
content.json,套固定骨架 - 参考稿:借原视频转写结构和节奏,换主语
- 模板稿:只读
- 渲染引擎
engine/vk.js:每帧是t的纯函数,支持--stills/--det/--sheet/--clip - 三层混音
tools/mix.py:人声 / 音效 / 配乐,人声领先 19.2dB,loudnorm -13 LUFS - 自包含播放页
tools/make-player-html.py:base64 内嵌视频,单文件可直接播
已知限制
- 文案必须人写,自动生成的是通用模板稿
- 私有仓库不支持
- 渲染 3–6 分钟(1044 帧)
bin/xianyu.js类的工作流骨架不适用本项目(那是另一个仓库的事)
修正过的坑
记录下来免得后人重踩:
ctx.shadow*会破坏--det确定性 → 改用半透明矩形模拟阴影- 单帧
drawImage超过 3 次带变换会破坏确定性 → 先烤到离屏 canvas index.html缺content.js和window.VK_SIZE→ 卡片空白 + 画幅变 16:9edge-tts的rate必须是+45%不是+45- 循环
replace纠正误听会叠字(HyperFrames→HyperFramess)→ 改成一次性正则替换 - 中文按滑窗切词会切出「紫微斗数的开」这种碎片 → 用 jieba TF-IDF
- 口播里的 star 数会过时(1.05万 → 实际 1.67万)→ 匹配上限放到 2 倍
版本说明
- 主版本:
content.json字段变更、CLI 参数不兼容 - 次版本:新增输入源、新增卡片类型、新增工具
- 修订号:修 bug、改文案、调参数