主题选项、配色与版本差异
现在
偶尔用 · 快照核对 11 月 4 日 09:18
截至 11 月 4 日 · 项目仓库和运行记录

Steam Millennium 配置备份 · 功能说明

保存两套主题的选项定义、来源提交与自己的颜色选择,减少换机后重新调校。

当前情况:两套主题的选项和配色都有记录。Adwaita 4.4 三处仍是同一版;Zehn 电脑上已更新,本机保存的这份(10 月 26 日备份)跟着记成 2026.10.13,但这份变化还没提交,公开仓库里仍是 2026.9.7;恢复时要分清的是“现在这份”和“想找回的某个历史快照”,最后仍要在 Steam 里看实际效果。

内容核对于 2026-11-04 09:18(北京时间,只读;E、G、H 三处同为 10 月 26 日那一代);测试结果写的是各自跑的日期;这页不实时读运行状态,要看现在好不好,问 AI 或看驾驶舱。

项目源码:公开仓库

主题选项、配色与版本差异
现在
偶尔用 · 快照核对 11 月 4 日 09:18
截至 11 月 4 日 · 项目仓库和运行记录

Steam Millennium 配置备份 · 功能说明

保存两套主题的选项定义、来源提交与自己的颜色选择,减少换机后重新调校。

当前情况:两套主题的选项和配色都有记录。Adwaita 4.4 三处仍是同一版;Zehn 电脑上已更新,本机保存的这份(10 月 26 日备份)跟着记成 2026.10.13,但这份变化还没提交,公开仓库里仍是 2026.9.7;恢复时要分清的是“现在这份”和“想找回的某个历史快照”,最后仍要在 Steam 里看实际效果。

内容核对于 2026-11-04 09:18(北京时间,只读;E、G、H 三处同为 10 月 26 日那一代);测试结果写的是各自跑的日期;这页不实时读运行状态,要看现在好不好,问 AI 或看驾驶舱。

项目源码:公开仓库

这项功能怎样使用
为什么需要它

圆角、字体、标题栏和配色很难只凭记忆复现。主题更新又可能增删选项,所以需要同时知道“我选了什么”和“这些选项属于哪一版主题”。

举个实际例子

“我以前把 Zehn 主题调成浅色和圆角,想找回当时的选择。”先选那份旧快照,再看它记的主题版本和电脑上现在装的是否一致;旧配置不能直接当作新版本的真实外观。

最后我会得到什么

可以读回自己的选项和 RGB 配色,再对照主题版本恢复;最终仍需在当前 Steam 中检查效果。

这项功能怎样使用
为什么需要它

圆角、字体、标题栏和配色很难只凭记忆复现。主题更新又可能增删选项,所以需要同时知道“我选了什么”和“这些选项属于哪一版主题”。

举个实际例子

“我以前把 Zehn 主题调成浅色和圆角,想找回当时的选择。”先选那份旧快照,再看它记的主题版本和电脑上现在装的是否一致;旧配置不能直接当作新版本的真实外观。

最后我会得到什么

可以读回自己的选项和 RGB 配色,再对照主题版本恢复;最终仍需在当前 Steam 中检查效果。

结果怎么看
可以怎么用

能从选定快照读回主题选项与颜色,并在当前 Steam 里看到对应效果。

需要处理什么

要恢复的历史快照和电脑上现装的主题版本不同时,先决定用哪一版的主题,再回填选项。

什么时候不可用

主题程序、图片或字体缺失时,只有配置文字仍不能重建完整外观。

结果怎么看
可以怎么用

能从选定快照读回主题选项与颜色,并在当前 Steam 里看到对应效果。

需要处理什么

要恢复的历史快照和电脑上现装的主题版本不同时,先决定用哪一版的主题,再回填选项。

什么时候不可用

主题程序、图片或字体缺失时,只有配置文字仍不能重建完整外观。

从哪里开始

