feat(i18n): add key descriptions for various settings in multiple languages

- Introduce detailed descriptions for authentication, SSRF protection, tenant management, and async task worker settings in English, Korean, Russian, and Chinese localization files.
- Enhance user understanding of configuration options by providing context-sensitive help directly within the settings interface.
- Update the Settings and SystemSettings components to utilize these new descriptions for improved user experience.
This commit is contained in:
wizardchen
2026-06-22 15:19:47 +08:00
committed by lyingbug
parent 01819b5bc2
commit 5f7ed2ffe9
6 changed files with 106 additions and 2 deletions
+1 -1
View File
@@ -282,7 +282,7 @@ const navItems = computed(() => {
{ key: 'storage', icon: 'cloud', label: t('settings.storageEngine') },
{ key: 'mcp', icon: 'tools', label: t('settings.mcpService') },
{ key: 'system', icon: 'info-circle', label: t('settings.versionInfo') },
{ key: 'system-global', icon: 'server', label: '系统设置' },
{ key: 'system-global', icon: 'server', label: t('settings.system') },
{ key: 'userprofile', icon: 'user', label: t('userProfile.title') },
{ key: 'tenant', icon: 'user-circle', label: t('settings.tenantInfo') },
{ key: 'members', icon: 'usergroup', label: t('tenantMember.title') },
+9 -1
View File
@@ -173,7 +173,7 @@
:title="t('system.globalSettings.badgeOverrideTooltip')"
>{{ t('system.globalSettings.badgeOverride') }}</t-tag>
</label>
<p v-if="item.description" class="desc">{{ item.description }}</p>
<p v-if="settingDescription(item)" class="desc">{{ settingDescription(item) }}</p>
<div v-if="modifiedMeta(item)" class="setting-meta">
{{ t('system.globalSettings.modifiedAt', { value: modifiedMeta(item) }) }}
</div>
@@ -528,6 +528,14 @@ function keyLabel(k: string): string {
return te(path) ? (t(path) as string) : k
}
// Descriptions are registered in Chinese on the backend for operator docs;
// user-facing copy lives in i18n (system.globalSettings.keyDescriptions.*).
function settingDescription(item: { key: string; description?: string }): string {
const path = `system.globalSettings.keyDescriptions.${item.key}`
if (te(path)) return t(path) as string
return item.description ?? ''
}
// Enum keys whose change triggers a whole-value inline popconfirm before
// PUT. ssrf.whitelist is not here — it uses per-tag confirm instead.
const HIGH_RISK_KEYS = new Set<string>([