考呗 Kaopy（内测版）
面向考前 1-10 天突击备考的 AI 考试工作站。
Kaopy 目前仍是内测版，适合愿意尝鲜、愿意反馈问题和建议的同学。核心流程已经可用，但在不同学校、不同课程、不同资料质量下，AI 计划和教学效果还需要继续打磨。如果你在真实备考中用了它，欢迎把不顺手、跑偏、慢、答得不够像考试的地方反馈给我们。
如果你一学期没怎么上课、课件还没看、往年题也没刷，但考试已经快到了，Kaopy 的目标很简单：帮你尽快进入“能做题、能过线”的备考状态。
Kaopy 更像一个考试版 VS Code：把一门考试当成一个项目来管理。你导入课件、往年题或复习资料，AI 会围绕考试目标建立计划，从零讲授、逐题练习、模拟检查，并持续监督你的进度。
适合谁
- 考前 1-10 天，需要临时抱佛脚的大学生
- 商科、理工科等国内课程考试
- 基础很弱，甚至默认“这学期基本没听课”
- 手里有课件、PPT、往年题、考试说明，希望快速拟合题型
- 很焦虑，需要 AI 帮你拆任务、盯进度、快速开始
核心流程
- 建立考试项目：填写科目、考试日期、每天能学多久。
- 导入资料：放入课件、往年题、复习提纲、考试说明。
- AI 制定计划：按剩余时间和资料优先级生成突击路线。
- 从零教学：默认你可以零基础，AI 按单元讲清高频考点。
- 逐题练习：结合课件和往年题风格出题，做完立刻反馈。
- 模考与查漏：考前集中练习薄弱点，尽量把分数补上来。
Kaopy 的特点
- 往年题驱动：把往年题和课件当成最高优先级，而不是泛泛讲课。
- 应急优先：不追求完整学完一门课，优先覆盖高频题型和能拿分的部分。
- AI 监督推进：计划、教学、练习、反馈和进度追踪都在同一个工作流里。
- 旁问不中断主线：学习中临时有疑问，可以发起旁问，不破坏主备考节奏。
- 本地 Markdown 存储：项目数据保存在本地 Markdown / JSON 文件中，零数据库，方便迁移和查看。
- 依附 Hermes Agent：利用 Hermes 的工具调用、记忆和 agent loop，Kaopy 专注考试工作流。
安装
在 VS Code 扩展商店搜索 Kaopy 或 考呗 安装。
也可以安装本地 .vsix：
- 打开 VS Code
- 按
Ctrl+Shift+P
- 选择
Extensions: Install from VSIX...
- 选择下载的 Kaopy 安装包
API Key
Kaopy 当前需要连接 OpenAI-compatible API，默认使用 DeepSeek：
- Base URL：
https://api.deepseek.com/v1
- 推荐模型：
deepseek-v4-pro / deepseek-v4-flash
你可以在 Kaopy 的 Customize 面板中填写 API Key，也可以在 VS Code 设置里配置：
kaopy.ai.apiKeykaopy.ai.baseUrlkaopy.ai.model
使用建议
- 先导入课件和往年题，再让 AI 制定计划。
- 如果只剩 1-3 天，不要追求完整学习，直接让 Kaopy 优先覆盖高频题型。
- 如果完全零基础，先让 Kaopy 从“最可能考、最容易拿分”的部分讲起。
- 做题时尽量回答真实情况，错题会帮助 AI 调整后续练习。
系统要求
- VS Code：1.100.0 或更高版本（下载：code.visualstudio.com）
- Python：3.9 或更高版本（下载：python.org）
- Kaopy 首次启动会自动检测 Python 并引导安装依赖。如缺失会弹出安装指引。
- API Key：DeepSeek 或其他 OpenAI-compatible API
- 操作系统：Windows / macOS / Linux 均支持（macOS 与 Linux 需要
python3 命令可用）
当前定位
Kaopy 不是通用聊天助手，也不是完整网课平台。
它是一个为考试冲刺设计的 AI 工作站：当时间很少、基础很弱、压力很大时，帮你把课件和往年题快速组织成可执行的备考流程。
原则：大道至简，唯快不破。AI 是教练，用户是决策者。
内测反馈
我们尤其想知道：
- 你的课程类型：商科、理工科，还是其他考试？
- 你还剩几天考试，基础大概如何？
- Kaopy 是否能根据你的课件和往年题抓住重点？
- 哪一步最慢、最焦虑、最不清楚？
- AI 教学和练习题是否像你的真实考试？
内测阶段最重要的不是“看起来完美”，而是尽快找到真实备考场景里的问题。你的反馈会直接影响后续版本的流程、提示词、检索、模型路由和题型拟合。
开发
npm install
npm run compile
在 VS Code 中按 F5 启动 Extension Development Host。
