pytcper是基于 Python 3 + tkinter 编写的图形化 TCP 调试工具，支持图形化界面，支持客户端与服务器端，多编码发送，接收，广播指令。零第三方依赖，可跨平台运行(Windows / Linux / macOS)。

文件	最后提交记录	最后更新时间
release	delete: 删除文件 release/pytcper-v2.0.001-linux-aarch64-dir.tar.gz Signed-off-by: micoder <micoder@qq.com>	17 天前
.gitignore	docs: 更新构建报告并补充 openEuler 22.03 兼容性说明 - build-report.md: 新增「系统兼容性（glibc 版本要求）与 openEuler 22.03 适配」，记录高兼容版二进制（便携 Python 构建，要求 GLIBC_2.17）与三种复现构建方法 - .gitignore: 忽略高兼容版构建目录 dist-linux-oe2203/ Co-Authored-By: AtomCode (deepseek-v4-flash) <noreply@atomgit.com>	17 天前
LICENSE	Initial commit	19 天前
README.md	docs: 合并多余 md 报告，仅保留 README.md 与 dev-doc.md - README.md: 新增「二进制分发版」小节（高兼容版 / 本机版 / aarch64） - dev-doc.md: 整合原 analysis-report.md（源码 Bug 分析）、build-report.md 与 BUILD_REPORT.md（构建打包与 glibc 系统兼容性），保留全部原有章节 - 删除 analysis-report.md、build-report.md、BUILD_REPORT.md Co-Authored-By: AtomCode (deepseek-v4-flash) <noreply@atomgit.com>	16 天前
app.py	fix: 修复 Linux 下 socket 关闭与 accept 循环竞态问题 - tcp_utils: 新增 close_socket()（先 shutdown 再 close），修复 Linux 上直接 close 被其它线程阻塞 recv 的 socket 不生效、对端收不到 FIN 的问题 - server_tab: _accept_loop 循环顶部一次性捕获 server_sock，消除停止服务瞬间的 None.accept() 竞态 - app.py: 最小宽度调整至 1200（工作区既有改动，随本次提交一并入库） - docs: 新增 analysis-report.md（项目与源码 Bug 分析报告）、 build-report.md（构建打包报告） Co-Authored-By: AtomCode (deepseek-v4-flash) <noreply@atomgit.com>	17 天前
base_tab.py	fix: 修复 Linux 下 socket 关闭与 accept 循环竞态问题 - tcp_utils: 新增 close_socket()（先 shutdown 再 close），修复 Linux 上直接 close 被其它线程阻塞 recv 的 socket 不生效、对端收不到 FIN 的问题 - server_tab: _accept_loop 循环顶部一次性捕获 server_sock，消除停止服务瞬间的 None.accept() 竞态 - app.py: 最小宽度调整至 1200（工作区既有改动，随本次提交一并入库） - docs: 新增 analysis-report.md（项目与源码 Bug 分析报告）、 build-report.md（构建打包报告） Co-Authored-By: AtomCode (deepseek-v4-flash) <noreply@atomgit.com>	17 天前
build_linux.sh	build: add source encryption and cross-platform packaging support - Add build_linux.sh to produce Linux binaries (PyArmor encrypt + PyInstaller, both dir-mode and one-file) on a Linux x86_64 host, since PyInstaller cannot cross-compile from Windows - Document source encryption and packaging (Windows exe, Linux binary, limitations) in dev-doc - Ignore build artifacts (dist/, dist-linux/, build/, obf/, *.spec) Co-Authored-By: AtomCode (deepseek-v4-flash) <noreply@atomgit.com>	18 天前
client_tab.py	fix: 修复 Linux 下 socket 关闭与 accept 循环竞态问题 - tcp_utils: 新增 close_socket()（先 shutdown 再 close），修复 Linux 上直接 close 被其它线程阻塞 recv 的 socket 不生效、对端收不到 FIN 的问题 - server_tab: _accept_loop 循环顶部一次性捕获 server_sock，消除停止服务瞬间的 None.accept() 竞态 - app.py: 最小宽度调整至 1200（工作区既有改动，随本次提交一并入库） - docs: 新增 analysis-report.md（项目与源码 Bug 分析报告）、 build-report.md（构建打包报告） Co-Authored-By: AtomCode (deepseek-v4-flash) <noreply@atomgit.com>	17 天前
dev-doc.md	docs: 合并多余 md 报告，仅保留 README.md 与 dev-doc.md - README.md: 新增「二进制分发版」小节（高兼容版 / 本机版 / aarch64） - dev-doc.md: 整合原 analysis-report.md（源码 Bug 分析）、build-report.md 与 BUILD_REPORT.md（构建打包与 glibc 系统兼容性），保留全部原有章节 - 删除 analysis-report.md、build-report.md、BUILD_REPORT.md Co-Authored-By: AtomCode (deepseek-v4-flash) <noreply@atomgit.com>	16 天前
server_tab.py	fix: 修复 Linux 下 socket 关闭与 accept 循环竞态问题 - tcp_utils: 新增 close_socket()（先 shutdown 再 close），修复 Linux 上直接 close 被其它线程阻塞 recv 的 socket 不生效、对端收不到 FIN 的问题 - server_tab: _accept_loop 循环顶部一次性捕获 server_sock，消除停止服务瞬间的 None.accept() 竞态 - app.py: 最小宽度调整至 1200（工作区既有改动，随本次提交一并入库） - docs: 新增 analysis-report.md（项目与源码 Bug 分析报告）、 build-report.md（构建打包报告） Co-Authored-By: AtomCode (deepseek-v4-flash) <noreply@atomgit.com>	17 天前
smoke_test.py	update to v1.0	19 天前
start.pyw	docs: add aarch64 build report and release binary packages - 新增 BUILD_REPORT.md 构建总结报告（环境、步骤、产物、验证、注意事项） - 新增 release/ 下 Linux ARM64 单文件与目录方式安装包 - start.pyw 补可执行权限 Co-Authored-By: AtomCode (deepseek-v4-flash) <noreply@atomgit.com>	17 天前
tcp_debug_tool.py	feat: v2.0.001 — encoding auto-detect, keepalive, no-console launcher Code: - Bump version to 2.0.001 - Add unicode encoding variants (UTF-16/32, UTF-8-BOM) via label alias - Auto-detect peer encoding so mismatched encodings display correctly - Enable TCP keepalive so dead/half-open clients are removed promptly Docs: - Update README feature overview and dev-doc tests/tech notes/changelog Launcher: - Add start.pyw and 启动调试助手.bat for console-free startup Co-Authored-By: AtomCode (deepseek-v4-flash) <noreply@atomgit.com>	18 天前
tcp_utils.py	fix: 修复 Linux 下 socket 关闭与 accept 循环竞态问题 - tcp_utils: 新增 close_socket()（先 shutdown 再 close），修复 Linux 上直接 close 被其它线程阻塞 recv 的 socket 不生效、对端收不到 FIN 的问题 - server_tab: _accept_loop 循环顶部一次性捕获 server_sock，消除停止服务瞬间的 None.accept() 竞态 - app.py: 最小宽度调整至 1200（工作区既有改动，随本次提交一并入库） - docs: 新增 analysis-report.md（项目与源码 Bug 分析报告）、 build-report.md（构建打包报告） Co-Authored-By: AtomCode (deepseek-v4-flash) <noreply@atomgit.com>	17 天前
tcp调试工具.png	add files	19 天前
启动调试助手.bat	feat: v2.0.001 — encoding auto-detect, keepalive, no-console launcher Code: - Bump version to 2.0.001 - Add unicode encoding variants (UTF-16/32, UTF-8-BOM) via label alias - Auto-detect peer encoding so mismatched encodings display correctly - Enable TCP keepalive so dead/half-open clients are removed promptly Docs: - Update README feature overview and dev-doc tests/tech notes/changelog Launcher: - Add start.pyw and 启动调试助手.bat for console-free startup Co-Authored-By: AtomCode (deepseek-v4-flash) <noreply@atomgit.com>	18 天前

