当 AI 编码代理住进终端：从执行工具到有状态工作空间的转变

# tmux-agent-setup.sh — 为 AI coding agent 创建结构化工作空间
# 使用方法：source tmux-agent-setup.sh 或逐行执行

SESSION="agent-work"

# 创建新 session
tmux new-session -d -s "$SESSION" -n "main"

# 窗格 0：你的操作区（左侧大窗格）
# 窗格 1：agent 运行区（右侧上方）
# 窗格 2：agent 日志/状态（右侧下方）

# 先垂直分割
tmux split-window -v -t "$SESSION:main"
# 再在右侧窗格水平分割
tmux split-window -h -t "$SESSION:main.1"

# 调整窗格大小：左侧占 60%，右侧上下各占 50%
tmux resize-pane -t "$SESSION:main.0" -x 60%
tmux resize-pane -t "$SESSION:main.1" -y 50%

# 在日志窗格启动实时日志监控
tmux send-keys -t "$SESSION:main.2" 'tail -f /tmp/agent-log.md' Enter

# 在 agent 窗格启动你的 coding agent（示例用 aider）
tmux send-keys -t "$SESSION:main.1" 'aider --model gpt-4o --chat-mode code' Enter

# 切到你的操作区
tmux select-pane -t "$SESSION:main.0"

# 附着到 session
tmux attach-session -t "$SESSION"

┌──────────────────┬──────────────┐
│                  │  agent 运行   │
│   你的操作区      │  (aider等)   │
│   编辑/审查/     ├──────────────┤
│   手动干预       │  agent 日志   │
│                  │  (tail -f)   │
└──────────────────┴──────────────┘

# agent_logger.py — 给 AI coding agent 的动作加结构化日志
# 用法：在 agent 的工具调用前后插入日志记录

import json
from datetime import datetime
from pathlib import Path

LOG_FILE = Path("/tmp/agent-log.md")

def log_action(action: str, target: str, detail: str = "", status: str = "running"):
    """记录 agent 的一个动作到 markdown 日志"""
    timestamp = datetime.now().strftime("%H:%M:%S")
    entry = (
        f"## [{timestamp}] {action}: {target}\n"
        f"- **状态**: {status}\n"
        f"- **详情**: {detail}\n\n"
    )
    with LOG_FILE.open("a") as f:
        f.write(entry)

def log_step(step_num: int, total: int, description: str):
    """记录 agent 当前在第几步"""
    timestamp = datetime.now().strftime("%H:%M:%S")
    progress = f"[{step_num}/{total}]"
    entry = (
        f"# 进度 {progress} — {description}\n"
        f"> 时间: {timestamp}\n\n"
    )
    with LOG_FILE.open("a") as f:
        f.write(entry)

# ---- 使用示例 ----
# 在你的 agent wrapper 或 hook 中调用：
log_step(1, 5, "读取项目结构，分析依赖关系")
log_action("read", "src/auth.py", "检查登录逻辑的现有实现", "done")

log_step(2, 5, "修改认证模块，添加 token 刷新")
log_action("edit", "src/auth.py", "在 L45 添加 refresh_token 方法", "running")

log_step(3, 5, "运行测试验证修改")
log_action("run", "pytest tests/auth_test.py", "3 passed, 1 failed", "failed")

# 进度 [2/5] — 修改认证模块，添加 token 刷新
> 时间: 14:32:08

## [14:32:05] read: src/auth.py
- **状态**: done
- **详情**: 检查登录逻辑的现有实现

## [14:32:10] edit: src/auth.py
- **状态**: running
- **详情**: 在 L45 添加 refresh_token 方法

# agent-interrupt.sh — 在 agent 运行中安全干预的快捷操作
# 绑定到 tmux 快捷键，随时可用

# 在 tmux 配置中添加以下绑定 (~/.tmux.conf)
# Ctrl-a = 中断 agent 并进入审查模式
# Ctrl-r = 从日志恢复 agent 上一步的上下文

cat >> ~/.tmux.conf << 'EOF'
bind-key a send-keys -t "#{session_name}:main.1" C-c \; \
             send-keys -t "#{session_name}:main.0" '# agent 已中断，进入手动审查模式' Enter \; \
             select-pane -t "#{session_name}:main.0"

bind-key r send-keys -t "#{session_name}:main.0" '# 从日志恢复上下文 — 查看最近动作:' Enter \; \
             send-keys -t "#{session_name}:main.0" 'tail -20 /tmp/agent-log.md' Enter
EOF

# 重新加载 tmux 配置
tmux source-file ~/.tmux.conf