feat: 新增 target description 字段，收紧 id/name 长度，调整延迟列和名称列

openspec/specs/probe-api/spec.md

@@ -17,7 +17,11 @@
 
 #### Scenario: targets 字段
 - **WHEN** Dashboard 响应包含 targets
-- **THEN** targets 数组中每个元素 SHALL 包含目标基本信息（id、name、group、type、target、interval）、latestCheck、stats、currentStreak 和 recentSamples 字段
+- **THEN** targets 数组中每个元素 SHALL 包含目标基本信息（id、name、description、group、type、target、interval）、latestCheck、stats、currentStreak 和 recentSamples 字段，其中 description 为 null 或字符串
+
+#### Scenario: target description 字段
+- **WHEN** 某个 target 配置了 `description`
+- **THEN** Dashboard targets 响应中对应元素 SHALL 返回该 description 值
 
 #### Scenario: window 参数缺失
 - **WHEN** 客户端请求 `GET /api/dashboard` 未提供 window 参数
@@ -105,7 +109,7 @@ Dashboard API SHALL 返回基于时间窗口计算的目标统计和连续状态
 
 #### Scenario: TargetStatus 类型
 - **WHEN** 前后端共享 `TargetStatus` 类型
-- **THEN** 该类型 SHALL 包含 stats（totalChecks、upChecks、downChecks、availability）、currentStreak 和 recentSamples 字段
+- **THEN** 该类型 SHALL 包含目标基本信息字段（id、name、description、group、type、target、interval）、stats（totalChecks、upChecks、downChecks、availability）、currentStreak 和 recentSamples 字段，其中 description 类型为 null 或字符串
 
 #### Scenario: TargetMetricsResponse 类型
 - **WHEN** 前后端共享 `TargetMetricsResponse` 类型

openspec/specs/probe-config/spec.md

@@ -328,3 +328,45 @@
 #### Scenario: dataDir 使用默认值
 - **WHEN** 未配置 `server.dataDir`（使用默认值 `./data`）
 - **THEN** 系统 SHALL 将默认值 `./data` 基于 configDir 解析为绝对路径
+
+### Requirement: target 通用元信息字段约束
+系统 SHALL 在 YAML target 通用字段中支持 `description` 字段，并对 `id`、`name` 和 `description` 执行契约校验。`id` MUST 为 1 到 30 个字符，显式 `name` MUST 为 1 到 30 个字符，`description` MUST 不超过 500 个字符且 MAY 为空字符串。
+
+#### Scenario: description 字段解析
+- **WHEN** 系统读取包含 `description: "检查生产 API 健康状态"` 的 target
+- **THEN** 系统 SHALL 将该字段解析为 target 的目标说明
+
+#### Scenario: description 为空字符串
+- **WHEN** 系统读取包含 `description: ""` 的 target
+- **THEN** 系统 SHALL 接受该配置，且不触发长度错误
+
+#### Scenario: description 类型非法
+- **WHEN** YAML 中某个 target 的 `description` 字段不是字符串
+- **THEN** 系统 SHALL 以错误退出，提示 description 字段类型错误
+
+#### Scenario: description 超过最大长度
+- **WHEN** YAML 中某个 target 的 `description` 字段超过 500 个字符
+- **THEN** 系统 SHALL 以错误退出，提示 description 字段长度错误
+
+#### Scenario: id 超过最大长度
+- **WHEN** YAML 中某个 target 的 `id` 字段超过 30 个字符
+- **THEN** 系统 SHALL 以错误退出，提示 id 字段长度错误
+
+#### Scenario: name 超过最大长度
+- **WHEN** YAML 中某个 target 的 `name` 字段超过 30 个字符
+- **THEN** 系统 SHALL 以错误退出，提示 name 字段长度错误
+
+#### Scenario: 变量替换后 description 超长
+- **WHEN** target 的 `description` 通过变量替换后超过 500 个字符
+- **THEN** 系统 SHALL 在契约校验阶段以错误退出，提示 description 字段长度错误
+
+### Requirement: 配置 schema 导出包含 target 元信息约束
+系统 SHALL 在导出的 `probe-config.schema.json` 中包含 target `id`、`name` 和 `description` 的长度约束，用于编辑器提示和外部校验。
+
+#### Scenario: schema 导出 description
+- **WHEN** 系统导出 `probe-config.schema.json`
+- **THEN** target schema SHALL 包含可选的 `description` 字段，类型为 string，最大长度为 500
+
+#### Scenario: schema 导出 id 和 name 长度
+- **WHEN** 系统导出 `probe-config.schema.json`
+- **THEN** target schema SHALL 声明 `id` 的 minLength 为 1、maxLength 为 30，并声明 `name` 的 minLength 为 1、maxLength 为 30

