源码索引¶
本页按问题而不是目录列出关键入口。全部链接锁定到 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 |