ODT 文件管理器

基于 odfdo 实现的本地 ODT 文档创建与编辑功能。

依赖库：odfdo v3.20+ — 活跃维护中，仅依赖单个包（lxml），完整支持 ODF 格式。

必要配置

pip install odfdo

能力边界

该技能为纯本地运行——无网络访问能力，且对 NextCloud 完全无感知。

如需配合 NextCloud 工作流，请搭配使用 nextcloud-aio-oc：

脚本路径位于：~/.openclaw/skills/odt-filemgr-oc/scripts/

工作流示例

编辑现有 ODT（NextCloud 场景）

NC=~/.openclaw/skills/nextcloud-aio-oc/scripts
ODT=~/.openclaw/skills/odt-filemgr-oc/scripts

# 1. 下载
python3 $NC/files_binary.py download "/Documents/MyDoc.odt" /tmp/MyDoc.odt

# 2. 检查结构
python3 $ODT/odt_tool.py inspect /tmp/MyDoc.odt

# 3. 编辑内容
python3 $ODT/odt_tool.py append /tmp/MyDoc.odt --text "New Section" --heading 2
python3 $ODT/odt_tool.py append /tmp/MyDoc.odt --text "Section content here."

# 4. 上传回 NextCloud
python3 $NC/files_binary.py upload /tmp/MyDoc.odt "/Documents/MyDoc.odt"

新建 ODT 并推送至 NextCloud

# 1. 本地创建
python3 $ODT/odt_tool.py create /tmp/NewDoc.odt --title "Q1 Report"

# 2. 添加内容
python3 $ODT/odt_tool.py append /tmp/NewDoc.odt --text "Summary" --heading 2
python3 $ODT/odt_tool.py append /tmp/NewDoc.odt --text "Results were positive across all metrics."

# 3. 推送至 NextCloud
python3 $NC/files_binary.py upload /tmp/NewDoc.odt "/Documents/Q1 Report.odt"

本地编辑 ODT（不涉及 NextCloud）

python3 $ODT/odt_tool.py inspect   myfile.odt
python3 $ODT/odt_tool.py to-text   myfile.odt
python3 $ODT/odt_tool.py append    myfile.odt --text "Added paragraph."
python3 $ODT/odt_tool.py replace   myfile.odt --find "draft" --sub "final"
python3 $ODT/odt_tool.py set-meta  myfile.odt --title "Final Report"

odt_tool.py 命令说明

自定义 Python 编辑

如需进行表格编辑、复杂样式调整或多步操作，可直接嵌入 Python 脚本：

from odfdo import Document, Header, Paragraph

doc = Document("/tmp/file.odt")
body = doc.body

# 按顺序读取全部内容
for child in body.children:
    if isinstance(child, Header):
        print(f"H{child.level}: {child.inner_text}")
    elif isinstance(child, Paragraph) and child.inner_text.strip():
        print(f"[{child.style}]: {child.inner_text}")

# 添加内容
body.append(Header(2, "New Section"))
body.append(Paragraph("Content here."))

# 表格编辑
table = body.get_table_by_name("MyTable")
table.set_value(0, 0, "Updated cell")

doc.save("/tmp/file.odt", pretty=True)

关于 odfdo 全量 API（表格、列表、文本跨度、样式、元数据等），请参阅 REFERENCE.md。

关键规则

1. 编辑前务必先 inspect：对未查看过的文件，必须先执行 inspect 确认结构。
2. 临时文件：工作过程中请使用 /tmp/ 目录存放中间文件；上传完成后及时清理。
3. 样式处理：对于含颜色、间距、边框等复杂样式的文档，建议通过 merge-styles 加载已有模板，而非从零生成样式。set-font 和 set-outline 可安全应用于任意文档，无需依赖模板。

故障排查