考搭子 (KaoBuddy)

离考试只剩两周，面对堆积如山的课件、扫描件、手写笔记和视频录像，如何快速构建复习体系？考搭子 (KaoBuddy) 是一款专为“临时抱佛脚”场景打造的 AI 备考工作台。它摒弃了传统学习工具漫长的知识库构建过程，主张“扔进资料，即刻开始”。通过强大的本地解析能力与智能 AI 代理，考搭子能迅速将杂乱的非结构化数据转化为结构化的知识点、每日计划、模拟试卷及临考速背卡片，帮助考生在极短时间内实现高效冲刺。

核心亮点：极速、隐私、智能

1. 全格式资料“吞噬”能力

• 多源异构解析：支持 PDF（含扫描版 OCR）、DOCX/TXT/Markdown、手写笔记图片/PDF、以及 B 站视频字幕自动抓取。
• 本地化处理：所有文件均在浏览器端解析（超大 PDF 采用分片策略），不上传服务器，确保原始资料绝对安全。
• 智能知识抽取：AI 自动从资料中提炼如“进程同步”、“银行家算法”等具体考点，并标注来源证据，拒绝幻觉。

2. 极致隐私与 BYOK 模式

• 数据不离机：所有项目数据、学习计划、错题本均存储在浏览器 IndexedDB 中，支持一键 JSON 备份与恢复。
• 自带 API Key：用户填入自己的 DeepSeek、Kimi 或 OpenAI Key，请求直接从前端发往服务商，服务端不落盘任何密钥或对话记录。
• 无账号负担：目前无需注册登录，打开即用，彻底消除隐私泄露顾虑。

3. 针对性极强的复习闭环

• 动态每日计划：根据剩余天数、每日可用时间及目标分数，AI 自动将知识点均匀分配至每一天，逾期模块自动滚动。
• 临考速背模式：考前最后一天，将知识点压缩为“核心概念 + 必背要点 + 记忆口诀 + 易错提醒”的极简卡片，助力最后冲刺。
• 精准模拟考：基于导入资料出题，不编造超纲内容。支持 AI 批改（选择题对答案，简答题按要点给分）及错题自动入库。

功能全景

快速开始

1. 在线体验（推荐）

直接访问部署在 Railway 上的预览版，手机电脑通用：
kaobuddy-preview-production.up.railway.app

2. 本地运行

Mac:

双击 open-kaobuddy.command

Windows:

双击 open-kaobuddy.bat

(脚本会自动安装依赖、启动后端服务并打开浏览器)

手动启动:

# 后端
python3 -m venv .venv
source .venv/bin/activate
pip install -e ".[test]"
uvicorn backend.app.main:app --port 8000

# 前端
npm install
npm run dev

3. Docker 部署

docker build -t kaobuddy .
docker run -p 8080:8080 kaobuddy

技术栈概览

• 前端：React 19 + TypeScript + Vite 6 + Framer Motion
• 后端：FastAPI + Uvicorn (异步 SSE 流式响应)
• 存储：IndexedDB (本地数据) + localStorage (API Key)
• 解析引擎：pdfjs-dist, mammoth, 自研旧 .doc 解析器
• AI 集成：httpx + OpenAI-compatible 协议 (支持 DeepSeek, Kimi, GPT-5.5 等)

考搭子不仅仅是一个笔记整理工具，更是一位懂考试、懂紧迫感的 AI 助教。它通过技术手段消除了复习前的准备摩擦，让考生能将宝贵的时间全部投入到真正的学习与记忆中。