快速上手
什么是 TSH
TSH (Tiny Shell) 是一个运行在浏览器中的网页终端。它基于 Cloudflare Worker 部署,打开网页即可获得完整的终端体验——文件操作、文本编辑、脚本执行、插件扩展,无需安装任何客户端。
在线体验
访问 TSH 在线版本,直接在浏览器中开始使用:
在线体验地址
首次打开时,浏览器会弹出文件夹授权对话框。选择一个文件夹作为终端的工作目录,TSH 将获得该目录的读写权限。
浏览器要求
TSH 使用 File System Access API,需要 Chrome 86+ 或 Edge 86+ 浏览器。Firefox 和 Safari 暂不支持此 API。
第一条命令
授权完成后,你会看到 TSH 提示符:
dev@tsh / ▸尝试输入以下命令:
bash
# 查看当前目录文件
ls
# 创建文件
touch hello.txt
# 写入内容
echo "Hello TSH" > hello.txt
# 查看文件内容
cat hello.txt
# 创建目录
mkdir myproject
# 进入目录
cd myproject
# 查看当前路径
pwd使用管道
TSH 支持管道操作,将前一个命令的输出作为后一个命令的输入:
bash
# echo 输出通过管道传给 tee
echo "line1" | tee log.txt
# 多级管道
echo "hello world" | tee output.txt安装插件
TSH 内置了插件系统,一行命令即可安装:
bash
# 安装计算器插件
plugin install /plugins/calx.js
# 使用计算器
calx 2+3*4
# 输出: 14
# 安装设备检测插件
plugin install /plugins/ck.js
# 检测设备信息
ck使用编辑器
在终端中直接编辑文件:
bash
# 用 Vim 编辑
vim hello.txt
# 用 Nano 编辑
nano hello.txt编辑器完全在终端内运行,无需弹窗。退出编辑器后会自动清屏并恢复终端状态。
运行脚本
TSH 支持自研脚本语言,编写 .tsh 文件实现自动化:
bash
# 创建脚本
cat > demo.tsh << 'EOF'
var name = "World"
echo "Hello, ${name}!"
for i in 1 2 3 {
echo "Count: ${i}"
}
EOF
# 运行脚本
tsh demo.tsh本地开发
如果你想本地运行或参与开发:
bash
# 克隆仓库
git clone https://github.com/tsh-dev/tsh.git
cd tsh/cf-worker
# 安装依赖
npm install
# 启动本地开发服务器
node local-dev.js
# 打开 http://localhost:8787/
# 构建 Worker
node build-worker.js详细的部署流程请参考 部署指南。