【免费下载链接】Agentero为人与 Agent 协作而生的一站式科研工作台项目地址https://gitcode.com/gh_mirrors/ag/Agentero点击查看免费下载Agentero 是一款为人与 Agent 协作而生的一站式科研工作台内置强大的论文翻译能力。这篇指南带你用 3 步完成 Agentero 论文翻译配置只需在设置里填写 OpenAI 兼容模型的 API Key、Base URL 和模型名即可开启 PDF 划词翻译与整篇全文翻译让英文文献阅读不再是障碍。一、3 步完成 Agentero 翻译配置整个配置过程都在Settings → 翻译中完成无需编写任何代码。找到入口打开应用设置窗口在左侧导航栏选择「翻译」分区。填写 API 服务展开API 服务 → OpenAI 兼容卡片填写三个字段字段填写方式API Key服务商控制台生成的密钥只填在设置页不要写进文档或 Git端点填Base URL根地址例如https://api.openai.com/v1不要带完整请求路径模型服务商实际支持的模型 ID例如gpt-4.1-mini、deepseek-chat确定并切换默认服务点「确定」后设置页会自动发起一次 5 秒的连通性 probe通过后把顶部的「默认服务」下拉切换到「OpenAI 兼容」即可在 PDF 中使用划词翻译与全文翻译。 如果你用的是官方发布的桌面版本下拉列表里通常还有「Agentero 内置」通道Hunyuan-MT选中即用、无需填任何密钥本文聚焦的是接入自己的 OpenAI 兼容模型这条 BYOK 路径。二、常见 OpenAI 兼容模型服务怎么填Agentero 只要求服务支持Chat Completions格式。以下 Base URL 可直接参考以服务商控制台为准服务Base URL 示例常见模型 IDOpenAIhttps://api.openai.com/v1gpt-4.1-miniDeepSeekhttps://api.deepseek.comdeepseek-chatKimi / Moonshothttps://api.moonshot.ai/v1moonshot-v1-8k等Qwen 兼容模式https://maas.qwencloudapi.com/compatible-mode/v1以控制台为准SiliconFlowhttps://api.siliconflow.cn/v1以控制台为准智谱 BigModelhttps://open.bigmodel.cn/api/paas/v4以控制台为准⚠️ 特别提示MiniMax 中国区 M3 的text/chatcompletion_v2接口不是Chat Completions 形态当前版本无法通过「OpenAI 兼容」通道接入。三、两个翻译入口划词翻译与全文翻译配置完成后两个入口即刻可用1. 划词翻译️ 在 PDF 中选中任意词句从选区菜单点击「翻译」译文卡片会贴合选区出现。支持「钉住」译文把翻译结果与页边重开入口一并保留开启「划词自动翻译」后选区一提取完成即自动翻译并弹出结果卡。2. 全文翻译 点击 PDF 工具栏的 Languages全文翻译按钮Agentero 会基于版面分析结果把正文、摘要、图表标题按阅读顺序分批翻译直接覆盖在原文对应区域上参考文献、算法框与侧栏文字不会被翻译。译文按论文缓存在本地换页、重开不用重翻。还可以逐页翻译hover 每页左上角页签可只翻译当前页双栏对照在 Settings → 翻译 的「翻译显示模式」中选择「双栏对照」原文右侧会打开一个只读译文 PDF 面板滚动自动同步。四、为什么只填 Base URL不填完整请求地址这是新手最容易踩的坑。Agentero 会自动把你的端点拼成POST {baseUrl}/chat/completions请求体是标准 Chat Completions 风格system user 两条消息、temperature0.2并从choices[0].message.content取回译文。所以端点必须填根地址下面的写法都会失败错误写法原因https://api.openai.com/v1/chat/completionsAgentero 已自动追加/chat/completions重复拼接.../v1/responsesResponses API 不是 Chat Completions.../v1/completions旧 Completions API 没有messages/choices结构.../v1/text/chatcompletion_v2MiniMax 自定义文本接口非兼容端点五、probe 探测失败按 6 步排查保存设置后的 5 秒 probe 失败时按以下顺序检查区域是否匹配中国区与国际区的账号、Key、域名往往不互通以服务商控制台为准端点是否是 Base URL确认没有多带/chat/completions等路径模型名是否精确模型 ID 区分服务商与区域照控制台原样填写Key 是否有效401/403通常是 Key、区域或权限问题检查余额、套餐与 RPM/TPM 限制网络与代理Settings → General → Network proxy 会影响翻译请求的出站超时或限流probe 只有 5 秒而真实翻译默认 30 秒超时——高峰期可能 probe 失败但正式翻译仍能成功可先试着直接划词验证。密钥安全Agentero 会把 Key 明文保存在本机settings.jsonUnix 权限0600界面上只显示同长度*掩码一旦 Key 泄露到聊天、Issue 或截图中请立即去服务商控制台撤销重建。六、可选进阶自定义翻译提示词「OpenAI 兼容」与 Agent 两条 LLM 路径支持在 Settings → 翻译 中填写自定义系统提示词 / 用户模板让译文更贴合你的风格一行短口语如「翻译得自然一点」会作为附加偏好追加多行内容会替换默认学术风格块模板占位符只认{{targetLang}}/{{sourceLang}}/{{text}}用户模板非空时必须包含{{text}}「引擎规则」只输出译文、公式与引用标记原样保留、不反问始终生效无法被覆盖。注意修改提示词后与提示词指纹绑定的全文翻译缓存会整体失效、触发重译属预期行为。七、总结与相关资源能力一句话小结划词翻译选区菜单一键触发可钉住译文支持自动翻译全文翻译基于版面分析分批翻译覆盖正文 / 摘要 / 图表标题本地缓存命中免重翻OpenAI 兼容接入只填 Base URL Key 模型 ID5 秒 probe 即验证连通 相关文档与源码路径内容路径OpenAI 兼容翻译配置说明docs/usage/translate-openai-compatible.md翻译后端设计docs/backend/translate.md内置 ProviderHunyuan-MTdocs/backend/builtin-provider.md翻译前端功能说明docs/frontend/translate.md翻译设置面板 UIsrc/components/settings/panes/translate-pane.tsxOpenAI 兼容翻译引擎crates/agentero-core/src/features/translate/sources/openai_compatible.rs按本指南完成配置后你的 Agentero 就能用任意 OpenAI 兼容大模型流畅阅读英文论文了——先划词试一句再点一次全文翻译看看整篇中文覆盖效果吧。赞分享【免费下载链接】Agentero为人与 Agent 协作而生的一站式科研工作台项目地址https://gitcode.com/gh_mirrors/ag/Agentero点击查看免费下载相关推荐SketchyBar翻译功能终极指南如何在macOS状态栏快速实现划词翻译SketchyBar翻译功能终极指南如何在macOS状态栏快速实现划词翻译 SketchyBar是一款高度可定制的macOS状态栏替代工具让用户能够完全自定桌面应用FancyZones 窗口管理完整指南5 步重建你的多屏工作流FancyZones 窗口管理完整指南5 步重建你的多屏工作流 晚上九点桌面上十几个窗口散得满地都是每次想找哪个窗口都得先拖半天。FancyZones 窗桌面应用如何快速学习SolidityCryptoZombies 10天速成教程如何快速学习SolidityCryptoZombies 10天速成教程 Solidity是以太坊智能合约的核心编程语言而CryptoZombies课程通过游上一篇HyperFormula最佳实践从代码规范到生产环境部署的完整指南下一篇iOS照片浏览器性能优化终极指南MWPhotoBrowser图片解码与渲染技巧创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考