dsh.so
中文
English中文
dsh-md-convert avatar

dsh-md-convert

Convert Office documents and PDFs (incl. scanned, via CPU-first routing OCR with lightweight models: PP-DocLayout-L layout, RapidOCR text, SLANet tables, FormulaNet formulas) to structurally-formatted Markdown. CLI + dsh agent tool (md_convert).

Plugin开发视觉自动化终端文件视觉 / OCR办公自动化
验证
L5 · 运行已测
通过
风险
低风险
健康
活跃
信任
金

安装验证：运行验证通过 (L5) · 验证于 dsh 0.2.1-alpha.2 · 验证日期 安装验证详情 →

安装验证徽章 dsh 0.2.1-alpha.2

功能介绍AI

将Office文档和PDF（含扫描件）转换为结构化Markdown，使用轻量OCR模型，提供CLI和智能体工具。

  • CPU优先的轻量级OCR识别
  • 识别布局、文本、表格和公式
  • 提供CLI和dsh智能体工具(md_convert)
developerAIfileAIvisionAI

能力标签为 AI 推断或 README 规则抽取（见角标），词表受限、未经安装验证；AI = 推断，README = 原文关键词。

安装

dsh plugin --profile web add github:yakoylp/dsh-md-convert#v0.5.6
已验证 v0.5.6

安装方式: GitHub · 运行验证通过 (L5) · 验证于 dsh 0.2.1-alpha.2

验证与兼容性

按插件版本分组：每张卡是该插件版本实测过的 dsh 版本与安装兼容结论（L5 优先）。只列真测过的组合——未列出 = 未实测，不推定兼容。L1–L3 为插件级静态档（与 dsh 版本无关，各 dsh 行同值）：在行内「验证等级」格里与 L4/L5 并列显示、标注「静态」，证据体为插件级单份、随行内「查看检查项与证据」出现，不在各版本重复存储。

External credentials（插件级）：未检测到

原插件兼容声明来自 package.json · peerDependencies
作者未声明 dsh 版本要求

○ 作者未声明 dsh 版本要求 —— 安装不会因版本被拒。

安装兼容矩阵（速览 · 行 = 插件版本〔最近 5〕，列 = dsh 版本〔最近 5〕）
结论一览 → 证据在下方分版本卡片
插件版本 ＼ dshdsh 0.2.1-alpha.2dsh 0.1.7-rc.1
v0.5.6✓·
安装兼容实测（按插件版本，组内按 dsh 版本）
图例：✓ L5 运行验证通过○ 生态插件◼ 生态应用✗ 失败
v0.5.6github✓ 运行验证通过 12026-10-18

https://github.com/yakoylp/dsh-md-convert

✓dsh 0.2.1-alpha.22026-10-10L5 · 运行验证通过
实测环境与工件
  • • Node.js: v24.14.0
  • • DSH: 0.2.1-alpha.2
  • • 被测插件工件: github · https://github.com/yakoylp/dsh-md-convert#v0.5.6
验证等级（L1–L3 为插件级静态档 · L4/L5 为该组合最新真测）
L1 静态
通过
L2 静态
通过
L3 静态
通过
L4 沙盒
通过
L5 运行
通过
在 dsh 沙盒中完成安装与运行冒烟——装得上、跑得起来
L5 · 运行验证通过 · dsh 0.2.1-alpha.2 有效

ID: dsh-md-convert@v0.5.6@dsh0.2.1-alpha.2 · 档位: l4-sandbox

签发：2026-10-10 · 有效至：2026-10-17

