← 返回列表

Agent 用法 GitHub · remicaesar/learn-by-reasoning

用 learn-by-reasoning 插件把 PDF 书变成要做题和教回的 Claude Code 课程

给一个带文字层的 PDF 书或讲义，得到逐章逐概念的课程：每个概念先做题、再看解释、用自己的话教回，终端打印进度地图。

开始尝试

效果

原站没有结果截图；README 说明 progress 会在终端打印整本书的紧凑进度地图，并生成 plan.md（章、页、概念状态 [ ] [>] [!] [x]）与 journal.md。

这是什么

新在哪里：以前用 Claude Code 学书多是让它总结解释、自己判断是否懂；现在插件强制按「问题→解释→教回」走，教不过关概念就不算完成，进度和错题存进 Markdown。

怎么做到的：在 Claude Code 里执行 /plugin marketplace add remicaesar/learn-by-reasoning 与 /plugin install learn-by-reasoning@learn-by-reasoning 安装插件并重启；用 /learn-by-reasoning:start 指定 PDF，插件读取材料并展示按书顺序排列的章节与概念计划供修改，同时在 ~/learning/ 下创建书文件夹；然后 cd ~/learning/<book-folder> 后运行 claude，再用 /learn-by-reasoning:study 开始会话（如到期先做热身小测）；/learn-by-reasoning:progress 打印地图；状态由 scripts/lbr.py 读写 plan.md 与 journal.md。

适合谁
用 Claude Code 学教材、讲义，想靠做题和讲回来验证自己是否真懂的人。
能帮你
把「先做题、再解释、教回检验」固化成不可跳过的学习闭环，并自动保存进度与错题。

评分 三项分开看，不合成总分；热度不等于好用

新颖性
全新做法 · 2026-10-21 出现
热度
未知
易上手
很容易上手
怎么评的

三项都由本站记录的事实按固定规则算出，编辑不能直接改档位；规则改动会写进更新说明。

新颖性

  • ●●● 全新做法，且有来源依据的出现时间在最近 30 天内
  • ●●○ 老工具新用法或近期刚开放，且有来源依据的时间在最近 30 天内
  • ●○○ 出现时间超过 30 天、未核实到精确日期，或已不再是新做法
  • 其他 出现时间未核实、晚于今天，或新颖类型未核实时按最低一档处理，不靠猜测加分

热度

  • ●●● 最近一次每周人工确认为“热门”：最近 14 天里独立讨论、实际案例、持续时间、传播平台、相对关注五项门槛全部满足（规则 heat-v1）
  • ●●○ 最近一次人工确认为“观察中”：前三项至少一项达到，或讨论增长 ≥ 50%，且至少 2 个独立案例
  • ●○○ 最近一次人工确认为“未进入跟踪”
  • 其他 还没有人工确认过的热度记录时显示“未知”。热度只统计本站已接入的信源，不代表全网

易上手

  • ●●● 准备门槛低且难度入门：不需要新账号或付费，首次尝试不超过 30 分钟，公开可用，会复制粘贴即可
  • ●●○ 准备门槛中等，或门槛低但需要改少量代码或配置
  • ●○○ 准备门槛高：需要商业软件或付费服务、首次尝试超过 2 小时、特殊硬件或网络、排队或邀请且无替代方案，或需要专业知识
  • 其他 只有介绍、还没有站内步骤，或关键步骤已失效时显示“暂不可试”；门槛未核实时显示“未核实”

怎么尝试

  • 时间 首次约 20 分钟
  • 费用 费用待核验：插件以 MIT 许可证开源；README 未说明费用，Claude Code 本身的费用原站未说明。
  • 账号 不需要新账号
  • 环境 Claude Code 命令行；Python 3（仅标准库）；pdftotext（poppler）；带文字层的 PDF。
  • 准备 Claude Code：运行插件命令与学习会话（README 列为依赖）
  • 准备 Python 3：运行 scripts/lbr.py 读写计划与绘制地图（仅标准库）
  • 准备 pdftotext（poppler）：从 PDF 提取文字，README 给出 brew install poppler
  • 准备 带文字层的 PDF 书或讲义：作为学习材料，start 命令的输入

替代方案：没有有效替代方案。能做到：README 未提及同类插件；可直接让 Claude Code 逐章总结提问，但缺少强制教回和进度/错题落盘机制。；差别：。

完成替代方案不算复现本实践。

按下面的步骤就能做出第一个结果。复制命令不会自动执行。

  1. 添加插件市场并安装

    在 Claude Code 中执行两条命令添加仓库为插件市场并安装插件，然后重启 Claude Code。

    Claude Code 斜杠命令原始来源命令 
    /plugin marketplace add remicaesar/learn-by-reasoning
/plugin install learn-by-reasoning@learn-by-reasoning

    预期结果：插件安装成功，重启 Claude Code 后出现 /learn-by-reasoning:* 命令

  2. 为 PDF 生成课程计划

    重启 Claude Code 后指定带文字层的 PDF，插件读取材料并展示按书顺序排列的章节与概念计划供修改，同时在 ~/learning/ 下创建书文件夹。

    Claude Code 斜杠命令原始来源命令 
    /learn-by-reasoning:start "<path to a PDF>"

    预期结果：终端显示章节与概念计划，~/learning/<book-slug>/ 下生成 plan.md 与 journal.md

  3. 进入书目录并启动 Claude Code

    在终端进入该书文件夹（把 <book-folder> 换成第 2 步实际生成的书文件夹名）并启动 Claude Code。

    bash原始来源命令 
    cd ~/learning/<book-folder> && claude

    预期结果：Claude Code 在该书文件夹内启动，之后的命令作用于这本书

  4. 跑一次学习会话

    在刚启动的会话里执行 study 命令开始学习会话；如有到期的热身小测先做小测，之后进入下一个概念。

    Claude Code 斜杠命令原始来源命令 
    /learn-by-reasoning:study

    预期结果：先出现热身小测（若有），随后呈现下一个概念的问题，需先做完题才给解释与教回环节

  5. 查看进度地图

    在书目录或任意目录执行 progress，打印进度地图或列出所有书。

    Claude Code 斜杠命令原始来源命令 
    /learn-by-reasoning:progress

    预期结果：终端打印整本书的紧凑地图，概念状态与 plan.md 中的 [ ] [>] [!] [x] 一致

  6. 自检脚本

    可选：运行仓库自带单元测试与地图脚本，确认本地环境可用。

    bash原始来源命令 
    python3 -m unittest discover -s tests -v
python3 scripts/lbr.py progress tests/fixtures

    预期结果：测试通过，并从 fixtures 目录打印出地图

原始来源：Claude Code 插件：出题后强制教回 ↗