v0.4.0 · 三种本地 Whisper 引擎

三种本地 Whisper 引擎

• 保留 Faster Whisper（CPU / INT8）及原有模型和设置。
• 新增 OpenAI Whisper 原版（CPU / FP32）。
• 新增 MLX Whisper（Apple 芯片 Mac / GPU）；Intel Mac 不安装 MLX。
• 三种引擎均支持 tiny、base、small、medium、large-v3、large-v3-turbo，保留文本与时间戳；另保留 BCut 在线识别。
• 安装时先选择引擎，再选择模型；设置页可分别下载、查看状态、删除模型。各引擎模型独立保存，不互相覆盖或自动切换。
• 修复切换引擎或模型后恢复其他引擎旧字幕的问题；增加旧 Helper 兼容提示。

安装与升级

1. 使用 Homebrew 安装前置工具：brew install node uv。
2. 下载并解压 obsidian-web-clipper-cn-transcript-v0.4.0-macos.zip，进入文件夹运行 bash install.sh。
3. Apple 芯片 Mac 可在引擎菜单选 3（MLX Whisper），首次选 tiny 验证；大模型可稍后在设置页下载。
4. Chrome 中加载或重新加载安装包内的 extension/dist/，在 Transcript Generator 设置中选择相同引擎和模型。已有 Helper 请在设置页重启。

macOS 包包含预构建扩展、Helper 和 Launcher；安装仍需联网准备 Python 依赖及所选模型，不是独立二进制应用。覆盖安装保留浏览器设置、Cookies、模型和缓存。不会设置开机自启。

-chrome.zip 仅包含浏览器扩展，不能单独提供本地字幕识别。模型权重不包含在下载包中。

验证与限制

Chrome 生产构建、12 项后端测试、3 项隔离安装菜单测试、设置页交互与配置保存、旧 Helper 保护、弹窗/侧栏编码检查通过。OpenAI Whisper 和 MLX Whisper 均使用真实 tiny 模型完成合成中文音频转写；用户反馈本机安装运行成功。

保留 Webpack 包体积提醒。tiny 识别仍可能有错字；本次不是性能或质量评测，尚未完成所有引擎的在线视频全链路及 Intel Mac 实机回归。

SHA-256

670a99bf3340682f7976a6a9b67592980e17f717a5fecd3d55d79ab618317f86  obsidian-web-clipper-cn-transcript-v0.4.0-chrome.zip
1f7d5a488d9bcca8b3e87cb5dfd749b532ff600f35061e17354872834470b035  obsidian-web-clipper-cn-transcript-v0.4.0-macos.zip

v0.3.0 · Obsidian Web Clipper 目录统一与完整安装教程

主要变化

• 用户可见的 Helper 安装目录统一为 ~/Library/Application Support/ObsidianWebClipperCNTranscript/。
• Whisper 模型与 transcript 缓存统一为 ~/.cache/obsidian-web-clipper-cn-transcript/。
• 安装器会自动迁移当前 TranscriptGenerator / transcript-generator 和更早 Clip Note 目录，保留模型、缓存、Cookies、模板与扩展设置。
• 新安装默认使用 Faster Whisper tiny，降低首次下载和验证门槛。
• 新增完整的 macOS 从零安装、彻底清理、指定 YouTube 视频验证和故障排除教程。
• 继续保持按需启动：不创建 LaunchAgent，不开机自启。

下载选择

• obsidian-web-clipper-cn-transcript-v0.3.0-macos.zip：完整 macOS 安装包，包含扩展、Helper 和 Launcher，推荐普通用户下载。
• obsidian-web-clipper-cn-transcript-v0.3.0-chrome.zip：仅浏览器扩展，不包含本地字幕生成 Helper。

SHA-256

a2439937068aca77422046d77afbb758851bec57d81aaeac2398de93332cea2e  obsidian-web-clipper-cn-transcript-v0.3.0-macos.zip
75b324254a9ae36181d5b06db1fef16d3d0728d63030f7add3eb6745f87bf363  obsidian-web-clipper-cn-transcript-v0.3.0-chrome.zip

