From ccf1a44c001e233c158bd168dc2d0d96721af929 Mon Sep 17 00:00:00 2001
From: kongdeqiang <123456>
Date: 星期一, 12 十月 2026 09:31:53 +0800
Subject: [PATCH] fix: 修改后台
---
src/main/java/com/custom/webui/config/StartupDiagnostics.java | 449 ++++++++++++++++++++++++++++++++++++++++++++++++++++++-
1 files changed, 439 insertions(+), 10 deletions(-)
diff --git a/src/main/java/com/custom/webui/config/StartupDiagnostics.java b/src/main/java/com/custom/webui/config/StartupDiagnostics.java
index dcf3112..8a1b4b9 100644
--- a/src/main/java/com/custom/webui/config/StartupDiagnostics.java
+++ b/src/main/java/com/custom/webui/config/StartupDiagnostics.java
@@ -1,37 +1,94 @@
package com.custom.webui.config;
+import com.custom.webui.config.props.LlmProperties;
import com.custom.webui.config.props.StorageProperties;
+import com.fasterxml.jackson.databind.JsonNode;
+import com.fasterxml.jackson.databind.ObjectMapper;
import lombok.RequiredArgsConstructor;
import lombok.extern.slf4j.Slf4j;
import org.springframework.boot.context.event.ApplicationReadyEvent;
import org.springframework.context.event.EventListener;
import org.springframework.stereotype.Component;
+import java.io.InputStream;
+import java.net.HttpURLConnection;
+import java.net.URI;
+import java.nio.charset.StandardCharsets;
import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;
+import java.util.ArrayList;
+import java.util.List;
/**
- * 鍚姩鑷锛氭妸鍏抽敭鏁版嵁鐨�**瀹為檯钀界洏浣嶇疆**鎵撹繘鍚姩鏃ュ織銆�
+ * 鍚姩鑷锛氭妸涓や釜**鍙湪杩愯鏃舵墠鏆撮湶銆佷笖鎶ラ敊淇℃伅浼氭妸浜哄甫鍋�**鐨勯厤缃」
+ * 鍦ㄥ惎鍔ㄦ棩蹇楅噷璇存竻妤氥��
*
- * <p><b>涓轰粈涔堥渶瑕佸畠</b>锛歿@code webui.storage.location} 鏄浉瀵硅矾寰勶紝
- * 鐩稿璺緞鎸夈�岃繘绋嬪伐浣滅洰褰曘�嶈В鏋愶紝鑰屽伐浣滅洰褰曢殢鍚姩鏂瑰紡鍙樺寲 鈥斺��
- * 鍦� IDE 閲屼互 webui-springboot 涓哄伐浣滅洰褰曞惎鍔紝鍜屼粠椤圭洰鏍圭洰褰�
- * {@code java -jar} 鍚姩锛屼細鎸囧悜涓や釜涓嶅悓鐨勭洰褰曘��
- *
- * <p>杩欎釜宸紓涓嶄細鍦ㄥ惎鍔ㄦ椂鎶ヤ换浣曢敊锛屽彧浼氬湪鐢ㄦ埛鐪熸涓婁紶鎴栬鍙栨枃浠舵椂鎵嶇偢锛�
+ * <h2>涓�銆佹枃浠惰惤鐩樹綅缃�</h2>
+ * {@code webui.storage.location} 鏄浉瀵硅矾寰勶紝鐩稿璺緞鎸夈�岃繘绋嬪伐浣滅洰褰曘�嶈В鏋愶紝
+ * 鑰屽伐浣滅洰褰曢殢鍚姩鏂瑰紡鍙樺寲 鈥斺�� 鍦� IDE 閲屼互 webui-springboot 涓哄伐浣滅洰褰曞惎鍔紝
+ * 鍜屼粠椤圭洰鏍圭洰褰� {@code java -jar} 鍚姩锛屼細鎸囧悜涓や釜涓嶅悓鐨勭洰褰曘��
+ * 杩欎釜宸紓涓嶄細鍦ㄥ惎鍔ㄦ椂鎶ヤ换浣曢敊锛屽彧浼氬湪鐢ㄦ埛鐪熸涓婁紶鎴栬鍙栨枃浠舵椂鎵嶇偢锛�
* 鑰屼笖琛ㄧ幇涓恒�岀煡璇嗗簱閲岀殑鏂囦欢鎵句笉鍒般�嶈繖绉嶆瀬鏄撹鍒ゆ垚鏁版嵁涓㈠け鐨勭幇璞°��
- * 鎶婅矾寰勫湪鍚姩鏃跺氨鎵撳嚭鏉ワ紝闂涓�鐪煎彲瑙併��
*
- * <p>杩欏彧鏄�**鍙娴嬫��**鎺柦锛屼笉鏄牎楠岄棬绂侊細鐩綍涓嶅瓨鍦ㄤ篃涓嶉樆鏂惎鍔� 鈥斺��
- * 棣栨涓婁紶浼氳嚜鍔ㄥ垱寤猴紝纭け璐ュ弽鑰屼細鎶娿�屽彧鏄兂鍏堣捣涓湇鍔$湅鐪嬨�嶇殑浜烘尅鍦ㄩ棬澶栥��
+ * <h2>浜屻�丩LM 鏈嶅姟鍦板潃涓庡崗璁槸鍚﹀尮閰�</h2>
+ * 杩欐槸鏈被瀛樺湪鐨勪富瑕佺悊鐢便�傞」鐩噷鐪熷疄韪╄繃涓�娆★紝鐜拌薄鏄細
+ * <pre>
+ * 鍓嶇鎻愮ず锛歀LM 鏈嶅姟杩斿洖閿欒 (HTTP 404)銆傝纭妯″瀷 qwen35 宸查�氳繃 `ollama pull` 涓嬭浇銆�
+ * </pre>
+ * 浣嗙湡瀹炲師鍥犳槸锛歿@code webui.llm.provider=ollama}锛堣 IDE 鐨�
+ * {@code -D} 鍙傛暟閽夋鐨勶級閰嶄笂浜嗕竴涓� **OpenAI 鍏煎鏈嶅姟**鐨勫湴鍧�锛�
+ * 浜庢槸鍚庣鍘昏姹� {@code http://127.0.0.1:10020/api/chat} 鈥斺��
+ * 閭d釜鍦板潃鍙湁 {@code /v1/chat/completions}锛屾病鏈� {@code /api/chat}锛�
+ * 杩斿洖 404銆傛彁绀哄嵈璁╀汉鍘� {@code ollama pull}锛屾柟鍚戝畬鍏ㄩ敊浜嗐��
+ *
+ * <p>涓ょ鍗忚闀垮緱鍍忎絾浜掍笉鍏煎锛�
+ * <table border="1">
+ * <tr><th>provider</th><th>璺緞</th><th>榛樿鍦板潃</th><th>鍝嶅簲鏍煎紡</th></tr>
+ * <tr><td>ollama</td><td>POST /api/chat</td><td>:11434</td><td>NDJSON锛堟瘡琛屼竴涓� JSON锛�</td></tr>
+ * <tr><td>openai-compat</td><td>POST /v1/chat/completions</td><td>:8000/v1</td><td>SSE锛坉ata: {...}锛�</td></tr>
+ * </table>
+ *
+ * <p>鎵�浠ュ惎鍔ㄦ椂涓诲姩鎺竴娆★細鍦板潃閫氫笉閫氥�佸崗璁涓嶅銆侀厤缃殑妯″瀷鍦ㄤ笉鍦�
+ * 鏈嶅姟杩斿洖鐨勬ā鍨嬪垪琛ㄩ噷銆�**涓嶉樆鏂惎鍔�** 鈥斺�� 杩欏彧鏄彲瑙傛祴鎬ф帾鏂斤紝
+ * 纭け璐ヤ細鎶娿�屽彧鎯冲厛璧蜂釜鏈嶅姟鐪嬬湅銆嶇殑浜烘尅鍦ㄩ棬澶栵紱浣嗘棩蹇楅噷浼氭槑纭啓鍑�
+ * 鎬庝箞鏀癸紝涓嶇敤鍐嶅幓鐚溿��
*/
@Slf4j
@Component
@RequiredArgsConstructor
public class StartupDiagnostics {
+ /**
+ * 鎺㈡祴瓒呮椂銆�
+ *
+ * <p>缁� 5 绉掕�屼笉鏄� 1~2 绉掞細瀹炴祴 10020 涓婇偅涓浆鍙戝櫒鍦ㄥ喎鍚姩鎴栨蹇欐椂锛�
+ * {@code /v1/models} 鍙兘 2 绉掑唴涓嶈繑鍥� 鈥斺�� 鑰屼笌姝ゅ悓鏃剁湡姝g殑瀵硅瘽璇锋眰
+ * 瀹屽叏姝e父銆�**鑷鎶ュ亣璀︽瘮涓嶆姤鏇寸碂**锛氱敤鎴蜂細鐓х潃銆屾湇鍔′技涔庢病鏈夊惎鍔ㄣ��
+ * 鍘绘帓鏌ヤ竴涓牴鏈笉瀛樺湪鐨勯棶棰橈紝杩欐鏄湰椤圭洰宸茬粡韪╄繃涓�娆$殑鍧戙��
+ *
+ * <p>瓒呮椂涔熶笉绛夊悓浜庝笉鍙敤锛屾墍浠ヨ秴鏃跺崟鐙帾杈烇紙瑙� {@link Check}锛夈��
+ * 鍙堜笉鑳界粰澶ぇ锛氳嚜妫�鏄�岄『鎵嬬湅涓�鐪笺�嶇殑杈呭姪淇℃伅锛屼笉璇ユ妸鍚姩鎷栦綇銆�
+ */
+ private static final int PROBE_TIMEOUT_MILLIS = 5000;
+
+ /** 鏃ュ織閲屾渶澶氬垪鍑犱釜妯″瀷鍚嶏紝澶浼氬埛灞� */
+ private static final int MAX_MODELS_IN_LOG = 8;
+
+ /** provider 瀵瑰簲鐨勯厤缃敭锛坰ystem property / 閰嶇疆鏂囦欢閲岄兘鏄繖涓悕瀛楋級 */
+ private static final String KEY_PROVIDER = "webui.llm.provider";
+
+ /** provider 瀵瑰簲鐨勭幆澧冨彉閲忓悕锛坅pplication.yml 閲屽啓鐨勬槸 ${WEBUI_LLM_PROVIDER:...}锛� */
+ private static final String ENV_PROVIDER = "WEBUI_LLM_PROVIDER";
+
private final StorageProperties storageProperties;
+ private final LlmProperties llmProperties;
+ private final ObjectMapper objectMapper;
+ private final com.custom.webui.util.PdfFontSupport pdfFontSupport;
+
+ // ------------------------------------------------------------------
+ // 涓�銆佸瓨鍌ㄤ綅缃�
+ // ------------------------------------------------------------------
@EventListener(ApplicationReadyEvent.class)
public void reportStorageLocations() {
@@ -44,6 +101,9 @@
log.info(" 閰嶇疆鍊� : {}", storageProperties.getLocation());
log.info(" 瀹為檯涓婁紶鐩綍 : {}", uploadRoot);
log.info(" 鐩綍鐘舵�� : {}", describe(uploadRoot));
+ // 椤轰究鎶ヤ竴涓� PDF 瀵煎嚭鐨勫瓧浣擄細鎵句笉鍒颁腑鏂囧瓧浣撴椂 PDF 瀵煎嚭浼氬け璐ワ紝
+ // 鑰岃繖浠朵簨鍦ㄥ惎鍔ㄦ椂璇翠竴鍙ワ紝姣旂瓑鐢ㄦ埛鐐逛簡銆屼笅杞� PDF銆嶅啀鎶ラ敊鍙嬪ソ寰楀
+ log.info(" 瀵煎嚭鑷 : {}", pdfFontSupport.describe());
log.info("=".repeat(66));
}
@@ -61,4 +121,373 @@
}
return "灏氫笉瀛樺湪锛岄娆′笂浼犳椂浼氳嚜鍔ㄥ垱寤�";
}
+
+ // ------------------------------------------------------------------
+ // 浜屻�丩LM 鏈嶅姟
+ // ------------------------------------------------------------------
+
+ @EventListener(ApplicationReadyEvent.class)
+ public void reportLlmEndpoint() {
+ String provider = llmProperties.getProvider();
+ String shadowWarning = providerShadowWarning();
+
+ log.info("=".repeat(66));
+
+ if ("mock".equalsIgnoreCase(provider)) {
+ log.info("LLM 鑷锛歱rovider=mock 鈥斺�� 涓嶈皟鐢ㄤ换浣曠湡瀹炴ā鍨嬶紝鍥炲鐢辨湰鍦版ā鎷熷櫒鐢熸垚");
+ log.info(" 閰嶇疆鏉ユ簮 : {}", providerSource());
+ log.info("=".repeat(66));
+ return;
+ }
+
+ // 鍙湁杩欎袱涓彇鍊间細璧板埌杩欓噷锛歮ock 宸插湪涓婇潰杩斿洖锛�
+ // 鍏朵綑鍙栧�煎湪 Spring 闃舵灏变細鍥犱负鎵句笉鍒� LlmService Bean 鑰屽惎鍔ㄥけ璐ャ��
+ boolean useOllama = "ollama".equalsIgnoreCase(provider);
+ String baseUrl = useOllama
+ ? llmProperties.getOllama().getBaseUrl()
+ : llmProperties.getOpenaiCompat().getBaseUrl();
+ String model = useOllama
+ ? llmProperties.getOllama().getDefaultModel()
+ : llmProperties.getOpenaiCompat().getModel();
+ String chatPath = useOllama ? "/api/chat" : "/chat/completions";
+
+ log.info("LLM 鑷锛坧rovider={}锛�", provider);
+ log.info(" 閰嶇疆鏉ユ簮 : {}", providerSource());
+ // 鎶婃墍鏈夎兘鐩栦綇閰嶇疆鏂囦欢鐨勬潵婧愰兘鎽婂紑鎵撳嚭鏉ャ��
+ // 鎺掓煡銆屾敼浜� yml 涓嶇敓鏁堛�嶆椂锛岀敤鎴峰拰鎴戜滑閮芥棤娉曠洿鎺ョ湅鍒� JVM 鏀跺埌浜嗗摢浜�
+ // 澶栭儴鍙傛暟 鈥斺�� 灏ゅ叾褰� IDE 鐣岄潰閲屾牴鏈壘涓嶅埌閭d釜 -D 鐨勬椂鍊欍��
+ // 杩欓噷涓�娆℃�у垪鍏紝鐪佹帀鍙嶅鐚滅殑鏉ュ洖銆�
+ String sysOverrides = describeSystemPropertyOverrides();
+ if (sysOverrides != null) {
+ log.info(" 绯荤粺灞炴�ц鐩� : {}", sysOverrides);
+ }
+ String envOverrides = describeEnvOverrides();
+ if (envOverrides != null) {
+ log.info(" 鐜鍙橀噺瑕嗙洊 : {}", envOverrides);
+ }
+ log.info(" 瀵硅瘽鍦板潃 : {}{}", trimTrailingSlash(baseUrl), chatPath);
+ log.info(" 榛樿妯″瀷 : {}", model);
+
+ if (shadowWarning != null) {
+ // 浼樺厛浜庤繛閫氭�у憡璀︽墦鍑烘潵锛氳繖鏄�屾敼浜嗛厤缃嵈涓嶇敓鏁堛�嶇殑鏍瑰洜锛�
+ // 涓嶅厛璇存竻妤氾紝鐢ㄦ埛浼氬幓鎬�鐤戠綉缁溿�佹ā鍨嬨�佷唬鐮侊紝鑰屼笉浼氭兂鍒� -D 鍙傛暟
+ log.warn(" 鈿狅笍 {}", shadowWarning);
+ }
+
+ Check check = useOllama ? checkOllama(baseUrl) : checkOpenAiCompat(baseUrl);
+ log.info(" 杩為�氭�� : {}", check.summary());
+ if (check.advice() != null) {
+ log.warn(" 鈿狅笍 {}", check.advice());
+ }
+ log.info("=".repeat(66));
+ }
+
+ /**
+ * provider 鐨�**鐢熸晥鏉ユ簮**锛屽彧鐢ㄤ簬鏃ュ織灞曠ず銆�
+ *
+ * <p>浼樺厛绾т粠楂樺埌浣庯細
+ * <ol>
+ * <li>JVM 绯荤粺灞炴�� {@code -Dwebui.llm.provider=...}</li>
+ * <li>鐜鍙橀噺 {@code WEBUI_LLM_PROVIDER=...}</li>
+ * <li>application.yml / application-{profile}.yml</li>
+ * </ol>
+ */
+ private String providerSource() {
+ if (isSet(System.getProperty(KEY_PROVIDER))) {
+ return "JVM 绯荤粺灞炴�� -D" + KEY_PROVIDER;
+ }
+ if (isSet(System.getenv(ENV_PROVIDER))) {
+ return "鐜鍙橀噺 " + ENV_PROVIDER;
+ }
+ return "application.yml";
+ }
+
+ /**
+ * 銆宲rovider 琚閮ㄦ潵婧愮洊浣忋�嶆椂缁欏嚭鐨勮鍛婏紝娌¤鐩栦綇鍒欒繑鍥� {@code null}銆�
+ *
+ * <p><b>涓轰粈涔堝繀椤绘湁杩欐</b>锛氳俯杩囦竴娆″緢闅惧彈鐨勫潙 鈥斺�� 鐢ㄦ埛宸茬粡鎶�
+ * application.yml 鏀规垚 {@code provider: ${WEBUI_LLM_PROVIDER:openai-compat}}锛�
+ * 閲嶅惎鍚庡嵈**浠嶇劧鍦ㄧ敤 ollama**銆傚師鍥犳槸 IDE 鐨� Run Configuration 閲�
+ * 鐣欑潃 {@code -Dwebui.llm.provider=ollama}锛�
+ *
+ * <p>绯荤粺灞炴�э紙{@code -D}锛変笌 OS 鐜鍙橀噺閮藉睘浜� Spring Boot 鐨�
+ * <b>澶栭儴鍖栭厤缃�</b>锛屼紭鍏堢骇**楂樹簬**浠讳綍 application.yml 鈥斺��
+ * 浜庢槸 yml 閲岄偅涓�琛岃闈欓粯鍘嬩綇锛屾�庝箞鏀归兘娌″弽搴旓紝鑰屼笖涓嶆姤浠讳綍閿欍��
+ * 鐢ㄦ埛鑳界湅鍒扮殑鍙湁銆岄厤缃敼浜嗕絾娌$敓鏁堛�嶏紝寰堝鏄撴��鐤戝埌浠g爜鎴栫紦瀛樹笂銆�
+ *
+ * <p>鎵�浠ヨ繖閲岀洿鎺ユ妸鐢熸晥鏉ユ簮鍜屾�庝箞鏀瑰啓鍦ㄦ棩蹇楅噷銆�
+ */
+ private String providerShadowWarning() {
+ String flag = System.getProperty(KEY_PROVIDER);
+ if (isSet(flag)) {
+ String hint = "銆傜郴缁熷睘鎬т紭鍏堢骇楂樹簬鎵�鏈夐厤缃枃浠� 鈥斺�� "
+ + "浣犲湪 application.yml 閲屾妸 provider 鏀规垚浠�涔堥兘涓嶇敓鏁堬紝杩欎竴琛岃闈欓粯鐩栦綇浜嗐��";
+ String toolOptions = toolOptionsHint();
+ if (toolOptions != null) {
+ // 杩欑鎯呭喌 IDE 鐣岄潰閲�**鏍规湰鎵句笉鍒�**閭d釜 -D锛屽繀椤诲崟鐙鏄庢潵婧�
+ hint = hint + toolOptions;
+ } else {
+ hint = hint + "IDE 鐢ㄦ埛璇锋墦寮� Run 鈫� Edit Configurations鈥︼紝"
+ + "鍦ㄩ�変腑閰嶇疆鐨� VM options 閲屽垹鎺夎繖涓� -D 鍙傛暟锛岀劧鍚庨噸鍚紱"
+ + "鑻ョ晫闈笂纭疄鎵句笉鍒板畠锛岃鎶婁笂涓�琛屻�岀郴缁熷睘鎬ц鐩栥�嶄笌涓嬮潰鐨勭幆澧冨彉閲忎竴璧锋牳瀵广��";
+ }
+ return "provider 鐨勫�兼潵鑷� JVM 绯荤粺灞炴�� -D" + KEY_PROVIDER + "=" + flag + hint;
+ }
+ String env = System.getenv(ENV_PROVIDER);
+ if (isSet(env)) {
+ return "provider 鐨勫�兼潵鑷幆澧冨彉閲� " + ENV_PROVIDER + "=" + env
+ + "銆傜幆澧冨彉閲忎紭鍏堢骇楂樹簬 application.yml锛屾敼 yml 涓嶇敓鏁堛��"
+ + "璇蜂粠鐜鍙橀噺閲屽幓鎺夊畠锛屾垨鐩存帴鏀硅繖涓彉閲忕殑鍊笺��";
+ }
+ return null;
+ }
+
+ /**
+ * 濡傛灉 {@code -D} 鍏跺疄鏄� {@code JAVA_TOOL_OPTIONS} / {@code _JAVA_OPTIONS}
+ * 濉炶繘鏉ョ殑锛岀粰鍑哄搴旇鏄庯紝鍚﹀垯杩斿洖 {@code null}銆�
+ *
+ * <p>杩欎袱涓幆澧冨彉閲忎細琚� **JVM 鑷姩娉ㄥ叆鍒版墍鏈� java 杩涚▼**鐨勫懡浠よ閲岋紝
+ * 琛ㄧ幇涓恒�屽鍑烘潵涓�鍫� -D 鍙傛暟锛屼絾 IDE 鐨� Run Configuration 閲屾�庝箞鎵鹃兘鎵句笉鍒般�嶃��
+ * 鎺掓煡鏃惰繖鏄渶瀹规槗婕忔帀鐨勪竴鏉¤矾寰� 鈥斺�� 鍥犱负瀹冩牴鏈笉鍦� IDE 閲岋紝
+ * 鑰屽湪 IDE 杩涚▼鑷繁鐨勭幆澧冨彉閲忛噷锛堥�氬父鏄� `launchctl setenv` 鎴� shell rc 璁剧殑锛夈��
+ */
+ private String toolOptionsHint() {
+ for (String key : new String[]{"JAVA_TOOL_OPTIONS", "_JAVA_OPTIONS"}) {
+ String value = System.getenv(key);
+ if (isSet(value) && value.contains(KEY_PROVIDER)) {
+ return "娉ㄦ剰锛氳繖涓� -D 鏄幆澧冨彉閲� " + key + " 娉ㄥ叆鐨�"
+ + "锛堝綋鍓嶅�硷細" + value + "锛夛紝瀹冧細琚� JVM 鑷姩鍔犲埌**鎵�鏈�** java 杩涚▼涓婏紝"
+ + "鎵�浠ヤ綘鍦� Edit Configurations 閲屾案杩滄壘涓嶅埌瀹冦��"
+ + "璇锋竻闄よ繖涓幆澧冨彉閲忓悗閲嶅惎 IDE锛坄launchctl unsetenv " + key + "`"
+ + "锛屾垨鍒犳帀 shell 閰嶇疆閲岀殑 export锛夊啀鍚姩鍚庣銆�";
+ }
+ }
+ return null;
+ }
+
+ /** 鍒楀嚭鎵�鏈変互 {@code webui.} 寮�澶寸殑绯荤粺灞炴�э紙鍗� -D 瑕嗙洊椤癸級锛屾病鏈夊垯杩斿洖 null */
+ private String describeSystemPropertyOverrides() {
+ List<String> items = new ArrayList<>();
+ for (String key : System.getProperties().stringPropertyNames()) {
+ if (key.startsWith("webui.")) {
+ items.add(key + "=" + System.getProperty(key));
+ }
+ }
+ if (items.isEmpty()) {
+ return null;
+ }
+ items.sort(String::compareTo);
+ return String.join(", ", items);
+ }
+
+ /** 鍒楀嚭鎵�鏈変笌妯″瀷鏈嶅姟鐩稿叧鐨勭幆澧冨彉閲忥紙鍚� JAVA_TOOL_OPTIONS锛夛紝娌℃湁鍒欒繑鍥� null */
+ private String describeEnvOverrides() {
+ List<String> items = new ArrayList<>();
+ for (String key : System.getenv().keySet()) {
+ boolean relevant = key.startsWith("WEBUI_")
+ || key.startsWith("OLLAMA_")
+ || key.startsWith("OPENAI_COMPAT_")
+ || "JAVA_TOOL_OPTIONS".equals(key)
+ || "_JAVA_OPTIONS".equals(key)
+ || "MAVEN_OPTS".equals(key);
+ if (relevant) {
+ String value = System.getenv(key);
+ // 瀵嗛挜绫诲彧鏄剧ず闀垮害锛岄伩鍏嶆妸 API Key 鍐欒繘鏃ュ織
+ if (key.contains("KEY") || key.contains("SECRET") || key.contains("TOKEN")) {
+ value = "***(闀垮害 " + (value == null ? 0 : value.length()) + ")";
+ }
+ items.add(key + "=" + value);
+ }
+ }
+ if (items.isEmpty()) {
+ return null;
+ }
+ items.sort(String::compareTo);
+ return String.join(", ", items);
+ }
+
+ private boolean isSet(String value) {
+ return value != null && !value.isBlank();
+ }
+
+ /**
+ * provider=ollama锛氭帰 {@code GET <baseUrl>/}銆�
+ *
+ * <p>Ollama 瀹堟姢杩涚▼鐨勬牴璺緞浼氳繑鍥炰竴琛岀函鏂囨湰 {@code Ollama is running}锛�
+ * 杩欐槸鏈�鐪佺殑璇嗗埆鏂瑰紡锛堜笉鐢ㄧ湡鐨勮窇涓�娆℃帹鐞嗭級銆�
+ */
+ private Check checkOllama(String baseUrl) {
+ Response resp = get(trimTrailingSlash(baseUrl) + "/");
+ if (resp.timeout()) {
+ return Check.ok("鎺㈡祴瓒呮椂锛�" + baseUrl + "锛夆�斺�� 涓嶄唬琛ㄤ笉鍙敤锛�"
+ + "鍙兘鍙槸 Ollama 姝e繖鎴栨鍦ㄥ姞杞芥ā鍨�");
+ }
+ if (resp.failure() != null) {
+ return new Check("杩炰笉涓� " + baseUrl + "锛�" + resp.failure() + "锛�",
+ "Ollama 浼间箮娌℃湁鍚姩銆傚厛鎵ц `ollama serve`锛�"
+ + "鑻ヨ琚湰鏈哄叾浠栬繘绋嬭闂紝鍙姞 OLLAMA_HOST=0.0.0.0銆�"
+ + "鑻ヤ綘鍏跺疄鎯崇敤鐨勬槸 OpenAI 鍏煎鏈嶅姟锛岃鎶� webui.llm.provider 鏀规垚 openai-compat銆�");
+ }
+ if (resp.status() == 200 && resp.body().contains("Ollama is running")) {
+ return Check.ok("姝e父锛孫llama 宸插氨缁�");
+ }
+ return new Check("HTTP " + resp.status() + "锛屼絾杩斿洖鍐呭涓嶆槸 Ollama 鐨勬爣璇嗘枃鏈細" + preview(resp.body()),
+ protocolMismatchAdvice(baseUrl));
+ }
+
+ /**
+ * provider=openai-compat锛氭帰 {@code GET <baseUrl>/models}銆�
+ *
+ * <p>閫� {@code /models} 鑰屼笉鏄洿鎺ュ彂涓�娆� chat 璇锋眰锛屾槸鍥犱负瀹冮『甯﹁兘鎷垮埌
+ * **鍙敤妯″瀷鍒楄〃** 鈥斺�� 杩欐牱銆屾ā鍨嬪悕鍐欓敊 / 妯″瀷娌′笅杞姐�嶈繖绫婚棶棰樹篃鑳藉湪
+ * 鍚姩鏃跺氨鍙戠幇锛岃�屼笉鏄瓑鐢ㄦ埛鐐瑰紑瀵硅瘽鎵嶇湅鍒版姤閿欍��
+ */
+ private Check checkOpenAiCompat(String baseUrl) {
+ String modelsUrl = trimTrailingSlash(baseUrl) + "/models";
+ Response resp = get(modelsUrl);
+ if (resp.timeout()) {
+ // 瀹炴祴锛氳浆鍙戝瀷缃戝叧鍦ㄥ喎鍚姩/绻佸繖鏃� /models 鍙兘瓒呮椂锛岃�屽璇濊姹傛湰韬槸姝e父鐨勩��
+ // 鎵�浠ヨ繖閲屼笉涓嬨�屾湇鍔℃病鍚姩銆嶇殑缁撹锛岄伩鍏嶈嚜妫�鑷繁鍒堕�犲亣鏁呴殰銆�
+ return Check.ok("鎺㈡祴瓒呮椂锛�" + modelsUrl + " 鍦� "
+ + PROBE_TIMEOUT_MILLIS + "ms 鍐呮病鏈夊搷搴旓級鈥斺�� 涓嶄唬琛ㄤ笉鍙敤锛�"
+ + "鍙兘鍙槸鏈嶅姟鍦ㄥ喎鍚姩鎴栨蹇欙紱鐪熷疄瀵硅瘽鑻ヤ篃澶辫触鍐嶆寜涓嬮潰鎺掓煡");
+ }
+ if (resp.failure() != null) {
+ return new Check("杩炰笉涓� " + modelsUrl + "锛�" + resp.failure() + "锛�",
+ "妯″瀷鏈嶅姟浼间箮娌℃湁鍚姩銆傛湰鍦伴儴缃茶鍏堟妸瀹冩媺璧锋潵锛�"
+ + "鍦板潃涓嶅鍒欐敼 webui.llm.openaiCompat.base-url锛堟敞鎰忚甯� /v1锛夈��");
+ }
+ if (resp.status() != 200) {
+ String advice = trimTrailingSlash(baseUrl).endsWith("/v1")
+ ? "鍦板潃鍙揪锛屼絾娌℃湁 /v1/models 鎺ュ彛銆傝纭杩欎釜鏈嶅姟瀹炵幇浜� OpenAI 鍏煎鍗忚銆�"
+ : "base-url 闇�瑕佸甫涓� /v1锛堜緥濡� http://127.0.0.1:10020/v1锛夛紝灏戜簡瀹冨氨浼� 404銆�";
+ return new Check("HTTP " + resp.status() + "锛�" + modelsUrl + " 杩斿洖锛�" + preview(resp.body()), advice);
+ }
+
+ List<String> models = parseModelIds(resp.body());
+ String summary = models.isEmpty()
+ ? "姝e父锛堟湇鍔″凡灏辩华锛屼絾 /models 娌℃湁杩斿洖妯″瀷鍒楄〃锛�"
+ : "姝e父锛屽彲鐢ㄦā鍨嬶細" + String.join(", ", models);
+
+ String configured = llmProperties.getOpenaiCompat().getModel();
+ if (!models.isEmpty() && configured != null && !configured.isBlank()
+ && models.stream().noneMatch(m -> m.equals(configured))) {
+ return new Check(summary,
+ "閰嶇疆鐨勬ā鍨嬨��" + configured + "銆嶄笉鍦ㄦ湇鍔¤繑鍥炵殑妯″瀷鍒楄〃閲岋紝"
+ + "瀵硅瘽鏃朵細鎶� model not found銆傝鏀� webui.llm.openaiCompat.model"
+ + "锛堟垨鐢ㄧ幆澧冨彉閲� OPENAI_COMPAT_MODEL 瑕嗙洊锛夈��");
+ }
+ return Check.ok(summary);
+ }
+
+ /**
+ * 鍦板潃鍙揪浣嗐�屼笉鍍� Ollama銆嶆椂璇ユ�庝箞璇淬��
+ *
+ * <p>杩欓噷鍒绘剰鎶娿�屼互 /v1 缁撳熬銆嶅綋鎴愬己淇″彿鍗曠嫭鎻愮ず 鈥斺��
+ * 椤圭洰韪╃殑閭d釜鍧戞鏄� base-url 鍐欐垚浜� {@code http://127.0.0.1:10020}锛�
+ * 瀵规柟鏄� OpenAI 鍏煎鏈嶅姟锛堝嵆渚夸笉甯� /v1锛夛紝鎵�浠ヤ袱绉嶈娉曢兘缁欍��
+ */
+ private String protocolMismatchAdvice(String baseUrl) {
+ String tail = "褰撳墠閰嶇疆涓嬪璇濅細璇锋眰 " + trimTrailingSlash(baseUrl) + "/api/chat锛�"
+ + "瀵规柟娌℃湁杩欎釜璺敱锛屼細杩斿洖 404锛岃�岄敊璇彁绀轰細璇姤鎴愩�屾ā鍨嬫湭涓嬭浇銆嶃��";
+ if (trimTrailingSlash(baseUrl).endsWith("/v1")) {
+ return "base-url 浠� /v1 缁撳熬锛岃繖鏄� OpenAI 鍏煎鏈嶅姟鐨勫湴鍧�锛屼笉鏄� Ollama銆�"
+ + "璇锋妸 webui.llm.provider 鏀规垚 openai-compat锛�"
+ + "鎴栨妸 webui.llm.ollama.base-url 鏀瑰洖 http://127.0.0.1:11434銆�" + tail;
+ }
+ return "杩欎釜鍦板潃涓婅窇鐨勪技涔庝笉鏄� Ollama锛圤llama 鍘熺敓鎺ュ彛鏄� /api/chat锛夈��"
+ + "鑻ュ鏂规槸 OpenAI 鍏煎鏈嶅姟锛坴LLM / LM Studio / SGLang / one-api 绛夛級锛�"
+ + "璇锋妸 webui.llm.provider 璁句负 openai-compat锛屽苟鎶� base-url 閰嶆垚浠� /v1 缁撳熬鐨勫湴鍧�銆�" + tail;
+ }
+
+ /** 浠� {@code {"data":[{"id":"qwen35"},...]}} 閲屽彇妯″瀷鍚嶏紝鍙栦笉鍒板氨杩斿洖绌哄垪琛� */
+ private List<String> parseModelIds(String body) {
+ List<String> ids = new ArrayList<>();
+ try {
+ JsonNode data = objectMapper.readTree(body).path("data");
+ if (data.isArray()) {
+ for (JsonNode item : data) {
+ String id = item.path("id").asText(null);
+ if (id != null && !id.isBlank()) {
+ ids.add(id);
+ }
+ if (ids.size() >= MAX_MODELS_IN_LOG) {
+ ids.add("鈥�");
+ break;
+ }
+ }
+ }
+ } catch (Exception e) {
+ log.debug("瑙f瀽 /models 鍝嶅簲澶辫触锛岃烦杩囨ā鍨嬪垪琛ㄦ鏌�: {}", e.getMessage());
+ }
+ return ids;
+ }
+
+ // ------------------------------------------------------------------
+ // 鏋佺畝 HTTP GET
+ // ------------------------------------------------------------------
+
+ /**
+ * 鑷鐢ㄧ殑 GET銆�
+ *
+ * <p>鐢� {@link HttpURLConnection} 鑰屼笉鏄」鐩噷鍒鐢ㄧ殑 RestTemplate锛�
+ * 杩欓噷鍙渶瑕佷竴涓�屾嬁鍒扮姸鎬佺爜鍜屽嚑琛屾枃鏈�嶇殑鑳藉姏锛岃�屼笖蹇呴』**缁濅笉鎶涘紓甯�** 鈥斺��
+ * 浠讳綍涓�涓嚜妫�澶辫触閮戒笉璇ュ奖鍝嶅惎鍔ㄣ��
+ */
+ private Response get(String url) {
+ HttpURLConnection conn = null;
+ try {
+ conn = (HttpURLConnection) URI.create(url).toURL().openConnection();
+ conn.setRequestMethod("GET");
+ conn.setConnectTimeout(PROBE_TIMEOUT_MILLIS);
+ conn.setReadTimeout(PROBE_TIMEOUT_MILLIS);
+ int status = conn.getResponseCode();
+ InputStream in = status >= 400 ? conn.getErrorStream() : conn.getInputStream();
+ String body = in == null ? "" : new String(in.readAllBytes(), StandardCharsets.UTF_8);
+ return new Response(status, body, null, false);
+ } catch (java.net.SocketTimeoutException e) {
+ // 鍗曠嫭璇嗗埆瓒呮椂锛氬畠鍜屻�岃繛鎺ヨ鎷掋�嶆槸瀹屽叏涓嶅悓鐨勭粨璁猴紝
+ // 娣峰湪涓�璧蜂細璁╀汉璇互涓烘湇鍔℃病璧凤紙瀹炴祴韪╄繃锛岃 PROBE_TIMEOUT_MILLIS 鐨勬敞閲婏級
+ return new Response(-1, "", "瓒呮椂锛�" + PROBE_TIMEOUT_MILLIS + "ms 鍐呮病鏈夊搷搴旓級", true);
+ } catch (Exception e) {
+ // 杩炴帴琚嫆 / DNS 澶辫触绛�
+ return new Response(-1, "", e.getClass().getSimpleName()
+ + (e.getMessage() == null ? "" : ": " + e.getMessage()), false);
+ } finally {
+ if (conn != null) {
+ conn.disconnect();
+ }
+ }
+ }
+
+ /** 鎶婂搷搴斾綋鍘嬫垚涓�琛岀煭棰勮锛岄『渚垮幓鎺� NUL 绛夋帶鍒跺瓧绗︼紙鏌愪簺鏈嶅姟浼氳繑鍥炰竴闀夸覆锛� */
+ private String preview(String body) {
+ if (body == null || body.isBlank()) {
+ return "(绌�)";
+ }
+ String cleaned = body.replaceAll("[\\p{Cntrl}&&[^\r\n\t]]", "").replaceAll("\\s+", " ").trim();
+ return cleaned.length() > 120 ? cleaned.substring(0, 120) + "鈥�" : cleaned;
+ }
+
+ private String trimTrailingSlash(String url) {
+ if (url == null) {
+ return "";
+ }
+ String s = url.trim();
+ while (s.endsWith("/")) {
+ s = s.substring(0, s.length() - 1);
+ }
+ return s;
+ }
+
+ /** 鍗曚釜妫�鏌ラ」鐨勭粨璁猴細涓�琛屾憳瑕� + 鍙�変慨澶嶅缓璁紙鏈夊缓璁椂鎸� WARN 鎵擄級 */
+ private record Check(String summary, String advice) {
+ static Check ok(String summary) {
+ return new Check(summary, null);
+ }
+ }
+
+ /** 鎺㈡祴缁撴灉锛歠ailure 闈炵┖琛ㄧず鍘嬫牴娌¤繛涓婏紱timeout 涓� true 鏃� failure 鎻忚堪瓒呮椂 */
+ private record Response(int status, String body, String failure, boolean timeout) {
+ }
}
--
Gitblit v1.9.1