VibeTunnel_IT运维与安全 skill-PHP中文网

VibeTunnel

Polar Sponsor

爱发电赞助

.NET 9.0

立即下载

管理 VibeTunnel 终端会话，在网页仪表板上创建、列出、监控和控制会话。

VibeTunnel. 管理 VibeTunnel终端会话通过 REST API. 创建,列出,监视,控制在网络仪表板上可见的会话.

功能概述

VibeTunnel. 管理 VibeTunnel终端会话通过 REST API. 创建,列出,监视,控制在网络仪表板上可见的会话.是一项面向实际任务的技能，主要用于Setup.；VibeTunnel 必须是运行.；

核心要点

Default: http://localhost。
它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。
使用时应结合输入条件选择合适的执行方式，核对必要参数、依赖环境与输出内容，并按原始要求处理异常情况。

使用与执行

从功能定位来看，该技能强调把分散的操作要求整理成清晰、可复用的处理流程，使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数，再依据技能说明逐步执行；若输入条件不完整，应先补齐信息或采用保守配置，避免因错误假设导致结果偏离需求。

结果检查与注意事项

执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期，并对异常提示、缺失字段和边界情况进行处理；涉及批量任务时，还应保存进度，避免中断后重复操作。该技能适合用于一次性任务，也可以接入自动化工作流，与其他技能或上层代理配合完成更完整的业务链路；在组合使用时，应明确每一步的输入输出关系，并避免不同步骤之间出现参数冲突。

VibeTunnel

通过 REST API 管理 VibeTunnel 终端会话。可创建、列出、监控和控制 Web 仪表板中可见的会话。

设置

VibeTunnel 必须处于运行状态。默认地址为：http://localhost:8080。可通过环境变量 VT_URL 覆盖该地址。

健康检查

curl -s ${VT_URL:-http://localhost:8080}/api/health | jq .

列出会话

curl -s ${VT_URL:-http://localhost:8080}/api/sessions | jq .

精简视图：

curl -s ${VT_URL:-http://localhost:8080}/api/sessions | jq -r '.[] | "(.status | if . == "running" then "●" else "○" end) (.name) [(.id | .[0:8])]"'

创建会话

curl -s -X POST ${VT_URL:-http://localhost:8080}/api/sessions 
  -H "Content-Type: application/json" 
  -d '{"command": ["zsh", "-l", "-i"], "name": "my-session", "workingDir": "/path/to/dir"}' | jq .

参数说明：

command：数组 — 命令及其参数（默认值：["zsh", "-l", "-i"]）
name：字符串 — 显示名称
workingDir：字符串 — 工作目录
cols：数字 — 终端宽度（默认值：120）
rows：数字 — 终端高度（默认值：30）

获取会话详情

curl -s ${VT_URL:-http://localhost:8080}/api/sessions/ | jq .

删除会话

curl -s -X DELETE ${VT_URL:-http://localhost:8080}/api/sessions/ | jq .

发送输入

curl -s -X POST ${VT_URL:-http://localhost:8080}/api/sessions//input 
  -H "Content-Type: application/json" 
  -d '{"text": "ls -lan"}' | jq .

注意：需在输入文本末尾包含换行符 n 才能执行命令。

调整会话尺寸

curl -s -X POST ${VT_URL:-http://localhost:8080}/api/sessions//resize 
  -H "Content-Type: application/json" 
  -d '{"cols": 150, "rows": 40}' | jq .

示例

启动 Claude Code 会话：

curl -s -X POST ${VT_URL:-http://localhost:8080}/api/sessions 
  -H "Content-Type: application/json" 
  -d '{"command": ["claude"], "name": "claude-code", "workingDir": "~/repos/my-project"}' | jq .

启动 tmux 会话：

curl -s -X POST ${VT_URL:-http://localhost:8080}/api/sessions 
  -H "Content-Type: application/json" 
  -d '{"command": ["tmux", "new", "-A", "-s", "work"], "name": "tmux-work"}' | jq .

清理已退出的会话：

curl -s ${VT_URL:-http://localhost:8080}/api/sessions | jq -r '.[] | select(.status == "exited") | .id' | 
  xargs -I {} curl -s -X DELETE ${VT_URL:-http://localhost:8080}/api/sessions/{}