vphone 是基于 Apple Virtualization.framework（PV=3 私有授权）的虚拟 iPhone 研究与工程平台：在 Apple Silicon 上运行完整的 iOS 用户态与内核——不是模拟器，也不是容器。固件补丁、DFU restore、CFW 注入、风控对抗、多 VM 管理、集群与 AI 自动化，构建期与运行期两条主线在同一套 Swift 工程里闭环。
vphone-cli vm create myphone -V dev# 研究变体：完整调试 + 环境伪装vphone-cli vm create myphone -V jb# 越狱变体：Sileo / TrollStore / procursus四个进程域 + 一组共享库：宿主机上的三个前端链接同一组 SwiftPM 库，受限特权操作收敛到一个 root LaunchDaemon，VM 内运行完整 iOS 与 vphoned 守护进程，外部客户端只认一个 Unix socket。
关键设计：vphone-manager 与 vphone-agent 都不持有 VZVirtualMachine——一律 spawn 已签名（PV=3 私有 entitlement）的无头 vphone-cli 子进程，经 HostControl socket 驱动。因此 agent 无需私有 entitlement 即可正常签名分发到任意 Mac，重启也不影响托管中的 VM；standalone agent 与 Manager 内嵌 agent 共享同一张 53 条路由表，两侧行为完全一致。
同一份 hybrid 固件，补丁组合与 CFW 内容由 -V 变体决定。日常研究与工程聚焦两档：dev 与 jb——后者是前者的超集，共享全部内核伪装与调试补丁。
保留完整调试能力与环境伪装，不引入越狱特征——攻击面与指纹可控，是日常研究、风控对抗与 AI 自动化的默认形态。
Selector24 / get-task-allow / 调试器 entitlement 放行，debugserver 可调试任意进程devOnly 补丁组：sysctl 伪装、kern.version 改写、pdp_ip0~4 蜂窝网卡注册dev 的超集：完整保留 dev 的内核伪装与调试补丁，再叠加越狱链——launchd hook + procursus 引导，开箱即用的越狱生态。
generate_nonce：apnonce 保持稳定，SHSH 票据可离线复用jbOnly 内核组 + launchdhook.dylib 注入 + Procursus bootstrap，Sileo / apt 生态可用vphone_jb_setup.sh 自动建符号链接、装 Sileo / TrollStore，日志落 /var/log/vphone_jb_setup.log底层另保留 regular（最小可用基座，不含越狱与伪装增量）与 exp（jb 超集 + 反 VM 检测研究补丁）两档作为工程基线与实验扩展；逐 patch 对比以仓库 research/0_binary_patch_comparison.md 为准。
vm create 由 VPhoneCreateOrchestrator 编排五阶段（结构化事件流 + 全程可取消），vphone-manager 的创建向导 in-process 驱动同一编排器；Python 仅保留 DFU restore 桥一处子进程。每阶段也可单独驱动，便于调试与重跑。
fw prepareiPhone 与 cloudOS（PCC）两份 IPSW 解包合并，产出可 restore 的混合固件。
Firmware/ 子树（agx / all_flash / ane / dfu / pmp）覆盖进 iPhone 树；dmg 与 trustcache 保留 iPhone 版BuildManifest：DFU 下自认 cloudOS research 设备，文件系统来自 iPhone 侧；配对表单一数据源在 config/firmware_catalog.jsonfw patch对 *Restore*/ 目录原地改写启动链组件，按变体串联补丁器。
PatchRecord（offset 与前后状态）落 patch_report.json，可审计、可回归比对DFU restore机器进 DFU，把混合固件真正刷进虚拟磁盘。
boot --dfu 先启动 ramdisk 引导，经 pymobiledevice3_bridge.py 与恢复模式交互restore-get-shsh 抓取 SHSH blob 存 bundle 根， restore-update 带 --tss 走离线 TSS 刷入Disk.img 与 SEPStorage；DFU 进程收尾终止，guest 干净关机cfw installhost-mount 挂起系统盘，把变体内容写进 guest（VM 须关机）。
CFWHostMounter 经 com.vphone.helper（root LaunchDaemon）挂载 Disk.img——特权面收敛在受限 helper 协议内ApfsSnapRename 翻转 APFS boot snapshot，下次启动直接吃到新系统卷first boot启动 VM，验证整条链路并把环境收拾到位。
vphoned 在 vsock:1337 就位，控制面即刻可用fwPrepareFailed / restoreGetSHSHFailed / firstBootPanic…），子进程 defer 终止不留悬挂对抗目标不是「藏得更深」，而是让风控读到一台语义自洽的真机：iPhone17,3、A18（T8140）、有蜂窝、有传感器、进程表干净。内核 sysctl、设备树与硬件、文件系统路径、服务命名四个层面同时收敛——所有伪装均在构建期（kernelcache / DSC / CFW）一次性注入，guest 内没有常驻注入框架。
kernel.sysctl_spoof · kernel.version_string
kern.hv_vmm_present caller-aware 动态伪装：代码洞 hook + 静态进程白名单（launchd / 系统守护进程读真值，否则 panic），App 读到 0；AMFI 与 Sandbox 内部查询同步处理kern.bootargs 对 App 返回 EPERM（模拟真机受限语义），launchd 读真值hw.machine / hw.cpufamily 恒定返回 iPhone17,3 / 0x6F5129AC（A18 真实值）kern.version： RELEASE_ARM64_VRESEARCH1 → RELEASE_ARM64_T8140，等长 NUL 填充——一发命中的「sysctl 银弹」失效cpus=6 boot-arg：不打 sysctl 补丁，从内核拓扑源头只拉起 6 CPU，hw.ncpu 与 commpage 的 activeProcessorCount 天然一致kern.hv_support ENOENT→EPERM 模拟真机沙盒拒绝；kern.boottime 向过去偏移固定 deltaDeviceTree · ifnet · GPU bundle · CoreMotion
pdp_ip0~4：bsd_init 钩子注册 IFT_CELLULAR 假蜂窝 ifnet——App getifaddrs() 可见蜂窝网卡，无需基带AppleParavirtGPUMetalIOGPUFamily → AppleGFXHW，bundle 名、bundle id 与 Metal plugin 引用同步改写std_sum ≈ 5.4e-3，稳过「零噪声探针」CFW 落盘形态 · launchd 进程表
iosbinpack64 物化为 /usr/libexec/.sysbinpack：工具链全盘路径重写，guest 无显眼目录名vphoned 伪装为 com.apple.mobile.assetd、bash 为 com.apple.security.shell——launchd 进程表第一眼像原生系统VPHONE_VNC_DAEMONS=1 才注入从单机研究工具到可运维的设备农场：GUI、集群节点 daemon、网络 sidecar 与自动化控制面各自独立成进程，共享同一组库与同一套协议——本地与远程、人工与 AI，操作语义完全同构。
H.264 屏幕流（硬编硬解，失败自动回退轮询截图）、手势自动识别、录屏导出 .mov；SSH 内嵌终端VPhone.app：内嵌签名 CLI、特权 helper、agent 与 guest 资源，Finder 双击即用AgentRoutes 单一数据源），两侧行为一致_vphone-node._tcp 自动发现 + 6 位配对码免手填 token；协议版本不匹配 fail-fast 拒绝192.168.127.1 / guest .2），分 VM proxy_config.json，运行时 network-control 热改分流规则与 UDP 策略llm-context 把屏幕上下文导出给 LLM 直接生成操作脚本；MCP server 将 VM 操作暴露为 AI 工具vm create Checkpoint 续跑：失败 / 取消 / 断电后重跑从断点续起， restore 5–30 分钟不再白做一台启动完成的虚拟 iPhone（dev 变体），经 vphone-manager 屏幕流与控制面操控——本地与远程节点同一套界面。
