TensaikunYT/Videohub

项目用途

VideoHub 是一个本地桌面工作室，用来处理 AI 编程 Agent 以代码写出的视频。一部片子的本质是一个网页，用 JavaScript 的 window.renderOut(t) 逐帧画出来，因此 VideoHub 可以不渲染就直接播放、逐帧步进，并允许在任意帧或帧区间上涂画、留言。留言通过 MCP 工具（hub_notes、hub_note_update、hub_live、hub_render 等）暴露给 Claude Code 或 OpenCode，Agent 读取后修改代码，预览会原地重载。渲染由 ffmpeg 队列完成，同一时间只跑一个任务，并且只重渲染留言涉及的 2 秒分块。

目标用户是通过编程 Agent 产出视频的人，例如动态图形、旁白讲解等逐帧内容。项目附带声音混音、缩略图工作室和渲染保护控制，hub_* 工具也可以通过 node server/cli.js 在命令行调用。

快速开始

各平台都需要 Node.js 22+、PATH 中的 ffmpeg、用于无头渲染的原生 Chrome/Chromium/Edge，以及 Claude Code 或 OpenCode。Windows 10/11 可用 winget 安装前两项；Linux 和 macOS 使用发行版或 Homebrew 包，具体见 README 的环境要求。不支持 Snap/Flatpak 浏览器包装。

1. 下载 ZIP 或把仓库克隆到你想保留的目录。
2. Windows：双击 SETUP.cmd（可先用 setup.ps1 -DryRun 预览）。Linux/macOS：先运行 chmod +x setup.sh update.sh uninstall.sh open.sh，再运行 ./setup.sh（可先用 --dry-run）。安装过程会询问工作区、监视文件夹、GPU 编码、Agent 和示例影片。
3. Windows 从桌面快捷方式或 open.cmd 启动；Linux/macOS 运行 ./open.sh。重启 Agent 会话，使其加载 hub_* MCP 工具。
4. 打开示例影片，空格播放、← → 逐帧，点击画面留言，然后 Render → Full film。预期在工作区得到 hello-film_v1.mp4；修改后选择 Render → Only the fixed parts 会生成 hello-film_v2.mp4，并可以只播放改动片段。

新片模板 和 项目契约 说明了实现实时预览、留言和分块局部渲染时，影片目录必须包含什么。

使用约束与安全

窗口、文件夹对话框、通知和文件管理器操作需要图形桌面会话。Linux 需要原生浏览器，以及可选的 taskset、zenity/kdialog、notify-send；没有 taskset 时或在 macOS 上，CPU 亲和力的电源控制不可用。渲染队列会为你的项目执行 shell 命令，因此服务只监听 127.0.0.1，不应通过隧道或端口转发把 7788 端口暴露出去。安装和更新脚本只对自身进程放开 PowerShell 执行策略；若机器策略仍然阻止，应改用经批准的签名部署，而不是降低防护。

Linux 和 macOS 支持被标注为新增、尚未在真机测试，Linux/macOS 的渲染性能也未经验证；平台说明 和 渲染速度 记录了功能限制和现有的 Windows 测量数据。项目采用 MIT 许可证。

HotRepo 点评

项目在 2026-11-13 进入 HotRepo 新项目榜，记录到 108 star、29 fork，并在约一小时的窗口内净增 6 star。观察窗口很短，不足以判断持续趋势。值得注意的设计是把视频定义为代码：预览、留言和局部重渲染都依赖明确的页面接口，因此整条流水线不依赖编译型原生辅助程序。代价是环境偏重——Node、ffmpeg、原生浏览器和 Agent 缺一不可，而且 Linux/macOS 的渲染路径仍未验证。