如何实现GitHub与PyPi兼容的明暗模式Logo切换？

GitHub本身支持多种明暗模式自动切换Logo的方式，但当项目同步到PyPi时，常见方案都会失效。以下是两种尝试过的无效方案及问题：

无效方案1：GitHub专属URL后缀 #

使用#gh-dark-mode-only和#gh-light-mode-only后缀区分明暗Logo：

![CoGuard Logo Dark](https://github.com/coguardio/coguard-cli/raw/master/logo_dark_mode.png#gh-dark-mode-only)![CoGuard_Light_Logo](https://github.com/coguardio/coguard-cli/raw/master/logo.png#gh-light-mode-only)

PyPi表现：两张Logo会同时显示，无法实现切换。

无效方案2：HTML <picture>标签 #

用HTML的<picture>结合媒体查询实现切换：

<p align="center">
  <picture>
    <source srcset="https://github.com/coguardio/coguard-cli/raw/master/logo_dark_mode.png" media="(prefers-color-scheme: dark)">
    <img src="https://github.com/coguardio/coguard-cli/raw/master/logo.png" alt="Light mode logo" width="500">
  </picture>
</p>

PyPi表现：不支持<picture>标签，仅显示默认的浅色Logo（或显示异常）。

可行解决方案：自适应SVG Logo #

SVG格式支持内嵌CSS媒体查询，能根据系统的明暗模式自动切换元素颜色，且GitHub和PyPi都能正常渲染SVG文件，是目前最可靠的跨平台方案。

步骤： #

1. 将你的Logo转换为SVG格式，对需要随主题变色的元素添加类名（比如logo-color）。
2. 在SVG内部添加样式，通过prefers-color-scheme媒体查询定义明暗模式下的颜色：

<svg xmlns="http://www.w3.org/2000/svg" width="500" height="150">
  <style>
    .logo-color {
      fill: #2d3748; /* 浅色模式颜色 */
    }
    @media (prefers-color-scheme: dark) {
      .logo-color {
        fill: #f7fafc; /* 深色模式颜色 */
      }
    }
  </style>
  <!-- 替换为你的Logo图形路径，给需要变色的元素加上class="logo-color" -->
  <path class="logo-color" d="M10 20L30 10L50 20..." />
  <text class="logo-color" x="25" y="30" font-size="24">CoGuard</text>
</svg>

3. 将这个自适应SVG文件上传到GitHub仓库，在README中用普通图片语法引用：

![CoGuard Logo](https://github.com/coguardio/coguard-cli/raw/master/logo-adaptive.svg)

这样，无论是在GitHub还是PyPi页面，Logo都会根据用户的系统明暗模式自动切换颜色，完美兼容双平台。

内容的提问来源于stack exchange，提问作者Albert