灵录 Capwise

中文 · English

录下来，讲清楚。

免费的开源 Mac 录屏与剪辑工作台。字幕、画面、配音、封面与 AI 助手，从录制到成片，在一个窗口里完成。 A native Mac studio for screen recordings, captions, and AI-assisted editing.

官网与界面预览 · 下载 macOS 版 · 报告问题 · 构建文档 · 许可证

真实安装版界面。演示中的 NOVA 是原创虚构素材，不包含私人录屏；标题、字幕和缩放均在灵录中编辑。

产品演示、操作教程、课程讲解，不必在录屏、字幕、配音和封面工具之间来回搬运。灵录把这些步骤放在一个本地编辑器里：先录下来，再慢慢打磨。

适合做产品演示、软件教程、课程录制和知识分享。当前发布包支持 macOS 13.3+、Apple Silicon，经过 Developer ID 签名与 Apple 公证。

录完之后，少折腾几步

• 操作太细，看不清？ 自动缩放、光标效果与标注，把注意力带到重点。
• 字幕太长，改不动？ 在文字列表里校对、查找替换，再翻译成双语字幕。
• 画面做好了，还得换工具？ 文字、贴纸、配乐、配音和片头封面继续在同一工程里加工。
• 不知道从哪调参数？ 告诉助手你想改什么，审阅后应用；也能直接操作画面。

你可以用它做什么

五分钟开始

1. 下载 Apple Silicon 版 Capwise.dmg。
2. 打开 DMG，将 Capwise 拖到 Applications，再启动「灵录」。
3. 按引导授权屏幕录制；需要录人声或摄像头时，再授予相应权限。
4. 录制一段视频，或导入已有视频。在编辑器中处理字幕、画面和声音。
5. 点击「导出」，选择输出设置和保存位置。

基础录制与编辑不需要注册 Cap 云服务账号。AI 功能可选：请在「设置 → AI 模型」中配置自己的服务。

本次提供 macOS 13.3+、Apple Silicon 安装包。Intel、Windows 和 Linux 暂未提供本项目验证过的发布包。

先打开一份好看的工程

下载「灵感成片」演示工程 · 看 24 秒导出视频

解压后在灵录中打开 .cap 文件：米白与墨绿配色、三个章节、8 个可编辑文字图层、6 条双语字幕、手动缩放，以及带淡入淡出的轻配乐。无需配置 AI 或开始录制，就能试试修改标题、翻译样式和时间线。

看看实际工作区

字幕与文字剪辑

「内容 / 翻译 / 样式」分开操作。原文与译文字体、颜色、描边和阴影独立设置；翻译可选择常见语言，也支持自定义。审阅后导出视频或单独导出 SRT / VTT。

普通字幕删除只修改文字；明确进入「按文字剪辑视频」，才会剪掉对应的音视频。两种操作的结果不同，应用前请检查范围。

AI 助手

在声音标签右侧打开助手，选择模型、发送快捷任务或输入自己的要求。字幕与编辑方案可以审阅、应用和撤销。制作封面会直接调用所配置的图片服务并应用结果，对话内可预览、继续编辑、换一张或撤销；生成可能收费。

素材、文字与提词器

素材集中管理，常用内容跨项目复用。文字支持标题、字幕条、标签、高亮等样式，以及独立入场、持续和退场动效。提词器支持写稿和读稿，录制时不用来回找稿子。

AI 助手如何工作

描述目标 → 生成方案 → 查看修改前后 → 应用 → 继续调整 / 撤销

可以这样说：

• 「润色这些字幕，保留人名、数字和原意。」
• 「隐藏字幕中的口头禅。」
• 「把字幕翻译成法语，并显示双语。」
• 「把第一条背景音乐调低 6 dB。」
• 「做一个浅绿色的产品演示封面，时长 1 秒。」

助手会先展示方案。对话中的模型选择只影响当前助手会话；你可以搜索模型，也可以进入模型设置管理服务。输入框支持 ⌘ Enter 发送，运行中可以停止。

封面背景通过你配置的图片服务生成并应用，可以继续编辑、换图或撤销。新封面默认 1 秒，时长可编辑；标题仍然是可修改的文字。请先确认服务配置和费用。

配置你的模型

需要 API Key 的服务先填写密钥，再获取并选择模型；提供商没有开放模型列表时，可以手动填写模型 ID。火山方舟也支持以 ep-… 开头的推理接入点。

快捷按钮会直接发送任务，显示简短名称，背后使用完整的任务提示词。助手会把允许隐藏的口头禅范围一并交给模型；无效方案会自动修正一次，仍失败时保留原项目。

输入框旁的「技能」可搜索本机常见技能目录中的 SKILL.md，或导入指定文件。只发送当前选中的技能正文给所选 API / ACP 模型；技能脚本和引用文件不会自动执行或读取。修改仍通过灵录的预览、应用和撤销流程。

ACP 使用本机已有的登录状态。不同适配器的安装、登录和模型支持不同；检测到命令不代表已经登录成功。灵录中的 ACP 编辑助手仅提出可审阅的修改方案，不授予它终端或文件读写权限。

