主题
A - 工具链配置
Zotero, Obsidian, LaTeX, 本地研究工作台,以及按流程选择工具
按流程选工具
这一附录主要回答两个问题:
- 本地工作台怎么搭起来
- 每个研究阶段优先打开什么工具
如果你在找的是“可单独运行的自动化科研项目”或“可复用的研究型 skill”,请直接看 附录 D。
| 阶段 | 本地基础工具 | 可叠加的研究工具 |
|---|---|---|
| 文献调研 | Zotero, Obsidian | PaSa, PaperQA2, Open Deep Research, GPT Researcher |
| 想法生成 | Obsidian, 白板, issue tracker | The AI Scientist, HypoGeniC |
| 新颖性验证 | Zotero, 本地 PDF, 对比表格 | PaperQA2, Scholar QA |
| 实验执行 | Python, uv, Git, W&B/MLflow | 自动化实验脚本、Agent 执行器 |
| 结果分析 | Jupyter, matplotlib, pandas | 结果归纳 agent、审稿模拟器 |
| 写作与审稿 | LaTeX, BibTeX, 语法检查 | ARIS review loop, AI Scientist review |
建议的工作目录
如果你希望把“人类工作流”和“智能体工作流”放在同一个项目里,建议至少区分这些目录:
text
project/
├── papers/ # PDF、相关工作
├── notes/ # 文献笔记、想法记录
├── artifacts/ # novelty report, pilot log, review memo
├── experiments/ # 代码和配置
├── results/ # 原始结果和汇总结果
├── paper/ # 论文草稿
└── scripts/ # 自动化脚本关键不是目录名,而是:每个阶段都要留下可复查的产物。
Zotero — 文献管理
安装
- 官网:https://www.zotero.org/
- 下载桌面客户端
- 安装浏览器插件(Zotero Connector)
工作流
1. 浏览器发现论文 → 点击 Zotero Connector → 保存到 Zotero
2. Zotero 自动提取:标题、作者、年份、摘要
3. 添加标签、笔记
4. 导出 BibTeX常用功能
| 功能 | 用途 |
|---|---|
| Collections | 按项目组织论文 |
| Tags | 标记主题、状态 |
| Notes | 记录你的理解 |
| Search | 快速查找 |
| Export | 导出 BibTeX |
Better BibTeX 插件
安装后可以:
- 自动生成 citation key
- 保持 BibTeX 同步
- 支持 Obsidian 集成
安装:
- Zotero → Tools → Add-ons
- 搜索 "Better BibTeX"
- 安装
导出 BibTeX
- 选择 Collection
- File → Export Library
- 格式选择 "BibTeX"
- 保存到
references.bib
Obsidian — 知识管理
安装
- 官网:https://obsidian.md/
- 下载桌面客户端
结构
vault/
├── 00-inbox/ # 快速捕捉
├── 01-projects/ # 项目笔记
├── 02-literature/ # 文献笔记
├── 03-concepts/ # 概念卡片
├── 04-templates/ # 模板
└── attachments/ # 附件文献笔记模板
markdown
# {{title}}
## Metadata
- Authors: {{authors}}
- Year: {{year}}
- Venue: {{venue}}
- URL: {{url}}
- Tags: #paper #{{topic}}
## Summary
[1-2 句总结]
## Key Points
- Point 1
- Point 2
- Point 3
## Method
[方法描述]
## Results
[关键结果]
## Thoughts
[你的想法]
## Questions
- Question 1?
- Question 2?
## Related
- [[Related Paper 1]]
- [[Related Paper 2]]Zotero 集成
使用插件 "Zotero Integration":
- 在 Zotero 中选中论文
- 在 Obsidian 中插入模板
- 自动填充元数据
Dataview 插件
查询笔记:
dataview
TABLE authors, year, venue
FROM "02-literature"
WHERE contains(tags, "diffusion")
SORT year DESCLaTeX — 论文写作
安装
选项 1:完整 TeX 发行版
- TeX Live (Linux/Windows)
- MacTeX (macOS)
选项 2:在线编辑器
- Overleaf(推荐新手)
编辑器
| 编辑器 | 特点 |
|---|---|
| VS Code + LaTeX Workshop | 免费,功能强大 |
| Overleaf | 在线,协作方便 |
| TeXstudio | 传统,稳定 |
VS Code 配置
json
// settings.json
{
"latex-workshop.view.pdf.viewer": "tab",
"latex-workshop.latex.autoBuild.run": "onFileChange",
"latex-workshop.latex.recipe.default": "latexmk"
}编译
bash
# 单次编译
pdflatex main.tex
# 完整编译(包含引用)
pdflatex main.tex
bibtex main
pdflatex main.tex
pdflatex main.tex
# 或用 latexmk(自动)
latexmk -pdf main.texMakefile
makefile
PAPER = main
all:
latexmk -pdf $(PAPER).tex
clean:
latexmk -c
rm -f *.bbl *.aux *.log *.out
watch:
latexmk -pvc -pdf $(PAPER).texGit — 版本控制
初始化
bash
git init
git add .
git commit -m "Initial commit".gitignore
gitignore
# LaTeX
*.aux
*.bbl
*.blg
*.log
*.out
*.synctex.gz
# Python
__pycache__/
*.pyc
.ipynb_checkpoints/
# Data
data/
*.pkl
*.pt工作流
bash
# 日常提交
git add .
git commit -m "Add method section"
# 查看历史
git log --oneline
# 恢复
git restore -- filename其他有用工具
Python 环境
推荐优先顺序:
- uv(默认推荐):轻量、快、适合 paper / pilot 项目
- conda / mamba:需要更重的系统依赖、CUDA 绑定或跨语言库时
- venv:最基础 fallback
uv(推荐)
bash
# 安装并固定 Python
uv python install 3.11
# 创建虚拟环境
uv venv --python 3.11
# 激活环境
# Windows PowerShell
.venv\Scripts\Activate.ps1
# Linux / macOS
# source .venv/bin/activate
# 添加依赖
uv add pyyaml pandas rich
# 运行脚本
uv run python scripts/run_pilot.py --config configs/pilot/base.yaml
# 根据 lockfile 同步依赖
uv sync适合场景:
- Pilot 实验项目
- 单论文仓库
- 需要快速复制环境给合作者或智能体
- 想把依赖放进
pyproject.toml和 lockfile,而不是散落在手写命令里
Conda / mamba
bash
# Conda
conda create -n paper python=3.10
conda activate paper
# 或 mamba
# mamba create -n paper python=3.10
# mamba activate papervenv
bash
python -m venv venv
venv\Scripts\Activate.ps1 # Windows PowerShell
# source venv/bin/activate # Linux/macOS实验跟踪
| 工具 | 特点 |
|---|---|
| TensorBoard | 轻量,集成 PyTorch |
| Weights & Biases | 功能强大,云端 |
| MLflow | 开源,自托管 |
图表制作
| 工具 | 用途 |
|---|---|
| matplotlib | Python 绑定图表 |
| seaborn | 统计图表 |
| plotly | 交互图表 |
| draw.io | 示意图 |
| PowerPoint | 简单图 |
AI 辅助
| 工具 | 用途 |
|---|---|
| Claude | 写作辅助 |
| Grammarly | 语法检查 |
| DeepL | 翻译 |
更完整的 AI/ML 研究工具入口见:附录 D
检查清单
| 工具 | 安装 | 配置 |
|---|---|---|
| Zotero | ✅ | Better BibTeX |
| Obsidian | ✅ | Zotero Integration |
| LaTeX | ✅ | 编辑器选择 |
| Git | ✅ | .gitignore |
| Python | ✅ | 虚拟环境 |
提示:工具只是工具,不要花太多时间配置。先开始写,遇到问题再解决。