mirror of
https://github.com/tradecatlabs/vibe-coding-cn.git
synced 2026-08-17 04:48:06 +00:00
61 lines
2.3 KiB
Markdown
61 lines
2.3 KiB
Markdown
# auto-tmux scripts
|
|
|
|
`scripts/` 存放 `auto-tmux` 的可执行辅助脚本，把常见 tmux 操作封装成安全、可复用、可审计的命令。
|
|
|
|
## 入口
|
|
|
|
- [`auto-tmux.sh`](./auto-tmux.sh) - 统一命令入口，支持拓扑、读取、发送、巡检、救援、录制、等待和 AI 工作台初始化。
|
|
- [`swarm-state.sh`](./swarm-state.sh) - 蜂群状态、任务、锁和报告管理。
|
|
- [`render-swarm-prompt.sh`](./render-swarm-prompt.sh) - commander、worker、reviewer 提示词渲染。
|
|
- [`auto-tmux-smoke-test.sh`](./auto-tmux-smoke-test.sh) - 创建临时 tmux 会话，端到端验证脚本能力。
|
|
|
|
## 常用命令
|
|
|
|
```bash
|
|
# 查看帮助
|
|
skills/auto-tmux/scripts/auto-tmux.sh help
|
|
|
|
# 查看 tmux 拓扑
|
|
skills/auto-tmux/scripts/auto-tmux.sh topology
|
|
|
|
# 诊断环境
|
|
skills/auto-tmux/scripts/auto-tmux.sh doctor --session ai-hub
|
|
|
|
target="$(tmux list-panes -t ai-hub:worker1 -F '#S:#I.#P' | head -n 1)"
|
|
|
|
# 读取指定 pane 最近 80 行
|
|
skills/auto-tmux/scripts/auto-tmux.sh capture -t "$target" -n 80
|
|
|
|
# 发送命令并回车
|
|
skills/auto-tmux/scripts/auto-tmux.sh send -t "$target" --text "make test" --enter
|
|
|
|
# 扫描某个 session 的错误
|
|
skills/auto-tmux/scripts/auto-tmux.sh scan --session ai-hub --pattern "ERROR|Traceback"
|
|
|
|
# 受控广播，先 dry-run
|
|
skills/auto-tmux/scripts/auto-tmux.sh broadcast --session ai-hub --text "pwd" --enter --dry-run
|
|
|
|
# 生成证据快照
|
|
skills/auto-tmux/scripts/auto-tmux.sh snapshot --session ai-hub --dir /tmp/auto-tmux-snapshot
|
|
|
|
# 初始化蜂群状态并添加任务
|
|
skills/auto-tmux/scripts/swarm-state.sh init --dir /tmp/ai_swarm
|
|
skills/auto-tmux/scripts/swarm-state.sh task-add --id task-001 --text "检查 README 链接"
|
|
skills/auto-tmux/scripts/swarm-state.sh report --dir /tmp/ai_swarm
|
|
|
|
# 端到端自测
|
|
skills/auto-tmux/scripts/auto-tmux-smoke-test.sh
|
|
|
|
# 渲染 worker prompt
|
|
skills/auto-tmux/scripts/render-swarm-prompt.sh worker --target "$target" --task "只运行 make test"
|
|
```
|
|
|
|
## 安全约束
|
|
|
|
- 默认对捕获输出做密钥脱敏。
|
|
- `send` 会先打印目标 pane 最近上下文，再发送按键。
|
|
- 危险命令默认拒绝，必须显式 `--force`。
|
|
- 批量操作必须使用明确的 session/window/pane 目标。
|
|
- 批量广播必须先 `--dry-run`，确认目标列表后再真实发送。
|
|
- 多 worker 协作时用 `swarm-state.sh lock-acquire` 声明文件、目录或服务锁。
|