From 76774b364f2e75872b6ae3d1134932f49abfa5ce Mon Sep 17 00:00:00 2001
From: scisaga <scisaga@gmail.com>
Date: Fri, 10 Apr 2026 02:09:16 +0800
Subject: [PATCH 1/2] =?UTF-8?q?=E4=BC=98=E5=8C=96=E7=AE=A1=E7=90=86?=
 =?UTF-8?q?=E7=AB=AF=E8=AF=A6=E6=83=85=E9=A1=B5=E4=BE=A7=E6=A0=8F=E5=B8=83?=
 =?UTF-8?q?=E5=B1=80?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 static/admin.css                       |  36 ++++--
 static/admin/pages/attempt-detail.html | 148 +++++++++++++------------
 static/admin/pages/quiz-detail.html    |  66 +++++------
 static/assets/css/admin/components.css |  30 +++++
 static/public.css                      |  10 --
 5 files changed, 165 insertions(+), 125 deletions(-)

diff --git a/static/admin.css b/static/admin.css
index 8e6c944..cfec6dd 100644
--- a/static/admin.css
+++ b/static/admin.css
@@ -3312,16 +3312,6 @@
       font-size: 1.05rem;
     }
   }
-  .xl\:sticky {
-    @media (width >= 80rem) {
-      position: sticky;
-    }
-  }
-  .xl\:top-6 {
-    @media (width >= 80rem) {
-      top: calc(var(--spacing) * 6);
-    }
-  }
   .xl\:hidden {
     @media (width >= 80rem) {
       display: none;
@@ -3678,6 +3668,12 @@
     position: relative;
     min-width: 0;
   }
+  .admin-sticky-aside {
+    min-width: 0;
+  }
+  .admin-sticky-aside__body {
+    min-width: 0;
+  }
   .admin-subsurface {
     border-color: rgba(37, 99, 235, 0.12);
     box-shadow: 0 14px 30px rgba(15, 23, 42, 0.05);
@@ -3791,6 +3787,26 @@
     width: 6.5rem;
     height: 6.5rem;
   }
+  @media (min-width: 1280px) {
+    .admin-sticky-aside {
+      position: sticky;
+      top: 1.5rem;
+      display: flex;
+      max-height: calc(100vh - 3rem);
+      flex-direction: column;
+      overflow: hidden;
+      align-self: flex-start;
+    }
+    .admin-sticky-aside__body {
+      flex: 1 1 auto;
+      min-height: 0;
+      overflow-y: auto;
+      overscroll-behavior: contain;
+      scrollbar-gutter: stable;
+      padding-right: 0.35rem;
+      margin-right: -0.35rem;
+    }
+  }
   .assignment-surface {
     position: relative;
     isolation: isolate;
diff --git a/static/admin/pages/attempt-detail.html b/static/admin/pages/attempt-detail.html
index 013c379..eda1a94 100644
--- a/static/admin/pages/attempt-detail.html
+++ b/static/admin/pages/attempt-detail.html
@@ -151,102 +151,104 @@ <h2 class="text-xl font-semibold tracking-[-0.03em] text-slate-900">答题回放
 
             <section
               x-show="adminCompactPanelVisible('attempt-detail', 'evaluation')"
-              class="admin-surface self-start rounded-3xl border border-white/70 bg-white/82 p-5 shadow-[var(--admin-shadow)] backdrop-blur-xl xl:sticky xl:top-6"
+              class="admin-surface admin-sticky-aside rounded-3xl border border-white/70 bg-white/82 p-5 shadow-[var(--admin-shadow)] backdrop-blur-xl"
             >
               <div>
                 <h2 class="text-xl font-semibold tracking-[-0.03em] text-slate-900">智能评价</h2>
                 <p class="mt-1 text-sm text-slate-600">汇总总分、主倾向、综合分析和候选人简评。</p>
               </div>
 
-              <div class="mt-5 grid gap-3">
-                <div class="grid gap-3 sm:grid-cols-2">
-                  <div x-show="attemptEvaluationShowScore()" class="rounded-[1.1rem] border border-blue-100 bg-blue-50/55 px-4 py-3">
-                    <div class="text-[12px] font-semibold uppercase tracking-[0.18em] text-blue-700">总分</div>
-                    <div class="mt-2 text-2xl font-black tracking-[-0.04em] text-slate-900" x-text="attemptReviewEvaluation().score_display || '-'"></div>
-                  </div>
-                  <div class="rounded-[1.1rem] border border-slate-200 bg-slate-50/80 px-4 py-3">
-                    <div class="text-[12px] font-semibold uppercase tracking-[0.18em] text-slate-500">结果模式</div>
-                    <div class="mt-2 text-lg font-bold tracking-[-0.03em] text-slate-900" x-text="attemptEvaluationResultModeLabel()"></div>
+              <div class="admin-sticky-aside__body">
+                <div class="mt-5 grid gap-3">
+                  <div class="grid gap-3 sm:grid-cols-2">
+                    <div x-show="attemptEvaluationShowScore()" class="rounded-[1.1rem] border border-blue-100 bg-blue-50/55 px-4 py-3">
+                      <div class="text-[12px] font-semibold uppercase tracking-[0.18em] text-blue-700">总分</div>
+                      <div class="mt-2 text-2xl font-black tracking-[-0.04em] text-slate-900" x-text="attemptReviewEvaluation().score_display || '-'"></div>
+                    </div>
+                    <div class="rounded-[1.1rem] border border-slate-200 bg-slate-50/80 px-4 py-3">
+                      <div class="text-[12px] font-semibold uppercase tracking-[0.18em] text-slate-500">结果模式</div>
+                      <div class="mt-2 text-lg font-bold tracking-[-0.03em] text-slate-900" x-text="attemptEvaluationResultModeLabel()"></div>
+                    </div>
                   </div>
-                </div>
 
-                <div x-show="attemptEvaluationPrimaryDimensions().length" class="border-t border-slate-200/80 pt-4">
-                  <div class="text-[12px] font-semibold uppercase tracking-[0.18em] text-sky-700">主倾向</div>
-                  <div class="mt-3 flex flex-wrap gap-2">
-                    <template x-for="dimension in attemptEvaluationPrimaryDimensions()" :key="dimension">
-                      <span :style="traitBadgeStyle(dimension)" class="rounded-full border px-3 py-1 text-xs font-semibold" x-text="dimension"></span>
-                    </template>
+                  <div x-show="attemptEvaluationPrimaryDimensions().length" class="border-t border-slate-200/80 pt-4">
+                    <div class="text-[12px] font-semibold uppercase tracking-[0.18em] text-sky-700">主倾向</div>
+                    <div class="mt-3 flex flex-wrap gap-2">
+                      <template x-for="dimension in attemptEvaluationPrimaryDimensions()" :key="dimension">
+                        <span :style="traitBadgeStyle(dimension)" class="rounded-full border px-3 py-1 text-xs font-semibold" x-text="dimension"></span>
+                      </template>
+                    </div>
                   </div>
-                </div>
 
-                <div x-show="attemptEvaluationTraitPairs().length" class="border-t border-slate-200/80 pt-4">
-                  <div class="text-sm font-semibold text-slate-900">维度对照</div>
-                  <div class="mt-3 divide-y divide-slate-200/80">
-                    <template x-for="pair in attemptEvaluationTraitPairs()" :key="`${pair.left || ''}-${pair.right || ''}`">
-                      <div class="py-3 first:pt-0 last:pb-0">
-                        <div class="flex items-start justify-between gap-3">
-                          <div>
-                            <div class="text-sm font-semibold tabular-nums text-slate-800" x-text="`${pair.left || '-'} ${pair.left_score || 0} / ${pair.right || '-'} ${pair.right_score || 0}`"></div>
-                            <div class="mt-1 text-xs leading-5 text-slate-500" x-text="pair.description || '按对立维度对照输出主倾向。'"></div>
+                  <div x-show="attemptEvaluationTraitPairs().length" class="border-t border-slate-200/80 pt-4">
+                    <div class="text-sm font-semibold text-slate-900">维度对照</div>
+                    <div class="mt-3 divide-y divide-slate-200/80">
+                      <template x-for="pair in attemptEvaluationTraitPairs()" :key="`${pair.left || ''}-${pair.right || ''}`">
+                        <div class="py-3 first:pt-0 last:pb-0">
+                          <div class="flex items-start justify-between gap-3">
+                            <div>
+                              <div class="text-sm font-semibold tabular-nums text-slate-800" x-text="`${pair.left || '-'} ${pair.left_score || 0} / ${pair.right || '-'} ${pair.right_score || 0}`"></div>
+                              <div class="mt-1 text-xs leading-5 text-slate-500" x-text="pair.description || '按对立维度对照输出主倾向。'"></div>
+                            </div>
+                            <span :style="traitBadgeStyle(pair.winner || '')" class="rounded-full border px-2.5 py-1 text-[11px] font-semibold" x-text="pair.winner || '-'"></span>
                           </div>
-                          <span :style="traitBadgeStyle(pair.winner || '')" class="rounded-full border px-2.5 py-1 text-[11px] font-semibold" x-text="pair.winner || '-'"></span>
                         </div>
-                      </div>
-                    </template>
+                      </template>
+                    </div>
                   </div>
-                </div>
 
-                <div x-show="!attemptEvaluationTraitPairs().length && attemptEvaluationDimensionList().length" class="border-t border-slate-200/80 pt-4">
-                  <div class="text-sm font-semibold text-slate-900">维度累计</div>
-                  <div class="mt-3 divide-y divide-slate-200/80">
-                    <template x-for="item in attemptEvaluationDimensionList()" :key="item.dimension || ''">
-                      <div class="py-3 first:pt-0 last:pb-0">
-                        <div class="flex items-center justify-between gap-3">
-                          <span class="text-sm font-semibold text-slate-800" x-text="item.dimension || '-'"></span>
-                          <span class="text-sm font-bold text-slate-900" x-text="item.score || 0"></span>
+                  <div x-show="!attemptEvaluationTraitPairs().length && attemptEvaluationDimensionList().length" class="border-t border-slate-200/80 pt-4">
+                    <div class="text-sm font-semibold text-slate-900">维度累计</div>
+                    <div class="mt-3 divide-y divide-slate-200/80">
+                      <template x-for="item in attemptEvaluationDimensionList()" :key="item.dimension || ''">
+                        <div class="py-3 first:pt-0 last:pb-0">
+                          <div class="flex items-center justify-between gap-3">
+                            <span class="text-sm font-semibold text-slate-800" x-text="item.dimension || '-'"></span>
+                            <span class="text-sm font-bold text-slate-900" x-text="item.score || 0"></span>
+                          </div>
+                          <div class="mt-1 text-xs leading-5 text-slate-500" x-text="item.meaning || '当前维度暂无额外说明。'"></div>
                         </div>
-                        <div class="mt-1 text-xs leading-5 text-slate-500" x-text="item.meaning || '当前维度暂无额外说明。'"></div>
-                      </div>
-                    </template>
+                      </template>
+                    </div>
                   </div>
-                </div>
 
-                <div x-show="attemptReviewEvaluation().final_analysis" class="border-t border-slate-200/80 pt-4">
-                  <div class="text-sm font-semibold text-emerald-800">综合分析</div>
-                  <div class="mt-2 whitespace-pre-line text-sm leading-6 text-slate-700" x-text="attemptReviewEvaluation().final_analysis"></div>
-                </div>
+                  <div x-show="attemptReviewEvaluation().final_analysis" class="border-t border-slate-200/80 pt-4">
+                    <div class="text-sm font-semibold text-emerald-800">综合分析</div>
+                    <div class="mt-2 whitespace-pre-line text-sm leading-6 text-slate-700" x-text="attemptReviewEvaluation().final_analysis"></div>
+                  </div>
 
-                <div x-show="attemptReviewEvaluation().candidate_remark" class="border-t border-slate-200/80 pt-4">
-                  <div class="text-sm font-semibold text-blue-800">候选人简评</div>
-                  <div class="mt-2 whitespace-pre-line text-sm leading-6 text-slate-700" x-text="attemptReviewEvaluation().candidate_remark"></div>
-                </div>
+                  <div x-show="attemptReviewEvaluation().candidate_remark" class="border-t border-slate-200/80 pt-4">
+                    <div class="text-sm font-semibold text-blue-800">候选人简评</div>
+                    <div class="mt-2 whitespace-pre-line text-sm leading-6 text-slate-700" x-text="attemptReviewEvaluation().candidate_remark"></div>
+                  </div>
 
-                <div
-                  x-show="assignmentStatusValue(attemptDetail.quiz_paper) === 'grading' && !attemptEvaluationHasContent()"
-                  class="grading-placeholder rounded-[1.1rem] border border-dashed border-amber-200 bg-amber-50/70 px-4 py-5"
-                >
-                  <div class="grading-placeholder__hero">
-                    <div class="grading-placeholder__spinner" aria-hidden="true">
-                      <span class="material-symbols-rounded text-[20px]">grading</span>
+                  <div
+                    x-show="assignmentStatusValue(attemptDetail.quiz_paper) === 'grading' && !attemptEvaluationHasContent()"
+                    class="grading-placeholder rounded-[1.1rem] border border-dashed border-amber-200 bg-amber-50/70 px-4 py-5"
+                  >
+                    <div class="grading-placeholder__hero">
+                      <div class="grading-placeholder__spinner" aria-hidden="true">
+                        <span class="material-symbols-rounded text-[20px]">grading</span>
+                      </div>
+                      <div>
+                        <div class="text-sm font-semibold text-amber-800">正在判卷</div>
+                        <p class="mt-2 text-sm leading-6 text-amber-700/90">系统正在汇总题目得分和大模型分析，完成后这里会自动显示总分、主倾向和综合评价。</p>
+                      </div>
                     </div>
-                    <div>
-                      <div class="text-sm font-semibold text-amber-800">正在判卷</div>
-                      <p class="mt-2 text-sm leading-6 text-amber-700/90">系统正在汇总题目得分和大模型分析，完成后这里会自动显示总分、主倾向和综合评价。</p>
+                    <div class="grading-placeholder__bars" aria-hidden="true">
+                      <span class="grading-placeholder__bar grading-placeholder__bar--primary"></span>
+                      <span class="grading-placeholder__bar grading-placeholder__bar--secondary"></span>
+                      <span class="grading-placeholder__bar grading-placeholder__bar--tertiary"></span>
                     </div>
                   </div>
-                  <div class="grading-placeholder__bars" aria-hidden="true">
-                    <span class="grading-placeholder__bar grading-placeholder__bar--primary"></span>
-                    <span class="grading-placeholder__bar grading-placeholder__bar--secondary"></span>
-                    <span class="grading-placeholder__bar grading-placeholder__bar--tertiary"></span>
-                  </div>
-                </div>
 
-                <div
-                  x-show="assignmentStatusValue(attemptDetail.quiz_paper) !== 'grading' && !attemptEvaluationHasContent()"
-                  class="rounded-[1.1rem] border border-dashed border-slate-200 bg-slate-50/80 px-4 py-5"
-                >
-                  <div class="text-sm font-semibold text-slate-700">当前暂无评价摘要</div>
-                  <p class="mt-2 text-sm leading-6 text-slate-500">该记录尚未生成可展示的综合分析；如果刚完成判卷，刷新后会自动补齐。</p>
+                  <div
+                    x-show="assignmentStatusValue(attemptDetail.quiz_paper) !== 'grading' && !attemptEvaluationHasContent()"
+                    class="rounded-[1.1rem] border border-dashed border-slate-200 bg-slate-50/80 px-4 py-5"
+                  >
+                    <div class="text-sm font-semibold text-slate-700">当前暂无评价摘要</div>
+                    <p class="mt-2 text-sm leading-6 text-slate-500">该记录尚未生成可展示的综合分析；如果刚完成判卷，刷新后会自动补齐。</p>
+                  </div>
                 </div>
               </div>
             </section>
diff --git a/static/admin/pages/quiz-detail.html b/static/admin/pages/quiz-detail.html
index 49448f8..cbe29a1 100644
--- a/static/admin/pages/quiz-detail.html
+++ b/static/admin/pages/quiz-detail.html
@@ -240,7 +240,7 @@ <h3 class="mt-1 text-lg font-semibold tracking-[-0.03em] text-slate-900">按题
 
             <section
               x-show="adminCompactPanelVisible('quiz-detail', 'history')"
-              class="admin-surface self-start rounded-3xl border border-white/70 bg-white/82 p-5 shadow-[var(--admin-shadow)] backdrop-blur-xl xl:sticky xl:top-6"
+              class="admin-surface admin-sticky-aside rounded-3xl border border-white/70 bg-white/82 p-5 shadow-[var(--admin-shadow)] backdrop-blur-xl"
             >
               <div class="flex items-start justify-between gap-3">
                 <div>
@@ -253,42 +253,44 @@ <h2 class="text-xl font-semibold tracking-[-0.03em] text-slate-900">版本历史
                 </div>
               </div>
 
-              <div class="mt-4 space-y-3">
-                <template x-for="version in quizDetail.quiz_version_history || []" :key="version.id">
-                  <button
-                    type="button"
-                    @click="loadQuizVersion(version.id)"
-                    :class="version.is_selected ? 'border-blue-300 bg-blue-50/70 shadow-[0_12px_28px_rgba(37,99,235,0.10)]' : 'border-blue-100 bg-white hover:border-blue-200 hover:bg-blue-50/40'"
-                    class="w-full rounded-xl border p-4 text-left transition"
-                  >
-                    <div class="flex items-start justify-between gap-3">
-                      <div class="min-w-0">
-                        <div class="flex flex-wrap items-center gap-2">
-                          <div class="font-semibold text-slate-900">版本 <span x-text="version.version_no || version.id"></span></div>
-                          <span x-show="version.is_current" class="rounded-full border border-emerald-200 bg-emerald-50 px-2.5 py-1 text-[11px] font-semibold text-emerald-700">当前</span>
-                          <span x-show="version.is_selected && !version.is_current" class="rounded-full border border-blue-200 bg-white px-2.5 py-1 text-[11px] font-semibold text-blue-700">已选</span>
+              <div class="admin-sticky-aside__body">
+                <div class="mt-4 space-y-3">
+                  <template x-for="version in quizDetail.quiz_version_history || []" :key="version.id">
+                    <button
+                      type="button"
+                      @click="loadQuizVersion(version.id)"
+                      :class="version.is_selected ? 'border-blue-300 bg-blue-50/70 shadow-[0_12px_28px_rgba(37,99,235,0.10)]' : 'border-blue-100 bg-white hover:border-blue-200 hover:bg-blue-50/40'"
+                      class="w-full rounded-xl border p-4 text-left transition"
+                    >
+                      <div class="flex items-start justify-between gap-3">
+                        <div class="min-w-0">
+                          <div class="flex flex-wrap items-center gap-2">
+                            <div class="font-semibold text-slate-900">版本 <span x-text="version.version_no || version.id"></span></div>
+                            <span x-show="version.is_current" class="rounded-full border border-emerald-200 bg-emerald-50 px-2.5 py-1 text-[11px] font-semibold text-emerald-700">当前</span>
+                            <span x-show="version.is_selected && !version.is_current" class="rounded-full border border-blue-200 bg-white px-2.5 py-1 text-[11px] font-semibold text-blue-700">已选</span>
+                          </div>
+                          <div class="mt-2 break-all font-mono text-[11px] leading-5 text-slate-500" x-text="version.git_commit || '-'"></div>
                         </div>
-                        <div class="mt-2 break-all font-mono text-[11px] leading-5 text-slate-500" x-text="version.git_commit || '-'"></div>
+                        <span class="material-symbols-rounded text-slate-400" x-text="version.is_selected ? 'visibility' : 'chevron_right'"></span>
                       </div>
-                      <span class="material-symbols-rounded text-slate-400" x-text="version.is_selected ? 'visibility' : 'chevron_right'"></span>
-                    </div>
 
-                    <div class="mt-3 space-y-2 text-xs leading-5 text-slate-500">
-                      <div x-show="version.source_path" class="break-all">
-                        <span class="font-semibold text-slate-600">文件：</span>
-                        <span x-text="version.source_path"></span>
-                      </div>
-                      <div x-show="version.created_at">
-                        <span class="font-semibold text-slate-600">创建时间：</span>
-                        <span x-text="formatDateTime(version.created_at)"></span>
+                      <div class="mt-3 space-y-2 text-xs leading-5 text-slate-500">
+                        <div x-show="version.source_path" class="break-all">
+                          <span class="font-semibold text-slate-600">文件：</span>
+                          <span x-text="version.source_path"></span>
+                        </div>
+                        <div x-show="version.created_at">
+                          <span class="font-semibold text-slate-600">创建时间：</span>
+                          <span x-text="formatDateTime(version.created_at)"></span>
+                        </div>
                       </div>
-                    </div>
-                  </button>
-                </template>
-              </div>
+                    </button>
+                  </template>
+                </div>
 
-              <div x-show="!(quizDetail.quiz_version_history || []).length" class="mt-4 rounded-xl border border-dashed border-slate-200 bg-slate-50/70 px-4 py-6 text-center text-sm text-slate-500">
-                暂无版本历史
+                <div x-show="!(quizDetail.quiz_version_history || []).length" class="mt-4 rounded-xl border border-dashed border-slate-200 bg-slate-50/70 px-4 py-6 text-center text-sm text-slate-500">
+                  暂无版本历史
+                </div>
               </div>
             </section>
           </div>
diff --git a/static/assets/css/admin/components.css b/static/assets/css/admin/components.css
index 04d2450..02c7951 100644
--- a/static/assets/css/admin/components.css
+++ b/static/assets/css/admin/components.css
@@ -135,6 +135,14 @@
     min-width: 0;
   }
 
+  .admin-sticky-aside {
+    min-width: 0;
+  }
+
+  .admin-sticky-aside__body {
+    min-width: 0;
+  }
+
   .admin-subsurface {
     border-color: rgba(37, 99, 235, 0.12);
     box-shadow: 0 14px 30px rgba(15, 23, 42, 0.05);
@@ -270,6 +278,28 @@
     height: 6.5rem;
   }
 
+  @media (min-width: 1280px) {
+    .admin-sticky-aside {
+      position: sticky;
+      top: 1.5rem;
+      display: flex;
+      max-height: calc(100vh - 3rem);
+      flex-direction: column;
+      overflow: hidden;
+      align-self: flex-start;
+    }
+
+    .admin-sticky-aside__body {
+      flex: 1 1 auto;
+      min-height: 0;
+      overflow-y: auto;
+      overscroll-behavior: contain;
+      scrollbar-gutter: stable;
+      padding-right: 0.35rem;
+      margin-right: -0.35rem;
+    }
+  }
+
   .assignment-surface {
     position: relative;
     isolation: isolate;
diff --git a/static/public.css b/static/public.css
index beaf369..915618a 100644
--- a/static/public.css
+++ b/static/public.css
@@ -3312,16 +3312,6 @@
       font-size: 1.05rem;
     }
   }
