Initial commit

Agents/更新-signal-table-excel-generator-design-v2-两表生成器文档.md

@@ -0,0 +1,53 @@
+# 更新 `signal-table-excel-generator-design.md` 为 v2 两表生成器文档
+
+## Summary
+- 只更新 Markdown 设计/测试文档，不编写代码。
+- 文档目标改为：前端网页用于维护设备和变量配置，点击“生成”后导出标准 Excel。
+- 最终 Excel 只包含两个 Sheet：
+  - `MES_基本变量原始数据`
+  - `设备类型对应表`
+- 页面参考微信双栏结构：左侧是设备列表，点击某一行设备/工位，右侧显示该工位对应的基本变量详情。
+
+## Key Changes
+- 删除文档中所有“五个 Sheet”相关内容，包括：
+  - `工厂接口配置`
+  - `变量类型代码说明`
+  - `配置_信号`
+- 重写 Excel 结构说明：
+  - `设备类型对应表` 作为左侧设备/工位配置的数据来源。
+  - `MES_基本变量原始数据` 作为右侧基本变量详情的数据来源。
+- 左侧设备创建表字段先定义为：
+  - `设备名称`
+  - `工位名称`
+  - `设备型号`
+  - `设备IP`
+  - `是否启用`
+- 文档中注明：为了兼容现有 SCADA，导出 Excel 时 `设备类型对应表` 仍需要保留程序必读列，如 `DB`、`数据来源`；但第一版页面主界面先不展示，可作为默认值或后续高级字段补充。
+- 页面行为写清楚：
+  - 左侧一行代表一个设备/工位。
+  - 点击左侧某一行，右侧切换显示该工位的基本变量。
+  - 交互方式参考微信：左侧列表选中项高亮，右侧展示详情。
+  - 未选择设备时，右侧显示空状态。
+- 文档明确后续规则：
+  - 没有明确要求时，只更新 `.md` 文档。
+  - 不主动进行 Vue 代码实现。
+
+## Test Plan
+- 创建设备后，左侧列表出现一行新设备。
+- 编辑设备后，左侧对应字段同步更新。
+- 删除设备后，左侧列表移除该设备。
+- 禁用设备后，导出 Excel 中 `是否启用` 为 `0`。
+- 点击左侧不同工位，右侧显示对应工位的基本变量。
+- 未选择左侧设备时，右侧显示空状态。
+- 导出的 Excel 只包含两个 Sheet。
+- `MES_基本变量原始数据` Sheet 名称必须完全一致。
+- `设备类型对应表` Sheet 名称必须完全一致。
+- 导出前校验设备名称、工位名称、设备型号、设备IP不能为空。
+- 导出的文件能被当前 SCADA 项目读取。
+
+## Assumptions
+- 当前只更新设计文档，不改 Vue 源码。
+- 第一版网页主界面只展示用户指定的 5 个设备字段。
+- Excel 导出只生成两个 Sheet。
+- 右侧基本变量详情由左侧选中的工位触发显示。
+- 页面布局参考微信双栏交互：左侧列表，右侧详情。