1. 投稿前本地编译总失败：Elsevier 上传 tex/bib/pdf 三件套到底怎么配

Elsevier 投稿系统对 LaTeX 稿件的处理逻辑，和很多人想的不太一样。我第一次投的时候，把整份项目打包成一个 zip 直接传，系统提示 "PDF failed to build"；后来只传 PDF，又提示缺少源文件；再后来把 tex 和 bib 分开传，还是报错。折腾了大半天才搞明白：Elsevier 的 Editorial Manager 其实把「manuscript 正文 PDF」和「LaTeX 源文件包」当成两个独立的上传槽位，PDF 用于审稿人阅读，源文件包用于后期排版，两者必须分别准备、分别上传。

这个场景下真正容易翻车的地方，往往不在投稿系统本身，而在你本地编译这一步。很多作者本地用 Overleaf 或者某个模板能跑通，一换到本地 TeX Live 就报File 'xxx.sty' not found，或者 bib 引用全是问号，或者编译出来的 PDF 页码、行号、参考文献格式和期刊要求对不上。等到上传时才发现问题，改起来就很被动。

所以这篇内容聚焦一件事：在正式上传 Elsevier 之前，怎么把本地编译环境配好、把 tex/bib/pdf 三件套验证到位。我会给出一套可复制的统一 Key 配置骨架（settings.json / config.toml），配合 tex/bib/pdf 的编译与上传前检查动作。如果你平时用 AI 辅助写 LaTeX 或者做文献整理，这套配置能让你在编辑器、命令行、脚本之间共用同一套模型接入参数，减少来回改配置的麻烦。

适合谁看：正在准备 Elsevier 投稿、本地用 LaTeX 写稿、需要处理 bib 参考文献、并且希望把编译验证流程固定下来的作者。下面从环境准备开始，一步步来。

2. TaoToken 统一 Key 前置：settings.json 与 config.toml 骨架

在讲编译之前，先把「统一 Key」这件事说清楚。很多作者在本地会同时用多个工具：VS Code 里的 LaTeX 插件、命令行脚本、可能还有 AI 辅助润色或文献摘要的工具。如果每个工具都单独配一套 API Key 和 Base URL，改起来非常痛苦，而且容易配错。

TaoToken 的思路是提供一个统一的接入地址，你只需要维护一份 Key 和一份 Base URL，就能在不同工具里复用。官网是 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，API 接入地址是 https://taotoken.net/api （这个不加 UTM）。注意，API 地址和官网地址是分开的，配置的时候别填错。

先说你需要在控制台拿到什么。打开 https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_content=console&utm_campaign=rewrite ，创建一个 API Key。这个 Key 就是你后面所有配置里要填的东西。拿到之后，建议先放到环境变量里，而不是硬编码在配置文件里，这样更安全，也方便多工具共享。

Linux/macOS 下可以这样：

export TAOTOKEN_API_KEY="sk-你的key" export TAOTOKEN_BASE_URL="https://taotoken.net/api"

Windows PowerShell：

$env:TAOTOKEN_API_KEY="sk-你的key" $env:TAOTOKEN_BASE_URL="https://taotoken.net/api"

接下来是两份配置文件骨架。第一份是settings.json，适合 VS Code 类编辑器或者支持 JSON 配置的工具：

{ "apiKey": "${TAOTOKEN_API_KEY}", "baseUrl": "https://taotoken.net/api", "model": "claude-sonnet-4-20250514", "timeout": 60000, "maxRetries": 3 }

第二份是config.toml，适合命令行工具或者 Python 脚本读取：

[api] base_url = "https://taotoken.net/api" api_key = "${TAOTOKEN_API_KEY}" model = "claude-sonnet-4-20250514" timeout = 60 [compile] engine = "pdflatex" bib_engine = "bibtex" output_dir = "./build"

这两份配置的核心字段是一致的：Base URL 固定为https://taotoken.net/api，Key 从环境变量读取，Model ID 按你实际使用的模型填写。如果你用的是 Claude Code 或者类似的编码工具，Model ID 要和你订阅的模型对应，别随便填一个不存在的名字，否则会报model not found。

