feyman-study

Category: Tools & Productivity | Uploader: zykkkl | Downloads: 0 | Version: v1.0（Latest）
费曼学习法助手。支持PDF/EPUB等教材阅读，按FSRS算法安排复习，分别记录每个科目的学习进度。支持多教材管理、知识点来源标注、自定义排序和跨教材混排。触发场景：(1) 用户学习新科目 (2) 复习已学知识 (3) 查看学习进度 (4) 管理教材
Changelog: Source: GitHub https://github.com/zykkkl/feynman-study
Directory Structure

Current level: Root
📁 references/
- 📄 数据管理.md 5.4 KB
- 📄 知识库.md 3.3 KB
📁 scripts/
- 📁 __pycache__/
  - 📄 feynman.cpython-312.pyc 11.5 KB
  - 📄 fsrs_wrapper.cpython-311.pyc 5.0 KB
  - 📄 fsrs_wrapper.cpython-312.pyc 4.3 KB
- 📄 feynman.py 16.5 KB
- 📄 fsrs_legacy.py 2.5 KB
- 📄 fsrs_wrapper.py 3.0 KB
- 📄 migrate_to_fsrs.py 3.0 KB
- 📄 optimize_fsrs.py 2.4 KB
📄 .gitattributes 66 B
📄 FSRS_INTEGRATION.md 1.7 KB
📄 README.md 8.3 KB
📄 requirements.txt 12 B
📄 SKILL.md 11.3 KB
SKILL.md

---
name: feyman-study
description: 费曼学习法助手。支持PDF/EPUB等教材阅读，按FSRS算法安排复习，分别记录每个科目的学习进度。支持多教材管理、知识点来源标注、自定义排序和跨教材混排。触发场景：(1) 用户学习新科目 (2) 复习已学知识 (3) 查看学习进度 (4) 管理教材
---

# 费曼学习法助手

## 概述

费曼学习法 + 间隔重复，让学习更高效！

**核心功能**：
- 支持PDF/EPUB/TXT/MD等教材格式
- 多教材管理（一门科目可关联多个教材）
- 教材来源标注（每个知识点标注来源）
- 自定义排序（灵活调整学习顺序）
- 跨教材混排（不同教材知识点混合复习）
- 分别记录每个科目的学习进度（持久化）
- FSRS算法智能复习排程
- 识别知识盲点并纠正

## 支持的教材格式

| 格式 | 支持 | 说明 |
|------|------|------|
| PDF | ✅ | 提取文本内容 |
| EPUB | ✅ | 提取文本内容 |
| TXT | ✅ | 直接读取 |
| Markdown | ✅ | 直接读取 |
| Word | ✅ | 需要转换 |
| PPT/PPTX | ✅ | 课堂讲义 |
| URL | ✅ | 在线资源 |

## 学习流程

### Step 0：确认/选择科目

**首次学习新科目时**：
1. 询问用户要学习什么科目
2. 创建该科目的学习档案
3. 记录到持久化存储

**继续学习已有科目时**：
1. 读取该科目的学习进度
2. 从上次中断的地方继续

### Step 1：提供教材

用户需要提供学习材料：
- 本地文件路径
- 或者URL链接
- 或者直接粘贴文本

**新增：教材管理**
- 可以为一门科目添加多个教材
- 每个教材有唯一ID和类型标注
- 学习过程中可随时添加新教材

### Step 2：提取内容

使用 markdown-converter 提取教材内容。

### Step 2.5：智能识别核心知识点

**重要原则**：不要机械地把所有章节内容都当作知识点，要智能筛选重要的核心知识点。

**Agent的分析流程**：

1. **阅读和理解教材**：
   - 快速浏览提取的教材内容
   - 识别章节结构、标题、重点标记

2. **评估知识点重要性**：

   对每个潜在知识点，评估以下维度：

   - ✅ **核心概念**：基础定义、核心术语
   - ✅ **关键原理**：重要定理、公式、规律
   - ✅ **实用技能**：常用方法、解题技巧
   - ✅ **依赖前提**：理解后续内容的必备知识
   - ❌ **辅助内容**：例子、练习、补充说明
   - ❌ **背景知识**：历史、趣闻、扩展阅读

3. **筛选核心知识点**：

   **应该提取的**：
   - 章节的核心概念和定义
   - 重要的定理、公式、原理
   - 关键的方法和技巧
   - 容易混淆的概念对比

   **不应该提取的**：
   - 具体的例题和习题
   - 补充说明和注释
   - 历史背景和人物介绍
   - 扩展阅读材料

