v0.9.9 - 变量与个性化运行时引擎、版本化搜索路径、模板解析器与 SPA 路由增强

版本亮点

docmd v0.9.9 带来了全新的变量与个性化运行时引擎,打通了构建期静态模板插值与客户端响应式个性化会话;修复了多版本部署在 /vX.Y.Z/ 路径下的搜索索引加载问题;消除了模板布局槽警告并加固了 Monorepo 依赖安装;完善了 SPA Logo 外部链接路由跳转;并针对 AI 助手插件优化了文档上下文检索与工具调用链路。

  • 统一变量与个性化引擎 (@docmd/core, @docmd/parser, @docmd/ui):支持在 Markdown 正文、公告横幅与页脚版权中优雅使用 {{ variable }} 插值。提供丰富的零配置内置系统变量(docmd.version、docmd.buildYear、docmd.gitCommit、docmd.gitBranch、page.slug、page.title),支持 || 默认回退值以及 \{{ ... }} 语法转义。
  • 通用客户端轻量运行时 (@docmd/ui):在所有模板中默认集成 docmd-runtime.js。提供全局 window.docmd API,通过响应式 DOM 标记(<span data-docmd-var="...">)实现代码块中个人 API Key 的动态水合与无刷新更新,并支持 iFrame 跨窗口 postMessage 状态同步。
  • 版本化搜索路径解析修复 (@docmd/plugin-search):修复了基准路径以版本号结尾(例如 /docs/v1.2.3/)时搜索索引加载失败的问题(感谢 @Goldloli 提交的 PR #266,解决 #262)。
  • SPA 外部 Logo 跳转修复 (@docmd/ui):修复了点击指向外部域名或主站的 Logo 时被 SPA 客户端路由意外拦截报错的问题。
  • 模板解析器与依赖隔离加固 (@docmd/api, @docmd/ui):彻底消除了诸如 summer 等扩展模板在多项目开发中出现的布局槽未找到警告,并在预检阶段优化了 npm v7+ 的依赖剔除防范机制。
  • AI 助手工具链与检索优化 (@docmd/plugin-ai):优化了文档检索与引用合成流程,以更少的往返交互实现精准文档引用。

社区贡献者与 Pull Requests

特别感谢参与 v0.9.9 版本的社区贡献者:

  • @Goldloli 提交了 PR #266(修复版本化基准路径下的搜索索引解析,解决 #262)。
  • @dependabot 自动化维护依赖更新(PR #264, PR #265)。

0.9.10 规划展望

  • 优化移动端浏览器上的代码块复制反馈体验。
  • 进一步增强深度嵌套 Tabs 与折叠 Callout 的容器标准化转换。
  • 持续提升多语言语义向量搜索索引的构建效率。