dsh-plc-decode

DSH PLUGIN开发与运行时

仓库 taoziliyouchong/dsh-plc-decode · npm dsh-plc-decode

开发与运行时 L5 · 运行验证通过 安全审查:低风险 可信度:金 可安装插件
安装这个插件

在 DeepSeek Harness 中直接解码 CoDeSys、台达 DVP 与西门子 S7-200 SMART 工程文件,输出可读报告与结构化数据,并支持新旧对比、地址体检与连线还原。

一句话选型结论

按资料字段整理

dsh-plc-decode 是开发与运行时类的 DSH 可安装插件,验证等级 L5 · 运行验证通过,安全审查为低风险,列出 5 项功能,有可直接复制的安装命令。验证通过不等于安全:插件会读写文件、执行命令或联网,装前先到仓库确认它做了什么;涉及密钥或系统权限的,建议先在隔离环境试装。

分类开发与运行时 收录类型可安装插件 验证等级L5 · 运行验证通过 安全审查低风险
验证等级 L5 L5 · 运行验证通过
GitHub 星标 5 复刻 0 · 未关闭 issue 0
最近更新 2026-11-09 创建于 2026-11-01
README 13.9 KB 正文体量,越大说明说明书写得越细

安装

可安装插件
在 DSH 里执行,装完用 dsh plugin list 确认已挂上;标了 L4 / L5 的命令已在沙盒里真实跑通
dsh plugin --profile web add github:taoziliyouchong/dsh-plc-decode
  1. 1
    确认版本与运行环境

    兼容的 DSH 版本为 0.2.2-rc.1 等 2 个,Node.js 要求 ^22.19.0 || >=24.0.0;版本不匹配时安装会报错。

  2. 2
    执行安装命令

    在 DSH 里执行上面的命令;多包仓库要注意区分具体子包名,别装错包。

  3. 3
    确认已挂载

    用 dsh plugin list 查看列表里是否出现这个插件,出现即挂载成功。

  4. 4
    试跑并检查权限

    加载后跑一个最小用例,确认它能正常工作;同时看它申请了哪些文件、命令或网络权限。

兼容 DSH 版本0.2.2-rc.1、0.2.1-rc.5版本不匹配时安装会报错
Node.js 要求^22.19.0 || >=24.0.0来自仓库 package.json 的 engines 字段
前置依赖无需要同时安装的同级依赖
npm 包名dsh-plc-decode可用 npm view 查看包信息

能做什么

5 项功能
字段来自项目仓库与公开索引,中文说明由本站标注

dsh-plc-decode:让 DeepSeek Harness 直接读懂工业 PLC 工程文件

  • 按文件头自动识别四种工程格式
  • 导出 ST 源码与解码报告
  • 新旧工程差异对比
  • 地址冲突与空闲段体检
  • LAD 连线还原与读写判定

适用场景

文件读写代码评审

上游标签

dsh-plugin

验证等级与安全审查

L5 · 运行验证通过
自动化流程结论,不是人工审核
验证等级L5 · 运行验证通过在 dsh 沙盒中完成安装与运行冒烟——装得上、跑得起来
安全审查低风险静态分析结论,未标注不代表已通过审查
仓库健康度活跃按仓库活跃度与最近更新时间给出
可信度金综合仓库活跃度与验证结果

上面的结论来自上游最近一次自动化验证(2026-11-10): 同一套检查会在插件发新版后重跑,页面显示的是最新一次的逐项结果。

逐项检查结果

L1 · 已找到 ✓ 通过
  • L1.0_DEFAULTED_FROM_L3 由 L3 推定 默认通过——L3 安装规范已通过(全库 L3 扫描策略)
L2 · 结构化 ✓ 通过
  • L2.0_DEFAULTED_FROM_L3 由 L3 推定 默认通过——L3 安装规范已通过(全库 L3 扫描策略)
L3 · 安装规范 ✓ 通过
  • L3.1_INSTALL_COMMAND_PARSED 安装命令已解析 方式:安装规范解析
  • L3.2_DSH_VERSION_DECLARED DSH 版本已声明 方式:DSH 版本声明
