# 官方应用套件与原生套件中心

官方应用已采用 SPKG 1.1 平台模块合同，通过运行时引擎完成真实签名载荷安装、卸载、更新与修复。新设备默认安装 18 个应用，15 个可选；已有设备保留安装和数据。完整清单、迁移与数据保留规则见 [应用迁移方案](package-center/APPLICATION-MIGRATION.md)，合同见 [SPKG 1.1 官方模块扩展](package-center/OFFICIAL-MODULES.md)。

下文的“尚无安装执行器”仅针对 SPKG 1.0 第三方原生进程，不代表官方平台模块无引擎。

## 套件中心

套件中心替代原「开源应用中心」，用于直接运行于 Linux 的原生应用。Docker 应用仍在「应用中心」中管理；原生应用也需要适配架构、系统 ABI、依赖和服务权限，不能仅凭 CPU 架构相同认定兼容。

## 本次交付与边界

| 能力 | 当前状态 |
| --- | --- |
| 原生软件浏览、分类、搜索、已安装与更新筛选 | 可用，来自设备当前 APT 软件源；可明确同步当前软件源索引 |
| 安装/更新预览、确认、后台任务、日志 | 可用，继续使用已有受限安装助手 |
| 白名单服务启停/重启、数据库中心复用 | 可用，权限和接口保持兼容 |
| 开发与接入入口、规范与模板下载 | 可用，无需访问互联网 |
| 官方 SPKG 1.1 目录、安装/卸载/修复/更新、依赖及批量确认 | 已实现；18 默认 / 15 可选，已安装 UI 载荷与后端状态同步 |
| SPKG v1.0 规范、Manifest/仓库 JSON Schema | 已提供，见下方文档 |
| Rust 开发工具：目录打包、Manifest 校验、摘要/签名/归档校验 | 已实现，工具不执行安装或任何包内脚本 |
| 第三方 SPKG 1.0 上传安装、原生进程执行器及第三方源管理 | 后续开发；当前不提供可点击的虚假安装操作 |
| 独立上传管理后台、审核/发布、开发者管理 | 后续按管理后台协议开发 |
| 第三方原生依赖执行、破坏性数据迁移、评分与安全扫描 | 规划能力，尚未实现 |

当前系统软件包来自发行版，**不是已经迁移到 SPKG 的官方套件**。APT 安装不会自动初始化网站/数据库账号，也不提供快照回滚。所有安装操作继续要求 `native.manage`，读取要求 `native.read`；不能通过重命名应用绕过权限。

## 开发者入口

- [SPKG v1.0 完整规范](package-center/SPKG-SPEC.md)：封装、字段、签名、权限、生命周期、安装引擎约束。
- [未来上传后台与发布协议](package-center/ADMIN-API.md)：后台 API、审核流转、存储与发布不可变性。
- [Manifest JSON Schema](package-center/manifest.schema.json)、[仓库索引 JSON Schema](package-center/index.schema.json)。
- [示例套件](../examples/packages/README.md)、[Rust 打包与校验工具](../tools/spkg/README.md)。
- [当前原生安装系统说明](NATIVE-APPS.md)。

## 第三方原生套件后续阶段

1. 已有：原生格式 1.0、机器可校验 Schema 和 Rust 工具。官方平台模块的格式 1.1 和安装引擎已单独完成。
2. 第三方原生安装引擎：Rust 独立受限执行器；包检验、计划预览、权限确认、依赖计划、隔离服务、持久化任务与审计、失败恢复。先使用隔离测试机完成完整验收。
3. 独立上传后台：按约定接收包、检验与扫描、人工审核、签名发布索引；NAS 不承担开发者后台管理角色。
4. 源管理与升级：来源信任、架构/ABI 过滤、离线安装、迁移/回滚；随后增加批量、统计等。

原方案中的 root 脚本、驱动安装、磁盘格式化与“无条件完全回滚”不作为格式 1.0 的默认能力。后续涉及这些能力必须单独扩展 broker 策略、权限和验收，不能由 manifest 任意放行。

## 内置应用迁移

[33 个应用迁移方案](package-center/APPLICATION-MIGRATION.md)列明基础/可选范围、生命周期、依赖及数据保留；[机器清单](package-center/application-inventory.json)和 application-manifests 下的 33 份官方模块源 Manifest 对应同一个安装引擎。构建会收集真实 JS/CSS 并生成签名 `.spkg`；源 Manifest 本身不是安装包。

最新[官方应用全量规范复核](package-center/COMPLIANCE-REVIEW.md)记录 33 项覆盖、必填规则、批量操作和发布校验改进。