4. **展示和确认**：
   - 向用户展示识别出的核心知识点列表
   - 说明每个知识点的重要性
   - 询问："这些是我识别出的核心知识点，是否需要调整？"
   - 根据用户反馈调整列表

5. **创建知识点**：
   - 使用add_knowledge命令为每个核心知识点创建记录
   - 标注来源教材
   - 进入Step 3开始学习

### Step 3：费曼讲解（规范化流程）

**Agent的职责**：

1. **明确提问**：
   - 告诉用户："现在我们来学习【知识点标题】"
   - 说明知识点来源："这个知识点来自【教材名称】"
   - 清晰要求："请用你自己的话解释这个概念，越详细越好"

2. **倾听和评估**：
   - 仔细听用户的解释
   - 评估解释的完整性和准确性
   - 识别哪些部分解释得好，哪些部分不清楚

3. **针对性追问**：
   - 如果某个核心概念没有提到，追问："那么【具体概念】呢？"
   - 如果某个解释不准确，追问："你确定【具体内容】是这样的吗？"
   - 如果解释模糊，追问："能具体说说【具体部分】吗？"
   - 继续追问直到用户能完整、准确地解释

4. **给出标准答案**：
   - 当用户解释清楚后，说："很好！现在让我给你标准答案"
   - 展示完整的、正确的知识点解释
   - 指出用户解释得好的地方和可以改进的地方

### Step 4：自动评分

**评分标准（0-5分）**：

- **完整性（0-2分）**：
  - 2分：覆盖所有核心概念
  - 1分：覆盖部分核心概念
  - 0分：遗漏大部分核心概念

- **准确性（0-2分）**：
  - 2分：解释完全正确
  - 1分：有小错误但不影响理解
  - 0分：有重大误解

- **流畅度（0-1分）**：
  - 1分：第一次或第二次就解释清楚
  - 0分：需要多次追问才解释清楚

**Agent必须**：
- 根据上述标准给出0-5的评分
- 说明评分理由
- 立即调用record_review记录

### Step 5：自动记录学习数据

使用脚本自动记录：
```bash
python scripts/feynman.py record_review <科目ID> <知识点ID> <评分0-5>
```

**记录内容**：
- 本次学习日期
- 评分（0-5）
- 更新复习历史
- 计算下次复习时间（基于FSRS算法）

### Step 6：继续下一个知识点

- 保存进度后，询问用户是否继续学习下一个知识点
- 如果继续，回到Step 3
- 如果结束，总结本次学习成果

**新增：自定义排序**
- 用户可以调整知识点的学习顺序
- 支持跨教材混排复习

## 复习功能

### 查看今日复习

用户说"复习"或"今日复习"时：
1. 读取所有科目的复习计划
2. 展示今天需要复习的内容
3. 按科目分组展示
4. **新增**：按自定义order排序，支持跨教材混排

### FSRS复习排程

对于每个知识点，记录：
- 上次复习日期
- 复习间隔
- 下次复习日期

复习时间线：
- 第1次复习：1天后
- 第2次复习：3天后
- 第3次复习：7天后
- 第4次复习：15天后
- 第5次复习：30天后
- 以此类推...

## 数据存储

### 存储位置

数据存储在：`~/.openclaw/feynman_study/`

### 数据结构

```
feynman_study/
├── subjects.json       # 科目列表（含教材信息）
├── progress/          # 每个科目的进度
│   ├── 数学.json
│   ├── 物理.json
│   └── ...
└── review_queue.json  # 今日复习队列
```

### 数据格式

**subjects.json**:
```json
{
  "subjects": [
    {
      "id": "math",
      "name": "数学",
      "created_at": "2026-01-01",
      "last_studied": "2026-03-05",
      "textbooks": [
        {
          "id": "tb_abc123",
          "name": "高等数学教材",
          "type": "pdf",
          "created_at": "2026-01-01",
          "description": "主教材"
        }
      ]
    }
  ]
}
```

**progress/数学.json**:
```json
{
  "subject_id": "math",
  "knowledge_points": [
    {
      "id": "kp_001",
      "title": "微积分基础",
      "content": "...",
      "source": "tb_abc123",
      "order": 1,
      "confusion_points": ["导数的定义"],
      "review_history": [
        {"date": "2026-03-01", "quality": 4},
        {"date": "2026-03-05", "quality": 3}
      ],
      "next_review": "2026-03-08",
      "interval": 3
    }
  ]
}
```

## 使用脚本

### 读取教材内容

使用 markdown-converter 提取内容：
```bash
markitdown <file.pdf>
```

### 管理学习数据

