前言¶
在 DeepSeek Harness（DSH）里做文档类任务时，常见情况是：工作区里已有 Word、PDF、表格或 Markdown，需要转成另一种格式给 Agent 读、给同事下载，或写回仓库。若离开 Harness 用桌面软件手工转换，路径和权限与工作区不一致，Agent 也不方便参与。社区插件 dsh-doc-convert（维护者 zsy334）把转换收进同一工作区：侧边栏面板可上传或选文件，对话里也可通过 convert_document 工具让 Agent 直接转换并写回。下面介绍它的定位、能力与安装用法。
这是什么¶
dsh-doc-convert 是 DSH 的客户端（Web）插件，在 Harness 工作区面板或 convert_document 工具中转换 Word、PDF、Markdown、HTML、TXT、Excel/CSV 与 PowerPoint 等常用格式。两个入口共用同一套转换服务：面板适合人工拖选文件并下载结果；工具适合在对话里指定路径与目标格式，由 Agent 完成转换。
插件源码与说明见 GitHub：zsy334/dsh-doc-convert，社区目录页：skillhub.cn/plugins/zsy334/dsh-doc-convert。DSH 生态强调「一切皆插件」；SkillHub 为独立社区目录，与 DeepSeek / 幻方无官方从属关系。
核心功能¶
两个入口¶
- 侧边栏「文档转换」面板：从本机拖入或选择文件上传，或浏览工作区已有文件，选定目标格式后转换并下载。
convert_document对话工具：传入工作区内的输入路径与目标格式，转换结果默认写在源文件同目录。
格式支持（以插件内支持矩阵为准）¶
Office 与 PDF 版式类转换由随插件安装的 LibreOffice Kit（@deepseek-ai/libreoffice-kit）完成；Markdown、HTML、TXT 与部分表格管线由 JS 实现。下表摘自项目 README，完整规则以仓库内 lib/formats.js 为准。
| 源格式 | 可转目标 |
|---|---|
| docx | pdf、html、md、txt、odt |
| doc（Word 97-2003） | docx、pdf、html、md、txt、odt |
| odt | docx、pdf、html、md、txt |
| txt | docx、pdf、html、md |
| md | html、docx、pdf、txt |
| html | md、docx、pdf、txt |
| txt、md（仅文本抽取） | |
| xlsx / xls / ods | csv、pdf、ods/xlsx、html、json |
| csv | xlsx、pdf、html、json |
| tsv | csv、xlsx、json |
| pptx / ppt / odp | pdf、pptx/odp |
说明要点：
- PDF 只做文本或 Markdown 抽取，不做 PDF→Word/PPT 的版面重建；扫描件需 OCR，当前版本不支持。
- 多工作表导出 CSV 时需填写准确的工作表名（面板有输入框；工具使用
sheet参数）。 - 输出默认与源文件同目录；重名时自动加
-1、-2等后缀；所有写入限制在工作区内。
运行依赖¶
- Node.js：
>=22.19.0 - DSH：
>=0.2.1-rc.1 <0.3.0-0 - 插件版本（package.json）：
0.1.0，许可证 MIT
安装与启用¶
安装面向 Web 配置档（--profile web）。首次安装会下载约 160MB 的 LibreOffice Kit 引擎；Linux 若无原生引擎包，会使用 WASM 版本。
dsh plugin --profile web add dsh-doc-convert
# 或直接从 GitHub 安装：
dsh plugin --profile web add github:zsy334/dsh-doc-convert
插件以当前 DSH 进程权限运行。安装前建议浏览仓库源码与 LICENSE，确认符合你的安全与合规要求。
典型用法¶
面板¶
点击左侧栏的「文档转换」图标，选择工作区与文件，再选目标格式，完成转换后可下载结果。
convert_document 工具¶
在对话中让 Agent 调用工具，参数示例：
{ "input_path": "docs/report.md", "target_format": "pdf" }
input_path 为工作区相对路径；target_format 须在该源格式支持的目标列表中。Excel 等多表场景按需补充 sheet 等工作表名参数。
适用场景与注意¶
适合：在 Harness 内统一处理交付物格式（如 md→pdf、docx→md 供 Agent 阅读、csv↔xlsx 数据交换、pptx→pdf 预览）；希望 Agent 在任务链里自动转换并写回同目录文件。
注意：
- 不要指望 PDF 转回可编辑 Office 版式；复杂扫描 PDF 需另备 OCR 流程。
- 转换大文件或首次拉起 LibreOffice Kit 可能耗时，与机器与 WASM/原生引擎环境有关。
- 维护与问题反馈可走 GitHub Issues。
结尾¶
dsh-doc-convert 把常用文档格式转换放进 DSH 工作区，面板与 convert_document 共用同一服务，输出受工作区边界约束，便于人与 Agent 协作。如需安装说明与支持矩阵的最新变更，以仓库 README 为准。
- 目录页：https://www.skillhub.cn/plugins/zsy334/dsh-doc-convert
- GitHub：https://github.com/zsy334/dsh-doc-convert
