q quicktuiv1 获取应用

安装

安装 QuickTUI 服务端

三步把会话装到手机上, 下面是完整参考: 安装参数、配对运维、手势。

三步

  1. 在电脑上 — 装 server. 在 Mac / Linux 的终端里跑一行. 需要 tmux 3.2+ (安装器只检查, 不代装). Windows 在 PowerShell 跑一行, 不需要 tmux.

    macOS / Linux 需要 tmux 3.2+, 安装器只检查, 不代装.

    macOS / Linux · Global

    curl -fsSL https://quicktui.ai/q.sh | sh

    macOS / Linux · China

    curl -fsSL https://dl.quicktui.cn/q.sh | sh

    Windows · PowerShell

    irm https://quicktui.ai/q.ps1 | iex

  2. 在手机上 — 装 App. App Store 下载 QuickTUI, iPhone 和 iPad 通用.

  3. 在手机上 — 配对一次. 安装器显示二维码, 用 App 扫一下. 会话就在手机上了.

    交互安装会打开配对向导。需要重新开始时，运行 quicktui-server pairing welcome；也可以运行 quicktui-server pairing qrcode，再用原生 App 扫描短期有效的二维码。

手机在手边, 电脑不在? 在 App 里添加服务器, 选「快速设置」, 填 SSH 登录信息, App 帮你把 server 装好.

参考

为每个客户端配对。

桌面环境下可加 --browser，在机器的默认浏览器中渲染二维码；用 --select-address 选择检测到的地址，或用 --debug-addr <host:port|URL> 把指定公网 URL 写入二维码。
当前 CLI 流程只支持能扫描二维码的原生 App 配对新设备，尚不提供 Web 或 Desktop 新设备配对所需的完整 payload 导出。Web 仅在 HTTPS 或 http://localhost:8022 这类 loopback origin 创建或保存设备凭据；远程明文 HTTP origin 会被拒绝。QuickTUI 不再提供 root token 或 browser token 登录。

设备配对运维。

列出或撤销已配对设备，无需重启服务：

# macOS / Linux
quicktui-server pairing devices list
quicktui-server pairing devices revoke <device_id>

# Windows PowerShell
& "$env:LOCALAPPDATA\QuickTUI\quicktui-server.exe" pairing devices list
& "$env:LOCALAPPDATA\QuickTUI\quicktui-server.exe" pairing devices revoke <device_id>

每个已配对客户端都会固定 server identity，并在 E2E 隧道内用绑定当前握手 transcript 的 device_pop_v1 完成认证。直连会端到端承载这条 E2E 隧道；QuickTUI Relay 只转发不透明的加密帧。撤销设备后，该客户端必须重新配对。quicktui-server pairing identity rotate 会轮换服务端 E2E identity 并清空全部配对；Windows 请使用上方相同的完整可执行文件路径。执行前必须先停止服务。仅在你打算让所有设备重新配对时使用。

使用已退役 root token 创建的 profile 必须重新配对。旧版每设备 token 只能在固定 identity 的 E2E 隧道内一次性迁移为 PoP 设备凭据；迁移后客户端会用 device_pop_v1 重新认证并删除旧 token。

中国镜像入口。

这是面向中国用户的并列入口。已通过 quicktui.ai/q.sh 安装的服务不会自动迁移; 重新执行 dl.quicktui.cn/q.sh 后才会走 OSS 自动更新。

Windows 电脑？PowerShell 里跑一行。

自动下载安装器、自动安装 qscn 会话后端，并注册登录时自启的计划任务。中国镜像入口将在 qscn 资产镜像完成后支持 Windows。老旧 Windows PowerShell 5.1 若未启用 TLS 1.2，在同一行前面加上 [Net.ServicePointManager]::SecurityProtocol = [Net.ServicePointManager]::SecurityProtocol -bor 3072; 即可。

安装脚本参数

非交互式安装、自定义端口、环境检查。通过 sh -s -- 传入：

参数说明
-y, --yes非交互模式
--addr <address>监听主机、host:port 或 http(s)://host:port（默认：0.0.0.0）。IPv6 字面量必须用方括号并自带端口，如 [::1]:9000
--port <port>监听端口，仅在 --addr 未含端口时生效（默认：8022）
--term <value>tmux 的 TERM（默认：xterm-256color）
--lang <value>tmux 的 LANG（默认：en_US.UTF-8）
install --channel stable安装最新正式版服务端（bootstrap 零参数默认）
install --channel preview安装最新 preview 版服务端
install --tag <tag>直接从发布源安装该精确 release tag，跳过 manifest
check仅运行环境检查，不安装
--no-service跳过后台服务注册
uninstall停止服务并卸载服务端
curl -fsSL https://quicktui.ai/q.sh | sh -s -- install --channel stable -y --port 9000

手势操作

在手机或 iPad 上驾驭终端的方式。部分单指 / 双指动作可以在设置里互换。

手势动作
单指双击输入 Tab
双指双击输入 Enter
单指上下滑滚动历史
单指左右滑切换 tmux 窗口
双指滑动方向键
三指左滑退格
三指上滑打开会话切换器

相关