快速上手

────────────────────────────────────────

本指南带你在 3 分钟内完成：安装 CLI → 登录观猹 → 推送第一个静态站点。

1. 安装 tt2 CLI

通过 npm 全局安装（推荐 Node.js ≥ 18）：

npm install -g @tt2/cli

或使用一键安装脚本（macOS / Linux）：

curl -fsSL https://lhub.tt2.li/install.sh | sh

验证安装：

tt2 --version

2. 登录观猹账号

tt2 login

CLI 会发起设备码授权：终端显示一个形如 ABCD-1234 的授权码和一个确认链接。 在浏览器中打开链接（或直接进入控制台设备页）， 使用观猹账号登录后确认授权，CLI 即自动获得凭证。

确认当前登录身份：

tt2 whoami

3. 推送你的站点

假设你有一个构建好的静态目录 ./dist（必须包含 index.html）：

tt2 push ./dist --name myapp

推送后，服务端的猹询码会对产物进行安全审查与自动适配，然后分发到边缘节点。 几秒钟后，你的站点即可通过 https://myapp.lhub.tt2.li 访问，SSL 证书自动签发。

4. 跟踪任务进度

推送是异步任务。用以下命令查看进度与结果：

# 查看最近的部署任务
tt2 tasks

# 持续跟踪某个任务（将 <task_id> 替换为 push 返回的任务 ID）
tt2 reply <task_id>

接下来

• CLI 完整命令参考——状态查询、站点管理、域名绑定、TokenPay 连接
• 自备域名指南——把 example.com 指到你的 lhub 站点
• 推送标准——产物规范与猹询码的自动修补行为

常见问题

部署要花多少钱？

部署任务消耗你在控制台连接的 TokenPay（TokenDance）模型额度。 额度耗尽时会自动切换到全平台共享的免费任务池，排队时间可能略长，但不会部署失败。

站点名字有什么规则？

--name 决定了三级域名 <name>.lhub.tt2.li。 仅允许小写字母、数字和中划线，3–32 字符，全平台唯一，先到先得。