这里有个细节：${TAOTOKEN_API_KEY}这种写法是否被解析，取决于你用的工具。有些工具支持环境变量插值，有些不支持。如果不支持，你就得在启动脚本里先做替换，或者直接用工具自己的密钥管理功能。我一般会在项目根目录放一个.env文件，然后用dotenv类库加载，这样 JSON 和 TOML 里都能引用。

配置好之后，先别急着编译 LaTeX，先用一个最小请求验证 Key 是否可用。可以用 curl：

curl -X POST "https://taotoken.net/api/v1/messages" \ -H "Content-Type: application/json" \ -H "x-api-key: $TAOTOKEN_API_KEY" \ -H "anthropic-version: 2023-06-01" \ -d '{ "model": "claude-sonnet-4-20250514", "max_tokens": 64, "messages": [{"role": "user", "content": "ping"}] }'

如果返回里有正常的content字段，说明 Key 和 Base URL 都没问题。如果返回 401，先检查 Key 有没有复制完整、有没有多余空格；如果返回local proxy failed，那基本是网络层或者地址填错了，重点看 Base URL 是不是写成了官网地址而不是 API 地址。

3. 可复制配置：Elsevier 模板下的 tex/bib/pdf 编译链路

现在进入正题：Elsevier 投稿的 LaTeX 项目，本地怎么编译出可上传的 PDF 和源文件包。Elsevier 官方推荐使用elsarticle文档类，模板一般包含主 tex 文件、.bib参考文献文件、图片目录、以及可能的.cls和.bst文件。

先看一个典型的项目结构：

manuscript/ ├── main.tex ├── refs.bib ├── elsarticle.cls ├── elsarticle-num.bst ├── figures/ │ ├── fig1.pdf │ └── fig2.pdf └── build/

主文件main.tex的头部大概是这样：

\documentclass[preprint,12pt]{elsarticle} \usepackage{graphicx} \usepackage{amsmath} \usepackage{hyperref} \begin{document} \begin{frontmatter} \title{Your Paper Title} \author{Author Name} \affiliation{organization={Your Institution}} \begin{abstract} Your abstract here. \end{abstract} \begin{keyword} keyword1 \sep keyword2 \end{keyword} \end{frontmatter} \section{Introduction} \label{sec:intro} Your text here \cite{ref1}. \bibliographystyle{elsarticle-num} \bibliography{refs} \end{document}

编译链路是四步：pdflatex→bibtex→pdflatex→pdflatex。很多人只跑一次 pdflatex 就以为完事了，结果引用全是问号，或者目录页码不对。正确顺序如下：

cd manuscript pdflatex -output-directory=build main.tex bibtex build/main pdflatex -output-directory=build main.tex pdflatex -output-directory=build main.tex

注意bibtex那一步的参数是build/main，不带.aux后缀，也不带.tex。如果你写成bibtex build/main.aux，有些版本会报错。跑完之后，build/目录里应该有main.pdf、main.aux、main.bbl、main.blg等文件。

如果你用bibtex一直报I couldn't open database file refs.bib，大概率是工作目录不对。bibtex默认在当前目录找.bib文件，而你的main.aux在build/里，它记录的 bib 路径可能是相对的。解决办法有两个：一是把.bib文件也复制到build/目录，二是用BIBINPUTS环境变量指定搜索路径：

export BIBINPUTS=".:./build:"

或者干脆不用-output-directory，直接在项目根目录编译，生成的文件散落一地但不容易出错。投稿前我一般会用一个Makefile把流程固定下来：

MAIN = main BUILD = build all: pdf pdf: mkdir -p $(BUILD) pdflatex -output-directory=$(BUILD) $(MAIN).tex bibtex $(BUILD)/$(MAIN) pdflatex -output-directory=$(BUILD) $(MAIN).tex pdflatex -output-directory=$(BUILD) $(MAIN).tex clean: rm -rf $(BUILD)

这样每次make就能完整跑一遍，不用记命令顺序。如果你用 VS Code 的 LaTeX Workshop，可以在settings.json里配一个 recipe，把bibtex插进去。前面给的settings.json骨架里已经有compile相关字段，你可以按自己的工具格式扩展。

