跳转至

源码索引

本页按问题而不是目录列出关键入口。全部链接锁定到 ef6d9e6605b121df15bf310e630e04f0c1119fc8。

全局骨架

要追的问题 首选源码 配套说明
文件为什么落在这些路径 docs/file-layout.md 仓库地图
生产/开发路径如何统一 default/bash/env-bootstrap OMARCHY_PATH / PATH
一个用户动作如何找命令 bin/omarchy CLI router
所有上游实现文档 docs/ 作为源码旁证

安装与用户生命周期

阶段 入口
root system apply bin/omarchy-apply-system
系统配置集合 install/config/all.sh
硬件集合 install/hardware/all.sh
登录配置 install/login/all.sh
owner finalization bin/omarchy-provision-user
用户动作集合 install/user/all.sh
graphical first-run bin/omarchy-first-run
deferred owner service install/provisioning/omarchy-provision-owner.service

Session 与 Hyprland

问题 源码
display manager 启动什么 default/wayland-sessions/omarchy.desktop
UWSM 导入什么环境 default/uwsm/env.d/10-omarchy
用户配置加载顺序 config/hypr/hyprland.lua
Lua module cache/path default/hypr/bootstrap.lua
默认模块装配 default/hypr/omarchy.lua
动态 toggle default/hypr/toggles.lua

Shell 与插件

问题 源码
常驻宿主/Loader/IPC shell/shell.qml
Shell 启动 bin/omarchy-launch-shell
IPC wrapper bin/omarchy-shell
manifest 发现与校验 shell/services/PluginRegistry.qml
bar widget 注册 shell/services/BarWidgetRegistry.qml
desktop entry 索引 shell/services/AppLibrary.qml
插件安装前校验 bin/omarchy-plugin-validate

菜单与主题

子系统 数据/模型 执行入口
Menu omarchy-menu.jsonc · MenuModel.js · Menu.qml bin/omarchy-menu
Theme themes/ · default/themed/ bin/omarchy-theme-set · theme-set-templates

更新、迁移与渠道

问题 源码
update 总顺序 bin/omarchy-update
包事务 bin/omarchy-update-system-pkgs
migration 执行/marker bin/omarchy-migrate
登录迁移通知 bin/omarchy-migrate-notify
防止绕过流程 00-omarchy-update-guard.hook
用户 hook bin/omarchy-hook
渠道切换 bin/omarchy-channel-set

安全、恢复与升级

场景 源码
Snapper create/restore bin/omarchy-snapshot
Factory reset staging bin/omarchy-system-factory-reset
Reset next-boot finish bin/omarchy-system-factory-reset-finish
旧版 → Quattro bin/omarchy-upgrade-to-quattro
主题不可信输入 bin/omarchy-theme-set#L138-L316

测试入口

层 Runner 公共基础
全部 headless test/all CLI + shell 都继续运行
CLI test/cli router/theme
Shell/脚本 test/shell base-test.sh
图形验收 test/acceptance acceptance.d/base-test.sh