cli-anything-libreoffice 是做什么的？
一个状态化的命令行界面，用于文档编辑，生成真正的 ODF 文件（ZIP 压缩包中的 XML）。专为 AI 代理和高级用户设计，无需 GUI 或 LibreOffice 安装即可创建和操作 Writer、Calc 和 Impress 文档。
安装
该 CLI 作为 cli-anything-libreoffice 包的一部分安装：
pip install cli-anything-libreoffice
前提条件：
- Python 3.10+
- 系统必须安装 libreoffice
用法
基本命令
# 显示帮助
cli-anything-libreoffice --help
# 启动交互式 REPL 模式
cli-anything-libreoffice
# 创建新项目
cli-anything-libreoffice project new -o project.json
# 以 JSON 输出运行（供代理使用）
cli-anything-libreoffice --json project info -p project.json
REPL 模式
未指定子命令时，CLI 进入交互式 REPL 会话：
cli-anything-libreoffice
# 交互式输入命令，支持 Tab 补全和历史记录
命令组
文档
文档管理命令。
| 命令 | 描述 |
|---|---|
new | 创建新文档 |
open | 打开项目 JSON，或导入现有的 Office/ODF 文件 |
import | 导入现有的 Office/ODF 文件到项目 JSON |
import-formats | 列出支持的导入格式 |
save | 保存当前文档 |
info | 显示文档信息 |
profiles | 列出可用的页面配置文件 |
json | 打印原始项目 JSON |
Writer
Writer（文字处理器）命令。
| 命令 | 描述 |
|---|---|
add-paragraph | 在文档中添加段落 |
add-heading | 在文档中添加标题 |
add-list | 在文档中添加列表 |
add-table | 在文档中添加表格 |
add-page-break | 添加分页符 |
remove | 通过索引移除内容项 |
list | 列出所有内容项 |
set-text | 设置内容项的文本 |
Calc
Calc（电子表格）命令。
| 命令 | 描述 |
|---|---|
add-sheet | 添加新工作表 |
remove-sheet | 按索引移除工作表 |
rename-sheet | 重命名工作表 |
set-cell | 设置单元格值 |
get-cell | 获取单元格值 |
list-sheets | 列出所有工作表 |
Impress
Impress（演示文稿）命令。
| 命令 | 描述 |
|---|---|
add-slide | 在演示文稿中添加幻灯片 |
remove-slide | 按索引移除幻灯片 |
set-content | 更新幻灯片的标题和/或内容 |
list-slides | 列出所有幻灯片 |
add-element | 在幻灯片中添加元素 |
样式组
样式管理命令。
| 命令 | 描述 |
|---|---|
create | 创建新样式 |
modify | 修改现有样式 |
list | 列出所有样式 |
apply | 将样式应用于内容项（仅适用于 Writer） |
remove | 移除样式 |
导出组
导出/渲染命令。
| 命令 | 描述 |
|---|---|
presets | 列出导出预设 |
preset-info | 显示预设详情 |
render | 将文档导出到文件 |
会话
会话管理命令。
| 命令 | 描述 |
|---|---|
status | 显示会话状态 |
undo | 撤销上次操作 |
redo | 重做上次撤销的操作 |
history | 显示撤销历史 |
示例
创建新项目
创建一个新的 libreoffice 项目文件。
cli-anything-libreoffice project new -o myproject.json
# 或使用 JSON 输出以编程方式使用
cli-anything-libreoffice --json project new -o myproject.json
交互式 REPL 会话
启动一个支持撤销/重做的交互式会话。
cli-anything-libreoffice
# 交互式输入命令
# 使用 'help' 查看可用命令
# 使用 'undo' 和 'redo' 进行历史导航
导出项目
将项目导出为最终输出格式。
cli-anything-libreoffice --project myproject.json export render output.pdf --overwrite
状态管理
CLI 维护会话状态，包括：
- 撤销/重做：最多 50 级历史
- 项目持久化：将项目状态保存/加载为 JSON
- 导入现有文件：将 ODF/DOCX/XLSX/PPTX 及相关格式转换为可编辑的项目 JSON
- 会话跟踪：跟踪修改和变更
输出格式
所有命令支持双输出模式：
- 人类可读（默认）：表格、颜色、格式化文本
- 机器可读（
--json标志）：结构化 JSON，供代理使用
# 人类可读输出
cli-anything-libreoffice project info -p project.json
# 供 AI 代理使用的 JSON 输出
cli-anything-libreoffice --json project info -p project.json
供 AI 代理使用
以编程方式使用此 CLI 时：
- 始终使用
--json标志 以获取可解析的输出 - 检查返回码 - 0 表示成功，非零表示错误
- 解析 stderr 以获取错误消息（失败时）
- 对所有文件操作使用绝对路径
- 先导入现有 Office 文件到 JSON，使用
document import input.docx -o work.json - 导出操作后验证输出是否存在
更多信息
- 完整文档：参见包中的 README.md
- 测试覆盖率：参见包中的 TEST.md
- 方法论：参见 cli-anything-plugin 中的 HARNESS.md
版本
1.0.0