SVSmate

The Ultimate VS Code Extension for SUSTechers

Request Feature · Report Bug · 中文文档 »

🚀 About the Project

This project originated as the final project for the Spring 2025 CS304 - Software Engineering.

Our goal is to develop a powerful and user-friendly VS Code extension tailored for SUSTechers, aiming to simplify their academic workflows — particularly operations related to Blackboard.

✨ Key Features

• 🔗 Seamlessly connect VS Code with your personal Blackboard data
• 📅 Automatically sync your schedule and assignments, and manage them with ease
• 🤖 Handle tasks more efficiently with AI-powered assistance
• 🤝 Collaborate on files with teammates in real time 🚧 In Development
• 📄 Extract code snippets from PDF course materials 🚧 In Development

💾 Installation

SVSmate can be installed via the VS Code Marketplace »

Or download .vsix manually in Release ».

🛠️ Usage

🔗 Blackboard Crawler

[!TIP] To ensure this feature works correctly, please configure your Blackboard Settings as shown below:

You can choose to update the entire course database, a specific semester, or individual course materials manually.
The extension also intelligently downloads Blackboard documents directly into your workspace.
Dive in and streamline your academic workflow!

[!WARNING] Better check your VPN status before start crawling.

📅 Task Scheduler

Manage your SUSTech tasks effortlessly in VS Code. Tasks can be imported directly from Blackboard, as shown below:

[!TIP] Click the calendar icon at the bottom of the Blackboard Calendar.

Paste your Blackboard calendar link to import tasks.
Once imported, you're free to edit, organize, and schedule them as you like.

🤖 AI-Powered Features

Currently tested with the Deepseek API, though other APIs should also work in theory.

After configuring your API key, you can:

1. Chat with your API agent: @mate-API
2. Automatically download Blackboard files to the correct directory
3. Generate intelligent subtask breakdowns
4. Read PDFs and extract code into files

Unlock the power of automation and AI to supercharge your study experience!

📄 Code Extractor

🚧 In Development

🤝 Collaborate Editing

🚧 In Development

📖 Documentation

Click here to view our Develop Document »

💬 Contribute

Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement".

Don't forget to give our project a ⭐️! Thanks again!

1. Fork the Project
2. Create your Feature Branch
3. Commit your Changes
4. Push to the Branch
5. Open a Pull Request

✅ TODO

• [ ] Add last update time in BB vault
• [ ] Add Chinese Document

💡 Planned Features

• Real-time collaboration (in development)
• PDF snippet extractor (in development)

👥 Contributors:

📜 License

Distributed under the MIT License. See LICENSE.txt for more information.