Skip to content

README_CN.md

Latest commit

 

History

History
123 lines (89 loc) · 3.84 KB

README_CN.md

File metadata and controls

123 lines (89 loc) · 3.84 KB

MCP Compatible Cursor Supported Kilo Code Supported Windsurf Supported MIT License

⚡ Live-time-tutorial MCP

English | 简体中文

让AI在完成任务后生成知识测验，一键保存截图并自动生成精美PDF笔记

Quiz GUI Screenshot

🧠 特性

  • 即时反馈 - 根据任务上下文自动生成测验，答题后立即显示对错、解析和思路演示
  • 用户反馈循环 - 在测验底部输入追问prompt，agent回复后自动生成新一轮测验
  • 自动PDF笔记生成 - 用户点击保存后，测验窗口关闭时自动调用AI生成PDF笔记
  • 轻松集成 - 支持 Windsurf、Cursor、Kilo Code 等多种 AI IDE

🔄 工作原理

任务完成 → AI总结知识点 → 生成测验 → 用户在GUI作答
→ [可选：输入反馈prompt] → Agent回复 → 再次生成测验（循环）
→ [如果点击了Save to Notebook] → PDF自动生成 → 保存到 ~/Desktop/Notebook/

🚀 部署安装

1. 构建服务

npm install
npm run build

2. 配置 IDE

在对应 IDE 的配置文件中添加如下内容，注意替换 [PATH_TO_PROJECT] 为本项目实际绝对路径：

配置内容：

{
  "mcpServers": {
    "live-time-tutorial": {
      "args": [
        "[PATH_TO_PROJECT]/dist/index.js"
      ],
      "command": "node",
      "disabled": false
    }
  }
}

3. 添加全局规则（推荐）

给 agent 添加全局规则（rules\task-feedback.md）以提高此 MCP 的触发频率。

4. 重启 IDE

配置完成后重启 IDE 即可激活 MCP 服务。

📖 使用指南

  • 自动触发：AI 完成任务后会询问是否需要测验
  • 手动触发：直接在对话中输入 "给我出个测验" 或 "quiz"
  • GUI作答：点击选项卡片直接提交答案
  • 留言反馈（可选）：在底部 Feedback to Agent 输入框输入追问prompt
  • PDF自动生成：如果点击了Save to Notebook，PDF会自动生成

所有文件直接保存到 ~/Desktop/Notebook/：

  • {topic}.pdf - 带截图的精美学习笔记

🧰 MCP 工具

generate_quiz

生成测验并打开GUI窗口。MCP等待窗口关闭。

行为逻辑：

  • 用户填写了反馈 → Agent回复反馈内容，然后再次调用 generate_quiz
  • 用户点击了 Save to Notebook → Agent 自动调用 save_notebook_note_pdf
  • 用户两者均未操作 → Agent 总结结果并结束对话

set_notebook_path

设置自定义笔记保存路径（默认：~/Desktop/Notebook）

save_notebook_note_pdf

使用 rich-notebook-pdf-generator Agent技能生成丰富的PDF学习笔记。

🎭 内置Agent技能

位于 src/builtin-skills/rich-notebook-pdf-generator/：

SKILL.md 指导Agent生成以下内容：

  1. 术语与定义 - 关键术语使用加粗高亮
  2. 核心概念与原理 - 核心思想与关键结论
  3. 实践示例 - 可运行的代码和真实场景
  4. 类比与记忆法 - 日常类比和对比记忆
  5. 总结表格 - 对比表格便于快速复习
  6. 流程图 - 使用制表符绘制文本流程图

📄 许可证

MIT

Crafted with ❤️ for effective learning