明暗模式 : docmd docs

docmd 内置支持明色和暗色配色方案。它会自动检测用户的系统偏好，并允许通过 UI 切换按钮手动覆盖。

默认浏览模式

在 docmd.config.json 中指定文档的初始状态。

{
  "theme": {
    "name": "sky",
    "appearance": "system"
  }
}

主题切换器是选项菜单的组成部分。可通过 layout 对象控制其可见性和位置。

{
  "layout": {
    "optionsMenu": {
      "position": "header",
      "components": {
        "themeSwitch": true
      }
    }
  }
}

主题引擎会向 <body> 标签添加 data-theme 属性：

如果使用类似 sky 这样的主题设计，属性值将为 sky-light 或 sky-dark。

docmd 主题为所有颜色使用 CSS 变量。可在自定义 CSS 中覆盖这些变量，自定义任意模式的外观。

/* 自定义 CSS 覆盖 */
:root {
  --docmd-primary: #4f46e5; /* 亮色模式主色调 */
}

body[data-theme="dark"] {
  --docmd-primary: #818cf8; /* 暗色模式主色调 */
}

用户手动切换模式后，偏好将存入 localStorage。docmd 在每次页面加载时即时读取该值，防止“主题闪烁”（FOUC）。

生成内容时，LLM 偏幽高对比结构。docmd 确保代码片段和提示框在两种模式下均可正常访问，保证 llms-full.txt 内容无论在哪种模式下构建，都能被正确解析为语义块。