MoXMoX
Docs · 三分钟上手

文档与快速上手

三个产品,三条最快路径。命令都可以一键复制;更完整的说明在各仓库的 README 与文档里。

moxsh · 安卓液态玻璃终端 Android 9+(minSdk 28)

第 1 步 · 安装 App。下载页提供每个版本的正式签名 APK 与多个国内加速镜像,任选其一:

前往下载页 →

第 2 步 · (可选)安装自研 PRoot 引擎。App 内已内置;这条命令是给原版 Termux 用户用的——把同一个引擎装成 Termux 里的 moxsh-proot 命令:

$curl -fsSL https://raw.githubusercontent.com/codecloud-dev/moxsh-terminal/main/scripts/install-moxsh-proot.sh | bash

装完即可进入 Ubuntu(二进制从 GitHub Release 下载并做 sha256 校验,放不下就不装,绝不静默):

$moxsh-proot -R ~/ubuntu -0 -- bash

App 内还有:Ubuntu / Debian / Kali / Alpine 一键安装(国内镜像优先)、图形包管理器、资源监控、AI 助手。详见 GitHub README。

moxwebgpu · WebGPU 计算框架 ~30KB · 零依赖

方式一 · 浏览器零构建。一个 script 标签拿到全局 MoxWebGPU——你现在看到的页面背景,就是同一个 bundle 在你的 GPU 上实时算的:

$<script src="https://mox-site.pages.dev/webgpu/moxwebgpu.browser.js"></script>
$const gpu = await MoxWebGPU.mox.init();

方式二 · 源码构建(TypeScript 源码 + vitest + tsup):

$git clone https://github.com/codecloud-dev/moxwebgpu.git && cd moxwebgpu && pnpm install && pnpm build

说明:npm 账号关联后即发布,届时 npm install moxwebgpu 直接可用(发布流程已就绪,关注仓库 Release)。WebGPU 需要安全上下文:Chrome / Edge 113+,或 localhost。想先看效果:在线演示 · 开发者接入页。

mox-id · 统一账号与云同步

登录。点本站右上角「登录」,两种入口:

个人中心。顶部导航「个人中心」里管理一切:头像、昵称、联系邮箱、商品兑换、订单与资产、登录设备、账号注销。

进入个人中心 →

云同步。在 moxsh 的「账号与云同步」卡片登录后,多设备配置与命令历史自动同步;内容在客户端加密后才上传,服务端看不到明文。

ProoT 增值服务与兑换 ¥5.99 / 30 天

ProoT 引擎分两层,别搞混:

购买与兑换。在 兑换页 用爱发电订单号或兑换码把授权赋予本设备;订阅按 30 天一个周期计费(¥5.99 / 周期)。

到期与离线。授权带到期时间,即便设备 30 天不联网,到期当天也会自动失效,续费后在 App 内执行 mox redeem status 刷新即可恢复。订阅型授权离线也按到期日判定,不依赖每次联网。

仅增值服务解锁的 4 项功能(在 ProoT 配方列表里标 🔒,持有 proot-pro 授权即解锁):

前往兑换页 →

常见问题

需要 root 吗?

不需要。moxsh 无需 root、装上即用;PRoot 发行版也是用户态隔离,不碰系统分区。

支持哪些设备?

Android 9(API 28)及以上。WebGPU 演示需要 Chrome / Edge 113+ 或任意桌面浏览器的 localhost 安全上下文。

我的数据存在哪?

云同步内容在客户端加密后才上传,服务端看不到明文;登录凭证只存本机浏览器。发现陌生设备时,可在个人中心一键踢掉。

npm 上为什么搜不到 moxwebgpu?

moxwebgpu 尚未发布到 npm(发布流水线已就绪,待绑定 npm 账号后上线)。在这之前请用上方的浏览器 bundle 或源码构建,能力完全一致;正式发布后 npm install moxwebgpu 才会可用。

遇到问题怎么办?

首选 GitHub Issues(我们都会看);也可以发 邮箱。报 bug 时附上机型、系统版本与复现步骤最有力。