升级

下载新的 macOS ZIP，解压后运行 bash install.sh --yes，再到 chrome://extensions 重新加载扩展。旧模型与配置会自动迁移并保留。

v0.2.2 · 安装阶段模型选择与 Release 安装包

安装阶段模型选择与 Release 安装包

安装前置条件

用户必须预先安装：

• Node.js 18 或更高版本
• uv

不需要预先安装 Python；安装器会通过 uv 准备隔离的 Python 3.11 环境。

新功能

• 交互安装时可选择 tiny、base、small、medium、large-v3 或 large-v3-turbo
• 可以跳过模型下载，稍后在扩展设置页完成
• --yes 无交互覆盖安装默认跳过下载，不删除已有模型
• 模型下载失败不会撤销已经完成的扩展和 Helper 安装

下载哪个文件

• obsidian-web-clipper-cn-transcript-v0.2.2-macos.zip：推荐。包含预构建扩展、Helper、Launcher、安装脚本、README、License 和第三方声明。解压后运行 bash install.sh。
• obsidian-web-clipper-cn-transcript-v0.2.2-chrome.zip：只包含 Chrome 扩展。解压后可以直接加载，但不能单独提供本地字幕生成能力。

macOS 安装包不包含 Python .venv、node_modules、Whisper 模型或开机启动项，也不是预编译独立程序。

SHA-256

93a0512614922413126ce2a0058fa6ddca662c10a9def94b7b7ed777a51876e3  obsidian-web-clipper-cn-transcript-v0.2.2-chrome.zip
337e7113084a5d74954a34095acbe9a6ad4ef10539ff0957b8aba1aebec8099b  obsidian-web-clipper-cn-transcript-v0.2.2-macos.zip

v0.2.1 · Transcript Generator 内部命名统一

Transcript Generator 内部命名统一

本版本把历史遗留的 Clip Note 内部名称完整迁移为 Transcript Generator，包括扩展源码、Python 包、Helper 命令、Launcher、Native Messaging Host、安装目录、模型缓存、环境变量和浏览器存储键。

升级兼容

• 自动迁移 v0.2.0 的浏览器设置与 Cookies
• 自动迁移已有 Helper 安装目录
• 自动迁移 Faster Whisper 模型与 transcript 缓存
• 注册新的 Native Messaging Host，并清理旧 Host
• 不删除模板、Cookies、模型或任务设置

安装或升级

下载 Source code，进入项目目录后运行：

bash install.sh

本项目仅支持 macOS + Chrome/Chromium，不提供预编译独立程序。

Obsidian Web Clipper CN · Transcript v0.2.0

首个统一命名与版本规则的公开版本。

平台支持

仅支持 macOS + Chrome/Chromium。不支持 Windows 或 Linux，并且当前没有开发 Windows/Linux 版本的计划。

主要内容

• 为没有平台字幕的 Bilibili / YouTube 视频生成带时间戳的 transcript
• 支持 BCut 在线 ASR 和 Faster Whisper 本地 ASR
• 生成结果写回 Web Clipper 原有 {{transcript}} 变量
• 支持弹出窗口与嵌入式窗口、任务恢复和状态收起
• 支持 Cookies 自动读取、手动导入和本地隔离
• Helper 通过 Native Messaging 按需启动，不创建 LaunchAgent
• 项目名称统一为 Obsidian Web Clipper CN · Transcript
• 产品版本独立定义为 0.2.0，上游代码基线为 Web Clipper CN 1.4.6

安装

git clone https://github.com/whatcccup/obsidian-web-clipper-cn-transcript.git
cd obsidian-web-clipper-cn-transcript
bash install.sh

已有安装覆盖升级：

cd /你的实际路径/obsidian-web-clipper-cn-transcript
bash update.sh

完成后打开 chrome://extensions，在原扩展卡片上点击“重新加载”。

发行形式

本 Release 仅提供 GitHub 自动生成的源码归档，不提供预编译独立程序。安装脚本使用 uv 准备隔离的 Python 3.11 Helper 运行时，不要求用户系统预装 Python 3.11。