From 1abe308742cde32a6ac90b9ca0b18b7d629b6890 Mon Sep 17 00:00:00 2001
From: ekko <152005280+EKKOLearnAI@users.noreply.github.com>
Date: Thu, 23 Apr 2026 12:57:42 +0800
Subject: [PATCH] feat: add Node.js version warning, fix provider URL
 detection, and add v0.4.4 changelog (#146)

- Display persistent warning bar when Node.js version < 23
- Fix provider model fetching to support non-v1 API versions (e.g. /v4)
- Add v0.4.4 changelog entries to frontend
- Bump version to 0.4.4

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
---
 package.json                                  |  2 +-
 packages/client/src/App.vue                   | 27 +++++++++++++++++++
 packages/client/src/api/hermes/system.ts      |  1 +
 .../hermes/models/ProviderFormModal.vue       |  2 +-
 packages/client/src/data/changelog.ts         |  5 ++++
 packages/client/src/i18n/locales/de.ts        |  6 +++++
 packages/client/src/i18n/locales/en.ts        |  5 ++++
 packages/client/src/i18n/locales/es.ts        |  6 +++++
 packages/client/src/i18n/locales/fr.ts        |  6 +++++
 packages/client/src/i18n/locales/ja.ts        |  6 +++++
 packages/client/src/i18n/locales/ko.ts        |  6 +++++
 packages/client/src/i18n/locales/pt.ts        |  6 +++++
 packages/client/src/i18n/locales/zh.ts        |  6 +++++
 packages/client/src/stores/hermes/app.ts      |  3 +++
 packages/server/src/controllers/health.ts     |  1 +
 .../server/src/services/config-helpers.ts     |  2 +-
 16 files changed, 87 insertions(+), 3 deletions(-)

diff --git a/package.json b/package.json
index f91b596..234144b 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "hermes-web-ui",
-  "version": "0.4.3",
+  "version": "0.4.4",
   "description": "Self-hosted AI chat dashboard for Hermes Agent — multi-model (Claude, GPT, Gemini, DeepSeek) web UI with Telegram, Discord, Slack, WhatsApp integration",
   "repository": {
     "type": "git",
diff --git a/packages/client/src/App.vue b/packages/client/src/App.vue
index f5d58f0..5dab6e0 100644
--- a/packages/client/src/App.vue
+++ b/packages/client/src/App.vue
@@ -2,6 +2,7 @@
 import { onMounted, onUnmounted, computed, ref, watch } from 'vue'
 import { useRoute, useRouter } from 'vue-router'
 import { darkTheme, NConfigProvider, NMessageProvider, NDialogProvider, NNotificationProvider } from 'naive-ui'
+import { useI18n } from 'vue-i18n'
 import { getThemeOverrides } from '@/styles/theme'
 import { useTheme } from '@/composables/useTheme'
 import AppSidebar from '@/components/layout/AppSidebar.vue'
@@ -10,6 +11,7 @@ import { useAppStore } from '@/stores/hermes/app'
 import SessionSearchModal from '@/components/hermes/chat/SessionSearchModal.vue'
 
 const { isDark } = useTheme()
+const { t } = useI18n()
 const appStore = useAppStore()
 const route = useRoute()
 const router = useRouter()
@@ -20,6 +22,12 @@ const naiveTheme = computed(() => isDark.value ? darkTheme : null)
 
 const isLoginPage = computed(() => route.name === 'login')
 
+const nodeVersionLow = computed(() => {
+  const v = appStore.nodeVersion
+  const major = parseInt(v.split('.')[0], 10)
+  return !isNaN(major) && major < 23
+})
+
 // Close mobile sidebar on route change
 watch(() => route.path, () => {
   appStore.closeSidebar()
@@ -49,6 +57,9 @@ useKeyboard()
     <NMessageProvider>
       <NDialogProvider>
         <NNotificationProvider>
+          <div v-if="nodeVersionLow && ready" class="node-warning-bar">
+            {{ t('sidebar.nodeVersionWarning', { version: appStore.nodeVersion }) }}
+          </div>
           <div v-if="ready" class="app-layout" :class="{ 'no-sidebar': isLoginPage }">
             <button v-if="!isLoginPage" class="hamburger-btn" @click="appStore.toggleSidebar">
               <img src="/logo.png" alt="Menu" style="width: 24px; height: 24px;" />
@@ -89,4 +100,20 @@ useKeyboard()
     height: calc(100 * var(--vh));
   }
 }
+
+.node-warning-bar {
+  position: absolute;
+  top: 0;
+  left: 0;
+  width: 100%;
+  z-index: 100;
+  padding: 4px 16px;
+  font-size: 12px;
+  font-weight: 500;
+  color: #b45309;
+  background-color: #fef3c7;
+  border-bottom: 1px solid #fde68a;
+  text-align: center;
+  line-height: 1.4;
+}
 </style>
diff --git a/packages/client/src/api/hermes/system.ts b/packages/client/src/api/hermes/system.ts
index 16c3f06..513a2b3 100644
--- a/packages/client/src/api/hermes/system.ts
+++ b/packages/client/src/api/hermes/system.ts
@@ -6,6 +6,7 @@ export interface HealthResponse {
   webui_version?: string
   webui_latest?: string
   webui_update_available?: boolean
+  node_version?: string
 }
 
 // Config-based model types
diff --git a/packages/client/src/components/hermes/models/ProviderFormModal.vue b/packages/client/src/components/hermes/models/ProviderFormModal.vue
index fc945d7..e9643d9 100644
--- a/packages/client/src/components/hermes/models/ProviderFormModal.vue
+++ b/packages/client/src/components/hermes/models/ProviderFormModal.vue
@@ -95,7 +95,7 @@ async function fetchModels() {
   fetchingModels.value = true
   try {
     const base = base_url.replace(/\/+$/, '')
-    const url = base.endsWith('/v1') ? `${base}/models` : `${base}/v1/models`
+    const url = /\/v\d+\/?$/.test(base) ? `${base}/models` : `${base}/v1/models`
     const headers: Record<string, string> = {}
     if (formData.value.api_key.trim()) {
       headers['Authorization'] = `Bearer ${formData.value.api_key.trim()}`
diff --git a/packages/client/src/data/changelog.ts b/packages/client/src/data/changelog.ts
index da41214..2cabc64 100644
--- a/packages/client/src/data/changelog.ts
+++ b/packages/client/src/data/changelog.ts
@@ -5,6 +5,11 @@ export interface ChangelogEntry {
 }
 
 export const changelog: ChangelogEntry[] = [
+  {
+    version: '0.4.4',
+    date: '2026-04-23',
+    changes: ['changelog.new_0_4_4_1', 'changelog.new_0_4_4_2', 'changelog.new_0_4_4_3', 'changelog.new_0_4_4_4', 'changelog.new_0_4_4_5'],
+  },
   {
     version: '0.4.3',
     date: '2026-04-22',
diff --git a/packages/client/src/i18n/locales/de.ts b/packages/client/src/i18n/locales/de.ts
index 5379296..e24b9c8 100644
--- a/packages/client/src/i18n/locales/de.ts
+++ b/packages/client/src/i18n/locales/de.ts
@@ -84,6 +84,7 @@ export default {
     updateSuccess: 'Aktualisierung abgeschlossen, bitte Server neu starten',
     updateFailed: 'Aktualisierung fehlgeschlagen',
     logout: 'Abmelden',
+    nodeVersionWarning: 'Node.js v{version} erkannt. Version 23+ wird fur volle Funktionalitat benotigt (SQLite, node-pty).',
     changelog: 'Anderungsprotokoll',
     noChangelog: 'Kein Anderungsprotokoll verfugbar',
   },
@@ -510,6 +511,11 @@ export default {
 
   // Anderungsprotokoll
   changelog: {
+    new_0_4_4_1: 'Dateibrowser mit Multi-Backend-Unterstutzung hinzugefugt (local/Docker/SSH/Singularity)',
+    new_0_4_4_2: 'Dateidownload aus Chat-Nachrichtenanhangen hinzugefugt',
+    new_0_4_4_3: 'Live-Badge auf aktiven Chat-Sitzungen hinzugefugt',
+    new_0_4_4_4: 'StepFun- und Nous-Portal-Provider-Unterstutzung hinzugefugt',
+    new_0_4_4_5: 'Spezialzeichen-Suche verursacht 500-Fehler behoben',
     new_0_4_3_1: 'Benutzername/Passwort-Login neben Token-Authentifizierung hinzugefugt',
     new_0_4_3_2: 'Kontoeinstellungen fur Anmeldeinformationen hinzugefugt',
     new_0_4_3_3: 'Abmelden-Schaltflache in der Seitenleiste hinzugefugt',
diff --git a/packages/client/src/i18n/locales/en.ts b/packages/client/src/i18n/locales/en.ts
index 421878c..97120f7 100644
--- a/packages/client/src/i18n/locales/en.ts
+++ b/packages/client/src/i18n/locales/en.ts
@@ -612,6 +612,11 @@ export default {
 
   // Changelog
   changelog: {
+    new_0_4_4_1: 'Add file browser with multi-backend support (local/Docker/SSH/Singularity)',
+    new_0_4_4_2: 'Add file download from chat message attachments',
+    new_0_4_4_3: 'Add live badge on active chat sessions',
+    new_0_4_4_4: 'Add StepFun and Nous Portal provider support',
+    new_0_4_4_5: 'Fix special character search queries causing 500 error',
     new_0_4_3_1: 'Add username/password login alongside token authentication',
     new_0_4_3_2: 'Add account settings for managing credentials (setup, change password, change username)',
     new_0_4_3_3: 'Add logout button to sidebar',
diff --git a/packages/client/src/i18n/locales/es.ts b/packages/client/src/i18n/locales/es.ts
index d9063ea..747ec46 100644
--- a/packages/client/src/i18n/locales/es.ts
+++ b/packages/client/src/i18n/locales/es.ts
@@ -84,6 +84,7 @@ export default {
     updateSuccess: 'Actualizacion completa, por favor reinicia el servidor',
     updateFailed: 'Error al actualizar',
     logout: 'Cerrar sesion',
+    nodeVersionWarning: 'Node.js v{version} detectado. Se requiere la version 23+ para todas las funcionalidades (SQLite, node-pty).',
     changelog: 'Registro de cambios',
     noChangelog: 'No hay registro de cambios',
   },
@@ -510,6 +511,11 @@ export default {
 
   // Registro de cambios
   changelog: {
+    new_0_4_4_1: 'Agregar explorador de archivos con soporte multi-backend (local/Docker/SSH/Singularity)',
+    new_0_4_4_2: 'Agregar descarga de archivos desde archivos adjuntos del chat',
+    new_0_4_4_3: 'Agregar indicador en vivo en sesiones de chat activas',
+    new_0_4_4_4: 'Agregar soporte para proveedores StepFun y Nous Portal',
+    new_0_4_4_5: 'Corregir error 500 al buscar con caracteres especiales',
     new_0_4_3_1: 'Agregar inicio de sesion con usuario/contrasena junto a autenticacion por token',
     new_0_4_3_2: 'Agregar configuracion de cuenta para gestionar credenciales',
     new_0_4_3_3: 'Agregar boton de cerrar sesion en la barra lateral',
diff --git a/packages/client/src/i18n/locales/fr.ts b/packages/client/src/i18n/locales/fr.ts
index dcfda12..0231f1c 100644
--- a/packages/client/src/i18n/locales/fr.ts
+++ b/packages/client/src/i18n/locales/fr.ts
@@ -84,6 +84,7 @@ export default {
     updateSuccess: 'Mise a jour terminee, veuillez redemarrer le serveur',
     updateFailed: 'Echec de la mise a jour',
     logout: 'Deconnexion',
+    nodeVersionWarning: 'Node.js v{version} detecte. La version 23+ est requise pour toutes les fonctionnalites (SQLite, node-pty).',
     changelog: 'Journal des modifications',
     noChangelog: 'Aucun journal disponible',
   },
@@ -510,6 +511,11 @@ export default {
 
   // Journal des modifications
   changelog: {
+    new_0_4_4_1: 'Ajout du navigateur de fichiers avec support multi-backend (local/Docker/SSH/Singularity)',
+    new_0_4_4_2: 'Ajout du telechargement de fichiers depuis les pieces jointes',
+    new_0_4_4_3: 'Ajout du badge en direct sur les sessions actives',
+    new_0_4_4_4: 'Ajout du support des fournisseurs StepFun et Nous Portal',
+    new_0_4_4_5: 'Correction de l\'erreur 500 lors de la recherche avec caracteres speciaux',
     new_0_4_3_1: 'Ajouter la connexion par nom d\'utilisateur/mot de passe en plus du token',
     new_0_4_3_2: 'Ajouter les parametres de compte pour gerer les identifiants',
     new_0_4_3_3: 'Ajouter le bouton de deconnexion dans la barre laterale',
diff --git a/packages/client/src/i18n/locales/ja.ts b/packages/client/src/i18n/locales/ja.ts
index c9bbb05..1f436ee 100644
--- a/packages/client/src/i18n/locales/ja.ts
+++ b/packages/client/src/i18n/locales/ja.ts
@@ -84,6 +84,7 @@ export default {
     updateSuccess: '更新が完了しました。サーバーを再起動してください',
     updateFailed: '更新に失敗しました',
     logout: 'ログアウト',
+    nodeVersionWarning: 'Node.js v{version} が検出されました。全機能にはバージョン23+が必要です（SQLite、node-pty）。',
     changelog: '更新履歴',
     noChangelog: '更新履歴はありません',
   },
@@ -510,6 +511,11 @@ export default {
 
   // 更新履歴
   changelog: {
+    new_0_4_4_1: 'ファイルブラウザを追加（local/Docker/SSH/Singularity対応）',
+    new_0_4_4_2: 'チャットメッセージの添付ファイルダウンロードを追加',
+    new_0_4_4_3: 'アクティブセッションにライブバッジを表示',
+    new_0_4_4_4: 'StepFunとNous Portalプロバイダーに対応',
+    new_0_4_4_5: '特殊文字検索で500エラーになる問題を修正',
     new_0_4_3_1: 'トークン認証に加えてユーザー名/パスワードログインを追加',
     new_0_4_3_2: '資格情報管理のためのアカウント設定を追加',
     new_0_4_3_3: 'サイドバーにログアウトボタンを追加',
diff --git a/packages/client/src/i18n/locales/ko.ts b/packages/client/src/i18n/locales/ko.ts
index 6b8a830..d595d43 100644
--- a/packages/client/src/i18n/locales/ko.ts
+++ b/packages/client/src/i18n/locales/ko.ts
@@ -84,6 +84,7 @@ export default {
     updateSuccess: '업데이트 완료, 서버를 재시작해 주세요',
     updateFailed: '업데이트 실패',
     logout: '로그아웃',
+    nodeVersionWarning: 'Node.js v{version}이(가) 감지되었습니다. 전체 기능에는 버전 23+가 필요합니다(SQLite, node-pty).',
     changelog: '변경 이력',
     noChangelog: '변경 이력이 없습니다',
   },
@@ -510,6 +511,11 @@ export default {
 
   // 변경 이력
   changelog: {
+    new_0_4_4_1: '파일 브라우저 추가 (local/Docker/SSH/Singularity 지원)',
+    new_0_4_4_2: '채팅 메시지 첨부 파일 다운로드 추가',
+    new_0_4_4_3: '활성 세션에 라이브 배지 표시',
+    new_0_4_4_4: 'StepFun 및 Nous Portal 프로바이더 지원 추가',
+    new_0_4_4_5: '특수문자 검색 시 500 에러 수정',
     new_0_4_3_1: '토큰 인증과 함께 사용자 이름/비밀번호 로그인 추가',
     new_0_4_3_2: '자격 증명 관리를 위한 계정 설정 추가',
     new_0_4_3_3: '사이드바에 로그아웃 버튼 추가',
diff --git a/packages/client/src/i18n/locales/pt.ts b/packages/client/src/i18n/locales/pt.ts
index a694b33..55d2311 100644
--- a/packages/client/src/i18n/locales/pt.ts
+++ b/packages/client/src/i18n/locales/pt.ts
@@ -84,6 +84,7 @@ export default {
     updateSuccess: 'Atualizacao concluida, por favor reinicie o servidor',
     updateFailed: 'Falha na atualizacao',
     logout: 'Sair',
+    nodeVersionWarning: 'Node.js v{version} detectado. A versao 23+ e necessaria para todas as funcionalidades (SQLite, node-pty).',
     changelog: 'Registro de alteracoes',
     noChangelog: 'Nenhum registro disponivel',
   },
@@ -510,6 +511,11 @@ export default {
 
   // Registro de alteracoes
   changelog: {
+    new_0_4_4_1: 'Adicionar navegador de arquivos com suporte multi-backend (local/Docker/SSH/Singularity)',
+    new_0_4_4_2: 'Adicionar download de arquivos dos anexos de chat',
+    new_0_4_4_3: 'Adicionar indicador ao vivo nas sessoes de chat ativas',
+    new_0_4_4_4: 'Adicionar suporte para provedores StepFun e Nous Portal',
+    new_0_4_4_5: 'Corrigir erro 500 ao pesquisar com caracteres especiais',
     new_0_4_3_1: 'Adicionar login por usuario/senha junto com autenticacao por token',
     new_0_4_3_2: 'Adicionar configuracoes de conta para gerenciar credenciais',
     new_0_4_3_3: 'Adicionar botao de sair na barra lateral',
diff --git a/packages/client/src/i18n/locales/zh.ts b/packages/client/src/i18n/locales/zh.ts
index e501ead..5ef7226 100644
--- a/packages/client/src/i18n/locales/zh.ts
+++ b/packages/client/src/i18n/locales/zh.ts
@@ -97,6 +97,7 @@ export default {
     updateSuccess: '更新完成，请重启服务',
     updateFailed: '更新失败',
     logout: '退出登录',
+    nodeVersionWarning: '检测到 Node.js v{version}，请升级到23以上版本。',
     changelog: '更新日志',
     noChangelog: '暂无更新日志',
   },
@@ -614,6 +615,11 @@ export default {
 
   // 更新日志
   changelog: {
+    new_0_4_4_1: '新增文件浏览器，支持多后端（本地/Docker/SSH/Singularity）',
+    new_0_4_4_2: '新增聊天消息附件文件下载',
+    new_0_4_4_3: '活跃会话显示实时状态标签',
+    new_0_4_4_4: '新增 StepFun 和 Nous Portal Provider 支持',
+    new_0_4_4_5: '修复特殊字符搜索导致 500 错误',
     new_0_4_3_1: '新增用户名/密码登录，支持与令牌认证并存',
     new_0_4_3_2: '新增账户设置：配置密码、修改密码、修改用户名',
     new_0_4_3_3: '侧边栏新增退出登录按钮',
diff --git a/packages/client/src/stores/hermes/app.ts b/packages/client/src/stores/hermes/app.ts
index 9267417..70d85f6 100644
--- a/packages/client/src/stores/hermes/app.ts
+++ b/packages/client/src/stores/hermes/app.ts
@@ -20,6 +20,7 @@ export const useAppStore = defineStore('app', () => {
   const selectedModel = ref('')
   const selectedProvider = ref('')
   const healthPollTimer = ref<ReturnType<typeof setInterval>>()
+  const nodeVersion = ref('')
 
   // Settings
   const streamEnabled = ref(true)
@@ -47,6 +48,7 @@ export const useAppStore = defineStore('app', () => {
       if (res.webui_version) serverVersion.value = res.webui_version
       if (res.webui_latest) latestVersion.value = res.webui_latest
       updateAvailable.value = !!res.webui_update_available
+      if (res.node_version) nodeVersion.value = res.node_version
     } catch {
       connected.value = false
     }
@@ -115,6 +117,7 @@ export const useAppStore = defineStore('app', () => {
     connected,
     serverVersion,
     latestVersion,
+    nodeVersion,
     updateAvailable,
     updating,
     doUpdate,
diff --git a/packages/server/src/controllers/health.ts b/packages/server/src/controllers/health.ts
index 09ee37e..8a5692d 100644
--- a/packages/server/src/controllers/health.ts
+++ b/packages/server/src/controllers/health.ts
@@ -48,6 +48,7 @@ export async function healthCheck(ctx: any) {
     webui_version: LOCAL_VERSION,
     webui_latest: cachedLatestVersion,
     webui_update_available: cachedLatestVersion && cachedLatestVersion !== LOCAL_VERSION,
+    node_version: process.versions.node,
   }
 }
 
diff --git a/packages/server/src/services/config-helpers.ts b/packages/server/src/services/config-helpers.ts
index be11df4..84cbae5 100644
--- a/packages/server/src/services/config-helpers.ts
+++ b/packages/server/src/services/config-helpers.ts
@@ -182,7 +182,7 @@ export async function listFilesRecursive(dir: string, prefix: string): Promise<{
 
 export async function fetchProviderModels(baseUrl: string, apiKey: string): Promise<string[]> {
   const base = baseUrl.replace(/\/+$/, '')
-  const modelsUrl = base.endsWith('/v1') ? `${base}/models` : `${base}/v1/models`
+  const modelsUrl = /\/v\d+\/?$/.test(base) ? `${base}/models` : `${base}/v1/models`
   try {
     const res = await fetch(modelsUrl, {
       headers: { Authorization: `Bearer ${apiKey}` },