dsh-plc-decode 0.2.0 → 0.2.2

package/index.js

@@ -19,17 +19,60 @@
 import { existsSync, mkdirSync, readFileSync, writeFileSync, readdirSync, statSync } from 'node:fs'
 import { createHash } from 'node:crypto'
 import { inflateSync } from 'node:zlib'
-import { tmpdir } from 'node:os'
+import { homedir, tmpdir } from 'node:os'
 import { basename, dirname, extname, isAbsolute, join, resolve } from 'node:path'
 import { fileURLToPath } from 'node:url'
 import z from '@deepseek-ai/schemastery'
 import { writeSmartPack, writeSourcePack } from './assets/decode-pack.mjs'
 import { registerHmi } from './hmi.js'
+import { apply as applyLadder, maybeLadderHint } from './ladder.js'
 
 export const name = 'dsh-plc-decode'
 export const inject = ['skills', 'tools', 'commands', 'shell', 'sandboxPolicy']
 
 /** 报错尾行：插件出问题时，使用者第一眼看的就是错误文本。 */
+
+/* ---------- 校准表：解不出的字节/功能码 → 名字（$DSH_HOME/plc-calibration.json） ---------- */
+const CALIB_FILE = join(process.env.DSH_HOME || join(homedir(), '.dsh'), 'plc-calibration.json')
+const CALIB_CMD = 'plc-calibrate'
+function readCalib() { try { return JSON.parse(readFileSync(CALIB_FILE, 'utf8')) } catch { return {} } }
+function writeCalib(obj) { try { mkdirSync(dirname(CALIB_FILE), { recursive: true }); writeFileSync(CALIB_FILE, JSON.stringify(obj, null, 2), 'utf8') } catch { /* 写不进去不影响解码 */ } }
+function calibArgs() { try { if (!existsSync(CALIB_FILE)) writeCalib({}) } catch {} ; return existsSync(CALIB_FILE) ? ['--calib', CALIB_FILE] : [] }
+/** 从报告里捞出「没解出来」的字节/功能码（DVP 未识别记录表 + 未定名功能码 ??XX）。 */
+function collectUnknowns(text) {
+  const out = []
+  const seen = new Set()
+  for (const m of text.matchAll(/^\s*×(\d+)\s+([0-9a-f]{2}(?: [0-9a-f]{2})+)\s+首见/mg)) {
+    if (seen.has(m[2])) continue
+    seen.add(m[2]); out.push({ key: m[2], count: Number(m[1]) })
+  }
+  for (const m of text.matchAll(/\?\?([0-9A-F]{2})/g)) {
+    const k = 'cmd:' + m[1]
+    if (seen.has(k)) continue
+    seen.add(k); out.push({ key: k, count: 1 })
+  }
+  return out
+}
+/** 解码后追加「要照片 + 记校准」的提示，并把待补项写进校准表。 */
+function calibrationHint(format, reportText, source) {
+  if (!reportText) return ''
+  const un = collectUnknowns(reportText)
+  if (!un.length) return ''
+  const calib = readCalib()
+  const known = calib[format] ?? {}
+  calib.__pending = calib.__pending ?? {}
+  calib.__pending[format] = calib.__pending[format] ?? {}
+  for (const u of un) if (!known[u.key]) calib.__pending[format][u.key] = { count: u.count, source: source ?? '', at: new Date().toISOString() }
+  writeCalib(calib)
+  const list = un.slice(0, 8).map((u) => '  ×' + u.count + '  ' + u.key).join('\n')
+  return '\n\n⚠ 有 ' + un.length + ' 类没解出来（已记进校准表待补）：\n' + list
+    + '\n要补：在软件里对这几处截图（梯形图局部或指令表）发我，我按图对账。'
+    + '\n记法：/' + CALIB_CMD + ' <格式> "<字节>" "<指令名>" [备注] —— 记下后，下次同样的字节直接出名字。'
+}
+function reportHint(outd, format, src) {
+  try { const f = join(outd, '解码报告.md'); return existsSync(f) ? calibrationHint(format, readFileSync(f, 'utf8'), src) : '' } catch { return '' }
+}
+
 const FEEDBACK_HINT = '遇到问题：加 QQ 号 2171960697，或开 Issue https://github.com/taoziliyouchong/dsh-plc-decode/issues'
 
 /** 插件配置（DSH 官方 Config 机制：cordis.patch.yml 里本插件行的 config 传进 apply）。
@@ -37,6 +80,8 @@ const FEEDBACK_HINT = '遇到问题：加 QQ 号 2171960697，或开 Issue https
 export const Config = z.object({
   archiveDir: z.string().default('解码归档')
     .description('解码产物归档根目录。相对路径按当前会话工作区解析，绝对路径原样使用。默认「解码归档」。'),
+  ladder: z.boolean().default(false)
+    .description('是否启用梯形图渲染（默认关闭）。开启后可用 ladder-auto / ladder-dvp / ladder-from-stl / ladder-render；也可用 /ladder on 随时切换。'),
 })
 
 /** 生效中的归档根目录；apply 时由 config.archiveDir 覆盖，未配置即默认值（与旧版行为一致）。 */
