jiavenzhong/dsh-tool-markitdown

README 摘要

dsh-tool-markitdown DeepSeek Harness（DSH）插件：发送其他格式的文件时， 优先转换为大语言模型最容易理解的 Markdown 再交给模型。 转换引擎：Microsoft MarkItDown — 本地执行，文件不离开你的电脑。 适用平台 dsh web（DeepSeek Harness Web GUI，Windows / macOS / Linux） 转换格式 PDF、Word、Excel、PPT、HTML、CSV、EPUB、ODT/ODS/ODP、RTF、JSON/XML、ipynb、图片 OCR 等 插件形态 宿主半区（Node）+ 浏览器半区（Web），纯 JavaScript， 无需构建 License MIT ✨ 功能特性 - 📄 输入框一键转换 ：点输入框工具行的 📄 按钮选文件，MarkItDown 立即转成 Markdown 并插入输入框草稿，发送给模型的就是 Markdown 正文（可先编辑再发送）。 - 🔄 发送时自动转换 ：从右侧文件面板把文件拖进输入框后发送，插件自动识别"一整行就是一个文件路径"的草稿行（如 docs/报告.pdf ），先转换再发送。 - 🤖 模型侧 markitdown 工具 ：对话里提到本地路径、http(s) 链接或上传后的 attachmentId ，模型会优先调用工具转换后再阅读。 - ✂️ 超长内容截断 + 全文可取回 ：默认单次返回 120,000 字符，超出后截断并返回 attachmentId ；模型可用该 id 取回完整内容（ /markitdown/raw/ ）。 - ⚙️ 可视化配置 ：「设置 插件配置 markitdown」可调 Python 命令、文件大小上限、输出字符上限、超时、发送时自动转换开关，改动即时生效。 - 🖼️ 图片不冲突 ：图片保持原样，继续优先走视觉识别（如 describe image ）；需要 OCR 时可让模型用 markitdown 工具处理图片。 - 🗂️ 原文件永不丢失 ：磁盘上的原文件只读、绝不修改或删除；上传的临时副本转换完成后立即清理。 🧩 工作原理 - 浏览器半区 （ lib/client.js ）：输入框 📄 按钮、发送时路径自动转换、草稿拼接。 - 宿主半区 （ lib/index.js + lib/routes.js + lib/convert.js ）： markitdown 工具注册、 /markitdown/ 路由、MarkItDown 子进程封装、结果注册表（内存，最多 256 条，重启清空）。 ✅ 环境要求 依赖 说明 DeepSeek Harness 已安装且 dsh web 可正常启动 Python 3.9+ 运行 MarkItDown；Windows 下也可用 py -3 ma…

分类