1. 安装与权限配置

前往下载中心获取对应平台的安装包。安装过程与常见桌面软件一致，以下为各平台需要留意的权限配置：

macOS

首次启动需在"系统设置 → 隐私与安全性"中授予 屏幕录制 与 辅助功能 权限；
macOS 15 及以上版本，系统会周期性重新请求屏幕录制权限，属正常系统行为；
v1.9.0 起官方构建已经 Apple 签名公证，可直接运行。

Windows

系统音频捕获开箱即用，无需额外驱动；
推荐从 Microsoft Store 或 winget 安装，可自动获得更新。

Linux

X11 会话开箱即用；Wayland 会话需要 xdg-desktop-portal 与 PipeWire；
系统音频捕获依赖 PipeWire；Wayland 下启用点击特效需按文档配置 udev 规则。

内存建议 8 GB 起步、16 GB 最佳；导出使用 GPU 硬件加速（Metal / D3D11 / Vulkan），无独立显卡时自动回退 CPU。

2. 录制第一条视频

启动 OpenScreen，点击"新建录制"；
在录制面板选择窗口或整个屏幕——捕获走系统原生接口（ScreenCaptureKit / Windows Graphics Capture / PipeWire），流畅且低延迟；
按需开启系统音频、麦克风与摄像头画中画；摄像头支持 8 个吸附位置、圆角与镜像设置；
点击红色录制按钮（或使用自定义快捷键）开始，倒计时后进入录制；
完成后点击停止，视频自动进入编辑器。

提示：录制时不必刻意追求操作节奏——停顿、误点都可以在编辑器中修剪，光标路径也会被自动平滑。

3. 自动美化与编辑

打开录制后，OpenScreen 已自动完成一轮"成品级"处理：

自动缩放：根据每次点击位置生成缩放关键帧，观众视线始终聚焦重点；缩放深度、时长、缓动均可调节；
平滑光标：光标路径平滑处理，点击附带反馈特效，大小样式可后期更换；
专业背景：壁纸、内边距、圆角、阴影与轻微运动模糊自动套用。

在时间线上可继续精细调整：修剪片段、逐段变速、添加文本/箭头/图片标注；每次编辑以"胶囊"形式落在时间线上，支持吸附引导线与音频波形对齐。所有操作均可撤销，原始录制不受破坏。

4. 字幕与转录

如录制了语音，点击"生成字幕"，内置 whisper.cpp 模型在本机离线完成转录（首次使用需联网下载模型，约 264 MB）；
转录结果以文本形式呈现，删除一个词即剪掉对应画面，编辑文本就是在编辑视频；
设置字幕的字体、字号、颜色与位置，可选自动翻译为其他语言；
确认无误后，字幕将烧录进最终导出的视频。

隐私说明：转录全程本地完成，音频不会离开你的电脑；仅当你主动使用字幕翻译或 AI 编辑助手时，相应文本才会经你配置的 API Key 发送至所选服务商。

5. 导出成品

格式：MP4（H.264）或 GIF；
分辨率：720p 至原始分辨率；帧率 24 / 30 / 60；
宽高比：16:9、9:16、1:1、4:3、4:5 等一键切换，同一素材适配官网横幅与竖屏短视频；
遮挡：邮箱、密码等敏感信息可叠加高斯模糊或马赛克区域（矩形 / 椭圆 / 自由形状）。

点击导出后进度条实时显示编码帧数，完成即落盘——无队列、无账号、无水印。

6. 进阶用法

AI 编辑助手

在聊天面板用自然语言下达指令（如"剪掉开头 3 秒""放大 1:20 处的操作"），助手读取真实时间线与转录文本执行编辑并给出时间码，每步可撤销。默认关闭，需在设置中填入自己的 API Key（支持 Claude、OpenAI、Gemini、Mistral 等服务商）。

AI 编程代理集成

内置 MCP 服务器与演示技能包，Claude Code、Codex、Cursor 等代理可以自动完成"录制 → 编辑 → 导出 MP4 → 附加到 Pull Request"的完整流程，适合为开源项目自动生成功能演示：

npx skills add getopenscreen/openscreen --skill openscreen-demo -y

命令行（CLI）模式

无头模式支持脚本化录制、编辑与导出；.openscreen 项目文件为 JSON 格式，可编程修改，CLI 以 NDJSON 输出进度，适合 CI 流水线与自动化场景。

7. 常见问题排查

录不出画面 / 黑屏

macOS：检查屏幕录制权限是否已授予并重启应用；
Windows：确认使用 Windows 10（1903）以上系统；
Linux Wayland：确认 xdg-desktop-portal 与 PipeWire 已安装并运行。

没有系统声音

Windows 开箱即用；macOS 与 Linux 请在录制面板确认已勾选系统音频，Linux 需 PipeWire。

导出较慢

优先确认 GPU 驱动正常；无可用 GPU 时自动回退 CPU 编码，耗时增加属正常现象；适当降低分辨率或帧率可加快导出。

字幕生成失败

首次生成需联网下载本地模型，请确认网络可用；此后可完全离线使用。

更多问题可查阅 GitHub 仓库文档或提交 Issue 反馈。

从安装到导出，一篇讲透