中级 12 分钟每日计划

LibreOffice 与 Ollama:LocalWriter,将 AI 引入 Writer

木桌上,一台笔记本电脑旁摊放着几张纸。

LibreOffice 没有内置 AI 助手,但第三方扩展可以将 Writer 连接到由您本机上的 Ollama 提供服务的模型。本指南以 LocalWriter 为例,这是一个发布在 GitHub 上的开源项目:介绍在哪里获取它、如何将其明确指向 http://localhost:11434、它会获得哪些权限,以及可能出现哪些故障。LibreOffice + Ollama 的组合本身并不能保证隐私:一切取决于您在扩展中填写的服务器地址。

作者: Mohamed Meguedmi·更新于 2026-11-17·已在 Windows、macOS 和 Linux 上测试
!
本指南验证了什么,又没有验证什么
LocalWriter 的 GitHub 仓库(github.com/balisujohn/localwriter)于 2026 年 10 月 30 日在准备本主题时查阅过;在撰写当天,即 2026 年 11 月 17 日,未能再次查阅。QuelLLM 既未安装也未测试该扩展:本指南不包含任何截图、任何速度测量,也不包含任何质量评价。菜单和设置字段的确切名称、当前版本及许可证,请在安装任何东西之前,查阅仓库的 README 和 Releases 页面。

#为什么要将 LibreOffice 与 Ollama 连接起来

Writer 是许多个人、协会和行政机构使用的写作工具。商业办公套件如今都提供了写作助手,但它们会将文本发送到在线服务。如果在同一台电脑上安装了 Ollama,开放权重模型就可以改写、续写或修改段落,而文档不会离开本机——前提是整条链路从头到尾都配置正确。

原理很简单。Ollama 在后台运行,并在 11434 端口响应 HTTP 请求。LibreOffice 扩展获取选中的文本,连同一条指令发送到该地址,然后把响应插入文档。扩展本身不包含模型:它只是 Writer 与服务器之间的中介。正因如此,服务器地址决定了一切,包括隐私性。

这套组合适合简短且可核查的任务:改写一段文字、为草稿续写、调整语气、总结某一节。它不能替代人工校对。本地模型和在线模型一样会出错,而且如果模型较小,出错往往更多。

#LocalWriter:这个扩展能做什么

打造专属 AI 助手的完整套件。

借助我们的经验和引导式路径,打造你的本地助手,在日常中使用你的 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 模型库中;如果愿意,也可以换成您已安装的模型。

终端
# Un modèle généraliste d'environ 9B
ollama pull qwen3.5:9b

# Vérifier les modèles installés et leur nom exact
ollama list

接下来,按扩展的方式调用 API。第一条命令列出 API 可见的模型,第二条命令发送一个真实的对话请求。如果返回的 JSON 中包含 choices 字段,就说明服务器已准备就绪。

终端(macOS、Linux)
curl http://localhost:11434/v1/models

curl http://localhost:11434/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{"model": "qwen3.5:9b", "messages": [{"role": "user", "content": "Reformule : la réunion est décalée à jeudi."}]}'

还要检查 Ollama 监听的是哪个地址。默认情况下,它只接受来自本机的连接(127.0.0.1),对于在同一台电脑上的 Writer 中使用而言,这正是正确的设置。如果有人设置了 OLLAMA_HOST=0.0.0.0,服务器就可以从局域网访问:此处并不需要这样做。

终端
# Linux : adresse d'écoute du port 11434
ss -ltnp | grep 11434

# macOS
lsof -nP -iTCP:11434 -sTCP:LISTEN
PowerShell(Windows)
netstat -ano | findstr 11434

