Sync from GitHub (excluding README)

.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/.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/.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/.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/.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/.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/.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/.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/.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/.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/.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/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/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/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/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/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/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/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/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

hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/.gitattributes

@@ -0,0 +1,2 @@
+# Auto detect text files and perform LF normalization
+* text=auto

hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/package-lock.json

@@ -0,0 +1,675 @@
+{
+  "name": "interconnect-server-node",
+  "version": "1.0.0",
+  "lockfileVersion": 1,
+  "requires": true,
+  "dependencies": {
+    "accepts": {
+      "version": "1.3.8",
+      "resolved": "https://registry.npmjs.org/accepts/-/accepts-1.3.8.tgz",
+      "integrity": "sha512-PYAthTa2m2VKxuvSD3DPC/Gy+U+sOA1LAuT8mkmRuvw+NACSaeXEQ+NHcVF7rONl6qcaxV3Uuemwawk+7+SJLw==",
+      "requires": {
+        "mime-types": "~2.1.34",
+        "negotiator": "0.6.3"
+      }
+    },
+    "array-flatten": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/array-flatten/-/array-flatten-1.1.1.tgz",
+      "integrity": "sha512-PCVAQswWemu6UdxsDFFX/+gVeYqKAod3D3UVm91jHwynguOwAvYPhx8nNlM++NqRcK6CxxpUafjmhIdKiHibqg=="
+    },
+    "asynckit": {
+      "version": "0.4.0",
+      "resolved": "https://registry.npmjs.org/asynckit/-/asynckit-0.4.0.tgz",
+      "integrity": "sha512-Oei9OH4tRh0YqU3GxhX79dM/mwVgvbZJaSNaRk+bshkj0S5cfHcgYakreBjrHwatXKbz+IoIdYLxrKim2MjW0Q=="
+    },
+    "axios": {
+      "version": "1.13.2",
+      "resolved": "https://registry.npmjs.org/axios/-/axios-1.13.2.tgz",
+      "integrity": "sha512-VPk9ebNqPcy5lRGuSlKx752IlDatOjT9paPlm8A7yOuW2Fbvp4X3JznJtT4f0GzGLLiWE9W8onz51SqLYwzGaA==",
+      "requires": {
+        "follow-redirects": "^1.15.6",
+        "form-data": "^4.0.4",
+        "proxy-from-env": "^1.1.0"
+      }
+    },
+    "bcryptjs": {
+      "version": "2.4.3",
+      "resolved": "https://registry.npmjs.org/bcryptjs/-/bcryptjs-2.4.3.tgz",
+      "integrity": "sha512-V/Hy/X9Vt7f3BbPJEi8BdVFMByHi+jNXrYkW3huaybV/kQ0KJg0Y6PkEMbn+zeT+i+SiKZ/HMqJGIIt4LZDqNQ=="
+    },
+    "body-parser": {
+      "version": "1.20.4",
+      "resolved": "https://registry.npmjs.org/body-parser/-/body-parser-1.20.4.tgz",
+      "integrity": "sha512-ZTgYYLMOXY9qKU/57FAo8F+HA2dGX7bqGc71txDRC1rS4frdFI5R7NhluHxH6M0YItAP0sHB4uqAOcYKxO6uGA==",
+      "requires": {
+        "bytes": "~3.1.2",
+        "content-type": "~1.0.5",
+        "debug": "2.6.9",
+        "depd": "2.0.0",
+        "destroy": "~1.2.0",
+        "http-errors": "~2.0.1",
+        "iconv-lite": "~0.4.24",
+        "on-finished": "~2.4.1",
+        "qs": "~6.14.0",
+        "raw-body": "~2.5.3",
+        "type-is": "~1.6.18",
+        "unpipe": "~1.0.0"
+      },
+      "dependencies": {
+        "debug": {
+          "version": "2.6.9",
+          "resolved": "https://registry.npmjs.org/debug/-/debug-2.6.9.tgz",
+          "integrity": "sha512-bC7ElrdJaJnPbAP+1EotYvqZsb3ecl5wi6Bfi6BJTUcNowp6cvspg0jXznRTKDjm/E7AdgFBVeAPVMNcKGsHMA==",
+          "requires": {
+            "ms": "2.0.0"
+          }
+        },
+        "ms": {
+          "version": "2.0.0",
+          "resolved": "https://registry.npmjs.org/ms/-/ms-2.0.0.tgz",
+          "integrity": "sha512-Tpp60P6IUJDTuOq/5Z8cdskzJujfwqfOTkrwIwj7IRISpnkJnT6SyJ4PCPnGMoFjC9ddhal5KVIYtAt97ix05A=="
+        }
+      }
+    },
+    "bytes": {
+      "version": "3.1.2",
+      "resolved": "https://registry.npmjs.org/bytes/-/bytes-3.1.2.tgz",
+      "integrity": "sha512-/Nf7TyzTx6S3yRJObOAV7956r8cr2+Oj8AC5dt8wSP3BQAoeX58NoHyCU8P8zGkNXStjTSi6fzO6F0pBdcYbEg=="
+    },
+    "call-bind-apply-helpers": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/call-bind-apply-helpers/-/call-bind-apply-helpers-1.0.2.tgz",
+      "integrity": "sha512-Sp1ablJ0ivDkSzjcaJdxEunN5/XvksFJ2sMBFfq6x0ryhQV/2b/KwFe21cMpmHtPOSij8K99/wSfoEuTObmuMQ==",
+      "requires": {
+        "es-errors": "^1.3.0",
+        "function-bind": "^1.1.2"
+      }
+    },
+    "call-bound": {
+      "version": "1.0.4",
+      "resolved": "https://registry.npmjs.org/call-bound/-/call-bound-1.0.4.tgz",
+      "integrity": "sha512-+ys997U96po4Kx/ABpBCqhA9EuxJaQWDQg7295H4hBphv3IZg0boBKuwYpt4YXp6MZ5AmZQnU/tyMTlRpaSejg==",
+      "requires": {
+        "call-bind-apply-helpers": "^1.0.2",
+        "get-intrinsic": "^1.3.0"
+      }
+    },
+    "combined-stream": {
+      "version": "1.0.8",
+      "resolved": "https://registry.npmjs.org/combined-stream/-/combined-stream-1.0.8.tgz",
+      "integrity": "sha512-FQN4MRfuJeHf7cBbBMJFXhKSDq+2kAArBlmRBvcvFE5BB1HZKXtSFASDhdlz9zOYwxh8lDdnvmMOe/+5cdoEdg==",
+      "requires": {
+        "delayed-stream": "~1.0.0"
+      }
+    },
+    "commander": {
+      "version": "11.1.0",
+      "resolved": "https://registry.npmjs.org/commander/-/commander-11.1.0.tgz",
+      "integrity": "sha512-yPVavfyCcRhmorC7rWlkHn15b4wDVgVmBA7kV4QVBsF7kv/9TKJAbAXVTxvTnwP8HHKjRCJDClKbciiYS7p0DQ=="
+    },
+    "content-disposition": {
+      "version": "0.5.4",
+      "resolved": "https://registry.npmjs.org/content-disposition/-/content-disposition-0.5.4.tgz",
+      "integrity": "sha512-FveZTNuGw04cxlAiWbzi6zTAL/lhehaWbTtgluJh4/E95DqMwTmha3KZN1aAWA8cFIhHzMZUvLevkw5Rqk+tSQ==",
+      "requires": {
+        "safe-buffer": "5.2.1"
+      }
+    },
+    "content-type": {
+      "version": "1.0.5",
+      "resolved": "https://registry.npmjs.org/content-type/-/content-type-1.0.5.tgz",
+      "integrity": "sha512-nTjqfcBFEipKdXCv4YDQWCfmcLZKm81ldF0pAopTvyrFGVbcR6P/VAAd5G7N+0tTr8QqiU0tFadD6FK4NtJwOA=="
+    },
+    "cookie": {
+      "version": "0.7.2",
+      "resolved": "https://registry.npmjs.org/cookie/-/cookie-0.7.2.tgz",
+      "integrity": "sha512-yki5XnKuf750l50uGTllt6kKILY4nQ1eNIQatoXEByZ5dWgnKqbnqmTrBE5B4N7lrMJKQ2ytWMiTO2o0v6Ew/w=="
+    },
+    "cookie-signature": {
+      "version": "1.0.7",
+      "resolved": "https://registry.npmjs.org/cookie-signature/-/cookie-signature-1.0.7.tgz",
+      "integrity": "sha512-NXdYc3dLr47pBkpUCHtKSwIOQXLVn8dZEuywboCOJY/osA0wFSLlSawr3KN8qXJEyX66FcONTH8EIlVuK0yyFA=="
+    },
+    "delayed-stream": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/delayed-stream/-/delayed-stream-1.0.0.tgz",
+      "integrity": "sha512-ZySD7Nf91aLB0RxL4KGrKHBXl7Eds1DAmEdcoVawXnLD7SDhpNgtuII2aAkg7a7QS41jxPSZ17p4VdGnMHk3MQ=="
+    },
+    "depd": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/depd/-/depd-2.0.0.tgz",
+      "integrity": "sha512-g7nH6P6dyDioJogAAGprGpCtVImJhpPk/roCzdb3fIh61/s/nPsfR6onyMwkCAR/OlC3yBC0lESvUoQEAssIrw=="
+    },
+    "destroy": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/destroy/-/destroy-1.2.0.tgz",
+      "integrity": "sha512-2sJGJTaXIIaR1w4iJSNoN0hnMY7Gpc/n8D4qSCJw8QqFWXf7cuAgnEHxBpweaVcPevC2l3KpjYCx3NypQQgaJg=="
+    },
+    "dotenv": {
+      "version": "16.6.1",
+      "resolved": "https://registry.npmjs.org/dotenv/-/dotenv-16.6.1.tgz",
+      "integrity": "sha512-uBq4egWHTcTt33a72vpSG0z3HnPuIl6NqYcTrKEg2azoEyl2hpW0zqlxysq2pK9HlDIHyHyakeYaYnSAwd8bow=="
+    },
+    "dunder-proto": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/dunder-proto/-/dunder-proto-1.0.1.tgz",
+      "integrity": "sha512-KIN/nDJBQRcXw0MLVhZE9iQHmG68qAVIBg9CqmUYjmQIhgij9U5MFvrqkUL5FbtyyzZuOeOt0zdeRe4UY7ct+A==",
+      "requires": {
+        "call-bind-apply-helpers": "^1.0.1",
+        "es-errors": "^1.3.0",
+        "gopd": "^1.2.0"
+      }
+    },
+    "ee-first": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/ee-first/-/ee-first-1.1.1.tgz",
+      "integrity": "sha512-WMwm9LhRUo+WUaRN+vRuETqG89IgZphVSNkdFgeb6sS/E4OrDIN7t48CAewSHXc6C8lefD8KKfr5vY61brQlow=="
+    },
+    "encodeurl": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/encodeurl/-/encodeurl-2.0.0.tgz",
+      "integrity": "sha512-Q0n9HRi4m6JuGIV1eFlmvJB7ZEVxu93IrMyiMsGC0lrMJMWzRgx6WGquyfQgZVb31vhGgXnfmPNNXmxnOkRBrg=="
+    },
+    "es-define-property": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/es-define-property/-/es-define-property-1.0.1.tgz",
+      "integrity": "sha512-e3nRfgfUZ4rNGL232gUgX06QNyyez04KdjFrF+LTRoOXmrOgFKDg4BCdsjW8EnT69eqdYGmRpJwiPVYNrCaW3g=="
+    },
+    "es-errors": {
+      "version": "1.3.0",
+      "resolved": "https://registry.npmjs.org/es-errors/-/es-errors-1.3.0.tgz",
+      "integrity": "sha512-Zf5H2Kxt2xjTvbJvP2ZWLEICxA6j+hAmMzIlypy4xcBg1vKVnx89Wy0GbS+kf5cwCVFFzdCFh2XSCFNULS6csw=="
+    },
+    "es-object-atoms": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/es-object-atoms/-/es-object-atoms-1.1.1.tgz",
+      "integrity": "sha512-FGgH2h8zKNim9ljj7dankFPcICIK9Cp5bm+c2gQSYePhpaG5+esrLODihIorn+Pe6FGJzWhXQotPv73jTaldXA==",
+      "requires": {
+        "es-errors": "^1.3.0"
+      }
+    },
+    "es-set-tostringtag": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/es-set-tostringtag/-/es-set-tostringtag-2.1.0.tgz",
+      "integrity": "sha512-j6vWzfrGVfyXxge+O0x5sh6cvxAog0a/4Rdd2K36zCMV5eJ+/+tOAngRO8cODMNWbVRdVlmGZQL2YS3yR8bIUA==",
+      "requires": {
+        "es-errors": "^1.3.0",
+        "get-intrinsic": "^1.2.6",
+        "has-tostringtag": "^1.0.2",
+        "hasown": "^2.0.2"
+      }
+    },
+    "escape-html": {
+      "version": "1.0.3",
+      "resolved": "https://registry.npmjs.org/escape-html/-/escape-html-1.0.3.tgz",
+      "integrity": "sha512-NiSupZ4OeuGwr68lGIeym/ksIZMJodUGOSCZ/FSnTxcrekbvqrgdUxlJOMpijaKZVjAJrWrGs/6Jy8OMuyj9ow=="
+    },
+    "etag": {
+      "version": "1.8.1",
+      "resolved": "https://registry.npmjs.org/etag/-/etag-1.8.1.tgz",
+      "integrity": "sha512-aIL5Fx7mawVa300al2BnEE4iNvo1qETxLrPI/o05L7z6go7fCw1J6EQmbK4FmJ2AS7kgVF/KEZWufBfdClMcPg=="
+    },
+    "express": {
+      "version": "4.22.1",
+      "resolved": "https://registry.npmjs.org/express/-/express-4.22.1.tgz",
+      "integrity": "sha512-F2X8g9P1X7uCPZMA3MVf9wcTqlyNp7IhH5qPCI0izhaOIYXaW9L535tGA3qmjRzpH+bZczqq7hVKxTR4NWnu+g==",
+      "requires": {
+        "accepts": "~1.3.8",
+        "array-flatten": "1.1.1",
+        "body-parser": "~1.20.3",
+        "content-disposition": "~0.5.4",
+        "content-type": "~1.0.4",
+        "cookie": "~0.7.1",
+        "cookie-signature": "~1.0.6",
+        "debug": "2.6.9",
+        "depd": "2.0.0",
+        "encodeurl": "~2.0.0",
+        "escape-html": "~1.0.3",
+        "etag": "~1.8.1",
+        "finalhandler": "~1.3.1",
+        "fresh": "~0.5.2",
+        "http-errors": "~2.0.0",
+        "merge-descriptors": "1.0.3",
+        "methods": "~1.1.2",
+        "on-finished": "~2.4.1",
+        "parseurl": "~1.3.3",
+        "path-to-regexp": "~0.1.12",
+        "proxy-addr": "~2.0.7",
+        "qs": "~6.14.0",
+        "range-parser": "~1.2.1",
+        "safe-buffer": "5.2.1",
+        "send": "~0.19.0",
+        "serve-static": "~1.16.2",
+        "setprototypeof": "1.2.0",
+        "statuses": "~2.0.1",
+        "type-is": "~1.6.18",
+        "utils-merge": "1.0.1",
+        "vary": "~1.1.2"
+      },
+      "dependencies": {
+        "debug": {
+          "version": "2.6.9",
+          "resolved": "https://registry.npmjs.org/debug/-/debug-2.6.9.tgz",
+          "integrity": "sha512-bC7ElrdJaJnPbAP+1EotYvqZsb3ecl5wi6Bfi6BJTUcNowp6cvspg0jXznRTKDjm/E7AdgFBVeAPVMNcKGsHMA==",
+          "requires": {
+            "ms": "2.0.0"
+          }
+        },
+        "ms": {
+          "version": "2.0.0",
+          "resolved": "https://registry.npmjs.org/ms/-/ms-2.0.0.tgz",
+          "integrity": "sha512-Tpp60P6IUJDTuOq/5Z8cdskzJujfwqfOTkrwIwj7IRISpnkJnT6SyJ4PCPnGMoFjC9ddhal5KVIYtAt97ix05A=="
+        }
+      }
+    },
+    "finalhandler": {
+      "version": "1.3.2",
+      "resolved": "https://registry.npmjs.org/finalhandler/-/finalhandler-1.3.2.tgz",
+      "integrity": "sha512-aA4RyPcd3badbdABGDuTXCMTtOneUCAYH/gxoYRTZlIJdF0YPWuGqiAsIrhNnnqdXGswYk6dGujem4w80UJFhg==",
+      "requires": {
+        "debug": "2.6.9",
+        "encodeurl": "~2.0.0",
+        "escape-html": "~1.0.3",
+        "on-finished": "~2.4.1",
+        "parseurl": "~1.3.3",
+        "statuses": "~2.0.2",
+        "unpipe": "~1.0.0"
+      },
+      "dependencies": {
+        "debug": {
+          "version": "2.6.9",
+          "resolved": "https://registry.npmjs.org/debug/-/debug-2.6.9.tgz",
+          "integrity": "sha512-bC7ElrdJaJnPbAP+1EotYvqZsb3ecl5wi6Bfi6BJTUcNowp6cvspg0jXznRTKDjm/E7AdgFBVeAPVMNcKGsHMA==",
+          "requires": {
+            "ms": "2.0.0"
+          }
+        },
+        "ms": {
+          "version": "2.0.0",
+          "resolved": "https://registry.npmjs.org/ms/-/ms-2.0.0.tgz",
+          "integrity": "sha512-Tpp60P6IUJDTuOq/5Z8cdskzJujfwqfOTkrwIwj7IRISpnkJnT6SyJ4PCPnGMoFjC9ddhal5KVIYtAt97ix05A=="
+        }
+      }
+    },
+    "follow-redirects": {
+      "version": "1.15.11",
+      "resolved": "https://registry.npmjs.org/follow-redirects/-/follow-redirects-1.15.11.tgz",
+      "integrity": "sha512-deG2P0JfjrTxl50XGCDyfI97ZGVCxIpfKYmfyrQ54n5FO/0gfIES8C/Psl6kWVDolizcaaxZJnTS0QSMxvnsBQ=="
+    },
+    "form-data": {
+      "version": "4.0.5",
+      "resolved": "https://registry.npmjs.org/form-data/-/form-data-4.0.5.tgz",
+      "integrity": "sha512-8RipRLol37bNs2bhoV67fiTEvdTrbMUYcFTiy3+wuuOnUog2QBHCZWXDRijWQfAkhBj2Uf5UnVaiWwA5vdd82w==",
+      "requires": {
+        "asynckit": "^0.4.0",
+        "combined-stream": "^1.0.8",
+        "es-set-tostringtag": "^2.1.0",
+        "hasown": "^2.0.2",
+        "mime-types": "^2.1.12"
+      }
+    },
+    "forwarded": {
+      "version": "0.2.0",
+      "resolved": "https://registry.npmjs.org/forwarded/-/forwarded-0.2.0.tgz",
+      "integrity": "sha512-buRG0fpBtRHSTCOASe6hD258tEubFoRLb4ZNA6NxMVHNw2gOcwHo9wyablzMzOA5z9xA9L1KNjk/Nt6MT9aYow=="
+    },
+    "fresh": {
+      "version": "0.5.2",
+      "resolved": "https://registry.npmjs.org/fresh/-/fresh-0.5.2.tgz",
+      "integrity": "sha512-zJ2mQYM18rEFOudeV4GShTGIQ7RbzA7ozbU9I/XBpm7kqgMywgmylMwXHxZJmkVoYkna9d2pVXVXPdYTP9ej8Q=="
+    },
+    "function-bind": {
+      "version": "1.1.2",
+      "resolved": "https://registry.npmjs.org/function-bind/-/function-bind-1.1.2.tgz",
+      "integrity": "sha512-7XHNxH7qX9xG5mIwxkhumTox/MIRNcOgDrxWsMt2pAr23WHp6MrRlN7FBSFpCpr+oVO0F744iUgR82nJMfG2SA=="
+    },
+    "get-intrinsic": {
+      "version": "1.3.0",
+      "resolved": "https://registry.npmjs.org/get-intrinsic/-/get-intrinsic-1.3.0.tgz",
+      "integrity": "sha512-9fSjSaos/fRIVIp+xSJlE6lfwhES7LNtKaCBIamHsjr2na1BiABJPo0mOjjz8GJDURarmCPGqaiVg5mfjb98CQ==",
+      "requires": {
+        "call-bind-apply-helpers": "^1.0.2",
+        "es-define-property": "^1.0.1",
+        "es-errors": "^1.3.0",
+        "es-object-atoms": "^1.1.1",
+        "function-bind": "^1.1.2",
+        "get-proto": "^1.0.1",
+        "gopd": "^1.2.0",
+        "has-symbols": "^1.1.0",
+        "hasown": "^2.0.2",
+        "math-intrinsics": "^1.1.0"
+      }
+    },
+    "get-proto": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/get-proto/-/get-proto-1.0.1.tgz",
+      "integrity": "sha512-sTSfBjoXBp89JvIKIefqw7U2CCebsc74kiY6awiGogKtoSGbgjYE/G/+l9sF3MWFPNc9IcoOC4ODfKHfxFmp0g==",
+      "requires": {
+        "dunder-proto": "^1.0.1",
+        "es-object-atoms": "^1.0.0"
+      }
+    },
+    "gopd": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/gopd/-/gopd-1.2.0.tgz",
+      "integrity": "sha512-ZUKRh6/kUFoAiTAtTYPZJ3hw9wNxx+BIBOijnlG9PnrJsCcSjs1wyyD6vJpaYtgnzDrKYRSqf3OO6Rfa93xsRg=="
+    },
+    "has-symbols": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/has-symbols/-/has-symbols-1.1.0.tgz",
+      "integrity": "sha512-1cDNdwJ2Jaohmb3sg4OmKaMBwuC48sYni5HUw2DvsC8LjGTLK9h+eb1X6RyuOHe4hT0ULCW68iomhjUoKUqlPQ=="
+    },
+    "has-tostringtag": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/has-tostringtag/-/has-tostringtag-1.0.2.tgz",
+      "integrity": "sha512-NqADB8VjPFLM2V0VvHUewwwsw0ZWBaIdgo+ieHtK3hasLz4qeCRjYcqfB6AQrBggRKppKF8L52/VqdVsO47Dlw==",
+      "requires": {
+        "has-symbols": "^1.0.3"
+      }
+    },
+    "hasown": {
+      "version": "2.0.2",
+      "resolved": "https://registry.npmjs.org/hasown/-/hasown-2.0.2.tgz",
+      "integrity": "sha512-0hJU9SCPvmMzIBdZFqNPXWa6dqh7WdH0cII9y+CyS8rG3nL48Bclra9HmKhVVUHyPWNH5Y7xDwAB7bfgSjkUMQ==",
+      "requires": {
+        "function-bind": "^1.1.2"
+      }
+    },
+    "http-errors": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/http-errors/-/http-errors-2.0.1.tgz",
+      "integrity": "sha512-4FbRdAX+bSdmo4AUFuS0WNiPz8NgFt+r8ThgNWmlrjQjt1Q7ZR9+zTlce2859x4KSXrwIsaeTqDoKQmtP8pLmQ==",
+      "requires": {
+        "depd": "~2.0.0",
+        "inherits": "~2.0.4",
+        "setprototypeof": "~1.2.0",
+        "statuses": "~2.0.2",
+        "toidentifier": "~1.0.1"
+      }
+    },
+    "iconv-lite": {
+      "version": "0.4.24",
+      "resolved": "https://registry.npmjs.org/iconv-lite/-/iconv-lite-0.4.24.tgz",
+      "integrity": "sha512-v3MXnZAcvnywkTUEZomIActle7RXXeedOR31wwl7VlyoXO4Qi9arvSenNQWne1TcRwhCL1HwLI21bEqdpj8/rA==",
+      "requires": {
+        "safer-buffer": ">= 2.1.2 < 3"
+      }
+    },
+    "inherits": {
+      "version": "2.0.4",
+      "resolved": "https://registry.npmjs.org/inherits/-/inherits-2.0.4.tgz",
+      "integrity": "sha512-k/vGaX4/Yla3WzyMCvTQOXYeIHvqOKtnqBduzTHpzpQZzAskKMhZ2K+EnBiSM9zGSoIFeMpXKxa4dYeZIQqewQ=="
+    },
+    "ipaddr.js": {
+      "version": "1.9.1",
+      "resolved": "https://registry.npmjs.org/ipaddr.js/-/ipaddr.js-1.9.1.tgz",
+      "integrity": "sha512-0KI/607xoxSToH7GjN1FfSbLoU0+btTicjsQSWQlh/hZykN8KpmMf7uYwPW3R+akZ6R/w18ZlXSHBYXiYUPO3g=="
+    },
+    "math-intrinsics": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/math-intrinsics/-/math-intrinsics-1.1.0.tgz",
+      "integrity": "sha512-/IXtbwEk5HTPyEwyKX6hGkYXxM9nbj64B+ilVJnC/R6B0pH5G4V3b0pVbL7DBj4tkhBAppbQUlf6F6Xl9LHu1g=="
+    },
+    "media-typer": {
+      "version": "0.3.0",
+      "resolved": "https://registry.npmjs.org/media-typer/-/media-typer-0.3.0.tgz",
+      "integrity": "sha512-dq+qelQ9akHpcOl/gUVRTxVIOkAJ1wR3QAvb4RsVjS8oVoFjDGTc679wJYmUmknUF5HwMLOgb5O+a3KxfWapPQ=="
+    },
+    "merge-descriptors": {
+      "version": "1.0.3",
+      "resolved": "https://registry.npmjs.org/merge-descriptors/-/merge-descriptors-1.0.3.tgz",
+      "integrity": "sha512-gaNvAS7TZ897/rVaZ0nMtAyxNyi/pdbjbAwUpFQpN70GqnVfOiXpeUUMKRBmzXaSQ8DdTX4/0ms62r2K+hE6mQ=="
+    },
+    "methods": {
+      "version": "1.1.2",
+      "resolved": "https://registry.npmjs.org/methods/-/methods-1.1.2.tgz",
+      "integrity": "sha512-iclAHeNqNm68zFtnZ0e+1L2yUIdvzNoauKU4WBA3VvH/vPFieF7qfRlwUZU+DA9P9bPXIS90ulxoUoCH23sV2w=="
+    },
+    "mime": {
+      "version": "1.6.0",
+      "resolved": "https://registry.npmjs.org/mime/-/mime-1.6.0.tgz",
+      "integrity": "sha512-x0Vn8spI+wuJ1O6S7gnbaQg8Pxh4NNHb7KSINmEWKiPE4RKOplvijn+NkmYmmRgP68mc70j2EbeTFRsrswaQeg=="
+    },
+    "mime-db": {
+      "version": "1.52.0",
+      "resolved": "https://registry.npmjs.org/mime-db/-/mime-db-1.52.0.tgz",
+      "integrity": "sha512-sPU4uV7dYlvtWJxwwxHD0PuihVNiE7TyAbQ5SWxDCB9mUYvOgroQOwYQQOKPJ8CIbE+1ETVlOoK1UC2nU3gYvg=="
+    },
+    "mime-types": {
+      "version": "2.1.35",
+      "resolved": "https://registry.npmjs.org/mime-types/-/mime-types-2.1.35.tgz",
+      "integrity": "sha512-ZDY+bPm5zTTF+YpCrAU9nK0UgICYPT0QtT1NZWFv4s++TNkcgVaT0g6+4R2uI4MjQjzysHB1zxuWL50hzaeXiw==",
+      "requires": {
+        "mime-db": "1.52.0"
+      }
+    },
+    "ms": {
+      "version": "2.1.3",
+      "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz",
+      "integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA=="
+    },
+    "negotiator": {
+      "version": "0.6.3",
+      "resolved": "https://registry.npmjs.org/negotiator/-/negotiator-0.6.3.tgz",
+      "integrity": "sha512-+EUsqGPLsM+j/zdChZjsnX51g4XrHFOIXwfnCVPGlQk/k5giakcKsuxCObBRu6DSm9opw/O6slWbJdghQM4bBg=="
+    },
+    "object-inspect": {
+      "version": "1.13.4",
+      "resolved": "https://registry.npmjs.org/object-inspect/-/object-inspect-1.13.4.tgz",
+      "integrity": "sha512-W67iLl4J2EXEGTbfeHCffrjDfitvLANg0UlX3wFUUSTx92KXRFegMHUVgSqE+wvhAbi4WqjGg9czysTV2Epbew=="
+    },
+    "on-finished": {
+      "version": "2.4.1",
+      "resolved": "https://registry.npmjs.org/on-finished/-/on-finished-2.4.1.tgz",
+      "integrity": "sha512-oVlzkg3ENAhCk2zdv7IJwd/QUD4z2RxRwpkcGY8psCVcCYZNq4wYnVWALHM+brtuJjePWiYF/ClmuDr8Ch5+kg==",
+      "requires": {
+        "ee-first": "1.1.1"
+      }
+    },
+    "parseurl": {
+      "version": "1.3.3",
+      "resolved": "https://registry.npmjs.org/parseurl/-/parseurl-1.3.3.tgz",
+      "integrity": "sha512-CiyeOxFT/JZyN5m0z9PfXw4SCBJ6Sygz1Dpl0wqjlhDEGGBP1GnsUVEL0p63hoG1fcj3fHynXi9NYO4nWOL+qQ=="
+    },
+    "path-to-regexp": {
+      "version": "0.1.12",
+      "resolved": "https://registry.npmjs.org/path-to-regexp/-/path-to-regexp-0.1.12.tgz",
+      "integrity": "sha512-RA1GjUVMnvYFxuqovrEqZoxxW5NUZqbwKtYz/Tt7nXerk0LbLblQmrsgdeOxV5SFHf0UDggjS/bSeOZwt1pmEQ=="
+    },
+    "proxy-addr": {
+      "version": "2.0.7",
+      "resolved": "https://registry.npmjs.org/proxy-addr/-/proxy-addr-2.0.7.tgz",
+      "integrity": "sha512-llQsMLSUDUPT44jdrU/O37qlnifitDP+ZwrmmZcoSKyLKvtZxpyV0n2/bD/N4tBAAZ/gJEdZU7KMraoK1+XYAg==",
+      "requires": {
+        "forwarded": "0.2.0",
+        "ipaddr.js": "1.9.1"
+      }
+    },
+    "proxy-from-env": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/proxy-from-env/-/proxy-from-env-1.1.0.tgz",
+      "integrity": "sha512-D+zkORCbA9f1tdWRK0RaCR3GPv50cMxcrz4X8k5LTSUD1Dkw47mKJEZQNunItRTkWwgtaUSo1RVFRIG9ZXiFYg=="
+    },
+    "qs": {
+      "version": "6.14.1",
+      "resolved": "https://registry.npmjs.org/qs/-/qs-6.14.1.tgz",
+      "integrity": "sha512-4EK3+xJl8Ts67nLYNwqw/dsFVnCf+qR7RgXSK9jEEm9unao3njwMDdmsdvoKBKHzxd7tCYz5e5M+SnMjdtXGQQ==",
+      "requires": {
+        "side-channel": "^1.1.0"
+      }
+    },
+    "range-parser": {
+      "version": "1.2.1",
+      "resolved": "https://registry.npmjs.org/range-parser/-/range-parser-1.2.1.tgz",
+      "integrity": "sha512-Hrgsx+orqoygnmhFbKaHE6c296J+HTAQXoxEF6gNupROmmGJRoyzfG3ccAveqCBrwr/2yxQ5BVd/GTl5agOwSg=="
+    },
+    "raw-body": {
+      "version": "2.5.3",
+      "resolved": "https://registry.npmjs.org/raw-body/-/raw-body-2.5.3.tgz",
+      "integrity": "sha512-s4VSOf6yN0rvbRZGxs8Om5CWj6seneMwK3oDb4lWDH0UPhWcxwOWw5+qk24bxq87szX1ydrwylIOp2uG1ojUpA==",
+      "requires": {
+        "bytes": "~3.1.2",
+        "http-errors": "~2.0.1",
+        "iconv-lite": "~0.4.24",
+        "unpipe": "~1.0.0"
+      }
+    },
+    "safe-buffer": {
+      "version": "5.2.1",
+      "resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.2.1.tgz",
+      "integrity": "sha512-rp3So07KcdmmKbGvgaNxQSJr7bGVSVk5S9Eq1F+ppbRo70+YeaDxkw5Dd8NPN+GD6bjnYm2VuPuCXmpuYvmCXQ=="
+    },
+    "safer-buffer": {
+      "version": "2.1.2",
+      "resolved": "https://registry.npmjs.org/safer-buffer/-/safer-buffer-2.1.2.tgz",
+      "integrity": "sha512-YZo3K82SD7Riyi0E1EQPojLz7kpepnSQI9IyPbHHg1XXXevb5dJI7tpyN2ADxGcQbHG7vcyRHk0cbwqcQriUtg=="
+    },
+    "send": {
+      "version": "0.19.2",
+      "resolved": "https://registry.npmjs.org/send/-/send-0.19.2.tgz",
+      "integrity": "sha512-VMbMxbDeehAxpOtWJXlcUS5E8iXh6QmN+BkRX1GARS3wRaXEEgzCcB10gTQazO42tpNIya8xIyNx8fll1OFPrg==",
+      "requires": {
+        "debug": "2.6.9",
+        "depd": "2.0.0",
+        "destroy": "1.2.0",
+        "encodeurl": "~2.0.0",
+        "escape-html": "~1.0.3",
+        "etag": "~1.8.1",
+        "fresh": "~0.5.2",
+        "http-errors": "~2.0.1",
+        "mime": "1.6.0",
+        "ms": "2.1.3",
+        "on-finished": "~2.4.1",
+        "range-parser": "~1.2.1",
+        "statuses": "~2.0.2"
+      },
+      "dependencies": {
+        "debug": {
+          "version": "2.6.9",
+          "resolved": "https://registry.npmjs.org/debug/-/debug-2.6.9.tgz",
+          "integrity": "sha512-bC7ElrdJaJnPbAP+1EotYvqZsb3ecl5wi6Bfi6BJTUcNowp6cvspg0jXznRTKDjm/E7AdgFBVeAPVMNcKGsHMA==",
+          "requires": {
+            "ms": "2.0.0"
+          },
+          "dependencies": {
+            "ms": {
+              "version": "2.0.0",
+              "resolved": "https://registry.npmjs.org/ms/-/ms-2.0.0.tgz",
+              "integrity": "sha512-Tpp60P6IUJDTuOq/5Z8cdskzJujfwqfOTkrwIwj7IRISpnkJnT6SyJ4PCPnGMoFjC9ddhal5KVIYtAt97ix05A=="
+            }
+          }
+        }
+      }
+    },
+    "serve-static": {
+      "version": "1.16.3",
+      "resolved": "https://registry.npmjs.org/serve-static/-/serve-static-1.16.3.tgz",
+      "integrity": "sha512-x0RTqQel6g5SY7Lg6ZreMmsOzncHFU7nhnRWkKgWuMTu5NN0DR5oruckMqRvacAN9d5w6ARnRBXl9xhDCgfMeA==",
+      "requires": {
+        "encodeurl": "~2.0.0",
+        "escape-html": "~1.0.3",
+        "parseurl": "~1.3.3",
+        "send": "~0.19.1"
+      }
+    },
+    "setprototypeof": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/setprototypeof/-/setprototypeof-1.2.0.tgz",
+      "integrity": "sha512-E5LDX7Wrp85Kil5bhZv46j8jOeboKq5JMmYM3gVGdGH8xFpPWXUMsNrlODCrkoxMEeNi/XZIwuRvY4XNwYMJpw=="
+    },
+    "side-channel": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/side-channel/-/side-channel-1.1.0.tgz",
+      "integrity": "sha512-ZX99e6tRweoUXqR+VBrslhda51Nh5MTQwou5tnUDgbtyM0dBgmhEDtWGP/xbKn6hqfPRHujUNwz5fy/wbbhnpw==",
+      "requires": {
+        "es-errors": "^1.3.0",
+        "object-inspect": "^1.13.3",
+        "side-channel-list": "^1.0.0",
+        "side-channel-map": "^1.0.1",
+        "side-channel-weakmap": "^1.0.2"
+      }
+    },
+    "side-channel-list": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/side-channel-list/-/side-channel-list-1.0.0.tgz",
+      "integrity": "sha512-FCLHtRD/gnpCiCHEiJLOwdmFP+wzCmDEkc9y7NsYxeF4u7Btsn1ZuwgwJGxImImHicJArLP4R0yX4c2KCrMrTA==",
+      "requires": {
+        "es-errors": "^1.3.0",
+        "object-inspect": "^1.13.3"
+      }
+    },
+    "side-channel-map": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/side-channel-map/-/side-channel-map-1.0.1.tgz",
+      "integrity": "sha512-VCjCNfgMsby3tTdo02nbjtM/ewra6jPHmpThenkTYh8pG9ucZ/1P8So4u4FGBek/BjpOVsDCMoLA/iuBKIFXRA==",
+      "requires": {
+        "call-bound": "^1.0.2",
+        "es-errors": "^1.3.0",
+        "get-intrinsic": "^1.2.5",
+        "object-inspect": "^1.13.3"
+      }
+    },
+    "side-channel-weakmap": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/side-channel-weakmap/-/side-channel-weakmap-1.0.2.tgz",
+      "integrity": "sha512-WPS/HvHQTYnHisLo9McqBHOJk2FkHO/tlpvldyrnem4aeQp4hai3gythswg6p01oSoTl58rcpiFAjF2br2Ak2A==",
+      "requires": {
+        "call-bound": "^1.0.2",
+        "es-errors": "^1.3.0",
+        "get-intrinsic": "^1.2.5",
+        "object-inspect": "^1.13.3",
+        "side-channel-map": "^1.0.1"
+      }
+    },
+    "sql.js": {
+      "version": "1.13.0",
+      "resolved": "https://registry.npmjs.org/sql.js/-/sql.js-1.13.0.tgz",
+      "integrity": "sha512-RJbVP1HRDlUUXahJ7VMTcu9Rm1Nzw+EBpoPr94vnbD4LwR715F3CcxE2G2k45PewcaZ57pjetYa+LoSJLAASgA=="
+    },
+    "statuses": {
+      "version": "2.0.2",
+      "resolved": "https://registry.npmjs.org/statuses/-/statuses-2.0.2.tgz",
+      "integrity": "sha512-DvEy55V3DB7uknRo+4iOGT5fP1slR8wQohVdknigZPMpMstaKJQWhwiYBACJE3Ul2pTnATihhBYnRhZQHGBiRw=="
+    },
+    "toidentifier": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/toidentifier/-/toidentifier-1.0.1.tgz",
+      "integrity": "sha512-o5sSPKEkg/DIQNmH43V0/uerLrpzVedkUh8tGNvaeXpfpuwjKenlSox/2O/BTlZUtEe+JG7s5YhEz608PlAHRA=="
+    },
+    "type-is": {
+      "version": "1.6.18",
+      "resolved": "https://registry.npmjs.org/type-is/-/type-is-1.6.18.tgz",
+      "integrity": "sha512-TkRKr9sUTxEH8MdfuCSP7VizJyzRNMjj2J2do2Jr3Kym598JVdEksuzPQCnlFPW4ky9Q+iA+ma9BGm06XQBy8g==",
+      "requires": {
+        "media-typer": "0.3.0",
+        "mime-types": "~2.1.24"
+      }
+    },
+    "unpipe": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/unpipe/-/unpipe-1.0.0.tgz",
+      "integrity": "sha512-pjy2bYhSsufwWlKwPc+l3cN7+wuJlK6uz0YdJEOlQDbl6jo/YlPi4mb8agUkVC8BF7V8NuzeyPNqRksA3hztKQ=="
+    },
+    "utils-merge": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/utils-merge/-/utils-merge-1.0.1.tgz",
+      "integrity": "sha512-pMZTvIkT1d+TFGvDOqodOclx0QWkkgi6Tdoa8gC8ffGAAqz9pzPTZWAybbsHHoED/ztMtkv/VoYTYyShUn81hA=="
+    },
+    "uuid": {
+      "version": "9.0.1",
+      "resolved": "https://registry.npmjs.org/uuid/-/uuid-9.0.1.tgz",
+      "integrity": "sha512-b+1eJOlsR9K8HJpow9Ok3fiWOWSIcIzXodvv0rQjVoOVNpWMpxf1wZNpt4y9h10odCNrqnYp1OBzRktckBe3sA=="
+    },
+    "vary": {
+      "version": "1.1.2",
+      "resolved": "https://registry.npmjs.org/vary/-/vary-1.1.2.tgz",
+      "integrity": "sha512-BNGbWLfd0eUPabhkXUVm0j8uuvREyTh5ovRa/dyow/BqAbZJyC+5fU+IzQOzmAKzYqYRAISoRhdQr3eIZ/PXqg=="
+    },
+    "ws": {
+      "version": "8.19.0",
+      "resolved": "https://registry.npmjs.org/ws/-/ws-8.19.0.tgz",
+      "integrity": "sha512-blAT2mjOEIi0ZzruJfIhb3nps74PRWTCz1IjglWEEpQl5XS/UNama6u2/rjFkDDouqr4L67ry+1aGIALViWjDg=="
+    }
+  }
+}

hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "interconnect-server",
+  "version": "1.0.0",
+  "description": "InterConnect-Server - Minecraft WebSocket API Server",
+  "author": "",
+  "license": "MIT",
+  "main": "src/server.js",
+  "scripts": {
+    "start": "node src/server.js",
+    "dev": "node --watch src/server.js",
+    "cli": "node cli/cli.js",
+    "dashboard": "node dashboard/server.js"
+  },
+  "keywords": [
+    "minecraft",
+    "websocket",
+    "api"
+  ],
+  "author": "",
+  "license": "MIT",
+  "dependencies": {
+    "axios": "^1.13.2",
+    "bcryptjs": "^2.4.3",
+    "commander": "^11.1.0",
+    "dotenv": "^16.3.1",
+    "express": "^4.18.2",
+    "sql.js": "^1.10.3",
+    "uuid": "^9.0.1",
+    "ws": "^8.14.2"
+  }
+}

hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/src/auth.js

@@ -0,0 +1,83 @@
+const { KEY_TYPE_ADMIN, KEY_TYPE_SERVER, KEY_TYPE_REGULAR } = require('./database');
+
+function verifyApiKey(db) {
+    return async (req, res, next) => {
+        const authHeader = req.headers.authorization;
+        
+        if (!authHeader || !authHeader.startsWith('Bearer ')) {
+            return res.status(401).json({ detail: 'Invalid API Key' });
+        }
+        
+        const token = authHeader.substring(7);
+        const result = await db.verifyApiKey(token);
+        
+        if (!result) {
+            return res.status(401).json({ detail: 'Invalid API Key' });
+        }
+        
+        req.apiKey = result;
+        next();
+    };
+}
+
+function requireAdminKey(req, res, next) {
+    if (!req.apiKey || req.apiKey.keyType !== KEY_TYPE_ADMIN) {
+        return res.status(403).json({ detail: 'Operation requires an Admin Key' });
+    }
+    next();
+}
+
+function requireRegularOrAdminKey(req, res, next) {
+    if (!req.apiKey || (req.apiKey.keyType !== KEY_TYPE_ADMIN && req.apiKey.keyType !== KEY_TYPE_REGULAR)) {
+        return res.status(403).json({ detail: 'Operation requires a Regular Key or Admin Key' });
+    }
+    next();
+}
+
+function requireRegularKeyForOwnServerKeys(db) {
+    return async (req, res, next) => {
+        requireRegularOrAdminKey(req, res, async () => {
+            const keyId = req.params.key_id;
+            const keyInfo = db.getApiKeyDetailsById(keyId);
+            
+            if (!keyInfo) {
+                return res.status(404).json({ detail: 'Key not found' });
+            }
+            
+            // Admin可以管理所有密钥
+            if (req.apiKey.keyType === KEY_TYPE_ADMIN) {
+                return next();
+            }
+            
+            // Regular Key只能管理自己关联的Server Key
+            if (req.apiKey.keyType === KEY_TYPE_REGULAR && keyInfo.regularKeyId === req.apiKey.id) {
+                return next();
+            }
+            
+            return res.status(403).json({ detail: 'Operation not permitted for this key' });
+        });
+    };
+}
+
+function requireServerKey(req, res, next) {
+    if (!req.apiKey || (req.apiKey.keyType !== KEY_TYPE_ADMIN && req.apiKey.keyType !== KEY_TYPE_SERVER)) {
+        return res.status(403).json({ detail: 'Operation requires a Server Key or Admin Key' });
+    }
+    next();
+}
+
+function requireAnyKey(req, res, next) {
+    if (!req.apiKey) {
+        return res.status(401).json({ detail: 'Authentication required' });
+    }
+    next();
+}
+
+module.exports = {
+    verifyApiKey,
+    requireAdminKey,
+    requireServerKey,
+    requireRegularOrAdminKey,
+    requireRegularKeyForOwnServerKeys,
+    requireAnyKey
+};

hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/src/database.js

@@ -0,0 +1,367 @@
+const initSqlJs = require('sql.js');
+const fs = require('fs');
+const path = require('path');
+const bcrypt = require('bcryptjs');
+const { v4: uuidv4 } = require('uuid');
+
+const KEY_PREFIX_ADMIN = 'mc_admin_';
+const KEY_PREFIX_SERVER = 'mc_server_';
+const KEY_PREFIX_REGULAR = 'mc_key_';
+
+const KEY_TYPE_ADMIN = 'admin';
+const KEY_TYPE_SERVER = 'server';
+const KEY_TYPE_REGULAR = 'regular';
+
+class Database {
+    constructor(dbPath = 'minecraft_ws.db') {
+        this.dbPath = dbPath;
+        this.db = null;
+    }
+
+    async init() {
+        const SQL = await initSqlJs();
+        
+        if (fs.existsSync(this.dbPath)) {
+            const buffer = fs.readFileSync(this.dbPath);
+            this.db = new SQL.Database(buffer);
+        } else {
+            this.db = new SQL.Database();
+        }
+        
+        this.initDbStructure();
+        this.save();
+    }
+
+    initDbStructure() {
+        this.db.run(`
+            CREATE TABLE IF NOT EXISTS api_keys (
+                id TEXT PRIMARY KEY,
+                name TEXT NOT NULL,
+                description TEXT,
+                key_hash TEXT NOT NULL UNIQUE,
+                key_prefix TEXT NOT NULL,
+                key_type TEXT NOT NULL,
+                server_id TEXT,
+                regular_key_id TEXT,
+                created_at TEXT NOT NULL,
+                last_used TEXT,
+                is_active INTEGER DEFAULT 1
+            )
+        `);
+
+        this.db.run(`
+            CREATE TABLE IF NOT EXISTS event_logs (
+                id INTEGER PRIMARY KEY AUTOINCREMENT,
+                event_type TEXT NOT NULL,
+                server_name TEXT NOT NULL,
+                timestamp TEXT NOT NULL,
+                data TEXT NOT NULL,
+                api_key_id TEXT,
+                FOREIGN KEY (api_key_id) REFERENCES api_keys (id)
+            )
+        `);
+    }
+
+    save() {
+        const data = this.db.export();
+        const buffer = Buffer.from(data);
+        fs.writeFileSync(this.dbPath, buffer);
+    }
+
+    generateRandomRawKeyString(prefix) {
+        return `${prefix}${uuidv4().replace(/-/g, '')}`;
+    }
+
+    async ensureInitialAdminKey() {
+        const stmt = this.db.prepare('SELECT 1 FROM api_keys WHERE key_type = ? LIMIT 1');
+        stmt.bind([KEY_TYPE_ADMIN]);
+        const adminKeyExists = stmt.step();
+        stmt.free();
+
+        if (!adminKeyExists) {
+            const generatedRawAdminKey = this.generateRandomRawKeyString(KEY_PREFIX_ADMIN);
+            const adminKeyName = 'Auto-Generated Admin Key';
+            const adminKeyDescription = `Auto-generated on ${new Date().toISOString()}`;
+            
+            const keyId = uuidv4();
+            const keyHash = await bcrypt.hash(generatedRawAdminKey, 10);
+            const createdAt = new Date().toISOString();
+            
+            try {
+                this.db.run(
+                    'INSERT INTO api_keys (id, name, description, key_hash, key_prefix, key_type, created_at, is_active) VALUES (?, ?, ?, ?, ?, ?, ?, 1)',
+                    [keyId, adminKeyName, adminKeyDescription, keyHash, KEY_PREFIX_ADMIN, KEY_TYPE_ADMIN, createdAt]
+                );
+                this.save();
+                return { name: adminKeyName, key: generatedRawAdminKey };
+            } catch (error) {
+                console.error('Error creating initial Admin Key:', error);
+                return null;
+            }
+        }
+        return null;
+    }
+
+    async createRegularKeyWithServerKey(name, description = '', serverId = null) {
+        const regularKeyId = uuidv4();
+        const serverKeyId = uuidv4();
+        
+        // 创建Regular Key
+        const regularRawKey = this.generateRandomRawKeyString(KEY_PREFIX_REGULAR);
+        const regularKeyHash = await bcrypt.hash(regularRawKey, 10);
+        
+        // 创建Server Key
+        const serverRawKey = this.generateRandomRawKeyString(KEY_PREFIX_SERVER);
+        const serverKeyHash = await bcrypt.hash(serverRawKey, 10);
+        
+        const createdAt = new Date().toISOString();
+        
+        try {
+            // 开始事务
+            this.db.exec('BEGIN TRANSACTION');
+            
+            // 插入Regular Key
+            this.db.run(
+                'INSERT INTO api_keys (id, name, description, key_hash, key_prefix, key_type, server_id, created_at, is_active) VALUES (?, ?, ?, ?, ?, ?, ?, ?, 1)',
+                [regularKeyId, name, description, regularKeyHash, KEY_PREFIX_REGULAR, KEY_TYPE_REGULAR, serverId, createdAt]
+            );
+            
+            // 插入关联的Server Key
+            this.db.run(
+                'INSERT INTO api_keys (id, name, description, key_hash, key_prefix, key_type, server_id, regular_key_id, created_at, is_active) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, 1)',
+                [serverKeyId, `${name} - Server Key`, `Server Key for ${name}`, serverKeyHash, KEY_PREFIX_SERVER, KEY_TYPE_SERVER, serverId, regularKeyId, createdAt]
+            );
+            
+            // 提交事务
+            this.db.exec('COMMIT');
+            this.save();
+            
+            return {
+                regularKey: {
+                    id: regularKeyId,
+                    rawKey: regularRawKey,
+                    keyPrefix: KEY_PREFIX_REGULAR,
+                    keyType: KEY_TYPE_REGULAR,
+                    serverId
+                },
+                serverKey: {
+                    id: serverKeyId,
+                    rawKey: serverRawKey,
+                    keyPrefix: KEY_PREFIX_SERVER,
+                    keyType: KEY_TYPE_SERVER,
+                    serverId,
+                    regularKeyId
+                }
+            };
+        } catch (error) {
+            this.db.exec('ROLLBACK');
+            throw new Error('Could not generate unique API key hash');
+        }
+    }
+
+    async createApiKey(name, description = '', keyType = KEY_TYPE_REGULAR, serverId = null, regularKeyId = null) {
+        const keyId = uuidv4();
+        let prefix;
+        
+        switch(keyType) {
+            case KEY_TYPE_ADMIN:
+                prefix = KEY_PREFIX_ADMIN;
+                break;
+            case KEY_TYPE_SERVER:
+                prefix = KEY_PREFIX_SERVER;
+                break;
+            default:
+                prefix = KEY_PREFIX_REGULAR;
+        }
+        
+        const rawKey = this.generateRandomRawKeyString(prefix);
+        const keyHash = await bcrypt.hash(rawKey, 10);
+        const createdAt = new Date().toISOString();
+
+        try {
+            this.db.run(
+                'INSERT INTO api_keys (id, name, description, key_hash, key_prefix, key_type, server_id, regular_key_id, created_at, is_active) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, 1)',
+                [keyId, name, description, keyHash, prefix, keyType, serverId, regularKeyId, createdAt]
+            );
+            this.save();
+            return { keyId, rawKey, keyPrefix: prefix, keyType, serverId, regularKeyId };
+        } catch (error) {
+            throw new Error('Could not generate unique API key hash');
+        }
+    }
+
+    async verifyApiKey(keyToCheck) {
+        const stmt = this.db.prepare('SELECT id, key_hash, key_type, server_id, regular_key_id FROM api_keys WHERE is_active = 1');
+        
+        while (stmt.step()) {
+            const row = stmt.getAsObject();
+            const isValid = await bcrypt.compare(keyToCheck, row.key_hash);
+            
+            if (isValid) {
+                stmt.free();
+                
+                this.db.run(
+                    'UPDATE api_keys SET last_used = ? WHERE id = ?',
+                    [new Date().toISOString(), row.id]
+                );
+                this.save();
+                
+                return { 
+                    id: row.id, 
+                    keyType: row.key_type,
+                    serverId: row.server_id,
+                    regularKeyId: row.regular_key_id
+                };
+            }
+        }
+        
+        stmt.free();
+        return null;
+    }
+
+    getApiKeyDetailsById(keyId) {
+        const stmt = this.db.prepare(
+            'SELECT id, name, description, key_prefix, key_type, server_id, regular_key_id, created_at, last_used, is_active FROM api_keys WHERE id = ?'
+        );
+        stmt.bind([keyId]);
+        
+        if (stmt.step()) {
+            const row = stmt.getAsObject();
+            stmt.free();
+            return {
+                id: row.id,
+                name: row.name,
+                description: row.description,
+                keyPrefix: row.key_prefix,
+                keyType: row.key_type,
+                serverId: row.server_id,
+                regularKeyId: row.regular_key_id,
+                createdAt: row.created_at,
+                lastUsed: row.last_used,
+                isActive: Boolean(row.is_active)
+            };
+        }
+        
+        stmt.free();
+        return null;
+    }
+
+    getAllApiKeysInfo() {
+        const stmt = this.db.prepare(
+            'SELECT id, name, description, key_prefix, key_type, server_id, regular_key_id, created_at, last_used, is_active FROM api_keys ORDER BY created_at DESC'
+        );
+        
+        const keys = [];
+        while (stmt.step()) {
+            const row = stmt.getAsObject();
+            keys.push({
+                id: row.id,
+                name: row.name,
+                description: row.description,
+                keyPrefix: row.key_prefix,
+                keyType: row.key_type,
+                serverId: row.server_id,
+                regularKeyId: row.regular_key_id,
+                createdAt: row.created_at,
+                lastUsed: row.last_used,
+                isActive: Boolean(row.is_active)
+            });
+        }
+        
+        stmt.free();
+        return keys;
+    }
+
+    getServerKeysByRegularKeyId(regularKeyId) {
+        const stmt = this.db.prepare(
+            'SELECT id, name, description, key_prefix, key_type, server_id, created_at, last_used, is_active FROM api_keys WHERE regular_key_id = ? AND key_type = ? ORDER BY created_at DESC'
+        );
+        stmt.bind([regularKeyId, KEY_TYPE_SERVER]);
+        
+        const keys = [];
+        while (stmt.step()) {
+            const row = stmt.getAsObject();
+            keys.push({
+                id: row.id,
+                name: row.name,
+                description: row.description,
+                keyPrefix: row.key_prefix,
+                keyType: row.key_type,
+                serverId: row.server_id,
+                createdAt: row.created_at,
+                lastUsed: row.last_used,
+                isActive: Boolean(row.is_active)
+            });
+        }
+        
+        stmt.free();
+        return keys;
+    }
+
+    toggleApiKeyActivation(keyId, activate) {
+        const result = this.db.run(
+            'UPDATE api_keys SET is_active = ? WHERE id = ?',
+            [activate ? 1 : 0, keyId]
+        );
+        this.save();
+        return result.changes > 0;
+    }
+
+    deleteApiKeyById(keyId) {
+        const keyInfo = this.getApiKeyDetailsById(keyId);
+        
+        if (keyInfo && keyInfo.keyType === KEY_TYPE_ADMIN) {
+            const stmt = this.db.prepare(
+                'SELECT COUNT(*) as count FROM api_keys WHERE key_type = ? AND id != ?'
+            );
+            stmt.bind([KEY_TYPE_ADMIN, keyId]);
+            stmt.step();
+            const row = stmt.getAsObject();
+            stmt.free();
+            
+            if (row.count === 0) {
+                throw new Error('Cannot delete the last Admin Key');
+            }
+        }
+
+        const result = this.db.run('DELETE FROM api_keys WHERE id = ?', [keyId]);
+        this.save();
+        return result.changes > 0;
+    }
+
+    logEvent(event, apiKeyId) {
+        this.db.run(
+            'INSERT INTO event_logs (event_type, server_name, timestamp, data, api_key_id) VALUES (?, ?, ?, ?, ?)',
+            [event.event_type, event.server_name, event.timestamp, JSON.stringify(event.data), apiKeyId]
+        );
+        this.save();
+    }
+
+    getRecentEvents(limit = 100) {
+        const stmt = this.db.prepare(
+            'SELECT * FROM event_logs ORDER BY timestamp DESC LIMIT ?'
+        );
+        stmt.bind([limit]);
+        
+        const events = [];
+        while (stmt.step()) {
+            const row = stmt.getAsObject();
+            events.push({
+                id: row.id,
+                eventType: row.event_type,
+                serverName: row.server_name,
+                timestamp: row.timestamp,
+                data: JSON.parse(row.data),
+                apiKeyId: row.api_key_id
+            });
+        }
+        
+        stmt.free();
+        return events;
+    }
+}
+
+module.exports = Database;
+module.exports.KEY_TYPE_ADMIN = KEY_TYPE_ADMIN;
+module.exports.KEY_TYPE_SERVER = KEY_TYPE_SERVER;
+module.exports.KEY_TYPE_REGULAR = KEY_TYPE_REGULAR;

hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/src/routes/events.js

@@ -0,0 +1,32 @@
+const express = require('express');
+const router = express.Router();
+
+function createEventsRouter(db, manager, requireAnyKey) {
+    router.post('/', requireAnyKey, async (req, res) => {
+        try {
+            const event = req.body;
+            
+            if (!event.event_type || !event.server_name || !event.timestamp || !event.data) {
+                return res.status(400).json({ detail: 'Missing required event fields' });
+            }
+            
+            db.logEvent(event, req.apiKey.id);
+            
+            const message = {
+                type: 'minecraft_event',
+                event: event,
+                source_key_id_prefix: req.apiKey.id.substring(0, 8)
+            };
+            
+            await manager.broadcastToAll(message);
+            
+            res.json({ message: 'Event received and broadcasted' });
+        } catch (error) {
+            res.status(500).json({ detail: error.message });
+        }
+    });
+
+    return router;
+}
+
+module.exports = createEventsRouter;

hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/src/routes/health.js

@@ -0,0 +1,27 @@
+const express = require('express');
+const router = express.Router();
+const { KEY_TYPE_ADMIN, KEY_TYPE_SERVER, KEY_TYPE_REGULAR } = require('../database');
+
+function createHealthRouter(db, manager) {
+    router.get('/', (req, res) => {
+        try {
+            const allKeys = db.getAllApiKeysInfo();
+            
+            res.json({
+                status: 'healthy',
+                timestamp: new Date().toISOString(),
+                active_ws: manager.getActiveConnectionsCount(),
+                keys_total: allKeys.length,
+                admin_active: allKeys.filter(k => k.keyType === KEY_TYPE_ADMIN && k.isActive).length,
+                server_active: allKeys.filter(k => k.keyType === KEY_TYPE_SERVER && k.isActive).length,
+                regular_active: allKeys.filter(k => k.keyType === KEY_TYPE_REGULAR && k.isActive).length
+            });
+        } catch (error) {
+            res.status(500).json({ status: 'unhealthy', error: error.message });
+        }
+    });
+
+    return router;
+}
+
+module.exports = createHealthRouter;

hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/src/routes/keys.js

@@ -0,0 +1,195 @@
+const express = require('express');
+const router = express.Router();
+const { KEY_TYPE_ADMIN, KEY_TYPE_SERVER, KEY_TYPE_REGULAR } = require('../database');
+const { requireRegularKeyForOwnServerKeys } = require('../auth');
+
+function createKeysRouter(db, requireAdminKey) {
+    const verifyApiKey = require('../auth').verifyApiKey(db);
+    router.post('/', requireAdminKey, async (req, res) => {
+        try {
+            const { name, description = '', key_type = KEY_TYPE_REGULAR, server_id = null } = req.body;
+            
+            if (!name) {
+                return res.status(400).json({ detail: 'Name is required' });
+            }
+            
+            if (key_type === KEY_TYPE_REGULAR) {
+                // 创建Regular Key并自动生成关联的Server Key
+                const result = await db.createRegularKeyWithServerKey(name, description, server_id);
+                
+                res.status(201).json({
+                    regularKey: {
+                        ...db.getApiKeyDetailsById(result.regularKey.id),
+                        key: result.regularKey.rawKey
+                    },
+                    serverKey: {
+                        ...db.getApiKeyDetailsById(result.serverKey.id),
+                        key: result.serverKey.rawKey
+                    }
+                });
+            } else {
+                // 创建单个Admin或Server Key
+                const result = await db.createApiKey(name, description, key_type, server_id);
+                const details = db.getApiKeyDetailsById(result.keyId);
+                
+                res.status(201).json({
+                    ...details,
+                    key: result.rawKey
+                });
+            }
+        } catch (error) {
+            res.status(500).json({ detail: error.message });
+        }
+    });
+
+    router.get('/', requireAdminKey, (req, res) => {
+        try {
+            const keys = db.getAllApiKeysInfo();
+            res.json(keys);
+        } catch (error) {
+            res.status(500).json({ detail: error.message });
+        }
+    });
+
+    // Regular Key获取自己的Server Key列表
+    router.get('/server-keys', verifyApiKey(db), requireRegularOrAdminKey, (req, res) => {
+        try {
+            if (req.apiKey.keyType === KEY_TYPE_ADMIN) {
+                // Admin获取所有Server Key
+                const allKeys = db.getAllApiKeysInfo();
+                const serverKeys = allKeys.filter(key => key.keyType === KEY_TYPE_SERVER);
+                res.json(serverKeys);
+            } else if (req.apiKey.keyType === KEY_TYPE_REGULAR) {
+                // Regular Key获取自己关联的Server Key
+                const serverKeys = db.getServerKeysByRegularKeyId(req.apiKey.id);
+                res.json(serverKeys);
+            }
+        } catch (error) {
+            res.status(500).json({ detail: error.message });
+        }
+    });
+
+    // Regular Key为自己创建新的Server Key
+    // 只有Admin Key可以为Regular Key创建Server Key
+    router.post('/server-keys', verifyApiKey(db), requireAdminKey, async (req, res) => {
+        try {
+            const { name, description = '', server_id = null, regular_key_id } = req.body;
+            
+            if (!name) {
+                return res.status(400).json({ detail: 'Name is required' });
+            }
+            
+            if (!regular_key_id) {
+                return res.status(400).json({ detail: 'regular_key_id is required' });
+            }
+            
+            const regularKeyInfo = db.getApiKeyDetailsById(regular_key_id);
+            if (!regularKeyInfo || regularKeyInfo.keyType !== KEY_TYPE_REGULAR) {
+                return res.status(404).json({ detail: 'Invalid Regular Key ID' });
+            }
+            
+            const result = await db.createApiKey(name, description, KEY_TYPE_SERVER, server_id, regular_key_id);
+            const details = db.getApiKeyDetailsById(result.keyId);
+            
+            res.status(201).json({
+                ...details,
+                key: result.rawKey
+            });
+        } catch (error) {
+            res.status(500).json({ detail: error.message });
+        }
+    });
+
+    router.get('/:key_id', verifyApiKey, requireRegularKeyForOwnServerKeys(db), (req, res) => {
+        try {
+            const details = db.getApiKeyDetailsById(req.params.key_id);
+            
+            if (!details) {
+                return res.status(404).json({ detail: 'API Key not found' });
+            }
+            
+            res.json(details);
+        } catch (error) {
+            res.status(500).json({ detail: error.message });
+        }
+    });
+
+    router.patch('/:key_id/activate', verifyApiKey, requireRegularKeyForOwnServerKeys(db), (req, res) => {
+        try {
+            const keyId = req.params.key_id;
+            
+            if (!db.getApiKeyDetailsById(keyId)) {
+                return res.status(404).json({ detail: 'Key not found' });
+            }
+            
+            if (db.toggleApiKeyActivation(keyId, true)) {
+                return res.json({ message: `Key '${keyId}' activated.` });
+            }
+            
+            res.status(500).json({ detail: 'Failed to activate key.' });
+        } catch (error) {
+            res.status(500).json({ detail: error.message });
+        }
+    });
+
+    router.patch('/:key_id/deactivate', verifyApiKey, requireRegularKeyForOwnServerKeys(db), (req, res) => {
+        try {
+            const keyId = req.params.key_id;
+            const keyInfo = db.getApiKeyDetailsById(keyId);
+            
+            if (!keyInfo) {
+                return res.status(404).json({ detail: 'Key not found' });
+            }
+            
+            // 不能删除自己
+            if (keyId === req.apiKey.id) {
+                return res.status(400).json({ detail: 'Cannot deactivate your own key.' });
+            }
+            
+            // 管理员不能删除最后一个Admin Key
+            if (req.apiKey.keyType === KEY_TYPE_ADMIN && keyInfo.keyType === KEY_TYPE_ADMIN) {
+                const allKeys = db.getAllApiKeysInfo();
+                const activeAdmin = allKeys.filter(k => k.keyType === KEY_TYPE_ADMIN && k.isActive && k.id !== keyId);
+                
+                if (activeAdmin.length === 0) {
+                    return res.status(400).json({ detail: 'Cannot deactivate last active Admin Key.' });
+                }
+            }
+            
+            if (db.toggleApiKeyActivation(keyId, false)) {
+                return res.json({ message: `Key '${keyId}' deactivated.` });
+            }
+            
+            res.status(500).json({ detail: 'Failed to deactivate key.' });
+        } catch (error) {
+            res.status(500).json({ detail: error.message });
+        }
+    });
+
+    router.delete('/:key_id', verifyApiKey, requireRegularKeyForOwnServerKeys(db), (req, res) => {
+        try {
+            const keyId = req.params.key_id;
+            
+            if (!db.getApiKeyDetailsById(keyId)) {
+                return res.status(404).json({ detail: 'Key not found' });
+            }
+            
+            // 不能删除自己
+            if (keyId === req.apiKey.id) {
+                return res.status(400).json({ detail: 'Cannot delete your own key.' });
+            }
+            
+            db.deleteApiKeyById(keyId);
+            res.status(204).send();
+        } catch (error) {
+            if (error.message.includes('last Admin Key')) {
+                return res.status(400).json({ detail: error.message });
+            }
+            res.status(500).json({ detail: error.message });
+        }
+    });
+
+    return router;
+}
+
+module.exports = createKeysRouter;

hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/src/routes/server.js

@@ -0,0 +1,70 @@
+const express = require('express');
+const router = express.Router();
+
+function createServerRouter(db, manager, requireServerKey) {
+    // 获取服务器信息
+    router.get('/info', requireServerKey, (req, res) => {
+        try {
+            // 这里应该从实际的Minecraft服务器获取信息
+            // 目前返回模拟数据
+            const serverInfo = {
+                server_id: req.apiKey.serverId || 'server-001',
+                status: 'running',
+                online_players: 5,
+                max_players: 20,
+                version: '1.20.1',
+                uptime: '2h 30m',
+                tps: 19.8
+            };
+            
+            res.json(serverInfo);
+        } catch (error) {
+            res.status(500).json({ detail: error.message });
+        }
+    });
+
+    // 发送服务器命令
+    router.post('/command', requireServerKey, (req, res) => {
+        try {
+            const { command } = req.body;
+            
+            if (!command) {
+                return res.status(400).json({ detail: 'Command is required' });
+            }
+            
+            // 这里应该向实际的Minecraft服务器发送命令
+            // 目前只是记录命令
+            console.log(`[Server Command] ${req.apiKey.serverId}: ${command}`);
+            
+            // 广播命令执行事件
+            const commandEvent = {
+                event_type: 'server_command',
+                server_name: req.apiKey.serverId || 'unknown',
+                timestamp: new Date().toISOString(),
+                data: {
+                    command: command,
+                    executed_by: req.apiKey.id,
+                    server_id: req.apiKey.serverId
+                }
+            };
+            
+            manager.broadcastToAll({
+                type: 'minecraft_event',
+                event: commandEvent,
+                source_key_id_prefix: req.apiKey.id.substring(0, 8)
+            });
+            
+            res.json({ 
+                message: 'Command sent successfully',
+                command: command,
+                server_id: req.apiKey.serverId
+            });
+        } catch (error) {
+            res.status(500).json({ detail: error.message });
+        }
+    });
+
+    return router;
+}
+
+module.exports = createServerRouter;

hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/src/server.js

@@ -0,0 +1,134 @@
+require('dotenv').config();
+const express = require('express');
+const path = require('path');
+const { WebSocketServer } = require('ws');
+const http = require('http');
+const Database = require('./database');
+const ConnectionManager = require('./websocket');
+const { verifyApiKey, requireAdminKey, requireServerKey, requireAnyKey } = require('./auth');
+const createKeysRouter = require('./routes/keys');
+const createEventsRouter = require('./routes/events');
+const createHealthRouter = require('./routes/health');
+const createServerRouter = require('./routes/server');
+
+const HOST = process.env.SERVER_HOST || '0.0.0.0';
+const PORT = parseInt(process.env.SERVER_PORT || '8000');
+
+const app = express();
+const server = http.createServer(app);
+const wss = new WebSocketServer({ noServer: true });
+
+const db = new Database(process.env.DATABASE_PATH || 'minecraft_ws.db');
+const manager = new ConnectionManager();
+
+app.use(express.json());
+
+app.use('/dashboard', express.static(path.join(__dirname, '../dashboard/public')));
+
+app.get('/', (req, res) => {
+    res.json({
+        message: 'Minecraft WebSocket API Server (Node.js)',
+        dashboard: '/dashboard',
+        websocket: 'ws://' + req.get('host') + '/ws',
+        version: '1.0.0'
+    });
+});
+
+app.use('/manage/keys', verifyApiKey(db), requireAdminKey, createKeysRouter(db, requireAdminKey));
+app.use('/api/events', verifyApiKey(db), requireAnyKey, createEventsRouter(db, manager, requireAnyKey));
+app.use('/health', createHealthRouter(db, manager));
+
+server.on('upgrade', async (request, socket, head) => {
+    const url = new URL(request.url, `http://${request.headers.host}`);
+    
+    if (url.pathname === '/ws') {
+        const apiKey = url.searchParams.get('api_key');
+        
+        if (!apiKey) {
+            socket.write('HTTP/1.1 401 Unauthorized\r\n\r\n');
+            socket.destroy();
+            return;
+        }
+        
+        const result = await db.verifyApiKey(apiKey);
+        
+        if (!result) {
+            socket.write('HTTP/1.1 401 Unauthorized\r\n\r\n');
+            socket.destroy();
+            return;
+        }
+        
+        wss.handleUpgrade(request, socket, head, (ws) => {
+            wss.emit('connection', ws, request, result);
+        });
+    } else {
+        socket.destroy();
+    }
+});
+
+wss.on('connection', (ws, request, apiKeyInfo) => {
+    manager.connect(ws, apiKeyInfo.id);
+    
+    ws.on('message', (data) => {
+        try {
+            const msg = JSON.parse(data.toString());
+            
+            if (msg.type === 'ping') {
+                ws.send(JSON.stringify({ type: 'pong' }));
+            }
+        } catch (error) {
+        }
+    });
+    
+    ws.on('close', () => {
+        manager.disconnect(ws);
+    });
+    
+    ws.on('error', () => {
+        manager.disconnect(ws);
+    });
+});
+
+async function startServer() {
+    console.log('🚀 启动Minecraft WebSocket API服务器...');
+    console.log('='.repeat(50));
+    
+    await db.init();
+    
+    const adminKeyInfo = await db.ensureInitialAdminKey();
+    
+    if (adminKeyInfo) {
+        console.log('='.repeat(60));
+        console.log('重要: 已生成新的Admin Key!');
+        console.log(`  名称: ${adminKeyInfo.name}`);
+        console.log(`  密钥: ${adminKeyInfo.key}`);
+        console.log('请复制并安全保存此密钥。');
+        console.log('您需要使用它来管理API密钥。');
+        console.log('如果丢失此密钥且没有其他Admin Key，您可能失去管理员访问权限。');
+        console.log('='.repeat(60));
+    } else {
+        console.log('信息: 已找到现有Admin Key或Admin Key检查已执行。');
+    }
+    
+    server.listen(PORT, HOST, () => {
+        console.log(`服务器地址: http://${HOST}:${PORT}`);
+        console.log(`WebSocket端点: ws://${HOST}:${PORT}/ws`);
+        console.log(`健康检查: http://${HOST}:${PORT}/health`);
+        console.log('='.repeat(50));
+        console.log();
+        console.log('💡 首次使用提示:');
+        console.log('1. 使用CLI工具创建API密钥:');
+        console.log('   node cli/cli.js create-key "MyServer"');
+        console.log();
+        console.log('2. 生成Minecraft插件配置文件:');
+        console.log('   node cli/cli.js generate-config');
+        console.log();
+        console.log('3. 将API密钥配置到Minecraft插件中');
+        console.log('='.repeat(50));
+    });
+}
+
+startServer().catch(error => {
+    console.error('❌ 启动失败:', error);
+    process.exit(1);
+});

hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/src/websocket.js

@@ -0,0 +1,63 @@
+class ConnectionManager {
+    constructor() {
+        this.activeConnections = new Map();
+        this.connectionKeys = new Map();
+    }
+
+    connect(websocket, apiKeyId) {
+        if (!this.activeConnections.has(apiKeyId)) {
+            this.activeConnections.set(apiKeyId, new Set());
+        }
+        this.activeConnections.get(apiKeyId).add(websocket);
+        this.connectionKeys.set(websocket, apiKeyId);
+    }
+
+    disconnect(websocket) {
+        const apiKeyId = this.connectionKeys.get(websocket);
+        
+        if (apiKeyId && this.activeConnections.has(apiKeyId)) {
+            this.activeConnections.get(apiKeyId).delete(websocket);
+            
+            if (this.activeConnections.get(apiKeyId).size === 0) {
+                this.activeConnections.delete(apiKeyId);
+            }
+        }
+        
+        this.connectionKeys.delete(websocket);
+    }
+
+    async broadcastToAll(message) {
+        if (this.activeConnections.size === 0) return;
+        
+        const messageStr = JSON.stringify(message);
+        const disconnectedWebsockets = [];
+        
+        for (const connectionsSet of this.activeConnections.values()) {
+            for (const connection of connectionsSet) {
+                try {
+                    if (connection.readyState === 1) {
+                        connection.send(messageStr);
+                    } else {
+                        disconnectedWebsockets.push(connection);
+                    }
+                } catch (error) {
+                    disconnectedWebsockets.push(connection);
+                }
+            }
+        }
+        
+        for (const ws of disconnectedWebsockets) {
+            this.disconnect(ws);
+        }
+    }
+
+    getActiveConnectionsCount() {
+        let count = 0;
+        for (const connectionsSet of this.activeConnections.values()) {
+            count += connectionsSet.size;
+        }
+        return count;
+    }
+}
+
+module.exports = ConnectionManager;

hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/start-server.bat

@@ -0,0 +1,3 @@
+@echo off
+echo Starting Minecraft WebSocket API Server...
+node src/server.js

hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/hf_repo/start.sh

@@ -0,0 +1,11 @@
+#!/bin/bash
+
+echo "🚀 启动Minecraft WebSocket API服务器..."
+echo "=================================================="
+
+if [ ! -d "node_modules" ]; then
+    echo "📦 检测到缺少依赖，正在安装..."
+    npm install
+fi
+
+node src/server.js