🌐 主仓库在 GitHub —
codecloud-dev/moxsh-suite是唯一主源:Issue、Pull Request、功能讨论请统一提交到 GitHub。Gitee 镜像 仅供国内高速只读访问,每 2 小时从 GitHub 定时同步(亦支持手动触发),不再随 push 触发。
moxsh —— 完全脱离 Termux、全面兼容 Termux、性能更强、整个 App 都是液态玻璃的移动 Linux 终端。
本仓库是 moxsh 家族的资产总入口:把散落在各处的真机源码、官网、设计原型、文档与规范集中收纳,五块分明,一眼看清。
⭐ 如果 moxsh 对你有用,欢迎点个 Star —— 它能让更多开发者发现这个移动 Linux 终端!
这是个刚起步的项目,bug 肯定有,而且不少。我不装完美—— 你踩到的每一个坑、每一个槽点,都是帮我把它养好的机会。
每个 issue 我都会看,能修的尽快修。一起把它从“能跑”养到“好用” 💪
💛 觉得好用?欢迎到 爱发电 请作者喝杯咖啡 —— 国内可直接微信 / 支付宝收款,是独立开发最大的鼓励。
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(查看该提交) |
site |
codecloud-dev/mox-site |
918b51f(查看该提交) |
本区块由
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 会拦下:
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始终不检出。
各仓「哪些版本是同一期发布、一起测过」见 兼容矩阵; 本仓库不产二进制,自身不设独立版本号,版本基准就是上面的 gitlink + 该矩阵。
.gitmodules 里的 URL 必须保留 GitHub 主源(Gitee 只是只读镜像,且两个子模块的
Gitee 路径与 GitHub 不同)。国内 clone 本仓库后,不要改 .gitmodules,用本机
insteadOf 重写即可让 git submodule update --init 改走 Gitee:
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/ |
开源免费 / 闭源免费 / 闭源付费(爱发电) / 订阅制 / 系统内置 五套真实示例 |
git clone https://github.com/codecloud-dev/moxsh-suite.git
cd moxsh-suite
git submodule update --init --recursive # 拉取 app / site代理拉取(中国大陆 / 受限网络):在 clone 之前设置 insteadOf,让 git 自动走 ghproxy 镜像:
git config --global url."https://ghproxy.net/https://github.com/".insteadOf "https://github.com/"官网已部署 GitHub Pages(源:mox-site 的 main 分支根目录):
- 在线体验页:https://codecloud-dev.github.io/mox-site/experience.html
- 官网首页:https://codecloud-dev.github.io/mox-site/
本地预览:直接用浏览器打开 site/index.html,或 design/moxsh-ui-mockup.html。
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 自动执行。
plugin-manifest.schema.json—— Draft 2020-12 JSON Schema,41 个顶层字段、19 个复用定义。README.md—— 规范文档(身份 / 开源闭源 / 定价与授权 / 爱发电 / 兼容 / 分发 / 入口 / 权限 / 依赖 / 能力 / 设置 / 签名)。examples/—— 开源免费 / 闭源免费 / 闭源付费(爱发电) / 订阅制(AI) / 系统内置 五套真实示例,均通过ajv校验。
moxsh/ui/—— 自研 Canvas 终端渲染、液态玻璃组件库。plugin-distro/—— 图形化容器管理四件套(Compose 屏幕)。plugin-ai/—— AI 助手(模型接入 + 技能系统 + Agent 工具)。
- App 编译 / 发布:见
app子仓库README.md(需要 Android SDK / NDK / Rust 工具链)。 - 官网改动:见
site子仓库,推main后 GitHub Pages 自动构建。 - 本仓库职责:仅收纳资产与规范。子模块版本演进后,在子仓库推进、于本仓库 bump gitlink 再提交即可。
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 一样顺滑。
