概览
dsh-attachment-formats
源码级技术说明DeepSeek Harness (dsh) web plugin — Codex-style attachment expansion: PDF text-layer (pymupdf4llm/pdfjs), Office (docx/xlsx/pptx) to Markdown, TIFF/epub/odt/rtf, long-document spill to index cards, scanned-PDF OCR (tesseract.js + 8 cloud providers inc. DeepSeek Vision), and browser image to PNG. dsh-plugin for the DeepSeek Harness Web GUI.收起技术说明
README / ZH
插件文档
目录摘要
dsh.pub 核对固定版本的组合包契约、运行时事实与分发语义；完整 README 请查看源仓库。
在 GitHub 阅读完整 READMELIMITATIONS
已知限制
- OCR（tesseract.js）对低清扫描件、复杂表格质量有限；置信度不足会自动回退 页面图并明确说明，绝不注入乱码文本。更高质量 OCR（RapidOCR/MinerU/ PaddleOCR）可作为后续可插拔后端（见 `docs/upgrade-v6.md`）。 - pymupdf4llm 高保真引擎仅处理 ≤40 页 PDF（更大用 pdfjs 快速引擎）；表格/ 公式重建质量好但仍非排版级还原，版式细节可用页面图对照。 - 无文本层且 OCR 不可用/失败的扫描件只能走页面图（视觉模型可用）。 - 旧 `.doc/.xls/.ppt` 需要 LibreOffice（`soffice`）；`rtf` 需要 pandoc； `epub/odt` 开箱即用，但装有 pandoc 时保真度更高。缺失的二进制会给出 明确可操作的错误——绝不静默丢弃。 - DOCX 的公式与内嵌图片不提取（表格、标题、正文保留）。 - XLSX 只输出「显示文本/结果」，图表、批注不提取。 - 大纲优先用书签目录；无书签的 PDF 回退字号启发式（对无标题样式的文档较弱）， 索引卡仍提供行数/页数与读取指引。 - iWork、压缩包等暂不转换。 - 图片、文档卡片、剪贴板文字和进度均归属开始接收附件时的会话，切换会话后 各自保留。dsh 0.1.3+ 使用 `createDrafts(sessionId, files)` + `addAttachments`， 旧版图片接口继续兼容。接口缺失或拒绝时明确报错，不再广播合成 drop。 纯原生图片/不支持转换的格式整批放行；混合批次转换支持格式后，将其余文件 经原生管线挂入原会话。通用文件需 dsh 0.1.3+，图片定向接口需 dsh 0.1.1+。 - 草稿合并使用官方输入面，旧宿主以 DOM 桥接回退。卡片条的**发送**按钮向 已挂载的原生输入框发送 Enter，遵守当前排队/插话偏好和上传等待规则。 若宿主更改按键处理方式，已合并的内容仍保留在草稿中，可用原生按钮发送。