Mdtero 文档

Mdtero 把论文转换为结构化 Markdown，支持阅读、带引文的研究工作和本地 agent 工作流。

Mdtero Account 用于登录、额度、计费和 API key 管理。Python 客户端、浏览器扩展和 agent skill 共用任务历史与下载结果。

从这里开始

uv tool install --upgrade mdtero
mdtero setup
mdtero doctor --json

• 阅读人类和 Agent 总览，了解常规工作流。
• 阅读安装，了解 Agent 接入、浏览器扩展和自行安装。
• 自己集成客户端时阅读 API 参考。
• 在 mdtero.com 管理账户和安装入口。

可以做什么

• 检索论文并把选中的结果加入项目。
• 解析 DOI、arXiv 链接，或你有权使用的 PDF、EPUB、HTML、XML 文件。
• 下载 Markdown 与相关资源，然后请求翻译。
• 导入 Zotero 或 BibTeX 元数据，不改写 Zotero 的文献条目。
• 文档处理完成后，对项目提问并获得带引文的结果。
• 通过 CLI、浏览器扩展或已安装的 agent skill 继续本地工作流。

安全交接

让本地 agent 接手时使用 JSON 输出：

mdtero doctor --json
mdtero mcp briefing --json

这些命令会提供任务状态、可下载成果、质量提示、引文和下一步操作，不会打印已保存的 secret。API key 只应交给可信机器，并仅在 mdtero setup --api-key --json 的安全提示中输入，不要放进命令行或聊天记录。

产品边界

Mdtero 用于处理你有权访问的内容。出版社订阅、机构访问和来源专用凭据仍由用户自行负责。论文依赖浏览器登录态或本地文件时，请使用扩展或上传已保存的文件。

解析实现和来源选择是服务内部行为，不是用户配置项。稳定的公开流程是：提交、查看状态、下载、翻译，再在项目中使用生成的 Markdown。