CourseMind
CourseMind 是「软件开发综合项目实训」课程的学习助手，运行在 Trae、Visual Studio Code 与 CodeBuddy IDE 中，提供学号登录、AI 使用统计、班级排行榜与采集状态诊断。同一个 VSIX 可安装到上述 IDE，在同一台电脑的多个 IDE 之间共享登录状态。
目前仅支持 Windows，暂不支持 macOS 与 Linux。
功能特性
- 账户信息：使用学号和密码登录，展示姓名、学号、教学班与上课教室，支持修改密码和退出登录。
- 今日 AI 使用：统计当天与本周的 AI 提问次数、会话数、平均轮次、多轮会话比例，以及主要主题分布和最近会话列表，并标注每条会话来自 Trae、Claude Code、CodeBuddy 还是 WorkBuddy。班级使用排行已并入该卡片内，位于卡片底部。
- 班级使用排行（已并入「今日 AI 使用」卡片内）：按教学班展示今日 / 本周提问次数排行榜（Top 5，前三名金银铜奖牌），自动高亮「我」的名次；不在前五时会在榜尾单独显示我的成绩。教师账号可切换查看所教的各个教学班。
- 多 IDE 共享登录：在任一个 IDE 登录后，打开同一台电脑上的其他 IDE 无需再次登录；任一 IDE 退出登录或修改密码，其他 IDE 自动同步。登录会话使用 Windows DPAPI 加密保存在本机当前用户目录。
- 多 AI 客户端：同时支持 Trae AI、Claude Code、腾讯 CodeBuddy 与腾讯 WorkBuddy 的对话采集，各自的 Hook 配置互相独立、互不覆盖，已有的其他 Hook 会完整保留。
- 采集状态诊断：一键检查采集器部署、Hook 配置、待上传 / 失败记录和服务器连接，异常时给出明确的修复提示。
- 当前项目：自动识别工作区名称、Git 分支、仓库地址与技术栈。
使用方法
1. 安装
在 Trae、Visual Studio Code 或 CodeBuddy IDE 的扩展管理页面选择「从 VSIX 安装」，选中 coursemind-0.9.2.vsix，安装完成后重启 IDE。
插件仅在 Windows 上工作，macOS 与 Linux 暂不支持；非 Windows 或远程开发（SSH / WSL / Dev Container）环境下只展示页面与服务端检测，不会部署采集器或写入 Hook。
从旧版（0.9.0 及以前）升级时，旧版扩展 ID 与新版不同，请先卸载旧版 CourseMind 再安装本版本，避免两个扩展并存。
2. 登录
点击左侧活动栏的 CourseMind 图标打开概览页，点击「登录 CourseMind」，输入学号和密码。登录成功后会显示姓名、学号、教学班和教室。
首次使用 Trae AI 前，请在 Trae 设置中启用「已配置的 Hooks」并选择「本地自动运行」（这是 Trae 特有的开关）。安装插件后重启 IDE，采集器会在后台自动部署，无需手动操作。
3. 查看统计与排行
概览页从上到下依次为：
- 账户信息：身份、教学班、教室，以及修改密码 / 退出登录入口；
- 当前项目：当前工作区与 Git 信息；
- 今日 AI 使用：提问、会话、轮次等指标与最近会话，并在卡片底部内嵌班级使用排行——点击「今日 / 本周」切换时间范围，榜单每 5 分钟自动刷新。
4. 配置 AI 客户端（可选）
Trae 会被自动接管；Claude Code、CodeBuddy、WorkBuddy 需要手动配置一次：
- 点击概览右上角齿轮图标进入设置页；
- 点击「配置 AI 客户端」；
- 插件会备份原有配置后写入采集 Hook，原有其他设置和 Hook 不受影响。
| 客户端 |
配置文件 |
说明 |
| Claude Code |
%USERPROFILE%\.claude\settings.json |
需在本机安装 Claude Code |
| 腾讯 CodeBuddy |
%USERPROFILE%\.codebuddy\settings.json |
CodeBuddy IDE 兼容 VS Code 扩展，可直接把本插件装进 CodeBuddy 使用；配置后即可采集，不需要像 Trae 那样再在设置里手动启用 Hooks |
| 腾讯 WorkBuddy |
%USERPROFILE%\.workbuddy\settings.json |
WorkBuddy 是独立客户端，无法把本插件装进去，但插件仍可采集它的 AI 对话 |
5. 切换校园网 / 公网（机房环境）
在设置页点击「切换到校园网」或「切换到公网」即可即时切换，切换不会退出登录，本地待上传记录会继续补传。
基本配置
在扩展设置中搜索 CourseMind，或点击设置页的「修改配置」直接定位到本扩展设置：
| 配置项 |
用途 |
coursemind.serverUrl |
公网环境下使用的服务端地址（只需填写协议、主机和端口，不要加 /api/v1） |
coursemind.networkEnvironment |
网络环境：public（公网）或 campus（校园网） |
coursemind.serverUrlCampus |
校园网服务端地址；留空时自动回退使用公网地址 |
coursemind.classroom |
本机所在教室；一般无需填写，登录身份中的教室会自动生效，适合机房统一预置 |
课堂配发的 VSIX 已内置正确的服务端地址，学生通常不需要修改任何配置。
常见问题
Q：提示「服务器连接失败」怎么办？
检查当前网络环境（校园网 / 公网）与对应服务器地址是否正确，并在浏览器中访问服务器地址的 /health 确认网络可达。设置页也提供「测试服务器连接」入口。
Q：使用 Claude Code / CodeBuddy / WorkBuddy 对话后没有统计数据？
这三个客户端不会自动接管，需要先在设置页主动执行一次「配置 AI 客户端」（Trae 会自动接管）。配置后可在设置页的采集状态中确认 Hook 是否正常。
Q：支持 macOS 或 Linux 吗？
暂不支持。当前版本只支持 Windows 本机，macOS 与 Linux 上插件只能展示页面和服务端连接状态，不会部署采集器或配置 Hook。
Q：排行榜没有显示？
排行榜需要服务端同步升级；旧版服务端会自动隐藏榜单区域，「今日 AI 使用」卡片的其余内容不受影响。若确认服务端已升级仍不显示，请联系老师确认你的行政班是否已编入教学班。
Q：Trae 和 VS Code 里都要登录吗？
不需要。同一台电脑、同一个 Windows 用户下，在任一 IDE 登录后，另一个 IDE 会自动识别；退出登录也会双向同步。
Q：采集会影响 AI 工具的正常使用吗？
不会。采集 Hook 在对话事件后异步执行，Hook 失败或网络异常不会阻塞 AI 回复，也不会修改你的对话内容。
隐私说明
- 登录会话仅保存在本机，使用 Windows DPAPI 按当前 Windows 用户加密，插件不读取、不上传密码。
- 采集内容仅包含课程学习所需的对话记录与项目上下文，随 VSIX 内置的上传凭证发送到课程服务端。
