From 80a6d9236ade191a5de0975abe4de5a6e7e63915 Mon Sep 17 00:00:00 2001
From: zhou zhou <3272660260@qq.com>
Date: 星期四, 19 三月 2026 14:03:10 +0800
Subject: [PATCH] #AI.注释
---
rsf-server/src/main/java/com/vincent/rsf/server/ai/service/impl/AiPromptRenderSupport.java | 16 ++++++++++++++++
1 files changed, 16 insertions(+), 0 deletions(-)
diff --git a/rsf-server/src/main/java/com/vincent/rsf/server/ai/service/impl/AiPromptRenderSupport.java b/rsf-server/src/main/java/com/vincent/rsf/server/ai/service/impl/AiPromptRenderSupport.java
index 0251428..3a07196 100644
--- a/rsf-server/src/main/java/com/vincent/rsf/server/ai/service/impl/AiPromptRenderSupport.java
+++ b/rsf-server/src/main/java/com/vincent/rsf/server/ai/service/impl/AiPromptRenderSupport.java
@@ -17,6 +17,10 @@
private static final Pattern VARIABLE_PATTERN = Pattern.compile("\\{\\{?([a-zA-Z0-9_.-]+)}}?");
+ /**
+ * 鍚屾椂娓叉煋 System Prompt 鍜� User Prompt锛屽苟鍥炰紶鏈瑙ｆ瀽鍒扮殑鍙橀噺娓呭崟銆�
+ * 璇ユ柟娉曠敤浜� Prompt 绠＄悊椤电殑棰勮鑳藉姏锛屽府鍔╃鐞嗗憳鍦ㄤ笉鐪熸璋冪敤妯″瀷鐨勫墠鎻愪笅楠岃瘉妯℃澘缁撴灉銆�
+ */
public AiPromptPreviewDto render(String systemPrompt, String userPromptTemplate, String input, Map<String, Object> metadata) {
String finalInput = input == null ? "" : input;
return AiPromptPreviewDto.builder()
@@ -26,6 +30,11 @@
.build();
}
+ /**
+ * 鍙覆鏌撶敤鎴锋秷鎭ā鏉裤��
+ * 濡傛灉妯℃澘娌℃湁娑堣垂浠讳綍鍙橀噺锛屽垯淇濈暀妯℃澘鍘熸枃骞舵妸鐢ㄦ埛杈撳叆闄勫姞鍒版湯灏撅紝
+ * 杩欐牱鍙互鏄惧紡鏆撮湶鈥滄ā鏉挎湭鐢熸晥鈥濈殑闂锛岃�屼笉鏄潤榛樺悶鎺夎緭鍏ャ��
+ */
public String renderUserPrompt(String userPromptTemplate, String input, Map<String, Object> metadata) {
if (!StringUtils.hasText(userPromptTemplate)) {
return input;
@@ -38,6 +47,7 @@
}
private String renderTemplate(String template, String input, Map<String, Object> metadata) {
+ /** 娓叉煋浠绘剰妯℃澘鐗囨锛涚┖妯℃澘淇濇寔鍘熸牱杩斿洖銆� */
if (!StringUtils.hasText(template)) {
return template;
}
@@ -45,6 +55,10 @@
}
private String replaceTemplateVariables(String template, String input, Map<String, Object> metadata) {
+ /**
+ * 缁熶竴澶勭悊 `{{input}}`銆乣{input}` 浠ュ強 metadata 閲岀殑鍗犱綅鍙橀噺鏇挎崲銆�
+ * 杩欓噷浣跨敤鏈寸礌鏇挎崲鑰屼笉鏄剼鏈墽琛岋紝鐩殑鏄妯℃澘琛屼负绋冲畾銆佸彲棰勬湡銆佹槗鎺掓煡銆�
+ */
String rendered = template
.replace("{{input}}", input)
.replace("{input}", input);
@@ -60,6 +74,7 @@
}
private List<String> resolveVariables(String systemPrompt, String userPromptTemplate, Map<String, Object> metadata) {
+ /** 鏀堕泦褰撳墠 Prompt 涓樉寮忓嚭鐜拌繃鐨勫彉閲忓悕锛岀敤浜庡墠绔睍绀恒�� */
LinkedHashSet<String> variables = new LinkedHashSet<>();
collectVariables(variables, systemPrompt);
collectVariables(variables, userPromptTemplate);
@@ -70,6 +85,7 @@
}
private void collectVariables(LinkedHashSet<String> variables, String template) {
+ /** 鎵弿妯℃澘鏂囨湰涓殑鍗犱綅鍙橀噺骞舵寜鍑虹幇椤哄簭鍘婚噸銆� */
if (!StringUtils.hasText(template)) {
return;
}
--
Gitblit v1.9.1