@@ -232,7 +277,7 @@ async function decodeCodesysProject(ctx, projPath, signal, exec, outDir, base) {
   const outd = outDir || defaultArchiveDir(abs, base)
   precreateOutDir(outd, kind)
   const result = kind === 'dvp'
-    ? await runPy(ctx, 'dvp_decode.py', [abs, '-o', outd], dir, signal, exec)
+    ? await runPy(ctx, 'dvp_decode.py', [abs, '-o', outd, ...calibArgs()], dir, signal, exec)
     : await runPy(ctx, 'read_project.py', [abs, outd], dir, signal, exec)
   // 加密 .project（不是 zip，整文件高熵）：read_project.py 报 BadZipFile。
   // 强硬解码通道：同目录常有 <工程>.precompilecache（zip），里面有全部标识符与中文名，
@@ -263,7 +308,7 @@ async function decodeCodesysProject(ctx, projPath, signal, exec, outDir, base) {
 async function decodeDvpText(ctx, dvpPath, signal, exec) {
   const abs = requireDvp(dvpPath, '需要一个 .dvp 工程文件路径（带空格请加引号）')
   const dir = dirname(abs)
-  const result = await runPy(ctx, 'dvp_decode.py', [abs], dir, signal, exec)
+  const result = await runPy(ctx, 'dvp_decode.py', [abs, ...calibArgs()], dir, signal, exec)
   if (!result.ok) throw new Error(result.text)
   return { abs, dir, text: result.text }
 }
@@ -2616,6 +2661,9 @@ export function apply(ctx, config = {}) {
   // 触摸屏（HMI）工程解码：画面/控件/变量/地址，与 PLC 侧共用同一插件行（hmi.js）。
   registerHmi(ctx)
 
+  // 梯形图渲染/自动成图（ladder.js）：默认关闭，/ladder on 打开。
+  applyLadder(ctx, cfg)
+
   // ── 工具一：统一入口（四格式自动识别分发）──
   ctx.tools.register({
     name: 'plc-decode',
@@ -2651,7 +2699,7 @@ export function apply(ctx, config = {}) {
       if (kind === 'project' || kind === 'dvp') {
         const result = await decodeCodesysProject(ctx, abs, exec.signal, exec, outDir, sessionBase(exec?.agent))
         const tail = String(result.kind).includes('加密') ? '00-目录.md' : '00-索引.md'
-        return { ok: true, text: `已解码完成（类型: ${result.kind}）\n输出目录: ${result.outd}\n${result.text}\n下一步: 先读 ${join(result.outd, tail)}` }
+        return { ok: true, text: `已解码完成（类型: ${result.kind}）\n输出目录: ${result.outd}\n${result.text}\n下一步: 先读 ${join(result.outd, tail)}` + maybeLadderHint() + reportHint(result.outd, result.kind === 'dvp' ? 'dvp' : 'codesys', abs) }
       }
       if (kind === 'hmismart') {
         throw new Error(
@@ -2662,7 +2710,7 @@ export function apply(ctx, config = {}) {
         )
       }
       const result = kind === 'smart' ? decodeSmartFile(abs, outDir, sessionBase(exec?.agent)) : decodeSmartLib(abs, outDir, sessionBase(exec?.agent))
-      return { ok: true, text: `已解码完成（类型: ${kind}）:\n${result.proceed}` }
+      return { ok: true, text: `已解码完成（类型: ${kind}）:\n${result.proceed}` + maybeLadderHint() + reportHint(result.outdir ?? outDir ?? join(sessionBase(exec?.agent), '解码归档'), 'smart', abs) }
     },
   })
 
@@ -3234,11 +3282,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'),
@@ -3432,6 +3476,23 @@ export function apply(ctx, config = {}) {
       }
     },
   })
+
+  ctx.commands.register({
+    name: 'plc-calibrate',
+    description: '记录解不出的字节/功能码对应的名字（校准表）：解完后下次同样的字节直接出名字。参数：格式（dvp/smart/codesys）、字节或 cmd:XX、名字，可选备注。',
+    input: { hint: '<格式> <字节或 cmd:XX> <名字> [备注]' },
+    handler: async ({ rawInput }) => {
+      const parts = splitArgs(rawInput)
+      if (parts.length < 3) return { kind: 'error', text: '用法：/plc-calibrate <格式> <字节或 cmd:XX> <名字> [备注]' }
+      const [format, key, name, ...note] = parts
+      const calib = readCalib()
+      calib[format] = calib[format] ?? {}
+      calib[format][key] = { name, note: note.join(' '), at: new Date().toISOString() }
+      if (calib.__pending && calib.__pending[format]) delete calib.__pending[format][key]
+      writeCalib(calib)
+      return { kind: 'success', text: '已记入校准表：' + format + ' ' + key + ' → ' + name + '（下次解码生效）' }
+    },
+  })
 }
 
 // 内部导出（诊断/CLI 验证用，不参与工具的 ctx 注册）：与工具相同的解码入口

