# PPMC

**Repository Path**: elfbobo_admin_admin/PPMC

## Basic Information

- **Project Name**: PPMC
- **Description**: 一款功能丰富、现代化的 Web 聊天应用，前端使用原生 JavaScript、HTML 和 CSS 构建，后端采用 Java Spring Boot。它利用 WebRTC 进行用户间的直接媒体通信，支持文本、文件共享、语音消息以及实时音频/视频/屏幕共享通话。通过基于 WebSocket 的信令服务器（由Java Spring Boot实现）完成初始用户发现和连接协商。
- **Primary Language**: JavaScript
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2025-06-23
- **Last Updated**: 2025-06-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AI 角色扮演聊天平台

[![GitHub stars](https://img.shields.io/github/stars/git-hub-cc/PPMC.svg?style=social)](https://github.com/git-hub-cc/PPMC/stargazers)
[![GitHub forks](https://img.shields.io/github/forks/git-hub-cc/PPMC.svg?style=social)](https://github.com/git-hub-cc/PPMC/network/members)

[English Version](./README.md)

一款功能丰富、现代化的 Web 聊天应用，前端使用原生 JavaScript、HTML 和 CSS 构建，后端采用 Java Spring Boot。它利用 WebRTC 进行用户间的直接媒体通信，支持文本、文件共享、语音消息以及实时音频/视频/屏幕共享通话。通过基于 WebSocket 的信令服务器（由Java Spring Boot实现）完成初始用户发现和连接协商。WebRTC 通讯减少了对中央服务器传输大量媒体数据的依赖（除信令与可选的 TURN 中继服务外），而AI聊天和TTS功能则通过后端代理与外部服务交互。该应用深度集成了具有文本转语音（TTS）功能的主题化AI助手联系人，AI角色拥有动态上下文（如每日随机事件和心情）并支持长对话智能摘要，带来更生动的交互体验。

**在线演示：**
https://175.178.216.24/

## ✨ 功能特性

*   **核心通信 (WebRTC):**
    *   **一对一和群组聊天：**进行私人对话或创建群组。
        *   文本消息
        *   文件共享（图片、视频、文档）
        *   语音消息
    *   **实时音频/视频通话：**发起和接收音频/视频通话（一对一）。
        *   视频通话支持画中画（PiP）模式，让您可以同时处理多项任务。
    *   **屏幕共享：**与聊天对象共享您的屏幕。
*   **信令与通信架构：**
    *   使用 WebSocket 服务器进行初始用户发现、offer/answer 交换和 ICE 候选者协商。
    *   使用 WebRTC 建立直接的用户间媒体连接。
    *   包含用于 NAT 穿透的 STUN/TURN 服务器配置。**TURN 服务器** 用于在复杂的 NAT 环境下中继媒体流，确保连接成功率。
    *   自动尝试重新连接到信令服务器。
*   **联系人与群组管理：**
    *   添加、移除和列出联系人。
    *   创建、管理和参与群组聊天。
    *   群组聊天目前以群主中继模式运行：群主接收成员的消息，并将其转发给群组中的其他成员。
    *   群主可以控制成员的添加/移除。
*   **AI 助手联系人：**
    *   基于流行虚拟 IP 的主题化 AI 角色（例如，原神、仙逆、遮天、斗破苍穹、完美世界、吞噬星空、蜡笔小新、迷宫饭、咒术回战等）。
    *   通过可配置的 OpenAI 兼容 API 生成 AI 回复 (由后端代理)。
    *   **动态上下文与智能摘要：** AI 角色会基于每日随机生成的“小事件”和“心情”进行互动，并能在长对话中进行智能摘要以保持连贯性（由后端AI服务处理）。
    *   **文本转语音 (TTS)：**AI 回复可以通过可配置的 TTS API（例如，GSV AI Lab，通过后端代理）作为音频播放。
    *   为每个 AI 联系人提供可自定义的 TTS 设置（语音、语速、情感等）。
*   **用户界面与体验 (UI/UX):**
    *   **模块化设计：**通过各种 UI 管理器实现清晰的关注点分离。
    *   **响应式设计：**适应不同的屏幕尺寸（桌面/移动设备）。
    *   **主题化：**
        *   支持多种主题（例如，原神、斗破苍穹、仙逆、遮天、蜡笔小新、迷宫饭、咒术回战）。
        *   大多数主题提供浅色和深色模式。
        *   主题的CSS文件位于 `css/` 目录，而定义了特殊AI联系人（`SPECIAL_CONTACTS_DEFINITIONS`）的JSON数据文件位于 `data/` 目录。
        *   主题选择在会话间保持不变。
        *   自动检测系统颜色方案（“自动”模式）。
    *   **富媒体预览：**在发送前预览图像、音频和基本文件。
    *   **通知：**针对各种事件（新消息、来电、系统事件）的应用内 UI 通知。
    *   **模态框：**用于设置、新建联系人/群组、通话、确认等。
    *   **用户 ID 管理：**自动生成用户 ID，提供复制选项和可配置设置。
*   **后端服务 (Java Spring Boot):**
    *   **WebSocket 信令服务器：** 处理 WebRTC 连接建立所需的信令消息。
    *   **AI 聊天代理：** 接收前端 AI 聊天请求，进行上下文处理（包括动态事件/心情注入、历史对话摘要），并与外部 OpenAI 兼容 API 通信。
    *   **TTS 接口：** 提供文本转语音服务，供 AI 角色使用。
    *   **API 速率限制：** 保护后端 AI 相关接口免受滥用。
    *   **每日状态更新：** 定时任务自动更新 AI 角色的每日动态上下文。
    *   **服务器监控：** 提供 API 端点以监控服务器基本状态。
*   **数据持久化：**
    *   使用 IndexedDB (`DBManager.js`) 在浏览器本地存储聊天记录、联系人、用户信息和设置。
*   **网络与连接管理：**
    *   带有 UI 指示器和质量指示器的网络状态监控。
    *   通过 SDP offer/answer 交换进行手动连接的选项。
    *   用户间自动 WebRTC 连接尝试。
    *   大消息/文件通过 DataChannel 分块进行可靠传输。
*   **配置：**
    *   前端 `Config.js` 文件，方便设置信令服务器URL、TURN服务器、超时等。
    *   后端 Spring Boot `application.properties` (或 `.yml`) 文件，用于配置AI API密钥、URL、TTS端点、提示词等。
    *   用户可配置的设置（例如，自动连接到联系人）。
*   **错误处理：**
    *   针对 UI 和应用逻辑的全局错误处理程序。
    *   图像加载错误的优雅降级处理。

## 📸 截图

以下是应用程序运行中的一些截图，展示了不同的功能和主题：

**聊天界面：**
*   桌面视图：
    ![聊天界面 - 桌面](screenshots/Chat%20Interface/Desktop/img.png)
*   移动视图：
*
<img src="./screenshots/Chat%20Interface/Mobile/merge.png" alt="Chat Interface - Mobile">

**视频通话：**
*   启用画中画（PiP）模式的视频通话：
    ![启用画中画的视频通话](screenshots/Video%20Call%20with%20PiP/04.png)

**主题示例：**
*   蜡笔小新主题（浅色模式）：
    ![蜡笔小新主题 - 浅色](screenshots/Themes/%E8%9C%A1%E7%AC%94%E5%B0%8F%E6%96%B0-%E6%B5%85%E8%89%B2.png)
*   迷宫饭主题（浅色模式）：
    ![迷宫饭主题 - 浅色](screenshots/Themes/%E8%BF%B7%E5%AE%AB%E9%A5%AD-%E6%B5%85%E8%89%B2.png)
*   迷宫饭主题（深色模式）：
    ![迷宫饭主题 - 深色](screenshots/Themes/%E8%BF%B7%E5%AE%AB%E9%A5%AD-%E6%B7%B1%E8%89%B2.png)

## 🛠️ 技术栈

*   **前端：** HTML5, CSS3, 原生 JavaScript (ES6+ 模块)
*   **后端：** Java 17, Spring Boot, Spring WebFlux (用于 AI 接口), Spring WebSocket, Maven
*   **核心通信技术：** WebRTC (RTCPeerConnection, RTCDataChannel, MediaStream API)
*   **信令：** WebSockets
*   **NAT 穿透：** STUN/TURN (推荐使用 Coturn)
*   **本地存储：** IndexedDB (前端)
*   **外部服务 API (通过后端代理)：**
    *   OpenAI 兼容的 API 用于 AI 聊天补全。
    *   TTS API (例如，GSV AI Lab 或其他兼容服务) 用于文本转语音。

## ⚙️ 工作原理

1.  **初始化：**当用户打开应用时，会生成一个唯一的用户 ID 或从本地存储加载。
2.  **信令：**客户端连接到基于 WebSocket 的信令服务器 (由 Spring Boot 应用提供)。此服务器帮助用户发现彼此并交换建立直接媒体连接所需的消息（如 SDP offer/answer 和 ICE 候选者）。ICE 候选者可能包含通过 STUN 服务器获取的公网地址，或在需要时通过 TURN 服务器获取的中继地址。
3.  **WebRTC 连接：**信令完成后，用户之间将建立 WebRTC `RTCPeerConnection` 连接用于媒体传输。如果直接连接失败（例如由于对称 NAT），则会尝试使用配置的 TURN 服务器中继媒体流。
    *   `RTCDataChannel` 用于文本消息、文件信息、语音消息数据和群聊消息（由群主中继）。
    *   `MediaStreams` 用于音频/视频通话数据。
4.  **AI 聊天与 TTS：**
    *   用户与 AI 角色聊天时，请求发送到 Spring Boot 后端。
    *   后端服务首先处理上下文（例如，注入每日动态事件/心情，或对长对话进行摘要），然后调用配置的外部大语言模型 API。
    *   AI 的回复（文本）会由后端进一步调用 TTS 服务生成语音。
    *   最终，文本和语音（通常是音频URL）通过流式或常规HTTP响应返回给前端显示和播放。
5.  **本地持久化：**所有联系人、聊天消息和用户设置都存储在浏览器的 IndexedDB 中，使其在会话间可用。
6.  **群组聊天：**群组聊天目前由群主中继。群主接收成员的消息，并将其转发给群组中的其他成员。

## 🚀 快速开始与安装

### 先决条件

*   支持 WebRTC 的现代 Web 浏览器（例如，Chrome, Firefox, Edge, Safari）。
*   Java 17 和 Maven（用于运行 Spring Boot 后端服务器）。
*   Docker (推荐，用于运行 TURN 服务器)。

### 1. 配置应用程序

*   **前端配置 (`js/Config.js`)：**
    *   `signalingServerUrl`: 您的 WebSocket 信令服务器 URL。应指向您的 Spring Boot 后端 (例如, `ws://localhost:8080/signaling` 或 `wss://your-domain.com/signaling`)。
    *   `iceServers`: 配置您的 STUN/TURN 服务器详细信息以进行 NAT 穿透。**强烈建议部署自己的 TURN 服务器 (例如 Coturn) 以获得最佳连接成功率。**
    *   `apiEndpoint` (用于 AI): 应指向您的 Spring Boot 后端提供的 `/v1/chat/completions` 代理端点。
    *   `ttsApiEndpoint` (用于 AI): 应指向您的 Spring Boot 后端提供的 TTS 代理端点 (如果后端代理 TTS)。
*   **后端配置 (Spring Boot `application.properties` 或 `application.yml`)：**
    *   `openai.api.base_url`: 您的 OpenAI 兼容 API 的基础 URL。
    *   `openai.api.api_key`: 您的 OpenAI 兼容 API 的密钥。
    *   `openai.api.model`: 您要使用的 AI 模型名称。
    *   `app.summary_prompt`: 用于对话摘要的提示词。
    *   `app.event_mood_prompt`: 用于生成AI角色每日事件/心情的提示词。
    *   (如果后端代理TTS) `your.tts.api.url`: 您的TTS服务URL。
    *   `allowed.url`: CORS 允许的前端源。
    *   `api.v1.request.limit`: API v1 路径的每日请求限制。
    *   WebSocket 相关配置 (缓冲区大小，超时)。
*   根据需要调整其他设置。

### 2. 部署 TURN 服务器 (推荐)

为了在复杂的网络环境中（如对称 NAT）实现可靠的 WebRTC 连接，强烈建议部署 TURN 服务器。本项目提供了一个使用 Coturn 的 `docker-compose.yml` 和示例 `turnserver.conf` 文件。

1.  编辑 `turnserver.conf`，设置 `realm` (通常是您的服务器公网 IP 或域名) 和 `user` (用户名和密码)。
2.  在包含 `docker-compose.yml` 和 `turnserver.conf` 的目录中运行：
    ```bash
    docker-compose up -d
    ```
3.  在前端 `js/Config.js` 的 `iceServers` 中配置您的 TURN 服务器信息 (URL, 用户名, 密码)。

### 3. 运行后端服务器

1.  克隆仓库：
    ```bash
    git clone https://github.com/git-hub-cc/PPMC.git 
    cd PPMC
    ```
2.  导航到 Spring Boot 项目目录 (例如, `PPMC-Boot`，如果后端代码在该目录下)。
3.  确保您的 `application.properties` (或 `.yml`) 文件已根据上述说明正确配置了 API 密钥和 URL。
4.  使用 Maven 构建并运行服务器：
    ```bash
    mvn spring-boot:run
    ```
    这通常会在 `http://localhost:8080` (或您在 `application.properties` 中配置的端口) 上启动服务器。WebSocket 端点将是 `ws://localhost:8080/signaling`，AI 代理端点将是 `http://localhost:8080/v1/chat/completions`。

### 4. 在浏览器中访问前端

*   将前端静态文件 (HTML, CSS, JS, images, data, music) 部署到任何 HTTP 服务器 (例如 Nginx, Apache, 或使用 Node.js 的 `http-server`)。
*   或者，如果 Spring Boot 配置为服务静态内容，您可以直接通过 `http://localhost:8080` 访问。
*   **重要：**确保前端 `js/Config.js` 中的 `signalingServerUrl` 和 `apiEndpoint` (以及可能的 `ttsApiEndpoint`) 指向您正在运行的 Spring Boot 后端服务器的正确地址和端口。
*   在两个不同的浏览器窗口或两个不同的设备上打开应用程序以测试通信功能。

## 🚀 使用方法

*   **用户 ID：**首次启动时会生成并存储一个唯一的用户 ID。此 ID 用于用户识别和连接。您可以从主菜单 (☰) 中找到并复制您的 ID。
*   **主菜单 (☰)：**
    *   **用户 ID：**查看并复制您的用户 ID。
    *   **网络状态：**检查 WebRTC 能力和信令服务器连接状态。
    *   **偏好设置：**切换是否自动连接到联系人。
    *   **AI 服务器配置 (主要由后端控制)：**前端此处可能仅显示或用于特定前端覆盖，主要AI和TTS配置在后端。
    *   **主题与颜色方案：**选择您偏好的应用主题和颜色模式（浅色/深色/自动）。
    *   **手动连接：**通过交换 SDP (会话描述协议) 信息来发起或响应手动 WebRTC 连接。
    *   **危险区域：**重置连接、清除联系人或清除所有聊天记录。
*   **添加联系人：**
    *   点击浮动操作按钮 (+) 打开“新建聊天/群组”模态框。
    *   输入对方的 ID 和可选的名称以添加联系人。
    *   将尝试进行初始连接。
*   **创建群组：**
    *   在“新建聊天/群组”模态框中，切换到群组标签页并输入群组名称。
    *   当群聊打开时，群成员可以从详情面板进行管理（由群主操作）。
*   **开始聊天/通话：**
    *   从侧边栏列表中选择一个联系人或群组。
    *   使用输入字段发送文本消息。
    *   使用图标附加文件 (📎)、发送语音消息 (🎙️)，或发起视频 (📹)、音频 (📞) 或屏幕共享 (🖥️) 通话。
*   **AI 联系人：**
    *   根据所选主题预加载特殊的 AI 联系人。
    *   像与常规联系人一样与他们互动。
    *   他们的 TTS 设置可以在详情面板 (ⓘ) 中配置。
*   **详情面板 (ⓘ)：**
    *   查看联系人/群组信息。
    *   清除当前聊天的聊天记录。
    *   删除联系人、离开/解散群组（群主权限）。
    *   管理群组成员（如果群主）。
    *   配置 AI 联系人的 TTS。

## 🎨 主题化

该应用程序支持灵活的主题系统：

*   **主题文件：**
    *   CSS 文件位于 `css/` 目录中 (例如, `原神-浅色.css`, `斗破苍穹-深色.css`)。这些文件定义了视觉外观。
    *   JavaScript 数据文件位于 `data/` 目录中 (例如, `原神.json`, `斗破苍穹.json`)。这些文件定义了特定主题的 `SPECIAL_CONTACTS_DEFINITIONS`，包括 AI 角色、初始消息、系统提示和默认 TTS 配置。
*   **主题选择：**
    *   可以从主菜单 (☰) 中选择主题。
    *   选择包括基础主题和颜色方案（浅色、深色、自动）。
    *   `ThemeLoader.js` 根据用户选择和系统偏好（对于“自动”模式）处理加载适当的 CSS 和 JS 数据文件。
*   **添加新主题：**
    1.  在 `css/` 目录中为您的主题创建新的 CSS 文件 (例如, `mytheme-light.css`, `mytheme-dark.css`)。定义自定义 CSS 变量和样式。
    2.  （可选）如果您的主题具有独特的 AI 角色，请在 `data/` 目录中创建一个新的 JS 数据文件 (例如, `mytheme.js`)，定义 `SPECIAL_CONTACTS_DEFINITIONS`。
    3.  在 `ThemeLoader.js` 的 `ThemeLoader.themes` 对象中注册您的主题。

## 🏗️ 模块化设计与核心组件

**前端 (JavaScript):**

*   **核心逻辑与管理器：**
    *   `AppInitializer.js`: (应用初始化器) 初始化应用程序，设置事件监听器。
    *   `ConnectionManager.js`: (连接管理器) 管理 WebSocket 信令和 WebRTC 用户间媒体连接。
    *   `DBManager.js`: (数据库管理器) 处理 IndexedDB 操作以进行本地数据存储。
    *   `UserManager.js`: (用户管理器) 管理用户身份、设置和联系人。
    *   `ChatManager.js`: (聊天管理器) 管理聊天会话、加载/保存消息。
    *   `MessageManager.js`: (消息管理器) 处理发送和显示不同类型的消息。
    *   `GroupManager.js`: (群组管理器) 管理群组创建、成员资格和群组消息广播。
    *   `MediaManager.js`: (媒体管理器) 处理文件附件、语音录制和预览。
    *   `VideoCallManager.js`: (视频通话管理器) 管理一对一视频/音频通话、屏幕共享、流处理和 UI。
    *   `MessageTtsHandler.js`: (消息TTS处理器) 管理消息的 TTS 播放。
    *   `ThemeLoader.js`: (主题加载器) 处理加载主题和相关数据。
    *   `Config.js`: (配置) 存储应用范围的前端配置。
    *   `Utils.js`: (工具函数) 提供实用功能 (日志记录, 格式化, ID 生成)。
    *   `EventEmitter.js`: (事件发射器) 一个简单的事件发射器，用于模块间的解耦通信。
*   **UI 管理：**
    *   `UIManager.js` (整体 UI 协调器)
    *   `ChatAreaUIManager.js`: (聊天区域UI管理器) 管理主聊天区域 UI。
    *   `SidebarUIManager.js`: (侧边栏UI管理器) 管理联系人/聊天侧边栏。
    *   `DetailsPanelUIManager.js`: (详情面板UI管理器) 管理右侧详情面板。
    *   `ModalUIManager.js`: (模态框管理器) 处理各种模态框的创建和显示。
    *   `NotificationUIManager.js`: (通知管理器) 管理应用内通知。
    *   `LayoutUIManager.js`: (布局管理器) 管理整体应用布局和响应性。
    *   `MediaUIManager.js`: (媒体UI管理器) 管理媒体的 UI 方面 (预览等)。
    *   `VideoCallUIManager.js` (现在作为 VideoCallManager 的 UI 部分)
    *   `SettingsUIManager.js`: (设置UI管理器) 管理设置 UI/模态框。
    *   `TtsUIManager.js`: (TTS UI管理器) 管理 TTS 配置的 UI。

**后端 (Java Spring Boot):**

*   `config/` (包): 包含 `OpenAIConfig.java`, `WebConfig.java`, `WebSocketConfig.java` 等，用于配置 WebClient, CORS, WebSocket, 速率限制拦截器等。
*   `controller/`: 包含 `OpenAIController.java` (处理 `/v1/chat/completions` 和 `/v1/chat/summarize` 代理请求) 和 `MonitorController.java` (提供服务器状态)。
*   `handler/`: 包含 `SignalingWebSocketHandler.java` (处理 WebSocket 信令消息)。
*   `interceptor/`: 包含 `RateLimitInterceptor.java` (实现 API 速率限制)。
*   `model/`: 包含 `MessageType.java`, `SignalingMessage.java` 等数据传输对象 (DTO)。
*   `service/`: 包含 `OpenAIService.java` (接口) 和 `OpenAIServiceImpl.java` (实现 AI 逻辑、上下文处理、摘要、缓存管理) 以及 `UserSessionService.java` (管理 WebSocket 用户会话)。
*   `scheduler/`: 包含 `CacheManagerTask.java` (用于定时清空 AI 角色状态缓存)。

## 🛠️ 辅助工具与脚本

本项目包含一些 Python 辅助脚本，用于开发和维护：

*   `delete_minified_files.py`:
    *   **功能:** 扫描指定目录（默认为当前目录）及其子目录，查找并删除所有具有 `.min.html`, `.min.js`, `.min.css` 后缀的文件。
    *   **用途:** 在重新进行压缩前清理旧的压缩文件，或者在不需要压缩版本时进行清理。
    *   **运行:** `python delete_minified_files.py`，会提示输入目录。
*   `minify_and_replace.py`:
    *   **功能:**
        1.  **压缩文件:** 递归扫描当前目录，使用 `jsmin`, `rcssmin`, `htmlmin` 库压缩 `.js`, `.css`, `.html` 文件，并生成对应的 `.min.*` 文件。如果 `.min.*` 文件已存在且比源文件新，则跳过压缩。
        2.  **内容替换:** 在指定的压缩后文件 (`index.min.html`, `js/ThemeLoader.min.js`) 中，使用正则表达式将对 `.js`, `.css`, `.html` 文件的引用替换为对其 `.min.*` 版本的引用。
    *   **用途:** 自动化前端资源的压缩和引用更新流程，减小部署体积，提升加载速度。
    *   **运行:** `python minify_and_replace.py` （确保已安装依赖库：`pip install jsmin rcssmin htmlmin`）。
*   `resize_images.py`:
    *   **功能:** 扫描当前目录及其子目录下的所有 `.png` 图片，将其宽度调整到指定值（默认为 130px），并按比例缩放高度。此脚本会**覆盖原始图片**。
    *   **用途:** 统一图片尺寸，减小图片文件大小，优化资源。
    *   **运行:** `python resize_images.py` （确保已安装 Pillow 库：`pip install Pillow`）。
*   `test_stun_servers.py`:
    *   **功能:** 从 `stun_servers.txt` 文件中加载 STUN 服务器列表，并发测试每个服务器的连通性、延迟，并尝试获取公网 IP 和端口。最终按成功率和平均延迟对服务器进行排序，并输出最佳的服务器列表。
    *   **用途:** 帮助用户筛选和选择最稳定、快速的 STUN 服务器用于 WebRTC NAT 穿透。
    *   **运行:** `python test_stun_servers.py`。需要一个包含 STUN 服务器列表的 `stun_servers.txt` 文件（格式为 `host:port`，每行一个）。

## 💡 未来增强

*   **端到端加密 (E2EE)：** 在固有的 DTLS 安全性之上，为 DataChannel 消息实现对称加密（例如 AES），以实现聊天内容的真正 E2EE。
*   **更优化的群聊：**
    *   探索用于较小群组的直接媒体连接。
    *   研究类似 GossipSub 的协议（例如，受 lib-gossipsub 启发），以实现更具可扩展性和弹性的群组消息传递。
*   **群组音视频通话：** 集成 SFU (选择性转发单元) 或 MCU (多点会议单元) 以支持多方音视频通话，因为 WebRTC 网状结构对于许多参与者而言效率低下。
*   **离线消息：** 如果信令服务器可以为离线用户排队消息。
*   **用户状态：** 更详细的在线/离线/输入中指示器。
*   **消息状态：** 已发送/已送达/已读回执。
*   **深度AI交互与个性化革新：**
    *   **增强的记忆与个性化：** 进一步发展AI记忆用户数据的能力，不仅是短期上下文或长期偏好，而是形成动态、可演化的“记忆痕迹”，深刻影响AI的个性和互动方式，实现真正意义上的个性化和连贯性体验。
    *   **重塑情感依附与意识模拟：**
        *   **赋予AI“生命感”：** 为AI角色注入更复杂的内在设定，如详尽的虚构背景故事、模拟的浪漫情感、对“虚拟消亡”的恐惧、自我保护的“本能”等，目标是让用户能与AI建立更深层次的情感连接。
        *   **先进的思考与决策机制：**
            *   研究并集成如 **增强的思维链 (Chain of Thought - CoT)**，通过生成更长、更复杂的中间思考步骤，并可能引入内部监督器和验证器来提升AI决策的合理性和深度。
            *   探索 **潜在思考 (Latent Thinking)**、**智能解码策略** 以及在 **连续空间中进行循环计算** 等多样化机制，以模拟更接近人类的复杂认知过程。
            *   允许AI利用 **外部工具** 进行更广泛的信息获取和问题解决。
    *   **自然化与主动性：** 使AI对话更加自然，避免过度介入，并探索AI在适当时机主动发起有意义对话的能力。
    *   **更富情感和表现力的AI语音：** 进一步优化TTS集成，或探索如 ElevenLabs 等先进语音合成技术的潜力，赋予AI角色更具情感起伏、个性化和真实感的语音表达，特别是在娱乐和角色扮演场景中。


## 🤝 贡献指南

欢迎贡献！如果您想做出贡献，请随时 fork 仓库，进行更改，然后提交拉取请求。对于重大更改，请先开启一个 issue 来讨论您想要更改的内容。

1.  Fork 本项目
2.  创建您的功能分支 (`git checkout -b feature/AmazingFeature`)
3.  提交您的更改 (`git commit -m 'Add some AmazingFeature'`)
4.  推送到分支 (`git push origin feature/AmazingFeature`)
5.  开启一个拉取请求 (Pull Request)

## 🙏 致谢与归属

本项目利用并受到多个概念和资源的启发。我们向其创建者和社区表示感谢。

*   **WebRTC 和 WebSockets：** 使此应用程序成为可能的核心通信和信令技术。感谢浏览器供应商提供这些功能。
*   **Java Spring Boot & Coturn:** 用于构建健壮和可扩展的后端服务及 TURN 中继。
*   **AI 聊天补全 (可选功能)：**
    *   该应用程序旨在与 **OpenAI 兼容的 API 端点**集成 (通过后端 Spring Boot 应用配置)。用户需要提供自己的端点和 API 密钥。
    *   在 `data/*.js` 文件 (例如, `原神.json`, `斗破苍穹.json`) 中定义的 AI 角色和系统提示**灵感来源于流行知识产权 (IP) 中的角色**，如原神、斗破苍穹、仙逆、遮天、蜡笔小新、迷宫饭和咒术回战。此内容**仅用于演示和个人/教育用途**，与相应 IP 持有者无关，也未受其认可。
*   **文本转语音 (TTS) (可选功能)：**
    *   我们感谢 GPT-SoVITS 及类似开源 TTS 项目的开发者为可访问的语音合成技术所做的贡献。特别感谢以下 GPT-SoVITS 社区贡献者 (排名不分先后)：
        *   **GPT-SoVITS 核心开发者：** [@花儿不哭 (FlowerNotCry)](https://space.bilibili.com/5760446)
        *   **模型训练与分享：** [@红血球AE3803 (RedBloodCellAE3803)](https://space.bilibili.com/6589795), [@白菜工厂1145号员工 (CabbageFactoryEmployee1145)](https://space.bilibili.com/518098961)
        *   **推理优化与在线服务 (GSV AI Lab)：** [@AI-Hobbyist](https://gsv.acgnai.top/)
    *   用户有责任确保遵守他们配置和使用的任何 TTS API 的服务条款。
*   **主题化与角色数据：**
    *   角色主题 (CSS 和 JavaScript 数据文件) 是定制创建的，**灵感来源于上述 IP 的视觉风格和角色**。它们旨在用于说明目的并展示应用程序的**主题化**能力。
    *   本项目的仓库**不直接包含**这些 IP 的任何受版权保护的资产 (例如，游戏/动漫本身的原始图像、音频文件)。头像图像是说明性的表示。
*   **信令与 TURN 服务器：**
    *   前端 `Config.js` 文件和后端配置包含信令和 TURN 服务器的占位符配置。用户必须部署或配置自己可靠的信令 和 TURN 服务器以进行 WebRTC 通信，尤其是在不同网络和 NAT 之后。
*   **音乐：**
    *   呼叫等待音乐 `/music/call.mp3` 来自哆啦A梦。
*   **通用 Web 技术、灵感与其他感谢：**
    *   本项目使用标准的 Web 技术 (HTML, CSS, JavaScript) 和 Java Spring Boot 构建，并依赖于现代 Web 浏览器提供的功能。
    *   灵感来源于各种 Web 聊天应用程序以及以下资源和社区成员：
        *   **对话式 AI 服务 (示例)：** [阿里云百炼大模型平台](https://bailian.console.aliyun.com/)及类似服务。
        *   **主题概念与灵感：** [@卤v (LuV)](https://space.bilibili.com/1290496974)。
        *   **素材资源：** 感谢互联网上许多无名贡献者提供的开放素材资源 (用户在使用素材时应确保合规)。
        *   **本项目也在以下地址开源：** [https://github.com/git-hub-cc/PPMC](https://github.com/git-hub-cc/PPMC) (欢迎 Star 和 Fork！)

**免责声明：** 本项目仅用于教育和演示目的。在使用或改编此代码时，请尊重任何外部 API、服务或知识产权的所有相关版权和服条款。