数据与费用

• 项目和媒体保存在本机，基础编辑不依赖 Cap 云服务。
• macOS 上的 API Key 保存在登录钥匙串；更新应用不会主动清空密钥。
• 使用云端字幕识别时，音频会发送给所选识别服务。
• 字幕校对、翻译和助手请求会发送相关字幕文字与编辑上下文给你选择的模型。助手不会把整个录屏上传给文本模型。
• 封面生图会发送图片描述给图片服务商。模型服务可能收费，费用与额度由服务商决定。
• 使用本地模型仍可能需要先下载模型文件；ACP 服务是否联网取决于所连接的助手。

当前边界

• 通用字幕改写一次使用最多 80 条字幕的上下文；长视频需要分批处理。明确的关键词查找替换会在本地搜索全部字幕。
• 「去口头禅」默认处理字幕显示，不自动剪除语音。只有明确要求剪掉对应语音 / 视频并审阅方案，才会执行媒体裁剪。
• AI 可能改错专有名词、语气或翻译，请在应用和导出前审阅。
• 配音质量也取决于麦克风、输入电平和环境；增益调整不能恢复原始录音中缺失的细节。
• 本项目仍在持续迭代。重要项目建议保留原始媒体与备份。

开发与验证

灵录基于 Cap，桌面界面使用 Rust + GPUI，媒体管线使用项目中的录制、渲染和导出 crates。

需要 macOS、Xcode Command Line Tools、Rust、Bun 及项目的原生媒体依赖。桌面应用拥有独立 Cargo workspace。首次准备会下载原生依赖及打过补丁的 GPUI 源码。

git clone https://github.com/joeseesun/capwise.git
cd capwise
bun install
bun run cap-setup
bash scripts/prepare-gpui-dependency.sh
cd apps/desktop-gpui
cargo build --bin cap-gpui

详细说明见 桌面开发文档；分发签名、公证和更新包流程见 发布文档。开发环境安装不等于已公证的分发包。

验证重点包括：修改方案的范围校验、字幕时间保留、撤销恢复、模型接入，以及安装包签名。每个版本的实际验证结果与已知限制写在 Release 说明 中。

反馈与来源

遇到问题请提交 Issue，附上应用版本、macOS 版本和复现步骤。请勿上传 API Key 或未经处理的私人录屏。

• 基于 Cap，保留上游版权与许可；主要代码为 AGPLv3，部分录制与相机 crates 为 MIT，详见 LICENSE。
• 助手交互参考 Qiaomu Agent，在原生 GPUI 界面中实现。
• 图标使用项目已有图标与 Lucide 风格资源；字体、媒体与第三方组件遵循各自许可。
• 随附配乐的来源记录见 音乐说明。

由 向阳乔木 维护 · 博客 · 乔木推荐 · X @vista8 · GitHub · 公众号「向阳乔木推荐看」

English

Capwise (灵录) is a local-first Mac screen recording and editing studio, based on Cap. Record a demo, refine captions, add narration or music, create a cover, and export your video in one workspace.

Install

Download the Apple Silicon Capwise.dmg, drag Capwise to Applications, and follow the recording permission guide. This release targets macOS 13.3+ on Apple Silicon. Intel, Windows, and Linux packages have not been verified for this fork.

Core recording and editing do not require a Cap Cloud account. Optional AI features use your own model providers or installed ACP agents. Configure speech recognition, text generation, and image generation separately in Settings → AI Models.

Published macOS packages are Developer ID signed and Apple notarized. See the release notes for version-specific verification. Try the editable 24-second demo project without configuring any AI provider.

Highlights

• Native Rust + GPUI editor with a timeline, zooms, captions, music, narration, and annotations.
• Separate content, translation, and style workspaces; independent original/translated subtitle styling.
• An editing assistant that proposes changes for review before applying them, with undo support.
• In-assistant cover generation and application, editable titles and cover duration (1 second for a new cover).
• Shared thumbnail-based assets, searchable Emoji/Lucide stickers, and an editable teleprompter.
• Searchable model selection and local ACP connections.
• Quick actions with task-specific instructions, plus a local SKILL.md picker and import. Only the selected skill body is sent; scripts and referenced files are not run automatically.

Privacy, costs, and limits

Projects remain local. Cloud transcription sends audio to the selected service; AI text features send relevant text and editing context. Cover generation sends the image description. API keys are stored in the macOS login Keychain. Provider charges may apply.

General AI rewrites use up to 80 captions of context per request; explicit keyword search/replacement searches the complete caption list locally. Filler hiding changes the displayed text. Explicit speech/video removal is a separate operation and must be reviewed. Image generation directly calls your configured provider and applies a cover, with edit and undo controls; provider charges may apply. Always review AI output. ACP integrations require their own installation and login; the in-app agent does not receive filesystem or terminal permissions.

See the desktop development guide, release notes, and license. Capwise retains Cap's upstream licensing: primarily AGPLv3, with MIT and third-party exceptions as documented. Report a bug without including credentials or private recordings.