Doxygen

读取某个文档站点是由哪个版本的 Doxygen 生成的。Doxygen 写出的每个 HTML 页面都会注明这一点——<meta name="generator" content="Doxygen 1.19.0"/>、<!-- Generated by Doxygen 1.19.0 --> 以及页脚——探针从前两者中读取版本。读取的页面为 /，除非目标的 path 另有指定。默认协议为 https。

targets:
  - id: api-docs
    product: doxygen
    address: https://docs.example.com
    path: /docs/        # 可选，当站点不在 / 下提供时

是构建工具，而不是服务器

不存在可以询问的 Doxygen 服务器：记录的版本是文档最后一次构建时所用的版本——正是这一点能暴露出陈旧的文档流水线。位于 SSO 之后的文档站点（例如 oauth2-proxy 登录页面）不显示任何标记，会以不支持失败；对于位于 HTTP Basic 之后的站点，请配置凭据（见下文）。

身份验证

可选——仅用于位于 HTTP Basic 之后的站点。basic 是唯一接受的类型；自 2.2.0 起，其他任何类型都是配置错误（参见配置 → 凭据）。

credentials:
  docs-basic:
    kind: basic
    username: reader
    password: "${DOCS_PASSWORD}"

记录的字段

仅 version——例如 1.19.0；本探针不记录任何 extra 字段。

CVE 关联

配置了 cve: 块时，会与 NVD 进行匹配。

生命周期解析器

github:doxygen/doxygen——endoflife.date 没有 Doxygen 的日历（已确认 404），因此改为根据 GitHub Releases 解析：只取最新发布的非预发布标签，不含 eol/support/lts 日期（GitHub 对生命周期策略没有立场，只知道“最新的发布版本是什么”）。Doxygen 的发布标签形如 Release_1_18_0；自 2.2.0 起，github 解析器会把这种写法读作 1.18.0。