Repository navigation
SUSFS Studio 1.0.0 is the first stable release: an independent WebUI and native transaction layer for devices that already provide SUSFS. It does not modify the host manager and does not require FinaSU's built-in SUSFS controller.
Highlights
- Diagnostics without a host dashboard — reports implementation, kernel type, provider version, reported features, protocol audit, runtime proc extensions, and execution identity separately.
- Rules and settings in one archive — paths (regular and looping), maps, dynamic/full-clone/static kstat, redirects, hide-mount/logging/AVC tri-state settings, uname, cmdline/bootconfig, hidden LKM modules, mount prefixes, Priority UID filtering, and automatic application preference.
- Reviewed application — resolves the archive into a provider-qualified plan, shows it for confirmation, writes a per-item journal, applies supported operations, and checks effects independently. Unknown results require refresh and review before another attempt.
- Archive safety — atomic save, revision-bound receipts, restore with a pre-restore backup, automatic backup selection, export, and a non-blocking write lock. Unknown schemas remain inspectable and are never silently rewritten.
- Studio-owned boot stages — pre-mount, late-pre-mount, post-mount, and late-load, with pending-reboot boundaries for operations that cannot complete in the current boot.
- Interface — Material 3 Expressive colour profiles, light and dark palettes, Simplified Chinese and English, hash routing, and fully bundled offline assets.
Verified environments
- GKI-LKM SUSFS 2.3.0, Android 17 / API 37, kernel 6.6.118, host
v3.3.1-50-g64833c00: diagnostics, archive round trip, unified plans, partial and unknown recovery, effects, boot stages, cleanup. - Built-In GKI SUSFS 2.4.0, host
v1.6.5: runtime detection, rules and settings, two restart lifecycles, pending-reboot boundaries, effects, restore, cleanup. - Archive save, restore, and export through host
v1.6.4(33211).
Other combinations are not implied. Exact evidence and gaps are in the host integration matrix.
Requirements
- Android arm64.
- SUSFS already present in the kernel or provided by a loaded module. Studio does not install SUSFS.
- A compatible root manager that can open a module WebUI and exposes the required command and file interfaces. Without the file interface, device save remains disabled and the reason is shown.
Back up existing configuration and confirm the module can be disabled before testing device operations. Restoring a Studio archive does not restore kernel runtime state.
Verification
Release assets are signed with Sigstore keyless signing. Download the module ZIP and its .bundle, then run:
cosign verify-blob \
--bundle susfs-studio-1.0.0-arm64.zip.bundle \
--certificate-identity https://github.com/LyraVoid/SUSFS-Studio/.github/workflows/release.yml@refs/heads/main \
--certificate-oidc-issuer https://token.actions.githubusercontent.com \
susfs-studio-1.0.0-arm64.zipSHA256SUMS and SHA256SUMS.bundle are provided for the same check. A signature proves which workflow built the asset; it does not prove compatibility with a particular device.
Known limitations
- Built-In SUSFS 2.3, LKM SUSFS 2.4, NON-GKI kernels, other architectures, and untested host versions remain unverified.
- Enabled AVC spoof-event effects and some Map effect evidence are narrower than the other tested rules.
- Host bridges remain general-purpose privileged interfaces. Studio restricts its own calls but cannot guarantee host-level navigation or origin isolation.
- Process interruption is covered by tests; hardware power-loss durability is not.
- Studio is licensed under AGPL-3.0-only. See
LICENSE,THIRD_PARTY_NOTICES.md, and theLICENSES/directory in the module ZIP.
简体中文
SUSFS Studio 1.0.0 是首个正式版本,为已提供 SUSFS 的设备提供独立 WebUI 和原生事务层,不修改宿主管理器,也不依赖 FinaSU 内置的 SUSFS 控制器。
- 独立诊断:分别呈现实现方式、内核类型、Provider 版本、接口能力、协议审计、运行时 proc 扩展和执行身份。
- 统一归档:路径(含循环)、Map、动态/全克隆/静态 kstat、重定向、隐藏挂载/日志/AVC 三态设置、uname、cmdline/bootconfig、LKM 模块隐藏、挂载前缀、Priority UID 和自动应用偏好。
- 审阅后应用:把归档解析为结合 Provider 能力的操作计划,逐项确认、写入预写日志、执行并独立验证效果;结果未知时先刷新核对。
- 归档安全:原子保存、修订回执、恢复前自动备份、备份选择、导出和非阻塞写锁;未知 schema 只读保留,不会静默改写。
- 启动阶段:pre-mount、late-pre-mount、post-mount、late-load,当前启动无法完成的操作明确标记待重启。
- 界面:Material 3 Expressive 配色、浅深色、简体中文与英文、哈希路由、完全离线资源。
已实测组合为 GKI-LKM SUSFS 2.3.0(Android 17、内核 6.6.118、宿主 v3.3.1-50-g64833c00)和 GKI 内建 SUSFS 2.4.0(宿主 v1.6.5);归档往返另在宿主 v1.6.4 验证。其他组合仍需自行验证。
发布资产使用 Sigstore 无密钥签名,校验命令见上方。签名只证明构建来源,不代表特定设备兼容。