Разные CSS-изменения для разных цветовых схем

Если я правильно понимаю проблему, для этого есть конкретное решение.

Я работаю над руководством по этой теме, но мне немного трудно объединить информацию так, чтобы её можно было напрямую использовать в теме, при этом сохранив объяснение технических деталей.

Чтобы максимально ясно объяснить, как это сделать…

Я предлагаю вам создать тему локально (это поможет Install the Discourse Theme CLI console app to help you build themes).
Затем создайте файл common/color_definitions.scss в вашей теме и напишите в нём:

$my-color: dark-light-choose(#FC3468, #FF93AC);

:root {
  --my-color: #{$my-color};
}

Затем в файле common/common.scss вы можете использовать переменную следующим образом:

h1 {
  color: var(--my-color);
}

Это автоматически выберет правильный цвет в тёмном или светлом режиме.