Function lesson_5_strategy_pattern

tutorials/18_design_patterns_for_agents.py:727–870

对应源码: permissions.rs:4-9 → PermissionMode 枚举 (5 种策略) sandbox.rs → FilesystemIsolationMode (3 种隔离策略) conversation.rs:170 → run_turn 中根据 permission_outcome 切换行为 策略模式和接口很像, 但侧重点不同: - 接口: "你必须实现这些方法" (关注 what) - 策略: "在运行时选择哪种行为" (关注 when/which) 日常类比:

()

# ============================================================

def lesson_5_strategy_pattern():
    """
    对应源码:
      permissions.rs:4-9   → PermissionMode 枚举 (5 种策略)
      sandbox.rs           → FilesystemIsolationMode (3 种隔离策略)
      conversation.rs:170  → run_turn 中根据 permission_outcome 切换行为

    策略模式和接口很像, 但侧重点不同:
    - 接口: "你必须实现这些方法" (关注 what)
    - 策略: "在运行时选择哪种行为" (关注 when/which)

    日常类比: 导航 App 的路线选择
    ─────────────────────────────
    同样从 A 到 B:
    - 策略 1: 最短距离 → 走小路
    - 策略 2: 最快时间 → 走高速
    - 策略 3: 避开收费 → 走免费路
    算法不同, 但 "导航" 的框架完全一样。
    """
    print("=" * 60)
    print("第五课: 策略模式 — 换挡: 运行时切换行为")
    print("=" * 60)

    # ---- 例 1: 权限策略 (PermissionMode) ----
    print()
    print("  例 1: 权限策略 (对应 permissions.rs)")
    print("  ────────────────────────────────────")

    class PermissionMode(IntEnum):
        """对应 permissions.rs:4-9 的 5 级权限"""
        ReadOnly = 0           # 只能读
        WorkspaceWrite = 1     # 能在工作区写
        DangerFullAccess = 2   # 完全文件系统访问
        Prompt = 3             # 每次询问用户
        Allow = 4              # 全部允许 (YOLO 模式)

    # 策略 1: 只读模式——一切写操作被拦截
    # 策略 2: 工作区写——只能改工作区文件
    # 策略 3: 全权限——随便搞

    def check_permission(
        tool: str,
        required: PermissionMode,
        current: PermissionMode,
    ) -> str:
        """
        对应 permissions.rs:80-120 的 authorize()
        核心逻辑: current >= required → 允许
        """
        if current >= required:
            return "允许"
        else:
            return f"拒绝 (需要 {required.name}, 当前 {current.name})"

    tools = [
        ("read",  PermissionMode.ReadOnly),
        ("write", PermissionMode.WorkspaceWrite),
        ("bash",  PermissionMode.DangerFullAccess),