=3:
- widths=[14*mm]+[(168-14)/ (ncols-1) *mm]*(ncols-1)
- t._argW=widths
- flows.append(t); flows.append(Spacer(1,4))
- continue
- # option lines start with full-width space or " A." style
- if re.match(r"^[ \s]*[A-E][．.、]", s):
- flows.append(Paragraph(inline(s), OPT)); i+=1; continue
- flows.append(Paragraph(inline(s), BODY)); i+=1
- return flows
-
-def build(md_path, pdf_path):
- md=open(md_path,encoding="utf-8").read()
- doc=SimpleDocTemplate(pdf_path, pagesize=A4,
- leftMargin=20*mm,rightMargin=20*mm,topMargin=18*mm,bottomMargin=18*mm,
- title=pdf_path.split("/")[-1])
- doc.build(parse(md))
- print("wrote", pdf_path)
-
-if __name__=="__main__":
- base="/Users/td_xu/courses/毛中特/output/"
- build(base+"毛中特期末模拟卷.md", base+"毛中特期末模拟卷.pdf")
- build(base+"毛中特期末模拟卷-答案解析.md", base+"毛中特期末模拟卷-答案解析.pdf")
diff --git a/scripts/misconception.py b/scripts/misconception.py
index ccbab9f..bef1961 100644
--- a/scripts/misconception.py
+++ b/scripts/misconception.py
@@ -7,7 +7,8 @@
import typer
from studylib.cli_common import guard, resolve_root
-from studylib.ioutils import read_jsonl
+from studylib.display import kc_label
+from studylib.ioutils import read_json, read_jsonl
app = typer.Typer(add_completion=False)
@@ -21,9 +22,11 @@ def list_cmd(course: Path = typer.Option(None, "--course")):
if not active:
typer.echo("没有活跃错因")
return
+ kcs = read_json(root / ".study" / "kc.json")
for m in active:
+ kc_disp = " / ".join(kc_label(k, kcs) for k in m["kc_ids"])
typer.echo(f"{m['error_id']} [{m['repair_status']}] {m['error_type']} "
- f"kc={','.join(m['kc_ids'])} ×{m.get('recurrence_count', 1)}")
+ f"kc={kc_disp} ×{m.get('recurrence_count', 1)}")
typer.echo(f" 错误假设：{m.get('wrong_assumption', '')}")
diff --git a/scripts/render_paper.py b/scripts/render_paper.py
new file mode 100644
index 0000000..ace9c4d
--- /dev/null
+++ b/scripts/render_paper.py
@@ -0,0 +1,44 @@
+#!/usr/bin/env python3
+import sys
+from pathlib import Path
+
+sys.path.insert(0, str(Path(__file__).resolve().parent))
+
+import typer
+
+from studylib.cli_common import guard
+from studylib.ioutils import read_json
+from studylib.render_paper import manifest_to_markdown, markdown_to_pdf
+
+app = typer.Typer(add_completion=False)
+
+
+@app.command()
+@guard
+def main(
+ manifest: Path = typer.Option(..., "--manifest"),
+ variant: str = typer.Option("both", "--variant"),
+ out_dir: Path = typer.Option(None, "--out-dir"),
+ fonts_dir: Path = typer.Option(None, "--fonts-dir"),
+):
+ if variant not in ("questions", "answers", "both"):
+ typer.echo("错误：--variant 必须是 questions/answers/both", err=True)
+ raise typer.Exit(code=1)
+ m = read_json(manifest)
+ if not m:
+ typer.echo(f"错误：manifest 不存在或为空：{manifest}", err=True)
+ raise typer.Exit(code=1)
+ out_dir = out_dir or manifest.parent
+ out_dir.mkdir(parents=True, exist_ok=True)
+ base = m["meta"].get("course_name", "quiz")
+ variants = ["questions", "answers"] if variant == "both" else [variant]
+ for v in variants:
+ md = manifest_to_markdown(m, v)
+ tag = "题目" if v == "questions" else "答案解析"
+ pdf = out_dir / f"{base}-{tag}.pdf"
+ markdown_to_pdf(md, pdf, fonts_dir=fonts_dir)
+ typer.echo(f"已生成：{pdf}")
+
+
+if __name__ == "__main__":
+ app()
diff --git a/scripts/render_quiz_html.py b/scripts/render_quiz_html.py
new file mode 100755
index 0000000..fc95b54
--- /dev/null
+++ b/scripts/render_quiz_html.py
@@ -0,0 +1,34 @@
+#!/usr/bin/env python3
+import sys
+from pathlib import Path
+
+sys.path.insert(0, str(Path(__file__).resolve().parent))
+
+import typer
+
+from studylib.cli_common import guard
+from studylib.ioutils import atomic_write_text, read_json
+from studylib.render_html import render_quiz_html
+
+app = typer.Typer(add_completion=False)
+
+
+@app.command()
+@guard
+def main(
+ manifest: Path = typer.Option(..., "--manifest"),
+ out: Path = typer.Option(None, "--out"),
+ reveal_default: str = typer.Option("on", "--reveal-default"),
+):
+ m = read_json(manifest)
+ if not m:
+ typer.echo(f"错误：manifest 不存在或为空：{manifest}", err=True)
+ raise typer.Exit(code=1)
+ html = render_quiz_html(m, reveal_default == "on")
+ out = out or manifest.with_suffix(".html")
+ atomic_write_text(out, html)
+ typer.echo(f"已生成交互测验页：{out}")
+
+
+if __name__ == "__main__":
+ app()
diff --git a/scripts/studylib/cli_common.py b/scripts/studylib/cli_common.py
index 432b83f..a929a03 100644
--- a/scripts/studylib/cli_common.py
+++ b/scripts/studylib/cli_common.py
@@ -29,7 +29,7 @@ def echo_next(state: dict) -> None:
if nbs["action"] == "rest":
typer.echo(f"下一步建议：rest —— {nbs['reasons'][0]}")
return
- target = nbs.get("kc_name") or "到期复习"
+ target = nbs.get("kc_label") or nbs.get("kc_name") or "到期复习"
typer.echo(f"下一步建议：{nbs['action']}「{target}」（约 {nbs['estimated_minutes']} 分钟）")
typer.echo("原因：")
for r in nbs["reasons"]:
diff --git a/scripts/studylib/dashboard.py b/scripts/studylib/dashboard.py
index 06f0760..d0f0810 100644
--- a/scripts/studylib/dashboard.py
+++ b/scripts/studylib/dashboard.py
@@ -4,17 +4,20 @@
from jinja2 import Template
+from .display import kc_label
+
TEMPLATE_PATH = Path(__file__).resolve().parents[2] / "templates" / "dashboard.md.j2"
def build_risks(kc_states: dict, miscs: dict, due: list) -> list[str]:
risks: list[str] = []
for kc in kc_states.values():
+ label = kc_label(kc.get("kc_id", ""), kc_states)
gap = kc["calibration"].get("gap")
if kc["teaching_state"] == "weak" and gap is not None and gap >= 0.3:
- risks.append(f"「{kc['name']}」：高置信度盲区")
+ risks.append(f"{label}：高置信度盲区")
elif kc["teaching_state"] == "blocked":
- risks.append(f"「{kc['name']}」：前置未稳定")
+ risks.append(f"{label}：前置未稳定")
for m in miscs.values():
if m["repair_status"] != "resolved" and m.get("recurrence_count", 1) >= 2:
risks.append(f"错因复发：{m['error_type']}（×{m['recurrence_count']}）")
diff --git a/scripts/studylib/display.py b/scripts/studylib/display.py
new file mode 100644
index 0000000..491c861
--- /dev/null
+++ b/scripts/studylib/display.py
@@ -0,0 +1,10 @@
+from __future__ import annotations
+
+
+def kc_label(kc_id: str, kcs: dict[str, dict] | None = None) -> str:
+ """User-facing KC label: 'kc_id（中文名）'. Falls back to bare kc_id."""
+ kc = (kcs or {}).get(kc_id) or {}
+ name = kc.get("name")
+ if not name or name == kc_id:
+ return kc_id
+ return f"{kc_id}（{name}）"
diff --git a/scripts/studylib/drill.py b/scripts/studylib/drill.py
new file mode 100644
index 0000000..1515fdc
--- /dev/null
+++ b/scripts/studylib/drill.py
@@ -0,0 +1,68 @@
+from __future__ import annotations
+
+import random
+
+from .nextstep import WEAKNESS_SCORE
+
+
+def _weighted_sample_no_replace(
+ rng: random.Random, items: list[str], weights: list[float], k: int
+) -> list[str]:
+ if k >= len(items):
+ return list(items)
+ # Efraimidis–Spirakis: key = u**(1/w); take the k largest keys.
+ pairs = []
+ for it, w in zip(items, weights):
+ ww = w if w > 0 else 1e-9
+ pairs.append((rng.random() ** (1.0 / ww), it))
+ pairs.sort(key=lambda p: p[0], reverse=True)
+ return [it for _, it in pairs[:k]]
+
+
+def select_kcs(kc_states: dict[str, dict], mode: str, count: int, seed: int = 0) -> list[str]:
+ if mode not in ("syllabus", "diagnostic"):
+ raise ValueError(f"unknown mode: {mode}")
+ ids = list(kc_states)
+ if not ids or count <= 0:
+ return []
+ rng = random.Random(seed)
+ if mode == "syllabus":
+ weights = [kc_states[i].get("exam_weight", 0.5) for i in ids]
+ else: # diagnostic (adaptive: prefers weak KCs when any learning record exists)
+ has_record = any(kc_states[i].get("teaching_state") != "unseen" for i in ids)
+ if has_record:
+ weights = [WEAKNESS_SCORE.get(kc_states[i].get("teaching_state"), 0.0) for i in ids]
+ else:
+ weights = [kc_states[i].get("exam_weight", 0.5) for i in ids]
+ return _weighted_sample_no_replace(rng, ids, weights, min(count, len(ids)))
+
+
+def gather_questions(
+ questions: dict, kc_ids: list[str], per_kc: int = 2, total: int | None = None
+) -> tuple[list[dict], dict[str, int]]:
+ total = total if total is not None else per_kc * max(1, len(kc_ids))
+ by_kc: dict[str, list[dict]] = {k: [] for k in kc_ids}
+ for q in questions.values():
+ for k in q.get("kc_ids", []):
+ if k in by_kc and len(by_kc[k]) < per_kc:
+ by_kc[k].append(q)
+ picked: list[dict] = []
+ seen: set = set()
+ i = 0
+ while len(picked) < total:
+ progressed = False
+ for k in kc_ids:
+ if i < len(by_kc[k]):
+ progressed = True
+ q = by_kc[k][i]
+ qid = q.get("question_id")
+ if qid not in seen:
+ seen.add(qid)
+ picked.append(q)
+ if len(picked) >= total:
+ break
+ if not progressed:
+ break
+ i += 1
+ shortfall = {k: per_kc - len(by_kc[k]) for k in kc_ids if len(by_kc[k]) < per_kc}
+ return picked, shortfall
diff --git a/scripts/studylib/ioutils.py b/scripts/studylib/ioutils.py
index 85cfe26..7a49e86 100644
--- a/scripts/studylib/ioutils.py
+++ b/scripts/studylib/ioutils.py
@@ -55,6 +55,13 @@ def read_jsonl(path: Path) -> list[dict]:
return rows
+def read_json(path: Path) -> dict:
+ path = Path(path)
+ if not path.exists():
+ return {}
+ return json.loads(path.read_text(encoding="utf-8"))
+
+
class _CourseLock:
"""Non-reentrant course-level lock; raises StateLockTimeout on timeout."""
diff --git a/scripts/studylib/manifest.py b/scripts/studylib/manifest.py
new file mode 100644
index 0000000..fb68f21
--- /dev/null
+++ b/scripts/studylib/manifest.py
@@ -0,0 +1,34 @@
+from __future__ import annotations
+
+from .display import kc_label
+from .ioutils import now_iso
+from .schemas import SCHEMA_VERSION
+
+
+def _question_view(q: dict, kcs: dict | None) -> dict:
+ kc_ids = list(q.get("kc_ids", []))
+ return {
+ "question_id": q["question_id"],
+ "kc_ids": kc_ids,
+ "kc_labels": [kc_label(k, kcs) for k in kc_ids],
+ "stem": q.get("stem", ""),
+ "answer": q.get("answer", ""),
+ "solution": q.get("solution", ""),
+ "difficulty": q.get("difficulty", 0.5),
+ "transfer_level": q.get("transfer_level", "T0"),
+ }
+
+
+def build_manifest(course: dict, mode: str, count: int, questions: list[dict],
+ kcs: dict | None = None) -> dict:
+ return {
+ "schema_version": SCHEMA_VERSION,
+ "meta": {
+ "course_id": course["id"],
+ "course_name": course["name"],
+ "mode": mode,
+ "count": count,
+ "generated_at": now_iso(),
+ },
+ "questions": [_question_view(q, kcs) for q in questions],
+ }
diff --git a/scripts/studylib/nextstep.py b/scripts/studylib/nextstep.py
index 74df560..8a49706 100644
--- a/scripts/studylib/nextstep.py
+++ b/scripts/studylib/nextstep.py
@@ -2,6 +2,8 @@
from datetime import date
+from .display import kc_label
+
DEFAULT_WEIGHTS = {
"exam_weight": 1.0, "urgency": 1.0, "weakness": 1.5, "prereq_centrality": 0.8,
"forgetting_risk": 1.0, "transfer_gap": 0.8, "blind_spot": 1.2, "expected_time": 0.5,
@@ -110,7 +112,9 @@ def compute_next_best_step(
reasons.append(f"距考试 {days} 天")
candidates.append({
- "action": action, "kc_id": kc_id, "kc_name": kc.get("name", kc_id),
+ "action": action, "kc_id": kc_id,
+ "kc_name": kc.get("name", kc_id),
+ "kc_label": kc_label(kc_id, kc_states),
"estimated_minutes": minutes, "priority_score": round(score, 4),
"reasons": reasons,
})
diff --git a/scripts/studylib/render_html.py b/scripts/studylib/render_html.py
new file mode 100644
index 0000000..ec6ed2a
--- /dev/null
+++ b/scripts/studylib/render_html.py
@@ -0,0 +1,53 @@
+from __future__ import annotations
+
+import re
+import unicodedata
+from pathlib import Path
+
+from jinja2 import Environment
+
+TEMPLATE_PATH = Path(__file__).resolve().parents[2] / "templates" / "quiz.html.j2"
+
+_OPT_RE = re.compile(r"^\s*([A-Ha-hＡ-Ｈａ-ｈ])[．.、)]\s*(.*)$")
+
+
+def parse_options(stem: str) -> tuple[str, list[tuple[str, str]]]:
+ lines = stem.splitlines()
+ body: list[str] = []
+ opts: list[list[str]] = [] # each: [letter, text]
+ in_opts = False
+ for ln in lines:
+ m = _OPT_RE.match(ln)
+ if m:
+ in_opts = True
+ letter = unicodedata.normalize("NFKC", m.group(1)).upper()
+ opts.append([letter, m.group(2).strip()])
+ elif not in_opts:
+ body.append(ln)
+ else:
+ opts[-1][1] = (opts[-1][1] + " " + ln.strip()).strip()
+ return "\n".join(body).strip(), [(o[0], o[1]) for o in opts]
+
+
+def _question_for_render(q: dict) -> dict:
+ body, opts = parse_options(q.get("stem", ""))
+ ans = q.get("answer", "") or ""
+ letters = sorted({unicodedata.normalize("NFKC", ch).upper() for ch in ans if ch.strip()})
+ return {
+ "stem": body,
+ "options": [{"letter": l, "text": t} for l, t in opts],
+ "answer": "".join(letters),
+ "answer_letters": letters,
+ "multi": len(letters) > 1,
+ "solution": q.get("solution", ""),
+ "kc_labels": q.get("kc_labels") or q.get("kc_ids", []),
+ }
+
+
+def render_quiz_html(manifest: dict, reveal_default: bool = True) -> str:
+ tpl = Environment(autoescape=True).from_string(TEMPLATE_PATH.read_text(encoding="utf-8"))
+ view = {
+ "meta": manifest["meta"],
+ "questions": [_question_for_render(q) for q in manifest["questions"]],
+ }
+ return tpl.render(m=view, reveal_default=("on" if reveal_default else "off"))
diff --git a/scripts/studylib/render_paper.py b/scripts/studylib/render_paper.py
new file mode 100644
index 0000000..c9a8d19
--- /dev/null
+++ b/scripts/studylib/render_paper.py
@@ -0,0 +1,127 @@
+from __future__ import annotations
+
+import html as _html
+from pathlib import Path
+
+from reportlab.lib import colors
+from reportlab.lib.enums import TA_LEFT
+from reportlab.lib.pagesizes import A4
+from reportlab.lib.styles import ParagraphStyle, getSampleStyleSheet
+from reportlab.lib.units import mm
+from reportlab.pdfbase import pdfmetrics
+from reportlab.pdfbase.cidfonts import UnicodeCIDFont
+from reportlab.pdfbase.pdfmetrics import registerFontFamily
+from reportlab.pdfbase.ttfonts import TTFont
+from reportlab.platypus import HRFlowable, Paragraph, SimpleDocTemplate
+
+BODY_FONT = "Body"
+BOLD_FONT = "HeitiM"
+_REGISTERED_KEY: str | None = None # guards repeated registration in one process
+
+
+def _register_fonts(fonts_dir: Path | None) -> None:
+ """Register CJK fonts. Prefer Heiti .ttc from fonts_dir; else fall back to
+ reportlab's built-in CID font STSong-Light (no font files needed). Sets the
+ module-level BODY_FONT/BOLD_FONT so styles resolve correctly either way."""
+ global BODY_FONT, BOLD_FONT, _REGISTERED_KEY
+ fonts_dir = Path(fonts_dir) if fonts_dir else None
+ use_heiti = bool(fonts_dir and (fonts_dir / "STHeitiLight.ttc").exists()
+ and (fonts_dir / "STHeitiMedium.ttc").exists())
+ key = f"heiti:{fonts_dir}" if use_heiti else "cid"
+ if _REGISTERED_KEY == key:
+ return # already registered with this config in this process
+ if use_heiti:
+ pdfmetrics.registerFont(TTFont("Body", str(fonts_dir / "STHeitiLight.ttc"), subfontIndex=0))
+ pdfmetrics.registerFont(TTFont("HeitiM", str(fonts_dir / "STHeitiMedium.ttc"), subfontIndex=0))
+ BODY_FONT, BOLD_FONT = "Body", "HeitiM"
+ else:
+ # UnicodeCIDFont registers under its face name; reuse that name for both.
+ pdfmetrics.registerFont(UnicodeCIDFont("STSong-Light"))
+ BODY_FONT = BOLD_FONT = "STSong-Light"
+ registerFontFamily(BODY_FONT, normal=BODY_FONT, bold=BOLD_FONT,
+ italic=BODY_FONT, boldItalic=BOLD_FONT)
+ _REGISTERED_KEY = key
+
+
+def _styles():
+ ss = getSampleStyleSheet()
+ return {
+ "h1": ParagraphStyle("h1", parent=ss["Title"], fontName=BOLD_FONT, fontSize=16,
+ leading=22, spaceAfter=6, textColor=colors.HexColor("#1a1a1a")),
+ "body": ParagraphStyle("body", fontName=BODY_FONT, fontSize=10.5, leading=16.5,
+ alignment=TA_LEFT, spaceAfter=3),
+ "opt": ParagraphStyle("opt", fontName=BODY_FONT, fontSize=10.5, leading=15,
+ leftIndent=14, spaceAfter=1),
+ "quote": ParagraphStyle("quote", fontName=BODY_FONT, fontSize=10, leading=15,
+ leftIndent=16, textColor=colors.HexColor("#444444"), spaceAfter=3),
+ }
+
+
+def _inline(t: str) -> str:
+ t = t.replace("\\_", "_")
+ t = _html.escape(t)
+ parts = t.split("**")
+ if len(parts) > 1:
+ out = []
+ for i, p in enumerate(parts):
+ out += ["", p, ""] if i % 2 else [p]
+ t = "".join(out)
+ return t
+
+
+def manifest_to_markdown(manifest: dict, variant: str) -> str:
+ if variant not in ("questions", "answers"):
+ raise ValueError(f"unknown variant: {variant}")
+ meta = manifest["meta"]
+ lines = [f"# {meta['course_name']} · 模拟卷",
+ f"> {meta['mode']} 模式 · {len(manifest['questions'])} 题 · 生成于 {meta['generated_at']}", ""]
+ for i, q in enumerate(manifest["questions"], 1):
+ kcs = " · ".join(q.get("kc_labels") or q.get("kc_ids", []))
+ lines.append(f"### 第 {i} 题 {kcs}")
+ lines.append(q.get("stem", ""))
+ if variant == "answers":
+ lines += ["", f"**答案：{q.get('answer', '')}**", f"> 解析：{q.get('solution', '')}"]
+ lines.append("")
+ return "\n".join(lines)
+
+
+def _parse(md: str, st: dict) -> list:
+ import re
+ flows, lines, i, n = [], md.split("\n"), 0, len(md.split("\n"))
+ while i < n:
+ line = lines[i].rstrip("\n")
+ s = line.strip()
+ if s == "":
+ i += 1
+ continue
+ if s == "---":
+ flows.append(HRFlowable(width="100%", thickness=0.6,
+ color=colors.HexColor("#bbbbbb"), spaceBefore=4, spaceAfter=4))
+ i += 1
+ continue
+ if s.startswith("# "):
+ flows.append(Paragraph(_inline(s[2:].strip()), st["h1"])); i += 1; continue
+ if s.startswith("### "):
+ flows.append(Paragraph(_inline(s[4:].strip()),
+ ParagraphStyle("h3", parent=st["body"], fontName=BOLD_FONT,
+ textColor=colors.HexColor("#0b5394"), spaceBefore=6)))
+ i += 1; continue
+ if s.startswith("> "):
+ blk = []
+ while i < n and lines[i].strip().startswith(">"):
+ blk.append(lines[i].strip()[1:].strip()); i += 1
+ flows.append(Paragraph("
".join(_inline(x) for x in blk), st["quote"])); continue
+ if re.match(r"^[ \s]*[A-H][．.、]", s):
+ flows.append(Paragraph(_inline(s), st["opt"])); i += 1; continue
+ flows.append(Paragraph(_inline(s), st["body"])); i += 1
+ return flows
+
+
+def markdown_to_pdf(md: str, pdf_path: Path, fonts_dir: Path | None = None) -> Path:
+ _register_fonts(fonts_dir)
+ doc = SimpleDocTemplate(str(pdf_path), pagesize=A4,
+ leftMargin=20 * mm, rightMargin=20 * mm,
+ topMargin=18 * mm, bottomMargin=18 * mm,
+ title=Path(pdf_path).name)
+ doc.build(_parse(md, _styles()))
+ return Path(pdf_path)
diff --git a/templates/dashboard.md.j2 b/templates/dashboard.md.j2
index 4481eec..805aa57 100644
--- a/templates/dashboard.md.j2
+++ b/templates/dashboard.md.j2
@@ -3,7 +3,7 @@
{% if s.next_best_step.action == "rest" -%}
暂无紧急任务。可以休息，或自由推进新章节。
{%- else -%}
-**{{ s.next_best_step.action }}**：{{ s.next_best_step.kc_name or "到期复习" }}
+**{{ s.next_best_step.action }}**：{{ s.next_best_step.kc_label or s.next_best_step.kc_name or "到期复习" }}
预计：{{ s.next_best_step.estimated_minutes }} 分钟
为什么：
diff --git a/templates/quiz.html.j2 b/templates/quiz.html.j2
new file mode 100644
index 0000000..fac97a1
--- /dev/null
+++ b/templates/quiz.html.j2
@@ -0,0 +1,121 @@
+
+
+
+
+{{ m.meta.course_name }} · 练习
+
+
+
+{{ m.meta.course_name }} · 练习卷
+{{ m.meta.mode }} 模式 · {{ m.questions | count }} 题 · 生成于 {{ m.meta.generated_at }}
+
+
+
+
+
+
+
+
+
+
+
+{% for q in m.questions %}
+{% set qnum = loop.index %}
+
+ {% for l in q.kc_labels %}{{ l }}{% if not loop.last %} · {% endif %}{% endfor %}
+ {{ qnum }}. {{ q.stem }}
+
+ {% for o in q.options %}
+
+ {% endfor %}
+
+
+
答案：{{ q.answer }}
+
{{ q.solution }}
+