penmentor

笔尖上的数学导师。手写时按一个键:Claude、Gemini 或 GPT 会像老师用彩笔一样在
屏幕上批改你的作业,给出提示而不是答案,并以 3Blue1Brown 风格的动画展示思路。

Writing an integral in xournal++, penmentor marking the sign slip, then animating the area
xournal++ 中的手写 → 按一个键 → 页面上的作业被批改 → 框出积分 → 生成交互式 manim 动画。(视频;为了可重复录制,笔迹是脚本化的,模型的回答是固定示例。)

我为什么用它

我用数位板在 xournal++ 里学微积分。我一直在把作业截图发给 Claude,再读回冗长的回答,而我真正想要的是一个在背后看着我的老师:圈出错误、打勾正确的地方、把我推向下一步,并且展示给我看为什么。penmentor 就是这样的工具,按一个键即可使用,走我自己的 Claude 订阅。

它如何帮助你学习

  • 给提示,不给答案。从一句点拨,到点明所用技巧,再到下一行淡淡的影子:思考由你完成,这正是它记得牢的原因。
  • 针对你自己作业的反馈。第一个真正的错误会在你出错的地方被圈出,正确的行被打勾,后续继承了该错误的行被下划线标出。你继续书写时这些标记会保留;按 Esc 清除。
  • 让你主动回忆的练习。针对你关键步骤的提问(可打字或手写作答)、找错练习、“哪个技巧适用?”。
  • 看到它。框出你想理解的部分,就能得到一个用 3Blue1Brown 自己的manim制作的交互式动画:拖动边界、重新输入数值,看黎曼和逐步逼近。
  • 感知整页。一个小型 xournal++ 插件会共享你当前所在的页面,而不只是屏幕上放得下的部分。

支持 Claude Code、Codex 和 Antigravity

penmentor 运行在你已经在用的 AI 命令行智能体上,走那个订阅。在设置中选择模型;其前缀表明由哪个智能体作答:

前缀 智能体 例如
claude: Claude Code claude:opus,claude:sonnet,claude:haiku
codex: Codex codex:gpt-5.6-terra
agy: Antigravity CLI agy:gemini-4-argon-medium,agy:gemini-3.8-flash-medium

设置会列出你已安装的智能体。每个智能体如何运行、能看到什么:指南。

快速开始

git clone https://github.com/AbdullahAlhariri/penmentor ~/src/penmentor
~/src/penmentor/bin/penmentor --selftest

Linux X11 环境(最好搭配 i3),并已登录上述某个智能体(claude,codex或agy),外加rofi,slop,xdotool和 PyQt6。将bin/penmentor绑定到一个按键(示例)。安装、按键和原理:指南。

许可证

MIT