如何快速上手飞秋（feiq）：macOS平台的高效局域网通讯工具 🚀

飞秋（feiq）是一款基于Qt框架开发的macOS平台局域网通讯工具，严格遵循飞秋协议（飞鸽扩展协议），支持好友管理、即时消息发送、表情包互动等核心功能。通过简洁的界面设计和高效的网络传输，让局域网内的文件分享与消息交流变得轻松便捷。

📋 项目核心架构概览

飞秋项目采用模块化设计，主要代码结构清晰，便于维护和扩展：

• 核心交互模块：mainwindow.cpp、feiqwin.cpp 负责主界面渲染与用户交互逻辑
• 网络通讯层：feiqlib/ 包含UDP/TCP通讯实现（udpcommu.cpp、tcpserver.cpp）和飞秋协议解析
• 数据模型：feiqlib/feiqmodel.cpp 管理好友列表与消息数据
• 跨平台适配：osx/ 目录提供macOS平台特有功能支持（如通知中心集成）

🖼️ 表情包资源与UI组件

项目内置丰富的表情包资源，存放在 res/face/ 目录下，包含96种常用动态表情（如1.gif至96.gif）。通过 chooseemojidlg.cpp 和 emoji.cpp 实现表情包的选择与渲染功能，让聊天更生动有趣。

⚡ 快速启动与核心流程解析

一键启动入口：main.cpp

程序入口文件 main.cpp 实现了简洁的初始化流程：

int main(int argc, char *argv[]) {
    QApplication a(argc, argv);
    a.setWindowIcon(QIcon(":/default/res/icon.png"));  // 设置窗口图标
    
    MainWindow w;
    FeiqWin feiqWin;
    w.setFeiqWin(&feiqWin);  // 关联主窗口与飞秋核心逻辑
    
    w.show();
    return a.exec();
}

启动后自动加载 mainwindow.ui 定义的界面布局，通过 fellowlistwidget.cpp 展示在线好友列表，实现即开即用的用户体验。

🔧 个性化配置指南

设置模块：settings.h

项目通过 Settings 类（继承自QSettings）管理用户配置，支持自定义：

• 网络连接参数
• 界面显示偏好
• 消息通知设置

配置文件采用键值对存储，通过 value() 方法可便捷获取配置项，例如：

QVariant Settings::value(const QString &key, const QVariant &defaultValue = QVariant(), bool cacheDefault=true);

📱 核心功能模块详解

1️⃣ 好友管理系统

• 好友发现：通过UDP广播实现局域网设备自动发现（feiqlib/udpcommu.cpp）
• 列表展示：fellowlistwidget.cpp 实现好友状态实时更新与右键菜单操作
• 添加好友：addfellowdialog.ui 提供手动添加好友的交互界面

2️⃣ 消息与文件传输

• 文本聊天：recvtextedit.cpp 支持富文本显示，集成表情包解析功能
• 文件传输：filetask.cpp 实现断点续传与传输进度管理，搭配 downloadfiledlg.ui 提供直观的下载控制界面

🛠️ 开发与扩展建议

插件系统入门

项目预留了插件扩展接口 plugin/iplugin.h，可通过实现 IPlugin 接口添加自定义功能。例如 plugin/rankuser.cpp 展示了用户活跃度统计插件的实现方式。

调试与日志

网络通讯模块建议结合 feiqlib/utils.cpp 中的日志工具进行调试，关键协议交互可在 protocol.h 中查看常量定义。

🎯 总结

飞秋（feiq）通过精简的代码结构和专注的功能设计，为macOS用户提供了高效的局域网通讯解决方案。无论是办公室文件共享还是家庭网络聊天，都能满足快速、稳定的通讯需求。项目源码完全开源，欢迎开发者参与功能优化与跨平台适配贡献！