Crate az_config_center_contract 

az-config-center-contract

AIO Desktop 配置中心契约层，定义运行配置 API、Shell 组件注册表、桌面后端状态查询、组件构建等全部共享数据类型。

功能

• Shell 组件类型枚举（ShellComponentKind）：Export、Alias、Function、Snippet 四种
• Shell 组件完整数据模型（ShellComponent）及其增删改查 DTO
• 运行配置 API 信封、登录请求、配置查询、写入、启停和删除 DTO
• 组件注册表快照（ShellComponentRegistry）、构建配置与构建结果
• 桌面后端健康状态（DesktopBackendStatus）
• 公共常量：默认输出路径（DEFAULT_SHELL_OUTPUT_PATH）、桌面令牌 header 名（DESKTOP_SESSION_TOKEN_HEADER）

安装

在 Cargo.toml 中添加：

[dependencies]
az-config-center-contract = { path = "../az-config-center-contract" }  # workspace 内部引用
# 或发布后：
# az-config-center-contract = "0.1"                                      # crates.io 引用

用法

use az_config_center_contract::{
    ConfigItem, DesktopBackendStatus, GetQuery, ShellComponent, ShellComponentKind,
    ShellComponentPatch, ShellComponentRegistry, ShellComponentRemove, ShellComponentUpsert,
    UpsertRequest,
};

// 构造一个 Shell 组件
let component = ShellComponent {
    name: "grep-log".into(),
    kind: ShellComponentKind::Function,
    summary: "搜索应用日志".into(),
    body: Some("grep -rn \"$1\" /var/log/app/*.log".into()),
    ..Default::default()
};

// 构造 upsert 请求
let upsert = ShellComponentUpsert {
    name: component.name.clone(),
    kind: component.kind,
    summary: component.summary,
    body: component.body,
    ..Default::default()
};

// 构造 patch 请求（仅修改摘要）
let patch = ShellComponentPatch {
    name: "grep-log".into(),
    summary: Some("按关键字搜索应用日志".into()),
    ..Default::default()
};

// 配置中心 API 查询参数和写入请求。
let query = GetQuery {
    namespace: "prod".into(),
    key: "service.timeout".into(),
};
let request = UpsertRequest {
    namespace: query.namespace,
    key: query.key,
    value: "30".into(),
    value_type: "number".into(),
    description: "服务超时时间，单位秒".into(),
    enabled: true,
    updated_by: "admin".into(),
};

依赖的 crates

• serde — 所有结构体的序列化与反序列化
• chrono — 配置快照中的时间戳类型
• uuid — 配置项和用户会话相关标识

Structs

ApiResponse

配置中心 API 的统一响应信封。

ConfigItem

配置中心中的单条配置快照。

DeleteRequest

删除配置的请求。

DeleteResult

删除配置后的影响行数。

DesktopBackendStatus

桌面后端健康状态和 Shell 注册表路径信息。

ErrorBody

配置中心 API 的错误响应体。

GetQuery

按命名空间和配置键读取配置的查询参数。

ListQuery

配置列表查询参数。

LoginPayload

配置中心登录成功后返回的会话信息。

LoginRequest

配置中心登录请求。

ShellComponent

Shell 组件注册表中的完整组件快照。

ShellComponentBuildConfig

Shell 注册表构建配置。

ShellComponentBuildRequest

触发 Shell 组件构建的请求。

ShellComponentBuildResult

Shell 组件构建结果。

ShellComponentConfigUpdate

修改 Shell 组件构建配置的请求。

ShellComponentPatch

局部修改 Shell 组件启用状态和摘要的请求。

ShellComponentRegistry

Shell 组件注册表快照。

ShellComponentRemove

删除 Shell 组件的请求。

ShellComponentUpsert

创建或整体更新 Shell 组件的请求。

StatusPayload

配置中心健康状态响应数据。

ToggleRequest

修改配置启停状态的请求。

UpsertRequest

创建或更新配置的请求。

Enums

ShellComponentKind

Shell 组件类型。

Constants

DEFAULT_SHELL_OUTPUT_PATH

Shell 组件默认渲染输出路径。

DESKTOP_SESSION_TOKEN_HEADER

桌面本地后端请求头中的会话令牌字段名。