查看检查项与证据
L1 · 已找到✓ 通过
由 L3 推定✓ 通过
默认通过——L3 安装规范已通过（全库 L3 扫描策略）
L2 · 结构化✓ 通过
由 L3 推定✓ 通过
默认通过——L3 安装规范已通过（全库 L3 扫描策略）
L3 · 安装规范✓ 通过
安装命令已解析✓ 通过
来源：插件市场校验 · 方式：安装规范解析 · 采集于 2026-10-18
DSH 版本已声明✓ 通过
来源：插件市场校验 · 方式：DSH 版本声明 · 采集于 2026-10-18
L4 · 安装已测✓ 通过
受限沙盒内执行安装✓ 通过
来源：Windows ACL 沙盒 · 方式：沙盒安装执行 · 采集于 2026-10-10
安装源 github:yakoylp/dsh-md-convert#v0.5.6 · 通道 GitHub 源码 · 结果 ran · 退出码 0
检查耗时：77.3s
沙盒安装成功✓ 通过
来源：Windows ACL 沙盒 · 方式：沙盒安装执行 · 采集于 2026-10-10
安装源 github:yakoylp/dsh-md-convert#v0.5.6 · 通道 GitHub 源码 · 结果 ran · 退出码 0
检查耗时：77.3s
安装产物已确认✓ 通过
来源：Windows ACL 沙盒 · 方式：沙盒安装执行 · 采集于 2026-10-10
安装源 github:yakoylp/dsh-md-convert#v0.5.6 · 通道 GitHub 源码 · 结果 ran · 退出码 0
检查耗时：77.3s
安装版本已解析✓ 通过
来源：Windows ACL 沙盒 · 方式：沙盒安装执行 · 采集于 2026-10-10
安装源 github:yakoylp/dsh-md-convert#v0.5.6 · 通道 GitHub 源码 · 结果 ran · 退出码 0
检查耗时：77.3s
L5 · 运行已测✓ 通过

已在加载器目录树中激活（150 个条目）

沙盒安装通过✓ 通过
来源：Windows ACL 沙盒 · 方式：沙盒安装执行 · 采集于 2026-10-10
安装源 github:yakoylp/dsh-md-convert#v0.5.6 · 安装方式 复用 L4 沙盒
检查耗时：1.8s
Web 启动就绪✓ 通过
来源：DSH 运行时 · 方式：Web 启动 · 采集于 2026-10-10
就绪行 dsh web: http://127.0.0.1:55917/?token=…
HTTP 服务响应✓ 通过
来源：DSH 运行时 · 方式：HTTP 请求 · 采集于 2026-10-10
探测路径 / · HTTP 200 · 耗时 1.8s
插件清单中已激活✓ 通过
来源：DSH 运行时 · 方式：插件清单查询 · 采集于 2026-10-10
清单判定 active · 清单条目 150
命中：include:dsh-md-convert · dsh-md-convert · 相位 active
相位计数：active 122 · null 28

L1–L3 为插件级静态结论（基础门槛，全 dsh 版本相同）：证据为插件级单份，不在各版本重复存储。

仅展示最近 3 个已发布版本；源码快照（commit hash）组、未标注工件组与更早版本不展示——全量档案保留在数据层（插件无任何已发布版本时，快照/未标注组才照常展示）。

作者徽章

将官方徽章嵌入你的 README，展示插件的安全与安装检测状态：

dsh.so risk
`[![dsh.so risk](https://www.dsh.so/badge/dsh-md-convert.svg)](https://www.dsh.so/artifact/dsh-md-convert/)`
dsh 0.2.1-alpha.2 安装验证已通过
`[![dsh.so install · dsh 0.2.1-alpha.2](https://www.dsh.so/badge/install/dsh-md-convert@0.2.1-alpha.2.svg)](https://www.dsh.so/artifact/dsh-md-convert/)`

安全报告

两层自动化检查，都不是人工审核：静态扫描（逐插件规则判定）与模型驱动的动态安全审计（只覆盖静态判定 warn 及以上的插件子集，不执行插件代码）。

dsh-md-convert自动审查 · 每日更新

静态扫描 低，动态审计最高 中，按「取更严者」→ 总评级 中。

静态 低→动态 中→总评级 中
0 严重·0 高
中总评级 · 中
1静态扫描 · vet 主判vet AST 静态分析（npm 发布物或 git 源码）
版本绑定
插件版本v0.5.6dsh 清单
扫描版本v0.5.6git2026-10-21
当前版本v0.5.6版本一致
vet 判定clean · git

vet 为 AST 静态扫描（npm 发布物或 git 源码）。