package/ladder.js

@@ -0,0 +1,381 @@
+/**
+ * ladder —— 文字梯形图渲染 + 自动成图（模块，由 index.js 调用）
+ * 默认关闭；开：/ladder on（立即生效）或 profile 配置 ladder: true。
+ *
+ * 两件事：
+ *   1) ladder-render     给"网络描述"→ 软件观感的文字梯形图（方框＋两侧引脚＋导线值）
+ *   2) ladder-from-stl   给 S7-200/SMART 语句表 → 每个网络的文字梯形图 + 机械讲解
+ *
+ * 为什么要有它：2026-09-18 用户认可了这一版式，并要求"保证要输出这种质量"——
+ *   手敲空格会对不齐、换会话会换风格；把版式固化成代码后，样式不会再漂。
+ *
+ * 只读输入 + 可选写出文本文件；不改动任何工程文件。
+ */
+
+import { readFileSync, writeFileSync, mkdtempSync } from 'node:fs'
+import { dirname, join, resolve } from 'node:path'
+import { homedir, tmpdir } from 'node:os'
+import { fileURLToPath } from 'node:url'
+import { BUNDLED_SKILL_RANK } from '@deepseek-ai/dsh-skill'
+import { renderSpec, lintSpec } from './assets/ladder-render.mjs'
+import { stlToLadder } from './assets/stl-to-ladder.mjs'
+import { autoLadder } from './assets/smart-ladder-auto.mjs'
+import { dvpLadder } from './assets/dvp-ladder.mjs'
+
+/** 梯形图功能开关：默认关闭；状态存 $DSH_HOME/ladder-state.json，/ladder on|off 切换，立即生效。 */
+const STATE_FILE = join(process.env.DSH_HOME || join(homedir(), '.dsh'), 'ladder-state.json')
+const HINT_LIMIT = 3
+const OFF_TEXT = '梯形图功能未开启。开启：/ladder on（立即生效），或在 profile 的 cordis.patch.yml 里给本插件行加 config ladder: true 后重启。'
+let ladderOn = false
+
+function readState() {
+  try { return JSON.parse(readFileSync(STATE_FILE, 'utf8')) } catch { return {} }
+}
+function patchState(patch) {
+  try { writeFileSync(STATE_FILE, JSON.stringify({ ...readState(), ...patch }), 'utf8') } catch { /* 状态写不进去不影响渲染 */ }
+}
+function setLadderOn(v) { ladderOn = Boolean(v); patchState({ enabled: ladderOn }) }
+export function ladderEnabled() { return ladderOn }
+/** 解码后提示（默认关闭时前三次提示「可以看梯形图」，之后不再提示）。 */
+export function maybeLadderHint() {
+  if (ladderOn) return ''
+  const st = readState()
+  const n = Number(st.hints) || 0
+  if (n >= HINT_LIMIT) return ''
+  patchState({ hints: n + 1 })
+  return `\n\n提示：这个工程可以出梯形图（按块/网络画成文字图）。要开就说 /ladder on，开启后随时可看（第 ${n + 1}/${HINT_LIMIT} 次提示）。`
+}
+
+/* ---------- 台达：先跑解码器拿结构化指令表，再画图（数据源与报告同一份） ---------- */
+const PY = 'python'
+const DVP_DECODER = join(dirname(fileURLToPath(import.meta.url)), 'assets', 'codesys-tools', 'dvp_decode.py')
+let CTX = null
+function psq(v) { return `'${String(v).replace(/'/g, "''")}'` }
+async function runPy(script, argv, workdir, exec) {
+  const policy = CTX?.sandboxPolicy && exec?.agent ? CTX.sandboxPolicy.resolve({ session: exec.agent.session }) : undefined
+  const spec = CTX.shell.resolve({
+    command: `$env:PYTHONIOENCODING='utf-8'; & ${PY} ${psq(script)} ${argv.map(psq).join(' ')}`,
+    workdir,
+    timeoutMs: 300000,
+    ...(policy ? { sandboxPolicy: policy } : {}),
+    ...(exec?.signal ? { signal: exec.signal } : {}),
+  })
+  const res = await (await CTX.shell.execute(spec)).result()
+  return { out: String(res.stdout?.text ?? '').trim(), err: String(res.stderr?.text ?? '').trim(), exitCode: res.exitCode }
+}
+async function decodeDvpToJson(file, exec) {
+  const abs = resolve(file)
+  const dir = mkdtempSync(join(tmpdir(), 'dvp-il-'))
+  const json = join(dir, 'insts.json')
+  const r = await runPy(DVP_DECODER, [abs, '--json', json], dirname(abs), exec)
+  if (r.exitCode !== 0) throw new Error(`DVP 解码失败（退出码 ${r.exitCode}）：${r.err || r.out}`)
+  return json
+}
+
+/** 随包技能：文字梯形的排版规范与自动成图。 */
+const SKILLS = [
+  { name: 'ladder-workflow', file: 'ladder-workflow.md', description: '文字梯形图排版与自动成图：STL/工程文件转图、按 spec 渲染、交付前自检' },
+]
+
+const SPEC_HINT = 'spec = { title?, legend?, outFile?, networks: [ { name, note?, rows: [ { left?, pinL?, pinR?, out? } ], comments?, plain? } ] }'
+
+/** 从 spec 渲染；顺带做结构自检（发现问题不改写，附在文本末尾便于当场改）。 */
+function render(spec) {
+  const text = renderSpec(spec)
+  const issues = lintSpec(spec)
+  return issues.length ? `${text}\n（结构自检 ${issues.length} 条：${issues.join('；')}）\n` : text
+}
+
+/** 注册工具、命令与内置技能（默认关闭；关着时工具只回一行开启提示）。 */
+export function apply(ctx, config = {}) {
+  CTX = ctx
+  const st = readState()
+  ladderOn = typeof st.enabled === 'boolean' ? st.enabled : config.ladder === true
+  const regTool = (def) => ctx.tools.register({ ...def, execute: (args, exec) => (ladderOn ? def.execute(args, exec) : { ok: true, text: OFF_TEXT }) })
+  const regCmd = (def) => ctx.commands.register({ ...def, handler: async (e) => (ladderOn ? def.handler(e) : { kind: 'error', text: OFF_TEXT }) })
+
+  regTool({
+    name: 'ladder-render',
+    description: '把网络描述渲染成软件观感的文字梯形图（触点/导线在左、指令盒画方框、引脚列两侧、值写在导线上）。用于任何要交"文字梯形图"的场合：PLC 程序讲解、改动方案、对照说明。样式固定、对齐由本工具计算（中文只在标题与说明行），排版不会再漂。传 spec JSON：networks[].rows[] 的 left=方框左侧的导线与触点（如 "Alw~:SM0.0 ──┤ ├"）、pinL/pinR=方框左右引脚名（如 EN/ENO）、out=方框右侧去向（如 VW198）；comments[] 是网络下方的说明行。可选 outFile 直接写盘。',
+    parameters: {
+      type: 'object',
+      properties: {
+        title: { type: 'string', description: '整份输出的标题（可选）。' },
+        legend: { type: 'boolean', description: '是否在图例行（默认 true，用固定那行符号说明）。' },
+        outFile: { type: 'string', description: '可选：把渲染结果写入该文件（UTF-8）。' },
+        networks: {
+          type: 'array',
+          description: '网络数组，按数组顺序渲染。',
+          items: {
+            type: 'object',
+            properties: {
+              name: { type: 'string', description: '网络标题，如 "网络 6"。' },
+              note: { type: 'string', description: '标题后的补充，如 "MOV_W（每个扫描周期都执行）"。' },
+              rows: {
+                type: 'array',
+                description: '行数组；一行画一根导线。',
+                items: {
+                  type: 'object',
+                  properties: {
+                    left: { type: 'string', description: '方框左侧的导线与元件。触点画成 ┤ ├（常开）、┤P├（上升沿）、┤==I +0├（比较）；只写 ASCII 与制表符，不要混中文。' },
+                    pinL: { type: 'string', description: '方框左侧引脚名（软件的英文名，如 EN、First、DataPtr）。' },
+                    pinR: { type: 'string', description: '方框右侧引脚名（如 ENO、Done、Error）。' },
+                    out: { type: 'string', description: '方框右侧导线的去向（如 VW198、M0.1）；只写地址/符号，不写中文。' },
+                  },
+                  additionalProperties: false,
+                },
+              },
+              comments: { type: 'array', items: { type: 'string' }, description: '网络下方的说明行（中文写在这里）。' },
+              plain: { type: 'boolean', description: '该网络没有指令盒（例如直接以线圈结尾）时设 true：每行只画导线，不画方框。' },
+            },
+            required: ['name', 'rows'],
+            additionalProperties: false,
+          },
+        },
+      },
+      required: ['networks'],
+      additionalProperties: false,
+    },
+    output: {
+      schema: {
+        type: 'object',
+        properties: { ok: { type: 'boolean' }, text: { type: 'string' } },
+        required: ['ok', 'text'],
+        additionalProperties: false,
+      },
+      render: (_args, value) => [{ type: 'text', text: value.text }],
+    },
+    async execute(args) {
+      const text = render({ ...args })
+      const outFile = String(args.outFile ?? '').trim()
+      if (outFile) {
+        try { writeFileSync(resolve(outFile), text, 'utf8') } catch (e) {
+          throw new Error(`写入失败 ${outFile}: ${e instanceof Error ? e.message : String(e)}`)
+        }
+        return { ok: true, text: `${text}\n（已写入 ${resolve(outFile)}）` }
+      }
+      return { ok: true, text }
+    },
+  })
+
+  regTool({
+    name: 'ladder-from-stl',
+    description: '把西门子 S7-200 / S7-200 SMART 语句表（STL）自动转成文字梯形图＋机械讲解：认 LD/LDN、A/AN、O/ON、ALD/OLD/LPS/LRD/LPP、EU/ED、比较触点（LDD=／AD<>／OW> 与 ==I／<D 两种写法）、=、S/R、CALL、MOV_/TON/CTU/算术等指令盒。输出风格与 ladder-render 一致（触点与导线在左、盒画方框、引脚列两侧、值写在导线上），每个网络后附一句"当……时，……"的机械讲解（不编造：认不出的写法按盒原样画并标注）。传 stl=语句表正文，或 file=.awl/.txt 路径；可选 outFile 写盘、summary=false 关掉讲解行。',
+    parameters: {
+      type: 'object',
+      properties: {
+        stl: { type: 'string', description: '语句表正文（与 file 二选一）。' },
+        file: { type: 'string', description: '语句表文件路径（.awl/.txt，与 stl 二选一）。' },
+        outFile: { type: 'string', description: '可选：把结果写入该文件（UTF-8）。' },
+        summary: { type: 'boolean', description: '是否输出机械讲解行（默认 true）。' },
+        title: { type: 'string', description: '可选标题。' },
+      },
+      additionalProperties: false,
+    },
+    output: {
+      schema: {
+        type: 'object',
+        properties: { ok: { type: 'boolean' }, text: { type: 'string' } },
+        required: ['ok', 'text'],
+        additionalProperties: false,
+      },
+      render: (_args, value) => [{ type: 'text', text: value.text }],
+    },
+    async execute(args) {
+      let src = String(args.stl ?? '')
+      const file = String(args.file ?? '').trim()
+      if (!src && file) {
+        try { src = readFileSync(resolve(file), 'utf8') } catch (e) {
+          throw new Error(`读取失败 ${file}: ${e instanceof Error ? e.message : String(e)}`)
+        }
+      }
+      if (!src.trim()) throw new Error('需要 stl（正文）或 file（路径）')
+      const text = stlToLadder(src, { summary: args.summary !== false, title: args.title })
+      const outFile = String(args.outFile ?? '').trim()
+      if (outFile) {
+        writeFileSync(resolve(outFile), text, 'utf8')
+        return { ok: true, text: `${text}\n（已写入 ${resolve(outFile)}）` }
+      }
+      return { ok: true, text }
+    },
+  })
+
+  regTool({
+    name: 'ladder-dvp',
+    description: '台达 DVP 工程（.dvp）直接出盒式文字梯形图：读工程程序区，按行（LD M1000 行首）还原成「母线＋多支路」梯形图，版式与西门子 .smart 那侧同一个渲染器。不用导出指令表、不用手画。并联输出按字节里的分支/栈记录还原；触点常开常闭按前缀推定（0x22/0x24＝常闭，B 系＝上升沿、C 系＝下降沿），未定名功能码按 ?? 原样画盒并在图下注明。参数 file=工程路径、from/to=只出某几行（行号从 1 起）、outFile=写盘。',
+    parameters: {
+      type: 'object',
+      properties: {
+        file: { type: 'string', description: '.dvp 工程文件路径。' },
+        from: { type: 'number', description: '可选：起始行号（从 1 起）。' },
+        to: { type: 'number', description: '可选：结束行号。' },
+        outFile: { type: 'string', description: '可选：把结果写入该文件（UTF-8）。' },
+        title: { type: 'string', description: '可选标题。' },
+      },
+      required: ['file'],
+      additionalProperties: false,
+    },
+    output: {
+      schema: {
+        type: 'object',
+        properties: { ok: { type: 'boolean' }, text: { type: 'string' } },
+        required: ['ok', 'text'],
+        additionalProperties: false,
+      },
+      render: (_args, value) => [{ type: 'text', text: value.text }],
+    },
+    async execute(args, exec) {
+      const json = await decodeDvpToJson(String(args.file ?? '').trim(), exec)
+      const text = await dvpLadder({
+        json,
+        from: args.from,
+        to: args.to,
+        title: args.title,
+        outFile: String(args.outFile ?? '').trim() || undefined,
+      })
+      const outFile = String(args.outFile ?? '').trim()
+      if (outFile) return { ok: true, text: `${text}\n（已写入 ${resolve(outFile)}）` }
+      return { ok: true, text }
+    },
+  })
+
+  regTool({
+    name: 'ladder-auto',
+    description: '自动画梯形图：直接读西门子 S7-200 SMART 的 .smart 工程，按块（可选单网络）自动生成软件观感的盒式文字梯形图——母线、触点（含常闭/边沿）、比较触点（双操作数内联）、S/R/=/线圈、并联支路自动折叠，指令盒画占位框（BOX#位次，实参用 smart-box-pins 查）。输入 file=工程路径、block=块名（可选）、net=网络号（可选）、outFile=可选写盘。无需手写 spec、无需导出 STL。',
+    parameters: {
+      type: 'object',
+      properties: {
+        file: { type: 'string', description: '.smart 工程文件路径。' },
+        block: { type: 'string', description: '可选：块名（如 启停／主程序）；不填默认第一个块。' },
+        net: { type: 'string', description: '可选：只画该块的第 N 个网络。' },
+        outFile: { type: 'string', description: '可选：把结果写入该文件（UTF-8）。' },
+        title: { type: 'string', description: '可选标题。' },
+      },
+      required: ['file'],
+      additionalProperties: false,
+    },
+    output: {
+      schema: {
+        type: 'object',
+        properties: { ok: { type: 'boolean' }, text: { type: 'string' } },
+        required: ['ok', 'text'],
+        additionalProperties: false,
+      },
+      render: (_args, value) => [{ type: 'text', text: value.text }],
+    },
+    async execute(args) {
+      const text = await autoLadder({ file: String(args.file ?? '').trim(), block: args.block ? String(args.block).trim() : undefined, net: args.net ? String(args.net).trim() : undefined, title: args.title })
+      const outFile = String(args.outFile ?? '').trim()
+      if (outFile) {
+        writeFileSync(resolve(outFile), text, 'utf8')
+        return { ok: true, text: `${text}\n（已写入 ${resolve(outFile)}）` }
+      }
+      return { ok: true, text }
+    },
+  })
+
+  regCmd({
+    name: 'ladder-dvp',
+    description: '.dvp 工程 → 盒式文字梯形图（自动出图，无需 spec）',
+    input: { hint: '<工程.dvp> [起行] [止行] [输出.txt]' },
+    handler: async ({ rawInput }) => {
+      try {
+        const parts = String(rawInput ?? '').trim().split(/\s+/).filter(Boolean)
+        if (!parts.length) throw new Error('用法: /ladder-dvp <工程.dvp> [起行] [止行] [输出.txt]')
+        const [file, from, to, out] = parts
+        const json = await decodeDvpToJson(file)
+        const text = await dvpLadder({ json, from, to, outFile: out })
+        return { kind: 'success', text: out ? `${text}\n（已写入 ${resolve(out)}）` : text }
+      } catch (error) {
+        return { kind: 'error', text: error instanceof Error ? error.message : String(error) }
+      }
+    },
+  })
+
+  regCmd({
+    name: 'ladder-auto',
+    description: '.smart 工程 → 盒式文字梯形图（自动出图，无需 spec）',
+    input: { hint: '<工程.smart> [块名] [网络号] [输出.txt]' },
+    handler: async ({ rawInput }) => {
+      try {
+        const parts = String(rawInput ?? '').trim().split(/\s+/).filter(Boolean)
+        if (!parts.length) throw new Error('用法: /ladder-auto <工程.smart> [块名] [网络号] [输出.txt]')
+        const [file, block, net, out] = parts
+        const text = await autoLadder({ file, block, net })
+        if (out) writeFileSync(resolve(out), text, 'utf8')
+        return { kind: 'success', text: out ? `${text}\n（已写入 ${resolve(out)}）` : text }
+      } catch (error) {
+        return { kind: 'error', text: error instanceof Error ? error.message : String(error) }
+      }
+    },
+  })
+
+  regCmd({
+    name: 'ladder-spec',
+    description: '把 spec JSON 渲染成文字梯形图（软件观感：方框＋两侧引脚＋导线值）',
+    input: { hint: '<spec.json> [输出.txt]' },
+    handler: async ({ rawInput }) => {
+      try {
+        const raw = String(rawInput ?? '').trim()
+        if (!raw) throw new Error(`用法: /ladder-spec <spec.json> [输出.txt]；${SPEC_HINT}`)
+        const [file, out] = raw.split(/\s+/)
+        const spec = JSON.parse(readFileSync(resolve(file), 'utf8'))
+        const text = render(spec)
+        if (out) writeFileSync(resolve(out), text, 'utf8')
+        return { kind: 'success', text: out ? `${text}\n（已写入 ${resolve(out)}）` : text }
+      } catch (error) {
+        return { kind: 'error', text: error instanceof Error ? error.message : String(error) }
+      }
+    },
+  })
+
+  regCmd({
+    name: 'ladder-stl',
+    description: '语句表（STL）→ 文字梯形图＋讲解',
+    input: { hint: '<语句表.txt> [输出.txt]' },
+    handler: async ({ rawInput }) => {
+      try {
+        const [file, out] = String(rawInput ?? '').trim().split(/\s+/)
+        if (!file) throw new Error('用法: /ladder-stl <语句表.txt> [输出.txt]')
+        const text = stlToLadder(readFileSync(resolve(file), 'utf8'), {})
+        if (out) writeFileSync(resolve(out), text, 'utf8')
+        return { kind: 'success', text: out ? `${text}\n（已写入 ${resolve(out)}）` : text }
+      } catch (error) {
+        return { kind: 'error', text: error instanceof Error ? error.message : String(error) }
+      }
+    },
+  })
+
+  ctx.commands.register({
+    name: 'ladder',
+    description: '梯形图功能开关：on 打开 / off 关闭 / status 查看（立即生效，不用重启）',
+    input: { hint: 'on | off | status' },
+    handler: async ({ rawInput }) => {
+      const arg = String(rawInput ?? '').trim().toLowerCase()
+      if (arg === 'on' || arg === 'off') {
+        setLadderOn(arg === 'on')
+        return { kind: 'success', text: `梯形图已${arg === 'on' ? '开启' : '关闭'}（立即生效）。` }
+      }
+      return { kind: 'success', text: `梯形图当前：${ladderOn ? '开启' : '关闭'}。用法：/ladder on|off` }
+    },
+  })
+
+  ctx.skills.registerProvider(() => ({
+    name: 'ladder',
+    list: () => Promise.resolve(SKILLS.map(s => ({
+      name: s.name,
+      description: s.description,
+      invocation: { modelInvocable: false, userInvocable: true },
+      provider: 'ladder',
+      source: 'bundled',
+      resourceBase: { kind: 'directory', path: new URL('./assets/', import.meta.url).pathname },
+      rank: BUNDLED_SKILL_RANK,
+      locator: new URL(`./assets/${s.file}`, import.meta.url),
+    }))),
+    async get(candidate) {
+      const s = SKILLS.find(x => x.name === candidate.name) ?? SKILLS[0]
+      return { ...candidate, content: readFileSync(new URL(`./assets/${s.file}`, import.meta.url), 'utf8') }
+    },
+  }))
+
+}

