StosDebug 安装和使用教程

经常折腾 LiveContainer 或者 MeloNX 的小伙伴可能会看到一个熟悉又陌生的工具，名字叫做 StosDebug，看上去就是个 JIT 启动工具，但又不是 StikDebug，可能非常想试试，但打开官方仓库后又什么也没有，非常的心痒难耐，不知道这到底是个什么样的工具。本文就来介绍一下 StosDebug 的安装和使用，和 StikDebug 相比哪里更好。

StosDebug 的特点

相比于 StikDebug，StosDebug 去掉了很多乱七八糟的功能，比如虚拟定位、进程管理啥的，只有一个功能，那就是开 JIT，因此界面十分简洁。从这个角度说名字里带个“Debug”并不准确，但是管它呢。

和 StikDebug 不同，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

目前 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。