关于 PDF 验证，重点看三件事：第一，参考文献编号是否连续、是否和正文引用对应；第二，图片是否都正常显示，有没有??占位；第三，页眉页脚、行号、作者信息是否符合期刊要求。Elsevier 的preprint选项会生成单栏、带行号的版本，适合审稿；review选项会隐藏作者信息，适合双盲审。投稿前确认你用的选项和期刊要求一致。

源文件包（zip）的准备也有讲究。Elsevier 一般要求上传包含.tex、.bib、.cls、.bst、图片的压缩包，但不要包含编译生成的.aux、.log、.out、.pdf（除非期刊明确要求）。我一般会这样打包：

cd manuscript zip -r submission.zip main.tex refs.bib elsarticle.cls elsarticle-num.bst figures/ -x "*.aux" "*.log" "*.out" "*.pdf"

注意figures/目录里的图片要保留，但如果你有生成的中间 PDF 不想传，可以用-x排除。打包完先自己解压到另一个目录，重新编译一遍，确认没有缺失文件。这一步能提前发现「本地能跑、换目录就报错」的问题。

4. 验证请求与成功结果：编译日志与上传前检查清单

编译跑完之后，别急着上传。先看日志，重点搜几个关键词。pdflatex的日志在build/main.log，bibtex的日志在build/main.blg。

在main.log里搜Warning和Error。常见的无害警告包括Overfull \hbox（排版溢出，不影响编译）和Font shape ... not available（字体替换，一般可忽略）。真正要处理的是LaTeX Error: File 'xxx.sty' not found，这说明缺宏包，需要装或者换编译引擎。

在main.blg里搜Warning--。如果看到Warning--I didn't find a database entry for "ref1"，说明正文引用了 bib 里不存在的条目，需要补上或者删掉引用。如果看到Warning--empty journal in ref1，说明 bib 条目字段不全，Elsevier 对参考文献格式要求比较严，建议补全。

验证 bib 是否真正生效，最直接的方法是打开生成的 PDF，翻到参考文献部分，看编号是不是从 [1] 开始连续排列，正文里的\cite{}是不是都变成了数字。如果还是问号，说明bibtex那一步没跑成功，或者.bbl文件没被pdflatex读进去。

上传前的检查清单，我一般按这个顺序过一遍：

如果这些都没问题，就可以上传了。Elsevier 的上传流程里，manuscript 槽位传 PDF，latex source file 槽位传 zip。两个都传完之后，系统会尝试自己编译一次源文件包，如果它编译失败，会给你发邮件。所以本地验证做得越充分，后面越省事。

如果你在验证过程中需要快速查某个宏包的用法，或者让 AI 帮你检查 bib 条目格式，可以用前面配好的统一 Key 接一个对话模型。模型对话入口在 https://taotoken.net/models?utm_source=taotoken_aicg_blog_end&utm_content=models&utm_campaign=rewrite ，把报错日志贴进去，让它帮你定位问题，比手动搜快很多。

5. 本篇常见错排查：401、local proxy failed、reading choices、OAuth

这一节把配置和编译过程中最容易撞到的几个报错集中说一下。这些错误我基本都踩过，按现象、原因、解决三步来。

401 Unauthorized。这个最直接，Key 不对。检查三件事：Key 有没有复制完整（有时候复制会漏掉最后几位）、有没有多余空格或换行、环境变量有没有真正加载。在终端里echo $TAOTOKEN_API_KEY看一下，如果输出为空，说明export没生效，或者你开的是新的终端窗口。Windows 下注意 PowerShell 和 CMD 的环境变量语法不一样，别混用。

local proxy failed。这个报错通常出现在请求发不出去的时候。先确认 Base URL 是不是https://taotoken.net/api，别写成官网地址。然后确认你的网络能正常访问这个地址，可以用curl -I https://taotoken.net/api看返回头。如果返回 404 或 502，说明地址或服务状态有问题；如果直接连接超时，检查本地网络设置。注意，这里不要用任何网络代理工具，直接用正常网络访问即可。

