dsh-markitdown
在终端中运行以下命令:
dsh plugin install AlbertZJ/dsh-markitdown
将以下提示词粘贴到 DeepSeek Harness 对话框中:
在 DeepSeek Harness 任意配置文件的 Plugins 页面选择从源码安装,或执行 CLI:dsh plugin install AlbertZJ/dsh-markitdown(源码仓库:https://github.com/AlbertZJ/dsh-markitdown)。
插件介绍
在 DeepSeek Harness 里,模型往往只能直接读 Markdown 或少量格式;PDF、Office、网页、图片和音频若不能稳定转成 Markdown,后续问答和编辑就会卡住。dsh-markitdown 把 Microsoft MarkItDown 接到 Harness 的模型工具层:在你配置的 Python 环境里调用 markitdown,不依赖 MCP,也不把转换引擎打进插件包,适合「已有 Python 生态、希望 Harness 能批量消化本地与网络文档」的场景。
核心能力围绕两类工具与一条工作流:markitdown_check 探测解释器与 MarkItDown 是否就绪并给出缺失时的安装指引;markitdown_convert 支持单文件或最多 16 个路径/URL 批量转换,可写文件、写目录或内联返回 Markdown。Word 内嵌图会导出到 .media 并在文档里换成可打开的文件链接,便于会话里用 read_image 追问细节;在 Settings → MarkItDown 中还可选地为导出图片生成模型描述(需自行配置提供商与 openai 包)。网络源在连接前做固定出口校验,默认拒绝内网与环回地址。
适合经常把合同、幻灯片、表格、扫描件、邮件附件或 YouTube 等链接交给 Agent 分析的用户;也适合希望在转换前自检环境、在转换后保留图片与 caveat 的文档工作流。需注意:扫描版 PDF 可能几乎没有文本层,复杂版式会压成线性 Markdown;插件不会替你 pip 安装 MarkItDown,应先跑 check 再按提示配置。
使用场景
- 把 PDF、Word、PPT 等本地文件转成 Markdown 再交给 Agent 分析
- 批量转换多个文件或 http(s) 链接(含需额外依赖的媒体源)
- Word 内嵌图导出为文件并在会话里继续看图追问
适合人员
- 常在 Harness 里处理合同、报告、幻灯片的知识工作者
- 需要自检 Python/MarkItDown 环境再转换的插件用户
- 希望文档与图片链接可复查、而非只靠一次性描述的团队