Repository navigation
版本定位
ssh-skill v4.0.0 是面向 Codex 和 Claude Code 的正式跨平台主版本,统一支持 Windows、macOS 和 Linux。它重点解决 AI 在 SSH 操作中可能出现的重复执行、超时误重试、平台路径差异、输出过大和结果解析歧义。
核心升级
- 新调用统一使用
scripts/ssh_skill.py,远程命令按独立参数传递,不经过本地 PowerShell、Bash 或 Zsh 二次解析。 - Codex 与 Claude Code 共用紧凑英文
SKILL.md契约,同时保留中文触发词和中英文 README。 - OpenSSH、Paramiko 和集群执行在请求发出后超时时,统一返回
outcome_unknown、retryable=false,防止 AI 自动重放可能已生效的操作。 - stdout 只输出一个版本化 JSON 结果,顶层结果限制为 256 KiB。
- 递归传输最多保留 100 条首尾样本,同时保留真实文件总数,避免大目录占满 AI 上下文。
- 显式启用的进度通过独立、实时、有限、ASCII-safe 的 stderr JSONL 输出,兼容 Windows 非 ASCII 路径和控制台代码页。
- 集群操作默认预览;执行需要
--apply,生产目标还需要--confirm-production。 - 主机密钥默认使用
accept-new;已知密钥冲突会被拒绝。 - 新配置拒绝明文密码,旧密码只作兼容读取并始终脱敏;agent forwarding 默认关闭。
- 新增本地离线
doctor,可检查 Python、OpenSSH、SSH agent、配置路径及多个安装副本的版本和内容漂移。
兼容范围
| AI 工具 | Windows | macOS | Linux |
|---|---|---|---|
| Codex | 支持 | 支持 | 支持 |
| Claude Code | 支持 | 支持 | 支持 |
正式发布矩阵覆盖 Python 3.10、3.11、3.12 和 3.13。Python 3.8/3.9 仅尽力兼容,不属于发布门槛。
迁移说明
- 新的 AI 调用应使用统一入口
scripts/ssh_skill.py和 v4 结果协议。 ssh_execute.py、ssh_upload.py、ssh_download.py、ssh_server_transfer.py、ssh_config_manager_v3.py、ssh_tunnel.py和ssh_daemon.py继续作为兼容入口保留。- 旧入口默认也返回 v4 envelope。只有确认存在旧版结果消费者时才使用
--legacy-json。 --legacy-json只转换结果字段,不会恢复旧版的不安全主机密钥、自动重试、无限输出或集群行为。
验证
- 本地完整测试:115 tests passed
python scripts/validate_release.py --root .:success=true、issues=[]python -m compileall -q scripts tests:通过- GitHub Actions:Windows、macOS、Ubuntu 及 Python 3.10-3.13 全部通过
- 合并后
main默认分支 CI:通过
文档
- 中文说明:README.md
- English README:README_EN.md
- AI 核心契约:SKILL.md
- 发布 PR:PR #9
Full Changelog: v3.3.0...v4.0.0