点击👇“LaTeX工作室” 关注公众号
精致科研生活从这里开始
📝 手写笔记太乱没法看？这个开源神器一键转 LaTeX，本地运行免费 forever！
对于理工科学生、研究人员和工程师来说，手写笔记是日常，但将这些充满公式、定理和推导过程的笔记整理成电子版，往往是一场噩梦。
手动敲 LaTeX？太慢！ OCR 识别公式？经常出错！ 付费软件？不仅贵还担心隐私泄露！
今天给大家安利一个刚刚在 GitHub 上引起关注的开源项目 —— notes2latex。它不仅能将你的手写数学笔记瞬间转换为可编译的 LaTeX 文档，而且完全本地运行、开源免费、支持任意大模型，简直是学术党的福音！
🚀 核心亮点：不仅仅是“识别”
很多工具声称能识别手写体，但 notes2latex 的不同之处在于它的**“智能代理 + 编译验证”机制**。
1. 🔄 自动生成 - 编译 - 修复闭环
这是该项目的核心黑科技。它不是简单地生成文本就结束，而是建立了一个基于 LangGraph 的智能循环：
- 生成：视觉语言模型（VLM）读取笔记图片，生成 LaTeX 代码（包含公式、定理、证明、图表等）。
- 修复：如果编译报错，AI 会读取错误日志，自动重写错误的部分。这个过程每页最多重试 3 次，绝大多数错误都能自动解决。
这意味着，你拿到的不仅仅是一段代码，而是一个保证能编译成功的 .tex 文件和对应的 PDF。
2. 📄 无限长度与上下文记忆
很多工具处理长文档时会“失忆”，导致前后符号不一致或环境未闭合。notes2latex 采用顺序处理机制：
- 每一页都会携带前一页生成的最后 40 行 LaTeX 代码作为上下文。
- 它会记住未闭合的环境（比如上一页没写完的
align* 环境）。 - 结果：无论你的笔记有多厚，符号定义、编号和文档结构都能保持一致，没有长度限制。
3. 🔒 隐私至上，完全本地化
- 数据不出域：除了你主动调用的 API 请求外，所有数据处理都在你的机器上完成。
- BYOK (Bring Your Own Key)：支持自带 API Key，甚至支持自部署的本地模型（如 Qwen3-VL 等），彻底杜绝隐私泄露风险。
🛠️ 如何使用？简单到令人发指
项目提供了 Docker 和命令行两种使用方式，对小白和极客都非常友好。
方法一：Docker 一键启动（推荐）
只需创建一个 docker-compose.yml 文件：
services:
notes2latex:
image: ghcr.io/advaypakhale/notes2latex:latest
ports:
- "8000:8000"
volumes:
- notes2latex-data:/app/data
volumes:
notes2latex-data:
然后运行：
docker compose up
打开浏览器访问 http://localhost:8000，在设置里填入你的 API Key（推荐使用 OpenRouter 获取通用 Key），上传笔记图片，坐等转换即可！
方法二：命令行高手
如果你喜欢终端操作：
# 转换文件
notes2latex convert notes.pdf -m openai/gpt-4o -o ./out --dpi 200
# 或者启动 Web 服务
notes2latex serve
🧠 模型推荐：丰俭由人
notes2latex 基于 LiteLLM，支持 100+ 种模型，你可以自由选择：
- 追求效果：默认推荐的 Gemini 3 Flash Preview，性价比高，每页成本仅约 $0.002-$0.003。
- 追求免费/本地：推荐 Qwen3-VL-30B 系列，效果出色且支持自托管，甚至在 OpenRouter 上有免费额度可用。
- 万能钥匙：强烈建议使用 OpenRouter，一个 Key 就能调用 Google、Anthropic、OpenAI、Meta、Qwen 等各家模型，无需反复切换配置。
在 AI 时代，重复性的劳动应该交给机器。notes2latex 不仅是一个转换工具，更展示了**“AI Agent + 传统编译器”**结合的巨大潜力。它让高质量的知识沉淀变得前所未有的简单。
最重要的是，它开源、免费、尊重隐私。
👉 项目地址：
https://github.com/advaypakhale/notes2latex
赶紧去 Star 一波，把你的手写笔记库彻底激活吧！
本文基于开源项目 notes2latex 介绍，项目遵循 MIT 协议。
更懂中文用户的 LaTeX 在线平台来了，点击领取福利！
