dsh-plc-decode 0.1.1 → 0.1.3

package/README.md

@@ -58,6 +58,7 @@ dsh plugin --profile web add github:taoziliyouchong/dsh-plc-decode
 | 命令 | 用途 |
 |---|---|
 | `/plc-decode <文件> [输出目录]` | 统一解码入口 |
+| `/plc-archive` | 查看当前生效的解码归档根目录、默认落点与改配置的方法 |
 | `/codesys-read <工程>` | 解码 `.project`（ST 源码 + 报告）或 `.dvp`（解码报告） |
 | `/dvp-read <工程>` | 台达 DVP 结构与指令表报告 |
 | `/smart-read <.smart/.smartlib> [输出目录]` | SMART 工程 / 库解码 |
@@ -79,6 +80,26 @@ dsh plugin --profile web add github:taoziliyouchong/dsh-plc-decode
 | `.dvp` | `00-索引.md`、`解码报告.md`（结构 / 段落注释 / 设备注释 / 指令表）、可选 `程序解读.md` |
 | `.smart` / `.smartlib` | `00-目录.md`（先读这份）、`解码报告.md`、`程序.lad`、`元素记录.tsv`、`符号地址.tsv`、`分析.md`、`记录.json`、`字符串全录.txt` |
 
+### 改归档地址（不用改代码）
+
+在 DSH profile 的 `cordis.patch.yml`（`$DSH_HOME/profiles/<profile>/cordis.patch.yml`）末尾加这几行：
+
+```yaml
+- id: dsh-plc-decode
+  name: dsh-plc-decode
+  config:
+    archiveDir: D:/plc/解码归档
+```
+
+`archiveDir` 是归档**根目录**：相对路径按当前会话工作区解析，绝对路径原样使用；默认 `解码归档`。改完重启 dsh 生效，`/plc-archive` 可随时查看当前生效值；只想改一次就在解码时传 `outDir`。
+
+实测同一份 `Dvp0.dvp` 在两种配置下的落点：
+
+| cordis.patch.yml | 解码落点 |
+|---|---|
+| 不写 `config` | `<工作区>\解码归档\靖昇20250212ZH1035\` |
+| `archiveDir: D:/plc/解码归档` | `D:\plc\解码归档\靖昇20250212ZH1035\` |
+
 `.smart` 的 `记录.json` 同时是各分析工具（地址占用、变量使用等）的输入，也是识别「已解码目录」的凭据；解码报告头部带**源文件指纹**（文件大小 + 修改时间），工程换版本后先核对指纹再用旧报告。
 
 ## 已知边界
@@ -93,7 +114,7 @@ dsh plugin --profile web add github:taoziliyouchong/dsh-plc-decode
 
 ```sh
 npm run check                 # 语法检查
