${esc(t('linked_files'))}
`;
for (const [cat, files] of categories) {
html += `
${esc(cat)}
`;
for (const f of files) {
@@ -435,7 +435,7 @@ async function openSkill(name, el) {
});
$('previewArea').classList.add('visible');
$('fileTree').style.display = 'none';
- } catch(e) { setStatus('Could not load skill: ' + e.message); }
+ } catch(e) { setStatus(t('skill_load_failed') + e.message); }
}
async function openSkillFile(skillName, filePath) {
@@ -453,7 +453,7 @@ async function openSkillFile(skillName, filePath) {
$('previewCode').textContent = data.content || '';
requestAnimationFrame(() => highlightCode());
}
- } catch(e) { setStatus('Could not load file: ' + e.message); }
+ } catch(e) { setStatus(t('skill_file_load_failed') + e.message); }
}
// ── Skill create/edit form ──
@@ -479,15 +479,15 @@ async function submitSkillSave() {
const content = $('skillFormContent').value;
const errEl = $('skillFormError');
errEl.style.display = 'none';
- if (!name) { errEl.textContent = 'Skill name is required'; errEl.style.display = ''; return; }
- if (!content.trim()) { errEl.textContent = 'Content is required'; errEl.style.display = ''; return; }
+ if (!name) { errEl.textContent = t('skill_name_required'); errEl.style.display = ''; return; }
+ if (!content.trim()) { errEl.textContent = t('content_required'); errEl.style.display = ''; return; }
try {
await api('/api/skills/save', {method:'POST', body: JSON.stringify({name, category: category||undefined, content})});
- showToast(_editingSkillName ? 'Skill updated' : 'Skill created');
+ showToast(_editingSkillName ? t('skill_updated') : t('skill_created'));
_skillsData = null;
toggleSkillForm();
await loadSkills();
- } catch(e) { errEl.textContent = 'Error: ' + e.message; errEl.style.display = ''; }
+ } catch(e) { errEl.textContent = t('error_prefix') + e.message; errEl.style.display = ''; }
}
// ── Memory inline edit ──
@@ -498,7 +498,7 @@ function toggleMemoryEdit() {
if (!form) return;
const open = form.style.display !== 'none';
if (open) { form.style.display = 'none'; return; }
- $('memEditSection').textContent = 'memory (notes)';
+ $('memEditSection').textContent = t('memory_notes_label');
$('memEditContent').value = _memoryData ? (_memoryData.memory || '') : '';
$('memEditError').style.display = 'none';
form.style.display = '';
@@ -515,10 +515,10 @@ async function submitMemorySave() {
errEl.style.display = 'none';
try {
await api('/api/memory/write', {method:'POST', body: JSON.stringify({section: 'memory', content})});
- showToast('Memory saved');
+ showToast(t('memory_saved'));
closeMemoryEdit();
await loadMemory(true);
- } catch(e) { errEl.textContent = 'Error: ' + e.message; errEl.style.display = ''; }
+ } catch(e) { errEl.textContent = t('error_prefix') + e.message; errEl.style.display = ''; }
}
// ── Workspace management ──
@@ -550,7 +550,7 @@ function syncWorkspaceDisplays(){
if(composerLabel) composerLabel.textContent=label;
if(composerChip){
composerChip.disabled=!hasSession;
- composerChip.title=hasSession?ws:'No active workspace';
+ composerChip.title=hasSession?ws:t('no_workspace');
composerChip.classList.toggle('active',!!(composerDropdown&&composerDropdown.classList.contains('open')));
}
}
@@ -610,15 +610,15 @@ function renderWorkspaceDropdownInto(dd, workspaces, currentWs){
}
dd.appendChild(document.createElement('div')).className='ws-divider';
dd.appendChild(_renderWorkspaceAction(
- 'Choose workspace path',
- 'Add a validated path and switch this conversation',
+ t('workspace_choose_path'),
+ t('workspace_choose_path_meta'),
li('folder',12),
()=>promptWorkspacePath()
));
const div=document.createElement('div');div.className='ws-divider';dd.appendChild(div);
dd.appendChild(_renderWorkspaceAction(
- 'Manage workspaces',
- 'Open the Spaces panel',
+ t('workspace_manage'),
+ t('workspace_manage_meta'),
li('settings',12),
()=>{closeWsDropdown();mobileSwitchPanel('workspaces');}
));
@@ -693,19 +693,19 @@ function renderWorkspacesPanel(workspaces){
${esc(w.path)}
-
-
+
+
`;
panel.appendChild(row);
}
const addRow=document.createElement('div');addRow.className='ws-add-row';
addRow.innerHTML=`
-
-
`;
+
+
`;
panel.appendChild(addRow);
const hint=document.createElement('div');
hint.style.cssText='font-size:11px;color:var(--muted);padding:4px 0 8px';
- hint.textContent='Paths are validated as existing directories before saving.';
+ hint.textContent=t('workspace_paths_validated_hint');
panel.appendChild(hint);
}
@@ -718,28 +718,28 @@ async function addWorkspace(){
_workspaceList=data.workspaces;
renderWorkspacesPanel(data.workspaces);
if(input)input.value='';
- showToast('Workspace added');
- }catch(e){setStatus('Add failed: '+e.message);}
+ showToast(t('workspace_added'));
+ }catch(e){setStatus(t('add_failed')+e.message);}
}
async function removeWorkspace(path){
- const _rmWs=await showConfirmDialog({title:'Remove workspace',message:`Remove "${path}"?`,confirmLabel:'Remove',danger:true,focusCancel:true});
+ const _rmWs=await showConfirmDialog({title:t('workspace_remove_confirm_title'),message:t('workspace_remove_confirm_message',path),confirmLabel:t('remove'),danger:true,focusCancel:true});
if(!_rmWs) return;
try{
const data=await api('/api/workspaces/remove',{method:'POST',body:JSON.stringify({path})});
_workspaceList=data.workspaces;
renderWorkspacesPanel(data.workspaces);
- showToast('Workspace removed');
- }catch(e){setStatus('Remove failed: '+e.message);}
+ showToast(t('workspace_removed'));
+ }catch(e){setStatus(t('remove_failed')+e.message);}
}
async function promptWorkspacePath(){
if(!S.session)return;
const value=await showPromptDialog({
- title:'Switch workspace',
- message:'Enter an absolute workspace path to add and switch this conversation to.',
- confirmLabel:'Switch',
- placeholder:'/Users/you/project',
+ title:t('workspace_switch_prompt_title'),
+ message:t('workspace_switch_prompt_message'),
+ confirmLabel:t('workspace_switch_prompt_confirm'),
+ placeholder:t('workspace_switch_prompt_placeholder'),
value:S.session.workspace||''
});
const path=(value||'').trim();
@@ -748,27 +748,27 @@ async function promptWorkspacePath(){
const data=await api('/api/workspaces/add',{method:'POST',body:JSON.stringify({path})});
_workspaceList=data.workspaces||[];
const target=_workspaceList[_workspaceList.length-1];
- if(!target) throw new Error('Workspace was not added');
+ if(!target) throw new Error(t('workspace_not_added'));
await switchToWorkspace(target.path,target.name);
}catch(e){
if(String(e.message||'').includes('Workspace already in list')){
- showToast('Workspace already saved — choose it from the list');
+ showToast(t('workspace_already_saved'));
return;
}
- showToast('Workspace switch failed: '+e.message);
+ showToast(t('workspace_switch_failed')+e.message);
}
}
async function switchToWorkspace(path,name){
if(!S.session)return;
if(S.busy){
- showToast('Cannot switch workspace while agent is running');
+ showToast(t('workspace_busy_switch'));
return;
}
if(typeof _previewDirty!=='undefined'&&_previewDirty){
const discard=await showConfirmDialog({
- title:'Discard file edits?',
- message:'Switching workspaces will discard unsaved file edits in the preview.',
+ title:t('discard_file_edits_title'),
+ message:t('discard_file_edits_message'),
confirmLabel:t('discard'),
danger:true
});
@@ -784,8 +784,8 @@ async function switchToWorkspace(path,name){
S.session.workspace=path;
syncTopbar();
await loadDir('.');
- showToast(`Switched to ${name||getWorkspaceFriendlyName(path)}`);
- }catch(e){setStatus('Switch failed: '+e.message);}
+ showToast(t('workspace_switched_to',name||getWorkspaceFriendlyName(path)));
+ }catch(e){setStatus(t('switch_failed')+e.message);}
}
// ── Profile panel + dropdown ──
@@ -799,7 +799,7 @@ async function loadProfilesPanel() {
_profilesCache = data;
panel.innerHTML = '';
if (!data.profiles || !data.profiles.length) {
- panel.innerHTML = '
No profiles found.
';
+ panel.innerHTML = `
${esc(t('profiles_no_profiles'))}
`;
return;
}
for (const p of data.profiles) {
@@ -809,20 +809,20 @@ async function loadProfilesPanel() {
if (p.model) meta.push(p.model.split('/').pop());
if (p.provider) meta.push(p.provider);
if (p.skill_count) meta.push(p.skill_count + ' skill' + (p.skill_count !== 1 ? 's' : ''));
- if (p.has_env) meta.push('API keys configured');
+ if (p.has_env) meta.push(t('profile_api_keys_configured'));
const gwDot = p.gateway_running
- ? '
'
- : '
';
+ ? `
`
+ : `
`;
const isActive = p.name === data.active;
- const activeBadge = isActive ? '
ACTIVE' : '';
+ const activeBadge = isActive ? `
${esc(t('profile_active'))}` : '';
card.innerHTML = `
`;
@@ -859,7 +859,7 @@ function renderProfileDropdown(data) {
// Divider + Manage link
const div = document.createElement('div'); div.className = 'ws-divider'; dd.appendChild(div);
const mgmt = document.createElement('div'); mgmt.className = 'profile-opt ws-manage';
- mgmt.innerHTML = `${li('settings',12)} Manage profiles`;
+ mgmt.innerHTML = `${li('settings',12)} ${esc(t('manage_profiles'))}`;
mgmt.onclick = () => { closeProfileDropdown(); mobileSwitchPanel('profiles'); };
dd.appendChild(mgmt);
}
@@ -876,7 +876,7 @@ function toggleProfileDropdown() {
_positionProfileDropdown();
const chip=$('profileChip');
if(chip) chip.classList.add('active');
- }).catch(e => { showToast('Failed to load profiles'); });
+ }).catch(e => { showToast(t('profiles_load_failed')); });
}
function closeProfileDropdown() {
@@ -894,7 +894,7 @@ window.addEventListener('resize',()=>{
});
async function switchToProfile(name) {
- if (S.busy) { showToast('Cannot switch profiles while agent is running'); return; }
+ if (S.busy) { showToast(t('profiles_busy_switch')); return; }
// Determine whether the current session has any messages.
// A session with messages is "in progress" and belongs to the current profile —
@@ -948,12 +948,12 @@ async function switchToProfile(name) {
// Start a new session for the new profile so nothing gets cross-tagged.
await newSession(false);
await renderSessionList();
- showToast('Switched to profile: ' + name + ' — new conversation started');
+ showToast(t('profile_switched_new_conversation', name));
} else {
// No messages yet — just refresh the list and topbar in place
await renderSessionList();
syncTopbar();
- showToast('Switched to profile: ' + name);
+ showToast(t('profile_switched', name));
}
// ── Sidebar panels ─────────────────────────────────────────────────────
@@ -963,7 +963,7 @@ async function switchToProfile(name) {
if (_currentPanel === 'profiles') await loadProfilesPanel();
if (_currentPanel === 'workspaces') await loadWorkspacesPanel();
- } catch (e) { showToast('Switch failed: ' + e.message); }
+ } catch (e) { showToast(t('switch_failed') + e.message); }
}
function toggleProfileForm() {
@@ -985,13 +985,13 @@ async function submitProfileCreate() {
const name = ($('profileFormName').value || '').trim().toLowerCase();
const cloneConfig = $('profileFormClone').checked;
const errEl = $('profileFormError');
- if (!name) { errEl.textContent = 'Name is required'; errEl.style.display = ''; return; }
- if (!/^[a-z0-9][a-z0-9_-]{0,63}$/.test(name)) { errEl.textContent = 'Lowercase letters, numbers, hyphens, underscores only'; errEl.style.display = ''; return; }
+ if (!name) { errEl.textContent = t('name_required'); errEl.style.display = ''; return; }
+ if (!/^[a-z0-9][a-z0-9_-]{0,63}$/.test(name)) { errEl.textContent = t('profile_name_rule'); errEl.style.display = ''; return; }
try {
const baseUrl = (($('profileFormBaseUrl') && $('profileFormBaseUrl').value) || '').trim();
const apiKey = (($('profileFormApiKey') && $('profileFormApiKey').value) || '').trim();
if (baseUrl && !/^https?:\/\//.test(baseUrl)) {
- errEl.textContent = 'Base URL must start with http:// or https://'; errEl.style.display = ''; return;
+ errEl.textContent = t('profile_base_url_rule'); errEl.style.display = ''; return;
}
const payload = { name, clone_config: cloneConfig };
if (baseUrl) payload.base_url = baseUrl;
@@ -999,18 +999,18 @@ async function submitProfileCreate() {
await api('/api/profile/create', { method: 'POST', body: JSON.stringify(payload) });
toggleProfileForm();
await loadProfilesPanel();
- showToast('Profile created: ' + name);
- } catch (e) { errEl.textContent = e.message || 'Create failed'; errEl.style.display = ''; }
+ showToast(t('profile_created', name));
+ } catch (e) { errEl.textContent = e.message || 'Create failed'; errEl.style.display = ''; }
}
async function deleteProfile(name) {
- const _delProf=await showConfirmDialog({title:`Delete profile "${name}"?`,message:'This removes all config, skills, memory, and sessions for this profile.',confirmLabel:'Delete',danger:true,focusCancel:true});
+ const _delProf=await showConfirmDialog({title:t('profile_delete_confirm_title',name),message:t('profile_delete_confirm_message'),confirmLabel:t('delete_title'),danger:true,focusCancel:true});
if(!_delProf) return;
try {
await api('/api/profile/delete', { method: 'POST', body: JSON.stringify({ name }) });
await loadProfilesPanel();
- showToast('Profile deleted: ' + name);
- } catch (e) { showToast('Delete failed: ' + e.message); }
+ showToast(t('profile_deleted', name));
+ } catch (e) { showToast(t('delete_failed') + e.message); }
}
// ── Memory panel ──
@@ -1023,23 +1023,23 @@ async function loadMemory(force) {
panel.innerHTML = `
- ${li('brain',14)} My Notes
+ ${li('brain',14)} ${esc(t('my_notes'))}
${fmtTime(data.memory_mtime)}
${data.memory
? `
${renderMd(data.memory)}
`
- : '
No notes yet.
'}
+ : `
${esc(t('no_notes_yet'))}
`}
- ${li('user',14)} User Profile
+ ${li('user',14)} ${esc(t('user_profile'))}
${fmtTime(data.user_mtime)}
${data.user
? `
${renderMd(data.user)}
`
- : '
No profile yet.
'}
+ : `
${esc(t('no_profile_yet'))}
`}
`;
- } catch(e) { panel.innerHTML = `
Error: ${esc(e.message)}
`; }
+ } catch(e) { panel.innerHTML = `
${esc(t('error_prefix'))}${esc(e.message)}
`; }
}
// Drag and drop
@@ -1074,12 +1074,12 @@ function switchSettingsSection(name){
function _syncHermesPanelSessionActions(){
const hasSession=!!S.session;
const visibleMessages=hasSession?(S.messages||[]).filter(m=>m&&m.role&&m.role!=='tool').length:0;
- const title=hasSession?(S.session.title||'Untitled'):'No active conversation selected.';
+ const title=hasSession?(S.session.title||t('untitled')):t('active_conversation_none');
const meta=$('hermesSessionMeta');
if(meta){
meta.textContent=hasSession
- ? `${title} · ${visibleMessages} message${visibleMessages===1?'':'s'}`
- : 'No active conversation selected.';
+ ? t('active_conversation_meta', title, visibleMessages)
+ : t('active_conversation_none');
}
const setDisabled=(id,disabled)=>{
const el=$(id);
@@ -1148,10 +1148,10 @@ function _showSettingsUnsavedBar(){
bar = document.createElement('div');
bar.id = 'settingsUnsavedBar';
bar.style.cssText = 'display:flex;align-items:center;justify-content:space-between;gap:8px;background:rgba(233,69,96,.12);border:1px solid rgba(233,69,96,.3);border-radius:8px;padding:10px 14px;margin:0 0 12px;font-size:13px;';
- bar.innerHTML = '
You have unsaved changes.'
+ bar.innerHTML = `
${esc(t('settings_unsaved_changes'))}`
+ '
'
- + ''
- + ''
+ + ``
+ + ``
+ '';
const body = document.querySelector('.settings-main') || document.querySelector('.settings-body') || document.querySelector('.settings-panel');
if(body) body.prepend(bar);
@@ -1171,8 +1171,14 @@ function _markSettingsDirty(){
async function loadSettingsPanel(){
try{
const settings=await api('/api/settings');
- // Apply server-persisted locale immediately (overrides localStorage boot default)
- if(settings.language && typeof setLocale==='function') setLocale(settings.language);
+ const resolvedLanguage=(typeof resolvePreferredLocale==='function')
+ ? resolvePreferredLocale(settings.language, localStorage.getItem('hermes-lang'))
+ : (settings.language || localStorage.getItem('hermes-lang') || 'en');
+ // Keep settings modal and current page strings in sync with the resolved locale.
+ if(typeof setLocale==='function'){
+ setLocale(resolvedLanguage);
+ if(typeof applyLocaleToDOM==='function') applyLocaleToDOM();
+ }
// Populate model dropdown from /api/models
const modelSel=$('settingsModel');
if(modelSel){
@@ -1210,7 +1216,7 @@ async function loadSettingsPanel(){
langSel.appendChild(opt);
}
}
- langSel.value=settings.language||'en';
+ langSel.value=resolvedLanguage;
langSel.addEventListener('change',_markSettingsDirty,{once:false});
}
const showUsageCb=$('settingsShowTokenUsage');
@@ -1287,7 +1293,7 @@ async function saveSettings(andClose){
_settingsDirty=false; _settingsThemeOnOpen=theme;
_hideSettingsPanel();
return;
- }catch(e){showToast('Save failed: '+e.message);return;}
+ }catch(e){showToast(t('settings_save_failed')+e.message);return;}
}
try{
await api('/api/settings',{method:'POST',body:JSON.stringify(body)});
@@ -1319,23 +1325,23 @@ async function signOut(){
await api('/api/auth/logout',{method:'POST',body:'{}'});
window.location.href='/login';
}catch(e){
- showToast('Sign out failed: '+e.message);
+ showToast(t('sign_out_failed')+e.message);
}
}
async function disableAuth(){
- const _disAuth=await showConfirmDialog({title:'Disable password protection',message:'Anyone will be able to access this instance.',confirmLabel:'Disable',danger:true,focusCancel:true});
+ const _disAuth=await showConfirmDialog({title:t('disable_auth_confirm_title'),message:t('disable_auth_confirm_message'),confirmLabel:t('disable'),danger:true,focusCancel:true});
if(!_disAuth) return;
try{
await api('/api/settings',{method:'POST',body:JSON.stringify({_clear_password:true})});
- showToast('Auth disabled — password protection removed');
+ showToast(t('auth_disabled'));
// Hide both auth buttons since auth is now off
const disableBtn=$('btnDisableAuth');
if(disableBtn) disableBtn.style.display='none';
const signOutBtn=$('btnSignOut');
if(signOutBtn) signOutBtn.style.display='none';
}catch(e){
- showToast('Failed to disable auth: '+e.message);
+ showToast(t('disable_auth_failed')+e.message);
}
}
@@ -1359,7 +1365,7 @@ function startCronPolling(){
const data=await api(`/api/crons/recent?since=${_cronPollSince}`);
if(data.completions&&data.completions.length>0){
for(const c of data.completions){
- showToast(`Cron "${c.name}" ${c.status==='error'?'failed':'completed'}`,4000);
+ showToast(t('cron_completion_status', c.name, c.status==='error' ? t('status_failed') : t('status_completed')),4000);
_cronPollSince=Math.max(_cronPollSince,c.completed_at);
}
_cronUnreadCount+=data.completions.length;
@@ -1404,7 +1410,7 @@ const _backgroundErrors=[]; // {session_id, title, message, ts}
function trackBackgroundError(sessionId, title, message){
// Only track if user is NOT currently viewing this session
if(S.session&&S.session.session_id===sessionId) return;
- _backgroundErrors.push({session_id:sessionId, title:title||'Untitled', message, ts:Date.now()});
+ _backgroundErrors.push({session_id:sessionId, title:title||t('untitled'), message, ts:Date.now()});
showErrorBanner();
}
@@ -1421,7 +1427,8 @@ function showErrorBanner(){
const latest=_backgroundErrors[0]; // FIFO: show oldest (first) error
if(!latest){banner.style.display='none';return;}
const count=_backgroundErrors.length;
- banner.innerHTML=`
\u26a0 ${count>1?count+' sessions have':'"'+esc(latest.title)+'" has'} encountered an error`;
+ const msg=count>1?t('bg_error_multi',count):t('bg_error_single',latest.title);
+ banner.innerHTML=`
\u26a0 ${esc(msg)}`;
banner.style.display='';
}
diff --git a/tests/test_chinese_locale.py b/tests/test_chinese_locale.py
new file mode 100644
index 0000000..9ae3082
--- /dev/null
+++ b/tests/test_chinese_locale.py
@@ -0,0 +1,65 @@
+from collections import Counter
+from pathlib import Path
+import re
+
+
+REPO = Path(__file__).resolve().parent.parent
+
+
+def read(path: Path) -> str:
+ return path.read_text(encoding="utf-8")
+
+
+def test_chinese_locale_block_exists():
+ src = read(REPO / "static" / "i18n.js")
+ assert "\n zh: {" in src
+ assert "_lang: 'zh'" in src
+ assert "_speech: 'zh-CN'" in src
+
+
+def test_chinese_locale_includes_representative_translations():
+ src = read(REPO / "static" / "i18n.js")
+ expected = [
+ "settings_title: '\\u8bbe\\u7f6e'",
+ "login_title: '\\u767b\\u5f55'",
+ "approval_heading: '需要审批'",
+ "tab_tasks: '任务'",
+ "tab_profiles: '配置'",
+ "session_time_just_now: '刚刚'",
+ "onboarding_title: '欢迎使用 Hermes Web UI'",
+ "onboarding_complete: '引导完成'",
+ ]
+ for entry in expected:
+ assert entry in src
+
+
+def test_chinese_locale_covers_english_keys():
+ src = read(REPO / "static" / "i18n.js")
+ en_match = re.search(r"\n en: \{([\s\S]*?)\n \},\n\n es: \{", src)
+ zh_match = re.search(
+ r"\n zh: \{([\s\S]*?)\n \},\n\n // Traditional Chinese \(zh-Hant\)",
+ src,
+ )
+ assert en_match, "English locale block not found"
+ assert zh_match, "Chinese locale block not found"
+
+ key_pattern = re.compile(r"^\s{4}([a-zA-Z0-9_]+):", re.MULTILINE)
+ en_keys = set(key_pattern.findall(en_match.group(1)))
+ zh_keys = set(key_pattern.findall(zh_match.group(1)))
+
+ missing = sorted(en_keys - zh_keys)
+ assert not missing, f"Chinese locale missing keys: {missing}"
+
+
+def test_chinese_locale_has_no_duplicate_keys():
+ src = read(REPO / "static" / "i18n.js")
+ zh_match = re.search(
+ r"\n zh: \{([\s\S]*?)\n \},\n\n // Traditional Chinese \(zh-Hant\)",
+ src,
+ )
+ assert zh_match, "Chinese locale block not found"
+
+ key_pattern = re.compile(r"^\s{4}([a-zA-Z0-9_]+):", re.MULTILINE)
+ keys = key_pattern.findall(zh_match.group(1))
+ duplicates = sorted(k for k, count in Counter(keys).items() if count > 1)
+ assert not duplicates, f"Chinese locale has duplicate keys: {duplicates}"
diff --git a/tests/test_language_precedence.py b/tests/test_language_precedence.py
new file mode 100644
index 0000000..29c92a2
--- /dev/null
+++ b/tests/test_language_precedence.py
@@ -0,0 +1,88 @@
+import json
+import pathlib
+import re
+import subprocess
+import textwrap
+
+
+REPO_ROOT = pathlib.Path(__file__).parent.parent.resolve()
+I18N_JS = (REPO_ROOT / "static" / "i18n.js").read_text(encoding="utf-8")
+BOOT_JS = (REPO_ROOT / "static" / "boot.js").read_text(encoding="utf-8")
+PANELS_JS = (REPO_ROOT / "static" / "panels.js").read_text(encoding="utf-8")
+
+
+def _run_i18n_case(script_expr: str) -> dict:
+ wrapped_expr = f"(() => ({script_expr}))()"
+ script = textwrap.dedent(
+ f"""
+ const fs = require('fs');
+ const vm = require('vm');
+ const src = fs.readFileSync({json.dumps(str(REPO_ROOT / "static" / "i18n.js"))}, 'utf8');
+ const storage = {{}};
+ const ctx = {{
+ localStorage: {{
+ getItem: (k) => Object.prototype.hasOwnProperty.call(storage, k) ? storage[k] : null,
+ setItem: (k, v) => {{ storage[k] = String(v); }},
+ }},
+ document: {{
+ documentElement: {{ lang: '' }},
+ querySelectorAll: () => [],
+ }},
+ }};
+ vm.createContext(ctx);
+ vm.runInContext(src, ctx);
+ const out = vm.runInContext({json.dumps(wrapped_expr)}, ctx);
+ process.stdout.write(JSON.stringify(out));
+ """
+ )
+ proc = subprocess.run(["node", "-e", script], check=True, capture_output=True, text=True)
+ return json.loads(proc.stdout)
+
+
+def test_i18n_exposes_locale_resolvers():
+ assert "function resolveLocale(" in I18N_JS
+ assert "function resolvePreferredLocale(" in I18N_JS
+
+
+def test_locale_alias_resolution_and_precedence_logic():
+ result = _run_i18n_case(
+ """
+{
+ zhCn: resolveLocale('zh-CN'),
+ zhTw: resolveLocale('zh_TW'),
+ enUs: resolveLocale('EN-us'),
+ esMx: resolveLocale('es-MX'),
+ bad: resolveLocale('xx-YY'),
+ preferred1: resolvePreferredLocale('zh-CN', 'en'),
+ preferred2: resolvePreferredLocale('xx-YY', 'zh-Hant'),
+ preferred3: resolvePreferredLocale('', 'xx-YY'),
+}
+ """
+ )
+ assert result["zhCn"] == "zh"
+ assert result["zhTw"] == "zh-Hant"
+ assert result["enUs"] == "en"
+ assert result["esMx"] == "es"
+ assert result["bad"] is None
+ assert result["preferred1"] == "zh"
+ assert result["preferred2"] == "zh-Hant"
+ assert result["preferred3"] == "en"
+
+
+def test_set_locale_normalizes_alias_and_persists_canonical_key():
+ result = _run_i18n_case(
+ """
+{
+ ...(setLocale('zh-CN'), {}),
+ saved: localStorage.getItem('hermes-lang'),
+ htmlLang: document.documentElement.lang,
+}
+ """
+ )
+ assert result["saved"] == "zh"
+ assert result["htmlLang"] == "zh-CN"
+
+
+def test_boot_and_settings_panel_use_shared_locale_precedence():
+ assert re.search(r"resolvePreferredLocale\(s\.language\s*,\s*localStorage\.getItem\('hermes-lang'\)\)", BOOT_JS)
+ assert re.search(r"resolvePreferredLocale\(settings\.language\s*,\s*localStorage\.getItem\('hermes-lang'\)\)", PANELS_JS)
diff --git a/tests/test_login_locale.py b/tests/test_login_locale.py
new file mode 100644
index 0000000..ad63e01
--- /dev/null
+++ b/tests/test_login_locale.py
@@ -0,0 +1,64 @@
+import json
+import urllib.error
+import urllib.request
+
+
+BASE = "http://127.0.0.1:8788"
+
+
+def get(path):
+ with urllib.request.urlopen(BASE + path, timeout=10) as r:
+ return json.loads(r.read()), r.status
+
+
+def get_raw(path):
+ with urllib.request.urlopen(BASE + path, timeout=10) as r:
+ return r.read().decode(), r.status
+
+
+def post(path, body=None):
+ data = json.dumps(body or {}).encode()
+ req = urllib.request.Request(
+ BASE + path, data=data, headers={"Content-Type": "application/json"}
+ )
+ try:
+ with urllib.request.urlopen(req, timeout=10) as r:
+ return json.loads(r.read()), r.status
+ except urllib.error.HTTPError as e:
+ return json.loads(e.read()), e.code
+
+
+def _current_language():
+ settings, status = get("/api/settings")
+ assert status == 200
+ return settings.get("language") or "en"
+
+
+def test_login_page_uses_simplified_chinese_for_zh_cn_alias():
+ prev_lang = _current_language()
+ try:
+ saved, status = post("/api/settings", {"language": "zh-CN"})
+ assert status == 200
+ assert saved.get("language") == "zh-CN"
+ html, status2 = get_raw("/login")
+ assert status2 == 200
+ assert 'lang="zh-CN"' in html
+ assert "\u767b\u5f55" in html
+ assert "\u8f93\u5165\u5bc6\u7801\u7ee7\u7eed\u4f7f\u7528" in html
+ finally:
+ post("/api/settings", {"language": prev_lang})
+
+
+def test_login_page_uses_traditional_chinese_for_zh_hant():
+ prev_lang = _current_language()
+ try:
+ saved, status = post("/api/settings", {"language": "zh-Hant"})
+ assert status == 200
+ assert saved.get("language") == "zh-Hant"
+ html, status2 = get_raw("/login")
+ assert status2 == 200
+ assert 'lang="zh-TW"' in html
+ assert "\u8f38\u5165\u5bc6\u78bc\u7e7c\u7e8c\u4f7f\u7528" in html
+ assert "\u5bc6\u78bc\u932f\u8aa4" in html
+ finally:
+ post("/api/settings", {"language": prev_lang})