eduevidence 5.2.0 → 6.2.0

package/visualization/eduevidence-report/scripts/zh_labels.py

@@ -207,9 +207,16 @@ def label(lang: str, kind: str, value: str) -> str:
         return value
     if value in table:
         return table[value]
-    lowered = value.lower()
+    lowered = str(value).lower()
     if lowered in table:
         return table[lowered]
+    # Unregistered enum: still render as prose rather than leaking the storage
+    # form ("no_ai_coding_assistant_control") into the report or a chart label.
+    if isinstance(value, str) and "_" in value:
+        generic = GENERIC_ENUM_ZH if lang == "zh" else GENERIC_ENUM_EN
+        if lowered in generic:
+            return generic[lowered]
+        return humanize_identifier(value, lang)
     return value
 
 
@@ -243,3 +250,75 @@ def zh_mode(value: str) -> str:
 
 def zh_action(value: str) -> str:
     return ACTION_ZH.get(value, value)
+
+# ---------------------------------------------------------------------------
+# Generic display hygiene
+# ---------------------------------------------------------------------------
+#: Labels shared by every renderer, so an unregistered enum never reaches the
+#: reader as a storage identifier ("first_programming_course") — it is shown as
+#: prose ("First programming course"). Curated entries win over this table.
+GENERIC_ENUM_ZH = {
+    "unknown": "未知",
+    "unknown_not_reported": "未报告",
+    "not_reported": "未报告",
+    "not_applicable": "不适用",
+    "other": "其他",
+    "general": "总体",
+}
+
+GENERIC_ENUM_EN = {
+    "unknown": "Unknown",
+    "unknown_not_reported": "Not reported",
+    "not_reported": "Not reported",
+    "not_applicable": "Not applicable",
+    "other": "Other",
+    "general": "General",
+}
+
+
+#: Lower-case tokens that must be rendered as acronyms rather than title case.
+_ACRONYMS = {
+    "ai": "AI", "rct": "RCT", "did": "DID", "llm": "LLM", "llms": "LLMs",
+    "cs1": "CS1", "cs2": "CS2", "nlp": "NLP", "irb": "IRB", "k12": "K-12",
+    "gdpr": "GDPR", "ferpa": "FERPA", "wwc": "WWC", "grade": "GRADE",
+    "prisma": "PRISMA", "ta": "TA", "url": "URL", "api": "API", "html": "HTML",
+    "css": "CSS", "js": "JS", "sql": "SQL", "pdf": "PDF", "id": "ID",
+}
+
+
+def humanize_identifier(value: str, lang: str = "en") -> str:
+    """Render an unregistered enum value as readable prose.
+
+    A curated label (see OUTCOME_ZH / STUDY_ZH / GENERIC_ENUM_*) always wins.
+    Everything else is de-underscored and capitalised so a report never shows
+    its storage format; zh keeps the original token when it is already CJK.
+    """
+    if value is None:
+        return ""
+    text = str(value).strip()
+    if not text:
+        return ""
+    curated = GENERIC_ENUM_ZH if lang == "zh" else GENERIC_ENUM_EN
+    if text in curated:
+        return curated[text]
+    lowered = text.lower()
+    if lowered in curated:
+        return curated[lowered]
+    if any("一" <= ch <= "鿿" for ch in text):
+        return text  # already prose in Chinese
+    words = [w for w in text.replace("-", " ").replace("_", " ").split() if w]
+    if not words:
+        return text
+    out = []
+    for word in words:
+        lowered_word = word.lower()
+        if lowered_word in _ACRONYMS:
+            out.append(_ACRONYMS[lowered_word])
+        elif word.isupper() and len(word) <= 6:
+            out.append(word)
+        elif word[:1].isdigit():
+            out.append(word)
+        else:
+            out.append(word[:1].upper() + word[1:])
+    return " ".join(out)
+

package/visualization/eduevidence-report/themes/academic.css

