前言¶
如果你需要在 DSH 智能體裏生成或處理 Word、Excel、PowerPoint 文件，dsh-office-tools 提供一個插件化的入口。它面向模型暴露七個 Office 文件工具，支持在 session workspace 內創建、讀取和更新 .docx、.xlsx、.pptx 文件。整個過程不啓動 LibreOffice、PowerPoint 或 Word 子進程，而是使用純 JS 庫完成文件生成和解析。
這是什麼¶
dsh-office-tools 是由 kw78 維護的 DSH 插件，許可證爲 MIT。
一句話定位：DSH model-facing Office tools: create, read, and update Word (.docx), Excel (.xlsx), and PowerPoint (.pptx) files inside the session workspace.
核心功能¶
插件提供七個 model-facing 工具：
| 工具 | 能力 |
|---|---|
word_create |
創建 .docx 文件，包含標題、段落、列表和一個表格 |
word_read |
從 .docx 文件中提取純文本 |
excel_create |
從標量單元格網格創建多工作表 .xlsx 文件 |
excel_read |
將一個或多個工作表讀取爲標量行 |
excel_update |
替換或創建整個工作表，或按 A1 地址寫單元格 |
ppt_create |
創建 16:9 .pptx 文件，包含標題頁、標題、段落、列表、備註和 PNG/JPG/GIF 圖片 |
ppt_read |
提取每頁幻燈片的段落文本、演講者備註和圖片數量 |
安裝與啓用¶
先選擇一種安裝方式。下面是 npm、GitHub 源碼和本地目錄三種命令：
# npm
dsh plugin --profile web add dsh-office-tools
# GitHub source
dsh plugin --profile web add github:kw78/dsh-office-tools
# local checkout
dsh plugin --profile web add /path/to/dsh-office-tools
如果從本地源碼構建，先在倉庫中執行：
pnpm install
pnpm run check
pnpm run check 會執行 typecheck、tests 和 build。安裝或構建完成後，重啓 DSH server。經過上面的步驟，七個工具會出現在下一次 prompt assembly 中。
使用邊界¶
插件的文件訪問被限定在調用 agent 的 session workspace 內。
讀取方面，讀取上限爲 50 MiB；文本或單元格結果有界，並會標記 truncated。
創建和更新方面，受行數和單元格數限制，並且默認拒絕覆蓋。overwrite 的默認值是 false。
圖片文件必須位於 session workspace 內，支持 .png、.jpg、.jpeg、.gif，每個圖片文件限制爲 20 MiB。ppt_create 支持顯式英寸座標 x/y/w/h，也可以省略座標，讓圖片自動放置在文本下方。
適用場景與注意¶
dsh-office-tools 適合需要在 DSH 智能體中直接生成 Office 文檔、讀取文檔內容或更新表格的工作流程。DSH 生態強調“一切皆插件”，這裏介紹的是第三方插件；社區目錄是獨立站點，與 DeepSeek / 幻方無官方從屬關係。
插件以當前 dsh 進程權限運行。安裝前，建議檢查源碼、依賴和許可證。本倉庫許可證爲 MIT，GitHub 地址如下：
https://github.com/kw78/dsh-office-tools
