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