dsh-plc-decode 0.2.2 → 0.2.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +154 -112
  2. package/package.json +2 -2
package/README.md CHANGED
@@ -2,143 +2,185 @@
2
2
 
3
3
  <img src="assets/icon-180.png" width="96" align="right" alt="dsh-plc-decode">
4
4
 
5
- **涓枃** | [English](README.en.md)
5
+ **中文** | [English](README.en.md)
6
6
 
7
- 鍦?[DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)锛圖SH锛夐噷鐩存帴璇?PLC 宸ョ▼鏂囦欢锛氭寜鏂囦欢澶磋嚜鍔ㄨ瘑鍒牸寮忥紝鎶婂伐绋嬭В鎴愬彲璇绘姤鍛婁笌缁撴瀯鍖栨暟鎹紝鍐嶅熀浜庤В鐮佺粨鏋滃仛鏂版棫瀵规瘮銆佸湴鍧€浣撴銆佸厓绱犵骇璇?鍐欏垽瀹氫笌杩炵嚎杩樺師銆傚悓涓€鎻掍欢琛岄噷涔熸壙鎺ヨЕ鎽稿睆锛圚MI锛夊伐绋嬶細鐢婚潰銆佹帶浠躲€佸彉閲忎笌鍦板潃锛涘▉绾堕€?EasyBuilder Pro 宸ョ▼璇诲悓宸ョ▼鐨勭紪璇戜骇鐗╋紝瑙e嚭鐢婚潰銆佹枃瀛楀璞°€佹姤璀︿簨浠朵笌鏂囧瓧搴撴潯鐩€?
8
- **鍙**锛氳В鏋愬伐绋嬫枃浠讹紝涓嶆敼鍔ㄥ師鏂囦欢銆?
9
- ## 鏀寔鐨勫伐绋嬫枃浠?
10
- | 鏂囦欢澶?| 鏍煎紡 | 瑙g爜鏂瑰紡 |
7
+ 在 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)(DSH)里直接读 PLC 工程文件:按文件头自动识别格式,把工程解成可读报告与结构化数据,再基于解码结果做新旧对比、地址体检、元素级读/写判定与连线还原。同一插件行里也承接触摸屏(HMI)工程:画面、控件、变量与地址;威纶通 EasyBuilder Pro 读该工程的编译产物,解出画面、文字对象、报警事件与文字库。
8
+
9
+ **只读**:解析工程文件,不改动原文件。
10
+
11
+ ## 支持的工程文件
12
+
13
+ | 文件头 | 格式 | 解码方式 |
11
14
  |---|---|---|
12
- | `50 4B 03 04`锛圸IP锛?| CoDeSys V3.5 / LeadSysStudio `.project`锛堝惈闆疯禌锛?| 鑷甫 Python 鑴氭湰锛氳В鍖?鈫?瀛楃涓茶〃 鈫?閫愬璞℃仮澶?POU ST 婧愮爜 |
13
- | `57 01 01 00` | 鍙拌揪 WPLSoft / ISPSoft `.dvp` | 鑷甫 Python 鑴氭湰锛氭枃浠剁粨鏋?/ 娈佃惤娉ㄩ噴 / 璁惧娉ㄩ噴 / 鎸囦护琛ㄥ弽姹囩紪 |
14
- | `53 48 33 00`锛圫H3锛?| 瑗块棬瀛?S7-200 SMART `.smart` 宸ョ▼ | 鍐呭祵 Node 瑙g爜鍣細鍧?/ 鎸囦护璁板綍 / 鎿嶄綔鏁?/ 鐢ㄦ埛涓庣郴缁熺鍙疯〃 |
15
- | `44 45 4D 00`锛圖EM锛?| 瑗块棬瀛?S7-200 SMART `.smartlib` 搴?| 鍐呭祵 Node 瑙g爜鍣細搴撳彉閲忎笌娉ㄩ噴娴?|
16
-
17
- > 闆疯禌锛圠eadshine锛夌敤 LeadSysStudio 淇濆瓨鐨?`.project` 涓?CoDeSys 鍚屾牸寮忥紝璧板悓涓€鏉¤В鐮侀摼锛歋T 婧愮爜瀵煎嚭鍒?`pous/<POU>.txt`锛屽彲鐢?`/codesys-check` 鍋氱瓑浠风紪璇戞牎楠岋紙缁撴瀯浣撴垚鍛樸€佹暟缁勪笅鏍囥€佽皟鐢ㄥ瓨鍦ㄦ€с€佸湴鍧€鍞竴銆佹湭澹版槑绗﹀彿锛夈€?
18
- ### 瑙︽懜灞忥紙HMI锛夊伐绋?
19
- | 鏂囦欢 | 鍝佺墝 | 瑙e嚭 |
15
+ | `50 4B 03 04`(ZIP) | CoDeSys V3.5 / LeadSysStudio `.project`(含雷赛) | 自带 Python 脚本:解包 → 字符串表 → 逐对象恢复 POU ST 源码 |
16
+ | `57 01 01 00` | 台达 WPLSoft / ISPSoft `.dvp` | 自带 Python 脚本:文件结构 / 段落注释 / 设备注释 / 指令表反汇编 |
17
+ | `53 48 33 00`(SH3) | 西门子 S7-200 SMART `.smart` 工程 | 内嵌 Node 解码器:块 / 指令记录 / 操作数 / 用户与系统符号表 |
18
+ | `44 45 4D 00`(DEM) | 西门子 S7-200 SMART `.smartlib` 库 | 内嵌 Node 解码器:库变量与注释流 |
19
+
20
+ > 雷赛(Leadshine)用 LeadSysStudio 保存的 `.project` 与 CoDeSys 同格式,走同一条解码链:ST 源码导出到 `pous/<POU>.txt`,可用 `/codesys-check` 做等价编译校验(结构体成员、数组下标、调用存在性、地址唯一、未声明符号)。
21
+
22
+ ### 触摸屏(HMI)工程
23
+
24
+ | 文件 | 品牌 | 解出 |
20
25
  |---|---|---|
