WQFiles README

项目的 README,来自 github.com/kolbicz/WQFiles。合并为一个 markdown 文件:README.md。

Worse Query Files

WQ Files is a file browser, app data manager and cache cleaner for iOS 26 and 27. "WQ" stands for worse_query, the sandbox technique it is built on. It reaches other apps' and system containers with no jailbreak and no kernel exploit. Tested on iOS 26.5 to 27.3 beta 1; see Tested devices.

[!WARNING] Apple patched worse_query in iOS 27.3 beta 2 (build 24C5049d). WQ Files can't open other apps' folders there or on any later build, and its startup check says so. It works up to iOS 27.3 beta 1 (24C5037i) and on iOS 26.0 to 26.7.2. Don't update to the 27.3 beta 2 or later if you want to keep using it.

WQ Files home screen on iPad

iOS 26 (26.0 to 26.7.2): supported since 0.7; tested on 26.7.1. worse_query reaches the app, extension, daemon and app group containers there, but not System Data or the system groups, so WQ Files hides those two and the Cache Cleaner has no crash-log section. A full inode scan would take most of an hour on iOS 26, so App Data, Extension Data and App Groups are listed from the LaunchServices database instead (found once and remembered). Internal Daemons aren't in that database: the first scan for them takes long, later ones only check new files. Apps, backups, restores, clearing app data, the Cache Cleaner and the file browser work as on iOS 27. App icons don't: iOS 26 hands WQ Files only placeholder icons and doesn't let it read other apps' bundles, so apps show symbol tiles.

WQ Files is available in English, German, Italian, Spanish, Portuguese (Brazil), Russian, Polish, Turkish, Thai, Vietnamese, Korean, Arabic and Simplified Chinese. It follows the device language; Language in WQ Files' Settings picks another, used from the next start.

Tested devices

Tested by the maintainer on:

Device iOS
iPhone 16 Pro Max (iPhone17,2) 27.2.1
iPhone 17 Pro Max (iPhone18,2) 27.0.1
iPad Air 5 iPadOS 27.0.1
iPhone 14 Pro (iPhone15,2) 26.7.1

Users have also reported it working on iOS 26.5, 27.2 and 27.3 beta 1. It does not work on 27.3 beta 2 or later (see above). Works on a device or iOS version not listed here? Open an issue with the Log (Settings → Log → Share).

Not supported: iOS 18 and older. worse_query doesn't exist there; WQ Files shows a notice instead of scanning. On iOS 17 and 18 use Cyanide.

What it opens

The container parents can't be listed, so App Data, Extension Data and App Groups come from the LaunchServices database, which lists every installed app's and extension's containers. It is found once (among the newest files, usually within seconds) and remembered. Internal Daemons, and the app folders when the database can't be read, need a scan of every file id (fsgetpath, the way KAMUI does it): minutes on a well-used device the first time, so WQ Files asks before it starts and shows a scan window; later scans only check new files.

Tools

App names come from LaunchServices' own database, read from lsd's container (the LaunchServices API itself refuses this app on 27.x). Apple services that only have localized names use a built-in table. Services without an icon get a symbol tile.

Themes

Settings → Theme sets the colors of the new design: Default, Custom Color (pick one color, WQ Files derives the rest) or a theme you import. Plain Background works with all of them, and Colored Cards (on by default) tints the start screen's cards in the color of their icon. A theme also colors the Wi-Fi Sharing page.

A theme is a small JSON file with the extension .wqtheme. Open one with WQ Files (share sheet or Files app) or use Import Theme…; Export Current Colors… writes the colors you use now as a starting point. WQ Files comes with the two themes in themes/ (Midnight and Sunset) built in; an imported theme with the same name replaces the built-in one.

