Repository navigation
Releases
v0.2.1 健壮性修复 · 孤儿视频 / OAuth / fetch 超时 / 流式下载
v0.2.1 健壮性修复
v0.2.0 发布后我自己又跑了一轮长尾场景测试,把 P0~P2 共 11 个问题一锅端了。功能层面跟 v0.2.0 一致,主要是把"看不见的角落"修干净。
关键修复
- 不再留孤儿视频:删除任务时若视频还在后台下载中,会先标记取消、下载完自动删
.part,不会在videos/留下几 MB 到几百 MB 的无主文件 - 不再"以为在等授权":一键授权进行中关闭设置弹窗的路径被堵死(关闭按钮与遮罩都禁用),避免静默取消授权
- 网关半开不再永久挂起:所有 fetch 都加超时(submit 30s / query 15s / 测试连接 5s / 同步模型 8s)
- 不再阻塞主线程:视频下载改流式 +
.part临时文件;图片上传硬上限 8MB(避免大图 base64 后塞进 POST 卡住主线程) - 新增
/api/health端点:版本、PID、运行时长、任务数、是否配 Key、模型目录来源——排查问题一查就知道 - SSE 合并按 id 走,避免覆盖你刚编辑但还没上传的本地修改
- 空地址计数持久化:网关先标 succeeded 还没给视频地址时,跨重启不再无限轮询
- CSP 收紧:去掉
style-src 'unsafe-inline',textarea初始值改用 DOM property 设置
详细修复表
| ID | 严重度 | 修法 |
|---|---|---|
| P0-1 | 紧急 | remove 给进行中的下载打 _aborted 标志,_download 完成时识别后自己删 .part |
| P0-2 | 紧急 | 授权中关闭按钮 disabled、遮罩加 .oauth-locked 类,遮罩点击不响应 |
| P1-1 | 高 | 改 pipe 流式落盘到 .part 临时文件,写完再原子 rename |
| P1-2 | 高 | 统一 requestJson 包装 AbortController,submit 30s / query 15s / 测试 5s / 同步 8s |
| P1-3 | 高 | 上传硬上限 8MB(10MB base64 后体积可接受) |
| P1-4 | 中 | SSE 改为按 id 合并 + 删除服务端已不存在的 |
| P1-5 | 中 | 改用 noUrlPolls 字段(无下划线)让 _public 序列化自然带过去 |
| P2-1 | 低 | 监听 focus 注册到 input.click() 之前,单一 settle 函数 |
| P2-2 | 低 | 渲染时留空,渲染完成后用 .value property 注入 |
| P2-3 | 低 | 去掉 style-src 'unsafe-inline' |
| P2-6 | 低 | 统一:失败也 loadIntoStudio 回编辑器 |
另增
GET /api/health— 版本、PID、运行时长、任务数、Key 状态、模型目录来源npm test用例从 32 个扩到 34 个,新增覆盖 /api/health 与 8MB 上传上限
下载
产物名固定 ASCII(VideoStudio-${version}-${os}-${arch}.${ext}):
- macOS(Apple 芯片):
VideoStudio-0.2.1-mac-arm64.zip— 首次需xattr -cr(见 README) - macOS(Intel):
VideoStudio-0.2.1-mac-x64.zip— 同上 - Windows:
VideoStudio-0.2.1-win-setup.exe(NSIS 安装向导)/VideoStudio-0.2.1-win-x64.zip(绿色版) - Linux:
VideoStudio-0.2.1-linux-x86_64.AppImage/VideoStudio-0.2.1-linux-arm64.AppImage—chmod +x后双击
升级方式:从 v0.2.0 升上来只需下载新包覆盖安装,本地配置 / API Key / 任务数据全部保留在 ~/Library/Application Support/video-studio/(macOS)/ %APPDATA%\video-studio\(Windows)/ ~/.config/video-studio(Linux)不动。
v0.2.0 创作台 / 作品墙双面板 · 检查更新
TokenDance 视频接入助手 VideoStudio 的第二个版本。主线是把工作台从「左侧任务队列 + 右侧编辑器」改成 创作台 / 作品墙 双面板,另外补上了「检查更新」。
本次内容
界面:创作台 / 作品墙
- 作品墙:提交出去的片段按宫格铺开,卡片直接用 16:9 视频首帧当封面,一眼看得见画面;生成中的卡片是流光骨架加已用时长;点卡片弹层播放。顶部按 全部 / 进行中 / 已完成 / 未成功 一键过滤,计数实时更新
- 创作台一次只配一段:点「新建工单」开一张空工单,选定模型后才展开完整参数区;提交后创作台回到起始屏,可以接着开下一张
- 去掉了常驻的左侧任务队列栏——它把主编辑区压掉近三分之一,而且队列卡片里一个画面都没有,对一个以画面为核心的工具来说本身就是信息缺失
新增:检查更新
设置页底部一键对照 GitHub Releases 查新版,自动按当前平台匹配到具体安装包,给出文件名、体积和 release notes。只做「查 + 跳下载页」,不自动下载、不自动安装,装不装由你决定。
修复
- 新建但还没选模型的工单,重启应用后不会再被悄悄补上默认模型
- 选择模型目录里不存在的模型会明确报错,不再静默换成默认模型(那会导致按另一个模型计费,界面上完全看不出来)
- 未选模型的工单提交时会被拦下并提示,不会污染队列
下载
| 平台 | 文件 |
|---|---|
| macOS(Apple 芯片) | VideoStudio-0.2.0-mac-arm64.zip |
| macOS(Intel) | VideoStudio-0.2.0-mac-x64.zip |
| Windows(安装向导) | VideoStudio-0.2.0-win-setup.exe |
| Windows(绿色版) | VideoStudio-0.2.0-win-x64.zip |
| Linux x64 | VideoStudio-0.2.0-linux-x86_64.AppImage |
| Linux arm64 | VideoStudio-0.2.0-linux-arm64.AppImage |
首次打开
macOS:包用的是 ad-hoc 签名,没有 Apple 开发者证书也没做公证,系统一定会拦一次。把 app 拖进「应用程序」后执行一次:
xattr -cr "/Applications/TokenDance 视频接入助手.app"也可以走图形界面:双击后到「系统设置 → 隐私与安全性」,在底部找到被拦截的提示,点「仍要打开」。不要再用「右键 → 打开」这个老办法——从 macOS 15 起 Apple 已逐步取消这个入口。
Windows:同样没有代码签名证书,首次运行 SmartScreen 会拦一次,点「更多信息 → 仍要运行」即可。
Linux:AppImage 先 chmod +x 再双击。
说明
本项目是社区自发的非官方 Playground,与词元跳动官方无隶属关系;模型能力、价格、可用性以官方平台为准。应用没有服务器端、没有账号体系、没有遥测上报,本地服务仅监听 127.0.0.1,素材与生成的视频不出本机一步。
v0.1.0 首个跨平台版本
TokenDance 视频接入助手 VideoStudio 的首个跨平台版本——一个跑在本机的视频生成 Playground,接入 词元跳动 TokenDance 统一模型网关上的全部视频生成模型。
本次内容
- 三平台桌面安装包:macOS(Apple 芯片 / Intel)、Windows(安装向导 + 绿色版)、Linux(AppImage,x64 / arm64),双击即用,不需要装 Node 环境
- 全量视频模型:MiniMax H3 / H3 Max、通义万相 Wan3.0 / Prime、Seedance 2.5 / 2.0 全系、可灵 Kling 3.0 / Omni、HappyHorse 1.1 / 1.0 全系
- 四种生成方式:文生视频 / 图生视频(首帧、首尾帧)/ 多模态参考生视频(参考图 + 参考视频 + 参考音频)/ 视频编辑
- 多片段并行:每段的模型、生成方式、时长、画质、画面比例独立配置,完成后视频自动落盘本地
- 一键授权:PKCE 流程,浏览器确认即完成,API Key 只存在你本机
- 费用预估:编辑器底部按当前模型 / 画质 / 时长实时计算预估费用
下载
| 平台 | 文件 |
|---|---|
| macOS(Apple 芯片) | VideoStudio-0.1.0-mac-arm64.zip |
| macOS(Intel) | VideoStudio-0.1.0-mac-x64.zip |
| Windows(安装向导) | VideoStudio-0.1.0-win-setup.exe |
| Windows(绿色版) | VideoStudio-0.1.0-win-x64.zip |
| Linux x64 | VideoStudio-0.1.0-linux-x86_64.AppImage |
| Linux arm64 | VideoStudio-0.1.0-linux-arm64.AppImage |
macOS 用户请先看这里
macOS 包用的是 ad-hoc 签名,没有 Apple 开发者证书也没做公证,所以系统一定会拦一次。把 app 拖进「应用程序」后执行一次:
xattr -cr "/Applications/TokenDance 视频接入助手.app"也可以走图形界面:双击后到「系统设置 → 隐私与安全性」,在底部找到被拦截的提示,点「仍要打开」。
不要再用「右键 → 打开」这个老办法——从 macOS 15 起 Apple 已逐步取消这个入口,在新系统上不会出现「打开」按钮。
构建配置有过一个 bug:
identity: null会让 Electron 跳过签名,在包里留下描述旧内容的失效签名,下载后 macOS 判定为「文件已损坏」并扔进废纸篓。改用identity: "-"做真正的 ad-hoc 签名后已修复(同时需关掉默认开启的 hardened runtime,否则会因 library validation 起不来)。上面这两个包是修复后重新构建的。
Windows 包同样没有代码签名证书,首次运行 SmartScreen 会拦一次,点「更多信息 → 仍要运行」即可。Linux 的 AppImage 需要先 chmod +x。
说明
本项目是社区自发的非官方 Playground,与词元跳动官方无隶属关系;模型能力、价格、可用性以官方平台为准。
应用没有服务器端、没有账号体系、没有遥测上报,本地服务仅监听 127.0.0.1,连局域网都访问不到;素材与生成的视频不出本机一步。