🌐 主仓库在 GitHub —
codecloud-dev/moxsh-plugins是唯一主源:Issue、Pull Request、功能讨论请统一提交到 GitHub。Gitee 镜像 仅供国内高速只读访问,每小时从 GitHub 自动同步。
仓库版本:1.0.2 · 官方与社区插件的索引与清单仓库。moxsh App 的插件商店从这里读取目录,按 id 下载
.mox包安装。
moxsh · 让手机上的 Linux 像 iOS 一样顺滑。
⭐ 如果这个插件商店对你有用,欢迎点个 Star —— 它能让更多开发者发现 moxsh 生态!
这是个刚起步的项目,bug 肯定有,而且不少。我不装完美—— 你踩到的每一个坑、每一个槽点,都是帮我把它养好的机会。
每个 issue 我都会看,能修的尽快修。一起把它从“能跑”养到“好用” 💪
💛 觉得好用?欢迎到 爱发电 请作者喝杯咖啡 —— 国内可直接微信 / 支付宝收款,是独立开发最大的鼓励。
📑 目录 · Contents
moxsh-plugins/
├── catalog.json # App 直接消费的索引(顶层对象 + entries 数组)
├── plugins.json # 社区索引,含 repo / path / tags 等全量元数据
├── schema/
│ ├── catalog.schema.json # catalog.json 的 JSON Schema(Draft 2020-12),供作者校验
│ └── entry-schema.json # 单条目 / .mox 包内 manifest.json 的最小契约(必填 id/name/version/type)
├── scripts/
│ └── check-schemas.mjs # 零依赖 Schema 契约自测(规则有效性 + 索引一致性)
├── plugins/
│ ├── hello-mox/
│ │ └── plugin.json # 单个插件的完整清单(plugin 类型)
│ └── glass-terminal-theme/
│ └── plugin.json # 单个插件的完整清单(theme 类型)
└── README.md
moxsh App 内 StoreRepository.CloudStoreApi 的行为:
- 拉取
<base>/catalog.json,要求顶层是对象、内含entries数组; - 每条 entry 必须带
type——缺失会导致JSONObject.getString("type")直接抛错、整个商店目录解析失败; - 包下载走
<base>/pkg/<id>.mox。
因此对外提供索引时是 catalog.json + entries,而不是 plugins.json + plugins。plugins.json 是给社区/工具用的全量索引,现与 catalog.json 统一使用 schemaVersion 键(v1.0.0 起不再用旧 schema: 2)。
| 字段 | 必需 | 说明 |
|---|---|---|
id |
是 | 插件唯一标识,仅字母数字与 . _ -,不以 . 开头 |
name |
是 | 展示名称 |
version |
是 | 语义化版本号 |
type |
是 | plugin / skill / theme / rootfs,缺此字段 App 会解析失败 |
author |
否 | 作者名 |
description |
否 | 详细说明,卡片展示 |
minAppVersion |
否 | 要求的最低 moxsh 版本 |
permissions |
否 | 权限列表 |
price |
否 | 价格,0 为免费 |
purchased |
否 | 已购标记 |
sizeBytes |
否 | 包体积,卡片显示"约 x MB"(包体未就绪时为 0 占位) |
tags |
否 | 标签数组 |
repository |
否 | 源码仓库 |
path |
否 | 插件清单在仓库内的相对路径 |
每个插件目录下的 plugin.json 是插件的完整清单(含兼容矩阵、分发方式、入口点、能力、授权等)。
以下字段遵循统一 Schema(完整 41 字段规范见 moxsh-suite 的 spec/plugin-manifest.schema.json):
| 字段 | 类型 | 说明 |
|---|---|---|
schemaVersion |
string | 清单 Schema 版本,当前 "1.0" |
id / name / version |
string | 标识 / 展示名 / 语义化版本 |
author |
object | { "name": "...", "url": "..." } |
description |
string | 说明 |
categories / tags |
array | 分类与标签 |
visibility |
string | open-source / closed-source 等 |
license |
object | { "spdx": "GPL-3.0" } |
pricing |
object | { "model": "free" | "paid" | "subscription" | "system" } |
compatibility |
object | minAppVersion / minPluginApi / supportedOs / requiresRoot / requiresProot |
distribution |
object | type(git/file) / channel(stable/beta) / autoUpdate |
entrypoints |
object | 生命周期钩子,如 { "hooks": ["onEnable", "onApply"] } |
permissions |
array | 权限声明 |
capabilities |
array | 能力声明 |
updatedAt |
string | ISO8601 更新时间 |
示例见 plugins/hello-mox/plugin.json 与 plugins/glass-terminal-theme/plugin.json。
仓库附带 schema/catalog.schema.json(整体索引)与 schema/entry-schema.json(单条目 / .mox 包内 manifest.json 契约)。提交前按下面顺序校验:
# 方式一(推荐,零依赖,CI 也跑这条):规则自测 + 索引一致性
node scripts/check-schemas.mjs
# 方式二:完整 JSON Schema 引擎校验(需联网)
npx --yes @hyperjump/json-schema-cli@latest validate \
schema/catalog.schema.json catalog.json
# 方式三:ajv-cli
npm i -g ajv-cli
ajv compile -s schema/catalog.schema.json && ajv validate -s schema/catalog.schema.json -d catalog.jsoncheck-schemas.mjs 不只校验数据,还校验规则本身没失效:两份 schema 是否都带 integrity / signature.keyId、算法枚举是否与 moxsh-suite/spec/plugin-manifest.schema.json 同构、planned 条目有没有偷偷写非 0 的 sizeBytes、catalog.json 与 plugins.json 的 id 集合是否一致。CI 见 .github/workflows/validate-schema.yml。
注意:Schema 只校验结构(字段类型 /
type枚举 /id格式)。语义正确性(如path是否真实存在、minAppVersion是否合理)仍需人工/CI 复核。
- Fork 本仓库,在
plugins/<插件 id>/下放plugin.json; - 往
plugins.json的plugins数组追加一条(含repo/path/tags); - 同步往
catalog.json的entries追加一条——App 只读这个文件,务必带type; - 用上面的 Schema 校验
catalog.json; - 发起 Pull Request,审核通过后即上架。
插件须为开源、无恶意行为;上架即视为同意以仓库许可证分发。
| 模块 | 状态 | 说明 |
|---|---|---|
插件索引 catalog.json |
✅ 已发布 | 0.x 起,App 直接消费 |
社区索引 plugins.json |
✅ 1.0.0 统一 | 旧 schema: 2 键名已统一为 schemaVersion |
示例插件 hello-mox |
✅ 已发布 | plugin 类型 |
示例主题 glass-terminal-theme |
✅ 1.0.0 新增 | theme 类型,演示多类型支持 |
catalog.json JSON Schema |
✅ 1.0.0 新增 | schema/catalog.schema.json,供作者校验 |
| 完整性 / 签名字段对齐 suite spec | ✅ 1.0.1 新增 | integrity.checksum、integrity.signature、signingKeyId 与 moxsh-suite/spec/plugin-manifest.schema.json 同构 |
.mox manifest 必填约束 |
✅ 1.0.1 新增 | schema/entry-schema.json 强制 id/name/version/type,与 terminal-core/src/moxpkg.rs 同源 |
| Schema 契约自测 + CI | ✅ 1.0.1 新增 | scripts/check-schemas.mjs + validate-schema.yml,含负向用例验证 |
| 详细作者指南 + 字段参考 | ✅ 1.0.0 新增 | 本 README |
.mox 打包接入 CI |
⏳ 未打通 | 无 pkg/ 目录、无构建/上传 workflow;sizeBytes 为 0 占位且 packageStatus=planned |
终端侧消费 integrity 签名 |
⏳ 未迁移 | App 目前仍用共享密钥 HMAC-SHA256,未迁移到 spec 的非对称签名 / keyId 轮换 |
| 付费 / 订阅 / 系统内置示例 | ⏳ 规划中 | 规范已支持(pricing / visibility),待补示例 |
.mox 打包流程尚未接入 CI:仓库没有 pkg/ 目录,也没有构建、签名、上传 Release 的 workflow。
因此 catalog.json 里两条 entry 的 sizeBytes 仍为 0,并显式标注 packageStatus: "planned" —— 这不是数据错误,是如实说明「包体不存在」,不允许填一个看起来像真的体积数字。App 点安装会提示「包源未配置」,属预期表现。
Schema 侧已把 integrity(checksum + signature)与 signingKeyId 补齐并对齐 moxsh-suite 的非对称签名规格,但这只是契约先行:终端侧 StoreRepository 仍在使用共享密钥 HMAC-SHA256,尚未迁移到 ed25519 / keyId 轮换,也没有校验 timestamp 过期/撤销。这是已知差距,不是设计选择;详见 moxsh-terminal/SECURITY.md。
moxsh · 让手机上的 Linux 像 iOS 一样顺滑。
