CatClaw.Qemu

项目概述

CatClaw.Qemu 是猫爪影视（CatClawVideo）的虚拟机套件组件，不是独立软件。它由 C# 宿主引擎、QEMU 虚拟机和 Java 桥接层组成，把 TVBox 风格爬虫壳、迅雷下载引擎等第三方组件放进虚拟机里运行，避免它们直接触碰宿主系统，需配合主程序使用。

用虚拟机隔离运行爬虫壳与下载引擎的安全底座。

主要功能

• QEMU 进程管理：负责虚拟机的启动、停止与整个生命周期维护
• ART 桥接：通过 Java 桥连接 Android 运行时与宿主引擎
• 爬虫壳隔离：把 TVBox 风格爬虫壳放进虚拟机执行，宿主不受其副作用影响
• 迅雷下载引擎：在虚拟机内驱动迅雷下载引擎完成下载任务
• 磁力链接解析：内置磁力 DTO 处理，对接下载链路
• 流媒体代理：提供流代理服务，播放地址经宿主中转
• 稀疏块设备：虚拟磁盘采用稀疏块设备格式，节省磁盘占用
• WHPX 探测：自动探测 Windows 平台 WHPX 硬件加速可用性
• 守卫解壳虚拟机：为解壳流程提供带守卫的专用虚拟机环境

适用人群

• 猫爪影视的使用者
• 开发 TVBox 类客户端的人
• 研究安卓虚拟化方案的开发者
• 需要隔离运行爬虫壳的技术用户

快速上手

1. 先安装猫爪影视（CatClawVideo）主程序
2. 按主程序说明引入本套件组件
3. 在主程序内启用爬虫壳或下载引擎，组件自动拉起虚拟机

核心优势

• 隔离安全：第三方壳与引擎跑在虚拟机内，出问题不波及宿主
• 性能兼顾：WHPX 加速探测与稀疏磁盘兼顾速度和空间
• 集成度高：与主程序之间的桥接层开箱即用，无需自行拼装

系统要求

项目	要求
宿主环境	猫爪影视主程序（.NET MAUI）
运行时	.NET 11
虚拟化	QEMU，Windows 下可用 WHPX 加速

注意事项

• 本仓库是组件库，不能脱离猫爪影视主程序单独运行
• 需要宿主机支持虚拟化，实际性能与硬件加速条件相关