76 lines
1.7 KiB
Markdown
76 lines
1.7 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 返回值一致。
|
|||
|
|
这是所有权证明。
|
|||
|
|
|
|||
|
|
## 协议版本
|
|||
|
|
|
|||
|
|
HLDP v1.0 · 冰朔 TCS-0002∞ · 国作登字-2026-A-00037559
|