AloneMonkey/MonkeyDev

MonkeyDev

使用 AI 安装或操作 MonkeyDev：请先读取 SKILL.md，按其中的安装、使用流程和注意事项执行。可以直接将该文件链接提供给 AI。

MonkeyDev 基于 iOSOpenDev，为 Xcode 提供 MonkeyApp 模板，用于向已有 iOS App 注入 dylib、开发 Objective-C / Logos Hook，并使用 Xcode 重签名、安装和调试。

当前支持 Apple Silicon Mac 和 iOS 15+ 非越狱 iPhoneOS arm64 真机。已用内置 Demo 和未加密 App 验证构建、重复安装、Hook、符号断点、头文件导出及 Reveal。验证环境为 Xcode 27.0（27A266a）、iPhone 14 Pro / iOS 18.6.2。

安装

需要完整 Xcode、原生 arm64 shell，以及当前用户的 ~/theos。发行包已包含原生 monkeyparser 和 class-dump，正常安装无需自行编译这些工具。

先以普通用户安装 Theos，不要将其安装到 /opt/theos：

bash -c "$(curl -fsSL https://raw.githubusercontent.com/theos/theos/master/bin/install-theos)"

首次安装：

sudo /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/AloneMonkey/MonkeyDev/master/bin/md-install)"
/opt/MonkeyDev/bin/md-doctor

后续更新：

sudo /opt/MonkeyDev/bin/md-update

开发时，也可在 MonkeyDev 源码目录安装或更新本地版本：

sudo env MONKEYDEV_SOURCE_DIR="$PWD" /bin/bash bin/md-install
# 本地更新仍指定源码目录：
sudo env MONKEYDEV_SOURCE_DIR="$PWD" /bin/bash bin/md-update
/opt/MonkeyDev/bin/md-doctor

macOS 原有 /bin/sh -c 入口也已验证兼容。安装位置为 /opt/MonkeyDev，模板注册在当前用户的 Xcode 模板目录；安装、更新和卸载不修改 Xcode.app。安装器先准备并校验完整版本，再替换安装，生成版本回执和文件哈希。完整模板统一维护在 MonkeyDev-Xcode-Templates，安装时直接复制，不再应用模板补丁。

创建并运行 MonkeyApp

1. 安装后保存工作并重启 Xcode，通过 File → New → Project → MonkeyDev → MonkeyApp 新建工程。
2. 填写项目名称、开发团队和 Organization Identifier。Target App 保持 Optional。
3. 将一个已砸壳的 IPA 或未加密 .app 放入 <App target>/TargetApp/，保持只有一份目标输入。不放输入时使用内置 Demo；无需设置 MONKEYDEV_INPUT_APP。
4. 选择 iPhone，以 Debug Build/Run。签名需要当前团队可用的证书、匹配的描述文件及设备授权。

Target App 文本框是历史越狱 Frida/SSH dump 入口，不是 IPA 路径选择器；该入口未纳入当前验证范围。使用上述 TargetApp 文件夹放入未加密输入，MonkeyDev 不负责在非越狱设备上自动砸壳。

创建向导提供以下下拉选项；创建后仍可在 App target → Build Settings → User-Defined 修改：

默认使用项目 Bundle ID。保留原 Bundle ID 仍需要描述文件授权该 ID，开关不会绕过签名权限。最小运行时固定开启，不捆绑旧 Substrate/Cycript。

编写 Hook 与调试

• <项目名>Dylib/<项目名>Dylib.m：普通 Objective-C / CaptainHook 示例，使用内部 runtime 后端。
• <项目名>Dylib/Logos/<项目名>Dylib.xm：Logos 示例，采用 internal 后端；生成的 .mm 同时参与编译，编辑源文件 .xm，不要手改 .mm。
• 两个入口可以同时执行。正式模板只打印示例日志，不自动弹窗；Trace 不自动注册业务方法。

源码断点直接设在 dylib 的实际语句上。分析输入 App 的 OC 方法时，可开启符号还原，重新构建后在 LLDB 设置符号断点：

breakpoint set -n '-[YourClass yourMethod:]'

将类名和 selector 换成目标 App 的实际方法。基础 UI/runtime 查询位于 Tools/LLDBTools.h/.mm，方法追踪位于 Trace/MDMethodTrace.h/.mm，均仅 Debug 可用。Trace 输出调用编号、线程号、嵌套深度、参数、返回值及同步方法耗时；它只支持明确的签名子集，不是任意 ABI 的通用 Hook。

头文件与视图检查

开启 Export OC Headers 后，构建将主程序头文件导出到可见目录：