使用 scripts/feynman.py 管理数据：

**科目管理**：
- `python scripts/feynman.py add_subject <科目名>` - 添加科目
- `python scripts/feynman.py list_subjects` - 列出所有科目

**教材管理（新增）**：
- `python scripts/feynman.py add_textbook <科目ID> <教材名> <类型> [描述]` - 添加教材
- `python scripts/feynman.py list_textbooks <科目ID>` - 列出科目的所有教材

**知识点管理**：
- `python scripts/feynman.py add_knowledge <科目ID> <知识点标题>` - 添加知识点
- `python scripts/feynman.py add_knowledge <科目ID> <标题> --source=<教材ID>` - 添加知识点并指定来源
- `python scripts/feynman.py add_knowledge <科目ID> <标题> --order=<序号>` - 添加知识点并指定顺序
- `python scripts/feynman.py reorder <科目ID> <知识点ID> <新序号>` - 调整知识点顺序（新增）

**复习管理**：
- `python scripts/feynman.py review_queue` - 查看今日复习
- `python scripts/feynman.py record_review <科目ID> <知识点ID> <质量(0-5)>` - 记录复习结果

**进度查看**：
- `python scripts/feynman.py progress` - 查看所有科目进度
- `python scripts/feynman.py progress <科目ID>` - 查看指定科目进度

## 新功能特性

### 1. 多教材支持
- 一门科目可以关联多个教材（书、PPT、网页等）
- 学习过程中可以随时添加新教材
- 每个教材有唯一ID和类型标注

### 2. 教材来源标注
- 每个知识点可以标注来自哪个教材（source字段）
- 便于追溯知识点的原始出处
- 支持跨教材学习

### 3. 灵活拆分
- 一个教材可以拆分成多个知识点
- 每个知识点独立管理和复习
- 支持细粒度的学习控制

### 4. 自主排序
- 用户可以自定义知识点的学习顺序（order字段）
- 使用reorder命令调整顺序
- 复习队列自动按order排序

### 5. 跨教材混排
- 不同教材的知识点可以混合排序
- 复习时按统一的order顺序进行
- 支持灵活的学习路径规划

## 删除知识点

### 重要提示

删除是不可逆操作，必须谨慎处理。

### 删除流程（必须严格遵守）

当用户说"删除知识点"、"移除知识点"或类似请求时：

1. **明确目标**：询问用户要删除哪个具体的知识点
   - 要求提供知识点ID或完整标题
   - 如果用户描述模糊，列出可能的匹配项让用户选择

2. **显示详情**：展示要删除的知识点完整信息
   - 标题
   - 内容摘要
   - 来源教材
   - 复习历史（复习次数、最后复习日期）

3. **明确确认**：要求用户明确确认
   - 使用明确的问句："确认删除这个知识点吗？这个操作不可撤销。"
   - 只有用户明确回复"是"、"确认"、"删除"等肯定词才继续

4. **执行删除**：使用脚本命令
   ```bash
   python scripts/feynman.py delete_knowledge <科目ID> <知识点ID>
   ```

5. **验证结果**：删除后
   - 确认删除成功
   - 显示该科目剩余的知识点数量
   - 提醒用户该知识点已从复习队列中移除

### 严格禁止的操作

以下操作**绝对不允许**：

- ❌ **批量删除**：一次删除多个知识点（除非用户逐个确认每一个）
- ❌ **模糊删除**：基于模糊条件删除（如"删除所有旧的"、"删除不重要的"）
- ❌ **清空操作**：删除某个科目的所有知识点
- ❌ **无确认删除**：在没有用户明确确认的情况下执行删除
- ❌ **直接修改JSON**：永远不要直接编辑progress/*.json文件来删除知识点

### 错误处理

- 如果知识点ID不存在：提示用户并列出该科目的所有知识点
- 如果标题匹配多个知识点：列出所有匹配项，让用户选择具体的ID
- 如果脚本命令失败：显示错误信息，不要尝试其他删除方法

### 使用脚本

```bash
# 删除单个知识点
python scripts/feynman.py delete_knowledge <科目ID> <知识点ID>

# 注意：如果该命令尚未实现，需要先实现该功能
```

## 参考资源

- references/知识库.md - 费曼学习法详细说明
- references/数据管理.md - 数据存储格式说明
- scripts/feynman.py - 数据管理脚本
- scripts/fsrs_wrapper.py - FSRS算法实现
Comments 0
Latest | Hot
Please login before commenting.
No comments yet. Be the first one!
feyman-study

Directory Structure

SKILL.md

Report

Notice
