Skip to content

About

moxsh 总仓库 · moxsh monorepo — 设计原型、文档、插件规范,以及 app / site 子模块。

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

🌐 主仓库在 GitHub — codecloud-dev/moxsh-suite 是唯一主源:Issue、Pull Request、功能讨论请统一提交到 GitHub。Gitee 镜像 仅供国内高速只读访问,每 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 报告
  • 💡 有想要的功能?→ 开个需求
  • 🗯️ 单纯想吐槽、挑刺?→ 也欢迎开 issue,标签随便打 😄

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

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

爱发电赞助码

📑 目录 · Contents

🗃️ 仓库拓扑

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 + 该矩阵。

国内网络:子模块走 Gitee 镜像

.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 分支根目录):

本地预览:直接用浏览器打开 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 同命令)

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 一样顺滑。

About

moxsh 总仓库 · moxsh monorepo — 设计原型、文档、插件规范,以及 app / site 子模块。

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages