Skip to content

Video2Doc v0.6.0 — Windows/macOS 兼容、隐私模式与安全加固

Choose a tag to compare

View all tags
@GoodWay0223 GoodWay0223 released this 22 Jul 10:13
· 9 commits to main since this release
v0.6.0
c5ecce7
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

重点更新

Video2Doc v0.6.0 是一次面向日常使用和后续迭代的基础版本更新：统一 Windows/macOS 核心运行路径，补齐隐私模式和安全边界，修正前端能力宣传，并建立可复现的正式发布流程。

Windows 与 macOS

  • 新增 start-video2doc.cmd 和 start-video2doc.command。
  • 自动发现 Windows WinGet/Scoop/Chocolatey/uv/虚拟环境，以及 macOS Homebrew/MacPorts 中的 ffmpeg、ffprobe、curl、yt-dlp 和浏览器。
  • Shell 入口统一验证 Python 3.10+，与当前 yt-dlp 的最低版本一致，并避免 Windows Store 无效 python3 别名。
  • GitHub Actions 在 windows-latest 和 macos-latest 上运行 Python 3.10/3.11 核心回归、启动器和打包 smoke。
  • 环境状态显示 Python、FFmpeg、ffprobe、curl、yt-dlp 与 JavaScript runtime 的本机版本，并离线核对 yt-dlp 最低要求。
  • 只有用户点击或执行 --check-updates 才向 PyPI 查询最新稳定版；程序只给出匹配安装形态的升级建议，不会自动升级。
  • Dependabot 每周提高 yt-dlp 已测试最低基线，计划 CI 同步在两个系统上重新验证当时的最新稳定版；更新需经 PR 与测试后才会进入发布。

隐私与安全

  • 本地文件新增“隐私模式：仅本机识别”。开启后，服务端只允许 FunASR → Whisper，并强制禁止豆包、TeleSpeechASR 和 SiliconFlow 内容增强。
  • 默认仅监听 127.0.0.1，移除通配 CORS。
  • 修复下载路径穿越、上传文件名越界、DOM XSS、超大请求体和不安全 URL 边界。
  • API Key 只从显式环境变量或 ~/.video2doc/config.json 读取，不写入仓库，也不放入子进程参数。

前端与正确性

  • 删除“95%+ 准确率”“高清无水印”“永久免费”等缺少验证依据的宣传。
  • 明确三个处理入口、字幕优先策略、MD/TXT/JSON/SRT 四种格式和小红书实验状态。
  • 增加本机能力状态、云端增强发送范围、隐私模式启用条件和完整开启教程。
  • 修复 yt-dlp Cookie 失败重试、Windows 空设备、校正规则、领域参数和单格式结果预览。

正式发布包

  • Video2Doc-v0.6.0.zip：Windows/macOS 共用的跨平台源码包。
  • Video2Doc-v0.6.0.zip.sha256：ZIP 的 SHA-256 校验值。
  • ZIP 内含 RELEASE-MANIFEST.json，记录每个文件的大小和 SHA-256。
  • 构建器会排除 .git、缓存、测试、运行输出、媒体和本地凭据，并在发现高置信密钥时中止发布。

从 v0.5.0 升级

  1. 下载并解压 v0.6.0 到新目录，不要直接覆盖正在运行的旧目录。
  2. 如需保留任务，先备份旧目录中的 output/；发布包不包含运行产物。
  3. API Key 继续使用系统环境变量或 ~/.video2doc/config.json。
  4. 重新执行 python -m pip install -r requirements.txt 和环境自检。

**网络监听变化：**v0.6.0 默认只监听 127.0.0.1。如需局域网访问，必须显式传入 --host 0.0.0.0；该模式目前没有认证或 HTTPS，请勿用于敏感内容。

验证范围

  • 本地 Windows：57/57 Python 回归、Python/JavaScript/Bash 语法和真实浏览器桌面/移动端检查。
  • GitHub Actions：Windows/macOS Python 3.10/3.11 核心回归、启动器和发布包 smoke。
  • 候选发布包：可复现性、SHA-256、包内清单、执行权限、CRLF/LF、敏感文件排除和解压运行检查。

CI 不调用真实平台媒体或收费 API，因此不代表所有平台页面、账号权限、地区限制、Key 有效性和额度均已端到端验证。

已知限制

  • FunASR/Whisper 是可选依赖；首次使用可能联网下载模型。
  • “链接转文稿”必须联网获取媒体，不能视为完全离线。
  • yt-dlp 更新频繁；可用 python scripts/check_setup.py --check-updates 显式联网检查。YouTube 完整支持还可能需要受支持的 JavaScript runtime/EJS 组件，并受地区、账号和页面变化影响。
  • 实验性 Bash CLI 的下载阶段尚未与 Web pipeline 完全统一，正式使用优先选择 Web UI。
  • 仓库当前没有开源许可证；请勿自行假定为 MIT 或其他许可证。

完整变更：v0.5.0...v0.6.0

Assets 4
Loading