静态发现（8 条）
  • 警告childProcess · code-execlib/core/deps.js:47

    const r = spawnSync(py, ["--version"], { encoding: "utf8", timeout: 15_000, windowsHide: true });

  • 警告childProcess · code-execlib/core/deps.js:63

    const r = spawnSync(python, ["-c", probe], { encoding: "utf8", timeout: 60_000, windowsHide: true });

  • 警告childProcess · code-execlib/core/deps.js:180

    const r = spawnSync(python, ["-c", probe], { encoding: "utf8", timeout: 60_000, windowsHide: true });

  • 警告childProcess · code-execlib/core/legacy.js:102

    const r = spawnSync("powershell.exe", ["-NoProfile", "-NonInteractive", "-ExecutionPolicy", "Bypass", "-File", scriptPath, ...args], {

  • 警告childProcess · code-execlib/core/legacy.js:145

    const r = spawnSync("powershell.exe", ["-NoProfile", "-NonInteractive", "-ExecutionPolicy", "Bypass", "-Command", script], {

  • 警告childProcess · code-execlib/core/legacy.js:176

    const r = spawnSync(cmd, ["--version"], { encoding: "utf8", timeout: 30_000, windowsHide: true });

  • 警告shellExec · shelllib/core/legacy.js:124

    try { execFileSync("powershell.exe", ["-NoProfile", "-Command", "Start-Sleep -Milliseconds 2500"], { windowsHide: true, timeout: 10_000 });

  • 警告childProcess · code-execlib/core/spawn.js:29

    child = spawn(cmd, args, { windowsHide, env });

2动态审计模型读脱敏源码上下文 · 不执行插件代码
最高等级中
并入后总评级 中
审计时间2026-10-17
发现计数0 严重·0 高另有 1 条中 / 1 条低未展开
展开 2 条审计发现
  • mediummd_convert 会静默向宿主 Python 安装 OCR 包,并可回退使用 --break-system-packageslib/core/deps.js:88

    agent 工具路径默认开启该行为(lib/index.js:`autoInstallDeps: config.autoInstallDeps !== false`),因此对扫描件 PDF 的一次 md_convert 调用就会在无用户确认的情况下对宿主解释器执行 pip。在 Debian/Ubuntu 系统 Python 上,错误分支会用 `--break-system-packages`(deps.js:97)重试,刻意绕过发行版包管理保护,并安装未固定版本的最新 paddlepaddle/paddleocr/paddlex[ocr]/pypdfium2/rapidocr/onnxruntime。暴露给模型的工具描述未说明会安装依赖;探测失败时(deps.js:65-68)还会保守地安装全部包。这并非任意代码执行(包名为固定映射),但确实是对宿主环境的未告知修改。

  • lowmd_convert 可向调用方指定的任意目录写文件lib/index.js:96

    outDir 直接取自工具参数并用 path.resolve 解析,因此绝对路径可绕过工作区(文档注释却声称输出留在“工作区内”)。由于覆盖默认开启(convert.js DEFAULT_OPTS.overwrite = true),派生出的 `<源文件名>.md` 可覆盖宿主进程有权限写入的任意位置的同名 .md 文件。影响有限:文件名由输入 basename 派生且必以 .md 结尾,且 agent 通常本就有文件写入工具。

未发现命令注入或数据外泄;残留风险是静默自动 pip 安装(含 --break-system-packages)以及 md_convert 工具可由调用方指定任意输出目录。

口径：动态审计只会把风险往严重里判，不会把风险降下来（只升不降，不构成豁免）；模型判错时由人工复核撤回，撤回后回到静态判定。合并判定 = 两层中更严的那一个。

免责声明：静态扫描与动态安全审计都是自动化分析，不构成安全保证。安装前请自行审查。

活跃度

最近提交 2026-10-04 · 活跃度：活跃

• 仓库创建: 2026-08-28

• 星标: ★ 2 · 复刻: 0

• 健康度: 活跃 — 近 30 天有提交

来源

GitHub: github.com/yakoylp/dsh-md-convert

这页有帮助吗？