L4 · 安装已测 ✓ 通过
  • L4.1_INSTALL_EXECUTED_CONFINED 受限沙盒内执行安装 方式:沙盒安装执行
  • L4.2_INSTALL_SUCCESS 沙盒安装成功 方式:沙盒安装执行
  • L4.3_ARTIFACT_CONFIRMED 安装产物已确认 方式:沙盒安装执行
L5 · 运行已测 ✓ 通过
  • L5.1_INSTALL_PASSED_SANDBOXED 沙盒安装通过 方式:沙盒安装执行
  • L5.2_WEB_BOOT_READY Web 启动就绪 方式:Web 启动
  • L5.3_HTTP_SERVED HTTP 服务响应 方式:HTTP 请求
  • L5.4_PLUGIN_INVENTORY_ACTIVE 插件清单中已激活 方式:插件清单查询

风险详情

  • 结论说明 静态扫描 低;动态审计无结论(以下以静态为准)→ 总评级 低。
  • 风险计数 严重 0 / 高 0

选择建议

装之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 验证等级 L5:安装和运行都在沙盒里跑通过,装完能直接用的概率高。
  • 静态安全审查为低风险,没有发现明显可疑行为。
  • 有可直接复制的安装命令,不用自己翻文档找入口。
  • 标注了兼容的 DSH 版本(0.2.2-rc.1 等 2 个),按版本装不容易报错。
  • 列出了 5 项功能,能直接看出它解决什么问题。

先想清楚的地方

  • 验证通过不等于安全:插件会读写文件、执行命令或联网,装前先到仓库确认它做了什么。

更适合

  • 需要在开发与运行时场景里给 DSH 补能力的人。
  • 想装完就能用、不想自己排依赖的人。
  • 能接受在本地装依赖、愿意自己确认权限的人。

不太适合

  • 只使用 DSH 官方内置能力、不接受第三方插件的人。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
插件验证等级安全审查星标兼容版本安装命令
dsh-plc-decode当前 L5 · 运行验证通过 低风险 5 0.2.2-rc.1 等 2 个 有
deepseek-harness L3 · 安装规范通过 低风险 24.6 万 未标注 无
rea L4 · 沙盒安装通过 低风险 2.6 万 0.1.1-rc.2 有
dsh-TUI L4 · 沙盒安装通过 中风险 4,292 0.1.7-rc.2 等 5 个 有
mirage L3 · 安装规范通过 低风险 3,681 未标注 无
dashi-taskboard L4 · 沙盒安装通过 低风险 3,311 0.1.1-rc.2 有

仓库档案

开发与运行时
字段来自项目仓库与公开索引,中文说明由本站标注
作者 / 维护方taoziliyouchong仓库 dsh-plc-decode · 默认分支 main
分类开发与运行时dev
收录类型可安装插件声明了 dsh.bundle、可用 dsh plugin add 安装的条目
开发语言JavaScript仓库主语言
许可证MIT商用或二次分发前请确认条款原文
星标 / 复刻 / issue5 / 0 / 0收录时的数值,非实时
创建 / 更新2026-11-01 · 2026-11-09最后推送 2026-11-12
本站收录2026-11-02首次进入本站目录的时间

README 全文

13.9 KB
作者原文,中文版优先;只做安全转义,不改内容

dsh-plc-decode

中文 | English

在 DeepSeek Harness(DSH)里直接读 PLC 工程文件:按文件头自动识别格式,把工程解成可读报告与结构化数据,再基于解码结果做新旧对比、地址体检、元素级读/写判定与连线还原。同一插件行里也承接触摸屏(HMI)工程:画面、控件、变量与地址;威纶通 EasyBuilder Pro 读该工程的编译产物,解出画面、文字对象、报警事件与文字库。

只读:解析工程文件,不改动原文件。

支持的工程文件

文件头 格式 解码方式
50 4B 03 04(ZIP) CoDeSys V3.5 / LeadSysStudio .project(含雷赛) 自带 Python 脚本:解包 → 字符串表 → 逐对象恢复 POU ST 源码
57 01 01 00 台达 WPLSoft / ISPSoft .dvp 自带 Python 脚本:文件结构 / 段落注释 / 设备注释 / 指令表反汇编
53 48 33 00(SH3) 西门子 S7-200 SMART .smart 工程 内嵌 Node 解码器:块 / 指令记录 / 操作数 / 用户与系统符号表
44 45 4D 00(DEM) 西门子 S7-200 SMART .smartlib 库 内嵌 Node 解码器:库变量与注释流

