SuperAPI AI 工具集

libreoffice-writer

办公与效率

查看项目

更新于 10-15 21:09

技能介绍

用途:通过 UNO 后端操作 LibreOffice Writer(.odt)文档,覆盖创建、编辑、格式化、导出与内容提取。所有路径必须为绝对路径;内置模块位于技能目录的 scripts/ 下,需设置 PYTHONPATH=<skill_base_dir>/scripts。遇到安装或运行问题可查阅 references/troubleshooting.md。

主要能力:非会话工具提供 create_document(path, source=None)、export_document(path, output_path, export_format)(支持 pdf、docx、md)和 snapshot_page(doc_path, output_path, page=1, dpi=150)。会话 API 以 WriterSession(path) 上下文管理器为主,支持 read_text、insert_text、replace_text、delete_text、format_text、insert_table、update_table、delete_table、insert_image、update_image、delete_image、insert_list、replace_list、delete_list、set_metadata、get_metadata、patch、export、reset、close。

使用方式:用 WriterTarget 定义结构化目标,kind 可为 text、insertion、table、image、list,配合 text、after、before、occurrence、name、index 字段定位;重复文本需指定 occurrence,否则要求唯一匹配。格式化使用 TextFormatting,可组合字符与段落属性,align 作用于整个段落。列表使用 ListItem,level 从 0 开始且不能跳级。元数据支持 title、author、subject、keywords、description。补丁 DSL 支持 insert_text、replace_text、delete_text、format_text、insert_table、update_table、delete_table、insert_image、update_image、delete_image、insert_list、replace_list、delete_list,模式有 atomic(失败即停止并回滚)和 best_effort(保留已成功操作)。

适用场景:批量或程序化编辑报告、生成结构化文档、导出 PDF/DOCX/MD、截图校验排版、更新表格与列表、设置文档元数据。

限制:UNO 接口要求绝对路径;锚点过短易产生歧义;align 会作用于整段;items 与 data 必须是合法 JSON;快照需自行清理;close 后不能再调用 export 等方法;Markdown 导入导出及 start/end 段落对齐需 LibreOffice 26.2+。