跑在 Android 上的液态玻璃终端 —— 装上就有完整 Linux 命令行，无需 root、无需配置，全面兼容 Termux 生态。
装上就有完整的 Linux 命令行；整个应用从内核到界面都为「快」与「美」重新造过一遍——Rust 内核 + 一整套美得像水的液态玻璃界面。
moxsh 只是 MoX 工具系列的第一块拼图。一套审美，把桌面级工具搬进掌心。
| 产品 | 状态 | 一句话定位 |
|---|---|---|
| moxsh | 已上线 | Android 液态玻璃终端，兼容 Termux 生态 |
| mox-site | 已上线 | 本系列官方门户（官网） |
| moxbox | 规划中 · 待定 | 文件管理与系统套件，同款玻璃界面；可能做，也可能不做 |
| moxcode | 规划中 · 待定 | 移动端轻量 IDE：终端 + 编辑器 + 预览一体；可能做，也可能不做 |
| 维度 | 说明 |
|---|---|
| Rust 内核 | PTY/会话、VT 解析、回滚、渲染调度、包管理验签、IPC 鉴权全部用 Rust，内存安全 |
| 液态玻璃 UI | 实时模糊、半透明层级、可拖拽悬浮窗；高版本实时渲染，低版本自动回退 |
| Termux 兼容 | 直接吃 termux-packages 官方仓库，*.deb 能装能跑，命令用法一致 |
| PRoot 发行版 | Ubuntu / Debian / Kali / Alpine 一键安装，隔离环境随便玩 |
| AI 助手 | 解释报错、写脚本、管环境，支持 DeepSeek / 智谱 / 通义 / Kimi 等 |
| 插件体系 | 悬浮玻璃终端、主题、系统监控，.mox 一键装，也兼容 Termux 插件 |
| 加固 IPC | 挑战-响应 + HMAC-SHA256 鉴权，跨进程调用不裸奔 |
| 命令云同步 | 登录后把 shell 配置、别名、历史同步到云端，换机不丢环境 |
moxsh 不是虚拟机，也不是模拟器。
终端部分由 Rust 内核直接驱动：应用启动命令行程序（execve），把标准输入输出接到屏幕上，和桌面 Linux 终端一致。由于 Android 不允许应用往 /bin、/usr 写文件，moxsh 把软件装在自己的私有目录（称为 prefix，对应 $PREFIX），路径处理对齐 Termux 约定——这就是 Termux 软件包能直接运行的原因。
软件包来自 Termux 官方仓库（apt/pkg 双协议兼容），全部用 Android NDK 交叉编译、原生运行、无仿真开销。想在隔离环境玩整个发行版，用内置 PRoot 引擎一键安装。
界面采用液态玻璃设计：实时模糊、半透明层级、可拖拽悬浮窗。高版本安卓用实时渲染模糊，低版本自动回退静态效果，无需手动设置。
第一次启动会自动下载并安装基础系统（引导包），完成后直接进入终端。
更新软件源与包：
pkg update && pkg upgrade安装软件（和 Termux 用法完全一致）：
pkg install python nodejs openssh常用操作：
termux-setup-storage # 允许访问手机存储（照片、下载等）
ssh user@host # 连接远程服务器
echo $PREFIX # 查看当前 prefix 路径首次装包前先
pkg update一次，可避免找不到包的问题。
- Android 9.0 或更高
- arm64-v8a 设备
- 约 300 MB 可用空间（含首装引导包）
正式签名包在 Releases 页面；CI 每次成功构建也会产出最新 APK。安装时如系统提示「未知来源」，允许即可。
moxsh 支持用 GitHub 账号一键登录（同步 shell 配置/历史、解锁插件商店）。登录走 设备流（Device Flow）：app 只需一个公开安全的 client_id，不含任何 client_secret / private key，无后端依赖。
为什么不是网页回调流：OAuth App 的网页流即使带 PKCE 也强制要求
client_secret，而密钥绝不能进 APK。设备流是 GitHub 给原生/CLI 应用的无密钥标准方案（gh CLI 同款）。
-
打开 GitHub → Settings → Developer settings
- 选 OAuth Apps → New OAuth App，或
- 选 GitHub Apps → New GitHub App
-
应用名随意（如
moxsh-login），Homepage / Callback URL 随便填（设备流不回跳）。 -
建好后复制页面上的 Client ID。
-
在仓库根目录把
local.properties.sample复制为local.properties，把 Client ID 粘进去：github_client_id=你的_client_id -
重新构建（
local.properties已被.gitignore忽略，不会进公开仓库）。
之后在 App 内「设置 → 账号 → 登录」会显示一个授权码，点按钮在浏览器输入并授权即可。
moxsh 的插件、AI 技能、主题、发行版镜像统一使用 .mox 包格式，通过内置商店安装，也支持把 .mox 文件放到下载目录离线安装。
为 moxsh 编写和发布插件的方法见 docs/plugins.md。同时 moxsh 兼容 Termux 插件宿主（Termux:API、Termux:Widget 等原插件可用）；外来 zip 格式会在导入时自动转换。
- 软件包层面：直接兼容。Termux 官方源
.deb能装能跑，命令用法一致。 - 代码层面：AI 辅助生成、clean-room 重写。终端内核、包管理器、运行环境、PRoot 引擎全部重新编写（Rust/Kotlin）；开发过程研读 Termux 公开文档/源码以对齐行为与生态契约，但未复制其代码，也不依赖修改 Termux 源码。
- 插件层面：双体系。Termux 兼容宿主让原插件继续可用；moxsh 原生插件（
.mox）独立签名、带玻璃图形界面。
发现 bug 或想要新功能，欢迎提 Issue；想贡献代码直接提 Pull Request。
如果这个项目对你有用，求一个 Star、点个关注、顺手转发——这对一个独立小项目来说，是天大的鼓励，也能让更多人用上更好的终端。
- 在 GitHub 上点 ⭐ Star：点开仓库右上角的 Star
- 关注仓库 / 加入 Discussions，第一时间收到更新
- 转发给你的朋友、群里、或任何可能被终端折磨过的开发者
也欢迎任何形式的共建：报 bug、提建议、交代码、写文档、做翻译。独立开发者 + AI 协作，但每一个方向都由人拍板。
本项目（含全部代码、文档与官网页面）由开发者 Codecloud 主导设计，AI 辅助生成代码：架构决策、需求定义与验收由人完成，代码实现与文档撰写由 AI 协作完成并经人工审核修订。