MarchLiu/dsh-uno-office

dsh-uno-office

由 LibreOffice 驱动的 DSH 高保真办公引擎。 通过真实排版引擎（LibreOffice / UNO）用提示词创建和编辑 Office 文档，并在必要时支持人工介入编辑。

与 Univer（纯 JS 内核）路线互补：LibreOffice 是真实排版引擎，复杂排版、转 PDF、公式、数据透视表等保真度高。

能力

| 工具 | 说明 |
|---|---|
| uno_status | 检查 UNO 桥接（python 运行时 / soffice / 连通性） |
| uno_create | 创建 docx / xlsx / pptx / odt / ods / odp |
| uno_read | 读取文档（段落样式 / 单元格网格含计算值 / 幻灯片） |
| uno_edit | 编辑：替换、追加段落、设置单元格、公式、汇总（SUM/COUNT/AVERAGE/MAX/MIN）、数据透视表、增删幻灯片 |
| uno_convert | 高保真导出（pdf、docx↔odt、xlsx、csv、html …） |
| uno_review_export | 人工介入·第 1 步：把文档复制到审阅目录交给用户手工编辑 |
| uno_review_import | 人工介入·第 2 步：用户改完后校验可打开并回灌到工作文档 |

人工介入工作流

1. Agent 调用 uno_review_export，把返回的 review_path 通过文件卡片发给用户；
2. 用户在 LibreOffice / Word / Excel 里手工编辑该副本；
3. 用户说「改好了」，Agent 调用 uno_review_import 校验并覆盖工作文档，继续后续自动化。

安装

1. 先准备 UNO python 运行时（macOS 必须，见下方“为什么”）
bash scripts/setup-runtime.sh

2. 安装插件
dsh plugin --profile  add github:you/dsh-uno-office#

为什么需要 setup-runtime.sh

LibreOffice ≥ 25.2（macOS）给自带 python 签了 ParentLaunchConstraint（CVE-2025-14714 修复），外部进程直接运行会被 macOS SIGKILL（CODESIGNING / Launch Constraint Violation）。该脚本把运行时复制到 ~/libreoffice-python 并 ad-hoc 重签，解除约束。上游讨论：TDF bug 167752。

Linux 上无此问题，可直接用系统 LibreOffice 的 python。

架构

index.js            # 插件入口：注册 7 个工具
lib/bridge.js       # 定位 UNO python、spawn py/uno_bridge.py、超时控制
py/uno_bridge.py    # UNO 命令分发器：连接常驻 headless soffice（socket :2002）
scripts/setup-runtime.sh  # macOS 运行时准备

soffice 以 --headless --accept=socket 常驻，由桥接按需拉起并复用。

License

MIT