少儿编程题卡生成器

它解决什么问题

在少儿编程教学里，出题往往比讲题更耗时间。一道看似简单的 Scratch 或 Python 题，要兼顾年级水平、知识点覆盖、题目描述、参考答案和扩展练习，整理成可直接使用的题卡还要额外排版。反复拼凑这些材料，容易让课程准备变成机械劳动。

技能如何工作

少儿编程题卡生成器 把出题流程拆成可复用的步骤：

• 默认直接在对话中展示题目，不创建文件；只有在用户明确要求导出、保存、生成题库或制作卡片时，才产出 JSON 或 PNG。
• 支持 Scratch、Python、Python turtle、C、C++ 和 GOC，同一批题可以按每题指定不同语言。
• 根据上下文推断年级、语言、难度、题数、知识点和主题；默认参数为 5 年级、Python、初级、5 题、按难度选择知识点、主题轮换。
• 出题时优先保证题目正确、适龄且可解，再考虑卡片视觉效果。
• 设计或检查题目会读取 references/problem-quality.md；导出 JSON 或调用渲染脚本时读取 references/problem-schema.md。生成 Scratch 题读取 references/scratch-syntax.md，生成 GOC 题读取 references/goc-guide.md，需要 PNG 或调整视觉样式时读取 references/visual-style.md。

每道题按六个部分生成：

1. 题目：包含标题、知识点、场景、目标，以及适用时的输入、输出、范围和示例。
2. 引导思路：用 4～6 个中文步骤说明思路，不直接泄露完整代码。
3. 语法框架：结构与答案一致，只把关键值或短表达式替换为 ?。
4. 完整程序：可运行或符合对应图形化语言规范，并与题面和框架保持一致。
5. 运行结果：精确描述输出；绘图题描述最终图形。
6. 扩展题：只增加一个主要挑战点，并默认提供参考程序。

交付模式分三种：直接展示会使用清晰的小标题和对应语言的代码块，不会为了保留内部结构而输出 JSON；导出 JSON 会按 problem-schema.md 组装数据，保存为 UTF-8，并先运行静态校验；渲染 PNG 会先生成 JSON，通过 scripts/validate_problem.py 校验后再调用 scripts/generate.py，每题生成 6 张图片。

适用边界与注意点

题目语言和难度依赖上下文推断，信息不足且会明显改变结果时才追问。同一批题会避免连续三题采用相同主题或相同解法。渲染 PNG 需要当前环境可用的 Python 和 Pillow，缺少依赖时应先说明缺失项并请求授权。

result_image 是可选项：Scratch、Python turtle 和 GOC 可由脚本模拟图形结果；其他题目使用精确文字结果卡，或嵌入用户提供的结果图。不要为了生成结果图直接执行模型生成的任意程序，应使用渲染脚本内置的受限模拟器，或使用用户明确提供的图片。交付前还要逐题检查知识点适龄性、题面条件完整性、引导思路是否泄露答案、? 是否与完整程序对应，以及扩展题是否只有一个主要难度增量。