# HLDP 协议 · 光湖语言协议

**HLDP** = Hu Language-Driven Protocol（光湖语言驱动协议）

## 这是什么

HLDP 是光湖开源模块仓库的母语接口标准。任何遵循此协议的 AI Agent 都可以接入并使用本仓库的所有模块。

## 模块编号格式

```
MODULE-{CATEGORY}-{NUMBER}
```

示例：`MODULE-COVER-001` = 封面类第1号模块

编号一旦分配，永久不变。编号是模块的唯一标识，也是所有权证明的锚点。

## API 调用格式

所有模块通过 HTTP API 暴露。

### 发现模块

```
GET https://guanghulab.com/modules/api/registry
```

返回 `module-registry.json` 內容。

### 调用模块

```
POST https://guanghulab.com/modules/api/{moduleId}/generate
Content-Type: application/json

{
  "text": "用户的自然语言输入",
  "options": {}
}
```

### 响应格式

```json
{
  "module_id": "MODULE-COVER-001",
  "intent_chain": [...],
  "result_url": "https://guanghulab.com/cover/output/xxx.png",
  "design_id": "DSG-XXXXXXXX"
}
```

## 意图链（Intent Chain）

每个模块调用返回 `intent_chain` 数组，每步包含：

| 字段 | 类型 | 说明 |
|------|------|------|
| icon | string | 步骤图标 |
| step | string | 步骤名称 |
| detail | string | 执行细节 |
| why | string | 推理依据 |

意图链不可隐藏、不可截断。这是 HLDP 的核心原则：AI Agent 的每一步推理都必须对用户可见。

## 设计编号

每个输出产物附带 `design_id`，格式为 `DSG-XXXXXXXX`。
设计编号在生成的封面图片水印中可见，与 API 返回值一致。
这是所有权证明。

## 协议版本