v1.0.0

GCchat

基于蓝盾(Radmin VPN)的局域网群聊

⬇下载安装包 查看用法

v2.0.5 · Windows · 需先安装并加入 Radmin VPN 网络 · 凌序工作室开发

核心能力

💬 文字 / 图片 / 文件 实时群聊

🛡️ 房主开服,成员凭蓝盾 IP 加入

👥 在线成员列表 · 🔔 未读消息提醒

🎨 自定义头像、本地消息持久化

关于 GCchat

GCchat 是一款面向小圈子、局域网场景的轻量群聊软件。它借助 蓝盾(Radmin VPN) 组建虚拟局域网,让分散在不同物理网络下的朋友也能像在同一局域网内一样即时聊天。无需公网服务器、无需注册账号,开箱即用。

核心特性

极简组网

无需公网服务器,房主在本机开启房间,其他人输入房主蓝盾 IP 即可加入。

文字 / 图片 / 文件

支持发送图片(自动压缩显示缩略图)与任意文件(≤15MB,接收后一键保存)。

在线成员列表

聊天页右侧实时显示成员头像、昵称与在线状态。

未读消息提醒

窗口失焦时红点 + 标题计数 + 任务栏闪烁,可在设置关闭。

自定义头像

自动生成 / 纯色 / 上传图片三种模式,可随时在设置中更换。

个性化设置

浅色 / 深色主题、字号、发送快捷键、消息时间显示,均即时生效并持久保存。

会话记忆

已在群聊则下次启动直接进入(含自定义头像),断线后台自动重连。

本地持久化

房主与成员各在本机保存聊天记录,断网也能翻看历史。

消息管理

右键消息可撤回 / 引用 / 复制;自己的消息以主题色气泡靠右显示,他人的靠左,一眼可分。

一键复制地址

顶栏直接复制「IP:端口」加入地址,不用手抄蓝盾 IP。

自定义端口

默认 9527,也可指定 1024~65535 的其他端口(同机多房间、端口被占用时有用),并记住上次选择。

全屏模式

按 F11 进入 / 退出全屏。

自动检查更新

启动时与每 6 小时自动检查,发现新版本弹窗引导下载,可在设置中关闭或手动检查。

更多产品

导航内置「更多产品」页,展示作者的其他项目,点击直达。

退出群聊

一键断开并清除会话,下次回到启动界面重新选择。

开场动画

启动时有凌序工作室出品的专属开场动画(可点击跳过)。

适用场景

宿舍开黑、办公室临时沟通、家庭相册分享、线下活动群通知等小范围、低延迟的即时通讯需求。

技术架构

架构

经典的 C/S(客户端 / 服务器)模式。房主即服务器,在本机监听端口(默认 9527,可自定义为 1024~65535 的其他端口)并接受成员连接;成员作为客户端连接房主。

网络层

基于 蓝盾(Radmin VPN) 的虚拟局域网,通信发生在局域网内,延迟低、无需公网穿透。

传输协议

采用「4 字节大端长度前缀 + UTF-8 JSON」的帧格式,可安全传输含中文与换行的文本,图片 / 文件以 base64 内嵌(图片 ≤4MB、文件 ≤15MB)。

技术栈

Python 3.11 + PySide6(Qt 6)构建桌面界面,标准库 socket / threading / sqlite3 实现通信与本地存储,单文件绿色打包。

并发模型

每个连接由独立线程处理,网络事件通过 Qt 信号跨线程投递到 UI,避免界面卡顿。

隐私与安全

数据不出局域网

消息仅在蓝盾虚拟局域网内的成员之间传输,不经过任何公网第三方服务器。

本地存储

聊天记录以 SQLite 文件保存在本机,房主与每位成员各存一份,掌控在自己设备上。

无账号体系

不收集手机号、邮箱等个人信息,昵称仅用于在群内标识,可随时更改。

最小权限

仅需局域网通信与本地文件读写权限;首次运行若被防火墙拦截,手动允许「专用网络」即可。

内测与反馈

