feat: Enhance account identification to support email, mobile, and token-only synthetic IDs across API, UI, and documentation.

webui/src/components/AccountManager.jsx

@@ -39,6 +39,10 @@ export default function AccountManager({ config, onRefresh, onMessage, authFetch
     const [loadingAccounts, setLoadingAccounts] = useState(false)
 
     const apiFetch = authFetch || fetch
+    const resolveAccountIdentifier = (acc) => {
+        if (!acc || typeof acc !== 'object') return ''
+        return String(acc.identifier || acc.email || acc.mobile || '').trim()
+    }
 
     const fetchAccounts = async (targetPage = page) => {
         setLoadingAccounts(true)
@@ -147,9 +151,14 @@ export default function AccountManager({ config, onRefresh, onMessage, authFetch
     }
 
     const deleteAccount = async (id) => {
+        const identifier = String(id || '').trim()
+        if (!identifier) {
+            onMessage('error', t('accountManager.invalidIdentifier'))
+            return
+        }
         if (!confirm(t('accountManager.deleteAccountConfirm'))) return
         try {
-            const res = await apiFetch(`/admin/accounts/${encodeURIComponent(id)}`, { method: 'DELETE' })
+            const res = await apiFetch(`/admin/accounts/${encodeURIComponent(identifier)}`, { method: 'DELETE' })
             if (res.ok) {
                 onMessage('success', t('messages.deleted'))
                 fetchAccounts() // 刷新当前页
@@ -163,24 +172,29 @@ export default function AccountManager({ config, onRefresh, onMessage, authFetch
     }
 
     const testAccount = async (identifier) => {
-        setTesting(prev => ({ ...prev, [identifier]: true }))
+        const accountID = String(identifier || '').trim()
+        if (!accountID) {
+            onMessage('error', t('accountManager.invalidIdentifier'))
+            return
+        }
+        setTesting(prev => ({ ...prev, [accountID]: true }))
         try {
             const res = await apiFetch('/admin/accounts/test', {
                 method: 'POST',
                 headers: { 'Content-Type': 'application/json' },
-                body: JSON.stringify({ identifier }),
+                body: JSON.stringify({ identifier: accountID }),
             })
             const data = await res.json()
             const statusMessage = data.success
-                ? t('apiTester.testSuccess', { account: identifier, time: data.response_time })
-                : `${identifier}: ${data.message}`
+                ? t('apiTester.testSuccess', { account: accountID, time: data.response_time })
+                : `${accountID}: ${data.message}`
             onMessage(data.success ? 'success' : 'error', statusMessage)
             fetchAccounts() // 刷新当前页
             onRefresh()
         } catch (e) {
             onMessage('error', t('accountManager.testFailed', { error: e.message }))
         } finally {
-            setTesting(prev => ({ ...prev, [identifier]: false }))
+            setTesting(prev => ({ ...prev, [accountID]: false }))
         }
     }
 
@@ -197,7 +211,12 @@ export default function AccountManager({ config, onRefresh, onMessage, authFetch
 
         for (let i = 0; i < allAccounts.length; i++) {
             const acc = allAccounts[i]
-            const id = acc.email || acc.mobile
+            const id = resolveAccountIdentifier(acc)
+            if (!id) {
+                results.push({ id: '-', success: false, message: t('accountManager.invalidIdentifier') })
+                setBatchProgress({ current: i + 1, total: allAccounts.length, results: [...results] })
+                continue
+            }
 
             try {
                 const res = await apiFetch('/admin/accounts/test', {
@@ -387,7 +406,7 @@ export default function AccountManager({ config, onRefresh, onMessage, authFetch
                         <div className="p-8 text-center text-muted-foreground">{t('actions.loading')}</div>
                     ) : accounts.length > 0 ? (
                         accounts.map((acc, i) => {
-                            const id = acc.email || acc.mobile
+                            const id = resolveAccountIdentifier(acc)
                             return (
                                 <div key={i} className="p-4 flex flex-col md:flex-row md:items-center justify-between gap-4 hover:bg-muted/50 transition-colors">
                                     <div className="flex items-center gap-3 min-w-0">
@@ -396,7 +415,7 @@ export default function AccountManager({ config, onRefresh, onMessage, authFetch
                                             acc.has_token ? "bg-emerald-500 shadow-[0_0_8px_rgba(16,185,129,0.5)]" : "bg-amber-500"
                                         )} />
                                         <div className="min-w-0">
-                                            <div className="font-medium truncate">{id}</div>
+                                            <div className="font-medium truncate">{id || '-'}</div>
                                             <div className="flex items-center gap-2 text-xs text-muted-foreground mt-0.5">
                                                 <span>{acc.has_token ? t('accountManager.sessionActive') : t('accountManager.reauthRequired')}</span>
                                                 {acc.token_preview && (

webui/src/components/ApiTester.jsx

@@ -42,6 +42,10 @@ export default function ApiTester({ config, onMessage, authFetch }) {
 
     const apiFetch = authFetch || fetch
     const accounts = config.accounts || []
+    const resolveAccountIdentifier = (acc) => {
+        if (!acc || typeof acc !== 'object') return ''
+        return String(acc.identifier || acc.email || acc.mobile || '').trim()
+    }
     const configuredKeys = config.keys || []
     const trimmedApiKey = apiKey.trim()
     const defaultKey = configuredKeys[0] || ''
@@ -297,11 +301,15 @@ return (
                                 onChange={e => setSelectedAccount(e.target.value)}
                             >
                                 <option value="" className="bg-popover text-popover-foreground">{t('apiTester.autoRandom')}</option>
-                                {accounts.map((acc, i) => (
-                                    <option key={i} value={acc.email || acc.mobile} className="bg-popover text-popover-foreground">
-                                        👤 {acc.email || acc.mobile}
-                                    </option>
-                                ))}
+                                {accounts.map((acc, i) => {
+                                    const id = resolveAccountIdentifier(acc)
+                                    if (!id) return null
+                                    return (
+                                        <option key={i} value={id} className="bg-popover text-popover-foreground">
+                                            👤 {id}
+                                        </option>
+                                    )
+                                })}
                             </select>
                             <ChevronDown className="absolute right-2.5 top-3 w-4 h-4 text-muted-foreground pointer-events-none" />
                         </div>

webui/src/locales/en.json

@@ -86,6 +86,7 @@
         "requiredFields": "Password and email/mobile are required.",
         "deleteKeyConfirm": "Are you sure you want to delete this API key?",
         "deleteAccountConfirm": "Are you sure you want to delete this account?",
+        "invalidIdentifier": "Invalid account identifier. Operation aborted.",
         "testAllConfirm": "Test API connectivity for all accounts?",
         "testAllCompleted": "Completed: {success}/{total} available",
         "testFailed": "Test failed: {error}",

webui/src/locales/zh.json

@@ -86,6 +86,7 @@
         "requiredFields": "需要填写密码以及邮箱或手机号",
         "deleteKeyConfirm": "确定要删除此 API 密钥吗？",
         "deleteAccountConfirm": "确定要删除此账号吗？",
+        "invalidIdentifier": "账号标识无效，无法执行操作",
         "testAllConfirm": "测试所有账号的 API 连通性？",
         "testAllCompleted": "完成：{success}/{total} 可用",
         "testFailed": "测试失败: {error}",