Skip to content

233box/Sai2Capture

Repository files navigation

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

Sai2Capture - SAI2 视频录制工具

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

🆕 最近更新

2026-03-08

  • 直接 MP4 录制 - 录制内容直接保存为 MP4 格式,无需二次导出
  • FFmpeg 视频编码 - 使用 FFmpeg 进行高质量视频编码,支持多种编解码器
  • 高效帧捕获 - 仅在内容变化时捕获帧,大幅减少文件体积

✨ 主要特性

  • 🎯 智能窗口捕获 - 自动检测并录制指定窗口的内容变化
  • 🎬 高效压缩录制 - 只在内容发生变化时才捕获帧,大幅减少文件体积
  • ⏸️ 暂停与继续 - 支持录制过程中暂停和继续,方便分段创作
  • 🔧 灵活配置 - 可自定义捕获间隔、窗口选择、缩放级别等参数
  • 🔥 全局热键 - 支持全局快捷键操作,无需切换窗口
  • 🎵 操作反馈 - 丰富的音效和视觉反馈,操作状态一目了然
  • 📱 美观界面 - 现代化的 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 的配置持久化,支持窗口状态记忆
  • 录制格式: MP4 视频格式(H.264/AVC 编码)

性能特点

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

💡 使用技巧

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

项目结构

Sai2Capture/
├── Converters/                 # 数据转换器
├── Helpers/                    # 辅助工具类
├── Models/                     # 数据模型
├── Services/                   # 核心服务层
│   ├── CaptureService          # 录制控制服务
│   ├── CustomDialogService     # 自定义对话框服务
│   ├── FFmpegVideoEncoder      # FFmpeg 视频编码器
│   ├── HotkeyService           # 全局热键服务
│   ├── LogService              # 日志服务
│   ├── 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