安装与接入

对大多数用户而言，只需把 Mdtero 接入 Agent；不需要先学习 CLI 命令。

接入 Agent

1. 打开 Mdtero 控制台，新建 API 密钥。
2. 选择 Agent，复制简短提示词。
3. 把提示词交给你信任的 Agent。它会先阅读本指南、安装受支持的 Mdtero 客户端，并在完成后确认。

提示词中含有一次可见的密钥，应像密码一样对待：只交给可信的 Agent，不要放进仓库、终端历史、日志或另一段聊天。环境不再可信时，请在控制台撤销该密钥。

自行安装

当前支持的 alpha 客户端是 Python mdtero 包：

uv tool install --upgrade mdtero
mdtero setup

没有 uv 时使用安装脚本：

curl -Ls https://mdtero.com/install.sh | sh

mdtero setup 会打开安全登录流程。使用控制台密钥时，仅在客户端的安全提示中输入；不要把密钥拼到命令后面。完整命令参考见 API 参考。

选择你的环境

环境	推荐路径
校园网 Windows/macOS，且有浏览器	直接使用 CLI。安装器会自动准备本地访问能力；浏览器扩展只作为当前页面或既有登录态的备用方案。
只有服务器	配置 CLI/API 密钥。使用 OA/API/HTTP 路径或上传文件；服务器没有本地浏览器授权。
服务器 + 校园电脑	服务器安装 CLI，校园电脑安装 Relay。这是处理浏览器授权、闭源或受 bot 保护论文的推荐路径。
服务器 + 校园 VPN	配置 CLI/API 密钥和 VPN/代理。它能改善按 IP 授权的机器可读资源，但不能代替浏览器会话。

第三种路径让 Agent 留在云端，而用户自己的浏览器留在校园网。Relay 只把已验证的 PDF 或脱敏静态文章 HTML 交给 Mdtero；不会导出 cookie、凭证、浏览器存储或通用浏览器会话。

服务器也可以由运维部署仅面向开放获取文章的受限无头 worker。它没有用户 cookie 或机构登录状态，不是通用 FlareSolverr，也不能处理闭源内容。

浏览器扩展与已保存文件

CLI 和本地访问能力是默认路径。只有在论文已经打开在你的浏览器中，或出版社必须使用普通浏览器里的既有登录态、而独立的 Mdtero Access 浏览器无法复用时，才使用浏览器扩展。也可以上传你有权使用的 PDF、EPUB、HTML 或 XML 文件。

Mdtero 仅处理你有权访问的内容，不会提供或绕过出版社订阅、机构授权或付费墙。

本地访问能力

桌面安装会自动准备本地访问能力。电脑位于校园网时，它可以提供校园 HTTP 出口，并在需要时使用独立的 Mdtero Access 浏览器处理合规的出版社任务。服务器和无头安装会跳过桌面浏览器组件。

该能力绑定到你的 Mdtero 账户。本地浏览器模式只能为同一账户采集受批准的文章 HTML 或 PDF；不会导出 cookie、凭证、浏览器存储，也不是通用浏览器代理。机构登录和出版社挑战仍需你本人完成，内容仍须由出版社授权。

安装和运行细节维护在中继仓库中： 校园中继指南。

更新

可以让 Agent 按本指南更新 Mdtero，或重新运行：

uv tool upgrade mdtero

公开工作流保持稳定：提交有权使用的材料，等待任务完成，下载结构化 Markdown，并在研究结论中保留引文。