> 雷赛(Leadshine)用 LeadSysStudio 保存的 .project 与 CoDeSys 同格式,走同一条解码链:ST 源码导出到 pous/.txt,可用 /codesys-check 做等价编译校验(结构体成员、数组下标、调用存在性、地址唯一、未声明符号)。

触摸屏(HMI)工程

文件 品牌 解出
.hmismart 西门子 WinCC flexible SMART(Smart Line 屏) 数据库直读:画面 / 元件 / 文本(带画面归属)/ 变量;本机没有 LocalDB 时退回二进制扫描,只出对象名与无归属文本;旁系 {{GUID}}.data 可补变量名、控件名、绑定候选、类型表
.fsprj 或含 HMI\Frame 的目录 繁易 FStudio / Flexem 画面 / 控件 / 控件地址(读 HMI\System\fs2.s3db 与 Bin\fshmi.bin)
.nbp 欧姆龙 NB-Designer 画面 / 控件 / 地址(XML 直读)
.mcp / .mcgs 昆仑通态 MCGS / LSTP Studio 画面 / 变量 / 报警 / 策略(Access 库)
.emtp / .exob 威纶通 EasyBuilder Pro 画面 / 文字对象 / 报警事件 / 文字库(.emtp 本体加密,读同工程的编译产物 .exob)

安装

前提:

  • DSH 桌面端(插件运行在 DSH 内,Node 版本跟随 DSH);
  • 解码 .project / .dvp 需要 Python 3.9+ 在 PATH 里(只用标准库,无需 pip 安装);
  • 解码 .smart / .smartlib 不需要 Python;
  • .hmismart 数据库直读需要本机有 SQL Server LocalDB(WinCC flexible SMART 自带 WINCCFLEX2022 实例,没有时试 MSSQLLocalDB;都没有就退回二进制扫描);
  • 生成「画面|文本」Excel 需要 Python 的 openpyxl;
  • 要求 DSH >= 0.2.1-alpha.1(下限按用到的服务与槽在 alpha.1 已存在推定);实测 0.2.1-alpha.3、0.2.2-rc.1,更高版本未验证。

从 GitHub 安装:

dsh plugin --profile web add github:taoziliyouchong/dsh-plc-decode

装完重启 DSH。本插件没有 npm 运行时依赖。

使用

工具(模型自动调用)

工具 用途
plc-decode 统一入口:按文件头识别四格式并分发解码,参数 file + 可选 outDir
smart-pou-structure 某子程序的内部结构:接口参数(L 区地址 + 类型)、盒级指令链、调用点实参
smart-lad 连线还原:按块、按网络打印 LAD 指令序列(LD/A/O/AN/ON、EU/ED、LPS/LRD/LPP、线圈、比较、指令盒占位)
smart-ladder-elements 元素级读/写判定:某地址(可一批)的每个落点是触点(读)还是写
smart-net-trace 网络级轨迹:给偏移区间,按顺序列出触点 / 写元件 / 指令盒 / 常数
smart-box-pins 盒级引脚表:库调用盒(MBUS_CTRL、MBUS_MSG、TON、CTU、MOV_* 等)的「引脚名 = 实参」
smart-pin-dump 字节级定位:某地址的全部出现位置,或某偏移区间内的操作数记录
smart-var-usage 变量使用体检:某地址的全部引用点、共用字节的其它地址形式、写入点判定
smart-free-space 地址占用与空闲段:加功能前选新地址(有符号名的、预留坑都不动)
smart-conflict 地址冲突体检:重叠冲突(真冲突 / 疑似 / 仅登记)+ 连续空间被切碎
smart-diff-project SMART 新旧工程对比:块清单、主程序调用链、I-O 引用、符号表差异
codesys-diff-project CoDeSys 新旧工程对比:POU 清单、真实逻辑变化区段、空白差异、字符串表、对象表
hmi-decode 触摸屏统一入口:按文件识别 .hmismart / .fsprj / .nbp / .mcp / .emtp / .exob 并解码(.hmismart 走数据库直读)
hmi-diff-project 新旧 .hmismart 对比:起始画面、画面表、画面名、配套文件
ebpro-decode 威纶通 EasyBuilder Pro:从编译产物 .exob 解画面 / 文字对象 / 报警事件 / 文字库
ladder-auto 自动出梯形图:直接读 .smart 工程,按块(可单网络)生成盒式文字梯形图(block、net)
ladder-dvp 台达 .dvp 工程 → 文字梯形图,可只出某几行
ladder-from-stl 语句表(STL)→ 文字梯形图 + 每个网络的机械讲解
ladder-render 把网络描述(spec JSON)渲染成固定版式的文字梯形图

