# Prompts-Core（提示词核心服务）

> 智能提示词构建与管理系统，支持多模态 AI 模型的提示词组装、会话管理和协议适配。

---

## 项目简介

**Prompts-Core** 是一个基于 Go 语言开发的提示词核心服务，作为 AI 应用层与模型网关之间的桥梁，负责将业务需求转换为标准化的模型请求。

### 核心价值
- **统一提示词管理**：集中化管理不同模型类型的提示词模板
- **智能会话维护**：基于 Redis + PostgreSQL 的双层会话存储
- **多协议适配**：支持 OpenAI、DeepSeek、Qwen、Gemini 等多种模型协议
- **文件处理能力**：自动提取文本文件和 ZIP 压缩包内容
- **技能系统集成**：支持从外部加载 Markdown 格式的技能描述

---

## 核心功能

### 1. 提示词构建引擎

#### 多模态支持
| 类型 | 说明 | 适用场景 |
|------|------|----------|
| Type 1 | 文字处理助手 | 文章撰写、文案优化、翻译等 |
| Type 2 | 图片处理助手 | 图像生成、风格迁移等 |
| Type 3 | 音频处理助手 | 语音合成、识别、降噪等 |
| Type 4 | 向量化处理助手 | 语义检索、知识索引等 |
| Type 5 | 全模态助手 | 跨模态转换、多模态融合等 |

#### 构建模式
- **BuildType 1（提示词构建）**：完整流程，包含系统提示词、历史会话、用户输入的智能组装
- **BuildType 2（节点构建）**：工作流路由决策，根据上下文选择节点 ID

#### 分批处理
当用户表单内容超出模型窗口限制时，自动按 Token 大小分批处理。

### 2. 会话管理系统

- **双层存储**：Redis 缓存（最近 N 轮）+ PostgreSQL 持久化
- **自动管理**：最大轮数控制（默认 10 轮）、自动过期（默认 30 分钟）

### 3. 协议适配器

通过配置动态支持多种模型协议：
- 角色映射：system/user/assistant → 目标协议角色
- 内容字段映射：content → parts.text 等
- 消息顺序控制：灵活配置拼接顺序
- 请求模板渲染：支持占位符替换

### 4. 任务调度

- **异步流程**：创建网关任务 → 轮询等待 → 接收回调 → 返回结果
- **重试机制**：可配置最大重试次数（默认 3 次）
- **超时保护**：默认 300 秒超时

---

## 技术架构

### 技术栈

| 组件 | 版本 | 用途 |
|------|------|------|
| Go | 1.26.0 | 编程语言 |
| GoFrame | v2.10.0 | Web 框架 |
| PostgreSQL | - | 关系型数据库 |
| Redis | - | 缓存与会话存储 |
| Consul | - | 服务注册与发现 |
| Jaeger | - | 分布式链路追踪 |

### 架构图