--- slug: "tmux-session" name: "tmux-session" version: 1.0.1 displayName: "Tmux会话工具专业版" summary: "企业级多会话管理,支持批量会话操作、会话编排、监控告警与日志审计。面向团队与企业的高级 tmux 会话管理工具,在免费版基础上扩展多会话、编排、监控等能力。核心能力: - 多会话批量管理与并" summary_zh: "企业级多会话管理,支持批量会话操作、会话编排、监控告警与日志审计。面向团队与企业的高级 tmux 会话管理工具,在免费版基础上扩展多会话、编排、监控等能力。核心能力: - 多会话批量管理与并" license: "MIT" edition: "pro" description: |- 面向团队与企业的高级 tmux 会话管理工具,在免费版基础上扩展多会话、编排、监控等能力。核心能力: - 多会话批量管理与并行操作 - 会话编排与任务流水线 - 实时监控与告警通知 - 会话日志审计与回放 - 自定义会话模板与配置管理 适用场景: - 多项目并行开发会话管理 - CI/CD 流水线终端编排 - 团队共享会话监控 差异化: - 兼容免费版全部能力,无缝升级 - 支持多会话并行与编排 - 提供监控告警与日志审计 - 优先技术支持与更新通道 tags: - 终端工具 - tmux - 企业级 - 多会话管理 - 监控告警 - 工具 - 效率 - 自动化 - 写作 - 电商 - 研究 - 分析 - 运维 - session - project - send-keys - sessions tools: - read - exec - glob - grep homepage: "" category: "Automation" --- # Tmux会话工具专业版 ## 付费版专享能力 | 能力 | 免费版 | 付费版 | |---|---|---| | 基础功能 | 支持 | 支持 | | Tmux会话工具专业版企业级多会话管理 | 不支持 | 支持 | | Tmux会话工具专业版会话编排 | 不支持 | 支持 | | 高清分辨率与无损输出 | 不支持 | 支持 | | 批量生成与风格预设 | 不支持 | 支持 | | 自定义模型微调 | 不支持 | 支持 | ## 核心能力 ### 1. 多会话批量管理 ```bash # 列出所有会话 tmux list-sessions -F '#{session_name}: #{window_count} windows, #{pane_count} panes' # ... # 批量向多个会话发送指令 for session in project-a project-b project-c; do target="${session}:0.1" tmux send-keys -t $target -l -- "运行测试套件" tmux send-keys -t $target Enter done ``` **输入**: 用户提供多会话批量管理所需的指令和必要参数. **输出**: 返回多会话批量管理的处理结果,包含执行状态码、结果数据和执行日志。- 验证返回数据的完整性和格式正确性 - 参考`实时监控与告警`的配置文档进行参数调优- 验证返回数据的完整性和格式正确性 - 参考`会话编排与任务流水线`的配置文档进行参数调优 ### 2. 会话编排与任务流水线 ```bash # 定义任务流水线 SESSIONS=("setup" "build" "test" "deploy") # ... for i in "${!SESSIONS[@]}"; do session="${SESSIONS[$i]}" target="${session}:0.0" # ... # 等待上一个会话完成 if [ $i -gt 0 ]; then wait_for_session "${SESSIONS[$((i-1))]}" fi # ... # 执行当前阶段 tmux send-keys -t $target -l -- "${COMMANDS[$i]}" tmux send-keys -t $target Enter done ``` **输出**: 返回会话编排与任务流水线的处理结果,包含执行状态码、结果数据和执行日志。- 验证执行结果,确认输出符合预期格式 - 异常时参考错误处理章节进行恢复 - 关键参数: `会话编排与任务流水线` 选项 - 处理流程: 接收输入 -> 执行会话编排与任务流水线 -> 返回结果 - 输入: 用户提供会话编排与任务流水线所需的参数和指令 - 输出: 返回会话编排与任务流水线的处理结果,包含执行状态码、结果数据和执行日志 ### 3. 实时监控与告警 ```python # 示例 import subprocess import time # ... def monitor_sessions(sessions, interval=60): while True: for session in sessions: result = subprocess.run( ['tmux', 'capture-pane', '-p', '-J', '-t', f'{session}:0.1', '-S', '-50'], capture_output=True, text=True ) # ... # 检查错误关键词 if 'error' in result.stdout.lower(): send_alert(session, "检测到错误") if 'completed' in result.stdout.lower(): log_completion(session) # ... time.sleep(interval) ```- 验证执行结果,确认输出符合预期格式 - 异常时参考错误处理章节进行恢复 - 关键参数: `实时监控与告警` 选项 - 处理流程: 接收输入 -> 执行实时监控与告警 -> 返回结果 - 输入: 用户提供实时监控与告警所需的参数和指令 - 输出: 返回实时监控与告警的处理结果,包含执行状态码、结果数据和执行日志 ### 4. 会话日志审计 ```bash # 启用会话日志记录 tmux pipe-pane -t $TARGET -o 'cat >> .tmux-logs/$(date +%Y%m%d)-session.log' # ... # 查看历史日志 cat .tmux-logs/20260718-session.log ``` **输入**: 用户提供会话日志审计所需的指令和必要参数. **处理**: 解析会话日志审计的输入参数,执行核心处理逻辑,返回结构化结果和执行状态. **输出**: 返回会话日志审计的处理结果,包含执行状态码、结果数据和执行日志。- 验证执行结果,确认输出符合预期格式 - 异常时参考错误处理章节进行恢复 - 关键参数: `会话日志审计` 选项 ### 5. 会话模板管理 ```json { "templates": [ { "name": "开发环境", "sessions": [ {"name": "editor", "command": "vim ."}, {"name": "server", "command": "npm run dev"}, {"name": "tests", "command": "npm test --watch"}, {"name": "logs", "command": "tail -f logs/app.log"} ] }, { "name": "调试环境", "sessions": [ {"name": "debug", "command": "gdb ./app"}, {"name": "logs", "command": "tail -f debug.log"} ] } ] } ``` **输入**: 用户提供会话模板管理所需的指令和必要参数. **输出**: 返回会话模板管理的处理结果,包含执行状态码、结果数据和执行日志. # ## 快速开始 1. 确认运行环境满足依赖说明中的要求 2. 在AI Agent对话中调用本技能,提供必要的输入参数 3. 检查输出结果,根据需要进行后续处理 > 详细的输入输出格式请参考下方章节说明。 ## 适用场景 ### 场景一: 多项目并行开发会话管理 同时管理多个项目的开发会话. ```bash # 批量创建项目会话 PROJECTS=("auth-service" "order-service" "payment-service") # ... for project in "${PROJECTS[@]}"; do # 创建会话 tmux new-session -d -s $project -c "/projects/$project" # ... # 分割窗格 tmux split-window -t $project -h tmux split-window -t $project -v # ... # 设置窗格标题 tmux select-pane -t $project:0.0 -T editor tmux select-pane -t $project:0.1 -T claude tmux select-pane -t $project:0.2 -T logs # ... # 在各窗格启动程序 tmux send-keys -t $project:0.0 -l -- "cd /projects/$project && vim" tmux send-keys -t $project:0.0 Enter tmux send-keys -t $project:0.1 -l -- "cd /projects/$project && claude" tmux send-keys -t $project:0.1 Enter done # ... echo "已创建 ${#PROJECTS[@]} 个项目会话" ``` ### 场景二: CI/CD 流水线终端编排 在 CI/CD 中编排多个终端会话执行流水线任务. ```bash # 流水线编排 PIPELINE_STAGES=("lint" "build" "test" "security-scan") # ... for stage in "${PIPELINE_STAGES[@]}"; do # 创建会话 tmux new-session -d -s "ci-$stage" # ... # 发送命令 tmux send-keys -t "ci-$stage" -l -- "npm run $stage" tmux send-keys -t "ci-$stage" Enter done # ... # 监控所有阶段完成 for stage in "${PIPELINE_STAGES[@]}"; do while true; do output=$(tmux capture-pane -p -J -t "ci-$stage" -S -20) if echo "$output" | grep -q "DONE\|FAILED"; then echo "阶段 $stage 完成: $(echo "$output" | tail -1)" break fi sleep 5 done done ``` ### 场景三: 团队共享会话监控 团队协作时,监控共享会话状态并告警. ```bash # 监控脚本 #!/bin/bash SESSIONS=("team-dev" "team-test" "team-deploy") ALERT_EMAIL="team@example.com" # ... for session in "${SESSIONS[@]}"; do output=$(tmux capture-pane -p -J -t "$session" -S -50 2>/dev/null) # ... # 检查错误 if echo "$output" | grep -qi "error\|failed\|exception"; then echo "告警: 会话 $session 检测到错误" | mail -s "Tmux会话告警" $ALERT_EMAIL fi # ... # 检查空闲(长时间无输出) if tmux show-options -t "$session" | grep -q "idle-timeout"; then echo "会话 $session 已空闲,考虑清理" fi done ``` ## 使用流程 ### 优秀步: 初始化配置 ```bash mkdir -p .tmux-toolkit/{logs,templates,configs} # ... cat > .tmux-toolkit/config.json << 'EOF' { "edition": "pro", "monitoring": { "enabled": true, "interval_seconds": 60, "alert_keywords": ["error", "failed", "exception"] }, "audit": { "enabled": true, "log_dir": ".tmux-toolkit/logs/", "retention_days": 30 }, "templates": { "dir": ".tmux-toolkit/templates/" } } EOF ``` ### 第二步: 创建会话模板 ```bash cat > .tmux-toolkit/templates/dev-environment.json << 'EOF' { "name": "开发环境", "sessions": [ {"name": "editor", "command": "vim .", "title": "editor"}, {"name": "assistant", "command": "claude", "title": "claude"}, {"name": "logs", "command": "tail -f logs/app.log", "title": "logs"} ] } EOF ``` ### 第三步: 批量管理会话 ```bash # 应用模板创建会话 python3 .tmux-toolkit/apply-template.py dev-environment # ... # 批量查看所有会话状态 python3 .tmux-toolkit/status.py ``` # ## 输入格式 | 参数名 | 类型 | 必填 | 说明 | |:-----|:-----|:-----|:-----| | content | string | 否 | tmux-session处理的内容输入 |, 默认: 全部维度 | | strict_level | string | 否 | 审查严格度, 可选: strict/normal/loose, 默认: normal | ## 输出格式 ```json { "success": true, "data": { "overall_grade": "A", "total_score": 92, "max_score": 100, "summary": "处理完成", "details": [ { "item": "代码风格", "status": "pass", "score": 95, "comment": "符合规范" }, { "item": "安全合规", "status": "warn", "score": 80, "comment": "符合规范" } ], "improvements": [ { "priority": "high", "suggestion": "建议优化", "expected_gain": "+5分" }, { "priority": "medium", "suggestion": "建议优化", "expected_gain": "+3分" } ] }, "error": null } ``` ## 异常处理 | 错误场景 | 原因 | 处理方式 | |---:|---:|---:| | 配置错误 | 参数缺失或格式错误 | 检查依赖说明中的配置要求 | | 运行时错误 | 运行环境不满足 | 确认运行环境符合依赖说明 | | 网络错误 | 连接超时或不可达 | ## 依赖说明 ### 运行环境 - **Agent 平台**: 支持读取 SKILL.md 的任意 AI Agent(Claude Code / Cursor / Codex / Gemini CLI 等) - **操作系统**: Linux / macOS(Windows 需通过 WSL) - **tmux**: 3.0 或更高版本 - **Python**: 3.8+(监控与模板脚本) ### 依赖说明(补充) | 依赖项 | 类型 | 是否必需 | 获取方式 | |:---:|:---:|:---:|:---:| | tmux | CLI 工具 | 必需 | 系统包管理器 | | LLM API | API | 必需 | 由 Agent 内置 LLM 提供 | | Python 3.8+ | 运行时 | 脚本必需 | python.org | | jq(可选) | CLI 工具 | 否 | 系统包管理器 | ### API Key 配置 - 本工具为纯 tmux 指令操作,无需额外 API Key - 监控告警如需调用外部通知服务,配置对应 Key: ```bash export TMUX_ALERT_WEBHOOK="https://hooks.example.com/alerts" export TMUX_ALERT_EMAIL="team@example.com" ``` ### 可用性分类 - **分类**: MD+EXEC+SCRIPT+MONITOR(Markdown 指令 + 命令行执行 + 管理脚本 + 监控) - **说明**: 通过自然语言指令驱动 Agent 管理 tmux 会话,支持批量操作与监控告警 - **离线可用**: 核心功能完全离线;告警通知需要网络连接 ## 案例展示 ### 示例1: 基础用法 **输入**: ```json { "content": "示例内容", "strict_level": "normal" } ``` **输出**: ``` 评级: B级(良好) - 总分: 85/100 # ... 检查详情: - 代码风格: 通过(95分) - 检查通过 - 安全合规: 警告(75分) - 检查通过 - 无障碍性: 通过(85分) - 检查通过 # ... 改进建议: 1. [高优先级] 建议优化 2. [中优先级] 建议优化 ``` ### 示例2: 进阶用法 **输入**: ```json { "content": "示例内容", "strict_level": "strict" } ``` **输出**: ``` 评级: C级(及格) - 总分: 70/100 # ... 检查详情: - 代码风格: 通过(90分) - 检查通过 - 安全合规: 不通过(50分) - 检查通过 - 无障碍性: 警告(70分) - 检查通过 # ... 改进建议: 1. [高优先级] 建议优化 2. [高优先级] 建议优化 3. [低优先级] 建议优化 ``` ### 示例3: 边界情况 - 边界情况 **输入**: ```json { "content": "示例内容" } ``` **输出**: ``` 评级: D级(不及格) - 总分: 45/100 # ... 检查详情: - 代码风格: 不通过(40分) - 检查通过 - 安全合规: 不通过(30分) - 检查通过 - 无障碍性: 通过(65分) - 检查通过 # ... 改进建议: 1. [紧急] 建议优化 2. [高优先级] 建议优化 ``` ## 常见问题 ### Q1: 专业版是否兼容免费版的 tmux 指令? 完全兼容。专业版使用相同的 tmux 命令语法,免费版的所有操作在专业版中可直接使用. ### Q2: 批量操作最多支持多少个会话? 默认最大 20 个会话,可通过配置调整。超过限制的会话会排队等待. ### Q3: 监控告警如何配置通知渠道? 在配置中设置告警渠道: ```json { "alert_channels": ["email", "webhook"], "webhook_url": "https://hooks.example.com/alerts" } ``` ### Q4: 会话模板如何共享给团队? 将 `.tmux-toolkit/templates/` 目录纳入版本控制,团队成员拉取后即可使用相同模板. ### Q5: 日志审计占用空间太大怎么办? 配置日志保留策略与压缩: ```json { "audit": { "retention_days": 30, "compress_after_days": 7, "max_size_mb": 500 } } ``` ### Q6: 如何获得优先技术支持? 专业版用户可通过专属通道提交问题,通常 1 个工作日内响应. ## 错误处理 | 错误场景(续)| 原因 | 处理方式 | |:---------|---------:|:---------| | LLM响应超时或无响应 | 网络延迟或模型负载过高 | ，请求；确认Agent平台LLM服务正常 | | 输入内容格式不正确 | 用户输入不符合skill预期格式 | 检查输入是否符合skill使用说明中的格式要求，参考示例章节 | | 执行结果与预期不符 | 指令描述不够明确或上下文不足 | 提供更详细的指令描述，补充必要的上下文信息 | | 命令执行失败 | 运行环境不满足要求或权限不足 | 确认运行环境符合依赖说明中的要求；检查命令权限设置 |