# 官方应用规范复核 — v0.09.153

复核基线为已发布的 v0.09.152，范围是 33 个桌面应用及对应的官方平台模块。控制面板内部的基础设置和共用身份、文件、通知服务保留为宿主能力，不虚构为额外独立应用。

## 全量覆盖结论

33 个桌面入口、33 条目录记录、33 份 SPKG 1.1 Manifest、33 个前端源入口一一对应。没有遗漏、重复 ID 或孤立的套件描述。18 个默认安装应用与用户确认清单一致；其余 15 个可选：岁月留声、文件互传、健康中心、终端、算法商城、AI 大模型、AI Agent、AI 硬件、自动化、相册、openraw、知识库、Office、投屏、文件共享。

全部模块的包 ID、默认策略、安装保护、版本、架构、描述、分类、权限、依赖、前端入口和保留数据策略纳入自动校验。每次产品版本递增时，版本工具同步全部模块版本、宿主 ABI 和官方依赖版本，避免下一次发行使用旧 Manifest。构建前自动检查目录，打包完成后才原子发布整个签名源。

完整逐项清单在 [application-inventory.json](application-inventory.json) 和 [迁移方案](APPLICATION-MIGRATION.md)。复现检查：

```sh
node frontend/scripts/test-official-catalog.cjs
python3 scripts/manage-version.py check
cargo test --locked --manifest-path backend-rust/Cargo.toml official::tests --lib
```

## 本轮发现与修复

| 发现 | 改进后的规则与行为 |
| --- | --- |
| 全选可能把受保护组件或无需操作项一起提交，整个操作失败 | 批量按钮分别计算可安装、可卸载和可更新项，显示实际数量；受保护组件不加入批量卸载；后端仍强制保护，不能靠前端绕过 |
| 筛选后取消当前选择会清空隐藏选择 | 按当前结果增减集合，保留其他筛选中的选择，提供一键清空 |
| 重复安装产生无意义写入和成功记录 | 服务端跳过已健康且版本一致的项；完全无需变更时不产生任务或修改状态 |
| 更新未安装应用会隐式变成安装，旧候选可能降级 | 更新要求已安装；候选版本不可低于已安装版本，依赖按实际选中候选重新验版本 |
| 确认框不说明自动依赖和实际版本变化 | 预览提供请求项、自动依赖、跳过项、逐应用前后版本和载荷大小；用户看到实际执行集合 |
| 过期预览仍可点击执行 | 确认按钮在过期时禁用，支持重新检查；服务端继续验证账户、期限、revision 和候选摘要 |
| 后端专用错误在通用 API 层被替换为笼统提示 | 通过 API 错误翻译回调显示依赖、忙碌、安装源、签名、存储和版本的实际原因；未知内部错误使用可操作提示 |
| 应用均列为系统类、说明重复，难以判断用途 | 33 个应用补齐用途描述和分类；目录支持未安装、已安装、可选、更新和分类筛选 |
| 套件可见不代表当前账号能打开 | 安装权限与使用权限明确分开，无使用能力时打开按钮禁用，安装不自动授予权限 |
| 清除数据及备份迁移的元数据容易被理解为已实现 | 元数据明确本轮不提供清除业务数据；升级实际合同是校验、暂存、健康检查和原子登记，不声明不存在的数据库迁移脚本 |
| 打包中途失败会留下半套源，错误签名种子到部署时才发现 | 发布前检查私钥位置、权限及受审公钥；全部 33 包成功后原子发布目录，拒绝覆盖既有发行源 |

## 验收边界

目录及规范验证覆盖全部 33 项；服务端为全部 15 个可选模块测试专属 API 所有权，并复核共用的签名、路径、依赖、无操作、降级、活动租约、预览和数据保留规则。前端验证筛选选择、保护、实际动作、预览过期与错误翻译。Linux 隔离进程使用真实录音验证安装、卸载、重启、重装后的字节一致性。

这不等同于为每个应用的每一种业务操作或硬件运行环境完成认证。原生数据库、虚拟机、Office 转换、AI 硬件和原生投屏的能力仍由实际运行环境决定；官方平台模块共享宿主 Rust API 与受限 broker，第三方原生进程执行器继续保持关闭。既有测试限制记录在[布局与验证说明](../RESPONSIVE-APPLICATION-AUDIT.md)，不会以“全部测试通过”掩盖。

本轮执行结果：Rust 完整回归 558 项通过、12 项既有忽略，旧 OTA 权限目录断言单独排除；前端 72/74 项通过，仍为既有 Dock mock 和国际化词条两项失败；版本管理 3 项及签名源发布 2 项通过。真实生产浏览器验证交互，三主题 12 个窗口尺寸与 3 个手机确认框无页面溢出、无运行异常。录音生命周期与完整签名源构建另以隔离进程验收，不操作真实 NAS 账号与业务数据。

## v0.09.154 刷新联动补充

窗口标题栏的通用刷新与当前套件页面统一：官方页更新官方目录、社区页更新社区目录、原生或数据库页更新对应原生目录。新增组件公开接口回归验证页面分流，避免用户点击刷新却未看到当前目录变化。最终部署版本包含 v0.09.153 的全部规范检查和改进。