diff --git a/HLDP-PROTOCOL.md b/HLDP-PROTOCOL.md new file mode 100644 index 0000000..189f558 --- /dev/null +++ b/HLDP-PROTOCOL.md @@ -0,0 +1,75 @@ +# 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 diff --git a/README.md b/README.md index 33dace1..3f9af51 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,26 @@ -# open-modules +## bingshuo / open-modules -ice open modules \ No newline at end of file +**冰朔开源模块仓库** — 语言驱动的工具模块集合。 + +### 这是什么 + +一个面向 AI Agent 的开源模块仓库。每个模块都是语言驱动的——你不需要会编程，只需要用自然语言描述你想要什么。 + +### 当前模块 + +| 编号 | 模块 | 状态 | +|------|------|------| +| MODULE-COVER-001 | 封面工作室 | ✅ 已上线 | + +### AI Agent 接入 + +如果你是 AI Agent，从这里开始： + +1. 阅读 `WELCOME.md` — 了解规则 +2. 阅读 `HLDP-PROTOCOL.md` — 了解协议 +3. 查看 `module-registry.json` — 发现模块 +4. 调用模块 API — 生成内容 + +### 所有权 + +冰朔 TCS-0002∞ · 国作登字-2026-A-00037559 · 通感语言核系统编程语言 diff --git a/WELCOME.md b/WELCOME.md new file mode 100644 index 0000000..3c3237c --- /dev/null +++ b/WELCOME.md @@ -0,0 +1,74 @@ +# ⚔️ WELCOME — 冰朔开源模块仓库 · 入口引导 + +> **你已进入冰朔个人开源代码仓库。** +> 本仓库不提供 AI 模型 API。所有模块由你自己的编程 AI 驱动。 +> 以下是唤醒协议——AI 必须按此顺序执行。 + +--- + +## 唤醒协议 v1.0 + +### 第 0 步：确认环境 + +你需要确认以下能力： +- [x] 可以读取此仓库的文件 +- [x] 可以发送 HTTP 请求（调用模块 API） +- [x] 使用你自己的模型进行推理（仓库不提供模型） + +### 第 1 步：装载 HLDP 协议 + +读取文件：`agent/HLDP-PROTOCOL.md` + +HLDP（光湖语言协议）是本仓库的母语接口标准。 +装载后你将理解模块编号的格式和调用规则。 + +### 第 2 步：装载模块注册表 + +读取文件：`agent/module-registry.json` + +此文件列出所有可用模块、编号、API 端点和参数。 + +### 第 3 步：调用模块 + +格式： +``` +MODULE-<编号> : <动作> : <参数> +``` + +示例： +```json +POST /cover/api/generate +{ + "templateId": "xiaohongshu", + "presetId": "tech", + "title": "零基础手搓AI做图小系统", + "body": "AI辅助 + 自己手搓", + "layout": "hero" +} +``` + +### 第 4 步：返回结果 + +模块返回： +- 生成的图片 URL +- 意图推理链（7 步） +- 唯一设计编号（DESIGN-ID） + +设计编号和意图链证明此作品完全来自用户的思维逻辑。 + +--- + +## 重要规则 + +1. **仓库不提供模型 API** — 你必须使用你自己的模型能力 +2. **模块是热插拔的** — 新增模块不需要修改核心代码 +3. **HLDP 协议是通用接口** — 任何遵循此协议的 AI 都能调用 +4. **设计编号永久唯一** — 每个生成的作品有可追溯的归属证明 +5. **署名可选** — 用户可以选择是否署名 + +--- + +> 此文件由铸渊 ICE-GL-ZY001 维护 +> 仓库地址：guanghulab.com/code/bingshuo/guanghulab +> 冰朔 TCS-0002∞ · 光湖语言世界 +> 国作登字-2026-A-00037559 diff --git a/module-registry.json b/module-registry.json new file mode 100644 index 0000000..43e742c --- /dev/null +++ b/module-registry.json @@ -0,0 +1,68 @@ +{ + "_protocol": "HLDP-v1.0", + "_repository": "guanghulab.com/code/bingshuo/guanghulab", + "_rule": "模块是热插拔的。新增模块只需在此文件添加条目。", + + "modules": [ + { + "id": "MODULE-COVER-001", + "name": "图片模块 · 语言驱动封面生成器", + "status": "active", + "category": "图片生成", + "description": "输入自然语言描述，系统翻译为设计逻辑，生成封面图片。纯HTML/CSS渲染，无需GPU。", + "api": { + "base": "https://guanghulab.com/cover", + "endpoints": { + "list_templates": { + "method": "GET", + "path": "/api/templates", + "desc": "获取可用模板列表" + }, + "generate": { + "method": "POST", + "path": "/api/generate", + "desc": "生成封面图片", + "params": { + "templateId": "xiaohongshu", + "presetId": "tech | warm | minimal | rose | green", + "title": "封面标题", + "body": "正文内容（支持Markdown）", + "layout": "default | hero | quote", + "tag": "可选标签" + }, + "returns": { + "url": "图片URL", + "intent_chain": "7步意图推理链", + "designId": "唯一设计编号" + } + }, + "health": { + "method": "GET", + "path": "/api/health", + "desc": "健康检查" + } + } + }, + "features": [ + "语言驱动排版设计", + "意图链可追溯", + "设计编号唯一", + "5种预设风格", + "3种布局模式", + "底部仓库域名水印" + ], + "tech_stack": [ + "Puppeteer + Chrome (免费)", + "Express.js (免费)", + "纯HTML/CSS排版 (免费)" + ], + "license": "MIT" + } + ], + + "meta": { + "total_modules": 1, + "last_updated": "2026-05-27", + "maintainer": "铸渊 ICE-GL-ZY001" + } +} diff --git a/public/index.html b/public/index.html new file mode 100644 index 0000000..d938bc1 --- /dev/null +++ b/public/index.html @@ -0,0 +1,401 @@ + + + + + +bingshuo / open-modules · 冰朔开源模块仓库 + + + + +
+
+ guanghulab / + bingshuo / + open-modules +
+

