CourseMind

CourseMind 是「软件开发综合项目实训」课程的学习助手，运行在 Trae 与 Visual Studio Code 中，提供学号登录、AI 使用统计、班级排行榜与采集状态诊断。同一个 VSIX 可安装到两种 IDE，在同一台电脑的 Trae 与 VS Code 之间共享登录状态。

功能特性

账户信息：使用学号和密码登录，展示姓名、学号、教学班与上课教室，支持修改密码和退出登录。
今日 AI 使用：统计当天与本周的 AI 提问次数、会话数、平均轮次、多轮会话比例，以及主要主题分布和最近会话列表，并标注每条会话来自 Trae 还是 Claude。
班级使用排行：按教学班展示今日 / 本周提问次数排行榜（Top 5，前三名金银铜奖牌），自动高亮「我」的名次；不在前五时会在榜尾单独显示我的成绩。教师账号可切换查看所教的各个教学班。
双 IDE 共享登录：在 Trae 登录后，打开同一台电脑上的 VS Code 无需再次登录；任一 IDE 退出登录或修改密码，另一 IDE 自动同步。登录会话使用 Windows DPAPI 加密保存在本机当前用户目录。
多 AI 客户端：同时支持 Trae AI 与 Claude Code 的对话采集，两者的 Hook 配置互相独立、互不覆盖，已有的其他 Hook 会完整保留。
采集状态诊断：一键检查采集器部署、Hook 配置、待上传 / 失败记录和服务器连接，异常时给出明确的修复提示。
当前项目：自动识别工作区名称、Git 分支、仓库地址与技术栈。

在 Trae 或 Visual Studio Code 的扩展管理页面选择「从 VSIX 安装」，选中 coursemind-0.9.1.vsix，安装完成后重启 IDE。

从旧版（0.9.0 及以前）升级时，旧版扩展 ID 与新版不同，请先卸载旧版 CourseMind 再安装本版本，避免两个扩展并存。

点击左侧活动栏的 CourseMind 图标打开概览页，点击「登录 CourseMind」，输入学号和密码。登录成功后会显示姓名、学号、教学班和教室。

首次使用 Trae AI 前，请在 Trae 设置中启用「已配置的 Hooks」并选择「本地自动运行」。安装插件后重启 IDE，采集器会在后台自动部署，无需手动操作。

概览页从上到下依次为：

Claude Code 不会被自动接管。确认本机已安装 Claude Code 后：

在设置页点击「切换到校园网」或「切换到公网」即可即时切换，切换不会退出登录，本地待上传记录会继续补传。

在扩展设置中搜索 CourseMind，或点击设置页的「修改配置」直接定位到本扩展设置：

配置项	用途
`coursemind.serverUrl`	公网环境下使用的服务端地址（只需填写协议、主机和端口，不要加 `/api/v1`）
`coursemind.networkEnvironment`	网络环境：`public`（公网）或 `campus`（校园网）
`coursemind.serverUrlCampus`	校园网服务端地址；留空时自动回退使用公网地址
`coursemind.classroom`	本机所在教室；一般无需填写，登录身份中的教室会自动生效，适合机房统一预置

课堂配发的 VSIX 已内置正确的服务端地址，学生通常不需要修改任何配置。

Q：提示「服务器连接失败」怎么办？ 检查当前网络环境（校园网 / 公网）与对应服务器地址是否正确，并在浏览器中访问服务器地址的 /health 确认网络可达。设置页也提供「测试服务器连接」入口。

Q：使用 Claude Code 对话后没有统计数据？ Claude Code 需要先在设置页主动执行一次「配置 AI 客户端」。配置后可在设置页的采集状态中确认 Hook 是否正常。

Q：排行榜没有显示？ 排行榜需要服务端同步升级；旧版服务端会自动隐藏该卡片，不影响其他功能。若确认服务端已升级仍不显示，请联系老师确认你的行政班是否已编入教学班。

Q：Trae 和 VS Code 里都要登录吗？ 不需要。同一台电脑、同一个 Windows 用户下，在任一 IDE 登录后，另一个 IDE 会自动识别；退出登录也会双向同步。

Q：采集会影响 AI 工具的正常使用吗？ 不会。采集 Hook 在对话事件后异步执行，Hook 失败或网络异常不会阻塞 AI 回复，也不会修改你的对话内容。