v1.0.2

MiniDocs 知识库 v1.0.2

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

新增功能

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

优化改进

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

v1.0.1

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，本地去重防重复点赞

v1.0.0

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，便于主题渲染知识库列表、文档树与文档详情。