优趣优智教学助手 VSCode 插件
这是一个专为优趣优智（UQUAI）教学平台设计的 VSCode 插件，支持与 uquai.com 平台进行交互，包括授权登录、班级管理、项目下载和上传等功能。
功能特性
- 🔐 OAuth授权登录: 支持跳转到 uquai.com 进行授权登录
- 👥 班级管理: 查看和管理你的教学班级
- 📚 课程资源: 浏览班级课程和章节资源
- 📥 项目下载: 支持下载指定项目的 zip 包到本地并自动解压
- 📤 项目上传: 支持将当前工作区打包并上传到 uquai.com
- 🗑️ 项目删除: 支持删除已上传的项目
- 🔄 项目更新: 支持更新已上传的项目
安装
从 VS Code Marketplace 安装
- 在 VS Code 中打开扩展面板（Ctrl+Shift+X）
- 搜索 "优趣优智教学助手"
- 点击安装
从源码安装
- 克隆此仓库到本地
- 运行
npm install 安装依赖
- 运行
npm run compile 编译 TypeScript 代码
- 在 VS Code 中按 F5 启动调试模式
界面介绍
插件在 VS Code 左侧活动栏添加了 "优趣优智" 图标，点击后展开三个主要功能区域：
1. 我的班级
- 显示你参与的所有班级
- 点击班级可展开查看课程列表
- 点击课程可查看章节资源
- 支持刷新班级列表
2. 我的项目
- 显示你创建的所有项目
- 支持任务挑战和创意天地两种类型
- 提供删除、更新、刷新等操作
- 支持分页加载更多项目
3. 功能操作
详细操作流程
1. 首次使用 - 登录授权
方法一：通过状态栏登录
- 查看 VS Code 底部状态栏，点击 "未登录" 状态
- 浏览器自动打开 uquai.com 授权页面
- 完成授权后，将授权码复制到剪贴板
- 回到 VS Code，插件自动检测并完成登录
方法二：通过命令面板登录
- 按
Ctrl+Shift+P 打开命令面板
- 输入 "优趣优智（UQUAI）: 登录授权" 并选择
- 按照上述步骤完成授权
登录成功后
- 状态栏显示 "已登录" 状态
- 自动刷新班级和项目列表
- 显示 "登录成功，数据已刷新！" 提示
2. 班级管理
查看班级列表
- 点击左侧 "优趣优智" 图标
- 展开 "我的班级" 区域
- 查看所有参与的班级
查看课程资源
- 点击班级名称展开课程列表
- 点击课程名称查看章节
- 点击章节查看附件资源
刷新班级数据
- 点击班级区域标题栏的刷新按钮
- 或使用命令 "优趣优智（UQUAI）: 刷新班级"
3. 项目管理
查看项目列表
- 展开 "我的项目" 区域
- 查看所有创建的项目
- 项目按类型分类显示
下载项目
- 点击项目名称
- 选择保存位置
- 插件自动下载并解压项目
- 自动初始化 Python 环境（如果适用）
上传新项目
- 点击 "功能操作" 中的 "上传作品"
- 选择要上传的文件夹或文件
- 输入项目名称
- 等待上传完成
更新项目
- 右键点击项目名称
- 选择 "更新作品"
- 选择要更新的文件或文件夹
- 等待更新完成
删除项目
- 右键点击项目名称
- 选择 "删除此作品"
- 确认删除操作
刷新项目列表
- 点击项目区域标题栏的刷新按钮
- 或使用命令 "优趣优智（UQUAI）: 刷新作品"
4. 退出登录
- 按
Ctrl+Shift+P 打开命令面板
- 输入 "优趣优智（UQUAI）: 退出登录" 并选择
- 确认退出操作
配置说明
- 自动登录: 插件会自动保存登录令牌，下次启动时自动登录
- 网络配置: 确保网络连接正常以访问 uquai.com API
- 文件权限: 确保有足够的文件系统权限进行项目操作
故障排除
登录问题
- 确保网络连接正常
- 检查 uquai.com 服务状态
- 尝试重新授权登录
上传失败
- 检查文件大小是否超限
- 确保网络连接稳定
- 验证项目格式是否正确
下载失败
- 检查项目是否仍然存在
- 确保有足够的磁盘空间
- 验证网络连接
许可证
MIT License
支持
如有问题或建议，请通过以下方式联系：
- 在 VS Code Marketplace 中留下评论
- 提交 GitHub Issue
- 联系优趣优智技术支持
| |
