CoolFace
Datasetpublic

XinWoRen/xinworen-yaml-mode-switch

xinworen-yaml-mode-switch 免重启热切换 YAML 配置 · Hot-toggle YAML config without restart bash + sed · 零外部依赖 · 幂等 · 可回滚 由 XinWoRen 出品 · 面向企业级部署的通用「配置热开关」工程底座 · github.com/XinWoRen-Global · 项目官网 xinworen.com 本工具是一个通用、安全、幂等的配置热开关 CLI，纯 bash + sed 实现、零依赖，可挂载到任意运行时作为「配置热加载」的入口。不绑定任何平台、模型或密钥 — 从生产环境沉淀、脱敏后开源。 A generic, dependency-free shell CLI to hot-toggle boolean/value keys in a YAML config. Extracted from production and open-sourced without any… See the full description on the dataset page: https://huggingface.co/datasets/XinWoRen/xinworen-yaml-mode-switch.

sourceHugging Faceupdated 22d agoView on Hugging Face
0likes102downloads
Dataset Card

<p align="center"> <img src="assets/xinworen-logo.png" width="96" alt="XinWoRen"> </p>

<h1 align="center">xinworen-yaml-mode-switch</h1>

<p align="center"> <b>免重启热切换 YAML 配置 · Hot-toggle YAML config without restart</b><br/> <span>bash + sed · 零外部依赖 · 幂等 · 可回滚</span> </p>

<p align="center"> <a href="https://github.com/XinWoRen-Global/xinworen-yaml-mode-switch/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="License: MIT"></a> <img src="https://img.shields.io/badge/bash-3.2%2B-yellowgreen.svg" alt="Bash 3.2+"> <img src="https://img.shields.io/badge/deps-0-orange.svg" alt="Zero dependency"> <a href="https://github.com/XinWoRen-Global/xinworen-yaml-mode-switch/actions"><img src="https://img.shields.io/github/actions/workflow/status/XinWoRen-Global/xinworen-yaml-mode-switch/ci.yml?branch=main" alt="CI"></a> <a href="https://xinworen.com"><img src="https://img.shields.io/badge/website-xinworen.com-7c3aed.svg" alt="Website: xinworen.com"></a> </p>

<p align="center"> <b>由 XinWoRen 出品</b> · 面向企业级部署的通用「配置热开关」工程底座 · <a href="https://github.com/XinWoRen-Global">github.com/XinWoRen-Global</a> · 项目官网 <a href="https://xinworen.com">xinworen.com</a> </p>

本工具是一个通用、安全、幂等的配置热开关 CLI，纯 bash + sed 实现、零依赖，可挂载到任意运行时作为「配置热加载」的入口。不绑定任何平台、模型或密钥 — 从生产环境沉淀、脱敏后开源。 A generic, dependency-free shell CLI to hot-toggle boolean/value keys in a YAML config. Extracted from production and open-sourced without any platform/model/secret coupling.

海内外镜像 / Mirrors · GitHub · Gitee · Hugging Face · Codeberg · GitCode · SourceForge — 可从你所在区域的任意镜像拉取 / 访问。官网 / Website: xinworen.com

为什么需要它 / Why

很多运行时通过 bind-mount / 热加载实时读取配置文件，但缺少一个安全、幂等的 CLI 来改配置字段。本工具提供一个通用入口：

  • —只改写目标字段所在行，保留文件其余注释与配置
  • —自动备份到 .bak，可 --restore 还原
  • —智能值校验：布尔语义值统一归一化为 true/false
  • —--dry-run 预览改动不落盘
  • —纯 bash + sed，GNU sed（Linux/git-bash）与 BSD sed（macOS）均可

安装 / Install

bash
curl -o yaml-mode-switch.sh https://raw.githubusercontent.com/XinWoRen-Global/xinworen-yaml-mode-switch/main/yaml-mode-switch.sh
chmod +x yaml-mode-switch.sh

或 clone 本仓库后直接使用。

用法 / Usage

bash
# 设置 / set
./yaml-mode-switch.sh <config.yaml> <key> <value>

# 打印当前值 / dump current value
./yaml-mode-switch.sh <config.yaml> <key> --dump

# 从备份还原 / restore from backup
./yaml-mode-switch.sh --restore <backup_file> [config]

# 预览改动，不落盘 / preview without writing
./yaml-mode-switch.sh --dry-run <config.yaml> <key> <value>

示例 / Examples

说明：<key> 传纯字段名（不含路径点号），工具会匹配任意缩进层级的第一处同名 key。例如 features: 块下的 test_mode，直接写 test_mode 即可命中。
bash
# 把 features 块下的 test_mode 设为 on（布尔归一化为 true）
./yaml-mode-switch.sh config.yaml test_mode on

# 把 debug 设为 true
./yaml-mode-switch.sh config.yaml debug true

# 查看当前 test_mode
./yaml-mode-switch.sh config.yaml test_mode --dump

# 归零重来：先 dry-run 确认
./yaml-mode-switch.sh --dry-run config.yaml test_mode off
./yaml-mode-switch.sh config.yaml test_mode off

退出码 / Exit codes

  • —0 成功
  • —1 参数错误 / 文件不存在
说明：布尔/开关语义值（on/off/yes/no/true/false/1/0）在写入前统一归一化为 true/false，保证生成的 YAML 语义一致。

无副作用 / Safety

  • —每次写入前自动 cp 到同名 .bak 备份
  • —--restore 可从备份无痛回滚
  • —--dry-run 只打印「改动前/后」对比，不安全可重复执行
  • —不读取、不写入任何密钥；只改你指定的那一个 key

贡献 / Contributing

欢迎提交 Issue / PR。参见 CONTRIBUTING。

License

MIT

版权所有 / Copyright (c) 2026 XinWoRen