Sync from GitHub (excluding README)

dashboard/public/app.js

@@ -20,6 +20,12 @@ const createKeyForm = document.getElementById('create-key-form');
 const cancelCreateBtn = document.getElementById('cancel-create-btn');
 const keyDetailsModal = document.getElementById('key-details-modal');
 const closeDetailsBtn = document.getElementById('close-details-btn');
+const createServerKeyModal = document.getElementById('create-server-key-modal');
+const createServerKeyForm = document.getElementById('create-server-key-form');
+const cancelServerKeyBtn = document.getElementById('cancel-server-key-btn');
+const refreshKeyModal = document.getElementById('refresh-key-modal');
+const cancelRefreshBtn = document.getElementById('cancel-refresh-btn');
+const confirmRefreshBtn = document.getElementById('confirm-refresh-btn');
 const adminKeysList = document.getElementById('admin-keys-list');
 const userKeysList = document.getElementById('user-keys-list');
 const commandForm = document.getElementById('command-form');
@@ -263,35 +269,19 @@ function renderAdminKeys(keys) {
 
     let html = '';
 
-    // Render Admin Keys
     if (adminKeys.length > 0) {
         html += '<h3 class="group-title">管理员密钥 (Admin Keys)</h3>';
         html += adminKeys.map(key => renderKeyCard(key)).join('');
     }
 
-    // Render Regular Keys with nested Server Keys
     if (regularKeys.length > 0) {
         html += '<h3 class="group-title">用户密钥 (Regular Keys)</h3>';
         html += regularKeys.map(regularKey => {
             const childServerKeys = serverKeysMap[regularKey.id] || [];
-            return `
-                <div class="regular-key-group">
-                    <div class="regular-key-header" onclick="toggleGroup(this)">
-                        ${renderKeyCard(regularKey)}
-                        ${childServerKeys.length > 0 ? `<span class="toggle-icon">▼</span>` : ''}
-                    </div>
-                    ${childServerKeys.length > 0 ? `
-                        <div class="nested-server-keys hidden">
-                            <h4>关联的服务器密钥 (Linked Server Keys)</h4>
-                            ${childServerKeys.map(serverKey => renderKeyCard(serverKey, true)).join('')}
-                        </div>
-                    ` : ''}
-                </div>
-            `;
+            return renderRegularKeyCard(regularKey, childServerKeys);
         }).join('');
     }
 
-    // Render Orphaned Server Keys (if any)
     const linkedServerKeyIds = new Set(Object.values(serverKeysMap).flat().map(k => k.id));
     const orphanServerKeys = serverKeys.filter(k => !linkedServerKeyIds.has(k.id));
 
@@ -339,12 +329,54 @@ function renderKeyCard(key, isNested = false) {
                     ? `<button class="btn-danger" onclick="deactivateKey('${key.id}')">停用</button>`
                     : `<button class="btn-success" onclick="activateKey('${key.id}')">启用</button>`
                 }
+                <button class="btn-secondary" onclick="showRefreshKeyModal('${key.id}', '${key.name}')">刷新</button>
                 <button class="btn-danger" onclick="deleteKey('${key.id}', '${key.name}')">删除</button>
             </div>
         </div>
     `;
 }
 
+function renderRegularKeyCard(regularKey, childServerKeys = []) {
+    return `
+        <div class="regular-key-group">
+            <div class="regular-key-header" onclick="toggleGroup(this)">
+                <div class="key-card">
+                    <div class="key-info">
+                        <h3>
+                            <span class="key-badge regular">Regular</span>
+                            <span class="key-badge ${regularKey.isActive ? 'active' : 'inactive'}">
+                                ${regularKey.isActive ? '已启用' : '已停用'}
+                            </span>
+                            ${regularKey.name}
+                        </h3>
+                        <p>ID: ${regularKey.id}</p>
+                        <p>Prefix: ${regularKey.keyPrefix}</p>
+                        ${regularKey.serverId ? `<p>Server ID: ${regularKey.serverId}</p>` : ''}
+                        <p>创建时间: ${new Date(regularKey.createdAt).toLocaleString()}</p>
+                        <p>最后使用: ${regularKey.lastUsed ? new Date(regularKey.lastUsed).toLocaleString() : '从未'}</p>
+                    </div>
+                    <div class="key-actions">
+                        ${regularKey.isActive
+                            ? `<button class="btn-danger" onclick="deactivateKey('${regularKey.id}')">停用</button>`
+                            : `<button class="btn-success" onclick="activateKey('${regularKey.id}')">启用</button>`
+                        }
+                        <button class="btn-secondary" onclick="showRefreshKeyModal('${regularKey.id}', '${regularKey.name}')">刷新</button>
+                        <button class="btn-danger" onclick="deleteKey('${regularKey.id}', '${regularKey.name}')">删除</button>
+                        <button class="btn-primary" onclick="showCreateServerKeyModal('${regularKey.id}', '${regularKey.name}')">添加 Server Key</button>
+                    </div>
+                </div>
+                ${childServerKeys.length > 0 ? `<span class="toggle-icon">▼</span>` : ''}
+            </div>
+            ${childServerKeys.length > 0 ? `
+                <div class="nested-server-keys hidden">
+                    <h4>关联的服务器密钥 (Linked Server Keys)</h4>
+                    ${childServerKeys.map(serverKey => renderKeyCard(serverKey, true)).join('')}
+                </div>
+            ` : ''}
+        </div>
+    `;
+}
+
 function renderUserServerKeys(keys) {
     if (!userKeysList) {
         return;
@@ -376,6 +408,7 @@ function renderUserServerKeys(keys) {
                     ? `<button class="btn-danger" onclick="deactivateKey('${key.id}')">停用</button>`
                     : `<button class="btn-success" onclick="activateKey('${key.id}')">启用</button>`
                 }
+                <button class="btn-secondary" onclick="showRefreshKeyModal('${key.id}', '${key.name}')">刷新</button>
             </div>
         </div>
     `).join('');
@@ -658,6 +691,166 @@ if (closeDetailsBtn) {
     });
 }
 
+function showCreateServerKeyModal(regularKeyId, regularKeyName) {
+    if (!createServerKeyModal) {
+        return;
+    }
+    
+    const parentNameEl = document.getElementById('create-server-key-parent-name');
+    if (parentNameEl) {
+        parentNameEl.textContent = `父级 Regular Key: ${regularKeyName}`;
+    }
+    
+    const regularIdInput = document.getElementById('server-key-regular-id');
+    if (regularIdInput) {
+        regularIdInput.value = regularKeyId;
+    }
+    
+    createServerKeyModal.classList.remove('hidden');
+}
+
+function hideCreateServerKeyModal() {
+    if (!createServerKeyModal) {
+        return;
+    }
+    
+    createServerKeyModal.classList.add('hidden');
+    
+    const nameInput = document.getElementById('server-key-name');
+    const descInput = document.getElementById('server-key-description');
+    const serverIdInput = document.getElementById('server-key-server-id');
+    
+    if (nameInput) nameInput.value = '';
+    if (descInput) descInput.value = '';
+    if (serverIdInput) serverIdInput.value = '';
+}
+
+async function createServerKey(event) {
+    event.preventDefault();
+    
+    const regularKeyId = document.getElementById('server-key-regular-id')?.value;
+    const name = document.getElementById('server-key-name')?.value.trim();
+    const description = document.getElementById('server-key-description')?.value.trim();
+    const serverId = document.getElementById('server-key-server-id')?.value.trim();
+    
+    if (!regularKeyId || !name) {
+        alert('Regular Key ID and name are required.');
+        return;
+    }
+    
+    try {
+        const payload = {
+            name,
+            description,
+            regular_key_id: regularKeyId
+        };
+        
+        if (serverId) {
+            payload.server_id = serverId;
+        }
+        
+        const response = await fetch(`${API_URL}/manage/keys/server-keys`, {
+            method: 'POST',
+            headers: {
+                ...authHeaders(apiKey),
+                'Content-Type': 'application/json'
+            },
+            body: JSON.stringify(payload)
+        });
+        
+        if (!response.ok) {
+            const error = await response.json();
+            alert(`Failed to create server key: ${error.detail}`);
+            return;
+        }
+        
+        const result = await response.json();
+        hideCreateServerKeyModal();
+        showKeyCreatedModal(result);
+        loadAdminKeys();
+    } catch (error) {
+        alert(`Failed to create server key: ${error.message}`);
+    }
+}
+
+if (cancelServerKeyBtn) {
+    cancelServerKeyBtn.addEventListener('click', hideCreateServerKeyModal);
+}
+
+if (createServerKeyForm) {
+    createServerKeyForm.addEventListener('submit', createServerKey);
+}
+
+window.showCreateServerKeyModal = showCreateServerKeyModal;
+window.hideCreateServerKeyModal = hideCreateServerKeyModal;
+window.createServerKey = createServerKey;
+
+function showRefreshKeyModal(keyId, keyName) {
+    if (!refreshKeyModal) {
+        return;
+    }
+    
+    const keyNameEl = document.getElementById('refresh-key-name');
+    const keyIdInput = document.getElementById('refresh-key-id');
+    
+    if (keyNameEl) keyNameEl.textContent = keyName;
+    if (keyIdInput) keyIdInput.value = keyId;
+    
+    refreshKeyModal.classList.remove('hidden');
+}
+
+function hideRefreshKeyModal() {
+    if (!refreshKeyModal) {
+        return;
+    }
+    refreshKeyModal.classList.add('hidden');
+}
+
+async function refreshKey() {
+    const keyId = document.getElementById('refresh-key-id')?.value;
+    
+    if (!keyId || !apiKey) {
+        return;
+    }
+    
+    try {
+        const response = await fetch(`${API_URL}/manage/keys/${keyId}/refresh`, {
+            method: 'POST',
+            headers: authHeaders(apiKey)
+        });
+        
+        if (!response.ok) {
+            const error = await response.json();
+            alert(`刷新失败: ${error.detail}`);
+            return;
+        }
+        
+        const result = await response.json();
+        hideRefreshKeyModal();
+        showKeyCreatedModal(result);
+        
+        if (currentRole === 'admin') {
+            loadAdminKeys();
+        } else if (currentRole === 'regular') {
+            loadUserServerKeys();
+        }
+    } catch (error) {
+        alert(`刷新失败: ${error.message}`);
+    }
+}
+
+if (cancelRefreshBtn) {
+    cancelRefreshBtn.addEventListener('click', hideRefreshKeyModal);
+}
+
+if (confirmRefreshBtn) {
+    confirmRefreshBtn.addEventListener('click', refreshKey);
+}
+
+window.showRefreshKeyModal = showRefreshKeyModal;
+window.hideRefreshKeyModal = hideRefreshKeyModal;
+window.refreshKey = refreshKey;
+
 if (createKeyForm) {
     createKeyForm.addEventListener('submit', async (event) => {
         event.preventDefault();

dashboard/public/index.html

@@ -170,6 +170,47 @@
         </div>
     </div>
 
+    <div id="create-server-key-modal" class="modal hidden">
+        <div class="modal-content">
+            <h2>为普通密钥创建服务器密钥</h2>
+            <p id="create-server-key-parent-name" class="modal-parent-info"></p>
+            <form id="create-server-key-form">
+                <input type="hidden" id="server-key-regular-id">
+                
+                <label>名称 *</label>
+                <input type="text" id="server-key-name" required>
+
+                <label>描述</label>
+                <textarea id="server-key-description"></textarea>
+
+                <label>服务器 ID（可选）</label>
+                <input type="text" id="server-key-server-id">
+
+                <div class="modal-actions">
+                    <button type="button" id="cancel-server-key-btn" class="btn-secondary">取消</button>
+                    <button type="submit" class="btn-primary">创建</button>
+                </div>
+            </form>
+        </div>
+    </div>
+
+    <div id="refresh-key-modal" class="modal hidden">
+        <div class="modal-content">
+            <h2>刷新密钥</h2>
+            <div class="modal-parent-info danger-bg">
+                <p>⚠️ <strong>警告：此操作不可撤销！</strong></p>
+                <p>刷新密钥将立即使旧密钥失效。</p>
+                <p>任何使用旧密钥连接的插件或服务都将断开连接，直到您更新为新密钥。</p>
+            </div>
+            <p>您确定要刷新密钥 <strong id="refresh-key-name"></strong> 吗？</p>
+            <input type="hidden" id="refresh-key-id">
+            <div class="modal-actions">
+                <button id="cancel-refresh-btn" class="btn-secondary">取消</button>
+                <button id="confirm-refresh-btn" class="btn-danger">确认刷新</button>
+            </div>
+        </div>
+    </div>
+
     <script src="app.js"></script>
 </body>
 </html>

dashboard/public/style.css

@@ -1,29 +1,31 @@
 :root {
-    /* Colors - Light Theme (Clean & Professional) */
-    --bg-body: #f3f4f6;
+    /* Colors - Light Theme (Modern Minimalist) */
+    --bg-body: #fafafa;
     --bg-card: #ffffff;
-    --bg-card-hover: #f9fafb;
+    --bg-card-hover: #f4f4f5;
     --bg-input: #ffffff;
     
-    --border-color: #e5e7eb;
-    --border-hover: #d1d5db;
+    --border-color: #e4e4e7;
+    --border-hover: #d4d4d8;
     
-    --primary: #4f46e5; /* Slightly darker indigo for better contrast on white */
-    --primary-hover: #4338ca;
-    --primary-glow: rgba(79, 70, 229, 0.15);
+    /* Primary: Teal/Emerald (Modern & Elegant) */
+    --primary: #0d9488;
+    --primary-hover: #0f766e;
+    --primary-glow: rgba(13, 148, 136, 0.15);
     
-    --danger: #dc2626;
-    --danger-hover: #b91c1c;
+    /* Accents */
+    --danger: #ef4444;
+    --danger-hover: #dc2626;
     
-    --success: #059669;
-    --success-hover: #047857;
+    --success: #10b981;
+    --success-hover: #059669;
     
-    --text-main: #111827;
-    --text-muted: #6b7280;
+    --text-main: #18181b;
+    --text-muted: #71717a;
     
     /* Spacing & Radius */
     --radius-sm: 6px;
-    --radius-md: 12px;
+    --radius-md: 10px;
     --radius-lg: 16px;
     --radius-xl: 24px;
     
@@ -35,33 +37,34 @@
     
     /* Effects */
     --shadow-sm: 0 1px 2px 0 rgba(0, 0, 0, 0.05);
-    --shadow-md: 0 4px 6px -1px rgba(0, 0, 0, 0.1), 0 2px 4px -1px rgba(0, 0, 0, 0.06);
-    --shadow-lg: 0 10px 15px -3px rgba(0, 0, 0, 0.1), 0 4px 6px -2px rgba(0, 0, 0, 0.05);
-    --glass-blur: blur(12px);
+    --shadow-md: 0 4px 6px -1px rgba(0, 0, 0, 0.05), 0 2px 4px -1px rgba(0, 0, 0, 0.03);
+    --shadow-lg: 0 10px 15px -3px rgba(0, 0, 0, 0.05), 0 4px 6px -2px rgba(0, 0, 0, 0.02);
+    --glass-blur: blur(16px);
     --transition: all 0.2s cubic-bezier(0.4, 0, 0.2, 1);
 }
 
 [data-theme="dark"] {
-    /* Colors - Dark Theme */
+    /* Colors - Dark Theme (Slate/Zinc) */
     --bg-body: #09090b;
-    --bg-card: rgba(39, 39, 42, 0.6);
-    --bg-card-hover: rgba(63, 63, 70, 0.6);
-    --bg-input: rgba(24, 24, 27, 0.8);
+    --bg-card: rgba(24, 24, 27, 0.6);
+    --bg-card-hover: rgba(39, 39, 42, 0.6);
+    --bg-input: rgba(39, 39, 42, 0.5);
     
     --border-color: rgba(255, 255, 255, 0.08);
-    --border-hover: rgba(255, 255, 255, 0.15);
+    --border-hover: rgba(255, 255, 255, 0.12);
     
-    --primary: #6366f1;
-    --primary-hover: #4f46e5;
-    --primary-glow: rgba(99, 102, 241, 0.4);
+    /* Primary: Lighter Teal for Dark Mode */
+    --primary: #14b8a6;
+    --primary-hover: #2dd4bf;
+    --primary-glow: rgba(20, 184, 166, 0.25);
     
-    --danger: #ef4444;
-    --danger-hover: #dc2626;
+    --danger: #f87171;
+    --danger-hover: #ef4444;
     
-    --success: #10b981;
-    --success-hover: #059669;
+    --success: #34d399;
+    --success-hover: #10b981;
     
-    --text-main: #fafafa;
+    --text-main: #f4f4f5;
     --text-muted: #a1a1aa;
     
     --shadow-sm: 0 1px 2px rgba(0, 0, 0, 0.5);
@@ -84,26 +87,41 @@ body {
     -webkit-font-smoothing: antialiased;
 }
 
+/* Elegant Background Pattern */
+body::before {
+    content: '';
+    position: fixed;
+    top: 0;
+    left: 0;
+    width: 100%;
+    height: 100%;
+    pointer-events: none;
+    background-image: radial-gradient(circle at 1px 1px, var(--border-color) 1px, transparent 0);
+    background-size: 40px 40px;
+    opacity: 0.4;
+    z-index: -1;
+}
+
 [data-theme="dark"] body {
     background-image: 
-        radial-gradient(circle at 15% 50%, rgba(99, 102, 241, 0.08), transparent 25%),
-        radial-gradient(circle at 85% 30%, rgba(139, 92, 246, 0.08), transparent 25%);
+        radial-gradient(circle at 20% 20%, rgba(20, 184, 166, 0.05), transparent 40%),
+        radial-gradient(circle at 80% 80%, rgba(20, 184, 166, 0.05), transparent 40%);
 }
 
 /* Scrollbar */
 ::-webkit-scrollbar {
-    width: 8px;
-    height: 8px;
+    width: 6px;
+    height: 6px;
 }
 ::-webkit-scrollbar-track {
     background: transparent;
 }
 ::-webkit-scrollbar-thumb {
-    background: rgba(255, 255, 255, 0.1);
-    border-radius: 4px;
+    background: var(--border-color);
+    border-radius: 3px;
 }
 ::-webkit-scrollbar-thumb:hover {
-    background: rgba(255, 255, 255, 0.2);
+    background: var(--text-muted);
 }
 
 /* Utilities */
@@ -115,11 +133,11 @@ body {
     min-height: 100vh;
     display: flex;
     flex-direction: column;
-    animation: fadeIn 0.5s ease-out;
+    animation: fadeIn 0.4s cubic-bezier(0.16, 1, 0.3, 1);
 }
 
 @keyframes fadeIn {
-    from { opacity: 0; transform: translateY(10px); }
+    from { opacity: 0; transform: translateY(8px); }
     to { opacity: 1; transform: translateY(0); }
 }
 
@@ -131,18 +149,16 @@ body {
     align-items: center;
     justify-content: center;
     padding: var(--space-xl);
-    background: radial-gradient(circle at center, rgba(99, 102, 241, 0.1) 0%, transparent 70%);
 }
 
 .login-container h1 {
     font-size: 2.5rem;
     font-weight: 800;
-    letter-spacing: -0.05em;
+    letter-spacing: -0.03em;
     margin-bottom: var(--space-xs);
-    background: linear-gradient(135deg, #fff 0%, #a1a1aa 100%);
+    background: linear-gradient(135deg, var(--text-main) 0%, var(--text-muted) 100%);
     -webkit-background-clip: text;
     -webkit-text-fill-color: transparent;
-    text-shadow: 0 0 30px rgba(99, 102, 241, 0.3);
 }
 
 .login-container h2 {
@@ -155,23 +171,23 @@ body {
 #login-form {
     background: var(--bg-card);
     backdrop-filter: var(--glass-blur);
-    padding: 40px;
+    padding: 48px;
     border-radius: var(--radius-xl);
     border: 1px solid var(--border-color);
     box-shadow: var(--shadow-lg);
     width: 100%;
-    max-width: 420px;
+    max-width: 400px;
     transition: var(--transition);
 }
 
 #login-form input {
     width: 100%;
-    padding: 16px;
+    padding: 14px 16px;
     background: var(--bg-input);
     border: 1px solid var(--border-color);
     border-radius: var(--radius-md);
     color: var(--text-main);
-    font-size: 1rem;
+    font-size: 0.95rem;
     margin-bottom: var(--space-lg);
     transition: var(--transition);
 }
@@ -179,17 +195,17 @@ body {
 #login-form input:focus {
     outline: none;
     border-color: var(--primary);
-    box-shadow: 0 0 0 4px rgba(99, 102, 241, 0.1);
+    box-shadow: 0 0 0 3px var(--primary-glow);
 }
 
 #login-form button {
     width: 100%;
-    padding: 16px;
-    background: linear-gradient(135deg, var(--primary) 0%, var(--primary-hover) 100%);
+    padding: 14px;
+    background: var(--primary);
     color: white;
     border: none;
     border-radius: var(--radius-md);
-    font-size: 1rem;
+    font-size: 0.95rem;
     font-weight: 600;
     cursor: pointer;
     transition: var(--transition);
@@ -197,15 +213,15 @@ body {
 }
 
 #login-form button:hover {
-    transform: translateY(-2px);
-    box-shadow: 0 8px 20px var(--primary-glow);
+    background: var(--primary-hover);
+    transform: translateY(-1px);
 }
 
 .error-message {
     color: var(--danger);
     margin-top: var(--space-md);
     text-align: center;
-    font-size: 0.9rem;
+    font-size: 0.85rem;
     min-height: 20px;
 }
 
@@ -213,17 +229,15 @@ body {
     margin-top: var(--space-xl);
     text-align: center;
     color: var(--text-muted);
-    font-size: 0.9rem;
-    background: rgba(255, 255, 255, 0.03);
+    font-size: 0.85rem;
     padding: var(--space-md) var(--space-lg);
     border-radius: var(--radius-lg);
-    border: 1px solid var(--border-color);
 }
 
 /* Navbar */
 .navbar {
-    background: var(--bg-card);
-    backdrop-filter: blur(20px);
+    background: rgba(var(--bg-card), 0.8);
+    backdrop-filter: blur(12px);
     padding: 16px 32px;
     display: flex;
     justify-content: space-between;
@@ -235,10 +249,23 @@ body {
 }
 
 .navbar h1 {
-    font-size: 1.25rem;
+    font-size: 1.1rem;
     font-weight: 700;
-    letter-spacing: -0.02em;
+    letter-spacing: -0.01em;
     color: var(--text-main);
+    display: flex;
+    align-items: center;
+    gap: 12px;
+}
+
+.navbar h1::before {
+    content: '';
+    display: block;
+    width: 10px;
+    height: 10px;
+    background: var(--primary);
+    border-radius: 50%;
+    box-shadow: 0 0 10px var(--primary);
 }
 
 .nav-info {
@@ -249,7 +276,8 @@ body {
 
 #user-info, #admin-user-info {
     font-size: 0.85rem;
-    color: var(--text-muted);
+    font-weight: 500;
+    color: var(--text-main);
     background: var(--bg-card);
     padding: 6px 12px;
     border-radius: 20px;
@@ -258,61 +286,44 @@ body {
 
 .logout-btn {
     padding: 8px 16px;
-    background: rgba(239, 68, 68, 0.1);
-    color: var(--danger);
-    border: 1px solid rgba(239, 68, 68, 0.2);
-    border-radius: var(--radius-sm);
+    background: transparent;
+    color: var(--text-muted);
+    border: 1px solid var(--border-color);
+    border-radius: var(--radius-md);
     cursor: pointer;
     font-size: 0.85rem;
-    font-weight: 600;
+    font-weight: 500;
     transition: var(--transition);
 }
 
 .logout-btn:hover {
-    background: rgba(239, 68, 68, 0.2);
+    background: var(--bg-card-hover);
+    color: var(--danger);
     border-color: var(--danger);
 }
 
 /* Theme Toggle */
 .theme-toggle {
     background: transparent;
-    border: 1px solid var(--border-color);
+    border: none;
     color: var(--text-muted);
-    padding: 6px 16px;
-    border-radius: var(--radius-md);
+    padding: 8px;
+    border-radius: 50%;
     cursor: pointer;
-    font-size: 0.85rem;
-    font-weight: 600;
     transition: var(--transition);
     display: flex;
     align-items: center;
     justify-content: center;
-    height: auto;
-    width: auto;
-    white-space: nowrap;
 }
 
 .theme-toggle:hover {
-    background: var(--bg-card-hover);
     color: var(--text-main);
-    border-color: var(--border-hover);
-}
-
-[data-theme="light"] .theme-toggle {
-    background: var(--bg-input);
-    color: var(--text-main);
-    border-color: var(--border-color);
-}
-
-[data-theme="light"] .theme-toggle:hover {
     background: var(--bg-card-hover);
-    border-color: var(--primary);
-    color: var(--primary);
 }
 
 /* Main Container */
 .container {
-    max-width: 1200px;
+    max-width: 1000px;
     margin: 0 auto;
     padding: var(--space-xl);
     width: 100%;
@@ -321,7 +332,7 @@ body {
 /* Stats Grid */
 .stats-grid {
     display: grid;
-    grid-template-columns: repeat(auto-fit, minmax(240px, 1fr));
+    grid-template-columns: repeat(auto-fit, minmax(200px, 1fr));
     gap: var(--space-md);
     margin-bottom: var(--space-xl);
 }
@@ -331,32 +342,29 @@ body {
     padding: var(--space-lg);
     border-radius: var(--radius-lg);
     border: 1px solid var(--border-color);
-    backdrop-filter: var(--glass-blur);
-    text-align: center;
+    text-align: left;
     transition: var(--transition);
 }
 
 .stat-card:hover {
-    border-color: var(--border-hover);
-    transform: translateY(-2px);
-    background: var(--bg-card-hover);
+    border-color: var(--primary);
+    box-shadow: var(--shadow-md);
 }
 
 .stat-card h3 {
     color: var(--text-muted);
-    font-size: 0.85rem;
+    font-size: 0.8rem;
+    font-weight: 600;
     text-transform: uppercase;
     letter-spacing: 0.05em;
-    margin-bottom: var(--space-sm);
+    margin-bottom: var(--space-xs);
 }
 
 .stat-value {
-    font-size: 2.5rem;
+    font-size: 2.2rem;
     font-weight: 700;
     color: var(--text-main);
-    background: linear-gradient(135deg, #fff 0%, #cbd5e1 100%);
-    -webkit-background-clip: text;
-    -webkit-text-fill-color: transparent;
+    letter-spacing: -0.03em;
 }
 
 /* Section */
@@ -366,7 +374,7 @@ body {
     border-radius: var(--radius-lg);
     border: 1px solid var(--border-color);
     margin-bottom: var(--space-xl);
-    backdrop-filter: var(--glass-blur);
+    box-shadow: var(--shadow-sm);
 }
 
 .section-header {
@@ -374,19 +382,19 @@ body {
     justify-content: space-between;
     align-items: center;
     margin-bottom: var(--space-lg);
-    border-bottom: 1px solid var(--border-color);
     padding-bottom: var(--space-md);
+    border-bottom: 1px solid var(--border-color);
 }
 
 .section h2 {
-    font-size: 1.25rem;
+    font-size: 1.1rem;
     font-weight: 600;
     color: var(--text-main);
 }
 
 /* Buttons */
 .btn-primary, .btn-secondary, .btn-danger, .btn-success {
-    padding: 10px 20px;
+    padding: 10px 18px;
     border-radius: var(--radius-md);
     font-weight: 500;
     cursor: pointer;
@@ -396,46 +404,46 @@ body {
     align-items: center;
     justify-content: center;
     gap: 8px;
+    border: 1px solid transparent;
 }
 
 .btn-primary {
     background: var(--primary);
     color: white;
-    border: 1px solid transparent;
-    box-shadow: 0 2px 8px rgba(99, 102, 241, 0.3);
+    box-shadow: 0 2px 8px var(--primary-glow);
 }
 .btn-primary:hover {
     background: var(--primary-hover);
-    box-shadow: 0 4px 12px rgba(99, 102, 241, 0.5);
+    transform: translateY(-1px);
 }
 
 .btn-secondary {
-    background: transparent;
+    background: var(--bg-input);
     color: var(--text-main);
-    border: 1px solid var(--border-color);
+    border-color: var(--border-color);
 }
 .btn-secondary:hover {
-    background: rgba(255, 255, 255, 0.05);
+    background: var(--bg-card-hover);
     border-color: var(--border-hover);
 }
 
 .btn-danger {
-    background: rgba(239, 68, 68, 0.1);
+    background: transparent;
     color: var(--danger);
-    border: 1px solid rgba(239, 68, 68, 0.2);
+    border-color: rgba(239, 68, 68, 0.3);
 }
 .btn-danger:hover {
-    background: rgba(239, 68, 68, 0.2);
+    background: rgba(239, 68, 68, 0.1);
     border-color: var(--danger);
 }
 
 .btn-success {
-    background: rgba(16, 185, 129, 0.1);
+    background: transparent;
     color: var(--success);
-    border: 1px solid rgba(16, 185, 129, 0.2);
+    border-color: rgba(16, 185, 129, 0.3);
 }
 .btn-success:hover {
-    background: rgba(16, 185, 129, 0.2);
+    background: rgba(16, 185, 129, 0.1);
     border-color: var(--success);
 }
 
@@ -448,45 +456,41 @@ body {
 
 .group-title {
     color: var(--text-muted);
-    font-size: 0.9rem;
+    font-size: 0.8rem;
+    font-weight: 600;
     text-transform: uppercase;
     letter-spacing: 0.05em;
     margin: var(--space-lg) 0 var(--space-sm) 0;
-    padding-bottom: var(--space-xs);
-    border-bottom: 1px solid var(--border-color);
 }
 
 /* AI Provider Select */
 #ai-provider-select {
     margin-bottom: var(--space-md);
-    background: var(--bg-input);
-    color: var(--text-main);
-    border: 1px solid var(--border-color);
 }
+
 /* Key Cards */
 .key-card {
     background: var(--bg-card);
     border: 1px solid var(--border-color);
     border-radius: var(--radius-md);
-    padding: var(--space-lg);
+    padding: var(--space-md) var(--space-lg);
     display: flex;
     align-items: center;
     transition: var(--transition);
 }
 
-.key-card.admin {
-    border-color: rgba(99, 102, 241, 0.3);
-    background: rgba(99, 102, 241, 0.05);
+.key-card:hover {
+    border-color: var(--border-hover);
+    background: var(--bg-card-hover);
 }
 
-[data-theme="light"] .key-card.admin {
-    background: rgba(99, 102, 241, 0.05);
-    border-color: rgba(99, 102, 241, 0.2);
+.key-card.admin {
+    border-left: 3px solid var(--primary);
 }
 
 .regular-key-group {
     border: 1px solid var(--border-color);
-    border-radius: var(--radius-lg);
+    border-radius: var(--radius-md);
     overflow: hidden;
     background: var(--bg-card);
 }
@@ -505,26 +509,24 @@ body {
 }
 
 .nested-server-keys {
-    padding: 0 var(--space-lg) var(--space-lg) calc(var(--space-lg) + 30px);
+    padding: 0 var(--space-lg) var(--space-lg) calc(var(--space-lg) + 24px);
     border-top: 1px solid var(--border-color);
-    background: rgba(0, 0, 0, 0.1);
-}
-
-[data-theme="light"] .nested-server-keys {
-    background: rgba(0, 0, 0, 0.02);
+    background: var(--bg-card-hover);
 }
 
 .nested-server-keys h4 {
     color: var(--text-muted);
-    font-size: 0.8rem;
+    font-size: 0.75rem;
+    font-weight: 600;
+    text-transform: uppercase;
     margin: var(--space-md) 0;
-    opacity: 0.7;
+    opacity: 0.8;
 }
 
 .key-card.nested {
     padding: var(--space-md);
     background: var(--bg-card);
-    border-left: 2px solid var(--primary);
+    border: 1px solid var(--border-color);
 }
 
 .toggle-icon-container {
@@ -534,25 +536,15 @@ body {
     align-items: center;
     justify-content: center;
     margin-right: var(--space-md);
-    background: rgba(255, 255, 255, 0.05);
+    background: var(--bg-input);
     border-radius: 50%;
-}
-
-[data-theme="light"] .toggle-icon-container {
-    background: rgba(0, 0, 0, 0.05);
+    border: 1px solid var(--border-color);
 }
 
 .toggle-icon {
-    font-size: 0.8rem;
+    font-size: 0.7rem;
     color: var(--text-muted);
-    transition: transform 0.3s cubic-bezier(0.4, 0, 0.2, 1);
-    /* Fix alignment */
-    display: flex;
-    align-items: center;
-    justify-content: center;
-    width: 100%;
-    height: 100%;
-    margin-top: 2px; /* Visual correction */
+    transition: transform 0.2s;
 }
 
 .key-info {
@@ -562,33 +554,35 @@ body {
 .key-info h3 {
     display: flex;
     align-items: center;
-    font-size: 1rem;
-    margin-bottom: var(--space-xs);
+    font-size: 0.95rem;
+    font-weight: 600;
+    margin-bottom: 4px;
     color: var(--text-main);
 }
 
 .key-info p {
     color: var(--text-muted);
-    font-size: 0.85rem;
+    font-size: 0.8rem;
     margin-bottom: 2px;
     font-family: 'JetBrains Mono', monospace;
 }
 
 .key-badge {
     padding: 2px 8px;
-    border-radius: 4px;
+    border-radius: 12px;
     font-size: 0.7rem;
     font-weight: 600;
     margin-right: var(--space-sm);
     text-transform: uppercase;
+    letter-spacing: 0.02em;
 }
 
-.key-badge.admin { background: rgba(139, 92, 246, 0.2); color: #c4b5fd; border: 1px solid rgba(139, 92, 246, 0.3); }
-.key-badge.regular { background: rgba(59, 130, 246, 0.2); color: #93c5fd; border: 1px solid rgba(59, 130, 246, 0.3); }
-.key-badge.server { background: rgba(16, 185, 129, 0.2); color: #6ee7b7; border: 1px solid rgba(16, 185, 129, 0.3); }
+.key-badge.admin { background: var(--primary); color: white; }
+.key-badge.regular { background: var(--bg-input); color: var(--text-main); border: 1px solid var(--border-color); }
+.key-badge.server { background: transparent; color: var(--text-muted); border: 1px solid var(--border-color); }
 
-.key-badge.active { background: rgba(16, 185, 129, 0.2); color: #34d399; }
-.key-badge.inactive { background: rgba(239, 68, 68, 0.2); color: #f87171; }
+.key-badge.active { color: var(--success); background: rgba(16, 185, 129, 0.1); }
+.key-badge.inactive { color: var(--text-muted); background: var(--bg-input); }
 
 .key-actions {
     display: flex;
@@ -603,10 +597,10 @@ body {
 
 label {
     display: block;
-    margin-bottom: var(--space-xs);
+    margin-bottom: 6px;
     font-weight: 500;
     color: var(--text-main);
-    font-size: 0.9rem;
+    font-size: 0.85rem;
 }
 
 input[type="text"],
@@ -614,25 +608,25 @@ input[type="password"],
 textarea,
 select {
     width: 100%;
-    padding: 12px;
+    padding: 10px 14px;
     background: var(--bg-input);
     border: 1px solid var(--border-color);
     border-radius: var(--radius-md);
     color: var(--text-main);
     font-family: inherit;
-    font-size: 0.95rem;
+    font-size: 0.9rem;
     transition: var(--transition);
 }
 
 input:focus, textarea:focus, select:focus {
     outline: none;
     border-color: var(--primary);
-    box-shadow: 0 0 0 3px rgba(99, 102, 241, 0.15);
+    box-shadow: 0 0 0 3px var(--primary-glow);
 }
 
 .hint {
     display: block;
-    margin-top: var(--space-xs);
+    margin-top: 6px;
     font-size: 0.8rem;
     color: var(--text-muted);
 }
@@ -641,39 +635,48 @@ input:focus, textarea:focus, select:focus {
 .events-list {
     max-height: 400px;
     overflow-y: auto;
-    background: rgba(0, 0, 0, 0.2);
+    background: var(--bg-input);
+    border: 1px solid var(--border-color);
     border-radius: var(--radius-md);
-    padding: var(--space-sm);
+    padding: 0;
 }
 
 .event-item {
-    padding: var(--space-md);
-    border-left: 3px solid var(--primary);
-    background: rgba(255, 255, 255, 0.02);
-    margin-bottom: var(--space-sm);
-    border-radius: 0 var(--radius-sm) var(--radius-sm) 0;
-    font-size: 0.9rem;
+    padding: 12px 16px;
+    border-bottom: 1px solid var(--border-color);
+    border-left: 3px solid transparent;
+    transition: var(--transition);
+}
+
+.event-item:last-child {
+    border-bottom: none;
+}
+
+.event-item:hover {
+    background: var(--bg-card-hover);
+    border-left-color: var(--primary);
 }
 
 .event-item strong {
-    color: var(--primary);
+    color: var(--text-main);
+    font-weight: 600;
 }
 
 .event-item pre {
-    background: rgba(0, 0, 0, 0.3);
-    padding: var(--space-sm);
+    background: var(--bg-body);
+    padding: 10px;
     border-radius: var(--radius-sm);
-    margin-top: var(--space-xs);
+    margin-top: 8px;
     color: var(--text-muted);
     font-size: 0.8rem;
-    overflow-x: auto;
+    border: 1px solid var(--border-color);
 }
 
 /* Command Console */
 .command-history {
     height: 300px;
     overflow-y: auto;
-    background: #000;
+    background: #0f172a; /* Always dark for terminal feel */
     border: 1px solid var(--border-color);
     border-radius: var(--radius-md);
     padding: var(--space-md);
@@ -682,17 +685,17 @@ input:focus, textarea:focus, select:focus {
 }
 
 .command-item {
-    margin-bottom: 6px;
-    padding-bottom: 6px;
-    border-bottom: 1px solid rgba(255, 255, 255, 0.05);
+    margin-bottom: 8px;
+    padding-bottom: 8px;
+    border-bottom: 1px solid rgba(255, 255, 255, 0.1);
     color: #e2e8f0;
-    font-size: 0.9rem;
+    font-size: 0.85rem;
 }
 
 .command-item .timestamp {
     color: #64748b;
     font-size: 0.75rem;
-    margin-top: 2px;
+    margin-top: 4px;
 }
 
 .command-form {
@@ -707,8 +710,8 @@ input:focus, textarea:focus, select:focus {
     left: 0;
     width: 100%;
     height: 100%;
-    background: rgba(0, 0, 0, 0.7);
-    backdrop-filter: blur(8px);
+    background: rgba(0, 0, 0, 0.4);
+    backdrop-filter: blur(4px);
     display: flex;
     justify-content: center;
     align-items: center;
@@ -718,29 +721,57 @@ input:focus, textarea:focus, select:focus {
 
 .modal-content {
     background: var(--bg-card);
-    padding: var(--space-xl);
+    padding: 32px;
     border-radius: var(--radius-xl);
     border: 1px solid var(--border-color);
-    width: 90%;
-    max-width: 500px;
-    box-shadow: 0 20px 25px -5px rgba(0, 0, 0, 0.5);
-    color: var(--text-main);
+    box-shadow: var(--shadow-lg);
 }
 
 .modal-actions {
-    display: flex;
-    justify-content: flex-end;
-    gap: var(--space-sm);
-    margin-top: var(--space-xl);
+    margin-top: 32px;
+    padding-top: 24px;
+    border-top: 1px solid var(--border-color);
 }
 
 /* AI Status */
 .ai-status {
     margin-top: var(--space-md);
-    padding: var(--space-md);
+    padding: 12px 16px;
     border-radius: var(--radius-md);
-    font-size: 0.9rem;
+    font-size: 0.85rem;
+    display: flex;
+    align-items: center;
+    gap: 8px;
+}
+.ai-status::before {
+    content: '';
+    display: block;
+    width: 8px;
+    height: 8px;
+    border-radius: 50%;
 }
 .ai-status.success { background: rgba(16, 185, 129, 0.1); color: var(--success); border: 1px solid rgba(16, 185, 129, 0.2); }
+.ai-status.success::before { background: var(--success); }
+
 .ai-status.error { background: rgba(239, 68, 68, 0.1); color: var(--danger); border: 1px solid rgba(239, 68, 68, 0.2); }
-.ai-status.info { background: rgba(99, 102, 241, 0.1); color: var(--primary); border: 1px solid rgba(99, 102, 241, 0.2); }
+.ai-status.error::before { background: var(--danger); }
+
+.ai-status.info { background: rgba(13, 148, 136, 0.1); color: var(--primary); border: 1px solid rgba(13, 148, 136, 0.2); }
+.ai-status.info::before { background: var(--primary); }
+
+.modal-parent-info {
+    color: var(--primary);
+    font-size: 0.85rem;
+    margin-bottom: var(--space-lg);
+    padding: 12px;
+    background: var(--primary-glow);
+    border: 1px solid transparent;
+    border-radius: var(--radius-md);
+    font-weight: 500;
+}
+
+.modal-parent-info.danger-bg {
+    color: var(--danger);
+    background: rgba(239, 68, 68, 0.1);
+    border: 1px solid rgba(239, 68, 68, 0.2);
+}

docs/API.md

@@ -290,7 +290,7 @@ Authorization: Bearer <regular_key_or_admin_key>
 
 为指定的 Regular Key 创建新的 Server Key。
 
-**权限**: Admin Key
+**权限**: Admin Key（仅限管理员，Regular Key 不能为自己创建 Server Key）
 
 **请求**
 
@@ -336,6 +336,33 @@ Content-Type: application/json
 }
 ```
 
+**错误响应** `400 Bad Request`
+
+```json
+{
+  "detail": "Name is required"
+}
+```
+
+```json
+{
+  "detail": "regular_key_id is required"
+}
+```
+
+**错误响应** `404 Not Found`
+
+```json
+{
+  "detail": "Invalid Regular Key ID"
+}
+```
+
+> ⚠️ **重要**: 
+> - 只有 Admin Key 可以为 Regular Key 创建额外的 Server Key
+> - Regular Key 不能为自己创建或删除 Server Key
+> - `key` 字段只在创建时返回一次，请妥善保存！
+
 ---
 
 ### 激活 API Key

docs/openapi.json

@@ -0,0 +1,930 @@
+{
+  "openapi": "3.0.0",
+  "info": {
+    "title": "InterConnect-Server API",
+    "version": "1.0.0",
+    "description": "InterConnect-Server 是一个 Minecraft WebSocket API 服务器，提供 API Key 管理、事件广播、服务器命令等功能。\n\n权限说明：\n- **Admin Key**: `mc_admin_` 前缀，拥有完整管理权限。\n- **Regular Key**: `mc_key_` 前缀，可查看/管理关联的 Server Key，发送服务器命令。\n- **Server Key**: `mc_server_` 前缀，仅用于插件/Mod 配置，用于认证和事件上报。"
+  },
+  "servers": [
+    {
+      "url": "http://localhost:8000",
+      "description": "本地服务器"
+    }
+  ],
+  "components": {
+    "securitySchemes": {
+      "bearerAuth": {
+        "type": "http",
+        "scheme": "bearer",
+        "bearerFormat": "API Key",
+        "description": "使用 API Key 进行认证 (Bearer Token)"
+      }
+    },
+    "schemas": {
+      "ApiKey": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "name": {
+            "type": "string"
+          },
+          "description": {
+            "type": "string"
+          },
+          "keyPrefix": {
+            "type": "string",
+            "enum": ["mc_admin_", "mc_key_", "mc_server_"]
+          },
+          "keyType": {
+            "type": "string",
+            "enum": ["admin", "regular", "server"]
+          },
+          "serverId": {
+            "type": "string",
+            "nullable": true
+          },
+          "regularKeyId": {
+            "type": "string",
+            "nullable": true
+          },
+          "createdAt": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "lastUsed": {
+            "type": "string",
+            "format": "date-time",
+            "nullable": true
+          },
+          "isActive": {
+            "type": "boolean"
+          }
+        }
+      },
+      "ApiKeyWithSecret": {
+        "allOf": [
+          {
+            "$ref": "#/components/schemas/ApiKey"
+          },
+          {
+            "type": "object",
+            "properties": {
+              "key": {
+                "type": "string",
+                "description": "原始 API Key，仅在创建时返回一次"
+              }
+            }
+          }
+        ]
+      },
+      "CreateKeyRequest": {
+        "type": "object",
+        "required": ["name"],
+        "properties": {
+          "name": {
+            "type": "string"
+          },
+          "description": {
+            "type": "string"
+          },
+          "key_type": {
+            "type": "string",
+            "enum": ["regular", "admin"],
+            "default": "regular"
+          },
+          "server_id": {
+            "type": "string"
+          }
+        }
+      },
+      "CreateServerKeyRequest": {
+        "type": "object",
+        "required": ["name", "regular_key_id"],
+        "properties": {
+          "name": {
+            "type": "string"
+          },
+          "description": {
+            "type": "string"
+          },
+          "server_id": {
+            "type": "string"
+          },
+          "regular_key_id": {
+            "type": "string",
+            "description": "关联的 Regular Key ID"
+          }
+        }
+      },
+      "Event": {
+        "type": "object",
+        "required": ["event_type", "server_name", "timestamp", "data"],
+        "properties": {
+          "event_type": {
+            "type": "string",
+            "description": "事件类型 (e.g., player_join, player_leave, message, ai_chat)"
+          },
+          "server_name": {
+            "type": "string"
+          },
+          "timestamp": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "data": {
+            "type": "object",
+            "description": "事件具体数据"
+          }
+        }
+      },
+      "CommandRequest": {
+        "type": "object",
+        "required": ["command"],
+        "properties": {
+          "command": {
+            "type": "string"
+          },
+          "server_id": {
+            "type": "string",
+            "description": "仅 Admin Key 需要/可以指定"
+          }
+        }
+      },
+      "AiConfig": {
+        "type": "object",
+        "properties": {
+          "apiUrl": {
+            "type": "string"
+          },
+          "modelId": {
+            "type": "string"
+          },
+          "apiKey": {
+            "type": "string",
+            "description": "部分隐藏的 API Key"
+          },
+          "enabled": {
+            "type": "boolean"
+          },
+          "systemPrompt": {
+            "type": "string"
+          },
+          "createdAt": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "updatedAt": {
+            "type": "string",
+            "format": "date-time"
+          }
+        }
+      },
+      "AiConfigUpdateRequest": {
+        "type": "object",
+        "properties": {
+          "api_url": {
+            "type": "string"
+          },
+          "model_id": {
+            "type": "string"
+          },
+          "api_key": {
+            "type": "string"
+          },
+          "enabled": {
+            "type": "boolean"
+          },
+          "system_prompt": {
+            "type": "string"
+          }
+        }
+      },
+      "AiChatRequest": {
+        "type": "object",
+        "required": ["message"],
+        "properties": {
+          "message": {
+            "type": "string"
+          },
+          "player_name": {
+            "type": "string"
+          },
+          "server_id": {
+            "type": "string"
+          }
+        }
+      },
+      "ErrorResponse": {
+        "type": "object",
+        "properties": {
+          "detail": {
+            "type": "string"
+          }
+        }
+      }
+    }
+  },
+  "paths": {
+    "/health": {
+      "get": {
+        "summary": "健康检查",
+        "description": "获取服务器状态和统计信息",
+        "security": [],
+        "responses": {
+          "200": {
+            "description": "服务器正常",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "status": {
+                      "type": "string"
+                    },
+                    "timestamp": {
+                      "type": "string"
+                    },
+                    "active_ws": {
+                      "type": "integer"
+                    },
+                    "keys_total": {
+                      "type": "integer"
+                    },
+                    "admin_active": {
+                      "type": "integer"
+                    },
+                    "server_active": {
+                      "type": "integer"
+                    },
+                    "regular_active": {
+                      "type": "integer"
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/manage/keys": {
+      "get": {
+        "summary": "获取所有 API Key",
+        "description": "获取所有 API Key 列表 (仅 Admin)",
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "成功",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/ApiKey"
+                  }
+                }
+              }
+            }
+          },
+          "403": {
+            "description": "权限不足",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            }
+          }
+        }
+      },
+      "post": {
+        "summary": "创建 API Key",
+        "description": "创建新的 Admin 或 Regular Key (创建 Regular Key 会自动附带一个 Server Key)",
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/CreateKeyRequest"
+              }
+            }
+          }
+        },
+        "responses": {
+          "201": {
+            "description": "创建成功",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "oneOf": [
+                    {
+                      "$ref": "#/components/schemas/ApiKeyWithSecret"
+                    },
+                    {
+                      "type": "object",
+                      "properties": {
+                        "regularKey": {
+                          "$ref": "#/components/schemas/ApiKeyWithSecret"
+                        },
+                        "serverKey": {
+                          "$ref": "#/components/schemas/ApiKeyWithSecret"
+                        }
+                      }
+                    }
+                  ]
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/manage/keys/{key_id}": {
+      "get": {
+        "summary": "获取 API Key 详情",
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ],
+        "parameters": [
+          {
+            "in": "path",
+            "name": "key_id",
+            "schema": {
+              "type": "string"
+            },
+            "required": true
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "成功",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ApiKey"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "未找到",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            }
+          }
+        }
+      },
+      "delete": {
+        "summary": "删除 API Key",
+        "description": "仅 Admin 可操作，不能删除自己",
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ],
+        "parameters": [
+          {
+            "in": "path",
+            "name": "key_id",
+            "schema": {
+              "type": "string"
+            },
+            "required": true
+          }
+        ],
+        "responses": {
+          "204": {
+            "description": "删除成功"
+          },
+          "400": {
+            "description": "无法删除（如试图删除自己）",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/manage/keys/{key_id}/activate": {
+      "patch": {
+        "summary": "激活 API Key",
+        "description": "Admin 可激活任意 Key，Regular 仅可激活关联的 Server Key",
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ],
+        "parameters": [
+          {
+            "in": "path",
+            "name": "key_id",
+            "schema": {
+              "type": "string"
+            },
+            "required": true
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "成功",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "message": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/manage/keys/{key_id}/deactivate": {
+      "patch": {
+        "summary": "停用 API Key",
+        "description": "Admin 可停用任意 Key，Regular 仅可停用关联的 Server Key",
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ],
+        "parameters": [
+          {
+            "in": "path",
+            "name": "key_id",
+            "schema": {
+              "type": "string"
+            },
+            "required": true
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "成功",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "message": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/manage/keys/server-keys": {
+      "get": {
+        "summary": "获取 Server Key 列表",
+        "description": "Admin 获取所有 Server Key，Regular 获取关联的 Server Key",
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "成功",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/ApiKey"
+                  }
+                }
+              }
+            }
+          }
+        }
+      },
+      "post": {
+        "summary": "创建 Server Key",
+        "description": "为指定的 Regular Key 创建新的 Server Key (仅 Admin，Regular Key 不能为自己创建)",
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/CreateServerKeyRequest"
+              }
+            }
+          }
+        },
+        "responses": {
+          "201": {
+            "description": "创建成功",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ApiKeyWithSecret"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "参数错误",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "Regular Key 不��在",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/api/events": {
+      "post": {
+        "summary": "发送事件",
+        "description": "发送 Minecraft 事件并广播给所有 WebSocket 连接",
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/Event"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "成功广播",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "message": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/api/server/info": {
+      "get": {
+        "summary": "获取服务器信息",
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ],
+        "parameters": [
+          {
+            "in": "query",
+            "name": "server_id",
+            "schema": {
+              "type": "string"
+            },
+            "description": "仅 Admin 需要"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "成功",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "server_id": {
+                      "type": "string"
+                    },
+                    "status": {
+                      "type": "string"
+                    },
+                    "online_players": {
+                      "type": "integer"
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/api/server/command": {
+      "post": {
+        "summary": "发送服务器命令",
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/CommandRequest"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "命令发送成功",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "message": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "403": {
+            "description": "禁止的命令",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/api/ai/config": {
+      "get": {
+        "summary": "获取 AI 配置 (Admin)",
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "成功",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/AiConfig"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "配置不存在",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            }
+          }
+        }
+      },
+      "post": {
+        "summary": "创建 AI 配置 (Admin)",
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/AiConfigUpdateRequest"
+              }
+            }
+          }
+        },
+        "responses": {
+          "201": {
+            "description": "创建成功",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/AiConfig"
+                }
+              }
+            }
+          }
+        }
+      },
+      "patch": {
+        "summary": "更新 AI 配置 (Admin)",
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/AiConfigUpdateRequest"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "更新成功",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/AiConfig"
+                }
+              }
+            }
+          }
+        }
+      },
+      "delete": {
+        "summary": "删除 AI 配置 (Admin)",
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ],
+        "responses": {
+          "204": {
+            "description": "删除成功"
+          }
+        }
+      }
+    },
+    "/api/ai/config/test": {
+      "post": {
+        "summary": "测试 AI 连接 (Admin)",
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "连接成功",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "success": {
+                      "type": "boolean"
+                    },
+                    "message": {
+                      "type": "string"
+                    },
+                    "model": {
+                      "type": "string"
+                    },
+                    "response": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/api/ai/chat": {
+      "post": {
+        "summary": "AI 聊天",
+        "description": "发送消息给 AI 并获取回复",
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/AiChatRequest"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "成功",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "success": {
+                      "type": "boolean"
+                    },
+                    "reply": {
+                      "type": "string"
+                    },
+                    "model": {
+                      "type": "string"
+                    },
+                    "usage": {
+                      "type": "object",
+                      "properties": {
+                        "prompt_tokens": {
+                          "type": "integer"
+                        },
+                        "completion_tokens": {
+                          "type": "integer"
+                        },
+                        "total_tokens": {
+                          "type": "integer"
+                        }
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "403": {
+            "description": "AI 功能已禁用",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "AI 配置不存在",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+}

docs/openapi.yaml

@@ -0,0 +1,512 @@
+openapi: 3.0.0
+info:
+  title: InterConnect-Server API
+  version: 1.0.0
+  description: |
+    InterConnect-Server 是一个 Minecraft WebSocket API 服务器，提供 API Key 管理、事件广播、服务器命令等功能。
+    
+    权限说明：
+    - **Admin Key**: `mc_admin_` 前缀，拥有完整管理权限。
+    - **Regular Key**: `mc_key_` 前缀，可查看/管理关联的 Server Key，发送服务器命令。
+    - **Server Key**: `mc_server_` 前缀，仅用于插件/Mod 配置，用于认证和事件上报。
+
+servers:
+  - url: http://localhost:8000
+    description: 本地服务器
+
+components:
+  securitySchemes:
+    bearerAuth:
+      type: http
+      scheme: bearer
+      bearerFormat: API Key
+      description: 使用 API Key 进行认证 (Bearer Token)
+
+  schemas:
+    ApiKey:
+      type: object
+      properties:
+        id:
+          type: string
+          format: uuid
+        name:
+          type: string
+        description:
+          type: string
+        keyPrefix:
+          type: string
+          enum: [mc_admin_, mc_key_, mc_server_]
+        keyType:
+          type: string
+          enum: [admin, regular, server]
+        serverId:
+          type: string
+          nullable: true
+        regularKeyId:
+          type: string
+          nullable: true
+        createdAt:
+          type: string
+          format: date-time
+        lastUsed:
+          type: string
+          format: date-time
+          nullable: true
+        isActive:
+          type: boolean
+    
+    ApiKeyWithSecret:
+      allOf:
+        - $ref: '#/components/schemas/ApiKey'
+        - type: object
+          properties:
+            key:
+              type: string
+              description: 原始 API Key，仅在创建时返回一次
+
+    CreateKeyRequest:
+      type: object
+      required: [name]
+      properties:
+        name:
+          type: string
+        description:
+          type: string
+        key_type:
+          type: string
+          enum: [regular, admin]
+          default: regular
+        server_id:
+          type: string
+
+    CreateServerKeyRequest:
+      type: object
+      required: [name, regular_key_id]
+      properties:
+        name:
+          type: string
+        description:
+          type: string
+        server_id:
+          type: string
+        regular_key_id:
+          type: string
+
+    Event:
+      type: object
+      required: [event_type, server_name, timestamp, data]
+      properties:
+        event_type:
+          type: string
+          description: 事件类型 (e.g., player_join, player_leave, message, ai_chat)
+        server_name:
+          type: string
+        timestamp:
+          type: string
+          format: date-time
+        data:
+          type: object
+          description: 事件具体数据
+
+    CommandRequest:
+      type: object
+      required: [command]
+      properties:
+        command:
+          type: string
+        server_id:
+          type: string
+          description: 仅 Admin Key 需要/可以指定
+
+    AiConfig:
+      type: object
+      properties:
+        apiUrl:
+          type: string
+        modelId:
+          type: string
+        apiKey:
+          type: string
+          description: 部分隐藏的 API Key
+        enabled:
+          type: boolean
+        systemPrompt:
+          type: string
+        createdAt:
+          type: string
+          format: date-time
+        updatedAt:
+          type: string
+          format: date-time
+
+    AiConfigUpdateRequest:
+      type: object
+      properties:
+        api_url:
+          type: string
+        model_id:
+          type: string
+        api_key:
+          type: string
+        enabled:
+          type: boolean
+        system_prompt:
+          type: string
+
+    AiChatRequest:
+      type: object
+      required: [message]
+      properties:
+        message:
+          type: string
+        player_name:
+          type: string
+        server_id:
+          type: string
+
+paths:
+  /health:
+    get:
+      summary: 健康检查
+      description: 获取服务器状态和统计信息
+      security: []
+      responses:
+        '200':
+          description: 服务器正常
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  status:
+                    type: string
+                  timestamp:
+                    type: string
+                  active_ws:
+                    type: integer
+                  keys_total:
+                    type: integer
+                  admin_active:
+                    type: integer
+                  server_active:
+                    type: integer
+                  regular_active:
+                    type: integer
+
+  /manage/keys:
+    get:
+      summary: 获取所有 API Key
+      description: 获取所有 API Key 列表 (仅 Admin)
+      security:
+        - bearerAuth: []
+      responses:
+        '200':
+          description: 成功
+          content:
+            application/json:
+              schema:
+                type: array
+                items:
+                  $ref: '#/components/schemas/ApiKey'
+        '403':
+          description: 权限不足
+    
+    post:
+      summary: 创建 API Key
+      description: 创建新的 Admin 或 Regular Key (创建 Regular Key 会自动附带一个 Server Key)
+      security:
+        - bearerAuth: []
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/CreateKeyRequest'
+      responses:
+        '201':
+          description: 创建成功
+          content:
+            application/json:
+              schema:
+                oneOf:
+                  - $ref: '#/components/schemas/ApiKeyWithSecret'
+                  - type: object
+                    properties:
+                      regularKey:
+                        $ref: '#/components/schemas/ApiKeyWithSecret'
+                      serverKey:
+                        $ref: '#/components/schemas/ApiKeyWithSecret'
+
+  /manage/keys/{key_id}:
+    get:
+      summary: 获取 API Key 详情
+      security:
+        - bearerAuth: []
+      parameters:
+        - in: path
+          name: key_id
+          schema:
+            type: string
+          required: true
+      responses:
+        '200':
+          description: 成功
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ApiKey'
+        '404':
+          description: 未找到
+    
+    delete:
+      summary: 删除 API Key
+      description: 仅 Admin 可操作，不能删除自己
+      security:
+        - bearerAuth: []
+      parameters:
+        - in: path
+          name: key_id
+          schema:
+            type: string
+          required: true
+      responses:
+        '204':
+          description: 删除成功
+        '400':
+          description: 无法删除（如试图删除自己）
+
+  /manage/keys/{key_id}/activate:
+    patch:
+      summary: 激活 API Key
+      description: Admin 可激活任意 Key，Regular 仅可激活关联的 Server Key
+      security:
+        - bearerAuth: []
+      parameters:
+        - in: path
+          name: key_id
+          schema:
+            type: string
+          required: true
+      responses:
+        '200':
+          description: 成功
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  message:
+                    type: string
+
+  /manage/keys/{key_id}/deactivate:
+    patch:
+      summary: 停用 API Key
+      description: Admin 可停用任意 Key，Regular 仅可停用关联的 Server Key
+      security:
+        - bearerAuth: []
+      parameters:
+        - in: path
+          name: key_id
+          schema:
+            type: string
+          required: true
+      responses:
+        '200':
+          description: 成功
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  message:
+                    type: string
+
+  /manage/keys/server-keys:
+    get:
+      summary: 获取 Server Key 列表
+      description: Admin 获取所有 Server Key，Regular 获取关联的 Server Key
+      security:
+        - bearerAuth: []
+      responses:
+        '200':
+          description: 成功
+          content:
+            application/json:
+              schema:
+                type: array
+                items:
+                  $ref: '#/components/schemas/ApiKey'
+    
+    post:
+      summary: 创建 Server Key
+      description: 为指定的 Regular Key 创建新的 Server Key (仅 Admin)
+      security:
+        - bearerAuth: []
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/CreateServerKeyRequest'
+      responses:
+        '201':
+          description: 创建成功
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ApiKeyWithSecret'
+        '400':
+          description: 参数错误
+        '404':
+          description: Regular Key 不存在
+
+  /api/events:
+    post:
+      summary: 发送事件
+      description: 发送 Minecraft 事件并广播给所有 WebSocket 连接
+      security:
+        - bearerAuth: []
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/Event'
+      responses:
+        '200':
+          description: 成功广播
+
+  /api/server/info:
+    get:
+      summary: 获取服务器信息
+      security:
+        - bearerAuth: []
+      parameters:
+        - in: query
+          name: server_id
+          schema:
+            type: string
+          description: 仅 Admin 需要
+      responses:
+        '200':
+          description: 成功
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  server_id:
+                    type: string
+                  status:
+                    type: string
+                  online_players:
+                    type: integer
+
+  /api/server/command:
+    post:
+      summary: 发送服务器命令
+      security:
+        - bearerAuth: []
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/CommandRequest'
+      responses:
+        '200':
+          description: 命令发送成功
+        '403':
+          description: 禁止的命令
+
+  /api/ai/config:
+    get:
+      summary: 获取 AI 配置 (Admin)
+      security:
+        - bearerAuth: []
+      responses:
+        '200':
+          description: 成功
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/AiConfig'
+    
+    post:
+      summary: 创建 AI 配置 (Admin)
+      security:
+        - bearerAuth: []
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/AiConfigUpdateRequest'
+      responses:
+        '201':
+          description: 创建成功
+    
+    patch:
+      summary: 更新 AI 配置 (Admin)
+      security:
+        - bearerAuth: []
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/AiConfigUpdateRequest'
+      responses:
+        '200':
+          description: 更新成功
+    
+    delete:
+      summary: 删除 AI 配置 (Admin)
+      security:
+        - bearerAuth: []
+      responses:
+        '204':
+          description: 删除成功
+
+  /api/ai/config/test:
+    post:
+      summary: 测试 AI 连接 (Admin)
+      security:
+        - bearerAuth: []
+      responses:
+        '200':
+          description: 连接成功
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  success:
+                    type: boolean
+                  message:
+                    type: string
+
+  /api/ai/chat:
+    post:
+      summary: AI 聊天
+      description: 发送消息给 AI 并获取回复
+      security:
+        - bearerAuth: []
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/AiChatRequest'
+      responses:
+        '200':
+          description: 成功
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  success:
+                    type: boolean
+                  reply:
+                    type: string
+                  model:
+                    type: string

hf_repo/docs/TEST_REPORT.md

@@ -0,0 +1,69 @@
+# InterConnect-Server 测试总结报告
+
+## 1. 测试概览
+
+本项目已完成全面的自动化测试套件构建，覆盖了核心业务逻辑、数据库操作、认证机制以及 API 接口。
+
+- **测试框架**: Jest
+- **API 测试工具**: Supertest
+- **测试结果**: ✅ 全部通过 (30/30 测试用例)
+- **测试时间**: 2026-01-23
+
+## 2. 测试覆盖范围
+
+测试套件分为单元测试 (Unit Tests) 和集成测试 (Integration Tests) 两部分。
+
+### 2.1 单元测试 (Unit Tests)
+
+针对各个独立模块进行的功能验证。
+
+#### 认证模块 (`src/auth.js`)
+- **测试文件**: `tests/unit/auth.test.js`
+- **覆盖内容**:
+  - `verifyApiKey`: 验证 API Key 的提取、校验和错误处理（401 Unauthorized）。
+  - `requireAdminKey`: 验证管理员权限控制。
+  - `requireRegularOrAdminKey`: 验证普通用户与管理员的权限兼容性。
+  - `requireAnyKey`: 验证基础访问权限。
+
+#### 数据库模块 (`src/database.js`)
+- **测试文件**: `tests/unit/database.test.js`
+- **覆盖内容**:
+  - **初始化**: 验证数据库表结构 (`api_keys`, `event_logs`, `ai_config`) 的自动创建。
+  - **密钥管理**: 验证 Admin Key 的初始生成、Regular Key 和 Server Key 的创建与关联。
+  - **验证逻辑**: 验证 `verifyApiKey` 的准确性。
+  - **事件日志**: 验证 `logEvent` 和 `getRecentEvents` 的读写功能。
+  - **AI 配置**: 验证 AI 配置信息的保存、读取和更新。
+
+#### WebSocket 管理器 (`src/websocket.js`)
+- **测试文件**: `tests/unit/websocket.test.js`
+- **覆盖内容**:
+  - **连接管理**: 验证连接跟踪 (`connect`) 和断开处理 (`disconnect`)。
+  - **广播功能**: 验证 `broadcastToAll` 能正确向所有活跃连接发送消息。
+  - **异常处理**: 验证在广播过程中自动清理已关闭的连接。
+
+### 2.2 集成测试 (Integration Tests)
+
+针对 HTTP API 接口的端到端测试。
+
+#### API 接口 (`src/routes/*.js`)
+- **测试文件**: `tests/integration/api.test.js`
+- **覆盖内容**:
+  - **基础端点**:
+    - `GET /`: 验证服务器欢迎信息。
+    - `GET /health`: 验证健康检查接口返回 `healthy` 状态。
+  - **受保护路由**:
+    - `POST /api/events`: 验证无 Key、无效 Key 和有效 Key 的访问控制及业务逻辑。
+  - **密钥管理 API**:
+    - `GET /manage/keys`: 验证 Admin 只有权访问。
+    - `POST /manage/keys`: 验证密钥创建流程。
+
+## 3. 测试环境配置
+
+为了支持测试，对项目进行了以下配置（现已清理）：
+1.  **依赖**: 安装了 `jest` 和 `supertest`。
+2.  **配置**: 添加了 `jest.config.js` 和 `tests/setup.js`。
+3.  **代码调整**: `src/server.js` 采用了条件启动模式，允许测试框架导入 App 实例而不自动监听端口。
+
+## 4. 结论
+
+当前代码库的核心功能稳定，权限控制逻辑严密，数据库操作符合预期。所有测试用例均已通过，可以放心地进行部署或后续开发。

hf_repo/hf_repo/.gitignore

@@ -57,3 +57,4 @@ cli/*.log
 *.dockerfile
 
 
+ICS-测试数据.txt

hf_repo/hf_repo/hf_repo/cli/cli.js

@@ -111,8 +111,10 @@ class MinecraftWSCLIClient {
         return true;
     }
 
-    async healthCheck() {
-        return await this.request('GET', '/health');
+    async resetAIConfig() {
+        this.ensureAdminKeyForManagement();
+        await this.request('DELETE', '/api/ai/config');
+        return true;
     }
 }
 
@@ -125,6 +127,22 @@ program
     .option('-s, --server-url <url>', 'API服务器URL', process.env.MC_WS_API_URL || HARDCODED_API_URL)
     .option('-k, --admin-key <key>', '用于管理操作的Admin Key', process.env.ADMIN_KEY || HARDCODED_ADMIN_KEY);
 
+program
+    .command('reset-ai-config')
+    .description('重置/清除 AI 配置 (使用 Admin Key)')
+    .action(async () => {
+        try {
+            const opts = program.opts();
+            const client = new MinecraftWSCLIClient(opts.serverUrl, opts.adminKey);
+            await client.resetAIConfig();
+            console.log(`\x1b[32m✅ AI 配置已成功重置/清除!\x1b[0m`);
+            console.log('现在您可以重新在 Dashboard 配置 AI 设置。');
+        } catch (error) {
+            console.error(`\x1b[31m❌ 错误: ${error.message}\x1b[0m`);
+            process.exit(1);
+        }
+    });
+
 program
     .command('create-key <name>')
     .description('创建新的API密钥')

hf_repo/hf_repo/hf_repo/dashboard/public/app.js

@@ -35,8 +35,83 @@ const aiSystemPromptInput = document.getElementById('ai-system-prompt');
 const aiEnabledCheckbox = document.getElementById('ai-enabled');
 const aiTestBtn = document.getElementById('ai-test-btn');
 const aiDeleteBtn = document.getElementById('ai-delete-btn');
+const aiProviderSelect = document.getElementById('ai-provider-select');
+const systemLogs = document.getElementById('system-logs');
+const clearLogsBtn = document.getElementById('clear-logs-btn');
+
+// AI Providers Configuration
+const AI_PROVIDERS = {
+    openai: {
+        url: 'https://api.openai.com/v1/chat/completions',
+        model: 'gpt-3.5-turbo'
+    },
+    siliconflow: {
+        url: 'https://api.siliconflow.cn/v1/chat/completions',
+        model: 'deepseek-ai/DeepSeek-R1'
+    },
+    gemini: {
+        url: 'https://generativelanguage.googleapis.com/v1beta/openai/chat/completions',
+        model: 'gemini-2.0-flash-exp'
+    },
+    deepseek: {
+        url: 'https://api.deepseek.com/chat/completions',
+        model: 'deepseek-chat'
+    },
+    moonshot: {
+        url: 'https://api.moonshot.cn/v1/chat/completions',
+        model: 'moonshot-v1-8k'
+    },
+    custom: {
+        url: '',
+        model: ''
+    }
+};
+
+if (aiProviderSelect) {
+    aiProviderSelect.addEventListener('change', (e) => {
+        const provider = AI_PROVIDERS[e.target.value];
+        if (provider && e.target.value !== 'custom') {
+            if (aiApiUrlInput) aiApiUrlInput.value = provider.url;
+            if (aiModelIdInput) aiModelIdInput.value = provider.model;
+        }
+    });
+}
+
 const aiStatus = document.getElementById('ai-status');
 
+// Theme Management
+const themeToggleBtns = document.querySelectorAll('.theme-toggle');
+
+function initTheme() {
+    const savedTheme = localStorage.getItem('theme') || 'dark';
+    document.documentElement.setAttribute('data-theme', savedTheme);
+    updateThemeIcons(savedTheme);
+}
+
+function toggleTheme() {
+    const currentTheme = document.documentElement.getAttribute('data-theme');
+    const newTheme = currentTheme === 'dark' ? 'light' : 'dark';
+    
+    document.documentElement.setAttribute('data-theme', newTheme);
+    localStorage.setItem('theme', newTheme);
+    updateThemeIcons(newTheme);
+}
+
+function updateThemeIcons(theme) {
+    const text = theme === 'dark' ? '浅色模式' : '深色模式';
+    
+    themeToggleBtns.forEach(btn => {
+        btn.textContent = text;
+    });
+}
+
+// Initialize Theme
+initTheme();
+
+themeToggleBtns.forEach(btn => {
+    btn.addEventListener('click', toggleTheme);
+});
+
 function authHeaders(key) {
     return { Authorization: `Bearer ${key}` };
 }
@@ -172,33 +247,102 @@ function renderAdminKeys(keys) {
         return;
     }
 
-    adminKeysList.innerHTML = keys.map((key) => `
-        <div class="key-card ${key.keyType === 'admin' ? 'admin' : ''}">
+    const adminKeys = keys.filter(k => k.keyType === 'admin');
+    const regularKeys = keys.filter(k => k.keyType === 'regular');
+    const serverKeys = keys.filter(k => k.keyType === 'server');
+    const serverKeysMap = {};
+
+    serverKeys.forEach(key => {
+        if (key.regularKeyId) {
+            if (!serverKeysMap[key.regularKeyId]) {
+                serverKeysMap[key.regularKeyId] = [];
+            }
+            serverKeysMap[key.regularKeyId].push(key);
+        }
+    });
+
+    let html = '';
+
+    // Render Admin Keys
+    if (adminKeys.length > 0) {
+        html += '<h3 class="group-title">管理员密钥 (Admin Keys)</h3>';
+        html += adminKeys.map(key => renderKeyCard(key)).join('');
+    }
+
+    // Render Regular Keys with nested Server Keys
+    if (regularKeys.length > 0) {
+        html += '<h3 class="group-title">用户密钥 (Regular Keys)</h3>';
+        html += regularKeys.map(regularKey => {
+            const childServerKeys = serverKeysMap[regularKey.id] || [];
+            return `
+                <div class="regular-key-group">
+                    <div class="regular-key-header" onclick="toggleGroup(this)">
+                        ${renderKeyCard(regularKey)}
+                        ${childServerKeys.length > 0 ? `<span class="toggle-icon">▼</span>` : ''}
+                    </div>
+                    ${childServerKeys.length > 0 ? `
+                        <div class="nested-server-keys hidden">
+                            <h4>关联的服务器密钥 (Linked Server Keys)</h4>
+                            ${childServerKeys.map(serverKey => renderKeyCard(serverKey, true)).join('')}
+                        </div>
+                    ` : ''}
+                </div>
+            `;
+        }).join('');
+    }
+
+    // Render Orphaned Server Keys (if any)
+    const linkedServerKeyIds = new Set(Object.values(serverKeysMap).flat().map(k => k.id));
+    const orphanServerKeys = serverKeys.filter(k => !linkedServerKeyIds.has(k.id));
+
+    if (orphanServerKeys.length > 0) {
+        html += '<h3 class="group-title">独立服务器密钥 (Orphan Server Keys)</h3>';
+        html += orphanServerKeys.map(key => renderKeyCard(key)).join('');
+    }
+
+    adminKeysList.innerHTML = html;
+}
+
+function toggleGroup(headerElement) {
+    const nestedContainer = headerElement.nextElementSibling;
+    const toggleIcon = headerElement.querySelector('.toggle-icon');
+    
+    if (nestedContainer && nestedContainer.classList.contains('nested-server-keys')) {
+        nestedContainer.classList.toggle('hidden');
+        if (toggleIcon) {
+            toggleIcon.style.transform = nestedContainer.classList.contains('hidden') ? 'rotate(0deg)' : 'rotate(180deg)';
+        }
+    }
+}
+
+function renderKeyCard(key, isNested = false) {
+    return `
+        <div class="key-card ${key.keyType === 'admin' ? 'admin' : ''} ${isNested ? 'nested' : ''}">
             <div class="key-info">
                 <h3>
                     <span class="key-badge ${key.keyType}">
                         ${key.keyType === 'admin' ? 'Admin' : key.keyType === 'server' ? 'Server' : 'Regular'}
                     </span>
                     <span class="key-badge ${key.isActive ? 'active' : 'inactive'}">
-                        ${key.isActive ? 'Active' : 'Inactive'}
+                        ${key.isActive ? '已启用' : '已停用'}
                     </span>
                     ${key.name}
                 </h3>
                 <p>ID: ${key.id}</p>
                 <p>Prefix: ${key.keyPrefix}</p>
                 ${key.serverId ? `<p>Server ID: ${key.serverId}</p>` : ''}
-                <p>Created: ${new Date(key.createdAt).toLocaleString()}</p>
-                <p>Last Used: ${key.lastUsed ? new Date(key.lastUsed).toLocaleString() : 'Never'}</p>
+                <p>创建时间: ${new Date(key.createdAt).toLocaleString()}</p>
+                <p>最后使用: ${key.lastUsed ? new Date(key.lastUsed).toLocaleString() : '从未'}</p>
             </div>
             <div class="key-actions">
                 ${key.isActive
-                    ? `<button class="btn-danger" onclick="deactivateKey('${key.id}')">Deactivate</button>`
-                    : `<button class="btn-success" onclick="activateKey('${key.id}')">Activate</button>`
+                    ? `<button class="btn-danger" onclick="deactivateKey('${key.id}')">停用</button>`
+                    : `<button class="btn-success" onclick="activateKey('${key.id}')">启用</button>`
                 }
-                <button class="btn-danger" onclick="deleteKey('${key.id}', '${key.name}')">Delete</button>
+                <button class="btn-danger" onclick="deleteKey('${key.id}', '${key.name}')">删除</button>
             </div>
         </div>
-    `).join('');
+    `;
 }
 
 function renderUserServerKeys(keys) {
@@ -217,20 +361,20 @@ function renderUserServerKeys(keys) {
                 <h3>
                     <span class="key-badge server">Server</span>
                     <span class="key-badge ${key.isActive ? 'active' : 'inactive'}">
-                        ${key.isActive ? 'Active' : 'Inactive'}
+                        ${key.isActive ? '已启用' : '已停用'}
                     </span>
                     ${key.name}
                 </h3>
                 <p>ID: ${key.id}</p>
                 <p>Prefix: ${key.keyPrefix}</p>
                 ${key.serverId ? `<p>Server ID: ${key.serverId}</p>` : ''}
-                <p>Created: ${new Date(key.createdAt).toLocaleString()}</p>
-                <p>Last Used: ${key.lastUsed ? new Date(key.lastUsed).toLocaleString() : 'Never'}</p>
+                <p>创建时间: ${new Date(key.createdAt).toLocaleString()}</p>
+                <p>最后使用: ${key.lastUsed ? new Date(key.lastUsed).toLocaleString() : '从未'}</p>
             </div>
             <div class="key-actions">
                 ${key.isActive
-                    ? `<button class="btn-danger" onclick="deactivateKey('${key.id}')">Deactivate</button>`
-                    : `<button class="btn-success" onclick="activateKey('${key.id}')">Activate</button>`
+                    ? `<button class="btn-danger" onclick="deactivateKey('${key.id}')">停用</button>`
+                    : `<button class="btn-success" onclick="activateKey('${key.id}')">启用</button>`
                 }
             </div>
         </div>
@@ -293,7 +437,7 @@ async function deleteKey(keyId, keyName) {
     if (currentRole !== 'admin') {
         return;
     }
-    if (!confirm(`Delete key "${keyName}"? This action cannot be undone.`)) {
+    if (!confirm(`确定要删除密钥 "${keyName}" 吗? 此操作无法撤销。`)) {
         return;
     }
     try {
@@ -365,21 +509,6 @@ async function loadStats() {
             connections.textContent = data.active_ws || 0;
         }
 
-        const totalKeys = document.getElementById('user-stat-total-keys');
-        if (totalKeys) {
-            totalKeys.textContent = data.keys_total || 0;
-        }
-
-        const adminKeys = document.getElementById('user-stat-admin-keys');
-        if (adminKeys) {
-            adminKeys.textContent = data.admin_active || 0;
-        }
-
-        const regularKeys = document.getElementById('user-stat-regular-keys');
-        if (regularKeys) {
-            regularKeys.textContent = data.regular_active || 0;
-        }
-
         const serverKeys = document.getElementById('user-stat-server-keys');
         if (serverKeys) {
             serverKeys.textContent = data.server_active || 0;
@@ -737,7 +866,7 @@ async function deleteAIConfig() {
     if (!apiKey) {
         return;
     }
-    if (!confirm('Are you sure you want to delete the AI configuration?')) {
+    if (!confirm('确定要删除 AI 配置吗？')) {
         return;
     }
 

hf_repo/hf_repo/hf_repo/dashboard/public/index.html

@@ -3,7 +3,10 @@
 <head>
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <title>Minecraft WebSocket API - 控制台</title>
+    <title>InterConnect Dashboard</title>
+    <link rel="preconnect" href="https://fonts.googleapis.com">
+    <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+    <link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700;800&family=JetBrains+Mono:wght@400;500&display=swap" rel="stylesheet">
     <link rel="stylesheet" href="style.css">
 </head>
 <body>
@@ -28,6 +31,9 @@
         <nav class="navbar">
             <h1>管理员面板</h1>
             <div class="nav-info">
+                <button id="admin-theme-toggle" class="theme-toggle" title="切换深色/浅色模式">
+                    <!-- Icon will be injected by JS -->
+                </button>
                 <span id="admin-user-info"></span>
                 <button class="logout-btn">退出登录</button>
             </div>
@@ -86,6 +92,9 @@
         <nav class="navbar">
             <h1>用户监测</h1>
             <div class="nav-info">
+                <button id="user-theme-toggle" class="theme-toggle" title="切换深色/浅色模式">
+                    <!-- Icon will be injected by JS -->
+                </button>
                 <span id="user-info"></span>
                 <button class="logout-btn">退出登录</button>
             </div>
@@ -97,18 +106,6 @@
                     <h3>活跃连接</h3>
                     <p class="stat-value" id="user-stat-connections">0</p>
                 </div>
-                <div class="stat-card">
-                    <h3>密钥总数</h3>
-                    <p class="stat-value" id="user-stat-total-keys">0</p>
-                </div>
-                <div class="stat-card">
-                    <h3>Admin Keys</h3>
-                    <p class="stat-value" id="user-stat-admin-keys">0</p>
-                </div>
-                <div class="stat-card">
-                    <h3>Regular Keys</h3>
-                    <p class="stat-value" id="user-stat-regular-keys">0</p>
-                </div>
                 <div class="stat-card">
                     <h3>Server Keys</h3>
                     <p class="stat-value" id="user-stat-server-keys">0</p>

hf_repo/hf_repo/hf_repo/dashboard/public/style.css

@@ -1,3 +1,74 @@
+:root {
+    /* Colors - Light Theme (Clean & Professional) */
+    --bg-body: #f3f4f6;
+    --bg-card: #ffffff;
+    --bg-card-hover: #f9fafb;
+    --bg-input: #ffffff;
+    
+    --border-color: #e5e7eb;
+    --border-hover: #d1d5db;
+    
+    --primary: #4f46e5; /* Slightly darker indigo for better contrast on white */
+    --primary-hover: #4338ca;
+    --primary-glow: rgba(79, 70, 229, 0.15);
+    
+    --danger: #dc2626;
+    --danger-hover: #b91c1c;
+    
+    --success: #059669;
+    --success-hover: #047857;
+    
+    --text-main: #111827;
+    --text-muted: #6b7280;
+    
+    /* Spacing & Radius */
+    --radius-sm: 6px;
+    --radius-md: 12px;
+    --radius-lg: 16px;
+    --radius-xl: 24px;
+    
+    --space-xs: 4px;
+    --space-sm: 8px;
+    --space-md: 16px;
+    --space-lg: 24px;
+    --space-xl: 32px;
+    
+    /* Effects */
+    --shadow-sm: 0 1px 2px 0 rgba(0, 0, 0, 0.05);
+    --shadow-md: 0 4px 6px -1px rgba(0, 0, 0, 0.1), 0 2px 4px -1px rgba(0, 0, 0, 0.06);
+    --shadow-lg: 0 10px 15px -3px rgba(0, 0, 0, 0.1), 0 4px 6px -2px rgba(0, 0, 0, 0.05);
+    --glass-blur: blur(12px);
+    --transition: all 0.2s cubic-bezier(0.4, 0, 0.2, 1);
+}
+
+[data-theme="dark"] {
+    /* Colors - Dark Theme */
+    --bg-body: #09090b;
+    --bg-card: rgba(39, 39, 42, 0.6);
+    --bg-card-hover: rgba(63, 63, 70, 0.6);
+    --bg-input: rgba(24, 24, 27, 0.8);
+    
+    --border-color: rgba(255, 255, 255, 0.08);
+    --border-hover: rgba(255, 255, 255, 0.15);
+    
+    --primary: #6366f1;
+    --primary-hover: #4f46e5;
+    --primary-glow: rgba(99, 102, 241, 0.4);
+    
+    --danger: #ef4444;
+    --danger-hover: #dc2626;
+    
+    --success: #10b981;
+    --success-hover: #059669;
+    
+    --text-main: #fafafa;
+    --text-muted: #a1a1aa;
+    
+    --shadow-sm: 0 1px 2px rgba(0, 0, 0, 0.5);
+    --shadow-md: 0 4px 6px -1px rgba(0, 0, 0, 0.5);
+    --shadow-lg: 0 10px 15px -3px rgba(0, 0, 0, 0.5);
+}
+
 * {
     margin: 0;
     padding: 0;
@@ -5,516 +76,671 @@
 }
 
 body {
-    font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Oxygen, Ubuntu, Cantarell, sans-serif;
-    background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
+    font-family: 'Inter', -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
+    background-color: var(--bg-body);
+    color: var(--text-main);
     min-height: 100vh;
-    color: #333;
+    line-height: 1.6;
+    -webkit-font-smoothing: antialiased;
 }
 
-.screen {
-    min-height: 100vh;
+[data-theme="dark"] body {
+    background-image: 
+        radial-gradient(circle at 15% 50%, rgba(99, 102, 241, 0.08), transparent 25%),
+        radial-gradient(circle at 85% 30%, rgba(139, 92, 246, 0.08), transparent 25%);
+}
+
+/* Scrollbar */
+::-webkit-scrollbar {
+    width: 8px;
+    height: 8px;
+}
+::-webkit-scrollbar-track {
+    background: transparent;
+}
+::-webkit-scrollbar-thumb {
+    background: rgba(255, 255, 255, 0.1);
+    border-radius: 4px;
+}
+::-webkit-scrollbar-thumb:hover {
+    background: rgba(255, 255, 255, 0.2);
 }
 
+/* Utilities */
 .hidden {
     display: none !important;
 }
 
+.screen {
+    min-height: 100vh;
+    display: flex;
+    flex-direction: column;
+    animation: fadeIn 0.5s ease-out;
+}
+
+@keyframes fadeIn {
+    from { opacity: 0; transform: translateY(10px); }
+    to { opacity: 1; transform: translateY(0); }
+}
+
+/* Login Screen */
 .login-container {
+    flex: 1;
     display: flex;
     flex-direction: column;
     align-items: center;
     justify-content: center;
-    min-height: 100vh;
-    padding: 20px;
+    padding: var(--space-xl);
+    background: radial-gradient(circle at center, rgba(99, 102, 241, 0.1) 0%, transparent 70%);
 }
 
 .login-container h1 {
-    color: white;
-    font-size: 3em;
-    margin-bottom: 10px;
+    font-size: 2.5rem;
+    font-weight: 800;
+    letter-spacing: -0.05em;
+    margin-bottom: var(--space-xs);
+    background: linear-gradient(135deg, #fff 0%, #a1a1aa 100%);
+    -webkit-background-clip: text;
+    -webkit-text-fill-color: transparent;
+    text-shadow: 0 0 30px rgba(99, 102, 241, 0.3);
 }
 
 .login-container h2 {
-    color: white;
-    font-size: 1.5em;
-    margin-bottom: 30px;
+    color: var(--text-muted);
+    font-size: 1.1rem;
+    font-weight: 400;
+    margin-bottom: var(--space-xl);
 }
 
 #login-form {
-    background: white;
+    background: var(--bg-card);
+    backdrop-filter: var(--glass-blur);
     padding: 40px;
-    border-radius: 10px;
-    box-shadow: 0 10px 40px rgba(0,0,0,0.2);
+    border-radius: var(--radius-xl);
+    border: 1px solid var(--border-color);
+    box-shadow: var(--shadow-lg);
     width: 100%;
-    max-width: 400px;
+    max-width: 420px;
+    transition: var(--transition);
 }
 
 #login-form input {
     width: 100%;
-    padding: 15px;
-    border: 2px solid #e0e0e0;
-    border-radius: 5px;
-    font-size: 16px;
-    margin-bottom: 20px;
+    padding: 16px;
+    background: var(--bg-input);
+    border: 1px solid var(--border-color);
+    border-radius: var(--radius-md);
+    color: var(--text-main);
+    font-size: 1rem;
+    margin-bottom: var(--space-lg);
+    transition: var(--transition);
+}
+
+#login-form input:focus {
+    outline: none;
+    border-color: var(--primary);
+    box-shadow: 0 0 0 4px rgba(99, 102, 241, 0.1);
 }
 
 #login-form button {
     width: 100%;
-    padding: 15px;
-    background: #667eea;
+    padding: 16px;
+    background: linear-gradient(135deg, var(--primary) 0%, var(--primary-hover) 100%);
     color: white;
     border: none;
-    border-radius: 5px;
-    font-size: 16px;
-    font-weight: bold;
+    border-radius: var(--radius-md);
+    font-size: 1rem;
+    font-weight: 600;
     cursor: pointer;
-    transition: background 0.3s;
+    transition: var(--transition);
+    box-shadow: 0 4px 12px var(--primary-glow);
 }
 
 #login-form button:hover {
-    background: #5568d3;
+    transform: translateY(-2px);
+    box-shadow: 0 8px 20px var(--primary-glow);
 }
 
 .error-message {
-    color: #ff4444;
-    margin-top: 10px;
+    color: var(--danger);
+    margin-top: var(--space-md);
+    text-align: center;
+    font-size: 0.9rem;
+    min-height: 20px;
+}
+
+.login-info {
+    margin-top: var(--space-xl);
     text-align: center;
+    color: var(--text-muted);
+    font-size: 0.9rem;
+    background: rgba(255, 255, 255, 0.03);
+    padding: var(--space-md) var(--space-lg);
+    border-radius: var(--radius-lg);
+    border: 1px solid var(--border-color);
 }
 
+/* Navbar */
 .navbar {
-    background: white;
-    padding: 20px 40px;
+    background: var(--bg-card);
+    backdrop-filter: blur(20px);
+    padding: 16px 32px;
     display: flex;
     justify-content: space-between;
     align-items: center;
-    box-shadow: 0 2px 10px rgba(0,0,0,0.1);
+    border-bottom: 1px solid var(--border-color);
+    position: sticky;
+    top: 0;
+    z-index: 100;
 }
 
 .navbar h1 {
-    font-size: 1.5em;
-    color: #667eea;
+    font-size: 1.25rem;
+    font-weight: 700;
+    letter-spacing: -0.02em;
+    color: var(--text-main);
+}
+
+.nav-info {
+    display: flex;
+    align-items: center;
+    gap: var(--space-md);
+}
+
+#user-info, #admin-user-info {
+    font-size: 0.85rem;
+    color: var(--text-muted);
+    background: var(--bg-card);
+    padding: 6px 12px;
+    border-radius: 20px;
+    border: 1px solid var(--border-color);
 }
 
 .logout-btn {
-    padding: 10px 20px;
-    background: #ff4444;
-    color: white;
-    border: none;
-    border-radius: 5px;
+    padding: 8px 16px;
+    background: rgba(239, 68, 68, 0.1);
+    color: var(--danger);
+    border: 1px solid rgba(239, 68, 68, 0.2);
+    border-radius: var(--radius-sm);
     cursor: pointer;
-    font-weight: bold;
+    font-size: 0.85rem;
+    font-weight: 600;
+    transition: var(--transition);
+}
+
+.logout-btn:hover {
+    background: rgba(239, 68, 68, 0.2);
+    border-color: var(--danger);
 }
 
+/* Theme Toggle */
+.theme-toggle {
+    background: transparent;
+    border: 1px solid var(--border-color);
+    color: var(--text-muted);
+    padding: 6px 16px;
+    border-radius: var(--radius-md);
+    cursor: pointer;
+    font-size: 0.85rem;
+    font-weight: 600;
+    transition: var(--transition);
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    height: auto;
+    width: auto;
+    white-space: nowrap;
+}
+
+.theme-toggle:hover {
+    background: var(--bg-card-hover);
+    color: var(--text-main);
+    border-color: var(--border-hover);
+}
+
+[data-theme="light"] .theme-toggle {
+    background: var(--bg-input);
+    color: var(--text-main);
+    border-color: var(--border-color);
+}
+
+[data-theme="light"] .theme-toggle:hover {
+    background: var(--bg-card-hover);
+    border-color: var(--primary);
+    color: var(--primary);
+}
+
+/* Main Container */
 .container {
-    max-width: 1400px;
+    max-width: 1200px;
     margin: 0 auto;
-    padding: 40px 20px;
+    padding: var(--space-xl);
+    width: 100%;
 }
 
+/* Stats Grid */
 .stats-grid {
     display: grid;
-    grid-template-columns: repeat(auto-fit, minmax(250px, 1fr));
-    gap: 20px;
-    margin-bottom: 40px;
+    grid-template-columns: repeat(auto-fit, minmax(240px, 1fr));
+    gap: var(--space-md);
+    margin-bottom: var(--space-xl);
 }
 
 .stat-card {
-    background: white;
-    padding: 30px;
-    border-radius: 10px;
-    box-shadow: 0 4px 15px rgba(0,0,0,0.1);
+    background: var(--bg-card);
+    padding: var(--space-lg);
+    border-radius: var(--radius-lg);
+    border: 1px solid var(--border-color);
+    backdrop-filter: var(--glass-blur);
     text-align: center;
+    transition: var(--transition);
+}
+
+.stat-card:hover {
+    border-color: var(--border-hover);
+    transform: translateY(-2px);
+    background: var(--bg-card-hover);
 }
 
 .stat-card h3 {
-    color: #666;
-    font-size: 0.9em;
-    margin-bottom: 10px;
+    color: var(--text-muted);
+    font-size: 0.85rem;
     text-transform: uppercase;
+    letter-spacing: 0.05em;
+    margin-bottom: var(--space-sm);
 }
 
 .stat-value {
-    font-size: 3em;
-    font-weight: bold;
-    color: #667eea;
+    font-size: 2.5rem;
+    font-weight: 700;
+    color: var(--text-main);
+    background: linear-gradient(135deg, #fff 0%, #cbd5e1 100%);
+    -webkit-background-clip: text;
+    -webkit-text-fill-color: transparent;
 }
 
+/* Section */
 .section {
-    background: white;
-    padding: 30px;
-    border-radius: 10px;
-    box-shadow: 0 4px 15px rgba(0,0,0,0.1);
-    margin-bottom: 30px;
+    background: var(--bg-card);
+    padding: var(--space-xl);
+    border-radius: var(--radius-lg);
+    border: 1px solid var(--border-color);
+    margin-bottom: var(--space-xl);
+    backdrop-filter: var(--glass-blur);
 }
 
 .section-header {
     display: flex;
     justify-content: space-between;
     align-items: center;
-    margin-bottom: 20px;
+    margin-bottom: var(--space-lg);
+    border-bottom: 1px solid var(--border-color);
+    padding-bottom: var(--space-md);
 }
 
 .section h2 {
-    color: #333;
-    margin-bottom: 20px;
+    font-size: 1.25rem;
+    font-weight: 600;
+    color: var(--text-main);
 }
 
-.btn-primary {
-    padding: 12px 24px;
-    background: #667eea;
-    color: white;
-    border: none;
-    border-radius: 5px;
+/* Buttons */
+.btn-primary, .btn-secondary, .btn-danger, .btn-success {
+    padding: 10px 20px;
+    border-radius: var(--radius-md);
+    font-weight: 500;
     cursor: pointer;
-    font-weight: bold;
-    transition: background 0.3s;
+    transition: var(--transition);
+    font-size: 0.9rem;
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    gap: 8px;
 }
 
+.btn-primary {
+    background: var(--primary);
+    color: white;
+    border: 1px solid transparent;
+    box-shadow: 0 2px 8px rgba(99, 102, 241, 0.3);
+}
 .btn-primary:hover {
-    background: #5568d3;
+    background: var(--primary-hover);
+    box-shadow: 0 4px 12px rgba(99, 102, 241, 0.5);
 }
 
 .btn-secondary {
-    padding: 12px 24px;
-    background: #e0e0e0;
-    color: #333;
-    border: none;
-    border-radius: 5px;
-    cursor: pointer;
-    font-weight: bold;
+    background: transparent;
+    color: var(--text-main);
+    border: 1px solid var(--border-color);
+}
+.btn-secondary:hover {
+    background: rgba(255, 255, 255, 0.05);
+    border-color: var(--border-hover);
 }
 
 .btn-danger {
-    padding: 8px 16px;
-    background: #ff4444;
-    color: white;
-    border: none;
-    border-radius: 5px;
-    cursor: pointer;
-    font-size: 0.9em;
+    background: rgba(239, 68, 68, 0.1);
+    color: var(--danger);
+    border: 1px solid rgba(239, 68, 68, 0.2);
+}
+.btn-danger:hover {
+    background: rgba(239, 68, 68, 0.2);
+    border-color: var(--danger);
 }
 
 .btn-success {
-    padding: 8px 16px;
-    background: #4caf50;
-    color: white;
-    border: none;
-    border-radius: 5px;
-    cursor: pointer;
-    font-size: 0.9em;
+    background: rgba(16, 185, 129, 0.1);
+    color: var(--success);
+    border: 1px solid rgba(16, 185, 129, 0.2);
+}
+.btn-success:hover {
+    background: rgba(16, 185, 129, 0.2);
+    border-color: var(--success);
 }
 
+/* Keys List */
 .keys-list {
-    display: grid;
-    gap: 15px;
+    display: flex;
+    flex-direction: column;
+    gap: var(--space-md);
+}
+
+.group-title {
+    color: var(--text-muted);
+    font-size: 0.9rem;
+    text-transform: uppercase;
+    letter-spacing: 0.05em;
+    margin: var(--space-lg) 0 var(--space-sm) 0;
+    padding-bottom: var(--space-xs);
+    border-bottom: 1px solid var(--border-color);
 }
 
+/* AI Provider Select */
+#ai-provider-select {
+    margin-bottom: var(--space-md);
+    background: var(--bg-input);
+    color: var(--text-main);
+    border: 1px solid var(--border-color);
+}
+/* Key Cards */
 .key-card {
-    border: 2px solid #e0e0e0;
-    padding: 20px;
-    border-radius: 8px;
+    background: var(--bg-card);
+    border: 1px solid var(--border-color);
+    border-radius: var(--radius-md);
+    padding: var(--space-lg);
     display: flex;
-    justify-content: space-between;
     align-items: center;
+    transition: var(--transition);
 }
 
 .key-card.admin {
-    border-color: #764ba2;
-    background: #f9f7fb;
+    border-color: rgba(99, 102, 241, 0.3);
+    background: rgba(99, 102, 241, 0.05);
 }
 
-.key-info h3 {
-    margin-bottom: 5px;
+[data-theme="light"] .key-card.admin {
+    background: rgba(99, 102, 241, 0.05);
+    border-color: rgba(99, 102, 241, 0.2);
 }
 
-.key-badge {
-    display: inline-block;
-    padding: 4px 8px;
-    border-radius: 4px;
-    font-size: 0.8em;
-    font-weight: bold;
-    margin-right: 10px;
+.regular-key-group {
+    border: 1px solid var(--border-color);
+    border-radius: var(--radius-lg);
+    overflow: hidden;
+    background: var(--bg-card);
 }
 
-.key-badge.admin {
-    background: #764ba2;
-    color: white;
+.regular-key-header {
+    cursor: pointer;
+    transition: var(--transition);
 }
-
-.key-badge.regular {
-    background: #667eea;
-    color: white;
+.regular-key-header:hover {
+    background: var(--bg-card-hover);
 }
 
-.key-badge.server {
-    background: #4f8ef7;
-    color: white;
+.regular-key-header .key-card {
+    border: none;
+    background: transparent;
 }
 
-.key-badge.active {
-    background: #4caf50;
-    color: white;
+.nested-server-keys {
+    padding: 0 var(--space-lg) var(--space-lg) calc(var(--space-lg) + 30px);
+    border-top: 1px solid var(--border-color);
+    background: rgba(0, 0, 0, 0.1);
 }
 
-.key-badge.inactive {
-    background: #ff4444;
-    color: white;
+[data-theme="light"] .nested-server-keys {
+    background: rgba(0, 0, 0, 0.02);
 }
 
-.key-actions {
-    display: flex;
-    gap: 10px;
+.nested-server-keys h4 {
+    color: var(--text-muted);
+    font-size: 0.8rem;
+    margin: var(--space-md) 0;
+    opacity: 0.7;
 }
 
-.events-list {
-    max-height: 400px;
-    overflow-y: auto;
+.key-card.nested {
+    padding: var(--space-md);
+    background: var(--bg-card);
+    border-left: 2px solid var(--primary);
 }
 
-.event-item {
-    padding: 15px;
-    border-left: 4px solid #667eea;
-    background: #f5f5f5;
-    margin-bottom: 10px;
-    border-radius: 4px;
-}
-
-.event-item strong {
-    color: #667eea;
-}
-
-.modal {
-    position: fixed;
-    top: 0;
-    left: 0;
-    width: 100%;
-    height: 100%;
-    background: rgba(0,0,0,0.5);
+.toggle-icon-container {
+    width: 24px;
+    height: 24px;
     display: flex;
-    justify-content: center;
     align-items: center;
-    z-index: 1000;
-}
-
-.modal-content {
-    background: white;
-    padding: 40px;
-    border-radius: 10px;
-    max-width: 500px;
-    width: 90%;
-    max-height: 90vh;
-    overflow-y: auto;
-}
-
-.modal-content h2 {
-    margin-bottom: 20px;
-}
-
-.modal-content label {
-    display: block;
-    margin-bottom: 5px;
-    font-weight: bold;
-    color: #666;
-}
-
-.modal-content input[type="text"],
-.modal-content textarea {
-    width: 100%;
-    padding: 10px;
-    border: 2px solid #e0e0e0;
-    border-radius: 5px;
-    margin-bottom: 15px;
-    font-size: 14px;
+    justify-content: center;
+    margin-right: var(--space-md);
+    background: rgba(255, 255, 255, 0.05);
+    border-radius: 50%;
 }
 
-.modal-content textarea {
-    min-height: 80px;
-    resize: vertical;
+[data-theme="light"] .toggle-icon-container {
+    background: rgba(0, 0, 0, 0.05);
 }
 
-.modal-content select {
+.toggle-icon {
+    font-size: 0.8rem;
+    color: var(--text-muted);
+    transition: transform 0.3s cubic-bezier(0.4, 0, 0.2, 1);
+    /* Fix alignment */
+    display: flex;
+    align-items: center;
+    justify-content: center;
     width: 100%;
-    padding: 10px;
-    border: 2px solid #e0e0e0;
-    border-radius: 5px;
-    margin-bottom: 15px;
-    font-size: 14px;
+    height: 100%;
+    margin-top: 2px; /* Visual correction */
 }
 
-.modal-actions {
-    display: flex;
-    gap: 10px;
-    justify-content: flex-end;
-    margin-top: 20px;
+.key-info {
+    flex: 1;
 }
 
-.nav-info {
+.key-info h3 {
     display: flex;
     align-items: center;
-    gap: 15px;
+    font-size: 1rem;
+    margin-bottom: var(--space-xs);
+    color: var(--text-main);
 }
 
-#user-info,
-#admin-user-info {
-    font-size: 0.9em;
-    color: #667eea;
-    background: rgba(255,255,255,0.1);
-    padding: 8px 12px;
-    border-radius: 20px;
+.key-info p {
+    color: var(--text-muted);
+    font-size: 0.85rem;
+    margin-bottom: 2px;
+    font-family: 'JetBrains Mono', monospace;
 }
 
-.server-info {
-    display: grid;
-    grid-template-columns: 1fr 1fr;
-    gap: 20px;
+.key-badge {
+    padding: 2px 8px;
+    border-radius: 4px;
+    font-size: 0.7rem;
+    font-weight: 600;
+    margin-right: var(--space-sm);
+    text-transform: uppercase;
 }
 
-.info-card {
-    background: #f8f9fa;
-    padding: 20px;
-    border-radius: 8px;
-    border: 1px solid #e9ecef;
-}
+.key-badge.admin { background: rgba(139, 92, 246, 0.2); color: #c4b5fd; border: 1px solid rgba(139, 92, 246, 0.3); }
+.key-badge.regular { background: rgba(59, 130, 246, 0.2); color: #93c5fd; border: 1px solid rgba(59, 130, 246, 0.3); }
+.key-badge.server { background: rgba(16, 185, 129, 0.2); color: #6ee7b7; border: 1px solid rgba(16, 185, 129, 0.3); }
 
-.info-card h3 {
-    margin-bottom: 15px;
-    color: #495057;
-}
+.key-badge.active { background: rgba(16, 185, 129, 0.2); color: #34d399; }
+.key-badge.inactive { background: rgba(239, 68, 68, 0.2); color: #f87171; }
 
-.command-history {
-    max-height: 200px;
-    overflow-y: auto;
-    background: white;
-    border: 1px solid #e9ecef;
-    border-radius: 4px;
-    padding: 10px;
-}
-
-.command-form {
+.key-actions {
     display: flex;
-    gap: 10px;
-    margin-bottom: 15px;
+    gap: var(--space-sm);
+    margin-left: var(--space-lg);
 }
 
-.command-form input {
-    flex: 1;
-    padding: 12px;
-    border: 2px solid #e0e0e0;
-    border-radius: 5px;
-    font-size: 14px;
+/* Forms & Inputs */
+.form-group {
+    margin-bottom: var(--space-lg);
 }
 
-.command-item {
-    padding: 8px 0;
-    border-bottom: 1px solid #f8f9fa;
-    font-family: monospace;
-    font-size: 0.9em;
-}
-
-.command-item:last-child {
-    border-bottom: none;
+label {
+    display: block;
+    margin-bottom: var(--space-xs);
+    font-weight: 500;
+    color: var(--text-main);
+    font-size: 0.9rem;
 }
 
-.command-item .timestamp {
-    color: #6c757d;
-    font-size: 0.8em;
+input[type="text"],
+input[type="password"],
+textarea,
+select {
+    width: 100%;
+    padding: 12px;
+    background: var(--bg-input);
+    border: 1px solid var(--border-color);
+    border-radius: var(--radius-md);
+    color: var(--text-main);
+    font-family: inherit;
+    font-size: 0.95rem;
+    transition: var(--transition);
 }
 
-.login-info {
-    margin-top: 20px;
-    text-align: left;
-    background: rgba(255,255,255,0.1);
-    padding: 15px;
-    border-radius: 8px;
+input:focus, textarea:focus, select:focus {
+    outline: none;
+    border-color: var(--primary);
+    box-shadow: 0 0 0 3px rgba(99, 102, 241, 0.15);
 }
 
-.login-info p {
-    margin: 5px 0;
-    font-size: 0.9em;
-    color: white;
+.hint {
+    display: block;
+    margin-top: var(--space-xs);
+    font-size: 0.8rem;
+    color: var(--text-muted);
 }
 
-.ai-config-form {
-    max-width: 600px;
+/* Events List */
+.events-list {
+    max-height: 400px;
+    overflow-y: auto;
+    background: rgba(0, 0, 0, 0.2);
+    border-radius: var(--radius-md);
+    padding: var(--space-sm);
 }
 
-.ai-config-form .form-group {
-    margin-bottom: 20px;
+.event-item {
+    padding: var(--space-md);
+    border-left: 3px solid var(--primary);
+    background: rgba(255, 255, 255, 0.02);
+    margin-bottom: var(--space-sm);
+    border-radius: 0 var(--radius-sm) var(--radius-sm) 0;
+    font-size: 0.9rem;
 }
 
-.ai-config-form label {
-    display: block;
-    margin-bottom: 8px;
-    font-weight: bold;
-    color: #333;
+.event-item strong {
+    color: var(--primary);
 }
 
-.ai-config-form input[type="text"],
-.ai-config-form input[type="password"],
-.ai-config-form textarea {
-    width: 100%;
-    padding: 12px;
-    border: 2px solid #e0e0e0;
-    border-radius: 5px;
-    font-size: 14px;
-    transition: border-color 0.3s;
+.event-item pre {
+    background: rgba(0, 0, 0, 0.3);
+    padding: var(--space-sm);
+    border-radius: var(--radius-sm);
+    margin-top: var(--space-xs);
+    color: var(--text-muted);
+    font-size: 0.8rem;
+    overflow-x: auto;
 }
 
-.ai-config-form input[type="text"]:focus,
-.ai-config-form input[type="password"]:focus,
-.ai-config-form textarea:focus {
-    border-color: #667eea;
-    outline: none;
+/* Command Console */
+.command-history {
+    height: 300px;
+    overflow-y: auto;
+    background: #000;
+    border: 1px solid var(--border-color);
+    border-radius: var(--radius-md);
+    padding: var(--space-md);
+    font-family: 'JetBrains Mono', monospace;
+    margin-top: var(--space-md);
 }
 
-.ai-config-form textarea {
-    min-height: 100px;
-    resize: vertical;
+.command-item {
+    margin-bottom: 6px;
+    padding-bottom: 6px;
+    border-bottom: 1px solid rgba(255, 255, 255, 0.05);
+    color: #e2e8f0;
+    font-size: 0.9rem;
 }
 
-.ai-config-form .hint {
-    display: block;
-    margin-top: 5px;
-    font-size: 0.85em;
-    color: #666;
+.command-item .timestamp {
+    color: #64748b;
+    font-size: 0.75rem;
+    margin-top: 2px;
 }
 
-.ai-config-form .form-actions {
+.command-form {
     display: flex;
-    gap: 10px;
-    margin-top: 25px;
-}
-
-.ai-status {
-    margin-top: 20px;
-    padding: 12px 16px;
-    border-radius: 5px;
-    font-size: 0.9em;
-}
-
-.ai-status:empty {
-    display: none;
+    gap: var(--space-sm);
 }
 
-.ai-status.success {
-    background: #d4edda;
-    color: #155724;
-    border: 1px solid #c3e6cb;
+/* Modal */
+.modal {
+    position: fixed;
+    top: 0;
+    left: 0;
+    width: 100%;
+    height: 100%;
+    background: rgba(0, 0, 0, 0.7);
+    backdrop-filter: blur(8px);
+    display: flex;
+    justify-content: center;
+    align-items: center;
+    z-index: 1000;
+    animation: fadeIn 0.2s ease-out;
 }
 
-.ai-status.error {
-    background: #f8d7da;
-    color: #721c24;
-    border: 1px solid #f5c6cb;
+.modal-content {
+    background: var(--bg-card);
+    padding: var(--space-xl);
+    border-radius: var(--radius-xl);
+    border: 1px solid var(--border-color);
+    width: 90%;
+    max-width: 500px;
+    box-shadow: 0 20px 25px -5px rgba(0, 0, 0, 0.5);
+    color: var(--text-main);
 }
 
-.ai-status.info {
-    background: #d1ecf1;
-    color: #0c5460;
-    border: 1px solid #bee5eb;
+.modal-actions {
+    display: flex;
+    justify-content: flex-end;
+    gap: var(--space-sm);
+    margin-top: var(--space-xl);
 }
 
-.ai-config-form input[type="checkbox"] {
-    width: auto;
-    margin-right: 8px;
-}
+/* AI Status */
+.ai-status {
+    margin-top: var(--space-md);
+    padding: var(--space-md);
+    border-radius: var(--radius-md);
+    font-size: 0.9rem;
+}
+.ai-status.success { background: rgba(16, 185, 129, 0.1); color: var(--success); border: 1px solid rgba(16, 185, 129, 0.2); }
+.ai-status.error { background: rgba(239, 68, 68, 0.1); color: var(--danger); border: 1px solid rgba(239, 68, 68, 0.2); }
+.ai-status.info { background: rgba(99, 102, 241, 0.1); color: var(--primary); border: 1px solid rgba(99, 102, 241, 0.2); }

hf_repo/hf_repo/hf_repo/docs/UI_UX_DESIGN_2026.md

@@ -0,0 +1,72 @@
+# InterConnect Server UI/UX 设计方案 2026
+
+## 1. 设计理念："星云玻璃 (Nebula Glass)"
+全新的设计语言摒弃了扁平的白色界面，转向以深度为导向的深色主题界面，灵感来源于现代开发工具（如 Vercel, Linear, Raycast）和游戏美学（Minecraft 光影）。
+
+### 核心概念
+- **沉浸式深度 (Immersive Depth)**：利用多层级的暗色、阴影和微妙的边框来构建层级关系，而不依赖厚重的投影。
+- **玻璃拟态 (Glassmorphism)**：使用半透明表面和背景模糊 (`backdrop-filter`) 来提供上下文关联和未来感。
+- **动效 (Motion)**：微交互（悬停状态、焦点转换）感觉即时且流畅。
+- **内容优先 (Content-First)**：高对比度的排版和充足的留白（或"留黑"）。
+
+## 2. 配色方案
+
+### 深色模式 (Dark Mode - 默认)
+| 变量 | 颜色 | 用途 |
+| :--- | :--- | :--- |
+| `--bg-body` | `#09090b` (Zinc 950) | 主背景 |
+| `--bg-card` | `rgba(39, 39, 42, 0.6)` | 卡片背景 (玻璃效果) |
+| `--border-color` | `rgba(255, 255, 255, 0.08)` | 边框 |
+| `--primary` | `#6366f1` (Indigo 500) | 主要操作、激活状态 |
+| `--primary-glow` | `rgba(99, 102, 241, 0.4)` | 发光效果 |
+| `--text-main` | `#fafafa` (Zinc 50) | 标题、主要文本 |
+| `--text-muted` | `#a1a1aa` (Zinc 400) | 次要文本、标签 |
+| `--danger` | `#ef4444` (Red 500) | 破坏性操作 |
+| `--success` | `#10b981` (Emerald 500) | 成功状态 |
+
+### 浅色模式 (Light Mode - 专业白)
+| 变量 | 颜色 | 用途 |
+| :--- | :--- | :--- |
+| `--bg-body` | `#f3f4f6` (Gray 100) | 主背景 |
+| `--bg-card` | `#ffffff` (White) | 卡片背景 (纯白) |
+| `--border-color` | `#e5e7eb` (Gray 200) | 边框 |
+| `--primary` | `#4f46e5` (Indigo 600) | 主要操作 (加深以提升对比度) |
+| `--text-main` | `#111827` (Gray 900) | 主要文本 |
+| `--text-muted` | `#6b7280` (Gray 500) | 次要文本 |
+
+## 3. 组件设计
+
+### 3.1 导航栏 (Navigation)
+- **样式**: 顶部固定，半透明磨砂玻璃效果。
+- **功能**: 包含标题、用户信息、主题切换（深/浅色）和退出按钮。
+
+### 3.2 卡片 (Cards - Bento Grid 风格)
+- **结构**: 圆角矩形 (`border-radius: 12px/16px`)。
+- **边框**: 1px 实线，微弱的透明度。
+- **交互**: 悬停时轻微上浮并增强边框颜色。
+
+### 3.3 按钮与输入框
+- **按钮**:
+  - 主要按钮：渐变色填充 + 悬停发光。
+  - 次要按钮：透明背景 + 边框，悬停高亮。
+- **输入框**:
+  - 深色背景 (`rgba(24, 24, 27, 0.8)`)。
+  - 聚焦光环：主色调光晕。
+
+## 4. 排版 (Typography)
+- **字体**: 
+  - 界面: `Inter` (现代无衬线体)
+  - 代码/密钥: `JetBrains Mono` (等宽字体)
+- **层级**:
+  - H1: 24px, 粗体, 紧凑字间距。
+  - H2: 18px, 半粗体, 大写字母间距。
+  - 正文: 14px/16px, 常规字重。
+
+## 5. 实施计划 (已完成)
+1.  **CSS 重构**: 使用 CSS 变量 (`:root` 和 `[data-theme="light"]`) 实现了完整的主题切换系统。
+2.  **HTML 结构**: 优化了语义化标签，添加了主题切换按钮。
+3.  **交互优化**: 实现了二级折叠菜单、动态箭头动画和响应式布局。
+4.  **功能增强**: 集成了系统日志控制台、多 AI 提供商配置和 API 密钥安全管理。
+
+---
+*由 Trae AI Pair Programmer 生成与执行*

hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/dashboard/public/index.html

@@ -1,71 +1,71 @@
 <!DOCTYPE html>
-<html lang="en">
+<html lang="zh-CN">
 <head>
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <title>Minecraft WebSocket API - Dashboard</title>
+    <title>Minecraft WebSocket API - 控制台</title>
     <link rel="stylesheet" href="style.css">
 </head>
 <body>
     <div id="login-screen" class="screen">
         <div class="login-container">
             <h1>Minecraft WebSocket API</h1>
-            <h2>Dashboard Login</h2>
+            <h2>控制台登录</h2>
             <form id="login-form">
-                <input type="password" id="api-key-input" placeholder="Enter Admin or Regular Key" required>
-                <button type="submit">Login</button>
+                <input type="password" id="api-key-input" placeholder="请输入 Admin 或 Regular Key" required>
+                <button type="submit">登录</button>
             </form>
             <p class="error-message" id="login-error"></p>
             <div class="login-info">
-                <p><strong>Key Types</strong></p>
-                <p>Admin Key - full management permissions</p>
-                <p>Regular Key - server monitoring and command access</p>
+                <p><strong>密钥类型</strong></p>
+                <p>Admin Key - 拥有完整管理权限</p>
+                <p>Regular Key - 服务器监测与命令访问</p>
             </div>
         </div>
     </div>
 
     <div id="admin-screen" class="screen hidden">
         <nav class="navbar">
-            <h1>Admin Panel</h1>
+            <h1>管理员面板</h1>
             <div class="nav-info">
                 <span id="admin-user-info"></span>
-                <button class="logout-btn">Logout</button>
+                <button class="logout-btn">退出登录</button>
             </div>
         </nav>
 
         <div class="container">
             <div class="section" id="admin-ai-section">
                 <div class="section-header">
-                    <h2>AI Configuration</h2>
+                    <h2>AI 配置</h2>
                 </div>
                 <div class="ai-config-form">
                     <form id="ai-config-form">
                         <div class="form-group">
-                            <label>API URL *</label>
+                            <label>API 地址 *</label>
                             <input type="text" id="ai-api-url" placeholder="https://api.openai.com/v1/chat/completions" required>
                         </div>
                         <div class="form-group">
-                            <label>Model ID *</label>
+                            <label>模型 ID *</label>
                             <input type="text" id="ai-model-id" placeholder="gpt-3.5-turbo" required>
                         </div>
                         <div class="form-group">
-                            <label>API Key *</label>
+                            <label>API 密钥 *</label>
                             <input type="password" id="ai-api-key" placeholder="sk-xxx">
                             <small id="ai-api-key-hint" class="hint"></small>
                         </div>
                         <div class="form-group">
-                            <label>System Prompt (Optional)</label>
-                            <textarea id="ai-system-prompt" placeholder="You are a helpful assistant for Minecraft players."></textarea>
+                            <label>系统提示词（可选）</label>
+                            <textarea id="ai-system-prompt" placeholder="你是 Minecraft 玩家助手。"></textarea>
                         </div>
                         <div class="form-group">
                             <label>
-                                <input type="checkbox" id="ai-enabled" checked> Enabled
+                                <input type="checkbox" id="ai-enabled" checked> 启用
                             </label>
                         </div>
                         <div class="form-actions">
-                            <button type="submit" class="btn-primary">Save Configuration</button>
-                            <button type="button" id="ai-test-btn" class="btn-secondary">Test Connection</button>
-                            <button type="button" id="ai-delete-btn" class="btn-danger">Delete Configuration</button>
+                            <button type="submit" class="btn-primary">保存配置</button>
+                            <button type="button" id="ai-test-btn" class="btn-secondary">测试连接</button>
+                            <button type="button" id="ai-delete-btn" class="btn-danger">删除配置</button>
                         </div>
                     </form>
                     <div id="ai-status" class="ai-status"></div>
@@ -74,8 +74,8 @@
 
             <div class="section" id="admin-key-section">
                 <div class="section-header">
-                    <h2>API Key Management</h2>
-                    <button id="create-key-btn" class="btn-primary">Create Key</button>
+                    <h2>API 密钥管理</h2>
+                    <button id="create-key-btn" class="btn-primary">创建密钥</button>
                 </div>
                 <div id="admin-keys-list" class="keys-list"></div>
             </div>
@@ -84,21 +84,21 @@
 
     <div id="user-screen" class="screen hidden">
         <nav class="navbar">
-            <h1>User Monitoring</h1>
+            <h1>用户监测</h1>
             <div class="nav-info">
                 <span id="user-info"></span>
-                <button class="logout-btn">Logout</button>
+                <button class="logout-btn">退出登录</button>
             </div>
         </nav>
 
         <div class="container">
             <div class="stats-grid">
                 <div class="stat-card">
-                    <h3>Active Connections</h3>
+                    <h3>活跃连接</h3>
                     <p class="stat-value" id="user-stat-connections">0</p>
                 </div>
                 <div class="stat-card">
-                    <h3>Total Keys</h3>
+                    <h3>密钥总数</h3>
                     <p class="stat-value" id="user-stat-total-keys">0</p>
                 </div>
                 <div class="stat-card">
@@ -116,21 +116,21 @@
             </div>
 
             <div class="section">
-                <h2>Server Keys</h2>
+                <h2>服务器密钥</h2>
                 <div id="user-keys-list" class="keys-list"></div>
             </div>
 
             <div class="section">
-                <h2>Command Console</h2>
+                <h2>命令控制台</h2>
                 <form id="command-form" class="command-form">
-                    <input type="text" id="command-input" placeholder="Enter command" required>
-                    <button type="submit" class="btn-primary">Send</button>
+                    <input type="text" id="command-input" placeholder="输入命令" required>
+                    <button type="submit" class="btn-primary">发送</button>
                 </form>
                 <div id="command-history" class="command-history"></div>
             </div>
 
             <div class="section">
-                <h2>Live Events</h2>
+                <h2>实时事件</h2>
                 <div id="user-events-list" class="events-list"></div>
             </div>
         </div>
@@ -138,26 +138,26 @@
 
     <div id="create-key-modal" class="modal hidden">
         <div class="modal-content">
-            <h2>Create API Key</h2>
+            <h2>创建 API 密钥</h2>
             <form id="create-key-form">
-                <label>Name *</label>
+                <label>名称 *</label>
                 <input type="text" id="key-name" required>
 
-                <label>Description</label>
+                <label>描述</label>
                 <textarea id="key-description"></textarea>
 
-                <label>Key Type</label>
+                <label>密钥类型</label>
                 <select id="key-type">
-                    <option value="regular">Regular</option>
-                    <option value="admin">Admin</option>
+                    <option value="regular">普通</option>
+                    <option value="admin">管理员</option>
                 </select>
 
-                <label>Server ID (optional)</label>
+                <label>服务器 ID（可选）</label>
                 <input type="text" id="key-server-id">
 
                 <div class="modal-actions">
-                    <button type="button" id="cancel-create-btn" class="btn-secondary">Cancel</button>
-                    <button type="submit" class="btn-primary">Create</button>
+                    <button type="button" id="cancel-create-btn" class="btn-secondary">取消</button>
+                    <button type="submit" class="btn-primary">创建</button>
                 </div>
             </form>
         </div>
@@ -165,14 +165,14 @@
 
     <div id="key-details-modal" class="modal hidden">
         <div class="modal-content">
-            <h2>Key Details</h2>
+            <h2>密钥详情</h2>
             <div id="key-details-content"></div>
             <div class="modal-actions">
-                <button id="close-details-btn" class="btn-secondary">Close</button>
+                <button id="close-details-btn" class="btn-secondary">关闭</button>
             </div>
         </div>
     </div>
 
     <script src="app.js"></script>
 </body>
-</html>
+</html>

hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/cli/cli.js

@@ -389,15 +389,15 @@ program
 
 program
     .command('reset-admin')
-    .description('Reset Admin Key using recovery token (offline)')
-    .requiredOption('-r, --recovery-token <token>', 'Admin recovery token')
-    .option('--db-path <path>', 'Database path', process.env.DATABASE_PATH || 'minecraft_ws.db')
-    .option('--keep-existing', 'Keep existing Admin Keys active')
-    .option('--name <name>', 'New Admin Key name', 'Recovered Admin Key')
+    .description('使用恢复令牌重置 Admin Key (离线)')
+    .requiredOption('-r, --recovery-token <token>', '管理员恢复令牌')
+    .option('--db-path <path>', '数据库路径', process.env.DATABASE_PATH || 'minecraft_ws.db')
+    .option('--keep-existing', '保持现有 Admin Key 处于活跃状态')
+    .option('--name <name>', '新 Admin Key 名称', 'Recovered Admin Key')
     .action(async (options) => {
         try {
             if (!fs.existsSync(options.dbPath)) {
-                throw new Error(`Database not found at ${options.dbPath}`);
+                throw new Error(`在 ${options.dbPath} 未找到数据库`);
             }
 
             const db = new Database(options.dbPath);
@@ -408,12 +408,12 @@ program
                 name: options.name
             });
 
-            console.log('Admin Key reset successful.');
+            console.log('\x1b[32m✅ Admin Key 重置成功。\x1b[0m');
             console.log(`  ID   : ${result.id}`);
-            console.log(`  Name : ${result.name}`);
+            console.log(`  名称 : ${result.name}`);
             console.log(`  Key  : ${result.key}`);
         } catch (error) {
-            console.error(`\x1b[31mReset failed: ${error.message}\x1b[0m`);
+            console.error(`\x1b[31m❌ 重置失败: ${error.message}\x1b[0m`);
             process.exit(1);
         }
     });

hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/dashboard/server.js

@@ -13,9 +13,9 @@ app.get('/', (req, res) => {
 
 app.listen(PORT, () => {
     console.log('='.repeat(50));
-    console.log('Minecraft WebSocket API - Dashboard');
+    console.log('Minecraft WebSocket API - 控制台');
     console.log('='.repeat(50));
-    console.log(`Dashboard URL: http://localhost:${PORT}`);
-    console.log('Use Admin or Regular Key to log in.');
+    console.log(`控制台地址: http://localhost:${PORT}`);
+    console.log('请使用 Admin Key 或 Regular Key 登录。');
     console.log('='.repeat(50));
 });

hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/docs/protocol.md

@@ -1,32 +1,31 @@
-# Protocol Specification
+# 协议规范
 
-This document defines the REST and WebSocket protocol formats used by
-InterConnect-Server. All payloads are JSON.
+本文档定义了 InterConnect-Server 使用的 REST 和 WebSocket 协议格式。所有负载均为 JSON 格式。
 
-## Authentication
+## 认证 (Authentication)
 
-- REST: Send `Authorization: Bearer <API_KEY>` in the request headers.
-- WebSocket: Connect to `ws://<host>/ws?api_key=<API_KEY>` (use `wss` over HTTPS).
+- REST: 在请求头中发送 `Authorization: Bearer <API_KEY>`。
+- WebSocket: 连接到 `ws://<host>/ws?api_key=<API_KEY>`（HTTPS 下使用 `wss`）。
 
-## Event Object
+## 事件对象 (Event Object)
 
-Events are sent to the server via REST and broadcast to WebSocket clients.
-The server validates required fields and the `event_type` value only.
-The `data` payload is otherwise passed through as-is.
+事件通过 REST 发送到服务器，并广播给 WebSocket 客户端。
+服务器仅验证必填字段和 `event_type` 值。
+`data` 负载会原样传递。
 
-Required fields:
-- `event_type` (string)
-- `server_name` (string)
-- `timestamp` (string, ISO 8601)
-- `data` (object)
+必填字段：
+- `event_type` (字符串)
+- `server_name` (字符串)
+- `timestamp` (字符串, ISO 8601)
+- `data` (对象)
 
-Valid `event_type` values:
+有效的 `event_type` 值：
 - `player_join`
 - `player_leave`
 - `message`
 - `server_command`
 
-Example event:
+事件示例：
 ```json
 {
   "event_type": "player_join",
@@ -38,34 +37,34 @@ Example event:
 }
 ```
 
-## REST Endpoints
+## REST 端点 (REST Endpoints)
 
 ### POST /api/events
 
-Submit an event to be stored and broadcast.
+提交一个事件以进行存储和广播。
 
-Request:
-- Auth: any valid key
+请求：
+- 认证：任意有效密钥
 - `Content-Type: application/json`
-- Body: Event Object
+- Body: 事件对象
 
-Response:
+响应：
 ```json
 {
   "message": "Event received and broadcasted"
 }
 ```
 
-Errors:
-- `400` if required fields are missing or `event_type` is invalid
-- `401` if the API key is missing/invalid
+错误：
+- `400` 如果缺少必填字段或 `event_type` 无效
+- `401` 如果 API 密钥丢失/无效
 
 ### POST /api/server/command
 
-Send a server command. This also broadcasts a `server_command` event.
+发送服务器命令。这也将广播一个 `server_command` 事件。
 
-Request:
-- Auth: Regular or Admin key
+请求：
+- 认证：Regular 或 Admin 密钥
 - `Content-Type: application/json`
 - Body:
 ```json
@@ -75,11 +74,11 @@ Request:
 }
 ```
 
-Notes:
-- `server_id` is required for Admin keys when not bound to a server.
-- The server enforces an allow/block list for Admin commands.
+注意：
+- 当 Admin 密钥未绑定到服务器时，必须提供 `server_id`。
+- 服务器对 Admin 命令强制执行允许/阻止列表。
 
-Response:
+响应：
 ```json
 {
   "message": "Command sent successfully",
@@ -88,23 +87,23 @@ Response:
 }
 ```
 
-## WebSocket Messages
+## WebSocket 消息 (WebSocket Messages)
 
-### Client to Server
+### 客户端到服务器
 
 Ping:
 ```json
 { "type": "ping" }
 ```
 
-Pong response:
+Pong 响应:
 ```json
 { "type": "pong" }
 ```
 
-### Server to Client
+### 服务器到客户端
 
-Broadcasted event:
+广播事件：
 ```json
 {
   "type": "minecraft_event",
@@ -121,5 +120,4 @@ Broadcasted event:
 }
 ```
 
-`source_key_id_prefix` is the first 8 characters of the API key ID that
-submitted the event or command. It is not the API key itself.
+`source_key_id_prefix` 是提交事件或命令的 API 密钥 ID 的前 8 个字符。它不是 API 密钥本身。

hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/docs/protocol.md

@@ -0,0 +1,125 @@
+# Protocol Specification
+
+This document defines the REST and WebSocket protocol formats used by
+InterConnect-Server. All payloads are JSON.
+
+## Authentication
+
+- REST: Send `Authorization: Bearer <API_KEY>` in the request headers.
+- WebSocket: Connect to `ws://<host>/ws?api_key=<API_KEY>` (use `wss` over HTTPS).
+
+## Event Object
+
+Events are sent to the server via REST and broadcast to WebSocket clients.
+The server validates required fields and the `event_type` value only.
+The `data` payload is otherwise passed through as-is.
+
+Required fields:
+- `event_type` (string)
+- `server_name` (string)
+- `timestamp` (string, ISO 8601)
+- `data` (object)
+
+Valid `event_type` values:
+- `player_join`
+- `player_leave`
+- `message`
+- `server_command`
+
+Example event:
+```json
+{
+  "event_type": "player_join",
+  "server_name": "survival-01",
+  "timestamp": "2024-01-21T12:34:56.789Z",
+  "data": {
+    "player": "Steve"
+  }
+}
+```
+
+## REST Endpoints
+
+### POST /api/events
+
+Submit an event to be stored and broadcast.
+
+Request:
+- Auth: any valid key
+- `Content-Type: application/json`
+- Body: Event Object
+
+Response:
+```json
+{
+  "message": "Event received and broadcasted"
+}
+```
+
+Errors:
+- `400` if required fields are missing or `event_type` is invalid
+- `401` if the API key is missing/invalid
+
+### POST /api/server/command
+
+Send a server command. This also broadcasts a `server_command` event.
+
+Request:
+- Auth: Regular or Admin key
+- `Content-Type: application/json`
+- Body:
+```json
+{
+  "command": "say Hello from API",
+  "server_id": "survival-01"
+}
+```
+
+Notes:
+- `server_id` is required for Admin keys when not bound to a server.
+- The server enforces an allow/block list for Admin commands.
+
+Response:
+```json
+{
+  "message": "Command sent successfully",
+  "command": "say Hello from API",
+  "server_id": "survival-01"
+}
+```
+
+## WebSocket Messages
+
+### Client to Server
+
+Ping:
+```json
+{ "type": "ping" }
+```
+
+Pong response:
+```json
+{ "type": "pong" }
+```
+
+### Server to Client
+
+Broadcasted event:
+```json
+{
+  "type": "minecraft_event",
+  "event": {
+    "event_type": "message",
+    "server_name": "survival-01",
+    "timestamp": "2024-01-21T12:34:56.789Z",
+    "data": {
+      "player": "Alex",
+      "message": "Hello world"
+    }
+  },
+  "source_key_id_prefix": "a1b2c3d4"
+}
+```
+
+`source_key_id_prefix` is the first 8 characters of the API key ID that
+submitted the event or command. It is not the API key itself.

hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/dashboard/public/app.js

@@ -26,6 +26,16 @@ const commandForm = document.getElementById('command-form');
 const commandInput = document.getElementById('command-input');
 const commandHistory = document.getElementById('command-history');
 const userEventsList = document.getElementById('user-events-list');
+const aiConfigForm = document.getElementById('ai-config-form');
+const aiApiUrlInput = document.getElementById('ai-api-url');
+const aiModelIdInput = document.getElementById('ai-model-id');
+const aiApiKeyInput = document.getElementById('ai-api-key');
+const aiApiKeyHint = document.getElementById('ai-api-key-hint');
+const aiSystemPromptInput = document.getElementById('ai-system-prompt');
+const aiEnabledCheckbox = document.getElementById('ai-enabled');
+const aiTestBtn = document.getElementById('ai-test-btn');
+const aiDeleteBtn = document.getElementById('ai-delete-btn');
+const aiStatus = document.getElementById('ai-status');
 
 function authHeaders(key) {
     return { Authorization: `Bearer ${key}` };
@@ -92,6 +102,7 @@ function showAdminPanel() {
     }
 
     loadAdminKeys();
+    loadAIConfig();
 }
 
 function showUserPanel() {
@@ -605,3 +616,170 @@ if (commandForm) {
 window.activateKey = activateKey;
 window.deactivateKey = deactivateKey;
 window.deleteKey = deleteKey;
+
+async function loadAIConfig() {
+    if (!apiKey) {
+        return;
+    }
+    try {
+        const response = await fetch(`${API_URL}/api/ai/config`, {
+            headers: authHeaders(apiKey)
+        });
+
+        if (response.ok) {
+            const config = await response.json();
+            if (aiApiUrlInput) aiApiUrlInput.value = config.apiUrl || '';
+            if (aiModelIdInput) aiModelIdInput.value = config.modelId || '';
+            if (aiApiKeyInput) aiApiKeyInput.value = '';
+            if (aiApiKeyHint) aiApiKeyHint.textContent = config.apiKey ? `Current: ${config.apiKey}` : '';
+            if (aiSystemPromptInput) aiSystemPromptInput.value = config.systemPrompt || '';
+            if (aiEnabledCheckbox) aiEnabledCheckbox.checked = config.enabled;
+            showAIStatus('Configuration loaded', 'success');
+        } else if (response.status === 404) {
+            if (aiApiUrlInput) aiApiUrlInput.value = '';
+            if (aiModelIdInput) aiModelIdInput.value = '';
+            if (aiApiKeyInput) aiApiKeyInput.value = '';
+            if (aiApiKeyHint) aiApiKeyHint.textContent = '';
+            if (aiSystemPromptInput) aiSystemPromptInput.value = '';
+            if (aiEnabledCheckbox) aiEnabledCheckbox.checked = true;
+            showAIStatus('No configuration found. Please set up AI configuration.', 'info');
+        }
+    } catch (error) {
+        showAIStatus(`Failed to load AI config: ${error.message}`, 'error');
+    }
+}
+
+async function saveAIConfig(event) {
+    event.preventDefault();
+    if (!apiKey) {
+        return;
+    }
+
+    const apiUrl = aiApiUrlInput?.value?.trim();
+    const modelId = aiModelIdInput?.value?.trim();
+    const apiKeyValue = aiApiKeyInput?.value?.trim();
+    const systemPrompt = aiSystemPromptInput?.value?.trim() || null;
+    const enabled = aiEnabledCheckbox?.checked ?? true;
+
+    if (!apiUrl || !modelId) {
+        showAIStatus('API URL and Model ID are required', 'error');
+        return;
+    }
+
+    try {
+        const existingResponse = await fetch(`${API_URL}/api/ai/config`, {
+            headers: authHeaders(apiKey)
+        });
+        const isUpdate = existingResponse.ok;
+
+        const payload = {
+            api_url: apiUrl,
+            model_id: modelId,
+            enabled: enabled,
+            system_prompt: systemPrompt
+        };
+
+        if (apiKeyValue) {
+            payload.api_key = apiKeyValue;
+        } else if (!isUpdate) {
+            showAIStatus('API Key is required for new configuration', 'error');
+            return;
+        }
+
+        const method = isUpdate ? 'PATCH' : 'POST';
+        const response = await fetch(`${API_URL}/api/ai/config`, {
+            method: method,
+            headers: {
+                ...authHeaders(apiKey),
+                'Content-Type': 'application/json'
+            },
+            body: JSON.stringify(payload)
+        });
+
+        if (response.ok) {
+            const config = await response.json();
+            if (aiApiKeyInput) aiApiKeyInput.value = '';
+            if (aiApiKeyHint) aiApiKeyHint.textContent = config.apiKey ? `Current: ${config.apiKey}` : '';
+            showAIStatus('Configuration saved successfully', 'success');
+        } else {
+            const error = await response.json();
+            showAIStatus(`Failed to save: ${error.detail}`, 'error');
+        }
+    } catch (error) {
+        showAIStatus(`Failed to save AI config: ${error.message}`, 'error');
+    }
+}
+
+async function testAIConnection() {
+    if (!apiKey) {
+        return;
+    }
+    showAIStatus('Testing connection...', 'info');
+
+    try {
+        const response = await fetch(`${API_URL}/api/ai/config/test`, {
+            method: 'POST',
+            headers: authHeaders(apiKey)
+        });
+
+        const result = await response.json();
+        if (result.success) {
+            showAIStatus(`Connection successful! Model: ${result.model}, Response: ${result.response}`, 'success');
+        } else {
+            showAIStatus(`Connection failed: ${result.error}`, 'error');
+        }
+    } catch (error) {
+        showAIStatus(`Test failed: ${error.message}`, 'error');
+    }
+}
+
+async function deleteAIConfig() {
+    if (!apiKey) {
+        return;
+    }
+    if (!confirm('Are you sure you want to delete the AI configuration?')) {
+        return;
+    }
+
+    try {
+        const response = await fetch(`${API_URL}/api/ai/config`, {
+            method: 'DELETE',
+            headers: authHeaders(apiKey)
+        });
+
+        if (response.ok || response.status === 204) {
+            if (aiApiUrlInput) aiApiUrlInput.value = '';
+            if (aiModelIdInput) aiModelIdInput.value = '';
+            if (aiApiKeyInput) aiApiKeyInput.value = '';
+            if (aiApiKeyHint) aiApiKeyHint.textContent = '';
+            if (aiSystemPromptInput) aiSystemPromptInput.value = '';
+            if (aiEnabledCheckbox) aiEnabledCheckbox.checked = true;
+            showAIStatus('Configuration deleted', 'success');
+        } else {
+            const error = await response.json();
+            showAIStatus(`Failed to delete: ${error.detail}`, 'error');
+        }
+    } catch (error) {
+        showAIStatus(`Failed to delete AI config: ${error.message}`, 'error');
+    }
+}
+
+function showAIStatus(message, type) {
+    if (!aiStatus) {
+        return;
+    }
+    aiStatus.textContent = message;
+    aiStatus.className = `ai-status ${type}`;
+}
+
+if (aiConfigForm) {
+    aiConfigForm.addEventListener('submit', saveAIConfig);
+}
+
+if (aiTestBtn) {
+    aiTestBtn.addEventListener('click', testAIConnection);
+}
+
+if (aiDeleteBtn) {
+    aiDeleteBtn.addEventListener('click', deleteAIConfig);
+}

hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/dashboard/public/index.html

@@ -34,6 +34,44 @@
         </nav>
 
         <div class="container">
+            <div class="section" id="admin-ai-section">
+                <div class="section-header">
+                    <h2>AI Configuration</h2>
+                </div>
+                <div class="ai-config-form">
+                    <form id="ai-config-form">
+                        <div class="form-group">
+                            <label>API URL *</label>
+                            <input type="text" id="ai-api-url" placeholder="https://api.openai.com/v1/chat/completions" required>
+                        </div>
+                        <div class="form-group">
+                            <label>Model ID *</label>
+                            <input type="text" id="ai-model-id" placeholder="gpt-3.5-turbo" required>
+                        </div>
+                        <div class="form-group">
+                            <label>API Key *</label>
+                            <input type="password" id="ai-api-key" placeholder="sk-xxx">
+                            <small id="ai-api-key-hint" class="hint"></small>
+                        </div>
+                        <div class="form-group">
+                            <label>System Prompt (Optional)</label>
+                            <textarea id="ai-system-prompt" placeholder="You are a helpful assistant for Minecraft players."></textarea>
+                        </div>
+                        <div class="form-group">
+                            <label>
+                                <input type="checkbox" id="ai-enabled" checked> Enabled
+                            </label>
+                        </div>
+                        <div class="form-actions">
+                            <button type="submit" class="btn-primary">Save Configuration</button>
+                            <button type="button" id="ai-test-btn" class="btn-secondary">Test Connection</button>
+                            <button type="button" id="ai-delete-btn" class="btn-danger">Delete Configuration</button>
+                        </div>
+                    </form>
+                    <div id="ai-status" class="ai-status"></div>
+                </div>
+            </div>
+
             <div class="section" id="admin-key-section">
                 <div class="section-header">
                     <h2>API Key Management</h2>

hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/dashboard/public/style.css

@@ -433,3 +433,88 @@ body {
     font-size: 0.9em;
     color: white;
 }
+
+.ai-config-form {
+    max-width: 600px;
+}
+
+.ai-config-form .form-group {
+    margin-bottom: 20px;
+}
+
+.ai-config-form label {
+    display: block;
+    margin-bottom: 8px;
+    font-weight: bold;
+    color: #333;
+}
+
+.ai-config-form input[type="text"],
+.ai-config-form input[type="password"],
+.ai-config-form textarea {
+    width: 100%;
+    padding: 12px;
+    border: 2px solid #e0e0e0;
+    border-radius: 5px;
+    font-size: 14px;
+    transition: border-color 0.3s;
+}
+
+.ai-config-form input[type="text"]:focus,
+.ai-config-form input[type="password"]:focus,
+.ai-config-form textarea:focus {
+    border-color: #667eea;
+    outline: none;
+}
+
+.ai-config-form textarea {
+    min-height: 100px;
+    resize: vertical;
+}
+
+.ai-config-form .hint {
+    display: block;
+    margin-top: 5px;
+    font-size: 0.85em;
+    color: #666;
+}
+
+.ai-config-form .form-actions {
+    display: flex;
+    gap: 10px;
+    margin-top: 25px;
+}
+
+.ai-status {
+    margin-top: 20px;
+    padding: 12px 16px;
+    border-radius: 5px;
+    font-size: 0.9em;
+}
+
+.ai-status:empty {
+    display: none;
+}
+
+.ai-status.success {
+    background: #d4edda;
+    color: #155724;
+    border: 1px solid #c3e6cb;
+}
+
+.ai-status.error {
+    background: #f8d7da;
+    color: #721c24;
+    border: 1px solid #f5c6cb;
+}
+
+.ai-status.info {
+    background: #d1ecf1;
+    color: #0c5460;
+    border: 1px solid #bee5eb;
+}
+
+.ai-config-form input[type="checkbox"] {
+    width: auto;
+    margin-right: 8px;
+}

hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/docs/AI_API.md

@@ -0,0 +1,415 @@
+# InterConnect-Server AI API Documentation
+
+本文档描述了 InterConnect-Server 的 AI 聊天功能相关 API 接口。
+
+## 概述
+
+AI 功能允许 Minecraft 服务器通过 InterConnect-Client 插件/模组调用 OpenAI 格式的 API，实现游戏内 AI 聊天功能。
+
+**基础路径**: `/api/ai`
+
+---
+
+## 认证
+
+所有 API 请求需要在 Header 中携带 API Key：
+
+```
+Authorization: Bearer <your_api_key>
+```
+
+### 权限要求
+
+| 接口 | 权限要求 |
+|------|----------|
+| `GET /api/ai/config` | Admin Key |
+| `POST /api/ai/config` | Admin Key |
+| `PATCH /api/ai/config` | Admin Key |
+| `DELETE /api/ai/config` | Admin Key |
+| `POST /api/ai/config/test` | Admin Key |
+| `POST /api/ai/chat` | Server Key 或 Admin Key |
+
+---
+
+## AI 配置接口
+
+### 获取 AI 配置
+
+获取当前的 AI 配置信息（API Key 会被部分隐藏）。
+
+**请求**
+
+```http
+GET /api/ai/config
+Authorization: Bearer <admin_key>
+```
+
+**成功响应** `200 OK`
+
+```json
+{
+  "apiUrl": "https://api.openai.com/v1/chat/completions",
+  "modelId": "gpt-3.5-turbo",
+  "apiKey": "sk-x****xxxx",
+  "enabled": true,
+  "systemPrompt": "You are a helpful assistant for Minecraft players.",
+  "createdAt": "2024-01-15T10:30:00.000Z",
+  "updatedAt": "2024-01-15T12:00:00.000Z"
+}
+```
+
+**错误响应** `404 Not Found`
+
+```json
+{
+  "detail": "AI configuration not found"
+}
+```
+
+---
+
+### 创建 AI 配置
+
+创建新的 AI 配置。
+
+**请求**
+
+```http
+POST /api/ai/config
+Authorization: Bearer <admin_key>
+Content-Type: application/json
+```
+
+**请求体**
+
+```json
+{
+  "api_url": "https://api.openai.com/v1/chat/completions",
+  "model_id": "gpt-3.5-turbo",
+  "api_key": "sk-xxxxxxxxxxxxxxxxxxxxxxxx",
+  "enabled": true,
+  "system_prompt": "You are a helpful assistant for Minecraft players."
+}
+```
+
+| 字段 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `api_url` | string | ✅ | OpenAI 格式的 API URL |
+| `model_id` | string | ✅ | 模型 ID (如 gpt-3.5-turbo, gpt-4) |
+| `api_key` | string | ✅ | API Key |
+| `enabled` | boolean | ❌ | 是否启用，默认 `true` |
+| `system_prompt` | string | ❌ | 系统提示词，可选 |
+
+**成功响应** `201 Created`
+
+```json
+{
+  "apiUrl": "https://api.openai.com/v1/chat/completions",
+  "modelId": "gpt-3.5-turbo",
+  "apiKey": "sk-x****xxxx",
+  "enabled": true,
+  "systemPrompt": "You are a helpful assistant for Minecraft players.",
+  "createdAt": "2024-01-15T10:30:00.000Z",
+  "updatedAt": "2024-01-15T10:30:00.000Z"
+}
+```
+
+**错误响应** `400 Bad Request`
+
+```json
+{
+  "detail": "api_url, model_id, and api_key are required"
+}
+```
+
+---
+
+### 更新 AI 配置
+
+更新现有的 AI 配置，只需提供要更新的字段。
+
+**请求**
+
+```http
+PATCH /api/ai/config
+Authorization: Bearer <admin_key>
+Content-Type: application/json
+```
+
+**请求体**
+
+```json
+{
+  "model_id": "gpt-4",
+  "enabled": false
+}
+```
+
+| 字段 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `api_url` | string | ❌ | OpenAI 格式的 API URL |
+| `model_id` | string | ❌ | 模型 ID |
+| `api_key` | string | ❌ | API Key（不提供则保持原值） |
+| `enabled` | boolean | ❌ | 是否启用 |
+| `system_prompt` | string | ❌ | 系统提示词 |
+
+**成功响应** `200 OK`
+
+```json
+{
+  "apiUrl": "https://api.openai.com/v1/chat/completions",
+  "modelId": "gpt-4",
+  "apiKey": "sk-x****xxxx",
+  "enabled": false,
+  "systemPrompt": "You are a helpful assistant for Minecraft players.",
+  "createdAt": "2024-01-15T10:30:00.000Z",
+  "updatedAt": "2024-01-15T14:00:00.000Z"
+}
+```
+
+---
+
+### 删除 AI 配置
+
+删除 AI 配置。
+
+**请求**
+
+```http
+DELETE /api/ai/config
+Authorization: Bearer <admin_key>
+```
+
+**成功响应** `204 No Content`
+
+无响应体
+
+**错误响应** `404 Not Found`
+
+```json
+{
+  "detail": "AI configuration not found"
+}
+```
+
+---
+
+### 测试 AI 连接
+
+测试当前 AI 配置是否能正常连接。
+
+**请求**
+
+```http
+POST /api/ai/config/test
+Authorization: Bearer <admin_key>
+```
+
+**成功响应** `200 OK`
+
+```json
+{
+  "success": true,
+  "message": "Connection successful",
+  "model": "gpt-3.5-turbo",
+  "response": "OK"
+}
+```
+
+**错误响应** `400 Bad Request`
+
+```json
+{
+  "success": false,
+  "message": "Connection failed",
+  "error": "Invalid API key"
+}
+```
+
+---
+
+## AI 聊天接口
+
+### 发送聊天消息
+
+发送消息到 AI 并获取回复。此接口供 Minecraft 服务器的 InterConnect-Client 插件/模组调用。
+
+**请求**
+
+```http
+POST /api/ai/chat
+Authorization: Bearer <server_key>
+Content-Type: application/json
+```
+
+**请求体**
+
+```json
+{
+  "message": "你好，请介绍一下 Minecraft 的红石系统",
+  "player_name": "Steve",
+  "server_id": "my-server-1"
+}
+```
+
+| 字段 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `message` | string | ✅ | 用户发送的消息内容 |
+| `player_name` | string | ❌ | 发送消息的玩家名称 |
+| `server_id` | string | ❌ | 服务器 ID（Admin Key 可指定，Server Key 使用绑定的 server_id） |
+
+**成功响应** `200 OK`
+
+```json
+{
+  "success": true,
+  "reply": "红石是 Minecraft 中的一种特殊材料，可以用来创建各种机械装置...",
+  "model": "gpt-3.5-turbo",
+  "usage": {
+    "prompt_tokens": 25,
+    "completion_tokens": 150,
+    "total_tokens": 175
+  }
+}
+```
+
+**错误响应**
+
+`404 Not Found` - AI 配置不存在
+
+```json
+{
+  "detail": "AI configuration not found"
+}
+```
+
+`403 Forbidden` - AI 功能已禁用
+
+```json
+{
+  "detail": "AI feature is disabled"
+}
+```
+
+`400 Bad Request` - 缺少必填字段
+
+```json
+{
+  "detail": "message is required"
+}
+```
+
+`500 Internal Server Error` - AI 请求失败
+
+```json
+{
+  "success": false,
+  "detail": "AI request failed",
+  "error": "Rate limit exceeded"
+}
+```
+
+---
+
+## 事件类型
+
+当 AI 聊天发生时，会产生 `ai_chat` 类型的事件，通过 WebSocket 广播给所有连接的客户端。
+
+**事件格式**
+
+```json
+{
+  "type": "minecraft_event",
+  "event": {
+    "event_type": "ai_chat",
+    "server_name": "my-server-1",
+    "timestamp": "2024-01-15T10:30:00.000Z",
+    "data": {
+      "player_name": "Steve",
+      "message": "你好",
+      "reply": "你好！有什么我可以帮助你的吗？",
+      "model": "gpt-3.5-turbo"
+    }
+  },
+  "source_key_id_prefix": "abc12345"
+}
+```
+
+---
+
+## Minecraft 插件/模组集成示例
+
+### 命令格式
+
+在 Minecraft 服务器中，玩家可以使用以下命令调用 AI：
+
+```
+/ic chat <消息内容>
+```
+
+### 插件实现流程
+
+1. 玩家执行 `/ic chat 你好` 命令
+2. 插件捕获命令，提取消息内容
+3. 插件向 InterConnect-Server 发送 POST 请求：
+
+```http
+POST /api/ai/chat
+Authorization: Bearer <server_key>
+Content-Type: application/json
+
+{
+  "message": "你好",
+  "player_name": "Steve",
+  "server_id": "my-server-1"
+}
+```
+
+4. 收到响应后，将 AI 回复发送给玩家
+
+### 响应处理示例（伪代码）
+
+```java
+// 发送请求
+Response response = httpClient.post("/api/ai/chat", {
+    "message": playerMessage,
+    "player_name": player.getName(),
+    "server_id": serverId
+});
+
+// 处理响应
+if (response.success) {
+    player.sendMessage("[AI] " + response.reply);
+} else {
+    player.sendMessage("[AI] 请求失败: " + response.error);
+}
+```
+
+---
+
+## 支持的 API 提供商
+
+本系统支持所有兼容 OpenAI Chat Completions API 格式的服务：
+
+| 提供商 | API URL 示例 |
+|--------|-------------|
+| OpenAI | `https://api.openai.com/v1/chat/completions` |
+| Azure OpenAI | `https://{resource}.openai.azure.com/openai/deployments/{deployment}/chat/completions?api-version=2024-02-01` |
+| Anthropic (via proxy) | 需要兼容层 |
+| 本地模型 (Ollama) | `http://localhost:11434/v1/chat/completions` |
+| 其他兼容服务 | 根据服务商文档配置 |
+
+---
+
+## 错误码参考
+
+| HTTP 状态码 | 说明 |
+|-------------|------|
+| 200 | 请求成功 |
+| 201 | 创建成功 |
+| 204 | 删除成功（无内容） |
+| 400 | 请求参数错误 |
+| 401 | 未认证或 API Key 无效 |
+| 403 | 权限不足或功能已禁用 |
+| 404 | 资源不存在 |
+| 500 | 服务器内部错误 |

hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/docs/API.md

@@ -0,0 +1,730 @@
+# InterConnect-Server API Documentation
+
+本文档描述了 InterConnect-Server 的所有 API 接口（AI 相关接口请参考 [AI_API.md](./AI_API.md)）。
+
+## 概述
+
+InterConnect-Server 是一个 Minecraft WebSocket API 服务器，提供 API Key 管理、事件广播、服务器命令等功能。
+
+**默认端口**: `8000`
+
+---
+
+## 认证
+
+除健康检查接口外，所有 API 请求需要在 Header 中携带 API Key：
+
+```
+Authorization: Bearer <your_api_key>
+```
+
+### API Key 类型
+
+| 类型 | 前缀 | 说明 |
+|------|------|------|
+| Admin Key | `mc_admin_` | 管理员密钥，拥有所有权限 |
+| Regular Key | `mc_key_` | 普通密钥，可管理关联的 Server Key |
+| Server Key | `mc_server_` | 服务器密钥，供 Minecraft 服务器使用 |
+
+---
+
+## 健康检查
+
+### 获取服务器状态
+
+获取服务器健康状态和统计信息，无需认证。
+
+**请求**
+
+```http
+GET /health
+```
+
+**成功响应** `200 OK`
+
+```json
+{
+  "status": "healthy",
+  "timestamp": "2024-01-15T10:30:00.000Z",
+  "active_ws": 5,
+  "keys_total": 10,
+  "admin_active": 2,
+  "server_active": 4,
+  "regular_active": 4
+}
+```
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `status` | string | 服务器状态 (`healthy` / `unhealthy`) |
+| `timestamp` | string | 当前时间戳 |
+| `active_ws` | number | 活跃的 WebSocket 连接数 |
+| `keys_total` | number | API Key 总数 |
+| `admin_active` | number | 活跃的 Admin Key 数量 |
+| `server_active` | number | 活跃的 Server Key 数量 |
+| `regular_active` | number | 活跃的 Regular Key 数量 |
+
+**错误响应** `500 Internal Server Error`
+
+```json
+{
+  "status": "unhealthy",
+  "error": "Database connection failed"
+}
+```
+
+---
+
+## API Key 管理
+
+**基础路径**: `/manage/keys`
+
+### 获取所有 API Key
+
+获取所有 API Key 的信息列表。
+
+**权限**: Admin Key
+
+**请求**
+
+```http
+GET /manage/keys
+Authorization: Bearer <admin_key>
+```
+
+**成功响应** `200 OK`
+
+```json
+[
+  {
+    "id": "550e8400-e29b-41d4-a716-446655440000",
+    "name": "My Server Key",
+    "description": "Production server",
+    "keyPrefix": "mc_key_",
+    "keyType": "regular",
+    "serverId": "server-1",
+    "regularKeyId": null,
+    "createdAt": "2024-01-15T10:30:00.000Z",
+    "lastUsed": "2024-01-15T12:00:00.000Z",
+    "isActive": true
+  }
+]
+```
+
+---
+
+### 创建 API Key
+
+创建新的 API Key。创建 Regular Key 时会自动生成关联的 Server Key。
+
+**权限**: Admin Key
+
+**请求**
+
+```http
+POST /manage/keys
+Authorization: Bearer <admin_key>
+Content-Type: application/json
+```
+
+**请求体 - 创建 Regular Key（推荐）**
+
+```json
+{
+  "name": "My Server",
+  "description": "Production Minecraft server",
+  "key_type": "regular",
+  "server_id": "server-1"
+}
+```
+
+**请求体 - 创建 Admin Key**
+
+```json
+{
+  "name": "New Admin",
+  "description": "Backup admin key",
+  "key_type": "admin"
+}
+```
+
+| 字段 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `name` | string | ✅ | Key 名称 |
+| `description` | string | ❌ | 描述信息 |
+| `key_type` | string | ❌ | Key 类型：`regular`（默认）、`admin` |
+| `server_id` | string | ❌ | 服务器 ID |
+
+**成功响应 - Regular Key** `201 Created`
+
+```json
+{
+  "regularKey": {
+    "id": "550e8400-e29b-41d4-a716-446655440000",
+    "name": "My Server",
+    "description": "Production Minecraft server",
+    "keyPrefix": "mc_key_",
+    "keyType": "regular",
+    "serverId": "server-1",
+    "regularKeyId": null,
+    "createdAt": "2024-01-15T10:30:00.000Z",
+    "lastUsed": null,
+    "isActive": true,
+    "key": "mc_key_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6"
+  },
+  "serverKey": {
+    "id": "660e8400-e29b-41d4-a716-446655440001",
+    "name": "My Server - Server Key",
+    "description": "Server Key for My Server",
+    "keyPrefix": "mc_server_",
+    "keyType": "server",
+    "serverId": "server-1",
+    "regularKeyId": "550e8400-e29b-41d4-a716-446655440000",
+    "createdAt": "2024-01-15T10:30:00.000Z",
+    "lastUsed": null,
+    "isActive": true,
+    "key": "mc_server_x1y2z3a4b5c6d7e8f9g0h1i2j3k4l5m6"
+  }
+}
+```
+
+**成功响应 - Admin Key** `201 Created`
+
+```json
+{
+  "id": "770e8400-e29b-41d4-a716-446655440002",
+  "name": "New Admin",
+  "description": "Backup admin key",
+  "keyPrefix": "mc_admin_",
+  "keyType": "admin",
+  "serverId": null,
+  "regularKeyId": null,
+  "createdAt": "2024-01-15T10:30:00.000Z",
+  "lastUsed": null,
+  "isActive": true,
+  "key": "mc_admin_p1q2r3s4t5u6v7w8x9y0z1a2b3c4d5e6"
+}
+```
+
+> ⚠️ **重要**: `key` 字段只在创建时返回一次，请妥善保存！
+
+---
+
+### 获取 API Key 详情
+
+获取指定 API Key 的详细信息。
+
+**权限**: Admin Key
+
+**请求**
+
+```http
+GET /manage/keys/:key_id
+Authorization: Bearer <admin_key>
+```
+
+**成功响应** `200 OK`
+
+```json
+{
+  "id": "550e8400-e29b-41d4-a716-446655440000",
+  "name": "My Server Key",
+  "description": "Production server",
+  "keyPrefix": "mc_key_",
+  "keyType": "regular",
+  "serverId": "server-1",
+  "regularKeyId": null,
+  "createdAt": "2024-01-15T10:30:00.000Z",
+  "lastUsed": "2024-01-15T12:00:00.000Z",
+  "isActive": true
+}
+```
+
+**错误响应** `404 Not Found`
+
+```json
+{
+  "detail": "API Key not found"
+}
+```
+
+---
+
+### 获取 Server Key 列表
+
+获取当前用户可访问的 Server Key 列表。
+
+**权限**: Regular Key 或 Admin Key
+
+**请求**
+
+```http
+GET /manage/keys/server-keys
+Authorization: Bearer <regular_key_or_admin_key>
+```
+
+**成功响应** `200 OK`
+
+```json
+[
+  {
+    "id": "660e8400-e29b-41d4-a716-446655440001",
+    "name": "My Server - Server Key",
+    "description": "Server Key for My Server",
+    "keyPrefix": "mc_server_",
+    "keyType": "server",
+    "serverId": "server-1",
+    "createdAt": "2024-01-15T10:30:00.000Z",
+    "lastUsed": "2024-01-15T12:00:00.000Z",
+    "isActive": true
+  }
+]
+```
+
+- **Admin Key**: 返回所有 Server Key
+- **Regular Key**: 只返回关联的 Server Key
+
+---
+
+### 创建 Server Key
+
+为指定的 Regular Key 创建新的 Server Key。
+
+**权限**: Admin Key
+
+**请求**
+
+```http
+POST /manage/keys/server-keys
+Authorization: Bearer <admin_key>
+Content-Type: application/json
+```
+
+**请求体**
+
+```json
+{
+  "name": "Backup Server Key",
+  "description": "Backup key for server-1",
+  "server_id": "server-1",
+  "regular_key_id": "550e8400-e29b-41d4-a716-446655440000"
+}
+```
+
+| 字段 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `name` | string | ✅ | Key 名称 |
+| `description` | string | ❌ | 描述信息 |
+| `server_id` | string | ❌ | 服务器 ID |
+| `regular_key_id` | string | ✅ | 关联的 Regular Key ID |
+
+**成功响应** `201 Created`
+
+```json
+{
+  "id": "880e8400-e29b-41d4-a716-446655440003",
+  "name": "Backup Server Key",
+  "description": "Backup key for server-1",
+  "keyPrefix": "mc_server_",
+  "keyType": "server",
+  "serverId": "server-1",
+  "regularKeyId": "550e8400-e29b-41d4-a716-446655440000",
+  "createdAt": "2024-01-15T10:30:00.000Z",
+  "lastUsed": null,
+  "isActive": true,
+  "key": "mc_server_n1o2p3q4r5s6t7u8v9w0x1y2z3a4b5c6"
+}
+```
+
+---
+
+### 激活 API Key
+
+激活指定的 API Key。
+
+**权限**: 
+- Admin Key: 可激活任意 Key
+- Regular Key: 只能激活关联的 Server Key
+
+**请求**
+
+```http
+PATCH /manage/keys/:key_id/activate
+Authorization: Bearer <api_key>
+```
+
+**成功响应** `200 OK`
+
+```json
+{
+  "message": "Key '550e8400-e29b-41d4-a716-446655440000' activated."
+}
+```
+
+---
+
+### 停用 API Key
+
+停用指定的 API Key。
+
+**权限**: 
+- Admin Key: 可停用任意 Key（不能停用最后一个活跃的 Admin Key）
+- Regular Key: 只能停用关联的 Server Key
+
+**请求**
+
+```http
+PATCH /manage/keys/:key_id/deactivate
+Authorization: Bearer <api_key>
+```
+
+**成功响应** `200 OK`
+
+```json
+{
+  "message": "Key '550e8400-e29b-41d4-a716-446655440000' deactivated."
+}
+```
+
+**错误响应** `400 Bad Request`
+
+```json
+{
+  "detail": "Cannot deactivate your own key."
+}
+```
+
+```json
+{
+  "detail": "Cannot deactivate last active Admin Key."
+}
+```
+
+---
+
+### 删除 API Key
+
+永久删除指定的 API Key。
+
+**权限**: Admin Key
+
+**请求**
+
+```http
+DELETE /manage/keys/:key_id
+Authorization: Bearer <admin_key>
+```
+
+**成功响应** `204 No Content`
+
+无响应体
+
+**错误响应** `400 Bad Request`
+
+```json
+{
+  "detail": "Cannot delete your own key."
+}
+```
+
+```json
+{
+  "detail": "Cannot delete the last Admin Key"
+}
+```
+
+---
+
+## 事件接口
+
+**基础路径**: `/api/events`
+
+### 发送事件
+
+发送 Minecraft 事件并广播给所有 WebSocket 连接。
+
+**权限**: 任意有效 API Key
+
+**请求**
+
+```http
+POST /api/events
+Authorization: Bearer <api_key>
+Content-Type: application/json
+```
+
+**请求体**
+
+```json
+{
+  "event_type": "player_join",
+  "server_name": "server-1",
+  "timestamp": "2024-01-15T10:30:00.000Z",
+  "data": {
+    "player_name": "Steve",
+    "player_uuid": "550e8400-e29b-41d4-a716-446655440000"
+  }
+}
+```
+
+| 字段 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `event_type` | string | ✅ | 事件类型 |
+| `server_name` | string | ✅ | 服务器名称 |
+| `timestamp` | string | ✅ | 事件时间戳 (ISO 8601) |
+| `data` | object | ✅ | 事件数据 |
+
+**支持的事件类型**
+
+| 事件类型 | 说明 |
+|----------|------|
+| `player_join` | 玩家加入服务器 |
+| `player_leave` | 玩家离开服务器 |
+| `message` | 聊天消息 |
+| `server_command` | 服务器命令 |
+| `ai_chat` | AI 聊天 |
+
+**成功响应** `200 OK`
+
+```json
+{
+  "message": "Event received and broadcasted"
+}
+```
+
+**错误响应** `400 Bad Request`
+
+```json
+{
+  "detail": "Missing required event fields"
+}
+```
+
+```json
+{
+  "detail": "Invalid event_type: unknown_event"
+}
+```
+
+---
+
+## 服务器接口
+
+**基础路径**: `/api/server`
+
+### 获取服务器信息
+
+获取 Minecraft 服务器信息���
+
+**权限**: Regular Key 或 Admin Key
+
+**请求**
+
+```http
+GET /api/server/info
+Authorization: Bearer <api_key>
+```
+
+**查询参数**（仅 Admin Key）
+
+| 参数 | 类型 | 说明 |
+|------|------|------|
+| `server_id` | string | 指定服务器 ID |
+
+**成功响应** `200 OK`
+
+```json
+{
+  "server_id": "server-1",
+  "status": "running",
+  "online_players": 5,
+  "max_players": 20,
+  "version": "1.20.1",
+  "uptime": "2h 30m",
+  "tps": 19.8
+}
+```
+
+**错误响应** `400 Bad Request`
+
+```json
+{
+  "detail": "server_id is required for this key"
+}
+```
+
+---
+
+### 发送服务器命令
+
+向 Minecraft 服务器发送命令。
+
+**权限**: Regular Key 或 Admin Key
+
+**请求**
+
+```http
+POST /api/server/command
+Authorization: Bearer <api_key>
+Content-Type: application/json
+```
+
+**请求体**
+
+```json
+{
+  "command": "say Hello World",
+  "server_id": "server-1"
+}
+```
+
+| 字段 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `command` | string | ✅ | 要执行的命令 |
+| `server_id` | string | ❌ | 服务器 ID（Admin Key 可指定） |
+
+**成功响应** `200 OK`
+
+```json
+{
+  "message": "Command sent successfully",
+  "command": "say Hello World",
+  "server_id": "server-1"
+}
+```
+
+**错误响应** `400 Bad Request`
+
+```json
+{
+  "detail": "Command is required"
+}
+```
+
+**错误响应** `403 Forbidden`
+
+```json
+{
+  "detail": "Command is not allowed for Admin Key"
+}
+```
+
+**Admin Key 默认禁止的命令**
+
+以下命令默认禁止 Admin Key 执行（可通过环境变量配置）：
+
+- `stop`, `restart`, `reload`
+- `op`, `deop`
+- `ban`, `ban-ip`, `banlist`, `pardon`, `pardon-ip`
+- `whitelist`, `kick`
+- `save-all`, `save-on`, `save-off`
+
+---
+
+## WebSocket 接口
+
+### 连接 WebSocket
+
+建立 WebSocket 连接以接收实时事件。
+
+**端点**
+
+```
+ws://<host>:<port>/ws?api_key=<your_api_key>
+```
+
+**示例**
+
+```
+ws://localhost:8000/ws?api_key=mc_server_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6
+```
+
+**连接成功后**
+
+服务器会推送 Minecraft 事件消息：
+
+```json
+{
+  "type": "minecraft_event",
+  "event": {
+    "event_type": "player_join",
+    "server_name": "server-1",
+    "timestamp": "2024-01-15T10:30:00.000Z",
+    "data": {
+      "player_name": "Steve"
+    }
+  },
+  "source_key_id_prefix": "550e8400"
+}
+```
+
+### 心跳检测
+
+客户端可以发送 ping 消息保持连接：
+
+**发送**
+
+```json
+{
+  "type": "ping"
+}
+```
+
+**响应**
+
+```json
+{
+  "type": "pong"
+}
+```
+
+---
+
+## 根路径
+
+### 获取服务器信息
+
+**请求**
+
+```http
+GET /
+```
+
+**成功响应** `200 OK`
+
+```json
+{
+  "message": "Minecraft WebSocket API Server (Node.js)",
+  "dashboard": "/dashboard",
+  "websocket": "ws://localhost:8000/ws",
+  "version": "1.0.0"
+}
+```
+
+---
+
+## 错误码参考
+
+| HTTP 状态码 | 说明 |
+|-------------|------|
+| 200 | 请求成功 |
+| 201 | 创建成功 |
+| 204 | 删除成功（无内容） |
+| 400 | 请求参数错误 |
+| 401 | 未认证或 API Key 无效 |
+| 403 | 权限不足 |
+| 404 | 资源不存在 |
+| 500 | 服务器内部错误 |
+
+---
+
+## 环境变量配置
+
+| 变量名 | 默认值 | 说明 |
+|--------|--------|------|
+| `SERVER_HOST` | `0.0.0.0` | 服务器监听地址 |
+| `SERVER_PORT` | `8000` | 服务器端口 |
+| `DATABASE_PATH` | `minecraft_ws.db` | 数据库文件路径 |
+| `DASHBOARD_PORT` | `3000` | Dashboard 独立端口（可选） |
+| `ADMIN_ALLOWED_COMMANDS` | - | Admin Key 允许的命令（逗号分隔） |
+| `ADMIN_BLOCKED_COMMANDS` | - | Admin Key 禁止的命令（逗号分隔） |

hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/docs/TECH_STACK.md

@@ -0,0 +1,149 @@
+# 项目技术栈文档
+
+本文件详细说明 InterConnect-Server 的技术组成、模块职责与关键依赖版本。
+
+## 1. 运行环境
+- **Node.js**: 建议 v18+（Docker 镜像使用 `node:18-alpine`）
+- **包管理**: npm
+- **平台**: Windows / Linux / macOS
+
+## 2. 核心依赖与用途
+
+### 2.1 后端服务
+- **express@4.18.x**
+  - REST API 服务框架
+  - 路由结构：`src/routes/*.js`
+  - 入口：`src/server.js`
+
+- **ws@8.14.x**
+  - WebSocket 服务端实现
+  - 协议：`/ws?api_key=...`
+  - 连接管理：`src/websocket.js`
+
+- **sql.js@1.10.x**
+  - SQLite 在内存中运行并导出文件
+  - 本地持久化文件：`minecraft_ws.db`
+  - 初始化与表结构：`src/database.js`
+
+- **bcryptjs@2.4.x**
+  - Key 哈希存储
+  - 认证校验：`db.verifyApiKey()`
+  - 恢复 Token 哈希：`admin_recovery` 表
+
+- **uuid@9.0.x**
+  - 生成密钥 ID 与原始 Key
+
+- **dotenv@16.3.x**
+  - 读取环境变量
+  - 用于命令过滤与数据库路径等配置
+
+### 2.2 CLI 工具
+- **commander@11.1.x**
+  - CLI 命令定义
+  - 命令入口：`cli/cli.js`
+  - 支持管理 Key / health / reset-admin
+
+- **http / https (Node 内置)**
+  - CLI 直接调用 API
+
+### 2.3 前端 Dashboard
+纯静态页面，无前端框架。
+- `dashboard/public/index.html`
+- `dashboard/public/app.js`
+- `dashboard/public/style.css`
+
+## 3. 关键模块职责
+
+### 3.1 `src/server.js`
+- 服务入口
+- REST API 路由挂载
+- WebSocket 升级与连接管理
+- 初始化数据库与 Admin Key / Recovery Token
+
+### 3.2 `src/database.js`
+- SQLite 初始化与持久化
+- Key 创建 / 激活 / 停用 / 删除
+- Admin Recovery Token 管理
+- 事件日志写入
+
+### 3.3 `src/auth.js`
+- Bearer Token 认证中间件
+- Admin / Regular 权限判断
+
+### 3.4 `src/routes/keys.js`
+- Key CRUD
+- `/manage/keys/server-keys` 列表与激活/停用逻辑
+
+### 3.5 `src/routes/server.js`
+- 服务器信息与命令入口
+- Admin 命令过滤（可配置 allowlist / blocklist）
+
+### 3.6 `src/websocket.js`
+- WebSocket 连接管理
+- 广播消息
+
+## 4. 数据结构
+
+### 4.1 `api_keys`
+| 字段 | 类型 | 说明 |
+|---|---|---|
+| id | TEXT | 主键 |
+| name | TEXT | Key 名称 |
+| description | TEXT | 描述 |
+| key_hash | TEXT | bcrypt 哈希 |
+| key_prefix | TEXT | mc_admin_ / mc_key_ / mc_server_ |
+| key_type | TEXT | admin / regular / server |
+| server_id | TEXT | 关联服务器 |
+| regular_key_id | TEXT | 关联 Regular Key |
+| created_at | TEXT | 创建时间 |
+| last_used | TEXT | 最近使用 |
+| is_active | INTEGER | 是否启用 |
+
+### 4.2 `event_logs`
+事件上报记录。
+
+### 4.3 `admin_recovery`
+| 字段 | 类型 | 说明 |
+|---|---|---|
+| id | INTEGER | 固定为 1 |
+| token_hash | TEXT | 恢复 Token 哈希 |
+| created_at | TEXT | 创建时间 |
+| last_used | TEXT | 最近使用 |
+
+## 5. 权限与安全策略
+- Admin Key：完整管理权限
+- Regular Key：只允许操作自身 Server Key
+- Server Key：仅用于插件/Mod，不允许登录 Dashboard
+- Admin 命令过滤：
+  - `ADMIN_ALLOWED_COMMANDS` 非空时为 allowlist
+  - 否则使用 `ADMIN_BLOCKED_COMMANDS` 作为默认拦截表
+
+## 6. 部署与运行
+
+### 6.1 直接运行
+```bash
+npm install
+npm start
+```
+
+### 6.2 Docker
+```bash
+docker-compose up -d
+```
+
+### 6.3 数据持久化
+必须保留 `minecraft_ws.db`，否则 Admin Key 将重新生成。
+
+## 7. 关键配置项
+```env
+SERVER_HOST=0.0.0.0
+SERVER_PORT=8000
+DATABASE_PATH=minecraft_ws.db
+ADMIN_ALLOWED_COMMANDS=list,tps,version
+ADMIN_BLOCKED_COMMANDS=stop,deop,op,ban
+```
+
+## 8. 兼容与约束
+- WebSocket 与 REST 使用同一端口
+- Dashboard 只通过 `/dashboard` 提供
+- Admin Key 恢复必须使用 recovery token，禁止删除数据库

hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/cli/cli.js

@@ -4,6 +4,7 @@ const http = require('http');
 const https = require('https');
 const fs = require('fs');
 require('dotenv').config();
+const Database = require('../src/database');
 
 const HARDCODED_API_URL = 'http://localhost:8000';
 const HARDCODED_ADMIN_KEY = process.env.ADMIN_KEY || null;
@@ -386,4 +387,35 @@ program
         }
     });
 
+program
+    .command('reset-admin')
+    .description('Reset Admin Key using recovery token (offline)')
+    .requiredOption('-r, --recovery-token <token>', 'Admin recovery token')
+    .option('--db-path <path>', 'Database path', process.env.DATABASE_PATH || 'minecraft_ws.db')
+    .option('--keep-existing', 'Keep existing Admin Keys active')
+    .option('--name <name>', 'New Admin Key name', 'Recovered Admin Key')
+    .action(async (options) => {
+        try {
+            if (!fs.existsSync(options.dbPath)) {
+                throw new Error(`Database not found at ${options.dbPath}`);
+            }
+
+            const db = new Database(options.dbPath);
+            await db.init();
+
+            const result = await db.resetAdminKeyWithRecovery(options.recoveryToken, {
+                deactivateExisting: !options.keepExisting,
+                name: options.name
+            });
+
+            console.log('Admin Key reset successful.');
+            console.log(`  ID   : ${result.id}`);
+            console.log(`  Name : ${result.name}`);
+            console.log(`  Key  : ${result.key}`);
+        } catch (error) {
+            console.error(`\x1b[31mReset failed: ${error.message}\x1b[0m`);
+            process.exit(1);
+        }
+    });
+
 program.parse();

hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/dashboard/public/app.js

@@ -1,402 +1,399 @@
 const API_URL = window.location.origin;
-let superKey = null;
+let apiKey = null;
+let currentRole = null;
 let ws = null;
+let statsIntervalId = null;
+let wsPingIntervalId = null;
 
 const loginScreen = document.getElementById('login-screen');
-const dashboardScreen = document.getElementById('dashboard-screen');
+const adminScreen = document.getElementById('admin-screen');
+const userScreen = document.getElementById('user-screen');
 const loginForm = document.getElementById('login-form');
 const loginError = document.getElementById('login-error');
-const logoutBtn = document.getElementById('logout-btn');
+const apiKeyInput = document.getElementById('api-key-input');
+const logoutButtons = document.querySelectorAll('.logout-btn');
+const adminUserInfo = document.getElementById('admin-user-info');
+const userInfo = document.getElementById('user-info');
 const createKeyBtn = document.getElementById('create-key-btn');
 const createKeyModal = document.getElementById('create-key-modal');
 const createKeyForm = document.getElementById('create-key-form');
 const cancelCreateBtn = document.getElementById('cancel-create-btn');
 const keyDetailsModal = document.getElementById('key-details-modal');
 const closeDetailsBtn = document.getElementById('close-details-btn');
+const adminKeysList = document.getElementById('admin-keys-list');
+const userKeysList = document.getElementById('user-keys-list');
+const commandForm = document.getElementById('command-form');
+const commandInput = document.getElementById('command-input');
+const commandHistory = document.getElementById('command-history');
+const userEventsList = document.getElementById('user-events-list');
 
-loginForm.addEventListener('submit', async (e) => {
-    e.preventDefault();
-    const key = document.getElementById('super-key-input').value;
-    
-    try {
-        // 验证密钥是否有效
-        const response = await fetch(`${API_URL}/health`, {
-            headers: { 'Authorization': `Bearer ${key}` }
-        });
-        
-        if (response.ok) {
-            superKey = key;
-            
-            // 验证密钥类型
-            let userKeyType = null;
-            let userServerId = null;
-            
-            // 尝试Admin Key验证
-            const adminResponse = await fetch(`${API_URL}/manage/keys`, {
-                headers: { 'Authorization': `Bearer ${key}` }
-            });
-            
-            if (adminResponse.ok) {
-                userKeyType = 'admin';
-            } else {
-                // 尝试Server Key验证
-                const serverResponse = await fetch(`${API_URL}/api/server/info`, {
-                    headers: { 'Authorization': `Bearer ${key}` }
-                });
-                
-                if (serverResponse.ok) {
-                    userKeyType = 'server';
-                    const serverData = await serverResponse.json();
-                    userServerId = serverData.server_id;
-                } else {
-                    // 尝试Regular Key验证（获取自己的Server Key列表）
-                    const regularResponse = await fetch(`${API_URL}/manage/keys/server-keys`, {
-                        headers: { 'Authorization': `Bearer ${key}` }
-                    });
-                    
-                    if (regularResponse.ok) {
-                        userKeyType = 'regular';
-                    } else {
-                        throw new Error('无效的密钥或权限不足');
-                    }
-                }
-            }
-            
-            loginError.textContent = '';
-            showDashboard(userKeyType, userServerId);
-        } else {
-            loginError.textContent = '无效的密钥';
-        }
-    } catch (error) {
-        loginError.textContent = error.message || '无法连接到服务器';
+function authHeaders(key) {
+    return { Authorization: `Bearer ${key}` };
+}
+
+function resetSession() {
+    apiKey = null;
+    currentRole = null;
+
+    if (statsIntervalId) {
+        clearInterval(statsIntervalId);
+        statsIntervalId = null;
+    }
+
+    if (wsPingIntervalId) {
+        clearInterval(wsPingIntervalId);
+        wsPingIntervalId = null;
     }
-});
 
-logoutBtn.addEventListener('click', () => {
-    superKey = null;
     if (ws) {
         ws.close();
         ws = null;
     }
-    loginScreen.classList.remove('hidden');
-    dashboardScreen.classList.add('hidden');
-});
 
-createKeyBtn.addEventListener('click', () => {
-    createKeyModal.classList.remove('hidden');
-});
+    if (loginScreen) {
+        loginScreen.classList.remove('hidden');
+    }
+    if (adminScreen) {
+        adminScreen.classList.add('hidden');
+    }
+    if (userScreen) {
+        userScreen.classList.add('hidden');
+    }
+}
 
-cancelCreateBtn.addEventListener('click', () => {
-    createKeyModal.classList.add('hidden');
-    createKeyForm.reset();
-});
+async function detectRole(key) {
+    const adminResponse = await fetch(`${API_URL}/manage/keys`, {
+        headers: authHeaders(key)
+    });
 
-closeDetailsBtn.addEventListener('click', () => {
-    keyDetailsModal.classList.add('hidden');
-});
+    if (adminResponse.ok) {
+        return 'admin';
+    }
 
-createKeyForm.addEventListener('submit', async (e) => {
-    e.preventDefault();
-    
-    const name = document.getElementById('key-name').value;
-    const description = document.getElementById('key-description').value;
-    const isSuper = document.getElementById('key-is-super').checked;
-    
-    try {
-        const response = await fetch(`${API_URL}/manage/keys`, {
-            method: 'POST',
-            headers: {
-                'Authorization': `Bearer ${superKey}`,
-                'Content-Type': 'application/json'
-            },
-            body: JSON.stringify({
-                name,
-                description,
-                is_super_key: isSuper
-            })
-        });
-        
-        if (response.ok) {
-            const result = await response.json();
-            createKeyModal.classList.add('hidden');
-            createKeyForm.reset();
-            
-            showKeyCreatedModal(result);
-            loadKeys();
-        } else {
-            const error = await response.json();
-            alert('创建失败: ' + error.detail);
-        }
-    } catch (error) {
-        alert('创建失败: ' + error.message);
+    const regularResponse = await fetch(`${API_URL}/manage/keys/server-keys`, {
+        headers: authHeaders(key)
+    });
+
+    if (regularResponse.ok) {
+        return 'regular';
     }
-});
 
-function showKeyCreatedModal(keyData) {
-    const content = `
-        <p><strong>密钥创建成功！</strong></p>
-        <p>名称: ${keyData.name}</p>
-        <p>类型: ${keyData.isSuperKey ? 'SuperKey' : '普通密钥'}</p>
-        <div class="key-display">
-            <strong>⚠️ 请立即复制并保存此密钥（仅显示一次）:</strong><br>
-            ${keyData.key}
-        </div>
-    `;
-    
-    document.getElementById('key-details-content').innerHTML = content;
-    keyDetailsModal.classList.remove('hidden');
+    return null;
 }
 
-// 全局变量
-let currentUserKeyType = null;
-let currentUserServerId = null;
+function showAdminPanel() {
+    currentRole = 'admin';
+    loginScreen.classList.add('hidden');
+    userScreen.classList.add('hidden');
+    adminScreen.classList.remove('hidden');
+
+    if (adminUserInfo) {
+        adminUserInfo.textContent = 'Admin Key';
+    }
+
+    loadAdminKeys();
+}
 
-async function showDashboard(userKeyType, userServerId) {
-    currentUserKeyType = userKeyType;
-    currentUserServerId = userServerId;
-    
+function showUserPanel() {
+    currentRole = 'regular';
     loginScreen.classList.add('hidden');
-    dashboardScreen.classList.remove('hidden');
-    
-    // 显示用户信息
-    const userInfo = document.getElementById('user-info');
-    const keyTypeIcons = { admin: '👑', server: '🖥️', regular: '🔑' };
-    const keyTypeNames = { admin: 'Admin', server: 'Server', regular: 'Regular' };
-    userInfo.textContent = `${keyTypeIcons[userKeyType]} ${keyTypeNames[userKeyType]} 用户`;
-    
-    // 根据权限显示/隐藏功能
-    const adminSection = document.getElementById('admin-section');
-    const serverSection = document.getElementById('server-section');
-    
-    if (userKeyType === 'admin') {
-        adminSection.style.display = 'block';
-        serverSection.style.display = 'block';
-        loadKeys();
-    } else if (userKeyType === 'server') {
-        adminSection.style.display = 'none';
-        serverSection.style.display = 'block';
-        loadServerInfo();
-    } else if (userKeyType === 'regular') {
-        adminSection.style.display = 'none';
-        serverSection.style.display = 'block';
-        loadRegularServerKeys();
-    }
-    
-    // 根据用户类型控制创建密钥按钮的显示
-    const createKeyBtn = document.getElementById('create-key-btn');
-    if (createKeyBtn) {
-        createKeyBtn.style.display = userKeyType === 'admin' ? 'block' : 'none';
-    }
-    
+    adminScreen.classList.add('hidden');
+    userScreen.classList.remove('hidden');
+
+    if (userInfo) {
+        userInfo.textContent = 'Regular Key';
+    }
+
+    loadUserServerKeys();
     loadStats();
     connectWebSocket();
-    
-    setInterval(loadStats, 5000);
-}
 
-async function loadStats() {
-    try {
-        const response = await fetch(`${API_URL}/health`);
-        const data = await response.json();
-        
-        document.getElementById('stat-connections').textContent = data.active_ws || 0;
-        document.getElementById('stat-total-keys').textContent = data.keys_total || 0;
-        document.getElementById('stat-super-keys').textContent = data.super_active || 0;
-        document.getElementById('stat-regular-keys').textContent = data.regular_active || 0;
-    } catch (error) {
-        console.error('Failed to load stats:', error);
-    }
+    statsIntervalId = setInterval(loadStats, 5000);
 }
 
-async function loadKeys() {
+async function loadAdminKeys() {
+    if (!adminKeysList || !apiKey) {
+        return;
+    }
     try {
         const response = await fetch(`${API_URL}/manage/keys`, {
-            headers: { 'Authorization': `Bearer ${superKey}` }
+            headers: authHeaders(apiKey)
         });
-        
+
         if (response.ok) {
             const keys = await response.json();
-            renderKeys(keys);
+            renderAdminKeys(keys);
+        } else {
+            adminKeysList.innerHTML = '<p>Failed to load keys.</p>';
         }
     } catch (error) {
-        console.error('Failed to load keys:', error);
+        adminKeysList.innerHTML = `<p>Failed to load keys: ${error.message}</p>`;
     }
 }
 
-async function loadRegularServerKeys() {
+async function loadUserServerKeys() {
+    if (!userKeysList || !apiKey) {
+        return;
+    }
     try {
         const response = await fetch(`${API_URL}/manage/keys/server-keys`, {
-            headers: { 'Authorization': `Bearer ${superKey}` }
+            headers: authHeaders(apiKey)
         });
-        
+
         if (response.ok) {
-            const serverKeys = await response.json();
-            renderServerKeys(serverKeys);
+            const keys = await response.json();
+            renderUserServerKeys(keys);
         } else {
-            document.getElementById('keys-list').innerHTML = '<p>无法加载Server Key列表</p>';
+            userKeysList.innerHTML = '<p>Failed to load server keys.</p>';
         }
     } catch (error) {
-        console.error('Failed to load server keys:', error);
-        document.getElementById('keys-list').innerHTML = '<p>无法加载Server Key列表</p>';
+        userKeysList.innerHTML = `<p>Failed to load server keys: ${error.message}</p>`;
     }
 }
 
-function renderServerKeys(keys) {
-    const keysList = document.getElementById('keys-list');
-    
-    if (keys.length === 0) {
-        keysList.innerHTML = '<p>暂无关联的Server Key</p>';
+function renderAdminKeys(keys) {
+    if (!adminKeysList) {
         return;
     }
-    
-    keysList.innerHTML = keys.map(key => `
-        <div class="key-card">
+
+    if (!keys.length) {
+        adminKeysList.innerHTML = '<p>No API keys found.</p>';
+        return;
+    }
+
+    adminKeysList.innerHTML = keys.map((key) => `
+        <div class="key-card ${key.keyType === 'admin' ? 'admin' : ''}">
             <div class="key-info">
                 <h3>
-                    <span class="key-badge server">🖥️ Server</span>
+                    <span class="key-badge ${key.keyType}">
+                        ${key.keyType === 'admin' ? 'Admin' : key.keyType === 'server' ? 'Server' : 'Regular'}
+                    </span>
                     <span class="key-badge ${key.isActive ? 'active' : 'inactive'}">
-                        ${key.isActive ? '活跃' : '已停用'}
+                        ${key.isActive ? 'Active' : 'Inactive'}
                     </span>
                     ${key.name}
                 </h3>
                 <p>ID: ${key.id}</p>
-                <p>前缀: ${key.keyPrefix}</p>
-                ${key.serverId ? `<p>服务器ID: ${key.serverId}</p>` : ''}
-                <p>创建时间: ${new Date(key.createdAt).toLocaleString('zh-CN')}</p>
-                <p>最后使用: ${key.lastUsed ? new Date(key.lastUsed).toLocaleString('zh-CN') : '从未使用'}</p>
+                <p>Prefix: ${key.keyPrefix}</p>
+                ${key.serverId ? `<p>Server ID: ${key.serverId}</p>` : ''}
+                <p>Created: ${new Date(key.createdAt).toLocaleString()}</p>
+                <p>Last Used: ${key.lastUsed ? new Date(key.lastUsed).toLocaleString() : 'Never'}</p>
             </div>
             <div class="key-actions">
-                ${key.isActive ? 
-                    `<button class="btn-danger" onclick="deactivateKey('${key.id}')">停用</button>` :
-                    `<button class="btn-success" onclick="activateKey('${key.id}')">激活</button>`
+                ${key.isActive
+                    ? `<button class="btn-danger" onclick="deactivateKey('${key.id}')">Deactivate</button>`
+                    : `<button class="btn-success" onclick="activateKey('${key.id}')">Activate</button>`
                 }
-                <button class="btn-danger" onclick="deleteKey('${key.id}', '${key.name}')">删除</button>
+                <button class="btn-danger" onclick="deleteKey('${key.id}', '${key.name}')">Delete</button>
             </div>
         </div>
     `).join('');
 }
 
-function renderKeys(keys) {
-    const keysList = document.getElementById('keys-list');
-    
-    if (keys.length === 0) {
-        keysList.innerHTML = '<p>暂无API密钥</p>';
+function renderUserServerKeys(keys) {
+    if (!userKeysList) {
         return;
     }
-    
-    keysList.innerHTML = keys.map(key => `
-        <div class="key-card ${key.keyType === 'admin' ? 'super' : ''}">
+
+    if (!keys.length) {
+        userKeysList.innerHTML = '<p>No server keys available.</p>';
+        return;
+    }
+
+    userKeysList.innerHTML = keys.map((key) => `
+        <div class="key-card">
             <div class="key-info">
                 <h3>
-                    <span class="key-badge ${key.keyType}">
-                        ${key.keyType === 'admin' ? '👑 Admin' : key.keyType === 'server' ? '🖥️ Server' : '🔑 Regular'}
-                    </span>
+                    <span class="key-badge server">Server</span>
                     <span class="key-badge ${key.isActive ? 'active' : 'inactive'}">
-                        ${key.isActive ? '活跃' : '已停用'}
+                        ${key.isActive ? 'Active' : 'Inactive'}
                     </span>
                     ${key.name}
                 </h3>
                 <p>ID: ${key.id}</p>
-                <p>前缀: ${key.keyPrefix}</p>
-                ${key.serverId ? `<p>服务器ID: ${key.serverId}</p>` : ''}
-                <p>创建时间: ${new Date(key.createdAt).toLocaleString('zh-CN')}</p>
-                <p>最后使用: ${key.lastUsed ? new Date(key.lastUsed).toLocaleString('zh-CN') : '从未使用'}</p>
+                <p>Prefix: ${key.keyPrefix}</p>
+                ${key.serverId ? `<p>Server ID: ${key.serverId}</p>` : ''}
+                <p>Created: ${new Date(key.createdAt).toLocaleString()}</p>
+                <p>Last Used: ${key.lastUsed ? new Date(key.lastUsed).toLocaleString() : 'Never'}</p>
             </div>
             <div class="key-actions">
-                ${key.isActive ? 
-                    `<button class="btn-danger" onclick="deactivateKey('${key.id}')">停用</button>` :
-                    `<button class="btn-success" onclick="activateKey('${key.id}')">激活</button>`
+                ${key.isActive
+                    ? `<button class="btn-danger" onclick="deactivateKey('${key.id}')">Deactivate</button>`
+                    : `<button class="btn-success" onclick="activateKey('${key.id}')">Activate</button>`
                 }
-                <button class="btn-danger" onclick="deleteKey('${key.id}', '${key.name}')">删除</button>
             </div>
         </div>
     `).join('');
 }
 
 async function activateKey(keyId) {
+    if (!apiKey) {
+        return;
+    }
     try {
         const response = await fetch(`${API_URL}/manage/keys/${keyId}/activate`, {
             method: 'PATCH',
-            headers: { 'Authorization': `Bearer ${superKey}` }
+            headers: authHeaders(apiKey)
         });
-        
-        if (response.ok) {
-            if (currentUserKeyType === 'admin') {
-                loadKeys();
-            } else if (currentUserKeyType === 'regular') {
-                loadRegularServerKeys();
-            }
-        } else {
+
+        if (!response.ok) {
             const error = await response.json();
-            alert('激活失败: ' + error.detail);
+            alert(`Failed to activate key: ${error.detail}`);
+            return;
+        }
+
+        if (currentRole === 'admin') {
+            loadAdminKeys();
+        } else if (currentRole === 'regular') {
+            loadUserServerKeys();
         }
     } catch (error) {
-        alert('激活失败: ' + error.message);
+        alert(`Failed to activate key: ${error.message}`);
     }
 }
 
 async function deactivateKey(keyId) {
+    if (!apiKey) {
+        return;
+    }
     try {
         const response = await fetch(`${API_URL}/manage/keys/${keyId}/deactivate`, {
             method: 'PATCH',
-            headers: { 'Authorization': `Bearer ${superKey}` }
+            headers: authHeaders(apiKey)
         });
-        
-        if (response.ok) {
-            if (currentUserKeyType === 'admin') {
-                loadKeys();
-            } else if (currentUserKeyType === 'regular') {
-                loadRegularServerKeys();
-            }
-        } else {
+
+        if (!response.ok) {
             const error = await response.json();
-            alert('停用失败: ' + error.detail);
+            alert(`Failed to deactivate key: ${error.detail}`);
+            return;
+        }
+
+        if (currentRole === 'admin') {
+            loadAdminKeys();
+        } else if (currentRole === 'regular') {
+            loadUserServerKeys();
         }
     } catch (error) {
-        alert('停用失败: ' + error.message);
+        alert(`Failed to deactivate key: ${error.message}`);
     }
 }
 
 async function deleteKey(keyId, keyName) {
-    if (!confirm(`确定要删除密钥 "${keyName}" 吗？此操作无法撤销。`)) {
+    if (currentRole !== 'admin') {
+        return;
+    }
+    if (!confirm(`Delete key "${keyName}"? This action cannot be undone.`)) {
         return;
     }
-    
     try {
         const response = await fetch(`${API_URL}/manage/keys/${keyId}`, {
             method: 'DELETE',
-            headers: { 'Authorization': `Bearer ${superKey}` }
+            headers: authHeaders(apiKey)
         });
-        
-        if (response.ok) {
-            if (currentUserKeyType === 'admin') {
-                loadKeys();
-            } else if (currentUserKeyType === 'regular') {
-                loadRegularServerKeys();
-            }
-        } else {
+
+        if (!response.ok) {
             const error = await response.json();
-            alert('删除失败: ' + error.detail);
+            alert(`Failed to delete key: ${error.detail}`);
+            return;
         }
+
+        loadAdminKeys();
     } catch (error) {
-        alert('删除失败: ' + error.message);
+        alert(`Failed to delete key: ${error.message}`);
+    }
+}
+
+function showKeyCreatedModal(payload) {
+    if (!keyDetailsModal) {
+        return;
+    }
+
+    let content = '';
+    if (payload.regularKey && payload.serverKey) {
+        content = `
+            <p><strong>Regular Key</strong></p>
+            <p>Name: ${payload.regularKey.name}</p>
+            <p>Type: ${payload.regularKey.keyType}</p>
+            <p>ID: ${payload.regularKey.id}</p>
+            <p>Key: ${payload.regularKey.key}</p>
+            <hr>
+            <p><strong>Server Key</strong></p>
+            <p>Name: ${payload.serverKey.name}</p>
+            <p>Type: ${payload.serverKey.keyType}</p>
+            <p>ID: ${payload.serverKey.id}</p>
+            <p>Key: ${payload.serverKey.key}</p>
+        `;
+    } else {
+        content = `
+            <p><strong>Key Created</strong></p>
+            <p>Name: ${payload.name}</p>
+            <p>Type: ${payload.keyType}</p>
+            <p>ID: ${payload.id}</p>
+            <p>Key: ${payload.key}</p>
+        `;
+    }
+
+    const detailsContent = document.getElementById('key-details-content');
+    if (detailsContent) {
+        detailsContent.innerHTML = content;
+    }
+
+    keyDetailsModal.classList.remove('hidden');
+}
+
+async function loadStats() {
+    try {
+        const response = await fetch(`${API_URL}/health`);
+        if (!response.ok) {
+            return;
+        }
+        const data = await response.json();
+
+        const connections = document.getElementById('user-stat-connections');
+        if (connections) {
+            connections.textContent = data.active_ws || 0;
+        }
+
+        const totalKeys = document.getElementById('user-stat-total-keys');
+        if (totalKeys) {
+            totalKeys.textContent = data.keys_total || 0;
+        }
+
+        const adminKeys = document.getElementById('user-stat-admin-keys');
+        if (adminKeys) {
+            adminKeys.textContent = data.admin_active || 0;
+        }
+
+        const regularKeys = document.getElementById('user-stat-regular-keys');
+        if (regularKeys) {
+            regularKeys.textContent = data.regular_active || 0;
+        }
+
+        const serverKeys = document.getElementById('user-stat-server-keys');
+        if (serverKeys) {
+            serverKeys.textContent = data.server_active || 0;
+        }
+    } catch (error) {
+        console.error('Failed to load stats:', error);
     }
 }
 
 function connectWebSocket() {
-    if (!superKey) return;
-    
-    const wsUrl = `ws://localhost:8000/ws?api_key=${superKey}`;
+    if (!apiKey) {
+        return;
+    }
+
+    const protocol = window.location.protocol === 'https:' ? 'wss' : 'ws';
+    const wsUrl = `${protocol}://${window.location.host}/ws?api_key=${apiKey}`;
     ws = new WebSocket(wsUrl);
-    
+
     ws.onopen = () => {
         console.log('WebSocket connected');
     };
-    
+
     ws.onmessage = (event) => {
         try {
             const message = JSON.parse(event.data);
-            
             if (message.type === 'minecraft_event') {
                 addEventToList(message.event);
             }
@@ -404,21 +401,23 @@ function connectWebSocket() {
             console.error('Failed to parse WebSocket message:', error);
         }
     };
-    
+
     ws.onerror = (error) => {
         console.error('WebSocket error:', error);
     };
-    
+
     ws.onclose = () => {
         console.log('WebSocket disconnected');
-        setTimeout(() => {
-            if (superKey) {
-                connectWebSocket();
-            }
-        }, 5000);
+        if (wsPingIntervalId) {
+            clearInterval(wsPingIntervalId);
+            wsPingIntervalId = null;
+        }
+        if (apiKey && currentRole === 'regular') {
+            setTimeout(() => connectWebSocket(), 5000);
+        }
     };
-    
-    setInterval(() => {
+
+    wsPingIntervalId = setInterval(() => {
         if (ws && ws.readyState === WebSocket.OPEN) {
             ws.send(JSON.stringify({ type: 'ping' }));
         }
@@ -426,19 +425,183 @@ function connectWebSocket() {
 }
 
 function addEventToList(event) {
-    const eventsList = document.getElementById('events-list');
-    
+    if (!userEventsList) {
+        return;
+    }
+
     const eventItem = document.createElement('div');
     eventItem.className = 'event-item';
     eventItem.innerHTML = `
         <strong>${event.event_type}</strong> - ${event.server_name}<br>
-        <small>${new Date(event.timestamp).toLocaleString('zh-CN')}</small><br>
+        <small>${new Date(event.timestamp).toLocaleString()}</small><br>
         <pre>${JSON.stringify(event.data, null, 2)}</pre>
     `;
-    
-    eventsList.insertBefore(eventItem, eventsList.firstChild);
-    
-    while (eventsList.children.length > 50) {
-        eventsList.removeChild(eventsList.lastChild);
+
+    userEventsList.insertBefore(eventItem, userEventsList.firstChild);
+
+    while (userEventsList.children.length > 50) {
+        userEventsList.removeChild(userEventsList.lastChild);
+    }
+}
+
+function appendCommandHistory(command, status, detail) {
+    if (!commandHistory) {
+        return;
     }
+
+    const entry = document.createElement('div');
+    entry.className = 'command-item';
+    entry.innerHTML = `
+        <div>${status}: ${command}</div>
+        ${detail ? `<div class="timestamp">${detail}</div>` : ''}
+    `;
+    commandHistory.insertBefore(entry, commandHistory.firstChild);
+
+    while (commandHistory.children.length > 20) {
+        commandHistory.removeChild(commandHistory.lastChild);
+    }
+}
+
+if (loginForm) {
+    loginForm.addEventListener('submit', async (event) => {
+        event.preventDefault();
+        const key = apiKeyInput.value.trim();
+        loginError.textContent = '';
+
+        if (!key) {
+            loginError.textContent = 'API key is required.';
+            return;
+        }
+
+        try {
+            const role = await detectRole(key);
+            if (!role) {
+                loginError.textContent = 'Invalid key or insufficient permissions.';
+                return;
+            }
+
+            apiKey = key;
+
+            if (role === 'admin') {
+                showAdminPanel();
+            } else if (role === 'regular') {
+                showUserPanel();
+            }
+        } catch (error) {
+            loginError.textContent = error.message || 'Unable to connect to server.';
+        }
+    });
+}
+
+logoutButtons.forEach((button) => {
+    button.addEventListener('click', () => {
+        resetSession();
+    });
+});
+
+if (createKeyBtn) {
+    createKeyBtn.addEventListener('click', () => {
+        createKeyModal.classList.remove('hidden');
+    });
 }
+
+if (cancelCreateBtn) {
+    cancelCreateBtn.addEventListener('click', () => {
+        createKeyModal.classList.add('hidden');
+        createKeyForm.reset();
+    });
+}
+
+if (closeDetailsBtn) {
+    closeDetailsBtn.addEventListener('click', () => {
+        keyDetailsModal.classList.add('hidden');
+    });
+}
+
+if (createKeyForm) {
+    createKeyForm.addEventListener('submit', async (event) => {
+        event.preventDefault();
+
+        const name = document.getElementById('key-name').value.trim();
+        const description = document.getElementById('key-description').value.trim();
+        const keyType = document.getElementById('key-type').value;
+        const serverId = document.getElementById('key-server-id').value.trim();
+
+        if (!name) {
+            alert('Name is required.');
+            return;
+        }
+
+        try {
+            const payload = {
+                name,
+                description,
+                key_type: keyType
+            };
+
+            if (serverId) {
+                payload.server_id = serverId;
+            }
+
+            const response = await fetch(`${API_URL}/manage/keys`, {
+                method: 'POST',
+                headers: {
+                    ...authHeaders(apiKey),
+                    'Content-Type': 'application/json'
+                },
+                body: JSON.stringify(payload)
+            });
+
+            if (!response.ok) {
+                const error = await response.json();
+                alert(`Failed to create key: ${error.detail}`);
+                return;
+            }
+
+            const result = await response.json();
+            createKeyModal.classList.add('hidden');
+            createKeyForm.reset();
+            showKeyCreatedModal(result);
+            loadAdminKeys();
+        } catch (error) {
+            alert(`Failed to create key: ${error.message}`);
+        }
+    });
+}
+
+if (commandForm) {
+    commandForm.addEventListener('submit', async (event) => {
+        event.preventDefault();
+
+        const command = commandInput.value.trim();
+        if (!command) {
+            return;
+        }
+
+        try {
+            const response = await fetch(`${API_URL}/api/server/command`, {
+                method: 'POST',
+                headers: {
+                    ...authHeaders(apiKey),
+                    'Content-Type': 'application/json'
+                },
+                body: JSON.stringify({ command })
+            });
+
+            if (!response.ok) {
+                const error = await response.json();
+                appendCommandHistory(command, 'Rejected', error.detail);
+                return;
+            }
+
+            appendCommandHistory(command, 'Sent', new Date().toLocaleString());
+            commandInput.value = '';
+        } catch (error) {
+            appendCommandHistory(command, 'Error', error.message);
+        }
+    });
+}
+
+window.activateKey = activateKey;
+window.deactivateKey = deactivateKey;
+window.deleteKey = deleteKey;

hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/dashboard/public/index.html

@@ -1,88 +1,125 @@
 <!DOCTYPE html>
-<html lang="zh-CN">
+<html lang="en">
 <head>
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <title>Minecraft WebSocket API - 控制面板</title>
+    <title>Minecraft WebSocket API - Dashboard</title>
     <link rel="stylesheet" href="style.css">
 </head>
 <body>
     <div id="login-screen" class="screen">
         <div class="login-container">
-            <h1>🎮 Minecraft WebSocket API</h1>
-            <h2>控制面板登录</h2>
+            <h1>Minecraft WebSocket API</h1>
+            <h2>Dashboard Login</h2>
             <form id="login-form">
-                <input type="password" id="super-key-input" placeholder="输入Admin Key或Server Key" required>
-                <button type="submit">登录</button>
+                <input type="password" id="api-key-input" placeholder="Enter Admin or Regular Key" required>
+                <button type="submit">Login</button>
             </form>
             <p class="error-message" id="login-error"></p>
             <div class="login-info">
-                <p><strong>密钥类型说明：</strong></p>
-                <p>👑 <strong>Admin Key</strong> - 完全管理权限</p>
-                <p>🖥️ <strong>Server Key</strong> - 服务器管理权限</p>
+                <p><strong>Key Types</strong></p>
+                <p>Admin Key - full management permissions</p>
+                <p>Regular Key - server monitoring and command access</p>
             </div>
         </div>
     </div>
 
-    <div id="dashboard-screen" class="screen hidden">
+    <div id="admin-screen" class="screen hidden">
         <nav class="navbar">
-            <h1>🎮 Minecraft WebSocket API</h1>
-            <button id="logout-btn">退出登录</button>
+            <h1>Admin Panel</h1>
+            <div class="nav-info">
+                <span id="admin-user-info"></span>
+                <button class="logout-btn">Logout</button>
+            </div>
+        </nav>
+
+        <div class="container">
+            <div class="section" id="admin-key-section">
+                <div class="section-header">
+                    <h2>API Key Management</h2>
+                    <button id="create-key-btn" class="btn-primary">Create Key</button>
+                </div>
+                <div id="admin-keys-list" class="keys-list"></div>
+            </div>
+        </div>
+    </div>
+
+    <div id="user-screen" class="screen hidden">
+        <nav class="navbar">
+            <h1>User Monitoring</h1>
+            <div class="nav-info">
+                <span id="user-info"></span>
+                <button class="logout-btn">Logout</button>
+            </div>
         </nav>
 
         <div class="container">
             <div class="stats-grid">
                 <div class="stat-card">
-                    <h3>活跃连接</h3>
-                    <p class="stat-value" id="stat-connections">0</p>
+                    <h3>Active Connections</h3>
+                    <p class="stat-value" id="user-stat-connections">0</p>
                 </div>
                 <div class="stat-card">
-                    <h3>总密钥数</h3>
-                    <p class="stat-value" id="stat-total-keys">0</p>
+                    <h3>Total Keys</h3>
+                    <p class="stat-value" id="user-stat-total-keys">0</p>
                 </div>
                 <div class="stat-card">
-                    <h3>活跃SuperKeys</h3>
-                    <p class="stat-value" id="stat-super-keys">0</p>
+                    <h3>Admin Keys</h3>
+                    <p class="stat-value" id="user-stat-admin-keys">0</p>
                 </div>
                 <div class="stat-card">
-                    <h3>活跃普通Keys</h3>
-                    <p class="stat-value" id="stat-regular-keys">0</p>
+                    <h3>Regular Keys</h3>
+                    <p class="stat-value" id="user-stat-regular-keys">0</p>
+                </div>
+                <div class="stat-card">
+                    <h3>Server Keys</h3>
+                    <p class="stat-value" id="user-stat-server-keys">0</p>
                 </div>
             </div>
 
             <div class="section">
-                <div class="section-header">
-                    <h2>API密钥管理</h2>
-                    <button id="create-key-btn" class="btn-primary">创建新密钥</button>
-                </div>
-                <div id="keys-list" class="keys-list"></div>
+                <h2>Server Keys</h2>
+                <div id="user-keys-list" class="keys-list"></div>
             </div>
 
             <div class="section">
-                <h2>实时事件监控</h2>
-                <div id="events-list" class="events-list"></div>
+                <h2>Command Console</h2>
+                <form id="command-form" class="command-form">
+                    <input type="text" id="command-input" placeholder="Enter command" required>
+                    <button type="submit" class="btn-primary">Send</button>
+                </form>
+                <div id="command-history" class="command-history"></div>
+            </div>
+
+            <div class="section">
+                <h2>Live Events</h2>
+                <div id="user-events-list" class="events-list"></div>
             </div>
         </div>
     </div>
 
     <div id="create-key-modal" class="modal hidden">
         <div class="modal-content">
-            <h2>创建新API密钥</h2>
+            <h2>Create API Key</h2>
             <form id="create-key-form">
-                <label>名称 *</label>
+                <label>Name *</label>
                 <input type="text" id="key-name" required>
-                
-                <label>描述</label>
+
+                <label>Description</label>
                 <textarea id="key-description"></textarea>
-                
-                <label>
-                    <input type="checkbox" id="key-is-super">
-                    创建为SuperKey
-                </label>
-                
+
+                <label>Key Type</label>
+                <select id="key-type">
+                    <option value="regular">Regular</option>
+                    <option value="admin">Admin</option>
+                </select>
+
+                <label>Server ID (optional)</label>
+                <input type="text" id="key-server-id">
+
                 <div class="modal-actions">
-                    <button type="button" id="cancel-create-btn" class="btn-secondary">取消</button>
-                    <button type="submit" class="btn-primary">创建</button>
+                    <button type="button" id="cancel-create-btn" class="btn-secondary">Cancel</button>
+                    <button type="submit" class="btn-primary">Create</button>
                 </div>
             </form>
         </div>
@@ -90,10 +127,10 @@
 
     <div id="key-details-modal" class="modal hidden">
         <div class="modal-content">
-            <h2>密钥详情</h2>
+            <h2>Key Details</h2>
             <div id="key-details-content"></div>
             <div class="modal-actions">
-                <button id="close-details-btn" class="btn-secondary">关闭</button>
+                <button id="close-details-btn" class="btn-secondary">Close</button>
             </div>
         </div>
     </div>

hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/dashboard/public/style.css

@@ -95,7 +95,7 @@ body {
     color: #667eea;
 }
 
-#logout-btn {
+.logout-btn {
     padding: 10px 20px;
     background: #ff4444;
     color: white;
@@ -218,7 +218,7 @@ body {
     align-items: center;
 }
 
-.key-card.super {
+.key-card.admin {
     border-color: #764ba2;
     background: #f9f7fb;
 }
@@ -236,7 +236,7 @@ body {
     margin-right: 10px;
 }
 
-.key-badge.super {
+.key-badge.admin {
     background: #764ba2;
     color: white;
 }
@@ -246,6 +246,11 @@ body {
     color: white;
 }
 
+.key-badge.server {
+    background: #4f8ef7;
+    color: white;
+}
+
 .key-badge.active {
     background: #4caf50;
     color: white;
@@ -327,8 +332,13 @@ body {
     resize: vertical;
 }
 
-.modal-content input[type="checkbox"] {
-    margin-right: 8px;
+.modal-content select {
+    width: 100%;
+    padding: 10px;
+    border: 2px solid #e0e0e0;
+    border-radius: 5px;
+    margin-bottom: 15px;
+    font-size: 14px;
 }
 
 .modal-actions {
@@ -344,7 +354,8 @@ body {
     gap: 15px;
 }
 
-#user-info {
+#user-info,
+#admin-user-info {
     font-size: 0.9em;
     color: #667eea;
     background: rgba(255,255,255,0.1);
@@ -379,6 +390,20 @@ body {
     padding: 10px;
 }
 
+.command-form {
+    display: flex;
+    gap: 10px;
+    margin-bottom: 15px;
+}
+
+.command-form input {
+    flex: 1;
+    padding: 12px;
+    border: 2px solid #e0e0e0;
+    border-radius: 5px;
+    font-size: 14px;
+}
+
 .command-item {
     padding: 8px 0;
     border-bottom: 1px solid #f8f9fa;

hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/dashboard/server.js

@@ -3,7 +3,7 @@ const express = require('express');
 const path = require('path');
 
 const app = express();
-const PORT = parseInt(process.env.DASHBOARD_PORT || '3000');
+const PORT = parseInt(process.env.DASHBOARD_PORT || '3000', 10);
 
 app.use(express.static(path.join(__dirname, 'public')));
 
@@ -13,9 +13,9 @@ app.get('/', (req, res) => {
 
 app.listen(PORT, () => {
     console.log('='.repeat(50));
-    console.log('🎮 Minecraft WebSocket API - 控制面板');
+    console.log('Minecraft WebSocket API - Dashboard');
     console.log('='.repeat(50));
-    console.log(`控制面板地址: http://localhost:${PORT}`);
-    console.log('请使用SuperKey登录');
+    console.log(`Dashboard URL: http://localhost:${PORT}`);
+    console.log('Use Admin or Regular Key to log in.');
     console.log('='.repeat(50));
 });

hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/.github/scripts/ai_agent.py

@@ -2,9 +2,9 @@ import os
 import json
 import re
 from openai import OpenAI
-from github import Github, Auth  # 导入 Auth 以修复弃用警告
+from github import Github, Auth
 
-# --- 1. 初始化客户端 (修复 DeprecationWarning) ---
+# 初始化客户端
 auth = Auth.Token(os.getenv("GITHUB_TOKEN"))
 gh = Github(auth=auth)
 repo = gh.get_repo(os.getenv("GITHUB_REPOSITORY"))
@@ -13,82 +13,51 @@ client = OpenAI(api_key=os.getenv("OPENAI_API_KEY"), base_url=os.getenv("OPENAI_
 event_data = json.loads(os.getenv("EVENT_CONTEXT"))
 event_name = os.getenv("EVENT_NAME")
 
-# --- 2. 定义工具 (增加 **kwargs 以忽略多余参数) ---
-
+# --- 工具定义 (保持不变，增加 **kwargs 鲁棒性) ---
 def list_directory(path=".", **kwargs):
-    """列出指定目录下的文件和文件夹"""
     try:
-        # 基础路径安全检查
-        if ".." in path: return "Error: Cannot access parent directory."
-        items = os.listdir(path)
-        return "\n".join(items)
-    except Exception as e:
-        return f"Error listing directory: {str(e)}"
+        if ".." in path: return "Error: Access denied."
+        return "\n".join(os.listdir(path))
+    except Exception as e: return str(e)
 
 def read_file(path, **kwargs):
-    """读取特定文件的完整内容"""
     try:
         if ".." in path: return "Error: Access denied."
         with open(path, 'r', encoding='utf-8') as f:
-            return f.read()[:5000] 
-    except Exception as e:
-        return f"Error reading file: {str(e)}"
+            return f.read()[:5000]
+    except Exception as e: return str(e)
 
 def search_keyword(keyword, path=".", **kwargs):
-    """在当前目录及其子目录中搜索关键词"""
     results = []
-    try:
-        for root, dirs, files in os.walk(path):
-            if ".git" in root: continue # 过滤 Git 目录
-            for file in files:
-                if file.endswith(('.py', '.js', '.ts', '.md', '.json', '.rs', '.toml', '.yml')):
-                    full_path = os.path.join(root, file)
-                    try:
-                        with open(full_path, 'r', encoding='utf-8') as f:
-                            if keyword in f.read():
-                                results.append(full_path)
-                    except: continue
-        return "\n".join(results[:15]) if results else "No matches found."
-    except Exception as e:
-        return f"Search error: {str(e)}"
-
-# --- 3. 获取上下文 ---
-
+    for root, _, files in os.walk(path):
+        if ".git" in root: continue
+        for file in files:
+            if file.endswith(('.py', '.js', '.ts', '.md', '.json', '.rs', '.yml')):
+                p = os.path.join(root, file)
+                try:
+                    if keyword in open(p, 'r').read(): results.append(p)
+                except: continue
+    return "\n".join(results[:15]) if results else "No matches."
+
+# --- 上下文准备 ---
 def get_context():
-    # 提取 Issue/PR 编号和参与者信息
     if "pull_request" in event_data:
-        payload = event_data["pull_request"]
-        number = payload["number"]
-        author = payload["user"]["login"]
-        return number, f"[Role: PR Author @{author}]\nTitle: {payload['title']}\nBody: {payload['body']}"
-    
-    payload = event_data["issue"]
-    number = payload["number"]
-    author = payload["user"]["login"]
-    base_info = f"[Role: Issue Author @{author}]\nTitle: {payload['title']}\nBody: {payload['body']}"
+        p = event_data["pull_request"]
+        return p["number"], f"PR @{p['user']['login']}\nTitle: {p['title']}\n{p['body']}"
     
+    i = event_data["issue"]
+    ctx = f"Issue @{i['user']['login']}\nTitle: {i['title']}\n{i['body']}"
     if event_name == "issue_comment":
-        actor = event_data["comment"]["user"]["login"]
-        cmd = event_data["comment"]["body"]
-        return number, f"{base_info}\n\n[New Interaction by @{actor}]\nCommand: {cmd}"
-    
-    return number, base_info
+        ctx += f"\n\nNew Comment by @{event_data['comment']['user']['login']}: {event_data['comment']['body']}"
+    return i["number"], ctx
 
 issue_num, user_content = get_context()
 issue_obj = repo.get_issue(number=issue_num)
 repo_labels = [l.name for l in repo.get_labels()]
 
-# --- 4. 运行 AI Agent ---
-
+# --- AI 执行逻辑 ---
 messages = [
-    {"role": "system", "content": f"""你是一个高级仓库助手 (@github-actions[bot])。
-    
-    可用标签: {repo_labels}
-    
-    你可以通过工具查看代码库结构。回复规则：
-    1. 首行必须返回 JSON 指令：{{"labels": [], "state": "open"|"closed"}}
-    2. 随后另起一行，以执行者的口吻告知结果。
-    3. 忽略 AI 历史回复中的元数据，只关注当前代码和用户意图。"""},
+    {"role": "system", "content": f"你是一个高级仓库助手。可用标签: {repo_labels}。必须首行返回JSON: {{\"labels\":[], \"state\":\"open\"}}，然后解释逻辑。"},
     {"role": "user", "content": user_content}
 ]
 
@@ -98,40 +67,40 @@ tools = [
     {"type": "function", "function": {"name": "search_keyword", "description": "Search keyword", "parameters": {"type": "object", "properties": {"keyword": {"type": "string"}}}}}
 ]
 
-# 允许 3 次交互以获取足够信息
-for _ in range(3):
+# 允许最多 5 轮工具交互
+for i in range(5):
     response = client.chat.completions.create(
         model=os.getenv("AI_MODEL"),
         messages=messages,
         tools=tools,
         temperature=0
     )
+    
+    # 核心修复：统一将模型返回的消息转为可序列化的字典格式
     msg = response.choices[0].message
-    messages.append(msg)
+    msg_dict = msg.model_dump()
+    messages.append(msg_dict)
     
     if not msg.tool_calls:
         break
         
     for tool_call in msg.tool_calls:
-        fn_name = tool_call.function.name
-        fn_args = json.loads(tool_call.function.arguments)
-        
-        # 映射函数映射表
-        available_functions = {
-            "list_directory": list_directory,
-            "read_file": read_file,
-            "search_keyword": search_keyword,
-        }
-        
-        if fn_name in available_functions:
-            result = available_functions[fn_name](**fn_args)
-            messages.append({"role": "tool", "tool_call_id": tool_call.id, "content": result})
+        args = json.loads(tool_call.function.arguments)
+        func = {"list_directory": list_directory, "read_file": read_file, "search_keyword": search_keyword}.get(tool_call.function.name)
+        result = func(**args) if func else "Unknown function"
+        messages.append({"role": "tool", "tool_call_id": tool_call.id, "content": str(result)})
 
-# 5. 解析并执行 GitHub 操作
-final_res = messages[-1].content
-json_data = {"labels": [], "state": "open"}
+# 确保最后一条消息是文本回复
+if messages[-1].get("role") == "tool" or (messages[-1].get("tool_calls") and not messages[-1].get("content")):
+    final_check = client.chat.completions.create(model=os.getenv("AI_MODEL"), messages=messages)
+    messages.append(final_check.choices[0].message.model_dump())
 
-# 提取 JSON 块
+# 提取最终文本内容
+final_msg = messages[-1]
+final_res = final_msg.get("content") or ""
+
+# --- 结果解析与执行 ---
+json_data = {"labels": [], "state": "open"}
 match = re.search(r'(\{.*?\})', final_res, re.DOTALL)
 if match:
     try:
@@ -141,7 +110,7 @@ if match:
 
 if json_data.get("labels"):
     issue_obj.add_to_labels(*json_data["labels"])
-if json_data.get("state") and json_data["state"] in ["open", "closed"]:
+if json_data.get("state") in ["open", "closed"]:
     issue_obj.edit(state=json_data["state"])
 
 issue_obj.create_comment(f"### 🤖 AI Agent Execution\n\n{final_res}")

hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/.github/workflows/ai-review.yaml

@@ -1,116 +1,46 @@
-import os
-import json
-import re
-from openai import OpenAI
-from github import Github, Auth
-
-# 初始化客户端
-auth = Auth.Token(os.getenv("GITHUB_TOKEN"))
-gh = Github(auth=auth)
-repo = gh.get_repo(os.getenv("GITHUB_REPOSITORY"))
-client = OpenAI(api_key=os.getenv("OPENAI_API_KEY"), base_url=os.getenv("OPENAI_BASE_URL"))
-
-event_data = json.loads(os.getenv("EVENT_CONTEXT"))
-event_name = os.getenv("EVENT_NAME")
-
-# --- 工具定义 (保持不变，增加 **kwargs 鲁棒性) ---
-def list_directory(path=".", **kwargs):
-    try:
-        if ".." in path: return "Error: Access denied."
-        return "\n".join(os.listdir(path))
-    except Exception as e: return str(e)
-
-def read_file(path, **kwargs):
-    try:
-        if ".." in path: return "Error: Access denied."
-        with open(path, 'r', encoding='utf-8') as f:
-            return f.read()[:5000]
-    except Exception as e: return str(e)
-
-def search_keyword(keyword, path=".", **kwargs):
-    results = []
-    for root, _, files in os.walk(path):
-        if ".git" in root: continue
-        for file in files:
-            if file.endswith(('.py', '.js', '.ts', '.md', '.json', '.rs', '.yml')):
-                p = os.path.join(root, file)
-                try:
-                    if keyword in open(p, 'r').read(): results.append(p)
-                except: continue
-    return "\n".join(results[:15]) if results else "No matches."
-
-# --- 上下文准备 ---
-def get_context():
-    if "pull_request" in event_data:
-        p = event_data["pull_request"]
-        return p["number"], f"PR @{p['user']['login']}\nTitle: {p['title']}\n{p['body']}"
-    
-    i = event_data["issue"]
-    ctx = f"Issue @{i['user']['login']}\nTitle: {i['title']}\n{i['body']}"
-    if event_name == "issue_comment":
-        ctx += f"\n\nNew Comment by @{event_data['comment']['user']['login']}: {event_data['comment']['body']}"
-    return i["number"], ctx
-
-issue_num, user_content = get_context()
-issue_obj = repo.get_issue(number=issue_num)
-repo_labels = [l.name for l in repo.get_labels()]
-
-# --- AI 执行逻辑 ---
-messages = [
-    {"role": "system", "content": f"你是一个高级仓库助手。可用标签: {repo_labels}。必须首行返回JSON: {{\"labels\":[], \"state\":\"open\"}}，然后解释逻辑。"},
-    {"role": "user", "content": user_content}
-]
-
-tools = [
-    {"type": "function", "function": {"name": "list_directory", "description": "List files", "parameters": {"type": "object", "properties": {"path": {"type": "string"}}}}},
-    {"type": "function", "function": {"name": "read_file", "description": "Read content", "parameters": {"type": "object", "properties": {"path": {"type": "string"}}}}},
-    {"type": "function", "function": {"name": "search_keyword", "description": "Search keyword", "parameters": {"type": "object", "properties": {"keyword": {"type": "string"}}}}}
-]
-
-# 允许最多 5 轮工具交互
-for i in range(5):
-    response = client.chat.completions.create(
-        model=os.getenv("AI_MODEL"),
-        messages=messages,
-        tools=tools,
-        temperature=0
-    )
-    
-    # 核心修复：统一将模型返回的消息转为可序列化的字典格式
-    msg = response.choices[0].message
-    msg_dict = msg.model_dump()
-    messages.append(msg_dict)
-    
-    if not msg.tool_calls:
-        break
-        
-    for tool_call in msg.tool_calls:
-        args = json.loads(tool_call.function.arguments)
-        func = {"list_directory": list_directory, "read_file": read_file, "search_keyword": search_keyword}.get(tool_call.function.name)
-        result = func(**args) if func else "Unknown function"
-        messages.append({"role": "tool", "tool_call_id": tool_call.id, "content": str(result)})
-
-# 确保最后一条消息是文本回复
-if messages[-1].get("role") == "tool" or (messages[-1].get("tool_calls") and not messages[-1].get("content")):
-    final_check = client.chat.completions.create(model=os.getenv("AI_MODEL"), messages=messages)
-    messages.append(final_check.choices[0].message.model_dump())
-
-# 提取最终文本内容
-final_msg = messages[-1]
-final_res = final_msg.get("content") or ""
-
-# --- 结果解析与执行 ---
-json_data = {"labels": [], "state": "open"}
-match = re.search(r'(\{.*?\})', final_res, re.DOTALL)
-if match:
-    try:
-        json_data = json.loads(match.group(1))
-        final_res = final_res.replace(match.group(1), "").strip()
-    except: pass
-
-if json_data.get("labels"):
-    issue_obj.add_to_labels(*json_data["labels"])
-if json_data.get("state") in ["open", "closed"]:
-    issue_obj.edit(state=json_data["state"])
-
-issue_obj.create_comment(f"### 🤖 AI Agent Execution\n\n{final_res}")
+name: AI Repository Agent (Python Tools)
+
+on:
+  pull_request:
+    types: [opened]
+  issues:
+    types: [opened]
+  issue_comment:
+    types: [created]
+
+jobs:
+  ai-agent:
+    if: |
+      github.event_name == 'pull_request' || 
+      github.event_name == 'issues' || 
+      (github.event_name == 'issue_comment' && startsWith(github.event.comment.body, '[use-ai]'))
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pull-requests: write
+      issues: write
+
+    steps:
+      - name: Checkout Code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Set up Python
+        uses: actions/setup-python@v4
+        with:
+          python-version: '3.10'
+
+      - name: Install Dependencies
+        run: |
+          pip install openai PyGithub
+
+      - name: Run AI Agent
+        env:
+          OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
+          OPENAI_BASE_URL: ${{ secrets.OPENAI_BASE_URL }}
+          AI_MODEL: ${{ secrets.AI_MODEL }}
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          EVENT_CONTEXT: ${{ toJson(github.event) }}
+          EVENT_NAME: ${{ github.event_name }}
+        run: python .github/scripts/ai_agent.py

hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/.github/workflows/ai-review.yaml

@@ -1,46 +1,116 @@
-name: AI Repository Agent (Python Tools)
-
-on:
-  pull_request:
-    types: [opened]
-  issues:
-    types: [opened]
-  issue_comment:
-    types: [created]
-
-jobs:
-  ai-agent:
-    if: |
-      github.event_name == 'pull_request' || 
-      github.event_name == 'issues' || 
-      (github.event_name == 'issue_comment' && startsWith(github.event.comment.body, '[use-ai]'))
-    runs-on: ubuntu-latest
-    permissions:
-      contents: read
-      pull-requests: write
-      issues: write
-
-    steps:
-      - name: Checkout Code
-        uses: actions/checkout@v4
-        with:
-          fetch-depth: 0
-
-      - name: Set up Python
-        uses: actions/setup-python@v4
-        with:
-          python-version: '3.10'
-
-      - name: Install Dependencies
-        run: |
-          pip install openai PyGithub
-
-      - name: Run AI Agent
-        env:
-          OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
-          OPENAI_BASE_URL: ${{ secrets.OPENAI_BASE_URL }}
-          AI_MODEL: ${{ secrets.AI_MODEL }}
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-          EVENT_CONTEXT: ${{ toJson(github.event) }}
-          EVENT_NAME: ${{ github.event_name }}
-        run: python .github/scripts/ai_agent.py
+import os
+import json
+import re
+from openai import OpenAI
+from github import Github, Auth
+
+# 初始化客户端
+auth = Auth.Token(os.getenv("GITHUB_TOKEN"))
+gh = Github(auth=auth)
+repo = gh.get_repo(os.getenv("GITHUB_REPOSITORY"))
+client = OpenAI(api_key=os.getenv("OPENAI_API_KEY"), base_url=os.getenv("OPENAI_BASE_URL"))
+
+event_data = json.loads(os.getenv("EVENT_CONTEXT"))
+event_name = os.getenv("EVENT_NAME")
+
+# --- 工具定义 (保持不变，增加 **kwargs 鲁棒性) ---
+def list_directory(path=".", **kwargs):
+    try:
+        if ".." in path: return "Error: Access denied."
+        return "\n".join(os.listdir(path))
+    except Exception as e: return str(e)
+
+def read_file(path, **kwargs):
+    try:
+        if ".." in path: return "Error: Access denied."
+        with open(path, 'r', encoding='utf-8') as f:
+            return f.read()[:5000]
+    except Exception as e: return str(e)
+
+def search_keyword(keyword, path=".", **kwargs):
+    results = []
+    for root, _, files in os.walk(path):
+        if ".git" in root: continue
+        for file in files:
+            if file.endswith(('.py', '.js', '.ts', '.md', '.json', '.rs', '.yml')):
+                p = os.path.join(root, file)
+                try:
+                    if keyword in open(p, 'r').read(): results.append(p)
+                except: continue
+    return "\n".join(results[:15]) if results else "No matches."
+
+# --- 上下文准备 ---
+def get_context():
+    if "pull_request" in event_data:
+        p = event_data["pull_request"]
+        return p["number"], f"PR @{p['user']['login']}\nTitle: {p['title']}\n{p['body']}"
+    
+    i = event_data["issue"]
+    ctx = f"Issue @{i['user']['login']}\nTitle: {i['title']}\n{i['body']}"
+    if event_name == "issue_comment":
+        ctx += f"\n\nNew Comment by @{event_data['comment']['user']['login']}: {event_data['comment']['body']}"
+    return i["number"], ctx
+
+issue_num, user_content = get_context()
+issue_obj = repo.get_issue(number=issue_num)
+repo_labels = [l.name for l in repo.get_labels()]
+
+# --- AI 执行逻辑 ---
+messages = [
+    {"role": "system", "content": f"你是一个高级仓库助手。可用标签: {repo_labels}。必须首行返回JSON: {{\"labels\":[], \"state\":\"open\"}}，然后解释逻辑。"},
+    {"role": "user", "content": user_content}
+]
+
+tools = [
+    {"type": "function", "function": {"name": "list_directory", "description": "List files", "parameters": {"type": "object", "properties": {"path": {"type": "string"}}}}},
+    {"type": "function", "function": {"name": "read_file", "description": "Read content", "parameters": {"type": "object", "properties": {"path": {"type": "string"}}}}},
+    {"type": "function", "function": {"name": "search_keyword", "description": "Search keyword", "parameters": {"type": "object", "properties": {"keyword": {"type": "string"}}}}}
+]
+
+# 允许最多 5 轮工具交互
+for i in range(5):
+    response = client.chat.completions.create(
+        model=os.getenv("AI_MODEL"),
+        messages=messages,
+        tools=tools,
+        temperature=0
+    )
+    
+    # 核心修复：统一将模型返回的消息转为可序列化的字典格式
+    msg = response.choices[0].message
+    msg_dict = msg.model_dump()
+    messages.append(msg_dict)
+    
+    if not msg.tool_calls:
+        break
+        
+    for tool_call in msg.tool_calls:
+        args = json.loads(tool_call.function.arguments)
+        func = {"list_directory": list_directory, "read_file": read_file, "search_keyword": search_keyword}.get(tool_call.function.name)
+        result = func(**args) if func else "Unknown function"
+        messages.append({"role": "tool", "tool_call_id": tool_call.id, "content": str(result)})
+
+# 确保最后一条消息是文本回复
+if messages[-1].get("role") == "tool" or (messages[-1].get("tool_calls") and not messages[-1].get("content")):
+    final_check = client.chat.completions.create(model=os.getenv("AI_MODEL"), messages=messages)
+    messages.append(final_check.choices[0].message.model_dump())
+
+# 提取最终文本内容
+final_msg = messages[-1]
+final_res = final_msg.get("content") or ""
+
+# --- 结果解析与执行 ---
+json_data = {"labels": [], "state": "open"}
+match = re.search(r'(\{.*?\})', final_res, re.DOTALL)
+if match:
+    try:
+        json_data = json.loads(match.group(1))
+        final_res = final_res.replace(match.group(1), "").strip()
+    except: pass
+
+if json_data.get("labels"):
+    issue_obj.add_to_labels(*json_data["labels"])
+if json_data.get("state") in ["open", "closed"]:
+    issue_obj.edit(state=json_data["state"])
+
+issue_obj.create_comment(f"### 🤖 AI Agent Execution\n\n{final_res}")

hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/.github/scripts/ai_agent.py

@@ -1,106 +1,110 @@
 import os
 import json
-import base64
+import re
 from openai import OpenAI
-from github import Github
+from github import Github, Auth  # 导入 Auth 以修复弃用警告
 
-# 初始化客户端
-client = OpenAI(api_key=os.getenv("OPENAI_API_KEY"), base_url=os.getenv("OPENAI_BASE_URL"))
-gh = Github(os.getenv("GITHUB_TOKEN"))
+# --- 1. 初始化客户端 (修复 DeprecationWarning) ---
+auth = Auth.Token(os.getenv("GITHUB_TOKEN"))
+gh = Github(auth=auth)
 repo = gh.get_repo(os.getenv("GITHUB_REPOSITORY"))
+client = OpenAI(api_key=os.getenv("OPENAI_API_KEY"), base_url=os.getenv("OPENAI_BASE_URL"))
+
 event_data = json.loads(os.getenv("EVENT_CONTEXT"))
 event_name = os.getenv("EVENT_NAME")
 
-# --- 定义 AI 可调用的工具 ---
+# --- 2. 定义工具 (增加 **kwargs 以忽略多余参数) ---
 
-def list_directory(path="."):
+def list_directory(path=".", **kwargs):
     """列出指定目录下的文件和文件夹"""
     try:
+        # 基础路径安全检查
+        if ".." in path: return "Error: Cannot access parent directory."
         items = os.listdir(path)
         return "\n".join(items)
     except Exception as e:
-        return str(e)
+        return f"Error listing directory: {str(e)}"
 
-def read_file(path):
+def read_file(path, **kwargs):
     """读取特定文件的完整内容"""
     try:
+        if ".." in path: return "Error: Access denied."
         with open(path, 'r', encoding='utf-8') as f:
-            return f.read()[:5000] # 限制长度防止 Over-token
+            return f.read()[:5000] 
     except Exception as e:
-        return str(e)
+        return f"Error reading file: {str(e)}"
 
-def search_keyword(keyword, path="."):
+def search_keyword(keyword, path=".", **kwargs):
     """在当前目录及其子目录中搜索关键词"""
     results = []
-    for root, dirs, files in os.walk(path):
-        for file in files:
-            if file.endswith(('.py', '.js', '.ts', '.md', '.json', '.rs')):
-                full_path = os.path.join(root, file)
-                try:
-                    with open(full_path, 'r', encoding='utf-8') as f:
-                        if keyword in f.read():
-                            results.append(full_path)
-                except:
-                    continue
-    return "\n".join(results[:20])
-
-# --- 准备上下文与角色 ---
+    try:
+        for root, dirs, files in os.walk(path):
+            if ".git" in root: continue # 过滤 Git 目录
+            for file in files:
+                if file.endswith(('.py', '.js', '.ts', '.md', '.json', '.rs', '.toml', '.yml')):
+                    full_path = os.path.join(root, file)
+                    try:
+                        with open(full_path, 'r', encoding='utf-8') as f:
+                            if keyword in f.read():
+                                results.append(full_path)
+                    except: continue
+        return "\n".join(results[:15]) if results else "No matches found."
+    except Exception as e:
+        return f"Search error: {str(e)}"
+
+# --- 3. 获取上下文 ---
 
 def get_context():
-    if event_name == "pull_request":
-        number = event_data["pull_request"]["number"]
-        author = event_data["pull_request"]["user"]["login"]
-        title = event_data["pull_request"]["title"]
-        body = event_data["pull_request"]["body"]
-        return number, f"PR Author: @{author}\nTitle: {title}\nBody: {body}\n(This is a Pull Request)"
+    # 提取 Issue/PR 编号和参与者信息
+    if "pull_request" in event_data:
+        payload = event_data["pull_request"]
+        number = payload["number"]
+        author = payload["user"]["login"]
+        return number, f"[Role: PR Author @{author}]\nTitle: {payload['title']}\nBody: {payload['body']}"
     
-    number = event_data["issue"]["number"]
-    author = event_data["issue"]["user"]["login"]
-    title = event_data["issue"]["title"]
-    body = event_data["issue"]["body"]
+    payload = event_data["issue"]
+    number = payload["number"]
+    author = payload["user"]["login"]
+    base_info = f"[Role: Issue Author @{author}]\nTitle: {payload['title']}\nBody: {payload['body']}"
     
     if event_name == "issue_comment":
         actor = event_data["comment"]["user"]["login"]
         cmd = event_data["comment"]["body"]
-        return number, f"Issue Author: @{author}\nTriggered by: @{actor}\nCommand: {cmd}\nContext: {title}\n{body}"
+        return number, f"{base_info}\n\n[New Interaction by @{actor}]\nCommand: {cmd}"
     
-    return number, f"Issue Author: @{author}\nTitle: {title}\nBody: {body}"
+    return number, base_info
 
 issue_num, user_content = get_context()
 issue_obj = repo.get_issue(number=issue_num)
 repo_labels = [l.name for l in repo.get_labels()]
 
-# --- 主逻辑 ---
+# --- 4. 运行 AI Agent ---
 
 messages = [
     {"role": "system", "content": f"""你是一个高级仓库助手 (@github-actions[bot])。
-    你可以通过工具阅读代码、搜索文件并管理 Issue/PR 状态。
     
     可用标签: {repo_labels}
-    你的目标: 
-    1. 理解用户意图。
-    2. 如果需要，使用工具查看项目结构或具体文件。
-    3. 给出处理方案，并直接执行（打标签、关闭等）。
     
-    输出规范:
-    回复开头必须是 JSON 指令: {{"labels": [], "state": "open"|"closed"}}
-    然后是你的执行报告。"""},
+    你可以通过工具查看代码库结构。回复规则：
+    1. 首行必须返回 JSON 指令：{{"labels": [], "state": "open"|"closed"}}
+    2. 随后另起一行，以执行者的口吻告知结果。
+    3. 忽略 AI 历史回复中的元数据，只关注当前代码和用户意图。"""},
     {"role": "user", "content": user_content}
 ]
 
-# 工具定义
 tools = [
-    {"type": "function", "function": {"name": "list_directory", "parameters": {"type": "object", "properties": {"path": {"type": "string"}}}}},
-    {"type": "function", "function": {"name": "read_file", "parameters": {"type": "object", "properties": {"path": {"type": "string"}}}}},
-    {"type": "function", "function": {"name": "search_keyword", "parameters": {"type": "object", "properties": {"keyword": {"type": "string"}}}}}
+    {"type": "function", "function": {"name": "list_directory", "description": "List files", "parameters": {"type": "object", "properties": {"path": {"type": "string"}}}}},
+    {"type": "function", "function": {"name": "read_file", "description": "Read content", "parameters": {"type": "object", "properties": {"path": {"type": "string"}}}}},
+    {"type": "function", "function": {"name": "search_keyword", "description": "Search keyword", "parameters": {"type": "object", "properties": {"keyword": {"type": "string"}}}}}
 ]
 
-# AI 决策循环 (允许最多 3 次工具调用)
+# 允许 3 次交互以获取足够信息
 for _ in range(3):
     response = client.chat.completions.create(
         model=os.getenv("AI_MODEL"),
         messages=messages,
-        tools=tools
+        tools=tools,
+        temperature=0
     )
     msg = response.choices[0].message
     messages.append(msg)
@@ -109,32 +113,35 @@ for _ in range(3):
         break
         
     for tool_call in msg.tool_calls:
-        func_name = tool_call.function.name
-        args = json.loads(tool_call.function.arguments)
+        fn_name = tool_call.function.name
+        fn_args = json.loads(tool_call.function.arguments)
         
-        if func_name == "list_directory": result = list_directory(**args)
-        elif func_name == "read_file": result = read_file(**args)
-        elif func_name == "search_keyword": result = search_keyword(**args)
+        # 映射函数映射表
+        available_functions = {
+            "list_directory": list_directory,
+            "read_file": read_file,
+            "search_keyword": search_keyword,
+        }
         
-        messages.append({"role": "tool", "tool_call_id": tool_call.id, "content": result})
-
-# 解析结果并操作 GitHub
-final_text = messages[-1].content
-json_part = {}
-try:
-    if final_text.startswith("{"):
-        import re
-        match = re.search(r'(\{.*?\})', final_text, re.DOTALL)
-        if match:
-            json_part = json.loads(match.group(1))
-            final_text = final_text.replace(match.group(1), "").strip()
-except:
-    pass
-
-# 执行 GitHub 动作
-if json_part.get("labels"):
-    issue_obj.add_to_labels(*json_part["labels"])
-if json_part.get("state"):
-    issue_obj.edit(state=json_part["state"])
-
-issue_obj.create_comment(f"### 🤖 AI Agent Action\n\n{final_text}")
+        if fn_name in available_functions:
+            result = available_functions[fn_name](**fn_args)
+            messages.append({"role": "tool", "tool_call_id": tool_call.id, "content": result})
+
+# 5. 解析并执行 GitHub 操作
+final_res = messages[-1].content
+json_data = {"labels": [], "state": "open"}
+
+# 提取 JSON 块
+match = re.search(r'(\{.*?\})', final_res, re.DOTALL)
+if match:
+    try:
+        json_data = json.loads(match.group(1))
+        final_res = final_res.replace(match.group(1), "").strip()
+    except: pass
+
+if json_data.get("labels"):
+    issue_obj.add_to_labels(*json_data["labels"])
+if json_data.get("state") and json_data["state"] in ["open", "closed"]:
+    issue_obj.edit(state=json_data["state"])
+
+issue_obj.create_comment(f"### 🤖 AI Agent Execution\n\n{final_res}")

hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/.github/workflows/ai-review.yaml

@@ -1,4 +1,4 @@
-name: AI Repository Assistant
+name: AI Repository Agent (Python Tools)
 
 on:
   pull_request:
@@ -9,11 +9,11 @@ on:
     types: [created]
 
 jobs:
-  ai-assistant:
+  ai-agent:
     if: |
       github.event_name == 'pull_request' || 
       github.event_name == 'issues' || 
-      startsWith(github.event.comment.body, '[use-ai]')
+      (github.event_name == 'issue_comment' && startsWith(github.event.comment.body, '[use-ai]'))
     runs-on: ubuntu-latest
     permissions:
       contents: read
@@ -23,120 +23,24 @@ jobs:
     steps:
       - name: Checkout Code
         uses: actions/checkout@v4
-
-      - name: Prepare Context
-        id: prep
-        run: |
-          # 提取基本信息
-          ISSUE_AUTHOR="${{ github.event.issue.user.login || github.event.pull_request.user.login }}"
-          CURRENT_ACTOR="${{ github.actor }}"
-          
-          echo "### METADATA ###" > content.txt
-          echo "Issue/PR Author: @$ISSUE_AUTHOR" >> content.txt
-          echo "Instruction triggered by: @$CURRENT_ACTOR" >> content.txt
-          echo "Assistant Identity: @github-actions[bot]" >> content.txt
-          echo -e "------------------\n" >> content.txt
-
-          if [ "${{ github.event_name }}" == "issue_comment" ]; then
-            echo "### NEW COMMAND FROM @$CURRENT_ACTOR ###" >> content.txt
-            echo "Comment: ${{ github.event.comment.body }}" >> content.txt
-            echo -e "\n### ORIGINAL CONTEXT ###" >> content.txt
-            echo "Title: ${{ github.event.issue.title }}" >> content.txt
-            echo "Description: ${{ github.event.issue.body }}" >> content.txt
-          elif [ "${{ github.event_name }}" == "pull_request" ]; then
-            echo "### NEW PULL REQUEST FROM @$ISSUE_AUTHOR ###" >> content.txt
-            git fetch origin ${{ github.event.pull_request.base.ref }}
-            git diff origin/${{ github.event.pull_request.base.ref }}...HEAD > pr_diff.txt
-            cat pr_diff.txt >> content.txt
-          else
-            echo "### NEW ISSUE FROM @$ISSUE_AUTHOR ###" >> content.txt
-            echo "Title: ${{ github.event.issue.title }}" >> content.txt
-            echo "Body: ${{ github.event.issue.body }}" >> content.txt
-          fi
-
-          echo "number=${{ github.event.issue.number || github.event.pull_request.number }}" >> $GITHUB_OUTPUT
-          echo "type=${{ github.event_name }}" >> $GITHUB_OUTPUT
-
-      - name: AI Action Execution
-        uses: actions/github-script@v7
-        env:
-          API_KEY: ${{ secrets.OPENAI_API_KEY }}
-          BASE_URL: ${{ secrets.OPENAI_BASE_URL }}
-          MODEL: ${{ secrets.AI_MODEL }}
-          ISSUE_NUMBER: ${{ steps.prep.outputs.number }}
         with:
-          script: |
-            const fs = require('fs');
-            const content = fs.readFileSync('content.txt', 'utf8');
-
-            const { data: repoLabels } = await github.rest.issues.listLabelsForRepo({
-              owner: context.repo.owner,
-              repo: context.repo.repo,
-            });
-            const labelNames = repoLabels.map(l => l.name);
-
-            const prompt = `你是一个拥有自主权的仓库助手 (@github-actions[bot])。
-            你需要根据提供的【METADATA】区分对话中的不同角色。
-            
-            角色指南：
-            1. Issue/PR Author: 任务的发起者。
-            2. Instruction triggered by: 当前向你下达指令的人。如果是 Author 且内容包含 "[use-ai]"，说明他在请求你介入。
-            3. Assistant Identity: 这是你自己。请不要审视或评价你自己的历史回复。
-
-            你的权力：
-            - 根据 Issue 内容的质量自动打标签（可选：${labelNames.join(", ")}）。
-            - 如果内容是无意义的测试、违反规范或已解决，请直接关闭它。
-            - 你的语气应该是果断的执行者，而不是卑微的助理。
-
-            输出要求（严格 JSON 第一行）：
-            {"labels": ["label_name"], "state": "closed" | "open"}
-            然后另起一行说明你的处理逻辑。`;
+          fetch-depth: 0
 
-            try {
-              const response = await fetch(`${process.env.BASE_URL}/chat/completions`, {
-                method: 'POST',
-                headers: { 'Authorization': `Bearer ${process.env.API_KEY}`, 'Content-Type': 'application/json' },
-                body: JSON.stringify({
-                  model: process.env.MODEL,
-                  messages: [{ role: "user", content: prompt + "\n\n内容如下：\n" + content }],
-                  temperature: 0.1 // 降低随机性，增强逻辑判断
-                })
-              });
-
-              const data = await response.json();
-              const fullText = data.choices[0].message.content;
-
-              const jsonMatch = fullText.match(/^\{.*?\}/);
-              let config = { labels: [], state: "open" };
-              let commentBody = fullText;
-
-              if (jsonMatch) {
-                config = JSON.parse(jsonMatch[0]);
-                commentBody = fullText.replace(jsonMatch[0], "").trim();
-              }
-
-              const issueParams = {
-                owner: context.repo.owner,
-                repo: context.repo.repo,
-                issue_number: parseInt(process.env.ISSUE_NUMBER)
-              };
-
-              // 执行打标签
-              if (config.labels && config.labels.length > 0) {
-                await github.rest.issues.addLabels({ ...issueParams, labels: config.labels });
-              }
-
-              // 执行状态变更
-              if (config.state) {
-                await github.rest.issues.update({ ...issueParams, state: config.state });
-              }
+      - name: Set up Python
+        uses: actions/setup-python@v4
+        with:
+          python-version: '3.10'
 
-              // 发表回复
-              await github.rest.issues.createComment({
-                ...issueParams,
-                body: `### 🤖 AI Assistant Action\n\n${commentBody}`
-              });
+      - name: Install Dependencies
+        run: |
+          pip install openai PyGithub
 
-            } catch (err) {
-              core.setFailed(err.message);
-            }
+      - name: Run AI Agent
+        env:
+          OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
+          OPENAI_BASE_URL: ${{ secrets.OPENAI_BASE_URL }}
+          AI_MODEL: ${{ secrets.AI_MODEL }}
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          EVENT_CONTEXT: ${{ toJson(github.event) }}
+          EVENT_NAME: ${{ github.event_name }}
+        run: python .github/scripts/ai_agent.py

hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/.github/scripts/ai_agent.py

@@ -0,0 +1,140 @@
+import os
+import json
+import base64
+from openai import OpenAI
+from github import Github
+
+# 初始化客户端
+client = OpenAI(api_key=os.getenv("OPENAI_API_KEY"), base_url=os.getenv("OPENAI_BASE_URL"))
+gh = Github(os.getenv("GITHUB_TOKEN"))
+repo = gh.get_repo(os.getenv("GITHUB_REPOSITORY"))
+event_data = json.loads(os.getenv("EVENT_CONTEXT"))
+event_name = os.getenv("EVENT_NAME")
+
+# --- 定义 AI 可调用的工具 ---
+
+def list_directory(path="."):
+    """列出指定目录下的文件和文件夹"""
+    try:
+        items = os.listdir(path)
+        return "\n".join(items)
+    except Exception as e:
+        return str(e)
+
+def read_file(path):
+    """读取特定文件的完整内容"""
+    try:
+        with open(path, 'r', encoding='utf-8') as f:
+            return f.read()[:5000] # 限制长度防止 Over-token
+    except Exception as e:
+        return str(e)
+
+def search_keyword(keyword, path="."):
+    """在当前目录及其子目录中搜索关键词"""
+    results = []
+    for root, dirs, files in os.walk(path):
+        for file in files:
+            if file.endswith(('.py', '.js', '.ts', '.md', '.json', '.rs')):
+                full_path = os.path.join(root, file)
+                try:
+                    with open(full_path, 'r', encoding='utf-8') as f:
+                        if keyword in f.read():
+                            results.append(full_path)
+                except:
+                    continue
+    return "\n".join(results[:20])
+
+# --- 准备上下文与角色 ---
+
+def get_context():
+    if event_name == "pull_request":
+        number = event_data["pull_request"]["number"]
+        author = event_data["pull_request"]["user"]["login"]
+        title = event_data["pull_request"]["title"]
+        body = event_data["pull_request"]["body"]
+        return number, f"PR Author: @{author}\nTitle: {title}\nBody: {body}\n(This is a Pull Request)"
+    
+    number = event_data["issue"]["number"]
+    author = event_data["issue"]["user"]["login"]
+    title = event_data["issue"]["title"]
+    body = event_data["issue"]["body"]
+    
+    if event_name == "issue_comment":
+        actor = event_data["comment"]["user"]["login"]
+        cmd = event_data["comment"]["body"]
+        return number, f"Issue Author: @{author}\nTriggered by: @{actor}\nCommand: {cmd}\nContext: {title}\n{body}"
+    
+    return number, f"Issue Author: @{author}\nTitle: {title}\nBody: {body}"
+
+issue_num, user_content = get_context()
+issue_obj = repo.get_issue(number=issue_num)
+repo_labels = [l.name for l in repo.get_labels()]
+
+# --- 主逻辑 ---
+
+messages = [
+    {"role": "system", "content": f"""你是一个高级仓库助手 (@github-actions[bot])。
+    你可以通过工具阅读代码、搜索文件并管理 Issue/PR 状态。
+    
+    可用标签: {repo_labels}
+    你的目标: 
+    1. 理解用户意图。
+    2. 如果需要，使用工具查看项目结构或具体文件。
+    3. 给出处理方案，并直接执行（打标签、关闭等）。
+    
+    输出规范:
+    回复开头必须是 JSON 指令: {{"labels": [], "state": "open"|"closed"}}
+    然后是你的执行报告。"""},
+    {"role": "user", "content": user_content}
+]
+
+# 工具定义
+tools = [
+    {"type": "function", "function": {"name": "list_directory", "parameters": {"type": "object", "properties": {"path": {"type": "string"}}}}},
+    {"type": "function", "function": {"name": "read_file", "parameters": {"type": "object", "properties": {"path": {"type": "string"}}}}},
+    {"type": "function", "function": {"name": "search_keyword", "parameters": {"type": "object", "properties": {"keyword": {"type": "string"}}}}}
+]
+
+# AI 决策循环 (允许最多 3 次工具调用)
+for _ in range(3):
+    response = client.chat.completions.create(
+        model=os.getenv("AI_MODEL"),
+        messages=messages,
+        tools=tools
+    )
+    msg = response.choices[0].message
+    messages.append(msg)
+    
+    if not msg.tool_calls:
+        break
+        
+    for tool_call in msg.tool_calls:
+        func_name = tool_call.function.name
+        args = json.loads(tool_call.function.arguments)
+        
+        if func_name == "list_directory": result = list_directory(**args)
+        elif func_name == "read_file": result = read_file(**args)
+        elif func_name == "search_keyword": result = search_keyword(**args)
+        
+        messages.append({"role": "tool", "tool_call_id": tool_call.id, "content": result})
+
+# 解析结果并操作 GitHub
+final_text = messages[-1].content
+json_part = {}
+try:
+    if final_text.startswith("{"):
+        import re
+        match = re.search(r'(\{.*?\})', final_text, re.DOTALL)
+        if match:
+            json_part = json.loads(match.group(1))
+            final_text = final_text.replace(match.group(1), "").strip()
+except:
+    pass
+
+# 执行 GitHub 动作
+if json_part.get("labels"):
+    issue_obj.add_to_labels(*json_part["labels"])
+if json_part.get("state"):
+    issue_obj.edit(state=json_part["state"])
+
+issue_obj.create_comment(f"### 🤖 AI Agent Action\n\n{final_text}")

hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/.github/workflows/ai-review.yaml

@@ -1,4 +1,4 @@
-name: AI Repository Assistant (Role-Aware)
+name: AI Repository Assistant
 
 on:
   pull_request:

hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/.github/workflows/ai-review.yaml

@@ -1,4 +1,4 @@
-name: AI Repository Assistant
+name: AI Repository Assistant (Role-Aware)
 
 on:
   pull_request:
@@ -6,11 +6,10 @@ on:
   issues:
     types: [opened]
   issue_comment:
-    types: [created] # 支持通过评论触发
+    types: [created]
 
 jobs:
   ai-assistant:
-    # 仅在：1. 新开 PR/Issue 2. 评论以 [use-ai] 开头时运行
     if: |
       github.event_name == 'pull_request' || 
       github.event_name == 'issues' || 
@@ -28,25 +27,35 @@ jobs:
       - name: Prepare Context
         id: prep
         run: |
-          # 判断是 PR 还是 Issue
-          if [ "${{ github.event.pull_request }}" != "" ]; then
-            EVENT_TYPE="PR"
-            ISSUE_NUMBER="${{ github.event.pull_request.number }}"
+          # 提取基本信息
+          ISSUE_AUTHOR="${{ github.event.issue.user.login || github.event.pull_request.user.login }}"
+          CURRENT_ACTOR="${{ github.actor }}"
+          
+          echo "### METADATA ###" > content.txt
+          echo "Issue/PR Author: @$ISSUE_AUTHOR" >> content.txt
+          echo "Instruction triggered by: @$CURRENT_ACTOR" >> content.txt
+          echo "Assistant Identity: @github-actions[bot]" >> content.txt
+          echo -e "------------------\n" >> content.txt
+
+          if [ "${{ github.event_name }}" == "issue_comment" ]; then
+            echo "### NEW COMMAND FROM @$CURRENT_ACTOR ###" >> content.txt
+            echo "Comment: ${{ github.event.comment.body }}" >> content.txt
+            echo -e "\n### ORIGINAL CONTEXT ###" >> content.txt
+            echo "Title: ${{ github.event.issue.title }}" >> content.txt
+            echo "Description: ${{ github.event.issue.body }}" >> content.txt
+          elif [ "${{ github.event_name }}" == "pull_request" ]; then
+            echo "### NEW PULL REQUEST FROM @$ISSUE_AUTHOR ###" >> content.txt
             git fetch origin ${{ github.event.pull_request.base.ref }}
-            git diff origin/${{ github.event.pull_request.base.ref }}...HEAD > content.txt
+            git diff origin/${{ github.event.pull_request.base.ref }}...HEAD > pr_diff.txt
+            cat pr_diff.txt >> content.txt
           else
-            EVENT_TYPE="Issue"
-            ISSUE_NUMBER="${{ github.event.issue.number }}"
-            # 如果是评论触发，获取评论内容作为补充指令
-            if [ "${{ github.event_name }}" == "issue_comment" ]; then
-              echo "Command: ${{ github.event.comment.body }}" > content.txt
-              echo -e "\nOriginal Content:\n${{ github.event.issue.title }}\n${{ github.event.issue.body }}" >> content.txt
-            else
-              echo -e "Title: ${{ github.event.issue.title }}\n\n${{ github.event.issue.body }}" > content.txt
-            fi
+            echo "### NEW ISSUE FROM @$ISSUE_AUTHOR ###" >> content.txt
+            echo "Title: ${{ github.event.issue.title }}" >> content.txt
+            echo "Body: ${{ github.event.issue.body }}" >> content.txt
           fi
-          echo "type=$EVENT_TYPE" >> $GITHUB_OUTPUT
-          echo "number=$ISSUE_NUMBER" >> $GITHUB_OUTPUT
+
+          echo "number=${{ github.event.issue.number || github.event.pull_request.number }}" >> $GITHUB_OUTPUT
+          echo "type=${{ github.event_name }}" >> $GITHUB_OUTPUT
 
       - name: AI Action Execution
         uses: actions/github-script@v7
@@ -54,35 +63,34 @@ jobs:
           API_KEY: ${{ secrets.OPENAI_API_KEY }}
           BASE_URL: ${{ secrets.OPENAI_BASE_URL }}
           MODEL: ${{ secrets.AI_MODEL }}
-          EVENT_TYPE: ${{ steps.prep.outputs.type }}
           ISSUE_NUMBER: ${{ steps.prep.outputs.number }}
         with:
           script: |
             const fs = require('fs');
             const content = fs.readFileSync('content.txt', 'utf8');
 
-            // 1. 获取现有 Labels
             const { data: repoLabels } = await github.rest.issues.listLabelsForRepo({
               owner: context.repo.owner,
               repo: context.repo.repo,
             });
             const labelNames = repoLabels.map(l => l.name);
 
-            // 2. 角色设定：从“建议者”转变为“执行者”
-            const prompt = `你是一个自动化的仓库助手。你被授权管理该仓库的 Issues 和 PR。
-            你的任务：分析内容，打上标签，并决定是否关闭或保持开启。
-            
-            仓库现有标签：[${labelNames.join(", ")}]。
-            
-            输出要求：
-            必须在回复的第一行输出 JSON 格式的操作指令：
-            {"labels": ["label1"], "state": "closed" | "open"}
+            const prompt = `你是一个拥有自主权的仓库助手 (@github-actions[bot])。
+            你需要根据提供的【METADATA】区分对话中的不同角色。
             
-            随后另起一行，以助手的身份简洁地说明你执行的操作和理由。不要说“我建议”，要说“我已执行”。
-            
-            当前环境：${process.env.EVENT_TYPE}
-            内容详情：
-            ${content}`;
+            角���指南：
+            1. Issue/PR Author: 任务的发起者。
+            2. Instruction triggered by: 当前向你下达指令的人。如果是 Author 且内容包含 "[use-ai]"，说明他在请求你介入。
+            3. Assistant Identity: 这是你自己。请不要审视或评价你自己的历史回复。
+
+            你的权力：
+            - 根据 Issue 内容的质量自动打标签（可选：${labelNames.join(", ")}）。
+            - 如果内容是无意义的测试、违反规范或已解决，请直接关闭它。
+            - 你的语气应该是果断的执行者，而不是卑微的助理。
+
+            输出要求（严格 JSON 第一行）：
+            {"labels": ["label_name"], "state": "closed" | "open"}
+            然后另起一行说明你的处理逻辑。`;
 
             try {
               const response = await fetch(`${process.env.BASE_URL}/chat/completions`, {
@@ -90,15 +98,14 @@ jobs:
                 headers: { 'Authorization': `Bearer ${process.env.API_KEY}`, 'Content-Type': 'application/json' },
                 body: JSON.stringify({
                   model: process.env.MODEL,
-                  messages: [{ role: "user", content: prompt }],
-                  temperature: 0.2
+                  messages: [{ role: "user", content: prompt + "\n\n内容如下：\n" + content }],
+                  temperature: 0.1 // 降低随机性，增强逻辑判断
                 })
               });
 
               const data = await response.json();
               const fullText = data.choices[0].message.content;
 
-              // 3. 解析指令
               const jsonMatch = fullText.match(/^\{.*?\}/);
               let config = { labels: [], state: "open" };
               let commentBody = fullText;
@@ -114,23 +121,22 @@ jobs:
                 issue_number: parseInt(process.env.ISSUE_NUMBER)
               };
 
-              // 4. 执行操作：打标签
+              // 执行打标签
               if (config.labels && config.labels.length > 0) {
                 await github.rest.issues.addLabels({ ...issueParams, labels: config.labels });
               }
 
-              // 5. 执行操作：修改状态 (Close/Reopen)
+              // 执行状态变更
               if (config.state) {
                 await github.rest.issues.update({ ...issueParams, state: config.state });
               }
 
-              // 6. 发布执行报告
+              // 发表回复
               await github.rest.issues.createComment({
                 ...issueParams,
                 body: `### 🤖 AI Assistant Action\n\n${commentBody}`
               });
 
             } catch (err) {
-              console.error(err);
               core.setFailed(err.message);
             }

hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/.github/workflows/ai-review.yaml

@@ -1,13 +1,20 @@
-name: AI PR & Issue Assistant with Auto-Label
+name: AI Repository Assistant
 
 on:
   pull_request:
-    types: [opened, synchronize]
+    types: [opened]
   issues:
     types: [opened]
+  issue_comment:
+    types: [created] # 支持通过评论触发
 
 jobs:
   ai-assistant:
+    # 仅在：1. 新开 PR/Issue 2. 评论以 [use-ai] 开头时运行
+    if: |
+      github.event_name == 'pull_request' || 
+      github.event_name == 'issues' || 
+      startsWith(github.event.comment.body, '[use-ai]')
     runs-on: ubuntu-latest
     permissions:
       contents: read
@@ -21,18 +28,27 @@ jobs:
       - name: Prepare Context
         id: prep
         run: |
-          if [ "${{ github.event_name }}" == "pull_request" ]; then
-            git fetch origin ${{ github.base_ref }}
-            git diff origin/${{ github.base_ref }}...HEAD > input_content.txt
-            echo "type=PR" >> $GITHUB_OUTPUT
-            echo "number=${{ github.event.pull_request.number }}" >> $GITHUB_OUTPUT
+          # 判断是 PR 还是 Issue
+          if [ "${{ github.event.pull_request }}" != "" ]; then
+            EVENT_TYPE="PR"
+            ISSUE_NUMBER="${{ github.event.pull_request.number }}"
+            git fetch origin ${{ github.event.pull_request.base.ref }}
+            git diff origin/${{ github.event.pull_request.base.ref }}...HEAD > content.txt
           else
-            echo -e "Title: ${{ github.event.issue.title }}\n\n${{ github.event.issue.body }}" > input_content.txt
-            echo "type=Issue" >> $GITHUB_OUTPUT
-            echo "number=${{ github.event.issue.number }}" >> $GITHUB_OUTPUT
+            EVENT_TYPE="Issue"
+            ISSUE_NUMBER="${{ github.event.issue.number }}"
+            # 如果是评论触发，获取评论内容作为补充指令
+            if [ "${{ github.event_name }}" == "issue_comment" ]; then
+              echo "Command: ${{ github.event.comment.body }}" > content.txt
+              echo -e "\nOriginal Content:\n${{ github.event.issue.title }}\n${{ github.event.issue.body }}" >> content.txt
+            else
+              echo -e "Title: ${{ github.event.issue.title }}\n\n${{ github.event.issue.body }}" > content.txt
+            fi
           fi
+          echo "type=$EVENT_TYPE" >> $GITHUB_OUTPUT
+          echo "number=$ISSUE_NUMBER" >> $GITHUB_OUTPUT
 
-      - name: AI Processing & Labeling
+      - name: AI Action Execution
         uses: actions/github-script@v7
         env:
           API_KEY: ${{ secrets.OPENAI_API_KEY }}
@@ -40,42 +56,38 @@ jobs:
           MODEL: ${{ secrets.AI_MODEL }}
           EVENT_TYPE: ${{ steps.prep.outputs.type }}
           ISSUE_NUMBER: ${{ steps.prep.outputs.number }}
-          ENABLE_AUTO_LABEL: "true" # 设置为 "false" 则彻底关闭自动打标签功能
         with:
           script: |
             const fs = require('fs');
-            const content = fs.readFileSync('input_content.txt', 'utf8');
-            if (!content.trim()) return;
+            const content = fs.readFileSync('content.txt', 'utf8');
 
-            // 1. 获取仓库现有的所有 Labels
+            // 1. 获取现有 Labels
             const { data: repoLabels } = await github.rest.issues.listLabelsForRepo({
               owner: context.repo.owner,
               repo: context.repo.repo,
             });
             const labelNames = repoLabels.map(l => l.name);
 
-            // 2. 构建针对标签的 Prompt 
-            let labelInstruction = "";
-            if (process.env.ENABLE_AUTO_LABEL === "true") {
-              labelInstruction = `
-            请从以下现有的标签列表中选择最合适的标签（可多选），仅从列表中选择：[${labelNames.join(", ")}]。
-            如果你认为不需要打标签，请返回空数组。
-            请在回复的最开头以 JSON 格式输出你的选择，格式如下：
-            {"suggested_labels": ["label1", "label2"]}
-            然后另起一行开始你的评论分析。`;
-            }
-
-            const prompt = process.env.EVENT_TYPE === 'PR' 
-              ? `你是一位资深工程师。请审查以下 PR 的代码改动，指出潜在 Bug 和改进点。${labelInstruction}\n\nDiff内容：\n${content}`
-              : `你是一位开源项目维护者。请分析以下 Issue 并给出建议。${labelInstruction}\n\nIssue内容：\n${content}`;
+            // 2. 角色设定：从“建议者”转变为“执行者”
+            const prompt = `你是一个自动化的仓库助手。你被授权管理该仓库的 Issues 和 PR。
+            你的任务：分析内容，打上标签，并决定是否关闭或保持开启。
+            
+            仓库现有标签：[${labelNames.join(", ")}]。
+            
+            输出要求：
+            必须在回复的第一行输出 JSON 格式的操作指令：
+            {"labels": ["label1"], "state": "closed" | "open"}
+            
+            随后另起一行，以助手的身份简洁地说明你执行的操作和理由。不要说“我建议”，要说“我已执行”。
+            
+            当前环境：${process.env.EVENT_TYPE}
+            内容详情：
+            ${content}`;
 
             try {
               const response = await fetch(`${process.env.BASE_URL}/chat/completions`, {
                 method: 'POST',
-                headers: {
-                  'Authorization': `Bearer ${process.env.API_KEY}`,
-                  'Content-Type': 'application/json'
-                },
+                headers: { 'Authorization': `Bearer ${process.env.API_KEY}`, 'Content-Type': 'application/json' },
                 body: JSON.stringify({
                   model: process.env.MODEL,
                   messages: [{ role: "user", content: prompt }],
@@ -86,40 +98,39 @@ jobs:
               const data = await response.json();
               const fullText = data.choices[0].message.content;
 
-              // 3. 解析标签和正文
+              // 3. 解析指令
+              const jsonMatch = fullText.match(/^\{.*?\}/);
+              let config = { labels: [], state: "open" };
               let commentBody = fullText;
-              let labelsToAdd = [];
-
-              if (process.env.ENABLE_AUTO_LABEL === "true") {
-                const jsonMatch = fullText.match(/^\{.*?\}/); // 匹配开头的 JSON
-                if (jsonMatch) {
-                  try {
-                    const labelData = JSON.parse(jsonMatch[0]);
-                    labelsToAdd = labelData.suggested_labels || [];
-                    commentBody = fullText.replace(jsonMatch[0], "").trim();
-                  } catch (e) {
-                    console.log("Failed to parse labels JSON");
-                  }
-                }
+
+              if (jsonMatch) {
+                config = JSON.parse(jsonMatch[0]);
+                commentBody = fullText.replace(jsonMatch[0], "").trim();
               }
 
-              // 4. 发布评论
-              await github.rest.issues.createComment({
+              const issueParams = {
                 owner: context.repo.owner,
                 repo: context.repo.repo,
-                issue_number: parseInt(process.env.ISSUE_NUMBER),
-                body: `### 🤖 AI ${process.env.EVENT_TYPE === 'PR' ? 'Review' : 'Assistant'}\n\n${commentBody}`
-              });
+                issue_number: parseInt(process.env.ISSUE_NUMBER)
+              };
 
-              // 5. 自动打标签（如果有建议的标签）
-              if (labelsToAdd.length > 0) {
-                await github.rest.issues.addLabels({
-                  owner: context.repo.owner,
-                  repo: context.repo.repo,
-                  issue_number: parseInt(process.env.ISSUE_NUMBER),
-                  labels: labelsToAdd
-                });
+              // 4. 执行操作：打标签
+              if (config.labels && config.labels.length > 0) {
+                await github.rest.issues.addLabels({ ...issueParams, labels: config.labels });
               }
+
+              // 5. 执行操作：修改状态 (Close/Reopen)
+              if (config.state) {
+                await github.rest.issues.update({ ...issueParams, state: config.state });
+              }
+
+              // 6. 发布执行报告
+              await github.rest.issues.createComment({
+                ...issueParams,
+                body: `### 🤖 AI Assistant Action\n\n${commentBody}`
+              });
+
             } catch (err) {
+              console.error(err);
               core.setFailed(err.message);
             }

hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/.github/workflows/ai-review.yaml

@@ -1,10 +1,10 @@
-name: AI PR & Issue Helper
+name: AI PR & Issue Assistant with Auto-Label
 
 on:
   pull_request:
     types: [opened, synchronize]
   issues:
-    types: [opened] # 当新 Issue 创建时触发
+    types: [opened]
 
 jobs:
   ai-assistant:
@@ -17,37 +17,57 @@ jobs:
     steps:
       - name: Checkout Code
         uses: actions/checkout@v4
-        with:
-          fetch-depth: 0
 
       - name: Prepare Context
         id: prep
         run: |
           if [ "${{ github.event_name }}" == "pull_request" ]; then
-            git diff origin/${{ github.base_ref }}...origin/${{ github.head_ref }} > input_content.txt
+            git fetch origin ${{ github.base_ref }}
+            git diff origin/${{ github.base_ref }}...HEAD > input_content.txt
             echo "type=PR" >> $GITHUB_OUTPUT
+            echo "number=${{ github.event.pull_request.number }}" >> $GITHUB_OUTPUT
           else
-            echo "${{ github.event.issue.title }}\n\n${{ github.event.issue.body }}" > input_content.txt
+            echo -e "Title: ${{ github.event.issue.title }}\n\n${{ github.event.issue.body }}" > input_content.txt
             echo "type=Issue" >> $GITHUB_OUTPUT
+            echo "number=${{ github.event.issue.number }}" >> $GITHUB_OUTPUT
           fi
 
-      - name: AI Processing
+      - name: AI Processing & Labeling
         uses: actions/github-script@v7
         env:
           API_KEY: ${{ secrets.OPENAI_API_KEY }}
           BASE_URL: ${{ secrets.OPENAI_BASE_URL }}
           MODEL: ${{ secrets.AI_MODEL }}
           EVENT_TYPE: ${{ steps.prep.outputs.type }}
+          ISSUE_NUMBER: ${{ steps.prep.outputs.number }}
+          ENABLE_AUTO_LABEL: "true" # 设置为 "false" 则彻底关闭自动打标签功能
         with:
           script: |
             const fs = require('fs');
             const content = fs.readFileSync('input_content.txt', 'utf8');
             if (!content.trim()) return;
 
-            // 根据类型定制 Prompt
+            // 1. 获取仓库现有的所有 Labels
+            const { data: repoLabels } = await github.rest.issues.listLabelsForRepo({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+            });
+            const labelNames = repoLabels.map(l => l.name);
+
+            // 2. 构建针对标签的 Prompt 
+            let labelInstruction = "";
+            if (process.env.ENABLE_AUTO_LABEL === "true") {
+              labelInstruction = `
+            请从以下现有的标签列表中选择最合适的标签（可多选），仅从列表中选择：[${labelNames.join(", ")}]。
+            如果你认为不需要打标签，请返回空数组。
+            请在回复的最开头以 JSON 格式输出你的选择，格式如下：
+            {"suggested_labels": ["label1", "label2"]}
+            然后另起一行开始你的评论分析。`;
+            }
+
             const prompt = process.env.EVENT_TYPE === 'PR' 
-              ? `你是一位资深工程师。请审查以下 PR 的代码改动，指出潜在 Bug 和改进点：\n\n${content}`
-              : `你是一位开源项目维护者。请分析以下 Issue 并给出建议或解决方案：\n\n${content}`;
+              ? `你是一位资深工程师。请审查以下 PR 的代码改动，指出潜在 Bug 和改进点。${labelInstruction}\n\nDiff内容：\n${content}`
+              : `你是一位开源项目维护者。请分析以下 Issue 并给出建议。${labelInstruction}\n\nIssue内容：\n${content}`;
 
             try {
               const response = await fetch(`${process.env.BASE_URL}/chat/completions`, {
@@ -59,27 +79,45 @@ jobs:
                 body: JSON.stringify({
                   model: process.env.MODEL,
                   messages: [{ role: "user", content: prompt }],
-                  temperature: 0.3
+                  temperature: 0.2
                 })
               });
 
               const data = await response.json();
-              const result = data.choices[0].message.content;
-              const header = process.env.EVENT_TYPE === 'PR' ? "### 🤖 AI Code Review" : "### 🤖 AI Issue Assistant";
+              const fullText = data.choices[0].message.content;
 
-              if (process.env.EVENT_TYPE === 'PR') {
-                await github.rest.issues.createComment({
-                  owner: context.repo.owner,
-                  repo: context.repo.repo,
-                  issue_number: context.payload.pull_request.number,
-                  body: `${header}\n\n${result}`
-                });
-              } else {
-                await github.rest.issues.createComment({
+              // 3. 解析标签和正文
+              let commentBody = fullText;
+              let labelsToAdd = [];
+
+              if (process.env.ENABLE_AUTO_LABEL === "true") {
+                const jsonMatch = fullText.match(/^\{.*?\}/); // 匹配开头的 JSON
+                if (jsonMatch) {
+                  try {
+                    const labelData = JSON.parse(jsonMatch[0]);
+                    labelsToAdd = labelData.suggested_labels || [];
+                    commentBody = fullText.replace(jsonMatch[0], "").trim();
+                  } catch (e) {
+                    console.log("Failed to parse labels JSON");
+                  }
+                }
+              }
+
+              // 4. 发布评论
+              await github.rest.issues.createComment({
+                owner: context.repo.owner,
+                repo: context.repo.repo,
+                issue_number: parseInt(process.env.ISSUE_NUMBER),
+                body: `### 🤖 AI ${process.env.EVENT_TYPE === 'PR' ? 'Review' : 'Assistant'}\n\n${commentBody}`
+              });
+
+              // 5. 自动打标签（如果有建议的标签）
+              if (labelsToAdd.length > 0) {
+                await github.rest.issues.addLabels({
                   owner: context.repo.owner,
                   repo: context.repo.repo,
-                  issue_number: context.payload.issue.number,
-                  body: `${header}\n\n${result}`
+                  issue_number: parseInt(process.env.ISSUE_NUMBER),
+                  labels: labelsToAdd
                 });
               }
             } catch (err) {

hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/.github/workflows/ai-review.yaml

@@ -0,0 +1,87 @@
+name: AI PR & Issue Helper
+
+on:
+  pull_request:
+    types: [opened, synchronize]
+  issues:
+    types: [opened] # 当新 Issue 创建时触发
+
+jobs:
+  ai-assistant:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pull-requests: write
+      issues: write
+
+    steps:
+      - name: Checkout Code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Prepare Context
+        id: prep
+        run: |
+          if [ "${{ github.event_name }}" == "pull_request" ]; then
+            git diff origin/${{ github.base_ref }}...origin/${{ github.head_ref }} > input_content.txt
+            echo "type=PR" >> $GITHUB_OUTPUT
+          else
+            echo "${{ github.event.issue.title }}\n\n${{ github.event.issue.body }}" > input_content.txt
+            echo "type=Issue" >> $GITHUB_OUTPUT
+          fi
+
+      - name: AI Processing
+        uses: actions/github-script@v7
+        env:
+          API_KEY: ${{ secrets.OPENAI_API_KEY }}
+          BASE_URL: ${{ secrets.OPENAI_BASE_URL }}
+          MODEL: ${{ secrets.AI_MODEL }}
+          EVENT_TYPE: ${{ steps.prep.outputs.type }}
+        with:
+          script: |
+            const fs = require('fs');
+            const content = fs.readFileSync('input_content.txt', 'utf8');
+            if (!content.trim()) return;
+
+            // 根据类型定制 Prompt
+            const prompt = process.env.EVENT_TYPE === 'PR' 
+              ? `你是一位资深工程师。请审查以下 PR 的代码改动，指出潜在 Bug 和改进点：\n\n${content}`
+              : `你是一位开源项目维护者。请分析以下 Issue 并给出建议或解决方案：\n\n${content}`;
+
+            try {
+              const response = await fetch(`${process.env.BASE_URL}/chat/completions`, {
+                method: 'POST',
+                headers: {
+                  'Authorization': `Bearer ${process.env.API_KEY}`,
+                  'Content-Type': 'application/json'
+                },
+                body: JSON.stringify({
+                  model: process.env.MODEL,
+                  messages: [{ role: "user", content: prompt }],
+                  temperature: 0.3
+                })
+              });
+
+              const data = await response.json();
+              const result = data.choices[0].message.content;
+              const header = process.env.EVENT_TYPE === 'PR' ? "### 🤖 AI Code Review" : "### 🤖 AI Issue Assistant";
+
+              if (process.env.EVENT_TYPE === 'PR') {
+                await github.rest.issues.createComment({
+                  owner: context.repo.owner,
+                  repo: context.repo.repo,
+                  issue_number: context.payload.pull_request.number,
+                  body: `${header}\n\n${result}`
+                });
+              } else {
+                await github.rest.issues.createComment({
+                  owner: context.repo.owner,
+                  repo: context.repo.repo,
+                  issue_number: context.payload.issue.number,
+                  body: `${header}\n\n${result}`
+                });
+              }
+            } catch (err) {
+              core.setFailed(err.message);
+            }

hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/.github/workflows/push_hf.yaml

@@ -0,0 +1,47 @@
+name: Sync to Hugging Face (Exclude README)
+
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+jobs:
+  sync-to-hub:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout GitHub Repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          lfs: true
+
+      - name: Sync and Push to HF
+        env:
+          HF_TOKEN: ${{ secrets.HF_TOKEN }}
+        run: |
+          # 1. 配置 Git 用户信息
+          git config --global user.email "actions@github.com"
+          git config --global user.name "GitHub Actions"
+          
+          # 2. 克隆 Hugging Face 仓库到临时目录 'hf_repo'
+          # 注意：请将 <USERNAME>/<REPO_NAME> 替换为你的路径
+          git clone https://x-access-token:$HF_TOKEN@huggingface.co/spaces/StarrySkyWorld/InterConnectServer hf_repo
+          
+          # 3. 使用 rsync 同步文件
+          # --exclude='.git/' : 不同步 git 历史
+          # --exclude='README.md' : 不同步 README 文件
+          # -av : 归档模式并显示详细过程
+          # --delete : 如果 GitHub 删除了某文件，HF 端也相应删除（README 除外）
+          rsync -av --exclude='.git/' --exclude='README.md' ./ hf_repo/
+          
+          # 4. 进入临时目录提交并推送
+          cd hf_repo
+          git add .
+          
+          # 检查是否有内容变化，防止空提交导致报错
+          if [ -n "$(git status --porcelain)" ]; then
+            git commit -m "Sync from GitHub (excluding README)"
+            git push origin main
+          else
+            echo "No changes to sync."
+          fi

hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/.gitignore

@@ -0,0 +1,59 @@
+# Dependencies
+node_modules/
+
+# Environment variables
+.env
+.env.local
+.env.*.local
+
+# Database files
+*.db
+*.sqlite
+*.sqlite3
+
+# Logs
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+lerna-debug.log*
+
+# Build files
+dist/
+build/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+.trae/
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Testing
+coverage/
+.nyc_output/
+
+# Misc
+*.tgz
+.cache/
+.parcel-cache/
+.next/
+.nuxt/
+.vuepress/dist/
+.serverless/
+.fusebox/
+.dynamodb/
+
+# CLI
+cli/*.log
+
+# Docker
+.dockerignore
+*.dockerfile
+
+

hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/Dockerfile

@@ -0,0 +1,16 @@
+FROM node:18-alpine
+
+WORKDIR /app
+
+COPY package*.json ./
+
+RUN npm install --production
+
+COPY . .
+
+EXPOSE 8000
+
+ENV SERVER_HOST=0.0.0.0
+ENV SERVER_PORT=8000
+
+CMD ["node", "src/server.js"]

hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 BeiChen
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/cli/cli.js

@@ -0,0 +1,389 @@
+#!/usr/bin/env node
+const { Command } = require('commander');
+const http = require('http');
+const https = require('https');
+const fs = require('fs');
+require('dotenv').config();
+
+const HARDCODED_API_URL = 'http://localhost:8000';
+const HARDCODED_ADMIN_KEY = process.env.ADMIN_KEY || null;
+
+class MinecraftWSCLIClient {
+    constructor(serverUrl, adminKey) {
+        this.serverUrl = serverUrl.replace(/\/$/, '');
+        this.effectiveAdminKey = adminKey || HARDCODED_ADMIN_KEY;
+    }
+
+    async request(method, endpoint, data = null) {
+        return new Promise((resolve, reject) => {
+            const url = new URL(endpoint, this.serverUrl);
+            const isHttps = url.protocol === 'https:';
+            const lib = isHttps ? https : http;
+            
+            const options = {
+                hostname: url.hostname,
+                port: url.port || (isHttps ? 443 : 80),
+                path: url.pathname + url.search,
+                method: method,
+                headers: {
+                    'Content-Type': 'application/json'
+                }
+            };
+            
+            if (this.effectiveAdminKey) {
+                options.headers['Authorization'] = `Bearer ${this.effectiveAdminKey}`;
+            }
+            
+            const req = lib.request(options, (res) => {
+                let body = '';
+                res.on('data', chunk => body += chunk);
+                res.on('end', () => {
+                    if (res.statusCode >= 200 && res.statusCode < 300) {
+                        if (res.statusCode === 204 || !body) {
+                            resolve(null);
+                        } else {
+                            try {
+                                resolve(JSON.parse(body));
+                            } catch {
+                                resolve(body);
+                            }
+                        }
+                    } else {
+                        let detail = body;
+                        try {
+                            const json = JSON.parse(body);
+                            detail = json.detail || body;
+                        } catch {}
+                        reject(new Error(`API请求失败 (${res.statusCode}): ${detail}`));
+                    }
+                });
+            });
+            
+            req.on('error', (e) => reject(new Error(`网络请求失败: ${e.message}`)));
+            
+            if (data) {
+                req.write(JSON.stringify(data));
+            }
+            req.end();
+        });
+    }
+
+    ensureAdminKeyForManagement() {
+        if (!this.effectiveAdminKey) {
+            throw new Error('此管理操作需要Admin Key。请通过--admin-key选项或ADMIN_KEY环境变量提供。');
+        }
+    }
+
+    async createApiKey(name, description = '', keyType = 'regular', serverId = null) {
+        this.ensureAdminKeyForManagement();
+        return await this.request('POST', '/manage/keys', {
+            name,
+            description,
+            key_type: keyType,
+            server_id: serverId
+        });
+    }
+
+    async listApiKeys() {
+        this.ensureAdminKeyForManagement();
+        return await this.request('GET', '/manage/keys');
+    }
+
+    async getApiKeyDetails(keyId) {
+        this.ensureAdminKeyForManagement();
+        return await this.request('GET', `/manage/keys/${keyId}`);
+    }
+
+    async activateApiKey(keyId) {
+        this.ensureAdminKeyForManagement();
+        return await this.request('PATCH', `/manage/keys/${keyId}/activate`);
+    }
+
+    async deactivateApiKey(keyId) {
+        this.ensureAdminKeyForManagement();
+        return await this.request('PATCH', `/manage/keys/${keyId}/deactivate`);
+    }
+
+    async deleteApiKey(keyId) {
+        this.ensureAdminKeyForManagement();
+        await this.request('DELETE', `/manage/keys/${keyId}`);
+        return true;
+    }
+
+    async healthCheck() {
+        return await this.request('GET', '/health');
+    }
+}
+
+const program = new Command();
+
+program
+    .name('minecraft-ws-cli')
+    .description('Minecraft WebSocket API CLI - 管理API密钥和服务器')
+    .version('1.0.0')
+    .option('-s, --server-url <url>', 'API服务器URL', process.env.MC_WS_API_URL || HARDCODED_API_URL)
+    .option('-k, --admin-key <key>', '用于管理操作的Admin Key', process.env.ADMIN_KEY || HARDCODED_ADMIN_KEY);
+
+program
+    .command('create-key <name>')
+    .description('创建新的API密钥')
+    .option('-d, --description <desc>', 'API密钥描述', '')
+    .option('-t, --type <type>', '密钥类型: admin, server, regular', 'regular')
+    .option('--server-id <id>', '关联的服务器ID（仅server类型需要）')
+    .action(async (name, options) => {
+        try {
+            const opts = program.opts();
+            const client = new MinecraftWSCLIClient(opts.serverUrl, opts.adminKey);
+            const result = await client.createApiKey(name, options.description, options.type, options.serverId);
+            
+            const keyTypeNames = { admin: 'Admin Key', server: 'Server Key', regular: '普通Key' };
+            
+            if (result.regularKey && result.serverKey) {
+                // 返回了Regular Key和关联的Server Key
+                console.log(`\x1b[32m✅ 成功创建Regular Key和关联的Server Key!\x1b[0m`);
+                console.log('='.repeat(60));
+                
+                // 显示Regular Key
+                console.log(`\x1b[34m🔑 Regular Key:${keyTypeNames[result.regularKey.keyType]}\x1b[0m`);
+                console.log(`  ID: ${result.regularKey.id}`);
+                console.log(`  名称: ${result.regularKey.name}`);
+                console.log(`  描述: ${result.regularKey.description || '无'}`);
+                console.log(`  前缀: ${result.regularKey.keyPrefix}`);
+                if (result.regularKey.serverId) {
+                    console.log(`  服务器ID: ${result.regularKey.serverId}`);
+                }
+                console.log(`  创建时间: ${result.regularKey.createdAt}`);
+                console.log(`\x1b[33m🔑 原始密钥 (请妥善保存，仅显示一次):\x1b[0m`);
+                console.log(`\x1b[31m  ${result.regularKey.key}\x1b[0m`);
+                console.log();
+                
+                // 显示关联的Server Key
+                console.log(`\x1b[34m🖥️ Server Key:${keyTypeNames[result.serverKey.keyType]}\x1b[0m`);
+                console.log(`  ID: ${result.serverKey.id}`);
+                console.log(`  名称: ${result.serverKey.name}`);
+                console.log(`  描述: ${result.serverKey.description || '无'}`);
+                console.log(`  前缀: ${result.serverKey.keyPrefix}`);
+                if (result.serverKey.serverId) {
+                    console.log(`  服务器ID: ${result.serverKey.serverId}`);
+                }
+                console.log(`  创建时间: ${result.serverKey.createdAt}`);
+                console.log(`\x1b[33m🔑 原始密钥 (请妥善保存，仅显示一次):\x1b[0m`);
+                console.log(`\x1b[31m  ${result.serverKey.key}\x1b[0m`);
+                console.log('='.repeat(60));
+                console.log();
+                console.log('使用示例:');
+                console.log(`  Regular Key登录控制面板: http://localhost:8000/dashboard`);
+                console.log(`  Server Key用于插件配置: 放入Minecraft插件的配置文件中`);
+            } else {
+                // 返回了单个密钥
+                const keyType = keyTypeNames[result.keyType] || result.keyType;
+                
+                console.log(`\x1b[32m✅ ${keyType}创建成功!\x1b[0m`);
+                console.log(`  ID: ${result.id}`);
+                console.log(`  名称: ${result.name}`);
+                console.log(`  类型: ${keyType}`);
+                console.log(`  前缀: ${result.keyPrefix}`);
+                if (result.serverId) {
+                    console.log(`  服务器ID: ${result.serverId}`);
+                }
+                console.log(`  创建时间: ${result.createdAt}`);
+                console.log(`\x1b[33m🔑 原始密钥 (请妥善保存，仅显示一次):\x1b[0m`);
+                console.log(`\x1b[31m  ${result.key}\x1b[0m`);
+                console.log();
+                console.log('使用示例:');
+                console.log(`  WebSocket连接: ws://localhost:8000/ws?api_key=${result.key}`);
+                console.log(`  HTTP请求头: Authorization: Bearer ${result.key}`);
+            }
+        } catch (error) {
+            console.error(`\x1b[31m❌ 错误: ${error.message}\x1b[0m`);
+            process.exit(1);
+        }
+    });
+
+program
+    .command('list-keys')
+    .description('列出所有API密钥')
+    .action(async () => {
+        try {
+            const opts = program.opts();
+            const client = new MinecraftWSCLIClient(opts.serverUrl, opts.adminKey);
+            const keys = await client.listApiKeys();
+            
+            if (keys.length === 0) {
+                console.log('📭 没有找到API密钥.');
+                return;
+            }
+            
+            console.log(`\x1b[34m📋 API密钥列表 (共 ${keys.length} 个):\x1b[0m`);
+            
+            const keyTypeIcons = { admin: '👑', server: '🖥️', regular: '🔑' };
+            const keyTypeNames = { admin: 'Admin', server: 'Server', regular: 'Regular' };
+            
+            for (const key of keys) {
+                const status = key.isActive ? '\x1b[32m🟢 活跃\x1b[0m' : '\x1b[31m🔴 已停用\x1b[0m';
+                const icon = keyTypeIcons[key.keyType] || '🔑';
+                const typeName = keyTypeNames[key.keyType] || key.keyType;
+                const lastUsed = key.lastUsed || '从未使用';
+                
+                console.log('-'.repeat(50));
+                console.log(`  ID         : ${key.id}`);
+                console.log(`  名称       : ${key.name}`);
+                console.log(`  类型       : ${icon} ${typeName}`);
+                console.log(`  状态       : ${status}`);
+                console.log(`  前缀       : ${key.keyPrefix}`);
+                if (key.serverId) {
+                    console.log(`  服务器ID   : ${key.serverId}`);
+                }
+                console.log(`  创建时间   : ${key.createdAt}`);
+                console.log(`  最后使用   : ${lastUsed}`);
+            }
+            console.log('-'.repeat(50));
+        } catch (error) {
+            console.error(`\x1b[31m❌ 错误: ${error.message}\x1b[0m`);
+            process.exit(1);
+        }
+    });
+
+program
+    .command('get-key <key_id>')
+    .description('获取特定API密钥的详细信息')
+    .action(async (keyId) => {
+        try {
+            const opts = program.opts();
+            const client = new MinecraftWSCLIClient(opts.serverUrl, opts.adminKey);
+            const key = await client.getApiKeyDetails(keyId);
+            
+            const keyTypeIcons = { admin: '👑', server: '🖥️', regular: '🔑' };
+            const keyTypeNames = { admin: 'Admin', server: 'Server', regular: 'Regular' };
+            
+            const status = key.isActive ? '\x1b[32m🟢 活跃\x1b[0m' : '\x1b[31m🔴 已停用\x1b[0m';
+            const icon = keyTypeIcons[key.keyType] || '🔑';
+            const typeName = keyTypeNames[key.keyType] || key.keyType;
+            const lastUsed = key.lastUsed || '从未使用';
+            
+            console.log(`\x1b[34m📄 密钥详情 (ID: ${key.id}):\x1b[0m`);
+            console.log(`  名称       : ${key.name}`);
+            console.log(`  描述       : ${key.description || '无'}`);
+            console.log(`  类型       : ${icon} ${typeName}`);
+            console.log(`  状态       : ${status}`);
+            console.log(`  前缀       : ${key.keyPrefix}`);
+            if (key.serverId) {
+                console.log(`  服务器ID   : ${key.serverId}`);
+            }
+            console.log(`  创建时间   : ${key.createdAt}`);
+            console.log(`  最后使用   : ${lastUsed}`);
+        } catch (error) {
+            console.error(`\x1b[31m❌ 错误: ${error.message}\x1b[0m`);
+            process.exit(1);
+        }
+    });
+
+program
+    .command('activate-key <key_id>')
+    .description('激活指定的API密钥')
+    .action(async (keyId) => {
+        try {
+            const opts = program.opts();
+            const client = new MinecraftWSCLIClient(opts.serverUrl, opts.adminKey);
+            const result = await client.activateApiKey(keyId);
+            console.log(`\x1b[32m✅ ${result.message}\x1b[0m`);
+        } catch (error) {
+            console.error(`\x1b[31m❌ 错误: ${error.message}\x1b[0m`);
+            process.exit(1);
+        }
+    });
+
+program
+    .command('deactivate-key <key_id>')
+    .description('停用指定的API密钥')
+    .action(async (keyId) => {
+        try {
+            const opts = program.opts();
+            const client = new MinecraftWSCLIClient(opts.serverUrl, opts.adminKey);
+            const result = await client.deactivateApiKey(keyId);
+            console.log(`\x1b[32m✅ ${result.message}\x1b[0m`);
+        } catch (error) {
+            console.error(`\x1b[31m❌ 错误: ${error.message}\x1b[0m`);
+            process.exit(1);
+        }
+    });
+
+program
+    .command('delete-key <key_id>')
+    .description('永久删除指定的API密钥')
+    .action(async (keyId) => {
+        try {
+            const opts = program.opts();
+            const client = new MinecraftWSCLIClient(opts.serverUrl, opts.adminKey);
+            await client.deleteApiKey(keyId);
+            console.log(`\x1b[32m✅ API密钥 ${keyId} 已成功删除!\x1b[0m`);
+        } catch (error) {
+            console.error(`\x1b[31m❌ 错误: ${error.message}\x1b[0m`);
+            process.exit(1);
+        }
+    });
+
+program
+    .command('health')
+    .description('检查服务器健康状态')
+    .action(async () => {
+        try {
+            const opts = program.opts();
+            const client = new MinecraftWSCLIClient(opts.serverUrl, opts.adminKey);
+            const result = await client.healthCheck();
+            
+            console.log('\x1b[34m🏥 服务器健康状态:\x1b[0m');
+            const statusIcon = result.status === 'healthy' ? '🟢' : '🔴';
+            console.log(`  状态          : ${statusIcon} ${result.status}`);
+            console.log(`  时间戳        : ${result.timestamp}`);
+            console.log(`  活跃WS连接数  : ${result.active_ws}`);
+            console.log(`  总密钥数      : ${result.keys_total}`);
+            console.log(`  活跃Admin Keys: ${result.admin_active}`);
+            console.log(`  活跃Server Keys: ${result.server_active}`);
+            console.log(`  活跃Regular Keys: ${result.regular_active}`);
+            
+            if (result.status === 'healthy') {
+                console.log('\x1b[32m✅ 服务器运行正常\x1b[0m');
+            } else {
+                console.log('\x1b[33m⚠️ 服务器状态异常\x1b[0m');
+            }
+        } catch (error) {
+            console.error(`\x1b[31m❌ 服务器连接或检查失败: ${error.message}\x1b[0m`);
+            process.exit(1);
+        }
+    });
+
+program
+    .command('generate-config [filename]')
+    .description('为Minecraft插件生成配置文件模板')
+    .action(async (filename = 'mc_ws_plugin_config.json') => {
+        try {
+            const opts = program.opts();
+            const wsUrl = opts.serverUrl.replace('http://', 'ws://').replace('https://', 'wss://');
+            
+            const configTemplate = {
+                websocket_settings: {
+                    server_address: `${wsUrl}/ws`,
+                    reconnect_delay_seconds: 10,
+                    ping_interval_seconds: 30
+                },
+                api_key: 'PASTE_YOUR_GENERATED_API_KEY_HERE',
+                server_identifier: 'MyMinecraftServer_1',
+                log_level: 'INFO',
+                enabled_events: {
+                    player_join: true,
+                    player_quit: true,
+                    player_chat: false,
+                    player_death: true
+                }
+            };
+            
+            fs.writeFileSync(filename, JSON.stringify(configTemplate, null, 4));
+            console.log(`\x1b[32m✅ 插件配置文件模板已生成: ${filename}\x1b[0m`);
+        } catch (error) {
+            console.error(`\x1b[31m❌ 生成配置文件失败: ${error.message}\x1b[0m`);
+            process.exit(1);
+        }
+    });
+
+program.parse();

hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/dashboard/public/app.js

@@ -0,0 +1,444 @@
+const API_URL = window.location.origin;
+let superKey = null;
+let ws = null;
+
+const loginScreen = document.getElementById('login-screen');
+const dashboardScreen = document.getElementById('dashboard-screen');
+const loginForm = document.getElementById('login-form');
+const loginError = document.getElementById('login-error');
+const logoutBtn = document.getElementById('logout-btn');
+const createKeyBtn = document.getElementById('create-key-btn');
+const createKeyModal = document.getElementById('create-key-modal');
+const createKeyForm = document.getElementById('create-key-form');
+const cancelCreateBtn = document.getElementById('cancel-create-btn');
+const keyDetailsModal = document.getElementById('key-details-modal');
+const closeDetailsBtn = document.getElementById('close-details-btn');
+
+loginForm.addEventListener('submit', async (e) => {
+    e.preventDefault();
+    const key = document.getElementById('super-key-input').value;
+    
+    try {
+        // 验证密钥是否有效
+        const response = await fetch(`${API_URL}/health`, {
+            headers: { 'Authorization': `Bearer ${key}` }
+        });
+        
+        if (response.ok) {
+            superKey = key;
+            
+            // 验证密钥类型
+            let userKeyType = null;
+            let userServerId = null;
+            
+            // 尝试Admin Key验证
+            const adminResponse = await fetch(`${API_URL}/manage/keys`, {
+                headers: { 'Authorization': `Bearer ${key}` }
+            });
+            
+            if (adminResponse.ok) {
+                userKeyType = 'admin';
+            } else {
+                // 尝试Server Key验证
+                const serverResponse = await fetch(`${API_URL}/api/server/info`, {
+                    headers: { 'Authorization': `Bearer ${key}` }
+                });
+                
+                if (serverResponse.ok) {
+                    userKeyType = 'server';
+                    const serverData = await serverResponse.json();
+                    userServerId = serverData.server_id;
+                } else {
+                    // 尝试Regular Key验证（获取自己的Server Key列表）
+                    const regularResponse = await fetch(`${API_URL}/manage/keys/server-keys`, {
+                        headers: { 'Authorization': `Bearer ${key}` }
+                    });
+                    
+                    if (regularResponse.ok) {
+                        userKeyType = 'regular';
+                    } else {
+                        throw new Error('无效的密钥或权限不足');
+                    }
+                }
+            }
+            
+            loginError.textContent = '';
+            showDashboard(userKeyType, userServerId);
+        } else {
+            loginError.textContent = '无效的密钥';
+        }
+    } catch (error) {
+        loginError.textContent = error.message || '无法连接到服务器';
+    }
+});
+
+logoutBtn.addEventListener('click', () => {
+    superKey = null;
+    if (ws) {
+        ws.close();
+        ws = null;
+    }
+    loginScreen.classList.remove('hidden');
+    dashboardScreen.classList.add('hidden');
+});
+
+createKeyBtn.addEventListener('click', () => {
+    createKeyModal.classList.remove('hidden');
+});
+
+cancelCreateBtn.addEventListener('click', () => {
+    createKeyModal.classList.add('hidden');
+    createKeyForm.reset();
+});
+
+closeDetailsBtn.addEventListener('click', () => {
+    keyDetailsModal.classList.add('hidden');
+});
+
+createKeyForm.addEventListener('submit', async (e) => {
+    e.preventDefault();
+    
+    const name = document.getElementById('key-name').value;
+    const description = document.getElementById('key-description').value;
+    const isSuper = document.getElementById('key-is-super').checked;
+    
+    try {
+        const response = await fetch(`${API_URL}/manage/keys`, {
+            method: 'POST',
+            headers: {
+                'Authorization': `Bearer ${superKey}`,
+                'Content-Type': 'application/json'
+            },
+            body: JSON.stringify({
+                name,
+                description,
+                is_super_key: isSuper
+            })
+        });
+        
+        if (response.ok) {
+            const result = await response.json();
+            createKeyModal.classList.add('hidden');
+            createKeyForm.reset();
+            
+            showKeyCreatedModal(result);
+            loadKeys();
+        } else {
+            const error = await response.json();
+            alert('创建失败: ' + error.detail);
+        }
+    } catch (error) {
+        alert('创建失败: ' + error.message);
+    }
+});
+
+function showKeyCreatedModal(keyData) {
+    const content = `
+        <p><strong>密钥创建成功！</strong></p>
+        <p>名称: ${keyData.name}</p>
+        <p>类型: ${keyData.isSuperKey ? 'SuperKey' : '普通密钥'}</p>
+        <div class="key-display">
+            <strong>⚠️ 请立即复制并保存此密钥（仅显示一次）:</strong><br>
+            ${keyData.key}
+        </div>
+    `;
+    
+    document.getElementById('key-details-content').innerHTML = content;
+    keyDetailsModal.classList.remove('hidden');
+}
+
+// 全局变量
+let currentUserKeyType = null;
+let currentUserServerId = null;
+
+async function showDashboard(userKeyType, userServerId) {
+    currentUserKeyType = userKeyType;
+    currentUserServerId = userServerId;
+    
+    loginScreen.classList.add('hidden');
+    dashboardScreen.classList.remove('hidden');
+    
+    // 显示用户信息
+    const userInfo = document.getElementById('user-info');
+    const keyTypeIcons = { admin: '👑', server: '🖥️', regular: '🔑' };
+    const keyTypeNames = { admin: 'Admin', server: 'Server', regular: 'Regular' };
+    userInfo.textContent = `${keyTypeIcons[userKeyType]} ${keyTypeNames[userKeyType]} 用户`;
+    
+    // 根据权限显示/隐藏功能
+    const adminSection = document.getElementById('admin-section');
+    const serverSection = document.getElementById('server-section');
+    
+    if (userKeyType === 'admin') {
+        adminSection.style.display = 'block';
+        serverSection.style.display = 'block';
+        loadKeys();
+    } else if (userKeyType === 'server') {
+        adminSection.style.display = 'none';
+        serverSection.style.display = 'block';
+        loadServerInfo();
+    } else if (userKeyType === 'regular') {
+        adminSection.style.display = 'none';
+        serverSection.style.display = 'block';
+        loadRegularServerKeys();
+    }
+    
+    // 根据用户类型控制创建密钥按钮的显示
+    const createKeyBtn = document.getElementById('create-key-btn');
+    if (createKeyBtn) {
+        createKeyBtn.style.display = userKeyType === 'admin' ? 'block' : 'none';
+    }
+    
+    loadStats();
+    connectWebSocket();
+    
+    setInterval(loadStats, 5000);
+}
+
+async function loadStats() {
+    try {
+        const response = await fetch(`${API_URL}/health`);
+        const data = await response.json();
+        
+        document.getElementById('stat-connections').textContent = data.active_ws || 0;
+        document.getElementById('stat-total-keys').textContent = data.keys_total || 0;
+        document.getElementById('stat-super-keys').textContent = data.super_active || 0;
+        document.getElementById('stat-regular-keys').textContent = data.regular_active || 0;
+    } catch (error) {
+        console.error('Failed to load stats:', error);
+    }
+}
+
+async function loadKeys() {
+    try {
+        const response = await fetch(`${API_URL}/manage/keys`, {
+            headers: { 'Authorization': `Bearer ${superKey}` }
+        });
+        
+        if (response.ok) {
+            const keys = await response.json();
+            renderKeys(keys);
+        }
+    } catch (error) {
+        console.error('Failed to load keys:', error);
+    }
+}
+
+async function loadRegularServerKeys() {
+    try {
+        const response = await fetch(`${API_URL}/manage/keys/server-keys`, {
+            headers: { 'Authorization': `Bearer ${superKey}` }
+        });
+        
+        if (response.ok) {
+            const serverKeys = await response.json();
+            renderServerKeys(serverKeys);
+        } else {
+            document.getElementById('keys-list').innerHTML = '<p>无法加载Server Key列表</p>';
+        }
+    } catch (error) {
+        console.error('Failed to load server keys:', error);
+        document.getElementById('keys-list').innerHTML = '<p>无法加载Server Key列表</p>';
+    }
+}
+
+function renderServerKeys(keys) {
+    const keysList = document.getElementById('keys-list');
+    
+    if (keys.length === 0) {
+        keysList.innerHTML = '<p>暂无关联的Server Key</p>';
+        return;
+    }
+    
+    keysList.innerHTML = keys.map(key => `
+        <div class="key-card">
+            <div class="key-info">
+                <h3>
+                    <span class="key-badge server">🖥️ Server</span>
+                    <span class="key-badge ${key.isActive ? 'active' : 'inactive'}">
+                        ${key.isActive ? '活跃' : '已停用'}
+                    </span>
+                    ${key.name}
+                </h3>
+                <p>ID: ${key.id}</p>
+                <p>前缀: ${key.keyPrefix}</p>
+                ${key.serverId ? `<p>服务器ID: ${key.serverId}</p>` : ''}
+                <p>创建时间: ${new Date(key.createdAt).toLocaleString('zh-CN')}</p>
+                <p>最后使用: ${key.lastUsed ? new Date(key.lastUsed).toLocaleString('zh-CN') : '从未使用'}</p>
+            </div>
+            <div class="key-actions">
+                ${key.isActive ? 
+                    `<button class="btn-danger" onclick="deactivateKey('${key.id}')">停用</button>` :
+                    `<button class="btn-success" onclick="activateKey('${key.id}')">激活</button>`
+                }
+                <button class="btn-danger" onclick="deleteKey('${key.id}', '${key.name}')">删除</button>
+            </div>
+        </div>
+    `).join('');
+}
+
+function renderKeys(keys) {
+    const keysList = document.getElementById('keys-list');
+    
+    if (keys.length === 0) {
+        keysList.innerHTML = '<p>暂无API密钥</p>';
+        return;
+    }
+    
+    keysList.innerHTML = keys.map(key => `
+        <div class="key-card ${key.keyType === 'admin' ? 'super' : ''}">
+            <div class="key-info">
+                <h3>
+                    <span class="key-badge ${key.keyType}">
+                        ${key.keyType === 'admin' ? '👑 Admin' : key.keyType === 'server' ? '🖥️ Server' : '🔑 Regular'}
+                    </span>
+                    <span class="key-badge ${key.isActive ? 'active' : 'inactive'}">
+                        ${key.isActive ? '活跃' : '已停用'}
+                    </span>
+                    ${key.name}
+                </h3>
+                <p>ID: ${key.id}</p>
+                <p>前缀: ${key.keyPrefix}</p>
+                ${key.serverId ? `<p>服务器ID: ${key.serverId}</p>` : ''}
+                <p>创建时间: ${new Date(key.createdAt).toLocaleString('zh-CN')}</p>
+                <p>最后使用: ${key.lastUsed ? new Date(key.lastUsed).toLocaleString('zh-CN') : '从未使用'}</p>
+            </div>
+            <div class="key-actions">
+                ${key.isActive ? 
+                    `<button class="btn-danger" onclick="deactivateKey('${key.id}')">停用</button>` :
+                    `<button class="btn-success" onclick="activateKey('${key.id}')">激活</button>`
+                }
+                <button class="btn-danger" onclick="deleteKey('${key.id}', '${key.name}')">删除</button>
+            </div>
+        </div>
+    `).join('');
+}
+
+async function activateKey(keyId) {
+    try {
+        const response = await fetch(`${API_URL}/manage/keys/${keyId}/activate`, {
+            method: 'PATCH',
+            headers: { 'Authorization': `Bearer ${superKey}` }
+        });
+        
+        if (response.ok) {
+            if (currentUserKeyType === 'admin') {
+                loadKeys();
+            } else if (currentUserKeyType === 'regular') {
+                loadRegularServerKeys();
+            }
+        } else {
+            const error = await response.json();
+            alert('激活失败: ' + error.detail);
+        }
+    } catch (error) {
+        alert('激活失败: ' + error.message);
+    }
+}
+
+async function deactivateKey(keyId) {
+    try {
+        const response = await fetch(`${API_URL}/manage/keys/${keyId}/deactivate`, {
+            method: 'PATCH',
+            headers: { 'Authorization': `Bearer ${superKey}` }
+        });
+        
+        if (response.ok) {
+            if (currentUserKeyType === 'admin') {
+                loadKeys();
+            } else if (currentUserKeyType === 'regular') {
+                loadRegularServerKeys();
+            }
+        } else {
+            const error = await response.json();
+            alert('停用失败: ' + error.detail);
+        }
+    } catch (error) {
+        alert('停用失败: ' + error.message);
+    }
+}
+
+async function deleteKey(keyId, keyName) {
+    if (!confirm(`确定要删除密钥 "${keyName}" 吗？此操作无法撤销。`)) {
+        return;
+    }
+    
+    try {
+        const response = await fetch(`${API_URL}/manage/keys/${keyId}`, {
+            method: 'DELETE',
+            headers: { 'Authorization': `Bearer ${superKey}` }
+        });
+        
+        if (response.ok) {
+            if (currentUserKeyType === 'admin') {
+                loadKeys();
+            } else if (currentUserKeyType === 'regular') {
+                loadRegularServerKeys();
+            }
+        } else {
+            const error = await response.json();
+            alert('删除失败: ' + error.detail);
+        }
+    } catch (error) {
+        alert('删除失败: ' + error.message);
+    }
+}
+
+function connectWebSocket() {
+    if (!superKey) return;
+    
+    const wsUrl = `ws://localhost:8000/ws?api_key=${superKey}`;
+    ws = new WebSocket(wsUrl);
+    
+    ws.onopen = () => {
+        console.log('WebSocket connected');
+    };
+    
+    ws.onmessage = (event) => {
+        try {
+            const message = JSON.parse(event.data);
+            
+            if (message.type === 'minecraft_event') {
+                addEventToList(message.event);
+            }
+        } catch (error) {
+            console.error('Failed to parse WebSocket message:', error);
+        }
+    };
+    
+    ws.onerror = (error) => {
+        console.error('WebSocket error:', error);
+    };
+    
+    ws.onclose = () => {
+        console.log('WebSocket disconnected');
+        setTimeout(() => {
+            if (superKey) {
+                connectWebSocket();
+            }
+        }, 5000);
+    };
+    
+    setInterval(() => {
+        if (ws && ws.readyState === WebSocket.OPEN) {
+            ws.send(JSON.stringify({ type: 'ping' }));
+        }
+    }, 30000);
+}
+
+function addEventToList(event) {
+    const eventsList = document.getElementById('events-list');
+    
+    const eventItem = document.createElement('div');
+    eventItem.className = 'event-item';
+    eventItem.innerHTML = `
+        <strong>${event.event_type}</strong> - ${event.server_name}<br>
+        <small>${new Date(event.timestamp).toLocaleString('zh-CN')}</small><br>
+        <pre>${JSON.stringify(event.data, null, 2)}</pre>
+    `;
+    
+    eventsList.insertBefore(eventItem, eventsList.firstChild);
+    
+    while (eventsList.children.length > 50) {
+        eventsList.removeChild(eventsList.lastChild);
+    }
+}

hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/dashboard/public/index.html

@@ -0,0 +1,103 @@
+<!DOCTYPE html>
+<html lang="zh-CN">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>Minecraft WebSocket API - 控制面板</title>
+    <link rel="stylesheet" href="style.css">
+</head>
+<body>
+    <div id="login-screen" class="screen">
+        <div class="login-container">
+            <h1>🎮 Minecraft WebSocket API</h1>
+            <h2>控制面板登录</h2>
+            <form id="login-form">
+                <input type="password" id="super-key-input" placeholder="输入Admin Key或Server Key" required>
+                <button type="submit">登录</button>
+            </form>
+            <p class="error-message" id="login-error"></p>
+            <div class="login-info">
+                <p><strong>密钥类型说明：</strong></p>
+                <p>👑 <strong>Admin Key</strong> - 完全管理权限</p>
+                <p>🖥️ <strong>Server Key</strong> - 服务器管理权限</p>
+            </div>
+        </div>
+    </div>
+
+    <div id="dashboard-screen" class="screen hidden">
+        <nav class="navbar">
+            <h1>🎮 Minecraft WebSocket API</h1>
+            <button id="logout-btn">退出登录</button>
+        </nav>
+
+        <div class="container">
+            <div class="stats-grid">
+                <div class="stat-card">
+                    <h3>活跃连接</h3>
+                    <p class="stat-value" id="stat-connections">0</p>
+                </div>
+                <div class="stat-card">
+                    <h3>总密钥数</h3>
+                    <p class="stat-value" id="stat-total-keys">0</p>
+                </div>
+                <div class="stat-card">
+                    <h3>活跃SuperKeys</h3>
+                    <p class="stat-value" id="stat-super-keys">0</p>
+                </div>
+                <div class="stat-card">
+                    <h3>活跃普通Keys</h3>
+                    <p class="stat-value" id="stat-regular-keys">0</p>
+                </div>
+            </div>
+
+            <div class="section">
+                <div class="section-header">
+                    <h2>API密钥管理</h2>
+                    <button id="create-key-btn" class="btn-primary">创建新密钥</button>
+                </div>
+                <div id="keys-list" class="keys-list"></div>
+            </div>
+
+            <div class="section">
+                <h2>实时事件监控</h2>
+                <div id="events-list" class="events-list"></div>
+            </div>
+        </div>
+    </div>
+
+    <div id="create-key-modal" class="modal hidden">
+        <div class="modal-content">
+            <h2>创建新API密钥</h2>
+            <form id="create-key-form">
+                <label>名称 *</label>
+                <input type="text" id="key-name" required>
+                
+                <label>描述</label>
+                <textarea id="key-description"></textarea>
+                
+                <label>
+                    <input type="checkbox" id="key-is-super">
+                    创建为SuperKey
+                </label>
+                
+                <div class="modal-actions">
+                    <button type="button" id="cancel-create-btn" class="btn-secondary">取消</button>
+                    <button type="submit" class="btn-primary">创建</button>
+                </div>
+            </form>
+        </div>
+    </div>
+
+    <div id="key-details-modal" class="modal hidden">
+        <div class="modal-content">
+            <h2>密钥详情</h2>
+            <div id="key-details-content"></div>
+            <div class="modal-actions">
+                <button id="close-details-btn" class="btn-secondary">关闭</button>
+            </div>
+        </div>
+    </div>
+
+    <script src="app.js"></script>
+</body>
+</html>

hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/dashboard/public/style.css

@@ -0,0 +1,410 @@
+* {
+    margin: 0;
+    padding: 0;
+    box-sizing: border-box;
+}
+
+body {
+    font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Oxygen, Ubuntu, Cantarell, sans-serif;
+    background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
+    min-height: 100vh;
+    color: #333;
+}
+
+.screen {
+    min-height: 100vh;
+}
+
+.hidden {
+    display: none !important;
+}
+
+.login-container {
+    display: flex;
+    flex-direction: column;
+    align-items: center;
+    justify-content: center;
+    min-height: 100vh;
+    padding: 20px;
+}
+
+.login-container h1 {
+    color: white;
+    font-size: 3em;
+    margin-bottom: 10px;
+}
+
+.login-container h2 {
+    color: white;
+    font-size: 1.5em;
+    margin-bottom: 30px;
+}
+
+#login-form {
+    background: white;
+    padding: 40px;
+    border-radius: 10px;
+    box-shadow: 0 10px 40px rgba(0,0,0,0.2);
+    width: 100%;
+    max-width: 400px;
+}
+
+#login-form input {
+    width: 100%;
+    padding: 15px;
+    border: 2px solid #e0e0e0;
+    border-radius: 5px;
+    font-size: 16px;
+    margin-bottom: 20px;
+}
+
+#login-form button {
+    width: 100%;
+    padding: 15px;
+    background: #667eea;
+    color: white;
+    border: none;
+    border-radius: 5px;
+    font-size: 16px;
+    font-weight: bold;
+    cursor: pointer;
+    transition: background 0.3s;
+}
+
+#login-form button:hover {
+    background: #5568d3;
+}
+
+.error-message {
+    color: #ff4444;
+    margin-top: 10px;
+    text-align: center;
+}
+
+.navbar {
+    background: white;
+    padding: 20px 40px;
+    display: flex;
+    justify-content: space-between;
+    align-items: center;
+    box-shadow: 0 2px 10px rgba(0,0,0,0.1);
+}
+
+.navbar h1 {
+    font-size: 1.5em;
+    color: #667eea;
+}
+
+#logout-btn {
+    padding: 10px 20px;
+    background: #ff4444;
+    color: white;
+    border: none;
+    border-radius: 5px;
+    cursor: pointer;
+    font-weight: bold;
+}
+
+.container {
+    max-width: 1400px;
+    margin: 0 auto;
+    padding: 40px 20px;
+}
+
+.stats-grid {
+    display: grid;
+    grid-template-columns: repeat(auto-fit, minmax(250px, 1fr));
+    gap: 20px;
+    margin-bottom: 40px;
+}
+
+.stat-card {
+    background: white;
+    padding: 30px;
+    border-radius: 10px;
+    box-shadow: 0 4px 15px rgba(0,0,0,0.1);
+    text-align: center;
+}
+
+.stat-card h3 {
+    color: #666;
+    font-size: 0.9em;
+    margin-bottom: 10px;
+    text-transform: uppercase;
+}
+
+.stat-value {
+    font-size: 3em;
+    font-weight: bold;
+    color: #667eea;
+}
+
+.section {
+    background: white;
+    padding: 30px;
+    border-radius: 10px;
+    box-shadow: 0 4px 15px rgba(0,0,0,0.1);
+    margin-bottom: 30px;
+}
+
+.section-header {
+    display: flex;
+    justify-content: space-between;
+    align-items: center;
+    margin-bottom: 20px;
+}
+
+.section h2 {
+    color: #333;
+    margin-bottom: 20px;
+}
+
+.btn-primary {
+    padding: 12px 24px;
+    background: #667eea;
+    color: white;
+    border: none;
+    border-radius: 5px;
+    cursor: pointer;
+    font-weight: bold;
+    transition: background 0.3s;
+}
+
+.btn-primary:hover {
+    background: #5568d3;
+}
+
+.btn-secondary {
+    padding: 12px 24px;
+    background: #e0e0e0;
+    color: #333;
+    border: none;
+    border-radius: 5px;
+    cursor: pointer;
+    font-weight: bold;
+}
+
+.btn-danger {
+    padding: 8px 16px;
+    background: #ff4444;
+    color: white;
+    border: none;
+    border-radius: 5px;
+    cursor: pointer;
+    font-size: 0.9em;
+}
+
+.btn-success {
+    padding: 8px 16px;
+    background: #4caf50;
+    color: white;
+    border: none;
+    border-radius: 5px;
+    cursor: pointer;
+    font-size: 0.9em;
+}
+
+.keys-list {
+    display: grid;
+    gap: 15px;
+}
+
+.key-card {
+    border: 2px solid #e0e0e0;
+    padding: 20px;
+    border-radius: 8px;
+    display: flex;
+    justify-content: space-between;
+    align-items: center;
+}
+
+.key-card.super {
+    border-color: #764ba2;
+    background: #f9f7fb;
+}
+
+.key-info h3 {
+    margin-bottom: 5px;
+}
+
+.key-badge {
+    display: inline-block;
+    padding: 4px 8px;
+    border-radius: 4px;
+    font-size: 0.8em;
+    font-weight: bold;
+    margin-right: 10px;
+}
+
+.key-badge.super {
+    background: #764ba2;
+    color: white;
+}
+
+.key-badge.regular {
+    background: #667eea;
+    color: white;
+}
+
+.key-badge.active {
+    background: #4caf50;
+    color: white;
+}
+
+.key-badge.inactive {
+    background: #ff4444;
+    color: white;
+}
+
+.key-actions {
+    display: flex;
+    gap: 10px;
+}
+
+.events-list {
+    max-height: 400px;
+    overflow-y: auto;
+}
+
+.event-item {
+    padding: 15px;
+    border-left: 4px solid #667eea;
+    background: #f5f5f5;
+    margin-bottom: 10px;
+    border-radius: 4px;
+}
+
+.event-item strong {
+    color: #667eea;
+}
+
+.modal {
+    position: fixed;
+    top: 0;
+    left: 0;
+    width: 100%;
+    height: 100%;
+    background: rgba(0,0,0,0.5);
+    display: flex;
+    justify-content: center;
+    align-items: center;
+    z-index: 1000;
+}
+
+.modal-content {
+    background: white;
+    padding: 40px;
+    border-radius: 10px;
+    max-width: 500px;
+    width: 90%;
+    max-height: 90vh;
+    overflow-y: auto;
+}
+
+.modal-content h2 {
+    margin-bottom: 20px;
+}
+
+.modal-content label {
+    display: block;
+    margin-bottom: 5px;
+    font-weight: bold;
+    color: #666;
+}
+
+.modal-content input[type="text"],
+.modal-content textarea {
+    width: 100%;
+    padding: 10px;
+    border: 2px solid #e0e0e0;
+    border-radius: 5px;
+    margin-bottom: 15px;
+    font-size: 14px;
+}
+
+.modal-content textarea {
+    min-height: 80px;
+    resize: vertical;
+}
+
+.modal-content input[type="checkbox"] {
+    margin-right: 8px;
+}
+
+.modal-actions {
+    display: flex;
+    gap: 10px;
+    justify-content: flex-end;
+    margin-top: 20px;
+}
+
+.nav-info {
+    display: flex;
+    align-items: center;
+    gap: 15px;
+}
+
+#user-info {
+    font-size: 0.9em;
+    color: #667eea;
+    background: rgba(255,255,255,0.1);
+    padding: 8px 12px;
+    border-radius: 20px;
+}
+
+.server-info {
+    display: grid;
+    grid-template-columns: 1fr 1fr;
+    gap: 20px;
+}
+
+.info-card {
+    background: #f8f9fa;
+    padding: 20px;
+    border-radius: 8px;
+    border: 1px solid #e9ecef;
+}
+
+.info-card h3 {
+    margin-bottom: 15px;
+    color: #495057;
+}
+
+.command-history {
+    max-height: 200px;
+    overflow-y: auto;
+    background: white;
+    border: 1px solid #e9ecef;
+    border-radius: 4px;
+    padding: 10px;
+}
+
+.command-item {
+    padding: 8px 0;
+    border-bottom: 1px solid #f8f9fa;
+    font-family: monospace;
+    font-size: 0.9em;
+}
+
+.command-item:last-child {
+    border-bottom: none;
+}
+
+.command-item .timestamp {
+    color: #6c757d;
+    font-size: 0.8em;
+}
+
+.login-info {
+    margin-top: 20px;
+    text-align: left;
+    background: rgba(255,255,255,0.1);
+    padding: 15px;
+    border-radius: 8px;
+}
+
+.login-info p {
+    margin: 5px 0;
+    font-size: 0.9em;
+    color: white;
+}

hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/dashboard/server.js

@@ -0,0 +1,21 @@
+require('dotenv').config();
+const express = require('express');
+const path = require('path');
+
+const app = express();
+const PORT = parseInt(process.env.DASHBOARD_PORT || '3000');
+
+app.use(express.static(path.join(__dirname, 'public')));
+
+app.get('/', (req, res) => {
+    res.sendFile(path.join(__dirname, 'public', 'index.html'));
+});
+
+app.listen(PORT, () => {
+    console.log('='.repeat(50));
+    console.log('🎮 Minecraft WebSocket API - 控制面板');
+    console.log('='.repeat(50));
+    console.log(`控制面板地址: http://localhost:${PORT}`);
+    console.log('请使用SuperKey登录');
+    console.log('='.repeat(50));
+});

hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/docker-compose.yml

@@ -0,0 +1,14 @@
+version: '3.8'
+
+services:
+  interconnect-server:
+    build: .
+    ports:
+      - "8000:8000"
+    environment:
+      - SERVER_HOST=0.0.0.0
+      - SERVER_PORT=8000
+      - DATABASE_PATH=/data/minecraft_ws.db
+    volumes:
+      - ./data:/data
+    restart: unless-stopped