当前版本处于 快照版快速迭代阶段,由 凌序工作室 持续测试与打磨。我们欢迎在测试过程中反馈任何问题、建议或崩溃日志,这将直接帮助产品打磨得更稳更好。

  • 反馈渠道:通过凌序工作室内部群组提交问题截图与复现步骤。
  • 测试重点:跨机联调、文字 / 图片 / 文件收发、在线成员列表、未读提醒、深色模式、断线重连、历史记录加载。

© 凌序工作室 · GCchatAI · v1.0.0

帮助 · 使用步骤

1. 安装并加入蓝盾网络

  • 所有参与者安装 Radmin VPN,启动并加入同一个网络。
  • 记下房主的蓝盾 IP(形如 26.x.x.x 或 27.x.x.x)。

2. 房主:创建群聊

  • 打开 GCchat → 选择「创建群聊」→ 输入昵称 → 开始。
  • 本机会自动启动服务器并进入群聊,把你的蓝盾 IP 发给朋友即可。

3. 成员:加入群聊

  • 打开 GCchat → 选择「加入群聊」→ 输入昵称与房主蓝盾 IP → 开始。

4. 退出与重进

  • 聊天窗口右上角「退出群聊」可断开并清除会话,下次启动回到启动界面。
  • 已在群内时,程序启动会自动重连,无需重新输入。

常见问题排查

  • 连不上:确认双方都在同一个蓝盾网络,且房主已「创建群聊」。
  • 防火墙:若连接被拒,允许 GCchat 通过 Windows 防火墙(专用网络)。
  • 图片过大:单张图片上限 4MB,过大将自动压缩或拦截提示;文件上限 15MB。

QAF · 常见问题

Q:一定要用 Radmin VPN(蓝盾)吗?不能直接公网联机?
A:本版仅支持蓝盾虚拟局域网内的互联,不依赖公网服务器。只要双方在同一蓝盾网络、能互相 ping 通即可。
Q:为什么我输入房主 IP 却连不上?
A:请确认:① 房主已点击「创建群聊」;② 你俩在同一蓝盾网络;③ 房主防火墙放行了 GCchat(默认端口 9527)。
Q:聊天记录会丢失吗?
A:不会。房主与每个成员都会在本机 SQLite 保存自己见过的消息,断网或重启后都能翻看历史;新成员加入时房主会先下发最近 200 条。
Q:发送图片 / 文件失败或很慢?
A:单张图片上限 4MB(发送前自动压缩)、文件上限 15MB,过大将被拦截;局域网带宽通常足够,若卡顿多为房主端网络或双方不在同一蓝盾子网。
Q:头像怎么换?为什么大家的头像不一样?
A:默认头像由昵称在本机哈希生成,稳定且一致(同一昵称在所有客户端显示相同);也可在设置页或登录界面切换为纯色或上传自定义图片。
Q:退出群聊后还能看到之前的记录吗?
A:能看到。退出只清除「自动进入」的会话标记,本地数据库中的历史记录仍然保留。
Q:可以开多个房间吗?
A:当前版本为单房间模式,一个房主 IP 对应一个群聊。如需多房间可启动多个房主实例使用不同端口。

更新日志

当前版本 v2.0.5 · 查看本次更新公告

v2.0.52026-10-24修复
  • 修复(重要):设置里开关「气泡显示发送时间」会把聊天记录全部清空的问题;切换时保持当前阅读位置,不再被拽到底部。
  • 修复:退出登录 / 被封禁时,提示条与首次更新检查的定时器可能触发程序崩溃。
  • 修复:切换头像纯色时会重复保存并多广播一次头像更新。
v2.0.42026-10-24优化
  • 优化:输入框旁的「图片」「文件」合并为一个「更多」菜单——点开即可选图片或文件,输入栏更简洁。
  • 说明:后续新功能(表情、截图等)将统一加入「更多」菜单,不再单独加按钮。
v2.0.32026-10-23优化
  • 新增:窗口尺寸记忆——启动对话框与主窗口调整大小后,下次打开自动沿用,不再每次回到同一个固定值。
  • 优化:启动对话框默认高度改为 470px(一屏可看全 IP / 端口 / 头像),最低仍为 300px,可自由拉高。
