前言¶
在 DeepSeek Harness（DSH）里做智能体或工作流时，对话往往要落到真实文件：改一版 DOCX、合并 PDF、补一张表里的公式。若只靠模型口述或手工切到桌面 Office，预览与「指着这一段改」的闭环很难接上。dsh-office-kit 把 Word、PDF、PPTX、XLSX 的创建、读取与编辑收进插件，并配合输入框 / 菜单、引用 Chip 和侧边栏预览，把文档技能和会话绑在同一界面里。
这是什么¶
dsh-office-kit 是面向 DSH 的插件，npm 包名为 dsh-office-kit，简介为「Office documents, PDF, presentations, and spreadsheets for DeepSeek Harness」。社区目录页维护者为 Tranquillitatis-Lab（SkillHub 目录）；源码与说明见 GitHub 仓库（README 中亦引用相关实现与 npm 发布）。它不提供 Google Docs 等在线协作，专注本机文件与 DSH 会话内的预览、标注与修改请求。
核心功能¶
以下能力均来自项目 README 与能力说明，按文档类型归纳。
四类文档技能¶
- Word（
/documents）：创建、读取、编辑 DOCX；支持表格、图片、公式、页眉页脚。 - PDF（
/pdf）：创建、读取、编辑 PDF；支持合并、旋转、删页与元数据。 - 演示文稿（
/presentations）：创建、读取、编辑 PPTX；支持项目符号、表格、图表与图片。 - 电子表格（
/spreadsheets）：创建、读取、编辑 XLSX；支持公式、样式、图表、冻结窗格与重算。
会话与预览¶
- Chip 引用：在输入框用
/插入对应菜单项，用自然语言描述创建、读取或修改任务。 - 侧边栏标注：在 PDF、DOC/DOCX、PPTX、XLSX 预览中吸附段落或框选区域，批量提交修改要求；注释可通过 Chip 链接回会话，PDF 标注可附选区截图。
- 渲染校验：DOCX/PPTX/XLSX 经 DSH 自带的 LibreOffice Kit 栅格化（Windows/macOS 原生引擎，Linux 走 WASM）；PDF 使用 PyMuPDF。缺字会在报告里点名。SVG/PDF 素材可用
ensure_raster_image.py转 PNG 后嵌入。 - 活体表格（Windows）：
excel-live-control通过 COM 驱动已打开的 Excel / WPS，支持读区、写值、样式、图表、重算、保存。
完整支持项与限制见仓库内 CAPABILITY.md。
安装与启用¶
在 DSH 官方插件列表中安装 dsh-office-kit，或使用命令行：
dsh plugin add dsh-office-kit
安装后：
- 打开 设置 → 插件，启用该插件。
- 确认 DSH 版本不低于
0.2.1-rc.2。 - 准备 Python
3.10–3.13（README 写明插件侧可不预装，缺失时会自动安装；Windows 在缺少兼容 Python 时会自动安装，macOS / Linux 优先使用系统已有解释器）。
可选：通过环境变量 DSH_OFFICE_PYTHON 指定 Python 解释器（见 README「配置与限制」）。
插件以当前 DSH 进程权限访问本机文件；安装前建议阅读源码与 MIT 许可证（package.json 中 license 字段为 MIT）。
典型用法¶
通过菜单处理文档¶
- 在输入框键入
/，选择 文档、PDF 文档、演示文稿 或 电子表格。 - 回车插入 Chip，描述创建、读取或修改任务。
- 打开生成的文件，在侧边栏预览结果。
在预览中请求修改¶
- 打开 PDF 或 DOC/DOCX，在工具栏点 请求修改。
- 悬停吸附段落，或拖动框选，输入要求并添加注释。
- 悬停底部 注释数量 查看列表，点 发送；取消 可清空本批。
操作习惯（README 原文）：
- Esc：先取消当前选区，再按一次退出标注模式。
- 附件：PDF 附选区截图；DOC/DOCX 仅发送文字与定位信息。
- 草稿：已有输入时会先合入草稿，由你确认发送；暂存注释在刷新后不保留。
仓库 public/samples/ 下提供 Word、PDF、演示文稿、电子表格示例文件，便于对照能力边界。
适用场景与注意¶
适合：需要在 DSH 会话中直接产出或迭代本地 Office 文件、希望预览里「指哪改哪」的开发者与用户；Windows 上若要与已打开的 Excel/WPS 联动，可使用 excel-live-control。
注意：
- 标注范围：侧边栏段落吸附与修改请求主要针对 PDF、DOC/DOCX；扫描版 PDF 可框选截图，不提供 OCR。
- 平台：活体表格依赖 Windows COM；Linux 上 Office 预览走 WASM 路径，行为以 README 与
CAPABILITY.md为准。 - 远程与云文档：不支持 Google Docs / Slides / Sheets 或远程编辑。
- 生态：DSH 奉行「一切皆插件」；SkillHub 等为社区目录，与 DeepSeek / 幻方无官方从属关系，本文安装命令以 README 原文为准，勿自行拼接
github:owner/repo形式。
结尾¶
dsh-office-kit 把四类本地办公文档和 PDF 的操作、预览、标注收回 DSH，减少「对话在外、文件在手」的割裂。查阅条目与星标等信息可见 SkillHub：dsh-office-kit；细节与示例见 GitHub：Tranquillitatis-Lab/dsh-office-kit。
