# live2d-2025

**Repository Path**: kdcnb/live2d-2025

## Basic Information

- **Project Name**: live2d-2025
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-11-10
- **Last Updated**: 2025-11-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Live2D API - Node.js 版本

Live2D 看板娘插件后端 API，已完全迁移到 Node.js 版本。

## 项目结构

```
live2d-api-master/
├── demo/                    # 主项目目录（网页应用）
│   ├── index.html          # 主页面
│   ├── model/              # 模型文件目录（从根目录迁移）
│   ├── lib/                # 前端资源
│   │   ├── common/         # 公共脚本
│   │   └── live2d/         # Live2D 相关
│   │       └── model_list.json  # 模型列表（从根目录迁移）
│   └── style/              # 样式文件
├── jss/                     # JavaScript 和 CSS 文件
├── tools/                   # Node.js 工具类
│   ├── modelList.js        # 模型列表管理
│   ├── modelTextures.js    # 皮肤/纹理管理
│   └── jsonCompatible.js   # JSON 格式化
├── server.js                # Node.js 服务器入口
├── package.json             # 项目配置
└── model_list.json         # 根目录模型列表（已迁移到 demo）

```

## 快速开始

### 1. 安装依赖

```bash
npm install
```

### 2. 启动服务器

```bash
npm start
```

服务器默认运行在 `http://localhost:3000`

### 3. 访问网页

在浏览器中打开：`http://localhost:3000`

## 功能特性

- ✅ **完整的 Live2D 看板娘功能**
  - 模型切换（顺序/随机）
  - 皮肤切换（顺序/随机）
  - 鼠标交互
  - 点击事件
  - 消息提示

- ✅ **Node.js API 后端**
  - RESTful API 接口
  - 自动模型路径处理
  - 支持多模型组
  - 支持多皮肤组合

- ✅ **完整的 Demo 应用**
  - 保留原有所有功能
  - 使用 Node.js API 加载模型
  - 支持所有原有交互功能

## API 接口

### 1. 获取模型配置

**接口：** `GET /get?id={modelId}-{textureId}`

**示例：**
```javascript
fetch('/get?id=1-1')
    .then(response => response.json())
    .then(data => console.log(data));
```

### 2. 随机切换模型

**接口：** `GET /rand?id={currentModelId}`

### 3. 顺序切换模型

**接口：** `GET /switch?id={currentModelId}`

### 4. 随机切换皮肤

**接口：** `GET /rand_textures?id={modelId}-{textureId}`

### 5. 顺序切换皮肤

**接口：** `GET /switch_textures?id={modelId}-{textureId}`

### 6. 更新皮肤列表

**接口：** `GET /add`

## 目录说明

### demo/ - 主项目目录

这是项目的核心目录，包含完整的网页应用：

- `index.html` - 主页面，包含完整的 Live2D 看板娘功能
- `model/` - 所有模型文件（从根目录迁移）
- `lib/live2d/model_list.json` - 模型列表配置（从根目录迁移）
- `lib/common/` - 前端公共脚本
  - `message.js` - 消息和模型加载逻辑（已更新为使用 Node.js API）
  - `live2d.js` - Live2D 核心库
  - `index.js` - 菜单和路由

### 模型迁移

所有模型文件已从根目录的 `model/` 迁移到 `demo/model/`，模型列表文件 `model_list.json` 已迁移到 `demo/lib/live2d/model_list.json`。

## 使用说明

### 启动服务

```bash
# 安装依赖
npm install

# 启动服务器
npm start

# 或自定义端口
PORT=8080 npm start
```

### 访问应用

启动后访问：`http://localhost:3000`

### 看板娘功能

- **点击工具栏图标**：
  - 🏠 首页 - 返回首页
  - 💬 对话 - 显示一言
  - 💡 夜间模式 - 切换夜间模式
  - 👥 切换模型 - 顺序切换到下一个模型
  - 👗 换装 - 随机切换皮肤
  - 📷 拍照 - 截图保存
  - ℹ️ 帮助 - 打开帮助页面
  - ❌ 关闭 - 隐藏看板娘

- **鼠标交互**：
  - 鼠标移动 - 看板娘会跟随
  - 点击看板娘 - 显示互动消息
  - 鼠标悬停页面元素 - 显示提示

## 技术栈

- **后端**：Node.js + Express
- **前端**：jQuery + Live2D
- **模型格式**：Live2D Cubism

## 开发说明

### 修改模型列表

编辑 `demo/lib/live2d/model_list.json`：

```json
{
    "models": [
        "Potion-Maker/Pio",
        "Potion-Maker/Tia",
        ...
    ],
    "messages": [
        "来自 Potion Maker 的 Pio 酱 ~",
        ...
    ]
}
```

### 添加新模型

1. 将模型文件放到 `demo/model/` 目录
2. 在 `demo/lib/live2d/model_list.json` 中添加模型路径
3. 重启服务器

## 注意事项

1. **模型路径**：所有模型文件应在 `demo/model/` 目录下
2. **API 路径**：前端代码会自动使用当前域名的 API
3. **静态资源**：`/model/*` 和 `/jss/*` 会自动提供静态文件服务
4. **CORS**：已启用 CORS，支持跨域访问

## 从 PHP 版本迁移

本项目已完全从 PHP 迁移到 Node.js：

- ✅ 所有 PHP 文件已删除
- ✅ 所有功能已迁移到 Node.js
- ✅ API 接口路径保持不变
- ✅ 前端代码无需修改

## 版权声明

> (>▽<) 都看到这了，点个 Star 吧 ~

**API 内所有模型 版权均属于原作者，仅供研究学习，不得用于商业用途**

MIT © FGHRSH