# moxsh-terminal

**Repository Path**: thousand-code-crafts/moxsh-terminal

## Basic Information

- **Project Name**: moxsh-terminal
- **Description**: 液态玻璃 Android 终端，全面兼容 Termux 生态（Rust 内核 / PRoot / 插件商店 / AI 助手）｜GitHub 主仓库 github.com/codecloud-dev/moxsh-terminal：Issue/PR 请到 GitHub 提交；本仓库为国内只读镜像，自动同步
- **Primary Language**: Kotlin
- **License**: GPL-3.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-10-11
- **Last Updated**: 2026-10-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

> **🌐 主仓库在 GitHub** — [`codecloud-dev/moxsh-terminal`](https://mox-site.pages.dev/go?r=moxsh-terminal) 是唯一主源：Issue、Pull Request、功能讨论请统一提交到 GitHub。[Gitee 镜像](https://gitee.com/thousand-code-crafts/moxsh-terminal) 仅供国内高速只读访问，每小时从 GitHub 自动同步。

<p align="center">
  <img src="assets/logo.svg" width="128" alt="moxsh 液态玻璃标志">
</p>

<h1 align="center">moxsh</h1>

<p align="center">
  <img src="https://img.shields.io/github/actions/workflow/status/codecloud-dev/moxsh-terminal/build.yml?branch=main&label=CI%20Build&color=8a7bff" alt="CI Build">
  <img src="https://img.shields.io/github/v/release/codecloud-dev/moxsh-terminal?label=Latest&color=37d5d3" alt="Latest">
  <img src="https://img.shields.io/github/stars/codecloud-dev/moxsh-terminal?style=social" alt="GitHub Stars">
  <img src="https://img.shields.io/github/discussions/codecloud-dev/moxsh-terminal?label=Discussions&color=ff7ac3" alt="社区讨论">
  <img src="https://img.shields.io/badge/version-1.0.0-8a7bff" alt="version">
  <img src="https://img.shields.io/badge/license-GPL--3.0-37d5d3" alt="license">
  <img src="https://img.shields.io/badge/Android-9%2B-3DDC84?logo=android&logoColor=white" alt="Android 9+">
  <img src="https://img.shields.io/badge/Core-Rust-000?logo=rust&logoColor=white" alt="Rust 内核">
  <img src="https://img.shields.io/badge/UI-Liquid%20Glass-8a7bff" alt="液态玻璃">
  <img src="https://img.shields.io/badge/Kotlin-UI-7F52FF?logo=kotlin&logoColor=white" alt="Kotlin">
</p>


> 装上就有完整的 Linux 命令行；整个应用从内核到界面都为「快」与「美」重新造过一遍——Rust 内核 + 一整套美得像水的液态玻璃界面。

<p align="center"><a href="README.md">中文</a> · <a href="README.en.md">English</a></p>

<p align="center"><img src="assets/demo.svg" width="760" alt="moxsh-terminal 手机终端动图：命令行安装 moxsh，进度条循环增长、光标闪烁"></p>

<p align="center"><b>⭐ 如果 moxsh 对你有用,欢迎点个 <a href="https://mox-site.pages.dev/go?r=moxsh-terminal">Star</a> —— 它能让更多人在手机上用上顺滑的 Linux 终端!</b></p>



## 🐛 欢迎来“批斗”我

> 这是个刚起步的项目，**bug 肯定有，而且不少**。我不装完美——
> 你踩到的每一个坑、每一个槽点，都是帮我把它养好的机会。

- 💥 遇到崩溃 / 黑屏 / 跑不起来？→ [提个 Bug 报告](https://mox-site.pages.dev/go?r=moxsh-terminal&p=issues)
- 💡 有想要的功能？→ [开个需求](https://mox-site.pages.dev/go?r=moxsh-terminal&p=issues)
- 🗯️ 单纯想吐槽、挑刺？→ 也欢迎开 issue，标签随便打 😄

每个 issue 我都会看，能修的尽快修。一起把它从“能跑”养到“好用” 💪

<p align="center">💛 觉得好用？欢迎到 <a href="https://afdian.com/a/cloudharbor">爱发电</a> 请作者喝杯咖啡 —— 国内可直接微信 / 支付宝收款，是独立开发最大的鼓励。</p>

<p align="center"><img src="assets/afdian-qr.jpg" width="200" alt="爱发电赞助码"></p>

<details>

<summary>目录</summary>

- [MoX 系列](#mox-系列)
- [核心特性](#核心特性)
- [它是怎么工作的](#它是怎么工作的)
- [快速上手](#快速上手)
- [插件体系](#插件体系)
- [和 Termux 的关系](#和-termux-的关系)
- [文档](#文档)
- [参与进来](#参与进来)
- [支持我们](#支持我们)
- [许可证](#许可证)

</details>

---

## 🌟 MoX 系列

moxsh 只是 **MoX 工具系列**的第一块拼图。一套审美，把桌面级工具搬进掌心。

|      产品      |   状态   | 一句话定位                                                            |
| :----------: | :----: | ---------------------------------------------------------------- |
|   **moxsh**  |  已上线 | Android 液态玻璃终端，兼容 Termux 生态                                      |
| **mox-site** |  已上线 | 本系列官方门户（[官网](https://codecloud-dev.github.io/mox-site/)）              |
|  **moxbox**  | 规划中 · 待定 | 文件管理与系统套件，同款玻璃界面；**可能做，也可能不做**                            |
|  **moxcode** | 规划中 · 待定 | 移动端轻量 IDE：终端 + 编辑器 + 预览一体；**可能做，也可能不做**                      |

---

## 🌟 大版本进度（MoX 全家桶 1.0.0）

moxsh 是 MoX 工具系列的第一块拼图。本仓库随全家桶一起升到 **1.0.0** 大版本里程碑：

| 仓库                | 角色                | 1.0.0 状态        |
| :---------------- | :---------------- | :------------- |
| **agent-core**    | TS 通用内核 / SDK    | ✅ 已发布          |
| **moxsh-plugins** | 插件清单（JSON）      | ✅ 已发布          |
| **moxwebgpu**     | WebGPU / 渲染       | ✅ 已发布          |
| **mox-site**      | 官方门户（静态站）     | ✅ 已发布          |
| **moxsh-terminal**| Android 终端（本仓库） | 🔄 本次发布        |
| **moxsh-suite**   | 全家桶 monorepo      | ⏳ 子模块收尾        |

> moxbox / moxcode 仍属「规划中 · 待定」，本次大版本不做，留作后续空间。
>
> 本次 1.0.0 重点是**门面统一与里程碑**：应用图标换上与门户一致的 moxsh「M」品牌字形、版本号升 1.0.0；性能打磨（120Hz 渲染 / glyph atlas / NEON 向量化）、AI 端侧（llama.cpp）、.mox 生态等方向在 [docs/roadmap.md](docs/roadmap.md) 中显式记为「规划中 / 待定」，作为下一迭代空间，不在本次一次性做绝。

---

## ⚙️ 核心特性

| 维度               | 说明                                             |
| :--------------- | ---------------------------------------------- |
| **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 引擎**一键安装。

界面采用**液态玻璃**设计：实时模糊、半透明层级、可拖拽悬浮窗。高版本安卓用实时渲染模糊，低版本自动回退静态效果，无需手动设置。

---

## 🚀 快速上手

第一次启动会自动下载并安装基础系统（引导包），完成后直接进入终端。

更新软件源与包：

```bash
pkg update && pkg upgrade
```

安装软件（和 Termux 用法完全一致）：

```bash
pkg install python nodejs openssh
```

常用操作：

```bash
termux-setup-storage          # 允许访问手机存储（照片、下载等）
ssh user@host                 # 连接远程服务器
echo $PREFIX                  # 查看当前 prefix 路径
```

> 首次装包前先 `pkg update` 一次，可避免找不到包的问题。

### 🔹 系统要求

- Android 9.0 或更高
- arm64-v8a 设备
- 约 300 MB 可用空间（含首装引导包）

### 🔹 获取 APK

正式签名包在 [Releases](../../releases) 页面；CI 每次成功构建也会产出最新 APK。安装时如系统提示「未知来源」，允许即可。

---

## 🧩 插件体系

moxsh 的插件、AI 技能、主题、发行版镜像统一使用 **`.mox`** 包格式，通过内置商店安装，也支持把 `.mox` 文件放到下载目录离线安装。

为 moxsh 编写和发布插件的方法见 [docs/plugins.md](docs/plugins.md)。同时 moxsh 兼容 Termux 插件宿主（Termux:API、Termux:Widget 等原插件可用）；外来 zip 格式会在导入时自动转换。

---

## 🔗 和 Termux 的关系

- **软件包层面**：直接兼容。Termux 官方源 `.deb` 能装能跑，命令用法一致。
- **代码层面**：AI 辅助生成、clean-room 重写。终端内核、包管理器、运行环境、PRoot 引擎全部重新编写（Rust/Kotlin）；开发过程研读 Termux 公开文档/源码以对齐行为与生态契约，但**未复制其代码**，也不依赖修改 Termux 源码。
- **插件层面**：双体系。Termux 兼容宿主让原插件继续可用；moxsh 原生插件（`.mox`）独立签名、带玻璃图形界面。

---

## 📖 文档

- [架构白皮书](docs/architecture.md) —— 设计与实现原理
- [插件开发指南](docs/plugins.md) —— 编写、打包、签名、上架
- [命令体系](docs/commands.md) —— 支持的命令清单
- [产品路线图](docs/roadmap.md) —— 对外分享的方向，规划类均「待定」

---

## 🤝 参与进来

发现 bug 或想要新功能，欢迎提 [Issue](../../issues)；想贡献代码直接提 Pull Request。

---

## 💖 支持我们

如果这个项目对你有用，**求一个 Star、点个关注、顺手转发**——这对一个独立小项目来说，是天大的鼓励，也能让更多人用上更好的终端。

- 在 GitHub 上点 ⭐ Star：点开仓库右上角的 Star
- 关注仓库 / 加入 [Discussions](../../discussions)，第一时间收到更新
- 转发给你的朋友、群里、或任何可能被终端折磨过的开发者

也欢迎任何形式的共建：报 bug、提建议、交代码、写文档、做翻译。独立开发者 + AI 协作，但每一个方向都由人拍板。

---

## 📜 许可证

[GPL-3.0](LICENSE)

## 🤖 AI 辅助声明

本项目（含全部代码、文档与官网页面）由开发者 **codecloud-dev** 主导设计，**AI 辅助生成代码**：架构决策、需求定义与验收由人完成，代码实现与文档撰写由 AI 协作完成并经人工审核修订。