21
- | `.hmismart` | 瑗块棬瀛?WinCC flexible SMART锛圫mart Line 灞忥級 | 鐢婚潰 / 鍏冧欢 / 鏂囨湰 / 璁惧琛紱鏃佺郴 `{{GUID}}.data` 閲岃В鍙橀噺鍚嶃€佹帶浠跺悕銆佺粦瀹氬€欓€夈€佺被鍨嬭〃 |
22
- | `.fsprj` 鎴栧惈 `HMI\Frame` 鐨勭洰褰?| 绻佹槗 FStudio / Flexem | 鐢婚潰 / 鎺т欢 / 鎺т欢鍦板潃锛堣 `HMI\System\fs2.s3db` 涓?`Bin\fshmi.bin`锛?|
23
- | `.nbp` | 娆у榫?NB-Designer | 鐢婚潰 / 鎺т欢 / 鍦板潃锛圶ML 鐩磋锛?|
24
- | `.mcp` / `.mcgs` | 鏄嗕粦閫氭€?MCGS / LSTP Studio | 鐢婚潰 / 鍙橀噺 / 鎶ヨ / 绛栫暐锛圓ccess 搴擄級 |
25
- | `.emtp` / `.exob` | 濞佺憾閫?EasyBuilder Pro | 鐢婚潰 / 鏂囧瓧瀵硅薄 / 鎶ヨ浜嬩欢 / 鏂囧瓧搴擄紙`.emtp` 鏈綋鍔犲瘑璇讳笉鍔紝璇诲悓宸ョ▼缂栬瘧浜х墿 `.exob`锛?|
26
-
27
- ## 瀹夎
28
-
29
- 鍓嶆彁锛?
30
- - DSH 妗岄潰绔紙鎻掍欢杩愯鍦?DSH 鍐咃紝Node 鐗堟湰璺熼殢 DSH锛夛紱
31
- - 瑙g爜 `.project` / `.dvp` 闇€瑕?Python 3.9+ 鍦?`PATH` 閲岋紙鍙敤鏍囧噯搴擄紝鏃犻渶 pip 瀹夎锛夛紱
32
- - 瑙g爜 `.smart` / `.smartlib` 涓嶉渶瑕?Python銆?- 瑕佹眰 DSH >= 0.2.1-alpha.3锛涘疄娴?0.2.1-alpha.3銆?.2.2-rc.1锛屾洿楂樼増鏈湭楠岃瘉銆?
33
- 浠?GitHub 瀹夎锛?
26
+ | `.hmismart` | 西门子 WinCC flexible SMART(Smart Line 屏) | 画面 / 元件 / 文本 / 设备表;旁系 `{{GUID}}.data` 里解变量名、控件名、绑定候选、类型表 |
27
+ | `.fsprj` 或含 `HMI\Frame` 的目录 | 繁易 FStudio / Flexem | 画面 / 控件 / 控件地址(读 `HMI\System\fs2.s3db` 与 `Bin\fshmi.bin`) |
28
+ | `.nbp` | 欧姆龙 NB-Designer | 画面 / 控件 / 地址(XML 直读) |
29
+ | `.mcp` / `.mcgs` | 昆仑通态 MCGS / LSTP Studio | 画面 / 变量 / 报警 / 策略(Access 库) |
30
+ | `.emtp` / `.exob` | 威纶通 EasyBuilder Pro | 画面 / 文字对象 / 报警事件 / 文字库(`.emtp` 本体加密,读同工程的编译产物 `.exob`) |
31
+
32
+ ## 安装
33
+
34
+ 前提:
35
+
36
+ - DSH 桌面端(插件运行在 DSH 内,Node 版本跟随 DSH);
37
+ - 解码 `.project` / `.dvp` 需要 Python 3.9+ 在 `PATH` 里(只用标准库,无需 pip 安装);
38
+ - 解码 `.smart` / `.smartlib` 不需要 Python;
39
+ - 要求 DSH >= 0.2.1-alpha.3;实测 0.2.1-alpha.3、0.2.2-rc.1,更高版本未验证。
40
+
41
+ 从 GitHub 安装:
42
+
34
43
  ```sh
35
44
  dsh plugin --profile web add github:taoziliyouchong/dsh-plc-decode
36
45
  ```
37
46
 
38
- 瑁呭畬閲嶅惎 DSH銆傛湰鎻掍欢娌℃湁 npm 杩愯鏃朵緷璧栥€?
39
- ## 浣跨敤
47
+ 装完重启 DSH。本插件没有 npm 运行时依赖。
48
+
49
+ ## 使用
40
50
 
41
- ### 宸ュ叿锛堟ā鍨嬭嚜鍔ㄨ皟鐢級
51
+ ### 工具(模型自动调用)
42
52
 
43
- | 宸ュ叿 | 鐢ㄩ€?|
53
+ | 工具 | 用途 |
44
54
  |---|---|