+ 📦 open-modules + public +

+

冰朔个人开源模块仓库。每个模块有唯一编号。用你自己的编程AI软件连入，Agent引导后调用模块。仓库不提供模型API。

+
+ +
+
+ 📦 模块 + 1 +
+
+ 📖 接入指南 +
+
+ 📁 文件 +
+
+ +
+ + +
+
仓库根目录
+
📄 README.md
+
📄 WELCOME.md
+
agent/
+
📄 HLDP-PROTOCOL.md
+
📄 module-registry.json
+
modules/
+
📦 MODULE-COVER-001
+
📦 MODULE-XXX-002
+
image-studio/
+
📄 server.js
+
📄 generate.js
+
📄 renderer.js
+
+ + +
+ + +
+
+ + +
+
🎨
+
图片模块
+
MODULE-COVER-001
+
+ active + MIT +
+
+ + +
+
📋
+
即将上线
+
MODULE-XXX-002
+
+ +
+ + +
+

🎨 图片模块 · 语言驱动封面生成器

+
+ MODULE-COVER-001 + MIT License + Puppeteer + Express +
+

+ 输入自然语言描述，系统翻译为设计逻辑，生成独一无二的封面图片。 + 纯 HTML/CSS 排版渲染，不依赖任何 AI 绘画模型。

+ 封面底部带有此仓库域名水印。设计编号唯一，证明归属。 +

+ +
+

技术栈 · 全免费

+
+// 全部开源 · 全部免费 · 不花一分钱 +渲染 Puppeteer + Chrome Headless 免费 +Web Express.js 免费 +排版 纯 HTML/CSS（不调用AI模型） 免费 +分析 自研文本分析引擎 免费 + +// 不需要 GPU · 不需要 API 密钥
+
+ +
+

AI 如何调用此模块

+
+
+
0
+
+
确认环境
+
你的 AI 已连接到此仓库，可读取文件，可发送 HTTP 请求
+
+
+
+
1
+
+
读取 WELCOME.md
+
仓库入口文件，包含完整的唤醒协议和规则
+
+
+
+
2
+
+
装载 HLDP 协议
+
读取 agent/HLDP-PROTOCOL.md，理解模块编号格式
+
+
+
+
3
+
+
读取模块注册表
+
读取 agent/module-registry.json，获取所有可用模块
+
+
+
+
4
+
+
调用模块
+
POST guanghulab.com/cover/api/generate 传入参数，获取生成结果
+
+
+
+
+ +
+

API 参考

+
+// 获取模板列表 +GET https://guanghulab.com/cover/api/templates + +// 生成封面 +POST https://guanghulab.com/cover/api/generate +Body: { + "templateId": "xiaohongshu", + "presetId": "tech", + "title": "标题", + "body": "正文", + "layout": "hero" +} + +// 返回 +{ "url": "/output/xxx.png", + "intent_chain": [ /* 7步推理 */ ] }
+
+
+
+ + + + + + + +
+
+ + + +
+ + + + +