Coredevice Toolkit

CoreDevice RSD 极客工具箱 (iOS 单机开发者中枢)

本 Skill 将原本必须通过 USB 数据线连接 Mac/Xcode 才能调用的苹果底层开发者特权（CoreDevice RSD 加密隧道），通过 Surge 本地回环反射 + 纯用户态网络协议栈 完整搬迁至 iPhone 单机内部。

一、 前置准备与环境要求

1. 系统版本：
   • 已实测验证 (Verified)：iOS 18.0+（包含当前真机环境）；
   • 实验性支持 (Experimental)：iOS 17.0 ~ 17.7（因部分小版本系统 remoted 守护进程可能仅监听 IPv6 Link-Local 或存在端口漂移，欢迎社区测试反馈）；
   • 需在系统【设置 ➡️ 隐私与安全性】中开启「开发者模式」；
2. 本地回环基建：Surge 启用 10.7.0.1 = reflect 与 tun-included-routes = 10.7.0.1/32（详见 Surge 回环配置指南）；
3. 配对文件：手机与电脑配对生成的 .plist 文件或 SideStore 配对文件（详见 配对文件指南）；
4. 一键初始化：在终端运行 sh /var/minis/skills/coredevice-toolkit/scripts/setup.sh，自动安装依赖并将全套 CLI 注册至全局路径。

二、 架构原理：单机莫比乌斯环 🔌🔄

Copy code
┌────────────────────────────────────────────────────────────────────────┐
│                        iPhone 单机内部 (Non-Jailbroken)                 │
│                                                                        │
│   [ 应用层 / CLI 工具: cdtk-* ]                                         │
│       │                                                                │
│       ▼                                                                │
│   coredevice_session.py (CoreDeviceSession 异步上下文管理器)            │
│       │                                                                │
│       ├── Node.js TLS-PSK 桥接 (通过 stdin 安全投递 PSK，0 命令行泄露) │
│       ▼                                                                │
│   pmd-pytcp (纯用户态 TCP/IP 协议栈，无 root 免虚拟网卡拨号)            │
│       │                                                                │
│       ▼                                                                │
│   发往 10.7.0.1:49152 (目标：本地开发者配对服务)                         │
│       │                                                                │
│       ▼                                                                │
│   Surge IP Rewrite (10.7.0.1 = reflect 本地反射回环)                   │
│       │                                                                │
│       ▼                                                                │
│   iOS 系统内核守护进程: remoted / launchd (85 大官方 Remote Services)   │
└────────────────────────────────────────────────────────────────────────┘

依赖与上游 API 说明

• 用户态协议栈 (UserspaceTun & UserspaceDialPlane)：iOS 环境下无 root 权限，无法创建内核级虚拟网卡（utun 设备节点）。本工具链采用 pymobiledevice3 原生提供的 remote.userspace_tunnel 与 pmd-pytcp（纯 Python 实现的 L2 协议栈），在内存中虚拟出 TCP/IP 握手层，实现非越狱环境下的用户态直接通信。
• 环境依赖版本：
  • python3 (>=3.10)
  • nodejs (>=18.0)
  • pymobiledevice3 (>=11.34.0)
  • pmd-pytcp (>=0.1.0)
  • cryptography (>=41.0.0)

三、 专属核心 CLI 工具矩阵 (cdtk-*)

安装后可在终端直接调用以下 7 大全局命令行神器：

1. cdtk-install（免电脑开发侧载与自签直装）

• 功能：自动动态发现本地证书与描述文件、自动签名（支持自定义 App 展现名称与 Bundle ID 避免冲突），并通过底层 installation_proxy 原生推流直装进入系统。
• 常用命令：

  bashCopy code
  cdtk-install list                     # 查看全量已安装应用与元数据
  cdtk-install install app.ipa          # 原生签名并直装 IPA
  cdtk-install install app.ipa -b com.demo.app -n "测试分身" -y # 多开分身直装
  cdtk-install uninstall <bundle_id> -y # 原生反注册卸载
  

2. cdtk-ctrl（原生应用生命周期与硬件触控控制）

• 功能：基于 com.apple.coredevice.appservice 与 dtuhidd，免无障碍权限直接拉起/保活前后台 App，列出全系统 400+ 正在运行的进程，枚举物理触控/按键设备。
• 常用命令：

  bashCopy code
  cdtk-ctrl launch <bundle_id>          # 原生拉起任意 App (如 com.apple.Preferences)
  cdtk-ctrl procs                       # 列出系统前后台正在运行的全部 App 进程
  cdtk-ctrl hid-list                    # 枚举底层硬件输入设备 (触摸屏/键盘/按键)
  cdtk-ctrl tap <x> <y>                 # 向物理屏幕注入底层硬件级触控点击
  cdtk-ctrl swipe <x1> <y1> <x2> <y2>   # 注入底层硬件级滑动轨迹
  

