zt 命令体系——让终端反向调应用侧功能

一句话理解

原版 Termux 是单向的：应用里只负责显示终端，终端里跑的命令只能操作自己的用户空间，碰不到 Android 应用层。

zt 命令把这个打通了——终端里敲 zt toast "Hello"，手机屏幕上就会弹出一个 Android Toast 通知。

为什么要做这件事

ZeroTermux 把大量功能做到了应用里（侧边栏菜单、设置面板、VNC 客户端等），这些功能在 Android 应用层，传统 Linux 命令行调用不到。zt 就是一层桥接：终端脚本可以调用这些应用侧能力。

典型场景：

脚本跑完后弹 Toast 通知你（zt toast "备份完成"）
长期脚本后台运行，出错时 zt dialog -c -t "出错了" -m "xxx" 弹确认框
X11 会话里用 zt x11keyboardhide 隐藏键盘获得更大显示区
定时任务日志跑完后 zt qr 让你扫码看详情
Shell 脚本里通过 zt openright 自动展开右侧菜单查看输出

zt 命令分类

类别	用途	示例
基础控制	帮助、版本、重启环境、打开菜单	`zt v`, `zt rb`, `zt or`
UI 弹窗	Toast、确认框、编辑框	`zt toast "msg"`, `zt dialog -c -t 标题 -m 消息`
X11 控制	开关终端、开关键盘、查状态	`zt x11xs`, `zt x11kbh`
系统交互	扫一扫、短信、通讯录、软链接	`zt qr`, `zt ln`
外观设置	背景图片	`zt backgroundimage`
VNC	VNC 连接	`zt vnc 地址_端口_用户_密码`

基础命令一览

zt help             # 查看帮助
zt version / zt v   # 查看版本
zt toast 内容       # 显示 Toast 通知
zt openleft / zt ol # 打开左侧栏
zt openright / zt or # 打开右侧栏
zt reboot / zt rb   # 重启 ZeroTermux 环境
zt qr               # 打开扫一扫

在脚本里用

zt 命令可以直接写进 shell 脚本。注意：zt 命令执行后 ZeroTermux 会响应，Android Toast 弹窗会盖住屏幕，对话框会阻塞脚本直到用户操作。

#!/data/data/com.termux/files/usr/bin/bash

# 备份脚本示例
zt toast "开始备份，请不要切后台"
backup.sh /path/to/data
if [ $? -eq 0 ]; then
    zt toast "备份完成"
else
    zt dialog -s -m "备份失败了，请检查日志"
fi