Function demonstrate_auto_background

tutorials/14_bash_engine_deep_dive.py:641–679

自动后台化 — reference/06-bash-engine.md 问题: 模型请求执行一个命令，但这个命令跑了 30 秒还没完。 如果一直等着，用户体验很差。 解决方案: 四条后台化路径: 1. 显式: 模型设置 run_in_background=true 2. 超时: 命令超过默认超时时间 3. 助手模式: 在主代理中阻塞 > 15 秒 4. 用户: 按 Ctrl+B 手动后台化 特殊规则: sleep 命令禁止自动后台化！

()

def demonstrate_auto_background():
    """自动后台化 — reference/06-bash-engine.md

    问题: 模型请求执行一个命令，但这个命令跑了 30 秒还没完。
    如果一直等着，用户体验很差。

    解决方案: 四条后台化路径:
    1. 显式: 模型设置 run_in_background=true
    2. 超时: 命令超过默认超时时间
    3. 助手模式: 在主代理中阻塞 > 15 秒
    4. 用户: 按 Ctrl+B 手动后台化

    特殊规则: sleep 命令禁止自动后台化！
    """
    print("\n=== 自动后台化策略 ===")

    AUTO_BG_THRESHOLD_SECONDS = 15  # 主代理阻塞阈值
    SLEEP_COMMANDS = {"sleep"}  # 禁止自动后台化的命令

    def should_auto_background(command: str, elapsed: float) -> bool:
        """决定是否自动后台化"""
        # 检查是否是 sleep 命令
        first_word = command.strip().split()[0] if command.strip() else ""
        if first_word in SLEEP_COMMANDS:
            return False  # sleep 不允许自动后台化
        return elapsed > AUTO_BG_THRESHOLD_SECONDS

    test_cases = [
        ("npm install", 20.0, True),
        ("sleep 30", 20.0, False),      # sleep 被排除！
        ("cargo build", 5.0, False),     # 还没超时
        ("make -j8", 16.0, True),
    ]

    for cmd, elapsed, expected in test_cases:
        result = should_auto_background(cmd, elapsed)
        status = "✓" if result == expected else "✗"
        action = "后台化" if result else "继续等待"
        print(f"  {status} '{cmd}' 已运行 {elapsed}s → {action}")


def demonstrate_output_size_watchdog():