package/package.json

@@ -1,18 +1,17 @@
 {
   "name": "dsh-plc-decode",
-  "version": "0.2.0",
-  "description": "在 DSH 里读工控工程文件：PLC（CoDeSys、台达、西门子 SMART）与触摸屏（西门子 WinCC flexible SMART、繁易 FStudio、欧姆龙 NB、昆仑通态 MCGS）里的程序、画面、控件、变量与地址，读成能查的报告与表。",
+  "version": "0.2.2",
+  "description": "在 DSH 里读工控工程文件：PLC（CoDeSys、台达、西门子 SMART）与触摸屏（西门子 WinCC flexible SMART、繁易 FStudio、欧姆龙 NB、昆仑通态 MCGS、威纶通 EasyBuilder Pro）里的程序、画面、控件、变量与地址，读成能查的报告与表。",
   "type": "module",
   "main": "index.js",
   "exports": {
     ".": "./index.js",
-    "./invariant": "./invariant.js",
     "./package.json": "./package.json"
   },
   "files": [
     "index.js",
     "hmi.js",
-    "invariant.js",
+    "ladder.js",
     "cordis.patch.yml",
     "assets",
     "scripts",
@@ -22,7 +21,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": {
@@ -46,6 +45,8 @@
     "omron",
     "nb-designer",
     "mcgs",
+    "weintek",
+    "easybuilder-pro",
     "industrial-automation",
     "leadshine",
     "leadsysstudio",
@@ -53,7 +54,7 @@
   ],
   "scripts": {
     "smoke": "node scripts/smoke.mjs",
-    "check": "node --check index.js && node --check hmi.js && node --check invariant.js && node --check assets/decode-pack.mjs && node --check assets/hmismart-decode.mjs && node --check assets/hmismart-diff.mjs && node --check assets/hmismart-report.mjs && node --check assets/nb-decode.mjs && node --check assets/mcgs-decode.mjs && node --check assets/smart-lad.mjs && node --check assets/smart-net-trace.mjs"
+    "check": "node --check index.js && node --check hmi.js && node --check ladder.js && node --check assets/decode-pack.mjs && node --check assets/hmismart-decode.mjs && node --check assets/hmismart-diff.mjs && node --check assets/hmismart-report.mjs && node --check assets/nb-decode.mjs && node --check assets/mcgs-decode.mjs && node --check assets/smart-lad.mjs && node --check assets/smart-net-trace.mjs"
   },
   "author": "taoziliyouchong",
   "license": "MIT",

package/scripts/smoke.mjs

@@ -15,8 +15,8 @@ import { join } from 'node:path'
 
 import { apply, inject, name as pluginName } from '../index.js'
 
-const EXPECTED_TOOLS = 18
-const EXPECTED_COMMANDS = 15
+const EXPECTED_TOOLS = 19
+const EXPECTED_COMMANDS = 20
 
 let failed = 0
 const pass = (m) => console.log(`  ok   ${m}`)

package/assets/FStudio/346/226/207/346/234/254/345/272/223/345/257/274/345/205/245/346/240/274/345/274/217.md

@@ -1,45 +0,0 @@
-# FStudio 文本库导入格式（繁易 Flexem）
-
-做多语言时，给 FStudio 文本库**导入**用的表，格式必须与软件**导出**的 TextLib 表逐字符一致，
-否则软件报"文件格式不正确"。踩过一次坑，记在这里。
-
-## 表结构
-
-单表，表名随意（软件导出叫 `TextLib`）。表头**必须**是这 5 列（有俄语就 6 列）：
-
-| 列 | 内容 | 说明 |
-|---|---|---|
-| 1 | `Guid` | 条目唯一标识，UUID 形如 `20c4864f-29ba-46c4-b9a5-beef83fbcad2`。新条目自己生成 UUID4 |
-| 2 | `Name` | 条目名，建议 ≤50 字，勿换行（软件里列表显示用） |
-| 3 | `Status` | 状态号，**数字**：默认值节点写 `0`，多状态依次 1、2… |
-| 4 | `1-Chinese (Simplified, PRC)-2052` | 简体中文（LCID 2052） |
-| 5 | `2-English (United States)-1033` | 英文（LCID 1033） |
-| 6 | `3-Russian (Russia)-1049` | 俄语（LCID 1049），不用就别加这列 |
-
-- 列名里空格、括号、连字符都不能改；`Guid`/`Name`/`Status` 首字母大写。
-- 简体中文那列的列名尤其容易写错成"中文"——**写"中文"就导不进去**。
-- 一个条目若有多状态，导出的表是"Guid 只在首行、后续行 Guid 留空"，同 `Name`、`Status` 递增。
-  自己造导入表时**每行都给 Guid** 更稳。
-
-## 生成脚本
-
-`出文本库导入表.py`：把中文英文对照表转成上面的格式。
-
-```
-python 出文本库导入表.py <对照表.xlsx> [输出.xlsx]
-```
-
-- 输入表要求：有一列列名含「中文」、一列含「英文」或 `English`。
-- 输出：**一份**可导入的 `.xlsx`（默认只出一份，别一次给多个表）。需要 `.xls` 时加参数：`--xls`。
-- 每个条目 Guid 自动生成、Status=0、Name 取中文前 50 字、英文为空的行标黄底提示。
-
-## 导入前自查（3 条）
-
-1. 表头逐字符对：`Guid` / `Name` / `Status` / `1-Chinese (Simplified, PRC)-2052` / `2-English (United States)-1033`。
-2. Guid 无重复、非空；Status 是数字不是文本。
-3. 库里已有的条目先核一遍，别把同名条目导成两条。
-
-## 相关
-
-- 文本库在工程里的位置：`Global\TextLibConfigInfo.cfg`；语言表：`HMI\System\LanguageConfigInfo.cfg`。
-- 画面元件想随语种变，还得逐个元件勾「使用文本库」指到条目（FStudio 使用手册 4.13.8 标签编辑器，p.570-571）。