dsh-uno-office

LibreOffice-powered high-fidelity office engine for 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 <name> add github:you/dsh-uno-office#<commit>

为什么需要 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