Function lesson_3_builder_pattern

tutorials/18_design_patterns_for_agents.py:345–573

对应源码: prompt.rs:85-93 → SystemPromptBuilder 结构体 prompt.rs:95-156 → with_*() 链式调用 + build() 方法 conversation.rs:429-447 → StaticToolExecutor 的 register() 链式调用 permissions.rs:64-73 → PermissionPolicy 的 with_tool_requirement() 问题: 有些对象的参数太多了, 全放构造函数里很痛苦。 比如 Sys

()

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

def lesson_3_builder_pattern():
    """
    对应源码:
      prompt.rs:85-93  → SystemPromptBuilder 结构体
      prompt.rs:95-156 → with_*() 链式调用 + build() 方法

      conversation.rs:429-447 → StaticToolExecutor 的 register() 链式调用
      permissions.rs:64-73    → PermissionPolicy 的 with_tool_requirement()

    问题: 有些对象的参数太多了, 全放构造函数里很痛苦。
    比如 SystemPrompt 需要: OS信息、风格、项目上下文、配置、自定义段落...
    如果写成: SystemPrompt(os, style, ctx, config, sections, ...) — 噩梦!

    Builder 模式: 链式调用, 需要什么加什么, 最后 .build()。

    日常类比: 赛百味点三明治
    ────────────────────
    你不会一口气说 "我要全麦面包白面包火鸡肉双倍芝士没有酸黄瓜加墨西哥辣椒"。
    你是一步步选:
      面包 → 全麦
      肉   → 火鸡
      芝士 → 双倍
      去掉 → 酸黄瓜
      加上 → 墨西哥辣椒
    最后说 "好了, 做吧!" → .build()
    """
    print("=" * 60)
    print("第三课: Builder 模式 — 点菜单: 一步步组装复杂对象")
    print("=" * 60)

    # ---- 反面教材: 参数爆炸 ----
    print()
    print("  反面教材 (参数爆炸):")
    print("  ──────────────────")
    print("    SystemPrompt(")
    print("        os_name='macOS',")
    print("        os_version='15.0',")
    print("        style_name='concise',")
    print("        style_prompt='Be brief',")
    print("        cwd='/home/user',")
    print("        date='2024-01-01',")
    print("        git_status='...',")
    print("        config=...,")
    print("        extra_sections=[...],")
    print("    )")
    print("    12 个参数! 大部分可选, 顺序容易搞错。")
    print()

    # ---- 正面教材: Builder 模式 ----

    # 对应 prompt.rs:85-93 的 SystemPromptBuilder
    @dataclass
    class SystemPromptBuilder:
        """
        Builder 模式三要素:
        1. 字段全部可选 (None 默认值)
        2. with_*() 方法返回 self (链式调用)
        3. build() 方法组装最终结果