Function lesson_4_registry_pattern

tutorials/18_design_patterns_for_agents.py:580–720

对应源码: conversation.rs:429-456 → StaticToolExecutor handlers: BTreeMap ← "名字 → 函数" 的映射 fn execute(&mut self, tool_name: &str, input: &str) → 按名字查找并调用 Agent 系统有很多工具 (bash, read, write, grep, glob, ...), 每个工具的执行逻辑不同。怎么组织? 方案 A (if/elif 地狱)

()

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

def lesson_4_registry_pattern():
    """
    对应源码:
      conversation.rs:429-456 → StaticToolExecutor
        handlers: BTreeMap<String, ToolHandler>   ← "名字 → 函数" 的映射
        fn execute(&mut self, tool_name: &str, input: &str) → 按名字查找并调用

    Agent 系统有很多工具 (bash, read, write, grep, glob, ...),
    每个工具的执行逻辑不同。怎么组织?

    方案 A (if/elif 地狱):
      if tool == "bash": do_bash()
      elif tool == "read": do_read()
      elif tool == "write": do_write()
      elif ... (50 个 elif)
      → 每加一个工具就要改这个 if 链, 容易出错

    方案 B (注册表):
      registry["bash"] = do_bash
      registry["read"] = do_read
      result = registry[tool](input)
      → 加工具只需 register(), 查找和执行完全解耦

    日常类比: 手机通讯录
    ────────────────────
    你不会记住所有人的电话号码。
    你把 "名字 → 号码" 存进通讯录, 需要时按名字搜索。
    注册表就是 "工具名 → 处理函数" 的通讯录。
    """
    print("=" * 60)
    print("第四课: 注册表模式 — 电话簿: 按名字查找处理函数")
    print("=" * 60)

    # ---- 反面教材 ----
    print()
    print("  反面教材 (if/elif 地狱):")
    print("  ─────────────────────")
    print("    def execute(tool, input):")
    print("        if tool == 'bash': return run_bash(input)")
    print("        elif tool == 'read': return read_file(input)")
    print("        elif tool == 'write': return write_file(input)")
    print("        elif tool == 'grep': return grep_file(input)")
    print("        elif ...  # 每加一个工具就改这里!")
    print()

    # ---- 正面教材: 注册表 ----
    print("  正面教材 (注册表):")
    print("  ────────────────")

    # 对应 conversation.rs:429-456
    class ToolRegistry:
        """
        工具注册表
        核心数据结构: dict[str, Callable]
        对应 Rust: BTreeMap<String, Box<dyn FnMut(&str) -> Result<String, ToolError>>>
        """
        def __init__(self):
            self._handlers: dict[str, Callable[[str], str]] = {}