[{"data":1,"prerenderedAt":3082},["ShallowReactive",2],{"search-docs":3,"doc-\u002Fai\u002Fagent\u002Fhooks":886},[4,8,12,16,20,24,28,32,36,40,44,48,52,56,60,64,68,72,76,80,84,88,92,96,100,104,108,112,116,120,124,128,132,136,140,144,148,152,156,159,162,165,169,172,175,178,182,186,190,194,198,202,206,210,214,218,222,226,230,234,238,242,246,250,254,258,262,266,269,273,277,281,285,288,291,294,298,301,304,307,310,313,316,319,322,325,329,332,336,340,344,348,352,356,359,362,365,368,371,374,377,380,383,386,389,393,396,399,402,405,408,411,414,417,420,424,428,432,435,438,442,446,450,454,458,462,466,470,474,477,480,483,487,491,494,497,500,504,507,511,515,518,521,524,527,530,533,536,539,542,545,548,551,554,557,560,563,566,569,572,575,579,583,587,591,595,599,603,606,610,614,617,620,623,626,629,633,637,640,643,646,649,652,655,658,661,664,667,670,673,676,679,682,685,688,691,694,697,700,703,706,709,712,716,720,724,728,732,736,740,744,748,752,756,760,764,768,772,775,779,783,787,790,793,796,799,802,805,808,811,814,818,822,825,829,832,835,838,841,844,848,851,854,858,862,865,869,873,876,879,882],{"path":5,"title":6,"description":7},"\u002Fabout\u002Fauthor","作者相关","只想纯粹的做一个程序员...",{"path":9,"title":10,"description":11},"\u002Fabout\u002Fjourney","心路历程","",{"path":13,"title":14,"description":15},"\u002Fai\u002Fagent\u002Fframeworks","Agent 框架","主流 Agent 框架：LangChain、LlamaIndex、AutoGen、CrewAI",{"path":17,"title":18,"description":19},"\u002Fai\u002Fagent\u002Fhooks","Agent Hooks 与自动化","Claude Agent 的 Hooks 生命周期、事件类型、典型自动化场景",{"path":21,"title":22,"description":23},"\u002Fai\u002Fagent\u002Fintroduction","AI Agent 概述","AI Agent 核心概念：感知、规划、执行、记忆",{"path":25,"title":26,"description":27},"\u002Fai\u002Fagent\u002Fpractice","Agent 实战","AI Agent 实战：构建自主任务执行系统",{"path":29,"title":30,"description":31},"\u002Fai\u002Fagent\u002Fsdk","Claude Agent SDK 开发","使用 Claude Agent SDK 构建自定义 AI Agent：架构、API、生命周期",{"path":33,"title":34,"description":35},"\u002Fai\u002Fagent\u002Fsubagents","Subagents 子代理","用 Subagents 分解复杂任务、并发执行、隔离上下文",{"path":37,"title":38,"description":39},"\u002Fai\u002Fagent\u002Ftool-use","工具调用","AI Agent 工具调用：Function Calling、Tool Use 原理与实践",{"path":41,"title":42,"description":43},"\u002Fai\u002Ffundamentals\u002Fdeep-learning","深度学习入门","深度学习基础知识：前向传播、反向传播、损失函数、优化器",{"path":45,"title":46,"description":47},"\u002Fai\u002Ffundamentals\u002Fml-basics","机器学习基础","机器学习核心概念：监督学习、无监督学习、强化学习",{"path":49,"title":50,"description":51},"\u002Fai\u002Ffundamentals\u002Fneural-networks","神经网络原理","神经网络架构：CNN、RNN、注意力机制",{"path":53,"title":54,"description":55},"\u002Fai\u002Fgetting-started","AI 学习路线","AI 技术学习路线图，从基础到实战的完整指南",{"path":57,"title":58,"description":59},"\u002Fai\u002Fllm\u002Ffine-tuning","模型微调","大模型微调技术：LoRA、QLoRA、全量微调、RLHF",{"path":61,"title":62,"description":63},"\u002Fai\u002Fllm\u002Fintroduction","大模型概述","大语言模型发展历程、核心能力与主流模型对比",{"path":65,"title":66,"description":67},"\u002Fai\u002Fllm\u002Flocal-deploy","本地部署","大模型本地部署：Ollama、vLLM、llama.cpp",{"path":69,"title":70,"description":71},"\u002Fai\u002Fllm\u002Ftransformer","Transformer 架构","Transformer 架构详解：自注意力机制、位置编码、多头注意力",{"path":73,"title":74,"description":75},"\u002Fai\u002Fmcp\u002Fclient","MCP Client 开发","MCP Client 开发指南：连接、调用、集成",{"path":77,"title":78,"description":79},"\u002Fai\u002Fmcp\u002Fdebugging","MCP 调试与排错","MCP Server 开发与集成过程中的常见问题、日志分析、诊断工具",{"path":81,"title":82,"description":83},"\u002Fai\u002Fmcp\u002Fintroduction","MCP 概述","Model Context Protocol 协议概述：架构、核心概念、应用场景",{"path":85,"title":86,"description":87},"\u002Fai\u002Fmcp\u002Fserver","MCP Server 开发","MCP Server 开发指南：资源、工具、提示词的实现",{"path":89,"title":90,"description":91},"\u002Fai\u002Fmcp\u002Ftools","MCP Tools 深入","深入理解 MCP Tools：与 Resources\u002FPrompts 的差异、Schema 设计、Annotations 与权限控制",{"path":93,"title":94,"description":95},"\u002Fai\u002Fprompt\u002Fadvanced","高级 Prompt 模式","高级 Prompt 设计模式：Tree-of-Thought、自我反思、多轮对话策略",{"path":97,"title":98,"description":99},"\u002Fai\u002Fprompt\u002Fbasics","Prompt 基础","Prompt Engineering 入门：基本概念、角色设定、输出格式控制",{"path":101,"title":102,"description":103},"\u002Fai\u002Fprompt\u002Ftechniques","提示词技巧","常用提示词技巧：Few-shot、Chain-of-Thought、ReAct",{"path":105,"title":106,"description":107},"\u002Fai\u002Frag\u002Fembedding","文本嵌入","文本嵌入模型：Embedding 原理、模型选择、相似度计算",{"path":109,"title":110,"description":111},"\u002Fai\u002Frag\u002Fintroduction","RAG 概述","检索增强生成（RAG）架构原理、优势与应用场景",{"path":113,"title":114,"description":115},"\u002Fai\u002Frag\u002Fpractice","RAG 实战","RAG 应用实战：文档问答系统、知识库搭建",{"path":117,"title":118,"description":119},"\u002Fai\u002Frag\u002Fvector-database","向量数据库","主流向量数据库对比：Milvus、Pinecone、Chroma、Weaviate",{"path":121,"title":122,"description":123},"\u002Fai\u002Fskills\u002Fbest-practices","Skill 最佳实践","编写高质量 Skill 的设计原则、常见陷阱与优化技巧",{"path":125,"title":126,"description":127},"\u002Fai\u002Fskills\u002Fcreating","创建自定义 Skill","从零编写一个可被 Agent 自动发现和调用的 Skill",{"path":129,"title":130,"description":131},"\u002Fai\u002Fskills\u002Fintroduction","Agent Skills 概述","Claude Agent Skills 概念、工作原理、与 Tools\u002FMCP 的区别",{"path":133,"title":134,"description":135},"\u002Fgolang\u002Fadvanced\u002Fconcurrency","Go - 并发深入","深入理解 Go 并发编程的核心机制。",{"path":137,"title":138,"description":139},"\u002Fgolang\u002Fadvanced\u002Fgc","Go - 垃圾回收","理解 Go 的垃圾回收机制，掌握 GC 调优方法。",{"path":141,"title":142,"description":143},"\u002Fgolang\u002Fadvanced\u002Fgmp","Go - GMP 调度模型","GMP 是 Go 运行时调度器的核心模型，理解它对于编写高性能 Go 程序至关重要。",{"path":145,"title":146,"description":147},"\u002Fgolang\u002Fadvanced\u002Fgo-concurrency","Go - 并发编程","Go 的并发是其核心特性之一，通过 Goroutine 和 Channel 实现。",{"path":149,"title":150,"description":151},"\u002Fgolang\u002Fadvanced\u002Fmemory","Go - 内存模型","理解 Go 的内存分配机制和内存模型。",{"path":153,"title":154,"description":155},"\u002Fgolang\u002Fadvanced\u002Fprofiling","Go - 性能分析","掌握 Go 的性能分析工具：pprof、trace、benchmark。",{"path":157,"title":158,"description":11},"\u002Fgolang\u002Fcore\u002Fgo-basic","Go - 基础语法",{"path":160,"title":161,"description":11},"\u002Fgolang\u002Fcore\u002Fgo-composite","Go - 复合类型",{"path":163,"title":164,"description":11},"\u002Fgolang\u002Fcore\u002Fgo-control","Go - 流程控制",{"path":166,"title":167,"description":168},"\u002Fgolang\u002Fcore\u002Fgo-error","Go - 错误处理","Go 使用显式的错误返回值来处理错误，而不是异常机制。",{"path":170,"title":171,"description":11},"\u002Fgolang\u002Fcore\u002Fgo-function","Go - 函数",{"path":173,"title":174,"description":11},"\u002Fgolang\u002Fcore\u002Fgo-install","Go - 环境搭建",{"path":176,"title":177,"description":11},"\u002Fgolang\u002Fcore\u002Fgo-interface","Go - 接口",{"path":179,"title":180,"description":181},"\u002Fgolang\u002Fcore\u002Fgo-module","Go - 包管理","Go Modules 是 Go 1.11 引入的官方依赖管理方案，Go 1.16 后成为默认模式。",{"path":183,"title":184,"description":185},"\u002Fgolang\u002Fdistributed\u002Fgrpc","Go - gRPC","gRPC 是 Google 开发的高性能 RPC 框架，使用 Protocol Buffers 作为序列化协议。",{"path":187,"title":188,"description":189},"\u002Fgolang\u002Fdistributed\u002Fmicroservice","Go - 微服务","微服务架构的核心组件：服务发现、负载均衡、熔断降级。",{"path":191,"title":192,"description":193},"\u002Fgolang\u002Fdistributed\u002Fmq","Go - 消息队列","使用 Go 操作 Kafka 和 RabbitMQ。",{"path":195,"title":196,"description":197},"\u002Fgolang\u002Fdistributed\u002Fredis","Go - Redis","使用 go-redis 操作 Redis，实现缓存、分布式锁等功能。",{"path":199,"title":200,"description":201},"\u002Fgolang\u002Fengineering\u002Fconfig","Go - 配置管理","使用 viper 进行配置管理，支持多种配置格式和配置中心。",{"path":203,"title":204,"description":205},"\u002Fgolang\u002Fengineering\u002Fdocker","Go - Docker 部署","使用 Docker 容器化部署 Go 应用。",{"path":207,"title":208,"description":209},"\u002Fgolang\u002Fengineering\u002Fkubernetes","Go - Kubernetes 部署","在 Kubernetes 上部署和管理 Go 应用。",{"path":211,"title":212,"description":213},"\u002Fgolang\u002Fengineering\u002Flogging","Go - 日志系统","使用 zap 和 logrus 构建高性能结构化日志系统。",{"path":215,"title":216,"description":217},"\u002Fgolang\u002Fengineering\u002Ftesting","Go - 单元测试","Go 内置了强大的测试框架，掌握测试是编写高质量代码的基础。",{"path":219,"title":220,"description":221},"\u002Fgolang\u002Fstdlib\u002Fbufio","bufio","在 Go 语言中，bufio 包提供了带缓冲的 I\u002FO 操作，能够提高读写性能。以下是一些常用的 bufio 包 API 及其详细说明：",{"path":223,"title":224,"description":225},"\u002Fgolang\u002Fstdlib\u002Fcontainer","container","在Go语言标准库中，container 包提供了几种常用的数据结构实现，这些数据结构对于高效地管理和操作数据非常有用。以下是 container 包中主要的数据结构：",{"path":227,"title":228,"description":229},"\u002Fgolang\u002Fstdlib\u002Fcrypto","crypto","在 Go 语言中，crypto 包提供了一组用于加密和解密的功能。以下是一些常用的 crypto 包及其子包的 API 及其详细说明：",{"path":231,"title":232,"description":233},"\u002Fgolang\u002Fstdlib\u002Fencoding-csv","encoding\u002Fcsv","在 Go 语言中，encoding\u002Fcsv 包提供了对 CSV（逗号分隔值）文件进行读写的功能。以下是一些常用的 encoding\u002Fcsv 包的 API 及其详细说明：",{"path":235,"title":236,"description":237},"\u002Fgolang\u002Fstdlib\u002Fencoding-json","encoding\u002Fjson","在 Go 语言中，encoding\u002Fjson 包提供了对 JSON 数据进行编码和解码的功能。以下是一些常用的 encoding\u002Fjson 包的 API 及其详细说明：",{"path":239,"title":240,"description":241},"\u002Fgolang\u002Fstdlib\u002Fencoding-xml","encoding\u002Fxml","在 Go 语言中，encoding\u002Fxml 包提供了对 XML 数据进行编码和解码的功能。以下是一些常用的 encoding\u002Fxml 包的 API 及其详细说明：",{"path":243,"title":244,"description":245},"\u002Fgolang\u002Fstdlib\u002Fflag","flag","在Go语言中，flag 包是用于处理命令行参数的标准库，它提供了一种简单而直接的方式来解析和使用命令行参数。下面是关于 flag 包的一些基本介绍和常用功能：",{"path":247,"title":248,"description":249},"\u002Fgolang\u002Fstdlib\u002Ffmt","fmt","在 Go 语言的标准库中，fmt 包是非常重要的，它提供了处理格式化输入和输出的基本工具。以下是一些 fmt 包内常用的API：",{"path":251,"title":252,"description":253},"\u002Fgolang\u002Fstdlib\u002Fhttp","net\u002Fhttp","在 Go 语言中，net\u002Fhttp 包提供了用于构建 HTTP 客户端和服务器的强大工具。以下是一些常用的 net\u002Fhttp 包的 API 及其详细说明：",{"path":255,"title":256,"description":257},"\u002Fgolang\u002Fstdlib\u002Fio","io","在 Go 语言中，io 包提供了基本的输入输出功能。以下是一些常用的 io 包的 API 及其详细说明：",{"path":259,"title":260,"description":261},"\u002Fgolang\u002Fstdlib\u002Flog","log","在 Go 语言中，log 包提供了简单的日志记录功能。以下是一些常用的 log 包的 API 及其详细说明：",{"path":263,"title":264,"description":265},"\u002Fgolang\u002Fstdlib\u002Fmath","math","在 Go 语言中，math 包提供了基本的数学函数和常量。以下是一些常用的 math 包的 API 及其详细说明：",{"path":267,"title":268,"description":11},"\u002Fgolang\u002Fstdlib\u002Fnet","net",{"path":270,"title":271,"description":272},"\u002Fgolang\u002Fstdlib\u002Fos","os","在Go语言中，os 包是一个非常重要且常用的标准库，它提供了与操作系统交互的功能，包括文件操作、环境变量管理、进程管理等。下面是一些 os 包中常用的功能和API：",{"path":274,"title":275,"description":276},"\u002Fgolang\u002Fstdlib\u002Fsort","order","在 Go 语言中，sort 包提供了对切片和用户定义的集合进行排序的函数。它实现了常见的排序算法，如快速排序（Quicksort）和堆排序（Heapsort），并且为自定义集合提供了接口，使得用户可以根据特定的需求进行排序。",{"path":278,"title":279,"description":280},"\u002Fgolang\u002Fstdlib\u002Fstrconv","strconv","在 Go 语言中，strconv 包提供了字符串和基本数据类型之间的转换函数，例如将整数转换为字符串、字符串转换为整数，以及其他类型之间的转换。这些功能非常有用，特别是在处理用户输入或从外部数据源读取数据时。",{"path":282,"title":283,"description":284},"\u002Fgolang\u002Fstdlib\u002Ftime","time","在 Go 语言中，time 包提供了处理时间和日期的功能。以下是一些常用的 time 包的 API 及其详细说明：",{"path":286,"title":287,"description":11},"\u002Fgolang\u002Fweb\u002Fgin\u002Ferror","Gin - 错误处理",{"path":289,"title":290,"description":11},"\u002Fgolang\u002Fweb\u002Fgin\u002Ffile","Gin - 文件处理",{"path":292,"title":293,"description":11},"\u002Fgolang\u002Fweb\u002Fgin\u002Fmiddleware","Gin - 中间件",{"path":295,"title":296,"description":297},"\u002Fgolang\u002Fweb\u002Fgin\u002Fquickstart","Gin - 快速开始","Gin 是目前最流行的 Go Web 框架，以高性能和简洁 API 著称。",{"path":299,"title":300,"description":11},"\u002Fgolang\u002Fweb\u002Fgin\u002Frequest","Gin - 请求处理",{"path":302,"title":303,"description":11},"\u002Fgolang\u002Fweb\u002Fgin\u002Fresponse","Gin - 响应处理",{"path":305,"title":306,"description":11},"\u002Fgolang\u002Fweb\u002Fgin\u002Frouter","Gin - 路由",{"path":308,"title":309,"description":11},"\u002Fgolang\u002Fweb\u002Fgin\u002Fvalidation","Gin - 参数校验",{"path":311,"title":312,"description":11},"\u002Fgolang\u002Fweb\u002Fgorm\u002Fassociation","GORM - 关联关系",{"path":314,"title":315,"description":11},"\u002Fgolang\u002Fweb\u002Fgorm\u002Fcrud","GORM - CRUD 操作",{"path":317,"title":318,"description":11},"\u002Fgolang\u002Fweb\u002Fgorm\u002Fmodel","GORM - 模型定义",{"path":320,"title":321,"description":11},"\u002Fgolang\u002Fweb\u002Fgorm\u002Fperformance","GORM - 日志与性能",{"path":323,"title":324,"description":11},"\u002Fgolang\u002Fweb\u002Fgorm\u002Fquery","GORM - 高级查询",{"path":326,"title":327,"description":328},"\u002Fgolang\u002Fweb\u002Fgorm\u002Fquickstart","GORM - 快速开始","GORM 是 Go 语言最流行的 ORM 库，功能强大，使用简单。",{"path":330,"title":331,"description":11},"\u002Fgolang\u002Fweb\u002Fgorm\u002Ftransaction","GORM - 事务与 Hook",{"path":333,"title":334,"description":335},"\u002Finterview\u002Fbasic","计算机基础面经","本章节汇总了面试中常见的通用技术概念，不局限于特定语言或数据库，是考察技术内功的关键考点。",{"path":337,"title":338,"description":339},"\u002Finterview\u002Fgolang","Golang 面试题","Go 语言面试高频考点，覆盖基础语法、数据结构、并发编程、内存管理、GC、调度器等核心知识。",{"path":341,"title":342,"description":343},"\u002Finterview\u002Fk8s","Kubernetes 面试题","Kubernetes（K8s）面试高频考点，覆盖架构原理、核心资源、网络存储、调度策略、运维监控等核心知识。",{"path":345,"title":346,"description":347},"\u002Finterview\u002Fmysql","MySQL 面试题","MySQL 数据库面试高频考点，覆盖索引、事务、锁、优化、主从复制等核心知识。",{"path":349,"title":350,"description":351},"\u002Finterview\u002Fredis","Redis 面试题","Redis 面试高频考点，覆盖数据结构、持久化、集群、缓存一致性、性能优化等核心知识。",{"path":353,"title":354,"description":355},"\u002Finterview\u002Frocketmq","RocketMQ 面试题","RocketMQ 面试高频考点，覆盖消息模型、可靠性、顺序消息、事务消息、存储与高可用等核心知识。",{"path":357,"title":358,"description":11},"\u002Fother\u002Fjava\u002Fcollection\u002Flist-arraylist","List - ArrayList 源码解析",{"path":360,"title":361,"description":11},"\u002Fother\u002Fjava\u002Fcollection\u002Flist-linkedlist","List - LinkedList 源码解析",{"path":363,"title":364,"description":11},"\u002Fother\u002Fjava\u002Fcollection\u002Flist-stack","List - Satck源码解析",{"path":366,"title":367,"description":11},"\u002Fother\u002Fjava\u002Fcollection\u002Flist-vectore","List - Vector 源码解析",{"path":369,"title":370,"description":11},"\u002Fother\u002Fjava\u002Fcollection\u002Fmap-hashmap","Map - HashMap 源码解析",{"path":372,"title":373,"description":11},"\u002Fother\u002Fjava\u002Fcollection\u002Fmap-linkedhashmap","Map - LinkedHashMap 源码解析",{"path":375,"title":376,"description":11},"\u002Fother\u002Fjava\u002Fcollection\u002Fmap-treemap","Map - TreeMap 源码解析",{"path":378,"title":379,"description":11},"\u002Fother\u002Fjava\u002Fcollection\u002Fqueue-deque","Queue - Deque 接口解析",{"path":381,"title":382,"description":11},"\u002Fother\u002Fjava\u002Fcollection\u002Fqueue-queue","Queue - Queue 接口解析",{"path":384,"title":385,"description":11},"\u002Fother\u002Fjava\u002Fcollection\u002Fset-hashset","Set - HashSet源码解析",{"path":387,"title":388,"description":11},"\u002Fother\u002Fjava\u002Fcollection\u002Fset-linkedhashset","Set - LinkedHashSet 源码解析",{"path":390,"title":391,"description":392},"\u002Fother\u002Fjava\u002Fcollection\u002Fset-treeset","Set - TreeSet源码解析","TreeSet 是一个 Set 集合接口的实现类，与 HashSet 类似，其底层也是通过维护了一个 TreeMap 对象来封装了一些实现方法，故本篇不再对 TreeSet 的底层原理进行详细说明，仅对常用 API 做简单介绍，如需了解 TreeMap 的底层实现原理，请移步 Map - HashMap 源码解析",{"path":394,"title":395,"description":11},"\u002Fother\u002Fjava\u002Fcore\u002Fannotation","Java核心 - 注解",{"path":397,"title":398,"description":11},"\u002Fother\u002Fjava\u002Fcore\u002Fbasic-grammar","Java核心 - 基础语法",{"path":400,"title":401,"description":11},"\u002Fother\u002Fjava\u002Fcore\u002Fclass-and-object","Java核心 - 面向对象",{"path":403,"title":404,"description":11},"\u002Fother\u002Fjava\u002Fcore\u002Fcommon-classes","Java核心 - 常用类",{"path":406,"title":407,"description":11},"\u002Fother\u002Fjava\u002Fcore\u002Fexception","Java核心 - 异常处理",{"path":409,"title":410,"description":11},"\u002Fother\u002Fjava\u002Fcore\u002Fgenerics","Java核心 - 泛型",{"path":412,"title":413,"description":11},"\u002Fother\u002Fjava\u002Fcore\u002Fjdk-env-path","Java核心 - 环境搭建",{"path":415,"title":416,"description":11},"\u002Fother\u002Fjava\u002Fcore\u002Freflection","Java核心 - 反射",{"path":418,"title":419,"description":11},"\u002Fother\u002Fjava\u002Fcore\u002Fstring","Java核心 - String 字符串",{"path":421,"title":422,"description":423},"\u002Fother\u002Fjava\u002Fio\u002Fbuffer-stream","Java IO - 缓冲流","缓冲流是对基本流的包装，通过内置缓冲区减少系统调用次数，大幅提升读写效率。",{"path":425,"title":426,"description":427},"\u002Fother\u002Fjava\u002Fio\u002Fbyte-stream","Java IO - 字节流","字节流是 Java IO 中最基本的流类型，以字节（byte）为单位进行数据读写，可以处理任意类型的文件。",{"path":429,"title":430,"description":431},"\u002Fother\u002Fjava\u002Fio\u002Fchar-stream","Java IO - 字符流","字符流以字符为单位进行读写，专门用于处理文本文件。相比字节流，字符流能够正确处理字符编码，避免中文乱码问题。",{"path":433,"title":434,"description":11},"\u002Fother\u002Fjava\u002Fio\u002Ffile","Java IO - File 类",{"path":436,"title":437,"description":11},"\u002Fother\u002Fjava\u002Fio\u002Fio-stream-system","Java IO - IO流概述",{"path":439,"title":440,"description":441},"\u002Fother\u002Fjava\u002Fio\u002Fnio","Java IO - NIO","NIO（New IO）是 JDK 1.4 引入的新 IO 模型，提供了更高效的 IO 操作方式，支持非阻塞 IO 和多路复用。",{"path":443,"title":444,"description":445},"\u002Fother\u002Fjava\u002Fjvm\u002Fclass-loading","类加载机制","类加载机制是 JVM 将 .class 文件加载到内存，并对数据进行校验、转换解析和初始化，最终形成可被 JVM 直接使用的 Java 类型的过程。",{"path":447,"title":448,"description":449},"\u002Fother\u002Fjava\u002Fjvm\u002Fgarbage-collection","垃圾回收","垃圾回收（Garbage Collection，GC）是 JVM 自动管理内存的机制，负责回收不再使用的对象所占用的内存。",{"path":451,"title":452,"description":453},"\u002Fother\u002Fjava\u002Fjvm\u002Fjvm-memory","JVM 内存结构","JVM 在执行 Java 程序时，会把它管理的内存划分为若干个不同的数据区域。这些区域有各自的用途、创建和销毁时间。",{"path":455,"title":456,"description":457},"\u002Fother\u002Fjava\u002Fjvm\u002Fjvm-tuning","JVM 调优","JVM 调优是优化 Java 应用性能的重要手段，主要包括参数配置、性能监控和问题排查。",{"path":459,"title":460,"description":461},"\u002Fother\u002Fjava\u002Fthread\u002Fatomic","原子类","Java 原子类（Atomic Classes）提供了一种无锁的线程安全方式，基于 CAS（Compare-And-Swap）操作实现。",{"path":463,"title":464,"description":465},"\u002Fother\u002Fjava\u002Fthread\u002Fcompletable-future","CompletableFuture","CompletableFuture 是 JDK 8 引入的异步编程工具，实现了 Future 和 CompletionStage 接口，支持函数式编程和链式调用。",{"path":467,"title":468,"description":469},"\u002Fother\u002Fjava\u002Fthread\u002Fconcurrent-collections","并发集合","Java 并发包提供了多种线程安全的集合类，用于替代传统的同步集合（如 Collections.synchronizedList）。",{"path":471,"title":472,"description":473},"\u002Fother\u002Fjava\u002Fthread\u002Fconcurrent-utils","并发工具类","Java 并发包提供了多种实用的并发工具类，用于控制线程之间的协调与同步。",{"path":475,"title":476,"description":11},"\u002Fother\u002Fjava\u002Fthread\u002Fsynchronized-lock","同步机制",{"path":478,"title":479,"description":11},"\u002Fother\u002Fjava\u002Fthread\u002Fthread-basic","线程基础",{"path":481,"title":482,"description":11},"\u002Fother\u002Fjava\u002Fthread\u002Fthread-pool","线程池",{"path":484,"title":485,"description":486},"\u002Fother\u002Fspring-series\u002Fspring\u002Fannotations-beans","Spring - 基于注解管理Bean","从 Java 5 开始，Java 增加了对注解（Annotation）的支持，它是代码中的一种特殊标记，可以在编译、类加载和运行时被读取，执行相应的处理。开发人员可以通过注解在不改变原有代码和逻辑的情况下，在源代码中嵌入补充信息。",{"path":488,"title":489,"description":490},"\u002Fother\u002Fspring-series\u002Fspring\u002Fimplement-ioc","Spring - 原理手写IoC","Spring 框架的 IOC 是基于 Java 反射机制实现的，在学习手写 IoC 之前，你需要具备一定的 Java 反射相关的知识，参考本站内的 Java 教程。",{"path":492,"title":493,"description":11},"\u002Fother\u002Fspring-series\u002Fspring\u002Fintroduction-case","Spring - 入门案例",{"path":495,"title":496,"description":11},"\u002Fother\u002Fspring-series\u002Fspring\u002Fspring-aop","Spring - 面向切面AOP",{"path":498,"title":499,"description":11},"\u002Fother\u002Fspring-series\u002Fspring\u002Fspring-aot","Spring - AOT提前编译",{"path":501,"title":502,"description":503},"\u002Fother\u002Fspring-series\u002Fspring\u002Fspring-data-validation","Spring - 数据校验","在开发中，我们经常遇到参数校验的需求，比如用户注册的时候，要校验用户名不能为空、用户名长度不超过20个字符、手机号是合法的手机号格式等等。如果使用普通方式，我们会把校验的代码和真正的业务处理逻辑耦合在一起，而且如果未来要新增一种校验逻辑也需要在修改多个地方。而spring validation允许通过注解的方式来定义对象校验规则，把校验和业务逻辑分离开，让代码编写更加方便。Spring Validation其实就是对Hibernate Validator进一步的封装，方便在Spring中使用。",{"path":505,"title":506,"description":11},"\u002Fother\u002Fspring-series\u002Fspring\u002Fspring-i18n","Spring - 国际化i18n",{"path":508,"title":509,"description":510},"\u002Fother\u002Fspring-series\u002Fspring\u002Fspring-ioc","Spring - IOC容器","IoC 是 Inversion of Control 的简写，译为“控制反转”，它不是一门技术，而是一种设计思想，是一个重要的面向对象编程法则，能够指导我们如何设计出松耦合、更优良的程序。",{"path":512,"title":513,"description":514},"\u002Fother\u002Fspring-series\u002Fspring\u002Fspring-junit","Spring - 单元测试JUnit","在之前的测试方法中，几乎都能看到以下的两行代码：",{"path":516,"title":517,"description":11},"\u002Fother\u002Fspring-series\u002Fspring\u002Fspring-resources","Spring - 资源操作",{"path":519,"title":520,"description":11},"\u002Fother\u002Fspring-series\u002Fspring\u002Fspring-summarize","Spring - Spring概述",{"path":522,"title":523,"description":11},"\u002Fother\u002Fspring-series\u002Fspring\u002Fspring-transaction","Spring - 事务",{"path":525,"title":526,"description":11},"\u002Fother\u002Fspring-series\u002Fspring\u002Fxml-beans","Spring - 基于XML管理Bean",{"path":528,"title":529,"description":11},"\u002Fother\u002Fspring-series\u002Fspringboot\u002Fspringboot-config","SpringBoot - 配置详解",{"path":531,"title":532,"description":11},"\u002Fother\u002Fspring-series\u002Fspringboot\u002Fspringboot-data","SpringBoot - 数据访问",{"path":534,"title":535,"description":11},"\u002Fother\u002Fspring-series\u002Fspringboot\u002Fspringboot-quickstart","SpringBoot - 快速入门",{"path":537,"title":538,"description":11},"\u002Fother\u002Fspring-series\u002Fspringboot\u002Fspringboot-web","SpringBoot - Web 开发",{"path":540,"title":541,"description":11},"\u002Fother\u002Fspring-series\u002Fspringcloud\u002Fspringcloud-config","SpringCloud - 配置中心",{"path":543,"title":544,"description":11},"\u002Fother\u002Fspring-series\u002Fspringcloud\u002Fspringcloud-discovery","SpringCloud - 服务注册与发现",{"path":546,"title":547,"description":11},"\u002Fother\u002Fspring-series\u002Fspringcloud\u002Fspringcloud-feign","SpringCloud - 服务调用",{"path":549,"title":550,"description":11},"\u002Fother\u002Fspring-series\u002Fspringcloud\u002Fspringcloud-gateway","SpringCloud - 服务网关",{"path":552,"title":553,"description":11},"\u002Fother\u002Fspring-series\u002Fspringcloud\u002Fspringcloud-introduction","SpringCloud - 微服务概述",{"path":555,"title":556,"description":11},"\u002Fother\u002Fspring-series\u002Fspringcloud\u002Fspringcloud-sentinel","SpringCloud - 服务保护",{"path":558,"title":559,"description":11},"\u002Fother\u002Fspring-series\u002Fspringmvc\u002Fspringmvc-databind","SpringMVC - 数据绑定与转换",{"path":561,"title":562,"description":11},"\u002Fother\u002Fspring-series\u002Fspringmvc\u002Fspringmvc-exception","SpringMVC - 异常处理",{"path":564,"title":565,"description":11},"\u002Fother\u002Fspring-series\u002Fspringmvc\u002Fspringmvc-interceptor","SpringMVC - 拦截器",{"path":567,"title":568,"description":11},"\u002Fother\u002Fspring-series\u002Fspringmvc\u002Fspringmvc-introduction","SpringMVC - 简介与环境搭建",{"path":570,"title":571,"description":11},"\u002Fother\u002Fspring-series\u002Fspringmvc\u002Fspringmvc-request","SpringMVC - 请求处理",{"path":573,"title":574,"description":11},"\u002Fother\u002Fspring-series\u002Fspringmvc\u002Fspringmvc-response","SpringMVC - 响应处理",{"path":576,"title":577,"description":578},"\u002Fproject\u002Frocket-leaf\u002Farchitecture","项目架构","Rocket-Leaf 的目录结构、模块划分、数据流向，以及各层之间的依赖关系。",{"path":580,"title":581,"description":582},"\u002Fproject\u002Frocket-leaf\u002Fbackend-layers","后端分层设计","Rocket-Leaf 的 model \u002F rocketmq \u002F service 三层结构，以及服务之间的依赖关系与设计取舍。",{"path":584,"title":585,"description":586},"\u002Fproject\u002Frocket-leaf\u002Fclient-manager","RocketMQ 客户端管理器","AdminClientManager 的多客户端池、默认连接懒加载、自动重连重试的设计与实现。",{"path":588,"title":589,"description":590},"\u002Fproject\u002Frocket-leaf\u002Fencryption","连接信息加密存储","AES-256-GCM + SHA-256 字段级派生密钥的实现，以及如何在不破坏兼容性的前提下为历史明文数据做透明迁移。",{"path":592,"title":593,"description":594},"\u002Fproject\u002Frocket-leaf\u002Ffrontend","前端结构与类型绑定","React + Vite 目录组织、自动生成的 Wails 绑定、api 薄封装与自定义 hooks 的职责划分。",{"path":596,"title":597,"description":598},"\u002Fproject\u002Frocket-leaf","项目简介","Rocket-Leaf 是一款基于 Wails v3 构建的跨平台 RocketMQ 桌面管理客户端，Go 后端 + React 前端。本文档系列拆解它的架构与关键实现。",{"path":600,"title":601,"description":602},"\u002Fproject\u002Frocket-leaf\u002Fwails-v3","Wails v3 入门","Wails v3 的核心概念、Service 绑定机制，以及 Rocket-Leaf 是如何用它把 Go 后端和 React 前端打通的。",{"path":604,"title":605,"description":11},"\u002Ftutorials\u002Fcloud\u002Fdocker\u002Fdocker-basic","Docker - 入门基础",{"path":607,"title":608,"description":609},"\u002Ftutorials\u002Fcloud\u002Fdocker\u002Fdocker-compose","Docker - Compose","在部署应用时，常常使用到不止一个容器，那么在部署容器的时候就需要一个一个进行部署，这样的部署过程也相对来说比较繁琐复杂，也容易出问题，那么有没有一种更为简单的方法呢？",{"path":611,"title":612,"description":613},"\u002Ftutorials\u002Fcloud\u002Fdocker\u002Fdocker-container-connection","Docker - 容器互联","在上一个章节中我们学习了 Docker 容器的端口映射，可以将 Docker 容器和本地以及网络中的端口进行连接起来。",{"path":615,"title":616,"description":11},"\u002Ftutorials\u002Fcloud\u002Fdocker\u002Fdocker-dockerfile","Docker - Dockerfile",{"path":618,"title":619,"description":11},"\u002Ftutorials\u002Fcloud\u002Fdocker\u002Fdocker-helloworld","Docker - HelloWorld",{"path":621,"title":622,"description":11},"\u002Ftutorials\u002Fcloud\u002Fdocker\u002Fdocker-install","Docker - 安装",{"path":624,"title":625,"description":11},"\u002Ftutorials\u002Fcloud\u002Fdocker\u002Fdocker-introduce","Docker - 简介",{"path":627,"title":628,"description":11},"\u002Ftutorials\u002Fcloud\u002Fdocker\u002Fdocker-object","Docker - 镜像、容器、仓库",{"path":630,"title":631,"description":632},"\u002Ftutorials\u002Fcloud\u002Fdocker\u002Fdocker-warehouse","Docker - 仓库管理","仓库是集中存放资源的地方，代码仓库是存放代码的，那么Docker 中的仓库就是存放 Docker 镜像的。",{"path":634,"title":635,"description":636},"\u002Ftutorials\u002Fcloud\u002Fdocker\u002Fdocker-web-containers","Docker - WEB应用实例","在之前的章节中，仅对普通容器进行了演示，但在实际中常常使用到 Docker 容器中的 WEB 应用程序。",{"path":638,"title":639,"description":11},"\u002Ftutorials\u002Fcloud\u002Fkubernetes\u002Fk8s-config","Kubernetes - ConfigMap 与 Secret",{"path":641,"title":642,"description":11},"\u002Ftutorials\u002Fcloud\u002Fkubernetes\u002Fk8s-helm","Kubernetes - Helm 包管理",{"path":644,"title":645,"description":11},"\u002Ftutorials\u002Fcloud\u002Fkubernetes\u002Fk8s-install","Kubernetes - 集群安装",{"path":647,"title":648,"description":11},"\u002Ftutorials\u002Fcloud\u002Fkubernetes\u002Fk8s-introduction","Kubernetes - 简介与架构",{"path":650,"title":651,"description":11},"\u002Ftutorials\u002Fcloud\u002Fkubernetes\u002Fk8s-kubectl","Kubernetes - kubectl 命令行工具",{"path":653,"title":654,"description":11},"\u002Ftutorials\u002Fcloud\u002Fkubernetes\u002Fk8s-monitoring","Kubernetes - 监控与日志",{"path":656,"title":657,"description":11},"\u002Ftutorials\u002Fcloud\u002Fkubernetes\u002Fk8s-network-security","Kubernetes - 网络与安全",{"path":659,"title":660,"description":11},"\u002Ftutorials\u002Fcloud\u002Fkubernetes\u002Fk8s-service","Kubernetes - Service 与 Ingress",{"path":662,"title":663,"description":11},"\u002Ftutorials\u002Fcloud\u002Fkubernetes\u002Fk8s-storage","Kubernetes - 持久化存储",{"path":665,"title":666,"description":11},"\u002Ftutorials\u002Fcloud\u002Fkubernetes\u002Fk8s-workload","Kubernetes - 工作负载资源",{"path":668,"title":669,"description":11},"\u002Ftutorials\u002Fcloud\u002Flinux\u002Flinux-bash","Linux - Bash 基础语法",{"path":671,"title":672,"description":11},"\u002Ftutorials\u002Fcloud\u002Flinux\u002Flinux-file-directory","Linux - 文件与目录操作",{"path":674,"title":675,"description":11},"\u002Ftutorials\u002Fcloud\u002Flinux\u002Flinux-network","Linux - 网络配置",{"path":677,"title":678,"description":11},"\u002Ftutorials\u002Fcloud\u002Flinux\u002Flinux-package","Linux - 软件包管理",{"path":680,"title":681,"description":11},"\u002Ftutorials\u002Fcloud\u002Flinux\u002Flinux-process","Linux - 进程管理",{"path":683,"title":684,"description":11},"\u002Ftutorials\u002Fcloud\u002Flinux\u002Flinux-scripts","Linux - 常用脚本示例",{"path":686,"title":687,"description":11},"\u002Ftutorials\u002Fcloud\u002Flinux\u002Flinux-service","Linux - 服务管理",{"path":689,"title":690,"description":11},"\u002Ftutorials\u002Fcloud\u002Flinux\u002Flinux-user-permission","Linux - 用户与权限管理",{"path":692,"title":693,"description":11},"\u002Ftutorials\u002Fcloud\u002Fnginx\u002Fnginx-https","Nginx - HTTPS 配置",{"path":695,"title":696,"description":11},"\u002Ftutorials\u002Fcloud\u002Fnginx\u002Fnginx-install","Nginx - 安装与配置",{"path":698,"title":699,"description":11},"\u002Ftutorials\u002Fcloud\u002Fnginx\u002Fnginx-loadbalance","Nginx - 负载均衡",{"path":701,"title":702,"description":11},"\u002Ftutorials\u002Fcloud\u002Fnginx\u002Fnginx-optimization","Nginx - 性能优化",{"path":704,"title":705,"description":11},"\u002Ftutorials\u002Fcloud\u002Fnginx\u002Fnginx-proxy","Nginx - 反向代理",{"path":707,"title":708,"description":11},"\u002Ftutorials\u002Fcloud\u002Fnginx\u002Fnginx-static","Nginx - 静态资源服务",{"path":710,"title":711,"description":11},"\u002Ftutorials\u002Fcloud\u002Fnginx\u002Fnginx-vhost","Nginx - 虚拟主机配置",{"path":713,"title":714,"description":715},"\u002Ftutorials\u002Fdatabase\u002Fmysql\u002Fmysql-architecture","MySQL 高可用架构","主从复制、读写分离、分库分表。",{"path":717,"title":718,"description":719},"\u002Ftutorials\u002Fdatabase\u002Fmysql\u002Fmysql-index","MySQL 索引","索引是帮助 MySQL 高效获取数据的有序数据结构。",{"path":721,"title":722,"description":723},"\u002Ftutorials\u002Fdatabase\u002Fmysql\u002Fmysql-lock","MySQL 锁","锁用于解决并发访问时的数据一致性问题。",{"path":725,"title":726,"description":727},"\u002Ftutorials\u002Fdatabase\u002Fmysql\u002Fmysql-optimize","MySQL 性能优化","SQL 优化是后端开发必备技能。",{"path":729,"title":730,"description":731},"\u002Ftutorials\u002Fdatabase\u002Fmysql\u002Fmysql-transaction","MySQL 事务","事务是一组不可分割的操作，要么全部成功，要么全部失败。",{"path":733,"title":734,"description":735},"\u002Ftutorials\u002Fdatabase\u002Fmysql\u002Fsql-advanced","SQL 进阶","多表查询、子查询、函数、视图、存储过程。",{"path":737,"title":738,"description":739},"\u002Ftutorials\u002Fdatabase\u002Fmysql\u002Fsql-basic","SQL 基础","SQL（Structured Query Language）是操作关系型数据库的标准语言。",{"path":741,"title":742,"description":743},"\u002Ftutorials\u002Fdatabase\u002Fredis\u002Fredis-advanced","Redis 进阶功能","事务、发布订阅、Lua 脚本、Pipeline。",{"path":745,"title":746,"description":747},"\u002Ftutorials\u002Fdatabase\u002Fredis\u002Fredis-basic","Redis 基础","Redis 安装配置与基本命令。",{"path":749,"title":750,"description":751},"\u002Ftutorials\u002Fdatabase\u002Fredis\u002Fredis-cluster","Redis 高可用","主从复制、哨兵、Cluster 集群。",{"path":753,"title":754,"description":755},"\u002Ftutorials\u002Fdatabase\u002Fredis\u002Fredis-datatype","Redis 数据类型","Redis 5 种基本数据类型 + 4 种特殊类型。",{"path":757,"title":758,"description":759},"\u002Ftutorials\u002Fdatabase\u002Fredis\u002Fredis-optimize","Redis 性能优化","内存优化、缓存问题、最佳实践。",{"path":761,"title":762,"description":763},"\u002Ftutorials\u002Fdatabase\u002Fredis\u002Fredis-persistence","Redis 持久化","Redis 提供 RDB 和 AOF 两种持久化方式。",{"path":765,"title":766,"description":767},"\u002Ftutorials\u002Fdatabase\u002Fredis\u002Fredis-principle","Redis 底层原理","数据结构、线程模型、网络模型。",{"path":769,"title":770,"description":771},"\u002Ftutorials\u002Fdev-idea\u002Fdesign-patterns\u002Fbehaiver-patterns\u002Fobserver-pattern","观察者模式","观察者模式属于行为型模式，定义了对象之间的一对多的依赖关系，在这种模式中，当一个对象的状态发生变化时，所有依赖于它的对象都会得到通知，并且执行相关操作。观察者模式又被成为“发布—订阅模式”，即发布者发生改变后，会通知所有订阅者。",{"path":773,"title":774,"description":11},"\u002Ftutorials\u002Fdev-idea\u002Fdesign-patterns\u002Fcreate-patterns\u002Ffactory-pattern","工厂模式",{"path":776,"title":777,"description":778},"\u002Ftutorials\u002Fdev-idea\u002Fdesign-patterns\u002Fcreate-patterns\u002Fsingleton-pattern","单例模式","单例模式是最常用的设计模式之一，他可以保证在整个应用中，某个类只存在一个实例化对象，即全局使用到该类的只有一个对象，这种模式在需要限制某些类的实例数量时非常有用，通常全局只需要一个该对象即可，如一些配置文件映射对象、数据库连接对象等。",{"path":780,"title":781,"description":782},"\u002Ftutorials\u002Fdev-idea\u002Fdesign-patterns\u002Fstructural-patterns\u002Fadapter-pattern","适配器模式","适配器模式是一种结构型模式，可以将一个类的接口转换成客户端所期望的另一种接口，适配器模式可以帮助开发人员在不修改现有代码的情况下，将不兼容的类组合在一起。",{"path":784,"title":785,"description":786},"\u002Ftutorials\u002Fdev-tools\u002Fgit\u002Fgit-basic-operations","Git 创建版本库","在 Git 上创建版本库有两种方式，一种是直接拷贝远程 Git 仓库到本地，另外一种是我们自己创建本地的版本库。",{"path":788,"title":789,"description":11},"\u002Ftutorials\u002Fdev-tools\u002Fgit\u002Fgit-branch-manage","Git 分支管理",{"path":791,"title":792,"description":11},"\u002Ftutorials\u002Fdev-tools\u002Fgit\u002Fgit-content-operations","Git 仓库内容操作",{"path":794,"title":795,"description":11},"\u002Ftutorials\u002Fdev-tools\u002Fgit\u002Fgit-introduce-install","Git 介绍和安装",{"path":797,"title":798,"description":11},"\u002Ftutorials\u002Fdev-tools\u002Fgit\u002Fgit-remote-manage","Git 远程管理",{"path":800,"title":801,"description":11},"\u002Ftutorials\u002Fdev-tools\u002Fgit\u002Fgit-workspace-index-repo","Git 工作原理",{"path":803,"title":804,"description":11},"\u002Ftutorials\u002Fdev-tools\u002Fhomebrew","HomeBrew 教程",{"path":806,"title":807,"description":11},"\u002Ftutorials\u002Fdev-tools\u002Fidea\u002Fshortcuts","快捷键",{"path":809,"title":810,"description":11},"\u002Ftutorials\u002Fdev-tools\u002Fmaven\u002Fintroduce-install-config","Maven - 介绍、安装、配置",{"path":812,"title":813,"description":11},"\u002Ftutorials\u002Ffront-end\u002Fvue3\u002Fbasic-knowledge","2. 基础知识",{"path":815,"title":816,"description":817},"\u002Ftutorials\u002Ffront-end\u002Fvue3\u002Fcomponent-communication","9. 组件通信","在前面的章节内，介绍了 Vue 中最核心的内容——组件的介绍和使用，和 Java 等编程语言相反，组件并不近似于这些变成语言中的类，类可以通过类或者其实例化的对象来相互交互，但 Vue 组件之间的作用域是相互独立的，这就意味着不同组件之间的数据无法相互引用。",{"path":819,"title":820,"description":821},"\u002Ftutorials\u002Ffront-end\u002Fvue3\u002Fcomputed","4. 计算属性","虽然直接在模板中使用表达式方便，但是如果在模板中添加很多逻辑，会让模板变的臃肿且难维护，耦合度较高。有没有一种简单的方式来实现呢？答案是有的。",{"path":823,"title":824,"description":11},"\u002Ftutorials\u002Ffront-end\u002Fvue3\u002Fcreate-vue-project","1. 环境搭建及安装",{"path":826,"title":827,"description":828},"\u002Ftutorials\u002Ffront-end\u002Fvue3\u002Flife-cycle","6. 生命周期","生命周期是指组件从创建、挂载、更新到销毁的整个过程中所经历的一系列阶段。在 Vue 中，每个组件都有自己的生命周期，可以通过生命周期钩子函数来监听和处理组件在不同阶段的行为和状态。",{"path":830,"title":831,"description":11},"\u002Ftutorials\u002Ffront-end\u002Fvue3\u002Fother-api","10. 其他 API",{"path":833,"title":834,"description":11},"\u002Ftutorials\u002Ffront-end\u002Fvue3\u002Fpinia","8. Pinia",{"path":836,"title":837,"description":11},"\u002Ftutorials\u002Ffront-end\u002Fvue3\u002Frouter","7. 路由",{"path":839,"title":840,"description":11},"\u002Ftutorials\u002Ffront-end\u002Fvue3\u002Ftemplate-grammar","3. 指令及模板语法",{"path":842,"title":843,"description":11},"\u002Ftutorials\u002Ffront-end\u002Fvue3\u002Fvue3-new-component","11. Vue3 新组件",{"path":845,"title":846,"description":847},"\u002Ftutorials\u002Ffront-end\u002Fvue3\u002Fwatch","5. 监视","Watch 是 Vue 提供的一个用于监视响应式数据变化并执行相应操作的 API，能够对响应式数据的变化做出一些操作的功能。Vue3 中的 Watch 支持多种用法，包括监视响应式对象、ref 对象、数组、函数等。",{"path":849,"title":850,"description":11},"\u002Ftutorials\u002Fmq\u002Fkafka\u002Fkafka-introduction","Kafka 简介与安装",{"path":852,"title":853,"description":11},"\u002Ftutorials\u002Fmq\u002Fkafka\u002Fkafka-producer-consumer","Kafka 生产者与消费者",{"path":855,"title":856,"description":857},"\u002Ftutorials\u002Fmq\u002Fkafka\u002Fkafka-springboot","Spring Boot 整合 Kafka","Spring Kafka 提供了对 Apache Kafka 的便捷集成。",{"path":859,"title":860,"description":861},"\u002Ftutorials\u002Fmq\u002Frabbitmq\u002Frabbitmq-exchange","RabbitMQ Exchange 详解","Exchange（交换机）是 RabbitMQ 的核心组件，负责接收生产者发送的消息，并根据规则将消息路由到一个或多个队列。",{"path":863,"title":864,"description":11},"\u002Ftutorials\u002Fmq\u002Frabbitmq\u002Frabbitmq-introduction","RabbitMQ 简介与安装",{"path":866,"title":867,"description":868},"\u002Ftutorials\u002Fmq\u002Frabbitmq\u002Frabbitmq-reliability","RabbitMQ 消息可靠性","消息可靠性是消息队列的核心要求，RabbitMQ 提供了多种机制来保证消息不丢失。",{"path":870,"title":871,"description":872},"\u002Ftutorials\u002Fmq\u002Frabbitmq\u002Frabbitmq-springboot","Spring Boot 整合 RabbitMQ","Spring AMQP 提供了对 RabbitMQ 的便捷集成，大大简化了开发工作。",{"path":874,"title":875,"description":11},"\u002Ftutorials\u002Fmq\u002Frocketmq\u002Frocketmq-client","RocketMQ 客户端使用",{"path":877,"title":878,"description":11},"\u002Ftutorials\u002Fmq\u002Frocketmq\u002Frocketmq-concepts","RocketMQ 核心概念",{"path":880,"title":881,"description":11},"\u002Ftutorials\u002Fmq\u002Frocketmq\u002Frocketmq-installation","RocketMQ 安装部署",{"path":883,"title":884,"description":885},"\u002Ftutorials\u002Fmq\u002Frocketmq\u002Frocketmq-message-type","RocketMQ 消息类型","RocketMQ 支持多种消息类型，满足不同业务场景需求。",{"id":887,"title":18,"body":888,"description":19,"extension":3077,"meta":3078,"navigation":1493,"path":17,"seo":3079,"stem":3080,"__hash__":3081},"docs\u002Fai\u002Fagent\u002Fhooks.md",{"type":889,"value":890,"toc":3049},"minimark",[891,896,904,920,931,935,939,951,954,965,968,980,983,986,989,1103,1113,1116,1119,1138,1359,1362,1394,1397,1400,1457,1461,1471,1715,1722,1796,1799,1803,1891,2016,2019,2023,2106,2241,2245,2311,2314,2318,2401,2404,2408,2487,2493,2496,2501,2504,2583,2587,2590,2598,2601,2628,2632,2635,2649,2699,2703,2706,2757,2761,2772,2775,2779,2786,2790,2826,2829,2832,2868,2871,2874,2877,2908,2911,2998,3001,3008,3034,3037,3045],[892,893,895],"h2",{"id":894},"什么是-hooks","什么是 Hooks",[897,898,899,903],"p",{},[900,901,902],"strong",{},"Hooks"," 是 Claude Agent 提供的生命周期钩子机制。它允许你在 Agent 执行过程的关键事件上挂载自定义逻辑，实现：",[905,906,907,911,914,917],"ul",{},[908,909,910],"li",{},"执行前校验（安全卫士）",[908,912,913],{},"执行后处理（格式化、通知）",[908,915,916],{},"自动化触发（文件变更跑测试）",[908,918,919],{},"注入上下文（追加信息）",[897,921,922,923,926,927,930],{},"与 Tools \u002F Skills 不同，",[900,924,925],{},"Hooks 是\"发生了 X 就必须 Y\"的确定性规则","，由 harness（宿主环境）执行，",[900,928,929],{},"不受模型自由裁量","。",[932,933,934],"note",{},"\nHooks 最重要的性质：**harness 执行，不是 Claude 执行**。这意味着它们 100% 会被触发，适合作安全边界和自动化流水线。\n",[892,936,938],{"id":937},"为什么需要-hooks","为什么需要 Hooks",[897,940,941,942,946,947,950],{},"考虑场景：\"每次修改 ",[943,944,945],"code",{},".ts"," 文件后自动跑 ",[943,948,949],{},"prettier","\"。",[897,952,953],{},"用 skill \u002F 提示词实现：",[905,955,956,959,962],{},[908,957,958],{},"Agent 可能忘记",[908,960,961],{},"Agent 可能选择跳过",[908,963,964],{},"很难保证 100% 执行",[897,966,967],{},"用 Hook 实现：",[905,969,970,977],{},[908,971,972,973,976],{},"只要匹配 ",[943,974,975],{},"PostToolUse: Edit","，harness 强制执行 prettier",[908,978,979],{},"模型无法绕过",[897,981,982],{},"Hooks 是把\"流程约束\"从提示词下沉到基础设施层的利器。",[892,984,985],{"id":985},"事件类型",[897,987,988],{},"Claude Agent 定义了一套标准事件，主要包括：",[990,991,992,1008],"table",{},[993,994,995],"thead",{},[996,997,998,1002,1005],"tr",{},[999,1000,1001],"th",{},"事件",[999,1003,1004],{},"触发时机",[999,1006,1007],{},"典型用途",[1009,1010,1011,1025,1038,1051,1064,1077,1090],"tbody",{},[996,1012,1013,1019,1022],{},[1014,1015,1016],"td",{},[943,1017,1018],{},"SessionStart",[1014,1020,1021],{},"会话初始化",[1014,1023,1024],{},"注入初始上下文 \u002F 日志",[996,1026,1027,1032,1035],{},[1014,1028,1029],{},[943,1030,1031],{},"UserPromptSubmit",[1014,1033,1034],{},"用户发送消息",[1014,1036,1037],{},"过滤\u002F改写\u002F拦截 prompt",[996,1039,1040,1045,1048],{},[1014,1041,1042],{},[943,1043,1044],{},"PreToolUse",[1014,1046,1047],{},"工具调用前",[1014,1049,1050],{},"权限校验 \u002F 参数审计",[996,1052,1053,1058,1061],{},[1014,1054,1055],{},[943,1056,1057],{},"PostToolUse",[1014,1059,1060],{},"工具调用后",[1014,1062,1063],{},"格式化 \u002F 验证 \u002F 通知",[996,1065,1066,1071,1074],{},[1014,1067,1068],{},[943,1069,1070],{},"Notification",[1014,1072,1073],{},"Agent 发送通知",[1014,1075,1076],{},"桌面提醒 \u002F 消息推送",[996,1078,1079,1084,1087],{},[1014,1080,1081],{},[943,1082,1083],{},"Stop",[1014,1085,1086],{},"会话结束",[1014,1088,1089],{},"清理 \u002F 汇总 \u002F 保存",[996,1091,1092,1097,1100],{},[1014,1093,1094],{},[943,1095,1096],{},"SubagentStop",[1014,1098,1099],{},"子代理结束",[1014,1101,1102],{},"聚合结果",[1104,1105,1111],"pre",{"className":1106,"code":1108,"language":1109,"meta":1110},[1107],"language-text","flowchart TD\n    Start[\"SessionStart\"] --> Input[\"UserPromptSubmit\"]\n    Input --> Loop{\"Agent Loop\"}\n    Loop --> Pre[\"PreToolUse\"]\n    Pre -->|allow| Exec[\"执行工具\"]\n    Pre -->|deny| Reject[\"拒绝 + 反馈模型\"]\n    Exec --> Post[\"PostToolUse\"]\n    Post --> Loop\n    Loop --> Stop[\"Stop\"]\n","text","mermaid",[943,1112,1108],{"__ignoreMap":11},[892,1114,1115],{"id":1115},"配置位置",[897,1117,1118],{},"Hooks 通过配置文件声明，通常放在：",[905,1120,1121,1130],{},[908,1122,1123,1126,1127],{},[900,1124,1125],{},"项目级","：",[943,1128,1129],{},".claude\u002Fsettings.json",[908,1131,1132,1126,1135],{},[900,1133,1134],{},"用户级",[943,1136,1137],{},"~\u002F.claude\u002Fsettings.json",[1104,1139,1143],{"className":1140,"code":1141,"language":1142,"meta":11,"style":11},"language-json shiki shiki-themes github-light github-light github-dark","{\n  \"hooks\": {\n    \"PostToolUse\": [\n      {\n        \"matcher\": \"Edit|Write\",\n        \"hooks\": [\n          {\n            \"type\": \"command\",\n            \"command\": \"prettier --write \\\"$CLAUDE_FILE_PATH\\\"\"\n          }\n        ]\n      }\n    ],\n    \"PreToolUse\": [\n      {\n        \"matcher\": \"Bash\",\n        \"hooks\": [\n          {\n            \"type\": \"command\",\n            \"command\": \"bash .claude\u002Fhooks\u002Fguard-bash.sh\"\n          }\n        ]\n      }\n    ]\n  }\n}\n","json",[943,1144,1145,1154,1164,1173,1179,1195,1203,1209,1222,1244,1250,1256,1262,1268,1276,1281,1293,1300,1305,1316,1326,1331,1336,1341,1347,1353],{"__ignoreMap":11},[1146,1147,1150],"span",{"class":1148,"line":1149},"line",1,[1146,1151,1153],{"class":1152},"sxrX7","{\n",[1146,1155,1157,1161],{"class":1148,"line":1156},2,[1146,1158,1160],{"class":1159},"sBjJW","  \"hooks\"",[1146,1162,1163],{"class":1152},": {\n",[1146,1165,1167,1170],{"class":1148,"line":1166},3,[1146,1168,1169],{"class":1159},"    \"PostToolUse\"",[1146,1171,1172],{"class":1152},": [\n",[1146,1174,1176],{"class":1148,"line":1175},4,[1146,1177,1178],{"class":1152},"      {\n",[1146,1180,1182,1185,1188,1192],{"class":1148,"line":1181},5,[1146,1183,1184],{"class":1159},"        \"matcher\"",[1146,1186,1187],{"class":1152},": ",[1146,1189,1191],{"class":1190},"sIIMD","\"Edit|Write\"",[1146,1193,1194],{"class":1152},",\n",[1146,1196,1198,1201],{"class":1148,"line":1197},6,[1146,1199,1200],{"class":1159},"        \"hooks\"",[1146,1202,1172],{"class":1152},[1146,1204,1206],{"class":1148,"line":1205},7,[1146,1207,1208],{"class":1152},"          {\n",[1146,1210,1212,1215,1217,1220],{"class":1148,"line":1211},8,[1146,1213,1214],{"class":1159},"            \"type\"",[1146,1216,1187],{"class":1152},[1146,1218,1219],{"class":1190},"\"command\"",[1146,1221,1194],{"class":1152},[1146,1223,1225,1228,1230,1233,1236,1239,1241],{"class":1148,"line":1224},9,[1146,1226,1227],{"class":1159},"            \"command\"",[1146,1229,1187],{"class":1152},[1146,1231,1232],{"class":1190},"\"prettier --write ",[1146,1234,1235],{"class":1159},"\\\"",[1146,1237,1238],{"class":1190},"$CLAUDE_FILE_PATH",[1146,1240,1235],{"class":1159},[1146,1242,1243],{"class":1190},"\"\n",[1146,1245,1247],{"class":1148,"line":1246},10,[1146,1248,1249],{"class":1152},"          }\n",[1146,1251,1253],{"class":1148,"line":1252},11,[1146,1254,1255],{"class":1152},"        ]\n",[1146,1257,1259],{"class":1148,"line":1258},12,[1146,1260,1261],{"class":1152},"      }\n",[1146,1263,1265],{"class":1148,"line":1264},13,[1146,1266,1267],{"class":1152},"    ],\n",[1146,1269,1271,1274],{"class":1148,"line":1270},14,[1146,1272,1273],{"class":1159},"    \"PreToolUse\"",[1146,1275,1172],{"class":1152},[1146,1277,1279],{"class":1148,"line":1278},15,[1146,1280,1178],{"class":1152},[1146,1282,1284,1286,1288,1291],{"class":1148,"line":1283},16,[1146,1285,1184],{"class":1159},[1146,1287,1187],{"class":1152},[1146,1289,1290],{"class":1190},"\"Bash\"",[1146,1292,1194],{"class":1152},[1146,1294,1296,1298],{"class":1148,"line":1295},17,[1146,1297,1200],{"class":1159},[1146,1299,1172],{"class":1152},[1146,1301,1303],{"class":1148,"line":1302},18,[1146,1304,1208],{"class":1152},[1146,1306,1308,1310,1312,1314],{"class":1148,"line":1307},19,[1146,1309,1214],{"class":1159},[1146,1311,1187],{"class":1152},[1146,1313,1219],{"class":1190},[1146,1315,1194],{"class":1152},[1146,1317,1319,1321,1323],{"class":1148,"line":1318},20,[1146,1320,1227],{"class":1159},[1146,1322,1187],{"class":1152},[1146,1324,1325],{"class":1190},"\"bash .claude\u002Fhooks\u002Fguard-bash.sh\"\n",[1146,1327,1329],{"class":1148,"line":1328},21,[1146,1330,1249],{"class":1152},[1146,1332,1334],{"class":1148,"line":1333},22,[1146,1335,1255],{"class":1152},[1146,1337,1339],{"class":1148,"line":1338},23,[1146,1340,1261],{"class":1152},[1146,1342,1344],{"class":1148,"line":1343},24,[1146,1345,1346],{"class":1152},"    ]\n",[1146,1348,1350],{"class":1148,"line":1349},25,[1146,1351,1352],{"class":1152},"  }\n",[1146,1354,1356],{"class":1148,"line":1355},26,[1146,1357,1358],{"class":1152},"}\n",[897,1360,1361],{},"字段说明：",[905,1363,1364,1370,1378,1386],{},[908,1365,1366,1369],{},[900,1367,1368],{},"事件名"," → 数组，可以配置多组规则",[908,1371,1372,1377],{},[900,1373,1374],{},[943,1375,1376],{},"matcher"," → 正则，匹配工具名；不填则匹配所有",[908,1379,1380,1385],{},[900,1381,1382],{},[943,1383,1384],{},"hooks"," → 实际执行的命令列表",[908,1387,1388,1393],{},[900,1389,1390],{},[943,1391,1392],{},"type: command"," → 当前主流类型，执行 shell 命令",[892,1395,1396],{"id":1396},"数据流",[897,1398,1399],{},"当 hook 被触发时，harness 会：",[1401,1402,1403,1409,1422,1428,1451],"ol",{},[908,1404,1405,1408],{},[900,1406,1407],{},"把事件数据序列化成 JSON","，通过 stdin 传给 hook 进程",[908,1410,1411,1414,1415,1418,1419],{},[900,1412,1413],{},"设置环境变量","，例如 ",[943,1416,1417],{},"CLAUDE_FILE_PATH","、",[943,1420,1421],{},"CLAUDE_TOOL_NAME",[908,1423,1424,1427],{},[900,1425,1426],{},"等待 hook 退出","，读取 stdout 和 exit code",[908,1429,1430,1433,1434],{},[900,1431,1432],{},"根据退出码决定后续行为","：\n",[905,1435,1436,1442],{},[908,1437,1438,1441],{},[943,1439,1440],{},"0","：继续正常流程",[908,1443,1444,1445,1447,1448,1450],{},"非 ",[943,1446,1440],{},"：对 ",[943,1449,1044],{}," 表示\"拒绝\"，对其他事件表示\"警告但继续\"",[908,1452,1453,1456],{},[900,1454,1455],{},"将 hook 的 stdout 反馈给模型","（可选，取决于 hook 实现）",[892,1458,1460],{"id":1459},"示例-1危险命令卫士","示例 1：危险命令卫士",[897,1462,1463,1464,1418,1467,1470],{},"拦截 ",[943,1465,1466],{},"rm -rf",[943,1468,1469],{},"sudo"," 等命令：",[1104,1472,1476],{"className":1473,"code":1474,"language":1475,"meta":11,"style":11},"language-bash shiki shiki-themes github-light github-light github-dark","#!\u002Fusr\u002Fbin\u002Fenv bash\n# .claude\u002Fhooks\u002Fguard-bash.sh\n\n# 从 stdin 读取 JSON\ninput=$(cat)\ncommand=$(echo \"$input\" | jq -r '.tool_input.command \u002F\u002F \"\"')\n\ndeny_patterns=(\n  \"rm -rf \u002F\"\n  \"rm -rf \\~\"\n  \":\\(\\)\\{.*\\|.*\\&\\};:\"  # fork bomb\n  \"curl.*\\| *sh\"\n  \"wget.*\\| *bash\"\n)\n\nfor pattern in \"${deny_patterns[@]}\"; do\n  if echo \"$command\" | grep -qE \"$pattern\"; then\n    echo \"❌ 禁止执行危险命令: $pattern\"\n    exit 1  # 非 0 退出码 = 拒绝\n  fi\ndone\n\nexit 0\n","bash",[943,1477,1478,1484,1489,1495,1500,1519,1554,1558,1568,1573,1578,1586,1591,1596,1600,1604,1635,1670,1682,1693,1698,1703,1707],{"__ignoreMap":11},[1146,1479,1480],{"class":1148,"line":1149},[1146,1481,1483],{"class":1482},"sCsY4","#!\u002Fusr\u002Fbin\u002Fenv bash\n",[1146,1485,1486],{"class":1148,"line":1156},[1146,1487,1488],{"class":1482},"# .claude\u002Fhooks\u002Fguard-bash.sh\n",[1146,1490,1491],{"class":1148,"line":1166},[1146,1492,1494],{"emptyLinePlaceholder":1493},true,"\n",[1146,1496,1497],{"class":1148,"line":1175},[1146,1498,1499],{"class":1482},"# 从 stdin 读取 JSON\n",[1146,1501,1502,1505,1509,1512,1516],{"class":1148,"line":1181},[1146,1503,1504],{"class":1152},"input",[1146,1506,1508],{"class":1507},"s8jYJ","=",[1146,1510,1511],{"class":1152},"$(",[1146,1513,1515],{"class":1514},"snPdu","cat",[1146,1517,1518],{"class":1152},")\n",[1146,1520,1521,1524,1526,1528,1531,1534,1537,1540,1543,1546,1549,1552],{"class":1148,"line":1197},[1146,1522,1523],{"class":1152},"command",[1146,1525,1508],{"class":1507},[1146,1527,1511],{"class":1152},[1146,1529,1530],{"class":1159},"echo",[1146,1532,1533],{"class":1190}," \"",[1146,1535,1536],{"class":1152},"$input",[1146,1538,1539],{"class":1190},"\"",[1146,1541,1542],{"class":1507}," |",[1146,1544,1545],{"class":1514}," jq",[1146,1547,1548],{"class":1159}," -r",[1146,1550,1551],{"class":1190}," '.tool_input.command \u002F\u002F \"\"'",[1146,1553,1518],{"class":1152},[1146,1555,1556],{"class":1148,"line":1205},[1146,1557,1494],{"emptyLinePlaceholder":1493},[1146,1559,1560,1563,1565],{"class":1148,"line":1211},[1146,1561,1562],{"class":1152},"deny_patterns",[1146,1564,1508],{"class":1507},[1146,1566,1567],{"class":1152},"(\n",[1146,1569,1570],{"class":1148,"line":1224},[1146,1571,1572],{"class":1190},"  \"rm -rf \u002F\"\n",[1146,1574,1575],{"class":1148,"line":1246},[1146,1576,1577],{"class":1190},"  \"rm -rf \\~\"\n",[1146,1579,1580,1583],{"class":1148,"line":1252},[1146,1581,1582],{"class":1190},"  \":\\(\\)\\{.*\\|.*\\&\\};:\"",[1146,1584,1585],{"class":1482},"  # fork bomb\n",[1146,1587,1588],{"class":1148,"line":1258},[1146,1589,1590],{"class":1190},"  \"curl.*\\| *sh\"\n",[1146,1592,1593],{"class":1148,"line":1264},[1146,1594,1595],{"class":1190},"  \"wget.*\\| *bash\"\n",[1146,1597,1598],{"class":1148,"line":1270},[1146,1599,1518],{"class":1152},[1146,1601,1602],{"class":1148,"line":1278},[1146,1603,1494],{"emptyLinePlaceholder":1493},[1146,1605,1606,1609,1612,1615,1618,1620,1623,1626,1629,1632],{"class":1148,"line":1283},[1146,1607,1608],{"class":1507},"for",[1146,1610,1611],{"class":1152}," pattern ",[1146,1613,1614],{"class":1507},"in",[1146,1616,1617],{"class":1190}," \"${",[1146,1619,1562],{"class":1152},[1146,1621,1622],{"class":1190},"[",[1146,1624,1625],{"class":1507},"@",[1146,1627,1628],{"class":1190},"]}\"",[1146,1630,1631],{"class":1152},"; ",[1146,1633,1634],{"class":1507},"do\n",[1146,1636,1637,1640,1643,1645,1648,1650,1652,1655,1658,1660,1663,1665,1667],{"class":1148,"line":1295},[1146,1638,1639],{"class":1507},"  if",[1146,1641,1642],{"class":1159}," echo",[1146,1644,1533],{"class":1190},[1146,1646,1647],{"class":1152},"$command",[1146,1649,1539],{"class":1190},[1146,1651,1542],{"class":1507},[1146,1653,1654],{"class":1514}," grep",[1146,1656,1657],{"class":1159}," -qE",[1146,1659,1533],{"class":1190},[1146,1661,1662],{"class":1152},"$pattern",[1146,1664,1539],{"class":1190},[1146,1666,1631],{"class":1152},[1146,1668,1669],{"class":1507},"then\n",[1146,1671,1672,1675,1678,1680],{"class":1148,"line":1302},[1146,1673,1674],{"class":1159},"    echo",[1146,1676,1677],{"class":1190}," \"❌ 禁止执行危险命令: ",[1146,1679,1662],{"class":1152},[1146,1681,1243],{"class":1190},[1146,1683,1684,1687,1690],{"class":1148,"line":1307},[1146,1685,1686],{"class":1159},"    exit",[1146,1688,1689],{"class":1159}," 1",[1146,1691,1692],{"class":1482},"  # 非 0 退出码 = 拒绝\n",[1146,1694,1695],{"class":1148,"line":1318},[1146,1696,1697],{"class":1507},"  fi\n",[1146,1699,1700],{"class":1148,"line":1328},[1146,1701,1702],{"class":1507},"done\n",[1146,1704,1705],{"class":1148,"line":1333},[1146,1706,1494],{"emptyLinePlaceholder":1493},[1146,1708,1709,1712],{"class":1148,"line":1338},[1146,1710,1711],{"class":1159},"exit",[1146,1713,1714],{"class":1159}," 0\n",[897,1716,1717,1718,1721],{},"在 ",[943,1719,1720],{},"settings.json"," 里挂载：",[1104,1723,1725],{"className":1140,"code":1724,"language":1142,"meta":11,"style":11},"{\n  \"hooks\": {\n    \"PreToolUse\": [{\n      \"matcher\": \"Bash\",\n      \"hooks\": [{ \"type\": \"command\", \"command\": \"bash .claude\u002Fhooks\u002Fguard-bash.sh\" }]\n    }]\n  }\n}\n",[943,1726,1727,1731,1737,1744,1755,1783,1788,1792],{"__ignoreMap":11},[1146,1728,1729],{"class":1148,"line":1149},[1146,1730,1153],{"class":1152},[1146,1732,1733,1735],{"class":1148,"line":1156},[1146,1734,1160],{"class":1159},[1146,1736,1163],{"class":1152},[1146,1738,1739,1741],{"class":1148,"line":1166},[1146,1740,1273],{"class":1159},[1146,1742,1743],{"class":1152},": [{\n",[1146,1745,1746,1749,1751,1753],{"class":1148,"line":1175},[1146,1747,1748],{"class":1159},"      \"matcher\"",[1146,1750,1187],{"class":1152},[1146,1752,1290],{"class":1190},[1146,1754,1194],{"class":1152},[1146,1756,1757,1760,1763,1766,1768,1770,1773,1775,1777,1780],{"class":1148,"line":1181},[1146,1758,1759],{"class":1159},"      \"hooks\"",[1146,1761,1762],{"class":1152},": [{ ",[1146,1764,1765],{"class":1159},"\"type\"",[1146,1767,1187],{"class":1152},[1146,1769,1219],{"class":1190},[1146,1771,1772],{"class":1152},", ",[1146,1774,1219],{"class":1159},[1146,1776,1187],{"class":1152},[1146,1778,1779],{"class":1190},"\"bash .claude\u002Fhooks\u002Fguard-bash.sh\"",[1146,1781,1782],{"class":1152}," }]\n",[1146,1784,1785],{"class":1148,"line":1197},[1146,1786,1787],{"class":1152},"    }]\n",[1146,1789,1790],{"class":1148,"line":1205},[1146,1791,1352],{"class":1152},[1146,1793,1794],{"class":1148,"line":1211},[1146,1795,1358],{"class":1152},[897,1797,1798],{},"效果：只要 Agent 想跑危险命令，无论模型怎么被说服都会被 hook 挡住。",[892,1800,1802],{"id":1801},"示例-2编辑后自动格式化","示例 2：编辑后自动格式化",[1104,1804,1806],{"className":1140,"code":1805,"language":1142,"meta":11,"style":11},"{\n  \"hooks\": {\n    \"PostToolUse\": [\n      {\n        \"matcher\": \"Edit|Write\",\n        \"hooks\": [\n          {\n            \"type\": \"command\",\n            \"command\": \"node .claude\u002Fhooks\u002Fformat.mjs\"\n          }\n        ]\n      }\n    ]\n  }\n}\n",[943,1807,1808,1812,1818,1824,1828,1838,1844,1848,1858,1867,1871,1875,1879,1883,1887],{"__ignoreMap":11},[1146,1809,1810],{"class":1148,"line":1149},[1146,1811,1153],{"class":1152},[1146,1813,1814,1816],{"class":1148,"line":1156},[1146,1815,1160],{"class":1159},[1146,1817,1163],{"class":1152},[1146,1819,1820,1822],{"class":1148,"line":1166},[1146,1821,1169],{"class":1159},[1146,1823,1172],{"class":1152},[1146,1825,1826],{"class":1148,"line":1175},[1146,1827,1178],{"class":1152},[1146,1829,1830,1832,1834,1836],{"class":1148,"line":1181},[1146,1831,1184],{"class":1159},[1146,1833,1187],{"class":1152},[1146,1835,1191],{"class":1190},[1146,1837,1194],{"class":1152},[1146,1839,1840,1842],{"class":1148,"line":1197},[1146,1841,1200],{"class":1159},[1146,1843,1172],{"class":1152},[1146,1845,1846],{"class":1148,"line":1205},[1146,1847,1208],{"class":1152},[1146,1849,1850,1852,1854,1856],{"class":1148,"line":1211},[1146,1851,1214],{"class":1159},[1146,1853,1187],{"class":1152},[1146,1855,1219],{"class":1190},[1146,1857,1194],{"class":1152},[1146,1859,1860,1862,1864],{"class":1148,"line":1224},[1146,1861,1227],{"class":1159},[1146,1863,1187],{"class":1152},[1146,1865,1866],{"class":1190},"\"node .claude\u002Fhooks\u002Fformat.mjs\"\n",[1146,1868,1869],{"class":1148,"line":1246},[1146,1870,1249],{"class":1152},[1146,1872,1873],{"class":1148,"line":1252},[1146,1874,1255],{"class":1152},[1146,1876,1877],{"class":1148,"line":1258},[1146,1878,1261],{"class":1152},[1146,1880,1881],{"class":1148,"line":1264},[1146,1882,1346],{"class":1152},[1146,1884,1885],{"class":1148,"line":1270},[1146,1886,1352],{"class":1152},[1146,1888,1889],{"class":1148,"line":1278},[1146,1890,1358],{"class":1152},[1104,1892,1896],{"className":1893,"code":1894,"language":1895,"meta":11,"style":11},"language-js shiki shiki-themes github-light github-light github-dark","\u002F\u002F .claude\u002Fhooks\u002Fformat.mjs\nimport { execSync } from \"node:child_process\"\n\nconst input = JSON.parse(await new Response(process.stdin).text())\nconst file = input.tool_input.file_path\n\nif (!file) process.exit(0)\n\nconst ext = file.split(\".\").pop()\nconst formatters = {\n  ts: `prettier --write \"${file}\"`,\n  js: `prettier --write \"${file}\"`,\n  py: `ruff format \"${file}\"`,\n  go: `gofmt -w \"${file}\"`,\n}\n\nconst cmd = formatters[ext]\nif (cmd) {\n  try {\n    execSync(cmd, { stdio: \"inherit\" })\n  } catch {\n    \u002F\u002F 不打断流程\n  }\n}\nprocess.exit(0)\n","js",[943,1897,1898,1903,1908,1912,1917,1922,1926,1931,1935,1940,1945,1950,1955,1960,1965,1969,1973,1978,1983,1988,1993,1998,2003,2007,2011],{"__ignoreMap":11},[1146,1899,1900],{"class":1148,"line":1149},[1146,1901,1902],{},"\u002F\u002F .claude\u002Fhooks\u002Fformat.mjs\n",[1146,1904,1905],{"class":1148,"line":1156},[1146,1906,1907],{},"import { execSync } from \"node:child_process\"\n",[1146,1909,1910],{"class":1148,"line":1166},[1146,1911,1494],{"emptyLinePlaceholder":1493},[1146,1913,1914],{"class":1148,"line":1175},[1146,1915,1916],{},"const input = JSON.parse(await new Response(process.stdin).text())\n",[1146,1918,1919],{"class":1148,"line":1181},[1146,1920,1921],{},"const file = input.tool_input.file_path\n",[1146,1923,1924],{"class":1148,"line":1197},[1146,1925,1494],{"emptyLinePlaceholder":1493},[1146,1927,1928],{"class":1148,"line":1205},[1146,1929,1930],{},"if (!file) process.exit(0)\n",[1146,1932,1933],{"class":1148,"line":1211},[1146,1934,1494],{"emptyLinePlaceholder":1493},[1146,1936,1937],{"class":1148,"line":1224},[1146,1938,1939],{},"const ext = file.split(\".\").pop()\n",[1146,1941,1942],{"class":1148,"line":1246},[1146,1943,1944],{},"const formatters = {\n",[1146,1946,1947],{"class":1148,"line":1252},[1146,1948,1949],{},"  ts: `prettier --write \"${file}\"`,\n",[1146,1951,1952],{"class":1148,"line":1258},[1146,1953,1954],{},"  js: `prettier --write \"${file}\"`,\n",[1146,1956,1957],{"class":1148,"line":1264},[1146,1958,1959],{},"  py: `ruff format \"${file}\"`,\n",[1146,1961,1962],{"class":1148,"line":1270},[1146,1963,1964],{},"  go: `gofmt -w \"${file}\"`,\n",[1146,1966,1967],{"class":1148,"line":1278},[1146,1968,1358],{},[1146,1970,1971],{"class":1148,"line":1283},[1146,1972,1494],{"emptyLinePlaceholder":1493},[1146,1974,1975],{"class":1148,"line":1295},[1146,1976,1977],{},"const cmd = formatters[ext]\n",[1146,1979,1980],{"class":1148,"line":1302},[1146,1981,1982],{},"if (cmd) {\n",[1146,1984,1985],{"class":1148,"line":1307},[1146,1986,1987],{},"  try {\n",[1146,1989,1990],{"class":1148,"line":1318},[1146,1991,1992],{},"    execSync(cmd, { stdio: \"inherit\" })\n",[1146,1994,1995],{"class":1148,"line":1328},[1146,1996,1997],{},"  } catch {\n",[1146,1999,2000],{"class":1148,"line":1333},[1146,2001,2002],{},"    \u002F\u002F 不打断流程\n",[1146,2004,2005],{"class":1148,"line":1338},[1146,2006,1352],{},[1146,2008,2009],{"class":1148,"line":1343},[1146,2010,1358],{},[1146,2012,2013],{"class":1148,"line":1349},[1146,2014,2015],{},"process.exit(0)\n",[897,2017,2018],{},"现在 Agent 每写完一个文件都会自动格式化，无需再在提示里提醒。",[892,2020,2022],{"id":2021},"示例-3提交前跑测试","示例 3：提交前跑测试",[1104,2024,2026],{"className":1140,"code":2025,"language":1142,"meta":11,"style":11},"{\n  \"hooks\": {\n    \"PreToolUse\": [\n      {\n        \"matcher\": \"Bash\",\n        \"hooks\": [{\n          \"type\": \"command\",\n          \"command\": \"bash .claude\u002Fhooks\u002Fpre-commit-guard.sh\"\n        }]\n      }\n    ]\n  }\n}\n",[943,2027,2028,2032,2038,2044,2048,2058,2064,2075,2085,2090,2094,2098,2102],{"__ignoreMap":11},[1146,2029,2030],{"class":1148,"line":1149},[1146,2031,1153],{"class":1152},[1146,2033,2034,2036],{"class":1148,"line":1156},[1146,2035,1160],{"class":1159},[1146,2037,1163],{"class":1152},[1146,2039,2040,2042],{"class":1148,"line":1166},[1146,2041,1273],{"class":1159},[1146,2043,1172],{"class":1152},[1146,2045,2046],{"class":1148,"line":1175},[1146,2047,1178],{"class":1152},[1146,2049,2050,2052,2054,2056],{"class":1148,"line":1181},[1146,2051,1184],{"class":1159},[1146,2053,1187],{"class":1152},[1146,2055,1290],{"class":1190},[1146,2057,1194],{"class":1152},[1146,2059,2060,2062],{"class":1148,"line":1197},[1146,2061,1200],{"class":1159},[1146,2063,1743],{"class":1152},[1146,2065,2066,2069,2071,2073],{"class":1148,"line":1205},[1146,2067,2068],{"class":1159},"          \"type\"",[1146,2070,1187],{"class":1152},[1146,2072,1219],{"class":1190},[1146,2074,1194],{"class":1152},[1146,2076,2077,2080,2082],{"class":1148,"line":1211},[1146,2078,2079],{"class":1159},"          \"command\"",[1146,2081,1187],{"class":1152},[1146,2083,2084],{"class":1190},"\"bash .claude\u002Fhooks\u002Fpre-commit-guard.sh\"\n",[1146,2086,2087],{"class":1148,"line":1224},[1146,2088,2089],{"class":1152},"        }]\n",[1146,2091,2092],{"class":1148,"line":1246},[1146,2093,1261],{"class":1152},[1146,2095,2096],{"class":1148,"line":1252},[1146,2097,1346],{"class":1152},[1146,2099,2100],{"class":1148,"line":1258},[1146,2101,1352],{"class":1152},[1146,2103,2104],{"class":1148,"line":1264},[1146,2105,1358],{"class":1152},[1104,2107,2109],{"className":1473,"code":2108,"language":1475,"meta":11,"style":11},"#!\u002Fusr\u002Fbin\u002Fenv bash\ninput=$(cat)\ncmd=$(echo \"$input\" | jq -r '.tool_input.command')\n\n# 只对 git commit 命令生效\nif echo \"$cmd\" | grep -q \"git commit\"; then\n  if ! npm test --silent; then\n    echo \"❌ 测试未通过，拒绝提交。请先修复测试。\"\n    exit 1\n  fi\nfi\nexit 0\n",[943,2110,2111,2115,2127,2155,2159,2164,2192,2212,2219,2226,2230,2235],{"__ignoreMap":11},[1146,2112,2113],{"class":1148,"line":1149},[1146,2114,1483],{"class":1482},[1146,2116,2117,2119,2121,2123,2125],{"class":1148,"line":1156},[1146,2118,1504],{"class":1152},[1146,2120,1508],{"class":1507},[1146,2122,1511],{"class":1152},[1146,2124,1515],{"class":1514},[1146,2126,1518],{"class":1152},[1146,2128,2129,2132,2134,2136,2138,2140,2142,2144,2146,2148,2150,2153],{"class":1148,"line":1166},[1146,2130,2131],{"class":1152},"cmd",[1146,2133,1508],{"class":1507},[1146,2135,1511],{"class":1152},[1146,2137,1530],{"class":1159},[1146,2139,1533],{"class":1190},[1146,2141,1536],{"class":1152},[1146,2143,1539],{"class":1190},[1146,2145,1542],{"class":1507},[1146,2147,1545],{"class":1514},[1146,2149,1548],{"class":1159},[1146,2151,2152],{"class":1190}," '.tool_input.command'",[1146,2154,1518],{"class":1152},[1146,2156,2157],{"class":1148,"line":1175},[1146,2158,1494],{"emptyLinePlaceholder":1493},[1146,2160,2161],{"class":1148,"line":1181},[1146,2162,2163],{"class":1482},"# 只对 git commit 命令生效\n",[1146,2165,2166,2169,2171,2173,2176,2178,2180,2182,2185,2188,2190],{"class":1148,"line":1197},[1146,2167,2168],{"class":1507},"if",[1146,2170,1642],{"class":1159},[1146,2172,1533],{"class":1190},[1146,2174,2175],{"class":1152},"$cmd",[1146,2177,1539],{"class":1190},[1146,2179,1542],{"class":1507},[1146,2181,1654],{"class":1514},[1146,2183,2184],{"class":1159}," -q",[1146,2186,2187],{"class":1190}," \"git commit\"",[1146,2189,1631],{"class":1152},[1146,2191,1669],{"class":1507},[1146,2193,2194,2196,2199,2202,2205,2208,2210],{"class":1148,"line":1205},[1146,2195,1639],{"class":1507},[1146,2197,2198],{"class":1507}," !",[1146,2200,2201],{"class":1514}," npm",[1146,2203,2204],{"class":1190}," test",[1146,2206,2207],{"class":1159}," --silent",[1146,2209,1631],{"class":1152},[1146,2211,1669],{"class":1507},[1146,2213,2214,2216],{"class":1148,"line":1211},[1146,2215,1674],{"class":1159},[1146,2217,2218],{"class":1190}," \"❌ 测试未通过，拒绝提交。请先修复测试。\"\n",[1146,2220,2221,2223],{"class":1148,"line":1224},[1146,2222,1686],{"class":1159},[1146,2224,2225],{"class":1159}," 1\n",[1146,2227,2228],{"class":1148,"line":1246},[1146,2229,1697],{"class":1507},[1146,2231,2232],{"class":1148,"line":1252},[1146,2233,2234],{"class":1507},"fi\n",[1146,2236,2237,2239],{"class":1148,"line":1258},[1146,2238,1711],{"class":1159},[1146,2240,1714],{"class":1159},[892,2242,2244],{"id":2243},"示例-4sessionstart-注入项目上下文","示例 4：SessionStart 注入项目上下文",[1104,2246,2248],{"className":1140,"code":2247,"language":1142,"meta":11,"style":11},"{\n  \"hooks\": {\n    \"SessionStart\": [{\n      \"hooks\": [{\n        \"type\": \"command\",\n        \"command\": \"cat .claude\u002Fproject-context.md\"\n      }]\n    }]\n  }\n}\n",[943,2249,2250,2254,2260,2267,2273,2284,2294,2299,2303,2307],{"__ignoreMap":11},[1146,2251,2252],{"class":1148,"line":1149},[1146,2253,1153],{"class":1152},[1146,2255,2256,2258],{"class":1148,"line":1156},[1146,2257,1160],{"class":1159},[1146,2259,1163],{"class":1152},[1146,2261,2262,2265],{"class":1148,"line":1166},[1146,2263,2264],{"class":1159},"    \"SessionStart\"",[1146,2266,1743],{"class":1152},[1146,2268,2269,2271],{"class":1148,"line":1175},[1146,2270,1759],{"class":1159},[1146,2272,1743],{"class":1152},[1146,2274,2275,2278,2280,2282],{"class":1148,"line":1181},[1146,2276,2277],{"class":1159},"        \"type\"",[1146,2279,1187],{"class":1152},[1146,2281,1219],{"class":1190},[1146,2283,1194],{"class":1152},[1146,2285,2286,2289,2291],{"class":1148,"line":1197},[1146,2287,2288],{"class":1159},"        \"command\"",[1146,2290,1187],{"class":1152},[1146,2292,2293],{"class":1190},"\"cat .claude\u002Fproject-context.md\"\n",[1146,2295,2296],{"class":1148,"line":1205},[1146,2297,2298],{"class":1152},"      }]\n",[1146,2300,2301],{"class":1148,"line":1211},[1146,2302,1787],{"class":1152},[1146,2304,2305],{"class":1148,"line":1224},[1146,2306,1352],{"class":1152},[1146,2308,2309],{"class":1148,"line":1246},[1146,2310,1358],{"class":1152},[897,2312,2313],{},"hook 的 stdout 会作为系统消息注入到会话中，让 Agent 一开始就\"知道\"项目上下文。",[892,2315,2317],{"id":2316},"示例-5stop-事件发送通知","示例 5：Stop 事件发送通知",[1104,2319,2321],{"className":1140,"code":2320,"language":1142,"meta":11,"style":11},"{\n  \"hooks\": {\n    \"Stop\": [{\n      \"hooks\": [{\n        \"type\": \"command\",\n        \"command\": \"osascript -e 'display notification \\\"Agent 任务完成\\\" with title \\\"Claude\\\"'\"\n      }]\n    }]\n  }\n}\n",[943,2322,2323,2327,2333,2340,2346,2356,2385,2389,2393,2397],{"__ignoreMap":11},[1146,2324,2325],{"class":1148,"line":1149},[1146,2326,1153],{"class":1152},[1146,2328,2329,2331],{"class":1148,"line":1156},[1146,2330,1160],{"class":1159},[1146,2332,1163],{"class":1152},[1146,2334,2335,2338],{"class":1148,"line":1166},[1146,2336,2337],{"class":1159},"    \"Stop\"",[1146,2339,1743],{"class":1152},[1146,2341,2342,2344],{"class":1148,"line":1175},[1146,2343,1759],{"class":1159},[1146,2345,1743],{"class":1152},[1146,2347,2348,2350,2352,2354],{"class":1148,"line":1181},[1146,2349,2277],{"class":1159},[1146,2351,1187],{"class":1152},[1146,2353,1219],{"class":1190},[1146,2355,1194],{"class":1152},[1146,2357,2358,2360,2362,2365,2367,2370,2372,2375,2377,2380,2382],{"class":1148,"line":1197},[1146,2359,2288],{"class":1159},[1146,2361,1187],{"class":1152},[1146,2363,2364],{"class":1190},"\"osascript -e 'display notification ",[1146,2366,1235],{"class":1159},[1146,2368,2369],{"class":1190},"Agent 任务完成",[1146,2371,1235],{"class":1159},[1146,2373,2374],{"class":1190}," with title ",[1146,2376,1235],{"class":1159},[1146,2378,2379],{"class":1190},"Claude",[1146,2381,1235],{"class":1159},[1146,2383,2384],{"class":1190},"'\"\n",[1146,2386,2387],{"class":1148,"line":1205},[1146,2388,2298],{"class":1152},[1146,2390,2391],{"class":1148,"line":1211},[1146,2392,1787],{"class":1152},[1146,2394,2395],{"class":1148,"line":1224},[1146,2396,1352],{"class":1152},[1146,2398,2399],{"class":1148,"line":1246},[1146,2400,1358],{"class":1152},[897,2402,2403],{},"长跑任务结束后桌面弹窗提醒。",[892,2405,2407],{"id":2406},"hooks-vs-其他机制对比","Hooks vs 其他机制对比",[990,2409,2410,2425],{},[993,2411,2412],{},[996,2413,2414,2417,2420,2423],{},[999,2415,2416],{},"机制",[999,2418,2419],{},"谁执行",[999,2421,2422],{},"确定性",[999,2424,1007],{},[1009,2426,2427,2443,2458,2472],{},[996,2428,2429,2434,2437,2440],{},[1014,2430,2431],{},[900,2432,2433],{},"提示词指令",[1014,2435,2436],{},"模型",[1014,2438,2439],{},"低",[1014,2441,2442],{},"柔性引导",[996,2444,2445,2450,2452,2455],{},[1014,2446,2447],{},[900,2448,2449],{},"Tools",[1014,2451,2436],{},[1014,2453,2454],{},"中",[1014,2456,2457],{},"提供能力",[996,2459,2460,2465,2467,2469],{},[1014,2461,2462],{},[900,2463,2464],{},"Skills",[1014,2466,2436],{},[1014,2468,2454],{},[1014,2470,2471],{},"提供方法论",[996,2473,2474,2478,2481,2484],{},[1014,2475,2476],{},[900,2477,902],{},[1014,2479,2480],{},"Harness",[1014,2482,2483],{},"高",[1014,2485,2486],{},"强制规则",[897,2488,2489,2490,930],{},"一句话总结：",[900,2491,2492],{},"想\"告诉\" Agent 做什么 → Skills；想\"强迫\" Agent 必须这样 → Hooks",[892,2494,2495],{"id":2495},"设计原则",[2497,2498,2500],"h3",{"id":2499},"原则-1幂等","原则 1：幂等",[897,2502,2503],{},"Hook 可能被重复触发（重试场景）。确保多次执行不会出问题：",[1104,2505,2507],{"className":1473,"code":2506,"language":1475,"meta":11,"style":11},"# ❌ 追加日志\necho \"$msg\" >> log.txt\n\n# ✅ 幂等：只记录新事件\nif ! grep -q \"$event_id\" log.txt; then\n  echo \"$msg\" >> log.txt\nfi\n",[943,2508,2509,2514,2531,2535,2540,2564,2579],{"__ignoreMap":11},[1146,2510,2511],{"class":1148,"line":1149},[1146,2512,2513],{"class":1482},"# ❌ 追加日志\n",[1146,2515,2516,2518,2520,2523,2525,2528],{"class":1148,"line":1156},[1146,2517,1530],{"class":1159},[1146,2519,1533],{"class":1190},[1146,2521,2522],{"class":1152},"$msg",[1146,2524,1539],{"class":1190},[1146,2526,2527],{"class":1507}," >>",[1146,2529,2530],{"class":1190}," log.txt\n",[1146,2532,2533],{"class":1148,"line":1166},[1146,2534,1494],{"emptyLinePlaceholder":1493},[1146,2536,2537],{"class":1148,"line":1175},[1146,2538,2539],{"class":1482},"# ✅ 幂等：只记录新事件\n",[1146,2541,2542,2544,2546,2548,2550,2552,2555,2557,2560,2562],{"class":1148,"line":1181},[1146,2543,2168],{"class":1507},[1146,2545,2198],{"class":1507},[1146,2547,1654],{"class":1514},[1146,2549,2184],{"class":1159},[1146,2551,1533],{"class":1190},[1146,2553,2554],{"class":1152},"$event_id",[1146,2556,1539],{"class":1190},[1146,2558,2559],{"class":1190}," log.txt",[1146,2561,1631],{"class":1152},[1146,2563,1669],{"class":1507},[1146,2565,2566,2569,2571,2573,2575,2577],{"class":1148,"line":1197},[1146,2567,2568],{"class":1159},"  echo",[1146,2570,1533],{"class":1190},[1146,2572,2522],{"class":1152},[1146,2574,1539],{"class":1190},[1146,2576,2527],{"class":1507},[1146,2578,2530],{"class":1190},[1146,2580,2581],{"class":1148,"line":1205},[1146,2582,2234],{"class":1507},[2497,2584,2586],{"id":2585},"原则-2快速","原则 2：快速",[897,2588,2589],{},"Hooks 会被频繁触发，耗时过长会拖慢整个 Agent。目标：",[905,2591,2592,2595],{},[908,2593,2594],{},"99 分位 \u003C 500ms",[908,2596,2597],{},"不要在 hook 里跑大模型推理 \u002F 长 IO",[897,2599,2600],{},"需要慢操作时，异步化：",[1104,2602,2604],{"className":1473,"code":2603,"language":1475,"meta":11,"style":11},"# 后台执行，不阻塞 hook\n(slow-command &)\nexit 0\n",[943,2605,2606,2611,2622],{"__ignoreMap":11},[1146,2607,2608],{"class":1148,"line":1149},[1146,2609,2610],{"class":1482},"# 后台执行，不阻塞 hook\n",[1146,2612,2613,2616,2619],{"class":1148,"line":1156},[1146,2614,2615],{"class":1152},"(",[1146,2617,2618],{"class":1514},"slow-command",[1146,2620,2621],{"class":1152}," &)\n",[1146,2623,2624,2626],{"class":1148,"line":1166},[1146,2625,1711],{"class":1159},[1146,2627,1714],{"class":1159},[2497,2629,2631],{"id":2630},"原则-3失败要降级","原则 3：失败要降级",[897,2633,2634],{},"Hook 本身可能出错。选择合适的失败策略：",[905,2636,2637,2643],{},[908,2638,2639,2642],{},[900,2640,2641],{},"安全卫士","：失败 = 拒绝（默认）",[908,2644,2645,2648],{},[900,2646,2647],{},"格式化\u002F通知","：失败 = 忽略继续",[1104,2650,2652],{"className":1473,"code":2651,"language":1475,"meta":11,"style":11},"# 非关键 hook\nset +e\nprettier --write \"$file\" 2>\u002Fdev\u002Fnull || true\nexit 0\n",[943,2653,2654,2659,2667,2693],{"__ignoreMap":11},[1146,2655,2656],{"class":1148,"line":1149},[1146,2657,2658],{"class":1482},"# 非关键 hook\n",[1146,2660,2661,2664],{"class":1148,"line":1156},[1146,2662,2663],{"class":1159},"set",[1146,2665,2666],{"class":1190}," +e\n",[1146,2668,2669,2671,2674,2676,2679,2681,2684,2687,2690],{"class":1148,"line":1166},[1146,2670,949],{"class":1514},[1146,2672,2673],{"class":1159}," --write",[1146,2675,1533],{"class":1190},[1146,2677,2678],{"class":1152},"$file",[1146,2680,1539],{"class":1190},[1146,2682,2683],{"class":1507}," 2>",[1146,2685,2686],{"class":1190},"\u002Fdev\u002Fnull",[1146,2688,2689],{"class":1507}," ||",[1146,2691,2692],{"class":1159}," true\n",[1146,2694,2695,2697],{"class":1148,"line":1175},[1146,2696,1711],{"class":1159},[1146,2698,1714],{"class":1159},[2497,2700,2702],{"id":2701},"原则-4可观测","原则 4：可观测",[897,2704,2705],{},"记录 hook 的触发和结果，方便排查：",[1104,2707,2709],{"className":1473,"code":2708,"language":1475,"meta":11,"style":11},"log_file=\".claude\u002Fhooks\u002Fhook.log\"\necho \"$(date +%s) $EVENT $TOOL_NAME exit=$?\" >> \"$log_file\"\n",[943,2710,2711,2721],{"__ignoreMap":11},[1146,2712,2713,2716,2718],{"class":1148,"line":1149},[1146,2714,2715],{"class":1152},"log_file",[1146,2717,1508],{"class":1507},[1146,2719,2720],{"class":1190},"\".claude\u002Fhooks\u002Fhook.log\"\n",[1146,2722,2723,2725,2728,2731,2734,2737,2740,2743,2746,2748,2750,2752,2755],{"class":1148,"line":1156},[1146,2724,1530],{"class":1159},[1146,2726,2727],{"class":1190}," \"$(",[1146,2729,2730],{"class":1514},"date",[1146,2732,2733],{"class":1190}," +%s) ",[1146,2735,2736],{"class":1152},"$EVENT",[1146,2738,2739],{"class":1152}," $TOOL_NAME",[1146,2741,2742],{"class":1190}," exit=",[1146,2744,2745],{"class":1159},"$?",[1146,2747,1539],{"class":1190},[1146,2749,2527],{"class":1507},[1146,2751,1533],{"class":1190},[1146,2753,2754],{"class":1152},"$log_file",[1146,2756,1243],{"class":1190},[2497,2758,2760],{"id":2759},"原则-5别写业务逻辑","原则 5：别写业务逻辑",[897,2762,2763,2764,2767,2768,2771],{},"Hook 是",[900,2765,2766],{},"策略","，不是",[900,2769,2770],{},"业务","。业务逻辑应该在 skill \u002F tool \u002F subagent 里，hook 只负责\"是否允许\"和\"事后处理\"。",[892,2773,2774],{"id":2774},"调试技巧",[2497,2776,2778],{"id":2777},"看-harness-日志","看 harness 日志",[897,2780,2781,2782,2785],{},"Claude Code \u002F Agent SDK 都会把 hook 触发记录在日志里（通常在 ",[943,2783,2784],{},"~\u002F.claude\u002Flogs\u002F"," 或 stderr）。",[2497,2787,2789],{"id":2788},"单独测试-hook","单独测试 hook",[1104,2791,2793],{"className":1473,"code":2792,"language":1475,"meta":11,"style":11},"# 模拟 harness 调用\necho '{\"tool_name\":\"Bash\",\"tool_input\":{\"command\":\"rm -rf \u002F\"}}' | bash .claude\u002Fhooks\u002Fguard-bash.sh\necho \"exit: $?\"\n",[943,2794,2795,2800,2815],{"__ignoreMap":11},[1146,2796,2797],{"class":1148,"line":1149},[1146,2798,2799],{"class":1482},"# 模拟 harness 调用\n",[1146,2801,2802,2804,2807,2809,2812],{"class":1148,"line":1156},[1146,2803,1530],{"class":1159},[1146,2805,2806],{"class":1190}," '{\"tool_name\":\"Bash\",\"tool_input\":{\"command\":\"rm -rf \u002F\"}}'",[1146,2808,1542],{"class":1507},[1146,2810,2811],{"class":1514}," bash",[1146,2813,2814],{"class":1190}," .claude\u002Fhooks\u002Fguard-bash.sh\n",[1146,2816,2817,2819,2822,2824],{"class":1148,"line":1166},[1146,2818,1530],{"class":1159},[1146,2820,2821],{"class":1190}," \"exit: ",[1146,2823,2745],{"class":1159},[1146,2825,1243],{"class":1190},[2497,2827,2828],{"id":2828},"加详细日志",[897,2830,2831],{},"调试期在 hook 开头加：",[1104,2833,2835],{"className":1473,"code":2834,"language":1475,"meta":11,"style":11},"exec 2> >(tee -a \u002Ftmp\u002Fhook-debug.log >&2)\nset -x\n",[943,2836,2837,2861],{"__ignoreMap":11},[1146,2838,2839,2842,2844,2847,2850,2853,2856,2859],{"class":1148,"line":1149},[1146,2840,2841],{"class":1159},"exec",[1146,2843,2683],{"class":1507},[1146,2845,2846],{"class":1190}," >(",[1146,2848,2849],{"class":1514},"tee",[1146,2851,2852],{"class":1159}," -a",[1146,2854,2855],{"class":1190}," \u002Ftmp\u002Fhook-debug.log ",[1146,2857,2858],{"class":1507},">&2",[1146,2860,1518],{"class":1190},[1146,2862,2863,2865],{"class":1148,"line":1156},[1146,2864,2663],{"class":1159},[1146,2866,2867],{"class":1159}," -x\n",[897,2869,2870],{},"事后清理掉。",[892,2872,2873],{"id":2873},"安全注意事项",[897,2875,2876],{},"Hooks 是双刃剑，使用不当会带来风险：",[905,2878,2879,2886,2891,2896,2903],{},[908,2880,2881,2882,2885],{},"❌ ",[900,2883,2884],{},"不要","在 hook 里执行来自模型输出的命令（命令注入风险）",[908,2887,2881,2888,2890],{},[900,2889,2884],{},"把 hook 脚本放在可写目录但权限过宽",[908,2892,2881,2893,2895],{},[900,2894,2884],{},"让 hook 读写敏感数据后通过 stdout 反馈给模型",[908,2897,2898,2899,2902],{},"✅ ",[900,2900,2901],{},"要","对用户输入 \u002F 模型输入做严格转义",[908,2904,2898,2905,2907],{},[900,2906,2901],{},"把 hook 纳入 Code Review",[892,2909,2910],{"id":2910},"常见自动化模式",[990,2912,2913,2923],{},[993,2914,2915],{},[996,2916,2917,2920],{},[999,2918,2919],{},"模式",[999,2921,2922],{},"用途",[1009,2924,2925,2936,2947,2958,2968,2978,2988],{},[996,2926,2927,2933],{},[1014,2928,2929,2932],{},[943,2930,2931],{},"PreToolUse Bash"," + 黑名单",[1014,2934,2935],{},"命令白\u002F黑名单",[996,2937,2938,2944],{},[1014,2939,2940,2943],{},[943,2941,2942],{},"PostToolUse Edit"," + 格式化",[1014,2945,2946],{},"自动整洁代码",[996,2948,2949,2955],{},[1014,2950,2951,2954],{},[943,2952,2953],{},"PostToolUse Write"," + 类型检查",[1014,2956,2957],{},"写完就 tsc \u002F mypy",[996,2959,2960,2965],{},[1014,2961,2962,2964],{},[943,2963,1083],{}," + 通知",[1014,2966,2967],{},"长任务完成提醒",[996,2969,2970,2975],{},[1014,2971,2972,2974],{},[943,2973,1018],{}," + 上下文注入",[1014,2976,2977],{},"项目记忆",[996,2979,2980,2985],{},[1014,2981,2982,2984],{},[943,2983,1031],{}," + 转义",[1014,2986,2987],{},"防止 prompt 注入",[996,2989,2990,2995],{},[1014,2991,2992,2994],{},[943,2993,1096],{}," + 聚合",[1014,2996,2997],{},"多 agent 收尾",[892,2999,3000],{"id":3000},"小结",[897,3002,3003,3004,3007],{},"Hooks 是 Agent 时代的\"",[900,3005,3006],{},"基础设施级约束","\"：",[905,3009,3010,3016,3022,3028],{},[908,3011,3012,3015],{},[900,3013,3014],{},"Harness 执行","，确定性强",[908,3017,3018,3021],{},[900,3019,3020],{},"事件驱动","，生命周期完整",[908,3023,3024,3027],{},[900,3025,3026],{},"低侵入","，配置化声明",[908,3029,3030,3033],{},[900,3031,3032],{},"可组合","，与 Skills \u002F Tools \u002F MCP 正交",[897,3035,3036],{},"把\"必须发生的事\"写成 Hook，把\"该怎么做的事\"写成 Skill，把\"能执行的动作\"写成 Tool——这就是一个健壮 Agent 系统的分层方式。",[897,3038,3039,3040,3044],{},"下一章 ",[3041,3042,3043],"a",{"href":33},"Subagents"," 将介绍如何用子代理并行处理复杂任务。",[3046,3047,3048],"style",{},"html pre.shiki code .sCsY4, html code.shiki .sCsY4{--shiki-light:#6A737D;--shiki-default:#6A737D;--shiki-dark:#6A737D}html pre.shiki code .sxrX7, html code.shiki .sxrX7{--shiki-light:#24292E;--shiki-default:#24292E;--shiki-dark:#E1E4E8}html pre.shiki code .s8jYJ, html code.shiki .s8jYJ{--shiki-light:#D73A49;--shiki-default:#D73A49;--shiki-dark:#F97583}html pre.shiki code .snPdu, html code.shiki .snPdu{--shiki-light:#6F42C1;--shiki-default:#6F42C1;--shiki-dark:#B392F0}html pre.shiki code .sBjJW, html code.shiki .sBjJW{--shiki-light:#005CC5;--shiki-default:#005CC5;--shiki-dark:#79B8FF}html pre.shiki code .sIIMD, html code.shiki .sIIMD{--shiki-light:#032F62;--shiki-default:#032F62;--shiki-dark:#9ECBFF}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":11,"searchDepth":1156,"depth":1156,"links":3050},[3051,3052,3053,3054,3055,3056,3057,3058,3059,3060,3061,3062,3069,3074,3075,3076],{"id":894,"depth":1156,"text":895},{"id":937,"depth":1156,"text":938},{"id":985,"depth":1156,"text":985},{"id":1115,"depth":1156,"text":1115},{"id":1396,"depth":1156,"text":1396},{"id":1459,"depth":1156,"text":1460},{"id":1801,"depth":1156,"text":1802},{"id":2021,"depth":1156,"text":2022},{"id":2243,"depth":1156,"text":2244},{"id":2316,"depth":1156,"text":2317},{"id":2406,"depth":1156,"text":2407},{"id":2495,"depth":1156,"text":2495,"children":3063},[3064,3065,3066,3067,3068],{"id":2499,"depth":1166,"text":2500},{"id":2585,"depth":1166,"text":2586},{"id":2630,"depth":1166,"text":2631},{"id":2701,"depth":1166,"text":2702},{"id":2759,"depth":1166,"text":2760},{"id":2774,"depth":1156,"text":2774,"children":3070},[3071,3072,3073],{"id":2777,"depth":1166,"text":2778},{"id":2788,"depth":1166,"text":2789},{"id":2828,"depth":1166,"text":2828},{"id":2873,"depth":1156,"text":2873},{"id":2910,"depth":1156,"text":2910},{"id":3000,"depth":1156,"text":3000},"md",{},{"title":18,"description":19},"ai\u002Fagent\u002Fhooks","ABFs7rsgznXHJJ8HdFSEEXuq5q51xlYeGKmd_087iHk",1775474635879]