dsh-file-upload

DeepSeek Harness (dsh) 文件消息插件 —— Claude 桌面端风格的拖拽/回形针文件上传,内容嗅探、文档转 Markdown(内置 JS 解析 + 可选微软 MarkItDown CLI),小文本直插输入框,read_document 工具让 agent 分页读取。

English | 中文

能力

• 上传:composer 回形针按钮 + 全局拖拽(拖动文件到窗口任意位置 → "松开以添加文件"遮罩 → 松开即上传),多文件支持
• 附件卡片:按类型着色的徽标卡(PDF 红 / DOC 蓝 / XLS 绿 / TXT 灰 / ZIP 紫 / JSON 金),显示名称、大小,可移除
• 文本直插(Claude 风格):小的文本文件(代码/JSON/CSV/日志/配置…)上传后内容直接进输入框,模型第一眼就看到文件内容;大文本插入路径引用
• 文档转 Markdown(开箱即用,非可选):内置 markitdown-node 引擎(微软 MarkItDown 的 TypeScript 移植),覆盖 PDF/DOCX/PPTX/XLSX/HTML/CSV/JSON/XML/ZIP/Jupyter/图片 OCR 等 20+ 格式,装完即用,零外部依赖;
• MarkItDown CLI 增强(可选):检测到微软官方 MarkItDown CLI 时自动启用,进一步支持音频转写、EPUB 等;内置引擎始终兜底
• read_document 工具:行号分页、offset/limit 翻页、字节预算 LRU 缓存(文件改动自动失效)、大小预检、走 ctx.fs(继承沙箱与 fs 观察策略)
• 安全:loopback-only、文件名消毒、会话隔离存储(.dsh-uploads/)、sha256 去重、并发限流、TTL 清扫

安装

dsh plugin --profile web add dsh-file-upload
# 重启 dsh web

使用

1. 点 composer 左侧回形针按钮,或直接拖文件到窗口;
2. 小文本文件内容自动进入输入框;文档显示为附件卡,路径随消息发出;
3. agent 对文档调用 读取全文(自动转 Markdown,可翻页)。