config — 管理配置

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

xskill config <COMMAND>

子命令：

  • init — 初始化配置文件，生成含默认值的完整配置（默认平台、缓存、注册中心）。内置平台条目按精简格式保存（仅 name/enabled/builtin 三字段）——由 Config::save() 对所有写配置的命令统一保证
  • edit — 在 $EDITOR 中打开配置（默认 vi）
  • get <key> — 通过点号路径获取配置值（如 cache.enabled）
  • set <key=value> — 通过点号路径设置配置值（如 cache.enabled=true）
  • show — 以美化后的 JSON 打印当前加载的完整配置（合并默认值，如补全缺失的平台）。输出无颜色，便于管道处理
  • 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 退出

--verbose 与 --help 保持全局旗标不变，仅 config 的动作转为子命令。不带子命令执行 xskill config 时显示帮助。

示例 — 读取/设置代理：

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