StosDebug 安装与使用指南

经常折腾 LiveContainer 或者 MeloNX 的朋友，可能会留意到一个叫 StosDebug 的工具。乍一看名字，以为又是个 JIT 启动器，但它和常见的 StikDebug 又不太一样。跑去官方仓库一看，啥也没有，心里难免痒痒的——这玩意儿到底能不能用？怎么用？今天这篇文章就来聊聊 StosDebug 的安装和使用，顺便对比一下它和 StikDebug 哪个更香。

StosDebug 有什么不一样

和 StikDebug 比起来，StosDebug 砍掉了一堆花里胡哨的功能，比如虚拟定位、进程管理这些，只保留了一个核心功能——开启 JIT。界面非常干净，虽然名字里带个“Debug”其实不太准确，但谁在乎呢。

更重要的是，StosDebug 是个新项目，设计之初就考虑到了 iOS 26+ 需要 JIT 脚本的特殊情况。不像 StikDebug 那样要手动管理 JIT 脚本，StosDebug 启用 JIT 时会自动检测包名并选取合适的脚本。如果搭配 LiveContainer 或者其他原生支持 StosDebug 作为 JIT 启动工具的应用，整个流程基本是无感的。

不过有个小遗憾——它对 TXM 的检测有点问题。比如我用的 iOS 18，虽然硬件支持 TXM，但 18 系统本身并没有像 26 系统那样为所有进程启用 TXM，实际上是个 Non-TXM 系统。可 StosDebug 仍然认为我的设备是 TXM-capable，并在启动时运行脚本。因为这个原因，StosDebug 目前还不是我的主力 JIT 工具。但如果你是 26.x 的系统，那还是值得一试的。

编译

目前 StosDebug 没有官方预编译的安装包，需要自己动手编译。这意味着你需要一台 Mac，或者借助 GitHub Actions 来完成编译。不想折腾编译的话直接在下方进行下载站长提供编译且汉化后的文件即可，不折腾编译可以直接跳过这一步。

使用 Mac 编译

首先安装本机支持的最新版 Xcode。比如我用的 macOS 15.6.1，就安装了 26.3 版本的 Xcode。

然后克隆仓库：

git clone https://github.com/stossy11/StosDebug

直接使用 Xcode 的 GUI 会强制进行代码签名，和你现有的侧载工具很可能冲突。所以我们需要用命令行编译未签名的程序包。

先检查当前工程有哪些 Scheme（正常情况下就叫 StosDebug）：

cd ~/StosDebug
xcodebuild -list

然后执行编译：

xcodebuild \
  -project StosDebug.xcodeproj \
  -scheme StosDebug \
  -configuration Release \
  -sdk iphoneos \
  -derivedDataPath build \
  CODE_SIGNING_ALLOWED=NO \
  CODE_SIGNING_REQUIRED=NO \
  CODE_SIGN_IDENTITY=""

这样就会在 build 目录里生成一大堆文件，其中我们关心的是 StosDebug.app，位于 build/Build/Products/Release-iphoneos。

接下来要打包成 IPA。IPA 本质上就是一个结构如下的 ZIP 压缩文件：

StosDebug.ipa
└── Payload
    └── StosDebug.app

所以只需要把 StosDebug.app 复制到 Payload 文件夹里，然后压缩即可：

mkdir -p Payload
cp -r build/Build/Products/Release-iphoneos/StosDebug.app ./Payload/StosDebug.app
zip -r StosDebug.ipa Payload

最后把安装包传到手机上，正常用 SideStore 安装就可以了。

使用 GitHub Actions 编译

其实就是向 GitHub 借一台 Mac 来帮忙编译，不过操作会稍微繁琐一点。鉴于会用 GitHub Actions 的朋友大概不会对编译感到犯难，这里直接贴出 ChatGPT 生成的 YAML 配置，成功后到 Actions 页签里下载构建好的 Artifact 即可：

name: Build iOS
on:
  workflow_dispatch:
  push:
    branches:
      - main
jobs:
  build:
    runs-on: macos-latest
    steps:
      - uses: actions/checkout@v4
      - name: Show Xcode version
        run: xcodebuild -version
      - name: List project
        run: |
          xcodebuild -project StosDebug.xcodeproj -list
      - name: Build
        run: |
          xcodebuild \
            -project StosDebug.xcodeproj \
            -scheme StosDebug \
            -configuration Release \
            -sdk iphoneos \
            -derivedDataPath build \
            CODE_SIGNING_ALLOWED=NO \
            CODE_SIGNING_REQUIRED=NO \
            CODE_SIGN_IDENTITY=""
      - name: Create unsigned ipa
        run: |
          mkdir Payload
          cp -R build/Build/Products/Release-iphoneos/*.app Payload/
          zip -r StosDebug.ipa Payload
      - name: Upload ipa
        uses: actions/upload-artifact@v4
        with:
          name: StosDebug.ipa
          path: StosDebug.ipa

StosDebug使用

和 StikDebug 一样，首先打开 LocalDevVPN。不连回环的话，不管怎么操作都是无效的。

第一次打开 StosDebug，软件会毫无征兆地弹出一个文件选择窗口——其实是让你导入配对文件，直接导入即可。

然后就会开始下载 DDI。下载成功后，主页就会显示出你的 App 列表，点击对应的 App 即可启用 JIT。

下载地址

会员直链下载