UniHalo v3.x 配置插件

为跨平台多端应用提供的官方配套插件，Halo 2.x 站点装上即用。

插件源码 应用源码 应用市场 官网主页 官方文档 作者主页 作者博客

📖 介绍

这是一个免费开源的跨平台多端应用（UniHalo）配置插件，基于 uni-app 与 Halo 2.x API 构建。一套源码，编译为微信小程序、APP 与 H5，Uni Halo 由两部分组成，当前为 插件端，配套使用：

• 应用端 uni-halo：移动端源码，编译为微信小程序（推荐）、APP 等。应用源码
• 插件端 uni-halo-plugin：UniHalo配置插件（Halo插件），提供全部后台配置能力 插件源码

注意：v3.0.0 是全新版本，与 v1.x / v2.x 无任何关联，不存在升级路径。插件为独立新插件，旧配置无法继承，也不支持旧版本的 uni-halo 源码。

📲 在线预览

微信扫描下方小程序码，即可在线体验插件配置后的应用效果，无需下载安装：

✨ 特性一览

🧩 功能模块

应用端 · 内容展示

应用端 · 内容管理

登录后按角色可见，管理员可直接在手机上维护内容，不必打开电脑。

管理端（插件控制台）

内容与安全策略都在 Halo 后台维护，改完即生效。

界面预览

主要界面

首页	分类	图库	瞬间	博主

恋爱模块

恋爱日记	恋爱相册	恋爱清单	我们的故事

恋爱相册支持查看密码锁定、页内解锁，密码在服务端校验，暴力尝试会被验证码拦截。

主题模板

插件内置恋爱日记前台模板，任何主题装上插件即可展示，支持整页接管或仅覆盖页头页脚。

恋爱日记主页	恋爱相册	恋爱清单	我们的故事

更多页面截图与功能演示，请访问 官网 或 官方文档。

🚀 快速开始

🔗 配套应用 （uni-halo）

下载体验：应用仓库 ｜ 官方文档

环境要求

• Halo ≥ 2.26（站点程序）
• 配套应用：uni-halo v3.x（Node.js ≥ 20、pnpm ≥ 9）

安装与配置

• 1、部署 uni-halo 应用：克隆 应用源码，参考 部署指南 在本地运行起来。
• 2、在 Halo 插件市场搜索 UniHalo 安装启用，或从 插件 Releases 下载安装包上传安装。
• 3、插件启动后进入插件配置页，按 插件配置文档 完成参数配置即可。

三步即可跑起来。

1. 安装插件

Halo 后台安装 Uni Halo 插件（要求 Halo 2.26.0 及以上），启用后在插件配置页完成设置。

2. 配置应用

获取应用源码 https://github.com/uni-halo/uni-halo ，安装依赖后在 env/.env 中填入小程序 AppID 与站点地址：

pnpm install

VITE_WX_APPID = '你的微信小程序AppID'
VITE_SERVER_BASEURL = 'https://你的域名'
VITE_SERVER_BASEURL__WEIXIN_RELEASE = 'https://你的域名'

3. 构建发布

pnpm build:mp    # 微信小程序（推荐）
pnpm build:app   # APP
pnpm build:h5    # H5

构建完成后，用微信开发者工具上传代码、提交审核，审核通过即可发布上线。

完整的图文部署流程见官方文档：https://uni-halo-doc.ialley.cn/deploy/full-content

📚 使用文档

• 插件配置：插件设置（基本设置、安全控制、平台接入、主题组件、主题模板、移动端登录）说明
• 控制台功能：内容管理（横幅、公告、友链、恋爱日记等）使用说明
• 移动端登录 · 使用与配置：站点管理员如何开通与配置登录能力
• 移动端登录 · 接口文档：App / 小程序端如何对接
• 恋爱日记主题模板：主题接入说明

🔒 隐私与数据说明

插件仅在你启用对应功能时处理以下数据，全部保存在你的站点数据库中，不做任何遥测、统计、崩溃上报或跨站追踪：

• 微信登录凭据（AppID / AppSecret）保存在 Halo Secret 资源中，不落入插件配置明文，也不下发到移动端。
• 密码不出现在通知、日志或任何对外接口中：微信自动注册的账号不提供可告知的初始密码，由用户在客户端内自行设置。
• 数据的删除与导出沿用 Halo 自身能力（删除用户、解绑微信、后台内容管理）。

🌐 外部服务说明

插件运行期的出站请求仅限以下两类，均可通过关闭对应功能停用：

• 微信开放平台（api.weixin.qq.com）：仅在站长开启「小程序一键登录」并配置微信凭据后调用 jscode2session，将小程序临时登录凭证换取微信用户标识（openid / unionid）。请求仅携带 AppID、AppSecret 与一次性 code，响应中的会话密钥（session_key）不存储、不使用。关闭微信登录后不再发起任何请求。
• SMTP 邮件服务（站点自配）：仅在功能触发时经由站点已配置的邮件发送器发送注册验证码与站内通知，收件人为站点用户邮箱。

除上述外，插件不连接任何第三方服务。

📚 相关资源

💰 赞助支持

如果您觉得这个项目对您有帮助，可以请作者喝杯饮料鼓励一下，同时为了项目能够持续发展，可以根据您的喜好支持一下本项目哦，非常感谢您的支持，作者也会更有动力持续维护和更新新的功能哦~

支付宝	微信	QQ

💬 社群与反馈

使用问题、配置求助都可以在群里提，Bug 与功能建议请走这里，方便跟踪

• QQ 交流群：632969367
• 插件提交 issue：https://github.com/uni-halo/uni-halo-plugin/issues
• 应用提交 issue：https://github.com/uni-halo/uni-halo/issues

🤝 参与贡献

插件还在持续更新中，欢迎您的参与！无论是提交建议、反馈问题还是提交 PR，我们都非常乐意接受。

欢迎通过 GitHub Issues 反馈问题，或提交 Pull Request 共同完善项目。感谢所有给插件贡献过代码的开发者！

🙏 致谢

• Halo：一款好用又强大的开源建站工具
• uni-app：使用 Vue.js 开发所有前端应用的框架，一套代码多端编译

插件开发

以下为本插件的开发介绍。

插件源码地址：https://github.com/uni-halo/uni-halo-plugin

开发环境

• Java 21+
• Node.js ^20.19.0 or >=22.12.0
• pnpm

开发

# 启用插件
./gradlew haloServer
# 开发前端
cd ui
pnpm install
pnpm dev

Api 文档

• 开启后，您可以在 http://{ip|domain}/swagger-ui/index.html 访问 swagger-ui 文档。

在 workplace 目录下 新建 application.yaml 文件，内容如下：

springdoc:
    api-docs:
        enabled: true
    swagger-ui:
        enabled: true
    show-login-endpoint: true
    show-actuator: true

构建

./gradlew build

构建完成后，可以在 build/libs 目录找到插件 jar 文件。

许可证

Apache License 2.0 © 小莫唐尼