[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-2322":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":9,"language":10,"languages":9,"totalLinesOfCode":9,"stars":11,"forks":12,"watchers":13,"openIssues":14,"contributorsCount":15,"subscribersCount":15,"size":15,"stars1d":16,"stars7d":14,"stars30d":17,"stars90d":15,"forks30d":15,"starsTrendScore":18,"compositeScore":19,"rankGlobal":9,"rankLanguage":9,"license":20,"archived":21,"fork":21,"defaultBranch":22,"hasWiki":23,"hasPages":21,"topics":24,"createdAt":9,"pushedAt":9,"updatedAt":25,"readmeContent":26,"aiSummary":27,"trendingCount":15,"starSnapshotCount":15,"syncStatus":14,"lastSyncTime":28,"discoverSource":29},2322,"Socratic-Education-System","HowieWang1121\u002FSocratic-Education-System","HowieWang1121","我们认为，受教育不仅是义务，更是应被保障的权利。然而，社会与经济条件的差异导致了优质教育资源的分配失衡。本项目旨在弥合城乡教育鸿沟，为偏远地区的师生提供基于 FastAPI 架构的启发式教学解决方案。系统摒弃了传统的“问答式”灌输，构建了以“助产术”为核心的对话智能体，通过多轮追问诱导学生自主拆解复杂问题，实现认知升级。在教师端，系统通过动态分析学生 JSON 档案，精准识别知识盲区并提供结构化教学干预建议，辅助教师完成个性化教学决策。",null,"Python",116,15,97,2,0,1,6,3,3.61,"MIT License",false,"main",true,[],"2026-06-12 02:00:40","# Socratic Education System v2 🎓\n\n> **基于苏格拉底式启发教学法的 K12 智能教育 AI Agent 平台**\n\n## 🌟 Project Vision\n\n本平台致力于将古老的“苏格拉底式教学法”与现代大语言模型（LLM）技术相结合，为 K12 阶段的学生提供一个**不直接给出答案、而是通过追问引导思考**的智能陪伴环境。我们相信，教育的本质不是灌输，而是点燃。通过多智能体协作，平台能够精准捕捉学生的逻辑断裂点，并为教师提供具有深厚教育心理学背景的学情诊断与教学建议。\n\n## 🚀 Core Features\n\n- **🎭 多智能体协作流程 (Multi-Agent Collaboration)**\n    - **Socratic Tutor Agent**: 核心对话机器人，严格遵循引导式教学，通过逻辑确认、揭示矛盾和连续追问来启发学生。\n    - **Profiler Agent**: 对话结束后自动运行，深度复盘对话历史，提取核心知识点并识别认知障碍。\n- **📊 动态学生画像回写 (Dynamic Student Profiling)**\n    - 每次对话后，系统会自动将诊断出的“思维弱点”以结构化日志 (`weakness_log`) 形式回写至 JSON 数据库，实现学生认知状态的实时跟踪。\n- **🧑‍🏫 教师端学情诊断与教学建议**\n    - **一键分析报告**: 整合全量档案生成深度诊断。\n    - **智能教学方案**: 基于最近 5 条弱点记录，预测学习难点并推荐具体的干预策略（如：先实验感性认知，再理论理性推导）。\n- **💾 模块化文件数据库**\n    - 基于线程安全（RLock）的 JSON 存储系统，确保在轻量级部署下依然具备强健的并发处理能力与审计追踪日志。\n\n## 🛠 Installation & Setup\n\n### 前置要求\n- Python 3.10+\n- DeepSeek API Key\n\n### 1. 克隆并进入项目\n```bash\ngit clone \u003Cyour-repo-url>\ncd 个人网站\n```\n\n### 2. 创建并激活虚拟环境\n```bash\npython3 -m venv .venv\nsource .venv\u002Fbin\u002Factivate  # macOS\u002FLinux\n# 或 .venv\\Scripts\\activate # Windows\n```\n\n### 3. 安装依赖\n```bash\npip install fastapi uvicorn openai pydantic marked\n```\n\n### 4. 配置 API Key\n在 `multi_agent_tutor.py` 中修改以下配置：\n```python\nAPI_KEY = \"您的 DeepSeek API Key\"\n```\n\n### 5. 启动服务\n```bash\npython3 multi_agent_tutor.py\n```\n服务启动后，在浏览器中打开 `index.html` 即可开始体验。\n\n## 📂 Project Structure\n\n- `multi_agent_tutor.py`: 后端核心，包含所有 API 路由与 Agent 逻辑。\n- `database\u002Fmanager.py`: 数据库管理类，处理 JSON 读写与并发锁。\n- `index.html`: 现代感 UI 界面，集成 Markdown 渲染与 KaTeX 公式支持。\n- `data\u002Fstudents\u002F`: 存放结构化的学生档案。\n- `logs\u002F`: 记录系统操作审计日志。\n\n## 📄 License\n\n本项目采用 [MIT 许可证](LICENSE)。您可以自由地使用、修改和分发。\n\n## 🤝 Community & Maintenance\n\n- **维护计划**：本项目将持续优化 Profiler Agent 的诊断逻辑，并计划引入更丰富的学科知识库。\n- **参与贡献**：我们非常欢迎 Pull Requests！在提交之前，请先阅读 [CONTRIBUTING.md](CONTRIBUTING.md)。\n- **反馈与支持**：如果您发现任何 Bug 或有功能建议，请通过 GitHub Issues 提交。\n\n---\n*由 AI 驱动，为每一个孩子提供苏格拉底式的智慧启迪。*\n","Socratic Education System 是一个基于苏格拉底式启发教学法的K12智能教育AI平台，旨在通过对话智能体帮助偏远地区的学生和教师提升教学质量。其核心功能包括多智能体协作流程、动态学生画像回写以及为教师提供学情诊断与个性化教学建议。系统采用FastAPI架构开发，并利用Python语言实现，支持模块化文件数据库管理以保证数据安全性和并发处理能力。该平台特别适合教育资源匮乏或分布不均的地区使用，能够有效辅助教师进行精准教学干预，同时激发学生的自主学习兴趣。","2026-06-11 02:49:28","CREATED_QUERY"]