dsh-attachment-formats

LIMITATIONS

已知限制

- 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、压缩包等暂不转换。 - 附件归属当前对话：文本/文档卡片一定落在你正在看的这个对话框（按 shell 的「当前会话」解析，不再依赖插槽渲染顺序）。转换出的页面图片走 Harness 原生 drop 管线——当前会话回复中时会暂时拒绝 drop，插件会等它空闲再投喂； 若同时开着多个对话，其它**空闲**的对话也可能接住同一合成 drop（Harness 层面的行为，插件无法圈定范围），建议附图片时只开一个对话（文本/代码文件 不受影响，始终留在当前对话）。 - 文档卡片的"发送时合并"走 DOM 事件桥接到 React 受控输入框，属于对 Harness 未公开 API 的适配；核心包升级后若失效，症状是「卡片内容没进 消息」，此时可用卡片条的**发送**按钮兜底（合成 Enter 路径），图片路径 始终不受影响。