75 lines
1.6 KiB
Markdown
75 lines
1.6 KiB
Markdown
# 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 返回值一致。
|
||
这是所有权证明。
|
||
|
||
## 协议版本
|
||
|