LibreOffice 与 Ollama:LocalWriter,将 AI 引入 Writer

LibreOffice 没有内置 AI 助手,但第三方扩展可以将 Writer 连接到由您本机上的 Ollama 提供服务的模型。本指南以 LocalWriter 为例,这是一个发布在 GitHub 上的开源项目:介绍在哪里获取它、如何将其明确指向 http://localhost:11434、它会获得哪些权限,以及可能出现哪些故障。LibreOffice + Ollama 的组合本身并不能保证隐私:一切取决于您在扩展中填写的服务器地址。
#为什么要将 LibreOffice 与 Ollama 连接起来
Writer 是许多个人、协会和行政机构使用的写作工具。商业办公套件如今都提供了写作助手,但它们会将文本发送到在线服务。如果在同一台电脑上安装了 Ollama,开放权重模型就可以改写、续写或修改段落,而文档不会离开本机——前提是整条链路从头到尾都配置正确。
原理很简单。Ollama 在后台运行,并在 11434 端口响应 HTTP 请求。LibreOffice 扩展获取选中的文本,连同一条指令发送到该地址,然后把响应插入文档。扩展本身不包含模型:它只是 Writer 与服务器之间的中介。正因如此,服务器地址决定了一切,包括隐私性。
这套组合适合简短且可核查的任务:改写一段文字、为草稿续写、调整语气、总结某一节。它不能替代人工校对。本地模型和在线模型一样会出错,而且如果模型较小,出错往往更多。
#LocalWriter:这个扩展能做什么
借助我们的经验和引导式路径,打造你的本地助手,在日常中使用你的 AI。
- 在线空间,终身可用
- PDF + 文件
- 30 天内退款
LocalWriter 是一款由第三方(GitHub 账号 balisujohn)开发的 LibreOffice 扩展,与 The Document Foundation 及 Ollama 团队均无关联。在 2026 年 10 月 30 日查阅时,其 README 描述了在 Writer 中的两种主要用法:续写所选文本,以及根据您输入的指令修改所选内容。该扩展连接与 OpenAI API 兼容的服务器;Ollama 提供了这样的 API,其他本地服务器也同样提供。
- 性质
- LibreOffice 扩展文件(.oxt),在 GitHub 仓库的 Releases 页面发布。
- 所述功能
- 续写选中内容;根据指令修改选中内容。请在 README 中核实菜单的确切名称、可能的快捷键,以及此后新增的功能(例如针对 Calc 的功能)。
- 目标服务器
- 任何提供 OpenAI 风格 API 的服务器均可:Ollama,以及其他本地推理引擎或在线服务。并不要求必须是本地服务器:地址由您自行填写。
- 状态
- 这是社区项目。更新频率、维护以及与 LibreOffice 新版本的兼容性都没有任何人保证。请查看最后一次提交的日期和未关闭的 issue。
其他扩展或宏也有相同的目标。本指南的原则(明确指定地址、检查权限、核实兼容性)适用于所有这些工具:请不要把 LocalWriter 视为推荐,而应将其视为一个有文档记录的示例。
#先决条件
- LibreOffice
- 从 libreoffice.org 或您的发行版安装的较新版本。请记下确切的版本号(帮助 > 关于 LibreOffice):稍后需要用它来核对扩展声明的兼容性。
- LibreOffice 中的 Python
- 用 Python 编写的扩展需要 LibreOffice 的 Python 支持。官方的 Windows 和 macOS 安装程序已包含该支持;在某些 Linux 发行版上,它是一个单独的软件包(见第 2 步)。
- Ollama
- 已安装并启动,监听 http://localhost:11434。如果尚未完成,请先按照 Ollama 安装指南操作(链接见页面末尾)。
- 与您的内存相匹配的模型
- Q4_K_M 下的参考值:3B 模型约占 2 GB 显存,7B 约占 5 GB,14B 约占 9 GB。像 RTX 3060 这样的 12 GB 显卡可以轻松运行 7B 至 9B 的模型。
- 一份测试文档
- 一个不含敏感数据的文件用于初次试用,并在安装扩展前备份您的重要文档。
#第 1 步:准备 Ollama 并检查 API
在动 LibreOffice 之前,请先确认 Ollama 的 OpenAI 兼容 API 能正常响应。如果这一步失败,扩展也会失败,而您也就能知道问题并不出在扩展上。请先下载一个大小适中的模型。下面两个标签于 2026 年 10 月 28 日出现在 Ollama 模型库中;如果愿意,也可以换成您已安装的模型。
接下来,按扩展的方式调用 API。第一条命令列出 API 可见的模型,第二条命令发送一个真实的对话请求。如果返回的 JSON 中包含 choices 字段,就说明服务器已准备就绪。
还要检查 Ollama 监听的是哪个地址。默认情况下,它只接受来自本机的连接(127.0.0.1),对于在同一台电脑上的 Writer 中使用而言,这正是正确的设置。如果有人设置了 OLLAMA_HOST=0.0.0.0,服务器就可以从局域网访问:此处并不需要这样做。
#第 2 步:在 LibreOffice 中安装扩展
- 01下载前先阅读代码仓库打开 https://github.com/balisujohn/localwriter。完整阅读 README,然后查看 Releases 页面:最新版本号、日期、版本说明以及提到的 LibreOffice 版本。也请看看未关闭的 issue:与您所用版本的已知不兼容问题,往往在写入文档之前就会先出现在那里。
- 02从 Releases 下载 .oxt 文件请使用已发布版本所附带的 .oxt 文件,而不是在其他网站上找到的副本。如果项目发布了 SHA-256 校验值,请与下载的文件进行比对;否则,只需记下版本号和下载日期。
- 03检查内容(可选,但很有用).oxt 文件就是一个 zip 压缩包。列出其内容可以看到 LibreOffice 将要执行的 Python 脚本,从而了解该扩展能做什么(参见“权限”一节)。
- 04通过扩展管理器安装在 LibreOffice 中:工具 > 扩展管理器 > 添加,然后选择 .oxt 文件。LibreOffice 可能会就扩展来源显示警告,或询问是仅为您本人安装还是为所有用户安装:在共用电脑上,请选择“仅为我安装”。
- 05完全重启 LibreOffice关闭所有 LibreOffice 窗口,包括通知区域中可能存在的快速启动器,然后重新打开 Writer。此时应出现一个新菜单或新的菜单项;其确切位置见 README。
在 Windows 上,unopkg 位于 LibreOffice 的 program 文件夹中(例如 C:\Program Files\LibreOffice\program)。在 Fedora 上,Python 支持由 libreoffice-pyuno 软件包提供。Flatpak 和 Snap 版本的 LibreOffice 自带运行环境:如遇问题,请与发行版软件包版本或 libreoffice.org 提供的版本进行对比。
#第 3 步:明确配置为指向本地 Ollama
该扩展会打开一个设置窗口(其位置见 README)。这是本指南中最重要的一步:每个字段都决定了您的文本发送到哪里,以及模型如何处理它。不要保留任何您没有读过的默认值。
- 服务器地址
- 填写 http://localhost:11434 或 http://127.0.0.1:11434。根据扩展构造请求的方式,它要么需要这个根地址,要么需要带 /v1 前缀的地址:请参照 README 中的示例,如果出现 404 错误,再尝试另一种写法。
- 模型名称
- 必须与 ollama list 显示的名称完全一致,包括标签(是 qwen3.5:9b,而不是 qwen3.5)。名称不准确会导致 Ollama 端报出“model not found”错误。
- API 密钥
- 本地 Ollama 不需要密钥。如果该字段为必填项,通常随便填一个值即可;本地使用时,切勿在此粘贴真实的在线服务密钥。
- 系统提示词
- 如果扩展允许修改指令,请用法语简短地编写:« Tu modifies uniquement le passage fourni. Réponds en français, sans commentaire ni guillemets. »(只修改所提供的段落。用法语回答,不加评论,不加引号。)这样可以减少插入文档中的啰嗦回复。
- 最大长度
- token 上限设得太低,回复会在句子中间被截断;设得太高,则会让模型输出过多内容。建议先从较小的值开始,再逐步调整。
第一次试用时,打开测试文档,选中一句话,然后用一条简单的指令启动修改功能,例如“让这段文字更正式”。生成过程中,在终端运行 ollama ps 命令可以看到已加载的模型:这直接证明请求确实到达了您本地的 Ollama,而不是别处。第一次调用可能较慢,因为需要时间将模型加载到内存中。
#权限与隐私:扩展能做什么
LibreOffice 扩展不像浏览器扩展那样处于隔离环境中。它的 Python 脚本以您用户账户的权限运行:可以读写您的文件、建立网络连接,并读取当前打开文档的内容。安装时不会有任何权限窗口列明这些权限。因此,安装一个 .oxt 文件就意味着信任其作者以及您下载的这个版本。
- 代码可供审阅
- LocalWriter 是开源的:第 2 步中列出的脚本均可审阅。请查找硬编码的网络地址和 HTTP 发送函数;一个可信的扩展只会调用您所输入的地址。
- 更新同样重要
- 新版本可能会改变行为。更新前请阅读发行说明,实际使用时避免使用未正式发布的开发版本。
- 地址决定隐私
- 使用 http://localhost:11434 时,选中的文本留在本机。使用另一台电脑的地址时,文本会经过您的网络。使用兼容 OpenAI 的在线服务地址时,文本会发送给该服务商,并受其条款约束。
- Ollama 的托管模型
- 较新版本的 Ollama 还提供在 ollama.com 服务器上运行的模型,需登录账户才能使用。如果在“模型”字段中选择了这类模型,即使地址仍为 localhost,文本也会被发送到线上。请在模型页面上确认它是本地模型,并确认 ollama ps 显示它已加载到您的机器上。
#需要了解的兼容性限制
多个层面必须相互匹配:LibreOffice 的版本、其 Python 解释器、扩展以及 Ollama 的版本。其中任何一个都不受其他项目控制,而且本指南未测试过任何组合。以下是最可能出现问题的地方,请对照仓库的 README 和工单进行核实。
- LibreOffice 版本
- 在某个分支上测试通过的扩展,如果内部 API 发生变化,可能会在下一个分支上失效。请将您的版本与代码仓库中提到的版本进行对比;如果没有相关说明,则应视为兼容性未知。
- Python 是否自带
- LibreOffice 在 Windows 和 macOS 上自带 Python,而在 Linux 上通常使用系统的 Python。如果扩展导入了不存在的库,加载时就会失败。
- API 格式
- 该扩展使用 OpenAI 的接口格式。Ollama 在 /v1 下实现了该接口,但不一定支持每个选项。不受支持的选项可能会被忽略,且不给出任何提示。
- 复杂文档
- 涉及表格、脚注、域或修订跟踪的选区可能会丢失格式:模型接收的是纯文本,返回的也是纯文本。
- 长度
- 选中的文本和指令必须能放进 Ollama 端配置的上下文窗口。超出部分,文本开头可能会被截断且没有任何提示。请逐段处理。
- Calc、Impress
- 不要假定为 Writer 设计的功能在其他地方也能用:只有 README 中提到的应用程序才适用。
- 界面卡死
- 视具体实现而定,在模型生成期间 Writer 可能会失去响应。如果模型过大、显存放不下,等待时间会明显延长:请优先选择能完全装入显存的模型。
#LibreOffice 搭配 Ollama 的故障排除
- 01安装后没有出现菜单完全重启 LibreOffice,包括快速启动器。在 工具 > 扩展管理器 中确认该扩展已列出并已启用。在 Linux 上,请安装 Python 支持(libreoffice-script-provider-python 或 libreoffice-pyuno),然后重试。
- 02“Connection refused”或超时Ollama 未启动,或监听在其他地址上。重新运行第 1 步中的 curl 命令:如果失败,问题出在 Ollama 端。如果成功,请逐字符核对扩展中填写的地址(是 http 而不是 https,端口 11434)。
- 03错误 404路径不匹配:扩展可能已经自动添加了 /v1,或者恰恰相反,要求地址中包含它。请尝试第 3 步中给出的另一种写法。
- 04« model not found »照抄 ollama list 给出的准确名称,包括其标签。如果模型尚未安装,请运行 ollama pull。
- 05回复为英文,或被评论、引号包裹加强系统提示词(要求用法语回答、仅输出文本),或更换模型。小模型对这类指令的遵循效果较差。
- 06Writer 非常缓慢或卡死运行 ollama ps:如果 PROCESSOR 列显示有一部分使用 CPU,说明模型超出了显存容量。请换用更小的模型或更轻量的量化版本,并关闭其他已加载的模型。
#深入了解
本指南聚焦于 Writer 与 Ollama 之间的桥接。服务器的安装、在网络上共享以及法律框架另有专门的指南。
- 安装 Ollama
- Windows、macOS 和 Linux 上的分步安装,第 1 步的前提条件:https://quelllm.fr/guide/installer-ollama
- 在局域网中共享 Ollama
- 如果 Writer 与服务器不在同一台机器上运行:OLLAMA_HOST 的设置及访问注意事项:https://quelllm.fr/guide/ollama-serveur-reseau-local-partage
- 本地 LLM 与 GDPR
- 对于企业中的个人数据,本地处理能改变什么、不能改变什么:https://quelllm.fr/guide/llm-local-donnees-privees-rgpd
- 来源
- LocalWriter 仓库:https://github.com/balisujohn/localwriter(2026/10/30 查阅,2026/11/17 未再次查阅);Ollama 的 OpenAI 兼容 API 文档:https://docs.ollama.com(2026/11/17 未再次查阅)。安装前请核实:版本和功能会不断变化。
有反馈、发现了错误,或想补充说明?请告诉我们,让这份指南对每个人都更有帮助。