文档

摘要

my-docs 为 Halo 提供独立的文档 / 知识库系统，支持文档库、树形目录、Markdown 编辑、前台文档站点、搜索与 SEO 集成。

本版本为 v1.3.1，适用于 Halo >= 2.25.0。

v1.3.0 的产物因 fat jar 中残留 JGit 签名文件无法加载，已撤回；请使用本版本。

本版重点

GitHub Wiki 导入

• 双通道导入：输入 owner/repo 或完整 GitHub 地址由服务器浅克隆 .wiki.git 拉取（私有 Wiki 支持 PAT 令牌）；服务器无法直连 GitHub 时可上传 clone 后打包的 zip
• Wiki 链接自动转换：[[Page]]、[[Page|文字]]、[[Page#锚点]] 转换为站内同库短链接；找不到对应页面时降级为纯文本并在导入报告中提示
• 导入行为：页面文件名作为标题，Home 排最前；_Sidebar / _Header / _Footer 自动跳过；可选导入到已有文档库（别名冲突自动追加序号）或新建文档库；可指定导入后立即发布或保持草稿

优化与修复

• 加固文档端点校验：PUT 路径名与请求体一致性、所属文档库存在性
• 搜索索引同步去重：插件重启后的全量 resync 不再反复重建索引；修复文档删除后搜索索引残留
• Markdown 渲染器实例复用，提升阅读页渲染性能
• 修复 fat jar 残留签名文件导致插件加载失败（Invalid signature file digest）

安装

1. 在 Release 附件中下载 plugin-my-docs-1.3.1.jar。
2. 进入 Halo Console，打开「插件」页面上传该 jar。
3. 安装并启用 my-docs。

---

Generated from v1.3.1