Skip to content

命令参考

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

文件操作命令

ls — 列出目录内容

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

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

cd — 切换目录

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

pwd — 显示当前路径

bash
pwd
# 输出: /current/working/path

cat — 查看文件内容

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

大文件保护

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

cp — 复制文件/目录

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

目录复制需要 -r

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

mv — 移动/重命名

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

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

rm — 删除文件/目录

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

不可恢复

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

mkdir — 创建目录

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

touch — 创建空文件

bash
touch newfile.txt

stat — 查看文件信息

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

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

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

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

echo — 输出文本

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

文本编辑器

vim — Vim 编辑器

bash
vim file.txt

nano — Nano 编辑器

bash
nano file.txt

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

系统命令

clear — 清屏

bash
clear

help — 帮助

bash
help

whoami — 当前用户

bash
whoami
# 输出: dev

date — 当前时间

bash
date
# 输出: 当前日期时间

管道

TSH 支持多级管道,用 | 分隔命令:

bash
command1 | command2 | command3

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

脚本命令

tsh — 运行 TSH 脚本

bash
tsh script.tsh

source — 加载执行脚本

bash
source script.tsh

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

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

插件命令

plugin — 插件管理

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

详细用法请参考 插件概述

路径规则

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

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

重定向

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

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

基于 MIT 许可证发布