<工程目录>/Headers/<App target 名>/

构建日志会打印实际路径。头文件不会自动加入 Xcode 的 App target；生成目录应加入项目 .gitignore。旧版本曾使用 .monkeydev/Headers，现有工程下次构建使用新目录。头文件主要用于分析，不保证能作为完整 SDK 直接编译。

Reveal 使用用户本机 SDK，不再随 MonkeyDev 分发框架。先通过 Reveal 下载 SDK，默认读取：

~/Library/Application Support/Reveal/RevealServer/RevealServer.xcframework

选择 UI Inspector (Debug) → Reveal 后重新 Build/Run，允许 App 的本地网络访问，在 Reveal 选择运行中的 App；USB 连接已验证。查看层级时保持 App 继续运行，不停在断点上。Release 不接入 Reveal。

LookinServer 1.2.8 的 arm64 动态 framework 已内置。安装 Lookin 桌面客户端后，选择 UI Inspector (Debug) → Lookin，Debug Build/Run，通过 USB 在 Lookin 打开运行中的 App，无需额外下载或编译 Server。自定义版本可通过 MONKEYDEV_LOOKIN_SDK 指定动态 framework 路径。Release 不接入。

旧工程的 MONKEYDEV_REVEAL=YES 仍可用；显式设置 MONKEYDEV_UI_INSPECTOR 时以新选项为准。上游许可证、对应源码和版本说明保留在 Librarys/Lookin/。

MonkeyPod

MonkeyPod 将 CaptainHook 插件做成可复用的 CocoaPods 库，由 MonkeyApp 的 Dylib target 引用，不负责独立重签名或设备安装。先安装 CocoaPods：

brew install cocoapods

用 MonkeyDev → MonkeyPod 创建工程。向导生成 Objective-C framework、公开头文件和同目录的 podspec，支持 iOS 15+ arm64。先用本地 Pod 验证，在 MonkeyApp 工程根目录创建 Podfile，例如：

# 兼容当前 CocoaPods 尚未支持的 Xcode 27 工程字段，仅在本次进程中生效。
require '/opt/MonkeyDev/Tools/cocoapods-compat'

platform :ios, '15.0'
target 'YourAppDylib' do
  use_frameworks! :linkage => :dynamic
  pod 'YourPlugin', :path => '../YourPlugin/YourPlugin'
end

替换 target、Pod 名和路径；:path 指向 podspec 所在目录，不是 .xcodeproj。执行 pod install 后打开 .xcworkspace，通过 MonkeyApp 的 App scheme Build/Run。使用动态 framework，让插件 constructor 随加载执行，避免静态链接时只含 Hook 函数的文件被丢弃。

默认示例对 CustomViewController 的实例方法 getMyName 返回 MonkeyDevPod，可用 MonkeyApp 内置 Demo 验证；实际使用时改成目标 App 的类、selector 和准确签名。CaptainHook 使用内部后端，不链接旧 Substrate。插件 framework 会由现有打包流程复制并签名。

兼容模块转换脚本数组和 framework 复制目的地，生成的 Pods 工程使用 CocoaPods 支持的格式，不修改宿主工程版本或已安装的 gem。遇到旧解析器不支持的其他 dstSubfolder 复制目录时会报错停止，避免保存时丢失目录配置。当前新格式仍可能出现版本提示；遇到其他未知字段时先检查，不按本例推断任意第三方工程均兼容。发布 Pod 前需自行补齐实际仓库、作者、许可等元数据，默认示例地址不能用于发布。

越狱 Logos Tweak

Logos Tweak、CaptainHook Tweak、Command-line Tool 创建向导的 Package Scheme 可选择 rootless（默认）、rootful 或 roothide，自动切换构建配置和 deb 布局。Tweak 需要兼容 MobileSubstrate 接口的 Hook 框架（例如对应环境的 ElleKit），不随插件打包旧 Substrate。roothide 使用随机越狱根目录，不能用普通 rootless 包直接代替。 仅选择 roothide 时可直接 #include <roothide.h>，通过 jbroot() 等官方接口访问插件资源；未调用 API 不保留运行库依赖。rootless/rootful 不引入该 SDK。

CaptainHook Tweak 和 Command-line Tool 使用相同的 USB、认证和 deb 安装配置。CaptainHook 默认使用内部 Objective-C Runtime Hook，不链接 Substrate；仍需设备上的 tweak 加载器加载插件。将工程 Package/Library/MobileSubstrate/DynamicLibraries/<项目名>.plist 的 Filter 改为目标 App 的 Bundle ID。