斜杠命令(人直接执行)

命令 用途
/plc-decode <文件> [输出目录] 统一解码入口
/plc-archive 查看当前生效的解码归档根目录、默认落点与改配置的方法
/codesys-read <工程> 解码 .project(ST 源码 + 报告)或 .dvp(解码报告)
/dvp-read <工程> 台达 DVP 结构与指令表报告
/smart-read <.smart/.smartlib> [输出目录] SMART 工程 / 库解码
/codesys-check <工程> 解码 .project 后做等价编译静态校验(结构体 / 调用 / 地址唯一 / 未声明符号)
/codesys-diff <旧> <新> CoDeSys 新旧对比
/smart-diff <旧> <新> SMART 新旧对比
/smart-free-space <.smart> 地址占用与空闲段
/smart-conflict <.smart> 地址冲突体检
/smart-ladder <.smart> [地址] 元素级读/写判定
/smart-lad <.smart> [块名] [网络号] 连线还原(LAD 指令序列)
/hmi-decode <.hmismart / .fsprj / .nbp / .mcp / .emtp / .exob> [输出目录] 触摸屏工程解码
/hmi-diff <旧 .hmismart> <新 .hmismart> 触摸屏新旧对比
/ladder on\|off\|status 梯形图开关(默认关闭,立即生效)
/ladder-auto <.smart> [块名] [网络号] [out.txt] 出 .smart 的梯形图
/ladder-dvp <.dvp> [起行] [止行] [out.txt] 出 .dvp 的梯形图
/ladder-stl [out.txt] 语句表 → 梯形图 + 讲解
/ladder-spec [out.txt] 渲染 spec JSON
/plc-calibrate <格式> <字节或 cmd:XX> <名字> [备注] 把解不出的字节 / 功能码记进校准表,之后解码直接用这个名字

输出位置

默认写到工作区的 解码归档/<工程所在文件夹名>/(用文件夹名而不是工程文件名,避免不同文件夹里的同名工程互相覆盖;同一文件夹里有多个工程文件时用 文件夹名_工程名)。也可以在工具参数里用 outDir 指定。

格式 主要产物
.project 00-索引.md(先读这份)、pous/.txt(ST 源码)、工程内容报告.md、全部字符串.txt、对象表.md、项目树.md
.dvp 00-索引.md、解码报告.md(结构 / 段落注释 / 设备注释 / 指令表)、可选 程序解读.md
.smart / .smartlib 00-目录.md(先读这份)、解码报告.md、程序.lad、元素记录.tsv、符号地址.tsv、分析.md、记录.json、字符串全录.txt
.hmismart HMI解码报告.md、00-格式说明.md、10-画面.tsv、11-元件.tsv、12-文本.tsv、13-变量.tsv、14-对象类型.tsv、15-屏上文本.tsv;无 LocalDB 时退回二进制扫描产物
.fsprj 画面.tsv、控件.tsv、控件地址.tsv、变量.tsv
.nbp / .mcp 解码报告.md + 画面/控件(或变量/报警/策略)JSON
.emtp / .exob HMI解码/HMI解码报告.md + 00-格式说明.md、10-画面.tsv、11-文字对象.tsv、12-报警事件.tsv、13-文字库.tsv、08-统计.json

梯形图(默认关闭)

