前言¶
在 DeepSeek Harness（DSH）里处理文档时，常见做法是把内容交给在线转换服务或让模型重写格式，既涉及上传，又难以固定版式。若只需要把 .md、.docx、.doc 转成带统一样式的 DOCX，并在本地留审计痕迹，更适合用宿主原生插件在机器上完成转换。下面介绍社区插件 dsh-doc-converter（维护者 bronya19c818，GitHub 星标 0，包版本 0.1.10，MIT 许可）：全程不调用模型、文档不上传，样式按不可变版本保存。
这是什么¶
dsh-doc-converter 是 DSH 原生插件，在本地完成 Markdown、DOCX、DOC 到 DOCX 的转换；样式预设分角色配置（标题、正文、表格、图片、页边距等），保存时生成新版本，旧版本仍可追溯。侧边栏「文档转换」页面与 doc_converter 工具调用共用同一套后端。
核心功能¶
资料中明确的能力如下。
- 导入与输出：支持
.md、.markdown、.docx、.doc；选定样式预设后生成 DOCX 供下载，并产出规范化报告与样式快照，便于复核。 - 样式管理：预设按角色设置；
list_styles、create_style、revise_style、delete_style等可选动作与页面逻辑一致；可从旧数据目录一次性迁移，身份、版本与原始字段不变（migrate_styles）。 - Markdown 处理：标题层级由后端统一判定；
*、^等与算式可能冲突的符号按上下文评分决定是否作为强调或上标，判定结果写入报告。 - DOCX / DOC 路径：DOCX 直接走 OOXML 规范化，不重建内容；仅显式指定时才走 Markdown 重建。DOC 转换依赖 LibreOffice；Markdown 与 DOC 转换依赖 Pandoc。只转换 DOCX 时不需要外部程序。
- 环境与依赖探测：可选
dependencies动作；页面「转换环境」会显示 Python、Pandoc、LibreOffice 的探测结果。
运行条件¶
- 操作系统：Windows（README 写明）。
- DSH：
engines.dsh要求>=0.2.1-rc.5；插件面向 web profile（dsh.client.platform为web）。 - Python：3.12 或更新，用于插件自有转换进程；插件在数据根下建私有
venv，不与系统 Python 混用。 - 外部工具：Pandoc（Markdown、DOC）；LibreOffice（仅 DOC）。由插件在执行端探测并调用，包内不分发。
安装与启用¶
在 DSH 中执行官方安装命令（来自 README，勿自行拼接 GitHub 路径）：
dsh plugin --profile web add dsh-doc-converter
安装后重启 DSH，侧边栏会出现「文档转换」。
首次使用：准备私有 Python 环境
用包内准备脚本执行一次（路径中的 <DSH_HOME> 替换为实际 DSH 主目录）：
node <DSH_HOME>/profiles/web/node_modules/dsh-doc-converter/scripts/setup-python.mjs \
--python <Python 3.12+ 可执行文件绝对路径> \
--data-root <DSH_HOME>/storages/dsh-doc-converter
依赖版本来自包内 python/requirements.txt 的锁定列表。也可在 Host 配置里显式提供 pythonPath 和 dataRoot，此时使用执行端的绝对路径。
典型用法¶
页面：选文件、选预设、开始转换；任务在后台运行，切换页面后仍可查看进度与结果；完成后下载 DOCX，其余产物在「其他产物」中查看。
工具调用（与页面一致的序列）：
import_file -> convert -> get_job（直到 completed/failed）-> artifact
可选动作还包括：dependencies、list_styles、create_style、revise_style、delete_style、migrate_styles。
数据位置¶
默认数据根为 $DSH_HOME/storages/dsh-doc-converter：
jobs/<id>/source/：原始输入副本，不覆盖上传文件jobs/<id>/：正式产物与审计文件style-packs/<id>/<version>.json：不可变样式版本
同一数据根只由一个工作进程写入。
适用场景与注意¶
适合：需要在 Windows 上的 DSH web 环境中本地批量或单次产出统一版式 DOCX、并保留规范化报告与样式快照的开发者或团队。
务必注意：
- 插件以当前 DSH 进程权限运行，安装前应自行查看 GitHub 仓库 源码与 MIT 许可及
THIRD_PARTY_NOTICES.txt。 - 非 Windows 或未安装 Pandoc / LibreOffice（当需要对应格式时）会导致相应转换路径不可用；仅 DOCX 输入时无此外部依赖要求。
- 社区插件目录 skillhub.cn 为独立站点，与 DeepSeek / 幻方无官方从属关系。
结尾¶
经过上面的步骤，可以在 DSH 内完成不经过模型的文档转换，并把样式版本与审计产物留在本地存储。进一步了解可访问插件目录页与源码仓库：
- 目录页：https://www.skillhub.cn/plugins/bronya19c818/dsh-doc-converter
- GitHub：https://github.com/bronya19c818/dsh-doc-converter
