命令参考

TSH 内置了常用的 Unix 风格命令，所有文件操作通过浏览器 File System Access API 在本地完成。

文件操作命令

ls — 列出目录内容

ls              # 列出当前目录
ls /subdir      # 列出指定目录
ls -l           # 详细列表（文件大小、类型）

输出中目录显示为蓝色，可执行文件显示为绿色。

cd — 切换目录

cd /path/to/dir    # 切换到指定目录
cd ..               # 返回上级目录
cd /                 # 返回根目录
cd                   # 返回根目录

pwd — 显示当前路径

pwd
# 输出: /current/working/path

cat — 查看文件内容

cat file.txt        # 显示文件内容
cat file1 file2     # 依次显示多个文件

大文件保护

超过 50MB 的文件会被阻止读取，防止浏览器内存溢出。

cp — 复制文件/目录

cp source.txt dest.txt       # 复制文件
cp -r sourcedir/ destdir/    # 递归复制目录（必须加 -r）

目录复制需要 -r

复制目录时必须加 -r 参数，否则会报 omitting directory 错误。

mv — 移动/重命名

mv old.txt new.txt       # 重命名
mv file.txt /subdir/     # 移动到目录
mv dir1/ dir2/           # 移动目录（无需额外参数）

mv 支持目录移动，不需要 -r 参数。如果目标是目录，文件会被移入该目录。

rm — 删除文件/目录

rm file.txt          # 删除文件
rm -r dirname/       # 递归删除目录

不可恢复

删除操作不可撤销，请谨慎使用。

mkdir — 创建目录

mkdir newdir
mkdir -p path/to/nested/dir    # 递归创建

touch — 创建空文件

touch newfile.txt

stat — 查看文件信息

stat file.txt
# 输出: 类型、大小、修改时间等

tee — 读取标准输入并写入文件

echo "content" | tee file.txt       # 写入并显示
echo "content" | tee -a file.txt    # 追加模式

tee 接受 stdin 参数，支持 -a 追加模式，常用于管道中保存中间结果。

echo — 输出文本

echo "Hello World"
echo "content" > file.txt       # 重定向写入
echo "content" >> file.txt      # 追加写入

文本编辑器

vim — Vim 编辑器

vim file.txt

nano — Nano 编辑器

nano file.txt

详细使用方法请参考 文本编辑器指南。

系统命令

clear — 清屏

clear

help — 帮助

help

whoami — 当前用户

whoami
# 输出: dev

date — 当前时间

date
# 输出: 当前日期时间

管道

TSH 支持多级管道，用 | 分隔命令：

command1 | command2 | command3

前一个命令的标准输出会作为后一个命令的标准输入。支持 tee、cat、echo 等命令参与管道。

SSH 命令

ssh — 打开 SSH 连接面板

ssh

打开 SSH 连接模态框，支持两种模式：

• 浏览器直连：填写主机、端口、用户名、密码/私钥，点击 Connect 直接连接
• 本地中继：复制生成的脚本命令，在本地终端执行，桥接远程服务器

详细用法请参考 SSH 连接指南 和 SFTP 文件管理。

脚本命令

tsh — 运行 TSH 脚本

tsh script.tsh

source — 加载执行脚本

source script.tsh

source 会自动检测文件扩展名，.tsh 文件使用 TSH 脚本解释器执行。

详细语法请参考 TSH 脚本语言。

插件命令

plugin — 插件管理

plugin install <url>      # 安装插件
plugin list               # 列出已安装插件
plugin remove <name>      # 移除插件

详细用法请参考 插件概述。

路径规则

写法	含义
/path	绝对路径（从授权根目录开始）
path	相对路径（从当前目录开始）
..	上级目录
.	当前目录

路径分隔符同时支持 / 和 \，内部统一规范化为 /。

重定向

echo "text" > file.txt     # 覆盖写入
echo "text" >> file.txt    # 追加写入

重定向仅支持 echo 等输出命令，将标准输出写入文件。