dsh-plc-decode 0.2.0 → 0.2.1

package/README.en.md

@@ -24,7 +24,7 @@ Prerequisites:
 - DSH desktop app (the plugin runs inside DSH; Node version follows DSH);
 - Python 3.9+ on `PATH` for `.project` / `.dvp` (standard library only, no `pip install`);
 - Python is not needed for `.smart` / `.smartlib`.
-- Compatible with the DSH 0.2.1 line (alpha / rc / stable); 0.3 and later are not guaranteed.
+- Requires DSH >= 0.2.1-alpha.3; verified on 0.2.1-alpha.3 and 0.2.2-rc.1, later versions untested.
 
 ```sh
 dsh plugin --profile web add github:taoziliyouchong/dsh-plc-decode

package/README.md

@@ -35,7 +35,7 @@
 - DSH 桌面端（插件运行在 DSH 内，Node 版本跟随 DSH）；
 - 解码 `.project` / `.dvp` 需要 Python 3.9+ 在 `PATH` 里（只用标准库，无需 pip 安装）；
 - 解码 `.smart` / `.smartlib` 不需要 Python。
-- 兼容 DSH 0.2.1 系列（alpha / rc / 正式版均可）；0.3 起不保证。
+- 兼容 DSH 0.2.1-alpha.3 ～ 0.2.2-rc.1（本机实际运行验证过的最高版本）；更高版本未验证。
 
 从 GitHub 安装：
 
@@ -105,14 +105,8 @@ dsh plugin --profile web add github:taoziliyouchong/dsh-plc-decode
 
 ### 改归档地址（不用改代码）
 
-在 DSH profile 的 `cordis.patch.yml`（`$DSH_HOME/profiles/<profile>/cordis.patch.yml`）末尾加这几行：
+在 DSH profile 的 `cordis.patch.yml`（`$DSH_HOME/profiles/<profile>/cordis.patch.yml`）末尾给本插件那一行加 config（只写 `archiveDir`：归档根目录）：
 
-```yaml
-- id: dsh-plc-decode
-  name: dsh-plc-decode
-  config:
-    archiveDir: D:/plc/解码归档
-```
 
 `archiveDir` 是归档**根目录**：相对路径按当前会话工作区解析，绝对路径原样使用；默认 `解码归档`。改完重启 dsh 生效，`/plc-archive` 可随时查看当前生效值；只想改一次就在解码时传 `outDir`。
 

package/assets/{zzuser-fstudio-i18n-workflow.md → fstudio-i18n-workflow.md}

@@ -18,7 +18,7 @@ FStudio 里画面文字的显示有**两条路**：
 ## 正确工作流（三步，别多）
 
 ### 第 1 步 · 扫（一次扫全，别一页页看）
-插件工具 `zzuser-fstudio-i18n`（或 `zzuser-fstudio-scan-texts` 只看清单）。
+插件工具 `fstudio-i18n`（或 `fstudio-scan-texts` 只看清单）。
 
 - 扫什么：`HMI\Frame\**\*.wcfg` 里**所有**带语种文字的元件，两条路都要收：
   ① 静态文本：`StaticTextContentInfo` 的 `LanguageSN` + `LabelContent`；
@@ -89,7 +89,7 @@ FStudio 里画面文字的显示有**两条路**：
 
 
 ### 第 3 步 · 出导入表（格式由代码保证）
-`zzuser-fstudio-i18n` 直接产出 `文本库导入表.xlsx`，列名与软件导出逐字符一致：
+`fstudio-i18n` 直接产出 `文本库导入表.xlsx`，列名与软件导出逐字符一致：
 
 ```
 Guid | Name | Status | 1-Chinese (Simplified, PRC)-2052 | 2-English (United States)-1033
