EduForge AI 产品白皮书

EduForge AI 以“让教学更简单”为产品理念，面向中小学教学场景提供 AI 资源生产与治理平台。系统从教材章节出发，将课堂 PPT、React 交互课件、PDF 试卷、章节资源库、公开展示页和开放接口统一纳入同一条任务链，从而把“生成一次、沉淀多次、持续复用”变成正式工作流，而不是零散工具集合。

平台强调真实环境运行。用户必须通过真实登录进入工作台，生成结果进入真实数据库和真实文件存储，管理员可以继续维护教材章节结构、上传资源文件、补充截图并控制公开展示内容。平台因此能够承担学校内部正式资源系统的角色，而不仅是前端演示站点。

在技术路径上，平台采用 Next.js 负责教师与管理员界面，FastAPI 负责认证、生成、资源与治理接口，Tongyi/Qwen 负责文本生成，本地图像 API 负责站点展示图与资源截图生产，本地 MySQL 负责核心业务数据存储。本地化部署是当前推荐模式，适合学校现有环境直接接入。

从管理价值看，平台并不只解决教师个人备课效率问题，还服务于学校层面的资源规范化、成果可见化和资产长期复用。章节、资源、任务、用户和公开展示之间形成了连续链条，因此平台可以同时支撑采购评审、校内部署、运营考核和对外展示四类正式场景。

从建设方式看，平台强调“少改现有环境、先打通真实链路、再逐步扩治理能力”。这意味着学校可以先在本地 MySQL 与现有网络条件下完成部署，再逐步接入统一认证、校内门户、资源审核制度和教研指标体系，避免一次性大规模改造带来的落地风险。

当前学校数字资源建设面临三个共性问题：第一，备课结果难以结构化沉淀，课件、讲稿、练习与演示资源散落在个人目录中；第二，AI 生成内容往往停留在聊天结果层，缺少真实账号、真实章节、真实资源库和真实下载链；第三，缺少能被学校信息中心接管的管理员能力，导致资源治理与平台接入无法形成制度化闭环。

EduForge AI 针对的不是“单次生成”问题，而是“正式交付与持续治理”问题。系统把教材章节作为主索引，把资源资产作为治理对象，把教师生成行为和管理员维护行为统一到一个平台上。这样做的目的，是让平台既服务于一线教师，又能被学校信息中心和教研部门纳入长期运营。

在多数学校场景中，资源建设失败并不是因为没有生成能力，而是因为缺少正式规则：谁可以发布、资源归哪个章节、截图由谁维护、公开页展示什么、失败任务如何追踪、接口如何被现有系统复用。平台将这些问题前置处理，使“内容生产”和“资源治理”从一开始就是同一套产品设计的一部分。

因此，平台面向的问题定义可以概括为三点：一是让资源生产从个人经验转化为组织流程；二是让 AI 生成结果进入正式资源库而非停留在临时页面；三是让学校信息中心、教研部门和管理者都能在同一系统中找到自己的职责锚点。

上述定位意味着平台适合作为学校教学资源数字化建设中的生产与治理底座，而不是覆盖所有教育信息化职能的“大而全平台”。这种边界划分有利于快速落地，也有利于与校内已有系统形成分工协作，而非功能冲突。

在采购或立项层面，建议将平台定位成“资源生产线 + 治理中台 + 集成接口层”的组合能力。这样既能说明其直接服务教师的业务价值，也能体现对管理流程和校内系统建设的长期支撑能力。

平台的运行效果取决于角色协同是否清晰。若只有教师使用而没有管理员和信息中心参与，资源会重新回到个人目录；若只有治理要求而没有教师工作流，平台又会失去日常活跃度。因此角色矩阵是平台能否持续运行的关键管理条件。

建议学校在正式部署时同步明确资源命名规范、截图维护责任、公开资源发布策略和管理员值守机制，使不同角色看到的系统目标、操作权限和考核要求保持一致。

平台的交付逻辑不是“同一内容换多种格式”，而是围绕教学场景给出不同可用产物。对于备课、课堂演示、测评、教研和公开展示，每类场景都有自己的输入约束、输出载体和治理要求，因此文档需要按场景而不是按文件格式理解平台能力。

从实施角度看，学校通常可以先从“章节备课 + 资源治理”两个场景起步，随后逐步扩展到公开发布和系统集成。这种推进方式可以更快积累正式资源资产，也更容易形成阶段性成效。

平台的方法论不是单纯的提示词工程，而是将章节组织、教学目标、课堂活动、资源沉淀和治理要求串成一套可执行流程。只有把这些约束显式化，AI 输出才会具备进入正式教学场景的稳定性。

平台以教材章节驱动为第一原则。所有生成任务以章节、教学目标和版本信息为首要输入，避免资源脱离教学主线。

平台以工作流闭环为第二原则。教师发起生成后，平台不仅返回文件，还要完成任务记录、章节归属、资源入库、截图补充和公开展示接续动作。

平台以正式资产治理为第三原则。任何产物都被视为长期资产，而非一次性文本输出。因此资源必须可命名、可下载、可替换、可审阅、可治理、可追溯。

平台以角色协作为第四原则。教师负责生成与使用，管理员负责治理与上传，信息中心负责部署与接入，教研组负责统一规范，四类主体共同构成正式运行机制。

在实际教学中，这套方法论的价值在于把教师经验转译为平台规则。例如章节索引、知识点列表、课件风格、练习题型、互动特性与公开发布策略，都可以逐步沉淀为组织级模板，而不是长期依赖少数个体经验。

上述五层结构的核心目的是把“AI 生成”从单一能力点提升为“可交付、可治理、可集成、可运维”的产品系统。首页 DAG、工作台、公开资源页、管理员页和 API 文档分别承担不同信息职责，但共享同一套数据和资源底座。

从请求路径看，教师或集成方先在体验层或接口层发起生成，再由业务层创建任务并驱动模型层执行，最终把结构化结果写回数据层和文件层，并由治理层决定其是否进入公开展示。这条链路保证了平台在“生成速度”和“正式治理”之间取得平衡。

从扩展路径看，平台架构允许学校后续接入统一身份认证、校本资源门户、运维监控、日志审计或更多学科模板，而不必推倒已有能力重建。因此它既适合快速试点，也适合逐步升级为长期运行系统。

治理与安全不是平台上线后的附属工作，而是产品设计中的基础前提。只有当资源、章节、任务、用户和发布动作都具有正式归属关系时，平台才可能进入学校真实运营体系。

平台当前通过真实登录鉴权、任务归属、资源归属和章节归属建立最基础的责任链。下一步治理增强重点包括：管理员操作审计、公开资源发布审批、章节变更日志以及更多面向学校的接口调用留痕。

如果学校希望把平台纳入正式制度，应同时建立账号审批、资源命名、公开发布、截图质量和数据备份等配套规则。产品提供的是治理抓手，制度设计则决定抓手能否真正发挥作用。

推荐部署形态为本地化部署。前端通过 Next.js 构建并启动，后端通过 Uvicorn 托管 FastAPI，数据库连接本地或校内 MySQL，文件资产存储在受控目录并通过静态挂载对外暴露。该结构对现有学校环境侵入小，便于信息中心接管。

在运维侧，平台至少需要关注四类指标：任务生成成功率、资源入库成功率、章节覆盖率与管理员上传成功率。由于平台同时依赖文本模型与本地图像 API，两类外部能力都应纳入健康检查与故障回传机制。

平台前后端均适配本地调试、局域网接入和正式服务器运行。PPTX 文件可以直接用本机 PowerPoint 打开，React 课件可以站内运行预览，文档页和管理员页则直接服务于学校长期运营与治理场景。

在学校环境中，运维工作不应只关注“服务是否启动”，还应关注“资源是否可恢复、日志是否可追踪、密钥是否可控、上传是否可治理”。平台的正式价值恰恰体现在这些长期运维能力是否完善。

对于学校正式立项或采购场景，建议把平台视作“可部署的教学资源生产与治理系统”而不是单一页面项目。采购、交付、部署、验收和运维责任应在项目初期就以正式文档明确，避免后期因边界不清导致系统只能短期演示而无法长期运行。

建议把本节内容与接口文档、部署记录、账号清单、环境变量说明和验收测试结果一起归档。这样采购完成后的系统交付才能转化为学校可持续接管、可审计、可迭代的正式项目成果。

建议把成效评估分成“效率指标”和“治理指标”两类。效率指标关注单次备课时间、交付文件数量、章节覆盖率与教师活跃度；治理指标关注资源截图完整率、章节资源治理完整率、公开资源复用率和管理员处理时效。只有两类指标同时改善，平台才算完成从工具到系统的转变。

建议将上述指标纳入季度复盘，并结合教师访谈、公开资源访问情况和章节空白点分析持续优化。这样可以避免平台建设停留在“上线完成”这一单点，而是形成可量化、可迭代的运营机制。

本节为平台运行设定可度量的服务等级目标 (SLO)，涵盖可用性、生成时延、资源治理时效和故障响应。建议在校内部署文档与运维交接资料里把表格指标作为验收口径，并由信息中心、教研部门和平台维护方共同复核。

平台默认按本地化部署形态运行，避免学生个人信息、试卷原文与教师授课记录跨网传输。下列要求与《中华人民共和国数据安全法》《个人信息保护法》《教育移动互联网应用程序备案管理办法》等合规框架对齐，作为校内信息化建设的最低基线。

建议在年度信息安全自查中将上述六个主题作为必查项；如校方计划接入云端模型或开放校外访问，需要先完成数据出境影响评估、最小化字段集白名单与跨域审计策略后再行实施。

平台采用前后端分离架构，所有产物以章节为锚点，并通过统一的资源治理流程沉淀。下表给出关键技术组件、当前形态与可演进方向，便于平台维护方做容量规划、性能优化与版本升级评估。

扩展路线遵循“先扩展观测、再扩展治理、最后扩展模型”的次序：先把日志、健康检查、链路追踪做齐，再把治理流程数字化，最后才考虑模型替换或多模型并存。这样可以避免在缺少观测的状态下盲目升级，导致教学一线感受到不可解释的回归。

本项目当前使用和展示的课本资源，统一来源于 GitHub 开源仓库 TapXWorld/ChinaTextbook。在此对该仓库的资源整理与开源分享表示感谢。若未特别说明，平台中的课本 PDF 与相关教材原始资源均以该仓库为来源基础，并在本系统内做分类、索引和教学场景适配。

除教材资源外，平台在产品设计和 AI 辅助教学方法上也持续参考公开研究、政策报告与教学技术开源项目。下面列出目前建议一并阅读或关注的外部参考链接，便于学校信息中心、教研团队和实施方建立统一认知。

如果学校后续需要把教材数据、AI 生成功能和教研流程进一步制度化，建议在白皮书、部署记录、教师培训材料和项目验收资料中同步保留以上引用，确保开源来源、研究依据与校内落地策略之间形成一致的文档链路。

本页信息既可用于正式采购、立项与技术交流，也可用于平台部署、接口集成和运维协同。建议在校内流转时与 API 文档、部署记录和资源治理制度一并归档，形成完整的项目文档包。