-  .xl\:sticky {
-    @media (width >= 80rem) {
-      position: sticky;
-    }
-  }
-  .xl\:top-6 {
-    @media (width >= 80rem) {
-      top: calc(var(--spacing) * 6);
-    }
-  }
   .xl\:hidden {
     @media (width >= 80rem) {
       display: none;

From b46e38bde22eed98c25abc15dc106053c2b1d0d1 Mon Sep 17 00:00:00 2001
From: scisaga <scisaga@gmail.com>
Date: Fri, 10 Apr 2026 02:24:33 +0800
Subject: [PATCH 2/2] =?UTF-8?q?=E4=BF=AE=E5=A4=8D=E7=A7=BB=E5=8A=A8?=
 =?UTF-8?q?=E7=AB=AF=E5=AF=BC=E8=88=AA=E5=B9=B6=E5=90=8C=E6=AD=A5=E6=8A=80?=
 =?UTF-8?q?=E8=83=BD=E6=96=87=E6=A1=A3?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 skills/qml-authoring/SKILL.md                     | 2 +-
 skills/quiz-repo-spec/references/repo-contract.md | 2 ++
 static/admin.css                                  | 4 ++--
 static/admin/index.html                           | 7 ++++++-
 static/assets/css/admin/components.css            | 2 +-
 5 files changed, 12 insertions(+), 5 deletions(-)

diff --git a/skills/qml-authoring/SKILL.md b/skills/qml-authoring/SKILL.md
index 0b91b36..71d23fb 100644
--- a/skills/qml-authoring/SKILL.md
+++ b/skills/qml-authoring/SKILL.md
@@ -15,7 +15,7 @@ description: Use this skill when authoring, reviewing, fixing, or documenting QM
 - 维护 traits 量表问卷的维度说明、分析建议与 Front Matter 解释口径
 - 维护问卷 `intro` / `outro` 图片及其展示约定
 - 排查 QML 解析错误
-- 更新 QML 规范文档或 QML 示例
+- 更新 `qml.md` 或 QML 示例
 - 评审 QML 语法与 parser 行为是否一致
 
 ## 工作流
diff --git a/skills/quiz-repo-spec/references/repo-contract.md b/skills/quiz-repo-spec/references/repo-contract.md
index 7c9e11f..9515817 100644
--- a/skills/quiz-repo-spec/references/repo-contract.md
+++ b/skills/quiz-repo-spec/references/repo-contract.md
@@ -24,6 +24,7 @@
 
 - 必须存在 `md-quiz-repo.yaml`
 - 必须存在 `README.md`
+- 新增、删除或重命名 quiz 后，必须同步更新 `md-quiz-repo.yaml` 与 `README.md`
 - 不再支持根目录散落 `*.md`
 
 ### manifest 要求
@@ -44,6 +45,7 @@ quizzes:
 - `quizzes` 必须是非空列表
 - 每个 `path` 只能是 `quizzes/<quiz_id>/quiz.md`
 - `path` 不能重复，不能越界，必须真实存在
+- 新增或删除 quiz 时，`quizzes` 列表必须同步反映实际仓库内容
 - 当前仓库规范版本号与 QML 头部推荐的 `schema_version: 2` / `format: qml-v2` 保持同一代际
 
 ## Quiz 目录规则
diff --git a/static/admin.css b/static/admin.css
index cfec6dd..acc687b 100644
--- a/static/admin.css
+++ b/static/admin.css
@@ -3694,7 +3694,7 @@
   }
   .admin-primary-nav__track {
     display: grid;
-    grid-template-columns: repeat(5, minmax(0, 1fr));
+    grid-template-columns: repeat(var(--admin-primary-nav-columns, 5), minmax(0, 1fr));
     gap: 0.45rem;
     border-radius: 1rem;
     border: 1px solid rgba(37, 99, 235, 0.14);
@@ -4877,4 +4877,4 @@
       --tw-translate-z: 0;
     }
   }