45
- | `plc-decode` | 缁熶竴鍏ュ彛锛氭寜鏂囦欢澶磋瘑鍒洓鏍煎紡骞跺垎鍙戣В鐮侊紝鍙傛暟 `file` + 鍙€?`outDir` |
46
- | `smart-pou-structure` | 鏌愬瓙绋嬪簭鐨勫唴閮ㄧ粨鏋勶細鎺ュ彛鍙傛暟锛圠 鍖哄湴鍧€ + 绫诲瀷锛夈€佺洅绾ф寚浠ら摼銆佽皟鐢ㄧ偣瀹炲弬 |
47
- | `smart-lad` | 杩炵嚎杩樺師锛氭寜鍧椼€佹寜缃戠粶鎵撳嵃 LAD 鎸囦护搴忓垪锛圠D/A/O/AN/ON銆丒U/ED銆丩PS/LRD/LPP銆佺嚎鍦堛€佹瘮杈冦€佹寚浠ょ洅鍗犱綅锛?|
48
- | `smart-ladder-elements` | 鍏冪礌绾ц/鍐欏垽瀹氾細鏌愬湴鍧€锛堝彲涓€鎵癸級鐨勬瘡涓惤鐐规槸瑙︾偣锛堣锛夎繕鏄啓 |
49
- | `smart-net-trace` | 缃戠粶绾ц建杩癸細缁欏亸绉诲尯闂达紝鎸夐『搴忓垪鍑鸿Е鐐?/ 鍐欏厓浠?/ 鎸囦护鐩?/ 甯告暟 |
50
- | `smart-box-pins` | 鐩掔骇寮曡剼琛細搴撹皟鐢ㄧ洅锛圡BUS_CTRL銆丮BUS_MSG銆乀ON銆丆TU銆丮OV_* 绛夛級鐨勩€屽紩鑴氬悕 = 瀹炲弬銆?|
51
- | `smart-pin-dump` | 瀛楄妭绾у畾浣嶏細鏌愬湴鍧€鐨勫叏閮ㄥ嚭鐜颁綅缃紝鎴栨煇鍋忕Щ鍖洪棿鍐呯殑鎿嶄綔鏁拌褰?|
52
- | `smart-var-usage` | 鍙橀噺浣跨敤浣撴锛氭煇鍦板潃鐨勫叏閮ㄥ紩鐢ㄧ偣銆佸叡鐢ㄥ瓧鑺傜殑鍏跺畠鍦板潃褰㈠紡銆佸啓鍏ョ偣鍒ゅ畾 |
53
- | `smart-free-space` | 鍦板潃鍗犵敤涓庣┖闂叉锛氬姞鍔熻兘鍓嶉€夋柊鍦板潃锛堟湁绗﹀彿鍚嶇殑銆侀鐣欏潙閮戒笉鍔級 |
54
- | `smart-conflict` | 鍦板潃鍐茬獊浣撴锛氶噸鍙犲啿绐侊紙鐪熷啿绐?/ 鐤戜技 / 浠呯櫥璁帮級+ 杩炵画绌洪棿琚垏纰?|
55
- | `smart-diff-project` | SMART 鏂版棫宸ョ▼瀵规瘮锛氬潡娓呭崟銆佷富绋嬪簭璋冪敤閾俱€両-O 寮曠敤銆佺鍙疯〃宸紓 |
56
- | `codesys-diff-project` | CoDeSys 鏂版棫宸ョ▼瀵规瘮锛歅OU 娓呭崟銆佺湡瀹為€昏緫鍙樺寲鍖烘銆佺┖鐧藉樊寮傘€佸瓧绗︿覆琛ㄣ€佸璞¤〃 |
57
- | `hmi-decode` | 瑙︽懜灞忕粺涓€鍏ュ彛锛氭寜鏂囦欢璇嗗埆 `.hmismart` / `.fsprj` / `.nbp` / `.mcp` / `.emtp` / `.exob` 骞跺鐞?|
58
- | `hmi-diff-project` | 鏂版棫 `.hmismart` 瀵规瘮锛氳捣濮嬬敾闈€佺敾闈㈣〃銆佺敾闈㈠悕銆侀厤濂楁枃浠?|
59
- | `ebpro-decode` | 濞佺憾閫?EBpro锛氳缂栬瘧浜х墿 `.exob` 瑙g爜鐢婚潰 / 鏂囧瓧瀵硅薄 / 鎶ヨ浜嬩欢 / 鏂囧瓧搴擄紙鍑?HMI瑙g爜鎶ュ憡.md 涓?4 寮?tsv锛?|
60
- | `ladder-auto` | 鑷姩鐢绘褰㈠浘锛氱洿鎺ヨ `.smart`锛屾寜鍧?缃戠粶鐢熸垚鐩掑紡鏂囧瓧姊舰鍥撅紙鍙寚瀹?`block` / `net`锛?|
61
- | `ladder-dvp` | 鍙拌揪 `.dvp` 鐩存帴鍑虹洅寮忔枃瀛楁褰㈠浘锛堝彲鎸夎鍙疯寖鍥达級 |
62
- | `ladder-from-stl` | 璇彞琛紙STL锛夆啋 鏂囧瓧姊舰鍥?+ 鏈烘璁茶В |
63
- | `ladder-render` | 鎶婄綉缁滄弿杩帮紙spec锛夋覆鏌撴垚鍥哄畾鐗堝紡鐨勬枃瀛楁褰㈠浘 |
64
-
65
- ### 鏂滄潬鍛戒护锛堜汉鐩存帴鎵ц锛?
66
- | 鍛戒护 | 鐢ㄩ€?|
55
+ | `plc-decode` | 统一入口:按文件头识别四格式并分发解码,参数 `file` + 可选 `outDir` |
56
+ | `smart-pou-structure` | 某子程序的内部结构:接口参数(L 区地址 + 类型)、盒级指令链、调用点实参 |
57
+ | `smart-lad` | 连线还原:按块、按网络打印 LAD 指令序列(LD/A/O/AN/ON、EU/ED、LPS/LRD/LPP、线圈、比较、指令盒占位) |
58
+ | `smart-ladder-elements` | 元素级读/写判定:某地址(可一批)的每个落点是触点(读)还是写 |
59
+ | `smart-net-trace` | 网络级轨迹:给偏移区间,按顺序列出触点 / 写元件 / 指令盒 / 常数 |
60
+ | `smart-box-pins` | 盒级引脚表:库调用盒(MBUS_CTRL、MBUS_MSG、TON、CTU、MOV_* 等)的「引脚名 = 实参」 |
61
+ | `smart-pin-dump` | 字节级定位:某地址的全部出现位置,或某偏移区间内的操作数记录 |
62
+ | `smart-var-usage` | 变量使用体检:某地址的全部引用点、共用字节的其它地址形式、写入点判定 |
63
+ | `smart-free-space` | 地址占用与空闲段:加功能前选新地址(有符号名的、预留坑都不动) |
64
+ | `smart-conflict` | 地址冲突体检:重叠冲突(真冲突 / 疑似 / 仅登记)+ 连续空间被切碎 |
65
+ | `smart-diff-project` | SMART 新旧工程对比:块清单、主程序调用链、I-O 引用、符号表差异 |
66
+ | `codesys-diff-project` | CoDeSys 新旧工程对比:POU 清单、真实逻辑变化区段、空白差异、字符串表、对象表 |
67
+ | `hmi-decode` | 触摸屏统一入口:按文件识别 `.hmismart` / `.fsprj` / `.nbp` / `.mcp` / `.emtp` / `.exob` 并解码 |
68
+ | `hmi-diff-project` | 新旧 `.hmismart` 对比:起始画面、画面表、画面名、配套文件 |
69
+ | `ebpro-decode` | 威纶通 EasyBuilder Pro:从编译产物 `.exob` 解画面 / 文字对象 / 报警事件 / 文字库 |
70
+ | `ladder-auto` | 自动出梯形图:直接读 `.smart` 工程,按块(可单网络)生成盒式文字梯形图(`block`、`net`) |
71
+ | `ladder-dvp` | 台达 `.dvp` 工程 → 文字梯形图,可只出某几行 |
72
+ | `ladder-from-stl` | 语句表(STL)→ 文字梯形图 + 每个网络的机械讲解 |
73
+ | `ladder-render` | 把网络描述(spec JSON)渲染成固定版式的文字梯形图 |
74
+
75
+ ### 斜杠命令(人直接执行)
76
+
77
+ | 命令 | 用途 |
67
78
  |---|---|
