Penmentor · 手写数学笔尖上的 AI 家教

产品简介

Penmentor 是一款可以在手写数学题时按一键召唤 AI 家教的本地工具，配合 xournal++ 与手写笔平板使用。它让 Claude / Gemini / GPT 视觉识别你屏幕上的笔迹，直接在你的画面上像老师那样「红色笔圈出错处、对的打个勾、用浅色笔点出下一步提示箭头」，而不是甩给你一长段文字答案。它最特别的一点是能把你框选的内容生成为 3Blue1Brown 风格的 manim 动画，把抽象概念动态地演给你看。

核心功能

1. 错误圈标：AI 在你的原稿上把第一个真正算错的地方用红笔圈出来，并提示该改什么；由这个错误继承出的后续错误行用下划线标出，正确的行则被打勾。
2. 分步提示阶梯：从「最小提示（只圈一处）」一级级升级到「指出方法」「露出下一步的半透明幻影」「完整解答」四档，调用方决定学生要看到多少。
3. 答案核对（Solution check）：检查最终答案是否漏写 +C、上下界、绝对值等常见小毛病，确保答案完整且无低级错误。
4. 题型归类：「Which technique?」把决定方法的关键特征涂色而不点破方法名，让学生自己挑方法（按 p 让 AI 评估是否可行），把思考留给人。
5. 针对练习：基于你当前解法中的关键 1~2 步生成对应问答题，可键入或手写作答；还能生成"找错题练习"——做一道新题、里面埋一个错误，看你能否圈出。
6. 3Blue1Brown 动画生成：用 manim 把你框选的内容渲染成交互式动画，可拖动积分上下界、改函数、拖分割数，可视化黎曼和、立体旋转、极坐标与参数曲线、泰勒多项式等。
7. 可调节 AI 后端：在 Settings 中切换 Claude Code / Codex / Antigravity 等 CLI 智能体后端，对应不同模型（claude:opus、codex:gpt-5.6-terra 等），跑在你已有订阅上。
8. 整页上下文感知：配合 xournal++ 插件共享未滚出的全部笔迹、未保存的笔画，让 AI 看到的不是局部截图，而是整页纸。

特色优势

• 「教师视角批改」而非「聊天答案」：在原稿上作画、保留红笔痕迹，是它跟普通 AI 解题工具最大的差异。
• 学习阶梯可调：从"只给一点点提示"到"几乎给出答案"四档，适配自学、家长辅导、培训班的多种使用场景。
• 模型跑在你自己的订阅上，结果可复现、可控制花费；数据只是「屏幕截图 + 笔记页」送给所选 CLI 智能体。
• 3Blue1Brown 风格动画可在副屏拖动，实时改参数看图变化，把抽象数学与几何直觉关联起来。

应用场景

1. 高中、本科与考研学生使用 xournal++ 手写数学题时，希望像有家教在身边实时批改与引导。
2. 自学者在 YouTube 之外寻找可即时纠错、可分步提示的私人家教，避开"刷答案"陷阱。
3. 培训机构、家长辅导孩子数学作业时，用统一 AI 工具保证批改风格一致，并能针对易错步骤反复出练习题。
4. 工程计算与仿真前期需要把函数图像、积分区域"动态看一看"再继续推公式的人。
5. 任何需要在 Linux + 手写笔 + 本地 AI 智能体环境做笔记与批改的个人用户。

适用人群

适合具有 xournal++ 手写笔记习惯、追求"分步提示而非直接答案"的学习者、需要长期反馈的数学/物理与工程学习用户，以及重视隐私、希望数据不外传到 AI 公司训练栈的家庭与个人用户。

出品方

Penmentor 由 Abdullah Alhariri 个人开发，以 MIT 协议在 GitHub 完整开源（仓库：github.com/AbdullahAlhariri/penmentor）。代码主要使用 Python + PyQt6，依赖 rofi / slop / xodotool 等 Linux 工具。

更新动态

仓库创建于 2026-10-17，截至本批发布已获 76 颗星。模型后端名单保持开放：除 Claude Code / Codex / Antigravity 三个 CLI 智能体外，用户可在 ~/.config/penmentor/settings.json 中指定任何所支持的模型名，自定义前缀为 harness。

官网链接

• GitHub：https://github.com/AbdullahAlhariri/penmentor
• 完整使用文档：https://github.com/AbdullahAlhariri/penmentor/blob/main/docs/guide.md
• xournal++ 配套：https://xournalpp.github.io/
• 3Blue1Brown manim：https://github.com/3b1b/manim