用途：把状态栏小组件想法做成可提交市场的 Omarchy 插件，避免做出永远不显示的组件。流程分阶段推进。
调研：读取 https://plugins.omarchy.org/catalog.json 确认想法与 id 未被占用，浅克隆最接近的 3 至 5 个插件；参考 references/quattro-facts.md 与 /usr/share/omarchy/shell/plugins/panels/ 下的官方面板；用真实 CLI（有 --json 时）确认可用数据字段。
原型：先写 HTML 而非 QML。做 option-a/b/c.html 与并排 iframe 的 index.html，含模拟状态栏、面板与明暗切换，主题取自 ~/.config/omarchy/themes/*/colors.toml；用无头 Chromium 截图自查后再给用户看。选定方向后做 design-<x>-full.html，覆盖健康、运行、失败、过期/警告、未配置、设置等状态，确认后再写规格。
建仓：可用 omarchy plugin clone omarchy.clock --edit 作模板，或复用自己上一个插件骨架；gh repo create 后 omarchy plugin add <git url> --enable 并 omarchy-restart-shell。源码放 ~/src，不要直接编辑 ~/.config/omarchy/plugins/<id>/。
构建顺序：manifest 与 BarWidget.qml 先让字形可见；Model.js 纯函数配 node 测试；Service.qml 单例加看门狗进程与 test/stub/ 桩；Panel.qml 用官方组件；其余状态经调试 IPC 强制触发并截图比对；SettingsView.qml 经 manifest barWidget.schema 保存；通知用 notify-send 去重。
验证与限制：用 omarchy-shell <id> open、shell toggle、grim -g 截图，悬停经 hyprctl eval 移动光标并恢复原位，不要求用户点击。组件不加载时按 references/debugging.md 逐层排查。提交前运行 omarchy-plugin-security 技能修复所有命中。插件仓库禁止出现 AGENTS.md、CLAUDE.md、SKILL.md 等代理指令文件，贡献说明放 docs/CONTRIBUTING.md。截图只裁面板边框，避免拍到背后窗口。