前言¶
DeepSeek Harness（DSH）运行在浏览器环境中，原生不具备读写 Office 文档的能力。开发者需要通过插件引入这一能力。hairyf/dsh-office-kit 是一个插件，它为 DSH 提供了本地 Word、PDF、演示文稿与电子表格的处理能力。
是什么¶
这是一个 DSH 插件，由 hairyf 维护，当前版本 0.4.6，许可证为 MIT。它将本地 Office 引擎（Windows/macOS 用 LibreOffice，Linux 用 WASM）接入 DSH，支持通过 / 菜单创建、读取和编辑多种文档格式，并在预览中提供标注与修改请求功能。
核心功能¶
1. 文档创建与编辑¶
插件支持四种主要文档类型，通过 / 菜单触发：
- Word：
/documents创建、读取和编辑 DOCX，支持表格、图片、公式与页眉页脚。 - PDF：
/pdf创建、读取和编辑 PDF，支持合并、旋转、删页与元数据。 - 演示文稿：
/presentations创建、读取和编辑 PPTX，支持项目符号、表格、图表与图片。 - 电子表格：
/spreadsheets创建、读取和编辑 XLSX，支持公式、样式、图表、冻结窗格与重算。
2. 侧边栏标注¶
在文档预览中，可以请求修改。步骤如下：
- 打开 PDF 或 DOC/DOCX，点击工具栏的「请求修改」。
- 悬停吸附段落，点击或拖动框选，输入要求并添加注释。
- 悬停底部「注释数量」查看列表，点击「发送」；「取消」清空本批。
- Esc：先取消当前选区，再按一次退出标注模式。
- 附件：PDF 附选区截图；DOC/DOCX 仅发送文字与定位信息。
- 草稿：已有输入时先合入草稿，由你确认发送；暂存注释刷新后不保留。
3. 会话引用与渲染校验¶
- 会话引用：通过 Chip 调用文档技能；注释链接可悬停查看文件名与要求，PDF 标注附选区截图。
- 渲染校验：DOCX/PPTX/XLSX 经 DSH 自带的 LibreOffice Kit（Windows/macOS 原生引擎，Linux 走 WASM）栅格化，PDF 直接用 PyMuPDF；缺失字体会在报告里点名，不再静默产出豆腐块。SVG/PDF 素材可用
ensure_raster_image.py转成 PNG 后嵌入。
4. 活体表格¶
excel-live-control 技能通过 COM 驱动已经打开的 Excel / WPS 表格，支持读区、写值、样式、图表、重算、保存。
安装与启用¶
在 DSH 官方插件中搜索并安装 dsh-office-kit，或使用命令行：
dsh plugin add dsh-office-kit
安装后需要在「设置 → 插件」中启用。该插件依赖 DSH ≥ 0.2.1-rc.2，Python 版本要求 3.10–3.13。Windows 缺少兼容 Python 时会自动安装；macOS / Linux 使用系统现有的 Python。
典型用法¶
通过菜单处理文档¶
- 在输入框键入
/，选择「文档」、「PDF 文档」、「演示文稿」或「电子表格」。 - 回车插入 Chip，描述创建、读取或修改任务。
- 打开生成的文件，在侧边栏预览结果。
适用场景与注意¶
适合需要在 DSH 中直接处理 Office 文档的场景，如自动生成报告、批量修改文档格式、在对话中引用文档内容等。
注意：插件以当前 DSH 进程的权限运行，安装前应检查源码与许可证。它不支持 Google Docs / Slides / Sheets 或远程编辑。
结语¶
DSH 的设计理念是「一切皆插件」，社区目录与 DeepSeek 或幻方无官方从属关系。hairyf/dsh-office-kit 提供了本地 Office 处理能力，配合侧边栏标注与活体表格，可以在对话中更自然地操作文档。
- 目录页：https://www.skillhub.cn/plugins/hairyf/dsh-office-kit
- GitHub：https://github.com/hairyf/dsh-office-kit