68
- | `/plc-decode <鏂囦欢> [杈撳嚭鐩綍]` | 缁熶竴瑙g爜鍏ュ彛 |
69
- | `/plc-archive` | 鏌ョ湅褰撳墠鐢熸晥鐨勮В鐮佸綊妗f牴鐩綍銆侀粯璁よ惤鐐逛笌鏀归厤缃殑鏂规硶 |
70
- | `/codesys-read <宸ョ▼>` | 瑙g爜 `.project`锛圫T 婧愮爜 + 鎶ュ憡锛夋垨 `.dvp`锛堣В鐮佹姤鍛婏級 |
71
- | `/dvp-read <宸ョ▼>` | 鍙拌揪 DVP 缁撴瀯涓庢寚浠よ〃鎶ュ憡 |
72
- | `/smart-read <.smart/.smartlib> [杈撳嚭鐩綍]` | SMART 宸ョ▼ / 搴撹В鐮?|
73
- | `/codesys-check <宸ョ▼>` | 瑙g爜 `.project` 鍚庡仛绛変环缂栬瘧闈欐€佹牎楠岋紙缁撴瀯浣?/ 璋冪敤 / 鍦板潃鍞竴 / 鏈0鏄庣鍙凤級 |
74
- | `/codesys-diff <鏃? <鏂?` | CoDeSys 鏂版棫瀵规瘮 |
75
- | `/smart-diff <鏃? <鏂?` | SMART 鏂版棫瀵规瘮 |
76
- | `/smart-free-space <.smart>` | 鍦板潃鍗犵敤涓庣┖闂叉 |
77
- | `/smart-conflict <.smart>` | 鍦板潃鍐茬獊浣撴 |
78
- | `/smart-ladder <.smart> [鍦板潃]` | 鍏冪礌绾ц/鍐欏垽瀹?|
79
- | `/smart-lad <.smart> [鍧楀悕] [缃戠粶鍙穄` | 杩炵嚎杩樺師锛圠AD 鎸囦护搴忓垪锛?|
80
- | `/hmi-decode <.hmismart / .fsprj / .nbp / .mcp / .emtp / .exob> [杈撳嚭鐩綍]` | 瑙︽懜灞忓伐绋嬭В鐮?|
81
- | `/hmi-diff <鏃?.hmismart> <鏂?.hmismart>` | 瑙︽懜灞忔柊鏃у姣?|
82
- | `/ladder on\|off\|status` | 姊舰鍥惧姛鑳藉紑鍏筹紙榛樿鍏抽棴锛屽紑鍚悗绔嬪嵆鐢熸晥锛?|
83
- | `/ladder-auto <.smart> [鍧楀悕] [缃戠粶鍙穄 [杈撳嚭.txt]` | `.smart` 鑷姩鍑烘褰㈠浘 |
84
- | `/ladder-dvp <.dvp> [璧疯] [姝㈣] [杈撳嚭.txt]` | `.dvp` 鑷姩鍑烘褰㈠浘 |
85
- | `/ladder-stl <璇彞琛?txt> [杈撳嚭.txt]` | 璇彞琛ㄦ垚鍥?+ 璁茶В |
86
- | `/ladder-spec <spec.json> [杈撳嚭.txt]` | 鎸?spec 娓叉煋鏂囧瓧姊舰鍥?|
87
- | `/plc-calibrate <鏍煎紡> <瀛楄妭鎴?cmd:XX> <鍚嶅瓧> [澶囨敞]` | 鎶婅В涓嶅嚭鐨勫瓧鑺?鍔熻兘鐮佽杩涙牎鍑嗚〃锛涗互鍚庡悓鏍峰瓧鑺傜洿鎺ュ嚭鍚嶅瓧 |
88
-
89
- ## 杈撳嚭浣嶇疆
90
-
91
- 榛樿鍐欏埌**宸ヤ綔鍖?*鐨?`瑙g爜褰掓。/<宸ョ▼鎵€鍦ㄦ枃浠跺す鍚?/`锛堢敤鏂囦欢澶瑰悕鑰屼笉鏄伐绋嬫枃浠跺悕锛岄伩鍏嶄笉鍚屾枃浠跺す閲岀殑鍚屽悕宸ョ▼浜掔浉瑕嗙洊锛涘悓涓€鏂囦欢澶归噷鏈夊涓伐绋嬫枃浠舵椂鐢?`鏂囦欢澶瑰悕_宸ョ▼鍚峘锛夈€備篃鍙互鍦ㄥ伐鍏峰弬鏁伴噷鐢?`outDir` 鎸囧畾銆?
92
- | 鏍煎紡 | 涓昏浜х墿 |
79
+ | `/plc-decode <文件> [输出目录]` | 统一解码入口 |
80
+ | `/plc-archive` | 查看当前生效的解码归档根目录、默认落点与改配置的方法 |
81
+ | `/codesys-read <工程>` | 解码 `.project`(ST 源码 + 报告)或 `.dvp`(解码报告) |
82
+ | `/dvp-read <工程>` | 台达 DVP 结构与指令表报告 |
83
+ | `/smart-read <.smart/.smartlib> [输出目录]` | SMART 工程 / 库解码 |
84
+ | `/codesys-check <工程>` | 解码 `.project` 后做等价编译静态校验(结构体 / 调用 / 地址唯一 / 未声明符号) |
85
+ | `/codesys-diff <旧> <新>` | CoDeSys 新旧对比 |
86
+ | `/smart-diff <旧> <新>` | SMART 新旧对比 |
87
+ | `/smart-free-space <.smart>` | 地址占用与空闲段 |
88
+ | `/smart-conflict <.smart>` | 地址冲突体检 |
89
+ | `/smart-ladder <.smart> [地址]` | 元素级读/写判定 |
90
+ | `/smart-lad <.smart> [块名] [网络号]` | 连线还原(LAD 指令序列) |
91
+ | `/hmi-decode <.hmismart / .fsprj / .nbp / .mcp / .emtp / .exob> [输出目录]` | 触摸屏工程解码 |
92
+ | `/hmi-diff <旧 .hmismart> <新 .hmismart>` | 触摸屏新旧对比 |
93
+ | `/ladder on\|off\|status` | 梯形图开关(默认关闭,立即生效) |
94
+ | `/ladder-auto <.smart> [块名] [网络号] [out.txt]` | 出 `.smart` 的梯形图 |
95
+ | `/ladder-dvp <.dvp> [起行] [止行] [out.txt]` | 出 `.dvp` 的梯形图 |
96
+ | `/ladder-stl <stl.txt> [out.txt]` | 语句表 → 梯形图 + 讲解 |
97
+ | `/ladder-spec <spec.json> [out.txt]` | 渲染 spec JSON |
98
+ | `/plc-calibrate <格式> <字节或 cmd:XX> <名字> [备注]` | 把解不出的字节 / 功能码记进校准表,之后解码直接用这个名字 |
99
+
100
+ ## 输出位置
101
+
102
+ 默认写到**工作区**的 `解码归档/<工程所在文件夹名>/`(用文件夹名而不是工程文件名,避免不同文件夹里的同名工程互相覆盖;同一文件夹里有多个工程文件时用 `文件夹名_工程名`)。也可以在工具参数里用 `outDir` 指定。
103
+
104
+ | 格式 | 主要产物 |
93
105
  |---|---|
94
- | `.project` | `00-绱㈠紩.md`锛堝厛璇昏繖浠斤級銆乣pous/<POU>.txt`锛圫T 婧愮爜锛夈€乣宸ョ▼鍐呭鎶ュ憡.md`銆乣鍏ㄩ儴瀛楃涓?txt`銆乣瀵硅薄琛?md`銆乣椤圭洰鏍?md` |
95
- | `.dvp` | `00-绱㈠紩.md`銆乣瑙g爜鎶ュ憡.md`锛堢粨鏋?/ 娈佃惤娉ㄩ噴 / 璁惧娉ㄩ噴 / 鎸囦护琛級銆佸彲閫?`绋嬪簭瑙h.md` |
96
- | `.smart` / `.smartlib` | `00-鐩綍.md`锛堝厛璇昏繖浠斤級銆乣瑙g爜鎶ュ憡.md`銆乣绋嬪簭.lad`銆乣鍏冪礌璁板綍.tsv`銆乣绗﹀彿鍦板潃.tsv`銆乣鍒嗘瀽.md`銆乣璁板綍.json`銆乣瀛楃涓插叏褰?txt` |
97
- | `.hmismart` | `10-鐢婚潰.tsv`銆乣11-鍏冧欢.tsv`銆乣12-鏂囨湰.tsv`銆乣13-璁惧.tsv`銆乣20-鍙橀噺.data.tsv`銆乣21-鎺т欢.data.tsv`銆乣23-鎺т欢缁戝畾.data.tsv`銆乣24-绫诲瀷琛?tsv` |
98
- | `.fsprj` | `鐢婚潰.tsv`銆乣鎺т欢.tsv`銆乣鎺т欢鍦板潃.tsv`銆乣鍙橀噺.tsv` |
99
- | `.nbp` / `.mcp` | `瑙g爜鎶ュ憡.md` + 鐢婚潰/鎺т欢锛堟垨鍙橀噺/鎶ヨ/绛栫暐锛塉SON |
100
- | `.emtp` / `.exob` | `HMI瑙g爜/HMI瑙g爜鎶ュ憡.md` + `00-鏍煎紡璇存槑.md` / `10-鐢婚潰.tsv` / `11-鏂囧瓧瀵硅薄.tsv` / `12-鎶ヨ浜嬩欢.tsv` / `13-鏂囧瓧搴?tsv` / `08-缁熻.json` |
106
+ | `.project` | `00-索引.md`(先读这份)、`pous/<POU>.txt`(ST 源码)、`工程内容报告.md`、`全部字符串.txt`、`对象表.md`、`项目树.md` |
107
+ | `.dvp` | `00-索引.md`、`解码报告.md`(结构 / 段落注释 / 设备注释 / 指令表)、可选 `程序解读.md` |
108
+ | `.smart` / `.smartlib` | `00-目录.md`(先读这份)、`解码报告.md`、`程序.lad`、`元素记录.tsv`、`符号地址.tsv`、`分析.md`、`记录.json`、`字符串全录.txt` |
109
+ | `.hmismart` | `10-画面.tsv`、`11-元件.tsv`、`12-文本.tsv`、`13-设备.tsv`、`20-变量.data.tsv`、`21-控件.data.tsv`、`23-控件绑定.data.tsv`、`24-类型表.tsv` |
110
+ | `.fsprj` | `画面.tsv`、`控件.tsv`、`控件地址.tsv`、`变量.tsv` |
111
+ | `.nbp` / `.mcp` | `解码报告.md` + 画面/控件(或变量/报警/策略)JSON |
112
+ | `.emtp` / `.exob` | `HMI解码/HMI解码报告.md` + `00-格式说明.md`、`10-画面.tsv`、`11-文字对象.tsv`、`12-报警事件.tsv`、`13-文字库.tsv`、`08-统计.json` |
113
+
114
+ ### 梯形图(默认关闭)
115
+
116
+ 梯形图工具默认关着,免得一次普通解码就多出一组工具:
117
+
118
+ - 打开:`/ladder on`(立即生效,不用重启);关闭:`/ladder off`;看状态:`/ladder status`
119
+ - 或者在 profile 的 `cordis.patch.yml` 里给本插件那一行写 `config: { ladder: true }` 作初始状态
120
+ - 关着时梯形图工具只回一行开启提示;解码照常
121
+ - 前三次解码会在结果末尾提示「可以看梯形图」(1/3、2/3、3/3),之后不再提示;开关状态与计数存在 `$DSH_HOME/ladder-state.json`
101
122
 