3. cdtk-profile（免确认静默描述文件管理器）

• 功能：基于 com.apple.mobile.MCInstall.shim.remote，彻底告别 Safari 弹窗 ➡️ 设置 ➡️ 输两遍密码确认的繁琐流程，免跳转一键管理证书与配置。
• 常用命令：

  bashCopy code
  cdtk-profile list                     # 查看当前系统已安装的全部描述文件
  cdtk-profile install cert.mobileconfig -y # 协议层直接下发安装描述文件
  cdtk-profile remove <PayloadIdentifier> -y # 静默移除指定的描述文件
  

4. cdtk-fs（免越狱应用沙盒穿透与媒体管理）

• 功能：基于 house_arrest（沙盒软禁穿透服务）与 afc，免越狱穿透自签与开发 App 沙盒完整文件系统（Documents、Library、tmp），导出内部 SQLite 数据库，管理系统媒体分区。
• 常用命令：

  bashCopy code
  cdtk-fs app ls <bundle_id> [/path]    # 查看应用沙盒内部完整目录树
  cdtk-fs app pull <bid> <rem> <loc>    # 提取沙盒文件 (如导出 App 内部数据库)
  cdtk-fs media ls [/path]              # 查看系统媒体分区 (相册/下载/图书)
  cdtk-fs media pull <rem> <loc>        # 从媒体分区拉取文件
  

5. cdtk-diag（硬件真实健康度与系统实时内核日志）

• 功能：基于 diagnostics_relay 与 syslog_relay，绕过应用层伪装，直读电池出厂设计容量、真实循环次数与电芯电压，实时监听系统内核与沙盒级实时运行日志。
• 常用命令：

  bashCopy code
  cdtk-diag hw                          # 读取真实电池硬件报告 (循环/容量/序列号)
  cdtk-diag log -f "CoreDevice" -t 10   # 实时监听 10 秒包含关键字的系统内核日志
  

6. cdtk-crash（系统深处崩溃与闪退日志透视器）

• 功能：基于 crashreportcopymobile 协议，免电脑秒级拉取系统 .ips 崩溃与诊断日志，结构化解析异常代码（EXC_BAD_ACCESS）、终止原因与触发线程调用栈。
• 常用命令：

  bashCopy code
  cdtk-crash list                       # 查看最近系统全量崩溃与 Jetsam 诊断日志
  cdtk-crash view <filename.ips>        # 结构化深度解析异常码与崩溃线程栈
  cdtk-crash pull <filename.ips>        # 导出原始崩溃日志到本地分析
  cdtk-crash latest [app_name]          # 一键速查最近一次闪退日志
  

7. cdtk-inspect（全局 WebKit / H5 远程调试穿透）

• 功能：基于 webinspector 协议，跨进程探测并挂载系统中所有正在运行的 WebKit 页面、H5 混合应用视窗与 JS 上下文，提供实时页面结构与通信排障。
• 常用命令：

  bashCopy code
  cdtk-inspect list                     # 列出全机所有挂载 WebKit 引擎的页面与 ID
  

四、 安全规范与凭据防护机制 🛡️

1. AI / 自动化调用最高安全准则 (Mandatory Safety Rule)：
   • 绝对禁止静默执行修改：在未向用户发起询问并获得明确聊天答复许可前，严禁执行任何安装/移除描述文件（cdtk-profile install/remove）、安装/卸载应用（cdtk-install install/uninstall）或覆写应用沙盒文件操作！
   • 只有在获得用户明确授权后，方可在命令行中附加 -y / --yes 执行。若无 -y，CLI 进程将主动输出阻断提示并安全退出（退出码 1）；
2. 配对文件（Private Key）强隔离与权限阻断：
   • 配对文件 .plist 包含设备的 Ed25519 签名私钥，相当于全权设备信任凭据；
   • 禁止全盘盲目搜索：工具链仅允许从显式参数、CDTK_PAIRING_FILE 或专用工作区目录 /var/minis/workspace/cdtk/*.plist 读取；
   • 强制权限拦截：严禁加载权限过宽（Group / Other 可读）的配对文件！若文件权限不符合 chmod 600（属主独占只读/读写），底座将主动抛出 PermissionError 拒绝启动并提供阻断修复指引；
3. 进程间通信（IPC）零泄露与防僵尸回收：
   • TLS-PSK 预共享密钥全部经由标准输入（stdin）安全传递给 Node 桥接进程，严禁通过命令行参数（argv）传递，避免系统进程表（ps）泄露；
   • Node 代理子进程监听 stdin.on('close') 与 SIGTERM，在父进程异常断开或退出时联动自动自毁；
   • 本地 Unix Domain Socket 部署在严格受限的 0700 专用私有临时目录中，会话生命周期结束后自动进行物理级清理。