使用方法
- 复制安装命令,在自己的智能体环境安装前先检查源码包。
- 从原始文档核对所需工具、凭据和支持的宿主。
- 说明输入材料与期望交付物,并对照来源检查输出。
npx skills add https://github.com/tcballard/build-omarchy-plugins --skill omarchy-qml-patterns开始前需了解
- 安装不包含模型订阅、API 额度或访问文件的权限。
- 仓库星数和安装量反映活跃情况,不等于独立质量或安全测试。
仓库原始内容
按源仓库内容呈现,保留标题、案例、代码、表格、链接以及原文引用的演示图片。
Write hosted Omarchy QML
Inspect the installed host and closest working component. Use its contract rather than assuming the pinned examples fit every version.
- Use hosted
Item/UI entry points, never a secondShellRootor Quickshell process. Give late-injected host properties safe defaults rather thanrequireddeclarations. - Use
qs.Uicomponents and semantic tokens. Importqs.Commons as Commonsand qualifyCommons.Color.*: Qt 6.12 adds a conflictingColortype. Keep the unqualified import too when usingStyle,UtilorBorder. - Use host motion components; route custom durations through
Style.duration(ms)and stop looping animations underStyle.reduceMotion. Inspect host support before using these newer tokens. - Keep hover/selection/open state per visual instance; share polling and remote state through a service where needed.
- Set
Text.PlainTextfor external text at every sink, including tooltips and nested delegates. Bound external data before displaying or saving it. - Launch commands with argument arrays. If a shell is necessary, quote external values with
Util.shellQuote. Keep secrets out of display properties, logs and environment dumps. - Keep repeated network/process/storage policy in a narrow adapter with explicit errors and tests for its actual production path.
Load only relevant references: host injection and facades, theme/orientation/monitors, plugin translations, motion and reduced motion, process and state, or external-data review boundaries.
For a theme problem, fix the consumer or shared theme source that owns it. Verify affected behavior with fixtures and required repository checks; report Qt imports and live lifecycle as unrun unless observed on the target host.