SSH 主机指纹与只读命令

首次连接：为什么需要主机指纹？

主机指纹用于确认连接的是预期服务器。0.3.1 的本机管理页支持先保存 SSH 地址和端口，再点“获取公开指纹”。这一步只进行限时密钥交换，不读取凭据、不认证、不执行命令。界面显示的是“网络获取 · 尚未确认可信”，不能把网络返回值直接当作信任依据。

通过服务器控制台、管理员或其他独立可信渠道核对 SHA-256 指纹；确认一致后点击“确认并填入指纹”，最后保存资源并测试连接。若指纹变化，先调查服务器是否更换密钥，不能自动接受或覆盖原值。该确认只在已登录的本机管理页完成，MCP 不提供自动确认信任的接口。

申请一次受控 SSH 操作

确定资源后，请求中填写绝对远端程序路径和逐项参数，说明只读目标及预期输出。用户在管理页核对并批准具体操作；批准后再用幂等键创建运行，通过游标读取过滤后的结果。SSH 凭据始终由本机代理用于认证，不作为命令结果交给 AI。

边界与检查

指纹不符时代理会在认证前拒绝。超时、断线或取消后先检查远端状态，不能据此假定命令尚未执行。若是 SFTP 传输，请查看文件传输指南；若是连接失败，请查看故障排查。

配置固定目标

资源中登记地址、端口、账号与密码或受支持的私钥引用；地址与账号属于可读元数据，秘密仅写入系统凭据库。首次只保存地址和端口也可以，随后在本机管理页获取网络公开指纹，从独立可信渠道核对，确认后保存并测试连接。测试只认证并断开，不执行命令。

一次只读操作

AI 可从非秘密目录选取已登记连接，使用 secretbridge_request_ssh 提交远端程序的绝对路径、分开的参数、可选绝对工作目录与超时。请求会冻结主机、账号、指纹、认证引用和命令。你在本机审批页核对真实目标与输出范围，然后才运行并用游标读取脱敏结果；若多条命令需要 Shell 解释，应明确审阅解释器和完整脚本，而不是默认把参数拼成一行。

SSH 密码或 Ed25519/ECDSA 私钥由代理内部认证。当前不自动接受未知主机密钥，也不以关闭核验解决连接失败。连接元数据与请求中重复填写的地址、账号不一致会被拒绝。

指纹变化与不确定结果

发生 host_key_rejected 或指纹变化时，先核查服务器控制台或管理员确认密钥轮换，再在管理页更新记录并重新审批。超时、断线和取消不代表远端未执行；检查运行历史和服务器状态后再决定是否重试。单文件传输请参阅SFTP 与 Git。