Docsme 文档管理

新特性

• 新增免费额度模式：无需许可证即可使用，免费额度包含每站点 1 个文档项目、每项目 1 个版本，文档读取功能不受限制；激活有效许可证后解除配额限制，并启用全部 6 个 MCP 文档变更工具
• 超出免费额度的已有项目和版本仍可正常维护，删除后可释放配额
• 控制台增加配额使用情况反馈与许可证激活指引

问题修复

• 修复文档树展开状态在批量操作、树刷新和路由切换后丢失或恢复不完整的问题

新特性

• 适配 MCP Server 插件，提供 11 个文档工具，支持发现、读取、搜索、创建、编辑、移动和发布文档

功能优化

• 记住项目编辑页的全屏偏好，切换文档或刷新页面后继续保持
• 减少文档树拖拽排序时不必要的更新请求
• 在应用市场中推荐可选的 MCP Server 配套应用

问题修复

• 修复文档富文本编辑器无法加载 ESM 形式编辑器扩展的问题

功能优化

• 统一文档树结构处理，提升复杂目录结构下路由、导航和搜索的稳定性
• 优化文档发布状态变更后的导航刷新，无需重启即可同步前后篇链接
• 优化文档编辑器高度适配，避免内容区域溢出

问题修复

• 修复包含中文或空格的文档永久链接未正确编码的问题

开发者相关

• 适配 Halo 2.26，最低运行版本调整为 2.26.0

新特性

• 文档项目支持配置 未授权访问处理方式，支持 404、显示登录提示、直接跳转登录页

• 支持管理文档版本

功能优化

• 适配 Halo 2.22+ 的新索引机制，提升性能和稳定性

功能优化

• 文档页面支持读取文档描述，生成 meta description 标签
• 为模板添加 _templateId 变量

问题修复

• 修复文档别名无法使用中文的问题

功能优化

• 适配 Halo 2.23

功能优化

• 适配 Halo 2.23

新特性

• 提供 docsmeProjectsFinder API，支持在主题任意位置查询文档项目

问题修复

• 修复 Halo 编辑器无法从附件库选择图片的问题

功能优化

• 适配 Halo 2.22

问题修复

• 修复在包含多语言文档的场景时，访问文档首页后无法切换语言的问题

问题修复

• 修复无法渲染 KaTeX 公式的问题

问题修复

• 修复文档删除之后，仍然可以搜索到文档的问题

注意：如果升级之后搜索仍然有问题，可以尝试在仪表盘的快捷访问中刷新搜索引擎索引。

问题修复

• 修复文档内容无法显示斜体样式的问题

问题修复

• 修复文档设置为禁止公开访问后，直接访问文档详情页面仍然可以访问的问题

问题修复

• 修复文档内容中任务列表的样式问题

重要变更

为了获得更好的体验，此版本移除了内置的 Prism 代码块高亮依赖，改为集成额外的代码高亮插件。升级到此版本之后，请进行以下操作：

