在 DeepSeek Harness（DSH）中处理文件时，如果直接将完整内容（如 Excel 或 PDF）输入模型，会消耗大量 token。dsh-plugin-office-markdown 在模型读取文件之前，先将其转换为 Markdown 格式，从而减少上下文输入量。
这是什么¶
这是一个 Bundle 插件，由 Z8906 维护。它解决了在 DSH 中读取大型 Office 或 PDF 文件时 token 消耗过高的问题。通过在本地将文件转换为 Markdown，插件用文件路径代替了整份全文，既节省了 token，又避免了将敏感内容上传到云端。
核心功能¶
- 文件转换：将 Office / PDF 文件转成 Markdown。
- 路径替代：用文件路径代替整份全文，节省 token。
- 本地运行：本地转换，不消耗 API 额度。
- 轻量级：0 npm 依赖。
- 所有权：产物归用户所有。
- 自动清理：卸载时自动清理 Python 环境。
- 批量支持：支持批量转换和结构索引。
- 配置界面：内置设置页，可配置 MarkItDown 环境。
安装与启用¶
- 确保你的 Node 版本 ≥ 18。
- 在 DSH 的 设置 → 插件 → 安装 界面中填入插件名称并回车。
- 填入以下内容进行安装：
dsh-plugin-office-markdown
安装完成后需要重启 DSH。
典型用法¶
安装后，可以通过工具调用或自然语言指令使用转换功能。以下是可用的参数示例：
- 单文件转换：
read_office_as_markdown({ path: "报表.xlsx" })
- 批量转换：
read_office_as_markdown({ paths: [...] })
- 仅获取结构索引（不触发转换）：
read_office_as_markdown({ action: "outline" })
- 清理旧产物：
read_office_as_markdown({ action: "clean" })
- 查看转换器状态：
read_office_as_markdown({ action: "status" })
调用后，插件会返回转换后的 .md 文件路径、体积、行数，以及一份结构索引（章节/工作表/幻灯片的标题与行号），并给出读取建议。
适用场景与注意¶
- 适用场景：需要处理工作区内的 Office 文档（.docx, .docm, .xlsx, .xlsm, .pptx, .pptm）或 PDF 文件，且希望减少 token 消耗的场景。
- 依赖要求：需要 Node ≥ 18，插件本身 0 npm 依赖。
- 文件支持：支持新版 Office 格式。.pdf 与旧版二进制格式（.doc, .xls, .ppt）需要 MarkItDown 或 Python 环境支持。
- 卸载行为：卸载插件会清理它登记过的 Python 环境，这与禁用或关闭插件不同。
- 权限注意：插件以当前 DSH 进程的权限运行，请确保在安装前检查源码与许可证。
总结¶
dsh-plugin-office-markdown 通过本地转换和路径引用机制，帮助 DSH 用户在处理文档时大幅降低 token 消耗。它支持多种文件格式和批量操作，并提供了内置的设置页面来管理 MarkItDown 环境。