{
  "name": "Midnight",
  "author": "you",
  "dark": {
    "background": ["#05070F", "#0B1226"],
    "glows": ["#2F6BFF9E", "#00C2FF66", "#7A5CFF55", "#00E0B03A"],
    "accent": "#5AA9FF",
    "card": "#1A2A5C33",
    "plain": "#05070F"
  },
  "light": {
    "background": ["#EEF3FF", "#DCE6FF"],
    "glows": ["#7FA8FF80", "#7FE0FF60"],
    "accent": "#2F6BFF"
  }
}
Key Meaning
name 1–40 characters, required. A theme with the same name replaces the installed one.
author Optional.
dark, light Colors for each appearance. At least one is required; a missing one uses the other.
background One color, or two for a top-to-bottom gradient. Required.
glows Up to four soft color spots on the background, usually semi-transparent.
accent Buttons, tabs and links.
card A tint laid over the cards' blur.
plain The solid color used with Plain Background (default: the first background color).
tiles Top level, next to name: colors of the icon tiles (and Colored Cards) by name: blue, sky, violet, indigo, mint, amber, orange, pink, gray, or all for every tile not named. One color or two (gradient), e.g. "tiles": {"sky": ["#8AD9FF", "#2C94E8"], "all": "#5B3FE0"}.

Colors are #RRGGBB or #RRGGBBAA. Unknown keys are ignored, files over 64 KB are refused, and WQ Files names the problem when a file isn't valid. Themes change colors only, not the layout.

Safety

Before a regular file is overwritten or deleted, its contents are copied to Backups inside the app (also reachable in the Files app). Long-press a backup to restore it to its original location. Recently Deleted (in the Backups tab, or under Tools in the classic design) lists the backed-up files whose original is gone, newest first: restore one to where it was (missing folders are created), or delete it from Backups for good. Deleting a folder deletes everything in it after saying how many files that is; every file is copied to Backups first (one backup for the whole folder), so it can be restored from Recently Deleted. App and system containers themselves (and the folders above them) can't be deleted. Symbolic links are removed as links. Clearing an app's data and cleaning caches delete without a file-by-file backup; Apps offers to back up Documents and Library first, while tmp is discarded and cannot be restored. Close the target app before backup, restore, or clear. App copies are verified by a source-stability digest, a destination-shape digest and stored part content hashes (rechecked before restore and rollback), and purge postconditions are rechecked, but the operations are not filesystem snapshots if the target app keeps running. Target data is changed only in response to explicit actions; interrupted safety transactions may be recovered on startup.

File saves retain the original inode and verify descriptor identity and saved contents. Locks are advisory: another app that ignores them can still write concurrently, and in-place writes are not crash-atomic. Close the target app and keep the durable backups. Recovery fails closed when required safety material is missing. Generic overwrite/delete operations on backup-storage files are refused to avoid recursively backing up backups; valid backups can still be restored. App backups live in App Backups (also in the Files app); old ones are never pruned automatically. Tap Select in Backups or App Backups to choose one or more complete backup folders and delete them together; a single folder can still be removed with Delete Backup. Automatic pruning is intentionally left out so a safety copy is never discarded without a user decision.

Editing another app's or the system's files can break things. Keep the backups and only change what you understand.

Troubleshooting

Install with AltStore or SideStore

 

Tap Add AltSource on your iPhone to add the source in AltStore, SideStore, LiveContainer and others (via AltDirect), or add it by hand:

https://raw.githubusercontent.com/kolbicz/WQFiles/main/source.json

Or download WQFiles.ipa from Releases and sign it yourself.

Signing: the App Group

WQ Files needs an App Group to work: worse_query asks for access through your app's group container. Whatever signs the IPA must give it one. The app uses whichever group it receives, so the group name doesn't matter. The top of Log shows the group it got, or "No App Group" when it got none.

Build and signing

./build.sh compiles an arm64 binary and ad-hoc signs it with an App Group entitlement (group.cz.kolbi.wqfiles). The technique needs an App Group, so re-sign with a tool that keeps one; the app uses whichever group it actually receives and shows it at the top of the Log. If it reports "No App Group", the signer dropped it.

The deployment minimum is iOS 26.0. Builds first run the host regression suite, then stage and validate the archive, metadata, signature and App Group before replacing WQFiles.ipa in the project directory. Set WQ_SKIP_PREFLIGHT=1 for fixture builds that do not have a test tree. For a separate output, set WQFILES_FINAL_IPA to an absolute path in an existing directory. The source updater validates the IPA's embedded metadata before atomically replacing source.json; its version/build arguments must match the artifact, and an existing release description is preserved when no new notes are supplied.

