Repository navigation
Releases
Releases · Tim0x0/halo-plugin-fireside
v0.7.2
🔧 优化
- 全部已读:操作前增加确认,明确当前订阅或全部订阅的处理范围,以及包含尚未加载的更早动态;确认框打开时固定操作目标
- 工具栏按钮:同步、全部已读和批量选择的按钮样式对齐链接插件,刷新列表移至末尾
- 订阅设置:精简动态 RSS 地址和暂停同步的帮助文案,移除地址示例,保留清空地址会删除动态的提醒
🐛 修复
- 已读 / 未读图标:修正操作图标反向的问题,使图标与提示一致;已读条目的“标为未读”图标使用绿色,对齐链接插件
📋 完整更新日志
- Full Changelog: v0.7.1...8d1a95b
反馈:BBS · 围炉
v0.7.1
🔧 优化
- 全部已读:改为后端一次处理,新增
links/{name}/mark-read端点,一次改完已读标记并归零未读数。原先在浏览器里对每条未读串行 GET 加 PUT,未读多时要上千次请求,而且一次最多处理 1000 条 - 订阅侧边栏:对齐链接插件订阅列表,宽度改为 18rem,条目带圆角描边与浅灰底,标题区改为两行(RSS / 订阅),订阅名与副标题的字号字重对齐;未读数保留绿色徽章
- 列表头像:由正圆改为圆角矩形,尺寸与前台头像一致(42px、圆角 6px)
- BBS 公告同步:发帖逻辑改用 halo-plugin-bbs 的可复用工作流,本仓库只保留触发与传参,与其他插件仓库一致
🐛 修复
- 查看原文:Console 里的按钮改为原生链接。
VButton不支持渲染成链接,tag="a"实际仍是按钮,点了没有反应
📋 完整更新日志
- Full Changelog: v0.7.0...v0.7.1
反馈:BBS · 围炉
v0.7.0
✨ 新增
- 增量同步:已入库的动态不再一律跳过,对清洗后的标题、正文、摘要与媒体地址计算 SHA-256,内容变了才回写,已读、隐藏与发布时间保持不变;此前只剩文字的旧动态在首次同步时自动补上图片
- 作者删除留档:对方删掉仍在保留窗口内的动态时,前台不展示、不占保留名额,后台以红点标出,重新出现即恢复;更早的条目不受影响,避免把「feed 没返回」误判成删除
- 后台未读:新入库的动态标绿点,概览与每个订阅统计未读数,没有未读不显示;新增「未读」筛选,支持单条与全部标为已读。升级后已有的动态视为未读
- 批量隐藏:可全选本页后一次性隐藏,作者已删除的条目不可选、不可隐藏
🔧 优化
- 管理页样式:对齐官方链接插件订阅页,主操作为描边按钮、次操作为无边框按钮,图标统一为 Mingcute,悬浮提示统一为 Halo tooltip,筛选条选中态改为深色块
- 订阅列表:改为两行,名称下方显示站点主机名,「全部动态」下方为「所有订阅」;右侧概览不再重复展示完整 RSS 地址
- 操作提示:同步、已读、隐藏、清空的结果提示精简,数量为 0 的项不再出现
🐛 修复
- 同步反复进出:对方删除最新动态后,本地保留名额被旧条目占住,导致每次同步都「新增 N 条、清理 N 条」
📋 完整更新日志
- Full Changelog: v0.6.0...v0.7.0
反馈:BBS · 围炉
v0.6.0
v0.5.0
本版本聚焦 前台发布与评论体验:发布框升级为富文本,列表页可原地展开完整评论区,评论预览对齐朋友圈样式(含链接与表情图)。
新功能
发布框:Tiptap 富文本
- 基于 Tiptap 2.11(
~2.11.9)裁剪内核,对齐官方编辑器技术路线;无 Vue 依赖,打成 IIFE 供前台调用 - 工具栏 7 键:加粗 / 斜体 / 删除线 / 行内代码 / 链接 / 撤销 / 重做
- 可产出的正文 HTML 仅限行内样式:
p/br/strong/em/s/code/a(不含标题、列表、正文插图;图片仍走九宫格) - 首次打开发布浮层时懒加载
fireside-editor.js;加载或初始化失败则回退textarea纯文本 - 链接须工具栏显式创建(关闭 autolink / 粘贴自动成链);URL 仅放行
http/https - 原有能力在编辑器路径下继续可用:
#话题联想、chip 删除、九宫格选图/排序/发表时上传、粘贴截图转投九宫格 - bundle 由
ui模块 esbuild 构建,挂入pnpm build,随 Gradle 产出
列表页:评论按钮原地展开
- 点击评论按钮,在卡片内展开官方
halo:comment完整评论区 - 卡片内用
<template>惰性存放组件:首屏不渲染、不执行脚本;仅被展开的卡片才克隆挂载 - 克隆后串行复活
<script>;同一外链src跨卡片只加载一次,避免库脚本二次执行(如customElements重复注册) - 评论组件固定
id(如#comment)挂载前按瞬间名改写,并同步替换内联脚本中的选择器引用 - 展开时隐藏评论预览,避免预览与完整评论区叠放;收起后清空并重拉预览,便于免审核评论即时回显
- 渐进增强:无 JS、不支持
<template>、或修饰键 / 中键点击时,仍走链接跳转详情页
评论预览:富文本与表情图
- 预览不再纯
textContent:经 DOMPurify 白名单消毒后按 HTML 插入 - 白名单大致对齐官方评论消毒默认档,并额外放行
img(表情包 / 贴图);属性仅保留href/src/alt - 链接补
target="_blank"与rel="noopener noreferrer nofollow ugc";图片补loading/decoding/referrerpolicy - 常见标记可显示:加粗、斜体、删除线、行内代码、链接、列表等;块级标签在预览里压成行内连排
- 表情图约一行字高行内展示;点击预览内真实链接或图片不会误触发「整块进详情」
- DOMPurify 不可用时回退纯文本
其它
- 列表页 / 详情页页脚站点名称改为链回首页
依赖与兼容
- 运行环境不变:Halo
>= 2.25.0;链接插件必需;瞬间插件可选(>= 1.16.0) - 原地展开的完整评论区依赖站点已安装的评论组件;未安装时按组件既有行为处理
- 变更集中在前台静态资源与模板(
fireside.js/fireside.css/fireside-editor.js/purify.min.js/ 模板);无数据模型迁移 - 升级后若仍见旧交互,请强刷或清 CDN / 浏览器缓存后再验
升级说明
- 安装 / 覆盖升级本次构建产物(插件名
plugin-fireside,版本0.5.0)并启用 - 访问
/fireside建议核对:- 登录后打开发布浮层:工具栏是否出现,富文本发布是否成功;断网或脚本失败时是否仍能纯文本发布
- 列表页点评论:是否原地展开 / 再点收起;收起后预览是否刷新
- 含链接、表情图的评论:预览是否正常显示,链接与图片点击是否符合预期
- 详情页评论区行为应与升级前一致(本版本未改详情页评论挂载方式)
Full Changelog:v0.4.0...v0.5.0
v0.4.0
✨ 新增
评论预览(仿微信朋友圈)
- 自身瞬间卡片下方新增灰底评论预览块:不用点开就能看到最新的顶层评论,时间正序排列,置顶评论优先入选
- 超出条数上限时显示「查看全部 N 条评论」;点击评论按钮或预览块任意位置进入详情页评论区
- 进入视口后才加载(懒加载),不拖慢首屏;可见性与隐私脱敏由 Halo 核心公开评论接口保证——匿名访客仅见已通过的评论,登录用户额外可见自己的待审核评论
- 列表页不再内嵌评论组件(此前每页挂载约 20 个隐藏组件实例),页面更轻
音乐 / 视频 / 网页分享卡
- 正文中独立成段的分享链接渲染为仿朋友圈卡片:网易云音乐、QQ 音乐、酷狗 → 音乐卡;B 站、抖音、YouTube、腾讯视频 → 视频卡;其余网页链接 → 通用分享卡(副标题显示来源主机名)
- 建议安装 编辑器超链接卡片 自动补全标题与封面;未安装时显示可点击的占位卡
- 自身瞬间在展示时注入(不写回瞬间数据),友链条目在同步入库时写入(阅读路径零解析开销)
设置页分节
「展示设置」内新增「外观」「互动」两个分节,设置项更好找:
| 分节 | 设置项 |
|---|---|
| 外观 | 封面图、签名、配色方案、允许访客切换配色 |
| 互动 | 评论预览条数(新增)、显示发瞬间入口 |
新增设置项:
| 设置项 | 默认 | 说明 |
|---|---|---|
| 评论预览条数 | 10 | 自身瞬间卡片下方展示的最新顶层评论条数(不含回复);0 关闭预览,-1 全部显示,超出时显示「查看全部 N 条评论」入口 |
🔧 优化
- 同步入库时剥除正文中的主题短代码标记(Typecho 花括号 / Hugo / Hexo·Jekyll Liquid / WordPress·BBCode 方括号),仅成对标记才删,代码块内免疫
- 媒体图片加载三态:占位 → 成功去底 → 失败提示;外链图片 Referer 改为
strict-origin-when-cross-origin,便于图床按域名白名单放行 - Console 管理页对齐官方样式(VCard + VPagination),支持调整每页条数,小图懒加载
- 启动时对无围炉数据的友链走免锁捷径,消除无谓的加锁查库与日志
- 内置页与详情页页脚新增 Powered by 项目链接
🐛 修复
- 无日期或时间异常的 RSS 条目导致游标分页截断、更早内容永远翻不到的问题
- 管理页选中单个友链且列表为空时,「立即同步」误执行全量同步的问题
- 配色按钮单独显示时 hover 顶部露白缝的问题
- 同步与管理页多项细节:隐藏条目的计数回写、级联清理与同步并发冲突、点赞连点重复计数、列表请求竞态、抓取超时误判等
⚠️ 升级注意
- 设置需重新填写一次:因设置页分节调整,「外观」(封面图、签名、配色方案、允许访客切换配色)与「互动」(显示发瞬间入口)分节下的旧值不会自动迁移,升级后请到插件设置中重新填写
- 公开时间线 API 改为纯游标分页:仅支持
before/size/tag参数,page参数已移除;自定义对接的主题请改用返回的nextCursor翻页(写入查询串前须 URL 编码),详见 README
📌 说明
- 评论预览走 Halo 核心公开评论接口,无需额外插件;点开后的完整评论区(详情页)仍使用官方「评论组件」插件渲染
- 分享卡的标题与封面补全依赖可选的「编辑器超链接卡片」插件,未安装不影响其它功能
Full Changelog: v0.3.0...v0.4.0
v0.3.0
✨ 新增
页面内发瞬间(仿微信发表页)
- 封面右上角相机入口:仅对已登录且有「允许发布自己的瞬间」权限的用户显示,访客不可见;可在设置中关闭
- 正文支持
#标签:打空格生效,与官方瞬间一致;输入时带标签联想(↑↓ 高亮、Enter/Tab 选中) - 「谁可以看」一键切换公开 / 私密
- 无免审核权限的用户发布后进入后台审核,通过才展示;免审核角色发布即上时间线
图片:微信朋友圈同款体验
- 点 + 选图,电脑也可以把图片文件直接拖进发表卡片(拖悬有高亮提示)
- 选图只做本地预览——不发布就不会在附件库留下用不上的文件
- 长按(手机)/ 按住(电脑)拖拽调整图片顺序:浮影跟手、其余格子实时让位,与朋友圈手感一致
- 点「发表」才按九宫格顺序逐张上传:轮到哪张哪张亮"上传中",按钮实时显示 n/m 进度
- 单张失败不打断后续:失败格子标红,再按「发表」只补传失败的,成功的不重复上传
- 发表过程中锁定编辑与关闭浮层,避免传到一半改内容导致所见非所得
配色方案
- 新增站点默认配色设置:跟随系统 / 浅色 / 深色
- 页面右下角访客切换按钮(明 / 暗 / 自动):选择记忆在访客浏览器本地并优先于站点默认;可在设置中关闭
新增设置项
| 设置项 | 默认 | 说明 |
|---|---|---|
| 显示发瞬间入口 | 开 | 封面右上角相机按钮,仅对已登录且有「允许发布自己的瞬间」权限的用户可见 |
| 配色方案 | 跟随系统 | 内置页默认配色(跟随系统 / 浅色 / 深色);允许访客切换时,访客的选择优先 |
| 允许访客切换配色 | 开 | 右下角 明/暗/自动 切换按钮,访客选择保存在其浏览器本地 |
📌 说明
- 发瞬间需要安装瞬间插件(>= 1.16.0),发布走其 UC API,与后台发布的瞬间完全同源
- 图片上传走 Halo 个人中心附件接口,站点需配置「个人中心附件存储策略」;未配置或无上传权限时发表页会给出定向提示,纯文字发布不受影响
Full Changelog: v0.2.0...v0.3.0
v0.2.0
✨ 新增
内置朋友圈页面 /fireside
- 像素级朋友圈观感:封面图 + 站点头像昵称悬挂 + 签名位,白底细分隔线时间线,方形圆角头像,熟悉的昵称蓝
- 图片布局照搬微信:单图原比例、四图田字格、其余三列九宫格;点图不跳转,交给灯箱插件接管
- 标签导航单行横向滑动:全部 / 你的标签(含条数)/ 友链,
?tag=友链即"只看朋友" - 游标式分页:"更早的动态"翻到任意深度成本恒定,无条数上限
- 暗色模式、移动端自适应、返回首页、返回顶部、版权页脚
详情页 /fireside/{name}
- 自身瞬间点时间戳进入,单条全文 + 评论区默认展开,方便分享
- 可见性与瞬间插件原生一致:匿名仅见已通过的公开瞬间
互动(自身瞬间)
- 点赞:走 Halo 计数接口,与主题页点赞记录互通
- 评论:官方
halo:comment组件服务端渲染,点击就地展开 - 复制链接:一键复制详情页地址
新增设置项
| 设置项 | 默认 | 说明 |
|---|---|---|
| 页面标题 | 围炉 | 内置页面标题 |
| 详情页标题 | 空 | 留空跟随页面标题 |
| 标题分隔符 | - |
可选 - 或 | |
| 每页条数 | 20 | 范围 10~100 |
| 封面图 | 空 | 朋友圈式封面,留空用默认深色底 |
| 签名 | 空 | 头像旁的一句话,如「记录生活中的点滴瞬间」 |
🔧 优化
- 正文内嵌标签智能清理:独立成行的删除整行不留空白,混在句子里的保留词面去掉链接
- 友链动态的正文标签链接改为相对地址,在任意页面筛选都正确
- 作者无头像时显示昵称首字占位;显示名称缺失时回退用户名
- 页面不发 Referer 请求友链图片,规避对方防盗链导致的裂图
Full Changelog: v0.1.0...v0.2.0
v0.1.0
🔥 首个版本发布!
聚合友链博主的说说、动态、瞬间,与你自己的瞬间混排成一条朋友圈式时间线,像刷朋友圈一样看到朋友们的近况。
在线演示:https://blog.timxs.com/moments
✨ 功能特性
- 在链接插件的友链表单中填写「动态 RSS 地址」即完成订阅(零侵入,未填写的友链不受影响)
- 定时同步友链 RSS(间隔可配置),支持手动同步(单个/全部)与暂停订阅
- 自己的瞬间实时直读,作者昵称、头像等展示信息实时跟随链接插件设置
- 外部 HTML 白名单清洗(防 XSS)、SSRF 内网地址防护
- 自动清理:友链内按原文链接去重、每友链保留最新 N 条、删除友链时级联清理
- 提供 Console 管理页(同步状态徽章、动态浏览、隐藏/恢复条目、清空数据)
- 提供 Finder API,主题
/moments页一行接入 - 提供公开时间线 REST API,支持前端无限滚动加载
📋 环境要求
📦 安装方式
在 Halo 后台 → 插件 → 安装插件
🔧 配置说明
- 在 Console「链接」中编辑友链,填写动态 RSS 地址(对方为 Halo 站点时一般为
https://对方域名/feed/moments/rss.xml) - 等待定时同步(默认 60 分钟),或在「围炉」管理页点击同步全部
- 在主题
templates/moments.html中加一行th:with完成接入,详见 README - 主题接入