添加回复字数限制设置功能 (#638)

* 添加回复字数限制设置功能

设置存储白名单、优先从用户设置读取
用户修改设置后立即生效，无需重启会话

* 修复Ruff警告;修复异常处理缺少初始化;修复滑条布局错误;修复bool被误判为int;统一前后端默认值350;添加功能范围说明;固定设置面板宽度

Author: MingTianSang

main_logic/core.py

@@ -18,6 +18,7 @@
 from main_logic.omni_realtime_client import OmniRealtimeClient
 from main_logic.omni_offline_client import OmniOfflineClient
 from main_logic.tts_client import get_tts_worker
+from utils.preferences import load_global_conversation_settings
 from config import MEMORY_SERVER_PORT, TOOL_SERVER_PORT
 from config.prompts_sys import (
     _loc,
@@ -280,12 +281,20 @@ def __init__(self, sync_message_queue, lanlan_name, lanlan_prompt):
 
     def _get_text_guard_max_length(self) -> int:
         try:
-            value = int(self._config_manager.get_core_config().get('TEXT_GUARD_MAX_LENGTH', 300))
-            if value <= 0:
+            # 优先从对话设置中读取，如果不存在则从核心配置读取
+            conversation_settings = load_global_conversation_settings()
+            if 'textGuardMaxLength' in conversation_settings:
+                value = int(conversation_settings['textGuardMaxLength'])
+            else:
+                value = int(self._config_manager.get_core_config().get('TEXT_GUARD_MAX_LENGTH', 350))
+            # 0 表示无限制，返回一个很大的数
+            if value == 0:
+                return 999999
+            if value < 0:
                 raise ValueError
             return value
         except Exception:
-            return 300
+            return 350
 
     async def _clear_tts_pipeline(self):
         """清空 TTS 请求/响应队列和待处理缓存，停止当前合成。"""
@@ -2106,6 +2115,9 @@ async def trigger_agent_callbacks(self) -> None:
                     async with self.lock:
                         self.current_speech_id = str(uuid4())
                     logger.debug("[%s] trigger_agent_callbacks: text session ready, calling stream_proactive", self.lanlan_name)
+                    # 更新字数限制（可能用户在对话期间修改了设置）
+                    if hasattr(self.session, 'update_max_response_length'):
+                        self.session.update_max_response_length(self._get_text_guard_max_length())
                     self.pending_agent_callbacks.clear()
                     delivered = await self.session.stream_proactive(instruction)
                     logger.debug("[%s] trigger_agent_callbacks: text session stream_proactive delivered=%s", self.lanlan_name, delivered)
@@ -2125,6 +2137,9 @@ async def trigger_agent_callbacks(self) -> None:
                     async with self._proactive_write_lock:
                         async with self.lock:
                             self.current_speech_id = str(uuid4())
+                        # 更新字数限制（可能用户在对话期间修改了设置）
+                        if hasattr(self.session, 'update_max_response_length'):
+                            self.session.update_max_response_length(self._get_text_guard_max_length())
                         self.pending_agent_callbacks.clear()
                         delivered = await self.session.stream_proactive(instruction)
                         if delivered:
@@ -2546,6 +2561,10 @@ async def _process_stream_data_internal(self, message: dict):
 
                 # 文本模式：直接发送文本
                 if isinstance(data, str):
+                    # 更新字数限制（可能用户在对话期间修改了设置）
+                    if hasattr(self.session, 'update_max_response_length'):
+                        self.session.update_max_response_length(self._get_text_guard_max_length())
+
                     # 先打断当前正在播放的语音（旧speech_id），避免误打断新回复
                     async with self.lock:
                         interrupted_speech_id = self.current_speech_id

main_logic/omni_offline_client.py

@@ -119,6 +119,12 @@ def __init__(
 
         # 质量守卫回调：由 core.py 设置，用于通知前端清理气泡
 
+    def update_max_response_length(self, max_length: int) -> None:
+        """更新回复字数限制(用户可能在对话期间修改设置)"""
+        if isinstance(max_length, int) and max_length >= 0:
+            self.max_response_length = max_length if max_length > 0 else 999999
+            logger.debug(f"OmniOfflineClient: 字数限制已更新为 {max_length}")
+
     def _match_name_prefix(self, text: str, name: str) -> int:
         """Check if text starts with a name prefix like 'Name | ' or 'Name |'.
         Returns the length of the matched prefix, or 0 if no match.

static/app-settings.js

@@ -35,7 +35,8 @@
             focusModeEnabled: S.focusModeEnabled,
             proactiveChatInterval: S.proactiveChatInterval,
             proactiveVisionInterval: S.proactiveVisionInterval,
-            subtitleEnabled: S.subtitleEnabled
+            subtitleEnabled: S.subtitleEnabled,
+            textGuardMaxLength: S.textGuardMaxLength
         };
         // 只有在 S 上存在 userLanguage 属性时才包含（含 null，支持显式清除语义）
         if ('userLanguage' in S) {
@@ -170,6 +171,9 @@
         const currentMemeChat = typeof window.proactiveMemeEnabled !== 'undefined'
             ? window.proactiveMemeEnabled
             : S.proactiveMemeEnabled;
+        const currentTextGuardMaxLength = typeof window.textGuardMaxLength !== 'undefined'
+            ? window.textGuardMaxLength
+            : S.textGuardMaxLength;
         const currentRenderQuality = typeof window.renderQuality !== 'undefined'
             ? window.renderQuality
             : S.renderQuality;
@@ -203,6 +207,7 @@
             focusModeEnabled: currentFocus,
             proactiveChatInterval: currentProactiveChatInterval,
             proactiveVisionInterval: currentProactiveVisionInterval,
+            textGuardMaxLength: currentTextGuardMaxLength,
             renderQuality: currentRenderQuality,
             targetFrameRate: currentTargetFrameRate,
             mouseTrackingEnabled: currentMouseTracking,
@@ -233,11 +238,15 @@
         S.focusModeEnabled = currentFocus;
         S.proactiveChatInterval = currentProactiveChatInterval;
         S.proactiveVisionInterval = currentProactiveVisionInterval;
+        S.textGuardMaxLength = currentTextGuardMaxLength;
         S.renderQuality = currentRenderQuality;
         S.targetFrameRate = currentTargetFrameRate;
         // 同步字幕设置到共享状态
         S.subtitleEnabled = currentSubtitleEnabled;
         S.userLanguage = currentUserLanguage;
+
+        // 同步到服务器（异步，不阻塞）
+        syncSettingsToServer();
     }
 
     // ======================== loadSettings ========================
@@ -306,6 +315,9 @@
                 S.focusModeEnabled = settings.focusModeEnabled ?? false;
                 S.proactiveChatInterval = settings.proactiveChatInterval ?? C.DEFAULT_PROACTIVE_CHAT_INTERVAL;
                 S.proactiveVisionInterval = settings.proactiveVisionInterval ?? C.DEFAULT_PROACTIVE_VISION_INTERVAL;
+                // 字数限制设置（默认350字）
+                S.textGuardMaxLength = settings.textGuardMaxLength ?? 350;
+                window.textGuardMaxLength = S.textGuardMaxLength;
                 // 画质设置
                 S.renderQuality = settings.renderQuality ?? 'medium';
                 window.cursorFollowPerformanceLevel = U.mapRenderQualityToFollowPerf(S.renderQuality);
@@ -367,6 +379,9 @@
                 // 首次启动默认开启音乐/meme搭话
                 S.proactiveMusicEnabled = true;
                 S.proactiveMemeEnabled = true;
+                // 首次启动默认字数限制为350
+                S.textGuardMaxLength = 350;
+                window.textGuardMaxLength = 350;
 
                 console.log('未找到保存的设置，使用默认值');
                 window.cursorFollowPerformanceLevel = U.mapRenderQualityToFollowPerf(S.renderQuality);
@@ -381,6 +396,8 @@
         } catch (error) {
             console.error('加载本地设置失败:', error);
             // 出错时也要确保全局变量被初始化
+            S.textGuardMaxLength = 350;
+            window.textGuardMaxLength = 350;
             window.cursorFollowPerformanceLevel = U.mapRenderQualityToFollowPerf(S.renderQuality);
             window.mouseTrackingEnabled = true;
             window.live2dFullscreenTrackingEnabled = false;
@@ -428,6 +445,7 @@
                         window.focusModeEnabled = S.focusModeEnabled;
                         window.proactiveChatInterval = S.proactiveChatInterval;
                         window.proactiveVisionInterval = S.proactiveVisionInterval;
+                        window.textGuardMaxLength = S.textGuardMaxLength;
                         // 同步回 localStorage
                         saveSettings();
                         // 重新初始化主动搭话调度器（使用最新标志）

static/avatar-ui-popup.js

@@ -430,7 +430,8 @@ function createChatSettingsSidePanel(manager, prefix, popup) {
     container.style.flexDirection = 'column';
     container.style.alignItems = 'stretch';
     container.style.gap = '2px';
-    container.style.minWidth = '160px';
+    container.style.width = '200px';
+    container.style.minWidth = '0';
     container.style.padding = '4px 4px';
 
     const chatToggles = [
@@ -443,10 +444,187 @@ function createChatSettingsSidePanel(manager, prefix, popup) {
         container.appendChild(toggleItem);
     });
 
+    // 字数限制滑动条
+    const textGuardContainer = manager._createTextGuardSlider();
+    container.appendChild(textGuardContainer);
+
     document.body.appendChild(container);
     return container;
 }
 
+/**
+ * 创建字数限制滑动条
+ */
+function createTextGuardSlider(manager, prefix) {
+    const container = document.createElement('div');
+    Object.assign(container.style, {
+        display: 'flex',
+        flexDirection: 'column',
+        gap: '4px',
+        padding: '4px 0'
+    });
+
+    // 标签和数值行
+    const labelRow = document.createElement('div');
+    Object.assign(labelRow.style, {
+        display: 'flex',
+        justifyContent: 'space-between',
+        alignItems: 'center',
+        gap: '8px'
+    });
+
+    const label = document.createElement('span');
+    label.textContent = window.t ? window.t('settings.toggles.textGuardMaxLength') : '回复字数限制';
+    label.setAttribute('data-i18n', 'settings.toggles.textGuardMaxLength');
+    Object.assign(label.style, {
+        fontSize: '12px',
+        color: 'var(--neko-popup-text, #333)',
+        flexShrink: '0'
+    });
+
+    const valueDisplay = document.createElement('span');
+    Object.assign(valueDisplay.style, {
+        fontSize: '12px',
+        color: 'var(--neko-popup-active, #2a7bc4)',
+        fontWeight: '500',
+        minWidth: '60px',
+        textAlign: 'right'
+    });
+
+    labelRow.appendChild(label);
+    labelRow.appendChild(valueDisplay);
+
+    // 滑动条行
+    const sliderRow = document.createElement('div');
+    Object.assign(sliderRow.style, {
+        display: 'flex',
+        alignItems: 'center',
+        gap: '8px',
+        width: '100%'
+    });
+
+    const slider = document.createElement('input');
+    slider.type = 'range';
+    // 滑动条位置：0-10 对应 50-1500（每档150字），11 对应无限制
+    // 默认值 350字 = (350-50)/150 = 2
+    slider.min = '0';
+    slider.max = '11';
+    slider.step = '1';
+
+    // 当前值转换：数值 -> 滑动条位置
+    const currentValue = typeof window.textGuardMaxLength !== 'undefined' ? window.textGuardMaxLength : 350;
+    let currentPosition;
+    if (currentValue === 0 || currentValue === null || currentValue === undefined) {
+        currentPosition = 11; // 无限制
+    } else {
+        // 找到最接近的档位：50 + position * 150
+        currentPosition = Math.min(10, Math.max(0, Math.round((currentValue - 50) / 150)));
+    }
+    slider.value = currentPosition;
+
+    Object.assign(slider.style, {
+        flex: '1',
+        height: '4px',
+        cursor: 'pointer',
+        accentColor: 'var(--neko-popup-accent, #44b7fe)'
+    });
+
+    // 更新显示文本
+    const updateDisplay = (position) => {
+        if (parseInt(position) === 11) {
+            const unlimitedText = (typeof window.t === 'function') ? window.t('settings.toggles.unlimited') : '无限制';
+            valueDisplay.textContent = unlimitedText;
+            valueDisplay.setAttribute('data-i18n', 'settings.toggles.unlimited');
+        } else {
+            const value = 50 + parseInt(position) * 150;
+            const unit = (typeof window.t === 'function') ? window.t('settings.toggles.characters') : '字';
+            valueDisplay.textContent = `${value}${unit}`;
+            valueDisplay.removeAttribute('data-i18n');
+        }
+    };
+
+    updateDisplay(currentPosition);
+
+    // 警告提示
+    const warningRow = document.createElement('div');
+    Object.assign(warningRow.style, {
+        fontSize: '11px',
+        color: '#ff6b6b',
+        lineHeight: '1.4',
+        minHeight: '16px',
+        opacity: '0',
+        transition: 'opacity 0.2s ease'
+    });
+
+    const updateWarning = (position) => {
+        const pos = parseInt(position);
+        const value = 50 + pos * 150;
+        if (pos === 11) {
+            // 无限制
+            const warningText = (typeof window.t === 'function')
+                ? window.t('settings.toggles.textGuardUnlimitedWarning')
+                : '无限制可能导致模型生成过长回复，消耗较多Token';
+            warningRow.textContent = warningText;
+            warningRow.style.opacity = '1';
+        } else if (value > 500) {
+            // 超过500字显示提示
+            const warningText = (typeof window.t === 'function')
+                ? window.t('settings.toggles.textGuardHighWarning')
+                : '设置过大可能导致回复过长，建议保持在500字以内';
+            warningRow.textContent = warningText;
+            warningRow.style.opacity = '1';
+        } else {
+            warningRow.style.opacity = '0';
+        }
+    };
+
+    updateWarning(currentPosition);
+
+    slider.addEventListener('input', () => {
+        const position = parseInt(slider.value);
+        updateDisplay(position);
+        updateWarning(position);
+    });
+
+    slider.addEventListener('change', () => {
+        const position = parseInt(slider.value);
+        let value;
+        if (position === 11) {
+            value = 0; // 0 表示无限制
+        } else {
+            value = 50 + position * 150;
+        }
+        window.textGuardMaxLength = value;
+        if (typeof window.saveNEKOSettings === 'function') window.saveNEKOSettings();
+        console.log(`[TextGuard] 回复字数限制已设置为 ${value === 0 ? '无限制' : value + '字'}`);
+    });
+
+    slider.addEventListener('click', (e) => e.stopPropagation());
+    slider.addEventListener('mousedown', (e) => e.stopPropagation());
+
+    sliderRow.appendChild(slider);
+
+    // 底部提示（仅对文本回复有效）
+    const noteRow = document.createElement('div');
+    Object.assign(noteRow.style, {
+        fontSize: '10px',
+        color: '#888',
+        lineHeight: '1.4',
+        marginTop: '4px'
+    });
+    const noteText = (typeof window.t === 'function')
+        ? window.t('settings.toggles.textGuardNote')
+        : '仅对文本回复有效，不影响语音对话';
+    noteRow.textContent = noteText;
+
+    container.appendChild(labelRow);
+    container.appendChild(sliderRow);
+    container.appendChild(warningRow);
+    container.appendChild(noteRow);
+
+    return container;
+}
+
 /**
  * 创建角色设置侧边面板
  */
@@ -455,7 +633,8 @@ function createCharacterSettingsSidePanel(manager, prefix) {
     container.style.flexDirection = 'column';
     container.style.alignItems = 'stretch';
     container.style.gap = '2px';
-    container.style.minWidth = '140px';
+    container.style.width = '160px';
+    container.style.minWidth = '0';
     container.style.padding = '4px 8px';
 
     const items = manager._characterMenuItems || [];
@@ -1727,6 +1906,10 @@ const AvatarPopupMixin = {
             return createAnimationSettingsSidePanel(this, prefix);
         };
 
+        ManagerProto._createTextGuardSlider = function () {
+            return createTextGuardSlider(this, prefix);
+        };
+
         ManagerProto._createSidePanelContainer = function (panelOptions = {}) {
             return createSidePanelContainer(this, prefix, options.sidePanelContainerLayout || panelOptions);
         };

static/locales/en.json

@@ -1551,7 +1551,13 @@
             "frameRateUnlimited": "Unlimited(VSync)",
             "mouseTracking": "Mouse Tracking",
             "fullscreenTracking": "Fullscreen Tracking",
-            "localTracking": "Local Tracking"
+            "localTracking": "Local Tracking",
+            "textGuardMaxLength": "Response Length Limit",
+            "unlimited": "Unlimited",
+            "characters": " chars",
+            "textGuardUnlimitedWarning": "May cause serious issues with the cat girl, not recommended unless necessary",
+            "textGuardHighWarning": "Setting too high may cause memory and language confusion, recommended within 500 chars",
+            "textGuardNote": "Applies to text replies only; does not affect voice sessions"
         }
     },
     "subtitle": {