SuperAPI AI 工具集

admin-wsl

通用与其它

查看项目

更新于 10-15 21:39

技能介绍

用途:在 WSL2 的 Ubuntu 24.04 环境中从 Linux 侧执行系统管理,并依据 Windows 侧共享 profile 中的偏好选择工具链。

主要能力:读取 profile 决定 Python 包管理器(uv/pip/conda)与 Node 包管理器(npm/pnpm/yarn/bun);执行 apt 安装;进行 Windows 与 WSL 路径转换;通过 profile 中的服务器信息 SSH 登录;执行 Docker 常用操作(docker ps、logs、exec、docker-compose up -d);记录需移交 Windows 的任务。

使用方式:先运行 bash scripts/verify-wsl-environment.sh 验证环境;profile 位于 Windows 侧,需通过 /mnt/c 访问,例如 WIN_USER=$(cmd.exe /c "echo %USERNAME%" 2>/dev/null | tr -d '\r')、ADMIN_ROOT="/mnt/c/Users/$WIN_USER/.admin"、PROFILE_PATH="$ADMIN_ROOT/profiles/$(hostname).json"。加载时 source /path/to/admin/scripts/load-profile.sh,再调用 load_admin_profile 与 show_admin_summary。SSH 可用 ssh_to_server "cool-two",或手动读取 host、username、keyPath 后执行 ssh -i "$KEY" "$USER@$HOST"。

适用场景:WSL 内 apt 包、Docker 容器、Python/Node 环境、shell 配置、systemd 服务、SSH 连接服务器等。

限制:.wslconfig、Windows 包、MCP 服务器、非 WSL 的原生 Linux 不在本技能范围内,需分别移交 admin-windows、admin-mcp、admin-unix。Docker 不可用时需确认 Windows 侧 Docker Desktop 已运行并启用 WSL 集成。更多已知问题与移交示例见 references/OPERATIONS.md。