-npm run smoke                 # 装载插件 + 核对注册面（工具 12 个 / 命令 11 个）
+npm run smoke                 # 装载插件 + 核对注册面（工具 12 个 / 命令 12 个）
 npm run smoke -- <工程文件>    # 额外对一个真实工程跑端到端解码，核对产物落盘
 npm pack --dry-run            # 看包里内容（node_modules、publish/ 不应进包）
 ```

package/assets/codesys-tools/dvp_decode.py

@@ -109,6 +109,11 @@ COMPACT_TYPES = {0x05: "M", 0x09: "X", 0x0A: "Y",
 # 行号索引前缀（保留吞 5B 语义）：14/16 为行号标记
 ROWIDX_PREFIX = {0x14, 0x16}
 
+# 2026-11-05：认不出的记录台账。disasm 每跳一条未识别记录就往这里记一笔
+# （段号, 行号, 字节原文），main 末尾聚合成「未识别记录」一节。
+# 这不是猜语义，是把「读不出来」变成看得见的账——用户能据此对照 WPLSoft 指令表。
+UNKNOWN_RECS = []
+
 # 触点/线圈指令前缀：
 #   12 触点族（LD/AND/T 页）、32=OUT、22=AND/ANI
 #   B 系（B4/B6/B2/B9）= ANDP（上升沿，置位侧）
@@ -126,8 +131,11 @@ COMPACT_NAMES = {
     (0x16, 0x05): "LD", (0x16, 0x0A): "LD", (0x16, 0x19): "LD",
 }
 # B/C 系沿触点：B=ANDP、C=ANDF，全类型页
+# 2026-11-05：B 系补 0x07（T 页）/ 0x1A（Y 页）——C 系早就有 0x1A 的实证注释，
+# B 系漏页会让上升沿触点整条消失；本机 16 份工程实测 B 系出现类型页 {05,07,09,15,17,19,1A}，
+# 其中 0x17 页语义未定，暂不映射（宁缺不猜），其余补齐。
 for _p in (0xB4, 0xB6, 0xB2, 0xB9):
-    for _t in (0x05, 0x09, 0x0A, 0x15, 0x19):
+    for _t in (0x05, 0x07, 0x09, 0x0A, 0x15, 0x19, 0x1A):
         COMPACT_NAMES[(_p, _t)] = "ANDP"
 for _p in (0xC6, 0xC9, 0xC2, 0xC4):
     for _t in (0x05, 0x09, 0x0A, 0x15, 0x19, 0x1A):
@@ -320,7 +328,7 @@ def _to_loading(cp):
     return cp
 
 
-def disasm(seg):
+def disasm(seg, segno=0):
     """段数据区 → 行分组指令 token 流
     - 比较指令族 ?CMP（e2/e4/e6/e9 + 双操作数，指令名待对照，统一 ? 前缀）
     - 行尾/分隔记录整体吞 5B（0b/61 10/68 10/57 10/5a/34/39）
@@ -358,12 +366,11 @@ def disasm(seg):
             elif b == 0x0b:
                 # 0b 00 00 00 00 ＝ ORB（与指令表逐条对得上；紧随其后的全零记录是 ANB）
                 toks.append('ORB'); i += 5
-            elif b == 0x56:
-                toks.append("MPS"); i += 1
-            elif b == 0x59:
-                toks.append("MRD"); i += 1
-            elif b == 0x54:
-                toks.append("MPP"); i += 1
+            elif b in (0x56, 0x59, 0x54):
+                # 2026-11-05：栈指令记录是完整 5 字节（实测 `56 10 00 00 00` / `59 00 00 00 00`
+                # / `54 10 00 00 00`），旧版 i += 1 把后 4 字节留进主循环：第 2 字节 0x10
+                # 会被当作未知记录，尾字节不是 0x00 时只跳 1 字节 → 后续记录整体错位。
+                toks.append({0x56: "MPS", 0x59: "MRD", 0x54: "MPP"}[b]); i += 5
             elif b == 0x90:
                 # 0x90 记录携带 32 位数据的**高位字**（rec[4]=0x10 表示后面还有操作数）。
                 # 高位字要并进前一个常数（如 K34463 + H1 = K99999），
@@ -371,16 +378,28 @@ def disasm(seg):
                 hi = rec[2] | (rec[3] << 8)
                 m = re.match(r'^([KH])([0-9A-F]+)$', toks[-1]) if toks else None
                 if hi and m:
+                    kind, digits = m.group(1), m.group(2)
                     try:
-                        toks[-1] = f"{m.group(1)}{int(m.group(2)) + (hi << 16)}"
+                        # 2026-11-05：①H 型常数内部存的是十六进制，旧版按十进制 int() 解析
+                        # 要么 ValueError（整条不拼）要么算错；②K 是 32 位有符号——高半字
+                        # 全 1 时是负数，旧版无符号拼接把 K-200000 显示成 K4294767296。
+                        val = int(digits, 16 if kind == 'H' else 10) + (hi << 16)
+                        if kind == 'K' and val >= 0x80000000:
+                            val -= 0x100000000
+                        toks[-1] = f"H{format(val, 'X')}" if kind == 'H' else f"K{val}"
                         i += 5
                         continue
                     except ValueError:
                         pass
                 toks.append(f"|H{hi}|" if hi else "|")
                 i += 5
-            elif b == 0x42:
-                if rec[2] == 0x18:
+            elif b in (0x42, 0x44, 0x49):
+                # 2026-11-05：0x44 / 0x49 是与 0x42 同形的功能指令记录——同为 5 字节，
+                # rec[2] 是功能码，直接查同一张 CMD_MAP/GUESS_CMD（实证 9 条全部对上：
+                #   44 10 5D 01 10 → 码 5D = DDRVI；44 10 00 D0 00 / 49 00 00 D0 00 → 码 00 = SET；
+                #   49 00 29 00 10 → 码 29 = DMOV）。
+                # 旧版不认这两种，尾字节 0x10 的记录落进 else 逐字节跳 → 整条指令名丢失且错位。
+                if b == 0x42 and rec[2] == 0x18:
                     # 段首非程序记录（不在任何网络里、无操作数），不是指令，整体吞 5B
                     i += 5
                     continue
@@ -420,7 +439,12 @@ def disasm(seg):
                             # 未识别记录若是标准 5 字节外形（尾字节 00），整吞，
                             # 不再逐字节跳：逐字节跳会让**后续所有记录整体错位**，
                             # 是指令序列与软件对不上的主要来源。
-                            i += 5 if rec[4] == 0x00 else 1
+                            # 2026-11-05：同时记进台账 + 行内留痕，不再静默消失。
+                            step = 5 if rec[4] == 0x00 else 1
+                            UNKNOWN_RECS.append((segno, li, rec[:step].hex(' ')))
+                            if step == 5:
+                                toks.append(f"〔?{rec[0]:02x}{rec[1]:02x}{rec[2]:02x}〕")
+                            i += step
         rows.append(" ".join(toks))
     return rows
 
@@ -436,6 +460,7 @@ def main():
 
     data = read_bytes(path)
     text = data.decode("ascii", "replace")
+    UNKNOWN_RECS.clear()
     lines = []
 
     # ---- 1. 结构 ----
@@ -514,11 +539,30 @@ def main():
                 spans.append((0, de0 + len("<DataEnd>"), nxt))
                 lines.append("  (本工程无 <SMT> 分段标记，按 Initial Value 块后的整块数据反汇编)")
     for si, ds, de in spans:
-        rows = disasm(data[ds:de])
+        rows = disasm(data[ds:de], si)
         lines.append(f"--- 段{si} ---")
         for li, r in enumerate(rows):
             lines.append(f"  行{li}: {r}")
 
+    # ---- 4.5 未识别记录台账 ----
+    lines.append("")
+    lines.append("=" * 60)
+    lines.append("【未识别记录（认不出→已跳过；指令表里缺的东西在这里查）】")
+    lines.append("=" * 60)
+    if not UNKNOWN_RECS:
+        lines.append("  无：本次解码的 5 字节记录全部落进已知指令/触点/操作数/填充。")
+    else:
+        agg = {}
+        for sg, li, hx in UNKNOWN_RECS:
+            agg.setdefault(hx, []).append((sg, li))
+        lines.append(f"  共 {len(UNKNOWN_RECS)} 条（{len(agg)} 种字节形态）：")
+        for hx, pos in sorted(agg.items(), key=lambda kv: -len(kv[1])):
+            where = "、".join(f"段{a}行{b}" for a, b in pos[:6])
+            more = f" 等 {len(pos)} 处" if len(pos) > 6 else ""
+            lines.append(f"  ×{len(pos):<4} {hx:<15} 首见 {where}{more}")
+        lines.append("  这些字节没被认成指令或触点，对应行里可能少了一条——拿字节形态去 WPLSoft")
+        lines.append("  指令表对照；核出来再补 COMPACT_NAMES / CMD_MAP，别按猜测直接补。")
+
     # ---- 5. 推断对照表 ----
     lines.append("")
     lines.append("=" * 60)

package/assets/decode-pack.mjs

@@ -75,7 +75,7 @@ export function writeSourcePack({ outd, kind, projName, projFile }) {
     nav += `\n## 怎么查（按问题挑一条，别整份读）\n\n`
     nav += `- 某段指令表 → 按下文「网络行号表」取段（行号＝解码报告里的行，从 1 起）\n`
     nav += `- 某地址在哪些网络出现 → grep 地址（如 \`grep -n "D2340" 解码报告.md\`），只读命中的那几行\n`
