Function lesson_5_exit_codes

tutorials/19_process_and_pipe_communication.py:359–457

对应源码 hooks.rs:179-196: match output.status.code() { Some(0) => HookCommandOutcome::Allow { message }, // 成功=允许 Some(2) => HookCommandOutcome::Deny { message }, // 2=拒绝 Some(code) => HookCommandOutcome::Warn { ... }, // 其他=警告 None => HookComman

()

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

def lesson_5_exit_codes():
    """
    对应源码 hooks.rs:179-196:
      match output.status.code() {
          Some(0) => HookCommandOutcome::Allow { message },  // 成功=允许
          Some(2) => HookCommandOutcome::Deny { message },   // 2=拒绝
          Some(code) => HookCommandOutcome::Warn { ... },    // 其他=警告
          None => HookCommandOutcome::Warn { ... },          // 被信号杀死
      }

    退出码 (exit code) 是进程结束时返回给父进程的一个数字:
    - 0 = 成功
    - 非 0 = 失败 (具体含义由程序自定)

    Claude Code 的 Hook 协议:
    - 0 = Allow (允许工具执行)
    - 2 = Deny (拒绝工具执行)
    - 其他 = Warn (警告, 但不阻止)
    """
    print("=" * 60)
    print("第五课: 退出码 — 进程的遗言")
    print("=" * 60)

    # ---- 演示不同退出码 ----
    print()
    print("  Claude Code Hook 退出码协议:")
    print("  ─────────────────────────────")

    test_cases = [
        (0, "Allow", "工具执行被允许"),
        (2, "Deny", "工具执行被拒绝"),
        (1, "Warn", "警告, 但继续执行"),
        (42, "Warn", "未知退出码, 也视为警告"),
    ]

    for exit_code, outcome, meaning in test_cases:
        result = subprocess.run(
            ["python3", "-c", f"import sys; print('hook output'); sys.exit({exit_code})"],
            capture_output=True,
            text=True,
        )
        print(f"    exit({exit_code}) → returncode={result.returncode:>2}"
              f" → {outcome:<5} | {meaning}")

    # ---- 在 Python 中实现 Hook 退出码解析 ----
    print()
    print("  用 Python 重现 hooks.rs 的退出码处理:")
    print("  ─────────────────────────────────────")

    def interpret_hook_exit_code(
        returncode: int | None,
        stdout: str,
        stderr: str,
        command: str,
        tool_name: str,
    ) -> dict:
        """
        对应 hooks.rs:179-196