一个面向大学生的学习与生活工作台。把课程笔记、学习讨论、计划确认和专注记录放在同一个空间,并加入校园场景、林连理常驻伙伴与「羁遇故事」。
- 已于 2026-10-25 部署到阿里云:在线体验。本次更新重新确认 HTTPS 首页返回 200,健康接口返回
{"status":"ok"}。 - 支持每个账号在「空间设置」连接自己的 DeepSeek/OpenAI API Key;密钥加密保存,支持替换和移除。
- 已补齐个人密钥管理接口、账号隔离测试、PostgreSQL 迁移和阿里云原生部署脚本。
- 五分钟参赛介绍视频已完成真人配音、字幕与画面对时,规格为 1920×1080、60fps;视频与配乐保留在本地。
详细进度、验收范围与待办见 项目进度,部署记录见 阿里云部署说明。
- 本地账号、HttpOnly 会话和按用户隔离的数据。
- 学习计划、按日期的待办、成长路线与专注计时;暂停、恢复、刷新和实际时长打卡。
- 文字资料库,支持粘贴文字与 UTF-8 TXT/Markdown;检索保留资料名和段落位置。
- 学习与生活 Agent:持久化会话、有用户原话依据的待验证学习观察、有预算的工具循环。
- 模型提出计划或任务调整,用户检查并确认后才写入;保护重复确认、跨账号操作与版本冲突。
- 校园场景、Q版常驻伙伴和可回看、续读的本地剧情。
项目支持本机运行,也已完成 Node.js + PostgreSQL + Nginx + systemd 的公网部署。PDF/OCR、精确钟点课表、冲突检测、后台通知及教学效果评测尚未完成。当前网站伙伴使用图片和界面动画,未接入 Live2D。
需要 Node.js 24 LTS。默认使用 SQLite,无需云模型也能手动规划、计时和查看记录。
npm ci
npm run db:setup
npm run build
npm start打开 http://localhost:3000 。首次 db:setup 会从 .env.example 创建本地 .env。默认只监听本机。
登录后打开「空间设置 → 连接你自己的 AI」,选择 DeepSeek 或 OpenAI,填写支持工具调用的模型名称及自己的 API Key。每个账号使用自己的密钥,可随时替换或移除;不使用站长共享密钥。
密钥使用 AES-256-GCM 加密保存在数据库中,不回显、不包含在用户数据导出中。npm run db:setup 会在本地 .env 自动生成 MODEL_ENCRYPTION_KEY;生产部署需生成独立的 64 位十六进制加密密钥,并与数据库一起妥善备份。丢失或更换该加密密钥会导致原有 API Key 无法解密。公网保存 API Key 必须使用 HTTPS。
发送消息时,输入、必要的学习概况和最近会话会发送给所选模型服务;勾选资料许可后,相关资料片段也可能被发送。模型费用由用户对应的服务商账户承担。此前曾使用 DeepSeek 完成真实接口和页面验收;这不代表接入了官方 LearnBuddy API。不要提交 .env、数据库或登录状态。
npm test
npm run typecheck
npm run build服务运行后可执行 npm run test:api。它会创建并清理专用验收账号;务必显式把 DATABASE_URL 指向同一实例的数据库。单元/服务测试使用受控模型,不能作为真实云模型验收证据。
src/modules/:账号、规划、专注、统计、模型、资料和学习 Agent。src/app/api/:鉴权、同源检查与 API。src/components/:工作台、伙伴和剧情界面。prisma/:SQLite/PostgreSQL schema 与 PostgreSQL 迁移。deploy/aliyun-native.sh:已用于阿里云原生部署;Dockerfile、compose.yaml为另一路部署配置,尚未完成 Docker 实机验收。
原创应用代码按 MIT 开源。角色、校园插画和品牌素材不自动适用代码的 MIT 许可,详见 素材说明。第三方依赖保留各自许可。
公开源码包不包含原始课件、个人记录、第三方背景音乐、Live2D SDK、参赛录屏或本地工作历史。开源版默认关闭剧情音乐;如有已获授权的音乐,可通过 NEXT_PUBLIC_STORY_MUSIC_URL 和 NEXT_PUBLIC_STORY_MUSIC_TITLE 配置,修改后重新构建。
继续完善资料格式与学习反馈,补齐自动备份、恢复演练、多人并发验证和 Docker 部署验收。