102
- ### 姊舰鍥撅紙榛樿鍏抽棴锛?
103
- 姊舰鍥惧伐鍏烽粯璁や笉寮€鍚紝閬垮厤姣忔瑙g爜閮藉涓€鎵瑰伐鍏蜂笌鎻愮ず锛?
104
- - 寮€锛歚/ladder on`锛堢珛鍗崇敓鏁堬紝涓嶇敤閲嶅惎锛夛紱鍏筹細`/ladder off`锛涚湅鐘舵€侊細`/ladder status`
105
- - 涔熷彲浠ュ湪 profile 鐨?`cordis.patch.yml` 閲岀粰鏈彃浠惰鍐?`config: { ladder: true }` 浣滀负鍒濆鐘舵€?- 鍏抽棴鏃惰皟鐢ㄦ褰㈠浘宸ュ叿鍙洖涓€琛屽紑鍚彁绀猴紱瑙g爜浜х墿鐓у父
106
- - 鍓嶄笁娆¤В鐮佷細鍦ㄧ粨鏋滄湯灏炬彁绀恒€岃繖涓伐绋嬪彲浠ュ嚭姊舰鍥俱€嶏紙绗?1/3銆?/3銆?/3 娆★級锛屼箣鍚庝笉鍐嶆彁绀猴紱寮€鍏充笌鎻愮ず璁℃暟璁板湪 `$DSH_HOME/ladder-state.json`
123
+ ### 改归档地址(不用改代码)
107
124
 
108
- ### 鏀瑰綊妗e湴鍧€锛堜笉鐢ㄦ敼浠g爜锛?
109
- 鍦?DSH profile 鐨?`cordis.patch.yml`锛坄$DSH_HOME/profiles/<profile>/cordis.patch.yml`锛夋湯灏剧粰鏈彃浠堕偅涓€琛屽姞 config锛堝彧鍐?`archiveDir`锛氬綊妗f牴鐩綍锛夛細
125
+ 在 DSH profile 的 `cordis.patch.yml`(`$DSH_HOME/profiles/<profile>/cordis.patch.yml`)末尾给本插件那一行加 config(只写 `archiveDir`:归档根目录):
110
126
 
