前言¶
如果你需要在 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