从项目快照选择目标主题配置,先确认目标机器已安装对应主题资源,再按恢复计划合并选项和配色。

需要准备什么
  • 想恢复的主题外观与日期
  • 目标电脑已装或希望重装的主题
从开始到拿到结果
1确定基线
分清公开仓库里已提交的、本机保存的这份(和已安装的一致)以及想找回的历史快照,选要恢复的那一份;Zehn 现在本机和仓库就不是同一版。
2核对主题版本
先装可用资源,再把对应选项和配色合并回填,不盲迁移未知键。
3实际看外观
在 Steam 核对主题、颜色和滚动条;版本差异或缺资源时保留明确缺口。
从哪里开始

从项目快照选择目标主题配置,先确认目标机器已安装对应主题资源,再按恢复计划合并选项和配色。

需要准备什么
  • 想恢复的主题外观与日期
  • 目标电脑已装或希望重装的主题
从开始到拿到结果
1确定基线
分清公开仓库里已提交的、本机保存的这份(和已安装的一致)以及想找回的历史快照,选要恢复的那一份;Zehn 现在本机和仓库就不是同一版。
2核对主题版本
先装可用资源,再把对应选项和配色合并回填,不盲迁移未知键。
3实际看外观
在 Steam 核对主题、颜色和滚动条;版本差异或缺资源时保留明确缺口。
技术实现与依据(一)

这里保留实现、关键条件、精确入口、历史记录和验证结果。

选中 Adwaita;Adwaita 三处一致,Zehn 本机保存为 2026.10.13、公开仓库仍是 2026.9.7(本机未提交)

关键规则与设计选择
1
选择值和主题定义分别保留,不把“已有 JSON”当作所有版本都支持这些键。
2
只保存名单内的定义文件,主题 CSS、图片和字体仍要从主题程序取得。
3
10 月 20 日核对:Adwaita 4.4 的已提交文件、本机保存的这份和已安装定义一致;Zehn 的本机保存已随安装更新到 2026.10.13,themes/Zehn 的 metadata.json、skin.json 与快照清单一起属于本机 7 个未提交文件,公开 master 仍是 2026.9.7。未提交的本机投影不算已发布的源码。
1
复制每套主题允许的定义与元数据文件。
当前怎样实现
  • Adwaita-for-Steam 来自 tkashkin/Adwaita-for-Steam;版本 4.4,metadata(元数据)提交 1e92107a51f6ed53c59c38646444c9eb3a52b030。已提交、本机保存与已安装定义都是这一版(9 月 18 日写入仓库)。
  • Zehn 来自 yurisuika/Zehn;公开仓库里是 2026.9.7,metadata(元数据)提交 68719556122c06fdaaa14358012a697577042d17;本机最新备份为 2026.10.13,尚未提交,新版的选项和颜色个数这次没重新数。9 月 19 日核对时曾是“已提交 2026.7.24、本地 2026.8.29、已安装 2026.9.7”三个版本并存,这是当时的历史。
  • Adwaita 子目录保存 metadata.json、skin.json、theme.json;Zehn 保存 metadata.json、skin.json、options.json、waifus.json。
  • Adwaita 保存 17 个条件选择与 48 个颜色变量,包括 System 配色方案、Adwaita 字体、圆角与方形游戏图标选择;如 --adw-accent-bg-rgb=39, 168, 100。Zehn 保存 25 个条件选择与 14 个颜色变量,包括 Embed Size=640、Avatar Frame=no 等选项与各状态颜色。
执行流程
技术实现与依据(一)

这里保留实现、关键条件、精确入口、历史记录和验证结果。

选中 Adwaita;Adwaita 三处一致,Zehn 本机保存为 2026.10.13、公开仓库仍是 2026.9.7(本机未提交)