127
+ `archiveDir` 是归档**根目录**:相对路径按当前会话工作区解析,绝对路径原样使用;默认 `解码归档`。改完重启 dsh 生效,`/plc-archive` 可随时查看当前生效值;只想改一次就在解码时传 `outDir`。
111
128
 
112
- `archiveDir` 鏄綊妗?*鏍圭洰褰?*锛氱浉瀵硅矾寰勬寜褰撳墠浼氳瘽宸ヤ綔鍖鸿В鏋愶紝缁濆璺緞鍘熸牱浣跨敤锛涢粯璁?`瑙g爜褰掓。`銆傛敼瀹岄噸鍚?dsh 鐢熸晥锛宍/plc-archive` 鍙殢鏃舵煡鐪嬪綋鍓嶇敓鏁堝€硷紱鍙兂鏀逛竴娆″氨鍦ㄨВ鐮佹椂浼?`outDir`銆?
113
- `.smart` 鐨?`璁板綍.json` 鍚屾椂鏄悇鍒嗘瀽宸ュ叿锛堝湴鍧€鍗犵敤銆佸彉閲忎娇鐢ㄧ瓑锛夌殑杈撳叆锛屼篃鏄瘑鍒€屽凡瑙g爜鐩綍銆嶇殑鍑嵁锛涜В鐮佹姤鍛婂ご閮ㄥ甫**婧愭枃浠舵寚绾?*锛堟枃浠跺ぇ灏?+ 淇敼鏃堕棿锛夛紝宸ョ▼鎹㈢増鏈悗鍏堟牳瀵规寚绾瑰啀鐢ㄦ棫鎶ュ憡銆?
114
- ## 宸茬煡杈圭晫
129
+ `.smart` 的 `记录.json` 同时是各分析工具(地址占用、变量使用等)的输入,也是识别「已解码目录」的凭据;解码报告头部带**源文件指纹**(文件大小 + 修改时间),工程换版本后先核对指纹再用旧报告。
115
130
 
116
- - 瑙︽懜灞忓伐绋嬶細`.hmismart` 閲屽彧鏈夋ā鏉块鏋讹紝鐪熷疄鐢婚潰涓庢帶浠跺湪鏃佺郴 `{{GUID}}.data`锛圗S2RT 搴忓垪鍖栨祦锛夛紝鍙橀噺鍚嶄笌鎺т欢鍚嶈兘瑙o紝鎺т欢鍒板彉閲忕殑寮曠敤鍙В鍑哄悓娈靛叡鐜颁笌 UUID 鍛戒腑閭i儴鍒嗭紝鍏朵綑鏍囥€屾湭瑙e嚭銆嶏紱绻佹槗宸ョ▼鑻ユ病寤哄彉閲忥紝鎺т欢鍦板潃鍙湪 `Bin\fshmi.bin` 鐨勫姩浣滆〃閲岋紱鏄嗕粦閫氭€佸伐绋嬮渶鏈満鏈?`.mcp` 鏍锋湰鎵嶈兘楠岃瘉銆?- 濞佺憾閫?EasyBuilder Pro锛歚.emtp` 鏈綋鍘嬬缉+鍔犲瘑锛岃涓嶅嚭缁撴瀯锛屽彧鑳藉彇鍚屽伐绋嬬紪璇戜骇鐗?`.exob`锛涜〃鍙嶆槧**缂栬瘧閭d竴鍒?*鐨勫伐绋嬶紙宸ョ▼鏀硅繃娌¢噸鏂扮紪璇戝氨鍏堢紪璇戝啀璺戯級銆傜紪璇戜骇鐗╅噷鍙湁婧愯瑷€銆佹病鏈夎瘧鏂囥€傜敾闈㈠綊灞炴寜瀵硅薄娴佸垎娈垫帹瀹氾紝琛ㄩ噷鐨?x/y/w/h 鏄瓧涓插妗嗗害閲忎笉鏄敾闈㈠潗鏍囥€?- 搴撳潡璋冪敤鍖猴紙濡?MBUS_MSG 鐨?Slave / RW / Addr / Count / DataPtr锛夌殑寮曡剼绾у疄鍙傝В涓嶅嚭锛屽伐鍏蜂細鏄庣‘璇存槑锛屼笉鐚溿€?- 鍔犲瘑鎴栫壒娈婂帇缂╃殑宸ョ▼鍙兘瑙d笉鍑猴紱瑙g爜鍣ㄤ細鎶ラ敊鑰屼笉鏄粰鍑哄崐鐪熺粨鏋溿€?- `.smart` 鐨勪覆/骞惰仈鎷撴墤鐢辨寚浠よ褰曡繕鍘燂紝宸茬敤瀹樻柟瀵煎嚭鐨?STL 閫愮綉缁滃洖褰掗獙璇侊紱搴撹皟鐢ㄥ尯锛堟棤鏍囧噯鐩掑ご锛変笉鍦ㄨ鐩栬寖鍥村唴銆?- 鎸囦护鍚嶅甫 `?`锛堝 `?DRVI`锛夋槸鎺ㄦ柇鍚嶏紝鎶ュ憡鏈熬鏈夋帹鏂鐓ц〃锛沗??xx` 鏄湭瀹氬悕锛屼繚鎸佸師鏍枫€?
117
- ## 寮€鍙戜笌鑷
131
+ ## 已知边界
132
+
133
+ - 触摸屏工程:`.hmismart` 里只有模板骨架,真实画面与控件在旁系 `{{GUID}}.data`(ES2RT 序列化流),变量名与控件名能解,控件到变量的引用只解出同段共现与 UUID 命中那部分,其余标「未解出」;繁易工程若没建变量,控件地址只在 `Bin\fshmi.bin` 的动作表里;昆仑通态工程需本机有 `.mcp` 样本才能验证。
134
+ - 威纶通 EasyBuilder Pro:`.emtp` 本体压缩加密,只能读同工程的编译产物 `.exob`,表里反映的是**编译当时**的工程(工程改过要先重新编译);编译产物只带源语言,没有译文。画面归属由对象流分段推定,表里的 x/y/w/h 是文字框度量,不是画面坐标。
135
+ - 库块调用区(如 MBUS_MSG 的 Slave / RW / Addr / Count / DataPtr)的引脚级实参解不出,工具会明确说明,不猜。
136
+ - 加密或特殊压缩的工程可能解不出;解码器会报错而不是给出半真结果。
137
+ - `.smart` 的串/并联拓扑由指令记录还原,已用官方导出的 STL 逐网络回归验证;库调用区(无标准盒头)不在覆盖范围内。
138
+ - 指令名带 `?`(如 `?DRVI`)是推断名,报告末尾有推断对照表;`??xx` 是未定名,保持原样。
139
+
140
+ ## 开发与自检
118
141
 
119
142
  ```sh