#第 2 步:在 LibreOffice 中安装扩展

  1. 01
    下载前先阅读代码仓库
    打开 https://github.com/balisujohn/localwriter。完整阅读 README,然后查看 Releases 页面:最新版本号、日期、版本说明以及提到的 LibreOffice 版本。也请看看未关闭的 issue:与您所用版本的已知不兼容问题,往往在写入文档之前就会先出现在那里。
  2. 02
    从 Releases 下载 .oxt 文件
    请使用已发布版本所附带的 .oxt 文件,而不是在其他网站上找到的副本。如果项目发布了 SHA-256 校验值,请与下载的文件进行比对;否则,只需记下版本号和下载日期。
  3. 03
    检查内容(可选,但很有用)
    .oxt 文件就是一个 zip 压缩包。列出其内容可以看到 LibreOffice 将要执行的 Python 脚本,从而了解该扩展能做什么(参见“权限”一节)。
  4. 04
    通过扩展管理器安装
    在 LibreOffice 中:工具 > 扩展管理器 > 添加,然后选择 .oxt 文件。LibreOffice 可能会就扩展来源显示警告,或询问是仅为您本人安装还是为所有用户安装:在共用电脑上,请选择“仅为我安装”。
  5. 05
    完全重启 LibreOffice
    关闭所有 LibreOffice 窗口,包括通知区域中可能存在的快速启动器,然后重新打开 Writer。此时应出现一个新菜单或新的菜单项;其确切位置见 README。
终端
# Voir les fichiers contenus dans l'extension (nom de fichier à adapter)
unzip -l localwriter.oxt

# Alternative en ligne de commande, LibreOffice fermé
unopkg add localwriter.oxt
unopkg list

# Debian, Ubuntu : support Python de LibreOffice s'il manque
sudo apt install libreoffice-script-provider-python

在 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,而不是别处。第一次调用可能较慢,因为需要时间将模型加载到内存中。

终端,生成过程中
ollama ps
→
随时准备撤销
扩展插入的文本会进入 Writer 的编辑历史:Ctrl+Z(Mac 上为 Cmd+Z)应能像撤销普通输入一样撤销它。请先在测试文档上确认这一点,再处理真实文件;并启用自动保存或修订跟踪(编辑 > 跟踪更改),以便记录模型所做的修改。

#权限与隐私:扩展能做什么

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 的故障排除

  1. 01
    安装后没有出现菜单
    完全重启 LibreOffice,包括快速启动器。在 工具 > 扩展管理器 中确认该扩展已列出并已启用。在 Linux 上,请安装 Python 支持(libreoffice-script-provider-python 或 libreoffice-pyuno),然后重试。
  2. 02
    “Connection refused”或超时
    Ollama 未启动,或监听在其他地址上。重新运行第 1 步中的 curl 命令:如果失败,问题出在 Ollama 端。如果成功,请逐字符核对扩展中填写的地址(是 http 而不是 https,端口 11434)。
  3. 03
    错误 404
    路径不匹配:扩展可能已经自动添加了 /v1,或者恰恰相反,要求地址中包含它。请尝试第 3 步中给出的另一种写法。
  4. 04
    « model not found »
    照抄 ollama list 给出的准确名称,包括其标签。如果模型尚未安装,请运行 ollama pull。
  5. 05
    回复为英文,或被评论、引号包裹
    加强系统提示词(要求用法语回答、仅输出文本),或更换模型。小模型对这类指令的遵循效果较差。
  6. 06
    Writer 非常缓慢或卡死
    运行 ollama ps:如果 PROCESSOR 列显示有一部分使用 CPU,说明模型超出了显存容量。请换用更小的模型或更轻量的量化版本,并关闭其他已加载的模型。
i
彻底卸载
工具 > 扩展管理器 > 选中该扩展 > 删除,然后重启 LibreOffice。如使用命令行,需在 LibreOffice 关闭的状态下操作:unopkg list 会显示扩展的标识符,将其传给 unopkg remove 即可。已下载的模型仍保留在 Ollama 中:如果不再需要,请用 ollama rm si 将其删除。

#深入了解

本指南聚焦于 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 未再次查阅)。安装前请核实:版本和功能会不断变化。
这份指南对您有帮助吗?

有反馈、发现了错误,或想补充说明?请告诉我们,让这份指南对每个人都更有帮助。