关键规则与设计选择
1
选择值和主题定义分别保留,不把“已有 JSON”当作所有版本都支持这些键。
2
只保存名单内的定义文件,主题 CSS、图片和字体仍要从主题程序取得。
3
10 月 20 日核对:Adwaita 4.4 的已提交文件、本机保存的这份和已安装定义一致;Zehn 的本机保存已随安装更新到 2026.10.13,themes/Zehn 的 metadata.json、skin.json 与快照清单一起属于本机 7 个未提交文件,公开 master 仍是 2026.9.7。未提交的本机投影不算已发布的源码。
1
复制每套主题允许的定义与元数据文件。
当前怎样实现
  • Adwaita-for-Steam 来自 tkashkin/Adwaita-for-Steam;版本 4.4,metadata(元数据)提交 1e92107a51f6ed53c59c38646444c9eb3a52b030。已提交、本机保存与已安装定义都是这一版(9 月 18 日写入仓库)。
  • Zehn 来自 yurisuika/Zehn;公开仓库里是 2026.9.7,metadata(元数据)提交 68719556122c06fdaaa14358012a697577042d17;本机最新备份为 2026.10.13,尚未提交,新版的选项和颜色个数这次没重新数。9 月 19 日核对时曾是“已提交 2026.7.24、本地 2026.8.29、已安装 2026.9.7”三个版本并存,这是当时的历史。
  • Adwaita 子目录保存 metadata.json、skin.json、theme.json;Zehn 保存 metadata.json、skin.json、options.json、waifus.json。
  • Adwaita 保存 17 个条件选择与 48 个颜色变量,包括 System 配色方案、Adwaita 字体、圆角与方形游戏图标选择;如 --adw-accent-bg-rgb=39, 168, 100。Zehn 保存 25 个条件选择与 14 个颜色变量,包括 Embed Size=640、Avatar Frame=no 等选项与各状态颜色。
执行流程
技术实现与依据(二)
2
与核心 config.json 中该主题的 conditions、themeColors 一起保存。
3
恢复时先核对安装版本、资源和选项对应关系,再把支持的主题选择、条件和配色逐层合并(递归合并:只改快照里有的项,目标里多出来的项留着)回填,然后在 Steam 查看实际外观。
技术实现与依据(二)
2
与核心 config.json 中该主题的 conditions、themeColors 一起保存。
3
恢复时先核对安装版本、资源和选项对应关系,再把支持的主题选择、条件和配色逐层合并(递归合并:只改快照里有的项,目标里多出来的项留着)回填,然后在 Steam 查看实际外观。
名词和入口
本模块用到的名词
名词意思
conditionsconfig.json 中每套主题已经选择的开关或枚举值。
themeColors保存 RGB 三元组配色,供对应主题引用;这是选择值,不是独立调色程序。
skin.json / theme.json主题选项、补丁目标和资源路径定义,引用的实际 CSS 等资源未随快照打包。
专业定义

Adwaita 和 Zehn 的选项、颜色与来源提交都留下;Adwaita 已提交、本机保存与已安装三处一致,Zehn 的本机保存已是新版、还没提交;历史快照各自带着当时的版本。

解决什么

只有配色值没有主题资源无法呈现界面;复制旧版本定义到新程序,也可能引用已经变化的选项或资源。

名词和入口
本模块用到的名词
名词意思
conditions
意思:
config.json 中每套主题已经选择的开关或枚举值。
themeColors
意思:
保存 RGB 三元组配色,供对应主题引用;这是选择值,不是独立调色程序。
skin.json / theme.json
意思:
主题选项、补丁目标和资源路径定义,引用的实际 CSS 等资源未随快照打包。
专业定义

Adwaita 和 Zehn 的选项、颜色与来源提交都留下;Adwaita 已提交、本机保存与已安装三处一致,Zehn 的本机保存已是新版、还没提交;历史快照各自带着当时的版本。

解决什么

只有配色值没有主题资源无法呈现界面;复制旧版本定义到新程序,也可能引用已经变化的选项或资源。

出问题时

解决什么

只有配色值没有主题资源无法呈现界面;复制旧版本定义到新程序,也可能引用已经变化的选项或资源。

