feat: 版本管理，package.json 唯一版本源、/api/meta 返回版本、Dashboard Header 展示版本号

openspec/specs/meta-api/spec.md

@@ -1,20 +1,24 @@
 ## Purpose
 
-定义系统运行时元数据 API：checker 类型列表等元信息的对外暴露方式。
+定义系统运行时元数据 API：checker 类型列表、应用版本号等元信息的对外暴露方式。
 
 ## Requirements
 
 ### Requirement: Meta 信息 API
-系统 SHALL 提供 `GET /api/meta` 端点，返回系统运行时元数据。未匹配 method SHALL 按 API 通配符处理为 JSON 404，不再保留自定义 HEAD/405 语义。
+系统 SHALL 提供 `GET /api/meta` 端点，返回系统运行时元数据，包括应用版本号和 checker 类型列表。未匹配 method SHALL 按 API 通配符处理为 JSON 404，不再保留自定义 HEAD/405 语义。
 
-#### Scenario: 获取 checker 类型列表
+#### Scenario: 获取 checker 类型列表和版本号
 - **WHEN** 客户端请求 `GET /api/meta`
-- **THEN** 系统 SHALL 返回 JSON `{ checkerTypes: string[] }`，包含所有已注册的 checker 类型标识符（如 `["http", "cmd"]`）
+- **THEN** 系统 SHALL 返回 JSON `{ checkerTypes: string[], version: string }`，其中 `checkerTypes` 包含所有已注册的 checker 类型标识符（如 `["http", "cmd"]`），`version` 为当前运行实例的 `MAJOR.MINOR.PATCH` 应用版本
 
 #### Scenario: 类型列表来源
 - **WHEN** 系统启动并注册了 checker
 - **THEN** `/api/meta` 返回的 `checkerTypes` SHALL 与 `CheckerRegistry.supportedTypes` 完全一致
 
+#### Scenario: 版本号来源
+- **WHEN** 系统启动并确定应用版本
+- **THEN** `/api/meta` 返回的 `version` SHALL 与启动时注入的应用版本完全一致
+
 #### Scenario: 不支持的 method 请求
 - **WHEN** 客户端使用 POST/PUT/DELETE/HEAD 等未声明 method 请求 `/api/meta`
 - **THEN** `/api/*` 通配符 SHALL 返回 JSON 404 响应
@@ -24,4 +28,4 @@
 
 #### Scenario: MetaResponse 类型定义
 - **WHEN** 前后端引用 `MetaResponse` 类型
-- **THEN** 该类型 SHALL 包含 `checkerTypes: string[]` 字段
+- **THEN** 该类型 SHALL 包含 `checkerTypes: string[]` 和 `version: string` 字段