Remote 技能

概述

用于远程访问 Linux 服务器，并在本地状态目录维护 setup 状态与服务器信息。remote 只识别执行环境，不识别 code agent；执行环境统一按 references/setup.md 判定为 windows-msys、linux-wsl、linux-native、macos-native。

本地状态目录跨平台统一为 ~/.local/share/remote（即 $XDG_DATA_HOME/remote，未设置 XDG 时回落到 $HOME/.local/share/remote）。PowerShell 的 $HOME 与 git bash 的 $HOME 指向同一物理目录，因此 ps1 与 sh 入口读写同一份状态，不再使用 AppData\Local\remote。

密码传递机制：

• Windows（windows-msys）：使用 SSH_ASKPASS 环境变量机制（OpenSSH 原生支持，无需额外安装）
• Linux/macOS/WSL：使用 sshpass

何时使用

• 需要连接 Linux 服务器执行只读查询
• 需要对同一台服务器并行采集多条命令输出
• 需要复用之前保存过的服务器地址、端口、用户名和密码
• 第一次访问某台服务器，或旧记录登录失败后需要重新确认连接信息
• 不适用于批量写操作、重启、删文件、改配置等高风险运维动作