dsh-plc-decode 0.2.1 → 0.2.3

package/assets/fstudio-i18n-workflow.md

@@ -1,165 +0,0 @@
-# FStudio 触摸屏多语言翻译 · 工作流
-
-适用：繁易 Flexem FStudio 的触摸屏工程（`.fsprj` + `HMI\Frame` + `Global\TextLibConfigInfo.cfg`）。
-目标：让画面上的文字随语种切换而变。
-
-## 一句话看清机制（先懂这个，省掉一半返工）
-
-FStudio 里画面文字的显示有**两条路**：
-
-1. **元件自带文字**：静态文本元件内部按语种分槽存字（`LanguageSN` 1 中文 / 2 英文 / 3 俄语），
-   切语种时软件自动取对应槽。**存的是字本身，不是引用**。
-2. **走文本库**：元件勾「使用文本库」并指向某条目，内容由文本库按语种提供。
-   同一个词在多处引用同一条，改一处全局生效。
-
-**实测经验**：这类工程的画面文字绝大多数走第 1 条路——库里只有几十条系统文本，元件上是写死的字。
-「切语种不变」的根因是：**字没进文本库，元件也没勾引用**。
-
-## 正确工作流（三步，别多）
-
-### 第 1 步 · 扫（一次扫全，别一页页看）
-插件工具 `fstudio-i18n`（或 `fstudio-scan-texts` 只看清单）。
-
-- 扫什么：`HMI\Frame\**\*.wcfg` 里**所有**带语种文字的元件，两条路都要收：
-  ① 静态文本：`StaticTextContentInfo` 的 `LanguageSN` + `LabelContent`；
-  ② 按钮/开关/指示灯：`Tag/Statuses/TagStatus/TagStatusLanguage` 的 `LanguageId` + `Text`。
-  **只扫 ① 会漏掉整批按钮标签**（2026-09-22 踩过：888 → 1899 个元件）。
-- 同时读 `Global\TextLibConfigInfo.cfg` 看库里已有什么。
-- 产出：`元件文本扫描.json` + 中文去重清单。
-
-### 第 2 步 · 译（口径先定，再动手）
-两条口径，开工前先问清用哪条（2026-09-22 一台设备上被改了三回）：
-
-- **定版优先（默认）**：词典译文一律覆盖元件里原有的英文，术语统一、机翻味清掉。
-  元件的原英文槽仍写进对照表第 6 列备查。
-- **原件优先**：元件里原本有英文的一律沿用，只补空白项；只有当原件英文属于
-  「词不达意 / 填错内容 / 张冠李戴」三类明显失误时才换成定版，并在表里标出来。
-  （判据集合见插件 `fstudio_i18n.py` 的 `FORCE_FIX`。）
-
-其余口径共通：
-- **元件里"中文标签 ↔ 英文标签"成对的要点**——那是工程自带的人工译文，可作译法参考。
-- 现场操作员扫一眼要懂；动词用设备惯用语（Start / Stop / Reset / Jog / Home）；
-  厂名音译（拓宇机械 → Tuoyu Machinery）；单位与代号按行业写法（mm、°/s、packs/min、S/N、DHCP IP）。
-- **注意**：原工程英文槽常有错填（同一画面几十条都写着 `current position`、`Platen`；
-  甚至有把数字 `8` 当英文的），那是串槽不是译文。
-- 外语比中文长、元件放不下的：按元件在屏上的可用宽度切成多行（真换行）；同一句中文全表一个切法（见入口技能「外语撑破控件就分段」）。
-
-### 包装机术语口径（纸品包装线，2026-09-22 定）
-先判断设备类型（画面名/工序词一看就知道），是包装机就按这套：
-
-**产品层级（量词别混）**
-| 实物 | 用词 | 说明 |
-|---|---|---|
-| 软抽小包（盒／包） | **pack** | 生产线成品单位；节拍写 `packs/min`（不要 boxes/min） |
-| 瓦楞外箱（箱） | **carton** | `carton infeed / opening / stop / press cylinder` |
-| 泛称"盒子" | 不用 box | box 是泛称，现场分不清层级；文档场景才用 |
-
-**工序词（按行业叫法）**
-| 中文 | 用 | 别用 |
-|---|---|---|
-| 上/下折封 | Top / Bottom folding seal | Top seal |
-| 折角 | Corner tuck | Corner fold |
-| 扯膜 | Film pull | Film tearing |
-| 下膜／上膜 | Bottom / Top film | Lower / Upper film |
-| 送卷、放卷 | Film unwind | Unwind speed |
-| 压纸输送 | Paper press conveyor | Platen conveying |
-| 推纸 | Paper pushing | Push paper |
-| 打码 / 冲孔 | Coding / Perforation | Coder / Punching |
-| 定长 / 追标 | Fixed length / Mark chasing | — |
-| 单光电 / 双光电 | Single / Dual photocell | Single sensor |
-| 测纸长 | Paper length measurement | Measure length |
-| 产品规格 | Pack height / width / length | Tissue height |
-
-仅校准工序与产品词；权限、网络、系统提示等非工艺词保持常规译法，别扩散。
-
-### 食品包装机术语口径（气调保鲜 / 转盘灌装封口，2026-09-28 定）
-先认设备：画面里有真空室、充气、封切的是**气调保鲜包装机**，有落杯/出杯/灌装/搅拌的是**转盘式灌装封口机**；同一工程的文本库常混着两类。
-
-| 中文 | 用 | 中文 | 用 |
-|---|---|---|---|
-| 真空 / 充气 | Vácuo / Injeção de gás | 杯 / 盒 | copo / embalagem |
-| 封切 / 封口 | Selagem e corte / Selagem | 落杯 / 出杯 | Queda do copo / Saída do copo |
-| 收膜 | Tração do filme | 灌装 / 搅拌 | Enchimento / Mistura |
-| 上真空室 | Câmara de vácuo superior | 打码 / 上胶 | Impressão de código / Colagem |
-| 顶盒 | Elevação da embalagem | 上料 / 光电 | Alimentação / Fotocélula |
-
-- **开／关成对词用同一词干 + Ligada/Desligada**（机械夹爪的开合用 Aberta/Fechada）。
-- 开＝`Atraso Inicial`、关＝`Tempo Final`（软件原本就是这套写法）；`权限N`＝`Permissão N`。
-- 葡语品牌词照抄不译：N2 / CO2 / O2 / OFF / ON / AT / I/O / WiFi / HMI / SD / Pen Drive。
-
-
-### 第 3 步 · 出导入表（格式由代码保证）
-`fstudio-i18n` 直接产出 `文本库导入表.xlsx`，列名与软件导出逐字符一致：
-
-```
-Guid | Name | Status | 1-Chinese (Simplified, PRC)-2052 | 2-English (United States)-1033
-```
-
-- 每行一个条目：Guid＝UUID4、Status＝数字 0（默认值节点）、Name 取中文前 50 字。
-- **第三语种按工程实际声明的语种来**（看 `HMI\System\LanguageConfigInfo.cfg` 的 `Lcid`），列名逐字符照抄、别自己拼；只有中英就别加。插件 `LANG_HEADS` 已备好常用列名：`pt` = `3-Portuguese (Brazil)-1046`、`pt-pt` = `3-Portuguese (Portugal)-2070`、`ko` = `3-Korean (Korea)-1042`、`ru` = `3-Russian (Russia)-1049`、`es`/`vi`/`th`/`ar` 同理。**换语种（如去韩语上葡语）时列名里的 LCID 必须与软件里加的语种一致**，否则导进去列对不上。
-- 多语词典写法：python 里加 `ELEMENT_PT`/`LONG_PT`（英表仍是 `ELEMENT_EN`/`LONG_EN`），或 json 写成 `{"en": {…}, "pt": {…}}`；只给英表就只出中英两列。
-- 导入：FStudio 文本库 → 导入 → 选这份表。
-- **状态要够数**：元件有 N 个状态（开关/指示灯/多状态按钮），挂库时取的是**库条目第 N 个状态**的内容；条目只有 1 个状态时，元件状态 1 就是空白（中文也空）。所以「开/关」「上一页/下一页」这类成对元件，条目必须做成多状态条目——导出表里表现为：首行带 Guid＋Status 0，后续状态行 **Guid 必须留空**＋Status 1/2、Name 与首行相同（重建/生成表时别顺手给后续状态行补 Guid，补了就不是同一条目的第二个状态了，2026-09-26 犯过、被用户当场看出）。单状态的元件用单状态条目即可；拿不准就把条目统一补到 2 状态，第二状态文字取成对词，没有成对词就与原状态同字（工程里原本就是这么写的：定位夹关→定位夹开 是成对，温度控制→温度控制 是同字）。
-- 导入后逐元件勾「使用文本库」指到条目（FStudio 使用手册 4.13.8 标签编辑器，p.570-571）。
-
-### 第 3 步的另一条路 · 已有导出表，只换语种列（retag）
-工程里文本库已经建好、软件也能导出表时**别重扫工程**，直接把导出的 TextLib 表整列换语种：
-
-```
-python <插件>/assets/fstudio_i18n.py retag <导出的TextLib表.xls> <输出.xlsx> <词典.json> pt 2
-# 或工具/命令：fstudio-retag <源表> <词典.json> [输出.xlsx] [语种键] [最少状态数]
-#                                                        ↑ 写 2 = 状态不够的条目补到 2 状态
-```
-
-- **只动第 6 列**：Guid、Name、Status、中文列、英文列逐行原样；多状态行的「首行带 Guid＋Status 0、后续行 Guid 留空＋Status 递增」结构照原样保留（软件导出的就是这个结构，别顺手给后续行补 Guid）。
-- 译文按**该行自己的中文列**取，不是按条目首行——多状态条目第二条常是成对词（成型关→成型开 译成 `Moldagem Desligada` / `Moldagem Ligada`）。
-- **状态数不够就补（最少状态数参数）**：屏上开关/指示灯是双状态元件，库条目只有一个状态时状态 1 会显示空白。补出来的行 Guid 留空、Status 递增、各语种文字与**首行相同**（软件导出的表里就是这么写的，不自己造词）。
-- 交付前机器校验四条：行数一致、前 5 列逐行一致、第三列无空/无汉字/无旧语种残留、抄参考表的译文与参考表逐字一致。
-
-### 要保留原表格式：就地改，走 Excel COM
-换语种列若要求「格式与原表一致」（用户会这么说），别用 xlwt/openpyxl 另存——**用 Excel COM 打开原件改再保存**，列宽/字体/合并等原样保留。要点与坑：
-
-- 改前先备份原件（`*.原件备份.xls`），中途出错直接从备份恢复重做。
-- **`Rows.Insert` 的 CopyOrigin 只管格式来源，不搬内容**——新行是空的，得自己把上一行的 `Range(...).Value` 搬过去（第一版只设了 CopyOrigin，三行全空，被"缺译 3"提示逮住）。插多行时**从下往上插**，行号才不漂。
-- 批量写值要**整块赋值**（`Range(A1:A9).Value = tuple(...)`），逐格 COM 往返慢十倍。
-- 写完 Excel 会把列宽/行高按字符重算（列宽 ±10/256 字符、行高 255→250 twips）：列宽用 `Columns(c).ColumnWidth = 原值`（Excel 单位）写回，行高用 `Rows("1:N").RowHeight = 12.75`（=255 twips）写回，写回后与原件一致。
-- 判"格式一致"要用 Excel 的口径（COM 读 `ColumnWidth`/`RowHeight`），别拿 xlrd 的 1/256 原始值硬比——那是文件内部表示，差几十分之一字符是重存的取整差。
-- 控件：`DispatchEx("Excel.Application")` 开独立实例、`Visible=False`、`DisplayAlerts=False`，`finally` 里 `Quit()`；别 `taskkill excel`（用户可能自己开着 Excel）。
-- **词典不一定要留**：改好的表里「中文列 ↔ 目标语种列」本身就是词典，要复用就从成品表反推，不必额外存一份。
-
-## 踩过的坑（照这个避）
-
-| 坑 | 现象 | 正解 |
-|---|---|---|
-| 列名不一致 | 导入报「文件格式不正确」 | 表头逐字符对；第 4 列是中英混排长名，不能写成「中文」 |
-| 以为要逐页看 | 大量时间翻画面 | 元件文本一次全扫，上千条几秒出 |
-| 拿元件英文槽当译文 | 译文一堆重复的 current position / Platen | 先查"同一英文被多少中文共用"，共用多的是串槽，按中文重译 |
-| 自己造表 | 交出去导不进 | 用插件出表，格式由代码保证 |
-| 一次交多个表 | "怎么又三个表格" | **只交最终能用的那一份**；对照表仅在你需要核对时才给 |
-| 「切韩语/俄语什么都不显示」 | 文本库三语都填了，屏上还是空白 | 按顺序查三处：① **元件语种槽有没有字**（本机实测 494 个元件只有 30 个韩文槽有字，275 个连韩语槽都没有）；② **元件有没有勾「使用文本库」**（30 个画面里只有 4 个用到库，光导库画面上什么都没变）；③ **该语种的字体**——工程 `HMI\System\LanguageConfigInfo.cfg` 每行一个字体，实测三行的字体类型都是「图形字体」（＝按字符串截位图存工程，多语种拿不到字模），且韩语行写的 `Microsoft YaHei` 经 cmap 表实测**不含韩文**（宋体、Arial 也不含；Malgun Gothic 含）。正解：该语种字体类型改**矢量字体**、字体换成含目标语言的（韩文用 Malgun Gothic），再重新下载工程（字模随工程打包）。判据：读字体文件 cmap 表查 U+AC00（韩文）／U+0400（西里尔）是否在覆盖区间内 |
-| 以为元件"挂了库"就会跟着库翻译 | 数出一堆带 TextLibId 的元件，以为导入文本库就能上英文 | 拷贝元件会连着上一条的 `TextLibId` 一起复制。先把每个 TextLibId 解到条目、与元件自身文字比对：对不上的就是拷贝残留（本机实测 494 个元件里 107 个带 TextLibId，98 个能解出条目，其中 **97 个全指向同一条**）。导入库≠上屏，还要逐元件勾「使用文本库」 |
-| 默认带俄语 | "不需要俄语" | 先确认语言范围；不要就不出那列 |
-| 译文写死在脚本里 | 改词要动代码 | 词典单独一个文件（`ELEMENT_EN`/`LONG_EN` 或 json），脚本只调用 |
-
-## 交付约定
-
-- 交付目录（你取用处）**只放最终可用件**：`文本库导入表.xlsx`。
-- 过程件（扫描 JSON、对照表、脚本）留在 `解码归档\<工程名>\` 或插件内。
-- 工程原件只读；不写 `Global\TextLibConfigInfo.cfg`、不改 `.wcfg`。
-
-## 词典
-
-插件不带词典也能跑（会列出缺译文的中文条目）。给某台设备配词典就写一个 py 文件：
-
-```python
-ELEMENT_EN = {"拓宇机械": "Tuoyu Machinery", "进料1速度": "Feed 1 speed"}
-LONG_EN = {"说明：...": "Note: ..."}   # 长句放这里
-ELEMENT_PT = {"定位夹": "Garra de Posicionamento"}   # 第三语种按语种键命名：PT / KO / RU / ES…
-LONG_PT = {}
-```
-
-```json
-{"en": {"启动1": "Start 1"}, "pt": {"启动1": "Partida 1"}}
-```
-
-再用 `fstudio-i18n` / `fstudio-retag` 的 `dict` 参数传入。

package/assets/nb-textlib-workflow.md

@@ -1,93 +0,0 @@
-# NB 系列触摸屏文本库翻译（.nbp / .whe）
-
-`拓宇`这类用 NB 软件做的屏，工程是 `.nbp`（主工程 XML）＋ `HMI0\HMI0.whe`（画面 XML），
-文本库另导出成 `TextLib.csv`。三个文件都是纯文本，可直接解析，不需要开软件。
-
-## 一、认格式
-
-- `.nbp`：`<NBProject DBVersion="...">`，画面内容不在这里，只存工程设置与 PLC 配置。
-- `.whe`：`<HMI>` → `<Frames>` → `<Window ProjectID Name>` → `<Parts>` → `<Part Type=...>` → `<Lable>`。
-  22 个画面，系统画面名是英文（Login Window、HEX/ASCII/NUM Keyboard、Confirm Action Window 等）。
-- `TextLib.csv`：UTF-16LE + BOM，**LF** 换行，四列制表符＋双引号，条目之间空行。
-  结构是每组：`"Name:"\t"条目名"` / `"Status:"\t"状态数"` / `"Language"\t"Language1"\t"Language2"\t"Language3"` / 若干数据行。
-- 数据行里的 `$_return_$$_enter_$` 是软件内的换行控制符（不是字面量），原版英文靠它分行。
-
-## 二、走库怎么判（最容易判错的一处）
-
-元件文字全在 `<Lable>` 里，两个属性决定：
-
-- `UseTextLibrary="Yes"` / `"No"`
-- `LibraryTextName="条目名"`（对应 CSV 的 `"Name:"`，不是中文列）
-
-**勾了库 ≠ 走库**：必须再核 `LibraryTextName` 是否真的在库条目名里。条目不存在时，软件回退显示
-`<Font>` 里内嵌的字，屏上看着正常、切换语种却不变——和没走库一个效果，肉眼看不出来。
-
-判定顺序：
-
-1. `UseTextLibrary=Yes` 且库里有该条目 → 正常走库，跳过。
-2. `UseTextLibrary=Yes` 但库里查无此条目 → **假走库**，当作翻不到处理。
-3. `UseTextLibrary=No` → 未走库。文字在 `<Font>文字</Font>`；多状态元件每个 `<State>` 一组。
-
-## 三、扫什么
-
-- 遍历**所有** `<Lable>`：静态标签、按钮、开关、指示灯的文字都在这，别只扫一种元件。
-- 系统画面（画面名是英文的那批）不管。
-- IO 地址标注（纯编号如 `100.03`、`0.9`）不管。
-- 报警单独看，见第六节。
-
-## 四、翻译口径
-
-- 字典优先：中文命中字典的逐字照用，不改写、不压缩、不换同义词。
-- 字典没有的：英文保留原版英文（不是我造的），第三语种留空，绝不自行翻译。
-- 字典备注列写「请删除」的条目：不翻、保持原样，也不进缺译表。
-- 原文本身是英文（中文列不含汉字）的条目：三语填同一个值。
-- 纯英文且没勾库的控件文字：不管。
-- 原版英文含 `$_return_$$_enter_$` 时：译文单行显示宽度超过原版最长行才按原行数在空格处切分
-  （全角字符按 2 计宽），不改变文字内容。
-
-## 五、缺译清单
-
-- 固定三列：中文 / 英文 / 韩语，没有的留空；按中文去重（一源一译）。
-- 内容 = 库内缺译（英文空或第三语种空）+ 翻不到的控件文字（未勾库的 + 假走库的）。
-- 已在库内缺译里出现的中文不重复列。
-
-## 六、报警
-
-- `.nbp` 里 `<AlarmObjects>` / `<EventObjects>` / `<Event>` 都是空节点 = 没有自定义报警/事件配置。
-- 屏上的报警通常是 Word Lamp 读某个文本库条目的状态字（状态显示类）。要核条目 `Status` 是否
-  覆盖元件 `StateCount`，不够时多出来的状态会显示空白。
-
-## 七、切了语种显示不出目标语言（韩文/日文/俄文）
-
-文字有没有、走不走库都正常，但切过去画面上不出字——按下面四处依次断，四处都通才显示：
-
-1. **语种槽有没有字**：`.nbp` 的 `<TextObjects>/<LableText>/<States>/<State>` 下 `<Text>` 的个数＝语种数，
-   第 N 个就是语种 N。某语种槽空＝切过去空白。
-2. **字体有没有该语种的字形**（最常见的一处）：
-   - 语种默认字体在 `.nbp` 的 `<DefaultLangFontInfo>`，几条 `<VectorFont>` 就是几个语种；
-   - 元件标签的三语字体在 `.whe` 的 `<Lable>/<Text>/<VectorFontList>`，三个 `<VectorFont>` 按语种顺序；
-   - 这两处字体名一样、且该字体不含目标语种字形，就画不出来（软件用方格或空白顶上）。
-   - 软件自带向量字体清单在 `<安装目录>\vectorfonts.xml`，按语种给默认字体：
-     **DFHEI5＝简体中文（20976 汉字、0 谚文）**、DFNB-TW＝繁体、DFNB-EN＝西文、
-     **DFNB-KR＝韩文（2350 个韩文音节）**、DFNB-JP / DFGNB-JP / DFPNB-JP＝日文。
-   - 核对办法：读 ttf 的 cmap 数 U+AC00–U+D7A3 有没有字形，比看字体名可靠。
-3. **下载包里带没带**：编译输出 `tar\HMI0\font_*.ttf` 是按工程实际用到的字裁出来的子集。
-   里面没有目标语种字形，屏上一样不显示——改完字体必须重新编译下载。
-4. **切语种入口**：运行时靠 LW9130 切语种（`LW9130＝语种序号−1`，0 起）；切语种的画面上要有对应按钮，
-   否则屏上没法切过去。
-
-改字体：
-
-- 入口：【HMI 属性】→【触摸屏扩展属性】→【语种设置】（文本库窗口里也能进）→ 当前编辑语种 →
-  字体类型选矢量字体 → 字体属性里选该语种字体。
-- 【语种设置】**不会**改已有元件标签的字体。两种刷新法：
-  ① 逐个元件把【标签】页「使用文本库」取消勾选再勾上；
-  ② 把工程当前编辑语种切到该语种，全选元件，用字体工具栏统一设字体（工具栏改的是当前状态、当前语种）。
-- 韩文字形 2350 个，改完屏端字体体积会明显变大，下载前留意屏的存储余量。
-
-## 八、改文件
-
-- 只改数据行第 3、4 列（英文、第三语种），中文列与全部结构行原样；写回 UTF-16LE+BOM、LF。
-- 改前先把原件备份到独立目录（保留原相对路径），再动导出表。
-- 目标 xlsx 正被 Excel 打开时：用 COM 连活动实例（`Get-ActiveObject`），**先查 `Saved=True`** 再改；
-  有未保存改动就不动，问用户。改完 `Workbook.Save()`，不要 `Quit`。

package/assets/wincc-text-i18n-workflow.md

@@ -1,96 +0,0 @@
-# wincc-text-i18n-workflow —— 西门子触摸屏项目文本翻译
-
-`Screens.xls / Others.xls / Messages.xls` 是 WinCC flexible（SMART）把工程文字按「画面 / 其它 / 报警」三处导出成的 Excel。英文列多半是半成品：有的空着，有的还是中文，更多是**串位**——这类表不能当成"填空"，得当校对。
-
-## 一、格式契约（动之前先认清这四条）
-
-- 第 1 行 `$_Languages`，第 2 行是语言名（第 1 列＝源语言，第 2 列＝目标语言），第 3 行 `$_Typ(...)`，再几行 `//` 注释。
-- **第 1 列是匹配键**：导入时按它回工程里找对应文本。改一个字，那一行就对不上、白改。所以只改第 2 列。
-- 文本通常被 `<text>…</text>` 包着；**换行是真换行**（Excel 单元格里 Alt+Enter 那种），不是字面 `\n`。映射文件里用 `\n` 表示，脚本读入时还原。
-- 目标列出现 `$_ignore`：这句源文本在工程里已经有多个不同译文，导出时被替换掉了。**它不是"不用翻"，照样译、照样填进目标列**（空文本 `<text />`、纯符号/缩写除外）。导入时软件若仍按多译文冲突跳过，那几处屏上才不会变，这时才需要进工程手动统一。留着 `$_ignore` 交给用户＝表里还是中文，等于没翻。
-
-## 二、四步
-
-1. `scan`：出「待译清单.tsv」＋「分型报告.md」。
-2. 逐条出译文，写成 `map.tsv`（一列中文原文、一列英文，制表符分隔）。
-3. `apply`：回写目标列，出**同扩展名**.xls。
-4. `check`：键列没动、没有未译、没有残留 `$_ignore`、没有串位（源无中文而译文更长）、没有一源多译。
-
-工具：`wincc-text-i18n`，`action=scan | apply | check`。
-
-## 三、分型只解决一半
-
-scan 判得出来的是：空译、中文残留、`$_ignore`、非中文同形（编号／日期格式）、**编号行挂词**——源文本不含中文（纯编号／代号）而译文更长的行。这一类就是串位：别行的功能词落到这一行了，按「源只有编号，译文也只留编号」处理；日期格式串（`yyyy-M-d H:mm:ss`）两列本来就不一样，不算。
-
-判不出来的仍是错译：中文对得上、译文却是另一个意思的那种，必须逐行看一遍。错译常见的三种样子：
-
-- 同类多行共用一句：`Q80~Q87` 全写 `Q15 Jet Glue 1`，`I80~I87` 全写 `I20`。
-- 上一行的话落到下一行：`Q20~Q27` 写着 `Q0 / Q1 / Q2 / Q3 Reject…`，那是 Q3~Q7 的。
-- 明显张冠李戴：`拓宇LOOG` → `Air pressure alarm Off`，`返回` → `Adjustment Screen`，`中性` → `Air pressure alarm On`。
-
-## 四、几条判据
-
-- **字典优先于模型译法**：用户给了字典文件（中文→英文的对照表）时，字典里有的条目逐字照用——不为词形统一而改写、不为屏宽而压缩、不换同义词；只有字典里没有的条目才自行翻译。字典里没有的条目，外语撑不住控件时按控件宽度切成多行（见入口技能「外语撑破控件就分段」）。字典自身可能一词多形（`Bag Opening Servo` 与 `Bag Open Servo Not Reset` 并存），按条目各照原样，不做全局统一。写回 XML 文本节点时 `&`/`<`/`>` 用实体（`&amp;` 等），导入后还原成原字符。
-- **以中文为准**。英文顺不顺口是次要的，和中文对得上才要紧。
-- 用户给的字典文件可能一表多语且列位错开（实测 `HMI information .xls`：中文在 A、英文在 B、越南语前半段在 G、报警段错到 K），取某语种时两列都要读，别只看一列就下"字典没有"的结论。
-- **一源一译**：同一句中文，全表只能有一个英文。同一文本两种译法，导回工程就产生多译文，下次再导出又变成 `$_ignore`，越改越乱。
-- **I/O 点位中文只写编号的，英文也只写编号**。别拿英文列里的话反推功能——那多半是别行串过来的。中文写了功能的（`Q5剔废`），才补功能。
-- 历史用词能用就不动（`Coder` 不改 `Encoder`），免得现场对不上。
-- 型号、电话、日期格式、公司名：原样，不翻译。
-- 地址这类改过的信息，以中文那一条为准重译，英文里常留着旧厂址。
-
-## 五、术语表（这台包装机的固定译法）
-
-| 中文 | 英文 |
-|---|---|
-| 工位 | Station |
-| 位置 | Position |
-| 吸盒 | Suck carton |
-| 走盒 | Carton feed |
-| 顶盒 | top box |
-| 联机 | Online |
-| 剔废 | Reject |
-| 堵料 | Jam |
-| 飞料 | Flying material |
-| 整料 | whole material |
-| 加料 | Feeding |
-| 测料 | Product detection |
-| 测盒 | Carton detection |
-| 测高 | Height detection |
-| 喷胶 | Glue spray |
-| 备用 | Backup |
-| 缺盒 | Carton shortage |
-| 缺纸 | Paper lack |
-| 光电 | sensor |
-
-一句里的拼法：`xxx Station`／`xxx Position` 与中文的「xxx工位／xxx位置」一一对应；`xxx开／关` 写成两行 `xxx` + `On`／`Off`，与源里的真换行对齐。
-
-## 六、出表细节
-
-- **产物写回源文件同路径、同名覆盖**，不要新建「翻译_项目文本」之类的目录另存——用户按原路径找文件，挪走或改名他就找不到。覆盖前先备份原件（项目侧放工作区 `_过程产物\`，不在源目录堆 `.bak`）。附加件（对照表等）放 `_过程产物`，不污染源目录。
-- **只改目标单元格，别整表重写**：`xlwt` 重建整表会吞行（实测 394 行写完剩 393，之后整表错位），也会丢掉别的列。`apply` 默认走 Excel COM：复制源表 → 只改变化的格子（PowerShell 调 `Excel.Application`，不需要 pywin32）→ `Save`，行数、列数、格式、其他列全原样；没有 Excel 才退到 xlwt，且写完回读核对行数与键列，对不上直接报错。
-- 必须出 **.xls**：软件的导入对话框按扩展名过滤，给 .xlsx 会选不到。
-- 新版导出表会带第 3 列元件路径（`\设备_1\HmiScreenFolder\…`），能定位这句文字在哪个画面——别丢。
-- 写 `.xls` 首选 Excel COM（`apply` 内置，Windows 有 Excel 就能用），无 Excel 时用 `xlwt`（`<python> -m pip install xlwt`）；读 .xls 借 LibreOffice Kit 转 xlsx。LibreOffice Kit 只能 xls→xlsx，不能 xlsx→xls，别拿它当写 .xls 的退路。
-- 空列照写：原表有几列，产物就几列。
-
-## 七、交付前必须交代的一件事：导入≠保存
-
-项目文本导入只改内存里的工程，**不保存工程就等于没导**——关掉重开就回到上次保存的版本，屏上还是中文。判断有没有真写进去，看同目录 `.hmismart` 的修改时间：导入并保存后会变成刚才的时间，不变就是没保存。
-
-**复核要拿工程重新导出的表来核，不能核自己手里那份。** 自己的表里全对，只说明表对；工程里对没对，要让它自己导一份出来比。工程重新导出时，第 5 行的导出时间注释会变（`//$_导出…`），比对键列时把这类注释行排除。
-
-所以交付话术里固定三步：导入 → **保存工程** → 点「刷新」复核。
-另外两个会让人误判的点：
-
-- 项目文本列表打开后不自动刷新，导入完要手动点「刷新」才看到新值。
-- 工程里存在多译文冲突时，导出表会多出一行 `//至少一个文本存在多种不同的翻译…`。等这些条目被统一后，这行注释会消失、表少一行——这不是格式坏了，是冲突清掉了。
-
-## 八、导入与导出按文本类型分开，一次一类
-
-Screens（画面）、Others（其它）、Messages（报警）是**三个独立文件**：导出时按类型各出一个文件，导入时一次只吃一个文件（软件按文件里的 `$_Typ` 判断类别）。所以：
-
-- 导回一个工程要**分别导三次**（Screens.xls、Others.xls、Messages.xls），只导一个文件，另外两类的屏上文字仍是原文。
-- 导出同理：切换文本类型分别导，或导出后确认目录里三个文件都在。
-- 导出日志（输出窗口）会逐类打印 `导出: 画面 / 导出: Others`，可以据此核对有没有漏类。
-