/python-101

A Python problem bank to learn the basic grammar of Python

Primary LanguageTypeScript

Python-101学习题库

npy开心，做什么事都会变顺 🥰

面向零基础学习者的交互式 Python 入门教程。项目计划通过网页的形式，将章节讲解、习题训练、在线运行与 LLM 判题整合在一起，为学习者提供循序渐进的学习路径与即时反馈。

功能亮点

  • 教程 + 题库双模式：章节页面配示例代码、常见错误与进阶拓展；题库可按章节和难度筛选练习。
  • 多题型覆盖：支持判断题、单选题和编程题，题面贴近日常场景帮助理解语法。
  • 在线运行 & LLM 判题：Python 3.8 沙箱环境，标准库可用，基于豆包模型给出逐步提示与判分。
  • 学习进度追踪：记录用户在每个题目的完成情况和得分，提供学习记录页。
  • 账号与设备管理：账户登录、设备数量限制、管理员后台可管理用户与题目资源。
  • 可维护内容仓库：教程与题目以 Markdown/结构化文件存放在 resources/ 中，便于后续扩展。

目录速览

  • PROJECT.md：完整的需求、设计与实现规范，所有开发与协作请先阅读此文档。
  • resources/：教程与题目内容（按章节和题目拆分存放，后续开发会补充具体结构）。
  • data/（在 .gitignore 中维护）：用户账户、设备信息与学习进度的本地 JSON 存储。

快速起步

  1. 准备 Python 3.8 运行环境。
  2. 将豆包 API Key 写入 .env：ARK_API_KEY=your_key_here。
  3. 按 PROJECT.md 中的规范补充 resources/ 下的章节与题目内容。
  4. 后续将提供运行脚本/前端页面，当前阶段聚焦于内容与系统设计的搭建。

参与贡献

  • 规划与开发以 PROJECT.md 为准，如有需求变更请先更新该规范。
  • 提交前请确认：目录结构符合约定、内容文件使用 UTF-8/ASCII，并遵守题目模板。
  • 欢迎在 Issue/PR 中讨论题目设计、判题策略与沙箱实现等细节。

授权信息

项目开源协议尚未指定，贡献前请确认后续的 License 约定。

开发运行

  • 后端：cd backend && python -m uvicorn app.main:app --reload --host 0.0.0.0 --port 8000（启动前按 backend/README.md 安装依赖）。
  • 前端：cd frontend && npm install && npm run dev，默认监听 http://127.0.0.1:5173。
  • 环境变量：根目录创建 .env，包含 ARK_API_KEY=...。未配置时判题接口会返回本地模拟结果。