MiniDocs知识库 v1.0.4

MiniDocs 知识库插件更新。

主要改动

• 阅读页 / 分享页无刷新切换：点击目录树文档通过 AJAX 更新正文与 URL（pushState），目录树展开状态、滚动位置完整保留，并支持浏览器前进 / 后退。
• 兼容 halo-plugin-shiki：切换后派发 pjax:complete，触发 shiki-code Web Component 重新高亮代码块，修复异步加载时代码块停留在模糊占位态的问题。
• 前端资源外置：模板内联样式与脚本抽离为 doc-page.css / doc-page.js，减小页面体积并规避大树渲染截断。
• 公开 API / Finder 增强：文档标识支持 metadata.name 兜底，补齐分享链路与可见性相关处理。

安装

下载 halo-plugin-minidocs-1.0.4.jar，在 Halo 后台「插件 → 上传 / 升级」安装；要求 Halo >= 2.26.0。

MiniDocs 知识库 v1.0.3

新增功能

1. 知识库图标（logo）自定义
   在知识库编辑弹窗「封面」下方新增「图标（logo）」设置，支持上传本地图片或直接粘贴图片链接，带实时预览与一键移除。未设置时继续显示默认书本图标。数据存储于 spec.logo（原有字段），卡片即时生效。

2. 未保存内容提醒 + 本地草稿自动保存/恢复

   • 编辑中的文档若有未保存改动，切换文章、返回列表或关闭页面时会弹出「放弃未保存的更改？」确认框，防止长文误丢。
   • 编辑期间每 5 秒将正文与标题自动保存到本地（按文档隔离）。
   • 意外刷新/退出后再次进入该文档，若检测到未保存草稿且与已保存内容不一致，会弹出「发现未保存的草稿」，可一键恢复或放弃。

界面优化

3. 知识库卡片结构调整：标题固定在封面下方、图标悬浮封面下沿，消除标题遮挡与排版空隙。
4. 按钮细节：「进入」按钮改为圆角矩形；卡片/操作图标放大，减少框内空白。
5. 卡片多选交互：点击卡片即切换选中态并唤起顶部批量操作栏，不再直接进入；右上角改为圆形对勾角标（未选时悬停显示、选中变蓝实底），移除原生复选框。

文档

6. 更新用户指南，补充「图标（logo）」字段说明。

MiniDocs v1.0.2

本版本聚焦知识库管理控制台的界面优化与交互体验升级，包括统计栏增强、移动端适配完善、列表交互重构，以及多项视觉细节打磨。

新增功能

• 统计栏显隐控制：统计栏右上角新增眼睛图标，可随时隐藏/恢复；插件设置新增「控制台知识库管理页显示统计栏」总开关（默认开启），管理员可全局控制
• 已分享统计：统计栏新增「已分享」卡片，实时统计开启外链分享的知识库数量（桌面端布局由 4 列扩展为 5 列）
• 标题气泡提示：卡片/列表视图标题及描述显示不全时，鼠标悬停弹出气泡显示完整内容

优化改进

• 按钮文字精简：「导入知识库」→「导入」、「新建知识库」→「新建」
• 统计栏紧凑化：面板与卡片内边距、字号全面收紧，整体高度压缩约 25%～30%
• 列表视图交互重构：文档数与更新时间默认靠右显示，鼠标悬停时操作按钮从右侧平滑展开，信息自动让位
• 知识库标识更新：卡片与列表中的知识库图标更换为新版书本图标，移除背景框，仅以颜色区分状态（公开绿 / 团队蓝 / 私有紫）
• 卡片操作区布局：PC 端「进入」按钮靠左、操作按钮组靠右，整体高度降低更紧凑
• 移动端分享弹窗：修复「分享外链」表单项文字未左对齐的问题
• 移动端工具栏：筛选标签、搜索框、排序下拉按两行网格布局，搜索与排序同行显示
• 移动端列表：采用卡片式行布局，杜绝横向溢出与时间戳被挤压
• 内容区宽度：移除主内容区最大宽度限制，消除宽屏两侧空隙

MiniDocs v1.0.1

一、功能优化

1. 知识库详情页：刷新记忆当前文章与布局

• 打开某篇文章后，当前文档会同步到 URL 参数，刷新页面后自动恢复正在阅读的文章
• 自动展开该文章的所有祖先目录，保持浏览上下文
• 侧边栏宽度、目录展开/折叠状态通过 localStorage 按知识库持久化，刷新后恢复

2. 知识库详情页：默认打开第一篇文章

• 进入知识库时，若未指定文档，自动打开第一篇文章（含目录嵌套时取第一个叶子文章）

3. 知识库详情页：移除文章树状态小圆点

• 移除了文章树每行右侧的发布状态小圆点（蓝色/灰色），界面更简洁

4. 阅读页大纲：默认展开到二级标题

• doc.html（阅读页）与 doc_share.html（分享页） 的右侧大纲统一优化
• 刚打开文章时，大纲默认展示一级 + 二级标题（H1 展开出 H2，H2 及更深折叠）
• 点击 H2 前的箭头可手动展开查看更深层级，滚动定位时仍自动展开活动节点祖先链

5. 知识库导出：文件名规范优化

• 单知识库导出：优先使用别名（slug）命名，如 KB20260828105721916349521.zip
• 别名为空时回退：MiniDocs-{timestamp}.zip
• 批量导出：MiniDocs-{timestamp}.zip

---

二、Bug 修复

1. 修复知识库批量导出接口异常

• 修复 POST /knowledgebases/export 端点在响应式链中调用 .blockOptional() 阻塞 reactor 事件循环线程导致的请求异常
• 改为全响应式非阻塞过滤，导出功能恢复正常

2. 修复阅读页点赞功能

• 修复 doc.html 模板点赞不生效问题：重构点赞逻辑，确保事件正确绑定、错误可追踪
• 点赞成功后点赞数实时 +1，本地去重防重复点赞

MiniDocs 知识库 v1.0.0

MiniDocs 是 Halo 2.x 的轻量知识库插件，用于搭建团队 / 个人知识库：多知识库管理、文档树、Markdown 编辑、分类标签与权限控制，并将知识库内容通过公开接口与 Finder 暴露给第三方主题，方便开发用户侧文档站点。

插件同时提供 Console 管理界面、minidocsFinder Finder API 和匿名公共 REST API，适用于传统 Thymeleaf 主题和前端框架渲染的文档页。

目标平台：Halo >= 2.26.0

功能特性

• 知识库管理：支持多知识库创建、编辑、删除，公开 / 私有切换、成员授权与排序。
• 文档管理：支持文档树层级、Markdown 编辑、slug 别名、发布 / 草稿状态、标签与封面。
• 分类标签：知识库与文档均支持标签，便于按主题归类与检索。
• 权限控制：内置「知识库查看」「知识库管理」角色模板；私有知识库可指定成员（可访问者）列表，服务端按「创建者 / 成员 / 管理员」做资源级访问校验；可开关「允许未登录用户阅读公开知识库」控制匿名访问。
• 文档发布：支持单篇文档发布，发布后内容通过公开接口与 Finder 对外可见。
• 文档导入导出：支持批量导入（同名知识库安全覆盖、失败自动回滚保留原数据），以及将文档导出为 Markdown（受导出开关约束）。
• 外链分享：知识库卡片可一键开启外链分享，生成 /docs/share/{token} 对外链接，支持可选访问密码与有效期，分享页与阅读页同布局且无需登录。
• 主题适配：提供 minidocsFinder Finder API 与匿名公共 REST API，便于主题渲染知识库列表、文档树与文档详情。