2026-07-10 02:45:13 +00:00
|
|
|
|
MARSCO_内部
|
|
|
|
|
|
|
|
|
|
|
|
软件自动升级与版本控制系统开发设计文档
|
|
|
|
|
|
|
|
|
|
|
|
v0.1
|
|
|
|
|
|
|
|
|
|
|
|
角色
|
|
|
|
|
|
|
|
|
|
|
|
编写
|
|
|
|
|
|
|
|
|
|
|
|
校对
|
|
|
|
|
|
|
|
|
|
|
|
校正
|
|
|
|
|
|
|
|
|
|
|
|
姓名
|
|
|
|
|
|
|
|
|
|
|
|
待填写
|
|
|
|
|
|
|
|
|
|
|
|
待填写
|
|
|
|
|
|
|
|
|
|
|
|
待填写
|
|
|
|
|
|
|
|
|
|
|
|
日期
|
|
|
|
|
|
|
|
|
|
|
|
待填写
|
|
|
|
|
|
|
|
|
|
|
|
待填写
|
|
|
|
|
|
|
|
|
|
|
|
待填写
|
|
|
|
|
|
|
|
|
|
|
|
MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
MARSCO_内部
|
|
|
|
|
|
|
|
|
|
|
|
修订记录
|
|
|
|
|
|
|
|
|
|
|
|
版本
|
|
|
|
|
|
|
|
|
|
|
|
日期
|
|
|
|
|
|
|
|
|
|
|
|
修订章节
|
|
|
|
|
|
|
|
|
|
|
|
修订内容
|
|
|
|
|
|
|
|
|
|
|
|
v0.1
|
|
|
|
|
|
|
|
|
|
|
|
2026-06-
|
|
|
|
|
|
|
|
|
|
|
|
技术选型
|
|
|
|
|
|
|
|
|
|
|
|
明确客户端与服务端技术栈边界。
|
|
|
|
|
|
|
|
|
|
|
|
修订人
|
|
|
|
|
|
|
|
|
|
|
|
待填写
|
|
|
|
|
|
|
|
|
|
|
|
23
|
|
|
|
|
|
|
|
|
|
|
|
v0.1
|
|
|
|
|
|
|
|
|
|
|
|
2026-06-
|
|
|
|
|
|
|
|
|
|
|
|
总体架构
|
|
|
|
|
|
|
|
|
|
|
|
梳理客户端、服务端和对象存储交互关
|
|
|
|
|
|
|
|
|
|
|
|
待填写
|
|
|
|
|
|
|
|
|
|
|
|
23
|
|
|
|
|
|
|
|
|
|
|
|
系。
|
|
|
|
|
|
|
|
|
|
|
|
v0.1
|
|
|
|
|
|
|
|
|
|
|
|
2026-06-
|
|
|
|
|
|
|
|
|
|
|
|
客户端目录结
|
|
|
|
|
|
|
|
|
|
|
|
将目录树整理为正式表格。
|
|
|
|
|
|
|
|
|
|
|
|
待填写
|
|
|
|
|
|
|
|
|
|
|
|
23
|
|
|
|
|
|
|
|
|
|
|
|
构
|
|
|
|
|
|
|
|
|
|
|
|
v0.1
|
|
|
|
|
|
|
|
|
|
|
|
2026-06-
|
|
|
|
|
|
|
|
|
|
|
|
本地配置文件
|
|
|
|
|
|
|
|
|
|
|
|
补充 app_config、client_identity、
|
|
|
|
|
|
|
|
|
|
|
|
待填写
|
|
|
|
|
|
|
|
|
|
|
|
23
|
|
|
|
|
|
|
|
|
|
|
|
设计
|
|
|
|
|
|
|
|
|
|
|
|
version_policy、local_state 字段说
|
|
|
|
|
|
|
|
|
|
|
|
明。
|
|
|
|
|
|
|
|
|
|
|
|
v0.1
|
|
|
|
|
|
|
|
|
|
|
|
2026-06-
|
|
|
|
|
|
|
|
|
|
|
|
Manifest 设计 补充全量清单、签名和文件完整性规则。 待填写
|
|
|
|
|
|
|
|
|
|
|
|
23
|
|
|
|
|
|
|
|
|
|
|
|
v0.1
|
|
|
|
|
|
|
|
|
|
|
|
2026-06-
|
|
|
|
|
|
|
|
|
|
|
|
启动票据设计 明确票据用途、校验规则和安全边界。
|
|
|
|
|
|
|
|
|
|
|
|
待填写
|
|
|
|
|
|
|
|
|
|
|
|
23
|
|
|
|
|
|
|
|
|
|
|
|
v0.1
|
|
|
|
|
|
|
|
|
|
|
|
2026-06-
|
|
|
|
|
|
|
|
|
|
|
|
客户端启动逻
|
|
|
|
|
|
|
|
|
|
|
|
新增 Visio 流程图和步骤表。
|
|
|
|
|
|
|
|
|
|
|
|
待填写
|
|
|
|
|
|
|
|
|
|
|
|
23
|
|
|
|
|
|
|
|
|
|
|
|
辑
|
|
|
|
|
|
|
|
|
|
|
|
v0.1
|
|
|
|
|
|
|
|
|
|
|
|
2026-06-
|
|
|
|
|
|
|
|
|
|
|
|
REST API 设计 明确设备身份接口非用户登录，补充管理
|
|
|
|
|
|
|
|
|
|
|
|
待填写
|
|
|
|
|
|
|
|
|
|
|
|
23
|
|
|
|
|
|
|
|
|
|
|
|
员登录仅用于后台。
|
|
|
|
|
|
|
|
|
|
|
|
v0.1
|
|
|
|
|
|
|
|
|
|
|
|
2026-06-
|
|
|
|
|
|
|
|
|
|
|
|
数据库设计
|
|
|
|
|
|
|
|
|
|
|
|
补充应用、通道、版本、策略、设备、授
|
|
|
|
|
|
|
|
|
|
|
|
待填写
|
|
|
|
|
|
|
|
|
|
|
|
23
|
|
|
|
|
|
|
|
|
|
|
|
权和审计日志表。
|
|
|
|
|
|
|
|
|
|
|
|
v0.1
|
|
|
|
|
|
|
|
|
|
|
|
2026-06-
|
|
|
|
|
|
|
|
|
|
|
|
对象存储目录
|
|
|
|
|
|
|
|
|
|
|
|
将对象存储目录整理为正式表格。
|
|
|
|
|
|
|
|
|
|
|
|
待填写
|
|
|
|
|
|
|
|
|
|
|
|
23
|
|
|
|
|
|
|
|
|
|
|
|
设计
|
|
|
|
|
|
|
|
|
|
|
|
v0.1
|
|
|
|
|
|
|
|
|
|
|
|
2026-06-
|
|
|
|
|
|
|
|
|
|
|
|
Hash 校验策略 明确更新可增量、校验必须全量。
|
|
|
|
|
|
|
|
|
|
|
|
待填写
|
|
|
|
|
|
|
|
|
|
|
|
23
|
|
|
|
|
|
|
|
|
|
|
|
MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄 MARSCO_内部
|
|
|
|
|
|
|
|
|
|
|
|
v0.1
|
|
|
|
|
|
|
|
|
|
|
|
2026-06-
|
|
|
|
|
|
|
|
|
|
|
|
签名策略
|
|
|
|
|
|
|
|
|
|
|
|
补充签名算法、key_id 和稳定序列化要
|
|
|
|
|
|
|
|
|
|
|
|
待填写
|
|
|
|
|
|
|
|
|
|
|
|
23
|
|
|
|
|
|
|
|
|
|
|
|
求。
|
|
|
|
|
|
|
|
|
|
|
|
v0.1
|
|
|
|
|
|
|
|
|
|
|
|
2026-06-
|
|
|
|
|
|
|
|
|
|
|
|
限流策略
|
|
|
|
|
|
|
|
|
|
|
|
将限流规则整理为表格。
|
|
|
|
|
|
|
|
|
|
|
|
待填写
|
|
|
|
|
|
|
|
|
|
|
|
23
|
|
|
|
|
|
|
|
|
|
|
|
v0.1
|
|
|
|
|
|
|
|
|
|
|
|
2026-06-
|
|
|
|
|
|
|
|
|
|
|
|
回滚机制
|
|
|
|
|
|
|
|
|
|
|
|
补充事务状态机和失败恢复规则。
|
|
|
|
|
|
|
|
|
|
|
|
待填写
|
|
|
|
|
|
|
|
|
|
|
|
23
|
|
|
|
|
|
|
|
|
|
|
|
v0.1
|
|
|
|
|
|
|
|
|
|
|
|
2026-06-
|
|
|
|
|
|
|
|
|
|
|
|
Demo 开发里程
|
|
|
|
|
|
|
|
|
|
|
|
按阶段整理开发计划。
|
|
|
|
|
|
|
|
|
|
|
|
待填写
|
|
|
|
|
|
|
|
|
|
|
|
23
|
|
|
|
|
|
|
|
|
|
|
|
碑
|
|
|
|
|
|
|
|
|
|
|
|
v0.1
|
|
|
|
|
|
|
|
|
|
|
|
2026-06-
|
|
|
|
|
|
|
|
|
|
|
|
Demo 验收用例 补充升级、回滚、禁用、预览版、离线等
|
|
|
|
|
|
|
|
|
|
|
|
待填写
|
|
|
|
|
|
|
|
|
|
|
|
23
|
|
|
|
|
|
|
|
|
|
|
|
验收用例。
|
|
|
|
|
|
|
|
|
|
|
|
v0.1
|
|
|
|
|
|
|
|
|
|
|
|
2026-06-
|
|
|
|
|
|
|
|
|
|
|
|
后续扩展方向 补充 License、灰度、多平台、日志上传
|
|
|
|
|
|
|
|
|
|
|
|
待填写
|
|
|
|
|
|
|
|
|
|
|
|
23
|
|
|
|
|
|
|
|
|
|
|
|
等扩展方向。
|
|
|
|
|
|
|
|
|
|
|
|
v0.1
|
|
|
|
|
|
|
|
|
|
|
|
2026-06-
|
|
|
|
|
|
|
|
|
|
|
|
设计范围与登
|
|
|
|
|
|
|
|
|
|
|
|
明确本期默认可用且不做普通用户登录校
|
|
|
|
|
|
|
|
|
|
|
|
待填写
|
|
|
|
|
|
|
|
|
|
|
|
23
|
|
|
|
|
|
|
|
|
|
|
|
录边界
|
|
|
|
|
|
|
|
|
|
|
|
验；管理员登录仅用于后台。
|
|
|
|
|
|
|
|
|
|
|
|
v0.1
|
|
|
|
|
|
|
|
|
|
|
|
2026-06-
|
|
|
|
|
|
|
|
|
|
|
|
本期范围
|
|
|
|
|
|
|
|
|
|
|
|
明确普通用户登录本期不做，默认可用；
|
|
|
|
|
|
|
|
|
|
|
|
待填写
|
|
|
|
|
|
|
|
|
|
|
|
23
|
|
|
|
|
|
|
|
|
|
|
|
后续可扩展权限和授权校验。
|
|
|
|
|
|
|
|
|
|
|
|
MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄
|
|
|
|
|
|
|
|
|
|
|
|
MARSCO_内部
|
|
|
|
|
|
|
|
|
|
|
|
目录
|
|
|
|
|
|
|
|
|
|
|
|
1 设计范围与登录边界 ............................................................................................................. 6
|
|
|
|
|
|
|
|
|
|
|
|
2 技术选型 ............................................................................................................................. 6
|
|
|
|
|
|
|
|
|
|
|
|
2.1 客户端技术栈 ..................................................................................................................... 6
|
|
|
|
|
|
|
|
|
|
|
|
2.2 服务端技术栈 ..................................................................................................................... 7
|
|
|
|
|
|
|
|
|
|
|
|
2.3 文件存储 ............................................................................................................................ 8
|
|
|
|
|
|
|
|
|
|
|
|
3 总体架构 .............................................................................................................................. 8
|
|
|
|
|
|
|
|
|
|
|
|
4 客户端目录结构 .................................................................................................................... 9
|
|
|
|
|
|
|
|
|
|
|
|
5 本地配置文件设计 .............................................................................................................. 11
|
|
|
|
|
|
|
|
|
|
|
|
5.1 app_config.json ................................................................................................................ 11
|
|
|
|
|
|
|
|
|
|
|
|
5.2 client_identity.dat ............................................................................................................. 11
|
|
|
|
|
|
|
|
|
|
|
|
5.3 version_policy.dat ............................................................................................................ 11
|
|
|
|
|
|
|
|
|
|
|
|
5.4 local_state.json ................................................................................................................ 12
|
|
|
|
|
|
|
|
|
|
|
|
6 Manifest 设计 .................................................................................................................... 13
|
|
|
|
|
|
|
|
|
|
|
|
7 启动票据设计 ..................................................................................................................... 14
|
|
|
|
|
|
|
|
|
|
|
|
8 客户端启动逻辑 .................................................................................................................. 15
|
|
|
|
|
|
|
|
|
|
|
|
8.1 Launcher 启动逻辑 ........................................................................................................... 16
|
|
|
|
|
|
|
|
|
|
|
|
8.2 MainApp 启动逻辑 ............................................................................................................ 18
|
|
|
|
|
|
|
|
|
|
|
|
8.3 Updater 升级逻辑 ............................................................................................................. 20
|
|
|
|
|
|
|
|
|
|
|
|
9 REST API 设计 .................................................................................................................... 21
|
|
|
|
|
|
|
|
|
|
|
|
9.1 检查更新接口 ................................................................................................................... 21
|
|
|
|
|
|
|
|
|
|
|
|
9.2 获取下载链接接口 ............................................................................................................ 24
|
|
|
|
|
|
|
|
|
|
|
|
9.3 升级结果上报接口 ............................................................................................................ 25
|
|
|
|
|
|
|
|
|
|
|
|
9.4 设备身份签发接口（非用户登录） .................................................................................... 26
|
|
|
|
|
|
|
|
|
|
|
|
9.5 管理后台管理员登录接口（非本期普通客户端用户登录） ................................................. 27
|
|
|
|
|
|
|
|
|
|
|
|
9.6 管理后台接口摘要 ............................................................................................................ 28
|
|
|
|
|
|
|
|
|
|
|
|
10 数据库设计 ....................................................................................................................... 29
|
|
|
|
|
|
|
|
|
|
|
|
10.1 应用表 apps ................................................................................................................... 29
|
|
|
|
|
|
|
|
|
|
|
|
10.2 版本通道表 channels ...................................................................................................... 29
|
|
|
|
|
|
|
|
|
|
|
|
10.3 版本表 versions .............................................................................................................. 30
|
|
|
|
|
|
|
|
|
|
|
|
MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄 MARSCO_内部
|
|
|
|
|
|
|
|
|
|
|
|
10.4 版本文件表 version_files ................................................................................................. 31
|
|
|
|
|
|
|
|
|
|
|
|
10.5 版本策略表 version_policies ............................................................................................ 32
|
|
|
|
|
|
|
|
|
|
|
|
10.6 设备表 devices ............................................................................................................... 33
|
|
|
|
|
|
|
|
|
|
|
|
10.7 授权表 licenses .............................................................................................................. 33
|
|
|
|
|
|
|
|
|
|
|
|
10.8 下载日志表 download_logs ............................................................................................. 34
|
|
|
|
|
|
|
|
|
|
|
|
10.9 升级日志表 upgrade_logs ................................................................................................ 35
|
|
|
|
|
|
|
|
|
|
|
|
10.10 管理员表 admin_users .................................................................................................. 35
|
|
|
|
|
|
|
|
|
|
|
|
10.11 管理员操作日志表 admin_audit_logs ............................................................................. 36
|
|
|
|
|
|
|
|
|
|
|
|
11 对象存储目录设计 ............................................................................................................. 37
|
|
|
|
|
|
|
|
|
|
|
|
12 Hash 校验策略 ................................................................................................................. 38
|
|
|
|
|
|
|
|
|
|
|
|
13 签名策略 .......................................................................................................................... 38
|
|
|
|
|
|
|
|
|
|
|
|
14 限流策略 .......................................................................................................................... 41
|
|
|
|
|
|
|
|
|
|
|
|
15 回滚机制 .......................................................................................................................... 42
|
|
|
|
|
|
|
|
|
|
|
|
16 Demo 开发里程碑 ............................................................................................................. 45
|
|
|
|
|
|
|
|
|
|
|
|
16.1 第一阶段：基础框架 ....................................................................................................... 45
|
|
|
|
|
|
|
|
|
|
|
|
16.2 第二阶段：服务端基础能力 ............................................................................................ 45
|
|
|
|
|
|
|
|
|
|
|
|
16.3 第三阶段：在线更新 ....................................................................................................... 45
|
|
|
|
|
|
|
|
|
|
|
|
16.4 第四阶段：版本策略 ....................................................................................................... 46
|
|
|
|
|
|
|
|
|
|
|
|
16.5 第五阶段：离线能力 ....................................................................................................... 46
|
|
|
|
|
|
|
|
|
|
|
|
16.6 第六阶段：可靠性与安全 ................................................................................................ 46
|
|
|
|
|
|
|
|
|
|
|
|
17 Demo 验收用例 ................................................................................................................ 46
|
|
|
|
|
|
|
|
|
|
|
|
18 后续扩展方向 ................................................................................................................... 47
|
|
|
|
|
|
|
|
|
|
|
|
MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
MARSCO_内部
|
|
|
|
|
|
|
|
|
|
|
|
1 设计范围与登录边界
|
|
|
|
|
|
|
|
|
|
|
|
本设计文档用于说明软件自动升级与版本控制系统第一版 Demo
|
|
|
|
|
|
|
|
|
|
|
|
的技术方案。设计范围包括客户端启动器、主程序启动校验、独立升
|
|
|
|
|
|
|
|
|
|
|
|
级器、版本策略、manifest、签名校验、下载授权、离线运行、回滚机
|
|
|
|
|
|
|
|
|
|
|
|
制、管理后台和基础服务端接口。
|
|
|
|
|
|
|
|
|
|
|
|
本 期 普 通 客 户 端 用 户 默 认 可 以 使 用 软 件 ， 不 需 要 登 录 账 号 。
|
|
|
|
|
|
|
|
|
|
|
|
Launcher 启动检查、MainApp 启动校验、Updater 下载与替换、离线
|
|
|
|
|
|
|
|
|
|
|
|
启动、离线更新包导入、版本禁用和降级控制均不做普通用户登录校
|
|
|
|
|
|
|
|
|
|
|
|
验，只使用设备身份、版本策略、manifest、启动票据和签名校验。
|
|
|
|
|
|
|
|
|
|
|
|
本期客户端侧不实现普通用户登录。所有客户端请求使用设备身
|
|
|
|
|
|
|
|
|
|
|
|
份凭证进行识别，设备身份凭证不代表用户账号，也不产生用户会话。
|
|
|
|
|
|
|
|
|
|
|
|
后续版本可以增加普通用户登录能力，用于用户权限校验、用户
|
|
|
|
|
|
|
|
|
|
|
|
授权状态判断，以及判断该用户是否可以使用该软件。该能力属于后
|
|
|
|
|
|
|
|
|
|
|
|
续扩展，不纳入本期 Demo 必做范围。
|
|
|
|
|
|
|
|
|
|
|
|
后续如增加普通用户登录，建议放在 Launcher 启动检查阶段或
|
|
|
|
|
|
|
|
|
|
|
|
MainApp 首次进入业务前，用于用户级授权状态判断。该能力不替代
|
|
|
|
|
|
|
|
|
|
|
|
设备身份、版本策略、manifest、启动票据和签名校验。
|
|
|
|
|
|
|
|
|
|
|
|
管理后台管理员登录属于本期范围，仅用于保护后台版本发布、
|
|
|
|
|
|
|
|
|
|
|
|
策略修改、设备管理、离线包生成和日志查看等管理操作。该登录不
|
|
|
|
|
|
|
|
|
|
|
|
是普通客户端用户登录，普通客户端用户不调用管理后台管理员登录
|
|
|
|
|
|
|
|
|
|
|
|
接口，也不持有后台访问令牌。
|
|
|
|
|
|
2 技术选型
|
|
|
|
|
|
2.1 客户端技术栈
|
|
|
|
|
|
|
|
|
|
|
|
客户端采用 Qt + C++ 开发。
|
|
|
|
|
|
|
|
|
|
|
|
客户端程序包括：
|
|
|
|
|
|
|
|
|
|
|
|
MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄 MARSCO_内部
|
|
|
|
|
|
|
|
|
|
|
|
a) Launcher.exe
|
|
|
|
|
|
|
|
|
|
|
|
软件启动器。
|
|
|
|
|
|
|
|
|
|
|
|
b) MainApp.exe
|
|
|
|
|
|
|
|
|
|
|
|
主业务程序，用于 Demo 演示主软件启动、版本显示和 DLL 加载。
|
|
|
|
|
|
|
|
|
|
|
|
c) Updater.exe
|
|
|
|
|
|
|
|
|
|
|
|
独立升级器，负责下载、校验、替换、回滚和重启。
|
|
|
|
|
|
|
|
|
|
|
|
d) demo_plugin.dll
|
|
|
|
|
|
|
|
|
|
|
|
Demo 插件 DLL，用于验证 DLL 替换能力。
|
|
|
|
|
|
|
|
|
|
|
|
e) UpdateHelper.exe
|
|
|
|
|
|
|
|
|
|
|
|
可选辅助程序，用于后续处理 Updater 自身更新。
|
|
|
|
|
|
|
|
|
|
|
|
客户端推荐使用 Qt 模块：
|
|
|
|
|
|
|
|
|
|
|
|
a) QNetworkAccessManager：HTTP API 请求和文件下载。
|
|
|
|
|
|
|
|
|
|
|
|
b) QJsonDocument：JSON 解析。
|
|
|
|
|
|
|
|
|
|
|
|
c) QFile、QDir：文件操作。
|
|
|
|
|
|
|
|
|
|
|
|
d) QCryptographicHash：SHA-256 hash 计算。
|
|
|
|
|
|
|
|
|
|
|
|
e) QProcess：启动和关闭外部进程。
|
|
|
|
|
|
|
|
|
|
|
|
f) QTimer：定时检查版本。
|
|
|
|
|
|
|
|
|
|
|
|
g) QLockFile：防止重复启动升级器。
|
|
|
|
|
|
|
|
|
|
|
|
h) QSaveFile：安全写入本地配置文件。
|
|
|
|
|
|
|
|
|
|
|
|
i) QSettings：本地配置管理。
|
|
|
|
|
|
|
|
|
|
|
|
j) QTemporaryDir：临时目录管理。
|
|
|
|
|
|
|
|
|
|
|
|
2.2 服务端技术栈
|
|
|
|
|
|
|
|
|
|
|
|
Demo 阶段建议使用：
|
|
|
|
|
|
|
|
|
|
|
|
a) Python FastAPI。
|
|
|
|
|
|
|
|
|
|
|
|
b) SQLite。
|
|
|
|
|
|
|
|
|
|
|
|
MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄 MARSCO_内部
|
|
|
|
|
|
|
|
|
|
|
|
c) MinIO。
|
|
|
|
|
|
|
|
|
|
|
|
d) Redis 可选，用于限流。
|
|
|
|
|
|
|
|
|
|
|
|
正式阶段可选：
|
|
|
|
|
|
|
|
|
|
|
|
a) Python FastAPI + PostgreSQL + Redis + MinIO / OSS。
|
|
|
|
|
|
|
|
|
|
|
|
b) Go + PostgreSQL + Redis + MinIO / OSS。
|
|
|
|
|
|
|
|
|
|
|
|
接口采用 HTTP REST JSON 方式约定。
|
|
|
|
|
|
|
|
|
|
|
|
2.3 文件存储
|
|
|
|
|
|
|
|
|
|
|
|
Demo 阶段使用 MinIO。
|
|
|
|
|
|
|
|
|
|
|
|
正式阶段可使用：
|
|
|
|
|
|
|
|
|
|
|
|
a) 阿里云 OSS。
|
|
|
|
|
|
|
|
|
|
|
|
b) 腾讯云 COS。
|
|
|
|
|
|
|
|
|
|
|
|
c) 华为云 OBS。
|
|
|
|
|
|
|
|
|
|
|
|
d) AWS S3。
|
|
|
|
|
|
|
|
|
|
|
|
e) 私有化 MinIO。
|
|
|
|
|
|
|
|
|
|
|
|
f) 企业内网对象存储。
|
|
|
|
|
|
|
|
|
|
|
|
版本文件不建议直接存入数据库。数据库只存文件元数据、hash、
|
|
|
|
|
|
|
|
|
|
|
|
大小、存储路径和版本关系。
|
|
|
|
|
|
3 总体架构
|
|
|
|
|
|
|
|
|
|
|
|
系统总体架构如下：
|
|
|
|
|
|
|
|
|
|
|
|
客户端：
|
|
|
|
|
|
|
|
|
|
|
|
a) Launcher.exe
|
|
|
|
|
|
|
|
|
|
|
|
b) MainApp.exe
|
|
|
|
|
|
|
|
|
|
|
|
c) Updater.exe
|
|
|
|
|
|
|
|
|
|
|
|
d) 本地身份凭证
|
|
|
|
|
|
|
|
|
|
|
|
e) 本地版本策略缓存
|
|
|
|
|
|
|
|
|
|
|
|
MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄 MARSCO_内部
|
|
|
|
|
|
|
|
|
|
|
|
f) 本地 manifest 缓存
|
|
|
|
|
|
|
|
|
|
|
|
g) staging 下载目录
|
|
|
|
|
|
|
|
|
|
|
|
h) backup 备份目录
|
|
|
|
|
|
|
|
|
|
|
|
i)
|
|
|
|
|
|
|
|
|
|
|
|
logs 日志目录
|
|
|
|
|
|
|
|
|
|
|
|
服务端：
|
|
|
|
|
|
|
|
|
|
|
|
a) API 服务。
|
|
|
|
|
|
|
|
|
|
|
|
b) 管理后台。
|
|
|
|
|
|
|
|
|
|
|
|
c) 数据库。
|
|
|
|
|
|
|
|
|
|
|
|
d) 对象存储。
|
|
|
|
|
|
|
|
|
|
|
|
e) Redis 限流模块。
|
|
|
|
|
|
|
|
|
|
|
|
f) 签名服务模块。
|
|
|
|
|
|
|
|
|
|
|
|
交互流程：
|
|
|
|
|
|
|
|
|
|
|
|
a) 客户端请求服务端 API。
|
|
|
|
|
|
|
|
|
|
|
|
b) 服务端验证设备身份。
|
|
|
|
|
|
|
|
|
|
|
|
c) 服务端返回版本策略。
|
|
|
|
|
|
|
|
|
|
|
|
d) 客户端根据策略判断是否允许运行或升级。
|
|
|
|
|
|
|
|
|
|
|
|
e) 需要升级时，客户端请求下载链接。
|
|
|
|
|
|
|
|
|
|
|
|
f) 服务端生成短期对象存储下载 URL。
|
|
|
|
|
|
|
|
|
|
|
|
g) 客户端下载文件并校验。
|
|
|
|
|
|
|
|
|
|
|
|
h) 客户端替换文件并上报结果。
|
|
|
|
|
|
|
|
|
|
|
|
4 客户端目录结构
|
|
|
|
|
|
|
|
|
|
|
|
建议客户端目录如下：
|
|
|
|
|
|
|
|
|
|
|
|
目录或文件
|
|
|
|
|
|
|
|
|
|
|
|
DemoApp/
|
|
|
|
|
|
|
|
|
|
|
|
Launcher.exe
|
|
|
|
|
|
|
|
|
|
|
|
MainApp.exe
|
|
|
|
|
|
|
|
|
|
|
|
用途
|
|
|
|
|
|
|
|
|
|
|
|
客户端安装根目录
|
|
|
|
|
|
|
|
|
|
|
|
默认启动入口，负责版本准入检查和启动票据生成
|
|
|
|
|
|
|
|
|
|
|
|
主业务程序
|
|
|
|
|
|
|
|
|
|
|
|
MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄 MARSCO_内部
|
|
|
|
|
|
|
|
|
|
|
|
Updater.exe
|
|
|
|
|
|
|
|
|
|
|
|
UpdateHelper.exe
|
|
|
|
|
|
|
|
|
|
|
|
独立升级程序
|
|
|
|
|
|
|
|
|
|
|
|
可选辅助程序，用于处理 Updater 自身更新
|
|
|
|
|
|
|
|
|
|
|
|
plugins/demo_plugin.dll
|
|
|
|
|
|
|
|
|
|
|
|
Demo 插件 DLL，用于验证 DLL 替换能力
|
|
|
|
|
|
|
|
|
|
|
|
bin/
|
|
|
|
|
|
|
|
|
|
|
|
config/app_config.json
|
|
|
|
|
|
|
|
|
|
|
|
运行依赖目录
|
|
|
|
|
|
|
|
|
|
|
|
客户端基础配置
|
|
|
|
|
|
|
|
|
|
|
|
config/client_identity.dat
|
|
|
|
|
|
|
|
|
|
|
|
本地设备身份凭证
|
|
|
|
|
|
|
|
|
|
|
|
config/version_policy.dat
|
|
|
|
|
|
|
|
|
|
|
|
本地版本策略缓存
|
|
|
|
|
|
|
|
|
|
|
|
config/local_state.json
|
|
|
|
|
|
|
|
|
|
|
|
本地运行状态和防回滚状态
|
|
|
|
|
|
|
|
|
|
|
|
update/manifest_cache/
|
|
|
|
|
|
|
|
|
|
|
|
manifest 缓存目录
|
|
|
|
|
|
|
|
|
|
|
|
update/staging/
|
|
|
|
|
|
|
|
|
|
|
|
update/backup/
|
|
|
|
|
|
|
|
|
|
|
|
update/logs/
|
|
|
|
|
|
|
|
|
|
|
|
data/
|
|
|
|
|
|
|
|
|
|
|
|
cache/
|
|
|
|
|
|
|
|
|
|
|
|
logs/
|
|
|
|
|
|
|
|
|
|
|
|
说明：
|
|
|
|
|
|
|
|
|
|
|
|
更新文件下载临时目录
|
|
|
|
|
|
|
|
|
|
|
|
升级前备份目录
|
|
|
|
|
|
|
|
|
|
|
|
升级日志目录
|
|
|
|
|
|
|
|
|
|
|
|
用户数据目录，不纳入 hash 校验
|
|
|
|
|
|
|
|
|
|
|
|
缓存目录
|
|
|
|
|
|
|
|
|
|
|
|
运行日志目录
|
|
|
|
|
|
|
|
|
|
|
|
a) config/client_identity.dat：本地设备身份凭证。
|
|
|
|
|
|
|
|
|
|
|
|
b) config/version_policy.dat：本地版本策略。
|
|
|
|
|
|
|
|
|
|
|
|
c) update/manifest_cache：缓存 manifest。
|
|
|
|
|
|
|
|
|
|
|
|
d) update/staging：下载新文件的临时目录。
|
|
|
|
|
|
|
|
|
|
|
|
e) update/backup：升级前备份目录。
|
|
|
|
|
|
|
|
|
|
|
|
f) update/logs：升级日志。
|
|
|
|
|
|
|
|
|
|
|
|
g) plugins：插件 DLL 目录，需要进行白名单检查。
|
|
|
|
|
|
|
|
|
|
|
|
h) data：用户数据目录，不纳入 hash 校验。
|
|
|
|
|
|
|
|
|
|
|
|
i)
|
|
|
|
|
|
|
|
|
|
|
|
logs：运行日志目录，不纳入 hash 校验。
|
|
|
|
|
|
|
|
|
|
|
|
MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄 MARSCO_内部
|
|
|
|
|
|
|
|
|
|
|
|
5 本地配置文件设计
|
|
|
|
|
|
5.1 app_config.json
|
|
|
|
|
|
|
|
|
|
|
|
字段
|
|
|
|
|
|
|
|
|
|
|
|
app_id
|
|
|
|
|
|
|
|
|
|
|
|
app_name
|
|
|
|
|
|
|
|
|
|
|
|
channel
|
|
|
|
|
|
|
|
|
|
|
|
api_base_url
|
|
|
|
|
|
|
|
|
|
|
|
platform
|
|
|
|
|
|
|
|
|
|
|
|
arch
|
|
|
|
|
|
|
|
|
|
|
|
current_version
|
|
|
|
|
|
5.2 client_identity.dat
|
|
|
|
|
|
|
|
|
|
|
|
示例值
|
|
|
|
|
|
|
|
|
|
|
|
marsco_demo_app
|
|
|
|
|
|
|
|
|
|
|
|
Marsco Demo App
|
|
|
|
|
|
|
|
|
|
|
|
stable
|
|
|
|
|
|
|
|
|
|
|
|
https://api.example.com/api/v1
|
|
|
|
|
|
|
|
|
|
|
|
windows
|
|
|
|
|
|
|
|
|
|
|
|
x64
|
|
|
|
|
|
|
|
|
|
|
|
1.0.0
|
|
|
|
|
|
|
|
|
|
|
|
该文件由服务端签发，客户端只验证，不自行伪造。
|
|
|
|
|
|
|
|
|
|
|
|
字段
|
|
|
|
|
|
|
|
|
|
|
|
client_id
|
|
|
|
|
|
|
|
|
|
|
|
device_id
|
|
|
|
|
|
|
|
|
|
|
|
license_id
|
|
|
|
|
|
|
|
|
|
|
|
app_id
|
|
|
|
|
|
|
|
|
|
|
|
channel
|
|
|
|
|
|
|
|
|
|
|
|
issued_at
|
|
|
|
|
|
|
|
|
|
|
|
valid_until
|
|
|
|
|
|
|
|
|
|
|
|
signature
|
|
|
|
|
|
5.3 version_policy.dat
|
|
|
|
|
|
|
|
|
|
|
|
字段
|
|
|
|
|
|
|
|
|
|
|
|
app_id
|
|
|
|
|
|
|
|
|
|
|
|
client_id
|
|
|
|
|
|
|
|
|
|
|
|
示例值
|
|
|
|
|
|
|
|
|
|
|
|
client_xxx
|
|
|
|
|
|
|
|
|
|
|
|
device_xxx
|
|
|
|
|
|
|
|
|
|
|
|
license_xxx
|
|
|
|
|
|
|
|
|
|
|
|
marsco_demo_app
|
|
|
|
|
|
|
|
|
|
|
|
stable
|
|
|
|
|
|
|
|
|
|
|
|
2026-06-23T00:00:00Z
|
|
|
|
|
|
|
|
|
|
|
|
2026-12-31T00:00:00Z
|
|
|
|
|
|
|
|
|
|
|
|
base64_signature
|
|
|
|
|
|
|
|
|
|
|
|
示例值
|
|
|
|
|
|
|
|
|
|
|
|
marsco_demo_app
|
|
|
|
|
|
|
|
|
|
|
|
client_xxx
|
|
|
|
|
|
|
|
|
|
|
|
MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄 MARSCO_内部
|
|
|
|
|
|
|
|
|
|
|
|
1024
|
|
|
|
|
|
|
|
|
|
|
|
stable
|
|
|
|
|
|
|
|
|
|
|
|
1.0.0
|
|
|
|
|
|
|
|
|
|
|
|
True
|
|
|
|
|
|
|
|
|
|
|
|
False
|
|
|
|
|
|
|
|
|
|
|
|
False
|
|
|
|
|
|
|
|
|
|
|
|
True
|
|
|
|
|
|
|
|
|
|
|
|
2026-06-23T00:00:00Z
|
|
|
|
|
|
|
|
|
|
|
|
2026-07-23T00:00:00Z
|
|
|
|
|
|
|
|
|
|
|
|
1.0.2
|
|
|
|
|
|
|
|
|
|
|
|
1.0.0
|
|
|
|
|
|
|
|
|
|
|
|
当前版本允许使用
|
|
|
|
|
|
|
|
|
|
|
|
base64_signature
|
|
|
|
|
|
|
|
|
|
|
|
policy_seq
|
|
|
|
|
|
|
|
|
|
|
|
channel
|
|
|
|
|
|
|
|
|
|
|
|
current_version
|
|
|
|
|
|
|
|
|
|
|
|
allow_run
|
|
|
|
|
|
|
|
|
|
|
|
force_update
|
|
|
|
|
|
|
|
|
|
|
|
allow_rollback
|
|
|
|
|
|
|
|
|
|
|
|
offline_allowed
|
|
|
|
|
|
|
|
|
|
|
|
issued_at
|
|
|
|
|
|
|
|
|
|
|
|
valid_until
|
|
|
|
|
|
|
|
|
|
|
|
latest_version
|
|
|
|
|
|
|
|
|
|
|
|
min_supported_version
|
|
|
|
|
|
|
|
|
|
|
|
message
|
|
|
|
|
|
|
|
|
|
|
|
signature
|
|
|
|
|
|
5.4 local_state.json
|
|
|
|
|
|
|
|
|
|
|
|
用于记录本地状态，防止策略回滚和系统时间回拨。
|
|
|
|
|
|
|
|
|
|
|
|
字段
|
|
|
|
|
|
|
|
|
|
|
|
max_policy_seq
|
|
|
|
|
|
|
|
|
|
|
|
last_success_run_at
|
|
|
|
|
|
|
|
|
|
|
|
last_online_verified_at
|
|
|
|
|
|
|
|
|
|
|
|
last_success_version
|
|
|
|
|
|
|
|
|
|
|
|
示例值
|
|
|
|
|
|
|
|
|
|
|
|
1024
|
|
|
|
|
|
|
|
|
|
|
|
2026-06-23T10:00:00Z
|
|
|
|
|
|
|
|
|
|
|
|
2026-06-23T09:50:00Z
|
|
|
|
|
|
|
|
|
|
|
|
1.0.0
|
|
|
|
|
|
|
|
|
|
|
|
离线时间和策略回滚判断规则：
|
|
|
|
|
|
|
|
|
|
|
|
a) max_policy_seq 只能递增，不能被旧策略覆盖。
|
|
|
|
|
|
|
|
|
|
|
|
b) 新读取的 version_policy.policy_seq 小于 max_policy_seq 时，客户
|
|
|
|
|
|
|
|
|
|
|
|
端应拒绝启动。
|
|
|
|
|
|
|
|
|
|
|
|
c) 当前系统时间早于 last_success_run_at 时，视为疑似时间回拨。
|
|
|
|
|
|
|
|
|
|
|
|
MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄 MARSCO_内部
|
|
|
|
|
|
|
|
|
|
|
|
d) 当前系统时间早于 last_online_verified_at 时，视为疑似时间回拨。
|
|
|
|
|
|
|
|
|
|
|
|
e) 离线启动时必须同时满足：策略签名正确、policy_seq 未倒退、
|
|
|
|
|
|
|
|
|
|
|
|
offline_allowed 为 true、当前时间未超过 valid_until、未检测到
|
|
|
|
|
|
|
|
|
|
|
|
明显时间回拨。
|
|
|
|
|
|
|
|
|
|
|
|
f) 联网校验成功后更新 last_online_verified_at 和本地缓存策略。
|
|
|
|
|
|
|
|
|
|
|
|
g) 每次成功启动后更新 last_success_run_at。
|
|
|
|
|
|
|
|
|
|
|
|
6 Manifest 设计
|
|
|
|
|
|
|
|
|
|
|
|
manifest 必须是当前版本的全量受控文件清单。
|
|
|
|
|
|
|
|
|
|
|
|
字段
|
|
|
|
|
|
|
|
|
|
|
|
app_id
|
|
|
|
|
|
|
|
|
|
|
|
version
|
|
|
|
|
|
|
|
|
|
|
|
channel
|
|
|
|
|
|
|
|
|
|
|
|
platform
|
|
|
|
|
|
|
|
|
|
|
|
arch
|
|
|
|
|
|
|
|
|
|
|
|
manifest_seq
|
|
|
|
|
|
|
|
|
|
|
|
created_at
|
|
|
|
|
|
|
|
|
|
|
|
files
|
|
|
|
|
|
|
|
|
|
|
|
signature
|
|
|
|
|
|
|
|
|
|
|
|
规则：
|
|
|
|
|
|
|
|
|
|
|
|
示例值
|
|
|
|
|
|
|
|
|
|
|
|
marsco_demo_app
|
|
|
|
|
|
|
|
|
|
|
|
1.0.2
|
|
|
|
|
|
|
|
|
|
|
|
stable
|
|
|
|
|
|
|
|
|
|
|
|
windows
|
|
|
|
|
|
|
|
|
|
|
|
x64
|
|
|
|
|
|
|
|
|
|
|
|
3001
|
|
|
|
|
|
|
|
|
|
|
|
2026-06-23T00:00:00Z
|
|
|
|
|
|
|
|
|
|
|
|
[{"path": "Launcher.exe", "sha256": "aaa", "size":
|
|
|
|
|
|
|
|
|
|
|
|
123456, "executable": true}, {"path": "MainApp.exe",
|
|
|
|
|
|
|
|
|
|
|
|
"sha256": "bbb", "size": 223456, "executable": true},
|
|
|
|
|
|
|
|
|
|
|
|
{"path": "Updater.exe", "sha256": "ccc", "size": 323456,
|
|
|
|
|
|
|
|
|
|
|
|
"executable": true}, {"path": "plugins/demo_plugin.dll",
|
|
|
|
|
|
|
|
|
|
|
|
"sha256": "ddd", "size": 423456, "executable": false}]
|
|
|
|
|
|
|
|
|
|
|
|
base64_signature
|
|
|
|
|
|
|
|
|
|
|
|
a) manifest 中列出的文件必须存在。
|
|
|
|
|
|
|
|
|
|
|
|
MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄 MARSCO_内部
|
|
|
|
|
|
|
|
|
|
|
|
b) manifest 中列出的文件 hash 必须一致。
|
|
|
|
|
|
|
|
|
|
|
|
c) 受控目录下未在 manifest 中出现的 exe、dll 文件应视为异常。
|
|
|
|
|
|
|
|
|
|
|
|
d) manifest 必须由服务端私钥签名。
|
|
|
|
|
|
|
|
|
|
|
|
e) 客户端使用内置公钥验证 manifest。
|
|
|
|
|
|
|
|
|
|
|
|
f) manifest 应支持版本号、通道、平台、架构。
|
|
|
|
|
|
|
|
|
|
|
|
7 启动票据设计
|
|
|
|
|
|
|
|
|
|
|
|
Launcher 启动 MainApp 时生成短期启动票据。
|
|
|
|
|
|
|
|
|
|
|
|
推荐方式：
|
|
|
|
|
|
|
|
|
|
|
|
a) Launcher 生成 ticket 文件。
|
|
|
|
|
|
|
|
|
|
|
|
b) ticket 文件存放到系统临时目录。
|
|
|
|
|
|
|
|
|
|
|
|
c) Launcher 启动 MainApp，并传入 ticket 文件路径。
|
|
|
|
|
|
|
|
|
|
|
|
d) MainApp 读取并验证 ticket。
|
|
|
|
|
|
|
|
|
|
|
|
e) MainApp 验证成功后删除 ticket 文件。
|
|
|
|
|
|
|
|
|
|
|
|
启动参数示例：
|
|
|
|
|
|
|
|
|
|
|
|
项目
|
|
|
|
|
|
|
|
|
|
|
|
启动参数
|
|
|
|
|
|
|
|
|
|
|
|
示例
|
|
|
|
|
|
|
|
|
|
|
|
MainApp.exe --ticket-
|
|
|
|
|
|
|
|
|
|
|
|
ticket 内容：
|
|
|
|
|
|
|
|
|
|
|
|
字段
|
|
|
|
|
|
|
|
|
|
|
|
payload
|
|
|
|
|
|
|
|
|
|
|
|
file=C:\Users\xxx\AppData\Local\Temp\marsco_ticket_xxx.json
|
|
|
|
|
|
|
|
|
|
|
|
示例值
|
|
|
|
|
|
|
|
|
|
|
|
{"app_id": "marsco_demo_app", "client_id":
|
|
|
|
|
|
|
|
|
|
|
|
"client_xxx", "device_id": "device_xxx", "version":
|
|
|
|
|
|
|
|
|
|
|
|
"1.0.0", "nonce": "uuid_xxx", "issued_at": "2026-06-
|
|
|
|
|
|
|
|
|
|
|
|
23T10:00:00Z", "expires_at": "2026-06-23T10:01:00Z"}
|
|
|
|
|
|
|
|
|
|
|
|
signature
|
|
|
|
|
|
|
|
|
|
|
|
base64_signature
|
|
|
|
|
|
|
|
|
|
|
|
校验规则：
|
|
|
|
|
|
|
|
|
|
|
|
a) 签名正确。
|
|
|
|
|
|
|
|
|
|
|
|
MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄 MARSCO_内部
|
|
|
|
|
|
|
|
|
|
|
|
b) 未过期。
|
|
|
|
|
|
|
|
|
|
|
|
c) app_id 一致。
|
|
|
|
|
|
|
|
|
|
|
|
d) client_id 一致。
|
|
|
|
|
|
|
|
|
|
|
|
e) device_id 一致。
|
|
|
|
|
|
|
|
|
|
|
|
f) version 一致。
|
|
|
|
|
|
|
|
|
|
|
|
g) nonce 未重复使用。
|
|
|
|
|
|
|
|
|
|
|
|
Demo 阶段可由 Launcher 生成本地签名票据。正式阶段需要区分
|
|
|
|
|
|
|
|
|
|
|
|
启动票据和服务端版本策略，真正的版本准入仍以服务端签名策略为
|
|
|
|
|
|
|
|
|
|
|
|
准。
|
|
|
|
|
|
|
|
|
|
|
|
启动票据安全边界：
|
|
|
|
|
|
|
|
|
|
|
|
a) 启动票据只用于防止普通用户直接双击 MainApp 绕过 Launcher。
|
|
|
|
|
|
|
|
|
|
|
|
b) 启动票据不能替代 version_policy、manifest 和 client_identity 的
|
|
|
|
|
|
|
|
|
|
|
|
服务端签名校验。
|
|
|
|
|
|
|
|
|
|
|
|
c) 客户端不得保存服务端私钥。
|
|
|
|
|
|
|
|
|
|
|
|
d) Demo 阶段的本地票据签名密钥只用于本机进程间启动校验，不
|
|
|
|
|
|
|
|
|
|
|
|
用于签发版本策略、manifest 或设备身份。
|
|
|
|
|
|
|
|
|
|
|
|
e) 即使启动票据校验通过，MainApp 仍必须验证本地版本策略签名、
|
|
|
|
|
|
|
|
|
|
|
|
有效期、版本号和核心文件 hash。
|
|
|
|
|
|
|
|
|
|
|
|
8 客户端启动逻辑
|
|
|
|
|
|
|
|
|
|
|
|
MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄 8.1 Launcher 启动逻辑
|
|
|
|
|
|
|
|
|
|
|
|
MARSCO_内部
|
|
|
|
|
|
|
|
|
|
|
|
图 1 Launcher 启动准入流程
|
|
|
|
|
|
|
|
|
|
|
|
流程步骤：
|
|
|
|
|
|
|
|
|
|
|
|
步骤
|
|
|
|
|
|
|
|
|
|
|
|
1
|
|
|
|
|
|
|
|
|
|
|
|
2
|
|
|
|
|
|
|
|
|
|
|
|
判断或处理
|
|
|
|
|
|
|
|
|
|
|
|
结果
|
|
|
|
|
|
|
|
|
|
|
|
启动 Launcher，读取
|
|
|
|
|
|
|
|
|
|
|
|
获得本地配置和设备身份
|
|
|
|
|
|
|
|
|
|
|
|
app_config 和 client_identity
|
|
|
|
|
|
|
|
|
|
|
|
验证 client_identity 签名
|
|
|
|
|
|
|
|
|
|
|
|
身份无效时拒绝继续
|
|
|
|
|
|
|
|
|
|
|
|
MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄
|
|
|
|
|
|
3
|
|
|
|
|
|
|
|
|
|
|
|
4
|
|
|
|
|
|
|
|
|
|
|
|
5
|
|
|
|
|
|
|
|
|
|
|
|
6
|
|
|
|
|
|
|
|
|
|
|
|
7
|
|
|
|
|
|
|
|
|
|
|
|
8
|
|
|
|
|
|
|
|
|
|
|
|
9
|
|
|
|
|
|
|
|
|
|
|
|
MARSCO_内部
|
|
|
|
|
|
|
|
|
|
|
|
尝试请求 /update/check
|
|
|
|
|
|
|
|
|
|
|
|
联网成功时进入在线策略校验
|
|
|
|
|
|
|
|
|
|
|
|
验证服务端返回策略签名，更新
|
|
|
|
|
|
|
|
|
|
|
|
获得最新运行策略
|
|
|
|
|
|
|
|
|
|
|
|
version_policy
|
|
|
|
|
|
|
|
|
|
|
|
联网失败时读取本地
|
|
|
|
|
|
|
|
|
|
|
|
进入离线策略校验
|
|
|
|
|
|
|
|
|
|
|
|
version_policy
|
|
|
|
|
|
|
|
|
|
|
|
验证本地策略签名、
|
|
|
|
|
|
|
|
|
|
|
|
离线策略无效时拒绝启动
|
|
|
|
|
|
|
|
|
|
|
|
valid_until、offline_allowed
|
|
|
|
|
|
|
|
|
|
|
|
检查本地核心文件 hash
|
|
|
|
|
|
|
|
|
|
|
|
核心文件异常时进入更新或提示
|
|
|
|
|
|
|
|
|
|
|
|
判断是否允许运行
|
|
|
|
|
|
|
|
|
|
|
|
允许时生成启动票据并启动
|
|
|
|
|
|
|
|
|
|
|
|
MainApp
|
|
|
|
|
|
|
|
|
|
|
|
不允许运行或强制升级
|
|
|
|
|
|
|
|
|
|
|
|
启动 Updater 或提示用户更新
|
|
|
|
|
|
|
|
|
|
|
|
MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄 8.2 MainApp 启动逻辑
|
|
|
|
|
|
|
|
|
|
|
|
MARSCO_内部
|
|
|
|
|
|
|
|
|
|
|
|
图 2 MainApp 启动校验流程
|
|
|
|
|
|
|
|
|
|
|
|
流程步骤：
|
|
|
|
|
|
|
|
|
|
|
|
步骤
|
|
|
|
|
|
|
|
|
|
|
|
判断或处理
|
|
|
|
|
|
|
|
|
|
|
|
结果
|
|
|
|
|
|
|
|
|
|
|
|
1
|
|
|
|
|
|
|
|
|
|
|
|
2
|
|
|
|
|
|
|
|
|
|
|
|
3
|
|
|
|
|
|
|
|
|
|
|
|
启动 MainApp，检查启动参数中
|
|
|
|
|
|
|
|
|
|
|
|
无票据时提示通过启动器启动并
|
|
|
|
|
|
|
|
|
|
|
|
是否存在 ticket-file
|
|
|
|
|
|
|
|
|
|
|
|
退出
|
|
|
|
|
|
|
|
|
|
|
|
读取 ticket
|
|
|
|
|
|
|
|
|
|
|
|
获得启动票据内容
|
|
|
|
|
|
|
|
|
|
|
|
验证 ticket 签名和有效期
|
|
|
|
|
|
|
|
|
|
|
|
票据无效时拒绝启动
|
|
|
|
|
|
|
|
|
|
|
|
MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄
|
|
|
|
|
|
4
|
|
|
|
|
|
|
|
|
|
|
|
5
|
|
|
|
|
|
|
|
|
|
|
|
6
|
|
|
|
|
|
|
|
|
|
|
|
7
|
|
|
|
|
|
|
|
|
|
|
|
8
|
|
|
|
|
|
|
|
|
|
|
|
MARSCO_内部
|
|
|
|
|
|
|
|
|
|
|
|
验证 version_policy
|
|
|
|
|
|
|
|
|
|
|
|
策略无效时拒绝启动
|
|
|
|
|
|
|
|
|
|
|
|
验证当前版本是否允许运行
|
|
|
|
|
|
|
|
|
|
|
|
禁用版本或过期策略进入拦截
|
|
|
|
|
|
|
|
|
|
|
|
验证核心 DLL hash
|
|
|
|
|
|
|
|
|
|
|
|
核心文件异常时拒绝启动
|
|
|
|
|
|
|
|
|
|
|
|
校验通过
|
|
|
|
|
|
|
|
|
|
|
|
进入主界面
|
|
|
|
|
|
|
|
|
|
|
|
主界面运行期间
|
|
|
|
|
|
|
|
|
|
|
|
启动定时器，定期检查更新
|
|
|
|
|
|
|
|
|
|
|
|
MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄 MARSCO_内部
|
|
|
|
|
|
|
|
|
|
|
|
8.3 Updater 升级逻辑
|
|
|
|
|
|
|
|
|
|
|
|
图 3 Updater 升级与回滚流程
|
|
|
|
|
|
|
|
|
|
|
|
流程步骤：
|
|
|
|
|
|
|
|
|
|
|
|
步骤
|
|
|
|
|
|
|
|
|
|
|
|
1
|
|
|
|
|
|
|
|
|
|
|
|
判断或处理
|
|
|
|
|
|
|
|
|
|
|
|
结果
|
|
|
|
|
|
|
|
|
|
|
|
启动 Updater，读取升级参数
|
|
|
|
|
|
|
|
|
|
|
|
获得目标版本和升级上下文
|
|
|
|
|
|
|
|
|
|
|
|
MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄
|
|
|
|
|
|
|
|
|
|
|
|
2
|
|
|
|
|
|
|
|
|
|
|
|
3
|
|
|
|
|
|
|
|
|
|
|
|
4
|
|
|
|
|
|
|
|
|
|
|
|
5
|
|
|
|
|
|
|
|
|
|
|
|
6
|
|
|
|
|
|
|
|
|
|
|
|
7
|
|
|
|
|
|
|
|
|
|
|
|
8
|
|
|
|
|
|
|
|
|
|
|
|
9
|
|
|
|
|
|
|
|
|
|
|
|
10
|
|
|
|
|
|
|
|
|
|
|
|
11
|
|
|
|
|
|
9 REST API 设计
|
|
|
|
|
|
9.1 检查更新接口
|
|
|
|
|
|
|
|
|
|
|
|
方法
|
|
|
|
|
|
|
|
|
|
|
|
POST
|
|
|
|
|
|
|
|
|
|
|
|
接口：
|
|
|
|
|
|
|
|
|
|
|
|
请求：
|
|
|
|
|
|
|
|
|
|
|
|
字段
|
|
|
|
|
|
|
|
|
|
|
|
app_id
|
|
|
|
|
|
|
|
|
|
|
|
client_id
|
|
|
|
|
|
|
|
|
|
|
|
device_id
|
|
|
|
|
|
|
|
|
|
|
|
MARSCO_内部
|
|
|
|
|
|
|
|
|
|
|
|
请求 /update/check，获取目标
|
|
|
|
|
|
|
|
|
|
|
|
获得版本清单
|
|
|
|
|
|
|
|
|
|
|
|
版本 manifest
|
|
|
|
|
|
|
|
|
|
|
|
验证 manifest 签名
|
|
|
|
|
|
|
|
|
|
|
|
签名无效时停止升级
|
|
|
|
|
|
|
|
|
|
|
|
扫描本地文件并对比 manifest
|
|
|
|
|
|
|
|
|
|
|
|
生成待下载文件列表
|
|
|
|
|
|
|
|
|
|
|
|
全量 hash
|
|
|
|
|
|
|
|
|
|
|
|
请求临时下载 URL
|
|
|
|
|
|
|
|
|
|
|
|
获得短期下载地址
|
|
|
|
|
|
|
|
|
|
|
|
下载文件到 staging 并校验
|
|
|
|
|
|
|
|
|
|
|
|
下载文件可用于替换
|
|
|
|
|
|
|
|
|
|
|
|
hash
|
|
|
|
|
|
|
|
|
|
|
|
通知 MainApp 退出并等待完全退
|
|
|
|
|
|
|
|
|
|
|
|
进入文件替换窗口
|
|
|
|
|
|
|
|
|
|
|
|
出
|
|
|
|
|
|
|
|
|
|
|
|
备份旧文件到 backup
|
|
|
|
|
|
|
|
|
|
|
|
形成可回滚状态
|
|
|
|
|
|
|
|
|
|
|
|
替换新文件并执行安装后全量校
|
|
|
|
|
|
|
|
|
|
|
|
校验通过后启动 MainApp
|
|
|
|
|
|
|
|
|
|
|
|
验
|
|
|
|
|
|
|
|
|
|
|
|
上报升级成功
|
|
|
|
|
|
|
|
|
|
|
|
任一步骤失败
|
|
|
|
|
|
|
|
|
|
|
|
服务端记录升级结果
|
|
|
|
|
|
|
|
|
|
|
|
执行回滚并上报失败原因
|
|
|
|
|
|
|
|
|
|
|
|
路径
|
|
|
|
|
|
|
|
|
|
|
|
/api/v1/update/check
|
|
|
|
|
|
|
|
|
|
|
|
示例值
|
|
|
|
|
|
|
|
|
|
|
|
marsco_demo_app
|
|
|
|
|
|
|
|
|
|
|
|
client_xxx
|
|
|
|
|
|
|
|
|
|
|
|
device_xxx
|
|
|
|
|
|
|
|
|
|
|
|
MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄 license_id
|
|
|
|
|
|
|
|
|
|
|
|
current_version
|
|
|
|
|
|
|
|
|
|
|
|
target_version
|
|
|
|
|
|
|
|
|
|
|
|
channel
|
|
|
|
|
|
|
|
|
|
|
|
platform
|
|
|
|
|
|
|
|
|
|
|
|
arch
|
|
|
|
|
|
|
|
|
|
|
|
operation
|
|
|
|
|
|
|
|
|
|
|
|
返回：
|
|
|
|
|
|
|
|
|
|
|
|
字段
|
|
|
|
|
|
|
|
|
|
|
|
allow_run
|
|
|
|
|
|
|
|
|
|
|
|
action
|
|
|
|
|
|
|
|
|
|
|
|
message
|
|
|
|
|
|
|
|
|
|
|
|
current_version
|
|
|
|
|
|
|
|
|
|
|
|
latest_version
|
|
|
|
|
|
|
|
|
|
|
|
channel
|
|
|
|
|
|
|
|
|
|
|
|
force_update
|
|
|
|
|
|
|
|
|
|
|
|
allow_rollback
|
|
|
|
|
|
|
|
|
|
|
|
policy_seq
|
|
|
|
|
|
|
|
|
|
|
|
MARSCO_内部
|
|
|
|
|
|
|
|
|
|
|
|
license_xxx
|
|
|
|
|
|
|
|
|
|
|
|
1.0.0
|
|
|
|
|
|
|
|
|
|
|
|
stable
|
|
|
|
|
|
|
|
|
|
|
|
windows
|
|
|
|
|
|
|
|
|
|
|
|
x64
|
|
|
|
|
|
|
|
|
|
|
|
check
|
|
|
|
|
|
|
|
|
|
|
|
示例值
|
|
|
|
|
|
|
|
|
|
|
|
True
|
|
|
|
|
|
|
|
|
|
|
|
optional_update
|
|
|
|
|
|
|
|
|
|
|
|
发现新版本
|
|
|
|
|
|
|
|
|
|
|
|
1.0.0
|
|
|
|
|
|
|
|
|
|
|
|
1.0.2
|
|
|
|
|
|
|
|
|
|
|
|
stable
|
|
|
|
|
|
|
|
|
|
|
|
False
|
|
|
|
|
|
|
|
|
|
|
|
False
|
|
|
|
|
|
|
|
|
|
|
|
1025
|
|
|
|
|
|
|
|
|
|
|
|
policy_valid_until
|
|
|
|
|
|
|
|
|
|
|
|
2026-07-23T00:00:00Z
|
|
|
|
|
|
|
|
|
|
|
|
manifest_xxx
|
|
|
|
|
|
|
|
|
|
|
|
https://download.example.com/xxx
|
|
|
|
|
|
|
|
|
|
|
|
base64_signature
|
|
|
|
|
|
|
|
|
|
|
|
manifest_id
|
|
|
|
|
|
|
|
|
|
|
|
manifest_url
|
|
|
|
|
|
|
|
|
|
|
|
signature
|
|
|
|
|
|
|
|
|
|
|
|
action 可选值：
|
|
|
|
|
|
|
|
|
|
|
|
字段/取值
|
|
|
|
|
|
|
|
|
|
|
|
allow
|
|
|
|
|
|
|
|
|
|
|
|
MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄
|
|
|
|
|
|
MARSCO_内部
|
|
|
|
|
|
|
|
|
|
|
|
optional_update
|
|
|
|
|
|
|
|
|
|
|
|
force_update
|
|
|
|
|
|
|
|
|
|
|
|
blocked
|
|
|
|
|
|
|
|
|
|
|
|
rollback_allowed
|
|
|
|
|
|
|
|
|
|
|
|
rollback_denied
|
|
|
|
|
|
|
|
|
|
|
|
license_invalid
|
|
|
|
|
|
|
|
|
|
|
|
device_invalid
|
|
|
|
|
|
|
|
|
|
|
|
policy_expired
|
|
|
|
|
|
|
|
|
|
|
|
operation 可选值：
|
|
|
|
|
|
|
|
|
|
|
|
字段/取值
|
|
|
|
|
|
|
|
|
|
|
|
check
|
|
|
|
|
|
|
|
|
|
|
|
upgrade
|
|
|
|
|
|
|
|
|
|
|
|
downgrade
|
|
|
|
|
|
|
|
|
|
|
|
当 operation 为 downgrade 时，客户端必须传入 target_version。服务
|
|
|
|
|
|
|
|
|
|
|
|
端需要判断目标版本是否存在、是否属于当前通道、是否允许降级、
|
|
|
|
|
|
|
|
|
|
|
|
是否满足最低支持版本和数据兼容规则。
|
|
|
|
|
|
|
|
|
|
|
|
降级检查返回示例：
|
|
|
|
|
|
|
|
|
|
|
|
字段
|
|
|
|
|
|
|
|
|
|
|
|
allow_run
|
|
|
|
|
|
|
|
|
|
|
|
action
|
|
|
|
|
|
|
|
|
|
|
|
message
|
|
|
|
|
|
|
|
|
|
|
|
current_version
|
|
|
|
|
|
|
|
|
|
|
|
latest_version
|
|
|
|
|
|
|
|
|
|
|
|
target_version
|
|
|
|
|
|
|
|
|
|
|
|
channel
|
|
|
|
|
|
|
|
|
|
|
|
示例值
|
|
|
|
|
|
|
|
|
|
|
|
True
|
|
|
|
|
|
|
|
|
|
|
|
rollback_allowed
|
|
|
|
|
|
|
|
|
|
|
|
允许降级到 1.0.0
|
|
|
|
|
|
|
|
|
|
|
|
1.0.2
|
|
|
|
|
|
|
|
|
|
|
|
1.0.2
|
|
|
|
|
|
|
|
|
|
|
|
1.0.0
|
|
|
|
|
|
|
|
|
|
|
|
stable
|
|
|
|
|
|
|
|
|
|
|
|
MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄 force_update
|
|
|
|
|
|
|
|
|
|
|
|
allow_rollback
|
|
|
|
|
|
|
|
|
|
|
|
policy_seq
|
|
|
|
|
|
|
|
|
|
|
|
MARSCO_内部
|
|
|
|
|
|
|
|
|
|
|
|
False
|
|
|
|
|
|
|
|
|
|
|
|
True
|
|
|
|
|
|
|
|
|
|
|
|
1030
|
|
|
|
|
|
|
|
|
|
|
|
policy_valid_until
|
|
|
|
|
|
|
|
|
|
|
|
2026-07-23T00:00:00Z
|
|
|
|
|
|
|
|
|
|
|
|
manifest_id
|
|
|
|
|
|
|
|
|
|
|
|
manifest_url
|
|
|
|
|
|
|
|
|
|
|
|
manifest_1_0_0
|
|
|
|
|
|
|
|
|
|
|
|
https://download.example.com/manifest-1.0.0.json
|
|
|
|
|
|
|
|
|
|
|
|
signature
|
|
|
|
|
|
9.2 获取下载链接接口
|
|
|
|
|
|
|
|
|
|
|
|
base64_signature
|
|
|
|
|
|
|
|
|
|
|
|
方法
|
|
|
|
|
|
|
|
|
|
|
|
POST
|
|
|
|
|
|
|
|
|
|
|
|
接口：
|
|
|
|
|
|
|
|
|
|
|
|
请求：
|
|
|
|
|
|
|
|
|
|
|
|
字段
|
|
|
|
|
|
|
|
|
|
|
|
app_id
|
|
|
|
|
|
|
|
|
|
|
|
client_id
|
|
|
|
|
|
|
|
|
|
|
|
device_id
|
|
|
|
|
|
|
|
|
|
|
|
license_id
|
|
|
|
|
|
|
|
|
|
|
|
version
|
|
|
|
|
|
|
|
|
|
|
|
channel
|
|
|
|
|
|
|
|
|
|
|
|
files
|
|
|
|
|
|
|
|
|
|
|
|
返回：
|
|
|
|
|
|
|
|
|
|
|
|
字段
|
|
|
|
|
|
|
|
|
|
|
|
expires_in
|
|
|
|
|
|
|
|
|
|
|
|
files
|
|
|
|
|
|
|
|
|
|
|
|
路径
|
|
|
|
|
|
|
|
|
|
|
|
/api/v1/update/download-url
|
|
|
|
|
|
|
|
|
|
|
|
示例值
|
|
|
|
|
|
|
|
|
|
|
|
marsco_demo_app
|
|
|
|
|
|
|
|
|
|
|
|
client_xxx
|
|
|
|
|
|
|
|
|
|
|
|
device_xxx
|
|
|
|
|
|
|
|
|
|
|
|
license_xxx
|
|
|
|
|
|
|
|
|
|
|
|
1.0.2
|
|
|
|
|
|
|
|
|
|
|
|
stable
|
|
|
|
|
|
|
|
|
|
|
|
["MainApp.exe", "plugins/demo_plugin.dll"]
|
|
|
|
|
|
|
|
|
|
|
|
示例值
|
|
|
|
|
|
|
|
|
|
|
|
600
|
|
|
|
|
|
|
|
|
|
|
|
[{"path": "MainApp.exe", "url":
|
|
|
|
|
|
|
|
|
|
|
|
"https://oss.example.com/temp-url-1", "sha256":
|
|
|
|
|
|
|
|
|
|
|
|
MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄 MARSCO_内部
|
|
|
|
|
|
|
|
|
|
|
|
"bbb", "size": 223456}, {"path":
|
|
|
|
|
|
|
|
|
|
|
|
"plugins/demo_plugin.dll", "url":
|
|
|
|
|
|
|
|
|
|
|
|
"https://oss.example.com/temp-url-2", "sha256":
|
|
|
|
|
|
|
|
|
|
|
|
"ddd", "size": 423456}]
|
|
|
|
|
|
|
|
|
|
|
|
9.3 升级结果上报接口
|
|
|
|
|
|
|
|
|
|
|
|
方法
|
|
|
|
|
|
|
|
|
|
|
|
POST
|
|
|
|
|
|
|
|
|
|
|
|
接口：
|
|
|
|
|
|
|
|
|
|
|
|
请求：
|
|
|
|
|
|
|
|
|
|
|
|
字段
|
|
|
|
|
|
|
|
|
|
|
|
app_id
|
|
|
|
|
|
|
|
|
|
|
|
client_id
|
|
|
|
|
|
|
|
|
|
|
|
device_id
|
|
|
|
|
|
|
|
|
|
|
|
license_id
|
|
|
|
|
|
|
|
|
|
|
|
from_version
|
|
|
|
|
|
|
|
|
|
|
|
to_version
|
|
|
|
|
|
|
|
|
|
|
|
channel
|
|
|
|
|
|
|
|
|
|
|
|
result
|
|
|
|
|
|
|
|
|
|
|
|
error_code
|
|
|
|
|
|
|
|
|
|
|
|
message
|
|
|
|
|
|
|
|
|
|
|
|
started_at
|
|
|
|
|
|
|
|
|
|
|
|
finished_at
|
|
|
|
|
|
|
|
|
|
|
|
result 可选：
|
|
|
|
|
|
|
|
|
|
|
|
字段/取值
|
|
|
|
|
|
|
|
|
|
|
|
success
|
|
|
|
|
|
|
|
|
|
|
|
路径
|
|
|
|
|
|
|
|
|
|
|
|
/api/v1/update/report
|
|
|
|
|
|
|
|
|
|
|
|
示例值
|
|
|
|
|
|
|
|
|
|
|
|
marsco_demo_app
|
|
|
|
|
|
|
|
|
|
|
|
client_xxx
|
|
|
|
|
|
|
|
|
|
|
|
device_xxx
|
|
|
|
|
|
|
|
|
|
|
|
license_xxx
|
|
|
|
|
|
|
|
|
|
|
|
1.0.0
|
|
|
|
|
|
|
|
|
|
|
|
1.0.2
|
|
|
|
|
|
|
|
|
|
|
|
stable
|
|
|
|
|
|
|
|
|
|
|
|
success
|
|
|
|
|
|
|
|
|
|
|
|
upgrade success
|
|
|
|
|
|
|
|
|
|
|
|
2026-06-23T10:00:00Z
|
|
|
|
|
|
|
|
|
|
|
|
2026-06-23T10:05:00Z
|
|
|
|
|
|
|
|
|
|
|
|
MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄
|
|
|
|
|
|
MARSCO_内部
|
|
|
|
|
|
|
|
|
|
|
|
download_failed
|
|
|
|
|
|
|
|
|
|
|
|
hash_failed
|
|
|
|
|
|
|
|
|
|
|
|
signature_failed
|
|
|
|
|
|
|
|
|
|
|
|
replace_failed
|
|
|
|
|
|
|
|
|
|
|
|
rollback_success
|
|
|
|
|
|
|
|
|
|
|
|
rollback_failed
|
|
|
|
|
|
|
|
|
|
|
|
permission_failed
|
|
|
|
|
|
|
|
|
|
|
|
disk_space_not_enough
|
|
|
|
|
|
|
|
|
|
|
|
mainapp_restart_failed
|
|
|
|
|
|
9.4 设备身份签发接口（非用户登录）
|
|
|
|
|
|
|
|
|
|
|
|
该接口用于首次签发或刷新设备身份凭证，不是客户端用户登录
|
|
|
|
|
|
|
|
|
|
|
|
接口。
|
|
|
|
|
|
|
|
|
|
|
|
Demo 阶 段 可 不 暴 露 该 接 口 ， 由 测 试 数 据 或 预 置 文 件 生 成
|
|
|
|
|
|
|
|
|
|
|
|
client_identity.dat。正式阶段如需启用，也应定位为设备激活/身份签
|
|
|
|
|
|
|
|
|
|
|
|
发能力，而不是用户名密码登录。
|
|
|
|
|
|
|
|
|
|
|
|
接口：
|
|
|
|
|
|
|
|
|
|
|
|
方法
|
|
|
|
|
|
|
|
|
|
|
|
POST
|
|
|
|
|
|
|
|
|
|
|
|
请求：
|
|
|
|
|
|
|
|
|
|
|
|
字段
|
|
|
|
|
|
|
|
|
|
|
|
app_id
|
|
|
|
|
|
|
|
|
|
|
|
activation_code
|
|
|
|
|
|
|
|
|
|
|
|
device_fingerprint
|
|
|
|
|
|
|
|
|
|
|
|
platform
|
|
|
|
|
|
|
|
|
|
|
|
arch
|
|
|
|
|
|
|
|
|
|
|
|
路径
|
|
|
|
|
|
|
|
|
|
|
|
/api/v1/device/activate
|
|
|
|
|
|
|
|
|
|
|
|
示例值
|
|
|
|
|
|
|
|
|
|
|
|
marsco_demo_app
|
|
|
|
|
|
|
|
|
|
|
|
XXXX-XXXX-XXXX
|
|
|
|
|
|
|
|
|
|
|
|
device_hash_xxx
|
|
|
|
|
|
|
|
|
|
|
|
windows
|
|
|
|
|
|
|
|
|
|
|
|
x64
|
|
|
|
|
|
|
|
|
|
|
|
MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄 返回：
|
|
|
|
|
|
|
|
|
|
|
|
字段
|
|
|
|
|
|
|
|
|
|
|
|
client_id
|
|
|
|
|
|
|
|
|
|
|
|
device_id
|
|
|
|
|
|
|
|
|
|
|
|
license_id
|
|
|
|
|
|
|
|
|
|
|
|
channel
|
|
|
|
|
|
|
|
|
|
|
|
identity_token
|
|
|
|
|
|
|
|
|
|
|
|
MARSCO_内部
|
|
|
|
|
|
|
|
|
|
|
|
示例值
|
|
|
|
|
|
|
|
|
|
|
|
client_xxx
|
|
|
|
|
|
|
|
|
|
|
|
device_xxx
|
|
|
|
|
|
|
|
|
|
|
|
license_xxx
|
|
|
|
|
|
|
|
|
|
|
|
stable
|
|
|
|
|
|
|
|
|
|
|
|
{"valid_until": "2026-12-31T00:00:00Z", "signature":
|
|
|
|
|
|
|
|
|
|
|
|
"base64_signature"}
|
|
|
|
|
|
|
|
|
|
|
|
Demo 阶段可以简化为预置 client_id，不做复杂激活流程。
|
|
|
|
|
|
|
|
|
|
|
|
9.5 管理后台管理员登录接口（非本期普通客户端用户登录）
|
|
|
|
|
|
|
|
|
|
|
|
该接口仅用于管理后台管理员登录，与本期普通客户端用户无关。
|
|
|
|
|
|
|
|
|
|
|
|
普通客户端用户在本期客户端不登录，不调用该接口，也不持有该接
|
|
|
|
|
|
|
|
|
|
|
|
口返回的后台访问令牌。
|
|
|
|
|
|
|
|
|
|
|
|
后续如增加普通用户登录，应单独设计客户端用户登录接口、用
|
|
|
|
|
|
|
|
|
|
|
|
户授权模型和用户权限校验逻辑，不复用管理后台管理员登录接口。
|
|
|
|
|
|
|
|
|
|
|
|
Demo 阶段可使用单管理员账号。正式阶段可扩展为多管理员、角
|
|
|
|
|
|
|
|
|
|
|
|
色权限、双因素认证或企业单点登录。
|
|
|
|
|
|
|
|
|
|
|
|
方法
|
|
|
|
|
|
|
|
|
|
|
|
POST
|
|
|
|
|
|
|
|
|
|
|
|
接口：
|
|
|
|
|
|
|
|
|
|
|
|
请求：
|
|
|
|
|
|
|
|
|
|
|
|
字段
|
|
|
|
|
|
|
|
|
|
|
|
username
|
|
|
|
|
|
|
|
|
|
|
|
password
|
|
|
|
|
|
|
|
|
|
|
|
返回：
|
|
|
|
|
|
|
|
|
|
|
|
路径
|
|
|
|
|
|
|
|
|
|
|
|
/api/v1/admin/login
|
|
|
|
|
|
|
|
|
|
|
|
示例值
|
|
|
|
|
|
|
|
|
|
|
|
admin
|
|
|
|
|
|
|
|
|
|
|
|
password
|
|
|
|
|
|
|
|
|
|
|
|
MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄 MARSCO_内部
|
|
|
|
|
|
|
|
|
|
|
|
示例值
|
|
|
|
|
|
|
|
|
|
|
|
jwt_or_session_token
|
|
|
|
|
|
|
|
|
|
|
|
Bearer
|
|
|
|
|
|
|
|
|
|
|
|
7200
|
|
|
|
|
|
|
|
|
|
|
|
字段
|
|
|
|
|
|
|
|
|
|
|
|
access_token
|
|
|
|
|
|
|
|
|
|
|
|
token_type
|
|
|
|
|
|
|
|
|
|
|
|
expires_in
|
|
|
|
|
|
|
|
|
|
|
|
要求：
|
|
|
|
|
|
|
|
|
|
|
|
a) 密码不得明文存储。
|
|
|
|
|
|
|
|
|
|
|
|
b) 登录失败应记录审计日志。
|
|
|
|
|
|
|
|
|
|
|
|
c) 管理后台接口必须校验管理员 token。
|
|
|
|
|
|
|
|
|
|
|
|
d) Demo 阶段可不实现复杂角色权限，但必须区分未登录和已登录
|
|
|
|
|
|
|
|
|
|
|
|
管理员；该状态只存在于管理后台，不存在于本期普通客户端。
|
|
|
|
|
|
|
|
|
|
|
|
9.6 管理后台接口摘要
|
|
|
|
|
|
|
|
|
|
|
|
第一版 Demo 至少需要以下后台接口：
|
|
|
|
|
|
|
|
|
|
|
|
方法
|
|
|
|
|
|
|
|
|
|
|
|
POST
|
|
|
|
|
|
|
|
|
|
|
|
POST
|
|
|
|
|
|
|
|
|
|
|
|
POST
|
|
|
|
|
|
|
|
|
|
|
|
POST
|
|
|
|
|
|
|
|
|
|
|
|
POST
|
|
|
|
|
|
|
|
|
|
|
|
POST
|
|
|
|
|
|
|
|
|
|
|
|
POST
|
|
|
|
|
|
|
|
|
|
|
|
POST
|
|
|
|
|
|
|
|
|
|
|
|
POST
|
|
|
|
|
|
|
|
|
|
|
|
GET
|
|
|
|
|
|
|
|
|
|
|
|
GET
|
|
|
|
|
|
|
|
|
|
|
|
GET
|
|
|
|
|
|
|
|
|
|
|
|
路径
|
|
|
|
|
|
|
|
|
|
|
|
/api/v1/admin/apps
|
|
|
|
|
|
|
|
|
|
|
|
/api/v1/admin/channels
|
|
|
|
|
|
|
|
|
|
|
|
/api/v1/admin/versions
|
|
|
|
|
|
|
|
|
|
|
|
/api/v1/admin/versions/{version_id}/files
|
|
|
|
|
|
|
|
|
|
|
|
/api/v1/admin/versions/{version_id}/publish
|
|
|
|
|
|
|
|
|
|
|
|
/api/v1/admin/policies
|
|
|
|
|
|
|
|
|
|
|
|
/api/v1/admin/policies/{policy_id}/force-update
|
|
|
|
|
|
|
|
|
|
|
|
/api/v1/admin/policies/{policy_id}/block
|
|
|
|
|
|
|
|
|
|
|
|
/api/v1/admin/policies/{policy_id}/rollback
|
|
|
|
|
|
|
|
|
|
|
|
/api/v1/admin/download-logs
|
|
|
|
|
|
|
|
|
|
|
|
/api/v1/admin/upgrade-logs
|
|
|
|
|
|
|
|
|
|
|
|
/api/v1/admin/audit-logs
|
|
|
|
|
|
|
|
|
|
|
|
MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄 MARSCO_内部
|
|
|
|
|
|
|
|
|
|
|
|
后台接口规则：
|
|
|
|
|
|
|
|
|
|
|
|
a) 所有后台接口都需要管理员 token。
|
|
|
|
|
|
|
|
|
|
|
|
b) 发布版本时生成 manifest、计算文件 hash 并写入版本文件表。
|
|
|
|
|
|
|
|
|
|
|
|
c) 修改强制升级、禁用、降级策略时必须生成新的 policy_seq。
|
|
|
|
|
|
|
|
|
|
|
|
d) 每次关键操作必须写入管理员操作记录。
|
|
|
|
|
|
|
|
|
|
|
|
e) Demo 阶段可使用简化管理页面或 API 调试页面完成后台操作。
|
|
|
|
|
|
|
|
|
|
|
|
10 数据库设计
|
|
|
|
|
|
10.1 应用表 apps
|
|
|
|
|
|
|
|
|
|
|
|
字段：
|
|
|
|
|
|
|
|
|
|
|
|
字段/取值
|
|
|
|
|
|
|
|
|
|
|
|
id
|
|
|
|
|
|
|
|
|
|
|
|
app_id
|
|
|
|
|
|
|
|
|
|
|
|
app_name
|
|
|
|
|
|
|
|
|
|
|
|
description
|
|
|
|
|
|
|
|
|
|
|
|
created_at
|
|
|
|
|
|
|
|
|
|
|
|
updated_at
|
|
|
|
|
|
10.2 版本通道表 channels
|
|
|
|
|
|
|
|
|
|
|
|
字段：
|
|
|
|
|
|
|
|
|
|
|
|
字段/取值
|
|
|
|
|
|
|
|
|
|
|
|
id
|
|
|
|
|
|
|
|
|
|
|
|
app_id
|
|
|
|
|
|
|
|
|
|
|
|
channel_code
|
|
|
|
|
|
|
|
|
|
|
|
channel_name
|
|
|
|
|
|
|
|
|
|
|
|
enabled
|
|
|
|
|
|
|
|
|
|
|
|
created_at
|
|
|
|
|
|
|
|
|
|
|
|
MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄 MARSCO_内部
|
|
|
|
|
|
|
|
|
|
|
|
updated_at
|
|
|
|
|
|
|
|
|
|
|
|
示例：
|
|
|
|
|
|
|
|
|
|
|
|
字段/取值
|
|
|
|
|
|
|
|
|
|
|
|
stable / 正式版
|
|
|
|
|
|
|
|
|
|
|
|
preview / 预览版
|
|
|
|
|
|
|
|
|
|
|
|
internal / 内测版
|
|
|
|
|
|
|
|
|
|
|
|
customer_a / 客户专版
|
|
|
|
|
|
10.3 版本表 versions
|
|
|
|
|
|
|
|
|
|
|
|
字段：
|
|
|
|
|
|
|
|
|
|
|
|
字段/取值
|
|
|
|
|
|
|
|
|
|
|
|
id
|
|
|
|
|
|
|
|
|
|
|
|
app_id
|
|
|
|
|
|
|
|
|
|
|
|
channel_code
|
|
|
|
|
|
|
|
|
|
|
|
version
|
|
|
|
|
|
|
|
|
|
|
|
version_name
|
|
|
|
|
|
|
|
|
|
|
|
status
|
|
|
|
|
|
|
|
|
|
|
|
is_latest
|
|
|
|
|
|
|
|
|
|
|
|
release_notes
|
|
|
|
|
|
|
|
|
|
|
|
offline_allowed
|
|
|
|
|
|
|
|
|
|
|
|
offline_valid_days
|
|
|
|
|
|
|
|
|
|
|
|
allow_rollback
|
|
|
|
|
|
|
|
|
|
|
|
rollback_targets
|
|
|
|
|
|
|
|
|
|
|
|
force_update
|
|
|
|
|
|
|
|
|
|
|
|
created_at
|
|
|
|
|
|
|
|
|
|
|
|
published_at
|
|
|
|
|
|
|
|
|
|
|
|
MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄 MARSCO_内部
|
|
|
|
|
|
|
|
|
|
|
|
updated_at
|
|
|
|
|
|
|
|
|
|
|
|
status 可选：
|
|
|
|
|
|
|
|
|
|
|
|
字段/取值
|
|
|
|
|
|
|
|
|
|
|
|
draft
|
|
|
|
|
|
|
|
|
|
|
|
published
|
|
|
|
|
|
|
|
|
|
|
|
deprecated
|
|
|
|
|
|
|
|
|
|
|
|
force_update
|
|
|
|
|
|
|
|
|
|
|
|
blocked
|
|
|
|
|
|
|
|
|
|
|
|
archived
|
|
|
|
|
|
|
|
|
|
|
|
说明：
|
|
|
|
|
|
|
|
|
|
|
|
a) allow_rollback 表示该版本是否允许作为降级目标。
|
|
|
|
|
|
|
|
|
|
|
|
b) rollback_targets 可为空；为空时表示不允许主动降级到其他版本。
|
|
|
|
|
|
|
|
|
|
|
|
c) 如果需要精确控制降级目标，rollback_targets 记录允许降级到的
|
|
|
|
|
|
|
|
|
|
|
|
版本列表，或拆分为独立版本关系表。
|
|
|
|
|
|
|
|
|
|
|
|
10.4 版本文件表 version_files
|
|
|
|
|
|
|
|
|
|
|
|
字段：
|
|
|
|
|
|
|
|
|
|
|
|
字段/取值
|
|
|
|
|
|
|
|
|
|
|
|
id
|
|
|
|
|
|
|
|
|
|
|
|
version_id
|
|
|
|
|
|
|
|
|
|
|
|
relative_path
|
|
|
|
|
|
|
|
|
|
|
|
storage_key
|
|
|
|
|
|
|
|
|
|
|
|
sha256
|
|
|
|
|
|
|
|
|
|
|
|
size
|
|
|
|
|
|
|
|
|
|
|
|
file_type
|
|
|
|
|
|
|
|
|
|
|
|
is_required
|
|
|
|
|
|
|
|
|
|
|
|
MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄 MARSCO_内部
|
|
|
|
|
|
|
|
|
|
|
|
created_at
|
|
|
|
|
|
10.5 版本策略表 version_policies
|
|
|
|
|
|
|
|
|
|
|
|
字段：
|
|
|
|
|
|
|
|
|
|
|
|
字段/取值
|
|
|
|
|
|
|
|
|
|
|
|
id
|
|
|
|
|
|
|
|
|
|
|
|
app_id
|
|
|
|
|
|
|
|
|
|
|
|
channel_code
|
|
|
|
|
|
|
|
|
|
|
|
version
|
|
|
|
|
|
|
|
|
|
|
|
policy_seq
|
|
|
|
|
|
|
|
|
|
|
|
allow_run
|
|
|
|
|
|
|
|
|
|
|
|
force_update
|
|
|
|
|
|
|
|
|
|
|
|
allow_rollback
|
|
|
|
|
|
|
|
|
|
|
|
rollback_targets
|
|
|
|
|
|
|
|
|
|
|
|
offline_allowed
|
|
|
|
|
|
|
|
|
|
|
|
valid_until
|
|
|
|
|
|
|
|
|
|
|
|
min_supported_version
|
|
|
|
|
|
|
|
|
|
|
|
latest_version
|
|
|
|
|
|
|
|
|
|
|
|
message
|
|
|
|
|
|
|
|
|
|
|
|
created_at
|
|
|
|
|
|
|
|
|
|
|
|
updated_at
|
|
|
|
|
|
|
|
|
|
|
|
说明：
|
|
|
|
|
|
|
|
|
|
|
|
a) 每次策略变更必须递增 policy_seq。
|
|
|
|
|
|
|
|
|
|
|
|
b) 客户端记录已见过的最大 policy_seq，检测到倒退时拒绝使用。
|
|
|
|
|
|
|
|
|
|
|
|
c) allow_rollback 表示当前策略是否允许降级。
|
|
|
|
|
|
|
|
|
|
|
|
MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄 MARSCO_内部
|
|
|
|
|
|
|
|
|
|
|
|
d) rollback_targets 用于限制允许降级的目标版本；未命中目标版本
|
|
|
|
|
|
|
|
|
|
|
|
时返回 rollback_denied。
|
|
|
|
|
|
|
|
|
|
|
|
10.6 设备表 devices
|
|
|
|
|
|
|
|
|
|
|
|
字段：
|
|
|
|
|
|
|
|
|
|
|
|
字段/取值
|
|
|
|
|
|
|
|
|
|
|
|
id
|
|
|
|
|
|
|
|
|
|
|
|
client_id
|
|
|
|
|
|
|
|
|
|
|
|
device_id
|
|
|
|
|
|
|
|
|
|
|
|
license_id
|
|
|
|
|
|
|
|
|
|
|
|
app_id
|
|
|
|
|
|
|
|
|
|
|
|
channel_code
|
|
|
|
|
|
|
|
|
|
|
|
status
|
|
|
|
|
|
|
|
|
|
|
|
first_seen_at
|
|
|
|
|
|
|
|
|
|
|
|
last_seen_at
|
|
|
|
|
|
|
|
|
|
|
|
created_at
|
|
|
|
|
|
|
|
|
|
|
|
updated_at
|
|
|
|
|
|
|
|
|
|
|
|
status 可选：
|
|
|
|
|
|
|
|
|
|
|
|
字段/取值
|
|
|
|
|
|
|
|
|
|
|
|
active
|
|
|
|
|
|
|
|
|
|
|
|
disabled
|
|
|
|
|
|
|
|
|
|
|
|
suspicious
|
|
|
|
|
|
|
|
|
|
|
|
expired
|
|
|
|
|
|
10.7 授权表 licenses
|
|
|
|
|
|
|
|
|
|
|
|
字段：
|
|
|
|
|
|
|
|
|
|
|
|
MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄 MARSCO_内部
|
|
|
|
|
|
|
|
|
|
|
|
字段/取值
|
|
|
|
|
|
|
|
|
|
|
|
id
|
|
|
|
|
|
|
|
|
|
|
|
license_id
|
|
|
|
|
|
|
|
|
|
|
|
customer_name
|
|
|
|
|
|
|
|
|
|
|
|
app_id
|
|
|
|
|
|
|
|
|
|
|
|
channel_code
|
|
|
|
|
|
|
|
|
|
|
|
max_devices
|
|
|
|
|
|
|
|
|
|
|
|
valid_until
|
|
|
|
|
|
|
|
|
|
|
|
status
|
|
|
|
|
|
|
|
|
|
|
|
created_at
|
|
|
|
|
|
|
|
|
|
|
|
updated_at
|
|
|
|
|
|
10.8 下载日志表 download_logs
|
|
|
|
|
|
|
|
|
|
|
|
字段：
|
|
|
|
|
|
|
|
|
|
|
|
字段/取值
|
|
|
|
|
|
|
|
|
|
|
|
id
|
|
|
|
|
|
|
|
|
|
|
|
client_id
|
|
|
|
|
|
|
|
|
|
|
|
device_id
|
|
|
|
|
|
|
|
|
|
|
|
license_id
|
|
|
|
|
|
|
|
|
|
|
|
app_id
|
|
|
|
|
|
|
|
|
|
|
|
version
|
|
|
|
|
|
|
|
|
|
|
|
channel_code
|
|
|
|
|
|
|
|
|
|
|
|
file_path
|
|
|
|
|
|
|
|
|
|
|
|
file_size
|
|
|
|
|
|
|
|
|
|
|
|
ip
|
|
|
|
|
|
|
|
|
|
|
|
user_agent
|
|
|
|
|
|
|
|
|
|
|
|
MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄 MARSCO_内部
|
|
|
|
|
|
|
|
|
|
|
|
result
|
|
|
|
|
|
|
|
|
|
|
|
created_at
|
|
|
|
|
|
10.9 升级日志表 upgrade_logs
|
|
|
|
|
|
|
|
|
|
|
|
字段：
|
|
|
|
|
|
|
|
|
|
|
|
字段/取值
|
|
|
|
|
|
|
|
|
|
|
|
id
|
|
|
|
|
|
|
|
|
|
|
|
client_id
|
|
|
|
|
|
|
|
|
|
|
|
device_id
|
|
|
|
|
|
|
|
|
|
|
|
license_id
|
|
|
|
|
|
|
|
|
|
|
|
app_id
|
|
|
|
|
|
|
|
|
|
|
|
channel_code
|
|
|
|
|
|
|
|
|
|
|
|
from_version
|
|
|
|
|
|
|
|
|
|
|
|
to_version
|
|
|
|
|
|
|
|
|
|
|
|
result
|
|
|
|
|
|
|
|
|
|
|
|
error_code
|
|
|
|
|
|
|
|
|
|
|
|
message
|
|
|
|
|
|
|
|
|
|
|
|
started_at
|
|
|
|
|
|
|
|
|
|
|
|
finished_at
|
|
|
|
|
|
|
|
|
|
|
|
created_at
|
|
|
|
|
|
10.10 管理员表 admin_users
|
|
|
|
|
|
|
|
|
|
|
|
字段：
|
|
|
|
|
|
|
|
|
|
|
|
字段/取值
|
|
|
|
|
|
|
|
|
|
|
|
id
|
|
|
|
|
|
|
|
|
|
|
|
username
|
|
|
|
|
|
|
|
|
|
|
|
MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄 MARSCO_内部
|
|
|
|
|
|
|
|
|
|
|
|
password_hash
|
|
|
|
|
|
|
|
|
|
|
|
status
|
|
|
|
|
|
|
|
|
|
|
|
last_login_at
|
|
|
|
|
|
|
|
|
|
|
|
created_at
|
|
|
|
|
|
|
|
|
|
|
|
updated_at
|
|
|
|
|
|
|
|
|
|
|
|
status 可选：
|
|
|
|
|
|
|
|
|
|
|
|
字段/取值
|
|
|
|
|
|
|
|
|
|
|
|
active
|
|
|
|
|
|
|
|
|
|
|
|
disabled
|
|
|
|
|
|
|
|
|
|
|
|
规则：
|
|
|
|
|
|
|
|
|
|
|
|
a) 密码只保存 hash，不保存明文。
|
|
|
|
|
|
|
|
|
|
|
|
b) Demo 阶段可预置一个管理员账号。
|
|
|
|
|
|
|
|
|
|
|
|
c) 正式阶段可扩展角色、权限、双因素认证和单点登录。
|
|
|
|
|
|
|
|
|
|
|
|
10.11 管理员操作日志表 admin_audit_logs
|
|
|
|
|
|
|
|
|
|
|
|
字段：
|
|
|
|
|
|
|
|
|
|
|
|
字段/取值
|
|
|
|
|
|
|
|
|
|
|
|
id
|
|
|
|
|
|
|
|
|
|
|
|
admin_user_id
|
|
|
|
|
|
|
|
|
|
|
|
action
|
|
|
|
|
|
|
|
|
|
|
|
target_type
|
|
|
|
|
|
|
|
|
|
|
|
target_id
|
|
|
|
|
|
|
|
|
|
|
|
before_data
|
|
|
|
|
|
|
|
|
|
|
|
after_data
|
|
|
|
|
|
|
|
|
|
|
|
ip
|
|
|
|
|
|
|
|
|
|
|
|
user_agent
|
|
|
|
|
|
|
|
|
|
|
|
MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄 MARSCO_内部
|
|
|
|
|
|
|
|
|
|
|
|
created_at
|
|
|
|
|
|
|
|
|
|
|
|
需要记录的关键操作：
|
|
|
|
|
|
|
|
|
|
|
|
a) 登录成功和登录失败。
|
|
|
|
|
|
|
|
|
|
|
|
b) 创建或发布版本。
|
|
|
|
|
|
|
|
|
|
|
|
c) 上传版本文件。
|
|
|
|
|
|
|
|
|
|
|
|
d) 修改强制升级策略。
|
|
|
|
|
|
|
|
|
|
|
|
e) 禁用或恢复版本。
|
|
|
|
|
|
|
|
|
|
|
|
f) 修改降级策略。
|
|
|
|
|
|
|
|
|
|
|
|
g) 生成离线更新包。
|
|
|
|
|
|
|
|
|
|
|
|
h) 禁用或恢复设备。
|
|
|
|
|
|
|
|
|
|
|
|
11 对象存储目录设计
|
|
|
|
|
|
|
|
|
|
|
|
建议对象存储目录如下：
|
|
|
|
|
|
|
|
|
|
|
|
对象路径
|
|
|
|
|
|
|
|
|
|
|
|
updates/{app_id}/
|
|
|
|
|
|
|
|
|
|
|
|
内容
|
|
|
|
|
|
|
|
|
|
|
|
应用根目录
|
|
|
|
|
|
|
|
|
|
|
|
updates/{app_id}/{channel}/
|
|
|
|
|
|
|
|
|
|
|
|
版本通道目录，例如 stable、
|
|
|
|
|
|
|
|
|
|
|
|
updates/{app_id}/{channel}/{version}/
|
|
|
|
|
|
|
|
|
|
|
|
preview
|
|
|
|
|
|
|
|
|
|
|
|
单个版本目录
|
|
|
|
|
|
|
|
|
|
|
|
updates/{app_id}/{channel}/{version}/manifest.json
|
|
|
|
|
|
|
|
|
|
|
|
当前版本 manifest
|
|
|
|
|
|
|
|
|
|
|
|
updates/{app_id}/{channel}/{version}/manifest.sig
|
|
|
|
|
|
|
|
|
|
|
|
manifest 签名
|
|
|
|
|
|
|
|
|
|
|
|
updates/{app_id}/{channel}/{version}/files/
|
|
|
|
|
|
|
|
|
|
|
|
版本文件目录
|
|
|
|
|
|
|
|
|
|
|
|
updates/{app_id}/{channel}/{version}/files/Launcher.exe
|
|
|
|
|
|
|
|
|
|
|
|
Launcher 可执行文件
|
|
|
|
|
|
|
|
|
|
|
|
updates/{app_id}/{channel}/{version}/files/MainApp.exe
|
|
|
|
|
|
|
|
|
|
|
|
主程序可执行文件
|
|
|
|
|
|
|
|
|
|
|
|
updates/{app_id}/{channel}/{version}/files/Updater.exe
|
|
|
|
|
|
|
|
|
|
|
|
升级器可执行文件
|
|
|
|
|
|
|
|
|
|
|
|
updates/{app_id}/{channel}/{version}/files/plugins/demo_plugin.dll Demo 插件 DLL
|
|
|
|
|
|
|
|
|
|
|
|
updates/{app_id}/{channel}/{version}/offline/
|
|
|
|
|
|
|
|
|
|
|
|
离线更新包目录
|
|
|
|
|
|
|
|
|
|
|
|
MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄 MARSCO_内部
|
|
|
|
|
|
|
|
|
|
|
|
updates/{app_id}/{channel}/{version}/offline/{package}.upd
|
|
|
|
|
|
|
|
|
|
|
|
离线更新包
|
|
|
|
|
|
|
|
|
|
|
|
规则：
|
|
|
|
|
|
|
|
|
|
|
|
a) 已发布版本目录不可覆盖。
|
|
|
|
|
|
|
|
|
|
|
|
b) 如果要修复，应发布新版本号。
|
|
|
|
|
|
|
|
|
|
|
|
c) manifest 与 files 必须保持一致。
|
|
|
|
|
|
|
|
|
|
|
|
d) 离线包由同一套 manifest 生成。
|
|
|
|
|
|
|
|
|
|
|
|
e) 对象存储 bucket 正式环境应设置为私有。
|
|
|
|
|
|
|
|
|
|
|
|
12 Hash 校验策略
|
|
|
|
|
|
|
|
|
|
|
|
系统采用 SHA-256 作为文件 hash 算法。
|
|
|
|
|
|
|
|
|
|
|
|
规则：
|
|
|
|
|
|
|
|
|
|
|
|
a) 服务端发布时计算所有受控文件 hash。
|
|
|
|
|
|
|
|
|
|
|
|
b) manifest 包含全量受控文件 hash。
|
|
|
|
|
|
|
|
|
|
|
|
c) 客户端升级前扫描本地文件。
|
|
|
|
|
|
|
|
|
|
|
|
d) 客户端只下载缺失或 hash 不一致的文件。
|
|
|
|
|
|
|
|
|
|
|
|
e) 下载完成后校验下载文件 hash。
|
|
|
|
|
|
|
|
|
|
|
|
f) 文件替换完成后执行全量 hash 校验。
|
|
|
|
|
|
|
|
|
|
|
|
g) 启动时执行核心文件 hash 校验。
|
|
|
|
|
|
|
|
|
|
|
|
h) 插件目录执行白名单检查。
|
|
|
|
|
|
|
|
|
|
|
|
结论：
|
|
|
|
|
|
|
|
|
|
|
|
更新可以增量，校验必须全量。
|
|
|
|
|
|
|
|
|
|
|
|
13 签名策略
|
|
|
|
|
|
|
|
|
|
|
|
签名采用非对称签名机制。Demo 阶段建议使用 Ed25519；如果现
|
|
|
|
|
|
|
|
|
|
|
|
有技术栈不方便支持 Ed25519，可使用 RSA-2048 / SHA-256，但同一
|
|
|
|
|
|
|
|
|
|
|
|
套 Demo 中必须固定一种算法。
|
|
|
|
|
|
|
|
|
|
|
|
规则：
|
|
|
|
|
|
|
|
|
|
|
|
a) 服务端保存私钥。
|
|
|
|
|
|
|
|
|
|
|
|
MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄 MARSCO_内部
|
|
|
|
|
|
|
|
|
|
|
|
b) 客户端内置公钥。
|
|
|
|
|
|
|
|
|
|
|
|
c) version_policy 必须签名。
|
|
|
|
|
|
|
|
|
|
|
|
d) manifest 必须签名。
|
|
|
|
|
|
|
|
|
|
|
|
e) client_identity 必须签名。
|
|
|
|
|
|
|
|
|
|
|
|
f) 离线更新包必须签名。
|
|
|
|
|
|
|
|
|
|
|
|
g) 客户端验证签名失败时拒绝启动或拒绝安装。
|
|
|
|
|
|
|
|
|
|
|
|
客户端不得保存服务端私钥。
|
|
|
|
|
|
|
|
|
|
|
|
签名数据规则：
|
|
|
|
|
|
|
|
|
|
|
|
a) 被签名对象必须包含 signature_alg 和 key_id。
|
|
|
|
|
|
|
|
|
|
|
|
b) 计算签名前必须移除 signature 字段。
|
|
|
|
|
|
|
|
|
|
|
|
c) JSON 签名载荷必须使用稳定序列化规则：字段按字典序排序、无
|
|
|
|
|
|
|
|
|
|
|
|
多余空白、UTF-8 编码。
|
|
|
|
|
|
|
|
|
|
|
|
d) 时间字段统一使用 UTC ISO-8601 格式。
|
|
|
|
|
|
|
|
|
|
|
|
e) 客户端根据 key_id 选择内置公钥进行验签。
|
|
|
|
|
|
|
|
|
|
|
|
f) 公钥轮换时，客户端可同时内置当前公钥和上一个公钥。
|
|
|
|
|
|
|
|
|
|
|
|
g) 签名失败返回或记录 signature_failed。
|
|
|
|
|
|
|
|
|
|
|
|
version_policy 签名字段至少包括：
|
|
|
|
|
|
|
|
|
|
|
|
字段/取值
|
|
|
|
|
|
|
|
|
|
|
|
app_id
|
|
|
|
|
|
|
|
|
|
|
|
client_id
|
|
|
|
|
|
|
|
|
|
|
|
policy_seq
|
|
|
|
|
|
|
|
|
|
|
|
channel
|
|
|
|
|
|
|
|
|
|
|
|
current_version
|
|
|
|
|
|
|
|
|
|
|
|
allow_run
|
|
|
|
|
|
|
|
|
|
|
|
force_update
|
|
|
|
|
|
|
|
|
|
|
|
MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄 MARSCO_内部
|
|
|
|
|
|
|
|
|
|
|
|
allow_rollback
|
|
|
|
|
|
|
|
|
|
|
|
rollback_targets
|
|
|
|
|
|
|
|
|
|
|
|
offline_allowed
|
|
|
|
|
|
|
|
|
|
|
|
issued_at
|
|
|
|
|
|
|
|
|
|
|
|
valid_until
|
|
|
|
|
|
|
|
|
|
|
|
latest_version
|
|
|
|
|
|
|
|
|
|
|
|
min_supported_version
|
|
|
|
|
|
|
|
|
|
|
|
message
|
|
|
|
|
|
|
|
|
|
|
|
signature_alg
|
|
|
|
|
|
|
|
|
|
|
|
key_id
|
|
|
|
|
|
|
|
|
|
|
|
manifest 签名字段至少包括：
|
|
|
|
|
|
|
|
|
|
|
|
字段/取值
|
|
|
|
|
|
|
|
|
|
|
|
app_id
|
|
|
|
|
|
|
|
|
|
|
|
version
|
|
|
|
|
|
|
|
|
|
|
|
channel
|
|
|
|
|
|
|
|
|
|
|
|
platform
|
|
|
|
|
|
|
|
|
|
|
|
arch
|
|
|
|
|
|
|
|
|
|
|
|
manifest_seq
|
|
|
|
|
|
|
|
|
|
|
|
created_at
|
|
|
|
|
|
|
|
|
|
|
|
files
|
|
|
|
|
|
|
|
|
|
|
|
signature_alg
|
|
|
|
|
|
|
|
|
|
|
|
key_id
|
|
|
|
|
|
|
|
|
|
|
|
client_identity 签名字段至少包括：
|
|
|
|
|
|
|
|
|
|
|
|
字段/取值
|
|
|
|
|
|
|
|
|
|
|
|
client_id
|
|
|
|
|
|
|
|
|
|
|
|
MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄 MARSCO_内部
|
|
|
|
|
|
|
|
|
|
|
|
device_id
|
|
|
|
|
|
|
|
|
|
|
|
license_id
|
|
|
|
|
|
|
|
|
|
|
|
app_id
|
|
|
|
|
|
|
|
|
|
|
|
channel
|
|
|
|
|
|
|
|
|
|
|
|
issued_at
|
|
|
|
|
|
|
|
|
|
|
|
valid_until
|
|
|
|
|
|
|
|
|
|
|
|
signature_alg
|
|
|
|
|
|
|
|
|
|
|
|
key_id
|
|
|
|
|
|
14 限流策略
|
|
|
|
|
|
|
|
|
|
|
|
服务端需要支持多维度限流。
|
|
|
|
|
|
|
|
|
|
|
|
建议限流维度：
|
|
|
|
|
|
|
|
|
|
|
|
a) client_id。
|
|
|
|
|
|
|
|
|
|
|
|
b) device_id。
|
|
|
|
|
|
|
|
|
|
|
|
c) license_id。
|
|
|
|
|
|
|
|
|
|
|
|
d) IP。
|
|
|
|
|
|
|
|
|
|
|
|
e) app_id。
|
|
|
|
|
|
|
|
|
|
|
|
f) version。
|
|
|
|
|
|
|
|
|
|
|
|
g) file_path。
|
|
|
|
|
|
|
|
|
|
|
|
建议限流规则：
|
|
|
|
|
|
|
|
|
|
|
|
维度
|
|
|
|
|
|
|
|
|
|
|
|
client_id
|
|
|
|
|
|
|
|
|
|
|
|
device_id
|
|
|
|
|
|
|
|
|
|
|
|
license_id
|
|
|
|
|
|
|
|
|
|
|
|
IP
|
|
|
|
|
|
|
|
|
|
|
|
超限后返回：
|
|
|
|
|
|
|
|
|
|
|
|
限制
|
|
|
|
|
|
|
|
|
|
|
|
10 分钟内最多请求 10 次下载链接
|
|
|
|
|
|
|
|
|
|
|
|
1 小时内最多下载 3 次完整包
|
|
|
|
|
|
|
|
|
|
|
|
24 小时内最多下载指定额度
|
|
|
|
|
|
|
|
|
|
|
|
10 分钟内最多请求 200 次 API
|
|
|
|
|
|
|
|
|
|
|
|
MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄 MARSCO_内部
|
|
|
|
|
|
|
|
|
|
|
|
示例值
|
|
|
|
|
|
|
|
|
|
|
|
RATE_LIMITED
|
|
|
|
|
|
|
|
|
|
|
|
请求过于频繁，请稍后再试。
|
|
|
|
|
|
|
|
|
|
|
|
字段
|
|
|
|
|
|
|
|
|
|
|
|
code
|
|
|
|
|
|
|
|
|
|
|
|
message
|
|
|
|
|
|
15 回滚机制
|
|
|
|
|
|
|
|
|
|
|
|
升级失败时必须支持回滚。
|
|
|
|
|
|
|
|
|
|
|
|
流程：
|
|
|
|
|
|
|
|
|
|
|
|
a) 下载文件到 staging。
|
|
|
|
|
|
|
|
|
|
|
|
b) 校验 hash。
|
|
|
|
|
|
|
|
|
|
|
|
c) 备份当前版本到 backup。
|
|
|
|
|
|
|
|
|
|
|
|
d) 替换文件。
|
|
|
|
|
|
|
|
|
|
|
|
e) 替换完成后执行全量校验。
|
|
|
|
|
|
|
|
|
|
|
|
f) 启动 MainApp 验证。
|
|
|
|
|
|
|
|
|
|
|
|
g) 如果失败，使用 backup 回滚。
|
|
|
|
|
|
|
|
|
|
|
|
h) 回滚后再次校验旧版本文件。
|
|
|
|
|
|
|
|
|
|
|
|
i) 上报回滚结果。
|
|
|
|
|
|
|
|
|
|
|
|
升级事务状态文件：
|
|
|
|
|
|
|
|
|
|
|
|
Updater 应 在 update/ 目 录 下 维 护 事 务 状 态 文 件 ， 例 如
|
|
|
|
|
|
|
|
|
|
|
|
update/upgrade_state.json。
|
|
|
|
|
|
|
|
|
|
|
|
字段：
|
|
|
|
|
|
|
|
|
|
|
|
字段
|
|
|
|
|
|
|
|
|
|
|
|
transaction_id
|
|
|
|
|
|
|
|
|
|
|
|
from_version
|
|
|
|
|
|
|
|
|
|
|
|
to_version
|
|
|
|
|
|
|
|
|
|
|
|
status
|
|
|
|
|
|
|
|
|
|
|
|
manifest_id
|
|
|
|
|
|
|
|
|
|
|
|
示例值
|
|
|
|
|
|
|
|
|
|
|
|
uuid_xxx
|
|
|
|
|
|
|
|
|
|
|
|
1.0.0
|
|
|
|
|
|
|
|
|
|
|
|
1.0.1
|
|
|
|
|
|
|
|
|
|
|
|
prepared
|
|
|
|
|
|
|
|
|
|
|
|
manifest_xxx
|
|
|
|
|
|
|
|
|
|
|
|
MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄 MARSCO_内部
|
|
|
|
|
|
|
|
|
|
|
|
2026-06-23T10:00:00Z
|
|
|
|
|
|
|
|
|
|
|
|
2026-06-23T10:01:00Z
|
|
|
|
|
|
|
|
|
|
|
|
update/staging/uuid_xxx
|
|
|
|
|
|
|
|
|
|
|
|
update/backup/uuid_xxx
|
|
|
|
|
|
|
|
|
|
|
|
started_at
|
|
|
|
|
|
|
|
|
|
|
|
updated_at
|
|
|
|
|
|
|
|
|
|
|
|
staging_dir
|
|
|
|
|
|
|
|
|
|
|
|
backup_dir
|
|
|
|
|
|
|
|
|
|
|
|
error_code
|
|
|
|
|
|
|
|
|
|
|
|
message
|
|
|
|
|
|
|
|
|
|
|
|
事务状态：
|
|
|
|
|
|
|
|
|
|
|
|
字段/取值
|
|
|
|
|
|
|
|
|
|
|
|
idle
|
|
|
|
|
|
|
|
|
|
|
|
prepared
|
|
|
|
|
|
|
|
|
|
|
|
downloading
|
|
|
|
|
|
|
|
|
|
|
|
downloaded
|
|
|
|
|
|
|
|
|
|
|
|
verified
|
|
|
|
|
|
|
|
|
|
|
|
waiting_mainapp_exit
|
|
|
|
|
|
|
|
|
|
|
|
backed_up
|
|
|
|
|
|
|
|
|
|
|
|
replacing
|
|
|
|
|
|
|
|
|
|
|
|
replaced
|
|
|
|
|
|
|
|
|
|
|
|
post_verify
|
|
|
|
|
|
|
|
|
|
|
|
committed
|
|
|
|
|
|
|
|
|
|
|
|
rollback_required
|
|
|
|
|
|
|
|
|
|
|
|
rolling_back
|
|
|
|
|
|
|
|
|
|
|
|
rolled_back
|
|
|
|
|
|
|
|
|
|
|
|
failed
|
|
|
|
|
|
|
|
|
|
|
|
状态规则：
|
|
|
|
|
|
|
|
|
|
|
|
a) 下载前进入 prepared。
|
|
|
|
|
|
|
|
|
|
|
|
MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄
|
|
|
|
|
|
|
|
|
|
|
|
MARSCO_内部
|
|
|
|
|
|
|
|
|
|
|
|
b) 下载过程中进入 downloading。
|
|
|
|
|
|
|
|
|
|
|
|
c) 下载完成且 hash 校验通过后进入 verified。
|
|
|
|
|
|
|
|
|
|
|
|
d) MainApp 完全退出后才能进入 backed_up。
|
|
|
|
|
|
|
|
|
|
|
|
e) 备份完成后才能进入 replacing。
|
|
|
|
|
|
|
|
|
|
|
|
f) 替换完成后进入 post_verify 并执行全量 hash 校验。
|
|
|
|
|
|
|
|
|
|
|
|
g) 全量校验成功、MainApp 可启动后进入 committed。
|
|
|
|
|
|
|
|
|
|
|
|
h) 替换后校验失败、启动失败或异常中断时进入 rollback_required。
|
|
|
|
|
|
|
|
|
|
|
|
i) 回滚完成并校验旧版本成功后进入 rolled_back。
|
|
|
|
|
|
|
|
|
|
|
|
j) 回滚失败进入 failed，并提示用户重新安装或联系管理员。
|
|
|
|
|
|
|
|
|
|
|
|
异常恢复规则：
|
|
|
|
|
|
|
|
|
|
|
|
a) Updater 启动时先读取 upgrade_state.json。
|
|
|
|
|
|
|
|
|
|
|
|
b) 如果状态为 downloading、downloaded 或 verified，可以清理 staging
|
|
|
|
|
|
|
|
|
|
|
|
后重新下载。
|
|
|
|
|
|
|
|
|
|
|
|
c) 如果状态为 backed_up、replacing、replaced 或 post_verify，必须
|
|
|
|
|
|
|
|
|
|
|
|
优先尝试回滚。
|
|
|
|
|
|
|
|
|
|
|
|
d) 如果状态为 rollback_required 或 rolling_back，继续执行回滚。
|
|
|
|
|
|
|
|
|
|
|
|
e) 如果状态为 committed 或 rolled_back，可清理旧事务状态。
|
|
|
|
|
|
|
|
|
|
|
|
f) 清理 staging 和 backup 前必须确认事务已提交或已成功回滚。
|
|
|
|
|
|
|
|
|
|
|
|
需要处理的失败类型：
|
|
|
|
|
|
|
|
|
|
|
|
a) 下载失败。
|
|
|
|
|
|
|
|
|
|
|
|
b) hash 失败。
|
|
|
|
|
|
|
|
|
|
|
|
c) 签名失败。
|
|
|
|
|
|
|
|
|
|
|
|
d) 文件占用。
|
|
|
|
|
|
|
|
|
|
|
|
e) 权限不足。
|
|
|
|
|
|
|
|
|
|
|
|
f) 磁盘空间不足。
|
|
|
|
|
|
|
|
|
|
|
|
MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄 MARSCO_内部
|
|
|
|
|
|
|
|
|
|
|
|
g) 替换失败。
|
|
|
|
|
|
|
|
|
|
|
|
h) 启动失败。
|
|
|
|
|
|
|
|
|
|
|
|
i) 回滚失败。
|
|
|
|
|
|
16 Demo 开发里程碑
|
|
|
|
|
|
16.1 第一阶段：基础框架
|
|
|
|
|
|
|
|
|
|
|
|
目标：
|
|
|
|
|
|
|
|
|
|
|
|
a) 完成 Launcher、MainApp、Updater 三个 Qt 程序。
|
|
|
|
|
|
|
|
|
|
|
|
b) MainApp 能显示当前版本。
|
|
|
|
|
|
|
|
|
|
|
|
c) MainApp 能加载 demo_plugin.dll。
|
|
|
|
|
|
|
|
|
|
|
|
d) Launcher 能启动 MainApp。
|
|
|
|
|
|
|
|
|
|
|
|
e) MainApp 直接启动时能拒绝进入。
|
|
|
|
|
|
|
|
|
|
|
|
16.2 第二阶段：服务端基础能力
|
|
|
|
|
|
|
|
|
|
|
|
目标：
|
|
|
|
|
|
|
|
|
|
|
|
a) 搭建 FastAPI 或 Go API。
|
|
|
|
|
|
|
|
|
|
|
|
b) 搭建 SQLite 数据库。
|
|
|
|
|
|
|
|
|
|
|
|
c) 搭建 MinIO。
|
|
|
|
|
|
|
|
|
|
|
|
d) 实现应用、版本、通道基础数据。
|
|
|
|
|
|
|
|
|
|
|
|
e) 实现 /update/check。
|
|
|
|
|
|
|
|
|
|
|
|
f) 实现 manifest 返回。
|
|
|
|
|
|
16.3 第三阶段：在线更新
|
|
|
|
|
|
|
|
|
|
|
|
目标：
|
|
|
|
|
|
|
|
|
|
|
|
a) Updater 下载 manifest。
|
|
|
|
|
|
|
|
|
|
|
|
b) Updater 校验 manifest 签名。
|
|
|
|
|
|
|
|
|
|
|
|
c) Updater 对比本地 hash。
|
|
|
|
|
|
|
|
|
|
|
|
d) Updater 下载差异文件。
|
|
|
|
|
|
|
|
|
|
|
|
MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄 MARSCO_内部
|
|
|
|
|
|
|
|
|
|
|
|
e) Updater 替换 MainApp 和 DLL。
|
|
|
|
|
|
|
|
|
|
|
|
f) Updater 自动重启 MainApp。
|
|
|
|
|
|
|
|
|
|
|
|
16.4 第四阶段：版本策略
|
|
|
|
|
|
|
|
|
|
|
|
目标：
|
|
|
|
|
|
|
|
|
|
|
|
a) 支持强制升级。
|
|
|
|
|
|
|
|
|
|
|
|
b) 支持版本禁用。
|
|
|
|
|
|
|
|
|
|
|
|
c) 支持正式版和预览版。
|
|
|
|
|
|
|
|
|
|
|
|
d) 支持动态新增通道。
|
|
|
|
|
|
|
|
|
|
|
|
e) 支持允许降级和禁止降级。
|
|
|
|
|
|
|
|
|
|
|
|
16.5 第五阶段：离线能力
|
|
|
|
|
|
|
|
|
|
|
|
目标：
|
|
|
|
|
|
|
|
|
|
|
|
a) 本地缓存 version_policy。
|
|
|
|
|
|
|
|
|
|
|
|
b) 支持离线有效期。
|
|
|
|
|
|
|
|
|
|
|
|
c) 离线凭证未过期时允许启动。
|
|
|
|
|
|
|
|
|
|
|
|
d) 离线凭证过期时禁止启动。
|
|
|
|
|
|
|
|
|
|
|
|
e) 支持离线更新包导入。
|
|
|
|
|
|
16.6 第六阶段：可靠性与安全
|
|
|
|
|
|
|
|
|
|
|
|
目标：
|
|
|
|
|
|
|
|
|
|
|
|
a) 支持升级失败回滚。
|
|
|
|
|
|
|
|
|
|
|
|
b) 支持 policy_seq 防回滚。
|
|
|
|
|
|
|
|
|
|
|
|
c) 支持系统时间回拨检测。
|
|
|
|
|
|
|
|
|
|
|
|
d) 支持插件白名单检查。
|
|
|
|
|
|
|
|
|
|
|
|
e) 支持下载限流。
|
|
|
|
|
|
|
|
|
|
|
|
f) 支持升级日志和下载日志。
|
|
|
|
|
|
|
|
|
|
|
|
17 Demo 验收用例
|
|
|
|
|
|
|
|
|
|
|
|
MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄 MARSCO_内部
|
|
|
|
|
|
|
|
|
|
|
|
a) 通过 Launcher 正常启动 MainApp。
|
|
|
|
|
|
|
|
|
|
|
|
b) 直接启动 MainApp 被拒绝。
|
|
|
|
|
|
|
|
|
|
|
|
c) MainApp 显示主程序版本和 DLL 版本。
|
|
|
|
|
|
|
|
|
|
|
|
d) 后台发布 1.0.1。
|
|
|
|
|
|
|
|
|
|
|
|
e) 客户端从 1.0.0 升级到 1.0.1。
|
|
|
|
|
|
|
|
|
|
|
|
f) 升级后 DLL 版本变化。
|
|
|
|
|
|
|
|
|
|
|
|
g) 升级后 MainApp 自动重启。
|
|
|
|
|
|
|
|
|
|
|
|
h) 手动篡改 DLL 后启动失败。
|
|
|
|
|
|
|
|
|
|
|
|
i) 手动篡改 version_policy 后启动失败。
|
|
|
|
|
|
|
|
|
|
|
|
j) 后台设置 1.0.0 强制升级后客户端无法继续使用。
|
|
|
|
|
|
|
|
|
|
|
|
k) 后台禁用 1.0.0 后客户端拒绝启动。
|
|
|
|
|
|
|
|
|
|
|
|
l) 后台开放预览版后 preview 客户端获取 preview 更新。
|
|
|
|
|
|
|
|
|
|
|
|
m) 后台关闭降级通道后客户端无法降级。
|
|
|
|
|
|
|
|
|
|
|
|
n) 离线凭证未过期时可以启动。
|
|
|
|
|
|
|
|
|
|
|
|
o) 离线凭证过期后拒绝启动。
|
|
|
|
|
|
|
|
|
|
|
|
p) 模拟升级失败后成功回滚。
|
|
|
|
|
|
|
|
|
|
|
|
18 后续扩展方向
|
|
|
|
|
|
|
|
|
|
|
|
后续可扩展：
|
|
|
|
|
|
|
|
|
|
|
|
a) 完整 License 系统。
|
|
|
|
|
|
|
|
|
|
|
|
b) 客户专版分发。
|
|
|
|
|
|
|
|
|
|
|
|
c) 灰度发布。
|
|
|
|
|
|
|
|
|
|
|
|
d) 多平台支持。
|
|
|
|
|
|
|
|
|
|
|
|
e) Windows 服务模式更新。
|
|
|
|
|
|
|
|
|
|
|
|
f) 管理员权限提权。
|
|
|
|
|
|
|
|
|
|
|
|
g) 代码签名证书。
|
|
|
|
|
|
|
|
|
|
|
|
h) 自动错误收集。
|
|
|
|
|
|
|
|
|
|
|
|
MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄 MARSCO_内部
|
|
|
|
|
|
|
|
|
|
|
|
i) 客户端日志上传。
|
|
|
|
|
|
|
|
|
|
|
|
j) 增量二进制差分更新。
|
|
|
|
|
|
|
|
|
|
|
|
k) 多语言界面。
|
|
|
|
|
|
|
|
|
|
|
|
l) 企业内网镜像站点。
|
|
|
|
|
|
|
2026-07-09 09:17:30 +00:00
|
|
|
|
MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄MARSCO内部资料请勿外泄
|
