Excel-Messenger 开源项目使用手册
1. 项目目录结构及介绍
本项目 excel-messenger
是一个以幽默为主旨的本地群聊应用,它独特之处在于服务器和所有客户端均通过Excel工作簿实现。以下是项目的目录结构概览:
excel-messenger/
├── README.md # 主要的说明文件,包含了项目简介和快速入门指导。
├── LICENSE # 使用的MIT开源许可协议文件。
├── client # 客户端相关的工作簿文件夹,可能包含多个版本或主题的Excel文件(如client_0xlsm等)。
│ ├── client_0.xlsm # 示例客户端工作簿,用于参与群聊。
│ └── ... # 其他客户端变体或更新版本。
├── server # 服务器端工作簿文件夹,含有控制和汇总聊天信息的主Excel文件(如serverxlsm)。
│ ├── server-xlsm # 作为聊天服务器的Excel工作簿,管理群聊记录。
└── screenshots # 屏幕截图文件夹,展示了应用界面和操作示例。
每个.xlsm
文件都是启用宏的Excel文件,这表明项目依赖于VBA(Visual Basic for Applications),用于实现自动化和交互功能。
2. 项目的启动文件介绍
- 客户端启动:用户需打开位于
client
目录下的相应.xlsm
文件,例如client_0.xlsm
,来创建或加入一个本地聊天室。 - 服务器启动:同样地,需要运行位于
server
目录中的Excel工作簿(比如server-xlsm
),这个文件将充当消息的中央枢纽,收集来自各个客户端的消息并展示。
启动流程不涉及传统意义上的服务端启动命令,而是通过打开特定的Excel工作簿,并执行其中预定义的VBA宏命令来激活聊天功能。
3. 项目的配置文件介绍
鉴于此项目基于Excel工作簿且侧重简易互动,配置并未以独立传统配置文件的形式存在。配置主要体现在Excel工作簿内的特定单元格或命名范围中,以及VBA代码本身。对于客户端和服务器的工作簿:
- 服务器端配置:可能包含如设置自动保存间隔、指定广播消息的逻辑等,这些配置多在VBA模块中硬编码或通过Excel工作表的特定区域间接控制。
- 客户端配置:通常涉及到用户的显示名和连接到服务器的信息,可能通过交互对话框进行输入而非直接编辑文件。
因项目性质,配置更改可能需要修改VBA代码或直接在Excel中调整参数,具体细节需查看每个工作簿内的VBA模块和说明文档。
请注意,由于实际项目中的细节和具体实现可能会有所不同,上述内容是基于提供的描述和一般理解构建的。在实际使用前,请参照仓库内最新的README.md
文件和VBA代码注释获取最准确的指南。