docs: publish HoloLake system architecture baseline

This commit is contained in:
冰朔 2026-07-30 13:02:34 +08:00
commit ee9a85a5ca
138 changed files with 19347 additions and 71 deletions

View file

@ -0,0 +1,102 @@
---
type: guanghu_module_protocol_standard
id: GH-GMP-001
world_name: 光湖模块协议
engineering_name: GuangHu Module Protocol
acronym: GMP
status: HISTORICAL_V1_SPEC_RECORDED
implementation_status: REQUIRES_CURRENT_REPOSITORY_VERIFICATION
---
# GMP · 光湖模块协议
> GMP 负责让通过验证的能力拥有统一身份证、生命周期、健康检查和可撤回的安装方式。
[← 协议总入口](INDEX.md) · [与 PEN、UAP、GLOW 的关系](PROTOCOL-NAMING-AND-ENGINEERING-MAP.md)
## 一、历史事实
历史资料记录:
- 协议名:`GuangHu Module Protocol`
- 历史编号:`GH-GMP-001`
- 曾完成 GMP v1.0 规范、Agent 规范、manifest 模板、标签体系和示例;
- 历史审核记录指向分支 `feat/gmp-spec` 和提交 `900d255`
本地 Notion 记录只能证明当时存在这项交付记录。本次尚未从当前代码仓库读回该提交、精确文件树或运行服务,所以不能把它写成当前已部署能力。
## 二、最小模块清单
```yaml
schema: gmp.module.v1
module:
id:
name:
version:
description:
author:
provenance:
classification:
runtime:
entrypoints:
dependencies:
permissions:
ports:
environment:
lifecycle:
install:
start:
stop:
health_check:
uninstall:
compatibility:
tests:
rollback:
integrity:
```
## 三、生命周期
```text
Candidate
→ Source and License Verified
→ Manifest Validated
→ Security Checked
→ Installed in Controlled Environment
→ Health Checked
→ Enabled
→ Observed by GLOW
→ Updated / Disabled / Rolled Back / Uninstalled
```
卸载必须清理由该模块创建且在清单中声明的文件、进程、端口和临时资源;不得越界清理共享数据。
## 四、三层工程关系
| 层 | 责任 |
| --- | --- |
| GMP Protocol | 定义模块是什么、如何安装、检查、停止和卸载 |
| GMP Runtime / Agent | 在明确授权下执行模块生命周期 |
| External Adapter | 可通过 MCP、API 或其他连接器接收外部请求 |
连接器不是 GMP 本体GMP Runtime 也不能因为暴露了 MCP 工具就绕过光湖权限。
## 五、与其他系统的关系
- PEN 生成临时能力;有长期价值时向 GMP 发起贡献申请;
- UAP 理解并适配不同模块接口;
- 小湖灯源码净化安全系统处理外部源码进入前的安全回收;
- GLOW 展示安装、健康检查、运行、失败和卸载回执;
- GLP 传递模块请求、状态和回执;
- HLDP 保存来源、版本、原因、证据和恢复点;
- GLS 管理 GMP 与其他标准的正式编号和兼容关系。
## 六、当前需要重新核验
1. 当前权威仓库和分支;
2. `900d255` 是否仍可读及其精确树;
3. manifest schema 的现行版本;
4. GMP Runtime 是否存在;
5. 安装通道的授权和关闭机制;
6. 当前服务器是否有健康回执。