Omarchy 社区主题：检查、安装、比较与移除

社区主题由 Omarchy 内置清单之外的维护者提供。进入图库不代表截图最新、仓库属于官方，或全部应用集成都兼容你安装的版本。用官方社区目录与本站预览图库发现候选，再根据仓库和实际应用检查做决定。

按问题阅读主题仓库

想确认的事	寻找的证据	截图为什么不够
谁维护	仓库所有者、README、问题回复	转发页面可能隐藏真正来源
适用哪个版本	有日期的兼容说明与文件布局	老教程可能依赖已替换的配置机制
展示哪些界面	桌面、编辑器/终端，以及明确的解锁/锁屏标注	一张桌面图不能证明所有应用一致
配色来自哪里	colors.toml、应用文件与模板前提	好看壁纸不等于完整集成
还改了什么	安装脚本、hook、可执行配置、依赖	命令可能做不止改颜色的事情
能否复用素材	代码许可与单独的壁纸、字体条款	仓库公开不等于所有素材任意使用

提交日期较旧不自动等于有问题；稳定调色板可能不需要频繁修改。针对你当前版本格式的未解决报告更值得关注。受欢迎也不能代替阅读安装说明。

安装前保护已有修改

记录当前主题，确认候选在本地会用什么名字。固定版本的安装器会将仓库基本名转为小写，去掉 omarchy- 前缀和 -theme 后缀。例如虚构仓库 omarchy-sample-theme 会对应 ~/.config/omarchy/themes/sample。

安装器在克隆之前移除已有目标目录，克隆成功后立即应用主题。 同名安装可能覆盖个人修改；克隆失败也不会自动恢复旧目录。继续之前，把已有同名目录复制到主题树之外。这里的示例名称只解释规则，不是要安装的真实仓库。

审阅实际仓库后，在 Install → Style → Theme 输入它的真实地址。不要自动跟着 README 再运行一段脚本；先理解为什么需要，以及会改什么。保留原先可用的内置主题作为退路。

理解兼容过滤，不要绕过

固定版本的主题实现说明会区分 Git 克隆主题与个人普通目录。生成前会排除 Lua、部分终端配置、VS Code 扩展配置及符号链接，并从模板生成对应文件；颜色文件仍可参与。因此老 README 宣称自带 Neovim Lua 定制，不代表在这个版本就会得到相同结果。

这是具体版本的机制，不表示所有历史版本都一样，也不表示主题在沙箱里运行。不要为了“恢复效果”删除 .git，或手动解压绕开过滤；改变信任分类不会让文件变安全或兼容。排查时保留安装输出，尤其是说明排除哪些文件的信息。

用固定场景验证效果

使用与原主题相同的代码、目录列表、选中文字和文件管理器视图；再开一个新终端。比较文字与控件之后再换壁纸，避免图片主导判断。

结果	解释与下一步
配色变化，但编辑器不同	检查过滤提示、编辑器插件与当前 colorscheme
新终端正常，旧窗口不同	查终端重载方式，不要先改生成文件
壁纸缺失	检查仓库素材与个人背景路径
选择器找不到主题	查克隆是否成功、目标目录和名称
已选主题仍不像预览	比较版本、个人模板覆盖和真正选中的源目录
只有一个不受集成的应用不同	用该应用的外观设置，主题不一定控制它

继续看应用主题差异追踪生成输出。有效兼容报告包含仓库提交、Omarchy 版本、具体界面与报错，不只是“坏了”的截图。

先恢复正常，再移除

先选择已知可用的内置主题，检查新终端与面板。备份社区目录内自己的修改。在本文对应的命令集中，运行 omarchy-theme-remove 打开个人主题移除选择器，只选要移除的一项。

移除工具只移除个人主题目录，不自动选择替代主题，也不能撤销任意脚本或 hook。个人背景目录中的壁纸应单独决定如何处理。不要为了移除一个主题重置整个桌面配置。

为便于复现，记录仓库地址、提交、系统版本和个人模板改动。后续拉取可能改变兼容性，更新前应有意识地检查，而不是认为曾经可用就永久相同。