-    nav += `- 找中文注释/设备名/画面文本 → grep 全部字符串.txt\n\n`
+    nav += `- 找中文注释/设备名 → grep 解码报告.md（dvp 只出这一份文本，不生成 全部字符串.txt）\n\n`
     nav += `## 读法\n\n- **看程序**：台达 DVP 没有 pous/ST，程序就是 \`解码报告.md\` 的指令表（按 \`LD M1000\` 分网络，末尾 END）。\n- **AI**：目录里有 \`程序解读.md\` 就先读它（网络级功能地图＋I/O 表＋机制链＋未确证清单），再回指令表逐段核对。报告里 \`?名\`（如 \`?DRVI\`）与 \`?CMP(关系)\` 是**推断**指令名——报告末尾有「推断对照表」（码／推测名／依据／把握），拿它下结论前先核台达指令表；\`??xx\` 与 \`?CMP[六位]\` 是推断不出、保持未定的。\n- 读之前核对源工程文件修改时间是否与本次解码一致（工程一改，导出即过期）。\n`
 
     // 网络行号表：让 AI 能按行号取一段，而不是整份读报告

package/index.js

@@ -20,13 +20,29 @@ import { existsSync, mkdirSync, readFileSync, writeFileSync, readdirSync, statSy
 import { createHash } from 'node:crypto'
 import { inflateSync } from 'node:zlib'
 import { tmpdir } from 'node:os'
-import { basename, dirname, extname, join, resolve } from 'node:path'
+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'
 
 export const name = 'dsh-plc-decode'
 export const inject = ['tools', 'commands', 'shell', 'sandboxPolicy']
 
+/** 插件配置（DSH 官方 Config 机制：cordis.patch.yml 里本插件行的 config 传进 apply）。
+ *  2026-11-05 加：让装插件的人不改代码就能换解码产物的存放位置。 */
+export const Config = z.object({
+  archiveDir: z.string().default('解码归档')
+    .description('解码产物归档根目录。相对路径按当前会话工作区解析，绝对路径原样使用。默认「解码归档」。'),
+})
+
+/** 生效中的归档根目录；apply 时由 config.archiveDir 覆盖，未配置即默认值（与旧版行为一致）。 */
+let ARCHIVE_ROOT = '解码归档'
+
+/** 归档根目录的绝对路径：绝对路径原样用，相对路径拼会话工作区。 */
+function archiveRootPath(base) {
+  return isAbsolute(ARCHIVE_ROOT) ? ARCHIVE_ROOT : join(base || process.cwd(), ARCHIVE_ROOT)
+}
+
 const PY = 'python'
 const TIMEOUT_MS = 300_000
 /** 本插件自带的资源目录（smart 连线/网表脚本等） */
@@ -72,7 +88,7 @@ function defaultArchiveDir(file, base) {
     const siblings = readdirSync(dir).filter((n) => /\.(smart|smartlib|dvp|project)$/i.test(n))
     if (siblings.length > 1) name = `${folder}_${stem}`
   } catch { /* 读不到目录就退回文件名 */ }
-  return join(base || process.cwd(), '解码归档', name)
+  return join(archiveRootPath(base), name)
 }
 
 /** 把命令名后的原始输入按 shell 引号规则切成参数（支持带空格路径）。 */