openspec/specs/probe-data-store/spec.md

@@ -26,15 +26,19 @@
 - **THEN** check_results 表的外键约束 SHALL 使用 `ON DELETE CASCADE`，确保删除目标时自动清理关联结果记录
 
 ### Requirement: targets 表同步
-系统 SHALL 在启动时将 YAML 配置中的目标列表同步到 SQLite targets 表，并持久化 target 类型、展示摘要、领域配置、调度配置、expect 配置和分组信息。
+系统 SHALL 在启动时将 YAML 配置中的目标列表同步到 SQLite targets 表，并持久化 target 类型、展示摘要、领域配置、调度配置、expect 配置、分组信息和目标说明。
 
 #### Scenario: 首次同步目标
 - **WHEN** 数据库为空且 YAML 中定义了 N 个 typed target
-- **THEN** 系统 SHALL 将所有目标插入 targets 表，包含 name、type、target、config、interval_ms、timeout_ms、expect 和 grp
+- **THEN** 系统 SHALL 将所有目标插入 targets 表，包含 name、description、type、target、config、interval_ms、timeout_ms、expect 和 grp
 
 #### Scenario: 配置变更后重新同步
 - **WHEN** YAML 配置发生变更（新增、删除或修改目标）后重启
-- **THEN** 系统 SHALL 根据 id 字段匹配：新增的插入、删除的移除、修改的更新（含 grp 字段）
+- **THEN** 系统 SHALL 根据 id 字段匹配：新增的插入、删除的移除、修改的更新（含 description 和 grp 字段）
+
+#### Scenario: 未配置 description
+- **WHEN** YAML target 未配置 `description`
+- **THEN** targets 表 SHALL 将该目标的 description 存储为 NULL
 
 ### Requirement: check_results 表追加写入
 系统 SHALL 将每次检查结果追加写入 check_results 表，不更新或删除已有记录。

openspec/specs/target-detail-drawer/spec.md

@@ -215,7 +215,11 @@ Drawer 内部 SHALL 使用 TDesign Tabs 组织概览和记录两个面板。Tabs
 
 #### Scenario: 基本信息内容
 - **WHEN** 概览面板渲染
-- **THEN** Descriptions SHALL 展示：目标地址、检查间隔、最新检查时间、状态详情
+- **THEN** Descriptions SHALL 展示：目标地址、检查间隔、最新检查时间、状态详情、描述，其中描述 SHALL 位于最后一行
+
+#### Scenario: 描述行占满整行
+- **WHEN** 概览面板渲染基本信息
+- **THEN** 描述项 SHALL 占据 Descriptions 的一整行，内容 SHALL 使用 `target.description ?? ""`，即使 description 为空也 SHALL 渲染该项
 
 #### Scenario: 统计区上下布局卡片
 - **WHEN** 概览面板渲染且有统计数据

openspec/specs/target-identity/spec.md

@@ -5,7 +5,7 @@
 ## Requirements
 
 ### Requirement: target id 字段
-每个 target SHALL 包含必填的 `id` 字段作为唯一标识符。`id` SHALL 符合 `[a-zA-Z0-9][a-zA-Z0-9_-]*` 命名规则。`id` MUST 在所有 targets 中全局唯一。`id` MUST NOT 参与变量替换。
+每个 target SHALL 包含必填的 `id` 字段作为唯一标识符。`id` SHALL 符合 `[a-zA-Z0-9][a-zA-Z0-9_-]*` 命名规则。`id` 长度 MUST 为 1 到 30 个字符。`id` MUST 在所有 targets 中全局唯一。`id` MUST NOT 参与变量替换。
 
 #### Scenario: 合法 id
 - **WHEN** target 配置 `id: "api-health"`
@@ -23,6 +23,10 @@
 - **WHEN** target 配置 `id: ""`
 - **THEN** 系统 SHALL 以配置错误退出，提示 id 不能为空
 
+#### Scenario: id 超过最大长度报错
+- **WHEN** target 配置超过 30 个字符的 `id`
+- **THEN** 系统 SHALL 以配置错误退出，提示 id 长度不合法
+
 #### Scenario: id 不合法报错
 - **WHEN** target 配置 `id: "_invalid"` 或 `id: "-start"` 或 `id: "has space"`
 - **THEN** 系统 SHALL 以配置错误退出，提示 id 不符合命名规则