120
- npm run check # 璇硶妫€鏌?npm run smoke # 瑁呰浇鎻掍欢 + 鏍稿娉ㄥ唽闈紙宸ュ叿 19 涓?/ 鍛戒护 20 涓級
121
- npm run smoke -- <宸ョ▼鏂囦欢> # 棰濆瀵逛竴涓湡瀹炲伐绋嬭窇绔埌绔В鐮侊紝鏍稿浜х墿钀界洏
122
- npm pack --dry-run # 鐪嬪寘閲屽唴瀹癸紙node_modules銆乸ublish/ 涓嶅簲杩涘寘锛?```
143
+ npm run check # 语法检查
144
+ npm run smoke # 装载插件 + 核对注册面(工具 19 个 / 命令 20 个)
145
+ npm run smoke -- <工程文件> # 额外对一个真实工程跑端到端解码,核对产物落盘
146
+ npm pack --dry-run # 看包里内容(node_modules、publish/ 不应进包)
147
+ ```
123
148
 
124
- ## 鐩綍缁撴瀯
149
+ ## 目录结构
125
150
 
126
151
  ```
127
- index.js 鎻掍欢鍏ュ彛锛氬伐鍏蜂笌鍛戒护娉ㄥ唽銆佸洓鏍煎紡鍒嗗彂銆丼MART 瑙g爜鍣?hmi.js 瑙︽懜灞忚В鐮佹ā鍧楋紙宸ュ叿/鍛戒护/鎶€鑳芥敞鍐岋紝鐢?index.js 璋冪敤锛?ladder.js 姊舰鍥炬覆鏌?鑷姩鎴愬浘妯″潡锛堥粯璁ゅ叧闂紝/ladder on 鎵撳紑锛岀敱 index.js 璋冪敤锛?assets/decode-pack.mjs 瑙g爜浜х墿钀界洏锛堢储寮?鐩綍/琛ㄦ牸/璁板綍锛?assets/smart-lad.mjs 杩炵嚎杩樺師鑴氭湰锛堢敱 smart-lad 宸ュ叿璋冪敤锛?assets/smart-net-trace.mjs 缃戠粶杞ㄨ抗鑴氭湰锛堢敱 smart-net-trace 宸ュ叿璋冪敤锛?assets/codesys-tools/ CoDeSys / DVP 瑙g爜 Python 鑴氭湰锛堝彧鐢ㄦ爣鍑嗗簱锛?assets/hmismart-decode.mjs 瑗块棬瀛?.hmismart 瑙g爜鍣紙缁撴瀯琛?+ .data 鍚嶅瓧/缁戝畾/绫诲瀷琛級
128
- assets/hmismart-report.mjs .hmismart 浜鸿鎶ュ憡锛堢敾闈?鍙橀噺/杩炴帴/鍏冧欢鍒嗙被锛?assets/hmismart-diff.mjs .hmismart 鏂版棫瀵规瘮
129
- assets/fstudio-tables.py 绻佹槗鐢婚潰 / 鎺т欢 / 鎺т欢鍦板潃琛?assets/fstudio_i18n.py 绻佹槗鍏冧欢鏂囨湰鎵弿锛堟寜璇鍒嗘Ы锛?assets/hmi-decode-workflow.md 瑙︽懜灞忚鍙栧伐浣滄祦锛堟妧鑳芥鏂囷級
130
- assets/ladder-workflow.md 梯形图技能(排版规范、自动成图、交付前自检)
131
- assets/nb-decode.mjs 娆у榫?NB-Designer 瑙g爜鍣?assets/mcgs-decode.mjs 鏄嗕粦閫氭€?MCGS / LSTP 瑙g爜鍣?assets/ebpro-decode.mjs 濞佺憾閫?EBpro 瑙g爜锛堣 .exob锛氱敾闈?/ 鏂囧瓧瀵硅薄 / 鎶ヨ浜嬩欢 / 鏂囧瓧搴擄級
132
- assets/ladder-render.mjs 鏂囧瓧姊舰鍥炬覆鏌撳櫒锛堝浐瀹氱増寮忥紝鐢?ladder-render 璋冪敤锛?assets/stl-to-ladder.mjs 璇彞琛ㄨ浆姊舰鍥撅紙鐢?ladder-from-stl 璋冪敤锛?assets/smart-ladder-auto.mjs .smart 鑷姩鎴愬浘锛堢敱 ladder-auto 璋冪敤锛?assets/dvp-ladder.mjs .dvp 鑷姩鎴愬浘锛堢敱 ladder-dvp 璋冪敤锛?scripts/smoke.mjs 鍐掔儫娴嬭瘯
152
+ index.js 插件入口:工具与命令注册、四格式分发、SMART 解码器
153
+ hmi.js 触摸屏解码模块(工具/命令/技能注册,由 index.js 调用)
154
+ ladder.js 梯形图模块(默认关闭,/ladder on;由 index.js 调用)
155
+ assets/decode-pack.mjs 解码产物落盘(索引/目录/表格/记录)
156
+ assets/smart-lad.mjs 连线还原脚本(由 smart-lad 工具调用)
157
+ assets/smart-net-trace.mjs 网络轨迹脚本(由 smart-net-trace 工具调用)
158
+ assets/codesys-tools/ CoDeSys / DVP 解码 Python 脚本(只用标准库)
159
+ assets/hmismart-decode.mjs 西门子 .hmismart 解码器(结构表 + .data 名字/绑定/类型表)
160
+ assets/hmismart-report.mjs .hmismart 可读报告(画面/变量/连接)
161
+ assets/hmismart-diff.mjs .hmismart 新旧对比
162
+ assets/fstudio-tables.py 繁易画面 / 控件 / 控件地址表
163
+ assets/fstudio_i18n.py 繁易元件文本扫描(按语种槽)
164
+ assets/hmi-decode-workflow.md 触摸屏解读流程(技能正文)
165
+ assets/nb-decode.mjs 欧姆龙 NB-Designer 解码器
166
+ assets/mcgs-decode.mjs 昆仑通态 MCGS / LSTP 解码器
167
+ assets/ebpro-decode.mjs 威纶通 EasyBuilder Pro 解码器(读 .exob)
168
+ assets/ladder-render.mjs 文字梯形图渲染器(由 ladder-render 调用)
169
+ assets/stl-to-ladder.mjs STL → 梯形图(由 ladder-from-stl 调用)
170
+ assets/smart-ladder-auto.mjs .smart 自动出图(由 ladder-auto 调用)
171
+ assets/dvp-ladder.mjs .dvp 自动出图(由 ladder-dvp 调用)
172
+ scripts/smoke.mjs 冒烟测试
133
173
  ```
134
174
 
135
- ## 鍙嶉
175
+ ## 反馈
176
+
177
+ 插件有问题,按这个顺序:
178
+
179
+ 1. 开 Issue:https://github.com/taoziliyouchong/dsh-plc-decode/issues —— 能留痕、能搜历史,别人也可能已经遇过;
180
+ 2. 急着问或不想开 Issue,QQ 号:**2171960697**(加好友请注明装的是哪个插件)。
136
181
 
137
- 鎻掍欢鏈夐棶棰橈紝鎸夎繖涓『搴忥細
182
+ 反馈时带上:DSH 版本、插件版本、报错原文、截图。少一样多半要再问一轮。
138
183
 
139
- 1. 寮€ Issue锛歨ttps://github.com/taoziliyouchong/dsh-plc-decode/issues 鈥斺€?鑳界暀鐥曘€佽兘鎼滃巻鍙诧紝鍒汉涔熷彲鑳藉凡缁忛亣杩囷紱
140
- 2. 鎬ョ潃闂垨涓嶆兂寮€ Issue锛孮Q 鍙凤細**2171960697**锛堝姞濂藉弸璇锋敞鏄庤鐨勬槸鍝釜鎻掍欢锛夈€?
141
- 鍙嶉鏃跺甫涓婏細DSH 鐗堟湰銆佹彃浠剁増鏈€佹姤閿欏師鏂囥€佹埅鍥俱€傚皯涓€鏍峰鍗婅鍐嶉棶涓€杞€?
142
- ## 璁稿彲
184
+ ## 许可
143
185
 
144
186
  MIT
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "dsh-plc-decode",
3
- "version": "0.2.2",
3
+ "version": "0.2.3",
4
4
  "description": "在 DSH 里读工控工程文件:PLC(CoDeSys、台达、西门子 SMART)与触摸屏(西门子 WinCC flexible SMART、繁易 FStudio、欧姆龙 NB、昆仑通态 MCGS、威纶通 EasyBuilder Pro)里的程序、画面、控件、变量与地址,读成能查的报告与表。",
5
5
  "type": "module",
6
6
  "main": "index.js",
@@ -21,7 +21,7 @@
21
21
  ],
22
22
  "engines": {
23
23
  "node": "^22.19.0 || >=24.0.0",
24
- "dsh": ">=0.2.1-0"
24
+ "dsh": ">=0.2.1-alpha.3"
25
25
  },
26
26
  "dsh": {
27
27
  "bundle": {