@@ -13,7 +13,7 @@
 :root[data-theme="academic"] body { font-size:15px; line-height:1.58; }
 :root[data-theme="academic"] .report-shell { max-width:980px; padding-top:22px; }
 :root[data-theme="academic"] .report-header { border-bottom:2px solid #222; margin-bottom:34px; }
-:root[data-theme="academic"] .report-header h1 { font-size:2rem; line-height:1.18; text-align:center; }
+:root[data-theme="academic"] .report-header h1 { font-size:clamp(1.5rem,2.2vw,1.7rem); line-height:1.18; text-align:center; }
 :root[data-theme="academic"] .report-header .meta { text-align:center; }
 :root[data-theme="academic"] .report-section { background:transparent; border:0; box-shadow:none; padding:0; margin-bottom:34px; }
 :root[data-theme="academic"] .report-section>h2 { font-size:1.08rem; border-bottom:1px solid #444; border-radius:0; padding:0 0 5px; }

package/visualization/eduevidence-report/themes/claude.css

@@ -12,7 +12,7 @@
 }
 :root[data-theme="claude"] .report-shell { max-width:1240px; padding-top:34px; }
 :root[data-theme="claude"] .report-header { max-width:900px; margin:0 auto 42px; padding-bottom:22px; }
-:root[data-theme="claude"] .report-header h1 { font-size:clamp(1.9rem,4vw,3rem); line-height:1.18; font-weight:500; }
+:root[data-theme="claude"] .report-header h1 { font-size:clamp(1.55rem,2.8vw,2.25rem); line-height:1.18; font-weight:500; }
 :root[data-theme="claude"] .report-section { background:transparent; border:0; box-shadow:none; padding:0; }
 :root[data-theme="claude"] .report-section>h2 { border:0; font-size:1.4rem; padding:0; margin-bottom:7px; }
 :root[data-theme="claude"] .section-lead { background:transparent; border:0; padding:0; max-width:760px; margin-bottom:24px; }

package/visualization/eduevidence-report/themes/datalab-dark.css

@@ -22,7 +22,7 @@
   width:100%; max-width:none; margin:0 0 22px; padding:18px 20px;
   border:1px solid var(--border); border-radius:12px; background:var(--surface); box-shadow:var(--shadow);
 }
-:root[data-theme="datalab-dark"] .report-header h1 { max-width:1100px; font-size:clamp(1.55rem,2.6vw,2.15rem); line-height:1.22; }
+:root[data-theme="datalab-dark"] .report-header h1 { max-width:1100px; font-size:clamp(1.4rem,2vw,1.75rem); line-height:1.22; }
 :root[data-theme="datalab-dark"] .report-header .meta { margin:8px 0 0; font-size:.85rem; color:var(--text-muted); }
 :root[data-theme="datalab-dark"] .report-brand-row { margin-bottom:8px; }
 :root[data-theme="datalab-dark"] .report-brand { color:var(--primary); text-transform:uppercase; letter-spacing:.08em; font-size:.83rem; }
@@ -134,7 +134,7 @@
   :root[data-theme="datalab-dark"] .controls { width:calc(100% - 24px); padding:8px 10px; }
   :root[data-theme="datalab-dark"] .report-shell { padding-left:14px; padding-right:14px; }
   :root[data-theme="datalab-dark"] .report-header { padding:15px 14px; }
-  :root[data-theme="datalab-dark"] .report-header h1 { font-size:1.45rem; }
+  :root[data-theme="datalab-dark"] .report-header h1 { font-size:1.3rem; }
   :root[data-theme="datalab-dark"] .brief-block { padding:15px 14px; }
   :root[data-theme="datalab-dark"] .brief-decision { padding:0; }
   :root[data-theme="datalab-dark"] .brief-decision .brief-block-header { padding:15px 14px 0; }

package/visualization/eduevidence-report/themes/datalab.css

@@ -23,7 +23,7 @@
   width:100%; max-width:none; margin:0 0 22px; padding:18px 20px;
   border:1px solid var(--border); border-radius:12px; background:var(--surface); box-shadow:var(--shadow);
 }
-:root[data-theme="datalab"] .report-header h1 { max-width:1100px; font-size:clamp(1.55rem,2.6vw,2.15rem); line-height:1.22; }
+:root[data-theme="datalab"] .report-header h1 { max-width:1100px; font-size:clamp(1.4rem,2vw,1.75rem); line-height:1.22; }
 :root[data-theme="datalab"] .report-header .meta { margin:8px 0 0; font-size:.85rem; }
 :root[data-theme="datalab"] .report-brand-row { margin-bottom:8px; }
 :root[data-theme="datalab"] .report-brand { color:var(--primary); text-transform:uppercase; letter-spacing:.08em; font-size:.83rem; }
@@ -138,7 +138,7 @@
   :root[data-theme="datalab"] .controls { width:calc(100% - 24px); padding:8px 10px; }
   :root[data-theme="datalab"] .report-shell { padding-left:14px; padding-right:14px; }
   :root[data-theme="datalab"] .report-header { padding:15px 14px; }
