[{"data":1,"prerenderedAt":479},["ShallowReactive",2],{"blog-post-zh-translate-pdfs-with-lmstudio":3},{"id":4,"title":5,"body":6,"category":467,"coverImage":468,"date":469,"description":470,"extension":471,"meta":472,"navigation":473,"path":474,"seo":475,"slug":476,"stem":477,"__hash__":478},"blog_zh/zh/blog/translate-pdfs-with-lmstudio.md","使用 LM Studio 翻译 PDF 并保留排版",{"type":7,"value":8,"toc":434},"minimark",[9,13,35,38,43,46,53,56,84,91,97,101,104,107,110,113,138,143,146,149,152,156,167,178,185,191,196,200,203,207,214,218,221,226,229,233,244,247,251,258,261,267,272,276,279,282,285,289,292,295,298,301,304,307,310,316,321,324,327,330,362,365,368,371,374,377,381,394,398,401,405,408,412,415,419,422,425],[10,11,12],"p",{},"如果你曾把 PDF 内容复制到聊天窗口里翻译，应该很清楚问题会来得多快：标题混入正文、表格结构丢失、脚注位置错乱，最后花在重新排版上的时间甚至超过阅读本身。",[10,14,15,16,26,27,34],{},"Mac 上有一种更合适的处理方式，尤其适合希望文档始终留在本机的用户。",[17,18,19],"strong",{},[20,21,25],"a",{"href":22,"rel":23},"https://lmstudio.ai/",[24],"nofollow","LM Studio"," 可以通过桌面界面运行开源语言模型，并提供本地 API 服务。将它与 ",[17,28,29],{},[20,30,33],{"href":31,"rel":32},"https://apps.apple.com/cn/app/id6758205667",[24],"Doco Translate"," 配合，就能得到一套私密、离线且尊重原始排版的 PDF 翻译流程。",[10,36,37],{},"本文会介绍完整设置过程：在 LM Studio 中安装模型、连接 Doco Translate，以及从导入到导出翻译一份真实 PDF。",[39,40,42],"h2",{"id":41},"为什么-lm-studio-适合-pdf-翻译","为什么 LM Studio 适合 PDF 翻译",[10,44,45],{},"LM Studio 是一款支持 macOS、Windows 和 Linux 的桌面应用，可用于浏览、下载并在本地运行大语言模型。它为模型搜索、下载进度、对话测试和服务器管理提供了图形界面，无需使用终端命令。",[10,47,48,49,52],{},"模型加载后，LM Studio 会在本机提供一个 ",[17,50,51],{},"OpenAI 兼容 API","。Doco Translate 可以像连接云端 API 一样调用这个本地地址，但文档数据不会离开你的 Mac。",[10,54,55],{},"这对文档翻译有几个明显优势：",[57,58,59,66,72,78],"ul",{},[60,61,62,65],"li",{},[17,63,64],{},"数据留在本机","：合同、病历、内部备忘录、财务报告和研究论文都不必上传。",[60,67,68,71],{},[17,69,70],{},"模型由你选择","：可以用 3B 小模型快速出初稿，也可以用更大的模型改善技术内容质量；更换模型时通常无需重新配置 Doco Translate。",[60,73,74,77],{},[17,75,76],{},"无需 API Key 和订阅","：本地服务器可以免费运行，不涉及 Token 费用。",[60,79,80,83],{},[17,81,82],{},"可视化管理服务","：你能看到当前加载的模型和服务器状态，也能先用聊天功能测试模型。",[10,85,86],{},[87,88],"img",{"alt":89,"src":90},"LM Studio 运行本地模型并为 Doco Translate 提供 API","/images/blog/translate-pdfs-with-lmstudio/1.jpg",[10,92,93],{},[94,95,96],"em",{},"LM Studio 通过可视化界面运行本地模型，并将其作为本地 API 服务。",[39,98,100],{"id":99},"doco-translate-如何使用本地模型","Doco Translate 如何使用本地模型",[10,102,103],{},"LM Studio 负责加载模型、执行推理并提供 API，但它不了解 PDF 页面结构，也不会处理扫描件 OCR 或让译文与原排版对应。",[10,105,106],{},"Doco Translate 正是为这部分工作设计的。它会解析 PDF，在保留文档结构的前提下拆分可翻译内容，把这些内容发送给 LM Studio，再将结果组合为可阅读的双语文档。你可以逐段检查、编辑并导出最终版本。",[10,108,109],{},"两款工具各自处理擅长的部分：LM Studio 运行语言模型，Doco Translate 管理文档工作流。",[39,111,112],{"id":112},"开始前需要准备什么",[114,115,116,124,132],"ol",{},[60,117,118,123],{},[17,119,120],{},[20,121,33],{"href":31,"rel":122},[24],"：可从 Mac App Store 免费下载。",[60,125,126,131],{},[17,127,128],{},[20,129,25],{"href":22,"rel":130},[24],"：从官方网站下载并安装 macOS 版本。",[60,133,134,137],{},[17,135,136],{},"一个语言模型","：直接通过 LM Studio 内置模型浏览器下载，无需单独处理模型文件。",[139,140,142],"h3",{"id":141},"在-lm-studio-中选择模型","在 LM Studio 中选择模型",[10,144,145],{},"打开 LM Studio 的模型搜索，可以找到来自 Hugging Face 的大量模型。Qwen、Gemma、Llama 和 Mistral 等多语言模型都可以用于翻译任务。",[10,147,148],{},"对多数 Mac 来说，1B 到 8B 参数模型适合作为起点。拥有 16 GB 或更多内存时，通常可以较顺畅地运行 7B–8B 模型；如果只有 8 GB 内存，建议选择 3B 以下的量化模型，以免系统过慢。",[10,150,151],{},"下载完成后加载模型，并先发送一条简单消息，确认它能正常响应，再连接 Doco Translate。",[139,153,155],{"id":154},"启动本地-api-服务","启动本地 API 服务",[10,157,158,159,162,163,166],{},"进入 LM Studio 的 ",[17,160,161],{},"Developer"," 页面（旧版本可能叫 ",[17,164,165],{},"Local Server","）并启动服务。默认地址是：",[168,169,175],"pre",{"className":170,"code":172,"language":173,"meta":174},[171],"language-text","http://localhost:1234\n","text","",[176,177,172],"code",{"__ignoreMap":174},[10,179,180,181,184],{},"LM Studio 会提供 OpenAI 兼容接口。Doco Translate 使用的聊天补全地址为 ",[176,182,183],{},"http://localhost:1234/v1/chat/completions","。翻译期间需要保持服务运行。",[10,186,187],{},[87,188],{"alt":189,"src":190},"在 LM Studio 中启动本地 API 服务","/images/blog/translate-pdfs-with-lmstudio/2.jpg",[10,192,193],{},[94,194,195],{},"在 LM Studio 中启动本地 API 服务。",[39,197,199],{"id":198},"将-lm-studio-连接到-doco-translate","将 LM Studio 连接到 Doco Translate",[10,201,202],{},"LM Studio 服务启动后，切换到 Doco Translate。",[139,204,206],{"id":205},"_1-打开-lm-studio-服务设置","1. 打开 LM Studio 服务设置",[10,208,209,210,213],{},"进入 ",[17,211,212],{},"设置 → 服务 → 高级服务 → LM Studio","，在这里配置本地服务地址和翻译模型。",[139,215,217],{"id":216},"_2-确认-api-地址","2. 确认 API 地址",[10,219,220],{},"LM Studio 的默认地址为：",[168,222,224],{"className":223,"code":172,"language":173,"meta":174},[171],[176,225,172],{"__ignoreMap":174},[10,227,228],{},"Doco Translate 会在输入框下方预览完整接口地址。如果两款应用运行在同一台 Mac 上并使用默认设置，通常无需修改。",[139,230,232],{"id":231},"_3-选择模型","3. 选择模型",[10,234,235,236,239,240,243],{},"在",[17,237,238],{},"模型","区域选择 LM Studio 当前加载的模型。如果列表中没有，请点击",[17,241,242],{},"添加模型","并填写模型标识，它必须与 LM Studio 服务面板中显示的名称一致。",[10,245,246],{},"常见错误是 Doco Translate 中填写的模型名与 LM Studio 实际加载的名称不同。如果无法找到模型，请先检查服务页面中的完整名称。",[139,248,250],{"id":249},"_4-验证连接","4. 验证连接",[10,252,253,254,257],{},"点击",[17,255,256],{},"验证服务","。成功提示代表 Doco Translate 已能访问 LM Studio 并与模型通信。",[10,259,260],{},"如果验证失败，请依次确认服务器正在运行、API 地址正确、模型名称与当前加载的模型一致。标准本地配置不需要 API Key。",[10,262,263],{},[87,264],{"alt":265,"src":266},"在 Doco Translate 设置中配置 LM Studio 翻译服务","/images/blog/translate-pdfs-with-lmstudio/3.jpg",[10,268,269],{},[94,270,271],{},"将 LM Studio 添加为 Doco Translate 的本地翻译服务。",[39,273,275],{"id":274},"分步骤翻译-pdf","分步骤翻译 PDF",[10,277,278],{},"连接验证成功后，翻译流程与其他服务基本相同。",[139,280,281],{"id":281},"选择源语言和目标语言",[10,283,284],{},"普通文档可以使用自动检测。对于扫描件、混合语言文件或特殊字体 PDF，手动指定源语言通常更稳定，也能为 OCR 提供更明确的信息。",[139,286,288],{"id":287},"选择-lm-studio-服务","选择 LM Studio 服务",[10,290,291],{},"选择刚配置的 LM Studio 服务。如果设置了多个模型，可以按任务切换：小模型适合快速翻译长文档，大模型适合更看重措辞和专业内容的任务。",[139,293,294],{"id":294},"导入并翻译",[10,296,297],{},"打开 PDF 后，Doco Translate 会解析文本块、标题、表格、图片和脚注，再把翻译请求发送给本地 LM Studio 模型。译文会放回文档视图，并尽量与原结构对齐。",[10,299,300],{},"速度取决于 Mac 硬件和模型大小。小模型在 Apple 芯片 Mac 上通常很快；更大的模型速度较慢，但处理技术或专业内容时可能更细致。",[139,302,303],{"id":303},"检查双语结果",[10,305,306],{},"本地模型能很好地处理日常文本，但法律、医疗、产品名称和缩写等专业词汇仍可能出错。Doco Translate 会并排显示原文和译文，也支持点击任意段落直接修改。",[10,308,309],{},"请重点检查数字、日期、单位、专有名词和表头，这些小错误往往会影响文档后续使用。",[10,311,312],{},[87,313],{"alt":314,"src":315},"在 Doco Translate 中使用本地 LM Studio 模型翻译 PDF","/images/blog/translate-pdfs-with-lmstudio/4.jpg",[10,317,318],{},[94,319,320],{},"使用本地 LM Studio 模型翻译 PDF。",[139,322,323],{"id":323},"导出",[10,325,326],{},"确认翻译后即可导出。导出的文件会保留原始 PDF 的主要版式结构，得到的是可继续使用的译文文档，而不是一整段无格式文本。",[39,328,329],{"id":329},"实用建议",[57,331,332,338,344,350,356],{},[60,333,334,337],{},[17,335,336],{},"先从少量页面开始","：翻译长文档前先测试几页，确认速度和质量符合预期。",[60,339,340,343],{},[17,341,342],{},"翻译时保持服务器页面可见","：这样能看到模型是否正在处理请求，也容易发现服务中断。",[60,345,346,349],{},[17,347,348],{},"让模型大小匹配硬件","：如果频繁使用交换内存或设备明显变慢，请改用更小或量化程度更高的模型。",[60,351,352,355],{},[17,353,354],{},"使用高质量扫描件","：模糊文字、水印和低分辨率会先影响 OCR，再影响翻译。",[60,357,358,361],{},[17,359,360],{},"始终保留原件","：对于合同、投稿和出版物，应把翻译结果视为工作副本。",[39,363,364],{"id":364},"什么情况下适合本地翻译",[10,366,367],{},"当隐私很重要、翻译任务经常发生，或内容不应该离开内部网络时，Doco Translate 与 LM Studio 的本地方案尤其合适。",[10,369,370],{},"它并非适合所有情况。如果文档不敏感、只翻译一次，而且你追求尽可能高的质量，使用更大云端模型的服务可能更省事。如果 Mac 内存有限，大模型处理长篇文档也可能非常缓慢。",[10,372,373],{},"它最适合需要反复处理敏感文档，并希望在自己的 Mac 上建立稳定、私密且无 API 费用工作流的用户。",[39,375,376],{"id":376},"常见问题",[139,378,380],{"id":379},"doco-translate-支持-lm-studio-的本地服务吗","Doco Translate 支持 LM Studio 的本地服务吗？",[10,382,383,384,386,387,390,391,393],{},"支持。在 ",[17,385,212],{}," 中填写本地服务地址（默认 ",[176,388,389],{},"http://localhost:1234","），选择当前加载的模型并点击",[17,392,256],{},"。",[139,395,397],{"id":396},"lm-studio-需要-api-key-吗","LM Studio 需要 API Key 吗？",[10,399,400],{},"标准的本地服务不需要。只有在你自行配置了身份验证时才需要填写。",[139,402,404],{"id":403},"pdf-翻译后会保留格式吗","PDF 翻译后会保留格式吗？",[10,406,407],{},"Doco Translate 会尽量保留标题、表格、图片、多栏文本和阅读顺序。由于译文长度可能变化，任何工具都无法保证所有文件像素级一致，但结果比复制到通用翻译器后手动排版更实用。",[139,409,411],{"id":410},"扫描版-pdf-也可以翻译吗","扫描版 PDF 也可以翻译吗？",[10,413,414],{},"可以。Doco Translate 内置 OCR，可从扫描件和图片型 PDF 中提取文字。清晰的扫描质量和正确的源语言设置有助于提高准确率。",[139,416,418],{"id":417},"验证服务失败怎么办","“验证服务”失败怎么办？",[10,420,421],{},"检查 LM Studio 服务是否正在运行、Doco Translate 中的 API 地址是否正确，以及模型名称是否与当前加载的模型完全一致，然后再次验证。",[39,423,424],{"id":424},"总结",[10,426,427,428,433],{},"LM Studio 与 ",[17,429,430],{},[20,431,33],{"href":31,"rel":432},[24]," 可以组成一套完全本地的 Mac PDF 翻译流程。LM Studio 通过桌面界面运行语言模型，Doco Translate 则负责文档解析、排版保留、OCR、双语检查和导出。对于不适合上传云端的 PDF，花十分钟完成这套配置通常非常值得。",{"title":174,"searchDepth":435,"depth":435,"links":436},2,[437,438,439,444,450,457,458,459,466],{"id":41,"depth":435,"text":42},{"id":99,"depth":435,"text":100},{"id":112,"depth":435,"text":112,"children":440},[441,443],{"id":141,"depth":442,"text":142},3,{"id":154,"depth":442,"text":155},{"id":198,"depth":435,"text":199,"children":445},[446,447,448,449],{"id":205,"depth":442,"text":206},{"id":216,"depth":442,"text":217},{"id":231,"depth":442,"text":232},{"id":249,"depth":442,"text":250},{"id":274,"depth":435,"text":275,"children":451},[452,453,454,455,456],{"id":281,"depth":442,"text":281},{"id":287,"depth":442,"text":288},{"id":294,"depth":442,"text":294},{"id":303,"depth":442,"text":303},{"id":323,"depth":442,"text":323},{"id":329,"depth":435,"text":329},{"id":364,"depth":435,"text":364},{"id":376,"depth":435,"text":376,"children":460},[461,462,463,464,465],{"id":379,"depth":442,"text":380},{"id":396,"depth":442,"text":397},{"id":403,"depth":442,"text":404},{"id":410,"depth":442,"text":411},{"id":417,"depth":442,"text":418},{"id":424,"depth":435,"text":424},"使用教程","/images/blog/translate-pdfs-with-lmstudio/cover.jpg","2026-05-17","在 Mac 上把 LM Studio 配置为 Doco Translate 的本地翻译服务，私密翻译 PDF、保留原始排版，并完全掌控所使用的语言模型。","md",{},true,"/zh/blog/translate-pdfs-with-lmstudio",{"title":5,"description":470},"translate-pdfs-with-lmstudio","zh/blog/translate-pdfs-with-lmstudio","Pqhahq7778hpGO9i-f7DfJtg_aOB43LrGeWjXLZFs-M",1787207634964]