noether-physics

NOETHER

一个会展示推导过程的物理研究助手。

用日常类比、经过量纲检查的方程、重新计算的完整示例，以及实际运行的模拟来解释物理概念。回答真实 arXiv 论文中的问题，并确保每句话都对应一段逐字引用。审查你自己的草稿参考文献，找出不存在的文献。

pip install noether-physics
noether explain decoherence

正在使用 0.1.0 或 0.1.1？ 请升级。这些版本曾确认虚构的参考文献——而这正是该工具旨在防止的情况。请参阅 CHANGELOG.md。

---

信任它之前，请先阅读

这是一个研究诚信工具，因此它的局限比功能更重要。

验证关卡会检查引文是否真实，但不会检查引文是否支持相关论断。 某个论断即使与自己的引文矛盾，仍可能通过。开发期间曾出现这样的情况：一个声称 “实验以五倍标准差检测到非零中子 EDM” 的论断通过了检查，但它引用的段落报告的是 d_n = 0.0 ± 1.1 × 10⁻²⁶ e·cm——一个零结果。引文本身真实无误，因此验证关卡放行了它。弥补这一缺陷需要检查蕴含关系，而这需要语言模型；让模型不参与验证器，才能保证其他保障措施有意义。因此，该工具输出的每个回答末尾都会说明这一点，而且你应该阅读引文。

参考文献解析器现在会从两个方向进行评测。 它能解析 86.5% 的真实参考文献，并且没有被 8 条蓄意伪造的参考文献中的任何一条骗过。直到建立了带标签的基准测试，这第二个数字才得以出现——而该基准测试的首次运行就发现，解析器确认了 80% 的伪造文献，其中一些置信度高达 0.95。我们发现并修复了三个缺陷。八条伪造文献仍是一个很小的样本：0% 的意思是“八条中没有一条骗过它”，而不是“它不会被骗”。

它的规模有限。 测试语料库包含 58 篇论文，解释库收录 8 个概念；量子力学覆盖范围仅限于二能级系统和一种腔模。不提供 PDF 回退机制，因此约 9% 的 quant-ph 论文（实测：55 篇中有 5 篇）完全无法导入。

docs/DEFERRED.md 记录了完整情况——列出每个缺口及其测量依据。这份文档如实呈现了情况；本 README 只是摘要。

---

存在的原因

2026 年的审计发现，AI 辅助撰写的综述论文中有 17% 存在虚假引用——即引用无法解析到任何数字对象；2025 年，在 250 万篇论文中，AI 生成的虚假引用约有 146,900 条。arXiv 现在会封禁提交虚构参考文献的作者。

物理学有一个无人利用的结构性优势：arXiv 会分发实际的 LaTeX 源文件。 方程附带其 \label，引用附带其 \cite 键，章节保留其真实结构——直接读取，而不是猜测。其他领域的工具会对 PDF 进行 OCR，因为那些领域没有源文件。而物理学有。

功能

解释。 采用精选编写的内容，而非生成式内容——然后通过机器检查。每个方程都会经过解析和量纲检查；每个完整示例都会重新计算，并与存储的答案进行比对，因此库中的笔误会导致 CI 失败，而不是教会你错误的数值。

noether explain decoherence          # analogy, maths, worked example, live simulation
noether concepts                     # what the library covers

模拟。 六种模型——摆、阻尼／受迫振子、带阻力的抛体（SciPy）；Rabi、退相干、Jaynes-Cummings（QuTiP）。每次运行都会将步长减半并报告漂移；如果存在解析解，还会自动将数值结果与之比对。

noether simulate rabi --params "detuning=6.28" --bloch
noether models

检查方程。 未声明的符号会返回 unknown，绝不猜测——h 可能是普朗克常数，也可能是高度；T 可能是周期，也可能是温度。unknown 不代表通过。

noether eq 'T = 2 \pi \sqrt{\frac{L}{g}}' --units 'T=second,L=meter,g=meter/second**2' --vary 'L=0.1..2' --at 'g=9.81'

读取论文。 导入 LaTeX 源文件，因此“方程 14”指的是作者编号为 14 的方程。

noether ingest 2001.11966
noether equations arXiv:2001.11966
noether find "vacuum Rabi oscillations"

审查你的草稿。 根据 arXiv、Crossref、OpenAlex 和 INSPIRE 解析每个 \bibitem。遇到无法解析的参考文献或没有对应参考文献条目的引用键时，会以非零状态码退出，因此可用作 pre-commit 钩子。

noether audit path/to/your-paper.tex

实测结果

请自行运行 noether bench status。截至上次运行：

门槛	结果	阈值	判定
方程	100%（31/31）	90%	通过
检索	83.3%（10/12），在 58 篇论文中排入前 3	80%	通过
引用	86.5%（32/37）	85%	通过
解析器	0% 误报（0/8 条虚构内容）	≤10%	通过

解读这些结果时，请结合其适用范围。在 58 篇论文中「找到正确论文并排入前 3」是一项真正的任务；若只有 8 篇，几乎不费吹灰之力；而早先的一次运行报告了毫无意义的 100%，因为 top_k 超过了语料库大小。引用阈值定为 85% 而非 100%，是因为书籍、学位论文和数字化前的文章确实不在任何索引中——nEDM 信件中剩余未能匹配的内容是一份 1954 年的丹麦期刊、一篇 1955 年的 Pauli 章节和一本 1982 年的牛津图书。

在 Claude 中使用

pip install "noether-physics[mcp]"
claude mcp add --scope user noether -- python -m noether.mcp_server

14 个工具。Claude 负责推理和编写；NOETHER 负责检索、检查和记录。我们有意不提供 write_answer 工具——可能产生幻觉的组件，并不是决定最终交付内容的组件。

安装

pip install noether-physics              # core
pip install "noether-physics[quantum]"   # + QuTiP simulations
pip install "noether-physics[mcp]"       # + MCP server

需要 Python 3.12+。从源码安装：uv venv && uv pip install -e ".[dev,quantum,mcp]"，然后运行 uv run pytest （288 项测试，无需联网——默认使用录制内容回放；若未命中则会报错，而不会实时回退）。

条款

arXiv 禁止批量爬取。本工具每次仅获取一篇论文，间隔 3 秒，并永久缓存，因此每篇论文只会下载一次。所有来源、速率限制和条款均在 research/sources/source_registry.yaml 中声明；不在该文件中的来源不会被调用。

不使用 AI 生成的图像。 每张图都从真实论文中提取，或由代码和数据以确定性方式生成，并标注其来源。

许可证

MIT——详见 LICENSE。发布历史：CHANGELOG.md。

此名称是对 Emmy Noether 的致敬。由于 noether 已被一个无关的物理单位库占用，PyPI 发行包名为 noether-physics；无论哪种情况，命令都为 noether。