.png)
一句话说完：Uni Halo v3.0.0 是一个全新版本。它基于 uni-app 与 Halo 2.x API 构建，一套源码编译为微信小程序、APP 与 H5，配套 Halo 插件完成全部后台配置。**它与此前的 v1.x / v2.x 没有任何关联，也不存在"升级"的说法——这是一次从零开始的重写。**
先说清楚一件事
如果你是老用户，请先看这一段。
v3.x 的应用端和插件端都是 全新项目：
应用端
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 新增了登录能力，读者不再只是"游客"：
账号密码登录与注册
微信一键登录
微信账号绑定
登录后使用站点原生令牌，可直接访问站点接口与插件接口
登录后的用户侧边栏会带出个人中心与管理入口：
3. 恋爱日记：从应用内到前台页面
恋爱日记一直是 Uni Halo 的特色模块，包含**恋爱相册**（支持查看密码锁定）、**恋爱清单**与**我们的故事**。
v3.0.0 更进一步：**插件内置了恋爱日记的前台模板**。任何主题装上插件，就能直接展示恋爱日记页面，支持主题整页接管或只覆盖页头页脚。
也就是说，它不再只是"小程序里的一个模块"，而是能成为你博客前台的一部分。
4. 41 个页面，覆盖一个博客客户端该有的全部
首页、分类、图库、瞬间、博主、文章列表与详情、归档、标签、搜索、公告中心、友情链接、投票中心、数据看板、收藏、偏好设置、关于项目、维护模式页……共 41 个页面。
完整的页面清单与分组，在官网可以逐页查看。