Kap Native

Kap Native 是面向 Apple Silicon Mac 的开源录屏工具，基于 Kap 3.6.0 开发，可原生运行在 arm64 架构上，不需要安装 Rosetta 2。

本项目由 Dr-Gavin-gr8 维护，是独立的 非官方社区版本，与 Wulkano 没有隶属或背书关系。

当前仓库以源码和本地构建为主。构建产物使用临时签名，尚未使用 Apple Developer ID 签名和公证，因此暂未提供面向普通用户的正式安装包。

主要功能

• 原生支持 Apple Silicon（arm64）
• 提供简体中文和英文界面
• 支持区域录制、音频录制和鼠标指针录制
• 录制区域右上角提供停止按钮
• 再次启动应用时会重新显示录制区域选择器
• 缺少屏幕录制权限时会显示明确提示
• 支持 MP4、WebM、AV1、HEVC、APNG 和 GIF 转换
• 不包含使用情况分析或远程崩溃上报

与原版 Kap 的主要区别

项目	Kap Native
目标架构	Apple Silicon arm64
Rosetta 2	不需要
应用名称	Kap Native
Bundle ID	com.wulkano.kap.native
界面语言	English、简体中文
录制停止方式	菜单栏、Esc、录制框右上角按钮
遥测	不收集分析数据，不自动上传崩溃信息
自动更新	当前关闭，避免覆盖本地原生依赖

系统要求

• Apple Silicon Mac（M1、M2、M3、M4 或后续芯片）
• macOS 11 或更高版本
• Xcode Command Line Tools
• Homebrew

安装构建工具：

xcode-select --install
brew install autoconf automake libtool

构建脚本会通过 npx 临时使用 Node.js 16.20.2 和 Yarn 1.22.22，不要求 全局安装这两个版本。

从源码构建

克隆仓库：

git clone https://github.com/Dr-Gavin-gr8/Kap-Native.git
cd Kap-Native

执行一键构建：

bash scripts/build-native-arm.sh

完成后，应用位于：

dist/mac-arm64/Kap Native.app

启动本地构建：

open "dist/mac-arm64/Kap Native.app"

构建过程会自动完成以下检查：

• Electron、Aperture、FFmpeg 和 Gifsicle 包含 arm64 架构
• 音频设备、窗口控制、Open With 和应用图标工具已原生编译
• 所有打包后的 Mach-O 文件都包含 arm64 slice
• 应用完成临时签名并通过严格签名校验
• MP4 和 GIF 导出烟雾测试通过

更完整的技术说明请参阅 NATIVE_ARM_BUILD.md。

如何使用

1. 启动 Kap Native。
2. 点击菜单栏中的 Kap Native 图标。
3. 拖动并调整需要录制的区域。
4. 点击录制按钮开始录制。
5. 停止后，录制内容会进入编辑和导出界面。

如何停止录制

录制过程中可以使用以下任意方式：

• 点击录制区域右上角的圆形关闭按钮；
• 按下 Esc；
• 点击菜单栏图标并选择“停止”。

右上角按钮只在录制时出现。除按钮外，录制边框保持鼠标穿透，不会阻挡其他 应用的操作。

如何退出

使用应用菜单中的“退出 Kap Native”，或者按下 Command + Q。

录制文件保存在哪里

默认保存目录：

~/Movies/Kaptures

可以在“偏好设置 → 通用 → 保存到…”中修改目录。点击设置页面显示的目录路径， 可以直接在访达中打开。

切换中文界面

打开：

偏好设置 → 通用 → 语言 → 简体中文

切换语言后，应用会自动重新启动，使菜单栏、偏好设置、权限提示、编辑器和导出 界面统一使用所选语言。

macOS 权限

首次使用时，需要在“系统设置 → 隐私与安全性”中允许：

• 屏幕与系统音频录制
• 麦克风（仅在需要录音时）

修改权限后，请完全退出 Kap Native，再重新启动。如果启动后没有出现录制选择 框，再次点击应用图标即可重新打开。

开发与测试

安装依赖：

npx -y -p node@16.20.2 -p yarn@1.22.22 -c \
  "yarn install --frozen-lockfile"

运行代码检查、测试和生产构建：

npx -y -p node@16.20.2 -p yarn@1.22.22 -c "yarn lint"
npx -y -p node@16.20.2 -p yarn@1.22.22 -c "yarn test:main"
npx -y -p node@16.20.2 -p yarn@1.22.22 -c "yarn build"

GitHub Actions 会对 main 分支和 Pull Request 自动执行相同的检查。目前主进程 测试共 26 项。

隐私

Kap Native 不包含原版项目中的 Sentry 集成，也不会收集使用情况分析数据。 录制内容默认只保存在本机，除非用户主动使用导出插件或其他分享操作。

错误发生时，应用只显示并允许复制错误详情，不会自动上传。可选插件可能连接 第三方服务，安装和使用前请查看插件自身的隐私条款。

详情请参阅 PRIVACY.md。

已知限制

• 当前只支持 Apple Silicon，不维护 Intel 构建。
• 项目基于 Kap 3.6.0 和 Electron 13，部分依赖版本较旧。
• 本地构建使用临时签名，不等同于 Apple Developer ID 签名和公证。
• 正式发布可下载二进制文件前，需要配置 Apple 开发者证书和公证流程。

参与贡献

欢迎提交 Issue 和 Pull Request：

• 普通问题：创建 Issue
• 贡献说明：contributing.md
• 安全问题：SECURITY.md
• 行为准则：CODE_OF_CONDUCT.md

请不要在公开 Issue 中提交密码、令牌、私人录屏或漏洞利用细节。

上游项目与许可证

Kap Native 基于 Wulkano 和 Kap 贡献者开发的 wulkano/Kap。原项目作者保留其版权。 主要修改记录见 NOTICE.md 和 CHANGELOG.md。

本项目遵循 MIT License。

English summary

Kap Native is an unofficial, community-maintained Apple Silicon edition of the open-source Kap screen recorder. It runs natively on arm64 Macs without Rosetta 2 and adds a Simplified Chinese interface, an in-frame stop button, startup and permission-flow improvements, and a telemetry-free default.

Build it on an Apple Silicon Mac with:

brew install autoconf automake libtool
bash scripts/build-native-arm.sh