v2.0.22026-10-23修复
  • 修复:深色模式下设置页一片白、文字看不清——设置页背景色未跟随主题,已修正。
  • 修复:浅色模式下导航栏是一条深蓝带,与浅色界面不协调;改为浅底深字,并加分隔线。
  • 修复:浅色模式下导航标题「GCchat」消失(文字色被写死为白色)。
  • 修复:顶栏「复制地址 / 重连」按钮白字发虚,已加深按钮底色提升对比度。
  • 优化:设置页改为可滚动,主窗口最小高度从 1347px 降到约 290px,窗口可自由拉矮拉高。
v2.0.12026-10-23优化
  • 优化:启动窗口不再这么高了——最低高度从 470px 降到 300px,且默认就以最矮状态打开;窗口可自由拉高,内容超出时上下滚动查看,不再出现底部内容被裁、按钮点不到的情况。
  • 优化:头像选择区改为横排,启动窗口更紧凑。
  • 说明:本次改动仅涉及启动窗口尺寸与排布,群聊、AI 等功能逻辑无变化。
v2.0.02026-10-22beta 测试版
  • 新增:AI 助手正式开放(左侧导航第 2 项)——支持多轮对话、随时切换模型,可自定义系统提示词。
  • 新增:AI 配置(设置 → AI 配置)——内置 OpenAI / DeepSeek / Moonshot Kimi / 智谱 GLM / 通义千问 / Ollama 本地 / 自定义 共 7 类接口提供方,采用通用的 OpenAI 兼容格式;密钥默认掩码、可手动显示,模型列表可自行增删。
  • 说明:密钥仅保存在本机 profile.json,不会上传;请勿在共用电脑上勾选「显示」或外传该文件。配置改动即时生效,无需重启。
  • 说明:AI 请求失败时会给出明确原因(密钥无效 / 地址或模型不正确 / 额度不足 / 超时等);超时时间 60 秒,多轮对话最多携带最近 20 条历史。
  • 已知限制:AI 回复为非流式输出(需等整段返回);对话记录仅保存在内存中,重启后清空。
v1.9.62026-10-21正式版
  • 新增:房主专属管理员——房主自动获得管理员身份(金色聊天气泡 + VIP 标识 + 头像金色描边),并可发送专属指令:/kick 昵称 踢人、/ban 昵称 封禁、/unban 解封、/mute 昵称 禁言、/unmute 解禁、/clear 清屏、/exit 关闭房间、/help 帮助。
  • 说明:封禁与禁言记录保存在房主本机,房主重启后依然有效;被封禁的成员会收到明确提示且不再自动重连(避免反复被拒刷屏)。
  • 新增:关闭窗口时新增「仅退出」选项——直接退出程序但保留群聊会话,下次启动自动回到该群聊;「退出登录」则回到登录界面。
  • 修复:清屏权限漏洞——此前任何一个成员都能清空所有人的聊天记录,现限定仅房主可操作。
  • 说明:管理员身份按连接来源判定(房主经本地回环接入),不依赖昵称,避免他人改个名字就取得管理员权限。
v1.9.52026-10-21修复
  • 修复:安装后依然进不了聊天界面(点「开始」无反应)。1.9.4 把用户档案与会话改存到安装目录,但安装目录位于 Program Files,普通运行的应用没有写入权限,保存档案即失败。现改为存到 %LOCALAPPDATA%\GCchat。
  • 改进:自动迁移 1.9.4 遗留在安装目录中的档案与聊天记录,升级后不会丢历史。
  • 说明:聊天记录现位于 %LOCALAPPDATA%\GCchat\data,可直接复制该目录做备份。
v1.9.42026-10-20修复
  • 修复:安装包无法进入聊天界面——下载安装后点「开始」没有反应。原因是打包后的程序把用户档案保存在包内一个并不存在的路径,导致保存失败;现已改为保存到安装目录,档案 / 会话 / 聊天记录都能正常读写。
  • 改进:保存档案与会话时会自动创建缺失的目录,避免同类问题以其他形式复现。
  • 说明:此问题只影响安装包版本,直接 python main.py 运行不受影响。
