docs: add AI-friendly repository navigation

2026-08-30 19:43:54 +08:00
parent b74e905870
commit e22b960b6c
7 changed files with 435 additions and 2 deletions
@@ -0,0 +1,41 @@
+# Experiment result registry
+
+Each child directory is an immutable result record. Exact metrics, protocol,
+raw console output and caveats live in that directory; this page only routes
+readers to the right comparison.
+
+| Result record | Question answered |
+|---|---|
+| [`easycom_open_stream_vs_causal_prefix_2026-08-19/`](easycom_open_stream_vs_causal_prefix_2026-08-19/README.md) | How prepared-media open-stream and causal-prefix features compare |
+| [`easycom_open_stream_8s_vs_20s_2026-08-23/`](easycom_open_stream_8s_vs_20s_2026-08-23/README.md) | Frozen open-stream context-length comparison |
+| [`easycom_sparse_supervision_vs_lora_2026-08-24/`](easycom_sparse_supervision_vs_lora_2026-08-24/README.md) | Sparse supervision versus LoRA comparison |
+| [`easycom_omni_lora_sparse_epoch2_2026-08-24/`](easycom_omni_lora_sparse_epoch2_2026-08-24/README.md) | Sparse epoch-2 LoRA result and provenance |
+| [`easycom_frozen_3b_8s_last4_learned_mix_2026-08-26/`](easycom_frozen_3b_8s_last4_learned_mix_2026-08-26/README.md) | Learned last-four-layer mixture ablation |
+| [`easycom_loss_structure_4ep_2026-08-26/`](easycom_loss_structure_4ep_2026-08-26/README.md) | LSTR-MCE versus independent BCE versus four-state CE |
+| [`easycom_transition_auxiliary_4ep_2026-08-27/`](easycom_transition_auxiliary_4ep_2026-08-27/README.md) | Supervised transition head and expected-reward objectives |
+| [`easycom_encoder_only_1s_4ep_2026-08-28/`](easycom_encoder_only_1s_4ep_2026-08-28/README.md) | Encoder-only A/V/AV versus global-Thinker local-feature baselines |
+
+## Interpretation rules
+
+- Do not compare full-timeline and causal-valid metrics without naming the
+  protocol.
+- A single seed is preliminary even when its absolute improvement is large.
+- Framewise mAP is retained for EgoSpeak comparability; it does not prove
+  correct floor-entry/yield behavior.
+- `G+A+V > G+A` does not prove visual speaker grounding unless correct visual
+  alignment also beats wrong-person/time-shift controls.
+- Historical transition-auxiliary results concern generic label changes, not
+  the new scenario-conditioned wearer entry/yield objective.
+
+## Required contents for a new result record
+
+```text
+results/<dataset>_<question>_<date>/
+  README.md       # hypothesis, command/config, split, seeds, interpretation
+  summary.json    # machine-readable aggregate and provenance
+  metrics.csv     # when a tabular comparison exists
+  raw_console.txt # optional but recommended
+```
+
+Never overwrite a dated record with a new protocol. Create another directory
+and link the relationship from both READMEs.