# localchat

**Repository Path**: OB19227/localchat

## Basic Information

- **Project Name**: localchat
- **Description**: 局域网内阅后即焚
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-09-28
- **Last Updated**: 2025-09-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 局域网聊天 - 阅后即焚

一个超简单的局域网聊天应用，支持阅后即焚功能，适合局域网内用户进行临时交流。

## 功能特点

- 🔥 **阅后即焚** - 消息在10秒后自动消失
- 👥 **用户昵称** - 支持自定义用户昵称
- 💬 **实时聊天** - 适合局域网内多用户聊天
- 📱 **简洁界面** - 超简单设计，无复杂样式
- ⏰ **消息限制** - 同时最多显示3条消息
- 🌐 **局域网支持** - 专为局域网环境设计
- 📝 **日志记录** - 支持可选的日志文件记录

## 使用方法

### 1. 基本使用
1. 安装Node.js环境（推荐使用Volta管理）
2. 在项目目录下运行 `npm install` 安装依赖
3. 运行 `npm start` 启动服务器
4. 在浏览器中打开 `http://localhost:3000`
5. 输入您的昵称并点击"设置昵称"
6. 开始输入消息并发送
7. 局域网内的其他用户可以通过 `http://您的IP:3000` 访问并加入聊天

### 2. 启用日志记录
默认情况下，日志只输出到控制台。要启用文件日志记录，请使用以下命令：
```bash
npm start -- --logfile
```
或者直接运行：
```bash
node server.js --logfile
```

日志文件将创建在可执行文件所在的目录中，文件名为 `lan-chat.log`。

### 3. 局域网部署

#### 方法一：使用Node.js服务器（推荐）
```bash
# 使用Volta安装Node.js（如果尚未安装）
volta install node

# 安装依赖
npm install

# 启动服务器（带日志记录）
npm start -- --logfile
```
然后通过 `http://您的IP:3000` 访问

#### 方法二：打包为独立exe文件
```bash
# 安装打包工具
npm install

# 打包应用
npm run build

# 运行生成的exe文件（带日志记录）
dist/lan-chat.exe --logfile
```

## 技术特点

- **WebSocket实时通信** - 支持多用户实时聊天
- **HTML + CSS + JavaScript** - 使用原生技术
- **响应式设计** - 适配不同屏幕尺寸
- **无数据库依赖** - 所有数据存储在内存中
- **可选日志记录** - 支持控制台和文件双重日志输出

## 文件结构

```
├── chat.html          # 主聊天页面
├── server.js          # WebSocket服务器
├── logger.js          # 日志模块
├── builder.js         # 打包构建脚本
├── package.json       # 项目配置文件
├── .gitignore         # Git忽略文件配置
├── README.md          # 说明文档
└── dist/              # 打包生成的exe文件目录
    ├── lan-chat.exe   # 独立可执行文件
    └── chat.html      # 聊天页面文件
```

## 界面说明

- **用户信息区域** - 设置和显示当前用户昵称
- **消息显示区域** - 显示聊天消息（最多3条）
- **输入区域** - 输入和发送消息
- **状态提示** - 显示消息自动消失时间
- **在线用户** - 显示当前在线用户列表
- **连接状态** - 显示与服务器的连接状态

## 注意事项

1. **消息自动消失** - 所有消息在10秒后自动删除
2. **消息数量限制** - 同时最多显示3条消息
3. **局域网使用** - 建议在局域网环境下使用
4. **浏览器兼容** - 支持现代浏览器（Chrome、Firefox、Safari、Edge）
5. **日志文件** - 启用日志记录后，日志文件会写入到exe文件所在目录

## 自定义配置

可以在代码中修改以下参数：

```javascript
this.maxMessages = 3;        // 最大消息数量
this.messageTimeout = 10000; // 消息消失时间（毫秒）
```

## 扩展功能

如需添加更多功能，可以考虑：

- 消息持久化存储
- 文件传输功能
- 表情符号支持
- 消息加密

## 许可证

MIT License - 可自由使用和修改

## 贡献

欢迎提交Issue和Pull Request来改进这个项目！

---

**注意：这是一个简单的演示项目，适合局域网内的临时聊天使用。如需生产环境使用，建议添加更多安全性和稳定性功能。**