基础 SSH/SSHD 入口、文件传输和服务端后续工作见 后续工作.汉语.md。
包身份为 豫言/安全外壳协议，版本 0.1.0。本包依赖标准库与安全外壳密码包，测试另用单元测试；SSH 二进制编码（原在拓展库）已并入本包。
报文。豫 实现初始无加密、无 MAC 的 SSH 二进制报文和 RFC 5647 的 AES-256-GCM 报文。初始报文连同四字节长度按 8 字节对齐；GCM 报文以四字节长度作附加认证数据，明文为填充长度、载荷、随机填充，末尾接完整 16 字节标签。GCM 编码和解码均返回下一 IV；前四字节保持不变，后八字节按大端整数递增，溢出时拒绝继续。单包长度限制为 1 MiB，以免超过底层密码原语的界限。
分帧。豫 从 TCP 字节缓冲区提取首个完整明文或 GCM 报文，区分数据未到齐、报头非法和已提取三种结果，并保留多帧合并时的剩余字节。分帧只确定边界；GCM 标签仍须由报文解码接口认证。
版本。豫 增量解析服务器识别行，接受 SSH 2.0 和兼容标识 1.99，保留识别行后同批收到的字节，并限制前置提示内容为 8192 字节。协商。豫 编解初始 KEXINIT，验证十个名称列并提供完整算法名查找；原始协商载荷应留作后续交换哈希的输入。
密钥交换。豫 编码并解析 Curve25519 初报与服务端回报、计算 SHA-256 交换哈希，供服务端生成 Ed25519 主机密钥 blob 和交换签名。客户端验签接口要求预先可信的完整主机密钥 blob，先比对主机密钥再验签。共享秘密以原始大端无符号字节编码为 SSH 正数 mpint；零编码为空，必要时在最高位前补零。
公钥文本。豫 严格解析单行 OpenSSH ssh-ed25519 公钥：要求 68 字符无填充 Base64，解码后校验 51 字节 SSH key blob，并可分别返回完整 blob 或 32 字节公钥。允许单行注释与末尾 LF/CRLF，拒绝前置选项、第二行、控制字符和畸形编码。它不解析 authorized_keys 选项。
私钥文本。豫 读取未加密、单把 Ed25519 的 OpenSSH openssh-key-v1 私钥文本，返回 32 字节种子。它校验 PEM 外壳、规范 Base64、算法与字段边界、双 checkint、公钥与种子的匹配，以及八字节对齐填充；加密或其他算法的私钥返回无结果。客户端与服务端探针优先读取标准私钥文件，缺少该文件时兼容原始种子文件。
已知主机。豫 读取 known_hosts 中的 Ed25519 条目，按调用方给出的主机名精确匹配，支持逗号分隔的精确别名、[主机]:端口 写法和 OpenSSH |1|盐|摘要 哈希主机名；只有条目里的公钥与握手所呈密钥完全相同时才信任。匹配密钥的 @revoked 条目优先否决，即使文件里另有可信条目；@revoked * 可全域撤销该密钥。注释、空行和其他算法可并存。一般通配模式、否定模式和证书颁发机构条目尚不支持；使用这些形式的条目不会授予信任。
授权公钥。豫 从多行 authorized_keys 文本中查找精确匹配的 Ed25519 公钥，允许空行、注释与其他算法行。权限结果 0 表示未授权，1 表示允许 PTY，2 表示禁止 PTY；当前只接受无选项、no-pty、restrict 和 restrict,no-pty 条目，其他选项不授权。同一密钥多行取较严格限制，扫描不完整则拒绝授权。服务端执行禁止 PTY 的约束。用户认证。豫 可从指定用户和服务的公钥请求提取候选钥；提取不等于授权或验签，调用方仍须检查授权文件并调用完整请求验证接口。
两种主机与用户密钥文本解析均限制文件为 256 KiB、每行 4096 字节，最多扫描 4096 行；超过扫描限制而仍未完成核对时拒绝授权。
派钥。豫 按 RFC 4253 派生 A 至 F 六个方向的 SHA-256 密钥材料，支持长于 32 字节的续展，并提供 AES-256-GCM 双向密钥与 12 字节 IV、NEWKEYS 载荷。服务。豫 编解服务请求与接受载荷。
会话。豫 可编解 RFC 4254 的 signal 通道请求，严格要求 want_reply=false、单个非空信号名及完整尾界。解析不会直接向进程发信号；会话层只执行 RFC 所列的标准信号名，未知扩展名忽略。
会话。豫 还可编解 exit-signal：包括信号名、core dumped、错误文本和语言标签，拒绝非法布尔位、截断及尾随数据。豫言客户端可区分它与正常退出的 exit-status。
传输控制。豫 按 RFC 4253 编解 DISCONNECT、IGNORE、UNIMPLEMENTED 和 DEBUG，严格核对消息号、长度、完整尾界及 DEBUG 布尔位，拒绝零值断开原因码。调试文本以原始字节返回；显示前调用方须验证 UTF-8 并过滤终端控制字符。发送 DISCONNECT 后不得再收发 SSH 报文。
全局请求。豫 编解 RFC 4254 的 GLOBAL_REQUEST 与请求应答，验证非空 US-ASCII 请求名和严格布尔位，保留请求专属数据；未知请求若要求应答，应回 REQUEST_FAILURE。全局请求与通道报文可交错到达，调用方须分别维持双向 IV 和会话状态。
用户认证。豫 编码 none 探询和 Ed25519 公钥认证请求，解析认证失败与成功，并供服务端验证指定用户、服务、会话号和获授权公钥上的签名。公钥签名覆盖 SSH string 会话标识符和完整请求前缀。
通道。豫 编解 session 通道开启、确认、窗口调整、普通数据、扩展数据和 EOF/CLOSE，并检查共用流量窗口及最大数据包。通道寿命。豫 记录双向 EOF/CLOSE，拒绝重复结束消息、EOF 后的同向数据和关闭后的发送；本端先发 CLOSE 时仍允许接收对端在途数据。会话。豫 编解 PTY、终端窗口变化、shell、exec、env、请求应答和 exit-status；env 仅解析原始名称和值，是否允许应用环境由服务端另行决定。PTY 已知模式按 RFC 4254 以零操作码结束，遇未知扩展操作码停止解析。原生主从 PTY、窗口尺寸和非阻塞读写由独立的 安全外壳终端 包提供。
客户端互通验证已覆盖与 OpenSSH 服务端的版本、KEXINIT、Curve25519、可信主机签名、NEWKEYS、加密服务请求以及 Ed25519 公钥用户认证。一次性豫言服务端探针也已与 OpenSSH 客户端完成主机密钥校验、Curve25519 换钥、公钥认证及 session 通道开启；未授权公钥收到 USERAUTH_FAILURE，客户端随后能用获准密钥登录。连续 12 次认证失败时，OpenSSH 客户端收到加密的 DISCONNECT 原因码 14。无 PTY 时认证用户的 exec 命令由真实标准流子进程执行，返回实际 exit-status；有 PTY 时，受限的 /usr/bin/tty 真子进程输出经 CHANNEL_DATA 回传，受限的 /bin/cat 也能接收 CHANNEL_DATA、回补窗口并回传测试文本，客户端均以 0 退出。会话消息、原生 PTY、当前用户权限下的控制终端子进程，以及 channel 与 PTY 的双向字节桥接已通过本地验证；桥接层见独立的 安全外壳会话 包。服务端多连接长期运行与完整授权策略尚待接入；客户端互通探针和服务端均已按报文数自动发起通道运行期重协商，并分别与 OpenSSH 对端通过。调用者须为两个传输方向分别保存密钥和 IV。