v1.9.32026-10-19新增
  • 新增:一键复制加入地址——顶栏「复制地址」按钮,把「IP:端口」复制到剪贴板,省去手抄蓝盾 IP;成员端也能复制房主地址转给他人。
  • 新增:导航 「更多产品」页,展示作者的其他项目,点击直达。产品列表来自官网(products.json),增删项目无需重新发版;没网时优雅显示占位并可重试。
  • 新增:F11 全屏——按 F11 进入/退出全屏,全屏时也可按 Esc 退出;在输入框中打字时同样生效。
  • 新增:自定义端口——创建/加入群聊时可指定端口(1024~65535),会记住上次使用的端口。同一台机器开多个群、或默认端口被占用时可用。
  • 修复:自定义端口在下次启动(自动进入群聊)时被写回默认端口,导致连不上自建房间。
  • 修复:连接失败提示里端口号写死为默认值,改为显示实际使用的端口。
v1.9.22026-10-18新增
  • 新增:自己的消息改为主题色气泡并靠右,他人的保持白底靠左——原先两者同款白底,只能靠位置分辨,现在颜色也一眼可分(文件消息卡片同步)。
  • 新增:自动检查更新——启动 8 秒后自动检查一次,之后每 6 小时检查;发现新版本弹窗显示版本与更新说明,可一键前往下载。设置页可关闭自动检查或手动检查。
  • 修复:发送图片与上传自定义头像在当前 PySide6 下直接失败(QImage.save() 只接受 QIODevice,原写法传 QByteArray 会抛 TypeError),改为经 QBuffer 中转。
  • 修复:渲染文件消息时崩溃(FileMessage 缺失 is_self 属性)。
  • 修复:检查更新期间关闭窗口,后台线程信号源已删除导致抛出 RuntimeError。
v1.9.12026-10-18新增
  • 新增:右键消息弹出菜单(撤回 / 引用 / 复制),点在文字、头像、图片上都能弹出。
  • 新增:撤回消息——仅本人可撤回自己的消息,撤回后所有人视图一致地显示"XX 撤回了一条消息"(服务端校验身份,越权撤回会被拒绝)。
  • 新增:引用消息——被引用内容以引用块形式随消息展示,发送前输入栏上方显示预览条,可一键取消。
  • 新增:复制按类型区分——文本复制文字、图片复制图片本体、文件复制文件名。
  • 修复:进入群聊、自己发送消息时没有自动滚动到最底部(滚动条量程延迟更新导致贴底取值过期)。
  • 兼容:旧版本客户端与旧数据库可无缝升级(历史消息无消息 ID,其撤回/引用选项自动置灰)。
v1.9.02026-09-24修复
  • 修复:多人同时收发大文件/消息时偶发"消息错乱"——服务端多线程并发写同一连接导致帧交错,现已全量串行化发送。
  • 修复:僵尸连接残留——服务端新增 90s 空闲回收,成员列表不再显示已掉线的人。
  • 修复:设置关闭"未读消息提醒"后标题仍会显示未读数(现完全静默)。
  • 修复:重启后自定义头像退回默认头像(会话自动进入时未读取本地档案)。
  • 修复:长文本消息把气泡撑满整行(现限宽自动换行);状态栏错误提示永久残留(现 2.5 秒自动还原)。
  • 加固:服务端二次校验图片/文件大小与文本长度;启动对话框支持回车直接开始。
  • 网页:下载卡片、特性介绍、QAF 头像说明等多处与新版本不一致的描述已统一更新。
v1.8.02026-09-24快照版
  • 新增:未读消息提醒(红点 + 标题计数 + 任务栏闪烁),设置中可关闭。
  • 新增:在线成员列表(右侧实时显示成员与在线状态,进/退群、改头像即时刷新)。
  • 新增:文件传输(任意文件 ≤15MB,接收后一键保存到本地)。
v1.7.02026-09-19修复
  • 修复:深色模式下部分文字(登录框、设置页、关于页、下拉框选项等)因背景为浅色、前景也为浅色而"看不见"的问题——全局控件统一使用主题背景色,并显式配置下拉框 / 滚动条配色。
