Ascend/swanlab-setup

SwanLab 配置管理

快速使用

# source 共享函数库
source scripts/functions.sh

# 在当前环境配置 SwanLab
swanlab_setup

# 为指定容器配置
swanlab_setup_for_container my_container

# 检查连接状态
swanlab_check

配置获取优先级

环境变量 > 配置文件 > 交互式输入

| 方式 | 变量/路径 | 说明 | |------|-----------|------| | 环境变量 | SWANLAB_HOST, SWANLAB_API_KEY | 推荐方式 | | 配置文件 | ~/.verl/swanlab.conf | 首次交互后自动保存 | | 交互式输入 | 终端提示 | 仅在交互式终端下触发 |

API

脚本 scripts/functions.sh 提供 sourceable 函数：

| 函数 | 用途 | |------|------| | swanlab_clear_proxy | 清除代理设置（SwanLab 连接需要） | | swanlab_load_config | 加载配置（环境变量 > 文件） | | swanlab_save_config HOST KEY | 保存配置到 ~/.verl/swanlab.conf | | swanlab_prompt_config | 交互式获取配置 | | swanlab_init | 按优先级初始化配置 | | swanlab_login | 在当前环境执行 pip install + swanlab login | | swanlab_setup | 完整流程：clear_proxy + init + login | | swanlab_setup_for_container NAME | 在指定容器内执行 swanlab_setup | | swanlab_check | 检查登录状态和网络连通性 |

其他 Skill 调用方式

# 1. 发现 skill 路径（推荐通过环境变量）
SWANLAB_SETUP_PATH="${SWANLAB_SETUP_PATH:-$(dirname "$(find ~/.claude/skills/swanlab-setup -name functions.sh 2>/dev/null || echo "")")}"

# 2. source 函数库
source "$SWANLAB_SETUP_PATH/scripts/functions.sh"

# 3. 调用
swanlab_setup

脚本结构

swanlab-setup/
├── SKILL.md              # 本文档
└── scripts/
    ├── functions.sh      # 共享函数库（被其他 skill source）
    └── swanlab_check.sh  # 独立检查脚本