MiaCode

Repository-specific guide for MiaCode. Use when working in this repo to locate implementations down to files, classes, and functions; trace linked behavior across document parsing, timeline, preview, audio, latency detection, Muri analysis, assets, scripts, and video export; check fixed-vs-flexible design rules; review hardcoded values and resource conventions; or update the guide after structural changes.

Repository guide for MiaCode (a Qt6/C++/QML maimai chart editor + video exporter). Use when working anywhere in this repo to locate a feature's owning files/classes/functions; understand the module layout (core/app/preview/render/audio/timeline/tools) and dependency rules; follow cross-module sync pairs (parser ↔ timeline ↔ preview ↔ export ↔ Muri); find debug flags and the --debug logging system; follow build/target/CTest/packaging conventions; or check the committed render-architecture decision (in-process QSG is the main path, DComp is off-by-default and being decoupled, the out-of-process worker has been removed). Also update this skill in the same change whenever repo structure, cross-module contracts, debug flags, or build conventions change.

Symptom→root-cause playbook for MiaCode UI layout bugs. Use WHENEVER touching dialog/window/QML-scene layout, or when the user reports 边界被吞/被截断/clipped borders, 布局不合理/controls overlap or misaligned, 层叠关系错误/wrong stacking or z-order, 1px缝隙/接缝/sliver/seam, tab 页被裁剪, dark-mode 看不清, 文本溢出, or hit-area mismatch. Distilled from ~40 commits of layout fixes (many took 2-3 iterations); ALWAYS diagnose via the routing table here BEFORE editing — never nudge per-control pixel values.