@@ -32,7 +36,7 @@
 - **THEN** 系统 SHALL 以配置错误退出，提示 id 重复
 
 ### Requirement: target name 字段
-每个 target SHALL 支持可选的 `name` 字段作为展示名称。`name` 缺省时 SHALL fallback 到 `id` 的值作为展示名称。`name` SHALL 支持变量替换。`name` MUST NOT 要求全局唯一。
+每个 target SHALL 支持可选的 `name` 字段作为展示名称。`name` 缺省时 SHALL fallback 到 `id` 的值作为展示名称。显式配置的 `name` 长度 MUST 为 1 到 30 个字符。`name` SHALL 支持变量替换。`name` MUST NOT 要求全局唯一。
 
 #### Scenario: 配置 name
 - **WHEN** target 配置 `id: "api-health"` 和 `name: "API 健康检查"`
@@ -46,6 +50,37 @@
 - **WHEN** target 配置 `id: "api-health"` 但未配置 `name`
 - **THEN** 系统 SHALL 使用 "api-health" 作为展示名称
 
+#### Scenario: name 为空字符串报错
+- **WHEN** target 配置 `name: ""`
+- **THEN** 系统 SHALL 以配置错误退出，提示 name 长度不合法
+
+#### Scenario: name 超过最大长度报错
+- **WHEN** target 配置超过 30 个字符的 `name`
+- **THEN** 系统 SHALL 以配置错误退出，提示 name 长度不合法
+
 #### Scenario: 多个 target 使用相同 name
 - **WHEN** 两个 target 配置不同 id 但相同 `name: "健康检查"`
 - **THEN** 系统 SHALL 接受该配置，不报错（name 不要求全局唯一）
+
+### Requirement: target description 字段
+每个 target SHALL 支持可选的 `description` 字段作为目标说明。`description` SHALL 支持变量替换。`description` 长度 MUST 不超过 500 个字符，且允许为空字符串。`description` MUST NOT 参与 target 唯一性判定。
+
+#### Scenario: 配置 description
+- **WHEN** target 配置 `description: "检查生产 API 健康状态"`
+- **THEN** 系统 SHALL 使用该值作为目标说明
+
+#### Scenario: description 使用变量
+- **WHEN** target 配置 `description: "${env} 环境健康检查"` 且 variables 中 `env: "生产"`
+- **THEN** 系统 SHALL 将目标说明解析为 "生产 环境健康检查"
+
+#### Scenario: description 缺省
+- **WHEN** target 未配置 `description`
+- **THEN** 系统 SHALL 接受该配置，且目标说明为 null
+
+#### Scenario: description 为空字符串
+- **WHEN** target 配置 `description: ""`
+- **THEN** 系统 SHALL 接受该配置，且目标说明为空字符串
+
+#### Scenario: description 超过最大长度报错
+- **WHEN** target 配置超过 500 个字符的 `description`
+- **THEN** 系统 SHALL 以配置错误退出，提示 description 长度不合法

openspec/specs/target-table/spec.md

@@ -44,7 +44,7 @@ Dashboard SHALL 按 group 字段将目标分组，每个分组使用 TDesign Car
 
 #### Scenario: 名称列
 - **WHEN** 表格渲染
-- **THEN** 名称列 SHALL 显示目标名称，支持字母排序（zh-CN），ellipsis 超长名称自动省略并 Tooltip 显示全名
+- **THEN** 名称列 SHALL 显示目标名称，ellipsis 超长名称自动省略并 Tooltip 显示全名，且 SHALL NOT 支持排序
 
 #### Scenario: 类型列
 - **WHEN** 表格渲染
@@ -68,7 +68,7 @@ Dashboard SHALL 按 group 字段将目标分组，每个分组使用 TDesign Car
 
 #### Scenario: 延迟列
 - **WHEN** 表格渲染
-- **THEN** 延迟列 SHALL 显示最近一次检查的延迟毫秒数，右对齐，颜色通过 CSS 类控制；超过 9999ms 时 SHALL 显示为"9999+ms"
+- **THEN** 延迟列标题 SHALL 展示为"延迟(ms)"，单元格 SHALL 显示最近一次检查的延迟毫秒数值并右对齐，颜色通过 CSS 类控制；超过 9999ms 时 SHALL 显示为"9999+"
 
 #### Scenario: 间隔列移除
 - **WHEN** 表格渲染