-  :root[data-theme="datalab"] .report-header h1 { font-size:1.45rem; }
+  :root[data-theme="datalab"] .report-header h1 { font-size:1.3rem; }
   :root[data-theme="datalab"] .brief-block { padding:15px 14px; }
   :root[data-theme="datalab"] .brief-decision { padding:0; }
   :root[data-theme="datalab"] .brief-decision .brief-block-header { padding:15px 14px 0; }

package/visualization/eduevidence-report/themes/presentation.css

@@ -31,7 +31,7 @@
 :root[data-theme="presentation"] .report-brand-row { margin-bottom:12px; }
 :root[data-theme="presentation"] .report-brand { color:var(--primary); text-transform:uppercase; letter-spacing:.1em; font-size:.8rem; }
 :root[data-theme="presentation"] .generated-theme-chip { background:#242A33; border-color:#3C4450; color:#B8C0CB; }
-:root[data-theme="presentation"] .report-header h1 { max-width:980px; font-size:clamp(1.5rem,2.6vw,2.1rem); line-height:1.08; letter-spacing:-.022em; }
+:root[data-theme="presentation"] .report-header h1 { max-width:980px; font-size:clamp(1.35rem,2vw,1.7rem); line-height:1.08; letter-spacing:-.022em; }
 :root[data-theme="presentation"] .report-header .meta { margin:10px 0 0; color:var(--text-muted); font-size:.86rem; overflow-wrap:anywhere; }
 :root[data-theme="presentation"] .report-view-switcher { display:inline-flex; margin-top:18px; padding:4px; border:1px solid var(--border); border-radius:999px; background:#12151A; }
 :root[data-theme="presentation"] .report-view-btn { min-height:36px; border:0; background:transparent; color:#BBC2CC; padding:7px 15px; }
@@ -114,7 +114,7 @@
   :root[data-theme="presentation"] .controls { width:calc(100% - 24px); border-radius:10px; }
   :root[data-theme="presentation"] .report-shell { padding-left:14px; padding-right:14px; }
   :root[data-theme="presentation"] .report-header { padding:18px 16px; border-radius:12px; }
-  :root[data-theme="presentation"] .report-header h1 { font-size:1.25rem; }
+  :root[data-theme="presentation"] .report-header h1 { font-size:1.2rem; }
   :root[data-theme="presentation"] .brief-block { padding:18px 16px; }
   :root[data-theme="presentation"] .brief-decision { padding:0; }
   :root[data-theme="presentation"] .brief-decision .decision-hero { min-height:0; padding:24px 18px; border-radius:13px; }

package/web/README.md

@@ -0,0 +1,18 @@
+# web/ — 前端分发与兼容边界
+
+EduEvidence 当前正式控制台是 **Research Studio**。开发源与运行时分发物必须明确区分：
+
+- **唯一权威可编辑控制台源**：`studio/`（React + TypeScript + Vite）。新功能、交互、可访问性、移动端和数据契约只在这里开发。
+- **正式运行时控制台**：`web/studio/`。它是 `studio/` 的可复现构建产物，由 Python 本地服务、Skill 上架包和 GitHub Pages 直接提供；不要手工编辑其中的 bundle。
+- `web/landing.html/.css/.js`：公开介绍页，保持独立视觉叙事；它只负责介绍和进入 Research Studio，不拥有研究状态。
+- `web/index.html`、`web/js/`、`web/styles.css`：v5 时代三页控制台的**兼容层 / 历史实现**。现有兼容 API 或旧链接在确有需要时可以继续读取它们，但不得把它们当作新 UI 的开发入口，也不要向其中增加新的产品功能。
+- `web/showcase_v2/`：冻结展示页。除安全或断链修复外不再与 Research Studio 同步演进。
+
+## 约定
+
+1. 新的 Research Studio 页面、组件和交互只能进入 `studio/src/`；禁止继续扩展旧 `web/js/` 控制台。
+2. `npm run build --prefix studio` 必须可复现 `web/studio/`；CI 使用 `git diff --exit-code -- web/studio` 守护这一点。
+3. 本地正式入口是 `http://127.0.0.1:<port>/studio/`；`dashboard_server.py` 的 `/`、`/console` 也应指向同一构建。
+4. GitHub Pages 根页保留介绍页，`/studio/` 是公开只读 Research Studio；静态导出只包含仓库示例，不包含本地研究项目、运行事件或 Autoevolve 会话。
+5. 五种报告主题属于 `visualization/eduevidence-report/` 的**生成时视觉身份**，不是 Research Studio 的运行时换肤；同一研究版本的科学内容不得因主题改变。
+6. 报告本体保持 single-file / zero-CDN；营销介绍页可以使用外部字体等展示资源，但不应把它们引入研究报告的离线能力声明。