Skip to content

v2.0.0-alpha.1

Pre-release
Pre-release

Choose a tag to compare

@github-actions github-actions released this 08 Sep 08:34
2f08a2f

v2.0.0-alpha.1:新的工作台与笔记工作区

这是 2.0 的第一个 alpha 预发布版,用于试用新版桌面流程。GitHub Latest、Homebrew 默认包和 AUR 稳定包继续提供 1.7.0;试用本版请使用下方 alpha 通道或本页附件。

本版变化

  • 重做桌面工作台、我的笔记、阅读页和设置:集中输入视频来源,预览后生成;最近笔记和后台任务进度在工作台可见。
  • 在线视频和本地文件分别保存草稿,单次生成选项与全局默认值独立。任务记录固定来源、识别服务、模型、导出格式及保存位置,可跨重启继续或修订。
  • 任务支持暂停、继续、取消和退出恢复。成功、部分完成和失败都有持久提示,在其他页面完成时保留当前阅读或设置位置;失败及待确认请求在重启后仍可处理。
  • 生成结果按版本保存,重新生成与补做截图/导出保留旧版本和手工修改的文件。笔记库支持文件夹、搜索、列表/卡片,阅读支持目录、查找、截图网格和每版本阅读进度。
  • 设置按默认生成、服务与模型、账号、存储与应用分组;旧配置导入前先保全原件,提供损坏配置修复和库位置恢复入口。
  • Apple 原生识别在模型已缓存时直接离线加载,避免等待远端检查;缺少模型时及时提示。修复拉丁语言字幕合并丢失句间空格等问题。
  • 修复 Windows 生成笔记时文件同步报“拒绝访问”和字幕导入时文件被占用的问题,补齐三平台发布所需的内置服务样本和源码补丁准备。

安装 GUI

GUI 已包含同版本 CLI 引擎,无需再安装独立 CLI 才能使用窗口。

macOS Apple Silicon(macOS 15+)

首次通过 Homebrew 安装 alpha:

brew update
brew install --cask mizorewww/tap/course2md-gui@alpha

如果已经通过 Homebrew 安装稳定版,先退出应用,再切换通道:

brew uninstall --cask course2md-gui
brew install --cask mizorewww/tap/course2md-gui@alpha

卸载命令不加 --zap,保留配置、笔记和模型缓存。手动安装过的应用可先移出 /Applications 留作备份,再执行 Homebrew 安装;也可直接使用本页 DMG 替换应用。

以后更新 alpha 使用 brew upgrade --cask course2md-gui@alpha。返回稳定通道需退出应用,卸载 course2md-gui@alpha,再安装 mizorewww/tap/course2md-gui

Windows / Linux

平台 下载 启动
Windows x64 桌面 ZIP 完整解压,打开 course2md-desktop.exe,保留同目录的 course2md.exe
Linux x64 桌面 tar.gz 完整解压,运行 ./course2md-desktop,保留同目录的 course2md

GUI 与 CLI 都需要 ffmpeg/ffprobe,在线视频还需要 yt-dlp。Homebrew 会安装这些依赖;其他平台请按 安装指南准备。Intel Mac 和 Linux ARM64 提供独立 CLI,本版没有预编译 GUI。

独立 CLI

Homebrew alpha 与稳定 CLI 可以同时安装。CLI 配方名为 course2md-alpha,旧写法 course2md@alpha 保留为兼容别名。alpha 默认不改动终端中的 course2md 命令,使用完整路径试用:

brew install mizorewww/tap/course2md-alpha
"$(brew --prefix course2md-alpha)/bin/course2md" --version
"$(brew --prefix course2md-alpha)/bin/course2md" doctor

若要把终端默认命令切换为 alpha,先 brew unlink course2md,再 brew link --force course2md-alpha。返回稳定版时先 unlink alpha,再 link 稳定版。

手动安装可选择本页的 macOS ARM64/x86_64、Linux ARM64/x86_64 或 Windows x64 CLI。Unix 文件需赋予执行权限;Apple Silicon 还需下载 mlx-macos-arm64.metallib 并改名为 mlx.metallib,与 CLI 放在同一目录。install.sh 和 AUR 当前只跟随稳定版。

测试范围与升级

  • 本机核心回归:169 项通过、2 项需在线环境的测试忽略;桌面回归:108 项通过、3 项忽略。发布流程另执行三个平台的桌面 release 测试及打包检查。
  • 已实测本地视频、受控在线视频来源、字幕路径、Apple 1.7B 本地识别、API 校对/摘要、后台任务与重启恢复、版本阅读和导出。完整记录见 UX 验收矩阵
  • 真实 Bilibili 登录与不同账号网络环境、其他硬件上的本地识别仍需试用反馈。
  • 升级前退出旧应用,替换完整应用包;保留旧配置和课程输出。2.0 会建立新的工作区索引,旧笔记和手工导出会保留。若需回到 1.7.0,旧版不能管理 2.0 的任务与版本历史。

启动后在应用「关于」确认 2.0.0-alpha.1;独立 CLI 使用 --version 确认。反馈问题时附上系统、操作步骤与已脱敏的诊断信息。

English

This is the first 2.0 alpha prerelease, featuring a redesigned desktop workspace, independent drafts, resumable tasks, persistent background results, versioned notes, improved reading and settings, and offline loading of cached Apple speech models.

Install the Apple Silicon GUI with brew install --cask mizorewww/tap/course2md-gui@alpha, or use the platform assets above. Quit and uninstall the stable cask first if installed; omit --zap to preserve user data. The GUI bundles its matching engine. The optional course2md-alpha formula is keg-only, so use $(brew --prefix course2md-alpha)/bin/course2md or explicitly switch your links. Stable Homebrew, AUR and GitHub Latest remain on 1.7.0. Version 1.x cannot manage the new 2.0 task and note-version history.

Full Changelog: v1.7.0...v2.0.0-alpha.1