SuperAPI AI 工具集

remote

部署与运维

查看项目

更新于 10-15 23:44

技能介绍

用途:Remote 技能用于远程访问 Linux 服务器,执行只读查询或并行采集多条命令输出,并复用本地保存的服务器连接信息。它只识别执行环境,不识别 code agent。

主要能力:按 windows-msys、linux-wsl、linux-native、macos-native 判定执行环境;本地状态目录统一为 ~/.local/share/remote(即 $XDG_DATA_HOME/remote,未设置 XDG 时回落到 $HOME/.local/share/remote)。密码传递在 Windows 使用 SSH_ASKPASS,在 Linux/macOS/WSL 使用 sshpass。支持通过 servers.json 保存和查找服务器记录,命中记录时直接复用,未命中时向用户询问地址、用户名、密码,端口默认 22。

使用方式:入口按两级判定选择。linux-wsl、linux-native、macos-native 走 remote.sh / setup.sh;仅 windows-msys 下用 echo "${BASH_VERSION:-}" 区分 shell,非空走 scripts/remote.sh / scripts/setup.sh,为空走 scripts/remote.ps1 / scripts/setup.ps1。检查 bootstrap 状态:bash 环境运行 bash ./skills/remote/scripts/remote.sh --check-bootstrap;pwsh 环境运行 powershell -ExecutionPolicy Bypass -File .\skills\remote\scripts\remote.ps1 -CheckBootstrap。退出码 0 表示就绪,非 0 需读取 references/setup.md 并通过标准脚本完成 setup。remote.ps1 提供 -Address、-Port、-Username、-Password、-Command、-Commands、-Save、-Show、-Parallel 命名参数。

适用场景:连接 Linux 服务器执行只读查询、对同一服务器并行采集命令输出、复用已保存的服务器信息、首次访问或旧记录登录失败后重新确认连接信息。

限制:不适用于批量写操作、重启、删文件、改配置等高风险运维动作;涉及写操作、重启、删除、停止服务时必须先征求用户确认。远端返回 Permission denied 时只能下结论为密码认证被拒绝。连接失败时按“结论 / 证据 / 推断 / 下一步”输出,最多允许一次基于标准主链的最小重试。本地状态文件按无 BOM UTF-8 写入,读取时兼容历史 BOM 文件。