星港

【暖阳日记】 v1.0.0 发布说明

Tim
Tim 楼主 发布于 已编辑

Release 页面:v1.0.0

🎉 首个版本发布!

为 Halo 提供个人日记功能。日记默认写给自己,想分享的再单独分享。

✨ 功能特性

  • 写日记:后台或 /diary 都能写;日期可以补写,一天可以写多篇,标题、心情、天气都可以留空
  • 自动保存:内容随写随存,不用手动保存
  • 分享闭环:默认写给自己,「分享 / 更新分享 / 收回分享」;分享前预览确认,访客才能读到
  • 前台手帐:左侧目录、右侧正文,点一篇只换右侧正文;日历对所有人开放,访客只看到已分享的日期;筛选和页码写在地址里
  • 两种视角:有管理权限的账号看全部日记(FOR MYSELF),访客只看已分享的(SHARED PAGES)
  • 后台管理:列表沿用 Halo 文章列表——回车搜索,按状态、日期、心情、天气筛选;行尾眼睛图标表示是否已分享,有未分享修改时标题旁有状态点,「阅读」可对照访客看到的版本;勾选后可批量操作
  • 回收站:删除进回收站,可「恢复」或「永久删除」
  • 权限模型:写日记、读未分享的内容需要「暖阳日记管理」角色,超级管理员默认拥有;普通登录用户和匿名访客一样,只能读已分享的版本
  • 隐私边界:未分享的内容不出现在访客的目录、搜索、日历和单篇里,也不进入站点搜索、RSS、站点地图
  • 面向主题:前台走主题模板渲染,全站变灰一类注入 <head> 的插件可以生效

📋 环境要求

  • Halo >= 2.26.0
  • JDK 21(自行构建)

📦 安装方式

下载 plugin-warm-diary-1.0.0.jar,在 Halo 后台 → 插件 → 安装 → 上传并启用。

🔧 配置说明

  1. 写第一篇:在后台或 /diary 写日记;日期可以补写,一天可以写多篇,标题、心情、天气都可以留空
  2. 分享给访客:后台「⋯ → 分享」或前台「分享」,预览确认后访客才能读到;之后的修改要再「更新分享」
  3. 插件设置:时区与手帐便笺在插件设置里填写,留空则用服务器时区和默认便笺
  4. 菜单入口(可选):可在 Halo 菜单中自行添加入口;/diary 等路径需留给插件使用

⚠️ 注意事项

  • 权限隔离不是加密:这是站点访问权限隔离,不是端到端加密;能直接访问数据库或服务器的人仍可看到底层数据
  • 管理账号之间不隔离:拥有「暖阳日记管理」角色的账号能读所有未分享的内容,彼此之间不隔离
  • 分享是快照:分享复制出独立版本,之后的自动保存不改变它,直到再次「更新分享」

📚 文档

  • README:使用说明、权限模型、接口与开发

反馈:BBS · 暖阳日记

下载

0 条评论
回复帖子