LeetMate: 你的本地端智能算法辅导专家 🚀

LeetMate 是一款运行在 VS Code 内部的 AI 算法学习伙伴。它基于 Python FastAPI 后端与 VS Code 插件端（Vue 3 + Vite）构建，旨在为你提供一个无需切换编辑器的沉浸式力扣（LeetCode）刷题环境。

从自然语言找题、思路启发、代码编写，到本地测试/一键提交、学后复盘，LeetMate 让你在最熟悉的编码环境中完成完整的算法学习闭环。

👉 观看 LeetMate 完整功能演示 (Demo)

✨ 核心特性 (Key Features)

🤖 首创“双 Agent”协同架构

LeetMate 采用主从 Agent 隔离机制，确保主线进度与单题辅导互不干扰：

• 算法学习总管家 (Guide Agent)：你的全局规划师。负责识别题目、创建项目空间、维护你的个人能力画像，并能为你动态编排“热身复习 - 核心攻坚 - 拓展延伸”三模块专属学习计划。
• 单题专属教练 (Tutor Agent)：你的贴身陪练。当你进入特定题目时实例化并接管会话，它专注于单题全程辅导，能够实时读取当前工作区代码，提供错误排查与复杂度分析。

💡 启发式教学，拒绝“直接喂饭”

遇到卡点？Tutor 不会在未被要求时直接扔给你标准答案，而是像真实的面试官一样：

• 分析你的当前思路，肯定正确方向，提前指出潜在陷阱。
• 当你在某个 TODO 上停滞超过 3 分钟时，后台自动检测并温和介入，询问是否需要补充提示或模板代码。
• 代码跑通后，为你进行时间/空间复杂度估算，并引导你探索更优解法（如从 DFS 引导至并查集优化）。

🔄 高效本地刷题闭环

深度集成开源 leetcode-cli，支持 Python / Java / C++，核心操作全部在 VS Code 内完成：

• 智能项目脚手架：按难度（easy/medium/hard）自动创建归档目录，生成包含题目描述与官方函数签名的解题文件。
• 本地测试与提交：在侧边栏直接点击运行官方测试样例，结果以卡片展示；AC（通过）后一键提交至力扣云端，并自动触发 Tutor 的完成总结弹窗与 Guide 的复盘流程。

🔍 毫秒级智能识题 (RAG + 多路径检索)

忘记了原题叫什么？只需要告诉 Guide：“我今天面试遇到了接雨水那道题”。系统内置基于 Hot 100 的离线向量库，通过四种路径精准定位：

1. 题号路径：直接命中离线题库。
2. 描述路径 (RAG)：Query 去噪提取核心语义，结合向量召回与词法匹配双通道定位。
3. 平台搜索路径：调用 CLI 在力扣官网动态检索。
4. LLM 兜底路径：若非原题，由大模型结构化生成题目说明。

🛡️ 极高的安全与上下文精准度

• 当前文件精准对齐：系统实时监听活跃编辑器，当 Tutor 会话与你当前打开的代码文件不匹配时，自动弹出对齐提示，防止 AI “跨服辅导”。
• 操作熔断机制 (Human-in-the-loop)：拦截危险 Shell 命令；任何涉及文件写入、项目创建或代码提交的敏感操作，必须经过你的显式授权（卡片按钮确认）才会执行。

📊 Hot 100 刷题总览看板

在 Guide 主会话中随时唤起统计视图，直观查看当前 Hot 100 的完成进度、不同难度题目的通关数量，支持一键跳转对应力扣网页或查看本地历史代码快照。

🚀 快速开始 (Getting Started)

1. 基础配置引导

首次启动 LeetMate 欢迎页时，系统将通过可视化流程引导你完成初始化：

1. 选择站点：LeetCode 中国站 (leetcode.cn) 或 国际站 (leetcode.com)。
2. 选择语言：设置惯用编程语言（Python / Java / C++）。
3. 选择工作区：指定一个本地文件夹，作为后续生成题目代码的专用空间。

2. 账号登录

在引导流程中，点击按钮跳转至 LeetCode 官网。登录后，在浏览器开发者工具 (F12) 的 Network/Application 面板中提取 csrf_token 与 LEETCODE_SESSION 并粘贴回插件中。凭据仅由本地 CLI 管理，保障隐私安全。

3. 发起你的第一次对话

直接在聊天框输入：

"帮我安排今天的刷题计划" "我想做第 42 题" "我今天面试遇到一道求无向图中连通图最小代价的题，帮我找找"