Command-line Tool 保留 C、C++、Foundation、Core Foundation 类型，使用 ldid 签名，默认不申请额外权限。rootless 安装到 /var/jb/usr/bin，rootful / roothide 安装到 /usr/bin（roothide 环境内的逻辑路径）；安装后通过设备 SSH 执行程序，不通过 Xcode Run 启动。

创建向导默认使用 USB 连接和 rootless 布局，授权方式可选 None、KEY（默认，SSH 密钥免密）或 PASSWORD（输入设备账号、密码）。None 只生成 deb，不安装；KEY 和 PASSWORD 在 Build 后自动安装 tweak。免密模式沿用 SSH 配置；只有密码模式启用账号、密码输入，默认账号为 mobile，密码必填。向导填写的密码会保存在工程中，请勿提交或分享。

USB 优先使用显式配置的 UDID，其次使用 Xcode 选择的设备，否则自动识别唯一连接的 USB 设备。IP 连接、SSH 别名和其他高级设置仍可在 target 的 Build Settings 中配置：

USB 模式需要 brew install libusbmuxd libimobiledevice，无需启动 iproxy；密码认证需要 brew install sshpass。密码也可通过不提交 Git 的本地配置设置 MonkeyDevDevicePassword，或使用密码文件。密码文件与直接配置同时存在时，以密码文件为准。

首次连接先在终端确认设备 SSH 主机身份。USB 模式在 rootless/rootful 下使用 monkeydev-usb-<UDID>，roothide 下使用独立的 monkeydev-roothide-<UDID> 作为主机身份别名；IP 模式使用目标主机身份；SSH 模式遵循用户已有配置。构建不会关闭主机密钥检查。SSH 免密登录与 sudo 权限独立：mobile 免密登录后，安装 deb 仍需要 sudo 密码或已有的免密 sudo 权限。

首次 USB 连接可用下面的命令，将 <UDID> 和 mobile 替换为实际设备与账号；密钥可由 SSH 配置提供，也可通过 -i 指定：

# rootless / rootful
ssh -o "ProxyCommand=inetcat -u <UDID> 22" -o "HostKeyAlias=monkeydev-usb-<UDID>" mobile@usb-iphone

# roothide
ssh -o "ProxyCommand=inetcat -u <UDID> 22" -o "HostKeyAlias=monkeydev-roothide-<UDID>" mobile@usb-iphone

支持范围与迁移

• 支持 MonkeyApp 的 thin arm64、未加密 iOS 真机输入；不支持 Intel 主机、模拟器、arm64e/PAC、Fat 或加密输入。arm64e 设备可以运行 arm64 App。
• 打包副本会移除 App 扩展、Watch 和旧 Store 元数据；当前不覆盖扩展的独立签名与安装。原始 IPA/App 保留。
• Cycript 和旧 Substrate 运行库已移除。CaptainHook/Logos internal 保留；Logos internal 不支持 %hookf。
• Logos Tweak、CaptainHook Tweak、iOS Command-line Tool 的 rootless arm64 已完成真机验证；Logos Tweak、CaptainHook Tweak 另已在 iPhone X / iOS 16.7.16 / Dopamine-roothide 2.4.9.27 + ElleKit 验证安装及 Hook 弹窗，Command-line Tool 的 C 示例也已验证安装与 SSH 执行；rootful 仅完成构建和打包检查。
• MonkeyPod 已完成本地动态 Pod 接入 MonkeyApp、签名安装及真机 Hook 验证；Pod 发布流程未验证。
• macOS 模板尚未迁移验证，不在当前支持范围内。
• 模板更新影响新建项目；已有工程需单独迁移。增量构建的签名阶段必须每次执行。

历史资料保留在 Wiki 和 MonkeyDevSpecs，其中旧依赖和安装步骤不代表当前适配状态。

卸载

sudo /opt/MonkeyDev/bin/md-uninstall

卸载会删除整个 /opt/MonkeyDev 专用目录（包括自行放入其中的文件），以及安装器记录的模板链接和 shell 配置。需要保留的自定义文件请先备份；工程、目标 IPA/App 和 Theos 不会删除，也不会修改 Xcode.app。

免责声明: 软件仅供技术交流，禁止用于商业及非法用途，如产生法律纠纷与本人无关。

个人博客

欢迎访问我的个人博客 AloneMonkey，阅读更多技术文章与实践分享。

关注公众号 · 添加个人微信

欢迎扫码关注我的微信公众号，或添加个人微信，一起交流技术与实践。

个人微信 · AloneMonkey	微信公众号