reading choices 相关报错。这个一般出现在解析模型返回的时候，比如你期望返回 JSON，但实际返回了别的格式，或者返回体里没有choices字段。先确认你调用的接口路径和请求体格式是否匹配。Anthropic 风格的接口返回的是content数组，OpenAI 风格的接口返回的是choices数组，两者不一样。如果你用的工具默认按 OpenAI 格式解析，但实际接的是 Anthropic 风格接口，就会报这个错。解决办法是看工具文档，确认它支持哪种接口格式，或者用中间层做转换。

OAuth 相关报错。如果你用的是 Claude Code 或者类似工具，可能会遇到 OAuth 登录失败或者 token 过期。这类工具一般有自己的登录流程，和 API Key 是两套机制。如果你已经用 API Key 配置好了，就不需要再走 OAuth。如果工具强制要求 OAuth，检查你的账号状态和订阅是否正常。遇到OAuth token expired，重新登录一次通常能解决。

bibtex 报错I found no \citation commands。这说明你的 tex 文件里没有任何\cite{}，或者\citation信息没写进.aux。检查主文件里有没有\cite{}，以及\bibliography{}的位置是否在\begin{document}之后。如果用了\nocite{*}，也会生成引用，但一般不建议在投稿稿里用。

pdflatex 报错File 'elsarticle.cls' not found。说明模板文件不在搜索路径里。把elsarticle.cls和elsarticle-num.bst放到和main.tex同一目录，或者用TEXINPUTS指定路径：

export TEXINPUTS=".:./texmf:"

上传后系统编译失败，但本地成功。这种情况通常是源文件包缺文件，或者路径大小写不一致。Elsevier 的编译环境是 Linux，对大小写敏感。检查\includegraphics{Figures/fig1}和实际目录figures/是否一致。另外，确保 zip 里没有绝对路径，解压后文件都在同一层级下。

如果你在排查过程中需要对照接口文档确认参数，接入文档在 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite ，里面有 Base URL、鉴权方式、请求格式的说明。遇到不确定的字段，先查文档再改配置，比反复试错快。

6. 长期投稿与编码工作流：把配置和编译固定下来

投稿不是一次性的活。一篇论文从初稿到接收，可能要经历多轮修改、多次重新编译、多个期刊的格式调整。如果每次都要重新配环境、重新记编译命令，效率很低，也容易出错。

我的做法是把前面这些配置和流程固化到项目模板里。新建论文项目时，直接复制一份模板目录，里面包含Makefile、settings.json、config.toml、.env.example、以及 Elsevier 的elsarticle.cls和.bst。这样每次开新稿，只需要改.env里的 Key（或者直接用环境变量），编译命令不用变。

如果你经常用 AI 辅助做文献整理、摘要翻译、或者 LaTeX 语法检查，可以把这些任务也接到同一套 Key 上。Coding Plan 适合长期、高频的编码和 Agent 类任务，入口在 https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding-plan&utm_campaign=rewrite 。对于投稿场景，你可以用它来批量处理 bib 条目格式、检查 tex 语法、或者生成图表说明文字。API Keys 管理在 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api-keys&utm_campaign=rewrite ，需要新建或轮换 Key 的时候去那里操作。

Claude Code 这类工具如果你在用，接入的时候记住三件套：Base URL 填https://taotoken.net/api，Key 填你控制台生成的，Model ID 填你实际订阅的模型名。三个都对了，才能正常跑。具体接入方式可以参考 https://taotoken.net/doc/claudecode-anthropic?utm_source=taotoken_aicg_blog_end&utm_content=claudecode-anthropic&utm_campaign=rewrite ，里面有配置示例。

最后说一个实际经验：投稿前一定要在干净目录里重新编译一遍。我试过把项目从笔记本拷到台式机，因为路径里有个空格，pdflatex直接报错。后来养成习惯，每次上传前把 zip 解压到/tmp/check这种无空格、无中文的路径下，跑一遍make，确认没问题再传。这一步多花两分钟，能省掉后面等编辑回信的几天。

编译验证做完、源文件包检查完、PDF 确认无误，就可以上传了。上传之后留意系统邮件，如果它编译失败，根据报错回到本地对应修改，重新打包再传。整个流程跑顺之后，后面再投别的期刊，换一下模板和格式要求就行，配置和编译链路不用动。