Regression tests

Run ./tests/run_all_tests.sh on macOS with Xcode and Python 3. It runs portable Foundation fixture executables, the Python release fixtures, static browser checks, and strict iOS arm64 compilation/linkage. Logs and generated files stay under .work/tests/; the existing IPA is not replaced. With only Command Line Tools installed, set WQ_SKIP_IOS_CHECK=1 to run the host tests. Set WQ_ASAN=1 to compile the host fixtures with AddressSanitizer.

For UIKit navigation and recovery checks on a disposable, booted simulator, run WQ_SIMULATOR_UDID=<device-id> ./tests/run_scan_ui_tests.sh. It runs the real Apps/Clean controllers with fixture task results, switches tabs, rebuilds a screen, backgrounds the app via Settings, terminates/relaunches it, and checks that foreground I/O can run between measurement steps. It does not open Simulator.app or exercise the sandbox technique. A screenshot and build artifacts are retained under .work/tests/.

The host recovery fixtures also terminate a scan process without a shutdown callback and verify recovery in a new process, including out-of-order inode chunks, changed root identity, failed writes, and rapid pause/resume races.

These tests use disposable files and entitlement/access doubles. They do not issue sandbox tokens or mutate installed app containers. Real iOS signing, token issuance, navigation/lifecycle timing, power-loss behavior and app-side concurrent writes still require supported-device validation.

Translations

WQ Files is in English, German, Italian, Spanish, Portuguese (Brazil), Russian, Polish, Turkish, Thai, Vietnamese, Korean, Arabic and Simplified Chinese. New languages and corrections are welcome as pull requests:

German, Italian, Spanish, Portuguese, Polish, Turkish and Thai, and the newest Chinese, Arabic and Korean strings, are machine translations so far: corrections from native speakers are especially welcome.

Credit and license

WQ Files is GPL-3.0-or-later (see LICENSE).

WQFiles (kolbicz/WQFiles)

正在搜索数据库…

1.1K ·GitHub
这是什么?一款适用于 iOS 26 和 27 的文件浏览器、应用数据管理器和缓存清理工具。它可以访问 iOS 通常禁止访问的其他应用和系统文件夹。
不越狱的话,它怎么进入其他应用的文件夹?它基于 worsequery 沙盒技术构建,无需越狱,也无需内核漏洞,即可访问应用、扩展、守护进程和 App Group 容器。
我需要什么签名设置?IPA 需要 App Group。使用 Apple ID 的 AltStore、SideStore 或 Sideloadly 会自动创建它,但通配符证书描述文件无法包含它,签名会失败。
和 iOS 27 相比,iOS 26 上缺少什么?系统数据和系统分组被隐藏,缓存清理工具没有崩溃日志部分,应用显示的是符号图块而不是真实图标。
它支持哪些 iOS 版本?最低支持 iOS 26.0。iOS 26 为初步支持,应用已在 26.7.1、27.0.1 和 27.2 上测试。
它内置了哪些工具?plist 编辑器、十六进制查看与编辑器、只读 SQLite 查看器、ZIP 压缩与解压、媒体播放器,以及文本和图片查看器。
如何把文件从一个应用的数据移动到另一个应用?选中项目,打开任意应用数据中的目标文件夹,然后点击 Move Here。移动可跨应用进行,已有的项目绝不会被替换。
SQLite 查看器能修改应用的数据库吗?不能。它读取的是数据库及其 -wal 文件的副本,因此应用自身的文件永远不会被改动。若要获得最新副本,请先关闭该应用。
缓存清理工具显示和执行什么操作?它按应用列出缓存和临时文件的大小,支持搜索、大缓存(50 MB+)筛选以及崩溃日志。长按某个应用即可跳转到其 Caches、tmp 或 data 文件夹。
作者
kolbicz
大小
6.9 MB
星标
1.1K
时长
9天
提交 · 90 天