Skip to content

v4.0.0 - Codex / Claude Code 跨平台 SSH 主版本

Latest

Choose a tag to compare

@badseal badseal released this 24 Aug 09:32
93bc545

版本定位

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:通过

文档

Full Changelog: v3.3.0...v4.0.0