docmd 具有模块化插件架构。必需的插件随核心一起发布，无需安装。可选插件可以通过单一 CLI 命令安装。

安装插件

使用 docmd CLI 安装和移除插件：

# 安装插件
npx @docmd/core add <plugin-name>

# 移除插件
npx @docmd/core remove <plugin-name>

安装程序检测你的包管理器（npm、pnpm、yarn 或 bun）。它将短名称解析为完整的包名称，并将配置注入到你的 docmd.config.json 中。

使用 --verbose（或 -V）获取完整的安装程序输出：

npx @docmd/core add <plugin-name> -V

必需插件

这些插件与 @docmd/core 一起打包。无需安装。在你的 docmd.config.json 中启用它们：

{
  "plugins": {
    "search": {},
    "seo": { "aiBots": false },
    "sitemap": {},
    "analytics": {},
    "llms": {},
    "mermaid": {},
    "openapi": {},
    "git": {}
  }
}

可选插件

可选插件需要在启用之前安装。

docmd 采用可插拔架构。几乎所有核心功能（从搜索到 SEO 再到实时预览）都是作为插件实现的。这种设计确保了引擎保持轻量，同时允许开发者根据具体项目需求选择性地开启功能。

插件概览

生命周期钩子

插件可以通过连接到以下生命周期钩子来介入构建过程：

插件安全

插件系统提供内置的安全保证：

• 验证: 插件可以声明一个包含 name、version 和 capabilities 的插件描述符。无效的描述符在加载时会被拒绝。
• 隔离: 每次钩子调用都包裹在 try/catch 边界内。一个损坏的插件不会导致构建崩溃或影响其他插件。
• 能力强制: 声明了能力的插件只能注册其已明确声明的钩子。未声明的钩子将被跳过并发出警告。

有关完整的 API 参考，请参阅 开发插件。