v0.9.9 - 变量与个性化运行时引擎、版本化搜索路径、模板解析器与 SPA 路由增强
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.docmdAPI,通过响应式 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 的容器标准化转换。
- 持续提升多语言语义向量搜索索引的构建效率。