用途:env-helper 是一个极简的环境变量工具,用于为其他工具脚本解析生态常量(如 HF_TOKEN、HF_USERNAME、.env 路径),且不依赖共享内部 Python 库,以避免循环依赖。
主要能力:通过解析引擎 ../../scripts/env_helper.py 提供三种用法:解析单个键(python3 ./scripts/env_helper.py --key HF_TOKEN)、以 JSON 输出全部已知常量(python3 ./scripts/env_helper.py --all)、获取完整的 HuggingFace 上传配置块(python3 ./scripts/env_helper.py --hf-config)。脚本能优雅处理默认回退值和递归文件夹遍历。
使用方式:应作为内联子 shell 命令供其他脚本调用,例如 export HF_TOKEN=$(python3 ./scripts/env_helper.py --key HF_TOKEN)。
限制与约束:切勿仅为读取或复述原始 HF_TOKEN 等凭据而运行该脚本并输出到聊天窗口,否则会危及用户安全;不要自行编写 awk、sed 或 grep 手动解析根目录 .env 文件,必须使用提供的 Python 解析器。若脚本以退出码 1 结束,表示所请求的凭据在 .env 或进程环境中不存在且无默认值,此时应立即查阅 references/fallback-tree.md。
适用场景:需要安全、统一地获取生态常量供其他插件脚本使用的自动化流程。其他细节暂未提供。