@@ -105,7 +121,7 @@ async function shellResult(ctx, spec) {
 
 /** 通过 ctx.shell 前台运行一个 Python 脚本（继承会话沙箱策略 + WinError 5 重试一次）。 */
 async function runPy(ctx, script, args, workdir, signal, exec) {
-  const cmd = `& ${PY} ${psq(join(CODESYS_TOOLS_DIR, script))} ${args.map(psq).join(' ')}`
+  const cmd = `$env:PYTHONIOENCODING='utf-8'; & ${PY} ${psq(join(CODESYS_TOOLS_DIR, script))} ${args.map(psq).join(' ')}`
   const policy = ctx.sandboxPolicy && exec && exec.agent
     ? ctx.sandboxPolicy.resolve({ session: exec.agent.session })
     : undefined
@@ -197,9 +213,10 @@ function requireDvp(dvp, usage) {
   return abs
 }
 
-/** 预建输出目录及其子目录（治 WinError 5：目录存在时 python makedirs exist_ok 不再报错）。 */
-function precreateOutDir(outd) {
-  for (const sub of ['', 'extracted', 'pous']) {
+/** 预建输出目录及其子目录（治 WinError 5：目录存在时 python makedirs exist_ok 不再报错）。
+ *  2026-11-05：dvp 产物只有「解码报告.md」，不再为它建 extracted/、pous/ 两个空目录。 */
+function precreateOutDir(outd, kind = 'project') {
+  for (const sub of kind === 'dvp' ? [''] : ['', 'extracted', 'pous']) {
     try { mkdirSync(join(outd, sub), { recursive: true }) } catch { /* 留给 python */ }
   }
 }
@@ -209,7 +226,7 @@ function precreateOutDir(outd) {
 async function decodeCodesysProject(ctx, projPath, signal, exec, outDir, base) {
   const { abs, dir, kind } = requireProject(projPath, '需要一个 .project / .dvp 工程文件路径（带空格请加引号）')
   const outd = outDir || defaultArchiveDir(abs, base)
-  precreateOutDir(outd)
+  precreateOutDir(outd, kind)
   const result = kind === 'dvp'
     ? await runPy(ctx, 'dvp_decode.py', [abs, '-o', outd], dir, signal, exec)
     : await runPy(ctx, 'read_project.py', [abs, outd], dir, signal, exec)
@@ -2587,7 +2604,11 @@ async function runDiff(ctx, oldP, newP, signal, base) {
 
 // ───────────────────────── 应用注册 ─────────────────────────
 
-export function apply(ctx) {
+export function apply(ctx, config = {}) {
+  // 2026-11-05：读插件配置的归档根目录（config.archiveDir）。不配置时保持旧行为不变。
+  const cfg = config && typeof config === 'object' ? config : {}
+  if (typeof cfg.archiveDir === 'string' && cfg.archiveDir.trim()) ARCHIVE_ROOT = cfg.archiveDir.trim()
+
   // ── 工具一：统一入口（四格式自动识别分发）──
   ctx.tools.register({
     name: 'plc-decode',
@@ -2596,7 +2617,7 @@ export function apply(ctx) {
       type: 'object',
       properties: {
         file: { type: 'string', description: 'PLC 工程文件路径（.project/.dvp/.smart/.smartlib，绝对路径或相对当前工作目录）。' },
-        outDir: { type: 'string', description: '可选：输出目录；缺省写到工作区「解码归档\\<工程文件名>\\」（四格式一致，不写工程目录）。' },
+        outDir: { type: 'string', description: '可选：输出目录；缺省写到「<归档根>\\<工程所在文件夹名>\\」（归档根默认「解码归档」，可用插件配置 archiveDir 改，见 /plc-archive；四格式一致，不写工程目录）。' },
       },
       required: ['file'],
       additionalProperties: false,
@@ -2732,7 +2753,7 @@ export function apply(ctx) {
       properties: {
         old: { type: 'string', description: '旧工程 .smart 文件路径（绝对路径或相对工作目录）。' },
         new: { type: 'string', description: '新工程 .smart 文件路径。' },
-        outDir: { type: 'string', description: '可选：输出目录；缺省写到工作区「解码归档\\<新工程文件名>\\」。' },
+        outDir: { type: 'string', description: '可选：输出目录；缺省写到「<归档根>\\<新工程所在文件夹名>\\」（归档根默认「解码归档」，可用插件配置 archiveDir 改）。' },
       },
       required: ['old', 'new'],
       additionalProperties: false,
@@ -3195,6 +3216,28 @@ export function apply(ctx) {
   })
 
   // ── 命令 ──
+  ctx.commands.register({
+    name: 'plc-archive',
+    description: '查看解码归档地址：当前生效的根目录、默认落点、怎么改配置',
+    input: { hint: '（无参数）' },
+    handler: async () => ({
+      kind: 'success',
+      text: [
+        `当前生效的归档根目录: ${ARCHIVE_ROOT}`,
+        `解析方式: ${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/解码归档',
+        '',
+        '只改这一次、不写配置：解码时传 outDir 参数（工具参数或 /plc-decode 的第二个参数）。',
+      ].join('\n'),
+    }),
+  })
+
   ctx.commands.register({
     name: 'plc-decode',
     description: 'PLC 工程统一解码入口（自动识别 .project/.dvp/.smart/.smartlib）',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-plc-decode",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "在 DSH 里读 PLC 工程文件：CoDeSys .project、台达 .dvp、西门子 S7-200 SMART .smart/.smartlib 统一解码成可读报告与结构化数据，另带新旧工程对比、地址体检与连线还原。",
   "type": "module",
   "main": "index.js",

package/scripts/smoke.mjs

@@ -16,7 +16,7 @@ import { join } from 'node:path'
 import { apply, inject, name as pluginName } from '../index.js'
 
 const EXPECTED_TOOLS = 12
-const EXPECTED_COMMANDS = 11
+const EXPECTED_COMMANDS = 12
 
 let failed = 0
 const pass = (m) => console.log(`  ok   ${m}`)
@@ -32,7 +32,8 @@ const INDEX_FILES = {
 
 /**
  * 用子进程代替 DSH 的 shell 服务：插件只依赖 resolve/execute/result 三个方法，
- * 这里把命令交给 PowerShell 执行，输出按 GBK 解码（与 DSH shell 服务行为一致）。
+ * 这里把命令交给 PowerShell 执行。插件在 runPy 里钉了 PYTHONIOENCODING=utf-8，
+ * python 输出是 UTF-8，所以这里也按 UTF-8 解码（2026-11-05 前是 GBK）。
  */
 function createShell() {
   return {
@@ -43,14 +44,14 @@ function createShell() {
         ['-NoProfile', '-NonInteractive', '-Command', spec.command],
         { cwd: spec.workdir || process.cwd(), timeout: spec.timeoutMs, maxBuffer: 64 * 1024 * 1024, encoding: 'buffer' },
       )
-      const gbk = new TextDecoder('gb18030')
+      const utf8 = new TextDecoder('utf-8')
       return {
         result: async () => ({
           exitCode: r.status ?? 1,
           timedOut: r.error?.code === 'ETIMEDOUT',
           aborted: false,
-          stdout: { text: gbk.decode(r.stdout ?? Buffer.alloc(0)) },
-          stderr: { text: gbk.decode(r.stderr ?? Buffer.alloc(0)) },
+          stdout: { text: utf8.decode(r.stdout ?? Buffer.alloc(0)) },
+          stderr: { text: utf8.decode(r.stderr ?? Buffer.alloc(0)) },
         }),
       }
     },