文件传输与 Git

概览

SFTP 文件传输复用保存的 SSH 资源、认证和主机密钥验证。上传与下载限于已登记的单文件操作，审批时核对源、目标与覆盖风险。Git HTTPS 使用独立令牌任务。

边界与检查

不要把私钥或访问令牌写入 Git 远端 URL、命令参数、聊天或日志。Git SSH 尚未实现；核对当前任务支持范围，不能通过关闭主机校验绕过。

选择传输类型

SFTP 与 Git HTTPS 都沿用资源、模板、审批、幂等键和脱敏运行记录。AI 不能在运行时任意改动已登记的路径、远端 URL、分支或命令。更改目标、模板或关联凭据后，旧审批失效。

SFTP 单文件传输

1. 使用已核对主机指纹的 SSH 资源和密码或受支持的私钥；SFTP 不跳过主机身份验证，也不使用远程 Shell。
2. 固定上传或下载方向、代理所在电脑的本机绝对路径、服务器上的远程绝对路径、字节上限与是否允许覆盖。默认拒绝覆盖。
3. 审批时核对两个路径与目标。成功结果返回方向和传输字节数，不会把文件正文交给 AI。

上传、下载均先写入目标同目录的临时文件，再提交目标。覆盖上传要求服务器支持指定原子重命名扩展；不支持时拒绝，不先删除原文件。超时或取消后若 cleanup_ok:false，在登记目录检查残留 .part 文件。进程崩溃或断电也可能留临时文件；完成替换后再取消不能撤回文件。

Git HTTPS 固定分支操作

本机需要可信的 Git 2.31+ 和已存在的仓库目录。模板固定 HTTPS 远端、分支、用户名、令牌引用与操作，可查询远端分支、抓取到专用远端引用，或非强制推送同名分支；不会自动 checkout、merge、强推或删除分支。不要把令牌放入远端 URL、参数、仓库配置或聊天。代理仅在该 Git 子进程内部提供认证并过滤输出。

远端可能在连接中断前已经接受推送。检查远端分支和本地状态后再重新申请。与外部仓库交换业务文件前，确认本机路径、仓库内容及账号权限符合你的预期。