Skip to content

快速上手

什么是 TSH

TSH (Tiny Shell) 是一个运行在浏览器中的网页终端。它基于 Cloudflare Worker 部署,打开网页即可获得完整的终端体验——文件操作、文本编辑、脚本执行、插件扩展,无需安装任何客户端。

在线体验

访问 TSH 在线版本,直接在浏览器中开始使用:

在线体验地址

https://look.tsh.qzz.io/

首次打开时,浏览器会弹出文件夹授权对话框。选择一个文件夹作为终端的工作目录,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

详细的部署流程请参考 部署指南

下一步

基于 MIT 许可证发布