办公文档套件 hairyf/dsh-office-kit

DSH Office Kit

[![npm version][npm-version-src]][npm-version-href]
[![npm downloads][npm-downloads-src]][npm-downloads-href]
[![bundle][bundle-src]][bundle-href]
[![JSDocs][jsdocs-src]][jsdocs-href]
[![License][license-src]][license-href]

为 DeepSeek Harness (DSH) 提供本地 Word、PDF、演示文稿与电子表格能力，支持 / 菜单、引用 Chip，以及侧边栏预览中的选区标注与修改请求。

📦 安装

在官方插件中安装 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。

特性

- 📝 Word：/documents 创建、读取和编辑 DOCX，支持表格、图片、公式与页眉页脚。
- 📄 PDF：/pdf 创建、读取和编辑 PDF，支持合并、旋转、删页与元数据。
- 📽️ 演示文稿：/presentations 创建、读取和编辑 PPTX，支持项目符号、表格、图表与图片。
- 📊 电子表格：/spreadsheets 创建、读取和编辑 XLSX，支持公式、样式、图表、冻结窗格与重算。
- 🖍️ 侧边栏标注：在 PDF、DOC/DOCX、PPTX、XLSX 预览中吸附段落或框选区域，批量提交修改要求。
- 🔗 会话引用：通过 Chip 调用文档技能；注释链接可悬停查看文件名与要求，PDF 标注附选区截图。
- 🖼️ 渲染校验：DOCX/PPTX/XLSX 经 DeepSeek Harness 自带的 LibreOffice Kit（Windows/macOS 原生引擎，Linux 走 WASM）栅格化，PDF 直接用 PyMuPDF；缺失字体会在报告里点名，不再静默产出豆腐块。SVG/PDF 素材可用 ensure_raster_image.py 转成 PNG 后嵌入。
- 🧮 活体表格：excel-live-control 技能通过 COM 驱动已经打开的 Excel / WPS 表格（读区、写值、样式、图表、重算、保存）。

🚀 快速开始

通过菜单处理文档

1. 在输入框键入 /，选择 文档、PDF 文档、演示文稿 或 电子表格。
2. 回车插入 Chip，描述创建、读取或修改任务。
3. 打开生成的文件，在侧边栏预览结果。

在预览中请求修改

1. 打开 PDF 或 DOC/DOCX，点击工具栏的 请求修改。
2. 悬停吸附段落，点击或拖动框选，输入要求并添加注释。
3. 悬停底部 注释数量 查看列表，点击 发送；取消 清空本批。

- Esc：先取消当前选区，再按一次退出标注模式。
- 附件：PDF 附选区截图；DOC/DOCX 仅发送文字与定位信息。
- 草稿：已有输入时先合入草稿，由你确认发送；暂存注释刷新后不保留。

💡 示例文档

- Word
- PDF
- 演示文稿
- 电子表格
- 来源与许可

📚 配置与限制

- Python：DSH_OFFICE_PYTHON 可指定解释器。
- 标注范围：仅 PDF、DOC/DOCX；扫描 PDF 可框选截图，不提供 OCR。
- 本地文件：不支持 Google Docs / Slides / Sheets 或远程编辑。
- 完整清单：能力与未支持项。

🛠️ 开发与贡献

pnpm install
pnpm run lint --fix
pnpm run typecheck
pnpm run test -- --run
pnpm run build

📜️ 许可证

- MIT
- 示例文档保留 Apache Tika 的许可与声明。

[npm-version-src]: https://img.shields.io/npm/v/dsh-office-kit?style=flat&colorA=080f12&colorB=1fa669
[![npm version][npm-version-src]][npm-version-href]
[![npm downloads][npm-downloads-src]][npm-downloads-href]
[![bundle][bundle-src]][bundle-href]
[![License][license-src]][license-href]
[![JSDocs][jsdocs-src]][jsdocs-href]

dsh-office-kit

一套 Office 工具，供 dsh 智能体使用。支持读写 Word、Excel、PowerPoint 和 PDF 文件，无需安装 Office。

功能

- Word（.docx）：读取文本、表格和样式；生成新文档；替换内容。
- Excel（.xlsx）：读取工作表、单元格和公式；写入单元格；导出 CSV。
- PowerPoint（.pptx）：读取幻灯片和备注；按模板生成演示文稿。
- PDF：提取文本和元数据；合并、拆分页面。

安装

npm install dsh-office-kit

用法

import { readDocx, writeXlsx, readPdf } from 'dsh-office-kit'

const doc = await readDocx('./report.docx')
console.log(doc.paragraphs)

await writeXlsx('./data.xlsx', [
{ name: 'Alice', score: 92 },
{ name: 'Bob', score: 85 },
])

const pdf = await readPdf('./manual.pdf')
console.log(pdf.text)

API

| 函数 | 说明 |
| readDocx(path) | 读取 .docx 文件，返回段落、表格和样式 |
| writeDocx(path, content) | 生成 .docx 文件 |
| readXlsx(path) | 读取 .xlsx 文件，返回工作表和单元格 |
| writeXlsx(path, rows) | 把数据写入 .xlsx 文件 |
| readPptx(path) | 读取 .pptx 文件，返回幻灯片和备注 |
| readPdf(path) | 提取 PDF 文本和元数据 |
| mergePdf(paths, output) | 合并多个 PDF 文件 |

配置

| 选项 | 类型 | 默认值 | 说明 |
| strict | boolean | false | 遇到不支持的格式时抛出错误 |
| maxFileSize | number | 52428800 | 单个文件大小上限，单位字节 |
| encoding | string | 'utf-8' | 文本编码 |

在 dsh 中使用

把插件注册到智能体，就能让智能体直接操作 Office 文件：

import { definePlugin } from 'dsh'
import officeKit from 'dsh-office-kit'

export default definePlugin({
name: 'office-kit',
setup(ctx) {
ctx.tools.register(officeKit.tools)
},
})

许可证

MIT