dsh-plc-decode 0.2.1 → 0.2.3

package/assets/hmismart-report.mjs

@@ -34,20 +34,15 @@ const TYPE = {
 
 const VAR_GROUPS = [
   ['PLC 直接地址', /^[QIMV]\d|^VD\d|^VW\d|^VB\d|^CD\d|^\d/],
-  ['锁机 / 产量限制', /锁机/],
-  ['伺服 / 编码器 / 位置', /伺服|编码器|旋转|原点|位置|位移|偏移/],
-  ['加料 / 送料 / 挡料', /加料|送料|上料|放料|挡料|整料|整平/],
-  ['吸盒 / 吸托 / 吸纸 / 吹气', /吸盒|吸托|吸纸|吹气|气压/],
-  ['封盒 / 压盒 / 顶盒 / 推料', /封盒|压盒|压托|顶盒|顶托|推托|推料|压料|压舌|推杆|飞料/],
-  ['喷胶', /喷胶/],
-  ['检测 / 剔废', /检测|测书|测托|测料|测盒|测速|测瓶|剔废|测瓶/],
-  ['报警 / 故障', /报警|故障|急停|缺料|缺纸|堵料|卡盒|盒子|托库/],
-  ['速度 / 计数 / 产量', /速度|计数|产量|清零|速比/],
-  ['画面 / 显示', /画面|隐藏/],
-  ['用户 / 密码', /用户|密码|权限/],
-  ['日期 / 时间', /当前[日年月]|[日月年]期/],
-  ['屏操作 / 模式', /屏|启动|停止|点动|手动|调试|自动|联机|复位|运行/],
-  ['备用', /备用/],
+  ['报警 / 故障', /报警|故障|急停|异常|错误/],
+  ['伺服 / 位置 / 编码器', /伺服|编码器|原点|位置|位移|偏移|轴/],
+  ['速度 / 计数 / 产量', /速度|转速|计数|产量|累计|清零/],
+  ['参数 / 设定', /参数|设定|目标|上限|下限|补偿|系数|比例|增益/],
+  ['画面 / 显示', /画面|显示|隐藏|屏/],
+  ['用户 / 密码 / 权限', /用户|密码|权限|登录/],
+  ['日期 / 时间', /当前[日年月]|[日月年]期|时间|时钟/],
+  ['操作 / 模式', /启动|停止|运行|暂停|点动|手动|自动|调试|复位|联机|使能/],
+  ['备用 / 预留', /备用|预留/],
 ]
 const grouped = new Set()
 const varLines = []

package/assets/lad-branches.mjs

@@ -0,0 +1,147 @@
+#!/usr/bin/env node
+// lad-branches.mjs v2 —— 画「一条母线 + 多条并联支路（支路内可再并联）」的文字梯形图
+//
+// 画法＝软件观感：触点/导线在左、指令盒画方框带引脚、线圈画在导线上。
+// （v1 用 [INCW VW222] / (S …) 的行末写法，用户看过说"不是梯形图"，已废。）
+//
+// 为什么需要它：
+//   · stl-to-ladder 把 LPS/LRD/LPP 拆出的并联支路当成并列的独立行（每条重复母线元件），并联结构看不见；
+//   · lad-box-inputs 只画「一个盒 + 多路并联输入」；ladder-render 一行只能一个盒、画不了盒与线圈混排。
+//   母线上挂多条支路、末端是盒或线圈的网络用它画：内容由 spec 给、列位由脚本补，不手敲对齐。
+//
+// 用法：node lad-branches.mjs spec.json
+// spec：{
+//   title?: string,
+//   rail?: string,                  // 母线文字（默认 SM0.0），画在第一条支路行
+//   boxCol?: number,                // 盒左边线列（默认按最长支路自动算）
+//   rows: [ { wire, box?, coil? } ],
+//   vfill?: [ { col, from, to } ],  // 支路内的竖向连接：第 from 条支路 → 第 to 条支路
+//   comments?: [ string ]
+// }
+//   wire   该支路的元件画法，**从母线列(9)开始写**：第一列 = 母线竖线接点（┬ ├ └）或空格
+//          支路内二次并联：父行在分岔列写 ┬、子行在分岔列写 └，中间用 vfill 补竖线
+//   box    { name, pins: [ { name, src } ] }；src:"cond" = 本支路导线接到该引脚，
+//          其他值 = 值写在盒左侧的导线上（如 "VW222" / "0" / "6000"）
+//   coil   "S M23.1" / "R M23.0, 2"（画成 ──( S M23.1 )）
+// 只写 ASCII 与制图字符；中文只出现在 title 与 comments。
+import { readFileSync } from 'node:fs'
+
+const file = process.argv[2]
+if (!file) {
+  console.error('用法：node lad-branches.mjs spec.json')
+  process.exit(2)
+}
+const spec = JSON.parse(readFileSync(file, 'utf8'))
+const rows = (spec.rows ?? []).filter((r) => r && r.wire)
+if (!rows.length) {
+  console.error('spec.rows 为空')
+  process.exit(2)
+}
+
+const BUS = 9
+const grid = []
+const ensure = (r) => { while (grid.length <= r) grid.push([]) }
+const put = (r, c, s) => {
+  ensure(r)
+  const row = grid[r]
+  while (row.length < c) row.push(' ')
+  let i = c
+  for (const ch of s) row[i++] = ch
+}
+const putCh = (r, c, ch) => {
+  ensure(r)
+  const row = grid[r]
+  while (row.length < c) row.push(' ')
+  row[c] = ch
+}
+const getCh = (r, c) => (grid[r] ?? [])[c] ?? ' '
+const fill = (r, c0, c1, ch) => { for (let c = c0; c < c1; c++) putCh(r, c, ch) }
+
+const longest = Math.max(...rows.map((r) => (r.wire ?? '').length))
+const boxCol = spec.boxCol ?? Math.max(34, BUS + longest + 4)
+const BOXW = Math.max(18, ...rows.map((r) => ((r.box?.name ?? '').length + 14)))
+
+const lineRows = []
+let line = 0
+for (const r of rows) {
+  const w = r.wire ?? ''
+  if (r.coil) {
+    // 末端线圈：左段从母线列按 wire 排，再补横线到 boxCol，保证多支路线圈同列对齐
+    put(line, BUS, w)
+    fill(line, BUS + w.length, boxCol, '─')
+    put(line, boxCol, `( ${r.coil} )`)
+    lineRows.push(line)
+    line += 1
+    continue
+  }
+  if (r.box) {
+    const pins = r.box.pins ?? []
+    const top = line
+    put(top, boxCol, '┌' + '─'.repeat(BOXW) + '┐')
+    let ln = top + 1
+    pins.forEach((p, i) => {
+      if (p.src === 'cond') {
+        put(ln, BUS, w + '─'.repeat(Math.max(2, boxCol - BUS - w.length)))
+        lineRows.push(ln)
+      } else {
+        const v = String(p.src ?? '')
+        const vc = Math.max(BUS + 2, boxCol - 3 - v.length)
+        put(ln, vc, v)
+        fill(ln, vc + v.length + 1, boxCol, '─')
+      }
+      put(ln, boxCol, `│ ${String(p.name ?? '').padEnd(BOXW - 2, ' ')}│`)
+      ln += 1
+      if (i === 0 && pins.length > 1) {
+        put(ln, boxCol, `│ ${String(r.box.name ?? '').padEnd(BOXW - 2, ' ')}│`)
+        ln += 1
+      }
+    })
+    if (pins.length <= 1) {
+      put(ln, boxCol, `│ ${String(r.box.name ?? '').padEnd(BOXW - 2, ' ')}│`)
+      ln += 1
+    }
+    put(ln, boxCol, '└' + '─'.repeat(BOXW) + '┘')
+    if (!pins.some((p) => p.src === 'cond')) lineRows.push(top)
+    line = ln + 1
+    continue
+  }
+  if (!r.box && !r.coil && /^\s/.test(w)) {
+    // 纯标签行（触点名对齐用）：原样输出，不画导线、不补横线
+    put(line, BUS, w)
+    lineRows.push(line)
+    line += 1
+    continue
+  }
+  put(line, BUS, w)
+  fill(line, BUS + w.length, boxCol, '─')
+  put(line, boxCol, `( ${r.coil} )`)
+  lineRows.push(line)
+  line += 1
+}
+
+const first = Math.min(...lineRows)
+const last = Math.max(...lineRows)
+for (let r = first; r <= last; r++) {
+  const ch = getCh(r, BUS)
+  if (!'┬├└│'.includes(ch)) putCh(r, BUS, '│')
+}
+for (const v of spec.vfill ?? []) {
+  const a = lineRows[v.from] ?? first
+  const b = lineRows[v.to] ?? last
+  for (let r = a + 1; r < b; r++) if (!'┬├└│'.includes(getCh(r, v.col))) putCh(r, v.col, '│')
+}
+
+if (spec.rail !== '') {
+  const railText = spec.rail ?? 'SM0.0'
+  put(first, 2, railText)
+  fill(first, 2 + railText.length + 1, BUS, '─')
+}
+
+const out = []
+if (spec.title) out.push(spec.title)
+for (const row of grid) out.push((row ?? []).join('').replace(/\s+$/, ''))
+if (spec.comments?.length) {
+  out.push('')
+  for (const [i, c] of spec.comments.entries()) out.push((i === 0 ? '说明：' : '      ') + c)
+}
+console.log(out.join('\n'))

package/assets/ladder-render.mjs

@@ -0,0 +1,118 @@
+/**
+ * 文字梯形图渲染器（纯函数，零依赖）
+ *
+ * 样式是**固定**的（2026-09-18 用户认可的那一版）：
+ *   - 触点与导线在左边、指令盒画成方框、引脚列在方框两侧、值写在导线上
+ *   - 梯体全为等宽字符；中文只出现在标题行与说明行（不参与对齐）
+ *   - 对齐由本模块按"显示宽度"计算（CJK/全角按 2 列），不靠手敲空格
+ *
+ * 用法：
+ *   import { renderSpec, renderNetwork, dw } from './ladder-render.mjs'
+ *   renderSpec({ legend: true, networks: [ { name:'网络 6', note:'MOV_W', rows:[...], comments:[...] } ] })
+ */
+
+/** 一个字符占几列（等宽字体下 CJK/全角 = 2，其余 = 1）。 */
+export function dw(s) {
+  let n = 0
+  for (const ch of String(s ?? '')) {
+    const c = ch.codePointAt(0)
+    const wide = (c >= 0x1100 && c <= 0x115f) || (c >= 0x2e80 && c <= 0xa4cf) ||
+      (c >= 0xac00 && c <= 0xd7a3) || (c >= 0xf900 && c <= 0xfaff) ||
+      (c >= 0xfe30 && c <= 0xfe6f) || (c >= 0xff00 && c <= 0xff60) ||
+      (c >= 0xffe0 && c <= 0xffe6) || c >= 0x20000
+    n += wide ? 2 : 1
+  }
+  return n
+}
+
+/** 图例行（用户看过并认可的那一行，不要随手改）。 */
+export const LEGEND = '符号：  ┤ ├ 常开触点    ┤P├ 上升沿触点    ┤==I +0├ 比较触点    ──  导线'
+
+const DEFAULT_STYLE = {
+  indent: 3,       // 缩进
+  gapMin: 4,       // 左导线区在最长左侧内容之后至少留几根横线
+  leftArea: 37,    // 左导线区的最小宽度（决定方框左边界落在第 3+37=40 列）
+  boxMin: 24,      // 方框内部最小宽度
+}
+
+/** 渲染一个网络；返回字符串（无行则返回空串）。 */
+export function renderNetwork(net, style = {}) {
+  const st = { ...DEFAULT_STYLE, ...style }
+  const pad = ' '.repeat(st.indent)
+  const rows = (net?.rows ?? []).filter((r) => r && (r.left || r.pinL || r.pinR || r.out))
+  if (!rows.length) return ''
+  const head = `${net.name ?? '网络'}${net.note ? ' ── ' + net.note : ''}`
+
+  // 无方框的网络（例如直接以线圈结尾的支路）：一行一根导线
+  if (net.plain) {
+    const lines = [head]
+    for (const r of rows) lines.push(pad + (r.left ?? '') + (r.out ? '── ' + r.out : ''))
+    for (const [i, c] of (net.comments ?? []).entries()) {
+      if (!String(c ?? '').trim()) continue
+      lines.push(i === 0 ? `${pad}说明：${c}` : ' '.repeat(st.indent + dw('说明：')) + c)
+    }
+    return lines.join('\n')
+  }
+
+  const leftW = Math.max(st.leftArea, Math.max(...rows.map((r) => dw(r.left ?? ''))) + st.gapMin)
+  const pinLW = Math.max(0, ...rows.map((r) => dw(r.pinL ?? '')))
+  const pinRW = Math.max(0, ...rows.map((r) => dw(r.pinR ?? '')))
+  const inside = Math.max(st.boxMin, 2 + pinLW + st.gapMin + pinRW)
+
+  const out = [head]
+  out.push(pad + ' '.repeat(leftW) + '┌' + '─'.repeat(inside) + '┐')
+  for (const r of rows) {
+    const left = r.left ?? ''
+    // 左侧内容若已以导线/触点符号收尾，就不再补空格（贴住更接近软件观感）
+    const sp = /[├┤│─┐┘]/.test(left.slice(-1)) ? 0 : 1
+    const wire = pad + left + ' '.repeat(sp) + '─'.repeat(Math.max(2, leftW - dw(left) - sp)) + '│'
+    const l = ' ' + (r.pinL ?? '')
+    const rr = (r.pinR ?? '') + ' '
+    const mid = ' '.repeat(Math.max(1, inside - dw(l) - dw(rr)))
+    out.push(wire + l + mid + rr + '│' + (r.out ? '── ' + r.out : ''))
+  }
+  out.push(pad + ' '.repeat(leftW) + '└' + '─'.repeat(inside) + '┘')
+  for (const [i, c] of (net.comments ?? []).entries()) {
+    if (!String(c ?? '').trim()) continue
+    out.push(i === 0 ? `${pad}说明：${c}` : ' '.repeat(st.indent + dw('说明：')) + c)
+  }
+  return out.join('\n')
+}
+
+/** 渲染整份（标题 + 图例 + 各网络，网络之间空一行）。 */
+export function renderSpec(spec) {
+  const parts = []
+  if (spec?.title) parts.push(spec.title, '═'.repeat(Math.max(8, dw(spec.title))))
+  if (spec?.legend !== false) parts.push(typeof spec?.legend === 'string' ? spec.legend : LEGEND)
+  for (const net of spec?.networks ?? []) {
+    const t = renderNetwork(net, spec?.style ?? {})
+    if (t) parts.push(t)
+  }
+  return parts.join('\n\n') + '\n'
+}
+
+/** 结构自检：返回问题列表（空数组 = 通过）。 */
+export function lintSpec(spec) {
+  const issues = []
+  if (!Array.isArray(spec?.networks) || !spec.networks.length) issues.push('networks 为空')
+  for (const [i, n] of (spec?.networks ?? []).entries()) {
+    const at = `第 ${i + 1} 个网络（${n?.name ?? '无名'}）`
+    if (!n?.name) issues.push(`${at}: 缺 name`)
+    const rows = (n?.rows ?? []).filter((r) => r && (r.left || r.pinL || r.pinR || r.out))
+    if (!rows.length) issues.push(`${at}: 没有有效行`)
+    if (!n?.plain) {
+      for (const r of rows) {
+        if (r.out && !r.pinR) issues.push(`${at}: 行「${r.left ?? ''}」有 out 但没写 pinR（右侧引脚）`)
+        if (/[\u4e00-\u9fff]/.test(String(r.left ?? ''))) issues.push(`${at}: 行「${r.left}」的 left 里混了中文——会破坏对齐，挪到 comments`)
+        if (/[\u4e00-\u9fff]/.test(String(r.out ?? ''))) issues.push(`${at}: 行 out「${r.out}」里混了中文——挪到 comments`)
+        if (/[\u4e00-\u9fff]/.test(String(r.pinL ?? '')) || /[\u4e00-\u9fff]/.test(String(r.pinR ?? ''))) {
+          issues.push(`${at}: 引脚名里混了中文——引脚用软件里的英文名`)
+        }
+      }
+    }
+    for (const c of n?.comments ?? []) {
+      if (/^\s*[①②③④⑤⑥⑦⑧⑨]/.test(String(c))) continue
+    }
+  }
+  return issues
+}

package/assets/ladder-workflow.md

@@ -0,0 +1,80 @@
+# ladder-workflow —— 文字梯形图的排版规范与自动成图
+
+要交"文字梯形图"（讲解、改动方案、对照说明）时用本技能。样式已固化成代码，**不要手敲空格、不要自创排法**：
+手敲必然对不齐，自创必然返工。两条路都走工具。
+
+## 一、两条路
+
+| 输入是什么 | 用哪个 | 命令 |
+|---|---|---|
+| 指令表／语句表（STL，含 `LD/A/O/=/TON/…`） | 工具 `ladder-from-stl` | `/ladder-stl <语句表.txt> [输出.txt]` |
+| 只有元件与引脚的信息（截图、解码结果、口述） | 工具 `ladder-render` | `/ladder <spec.json> [输出.txt]` |
+| 台达 DVP 工程文件 | 工具 `ladder-dvp` | `/ladder-dvp <工程.dvp> [起段] [止段]` |
+| 西门子 S7-200 SMART 工程文件 | 工具 `ladder-auto` | `/ladder-auto <工程.smart> [块名] [网络]` |
+
+**能拿到工程文件或 STL 就走自动那条**：串并联写在文件里，成图是确定的，不用猜；只有拿不到才走 spec 手写。
+
+## 二、STL 自动成图
+
+认得的写法（S7-200 / S7-200 SMART）：
+
+- 触点 `LD/LDN`、`A/AN`、`O/ON`、`NOT`
+- 逻辑堆栈 `ALD`、`OLD`、`LPS`、`LRD`、`LPP`
+- 边沿 `EU` → `┤P├`，`ED` → `┤N├`
+- 比较触点两种写法都认：`LDD=`／`AD<>`／`OW>`，以及 `==I`／`<D`／`>=R`
+- 输出 `=`（线圈）、`S`/`R`（可带个数）、`CALL`（子程序与库块）
+- 指令盒 `MOV_`、`TON/TOF`、`CTU/CTD`、`INC/DEC`、算术、移位…
+
+行为约定：
+
+- 每个网络出一段梯体 + 一句机械讲解（"当……时，……"）；`summary=false` 可关掉讲解。
+- **认不出的写法不猜**：按盒原样画，讲解里标"未识别写法"。看完必须人工核一遍再交。
+- 定时器／计数器的编号进盒名（`TON T57`），不当引脚；`PT`/`PV` 才是引脚。
+- 网络分隔：`Network N`／`网络 N`；`//` 开头的行当网络注释保留。
+
+## 三、只有元件信息时（spec 渲染）
+
+```json
+{
+  "title": "可选标题",
+  "legend": true,
+  "networks": [
+    {
+      "name": "网络 7",
+      "note": "盒名（可选补充）",
+      "rows": [
+        { "left": "Alw~:SM0.0 ──┤ ├", "pinL": "EN" },
+        { "left": "C1 ─┤==I +0├──┤P├", "pinL": "First" },
+        { "left": "40100", "pinL": "Addr" },
+        { "left": "2", "pinL": "Count", "pinR": "Done", "out": "M0.1" }
+      ],
+      "comments": ["EN 常通——盒每扫描都被调用；", "First 只在 C1==0 的上升沿给一拍。"]
+    }
+  ]
+}
+```
+
+| 字段 | 写什么 |
+|---|---|
+| `rows[].left` | 方框左侧的导线与元件画法（触点、比较、常数、地址）。只写 ASCII 与制表符，**不混中文** |
+| `rows[].pinL` / `pinR` | 方框左／右引脚名，用软件里的英文名（EN、First、Addr、DataPtr、Done、Error、ENO…） |
+| `rows[].out` | 方框右侧导线去向（`VW198`、`M0.1`）；**有 out 必须给 pinR** |
+| `rows[]` 一行 | 一根导线；按软件的引脚顺序排 |
+| `comments[]` | 网络下方的中文说明 |
+| `plain: true` | 没有指令盒的网络（直接以线圈收尾）：只画导线，不画方框 |
+
+## 四、画法约定（照软件观感）
+
+- 常开触点 `┤ ├`　常闭触点 `┤/├`　上升沿 `┤P├`　下降沿 `┤N├`
+- 比较触点带参数写：`┤==I +0├`、`┤<I 最高速度├`
+- 数值／地址写在导线上：`40100 ────┤ Addr`
+- 线圈 `──( Q1.7 )`、置位复位 `──( S M25.6, 2 )`
+- 盒名放网络标题（`name` + `note`）或盒内；不塞进引脚行
+- 多支路（母线拉出多条并联）用自动成图的 `ladder-dvp`／`ladder-auto`；手写 spec 只适合单支路
+
+## 五、交付前自检
+
+1. 渲染器自带结构自检（中文混进梯体、有 out 没 pinR、空网络都会点出来）——**不过先改，别交**。
+2. 对着源头逐行核：每根导线上的值、每个引脚名都能在程序里指出来；**不确定的接线不画成确定的样子**，宁可空着并在 comments 写"待核"。
+3. 自动成图后重点核三处：比较触点、边沿、`LPS/LRD/LPP` 拆出来的并列支路——这三处最容易看错。
+4. 图上看不懂的元件（画成 `?`／`〔?…〕`）不要当成已知交出去：写明是哪一段、什么字节，交给用户对账。

package/assets/smart-ladder-auto.mjs

@@ -0,0 +1,182 @@
+#!/usr/bin/env node
+/**
+ * smart-ladder-auto.mjs —— .smart 工程 → 盒式文字梯形图（自动出图）
+ *
+ * 链路：spawn smart-lad.mjs 拿每块每网络的 LAD 指令序列（LD/A/O/AN/ON/EU/ED/LPS/LRD/LPP/=/S/R + 比较触点 + [盒] 占位）
+ *      → 折叠成 lad-branches 的支路 spec（母线 + 多支路 + 盒 + 线圈）
+ *      → spawn lad-branches.mjs 渲染（版式单一正文在它那里，这里不复制渲染逻辑）
+ *
+ * V1 边界（诚实声明）：
+ *   · 支持主形态：母线触点(LD) + 串/并联触点 + 边沿 + 比较触点 + S/R/=/线圈 + 单层 LPS/LRD/LPP 支路；
+ *   · 指令盒（TON/CTU/CALL 等无法从元件记录拿实参的）画占位框（BOX#位次），实参用 smart-box-pins 查；
+ *   · 嵌套 LPS（栈深>2）、ALD/OLD 复杂栈运算按原样标注，不猜。
+ */
+
+import { execFile } from 'node:child_process'
+import { promisify } from 'node:util'
+import { writeFileSync, readFileSync, mkdtempSync } from 'node:fs'
+import { tmpdir } from 'node:os'
+import { dirname, join } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const pExecFile = promisify(execFile)
+
+const ASSETS_DIR = dirname(fileURLToPath(import.meta.url))
+const SMART_LAD = join(ASSETS_DIR, 'smart-lad.mjs')
+const LAD_BRANCHES = join(ASSETS_DIR, 'lad-branches.mjs')
+
+/* ---------- 解析 smart-lad 文本 ---------- */
+
+/** 把 smart-lad 的输出按块/网络拆成指令行 */
+export function parseLadText(text) {
+  const blocks = []
+  let cur = null
+  for (const rawLine of text.split(/\r?\n/)) {
+    const line = rawLine.trim()
+    const bm = line.match(/^## 块：(.+)$/)
+    if (bm) { cur = { name: bm[1], nets: [] }; blocks.push(cur); continue }
+    if (!cur) continue
+    const nm = line.match(/^Network (\d+)$/)
+    if (nm) { cur.nets.push({ no: Number(nm[1]), ins: [] }); continue }
+    if (!line || line.startsWith('#')) continue
+    if (!cur.nets.length) cur.nets.push({ no: cur.nets.length + 1, ins: [] })
+    cur.nets[cur.nets.length - 1].ins.push(line)
+  }
+  return blocks
+}
+
+/* ---------- 指令 → 触点/盒/线圈 ---------- */
+
+const CMP_RE = /^(L|A|O)(W|D)?(<>|<=|>=|=|<|>)$/
+const RAIL_PASS = /^(SM0\.0|Always_On|First_Scan_On)$/i
+
+/** 一个触点的文字画法：地址在左、触点符号在右 */
+function contact(addr, negate, edge) {
+  if (edge) return `──${edge}├`
+  return `──${addr} ─${negate ? '┤/├' : '┤ ├'}`
+}
+
+/** 比较触点：两个操作数都内联（┤>=I LW0, +31├），不丢操作数 */
+function cmpContact(size, rel, a, b) {
+  const sym = `${size === 'D' ? 'D' : 'I'}${rel}`
+  return `──┤${sym}│ ${a}, ${b}├`
+}
+
+/** 一条指令行 → 对 cur 的增量；返回 {kind, wire?, coil?, box?} 或 null(纯增量) */
+function applyIns(line, st) {
+  // [盒] 占位
+  const bm = line.match(/^\[盒\]\s*←\s*位次\s*(\d+)/)
+  if (bm) return { kind: 'box', name: `BOX#${bm[1]}` }
+
+  const m = line.match(/^(\S+)\s*(.*)$/)
+  if (!m) return null
+  const op = m[1]
+  const args = m[2] ? m[2].split(',').map((s) => s.trim()) : []
+
+  const cm = op.match(CMP_RE)
+  if (cm) {
+    if (args.length < 2) return null
+    st.cur += cmpContact(cm[2], cm[3], args[0], args[1])
+    return null
+  }
+
+  switch (op) {
+    case 'LD': case 'LDN':
+      st.cur = RAIL_PASS.test(args[0]) ? '' : contact(args[0], op === 'LDN')
+      if (!st.cur) st.rail = args[0]
+      return null
+    case 'A': st.cur += contact(args[0], false); return null
+    case 'AN': st.cur += contact(args[0], true); return null
+    case 'O': st.cur += contact(args[0], false).replace('──', '─┬─'); return null
+    case 'ON': st.cur += contact(args[0], true).replace('──', '─┬─'); return null
+    case 'EU': st.cur += contact('', false, '┤P'); return null
+    case 'ED': st.cur += contact('', false, '┤N'); return null
+    case 'LPS': st.stack.push(st.cur); return null
+    case 'LRD': if (st.stack.length) st.cur = st.stack[st.stack.length - 1]; return null
+    case 'LPP': st.cur = st.stack.pop() ?? st.cur; return null
+    case '=':
+      return { kind: 'row', wire: st.cur, coil: args[0] }
+    case 'S': case 'R':
+      return { kind: 'row', wire: st.cur, coil: `${op} ${args.join(', ')}` }
+    case 'ALD': case 'OLD':
+      st.cur += '──(ALD/OLD 汇合)'
+      return null
+    default:
+      // TON/CTU/MOV_ 等 smart-lad 直接给出的盒行：画占位框
+      return { kind: 'box', name: op.slice(0, 12), tail: args.join(' ') }
+  }
+}
+
+/** 一个网络的指令行数组 → lad-branches spec */
+export function netToSpec(no, lines) {
+  const st = { cur: '', stack: [], rail: 'SM0.0' }
+  const rows = []
+  for (const line of lines) {
+    const r = applyIns(line, st)
+    if (!r) continue
+    if (r.kind === 'row') {
+      rows.push({ wire: st.cur || '──', coil: r.coil })
+      st.cur = st.stack.length ? st.stack[st.stack.length - 1] : ''
+    } else if (r.kind === 'box') {
+      rows.push({ wire: st.cur || '──', box: { name: r.name, pins: [{ name: 'EN', src: 'cond' }] } })
+      st.cur = st.stack.length ? st.stack[st.stack.length - 1] : ''
+    }
+  }
+  if (rows.length && rows.length > 1) {
+    rows[0].wire = '┬' + rows[0].wire
+    for (let i = 1; i < rows.length; i++) rows[i].wire = '└' + rows[i].wire
+  }
+  return {
+    title: `网络${no}`,
+    rail: st.rail,
+    boxCol: 74,
+    rows,
+    vfill: rows.length > 1 ? [{ col: 9, from: 0, to: rows.length - 1 }] : [],
+  }
+}
+
+/* ---------- 渲染（复用 lad-branches，单一正文） ---------- */
+
+async function renderNet(spec) {
+  const dir = mkdtempSync(join(tmpdir(), 'lad-auto-'))
+  const f = join(dir, 'n.json')
+  writeFileSync(f, JSON.stringify(spec), 'utf8')
+  const { stdout } = await pExecFile(process.execPath, [LAD_BRANCHES, f], { encoding: 'utf8', maxBuffer: 4 << 20 })
+  return stdout.replace(/\s+$/, '')
+}
+
+/** 主入口：工程文件 + 块名（可选网络号）→ 文字梯形图 */
+export async function autoLadder({ file, block, net, title }) {
+  const { stdout } = await pExecFile(process.execPath, [SMART_LAD, file, ...(block ? [block] : [])], {
+    encoding: 'utf8', maxBuffer: 32 << 20,
+  })
+  const blocks = parseLadText(stdout)
+  if (!blocks.length) throw new Error(`smart-lad 没解析出块：${file}`)
+  const picked = block ? blocks.find((b) => b.name === block) : blocks[0]
+  if (!picked) throw new Error(`没找到块「${block}」，现有：${blocks.map((b) => b.name).join('、')}`)
+
+  const parts = [title ?? `${picked.name} · 盒式梯形图（自动生成）`, '']
+  let count = 0
+  for (const n of picked.nets) {
+    if (net && n.no !== Number(net)) continue
+    if (!n.ins.length) continue
+    const spec = netToSpec(n.no, n.ins)
+    if (!spec.rows.length) continue
+    parts.push(await renderNet(spec), '')
+    count++
+  }
+  if (!count) throw new Error('该块没有可渲染的网络')
+  const note = '说明：BOX#n＝指令盒占位（实参用 smart-box-pins 按位次/区间查）；比较触点两操作数内联标注。'
+  return parts.join('\n') + '\n' + note + '\n'
+}
+
+/* CLI：node smart-ladder-auto.mjs <工程.smart> [块名] [网络号] [输出.txt] */
+if (process.argv[1] && process.argv[1].endsWith('smart-ladder-auto.mjs')) {
+  const [file, block, net, out] = process.argv.slice(2)
+  autoLadder({ file, block, net })
+    .then((text) => {
+      process.stdout.write(out ? `${text}\n（已写入 ${out}）\n` : text)
+      if (out) writeFileSync(out, text, 'utf8')
+    })
+    .catch((e) => { console.error(String(e)); process.exit(1) })
+}