# moxsh-suite **Repository Path**: codecloud-dev/moxsh-suite ## Basic Information - **Project Name**: moxsh-suite - **Description**: moxsh 总仓库:设计原型 / 文档 / 插件规范 / app(moxsh-terminal) 与 site(mox-site) 子模块|GitHub 主仓库 github.com/codecloud-dev/moxsh-suite:Issue/PR 请到 GitHub 提交;本仓库为国内只读镜像,自动同步 - **Primary Language**: HTML - **License**: MIT - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 1 - **Forks**: 0 - **Created**: 2026-10-11 - **Last Updated**: 2026-11-19 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README > **🌐 主仓库在 GitHub** — [`codecloud-dev/moxsh-suite`](https://mox-site.pages.dev/go?r=moxsh-suite) 是唯一主源:Issue、Pull Request、功能讨论请统一提交到 GitHub。[Gitee 镜像](https://gitee.com/codecloud-dev/moxsh-suite) 仅供国内高速只读访问,每 2 小时从 GitHub 定时同步(亦支持手动触发),不再随 push 触发。

MoX

# moxsh 总仓库 · monorepo

MoX Series: 资产总入口 monorepo: 子模块 docs: 设计 / 规范 version: 1.0.1 docs: 中 / EN

CI License Stars Last commit submodules: app / site PRs welcome

中文 · English

> **moxsh** —— 完全脱离 Termux、全面兼容 Termux、性能更强、**整个 App 都是液态玻璃**的移动 Linux 终端。 本仓库是 moxsh 家族的**资产总入口**:把散落在各处的真机源码、官网、设计原型、文档与规范集中收纳,五块分明,一眼看清。

moxsh-suite 套件动图:终端/插件/核心/官网四个模块围绕中央 mox 徽标错峰浮动

⭐ 如果 moxsh 对你有用,欢迎点个 Star —— 它能让更多开发者发现这个移动 Linux 终端!

## 🐛 欢迎来“批斗”我 > 这是个刚起步的项目,**bug 肯定有,而且不少**。我不装完美—— > 你踩到的每一个坑、每一个槽点,都是帮我把它养好的机会。 - 💥 遇到崩溃 / 黑屏 / 跑不起来?→ [提个 Bug 报告](https://mox-site.pages.dev/go?r=moxsh-suite&p=issues) - 💡 有想要的功能?→ [开个需求](https://mox-site.pages.dev/go?r=moxsh-suite&p=issues) - 🗯️ 单纯想吐槽、挑刺?→ 也欢迎开 issue,标签随便打 😄 每个 issue 我都会看,能修的尽快修。一起把它从“能跑”养到“好用” 💪

💛 觉得好用?欢迎到 爱发电 请作者喝杯咖啡 —— 国内可直接微信 / 支付宝收款,是独立开发最大的鼓励。

爱发电赞助码