边界
  • 恢复会合并 config.json 里受支持的主题选择、条件和配色,但不会写回主题的安装定义、程序和图片字体等资源,不自动调整废弃键,也不保证上游忽略未知选项时一定不出错。
  • 10 月 20 日本机仓库有 7 个未提交文件:快照清单,加上 Size on Disk、Easy SteamGrid 两个插件和 Zehn 主题各自的说明文件,里面是新的版本号;公开仓库仍是旧版本。这不是另建的版本管理或主题自动迁移系统。
失败与恢复
  • 主题新版本删改了旧选项或资源路径: 按对应主题实际版本重新核对;无法从本项目证明自动兼容,不保证复制后原样还原。
  • 主题外观不符合预期: 核对 activeTheme、conditions、themeColors 以及实际安装资源,必要时恢复目标机已保留配置。
出问题时

解决什么

只有配色值没有主题资源无法呈现界面;复制旧版本定义到新程序,也可能引用已经变化的选项或资源。

边界
  • 恢复会合并 config.json 里受支持的主题选择、条件和配色,但不会写回主题的安装定义、程序和图片字体等资源,不自动调整废弃键,也不保证上游忽略未知选项时一定不出错。
  • 10 月 20 日本机仓库有 7 个未提交文件:快照清单,加上 Size on Disk、Easy SteamGrid 两个插件和 Zehn 主题各自的说明文件,里面是新的版本号;公开仓库仍是旧版本。这不是另建的版本管理或主题自动迁移系统。
失败与恢复
  • 主题新版本删改了旧选项或资源路径: 按对应主题实际版本重新核对;无法从本项目证明自动兼容,不保证复制后原样还原。
  • 主题外观不符合预期: 核对 activeTheme、conditions、themeColors 以及实际安装资源,必要时恢复目标机已保留配置。
依据与来源
真实入口
  • themes/Adwaita-for-Steam/主题定义、元数据及已提交/本地版本。
  • themes/Zehn/皮肤定义、选项、元数据与本地版本。
  • config/config.json实际选中的主题、条件和 RGB 颜色。
如何验证
  • 原有测试证明主题元数据会复制,主题图片资源不复制。
  • 10 月 11 日只读比对时两套主题的已提交文件、本机保存的这份与安装定义的 JSON 值一致(Adwaita 4.4、Zehn 2026.9.7);10 月 20 日 git diff 显示 Zehn 的本机保存已变为 2026.10.13、尚未提交;这是文件内容核对,不是 Steam 界面效果验收。9 月 19 日看到的 Zehn 版本差异是历史观察。
与其他模块的关系

与核心设置一起还原外观;插件清单是另外一类扩展,二者都依赖真实程序资源。

依据与来源
真实入口
  • themes/Adwaita-for-Steam/主题定义、元数据及已提交/本地版本。
  • themes/Zehn/皮肤定义、选项、元数据与本地版本。
  • config/config.json实际选中的主题、条件和 RGB 颜色。
如何验证
  • 原有测试证明主题元数据会复制,主题图片资源不复制。
  • 10 月 11 日只读比对时两套主题的已提交文件、本机保存的这份与安装定义的 JSON 值一致(Adwaita 4.4、Zehn 2026.9.7);10 月 20 日 git diff 显示 Zehn 的本机保存已变为 2026.10.13、尚未提交;这是文件内容核对,不是 Steam 界面效果验收。9 月 19 日看到的 Zehn 版本差异是历史观察。
与其他模块的关系

与核心设置一起还原外观;插件清单是另外一类扩展,二者都依赖真实程序资源。

复制 AI 续作说明

项目:主题选项、配色与版本差异;仓库:wlyaaaaa/steam-millennium-config-backup;范围:整个项目;目标:(这里写这次要做的事)。先读项目的 AGENTS.md 和说明,按现行规则做。

把“目标”换成这次要做的事,整段复制给 AI。