前言¶
在 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
