平台内容规划

Gitee · Cloudflare · 超星 · 本地 — 各放什么、怎么组织、学生怎么访问

一、之前的错误及修正

问题:之前将 HTML 报告文件(genai-projects.html、course-overview.html 等)推送到 Gitee 仓库,这是错误的。Gitee 是代码托管和课堂管理平台,不是用来展示 HTML 报告的。

文件之前放Gitee正确归属处理
course-overview.html错误Cloudflare从Gitee删除
genai-projects.html错误Cloudflare从Gitee删除
workorder-kanban.html错误Cloudflare从Gitee删除
deployment-feasibility.html错误Cloudflare(教师参考)从Gitee删除
ai-teaching-management.html错误Cloudflare(教师参考)从Gitee删除
credentials.md未推送仅本地无需处理

二、三个平台 + 一个本地的定位

平台角色学生如何访问核心内容
超星平台 课程内容层
学生学习主入口
学习通APP / 浏览器
登录 i.chaoxing.com
数字教材(教学内容)
作业(非代码类)
讨论区
学情分析
Gitee高校版 代码作业层
代码提交与评审
浏览器登录 Gitee
加入班级后接受作业
项目起始代码模板
代码作业分发
学生仓库(fork)
代码评审(PR)
Cloudflare Pages 展示层
公开Web内容
浏览器直接访问
无需登录
工单
课程总览页
学生作品集展示
教师参考文档
OpenWorker(本地) 教师演示层
非公开
仅教师本机
127.0.0.1:8765
项目07/10高级演示
AI教学助手原型

三、Gitee 高校版 — 代码作业层

定位

Gitee 是代码托管 + 课堂管理平台,对标 GitHub Classroom。学生加入班级后,接受代码作业,fork 起始代码到自己的仓库,完成后提交 PR 供教师评审。

仓库结构规划

建议创建一个课程模板仓库(teachagent-genai),包含所有项目的起始代码和模板。学生加入 Gitee 高校版班级后,按作业要求 fork 对应项目目录。

teachagent-genai/ # 课程模板仓库(教师维护) ├── README.md # 课程说明 + 使用指南 │ ├── projects/ # 10个项目起始代码 │ ├── 01-brand-content/ # 项目01:品牌内容工坊 │ │ ├── README.md # 任务说明 + 验收标准 │ │ ├── prompts/ # 提示词模板 │ │ │ └── brand-story-prompt.txt │ │ └── output-template/ # 交付物模板 │ │ └── brand-content.docx │ │ │ ├── 02-visual-design/ # 项目02:视觉创意设计室 │ │ ├── README.md │ │ └── prompts/ │ │ │ ├── 03-short-video/ # 项目03:短视频创作工作室 │ │ ├── README.md │ │ └── prompts/ │ │ │ ├── 04-audio-synthesis/ # 项目04:有声内容制作中心 │ │ ├── README.md │ │ └── prompts/ │ │ │ ├── 05-document-analysis/ # 项目05:合同/文档分析系统 │ │ ├── README.md │ │ ├── starter/ # Python起始代码 │ │ │ ├── main.py # 主程序骨架 │ │ │ ├── requirements.txt # 依赖清单 │ │ │ └── config.example.py # API配置示例 │ │ └── samples/ # 测试用文档 │ │ └── sample-contract.pdf │ │ │ ├── 06-data-insight/ # 项目06:商业数据洞察生成器 │ │ ├── README.md │ │ ├── starter/ │ │ │ ├── main.py │ │ │ ├── requirements.txt │ │ │ └── config.example.py │ │ └── samples/ │ │ └── sales-data.csv │ │ │ ├── 07-smart-assistant/ # 项目07:校园智能助手 │ │ ├── README.md │ │ ├── starter/ # RAG系统起始代码 │ │ │ ├── main.py │ │ │ ├── rag_engine.py │ │ │ ├── requirements.txt │ │ │ └── config.example.py │ │ └── knowledge-base/ # 知识库文档 │ │ └── campus-faq.md │ │ │ ├── 08-tutoring-system/ # 项目08:AI个性化辅导系统 │ │ ├── README.md │ │ ├── starter/ │ │ │ ├── main.py │ │ │ ├── learner_model.py │ │ │ ├── requirements.txt │ │ │ └── config.example.py │ │ └── samples/ │ │ │ ├── 09-code-dev/ # 项目09:AI辅助开发实战 │ │ ├── README.md │ │ ├── starter/ # 待开发项目骨架 │ │ │ ├── app.py │ │ │ └── requirements.txt │ │ └── tasks/ # 开发任务清单 │ │ │ └── 10-agent-orchestration/ # 项目10:多智能体协作平台 │ ├── README.md │ ├── starter/ # OpenWorker配置模板 │ │ ├── agent-config.toml │ │ └── workflow-template.md │ └── docs/ # 架构说明 │ ├── templates/ # 通用模板 │ ├── prompt-templates/ # 提示词模板库 │ │ ├── text-generation.md │ │ ├── image-generation.md │ │ └── code-generation.md │ ├── api-examples/ # API调用示例 │ │ ├── qwen-api-example.py # Qwen API调用 │ │ └── doubao-api-example.py # Doubao API调用 │ └── work-order-template.md # 工单模板说明 │ └── docs/ # 课程文档(供学生参考) ├── tool-evaluation-guide.md # 5D工具评估框架使用指南 └── work-order-system.md # 工单系统使用说明

学生如何使用

  1. 教师通过 Gitee 高校版创建班级,学生手机号注册后加入
  2. 教师发布代码作业(对应项目05-09有代码的项目)
  3. 学生接受作业后,Gitee 自动 fork 模板仓库到学生个人空间
  4. 学生在自己的仓库中完成代码开发,提交到指定分支
  5. 教师通过 Gitee 的代码评审功能批改,支持自动测试+人工评阅

不放什么

  • 不放 HTML 报告:报告是展示内容,放 Cloudflare
  • 不放凭据文件:credentials.md 仅本地保存
  • 不放字体/JS等资源:这些是Cloudflare静态资源
  • 不放 OpenWorker 源码:教师机本地保留

四、Cloudflare Pages — 展示层

定位

Cloudflare 承载需要公开访问的 Web 内容,学生无需登录即可通过浏览器访问。核心是工单和作品展示。

目录结构

teachagent-kanban.pages.dev/ # Cloudflare Pages 部署根目录 │ # 对应本地:d:\Dev\TeachAgent\genai-projects\ │ ├── index.html # 课程入口页(跳转到各子页面) ├── workorder-kanban.html # 工单(核心,学生日常使用) ├── course-overview.html # 课程总览(参考用) │ ├── genai-projects.html # 主报告(教师参考) ├── deployment-feasibility.html # 部署方案(教师参考) ├── ai-teaching-management.html # 教学管理方案(教师参考) │ ├── portfolios/ # 学生作品集展示(后续添加) │ ├── project-01/ # 按项目分类 │ └── project-07/ │ ├── _shared/ # 共享静态资源 │ ├── fonts/ # 字体文件 │ └── js/ │ └── echarts.min.js # 图表库 └── assets/ └── charts.js # 图表配置

学生访问方式

页面用途访问频率
工单查看/更新工单状态每节课
课程总览了解课程全貌学期初
学生作品集展示优秀作品项目结束时
教师参考文档教师查看规划偶尔

五、超星平台 — 课程内容层

定位

超星是学生学习的主入口,承载数字教材形式的课程内容、作业管理、讨论区和学情分析。课程内容需要以数字教材格式在 i.chaoxing.com 上重新编写。

内容规划

模块内容来源
数字教材10个项目的教学内容(原理讲解、操作指南、案例)从主报告拆分迁移
作业管理非代码类作业的发布、提交、批改超星内置功能
代码作业链接指向 Gitee 高校版的代码作业入口超星中放链接
讨论区学生提问、反馈收集超星内置功能
学情分析学习行为数据、成绩统计超星内置功能
工单链接指向 Cloudflare 工单的入口超星中放链接

数字教材章节规划

超星数字教材(i.chaoxing.com) ├── 课程导论 │ ├── "用AI,学AI"教学理念说明 │ ├── 工单系统使用指南 │ └── 5D工具评估框架说明 │ ├── 第一篇:内容生成(项目01-04) │ ├── 第1章:文本创作与文案(品牌内容工坊) │ ├── 第2章:图像生成与设计(视觉创意设计室) │ ├── 第3章:视频内容制作(短视频创作工作室) │ └── 第4章:音频与语音合成(有声内容制作中心) │ ├── 第二篇:理解分析(项目05-06) │ ├── 第5章:文档智能处理(合同分析系统) │ └── 第6章:数据分析与报告(数据洞察生成器) │ ├── 第三篇:交互服务(项目07-08) │ ├── 第7章:智能对话与咨询(校园智能助手) │ └── 第8章:个性化学习与教育(AI辅导系统) │ └── 第四篇:开发自动化(项目09-10) ├── 第9章:代码生成与开发(AI辅助开发实战) └── 第10章:智能体工作流编排(多智能体协作平台)

关键:超星中的每个章节应包含指向 Gitee 代码作业和 Cloudflare 工单的外部链接,形成三平台联动。

六、本地文件 — 仅教师保留

不公开的文件

文件/目录位置说明
credentials.mdd:\Dev\TeachAgent\凭据文件(Gitee PAT、CF Token等)
OpenWorker/d:\Dev\TeachAgent\OpenWorker\智能体源码,仅教师机运行
ai-industry-applications/d:\Dev\TeachAgent\ai-industry-applications\AI行业应用研究(参考资料)
secrets.json / .envC:\Users\PC\AppData\Roaming\coworker\API密钥配置

绝对不上传到任何公开平台的文件:

  • credentials.md — 含 Gitee PAT 和 Cloudflare API Token
  • secrets.json / .env — 含 AI 模型 API Key
  • OpenWorker 源码 — 含安全缺陷,不可公开

七、内容流转总表

哪些内容在哪个平台,一览:

内容超星GiteeCloudflare本地
课程教学内容(数字教材)
非代码作业发布与提交
代码作业起始模板
学生代码提交与评审
工单(交互式)链接
课程总览页链接
学生作品集展示
教师参考文档(报告)备份
讨论区/反馈收集
学情分析代码数据
OpenWorker演示
凭据/密钥仅本地
提示词模板库教材引用
API调用示例代码

八、待办事项

需要立即处理的:

  1. 清理 Gitee 仓库:删除之前错误推送的5个HTML文件
  2. 重建 Gitee 仓库结构:按上述规划创建 projects/、templates/、docs/ 目录
  3. 创建项目起始代码:为项目05-09编写Python起始代码模板

后续需要做的:

  1. 超星数字教材迁移:将课程内容按章节结构编写到超星平台
  2. 超星作业设置:在超星中创建作业,添加Gitee/Cloudflare外部链接
  3. Cloudflare入口页:创建 index.html 作为课程展示入口
  4. 学生作品集目录:在Cloudflare创建portfolios/目录结构
  5. Gitee高校版班级创建:在 edu.gitee.com 创建班级,配置作业