# transinner

**Repository Path**: Shaksper/transinner

## Basic Information

- **Project Name**: transinner
- **Description**: 一个简单易用的局域网文本实时传输工具，支持多设备在同一WiFi或局域网下实时同步文本内容。
- **Primary Language**: Unknown
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-10
- **Last Updated**: 2026-01-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# transinner - 局域网文本传输工具

一个简单易用的局域网文本实时传输工具，支持多设备在同一WiFi或局域网下实时同步文本内容。

## 功能特性

🔄 实时双向同步 - 多设备同时在线，文本内容实时同步
💾 保存到文件 - 可将文本保存到服务器本地文件
📁 打开文件夹 - 快速打开文件保存目录
🌐 局域网访问 - 支持通过局域网IP访问
📱 响应式设计 - 支持电脑、手机、平板等多种设备
🎨 美观界面 - 现代化UI设计，操作简单直观

## 快速开始

### 使用源码运行

1. 确保已安装 Node.js（建议版本 14 或更高）
2. 在项目目录下运行以下命令安装依赖：
   ```bash
   npm install
   ```
3. 启动服务器：
   ```bash
   npm start
   ```
4. 在浏览器中打开 http://localhost:3000

### 使用打包后的可执行文件

**重要**：打包后的可执行文件需要与 `index.html` 和 `client.js` 一起分发，这些文件必须放在同一个目录下。

#### Windows
1. 将 `transinner-win.exe`、`index.html`、`client.js` 放在同一个目录
2. 双击 `transinner-win.exe` 运行
3. 在浏览器中打开 http://localhost:3000
4. 查看局域网访问地址，在其他设备上访问

#### macOS
1. 将 `transinner-macos`、`index.html`、`client.js` 放在同一个目录
2. 在终端中执行：`./transinner-macos`
3. 在浏览器中打开 http://localhost:3000
4. 查看局域网访问地址，在其他设备上访问

#### Linux
1. 将 `transinner-linux`、`index.html`、`client.js` 放在同一个目录
2. 在终端中执行：`./transinner-linux`
3. 在浏览器中打开 http://localhost:3000
4. 查看局域网访问地址，在其他设备上访问

## 使用说明

1. 在文本框中输入或粘贴内容
2. 内容会自动同步到所有连接的设备
3. 点击"保存到文件"按钮可将当前文本保存到服务器
4. 点击"打开文件夹"按钮可快速打开文件保存目录
5. 保存的文件存储在 `saved_texts` 目录中

## 打包说明

详细的打包说明请参考 [BUILD.md](BUILD.md)

## 文件结构

```
transinner/
├── server.js          # 服务端代码
├── index.html         # 前端页面
├── client.js          # 前端JavaScript代码
├── package.json       # 项目配置文件
├── saved_texts/       # 保存的文本文件目录（自动创建）
├── dist/             # 打包后的可执行文件
│   ├── transinner-win.exe    # Windows版本
│   ├── transinner-macos     # macOS版本
│   └── transinner-linux     # Linux版本
├── build.bat          # Windows打包脚本
├── build.sh          # macOS/Linux打包脚本
├── BUILD.md          # 打包说明文档
└── README.md         # 使用说明文档
```

## 技术栈

- 后端：Node.js + Express
- 实时通信：Socket.io
- 前端：原生 HTML/CSS/JavaScript
- 打包工具：pkg

## 注意事项

1. 确保所有设备连接到同一个WiFi或局域网
2. 如无法访问，请检查防火墙设置
3. 服务器默认端口为3000
4. 首次运行打包后的程序时，会在可执行文件所在目录创建 `saved_texts` 文件夹

## 系统要求

### 源码运行
- Node.js 14 或更高版本

### 打包后的可执行文件
- Windows 7 或更高版本
- macOS 10.13 或更高版本
- Linux (主流发行版)

## 许可证

ISC

## 作者

昶之

## 项目地址

https://gitee.com/Shaksper/transinner