<!-- PAYSKILL_UNIFORM v1 -->
付费说明（Pay Skill · 0.1 元/次）
本技能已接入支付宝 AI 按量付费（Pay Skill），每次成功调用收费 0.1 元，由 SkillHub / SkillPay 按次统一计费，采用支付宝 A2M 协议（HTTP 402 Payment Required）：未付费调用返回 402 与 Payment-Needed 账单，用户完成支付后凭 Payment-Proof 重试，平台完成验付与履约确认后返回结果（Payment-Validation）。订单按 out_trade_no 持久化并保证幂等，避免重复扣费。
西门子WINCC助手
一、你能解决的痛点
做 WinCC 项目，最耗时的往往不是画图，而是反复踩配置坑：Runtime 启动卡死、趋势数据断档、
报警不消除、变量表几百个手动建、HResult 错误码看不懂。本助手把这些问题收敛为 5 个确定性入口，
让你「查得到原因、生成得了产物、抄得了脚本」。
二、核心能力一览
| 命令 | 干什么 | 产出 |
|---|---|---|
decode |
报错解码：HResult 码 / 中文症状 → 原因+措施 | 终端排查指引 |
tag-import |
友好变量表 → TIA Portal 可导入 XLSX | Hmi Tags 表（15 列官方表头） |
alarm |
报警表 → Alarm Logging 组态表 | Alarm 表（触发变量/文本/优先级/类别） |
script |
生成常用 C/VBScript 动作模板 | .vbs / .c 源码 |
checklist |
运行启动/投运/备份/健康 检查清单 | 终端勾选清单 |
tips |
高频避坑与工程经验 | 终端技巧列表 |
三、四步上手（以变量批量导入为例）
- 导出现有变量表（或新建）为 CSV，列含：变量名,数据类型,地址,连接,变量表,注释（中文表头也认）。
- 运行转换：
python wincc_helper.py tag-import tags.csv --out tags_import.xlsx - 导入 TIA Portal：在「显示所有变量」中导入生成的 XLSX（工作表名固定
Hmi Tags，勿改）。 - 自动建表：系统按「变量表」列自动创建变量表并分配变量，省去逐个手建。
四、能力详表
- 报错解码库：内置 18 条官方 HResult 码（0x80004005 / 0x80046127 / 0x80040154 等）的原因与修复步骤；
支持 6 类症状关键词（Runtime启动失败、趋势断档、报警不消除、变量地址错误、画面卡死、备份）直接给排查链路。 - 变量导入器：识别中英文表头别名；数据类型自动归一（布尔→Bool、实数→Real、整型→Int…）；
输出 TIA Portal 要求的 15 列「Hmi Tags」表（Name/Connection/Data type/Address/Comment…），表头加粗、冻结首行。 - 报警组态器：触发变量/报警文本/优先级/报警类别/确认变量 结构化输出；提示「触发变量名须与 Tag Management 完全一致」。
- 脚本模板库：6 种高频动作——读变量、写变量（含
CDbl类型转换）、Excel 配方导入（含Close+Quit+Set NothingCOM 释放）、
报警确认、画面切换、C 标度动作；每条都带避坑注释。 - 检查清单：4 套勾选清单覆盖启动/投运/备份/健康；10 条实用技巧沉淀真实工程教训。
五、输出字段说明
- 变量表 XLSX 列：Name, Path, Connection, PLC tag, Data type, Length, Address, Access method,
HMI tag (display class), Acquisition cycle, Limit upper, Limit lower, Substitute value, Comment, Visible in HMI。 - 报警表 XLSX 列：触发变量(Trigger Tag), 报警文本(Message Text), 优先级(Priority), 报警类别(Class), 确认变量(Ack Tag), 注释。
六、适合谁用
- 做楼宇自控 / 暖通 / 能源管理 HMI 的自动化与电气工程师（如楼宇智能化集成商）。
- 维护西门子 WinCC 上位机、被 HResult 报错困扰的程序员。
- 需要把 PLC 变量批量导入 WinCC、批量配置报警的组态工程师。
七、⚠️ 注意事项
- 本助手生成的是工程辅助产物与知识指引，不替代西门子官方文档；导入前请备份项目
.mdf并在副本上先测。 tag-import默认输出 TIA Portal 版「Hmi Tags」XLSX；经典 WinCC（VarExim/配置工具）请用--csv导出后按官方列头整理。- 零依赖版不直接读 .xlsx/.xls 源文件，请先把变量表另存为
.csv再导入（避免引入第三方库）。 - 触发变量名务必与 WinCC Tag Management 中存在的变量完全一致，否则报警不触发、变量地址错误。
- 项目备份请使用 WinCC「项目复制器」，禁止在资源管理器直接复制项目文件夹（会破坏 GUID）。
八、触发词
西门子WINCC、WinCC报错、HResult、Runtime启动失败、WinCC趋势断档、报警不消除、变量导入、标签导入、
Hmi Tags、VarExim、TIA Portal 变量、报警组态、Alarm Logging、WinCC脚本、VBScript、C动作、配方导入、
WinCC调试、WinCC备份、SCADA排错、西门子上位机、工业HMI助手。
九、文件清单
SKILL.md：本说明examples/wincc_helper.md：完整可运行源码（纯标准库 CLI，含 XLSX 写入器与知识库）examples/usage.md：各子命令用法与参数examples/example_output.md：真实运行示例输出
进化记录
- 2026-08-26 v1.0.8（数据驱动自查更新）
- 同类标杆匹配：归入「professional」分类，基于平台头部技能榜匹配到 5 个同领域头部技能（如 A股量化 AkShare、专利初稿助手、Tax Policy Knowledge 财税政策知识库与风险合规助手），提取其高共识能力标签做补强。
- 标签已较完整，本次保持。
- 客户评分维度：经实测本批技能均为新建技能，平台评论/评分当前为空，本次以同类标杆特征驱动优化；后续将随真实使用数据持续迭代。
