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": {}
}

响应格式

{
  "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

1.7 KiB Raw Blame History Unescape Escape