Astra Shell 文档下载 macOS
文档目录 当前:文件浏览与传输

文档 / 日常使用 / 文件浏览与传输

EVERYDAY · FILES

在 Shell 旁边查看远端文件。

文件浏览和传输复用同一条安全连接,但使用独立 Stream,不让大文件传输阻塞终端交互。

浏览与预览

连接 Astra Host 后,在 Host 主页选择“打开远程文件夹”,再选择 --session-root 内允许访问的目录。Files 视图会分页列出目录;点击常见文本或代码文件会在只读标签中打开,其他支持的文件交给系统预览。文件内容显示行号与语法强调,适合在终端任务旁快速核对配置或日志。

上传与下载

App 内可使用“上传”按钮;macOS 也可以把 Finder 文件拖入当前目录。非文本文件的系统预览会先下载到应用的受控缓存;如果要把远端文件明确保存到指定本地路径,请使用可选的 astra CLI。Astra Files/1 对上传和下载提供稳定 transfer ID、SHA-256 校验、断点续传和原子提交。

cd /path/to/astra-shell
./target/debug/astra -p 4433 -i /path/to/private-key YOUR_USER@YOUR_HOST files put ./local.tar remote.tar
./target/debug/astra -p 4433 -i /path/to/private-key YOUR_USER@YOUR_HOST files get remote.tar ./downloaded.tar

Files Stream 的优先级低于终端流,但大文件负载下的端到端时延仍取决于网络与部署环境;生产使用前应在自己的链路上验证。

Git 状态

目录列表可以显示工作区文件的新增、修改和删除状态,帮助你在打开文件前快速定位变化;它是浏览提示,不替代完整的 Git 命令与审阅流程。

安全边界

预览器不会执行文件内容。路径解析、权限检查、并发文件操作与传输额度由服务端统一控制。当前产品以查看和可靠传输为重点,不将浏览器式编辑器作为既有能力承诺。