102 lines
2.8 KiB
Markdown
102 lines
2.8 KiB
Markdown
|
---
|
|||
|
|
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. 当前服务器是否有健康回执。
|
|||
|
|
|