Document today's config-path, window-chrome and tooling gotchas
AGENTS.md gains the rules the day's debugging produced: never put the config in the install dir (the build script wipes it, silently costing all local-only fields), never branch app_dir() on sys.frozen (two diverging configs), the consequences that come with a frameless window, and why the resize grip must be placed rather than packed. Also records that Claude's Bash and PowerShell tools can see different files under AppData, which made "the notes are in the file" and "the app shows no notes" both true at once -- with the diagnostic-module approach that finally settled it. README: config now lives in %APPDATA%\VersaPadViewer, plus the frameless window and notes in the feature list.
This commit is contained in:
parent
91bac353b4
commit
9464cafaab
2 changed files with 85 additions and 9 deletions
27
README.md
27
README.md
|
|
@ -12,9 +12,9 @@ echtes Board getestet (Read-Modify-Write ist byte-identisch zum Original,
|
|||
inklusive CRC). Nicht vorhanden: automatisierte Tests (Verifikation läuft
|
||||
manuell gegen ein angeschlossenes Board), eine vorgefertigte `.exe` zum
|
||||
Download (siehe unten, warum), und Mehrbenutzer-/Netzwerkbetrieb. Die eigene
|
||||
Config-Datei (`versapad_config_all.json`) liegt automatisch neben der
|
||||
Installation (siehe „Aufbau" unten) und wird bei Bedarf automatisch neu
|
||||
angelegt — kein manuelles Pfad-Anpassen mehr nötig. Nur die *optionale*
|
||||
Config-Datei (`versapad_config_all.json`) liegt automatisch unter
|
||||
`%APPDATA%\VersaPadViewer\` (siehe „Aufbau" unten) und wird bei Bedarf
|
||||
automatisch neu angelegt — kein manuelles Pfad-Anpassen mehr nötig. Nur die *optionale*
|
||||
Lese-Interop mit den JSON-Exports der offiziellen VersaGUI
|
||||
(`versapad_data.CONFIG_PATHS`) ist noch für eine bestimmte Windows-Maschine
|
||||
hartkodiert (OneDrive-Desktop) — für einen anderen Rechner dort anpassen,
|
||||
|
|
@ -41,6 +41,11 @@ falls gewünscht.
|
|||
Tool-Aufruf ändern, ohne Klicks in der GUI (siehe unten)
|
||||
- **Tray-Icon** — minimiert/schließt ins Tray statt in die Taskleiste, wie
|
||||
die offizielle VersaGUI
|
||||
- **Randloses Fenster** — ohne Windows-Titelleiste, dafür kompakter Kopf
|
||||
(Modus-Checkboxen direkt neben dem Titel). Verschieben durch Ziehen an
|
||||
der Kopfzeile, Größe ändern am Anfasser unten rechts, `✕`/`—` legen ins
|
||||
Tray. Einen Taskleisten-Eintrag gibt es dadurch nicht — das Fenster kommt
|
||||
über das Tray-Icon zurück.
|
||||
|
||||
## Voraussetzungen
|
||||
|
||||
|
|
@ -111,14 +116,20 @@ VersaMCU-Firmware-Quellen übernommen und gegen ein echtes Board validiert
|
|||
(Read → unpack → pack ist bytegenau identisch zum Original, inklusive CRC).
|
||||
|
||||
Die eigene Config-Datei (`versapad_config_all.json` — alle 3 Profile +
|
||||
Makros + lokale Profilnamen, siehe `versapad_combined.py`) liegt neben der
|
||||
Installation: bei der gebauten `.exe` im selben Ordner, beim Start aus dem
|
||||
Quellcode im Projektordner (`versapad_data.app_dir()`). Fehlt sie (z.B.
|
||||
frische Installation), wird sie automatisch angelegt — per Serial vom
|
||||
Makros + lokale Profilnamen + Notizen, siehe `versapad_combined.py`) liegt
|
||||
unter `%APPDATA%\VersaPadViewer\` (`versapad_data.app_dir()`), also
|
||||
**getrennt vom Installationsordner** und unabhängig davon, ob die `.exe`
|
||||
oder der Quellcode gestartet wurde. Beides ist Absicht: das Build-Skript
|
||||
räumt sein Zielverzeichnis vor jedem Deploy komplett ab (läge die Config
|
||||
dort, würde jeder Rebuild sie löschen), und ein vom Startweg abhängiger
|
||||
Pfad hatte zu zwei auseinanderlaufenden Configs geführt. Fehlt die Datei
|
||||
(z.B. frische Installation), wird sie automatisch angelegt — per Serial vom
|
||||
Board, falls eins angeschlossen ist, sonst als leere Default-Config.
|
||||
Profilnamen (`profile_names`) stehen direkt in dieser Datei und lassen sich
|
||||
per Doppelklick auf einen Tab (in jedem Modus — Nur-Lesen, Live-Sync oder
|
||||
Programmiermodus) oder `rename_profile()` (MCP) ändern.
|
||||
Programmiermodus) oder `rename_profile()` (MCP) ändern. Notizen ebenso —
|
||||
im Bearbeiten-Dialog des Programmiermodus oder per
|
||||
`set_button_note()`/`set_encoder_note()` (MCP).
|
||||
|
||||
Die klassischen `versapad_config1/2/3.json` sind kein von diesem Tool
|
||||
geschriebenes Format, sondern optionale Lese-Interop mit einem JSON-Export
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue