目录

SPKG1.1官方模块与安装接口

官方平台模块已有真实签名安装引擎。它共享SPKG1.0的归档和签名封装,但运行形态是使用宿主现有API的前端模块,不是独立操作系统进程。当前官方清单35项,18默认/17可选;旧33项复核和迁移文档属于历史记录,不能替代当前机器清单。

模块封装

仅允许manifest.json及assets下的普通叶子文件;不执行scripts、bin、动态库或任意命令。runtime.kind为platform-module,runtime.module必须是审定ID,runtime.host_version严格绑定宿主版本,入口assets/entry.js及styles均为实际0644文件。共享资源由同版本宿主提供,资源字段是共享宿主预算,不代表模块拥有独立cgroup进程。

构建与签名发行

官方构建使用同一精确提交生成Rust宿主、前端公共资源及独立模块入口,再由scripts/build-official-packages.py收集JS/CSS并签名。私钥放仓库外0600文件,APUOS_OFFICIAL_SIGN_KEY指向受审配置;公开公钥可审核,私钥不能下发开发者或网页。第三方不能把author改成官方名称来取得身份。

NAS管理接口

方法与路径 权限 用途
GET /api/v1/official/packages/installed desktop.read 真实已安装摘要、入口与样式
GET /api/v1/official/packages native.read 当前候选、状态、修复与操作记录
POST /api/v1/official/packages/preview native.manage action及appIds生成预览
POST /api/v1/official/packages/execute native.manage previewId与confirm:true执行确认

预览action为install、update、uninstall;修复使用install。预览五分钟有效并绑定账号、状态revision及候选摘要。无实际变化返回official_nothing_to_do;执行记录status=succeeded才可以显示成功。安装权限不自动授予应用使用权限,模块卸载后专属接口同样受保护。

数据与升级

默认卸载只清理模块代码和入口,保留文件、模型、笔记、录音、健康记录等业务数据。受保护模块、已安装依赖者及活动租约阻止直接卸载;重装恢复管理能力。宿主升级仍保持原已安装集合,不能为了版本统一把所有可选模块重新装上。详细合同及历史复核分别见官方模块规范和历史规范复核。