Uni Halo v3.0.0 正式发布：给 Halo 站长的多端客户端，全新出发

一句话说完：Uni Halo v3.0.0 是一个全新版本。它基于 uni-app 与 Halo 2.x API 构建，一套源码编译为微信小程序、APP 与 H5，配套 Halo 插件完成全部后台配置。它与此前的 v1.x / v2.x 没有任何关联，也不存在"升级"的说法——这是一次从零开始的重写。

先说清楚一件事

如果你是老用户，请先看这一段。

v3.0.0 的应用端和插件端都是全新项目：

• 应用端 uni-halo 完全重写，与旧版无任何代码与数据关联
• 插件端 uni-halo 是一个独立的新插件，插件标识已变更，旧插件的配置无法继承
• 因此没有升级路径：请卸载旧插件，全新安装新版插件，再按文档重新部署应用

这不是偷懒，而是 v3 换了整套架构：请求层、状态管理、UI 体系、插件配置模型全部重来。勉强做迁移只会留下一堆历史包袱。

环境要求：Halo 2.26.0 及以上。 低于这个版本装不上，也跑不起来。

一、Uni Halo 是什么

简单说，它是给你的 Halo 博客配一个移动端客户端。

站点内容、分类、图库、瞬间、友链、公告，都能在手机上被读者访问；而你作为站长，只需要装一个插件，在 Halo 后台完成配置——不需要改一行代码。

技术栈是当下主流的一套：uni-app + Vue 3 + TypeScript + Vite + UnoCSS + wot-ui，请求层基于 alova 封装。编译目标覆盖微信小程序（推荐）、APP 与 H5，一套代码，多端运行。

二、这次全新版本，带来了什么

1. 从"能看"到"能管"

以前移动端只能浏览。v3.0.0 补上了管理能力：管理员在手机上就能直接管理恋爱相册、恋爱日记、恋爱故事和瞬间。

同时加入了按角色控制可见性：管理员和普通用户看到的菜单与按钮不同，权限在插件侧配置。

2. 一套完整的账号体系

v3.0.0 新增了登录能力，读者不再只是"游客"：

• 账号密码登录与注册
• 微信一键登录
• 微信账号绑定
• 登录后使用站点原生令牌，可直接访问站点接口与插件接口

登录后的用户侧边栏会带出个人中心与管理入口：

安全方面，插件内置了登录限流（按用户名与 IP），令牌自动过期与清理，不需要额外配置。

3. 恋爱日记：从应用内到前台页面

恋爱日记一直是 Uni Halo 的特色模块，包含恋爱相册（支持查看密码锁定）、恋爱清单与我们的故事。

v3.0.0 更进一步：插件内置了恋爱日记的前台模板。任何主题装上插件，就能直接展示恋爱日记页面，支持主题整页接管或只覆盖页头页脚。

也就是说，它不再只是"小程序里的一个模块"，而是能成为你博客前台的一部分。

4. 41 个页面，覆盖一个博客客户端该有的全部

首页、分类、图库、瞬间、博主、文章列表与详情、归档、标签、搜索、公告中心、友情链接、投票中心、数据看板、收藏、偏好设置、关于项目、维护模式页……共 41 个页面。

完整的页面清单与分组，在官网可以逐页查看。

三、插件侧：配置都在 Halo 后台

插件提供的是"配置能力"，装好后你在 Halo 控制台就能完成全部设置：

包括：

• 横幅管理：小程序轮播图
• 公告管理：公告类型与内容
• 友链管理：友链分组与投稿审核，支持审核结果邮件通知
• 恋爱管理：相册、清单、故事的内容维护
• 应用管理：应用信息与版本维护
• 审核配置：投稿内容的候选与审核策略
• 验证码安全控制：图形字符或算术题，可按需选择生效范围
• 移动端登录：登录开关与微信密钥配置
• 主题展示：主题悬浮窗

另外还有站点维护模式：维护期间统一展示维护提示页，不用再临时改主题。

四、三步开始使用

第一步：Halo 后台安装插件（要求 Halo 2.26.0+），按文档完成配置。

第二步：拉取应用源码，配置站点地址后本地运行或编译。

第三步：发布到微信小程序（推荐）、APP 或 H5。

完整的图文流程见官方文档站的「完整流程」章节，从插件配置一路写到小程序提审。

五、在线体验

微信扫描下方二维码，或微信搜索小程序【小莫唐尼】即可预览。

六、相关链接

七、反馈与交流

遇到问题请提交 issue，或加入 QQ 交流群：632969367

项目使用 Apache-2.0 协议开源，源码与插件全部免费开放。

开源不易，用爱发电。如果这个版本对你有帮助，欢迎点个 Star，或者把它分享给同样用 Halo 的朋友。

Uni Halo v3.0.0 · 2026 年 9 月 19 日