LibreOffice Writer Python宏实现自动保存遇UI阻塞与线程问题求助

需求说明 #

需要实现一个Python宏，为LibreOffice Writer提供自动保存功能：

• 定期将文档的修改保存到磁盘
• 保存后标记文档为未修改，让桌面环境感知到文档状态变化
• 替代LibreOffice自带的自动恢复/备份功能（无法满足上述需求）

现有方案的问题 #

方案1：阻塞式循环 #

首次尝试的代码通过while True+sleep实现定时，但会完全阻塞UI线程，导致Writer无法响应任何操作：

def autosave():
    from time import sleep
    doc = XSCRIPTCONTEXT.getDocument()
    args=()
    while True :
        if doc.isModified() :
            doc.storeToURL(doc.getURL(),args)
            doc.setModified(False)
        sleep(60)

方案2：后台线程 #

改用Python线程后，虽然不会阻塞UI，但存在两个核心问题：

1. LibreOffice的UAPI（UNO API）并非线程安全，子线程直接调用文档操作API可能导致程序崩溃或异常
2. 线程可能因LibreOffice宏环境的生命周期限制，无法持续运行（比如宏上下文被回收）

代码示例：

def autosave_timer() :
    while True :
        autosave()
        sleep(60)

def autosave():
    from time import sleep
    doc = XSCRIPTCONTEXT.getDocument()
    args=()
    if doc.isModified() :
            doc.storeToURL(doc.getURL(),args)
            doc.setModified(False)

def run_autosave() :
    thread=Thread(target=autosave_timer)        
    thread.start()

推荐实现方式：使用LibreOffice自带定时器服务 #

利用LibreOffice内置的com.sun.star.util.Timer服务，适配其单线程UI模型，既能定时执行保存，又不会阻塞UI，且生命周期稳定。

完整代码实现 #

import uno
from com.sun.star.util import XTimerListener
from com.sun.star.beans import PropertyValue

# 定义定时器监听器类，处理定时触发事件
class AutosaveListener(XTimerListener):
    def __init__(self, doc):
        self.doc = doc

    def timerTriggered(self, event):
        # 仅当文档被修改时执行保存
        if self.doc.isModified():
            try:
                # 构造保存参数（强制覆盖，避免弹出确认框）
                args = (PropertyValue(Name="Overwrite", Value=True),)
                self.doc.storeToURL(self.doc.getURL(), args)
                self.doc.setModified(False)
            except Exception as e:
                print(f"自动保存失败: {str(e)}")

    def disposing(self, event):
        # 定时器销毁时清理文档引用
        self.doc = None

def run_autosave():
    # 获取当前活动文档
    doc = XSCRIPTCONTEXT.getDocument()
    # 获取LibreOffice组件上下文与定时器服务
    ctx = XSCRIPTCONTEXT.getComponentContext()
    timer_factory = ctx.getServiceManager().createInstanceWithContext(
        "com.sun.star.util.Timer", ctx
    )
    # 设置定时参数：间隔60秒（单位毫秒），持续重复触发
    timer_factory.setTimeout(60000)
    timer_factory.setRepeat(True)
    # 创建并注册监听器
    listener = AutosaveListener(doc)
    timer_factory.addTimerListener(listener)
    # 启动定时器
    timer_factory.start()
    # 全局保存监听器引用，防止被Python垃圾回收机制回收
    globals()["autosave_listener"] = listener

关键说明 #

1. 官方适配的定时机制：com.sun.star.util.Timer是LibreOffice官方提供的定时服务，完全兼容其UI线程模型，不存在线程安全风险
2. 生命周期管理：通过globals()保存监听器引用，避免因垃圾回收导致监听器失效，确保定时器持续运行
3. 异常防护：添加异常捕获，避免保存失败（比如文档被外部锁定）导致宏崩溃
4. 无干扰保存：通过Overwrite参数强制覆盖，避免弹出保存确认对话框影响操作

内容的提问来源于stack exchange，提问作者Stephen Boston