力扣认知刷题器

这是一个面向力扣刷题训练的 AI 认知课件生成器。核心仍是 direct-html 工作流：

用户粘贴力扣题、算法题或代码分析题文本
-> LLM 结构化为 problem.json
-> LLM 基于 example 蓝图生成 page_plan.json
-> page_plan 审计通过后，LLM 直接生成 standalone HTML
-> 审计失败则反馈错误并重试
-> 前端预览生成的学习材料

它不依赖原项目里的 LessonSpec、builder、runtime pack 或 schema compiler。

工作流图

flowchart TD
  A["用户在前端粘贴力扣题、算法题或代码分析题文本"] --> B["POST /api/generate"]
  B --> C["DeepSeek 调用 1：题目结构化"]
  C --> D["生成内部 problem.json"]
  D --> E["DeepSeek 调用 2：基于 example 蓝图生成 page_plan.json"]
  E --> F{"page_plan 审计是否通过？"}
  F -- "否" --> G["把 plan 审计错误反馈给 DeepSeek"]
  G --> E
  F -- "是" --> H["把 problem.json + page_plan.json 注入 prompt.txt"]
  H --> I["追加迁移练习深度要求"]
  I --> J["DeepSeek 调用 3：直接生成 standalone HTML"]
  J --> K["写入 direct_XXX_slug.html"]
  K --> L{"HTML 审计是否通过？"}
  L -- "否" --> M["把 HTML 审计错误反馈给 DeepSeek"]
  M --> J
  L -- "是" --> N["写入 direct-html-report.json"]
  N --> O["前端 iframe 预览 HTML"]
  O --> P["用户打开 HTML / 报告 / problem.json / page_plan.json 审查"]

  subgraph QualityGate["质量门"]
    Q1["单文件 HTML"]
    Q2["CSS/JS 内联"]
    Q3["无外部网络资源"]
    Q4["包含迁移学习"]
    Q5["参考答案与自动播放"]
    Q6["题目特定迁移检查，例如 #209 -> #713"]
  end

  F -.-> QualityGate
  L -.-> QualityGate

Loading

运行

需要 Python 3.9+。

复制环境变量文件：

copy .env.example .env

在 .env 中填入：

DEEPSEEK_API_KEY=你的 key

启动本地前端：

python -m direct_html_workflow.cli serve

打开：

http://127.0.0.1:8765

然后粘贴一道力扣题、算法题或代码分析题的完整文本，点击“生成学习材料”。

CLI 用法

从题目文本生成 HTML：

python -m direct_html_workflow.cli generate samples/leetcode_209.txt --output outputs/leetcode-209

只把题目文本结构化为 JSON：

python -m direct_html_workflow.cli structure samples/leetcode_209.txt --output outputs/problem.json

审计一个 direct HTML 文件：

python -m direct_html_workflow.cli check outputs/leetcode-209/direct_209_minimum-size-subarray-sum.html --problem outputs/leetcode-209/problem.json

输入

真正的用户输入是一道题的文本，可以是力扣题、普通算法题或代码分析题。推荐包含：

• 题号
• 题名
• 描述
• 示例
• 约束
• 函数签名或核心代码

题号不是必需项。系统会先调用 DeepSeek 把文本整理为内部 problem.json，再把这个 JSON 注入 prompt.txt。

如果输入不是 LeetCode 题，leetcodeId 会设为 0，并按普通算法题生成学习材料。

输出

每次生成会写入一个目录：

outputs/YYYYMMDD-HHMMSS/
  problem.json
  page_plan.json
  direct_XXX_slug.html
  direct-html-report.json

前端会直接用 iframe 预览 HTML。

质量门

当前审计包含：

• 必须是 standalone HTML
• CSS 和 JavaScript 必须内联
• 不允许外部网络资源
• 必须包含原题标题或分析主题
• 必须包含迁移学习
• 必须有参考答案入口
• 必须有 trace 自动播放

对于 LeetCode 209，额外要求迁移到 LeetCode 713，并包含：

• product
• product >= k
• right-left+1 或 right - left + 1
• 固定右端点批量计数解释

注意

不要把 .env 或真实 API key 提交到 GitHub。