📑 目录 · Contents - [🗃️ 仓库拓扑](#仓库拓扑) - [🔗 子模块锁定版本](#子模块锁定版本) - [📑 目录导航](#目录导航) - [🚀 快速开始](#快速开始) - [🌐 在线体验](#在线体验) - [📊 关键资产速览](#关键资产速览) - [🔹 构建与贡献](#构建与贡献) - [📜 许可证](#许可证)
## 🗃️ 仓库拓扑 ```text moxsh-suite (本仓库 / monorepo,默认分支 master) ├── app/ → git submodule → codecloud-dev/moxsh-terminal (Android 真机源码) ├── site/ → git submodule → codecloud-dev/mox-site (官网 + 在线体验) ├── design/ (实体文件) UI 原型 HTML + 自动化回归测试 ├── docs/ (实体文件) 设计 / 学习笔记、验收报告 └── spec/ (实体文件) 插件清单 JSON 规范 (Schema + 多套示例) ``` `app`(`codecloud-dev/moxsh-terminal`)是 **public**,`site`(`codecloud-dev/mox-site`)是 **private**,两者默认分支均为 `main`(本总仓自身用 `master`)。 > **2026-11-11 修正**:此前这里写「两个子仓库均为 public」,是错的。这正是 suite 的 legacy > GitHub Pages 构建执行 `git submodule update --init --recursive` 时对 `site` 报 > `Repository not found` 的原因。私有子模块只是维护者本地指针,匿名 CI / Pages 拉不到。 ## 🔗 子模块锁定版本 | 子模块 | 仓库 | 锁定提交(真实 gitlink) | | --- | --- | --- | | `app` | `codecloud-dev/moxsh-terminal` | `6daa15f`([查看该提交](https://github.com/codecloud-dev/moxsh-terminal/tree/6daa15f7c2241922280f1c44cdd83c7bbed34cbf)) | | `site` | `codecloud-dev/mox-site` | `918b51f`([查看该提交](https://github.com/codecloud-dev/mox-site/tree/918b51f302f2c608dab0225749181774813d6509)) | > 本区块由 `scripts/sync-submodule-pins.mjs` 从 `git ls-tree HEAD` 生成,CI 由 `check-pins.yml` 校验; > 手动改这里会在下次 PR 直接失败。bump 子模块后请重跑 `node scripts/sync-submodule-pins.mjs` >(中英两份 README 会一起更新)。 > **2026-11-11 修正**:此前这里手写 `709cd64` / `bcdc62b` 两个 pin,与真实 gitlink > (`6daa15f` / `918b51f`)**对不上**——子模块 bump 后没人同步文档。现已改为从 > `git ls-tree HEAD` 自动生成,并由 `check-pins.yml` 在每次 push / PR 强校验。 子仓库各自独立演进,bump 子模块后必须同步 pin,否则 CI 会拦下: ```bash cd app && git fetch origin main && git checkout <目标提交> && cd .. git add app && git commit -m "chore: bump app 子模块" node scripts/sync-submodule-pins.mjs git add README.md README.en.md && git commit --amend --no-edit ``` > 若新提交改了 `versionName`,**必须同步更新 `compat-matrix.json` 里 > `moxsh-terminal` 的版本**:`check-compat-matrix.mjs` 会拿 pin 处的 > `app/moxsh/app/build.gradle.kts` 真值比对,不一致直接拦下 PR。 > CI 会先以 `git submodule update --init --depth 1 app` 检出 public 的 app 子模块 > 再做这项核对;private 的 `site` 始终不检出。 各仓「哪些版本是同一期发布、一起测过」见 [兼容矩阵](compat-matrix.json); 本仓库不产二进制,自身不设独立版本号,版本基准就是上面的 gitlink + 该矩阵。 ### 国内网络:子模块走 Gitee 镜像 `.gitmodules` 里的 URL 必须保留 GitHub 主源(Gitee 只是只读镜像,且两个子模块的 Gitee 路径与 GitHub 不同)。国内 clone 本仓库后,不要改 `.gitmodules`,用本机 `insteadOf` 重写即可让 `git submodule update --init` 改走 Gitee: ```bash git config --global url."https://gitee.com/codecloud-dev/".insteadOf \ "https://github.com/codecloud-dev/" git submodule update --init --recursive # 用完可撤销:git config --global --unset-all url."https://gitee.com/codecloud-dev/".insteadOf ``` > 注:`site` 子模块对应的 Gitee 镜像可能不存在(该仓曾为私有),此时 `insteadOf` > 仍会回落到失败而不是自动回源;遇到就临时 `--unset-all` 再单独初始化。 ## 📑 目录导航 | 路径 | 内容 | |---|---| | `app/moxsh/ui/` | 自研 Canvas 终端渲染层、液态玻璃组件库(`Glass.kt` / `MoxshTokens.kt` / `MoxshComponents.kt`) | | `app/moxsh/plugins/plugin-distro/` | 图形化容器管理四件套(发行版管理器 / 包管理器 / 资源监控 / 新手引导) | | `app/moxsh/plugins/plugin-ai/` | AI 助手(多模型接入 + 技能 + Agent 工具) | | `site/` | 官网静态站 + 在线体验页(`experience.html` 嵌入 `prototype.html`) | | `design/moxsh-ui-mockup.html` | 主交互原型(也是 `site/prototype.html` 的来源) | | `design/tests/test_ui.js` | Playwright 原型回归测试(33 条断言 / 0 报错,CI 自动跑) | | `docs/` | Podroid UI 学习笔记、验收报告 | | `spec/plugin-manifest.schema.json` | 插件清单 Draft 2020-12 JSON Schema(41 顶层字段) | | `spec/examples/` | 开源免费 / 闭源免费 / 闭源付费(爱发电) / 订阅制 / 系统内置 五套真实示例 | ## 🚀 快速开始 ```bash git clone https://github.com/codecloud-dev/moxsh-suite.git cd moxsh-suite git submodule update --init --recursive # 拉取 app / site ``` **代理拉取(中国大陆 / 受限网络)**:在 `clone` 之前设置 insteadOf,让 git 自动走 `ghproxy` 镜像: ```bash git config --global url."https://ghproxy.net/https://github.com/".insteadOf "https://github.com/" ``` ## 🌐 在线体验 官网已部署 GitHub Pages(源:`mox-site` 的 `main` 分支根目录): - 在线体验页: - 官网首页: 本地预览:直接用浏览器打开 `site/index.html`,或 `design/moxsh-ui-mockup.html`。 ## 📊 关键资产速览 ### 🎨 design/ — UI 原型 - `moxsh-ui-mockup.html` —— **主原型**:全应用液态玻璃;底部三键(终端 / 分类 / 设置);**会话抽屉**(Termux 式:环境色点 / 长按改名 / 退出码红删除线 / 新建);**针对小白的图形化容器管理四件套**(发行版管理器 / 图形包管理器 / 资源监控 / 新手引导);控制中心(音量+键呼出、跟手);AI 助手配置屏。 - `tests/test_ui.js` —— Playwright 回归,**33 条断言**:五主题切换、三键视图、终端命令、会话抽屉与左右滑手势、AI 面板、控制中心 / 快捷键、通透度滑块、滚动收标题,且 0 控制台报错。由 `.github/workflows/design-ui-test.yml` 固定 `playwright@1.58.1` 在 CI 自动执行。 ### 🧩 spec/ — 插件清单规范 - `plugin-manifest.schema.json` —— Draft 2020-12 JSON Schema,41 个顶层字段、19 个复用定义。 - `README.md` —— 规范文档(身份 / 开源闭源 / 定价与授权 / 爱发电 / 兼容 / 分发 / 入口 / 权限 / 依赖 / 能力 / 设置 / 签名)。 - `examples/` —— 开源免费 / 闭源免费 / 闭源付费(爱发电) / 订阅制(AI) / 系统内置 五套真实示例,均通过 `ajv` 校验。 ### 🗃️ app/ — 真机源码(子仓库) - `moxsh/ui/` —— 自研 Canvas 终端渲染、液态玻璃组件库。 - `plugin-distro/` —— 图形化容器管理四件套(Compose 屏幕)。 - `plugin-ai/` —— AI 助手(模型接入 + 技能系统 + Agent 工具)。 ## 🔹 构建与贡献 - **App 编译 / 发布**:见 `app` 子仓库 `README.md`(需要 Android SDK / NDK / Rust 工具链)。 - **官网改动**:见 `site` 子仓库,推 `main` 后 GitHub Pages 自动构建。 - **本仓库职责**:仅收纳资产与规范。子模块版本演进后,在子仓库推进、于本仓库 bump gitlink 再提交即可。 ### 本地校验(与 CI 同命令) ```bash node scripts/check-submodule-pins.mjs # README pin == 真实 gitlink node scripts/check-compat-matrix.mjs # 结构 + pin 处真实版本核对(app 需在 pin) python3 .github/scripts/check_secrets.py --self-test # 规则/占位符/扫描目录自测 python3 .github/scripts/check_secrets.py # 全仓密钥扫描(含 .github/) node design/tests/test_ui.js # 需 playwright@1.58.1 + chromium ``` 前三条走 `check-pins.yml` / `secret-scan.yml`,UI 断言走 `design-ui-test.yml`; `pages.yml` 只发布 `pages/`,不碰私有子模块。本仓无顶层 `package.json`,playwright 由 UI workflow 临时安装,不进依赖树。 ## 📜 许可证 各子仓库自带 `LICENSE`;本仓库收纳的资产沿用对应子仓库协议。 --- moxsh · 让手机上的 Linux 像 iOS 一样顺滑。