diff options
Diffstat (limited to 'AGENTS.md')
| -rw-r--r-- | AGENTS.md | 19 |
1 files changed, 18 insertions, 1 deletions
@@ -19,6 +19,7 @@ modules. island/ top-centre pills on DP-1: clock, volume, tray, layout, privacy, calendar, OBS assistant/ the assistant canvas on SUPER+Home, a view over desktop-assistant + companion/ a chibi 2B, bottom-right of the focused monitor, on SUPER+\ window-switcher/ expose: open windows scattered as live previews, on ALT+TAB or the top-right hot corner of DP-1 keybinds/ live keybind reminder, on SUPER+k @@ -207,6 +208,12 @@ changing that component. The ones that generalise: `Settings.qml`, which imports Controls, `Button { icon: ... }` became the Controls button and logged `Unable to assign QString to QQuickIcon`. A file that imports Controls builds its buttons from a `Rectangle` instead. +- **Plain `import QtQuick` shadows a directory's own `Sprite.qml` too.** + QtQuick ships a `Sprite` type (for `AnimatedSprite`), and an explicit + import beats the implicit directory one, so the companion's `Sprite { + onSettled: ... }` failed with `Cannot assign to non-existent property + "onSettled"` and took the whole desktop shell down on restart. It is + `Figure.qml`. Before naming a component, check it is not a QtQuick type. - **`FloatingWindow.maximized` works under Hyprland.** Setting it fills the monitor and clearing it restores the old size, checked by eye; the settings window's titlebar row uses it, since Hyprland draws no decorations. @@ -383,7 +390,10 @@ changing that component. The ones that generalise: the loaded model answers 400 `model is already running`, and an unknown id 404; both measured. With `--models-max 1` a load swaps out the resident model for every client, so the assistant page does it only on a - click. + click. `POST /models/unload` with the same body frees it (answers + `{"success":true}`, measured); the next request for it loads it again. + `sd-webui` unloads whatever is loaded before starting sd-server: a resident + Gemma left Pony 1.1 GB of 12 GB and its first step failed. - **`busctl get-property` escapes non-ASCII as octal.** A name with an accented letter reads `s "Do\303\250r"`-style, which no shell builtin decodes. `busctl --json=short` returns real UTF-8; `userctl` pipes it @@ -489,6 +499,13 @@ correct and a fresh `qs` process rendered it. Force the rescan by changing a file that imports the directory (`desktop/shell.qml`), or restart the shell. Touch alone does not reload: the content must change. +Changing `desktop/shell.qml` can fail on a type it did not touch. Twice in +one session, an edit adding an import to it hot-reloaded into `Failed to +load configuration`, `UdtModule is not a type` and then `SunsetModule is +not a type`, both existing modules in `modules/appearance/` that a fresh +process resolved fine. The old config kept running; `./reload.sh desktop` +loaded the new one cleanly. Expect a restart after any `shell.qml` edit. + Switching git branches under a running shell can drop a component until a restart. Merging the island branch meant a moment on master without `desktop/island/`; the shell hot-reloaded then, logged `Ignoring unresolvable |