@@ -107,7 +107,7 @@ Guid | Name | Status | 1-Chinese (Simplified, PRC)-2052 | 2-English (United Stat
 
 ```
 python <插件>/assets/fstudio_i18n.py retag <导出的TextLib表.xls> <输出.xlsx> <词典.json> pt 2
-# 或工具/命令：zzuser-fstudio-retag <源表> <词典.json> [输出.xlsx] [语种键] [最少状态数]
+# 或工具/命令：fstudio-retag <源表> <词典.json> [输出.xlsx] [语种键] [最少状态数]
 #                                                        ↑ 写 2 = 状态不够的条目补到 2 状态
 ```
 
@@ -162,4 +162,4 @@ LONG_PT = {}
 {"en": {"启动1": "Start 1"}, "pt": {"启动1": "Partida 1"}}
 ```
 
-再用 `zzuser-fstudio-i18n` / `zzuser-fstudio-retag` 的 `dict` 参数传入。
+再用 `fstudio-i18n` / `fstudio-retag` 的 `dict` 参数传入。

package/assets/{zzuser-hmi-decode-workflow.md → hmi-decode-workflow.md}

@@ -1,15 +1,15 @@
-# zzuser-hmi-decode-workflow —— 触摸屏工程读取工作流
+# hmi-decode-workflow —— 触摸屏工程读取工作流
 
-触摸屏（HMI）工程走**本入口**，与 PLC 分开：PLC 工程（`.project` / `.dvp` / `.smart` / `.smartlib`）用 `zzuser-plc-decode`，屏工程用 `zzuser-hmi-decode`。
+触摸屏（HMI）工程走**本入口**，与 PLC 分开：PLC 工程（`.project` / `.dvp` / `.smart` / `.smartlib`）用 `plc-decode`，屏工程用 `hmi-decode`。
 
 ## 一、先认类型（别拿错工具）
 
 | 文件 | 是什么 | 用哪个 |
 |---|---|---|
-| `.hmismart` | 西门子 WinCC flexible SMART 触摸屏工程（Smart Line 屏） | 工具 `zzuser-hmi-decode`（解码）／`zzuser-hmi-diff-project`（新旧对比） |
-| `.fsprj` 或含 `HMI\Frame` 的目录 | 繁易 FStudio / Flexem 触摸屏工程 | 工具 `zzuser-hmi-decode`（扫文本）／`zzuser-fstudio-scan-texts`／`zzuser-fstudio-i18n`（多语言出表） |
+| `.hmismart` | 西门子 WinCC flexible SMART 触摸屏工程（Smart Line 屏） | 工具 `hmi-decode`（解码）／`hmi-diff-project`（新旧对比） |
+| `.fsprj` 或含 `HMI\Frame` 的目录 | 繁易 FStudio / Flexem 触摸屏工程 | 工具 `hmi-decode`（扫文本）／`fstudio-scan-texts`／`fstudio-i18n`（多语言出表） |
 | `<工程名>.设备_1.srt`（同目录） | 项目文本侧的序列化存储 | 主文件被锁时的旁路，见第三节 |
-| `Screens.xls` / `Others.xls` / `Messages.xls` | WinCC flexible「项目文本」导出成的 Excel 三件套 | 工具 `zzuser-wincc-text-i18n`（分型／回写／自检），流程见技能 `zzuser-wincc-text-i18n-workflow` |
+| `Screens.xls` / `Others.xls` / `Messages.xls` | WinCC flexible「项目文本」导出成的 Excel 三件套 | 工具 `wincc-text-i18n`（分型／回写／自检），流程见技能 `wincc-text-i18n-workflow` |
 
 **第一原则与 PLC 侧相同：先要"软件里能导出的东西"**。触摸屏这边对应的是：画面清单/变量表（软件里能导 CSV 或看变量表）——导出来对账，比在工程里挖快一个数量级。
 
@@ -22,7 +22,7 @@
 - **压缩块**：gzip 头 + **裸 deflate，没有 CRC/ISIZE 尾部**——标准 `gunzip` 只能解出一小部分，必须 `inflateRaw`。解出的内容是「属性名 + 属性值」序列与软件自带的多语言系统消息。
 - **内嵌 DDL**：`Hmi*` 表的建表脚本明文可读（HmiScreenTable / HmiTagTable / HmiConnectionTable / HmiScreenItemTable …），即工程数据的逻辑模型——**查某张表有哪些字段，先看它**。
 - **一次跑完**：`assets/hmismart-decode.mjs`（原始产物）+ `assets/hmismart-report.mjs`（人读报告），产物落 `<工作区>\解码归档\<工程名>\HMI解码\`，只读源文件。
-- **新旧差异**：`assets/hmismart-diff.mjs`（工具 `zzuser-hmi-diff-project`）——比 ①起始画面配置 ②画面表记录 ③画面名清单 ④配套文件差异。**"重启后跳到别的画面"先看第 1 节**：`StartScreenId` 指向 `Deleted=true` 的画面时，面板启动找不到它就退到列表里的其它画面。
+- **新旧差异**：`assets/hmismart-diff.mjs`（工具 `hmi-diff-project`）——比 ①起始画面配置 ②画面表记录 ③画面名清单 ④配套文件差异。**"重启后跳到别的画面"先看第 1 节**：`StartScreenId` 指向 `Deleted=true` 的画面时，面板启动找不到它就退到列表里的其它画面。
 - **查某个地址/变量时别做大范围 grep**：含压缩块原文的几份产物里宽 pattern（如 `VW`）会刷出几百行垃圾、把上下文冲掉；要查就用具体串。另：**地址表里出现 ≠ 画面绑定**，要知道挂在哪个控件上，得回对象记录再查一层。
 
 ### 两台软件同时唱着的时候：直接读旁系 `.data`（省一次解锁）
@@ -43,11 +43,11 @@
 
 ## 四、繁易 FStudio（多语言另见专篇）
 
-- 工具：`zzuser-hmi-decode`（读工程→扫元件文本）、`zzuser-fstudio-scan-texts`（只看要翻什么）、`zzuser-fstudio-i18n`（出对照表 + 可导入文本库的表）。
-- 方法与踩坑见同插件技能 **`zzuser-fstudio-i18n-workflow`**：列名逐字符一致、元件文字常写死不走文本库、原工程英文槽常是错填。
+- 工具：`hmi-decode`（读工程→扫元件文本）、`fstudio-scan-texts`（只看要翻什么）、`fstudio-i18n`（出对照表 + 可导入文本库的表）。
+- 方法与踩坑见同插件技能 **`fstudio-i18n-workflow`**：列名逐字符一致、元件文字常写死不走文本库、原工程英文槽常是错填。
 
 ## 五、交付与边界
 
 - 产物约定：`.hmismart` 写 `<工作区>\解码归档\<工程名>\HMI解码\`；FStudio 写 `<工程目录>\多语言产出\`。**不写系统临时目录、不污染工程目录**。
 - 只读源工程；`解码归档` 里的报告是某个版本的快照，拿旧报告对账前先比源文件的**大小 + 修改时间**。
-- 屏上地址为什么长成"不是西门子那种格式"（M 区名、Modbus 号、命名习惯）：见 PLC 侧技能 `zzuser-codesys-teach-workflow` §5——那是工程地址面的事，不在这里重复。
+- 屏上地址为什么长成"不是西门子那种格式"（M 区名、Modbus 号、命名习惯）：见 PLC 侧技能 `codesys-teach-workflow` §5——那是工程地址面的事，不在这里重复。

package/assets/{zzuser-nb-textlib-workflow.md → nb-textlib-workflow.md}

@@ -88,6 +88,6 @@
 ## 八、改文件
 
 - 只改数据行第 3、4 列（英文、第三语种），中文列与全部结构行原样；写回 UTF-16LE+BOM、LF。
-- 改前备份原件（`E:\chajian\_backup\<日期>-<主题>\` 保留原相对路径）。
+- 改前先把原件备份到独立目录（保留原相对路径），再动导出表。
 - 目标 xlsx 正被 Excel 打开时：用 COM 连活动实例（`Get-ActiveObject`），**先查 `Saved=True`** 再改；
   有未保存改动就不动，问用户。改完 `Workbook.Save()`，不要 `Quit`。

package/assets/{zzuser-wincc-text-i18n-workflow.md → wincc-text-i18n-workflow.md}

@@ -1,4 +1,4 @@
-# zzuser-wincc-text-i18n-workflow —— 西门子触摸屏项目文本翻译
+# wincc-text-i18n-workflow —— 西门子触摸屏项目文本翻译
 
 `Screens.xls / Others.xls / Messages.xls` 是 WinCC flexible（SMART）把工程文字按「画面 / 其它 / 报警」三处导出成的 Excel。英文列多半是半成品：有的空着，有的还是中文，更多是**串位**——这类表不能当成"填空"，得当校对。
 
@@ -16,11 +16,11 @@
 3. `apply`：回写目标列，出**同扩展名**.xls。
 4. `check`：键列没动、没有未译、没有残留 `$_ignore`、没有串位（源无中文而译文更长）、没有一源多译。
 
-工具：`zzuser-wincc-text-i18n`，`action=scan | apply | check`。
+工具：`wincc-text-i18n`，`action=scan | apply | check`。
 
 ## 三、分型只解决一半
 
-scan 判得出来的是：空译、中文残留、`$_ignore`、非中文同形（编号／日期格式）、**编号行挂词**——源文本不含中文（纯编号／代号）而译文更长的行，例如 `Q10` 对 `Q10 top box`、`Q23` 对 `Q3 Reject`。这一类就是串位：别行的功能词落到这一行了，按「源只有编号，译文也只留编号」处理；日期格式串（`yyyy-M-d H:mm:ss`）两列本来就不一样，不算。
+scan 判得出来的是：空译、中文残留、`$_ignore`、非中文同形（编号／日期格式）、**编号行挂词**——源文本不含中文（纯编号／代号）而译文更长的行。这一类就是串位：别行的功能词落到这一行了，按「源只有编号，译文也只留编号」处理；日期格式串（`yyyy-M-d H:mm:ss`）两列本来就不一样，不算。
 
 判不出来的仍是错译：中文对得上、译文却是另一个意思的那种，必须逐行看一遍。错译常见的三种样子：
 

package/hmi.js

@@ -274,19 +274,19 @@ async function retagFstudio(ctx, src, outArg, dict, lang, minStatus, exec) {
 
 const SKILLS = [
   {
-    name: 'zzuser-hmi-decode-workflow',
+    name: 'hmi-decode-workflow',
     description: '触摸屏工程读取工作流：.hmismart 全解（画面/变量/连接）与新旧差异、.srt 项目文本旁路读法、FStudio 多语言入口。接触摸屏（HMI）工程任务时加载。',
-    file: 'zzuser-hmi-decode-workflow.md',
+    file: 'hmi-decode-workflow.md',
   },
   {
-    name: 'zzuser-fstudio-i18n-workflow',
+    name: 'fstudio-i18n-workflow',
     description: 'FStudio/Flexem 触摸屏多语言翻译的正确工作流：三步（扫元件文本→出对照表→出可导入表）与踩坑清单（列名逐字符一致、元件文字写死不走文本库、原工程英文槽常是错填）。接多语言/翻译类触摸屏任务时加载。',
-    file: 'zzuser-fstudio-i18n-workflow.md',
+    file: 'fstudio-i18n-workflow.md',
   },
   {
-    name: 'zzuser-wincc-text-i18n-workflow',
+    name: 'wincc-text-i18n-workflow',
     description: '西门子 WinCC flexible/SMART 项目文本（Screens/Others/Messages 三件套 xls）翻译流程：格式契约（第 1 列是匹配键、换行是真换行、$_ignore 不许动）、分型判据、错译串位的识别、一源一译、术语表与出 .xls 的写法。接「触摸屏项目文本翻译/英文没填/导回英文」类任务时加载。',
-    file: 'zzuser-wincc-text-i18n-workflow.md',
+    file: 'wincc-text-i18n-workflow.md',
   },
 ]
 

package/index.js

@@ -3234,11 +3234,7 @@ export function apply(ctx, config = {}) {
         `解析方式: ${isAbsolute(ARCHIVE_ROOT) ? '绝对路径，原样使用' : `相对路径，按会话工作区解析（本进程 cwd = ${process.cwd()}）`}`,
         '默认落点: <归档根>\\<工程文件所在文件夹名>\\（同一文件夹里有多个工程文件时用 <文件夹名>_<文件名>）',
         '',
-        '改配置（改完重启 dsh 生效）：在 DSH profile 的 cordis.patch.yml 里给本插件那行加 config：',
-        '  - id: dsh-plc-decode',
-        '    name: dsh-plc-decode',
-        '    config:',
-        '      archiveDir: D:/plc/解码归档',
+        '改配置（改完重启 dsh 生效）：在 DSH profile 的 cordis.patch.yml 里给本插件那行加 config，只写 archiveDir（归档根目录）。',
         '',
         '只改这一次、不写配置：解码时传 outDir 参数（工具参数或 /plc-decode 的第二个参数）。',
       ].join('\n'),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-plc-decode",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "在 DSH 里读工控工程文件：PLC（CoDeSys、台达、西门子 SMART）与触摸屏（西门子 WinCC flexible SMART、繁易 FStudio、欧姆龙 NB、昆仑通态 MCGS）里的程序、画面、控件、变量与地址，读成能查的报告与表。",
   "type": "module",
   "main": "index.js",
@@ -22,7 +22,7 @@
   ],
   "engines": {
     "node": "^22.19.0 || >=24.0.0",
-    "dsh": ">=0.2.1-0 <0.3.0-0"
+    "dsh": ">=0.2.1-0"
   },
   "dsh": {
     "bundle": {