前言¶
在 DSH 插件体系里，智能体需要生成和编辑 Office 文件时，常见难点不是“能不能生成”，而是字段结构、文档操作和结果核对是否明确。DSH-Office 插件用于解决这个问题：它用本机 zagens-office 生成和编辑 PPTX / DOCX / XLSX / PDF，并通过一组工具让模型先取契约，再执行写或改。
这是什么¶
DSH-Office 由 didclawapp-ai 维护，许可证为 MIT。它面向需要把 PPTX / DOCX / XLSX / PDF 读写纳入 DSH 工作流的场景，核心依赖本机 zagens-office。
核心功能¶
插件提供四个工具：
| 工具 | 作用 |
|---|---|
office_schema |
取 JSON 契约，写/改之前先调 |
office_write |
新建文档 |
office_edit |
按 op 改已有文档 |
office_read |
读回文档核对 |
可用顺序是：先 office_schema，再 office_write 或 office_edit，最后 office_read。
安装与启用¶
安装命令：
dsh plugin --profile web add github:didclawapp-ai/DSH-Office
启动：
dsh web
启动日志出现以下内容即表示加载成功：
[zagens-office] plugin loaded
Node 引擎要求：
^22.19.0 || >=24.0.0
如果没有引擎，模型会自行下载到：
~/.zagens-pro/bin
需要固定到某个提交版本时：
dsh plugin --profile web add github:didclawapp-ai/DSH-Office#<commit-sha>
卸载：
dsh plugin --profile web remove dsh-zagens-office
典型用法¶
一个可复现的流程如下：
1、调用 office_schema，取 JSON 契约。
2、需要新建文档时，调用 office_write。
3、需要修改已有文档时，调用 office_edit，按 op 修改。
4、调用 office_read，读回文档核对。
写/改之前先调 office_schema，是为了在字段未确认前避免直接生成或修改文档。
适用场景与注意¶
适合：需要 DSH 智能体按明确 JSON 契约处理 PPTX / DOCX / XLSX / PDF 的流程。
注意：
- 插件以当前 dsh 进程权限运行。
- 安装前检查源码与许可证。
- 该插件许可证为 MIT。
- 使用本机 zagens-office，缺少引擎时会下载到
~/.zagens-pro/bin。
结尾¶
DSH-Office 把 Office 文档生成和编辑收敛到四个工具：查契约、新建、修改、读回核对。仓库地址：https://github.com/didclawapp-ai/DSH-Office
