如何边读原文边问AI：zotero-AI-Butler侧边栏沉浸式阅读实战（LaTeX公式渲染+追问教程）-平芜编程栈

人工智能
大模型
AI 应用
科研

【免费下载链接】zotero-AI-Butler

【Zotero AI 管家】调用大模型，自动精读论文库里的论文，总结为Zotero笔记。支持主流大模型平台！您只需像往常一样把文献丢进 Zotero，管家会自动帮您精读论文，将文章揉碎了总结为笔记，让您“十分钟完全了解”这篇论文！

项目地址：https://gitcode.com/gh_mirrors/zo/zotero-AI-Butler

读论文时左右翻屏找摘要、复制问题丢给聊天窗口，是很多科研新手的高频痛点。开源 Zotero 插件zotero-AI-Butler（AI 管家）的侧边栏功能，让您可以一边读论文原文、一边看 AI 生成的讲解笔记，还支持LaTeX 公式渲染与大模型追问——读完即懂，十分钟吃透一篇论文。本文用 5 个步骤带您完成沉浸式阅读配置。

1. 为什么需要沉浸式阅读？

传统"总结→关闭→再打开原文"的阅读方式，会不断打断心流。AI 管家的侧边栏方案是：选中论文条目后，Zotero 右侧面板自动显示这篇文献的 AI 笔记，原文与讲解并排呈现，眼睛不用离开屏幕：

自动检测：自动查找并显示 AI 管家生成的笔记，没有笔记时还可一键召唤生成
折叠/展开：点击标题栏随时收起，不占阅读空间
高度可调：拖拽底部手柄调整笔记区域高度，设置自动保存
字体缩放：标题栏 +/− 按钮快速调字号

对照阅读的实际效果——左边读 PDF 原文，右边看 AI 管家对方法细节的逐步拆解：

2. LaTeX 公式渲染：数学论文不再满屏乱码

AI 笔记里如果直接贴 $\sigma(x) = \frac{1}{1+e^{-x}}$ 这样的原始 LaTeX 源码，读起来毫无体验。AI 管家内置 KaTeX 引擎（样式加载逻辑见 themeManager.ts 的loadKatexCss），侧边栏笔记中的公式会被自动识别并渲染：

行内公式 $...$ 与块级公式$$...$$自动识别
长公式自动出现横向滚动条，不撑破版式
公式样式随 Zotero 明暗主题自动适配

渲染效果如下——Sigmoid 激活函数、Transformer 注意力机制公式都以标准排版呈现：

💡 KaTeX 字体文件内置于插件包 addon/content/fonts/，离线也能正常渲染，无需联网加载。

3. 边读边问：两种追问模式怎么选？

阅读中遇到不懂的段落，直接点击侧边栏顶部的追问按钮，无需离开 Zotero：

模式	上下文范围	是否保存	适用场景
📑完整追问	论文全文/附件 + AI 笔记 + 已保存的追问历史	✅ 自动保存到笔记	深度讨论，想留档的问答
💬快速追问	论文全文/附件 + 当前对话框记录，可附加临时关联文献	❌ 刷新即清空	临时确认，不想污染笔记

按钮文案与上下文说明定义在 addon.ftl，按钮与交互逻辑实现在 ItemPaneSection.ts 的renderActionButtons中。

推荐提问姿势：读到某个方法细节时，指着原文问"这段的消融实验为什么重要？"；快速追问适合问"式(3)里的 d_k 是什么含义"这类小问题，答案用完即弃。

4. 实战技巧：固定侧边栏 + 切换笔记主题

📌 固定侧边栏，翻页不打断

频繁翻页会让侧边栏跟着跳动。右键侧边栏最右侧的"AI 管家"图标，选择**"固定此栏"**，再切换文献时讲解窗口始终跟随，心流不断线；再次右键选"取消固定此栏"即可恢复。

🎨 一键切换笔记样式

侧边栏笔记支持两种内置主题，点击标题栏样式按钮即可切换：

GitHub（默认）：简洁清爽
红印（Redstriking）：红色强调重点，适合标记式阅读

主题 CSS 位于 addon/content/markdown_themes/，界面设置入口对应 UiSettingsPage.ts。

5. 常见问题速查

侧边栏没有出现 AI 笔记？说明该文献还没生成过笔记，点击侧边栏的"召唤 AI 管家"按钮即可一键生成（需先在 API 配置指南中配好 API 密钥）。
公式显示异常？确认大模型输出的公式使用 $...$ /$$...$$标准写法；侧边栏对 KaTeX 渲染有专门的滚动与适配样式，见 ItemPaneSection.ts。
更多问题？参考常见问题 FAQ 与快速开始。

写在最后

把 zotero-AI-Butler 侧边栏用起来后，阅读工作流变成一条流水线：AI 笔记速览 → 原文对照精读 → 遇到公式看渲染 → 存疑处即时追问。核心源码可追溯至 ItemPaneSection.ts（侧边栏整体实现）与 themeManager.ts（主题与 KaTeX 加载），欢迎在源码中进一步定制您的专属阅读体验。