From 85703f72f94b1a97c975819bd7ff1602d21c1899 Mon Sep 17 00:00:00 2001
From: suyu <1643689728@qq.com>
Date: Thu, 20 Aug 2026 12:46:01 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20=E8=A1=A5=E5=85=85=20HMI=20=E5=A4=96?=
 =?UTF-8?q?=E8=A7=82=E5=B7=A5=E7=A8=8B=E6=A0=BC=E5=BC=8F?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/工程格式说明.md                    | 11 +++++++++++
 docs/用户使用/数量边界确认方案.md |  1 +
 2 files changed, 12 insertions(+)

diff --git a/docs/工程格式说明.md b/docs/工程格式说明.md
index bd67235..1c791c9 100644
--- a/docs/工程格式说明.md
+++ b/docs/工程格式说明.md
@@ -39,6 +39,17 @@
 
 每个控件都要求 `id`、`type`、`bounds`、`text`、`binding` 和 `properties`。`bounds` 包含整数 `x`、`y`、`width`、`height`，矩形必须完整位于页面内。`binding` 为寄存器对象或 JSON `null`。
 
+`properties` 保存控件外观扩展属性。当前保留以下 HMI 外观属性名：
+
+| 属性名 | 值格式 | 说明 |
+| --- | --- | --- |
+| `textColor` | `#RRGGBB` 字符串 | 控件普通文字颜色，缺失时使用控件默认颜色 |
+| `fontSize` | `6~72` 的十进制数字字符串 | 控件文字字号 |
+| `fontBold` | `true` 或 `false` 字符串 | 是否使用粗体 |
+| `fontItalic` | `true` 或 `false` 字符串 | 是否使用斜体 |
+
+字体和颜色属于静态显示属性，不参与 M/D 绑定、PLC 轮询和离线控制逻辑。未知扩展属性仍按字符串保留。
+
 | `type` | 绑定 | 额外必填字段 |
 | --- | --- | --- |
 | `button` | M 地址或 `null` 草稿 | `buttonOperation` |
diff --git a/docs/用户使用/数量边界确认方案.md b/docs/用户使用/数量边界确认方案.md
index 1d04308..1d7ca37 100644
--- a/docs/用户使用/数量边界确认方案.md
+++ b/docs/用户使用/数量边界确认方案.md
@@ -20,6 +20,7 @@
 | HMI | 页面宽度、高度 | 1 | 8192 | 拒绝保存或加载 | 防止异常尺寸撑大画布 |
 | HMI | 控件宽度、高度 | 1 | 8192 | 拒绝保存或加载；控件还必须完整放在页面内 | 防止异常尺寸和越界绘制 |
 | HMI | 单控件扩展属性 | 0 对 | 64 对 | 第 65 对属性不能加载或保存 | 防止属性对象无限增长 |
+| HMI | 字号 | 6 | 72 | 拒绝保存、加载或编辑 | 控制文字可读性和控件布局开销 |
 | 报警 | 报警定义数量 | 0 | 512 | 第 513 条报警不能创建或加载 | 报警每个刷新周期都要判断 |
 | 注释 | M/D 软元件注释数量 | 0 | 8002 | 超出后拒绝保存或加载 | M0~M4000 和 D0~D4000 每个地址最多一条，共 8002 条 |
 | 控制逻辑 | 控制逻辑数量 | 0 | 128 | 第 129 组不能创建或加载 | 控制工程树和扫描工作量 |