梯形图工具默认关着,免得一次普通解码就多出一组工具:

  • 打开:/ladder on(立即生效,不用重启);关闭:/ladder off;看状态:/ladder status
  • 或者在 profile 的 cordis.patch.yml 里给本插件那一行写 config: { ladder: true } 作初始状态
  • 关着时梯形图工具只回一行开启提示;解码照常
  • 前三次解码会在结果末尾提示「可以看梯形图」(1/3、2/3、3/3),之后不再提示;开关状态与计数存在 $DSH_HOME/ladder-state.json

改归档地址(不用改代码)

在 DSH profile 的 cordis.patch.yml($DSH_HOME/profiles//cordis.patch.yml)末尾给本插件那一行加 config(只写 archiveDir:归档根目录):

archiveDir 是归档根目录:相对路径按当前会话工作区解析,绝对路径原样使用;默认 解码归档。改完重启 dsh 生效,/plc-archive 可随时查看当前生效值;只想改一次就在解码时传 outDir。

.smart 的 记录.json 同时是各分析工具(地址占用、变量使用等)的输入,也是识别「已解码目录」的凭据;解码报告头部带源文件指纹(文件大小 + 修改时间),工程换版本后先核对指纹再用旧报告。

已知边界

  • 触摸屏工程:.hmismart 是 SQL Server 数据库文件,画面 / 元件 / 文本的归属链从表里 join 出来;本机没有 LocalDB 时退回二进制扫描,只能出对象名与无归属文本,拿不到画面归属。旁系 {{GUID}}.data(ES2RT 序列化流)仍可补变量名、控件名与绑定候选。繁易工程若没建变量,控件地址只在 Bin\fshmi.bin 的动作表里;昆仑通态工程需本机有 .mcp 样本才能验证。
  • 威纶通 EasyBuilder Pro:.emtp 本体压缩加密,只能读同工程的编译产物 .exob,表里反映的是编译当时的工程(工程改过要先重新编译);编译产物只带源语言,没有译文。画面归属由对象流分段推定,表里的 x/y/w/h 是文字框度量,不是画面坐标。
  • 库块调用区(如 MBUS_MSG 的 Slave / RW / Addr / Count / DataPtr)的引脚级实参解不出,工具会明确说明,不猜。
  • 加密或特殊压缩的工程可能解不出;解码器会报错而不是给出半真结果。
  • .smart 的串/并联拓扑由指令记录还原,已用官方导出的 STL 逐网络回归验证;库调用区(无标准盒头)不在覆盖范围内。
  • 指令名带 ?(如 ?DRVI)是推断名,报告末尾有推断对照表;??xx 是未定名,保持原样。

开发与自检

npm run check                 # 语法检查
npm run smoke                 # 装载插件 + 核对注册面(工具 19 个 / 命令 20 个)
npm run smoke -- <工程文件>    # 额外对一个真实工程跑端到端解码,核对产物落盘
npm pack --dry-run            # 看包里内容(node_modules、publish/ 不应进包)

目录结构

index.js                    插件入口:工具与命令注册、四格式分发、SMART 解码器
hmi.js                      触摸屏解码模块(工具/命令/技能注册,由 index.js 调用)
ladder.js                   梯形图模块(默认关闭,/ladder on;由 index.js 调用)
assets/decode-pack.mjs      解码产物落盘(索引/目录/表格/记录)
assets/smart-lad.mjs        连线还原脚本(由 smart-lad 工具调用)
assets/smart-net-trace.mjs  网络轨迹脚本(由 smart-net-trace 工具调用)
assets/codesys-tools/       CoDeSys / DVP 解码 Python 脚本(只用标准库)
assets/hmismart-db.mjs      .hmismart 数据库直读(附加 LocalDB 查表,出画面/元件/文本/变量)
assets/hmismart-db.ps1      上一条的 PowerShell 半部(复制 + 附加 + 导出 TSV)
assets/hmismart-decode.mjs  .hmismart 二进制扫描兜底(结构表 + .data 名字/绑定/类型表)
assets/hmismart-report.mjs  .hmismart 可读报告(画面/变量/连接)
assets/hmismart-screen-xlsx.py  「画面|文本」两列 Excel(读 12-文本.tsv)
assets/hmi-auto-decode.mjs  触摸屏工程批量入口:判类型 → 调对应解码器 → 出屏幕文本.xlsx
assets/hmismart-diff.mjs    .hmismart 新旧对比
assets/fstudio-tables.py    繁易画面 / 控件 / 控件地址表
assets/hmi-decode-workflow.md  触摸屏解读流程(技能正文)
assets/nb-decode.mjs        欧姆龙 NB-Designer 解码器
assets/mcgs-decode.mjs      昆仑通态 MCGS / LSTP 解码器
assets/ebpro-decode.mjs     威纶通 EasyBuilder Pro 解码器(读 .exob)
assets/ladder-render.mjs    文字梯形图渲染器(由 ladder-render 调用)
assets/stl-to-ladder.mjs    STL → 梯形图(由 ladder-from-stl 调用)
assets/smart-ladder-auto.mjs .smart 自动出图(由 ladder-auto 调用)
assets/dvp-ladder.mjs       .dvp 自动出图(由 ladder-dvp 调用)
scripts/smoke.mjs           冒烟测试

反馈

插件有问题,按这个顺序:

  1. 开 Issue:https://github.com/taoziliyouchong/dsh-plc-decode/issues —— 能留痕、能搜历史,别人也可能已经遇过;
  2. 急着问或不想开 Issue,QQ 号:2171960697(加好友请注明装的是哪个插件)。

反馈时带上:DSH 版本、插件版本、报错原文、截图。少一样多半要再问一轮。

许可

MIT

常见问题

9 问
答案由本站依据条目字段整理,不引用上游原文
dsh-plc-decode 怎么安装?

在 DSH 里执行 `dsh plugin --profile web add github:taoziliyouchong/dsh-plc-decode` 即可。对应的 npm 包名是 `dsh-plc-decode`。

dsh-plc-decode 的验证等级是什么意思?

L5 · 运行验证通过。在 dsh 沙盒中完成安装与运行冒烟——装得上、跑得起来

dsh-plc-decode 安全吗?

低风险。静态扫描 低;动态审计无结论(以下以静态为准)→ 总评级 低。

dsh-plc-decode 装之前要先确认什么?

先看它会读写哪些文件、执行哪些命令、连接哪些网络地址;验证等级只说明装得上、跑得起来,不等于安全。涉及密钥或系统权限的,建议先在隔离环境试装。

dsh-plc-decode 支持哪些 DSH 版本?

上游记录的兼容版本包括 0.2.2-rc.1、0.2.1-rc.5。

dsh-plc-decode 需要什么运行环境?

Node.js ^22.19.0 || >=24.0.0。环境不满足时安装会失败,建议先确认本机版本。

dsh-plc-decode 用的是什么许可证?

上游标注为 MIT。商用或二次分发前请到仓库确认许可证原文。

dsh-plc-decode 有哪些功能?

按文件头自动识别四种工程格式、导出 ST 源码与解码报告、新旧工程差异对比、地址冲突与空闲段体检、LAD 连线还原与读写判定。

这条记录的数据可靠吗?

本站按仓库名去重后合并整理,字段以作者仓库与 npm 元数据为准;安装命令、仓库地址与 README 保持原文,带 L4 / L5 标记的安装命令已在隔离沙盒里真实跑通。

开发与运行时
按星标排序,可作替代方案

rea

rea

L4 · 沙盒安装通过 2.6 万 星

dsh-TUI

dsh-TUI

Claude Code 风格全屏终端 UI:像素鲸鱼顶栏、实时工作状态行、思考流式展开。

L4 · 沙盒安装通过 4,292 星

mirage

mirage

把文件系统与 bash 提供者换成 mirage 虚拟工作区:文件工具与 shell 命令作用于挂载的资源(RAM、S3、Redis、Sla

L3 · 安装规范通过 3,681 星

dashi-taskboard

dashi-taskboard

把当前已安装并运行中的 Codex Taskboard 嵌入 DeepSeek Harness 侧边栏,并通过 Launcher 运行时描述

L4 · 沙盒安装通过 3,311 星

taoziliyouchong 的其它插件

6 个

插件的元信息来自作者仓库;分类、验证等级与安全结论的中文说明为中文整理,最近核验 2026-11-10。