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 步：用户改完后校验可打开并回灌到工作文档 |
人工介入工作流
- Agent 调用
uno_review_export，把返回的 review_path 通过文件卡片发给用户；
- 用户在 LibreOffice / Word / Excel 里手工编辑该副本；
- 用户说「改好了」，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