pytcper TCP调试助手

当前版本：v2.0.001

pytcper TCP调试助手：一个基于 Python 3 + tkinter 编写的图形化 TCP 调试工具，零第三方依赖，可跨平台运行（Windows / Linux / macOS）。

开发细节（项目结构 / 源码分析 / 测试情况 / 构建打包与系统兼容性 / 版本更新记录）见 dev-doc.md。

一、功能总览

功能	说明
TCP 客户端	连接任意远程 TCP 服务器，实时收发指令
TCP 服务端	在本机监听端口，接收多个客户端连接，支持定向发送、广播、主动断开客户端
多编码支持	UTF-8（含 BOM）/ UTF-16 / UTF-16LE / UTF-16BE / UTF-32 / UTF-32LE / UTF-32BE / GBK / GB2312 / BIG5 / Latin-1 / ASCII，支持自动编码探测，跨编码也能正确显示
HEX 收发	发送时按十六进制字节解析，接收时可切换十六进制显示
定时循环发送	按设定间隔循环发送指令，可设次数（0 = 无限），随时启停
自动重连	客户端意外断线后按设定间隔自动重新连接
发送文件	选择文件按原样字节发送（适用于二进制报文 / 固件等）
导出记录	收发记录一键导出为文本文件
历史报文	自动记录最近 50 条发送内容，↑/↓ 键切换，历史窗口一键重发
收发统计	实时显示发送 / 接收的消息条数与字节数
服务端管理	客户端列表显示在线时长，可一键断开所选客户端
操作体验	Ctrl+Enter 快捷发送、发送框一键清除、窗口大小自动记忆

二、运行环境与启动

环境要求：Python 3.8 及以上（需自带 tkinter，Windows 官方安装包默认包含）
启动命令（本机 python 不在 PATH 中，请用 py 启动器）：

py tcp_debug_tool.py

启动后弹出主窗口，包含「TCP 客户端」和「TCP 服务端」两个标签页。

三、界面操作说明

3.1 TCP 客户端（对接远程 TCP 服务器）

在「服务器地址」「端口」输入框填写目标主机与端口；
点击连接，成功后按钮变为断开，状态区显示已连接；
勾选 自动重连 并设置间隔（秒），断线后会自动重连，等待期间点击 取消重连 可停止；
在「发送」区输入指令 → 选择编码 → 点击发送（或按 Ctrl+Enter）；
服务器返回的数据实时显示在「收发记录」区（蓝色为接收 RX，红色为发送 TX）。

3.2 TCP 服务端（本地 TCP 服务）

填写 监听端口，点击 启动服务；
客户端接入后出现在「已连接客户端」列表中，显示 在线时长，上下线自动记录日志；
选中列表中的某个客户端，输入指令后点击发送为定向发送；
点击广播将指令同时发送给所有已连接客户端；
点击 断开所选 可主动断开列表中的客户端。

3.3 发送辅助功能

功能	操作
定时循环发送	设置间隔(秒)与次数(0=无限)，点击循环发送启动，再点一次停止；失败或断线自动停止
发送文件	点击发送文件选择文件，按原样字节发送（不经过编码转换）
历史报文	点击历史报文打开历史窗口，双击填入或点填入并重发；也可在输入框按 ↑/↓ 键切换历史
清除发送框	点击发送区右侧清除按钮，一键清空发送框内容
导出记录	点击工具栏导出记录保存收发记录为文本文件

3.4 编码与格式选项

编码下拉框：发送与接收共用的字符编码，切换后即时生效；
HEX发送：勾选后输入框按十六进制解析，例如 01 0A FF 会被当作 0x01 0x0A 0xFF 三个字节发送；
接收显示HEX：勾选后接收到的字节以 AB CD 12 形式展示；
自动追加换行：文本模式发送时在指令末尾自动追加 \r\n，适合行协议调试（HEX 发送模式下不追加，避免污染字节流）；
时间戳：每条收发记录前显示 [HH:MM:SS]；
收发统计：日志工具栏实时显示「发送 x 条 / x 字节接收 x 条 / x 字节」。

3.5 菜单与关于

四、二进制分发版

无需安装 Python，直接运行（需图形界面环境）。二进制为构建产物（不入源码仓库），构建方法、glibc 兼容性细节与跨平台限制见 dev-doc.md 构建章节。

产物	适用平台	说明
高兼容版（Linux x86_64）	glibc ≥ 2.17 的发行版	openEuler 22.03 / CentOS 7 / Ubuntu 18.04+ / Debian 10+ 等，推荐分发
本机版（Linux x86_64）	glibc ≥ 2.38 的新系统	仅限 openEuler 25.09 等新版发行版
aarch64 发布包	Linux ARM64	历史发布包见 `release/`（PyArmor 加密 + PyInstaller 打包）

运行方式：./pytcper（Linux）或 pytcper.exe（Windows，需在 Windows 上另行构建）。

项目介绍

Apache-2.0 Python 22提交数atomcode python 网络应用

定制我的领域

README

规则集

pytcper:基于 Python + tkinter 的跨平台 TCP 调试助手