1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
// 派发配置：模式词、能力开关与内置参数。零值即默认可直接使用；
// 命令行 --xyz.* 与各模式的裸名 flag 优先级高于这里的字段值。
use std::time::Duration;
use crate::logx;
/// ModeWords 重命名内建模式关键词。留空的字段保持默认（serve、mcp、
/// help）。
#[derive(Debug, Clone, Default)]
pub struct ModeWords {
pub serve: String,
/// 独立的 HTTP 模式（仅 REST + /openapi.json，不挂 /mcp；spec §13.1）。
pub http: String,
pub mcp: String,
pub help: String,
}
/// Capabilities 在运行时开关通道（与 build feature 相互独立）。零值保持
/// 全部可用。禁用通道只移除它自己的运行时路径：模式词（serve/mcp/help）
/// 与 -v/--version 继续工作，被禁用的模式以清晰错误应答。被禁通道的
/// CLI()/HTTP()/MCP() 配置照常编译与运行——只是不再被消费。
#[derive(Debug, Clone, Copy, Default)]
pub struct Capabilities {
/// 不在命令注册表上生成子命令（mcp/serve/help/-v 仍可用）。
pub no_cli: bool,
/// mcp 模式不可用（stdio/http 都拒绝）。
pub no_mcp: bool,
/// serve 模式不可用。
pub no_http: bool,
}
/// Config 调整派发器。零值保持全部默认。
#[derive(Debug, Clone, Default)]
pub struct Config {
pub modes: ModeWords,
pub capabilities: Capabilities,
/// serve 与 mcp(http) 模式的默认监听地址（各模式自己的 --addr flag
/// 优先）。
pub addr: String,
/// 开启 serve REST 与 MCP http 传输的 Bearer 凭据校验，每个元素是
/// 一个可接受的 token；空表示不校验。命令行写法：--xyz.bearer=tok1,tok2
/// （stdio 传输为本地进程，不受影响）。
pub bearer_tokens: Vec<String>,
/// 库自身诊断的日志级别（logx 输出到 stderr）。零值（LevelUnset）
/// 保持默认 Info。命令行：--xyz.log-level=debug|info|warn|error。
pub log_level: crate::logx::Level,
/// serve 模式的每请求超时（TimeoutLayer）；0 = 不设超时。
/// （标准头超时在 Rust 实现里未单独配置，见 README 与 Go 版差异节。）
pub timeout: Duration,
/// cert_file/key_file 同时给定则 serve 以 TLS 监听
/// （--xyz.tls-cert/--xyz.tls-key）。
pub cert_file: String,
pub key_file: String,
/// CORSOrigins 非空则开启 CORS：逐个 Origin 放行（"*" 表示任意来源），
/// OPTIONS 预检在鉴权之前应答。命令行：--xyz.cors=origin1,origin2。
pub cors_origins: Vec<String>,
/// 界面语言覆盖：""=自动（--xyz.lang flag > 本字段 > LANG/LC_ALL 环境
/// 检测 > 英文默认）。取值 "en" | "zh-CN"。
pub lang: String,
/// 用户的多语言内容覆盖表：语言 → (消息键 → 文本)。键名见 lang 目录
/// （xyz-spec §15.8 的规范键表）。
pub translations: std::collections::HashMap<String, std::collections::HashMap<String, String>>,
/// serve/mcp 启动时注入的通道级默认参数（字段线上名 → 字符串值）：
/// 请求/调用未显式提供时自动补上，优先级高于全局 default 属性、低于
/// 显式入参与接口默认。命令行：--default k=v（可重复/逗号分隔对）。
pub channel_defaults: std::collections::HashMap<String, String>,
/// help 总览的自定义文本块：前者原样插在总览开头（程序名/描述/版本/
/// 仓库地址等自己拼），后者插在结尾（命令表之后，即使命令表被隐藏也
/// 打印）。空 = 不插入。
pub help_before: String,
pub help_after: String,
/// 应用名（spec §11.6/§12.6）：X-App-Name 响应头与 MCP serverInfo.name。
/// 空 = 二进制 basename。
pub name: String,
/// 应用版本（spec §11.6/§12.6）：X-App-Version 响应头与
/// serverInfo.version。空 = version::version()（默认 "dev"）。
/// 与 xyz 库自身的版本（version::SDK_VERSION → X-XYZ-Version）无关。
pub version: String,
/// 代码级全局默认格式（spec §10.7 第四层）：""|auto = 按 TTY 解析为
/// format_interactive / format_piped。命令行 --xyz.format（第二层，
/// format_from_flag 置位）与逐命令 CliHints.format（第三层）优先。
pub format: String,
/// format=auto 时交互式终端下的具体格式（默认 text）。
pub format_interactive: String,
/// format=auto 时非交互（管道/重定向/其他程序调用）下的具体格式
/// （默认 jsonl）。
pub format_piped: String,
/// 标记 format 来自命令行 --xyz.format（命令行层，高于逐命令 hint）。
pub format_from_flag: bool,
/// 附加到每个 HTTP 响应的自定义静态头（键值原样写入；与自动
/// X-App-*/X-XYZ-* 头并存）。命令行：--xyz.header k=v（可重复）。
pub response_headers: Vec<(String, String)>,
/// 关闭自动服务器上下文头（HTTP 的 X-App-*/X-XYZ-* 与 MCP 结果的
/// _meta.xyz）：spec §11.6/§12.8 的单一开关。自定义头不受影响。
/// 命令行：--xyz.no-server-headers。
pub no_server_headers: bool,
}
impl Config {
pub fn default_log_level(&self) -> logx::Level {
self.log_level
}
/// 应用名：config 覆盖 > 二进制 basename（spec §11.6/§12.6）。
pub fn resolved_name(&self) -> String {
if !self.name.is_empty() {
return self.name.clone();
}
crate::cli::bin_name()
}
/// 应用版本：config 覆盖 > 版本槽（默认 "dev"）。
pub fn resolved_version(&self) -> String {
if !self.version.is_empty() {
return self.version.clone();
}
crate::version::version().to_string()
}
}