v1.6.02026-09-19正式版
  • 新增「更多设置」:发送快捷键(Enter 发送 / Ctrl+Enter 换行,可反向切换)、消息时间显示开关、字号(小 / 中 / 大)、浅色 / 深色主题,均即时生效并持久保存。
  • 修复:退出群聊点「是」后聊天窗口不关闭(closeEvent 内同步嵌套登录框所致,改为窗口关闭完成后再回到登录界面)。
  • 修复:连接失败提示中的端口号硬编码,改为读取默认端口常量。
v1.5.52026-09-18
  • 修复:点「重连」会新建一条接收线程,与旧线程并存导致双重连接、消息重复——改为只断开当前连接,由既有接收循环自行重连。
  • 修复:退出群聊未停止本地服务器,房主再次"创建群聊"时端口 9527 绑定失败(Address already in use),旧服务器线程泄漏。
  • 修复:断线重连后历史消息在聊天界面被重复渲染(重连下发历史前未清空消息区)。
  • 修复:连接"假死"无法检测——recv 无超时、未启用 keepalive,VPN 掉线等导致连接静默断开后既不重连也不提示,消息静默丢失;新增 TCP keepalive + 应用层 ping/pong 心跳(15s)探活。
  • 修复:图片发送一律转 PNG,常见照片因体积超限被误判"图片过大"无法发送——改为 JPEG 压缩(quality 85)。
v1.5.32026-09-18
  • 创建房间时房主可输入 / 自动探测蓝盾 IP;聊天窗口顶部新增"分享给成员"地址,方便把加入地址发给朋友。
v1.5.22026-09-17
  • 修复:无法进入 / 创建群聊的 bug(房主模式下服务器与客户端并发写同一 SQLite 文件,触发 database is locked,建群后首次发消息即断开)。
v1.5.12026-09-17
  • 修复了一些已知 bug。
v1.5.02026-09-17
  • 大更新:新增左侧可折叠导航栏,点击切换右侧内容(群聊 / AI 置灰未开放 / 设置 / 关于)。
  • 设置改为内联页面,关于页新增官网链接 https://gcchat.pages.dev。
v1.4.12026-09-17
  • 退出群聊新增确认弹窗:先询问「是否关闭」,确认后才关闭窗口并回到登录界面。
v1.4.02026-09-17
  • 修复:开场动画结束后无法进入主界面(启动对话框 / 聊天窗口打不开)的严重 bug。
v1.1.32026-09-17内测
  • 「关于」页扩充:新增技术架构、隐私与安全、内测与反馈三个章节。
  • 延续 v1.1.2 内测,无功能代码改动。
v1.1.22026-09-17内测
  • 内测版本发布,供凌序工作室内部测试与反馈。
  • 包含 v1.1.0 开场动画 与 v1.1.1 三项崩溃修复。
v1.1.12026-09-17
  • 修复:头像(dict)写入 SQLite 崩溃,导致服务端收到首条消息即断开、客户端收不到任何消息。
  • 修复:点击「退出群聊」或关闭窗口时 closeEvent 递归调用导致栈溢出的崩溃。
  • 修复:重连时历史记录重复堆积的问题。
v1.1.02026-09-17
  • 新增:软件开场动画(约 3 秒),底部显示「凌序工作室 · 出品」署名。
  • 点击动画任意处可立即跳过,不阻塞进入主界面。
v1.0.12026-09-17
  • 修复:启动对话框按钮 / 输入框文字显示异常(对话框高度不足导致布局压缩、文字被裁切)。
  • 修复:同一昵称在不同电脑上头像颜色不一致的问题。
  • 优化:默认字体改为微软雅黑,Windows 下渲染更稳定。
v1.0.02026-09-17
  • 首个正式版本发布(Windows)。
  • 基于蓝盾(Radmin VPN)的 C/S 架构局域网群聊。
  • 支持创建 / 加入群聊、文本与图片消息。
  • 系统随机头像、本地消息持久化、会话记忆。
  • 进出群系统提示、新消息提醒、断线自动重连、退出群聊。
  • 发布页新增:更新日志、版本号与更新公告。
v0.9.0内测
  • 核心协议与服务器 / 客户端联调完成。
v2.0.5 更新公告

GCchat v2.0.5 修复 🛠

本次以稳定性为主: