SkyPort

一款使用 Flutter 构建的跨平台串口调试助手，专注桌面平台的高性能串口收发与调试体验，支持 ANSI 转义序列渲染和灵活的数据处理模式。

📸 界面预览

✨ 功能特性

• 串口操作

  • 自动扫描和列出可用串口。
  • 连接和断开串口设备，连接状态与收发统计显示在底部状态栏。
  • 可配置波特率、数据位、停止位和校验位，常用参数会被记忆并自动恢复。
  • 支持智能重连，当设备意外断开时自动尝试重新连接。

• 数据收发

  • 支持 ASCII 和 Hex 两种格式发送和接收数据。
  • 支持 ANSI 转义序列的解析和渲染，用于彩色日志输出。
  • 采用统一流式缓冲架构，自动处理数据包边界：
  • 每条记录可选显示时间戳，并区分显示"发送"和"接收"记录。
  • 可配置日志缓冲区大小（16-512MB，默认128MB）来控制内存使用。
  • 一键清空接收区。

• 发送配置

  • 支持 Hex 发送和文本发送模式切换。
  • 文本发送可选择是否自动追加换行，以及换行风格（LF / CR / CRLF）。
  • 支持自动发送和历史发送数据记忆。

• 界面与体验

  • 基于 Material Design 3，左右双栏布局：左侧为配置与发送控制，右侧为数据日志与输入区。
  • 支持浅色/深色/跟随系统主题切换。
  • 多种预设主题色可选。
  • 支持串口自动重连。
  • 可启用/禁用 ANSI 转义序列渲染。
  • 窗口尺寸、位置和串口偏好会被记忆，提升日常使用效率。

• 跨平台

  • 当前支持 Windows 和 Linux 桌面平台（MacOS 与 Android 在规划中）。

📥 下载安装

你可以从 GitHub Releases 页面下载最新版本的安装包。

🚀 如何构建

环境准备

确保你已安装 Flutter SDK 和 Dart SDK。详情请参考 Flutter 官方文档。

构建步骤

1. 克隆仓库

   git clone https://github.com/StarSphere-1024/SkyPort.git
   cd SkyPort

2. 获取依赖

   flutter pub get

3. 运行应用（桌面）

   flutter run -d windows  # Windows
   flutter run -d linux    # Linux

4. 构建发布版本

   flutter build windows  # Windows
   flutter build linux    # Linux

📦 主要依赖

• flutter_riverpod (v3.0.3): 用于状态管理。
• flutter_libserialport (v0.6.0): 用于串口通信。
• shared_preferences (v2.5.3): 用于记忆用户偏好和串口参数。
• window_manager (v0.5.1): 用于桌面端窗口管理。
• ansi_escape_codes (v2.1.0): 用于 ANSI 转义序列解析和渲染。
• flutter_localizations + intl (v0.20.2): 用于国际化支持。

🤝 贡献

欢迎贡献！请遵循以下步骤：

1. Fork 本仓库
2. 创建你的特性分支 (git checkout -b feature/AmazingFeature)
3. 提交你的更改 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 开启一个 Pull Request

开发环境设置

• 安装 Flutter 3.4.1+
• 运行 flutter pub get 安装依赖
• 使用 flutter run 启动开发版本

🐛 问题报告

如果你发现 bug 或有功能建议，请在 Issues 页面提交。

📄 许可证

本项目采用 GNU Affero General Public License v3.0 许可证。

👤 作者

StarSphere-1024 - GitHub

---

如果这个项目对你有帮助，请给它一个 ⭐！