文章摘要
各位坛友好，今天把我们正在维护的 ZO论坛盒子 开源分享出来。
这是一个基于 Electron 开发的 Discuz 论坛桌面客户端。除了桌面端源码，本次也公开了配套后台接口，以及部署、配置和接口对接文档，方便有需要的站长和开发者研究、修改，或接入自己的论坛。
开源地址：
一、这套项目可以做什么？ZO论坛盒子围绕论坛日常使用和站长管理需求，提供了以下功能：
**帖子浏览：**首页、版块、搜索、帖子详情、正文渲染及附件资源入口。**账号服务：**密码登录、QQ 授权、短信认证及原生验证码流程。**个人中心：**个人资料、通知、勋章、任务等功能对接。**动态配置：**管理员可以配置客户端导航、主题、功能开关和运行状态。**公告管理：**支持居中公告、首页公告条和右下角悬浮公告。**内容展示：**后台可配置游戏信息字段的名称、顺序及显示状态。**桌面分发：**提供 Windows 构建与更新方案，以及 Linux x64 打包和手动更新流程。
QQ、短信、签到等能力需要论坛已有的插件或服务支持，部署前应先确保这些功能在论坛网页端能够正常使用。
二、本次开源包含哪些内容？仓库采用前后端放在同一个仓库的结构：
client/ Electron 桌面客户端源码server/api/desktop/ 配套后台接口docs/ 版本与平台说明third-party-licenses/ 第三方许可文本
同时提供：
README 项目介绍和使用说明API 与环境配置文档Windows 构建与更新说明Linux 安装说明安全说明与开源检查清单
本次公开的是客户端和我们编写的配套接口。**Discuz、UCenter 主程序及商业插件需要自行安装并取得相应授权。**生产配置、数据库、账号会话、签名证书和服务器凭据不在仓库中。
三、适合哪些人使用？如果你正在运营 Discuz 论坛，想给用户提供桌面端访问入口，可以参考这套项目。
如果你正在学习 Electron，也可以从中了解桌面窗口、会话管理、请求桥、配置同步和更新分发等实现方式。
对已有 Discuz 站点来说，这套项目还可以作为客户端与既有论坛账号、内容和插件体系对接的参考。
四、如何开始？开发客户端可以从以下命令开始：
git clone zo-forum-desktop/clientnpm cinpm testnpm start
接入自己的论坛之前，请先阅读仓库中的部署指南。
当前源码默认对接 ZO 站点。换站时，需要同步调整论坛地址、请求白名单、CSP、更新源及相关回调配置，不能只替换一个 API 地址。后台接口则需要部署到自己的 Discuz 环境中，再进行配置和联调。
五、当前版本与验证情况本次开源版本为 2.2.7。
开源整理期间重新执行并通过了：
12 项 Node 安全与配置测试33 个 PHP 文件语法检查7 项无需连接数据库的发帖策略检查
这些检查不等于所有设备和论坛环境都已完成验收。尤其是 Linux 版本目前属于首发测试版，尚未完成 Linux 实机启动验收。接入其他论坛后，也需要使用自己的测试账号验证登录、插件兼容性和权限场景。
六、开源许可与版权说明
本项目自行编写的代码采用 MIT 许可证，允许学习、修改、分发和商用，也允许闭源衍生；分发时须保留版权与许可声明。
第三方组件遵循各自的许可证。代码开源许可不额外授予 ZO 品牌、图标、论坛内容或商业插件的使用与分发权，具体以仓库中的 LICENSE 和第三方声明为准。
欢迎有兴趣的坛友体验，也欢迎提交 Issue 反馈问题或通过 Pull Request 参与改进。
反馈时可以附上操作系统、客户端版本、复现步骤和经过脱敏的截图，方便定位问题。请勿上传密码、Cookie、短信验证码或其他凭据。
项目地址：
希望这套源码能给正在做论坛客户端的朋友提供一些实际参考。
