Repository navigation
ShellPier v0.8.0-alpha.1
Pre-release本版增加 host 托管终端、反向 SOCKS5 与远端文件独立复制,并继续对照 OpenSSH、tmux、Mosh、tmate 和 rclone 核对实现边界。
新功能与修复
terminals open/read/write/list/status/resize/signal/close/operation:由目标端 host 保存 PTY。SSH 断线后用原票据和 terminal ID 继续控制同一终端,保留 shell 变量、工作目录与输出游标。open/write 支持 operation ID 去重和查询;调用结果未知时查询原操作,不自动重放输入。forward TICKET --reverse --dynamic --listen 0:目标端建立 loopback SOCKS5 CONNECT 监听,域名解析与出站连接发生在控制端。单个目的连接失败不会关闭整个监听。files copy TICKET SOURCE DEST:经控制端 SFTP 固定缓冲流复制远端普通文件,生成独立副本,默认不覆盖。支持--dry-run;不自动创建父目录,失败可能保留部分目标文件。- 修复
proxy --to在票据到期边界可能将超时报告为普通 SSH 断线的竞态。连接断开测试同时覆盖执行所在连接和整个中继连接池,并继续验证命令不会被自动重放。 - 同步帮助、命令 schema、MCP、Agent skill 与中英文文档。MCP 的 terminals open/write 要求显式 operation ID,未知结果保留查询所需身份。
命令手册提供完整示例。工具对比记录一手资料、OpenSSH 逐项差异和本轮取舍。
使用边界
terminals 限于同一个 host 进程;host 退出、票据 TTL 或终端 lifetime 到期后结束,不跨 host 重启恢复,不提供屏幕模拟、UDP 漫游或多人权限分离。旧 terminal 控制端 worker 继续保留。
反向 SOCKS 只支持 CONNECT,不支持 UDP/BIND;--allow-forward 约束目标端正向出站,不限制控制端出站。files copy 明确报告 transport:client-stream,不是 SFTP 服务端 copy-data,也不使用共享 inode 的硬链接。
OpenSSH 闲置 channel 超时、远端 Unix socket、完整多跳编排,以及 SFTP fsync/statvfs/copy-data 服务端能力仍未加入。已有协议或客户端方法不能证明服务端实现了对应能力。
Windows 继续沿用经过来源校验的 Go 官方运行时修复;原 v0.5 崩溃的历史根因仍未确认。本轮调整了旧测试中小于产品正常启动期限的测试预算,并增加失败诊断,没有据此认定原 Windows 失败的完整根因。
已完成验证
- 最终源码 CI:Linux、macOS、Windows 的 vet、race 与十轮重复测试,以及最低 Go 版本、漏洞扫描全部通过。
- 发行流程:七个离线 ZIP 构建通过,Windows amd64/386 最终包在 Windows 原生执行 version 与 doctor 通过。
- 七个下载包的来源提交、完整性、构建信息、许可证与文档通过检查;Windows 三种架构的实际补丁标记与来源记录一致。
- macOS arm64 最终包八组验收通过,覆盖跨连接终端状态、操作去重与冲突、host 停止回收、反向 SOCKS 的解析与失败恢复、独立文件复制和限制,以及既有 MCP/jobs/PTY、目录分享、OpenSSH、转发、清单与文件管道回归。
提供 Linux amd64/arm64、macOS amd64/arm64、Windows amd64/386/arm64。Windows arm64 等交叉构建目标没有在本轮完成全部原生运行验收,最低系统版本亦未新增实机证明。
来源提交:e3161d119ca7469708de317dd2444018fca5c729。