1. 安装 Shiki 代码高亮（推荐）或者 highlight.js 代码高亮
2. 在插件设置中添加 /docs/** 规则。

新特性

• 深度适配 Shiki 代码高亮插件
  • 支持在 Halo 编辑器中使用 Shiki 渲染代码块高亮
  • 支持 Markdown 预览时使用 Shiki 渲染代码块高亮

Full Changelog: v1.1.0...v1.2.0

⚠️ 提示

1.0.1 之后的版本添加了许可证校验，需要通过 Halo 专业版或者插件的许可证激活之后才能正常启用，所以在更新之前请确保已经有了对应的许可证。

关于此插件的发行方式请查阅：https://www.halo.run/store/apps/app-yffxw

新特性

• 为文档项目增加权限管理机制，支持为角色或者单个用户设置管理、编辑、只读权限。
• 文档项目添加 禁止公开访问 选项。
• 编辑器支持转存外部媒体资源。

问题修复

• 解决将粘贴 Excel 内容会变为图片的问题。

注意事项

• 如果需要让用户支持在编辑器中上传图片，需要提前给用户分配一个包含 允许管理自己的附件 的权限。
• 如果文档项目开启了 禁止公开访问 选项，那么只有超级管理员或者至少包含只读权限的用户可访问文档。

⚠️ 提示

1.0.1 之后的版本添加了许可证校验，需要通过 Halo 专业版或者插件的许可证激活之后才能正常启用，所以在更新之前请确保已经有了对应的许可证。

关于此插件的发行方式请查阅：https://www.halo.run/store/apps/app-yffxw

功能优化

• 添加菜单/路由权限判断。（需要升级到 Halo 2.21.7）

⚠️ 提示

1.0.1 之后的版本添加了许可证校验，需要通过 Halo 专业版或者插件的许可证激活之后才能正常启用，所以在更新之前请确保已经有了对应的许可证。

关于此插件的发行方式请查阅：https://www.halo.run/store/apps/app-yffxw

问题修复

• 修复使用 Markdown 编辑器时，无法预览的问题。

⚠️ 提示

1.0.1 之后的版本添加了许可证校验，需要通过 Halo 专业版或者插件的许可证激活之后才能正常启用，所以在更新之前请确保已经有了对应的许可证。

关于此插件的发行方式请查阅：https://www.halo.run/store/apps/app-yffxw

新特性

• 为文档项目增加权限管理机制，支持为角色或者单个用户设置管理、编辑、只读权限。
• 文档项目添加 禁止公开访问 选项。

注意事项

• 由于需要针对单个项目设置权限，没有利用 Halo 本身的权限机制，所以在 Console 和 UC 端，文档菜单将暂时开放给所有已登录的用户，如果用户没有任何文档的访问权限，不会显示任何数据。
• 如果需要让用户支持在编辑器中上传图片，需要提前给用户分配一个包含 允许管理自己的附件 的权限。
• 如果文档项目开启了 禁止公开访问 选项，那么只有超级管理员或者至少包含只读权限的用户可访问文档。

⚠️ 提示

1.0.1 之后的版本添加了许可证校验，需要通过 Halo 专业版或者插件的许可证激活之后才能正常启用，所以在更新之前请确保已经有了对应的许可证。

关于此插件的发行方式请查阅：https://www.halo.run/store/apps/app-yffxw

问题修复

• 修复暗黑模式切换以及 TOC 功能无法使用的问题。

⚠️ 提示

1.0.1 之后的版本添加了许可证校验，需要通过 Halo 专业版或者插件的许可证激活之后才能正常启用，所以在更新之前请确保已经有了对应的许可证。

关于此插件的发行方式请查阅：https://www.halo.run/store/apps/app-yffxw

功能优化

• 优化提示块在暗黑模式下的样式。

问题修复

• 修复浏览器控制台 JavaScript 异常的问题。
• 修复文档列表页面图标大小的样式问题。

⚠️ 提示

1.0.1 之后的版本添加了许可证校验，需要通过 Halo 专业版或者插件的许可证激活之后才能正常启用，所以在更新之前请确保已经有了对应的许可证。

关于此插件的发行方式请查阅：https://www.halo.run/store/apps/app-yffxw

问题修复

• 修复使用 Halo 编辑器发布时，可能出现页面卡死的问题。

⚠️ 提示

1.0.1 之后的版本添加了许可证校验，需要通过 Halo 专业版或者插件的许可证激活之后才能正常启用，所以在更新之前请确保已经有了对应的许可证。

关于此插件的发行方式请查阅：https://www.halo.run/store/apps/app-yffxw

问题修复

• 修复 Markdown 文档导入时，encode 过的图片链接无法导入的问题。

⚠️ 提示

此版本添加了许可证校验，需要通过 Halo 专业版或者插件的许可证激活之后才能正常启用，所以在更新之前请确保已经有了对应的许可证。

关于此插件的发行方式请查阅：https://www.halo.run/store/apps/app-yffxw

功能优化

• 添加许可证校验。
• 文档导入支持同时上传关联的图片。

问题修复

• 修复 Halo 编辑器无法通过粘贴上传图片的问题。

🎉 正式版发布

此插件已经正式发布 1.0.0 版本，此前承诺在测试阶段提供有效反馈的用户可以在正式版发布之后赠送折扣券，但后面因为凌霞软件商业相关的调整，Halo 官方应用市场已经不再独立销售付费应用，而是改为仅限 Halo 专业版使用，所以现对此前的公告做出调整。

1. 赠送 Halo 专业版的 5 折优惠券，请发送 Halo 官网以及凌霞软件官网的用户名到 ruiyuan.wang@fit2cloud.com。反馈收集截止日期为 2025 年 7 月 15 日，优惠券使用日期截止到 2025 年 8 月 1 日。
2. 公开未来 3 个版本的免授权版本的下载地址，之后的版本可能无法得到更新。
3. 面向 Halo 生态的开发者免费，如果你满足以下要求，请发送邮件到 ruiyuan.wang@fit2cloud.com 申请。（此方式永久有效）
   1. 对 halo-dev 和 halo-sigs 组织下的仓库有过 PR 贡献。
   2. 在 Halo 应用市场上架过插件或者主题。

功能优化

• 文档导入功能支持解析 Front Matter 中的 description 字段。
• 优化文档图片的间距样式。

预告

此插件即将发布 1.0.0 正式版本，此前承诺在测试阶段提供有效反馈的用户可以在正式版发布之后赠送折扣券，但后面因为凌霞软件商业相关的调整，Halo 官方应用市场已经不再独立销售付费应用，而是改为仅限 Halo 专业版使用，所以现对此前的公告做出调整。

1. 赠送 Halo 专业版的 5 折优惠券，请发送 Halo 官网以及凌霞软件官网的用户名到 ruiyuan.wang@fit2cloud.com。反馈收集截止日期为 2025 年 7 月 15 日，优惠券使用日期截止到 2025 年 8 月 1 日。
2. 公开未来 3 个版本的免授权版本的下载地址，之后的版本可能无法得到更新。
3. 面向 Halo 生态的开发者免费，如果你满足以下要求，请发送邮件到 ruiyuan.wang@fit2cloud.com 申请。（此方式永久有效）
   1. 对 halo-dev 和 halo-sigs 组织下的仓库有过 PR 贡献。
   2. 在 Halo 应用市场上架过插件或者主题。

以上调整在正式版发布后生效。

新特性

• 重构默认模板，优化主题集成的方式，文档：主题适配 - Docsme
• 文档和目录支持设置描述。

问题修复

• 修复 1.0.0-rc.1 中文档目录页面报错的问题。

预告

此插件即将发布 1.0.0 正式版本，此前承诺在测试阶段提供有效反馈的用户可以在正式版发布之后赠送折扣券，但后面因为凌霞软件商业相关的调整，Halo 官方应用市场已经不再独立销售付费应用，而是改为仅限 Halo 专业版使用，所以现对此前的公告做出调整。

1. 赠送 Halo 专业版的 5 折优惠券，请发送 Halo 官网以及凌霞软件官网的用户名到 ruiyuan.wang@fit2cloud.com。反馈收集截止日期为 2025 年 7 月 15 日，优惠券使用日期截止到 2025 年 8 月 1 日。
2. 公开未来 3 个版本的免授权版本的下载地址，之后的版本可能无法得到更新。
3. 面向 Halo 生态的开发者免费，如果你满足以下要求，请发送邮件到 ruiyuan.wang@fit2cloud.com 申请。（此方式永久有效）
   1. 对 halo-dev 和 halo-sigs 组织下的仓库有过 PR 贡献。
   2. 在 Halo 应用市场上架过插件或者主题。

以上调整在正式版发布后生效。

新特性

• 重构默认模板，优化主题集成的方式，文档：主题适配 - Docsme
• 文档和目录支持设置描述。