# TouchFish拓展版

**Repository Path**: xx2870/touchfish_more

## Basic Information

- **Project Name**: TouchFish拓展版
- **Description**: 机房聊天软件：此仓库根据https://gitee.com/xx2870/TouchFish衍生，相对来说更好用。
- **Primary Language**: Python
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-09-13
- **Last Updated**: 2026-01-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

> [TouchFish拓展版（github项目）](https://github.com/xie2870/touchfish_more)。

# TouchFish 拓展版

**重要提示：本拓展版不与官方 v4 版本兼容，目前已暂停更新！建议使用最稳定的 [v3.2.0](https://gitee.com/xx2870/touchfish_more/archive/refs/tags/v3.2.0%E6%8B%93%E5%B1%95%E7%89%88.zip)，最新版（v4.0.0）问题较多，暂不推荐使用。**

#### 项目介绍
这是一个基于 [TouchFish](https://gitee.com/xx2870/TouchFish) 开发的增强版本，在保持与原版完全兼容的基础上，进行了多项优化与功能扩展。你可以把它看作是一个更稳定、更好用的“TouchFish 改良版”。  
无论你连接的是原版 TouchFish 的哪个版本（官方v4版本以下），拓展版都能正常通信，不会出现兼容性问题！

#### 主要用途
这是一个轻量级的局域网聊天工具，支持文字聊天和文件传输，适合团队内部、机房环境或朋友之间快速沟通和共享文件。

#### 安装指南

1.  下载本仓库的 ZIP 文件。
2.  解压到任意目录。
3.  根据你的操作系统进入对应文件夹：
    *   **Windows 用户**：打开 `windows` 文件夹，直接运行里面的 `.exe` 可执行文件。
    *   **macOS 用户**：打开 `macos` 文件夹，运行其中的应用程序。  
        **注意**：如果首次运行时提示“无法打开”，请前往**系统设置 > 隐私与安全性**，找到该应用并点击“允许”。然后在弹出的窗口中确认“运行”即可。
    *   **Linux 用户**：需要运行 Python 源代码。请确保已安装 Python 3，所有依赖均为标准库，无需额外安装。

#### 文件说明

*   `chat`：**服务器端**。负责创建聊天室，管理用户连接和消息转发。
*   `client`：**客户端（图形界面版）**。用户通过它连接服务器，进行聊天和文件传输。
*   `admin`：**管理员系统**。提供更多服务器管理功能。
*   `clientcli`：**命令行客户端**。适合喜欢使用命令行的用户。

更详细的使用方法和功能说明，请参阅本项目的 [Wiki 页面](https://gitee.com/xx2870/touchfish_more/wikis/%E4%BD%BF%E7%94%A8%E6%96%B9%E6%B3%95)。

#### 如何参与改进

我们欢迎任何形式的贡献！在提交代码或建议前，请务必阅读 [贡献者须知](https://gitee.com/xx2870/touchfish_more/wikis/%E8%B4%A1%E7%8C%AE%E8%80%85%E9%A1%BB%E7%9F%A5)，感谢你的支持！

**主要贡献者：**
*   **xx2870**：项目创建者与核心开发者。
*   **洛谷用户 O_O6**：开发了初版的 `client_O2` 图形界面客户端。

#### 相比于原版 TouchFish，拓展版有哪些优势？

1.  **开箱即用**：无需安装任何第三方 Python 库，系统自带环境即可运行。
2.  **全平台支持**：为 Windows 和 macOS 提供了编译好的可执行文件，Linux 则保持源代码的灵活性。
3.  **强化管理**：新增 `kick` 功能，可强制断开违规用户连接，并配合 `ban` 实现更有效的管理。
4.  **体验优化**：自动刷新日志文件，操作更流畅。
5.  **安全退出**：服务器使用 `exit` 命令关闭时，会自动通知所有客户端安全断开，避免残留连接。若想静默关闭，可直接点击窗口关闭按钮。

#### 版本说明

项目发布两种版本：
*   **预览版**：包含最新功能，但可能存有一些未知问题，适合尝鲜和测试。
*   **正式版**：经过测试，已知问题已修复的稳定版本，推荐大多数用户使用。

**各平台发布策略：**
*   Windows：每个版本（包括预览版和正式版）都会更新可执行文件。
*   macOS：仅正式版会更新可执行文件。
*   Linux：所有版本均以 Python 源代码形式提供。

---
如果觉得这个项目对你有帮助，欢迎点击页面右上角的 **Star** 支持一下，这是对我们最大的鼓励！