Added a new protocol at /l2d for live2d model customization.

Author: wehos

.gitignore

@@ -7,6 +7,7 @@ core_config.txt
 # 忽略 memory/store 下所有内容（含子目录和文件）
 memory/store/
 config/api.py
+config/*.json
 
 # 忽略临时文件
 *.tmp

README.MD

@@ -23,9 +23,9 @@
 ---
 
 # 项目简介
-本项目的目的是打造一个新手友好、开箱即用的，具有听觉、视觉、工具调用和多端同步功能的AI~~猫娘~~伙伴。本项目在设计时有三个核心目标：
+Lanlan（兰兰）是一个新手友好、开箱即用的，具有听觉、视觉、工具调用和多端同步功能的AI~~猫娘~~伙伴。本项目有三个核心目标：
 
-1. **降低语音延迟**。本项目的用户界面以语音交互为主，一切系统级设计皆须优先确保**降低对话延迟**，且任何服务不得阻塞对话进程。
+1. **极致的低延迟**。本项目的用户界面以语音交互为主，一切系统级设计皆须优先确保**降低语音延迟**，且任何服务不得阻塞对话进程。
 
 1. **全场景同步**。猫娘可以在手机、电脑和智能眼镜上同时存在，且**同一只猫娘**在不同终端同时存在时，**行为应当完全同步**。 (假想场景：如果家中有多个显示器，每一个显示器上都放置着猫娘，那么我们希望无论走到哪里都是在跟同一只猫娘对话，实现全方位环绕式体验。)
 
@@ -37,8 +37,8 @@
 
 # 运行
 
-1. **获取阿里云API**。在阿里云的百炼平台[官网](https://bailian.console.aliyun.com/)注册账号。新用户实名认证后可以获取大量免费额度，记得留意页面上的"新人福利"广告。注册完成后，请访问[控制台](https://bailian.console.aliyun.com/api-key?tab=model#/api-key)获取API Key。将API Key填入`core_config.txt`中的`"coreApiKey": `后的引号内。     
-> *注：本项目提供的都是官方链接，不含任何推广，本人无法从中获取任何收益。阿里的官网目前做的很烂，请忍耐orz*
+1. **获取阿里云API**。在阿里云的百炼平台[官网](https://bailian.console.aliyun.com/)注册账号。新用户实名认证后可以获取大量免费额度，记得留意页面上的"新人福利"广告。注册完成后，请访问[控制台](https://bailian.console.aliyun.com/api-key?tab=model#/api-key)获取API Key。将API Key填入`core_config.txt`中的`"coreApiKey": `后的引号内。      
+   > *注：本项目提供的都是官方链接，不含任何推广，本人无法从中获取任何收益。阿里的官网目前做的很烂，请忍耐orz*
 
 1. **体验网页版**。对于一键包，填写好API KEY后，运行`启动网页版.bat`即可打开网页版。**首次启动请耐心等待网页刷新**。
 

main_server.py

@@ -12,6 +12,8 @@
 from main_helper import core as core, cross_server as cross_server
 from fastapi.templating import Jinja2Templates
 from fastapi.responses import HTMLResponse
+from utils.preferences import load_user_preferences, update_model_preferences, validate_model_preferences, get_model_preferences, get_preferred_model_path, move_model_to_top
+from utils.frontend_utils import find_models
 templates = Jinja2Templates(directory="./")
 from config import LANLAN_PROMPT, MASTER_NAME, her_name, MAIN_SERVER_PORT
 
@@ -74,17 +76,61 @@ async def get_default_index(request: Request): # 这个接口在直播版代码
     return templates.TemplateResponse("templates/index.html", {
         "request": request,
         "lanlan_name": her_name,
-        "model_path": f"/static/live2d/mao_pro.model3.json" 
+        "model_path": f"/static/mao_pro/mao_pro.model3.json" 
     })
 
-@app.get("/{lanlan_name}", response_class=HTMLResponse)
-async def get_index(request: Request, lanlan_name: str):
-    # Point FileResponse to the correct path relative to where server.py is run
-    return templates.TemplateResponse("templates/index.html", {
-        "request": request,
-        "lanlan_name": lanlan_name,
-        "model_path": f"/static/live2d/mao_pro.model3.json" # TODO: 根据lanlan_name动态加载模型. 实现起来很简单，但是用户需要手动配置、还需要调整大小和位置，当前版本先不增加复杂度
-    })
+@app.get("/api/preferences")
+async def get_preferences():
+    """获取用户偏好设置"""
+    preferences = load_user_preferences()
+    return preferences
+
+@app.post("/api/preferences")
+async def save_preferences(request: Request):
+    """保存用户偏好设置"""
+    try:
+        data = await request.json()
+        if not data:
+            return {"success": False, "error": "无效的数据"}
+        
+        # 验证偏好数据
+        if not validate_model_preferences(data):
+            return {"success": False, "error": "偏好数据格式无效"}
+        
+        # 更新偏好
+        if update_model_preferences(data['model_path'], data['position'], data['scale']):
+            return {"success": True, "message": "偏好设置已保存"}
+        else:
+            return {"success": False, "error": "保存失败"}
+            
+    except Exception as e:
+        return {"success": False, "error": str(e)}
+
+
+@app.get("/api/models")
+async def get_models():
+    """
+    API接口，调用扫描函数并以JSON格式返回找到的模型列表。
+    """
+    models = find_models()
+    return models
+
+@app.post("/api/preferences/set-preferred")
+async def set_preferred_model(request: Request):
+    """设置首选模型"""
+    try:
+        data = await request.json()
+        if not data or 'model_path' not in data:
+            return {"success": False, "error": "无效的数据"}
+        
+        if move_model_to_top(data['model_path']):
+            return {"success": True, "message": "首选模型已更新"}
+        else:
+            return {"success": False, "error": "模型不存在或更新失败"}
+            
+    except Exception as e:
+        return {"success": False, "error": str(e)}
+
 
 @app.on_event("startup")
 async def startup_event():
@@ -171,6 +217,26 @@ async def websocket_endpoint(websocket: WebSocket, lanlan_name: str):
         logger.info(f"Cleaning up WebSocket resources: {websocket.client}")
         await session_manager[lanlan_name].cleanup()
 
+@app.get("/l2d", response_class=HTMLResponse)
+async def get_l2d_manager(request: Request):
+    """渲染Live2D模型管理器页面"""
+    return templates.TemplateResponse("templates/l2d_manager.html", {
+        "request": request
+    })
+
+@app.get("/{lanlan_name}", response_class=HTMLResponse)
+async def get_index(request: Request, lanlan_name: str):
+    # 获取首选模型路径
+    model_path = get_preferred_model_path() or f"/static/mao_pro/mao_pro.model3.json"
+    
+    # Point FileResponse to the correct path relative to where server.py is run
+    return templates.TemplateResponse("templates/index.html", {
+        "request": request,
+        "lanlan_name": lanlan_name,
+        "model_path": model_path
+    })
+
+
 # --- Run the Server ---
 # (Keep your existing __main__ block)
 if __name__ == "__main__":

manager.py

@@ -0,0 +1,85 @@
+import os
+from flask import Flask, render_template, jsonify, request
+from utils.preferences import load_user_preferences, update_user_preferences, validate_preferences
+
+# 初始化Flask应用
+app = Flask(__name__)
+
+# 修改点：将扫描的根目录直接设置为 'static' 文件夹
+SEARCH_ROOT_DIR = app.static_folder or 'static'
+
+def find_models():
+    """
+    递归扫描整个 'static' 文件夹，查找所有包含 '.model3.json' 文件的子目录。
+    """
+    found_models = []
+    if not os.path.exists(SEARCH_ROOT_DIR):
+        print(f"警告：指定的静态文件夹路径不存在: {SEARCH_ROOT_DIR}")
+        return []
+
+    # os.walk会遍历指定的根目录下的所有文件夹和文件
+    for root, dirs, files in os.walk(SEARCH_ROOT_DIR):
+        for file in files:
+            if file.endswith('.model3.json'):
+                # 获取模型名称 (使用其所在的文件夹名，更加直观)
+                model_name = os.path.basename(root)
+                
+                # 构建可被浏览器访问的URL路径
+                # 1. 计算文件相对于 static_folder 的路径
+                relative_path = os.path.relpath(os.path.join(root, file), app.static_folder)
+                # 2. 将本地路径分隔符 (如'\') 替换为URL分隔符 ('/')
+                model_path = relative_path.replace(os.path.sep, '/')
+                
+                found_models.append({
+                    "name": model_name,
+                    "path": f"/static/{model_path}"
+                })
+                
+                # 优化：一旦在某个目录找到模型json，就无需再继续深入该目录的子目录
+                dirs[:] = []
+                break
+                
+    return found_models
+
+@app.route('/')
+def l2d_manager():
+    """渲染主控制页面"""
+    return render_template('l2d_manager.html')
+
+@app.route('/api/models')
+def get_models():
+    """
+    API接口，调用扫描函数并以JSON格式返回找到的模型列表。
+    """
+    models = find_models()
+    return jsonify(models)
+
+@app.route('/api/preferences', methods=['GET'])
+def get_preferences():
+    """获取用户偏好设置"""
+    preferences = load_user_preferences()
+    return jsonify(preferences)
+
+@app.route('/api/preferences', methods=['POST'])
+def save_preferences():
+    """保存用户偏好设置"""
+    try:
+        data = request.get_json()
+        if not data:
+            return jsonify({"success": False, "error": "无效的数据"}), 400
+        
+        # 验证偏好数据
+        if not validate_preferences(data):
+            return jsonify({"success": False, "error": "偏好数据格式无效"}), 400
+        
+        # 更新偏好
+        if update_user_preferences(data):
+            return jsonify({"success": True, "message": "偏好设置已保存"})
+        else:
+            return jsonify({"success": False, "error": "保存失败"}), 500
+            
+    except Exception as e:
+        return jsonify({"success": False, "error": str(e)}), 500
+
+if __name__ == '__main__':
+    app.run(host='0.0.0.0', port=5000, debug=True)