From ced8f12318f72326c759e54ffcca59f08d6b11c4 Mon Sep 17 00:00:00 2001
From: Y1fe1Zh0u <zhouyifei210@gmail.com>
Date: Fri, 24 Jul 2026 15:10:28 +0800
Subject: [PATCH] Clarify the runtime budget shown in agent settings

The max_tool_rounds control limits model-result steps rather than tool calls, so its previous wording caused operators to compare an unrelated tool count with the Runtime ceiling. Align the Chinese, English, and fallback copy with the enforced semantics, including wait and error results.

Constraint: Preserve the existing setting key, numeric range, default, and Runtime behavior

Confidence: high

Scope-risk: narrow

Directive: Keep this copy aligned with node_executor model_step_count semantics

Tested: Frontend node tests (85 passed); npm production build; i18n JSON parsing; git diff check

Not-tested: Browser screenshot on a deployed server
---
 frontend/src/i18n/en.json                            | 3 +++
 frontend/src/i18n/zh.json                            | 6 +++---
 frontend/src/pages/agent-detail/tabs/SettingsTab.tsx | 6 +++---
 3 files changed, 9 insertions(+), 6 deletions(-)

diff --git a/frontend/src/i18n/en.json b/frontend/src/i18n/en.json
index 115da4457..99b59f1d8 100644
--- a/frontend/src/i18n/en.json
+++ b/frontend/src/i18n/en.json
@@ -501,6 +501,9 @@
       "currentUsage": "Current Usage",
       "today": "Today",
       "month": "This Month",
+      "maxToolRounds": "Model Step Limit",
+      "maxToolRoundsLabel": "Maximum model steps per run",
+      "maxToolRoundsDesc": "Each model step that returns a result counts, including wait or error results. Tool-call count is separate. Default: 50",
       "saveSettings": "Save Settings",
       "save": "Save",
       "saving": "Saving...",
diff --git a/frontend/src/i18n/zh.json b/frontend/src/i18n/zh.json
index fb6e1c96f..91a61c464 100644
--- a/frontend/src/i18n/zh.json
+++ b/frontend/src/i18n/zh.json
@@ -508,9 +508,9 @@
       "currentUsage": "当前用量",
       "today": "今日",
       "month": "本月",
-      "maxToolRounds": "最大工具调用轮次",
-      "maxToolRoundsLabel": "每条消息的最大轮次",
-      "maxToolRoundsDesc": "智能体每条消息可执行的工具调用轮次数（搜索、写入等）。默认值：50",
+      "maxToolRounds": "模型决策步数上限",
+      "maxToolRoundsLabel": "单次任务的最大模型决策步数",
+      "maxToolRoundsDesc": "模型决策步骤返回结果时即计入，包括等待或错误结果；工具调用次数单独计算。默认值：50",
       "saveSettings": "保存设置",
       "save": "保存",
       "saving": "保存中...",
diff --git a/frontend/src/pages/agent-detail/tabs/SettingsTab.tsx b/frontend/src/pages/agent-detail/tabs/SettingsTab.tsx
index 6b4c6f327..d2d680b68 100644
--- a/frontend/src/pages/agent-detail/tabs/SettingsTab.tsx
+++ b/frontend/src/pages/agent-detail/tabs/SettingsTab.tsx
@@ -166,9 +166,9 @@ export default function SettingsTab(props: Props) {
             </div>
 
             <div className="card" style={{ marginBottom: '12px' }}>
-                <h4 style={{ marginBottom: '12px', display: 'flex', alignItems: 'center', gap: '6px' }}><IconTools size={16} stroke={1.8} /> {t('agent.settings.maxToolRounds', 'Max Tool Call Rounds')}</h4>
+                <h4 style={{ marginBottom: '12px', display: 'flex', alignItems: 'center', gap: '6px' }}><IconTools size={16} stroke={1.8} /> {t('agent.settings.maxToolRounds', 'Model Step Limit')}</h4>
                 <div>
-                    <label style={{ display: 'block', fontSize: '13px', fontWeight: 500, marginBottom: '6px' }}>{t('agent.settings.maxToolRoundsLabel', 'Maximum rounds per message')}</label>
+                    <label style={{ display: 'block', fontSize: '13px', fontWeight: 500, marginBottom: '6px' }}>{t('agent.settings.maxToolRoundsLabel', 'Maximum model steps per run')}</label>
                     <input
                         className="input"
                         type="number"
@@ -178,7 +178,7 @@ export default function SettingsTab(props: Props) {
                         onChange={(e) => setSettingsForm((form) => ({ ...form, max_tool_rounds: Math.max(5, Math.min(200, parseInt(e.target.value) || 50)) }))}
                         style={{ width: '120px' }}
                     />
-                    <div style={{ fontSize: '11px', color: 'var(--text-tertiary)', marginTop: '4px' }}>{t('agent.settings.maxToolRoundsDesc', 'How many tool-calling rounds the agent can perform per message (search, write, etc). Default: 50')}</div>
+                    <div style={{ fontSize: '11px', color: 'var(--text-tertiary)', marginTop: '4px' }}>{t('agent.settings.maxToolRoundsDesc', 'Each model step that returns a result counts, including wait or error results. Tool-call count is separate. Default: 50')}</div>
                 </div>
             </div>