Skip to content

233box/Sai2Capture

Repository files navigation

此文档由AI生成,部分内容可能存在不准确或错误,敬请谅解。

Sai2Capture - SAI2 视频录制工具

一个专为 SAI2(日本著名绘画软件)用户设计的窗口内容录制工具,能够自动捕获窗口变化并生成高质量视频文件。

🆕 最近更新

2026-03-08

  • 结构化数据存储 - 新增 .sai2rec 录制格式,支持崩溃恢复和断点续录
  • FFmpeg 视频导出 - 支持多种编解码器(H.264、H.265、VP9、AV1、MJPEG 等)
  • 质量等级选择 - 提供 5 档视频质量等级,平衡文件大小与画质
  • 录制管理功能 - 统一的录制文件管理和视频导出界面

✨ 主要特性

  • 🎯 智能窗口捕获 - 自动检测并录制指定窗口的内容变化
  • 🎬 高效压缩录制 - 只在内容发生变化时才捕获帧,大幅减少文件体积
  • ⏸️ 暂停与继续 - 支持录制过程中暂停和继续,方便分段创作
  • 🔧 灵活配置 - 可自定义捕获间隔、窗口选择、缩放级别等参数
  • 🔥 全局热键 - 支持全局快捷键操作,无需切换窗口
  • 🎵 操作反馈 - 丰富的音效和视觉反馈,操作状态一目了然
  • 📱 美观界面 - 现代化的 WPF 界面设计,简洁易用
  • 🖼️ 实时预览 - 嵌入式预览窗口,实时查看目标窗口内容
  • 📐 画布监控 - 自动检测 SAI2 画布尺寸并实时显示

🚀 快速开始

系统要求

  • Windows 10/11 (版本 19041 或更高)
  • 64 位操作系统
  • 无需安装 .NET Runtime(自包含发布)

安装步骤

  1. Releases 页面下载最新版本的安装包
  2. 解压到任意文件夹
  3. 运行 Sai2Capture.exe

基本使用

  1. 启动应用 - 打开 Sai2Capture
  2. 选择目标窗口 - 在"窗口名称"下拉框中选择要录制的 SAI2 窗口
    • 为了使录取效果最好,建议在sai2中将导航器的大小调整到最大(设置大小上限至最大,手动调整导航器至最大)
  3. 调整设置 - 根据需要调整捕获间隔、视频质量等参数
  4. 开始录制 - 点击"开始捕获"按钮或使用快捷键开始录制
  5. 控制录制 - 可随时暂停、继续或停止录制
  6. 保存视频 - 停止录制后,视频文件会自动保存到指定文件夹

🎮 操作指南

主界面功能

  • 主页面 - 核心录制控制和状态显示
    • 主要控制按钮
    • 实时显示 SAI2 画布尺寸信息
    • 嵌入式预览窗口
  • 设置页 - 详细的参数配置和热键管理
  • 系统日志 - 实时查看操作记录和错误信息,支持日志级别过滤(全部/INFO/WARNING/ERROR)

录制控制

  • 开始捕获 - 开始监控窗口变化并准备录制
  • 暂停捕获 - 暂停录制(保留已捕获内容)
  • 停止捕获 - 停止录制并生成视频文件

界面特性

  • 窗口记忆 - 自动保存窗口大小和位置,下次启动时恢复用户的界面设置
  • 响应式布局 - 优化的窗口尺寸(默认 800x600)和按钮排列方式
  • 画布轮询 - 每 2 秒自动检查 SAI2 画布尺寸变化

热键与窗口管理

默认快捷键(可在设置中自定义):

  • F9 - 开始捕获

  • F10 - 暂停/继续捕获

  • F11 - 停止捕获

  • 窗口置顶 - 支持切换窗口置顶状态,方便边录制边操作(可通过热键触发)

  • 自定义热键 - 可为各种操作绑定全局热键

🛠️ 技术架构

核心技术

  • 框架: .NET 8.0 + WPF
  • 图像处理: OpenCvSharp4 4.8.0
  • 窗口捕获: Windows PrintWindow API
  • 视频编码: FFmpeg(通过 FFMpegCore,支持 H.264、H.265、VP9、AV1 等)
  • 依赖注入: Microsoft.Extensions.DependencyInjection 8.0.0
  • MVVM 框架: CommunityToolkit.Mvvm 8.2.0
  • 自定义窗口样式: 基于 WPF 的自定义窗口样式系统
  • 设置管理: 基于 JSON 的配置持久化,支持窗口状态记忆
  • 录制格式: 自定义 .sai2rec 二进制格式(支持崩溃恢复和断点续录)

性能特点

  • 启动速度: 快速启动,无需配置复杂环境
  • 内存占用: 合理的内存使用,适合长时间运行
  • CPU 效率: 智能帧差检测,仅在内容变化时处理
  • 兼容性: 优秀的系统兼容性,支持 Windows 10/11

💡 使用技巧

  1. 优化性能 - 调整捕获间隔,较低值提供更流畅的效果但文件更大
  2. 预览窗口 - 使用预览功能确保选择了正确的窗口
  3. 画布监控 - 自动检测 SAI2 画布尺寸,支持 .sai2 文件路径解析
  4. 批量处理 - 设置完成后可重复使用相同的配置
  5. 故障排除 - 查看系统日志了解详细错误信息,支持按级别过滤
  6. 视频导出 - 支持多种编解码器选择,H.264 兼容性最好,H.265 压缩率更高
  7. 质量等级 - 根据需求选择质量等级(1-5),等级 2「高质量」为推荐设置
  8. 崩溃恢复 - 使用 .sai2rec 格式录制,意外中断后可继续录制

项目结构

Sai2Capture/
├── Converters/                 # 数据转换器
├── Helpers/                    # 辅助工具类
├── Models/                     # 数据模型
├── Services/                   # 核心服务层
│   ├── CaptureService          # 录制控制服务
│   ├── CustomDialogService     # 自定义对话框服务
│   ├── FFmpegVideoEncoder      # FFmpeg 视频编码器
│   ├── HotkeyService           # 全局热键服务
│   ├── LogService              # 日志服务
│   ├── RecordingDataService    # 录制数据服务(.sai2rec 格式)
│   ├── Sai2FileParser          # SAI2 文件解析
│   ├── SettingsService         # 设置管理服务
│   ├── SharedStateService      # 全局状态管理
│   ├── SoundService            # 音效服务
│   ├── UtilityService          # 实用工具服务
│   └── WindowCaptureService    # 窗口捕获服务
├── Styles/                     # UI 样式和窗口基类
├── ViewModels/                 # MVVM 视图模型
├── Views/                      # UI 视图
├── Sounds/                     # 音效资源(嵌入式)

🤝 反馈与建议

如果您在使用过程中遇到问题或有改进建议,欢迎通过以下方式反馈:

  • 提交 Issue
  • 在讨论区分享使用经验

📄 许可证

本项目采用 MIT 许可证,详情请参阅 LICENSE 文件。


享受您的创作之旅! 🎨✨

About

专为sai2设计的录制软件,集成了启动sai2的快捷方式

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages