技术可行性与部署方案评估

《人工智能应用基础》课程 + OpenWorker智能体 · 2026-08-05

一、当前已验证状态

已跑通的环节：OpenWorker已在本机Windows上成功运行，Qwen3.7-max模型可用，后端API（127.0.0.1:8765）和前端GUI均已正常工作。

已验证清单

组件状态说明
OpenWorker后端✓ 运行中FastAPI，端口8765，PID活跃
OpenWorker前端✓ 可用Vite dev server，端口5174
Qwen3.7-max（文本）✓ 已验证阿里云百炼，OpenAI兼容端点
Doubao（豆包）✓ 已配置火山引擎Ark，API Key已设
PowerShell执行✓ 已修复绝对路径修复，shell工具正常
课程规划报告✓ 已生成HTML报告+3张ECharts图表
工单✓ 已创建交互式HTML，支持拖拽
超星数字教材平台✓ 已确认i.chaoxing.com，支持多模态、AI辅助、知识图谱
智雅智能体平台✓ 已确认zhiya.chaoxing.com，工作流+知识库+插件
Gitee代码托管✓ 已确认国内访问稳定，免费私有仓库，中文界面
AI辅助教学管理方案✓ 已生成三层架构，反馈/作品/进度AI辅助

二、OpenWorker架构约束分析

OpenWorker的设计定位是单用户本地智能体（local sidecar），而非多用户服务端。以下是关键架构约束：

约束项当前状态对课程的影响严重程度
绑定地址 127.0.0.1:8765 仅本机可访问，学生无法从其他机器连接 关键
CORS策略 仅允许localhost/tauri来源 学生浏览器无法直接调用API 关键
用户认证 无（本地sidecar token） 多用户场景下无法区分学生、无法限流 中等
并发能力 单进程异步 30+学生同时使用可能排队 中等
会话隔离 共享workspace 学生之间可能看到彼此的对话和文件 中等
图像/视频/音频API 仅支持OpenAI兼容端点 通义万相等需DashScope原生API，OpenWorker无法直接调用 中等

核心结论：OpenWorker适合教师演示和高级项目（07/10）使用，但不适合作为全班30+学生的统一API网关。课程需要采用分层架构。

三、各项目技术可行性逐项评估

项目核心AI能力API可达性OpenWorker支持学生端可行性综合评级
01 品牌内容工坊 文本生成 ✓ Qwen API已配置 ✓ 完全支持 ✓ 学生直接用API或网页版 立即可用
02 视觉创意设计室 图像生成 △ 通义万相需原生API ✗ OpenWorker不支持 ✓ 学生用网页版（即梦/可灵） 网页版可行
03 短视频创作 视频生成 △ 可灵/即梦为网页产品 ✗ 不支持 ✓ 学生用网页版+剪映 网页版可行
04 有声内容 语音合成TTS △ CosyVoice需原生API ✗ 不支持 ✓ 学生用网页版（海螺AI等） 网页版可行
05 文档智能分析 OCR+信息抽取 ✓ Qwen-VL可用 △ 多模态需测试 ✓ Python+API直接调用 基本可行
06 数据洞察 代码解释器+分析 ✓ Qwen API已配置 ✓ 完全支持 ✓ Python+API直接调用 立即可用
07 校园智能助手 RAG+对话 ✓ Qwen Function Call ✓ 核心场景 △ 需部署OpenWorker或用Dify 需额外部署
08 个性化辅导 自适应学习 ✓ Qwen API △ OpenWorker可编排 △ 需开发原型系统 需开发工作
09 AI辅助开发 代码生成 ✓ Qwen API/Trae ✓ 代码工具可用 ✓ 学生装Trae/通义灵码 立即可用
10 多智能体协作 Agent编排 ✓ Qwen+OpenWorker ✓ 核心场景 △ 需OpenWorker运行环境 教师演示为主

可行性总结：10个项目中，4个"立即可用"（01/05/06/09），3个"网页版可行"（02/03/04），3个"需额外部署或开发"（07/08/10）。无"不可行"项目。

四、部署方案（2026-08-05 最终版）

架构简化：经过深入调研，确认了三个关键事实：① Gitee高校版有GitHub Classroom等价能力（班级管理+代码作业+自动测试+评分）；② 超星平台内置作业管理和学情分析（无需飞书）；③ Cloudflare Pages国内访问稳定（优于Vercel）。因此，平台依赖从7个降至3+1（超星+Gitee+Cloudflare + OpenWorker教师机）。

方案B：精简三层架构（最终推荐）

架构：超星平台承担课程内容+作业+学情+课程AI助手；Gitee高校版承担代码托管+代码作业+评审；Cloudflare Pages承载工单和仪表盘；OpenWorker仅教师机运行做演示

┌──────────────────────────────────────────────────────────┐ │ 超星平台 (云端) │ │ ┌──────────────────────┐ ┌──────────────────────┐ │ │ │ 超星数字教材+学习通 │ │ 智雅智能体平台 │ │ │ │ i.chaoxing.com │ │ zhiya.chaoxing.com │ │ │ │ ──────────────────── │ │ ──────────────────── │ │ │ │ ·课程内容(数字教材) │ │ ·课程AI助手 │ │ │ │ ·知识图谱 │ │ ·课程AI助手 │ │ │ │ ·AI写作/校对 │ │ ·工作流编排 │ │ │ │ ·学情分析(内置) │ │ ·知识库集成 │ │ │ │ ·数字人授课 │ │ ·第三方链接接入 │ │ │ │ ·作业管理(内置) │ │ │ │ │ │ ·讨论区(反馈收集) │ │ │ │ │ │ ·AI自动批改 │ │ │ │ │ └──────────────────────┘ └──────────────────────┘ │ └──────────────────────────────────────────────────────────────┘ │ │ ┌──────┴──────┐ ┌───────┴───────┐ │ 学生端 │ │ 教师端 │ │ 学习通APP │ │ 浏览器登录 │ │ 或浏览器 │ │ 智雅工作台 │ └─────────────┘ └───────────────┘ ┌──────────────────────────────────────────────────────────┐ │ Gitee 高校版 (云端) │ │ ┌──────────────────────────────────────────────────────┐ │ │ │ ·代码托管(免费私有仓库) ·班级/团队管理 │ │ │ │ ·代码作业(自动分发) ·在线批改/评阅 │ │ │ │ ·代码扫描+单元测试 ·自动评分 │ │ │ │ ·代码评审(PR) ·多角色权限 │ │ │ │ ·过程数据记录 ·国内毫秒级访问 │ │ │ │ 2500+高校使用 ·学生手机号注册 │ │ │ └──────────────────────────────────────────────────────┘ │ └──────────────────────────────────────────────────────────────┘ ┌──────────────────────────────────────────────────────────┐ │ Cloudflare Pages (全球CDN, 免费) │ │ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │ │ │ 工单 │ │ AI仪表盘 │ │ 学生作品集 │ │ │ │ (静态HTML) │ │ (Pages+D1) │ │ (静态页面) │ │ │ │ xxx.pages.dev │ │ Workers API │ │ 自动部署 │ │ │ └──────────────┘ └──────────────┘ └──────────────┘ │ │ 无限带宽 · 500次构建/月 · 国内访问稳定 │ └──────────────────────────────────────────────────────────────┘ ┌──────────────────────────────────────────────────────────┐ │ 教师机 (本地, 非服务器) │ │ ┌──────────────────────┐ ┌──────────────────────┐ │ │ │ OpenWorker (演示用) │ │ Python+Qwen API │ │ │ │ :8765 │ │ (AI分析脚本) │ │ │ │ 项目07/10演示 │ │ 反馈分析/评估/进度 │ │ │ └──────────────────────┘ └──────────────────────┘ │ │ 无需专用服务器，教师笔记本即可 │ └──────────────────────────────────────────────────────────────┘

平台对比：旧方案 vs 新方案

功能旧方案(7平台)新方案(3+1)简化原因
课程内容静态HTML → GitHub Pages超星数字教材多模态+AI辅助+知识图谱+学情分析
作业管理飞书多维表格超星内置作业管理超星自带作业批改+学情统计，无需额外平台
学生反馈飞书表单+AI字段超星讨论区+作业评语超星讨论区+AI自动批改分析，足够用
代码托管GitHub ClassroomGitee高校版有Classroom等价能力，国内访问稳定
代码作业GitHub ClassroomGitee高校版代码作业自动分发+测试+评分，功能等价
进度追踪飞书多维表格超星学情+Gitee提交记录两个平台都有内置统计
仪表盘/看板校内NginxCloudflare Pages免费CDN，国内访问稳定，无需服务器
课程AI助手OpenWorker智雅平台官方平台，零部署
AI分析飞书AI字段Python+Qwen API(本地)脚本本地运行，结果导出报告
OpenWorker教师机/专用机仅教师机演示不需要专用服务器，不需要学生访问

学生端工具清单（极简）

工具用途注册方式费用
超星学习通课程内容+作业+讨论学校统一账号（已有）免费
Gitee代码项目提交+评审手机号（5分钟）免费
Python + VS Code编写代码+调用API无需注册免费
浏览器访问AI工具+Cloudflare看板无需注册免费

全程无需VPN · 无需境外账号 · 无需飞书 · 无需专用服务器

为什么去掉飞书？

维度保留飞书去掉飞书（用超星+Gitee）
学生平台数4个（超星+Gitee+飞书+浏览器）3个（超星+Gitee+浏览器）
学生未来使用概率飞书在企业中覆盖率有限超星和Gitee技能在教育和IT行业通用
作业管理飞书多维表格（需手动建表）超星内置作业管理（自动统计）
学情分析飞书无内置学情分析超星内置学情分析（出勤/完成率/正确率）
反馈收集飞书表单+AI分类超星讨论区+作业评语（足够）
AI深度分析飞书AI字段Python+Qwen API脚本（更灵活）
协作编辑飞书云文档超星云盘（文件上传下载）
学习成本学生需学飞书超星学习通学生已熟悉

为什么用Cloudflare而不是Vercel？

对比项Cloudflare PagesVercel
免费带宽无限100GB/月
国内访问稳定（全球300+CDN节点）较慢（需优选IP）
免费构建500次/月100次/月
ServerlessWorkers 10万次/天Serverless Functions
数据库D1 5GB免费无（需外接）
免费域名xxx.pages.devxxx.vercel.app
适合本课程静态看板+仪表盘+轻量API全栈Web应用

Cloudflare Pages 可承载：工单HTML（静态）、AI分析仪表盘（Pages+Workers+D1）、学生作品集展示页面。全部免费，国内可访问。

为什么OpenWorker不需要专用服务器？

问题回答
OpenWorker支持多用户并发吗？不支持。设计为单用户本地sidecar，无用户认证、无会话隔离、无并发管理
学生需要访问OpenWorker吗？不需要。学生直接调用Qwen API或用网页工具
项目07(RAG)怎么办？学生用Python+Chroma+Qwen API自己搭建，不需要OpenWorker
项目10(多智能体)怎么办？教师机演示OpenWorker，专题展示用智雅平台部署
课程AI助手部署在哪？智雅平台（零部署），不是OpenWorker
OpenWorker的角色是什么？教师开发和演示工具，不是生产服务

优点：课程内容专业规范（数字教材）、平台合规、学生零门槛（无需注册境外账号）、国产工具链稳定、平台依赖最少

缺点：超星平台需熟悉编辑流程，智雅平台自定义能力有限，Gitee Pages已下线需用Cloudflare替代

五、平台选型深度研判（2026-08-05 修订）

针对"OpenWorker是否需要专用服务器"、"Gitee是否有Classroom能力"、"作品收集方案"、"Cloudflare与Gitee集成"等关键问题，逐一研判如下。

5.1 OpenWorker 是否需要专用服务器？

结论：不需要，也不应该。OpenWorker是单用户本地sidecar架构，从设计基因上就不支持多用户服务端部署。强行改造的代价相当于重写产品，且存在严重安全风险。

源码级架构约束

约束项源码位置具体问题严重程度
sidecar生命周期run.py父进程（GUI）退出后服务器自动 os._exit(0) 自杀，无法作为常驻服务致命
单全局令牌app.py:182-206每次启动生成一个共享token，无用户表、无user_id、无RBAC致命
单DB无会话隔离manager.py"Storage is a single DB...sessions span folders"，所有学生对话/文件全局可见致命
CORS锁死loopbackapp.py:25-37仅允许 tauri://localhost、127.0.0.1，防止任意网页跨域调用高
Shell工具暴露RCEtools/shell.pyAgent拥有宿主机shell权限，开放到网络等于把RCE交给所有学生致命
单进程单workerrun.py:165uvicorn单进程，30并发agent turn会迅速打满事件循环高
共享API Keyconfig.pyBYOK模式只有一把模型key，30人共用会触发上游rate limit，费用无法按人分摊高

三种部署方案可行性对比

方案可行性分析
A) 专用服务器供全班用 ✗ 不可行 缺多租户层、缺会话隔离、shell工具暴露RCE。改造成本≈重做产品。若用Dify/FastGPT替代可实现多用户服务端，但那已不是OpenWorker。
B) 教师机本地运行做演示 ✓ 推荐 完全契合sidecar设计：单用户、本地loopback、投屏演示。用于项目07/10核心演示和AI教学助手。仅需教师自备模型API key。
C) 每个学生本地安装 △ 有条件可行 天然实现会话隔离，符合local-first哲学。但需每人自备API key + Windows环境配置（PowerShell绝对路径等），适合计算机专业小班。

若需多用户服务端智能体：建议使用Dify（Docker一键部署，原生多租户+工作空间隔离+用户管理，30人并发建议8C/16G）或FastGPT（知识库导向），而非改造OpenWorker。这些平台从设计之初就是多用户服务端架构。

5.2 Gitee 与 GitHub 能力对比

结论：核心Git能力基本一致。代码托管、PR/MR、Issues、Wiki、Webhook、CI/CD等核心工作流完全兼容。Gitee有对标GitHub Classroom的"Gitee高校版"，2500+高校在用。

能力维度GiteeGitHub教学影响
Git代码托管✓ 完全一致（额外支持SVN）✓学生学的git技能通用
Fork / Pull Request✓ 称Merge Request✓协作流程一致
Issues / Wiki / 标签✓✓项目管理一致
Webhook✓ 4类事件（Push/Tag/Issue/PR）✓CI/CD触发一致
CI/CD✓ Gitee Go✓ Actions（生态更强）Gitee Go满足教学需求
开放API✓ OpenAPI v5（REST）✓ REST + GraphQL都能被AI工具调用
教育版（Classroom）✓ Gitee高校版✓ GitHub Classroom核心等价
静态站点托管✗ Gitee Pages已下线（2024.07）✓ GitHub Pages需用Cloudflare替代
官方CLI工具✗ 无官方CLI（有社区第三方）✓ gh不影响，原生git可用
Codespaces（云端IDE）△ 基础WebIDE✓ 完整教学用本地IDE即可
国内访问速度✓ 毫秒级✗ 不稳定（需VPN）关键优势
学生注册门槛✓ 手机号✗ 需邮箱+可能翻墙关键优势
中文界面✓ 原生中文✗ 无降低学习门槛

Gitee高校版（对标GitHub Classroom）功能详情

功能Gitee高校版GitHub Classroom
班级/团队管理✓ 二维码/链接/邮件邀请，多角色权限，批量导入✓ 邀请链接，多角色
作业分发✓ 文本作业/代码作业/实训作业，课程通知一键直达✓ 代码作业为主
自动测试/评分✓ 代码扫描+单元测试+重复率检测+自动评分模型✓ 基于Actions的Autograder
代码评审✓ 在线批改/评阅，Fork页面查看提交，保护分支规则✓ PR评审
AI能力✓ AI算力支持+重复率检测△ 需自行集成
部署形态SaaS + 私有化部署SaaS
本土化✓ 原生中文+国内访问✗ 英文+访问不稳定
使用规模2500+高校，100万+师生全球广泛使用

数据来源：Gitee高校版官方页面 gitee.com/education；2026年1月开源技术纳入国家职教体系后已在全国超2000所高校落地。

5.3 Gitee CLI与API能力：AI工具能否直接推送内容？

结论：完全可以。虽然Gitee没有官方CLI工具，但有三条路径让AI工具直接推送内容到Gitee仓库：

路径方式适用场景可行性
① 原生git命令 git push 到 gitee.com 远程仓库（HTTPS/SSH） 开发者手动推送，与GitHub完全一致 ✓ 完全可用
② OpenAPI v5 通过PAT（个人访问令牌）调用REST API：创建文件 POST /repos/{owner}/{repo}/contents/{path}、批量提交 POST /repos/{owner}/{repo}/commits AI工具/脚本直接推送内容，无需本地git环境 ✓ 推荐
③ MCP码云工具服务器 配置 GITEE_PERSONAL_ACCESS_TOKEN，AI Agent调用 create_or_update_file、push_files 等MCP工具 AI Agent直接操作Gitee仓库（最自然） ✓ 最适合AI
④ 社区CLI ge（gitee-cli）等第三方工具，对标GitHub gh 命令行操作，功能有限 △ 可选

具体操作示例（AI工具推送内容到Gitee）：

# 1. 学生或教师创建Gitee Personal Access Token # 设置 → 私人令牌 → 勾选 projects, issues, user 权限 # 2. AI工具通过API直接创建/更新文件 curl -X POST "https://gitee.com/api/v5/repos/{owner}/{repo}/contents/{path}" \ -H "Content-Type: application/json" \ -d '{ "access_token": "你的PAT", "content": "base64编码的文件内容", "message": "AI自动提交：更新工单", "branch": "main" }' # 3. 或通过MCP工具服务器（AI Agent原生集成） # 配置 GITEE_PERSONAL_ACCESS_TOKEN 环境变量 # AI Agent即可调用 push_files 工具批量推送多个文件

5.4 Cloudflare Pages 能否从 Gitee 推送部署？

事实：Cloudflare Pages 原生仅支持 GitHub 和 GitLab，不支持 Gitee。但有三条可行的集成路径：

方案原理自动化程度推荐度
A) wrangler CLI直接上传 npx wrangler pages deploy ./dist 直接上传构建产物，完全不依赖任何Git仓库 手动/脚本触发 ✓ 最推荐
B) Gitee → GitHub镜像同步 Gitee仓库设置"镜像管理"自动同步到GitHub，Cloudflare Pages连接该GitHub仓库自动部署 全自动 ✓ 可选
C) CI/CD + wrangler Gitee Go流水线构建完成后，用 wrangler pages deploy 直接上传 全自动 ✓ 可选

推荐方案A的工作流（教师端）：

# 教师本地构建工单HTML # 然后用wrangler一键部署到Cloudflare Pages # 首次安装 npm install -g wrangler wrangler login # 浏览器授权 # 创建项目 npx wrangler pages project create teachagent-kanban # 每次更新后部署 npx wrangler pages deploy ./genai-projects --project-name=teagent-kanban # 部署后访问 https://teagent-kanban.pages.dev # 国内可正常访问（pages.dev未被墙）

Cloudflare Pages 国内访问实测（2026年数据）

指标Cloudflare PagesVercel说明
默认域名可用性*.pages.dev 未被墙*.vercel.app 已被墙关键差异
国内加载时间~4.8秒（免费版）不可用（需自定义域名）CF免费版偏慢但可用
延迟（TTFB）~180ms起N/A香港/东京边缘节点
免费带宽无限100GB/月CF更优
免费构建500次/月100次/月CF更优
ServerlessWorkers 10万次/天Serverless Functions均可
数据库D1 5GB免费无（需外接）CF更优
优化方案绑定自定义域名+国内CDN分流（如腾讯云EdgeOne）可将加载降至~1.3秒需自定义域名均可优化

数据来源：php中文网实测(2026-06)、CSDN用户对比(2025-09)、V2ex社区讨论(2025-02)。Cloudflare China Network（国内节点）需Enterprise版+ICP备案，普通免费版走海外边缘节点。

5.5 作品收集方案研判：超星云盘 vs Gitee vs 飞书

结论：代码类作品用Gitee仓库提交，非代码类作品（图片/视频/文档）用超星作业管理+云盘上传。不引入飞书，避免额外平台依赖。

作品类型收集方案理由
代码项目（项目01/05/06/07/08/09/10） Gitee高校版代码作业 自动分发+提交+测试+评分+评审，完整Git流程，过程数据可追溯
图片/海报/设计稿（项目02） 超星作业管理上传 超星内置作业管理支持文件上传，自动统计提交情况，无需额外平台
视频/音频（项目03/04） 超星云盘上传 + Gitee提交代码/脚本 大文件走超星云盘（支持上传下载），代码/提示词走Gitee
分析报告/文档（项目05/06/08） Gitee仓库（Markdown/PDF） 报告随代码一起提交，版本可追溯
作品集展示 Cloudflare Pages静态页面 从Gitee仓库自动生成作品集页面，公网可访问

为什么不引入飞书？

维度引入飞书不引入飞书（超星+Gitee）
学生平台数4个（超星+Gitee+飞书+浏览器）3个（超星+Gitee+浏览器）
学生未来使用概率飞书在企业中覆盖率有限，职业院校毕业生更可能用钉钉/企业微信超星和Gitee技能在教育和IT行业通用
作业管理飞书多维表格（需手动建表+配置AI字段）超星内置作业管理（自动统计+AI批改）
学情分析飞书无内置学情分析超星内置学情分析（出勤/完成率/正确率）
反馈收集飞书表单+AI分类超星讨论区+作业评语（足够）
AI深度分析飞书AI字段（受限于平台能力）Python+Qwen API脚本（更灵活，可自定义）
协作编辑飞书云文档（实时协作）超星云盘（文件上传下载）+ Gitee（代码协作）
学习成本学生需额外学飞书超星学习通学生已熟悉，Gitee注册5分钟
平台依赖风险多一个平台依赖，飞书政策可能变化平台最少，依赖最轻

关于超星云盘的局限性：超星云盘确实只支持文件上传下载，无法git同步——但这不影响教学。代码类作品通过Gitee仓库提交（有完整git流程），非代码类作品（图片/视频/文档）通过超星作业管理上传即可。只有需要版本管理的文件才需要git，而那些文件本就应该在Gitee上。

六、推荐部署计划（分阶段）

第一阶段：开课前准备（开学前2周）

任务负责技术方案工时
超星数字教材创建教师登录i.chaoxing.com，创建课程数字教材，将genai-projects.html内容迁移为数字教材章节8h
智雅平台智能体创建教师登录zhiya.chaoxing.com，创建课程AI助手智能体，配置知识库（教材内容+FAQ）6h
工单部署到Cloudflare教师npx wrangler pages deploy 一键部署到Cloudflare Pages1h
API Key准备教师阿里云百炼创建子账号，设配额2h
学生环境清单教师编写安装指南（Python+VS Code+Gitee注册）2h
OpenWorker演示机配置教师保持本地127.0.0.1运行，投屏演示0.5h
测试Qwen-VL多模态教师验证项目05/07所需的OCR能力2h
Gitee高校版组织创建教师注册Gitee高校版，创建班级/团队，建立项目仓库模板2h
超星作业管理配置教师在超星平台配置各项目作业模板（文件上传+代码作业链接）2h

第二阶段：课程运行中（按项目）

项目部署方式学生端工具教师端
01 品牌内容学生直连APIPython+Qwen API 或 通义千问网页版OpenWorker演示
02 视觉设计网页版工具即梦AI/可灵AI网页版 + Canva通义万相API演示
03 短视频网页版+本地可灵AI网页版 + 剪映桌面版同上
04 有声内容网页版+本地海螺AI/CosyVoice网页版 + AudacityTTS API演示
05 文档分析学生PythonPython+Qwen-VL API + PandasOpenWorker演示
06 数据洞察学生PythonJupyter+Qwen API+PandasOpenWorker演示
07 校园助手OpenWorkerPython+Chroma+FastAPIOpenWorker核心使用
08 辅导系统学生PythonPython+Gradio+Qwen APIOpenWorker演示
09 代码开发学生IDETrae IDE / VS Code+通义灵码OpenWorker演示
10 智能体编排OpenWorkerPython+OpenWorker APIOpenWorker核心使用

第三阶段：高阶打磨（课程后期）

七、OpenWorker局域网配置（可选）

注意：以下修改仅限教室局域网演示场景，且仅对教师本人投屏使用。不推荐让学生直接连接OpenWorker，原因见第5.1节源码级架构约束分析。

1. 修改绑定地址

# C:\Users\PC\AppData\Roaming\coworker\config.toml host = "0.0.0.0" # 原为 127.0.0.1 port = 8765

2. 放开CORS（app.py）

# coworker/server/app.py 第32行 # 增加教室网段，例如 192.168.x.x _ALLOWED_ORIGIN_RE = re.compile( r"^(tauri://localhost" r"|https?://localhost(:\d+)?" r"|https?://127\.0\.0\.1(:\d+)?" r"|https?://tauri\.localhost" r"|https?://192\.168\.\d+\.\d+(:\d+)?" # 新增：教室网段 r")$" )

3. 前端Vite配置

# surfaces/gui/vite.config.ts server: { host: '0.0.0.0', // 允许局域网访问 port: 5174, }

安全提示：以上修改仅适用于教室局域网环境。若部署到公网，必须增加认证层（Basic Auth / API Key）和HTTPS。

八、API成本估算（按30人/学期）

项目API用量/人30人总用量费用估算说明
01 文本生成~500次调用15,000次~0元百炼免费额度覆盖
05 OCR+文档~100次调用3,000次~0元Qwen-VL免费额度
06 数据分析~200次调用6,000次~0元百炼免费额度
07 RAG对话~1,000次调用30,000次~50-100元超出免费额度部分
10 智能体编排~500次调用15,000次~30-50元多轮对话消耗
学期总API成本~100-200元阿里云百炼免费额度极充足

成本结论：阿里云百炼的免费额度对教学场景极为友好。30人班级一学期的API成本预计在100-200元以内，几乎可忽略。图像/视频/音频生成项目主要用网页版工具（即梦/可灵/海螺均有免费额度），无需额外API费用。

九、风险矩阵与应对

风险概率影响应对措施
阿里云百炼免费额度调整 低高备用方案：DeepSeek免费API + 豆包免费额度
教室网络不稳定 中中课件本地缓存，关键操作提供离线方案
学生Python环境差异 高低提供Docker镜像或requirements.txt+安装指南
OpenWorker在课堂环境崩溃 低中教师提前重启，关键项目有Python直连方案兜底
图像/视频工具网页版限流 中低多平台备选（即梦+可灵+通义万相轮换）
学生API Key泄露 中高使用教师共享Key+配额限制，不给学生管理Key
超星平台编辑流程不熟悉 高低开课前参加超星培训，参照已有数字教材案例
智雅平台自定义能力有限 中中复杂场景用OpenWorker补充，智雅负责课程展示和基础AI助手
Gitee企业版功能限制 低低免费版满足教学需求，高级功能可选升级

十、结论

总体评估：技术可行性高，可立即启动。

具体结论如下：

下一步行动：建议优先完成三件事：①登录超星数字教材平台创建课程教材；②登录智雅平台创建课程AI助手原型；③创建Gitee组织和项目仓库模板。三件事可并行推进。OpenWorker的网络开放修改可在项目07开始前（约第7周）完成。

← 返回课程规划报告 ｜ 工单 → ｜ AI教学管理方案 →