-}
\ No newline at end of file
+}
diff --git a/static/admin/index.html b/static/admin/index.html
index 00c0d7f..49b9337 100644
--- a/static/admin/index.html
+++ b/static/admin/index.html
@@ -120,7 +120,12 @@ <h1 class="mt-1 truncate text-3xl font-semibold tracking-[-0.04em] text-slate-90
 
             <div x-show="isAdminCompactLayout" x-cloak class="admin-mobile-nav-shell md:hidden">
               <div class="admin-primary-nav">
-                <div class="admin-primary-nav__track" role="navigation" aria-label="后台主导航">
+                <div
+                  class="admin-primary-nav__track"
+                  role="navigation"
+                  aria-label="后台主导航"
+                  :style="{ '--admin-primary-nav-columns': navItems.length }"
+                >
                   <template x-for="item in navItems" :key="'compact-' + item.href">
                     <button
                       type="button"
diff --git a/static/assets/css/admin/components.css b/static/assets/css/admin/components.css
index 02c7951..7afcc00 100644
--- a/static/assets/css/admin/components.css
+++ b/static/assets/css/admin/components.css
@@ -167,7 +167,7 @@
 
   .admin-primary-nav__track {
     display: grid;
-    grid-template-columns: repeat(5, minmax(0, 1fr));
+    grid-template-columns: repeat(var(--admin-primary-nav-columns, 5), minmax(0, 1fr));
     gap: 0.45rem;
     border-radius: 1rem;
     border: 1px solid rgba(37, 99, 235, 0.14);