config — 管理配置

查看或修改全局配置文件。

xskill config [OPTIONS]

选项:

  • -i, --init — 初始化配置文件,生成含默认值的完整配置(默认平台、缓存、注册中心)
  • -e, --edit — 在 $EDITOR 中打开配置(默认 vi
  • -g, --get <key> — 通过点号路径获取配置值(如 cache.enabled
  • -s, --set <key=value> — 通过点号路径设置配置值(如 cache.enabled=true
  • -w, --show — 以美化后的 JSON 打印当前加载的完整配置(合并默认值,如补全缺失的平台)。输出无颜色,便于管道处理
  • -V, --validate — 校验配置文件。先做 JSON 语法与强类型结构校验,再对照 JSON Schema 做完整 Schema 校验。优先查找本地 Schema($XSKILL_SCHEMA<config_dir>/schemas/xskill.schema.json、从可执行文件目录向上查找、<exe_dir>/../share/xskill/xskill.schema.json);本地均无则从 https://xskill.gcli.cn/xskill.schema.json 拉取(遵循代理配置)。成功输出 Valid <path> (schema: <source>),失败打印每条错误(含 JSON 路径)并以 1 退出

示例 — 读取/设置代理:

xskill config --get proxy
xskill config --set proxy=socks5h://127.0.0.1:40027
xskill config --validate

示例

# 初始化配置文件
xskill config --init

# 在编辑器中打开配置
xskill config --edit

# 读取值
xskill config --get cache.enabled

# 设置值
xskill config --set cache.enabled=true