[{"data":1,"prerenderedAt":3192},["ShallowReactive",2],{"search-docs":3,"doc-\u002Fai\u002Fagent\u002Fsdk":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":30,"body":888,"description":31,"extension":3187,"meta":3188,"navigation":1060,"path":29,"seo":3189,"stem":3190,"__hash__":3191},"docs\u002Fai\u002Fagent\u002Fsdk.md",{"type":889,"value":890,"toc":3163},"minimark",[891,896,904,928,932,936,1020,1023,1079,1082,1103,1106,1275,1278,1293,1296,1305,1310,1313,1319,1330,1334,1637,1640,1643,1898,1901,1927,1930,1935,2030,2033,2184,2187,2190,2333,2336,2347,2350,2353,2397,2400,2515,2518,2522,2525,2631,2634,2637,2641,2748,2751,2755,2785,2789,2851,2854,2858,2939,2945,2948,3023,3027,3108,3115,3118,3121,3151,3159],[892,893,895],"h2",{"id":894},"什么是-agent-sdk","什么是 Agent SDK",[897,898,899,903],"p",{},[900,901,902],"strong",{},"Claude Agent SDK"," 是 Anthropic 官方提供的一套用来构建\"像 Claude Code 一样\"的 Agent 程序库。它把 Claude Code 内部的 Agent 循环、工具调度、权限控制、上下文管理等核心能力抽成可编程的 API，让你可以：",[905,906,907,915,922,925],"ul",{},[908,909,910,911,914],"li",{},"构建面向特定领域的",[900,912,913],{},"专业 Agent","（代码审查 \u002F 数据分析 \u002F 客服）",[908,916,917,918,921],{},"在应用内嵌入",[900,919,920],{},"Agent 能力","（CLI \u002F Web \u002F Desktop）",[908,923,924],{},"通过程序化方式批量运行 Agent 任务",[908,926,927],{},"与现有后端集成（CI、任务调度、工作流引擎）",[929,930,931],"note",{},"\nAgent SDK 目前有 TypeScript 和 Python 两个官方实现，API 基本对齐。下文以 TypeScript 为主，Python 会标注差异。\n",[892,933,935],{"id":934},"能做什么-vs-不能做什么","能做什么 vs 不能做什么",[937,938,939,952],"table",{},[940,941,942],"thead",{},[943,944,945,949],"tr",{},[946,947,948],"th",{},"能力",[946,950,951],{},"说明",[953,954,955,964,972,980,988,996,1004,1012],"tbody",{},[943,956,957,961],{},[958,959,960],"td",{},"✅ 调用 Claude 模型（含工具使用）",[958,962,963],{},"自动管理 tools 循环",[943,965,966,969],{},[958,967,968],{},"✅ 接入 MCP servers",[958,970,971],{},"配置即接入，无需手写协议",[943,973,974,977],{},[958,975,976],{},"✅ 使用 Skills",[958,978,979],{},"自动发现并按需加载",[943,981,982,985],{},[958,983,984],{},"✅ Subagents 分发子任务",[958,986,987],{},"原生并发",[943,989,990,993],{},[958,991,992],{},"✅ Hooks 拦截事件",[958,994,995],{},"生命周期钩子",[943,997,998,1001],{},[958,999,1000],{},"✅ 自定义工具",[958,1002,1003],{},"用本地函数扩展能力",[943,1005,1006,1009],{},[958,1007,1008],{},"❌ 训练 \u002F 微调模型",[958,1010,1011],{},"这是 API 层的事",[943,1013,1014,1017],{},[958,1015,1016],{},"❌ 替代 HTTP 直连",[958,1018,1019],{},"SDK 是 Agent 循环，不是 HTTP 客户端",[892,1021,1022],{"id":1022},"安装",[1024,1025,1029],"pre",{"className":1026,"code":1027,"language":1028,"meta":11,"style":11},"language-bash shiki shiki-themes github-light github-light github-dark","# TypeScript \u002F Node.js\nnpm install @anthropic-ai\u002Fclaude-agent-sdk\n\n# Python\npip install claude-agent-sdk\n","bash",[1030,1031,1032,1041,1055,1062,1068],"code",{"__ignoreMap":11},[1033,1034,1037],"span",{"class":1035,"line":1036},"line",1,[1033,1038,1040],{"class":1039},"sCsY4","# TypeScript \u002F Node.js\n",[1033,1042,1044,1048,1052],{"class":1035,"line":1043},2,[1033,1045,1047],{"class":1046},"snPdu","npm",[1033,1049,1051],{"class":1050},"sIIMD"," install",[1033,1053,1054],{"class":1050}," @anthropic-ai\u002Fclaude-agent-sdk\n",[1033,1056,1058],{"class":1035,"line":1057},3,[1033,1059,1061],{"emptyLinePlaceholder":1060},true,"\n",[1033,1063,1065],{"class":1035,"line":1064},4,[1033,1066,1067],{"class":1039},"# Python\n",[1033,1069,1071,1074,1076],{"class":1035,"line":1070},5,[1033,1072,1073],{"class":1046},"pip",[1033,1075,1051],{"class":1050},[1033,1077,1078],{"class":1050}," claude-agent-sdk\n",[897,1080,1081],{},"环境变量：",[1024,1083,1085],{"className":1026,"code":1084,"language":1028,"meta":11,"style":11},"export ANTHROPIC_API_KEY=sk-ant-...\n",[1030,1086,1087],{"__ignoreMap":11},[1033,1088,1089,1093,1097,1100],{"class":1035,"line":1036},[1033,1090,1092],{"class":1091},"s8jYJ","export",[1033,1094,1096],{"class":1095},"sxrX7"," ANTHROPIC_API_KEY",[1033,1098,1099],{"class":1091},"=",[1033,1101,1102],{"class":1095},"sk-ant-...\n",[892,1104,1105],{"id":1105},"最小示例",[1024,1107,1111],{"className":1108,"code":1109,"language":1110,"meta":11,"style":11},"language-ts shiki shiki-themes github-light github-light github-dark","import { query } from \"@anthropic-ai\u002Fclaude-agent-sdk\"\n\nconst result = query({\n  prompt: \"统计当前目录下有多少个 .ts 文件，并列出前 5 个最大的\",\n  options: {\n    model: \"claude-sonnet-4-5\",\n    allowedTools: [\"Bash\", \"Read\"],\n  },\n})\n\nfor await (const message of result) {\n  if (message.type === \"assistant\") {\n    console.log(message.text)\n  }\n}\n","ts",[1030,1112,1113,1127,1131,1149,1160,1165,1176,1194,1200,1206,1211,1234,1252,1263,1269],{"__ignoreMap":11},[1033,1114,1115,1118,1121,1124],{"class":1035,"line":1036},[1033,1116,1117],{"class":1091},"import",[1033,1119,1120],{"class":1095}," { query } ",[1033,1122,1123],{"class":1091},"from",[1033,1125,1126],{"class":1050}," \"@anthropic-ai\u002Fclaude-agent-sdk\"\n",[1033,1128,1129],{"class":1035,"line":1043},[1033,1130,1061],{"emptyLinePlaceholder":1060},[1033,1132,1133,1136,1140,1143,1146],{"class":1035,"line":1057},[1033,1134,1135],{"class":1091},"const",[1033,1137,1139],{"class":1138},"sBjJW"," result",[1033,1141,1142],{"class":1091}," =",[1033,1144,1145],{"class":1046}," query",[1033,1147,1148],{"class":1095},"({\n",[1033,1150,1151,1154,1157],{"class":1035,"line":1064},[1033,1152,1153],{"class":1095},"  prompt: ",[1033,1155,1156],{"class":1050},"\"统计当前目录下有多少个 .ts 文件，并列出前 5 个最大的\"",[1033,1158,1159],{"class":1095},",\n",[1033,1161,1162],{"class":1035,"line":1070},[1033,1163,1164],{"class":1095},"  options: {\n",[1033,1166,1168,1171,1174],{"class":1035,"line":1167},6,[1033,1169,1170],{"class":1095},"    model: ",[1033,1172,1173],{"class":1050},"\"claude-sonnet-4-5\"",[1033,1175,1159],{"class":1095},[1033,1177,1179,1182,1185,1188,1191],{"class":1035,"line":1178},7,[1033,1180,1181],{"class":1095},"    allowedTools: [",[1033,1183,1184],{"class":1050},"\"Bash\"",[1033,1186,1187],{"class":1095},", ",[1033,1189,1190],{"class":1050},"\"Read\"",[1033,1192,1193],{"class":1095},"],\n",[1033,1195,1197],{"class":1035,"line":1196},8,[1033,1198,1199],{"class":1095},"  },\n",[1033,1201,1203],{"class":1035,"line":1202},9,[1033,1204,1205],{"class":1095},"})\n",[1033,1207,1209],{"class":1035,"line":1208},10,[1033,1210,1061],{"emptyLinePlaceholder":1060},[1033,1212,1214,1217,1220,1223,1225,1228,1231],{"class":1035,"line":1213},11,[1033,1215,1216],{"class":1091},"for",[1033,1218,1219],{"class":1091}," await",[1033,1221,1222],{"class":1095}," (",[1033,1224,1135],{"class":1091},[1033,1226,1227],{"class":1138}," message",[1033,1229,1230],{"class":1091}," of",[1033,1232,1233],{"class":1095}," result) {\n",[1033,1235,1237,1240,1243,1246,1249],{"class":1035,"line":1236},12,[1033,1238,1239],{"class":1091},"  if",[1033,1241,1242],{"class":1095}," (message.type ",[1033,1244,1245],{"class":1091},"===",[1033,1247,1248],{"class":1050}," \"assistant\"",[1033,1250,1251],{"class":1095},") {\n",[1033,1253,1255,1258,1260],{"class":1035,"line":1254},13,[1033,1256,1257],{"class":1095},"    console.",[1033,1259,260],{"class":1046},[1033,1261,1262],{"class":1095},"(message.text)\n",[1033,1264,1266],{"class":1035,"line":1265},14,[1033,1267,1268],{"class":1095},"  }\n",[1033,1270,1272],{"class":1035,"line":1271},15,[1033,1273,1274],{"class":1095},"}\n",[897,1276,1277],{},"只用几行代码，SDK 就帮你完成：",[1279,1280,1281,1284,1287,1290],"ol",{},[908,1282,1283],{},"建立与 Claude 的对话",[908,1285,1286],{},"注入默认工具（Bash \u002F Read 等）",[908,1288,1289],{},"驱动 tool-use 循环直到任务完成",[908,1291,1292],{},"以流式方式返回消息",[892,1294,1295],{"id":1295},"核心概念",[1024,1297,1303],{"className":1298,"code":1300,"language":1301,"meta":1302},[1299],"language-text","flowchart TD\n    App[\"你的应用\"]\n    subgraph SDK[\"Claude Agent SDK\"]\n        Q[\"query\u002FrunAgent\u003Cbr\u002F>入口\"]\n        Loop[\"Agent Loop\u003Cbr\u002F>（工具循环）\"]\n        Tools[\"Tools\u003Cbr\u002F>内置 + 自定义\"]\n        MCP[\"MCP Clients\"]\n        Skills[\"Skills 加载器\"]\n        Hooks[\"Hooks 系统\"]\n        Ctx[\"Context \u002F Memory\"]\n    end\n    Claude[\"Claude API\"]\n    App --> Q\n    Q --> Loop\n    Loop \u003C--> Claude\n    Loop --> Tools\n    Loop --> MCP\n    Loop --> Skills\n    Loop --> Hooks\n    Loop --> Ctx\n","text","mermaid",[1030,1304,1300],{"__ignoreMap":11},[1306,1307,1309],"h3",{"id":1308},"agent-loop","Agent Loop",[897,1311,1312],{},"SDK 内部的核心循环：",[1024,1314,1317],{"className":1315,"code":1316,"language":1301,"meta":1302},[1299],"sequenceDiagram\n    participant App\n    participant SDK\n    participant LLM\n    participant Tool\n    App->>SDK: query(prompt, options)\n    loop 直到任务完成\n        SDK->>LLM: messages + tools\n        LLM-->>SDK: assistant message (可能含 tool_use)\n        alt 有 tool_use\n            SDK->>Tool: 调用工具\n            Tool-->>SDK: 结果\n            SDK->>SDK: append tool_result\n        else 只有 text\n            SDK->>App: yield 最终消息\n        end\n    end\n",[1030,1318,1316],{"__ignoreMap":11},[897,1320,1321,1322,1325,1326,1329],{},"你不需要自己写循环——",[1030,1323,1324],{},"query()"," 是个异步迭代器，直接 ",[1030,1327,1328],{},"for await"," 就能拿到流式输出。",[892,1331,1333],{"id":1332},"options-全景","Options 全景",[1024,1335,1337],{"className":1108,"code":1336,"language":1110,"meta":11,"style":11},"const options: AgentOptions = {\n  \u002F\u002F 模型选择\n  model: \"claude-sonnet-4-5\",\n  maxTokens: 8192,\n\n  \u002F\u002F 工具控制\n  allowedTools: [\"Bash\", \"Read\", \"Write\", \"Grep\"],\n  disallowedTools: [\"WebFetch\"],\n\n  \u002F\u002F System Prompt\n  systemPrompt: \"你是一个严谨的 TypeScript 代码审查员。\",\n  appendSystemPrompt: \"输出使用中文。\",\n\n  \u002F\u002F 工作目录与权限\n  cwd: \"\u002Fpath\u002Fto\u002Fproject\",\n  permissionMode: \"default\", \u002F\u002F \"default\" | \"acceptEdits\" | \"bypassPermissions\"\n\n  \u002F\u002F MCP 集成\n  mcpServers: {\n    github: {\n      command: \"npx\",\n      args: [\"-y\", \"@modelcontextprotocol\u002Fserver-github\"],\n      env: { GITHUB_TOKEN: process.env.GH_TOKEN },\n    },\n  },\n\n  \u002F\u002F Hooks\n  hooks: {\n    PreToolUse: [{ matcher: \"Bash\", handler: myBashGuard }],\n  },\n\n  \u002F\u002F 会话\n  resume: \"session-id-xxx\",   \u002F\u002F 继续已有会话\n  maxTurns: 20,               \u002F\u002F 最大对话轮数\n}\n",[1030,1338,1339,1357,1362,1371,1381,1385,1390,1413,1423,1427,1432,1442,1452,1456,1461,1471,1485,1490,1496,1502,1508,1519,1535,1547,1553,1558,1563,1569,1575,1586,1591,1596,1602,1617,1632],{"__ignoreMap":11},[1033,1340,1341,1343,1346,1349,1352,1354],{"class":1035,"line":1036},[1033,1342,1135],{"class":1091},[1033,1344,1345],{"class":1138}," options",[1033,1347,1348],{"class":1091},":",[1033,1350,1351],{"class":1046}," AgentOptions",[1033,1353,1142],{"class":1091},[1033,1355,1356],{"class":1095}," {\n",[1033,1358,1359],{"class":1035,"line":1043},[1033,1360,1361],{"class":1039},"  \u002F\u002F 模型选择\n",[1033,1363,1364,1367,1369],{"class":1035,"line":1057},[1033,1365,1366],{"class":1095},"  model: ",[1033,1368,1173],{"class":1050},[1033,1370,1159],{"class":1095},[1033,1372,1373,1376,1379],{"class":1035,"line":1064},[1033,1374,1375],{"class":1095},"  maxTokens: ",[1033,1377,1378],{"class":1138},"8192",[1033,1380,1159],{"class":1095},[1033,1382,1383],{"class":1035,"line":1070},[1033,1384,1061],{"emptyLinePlaceholder":1060},[1033,1386,1387],{"class":1035,"line":1167},[1033,1388,1389],{"class":1039},"  \u002F\u002F 工具控制\n",[1033,1391,1392,1395,1397,1399,1401,1403,1406,1408,1411],{"class":1035,"line":1178},[1033,1393,1394],{"class":1095},"  allowedTools: [",[1033,1396,1184],{"class":1050},[1033,1398,1187],{"class":1095},[1033,1400,1190],{"class":1050},[1033,1402,1187],{"class":1095},[1033,1404,1405],{"class":1050},"\"Write\"",[1033,1407,1187],{"class":1095},[1033,1409,1410],{"class":1050},"\"Grep\"",[1033,1412,1193],{"class":1095},[1033,1414,1415,1418,1421],{"class":1035,"line":1196},[1033,1416,1417],{"class":1095},"  disallowedTools: [",[1033,1419,1420],{"class":1050},"\"WebFetch\"",[1033,1422,1193],{"class":1095},[1033,1424,1425],{"class":1035,"line":1202},[1033,1426,1061],{"emptyLinePlaceholder":1060},[1033,1428,1429],{"class":1035,"line":1208},[1033,1430,1431],{"class":1039},"  \u002F\u002F System Prompt\n",[1033,1433,1434,1437,1440],{"class":1035,"line":1213},[1033,1435,1436],{"class":1095},"  systemPrompt: ",[1033,1438,1439],{"class":1050},"\"你是一个严谨的 TypeScript 代码审查员。\"",[1033,1441,1159],{"class":1095},[1033,1443,1444,1447,1450],{"class":1035,"line":1236},[1033,1445,1446],{"class":1095},"  appendSystemPrompt: ",[1033,1448,1449],{"class":1050},"\"输出使用中文。\"",[1033,1451,1159],{"class":1095},[1033,1453,1454],{"class":1035,"line":1254},[1033,1455,1061],{"emptyLinePlaceholder":1060},[1033,1457,1458],{"class":1035,"line":1265},[1033,1459,1460],{"class":1039},"  \u002F\u002F 工作目录与权限\n",[1033,1462,1463,1466,1469],{"class":1035,"line":1271},[1033,1464,1465],{"class":1095},"  cwd: ",[1033,1467,1468],{"class":1050},"\"\u002Fpath\u002Fto\u002Fproject\"",[1033,1470,1159],{"class":1095},[1033,1472,1474,1477,1480,1482],{"class":1035,"line":1473},16,[1033,1475,1476],{"class":1095},"  permissionMode: ",[1033,1478,1479],{"class":1050},"\"default\"",[1033,1481,1187],{"class":1095},[1033,1483,1484],{"class":1039},"\u002F\u002F \"default\" | \"acceptEdits\" | \"bypassPermissions\"\n",[1033,1486,1488],{"class":1035,"line":1487},17,[1033,1489,1061],{"emptyLinePlaceholder":1060},[1033,1491,1493],{"class":1035,"line":1492},18,[1033,1494,1495],{"class":1039},"  \u002F\u002F MCP 集成\n",[1033,1497,1499],{"class":1035,"line":1498},19,[1033,1500,1501],{"class":1095},"  mcpServers: {\n",[1033,1503,1505],{"class":1035,"line":1504},20,[1033,1506,1507],{"class":1095},"    github: {\n",[1033,1509,1511,1514,1517],{"class":1035,"line":1510},21,[1033,1512,1513],{"class":1095},"      command: ",[1033,1515,1516],{"class":1050},"\"npx\"",[1033,1518,1159],{"class":1095},[1033,1520,1522,1525,1528,1530,1533],{"class":1035,"line":1521},22,[1033,1523,1524],{"class":1095},"      args: [",[1033,1526,1527],{"class":1050},"\"-y\"",[1033,1529,1187],{"class":1095},[1033,1531,1532],{"class":1050},"\"@modelcontextprotocol\u002Fserver-github\"",[1033,1534,1193],{"class":1095},[1033,1536,1538,1541,1544],{"class":1035,"line":1537},23,[1033,1539,1540],{"class":1095},"      env: { GITHUB_TOKEN: process.env.",[1033,1542,1543],{"class":1138},"GH_TOKEN",[1033,1545,1546],{"class":1095}," },\n",[1033,1548,1550],{"class":1035,"line":1549},24,[1033,1551,1552],{"class":1095},"    },\n",[1033,1554,1556],{"class":1035,"line":1555},25,[1033,1557,1199],{"class":1095},[1033,1559,1561],{"class":1035,"line":1560},26,[1033,1562,1061],{"emptyLinePlaceholder":1060},[1033,1564,1566],{"class":1035,"line":1565},27,[1033,1567,1568],{"class":1039},"  \u002F\u002F Hooks\n",[1033,1570,1572],{"class":1035,"line":1571},28,[1033,1573,1574],{"class":1095},"  hooks: {\n",[1033,1576,1578,1581,1583],{"class":1035,"line":1577},29,[1033,1579,1580],{"class":1095},"    PreToolUse: [{ matcher: ",[1033,1582,1184],{"class":1050},[1033,1584,1585],{"class":1095},", handler: myBashGuard }],\n",[1033,1587,1589],{"class":1035,"line":1588},30,[1033,1590,1199],{"class":1095},[1033,1592,1594],{"class":1035,"line":1593},31,[1033,1595,1061],{"emptyLinePlaceholder":1060},[1033,1597,1599],{"class":1035,"line":1598},32,[1033,1600,1601],{"class":1039},"  \u002F\u002F 会话\n",[1033,1603,1605,1608,1611,1614],{"class":1035,"line":1604},33,[1033,1606,1607],{"class":1095},"  resume: ",[1033,1609,1610],{"class":1050},"\"session-id-xxx\"",[1033,1612,1613],{"class":1095},",   ",[1033,1615,1616],{"class":1039},"\u002F\u002F 继续已有会话\n",[1033,1618,1620,1623,1626,1629],{"class":1035,"line":1619},34,[1033,1621,1622],{"class":1095},"  maxTurns: ",[1033,1624,1625],{"class":1138},"20",[1033,1627,1628],{"class":1095},",               ",[1033,1630,1631],{"class":1039},"\u002F\u002F 最大对话轮数\n",[1033,1633,1635],{"class":1035,"line":1634},35,[1033,1636,1274],{"class":1095},[892,1638,1639],{"id":1639},"自定义工具",[897,1641,1642],{},"除了 SDK 内置工具，你可以注入本地函数：",[1024,1644,1646],{"className":1108,"code":1645,"language":1110,"meta":11,"style":11},"import { query, tool } from \"@anthropic-ai\u002Fclaude-agent-sdk\"\nimport { z } from \"zod\"\n\nconst getWeather = tool({\n  name: \"get_weather\",\n  description: \"Get current weather for a city\",\n  inputSchema: z.object({\n    city: z.string().describe(\"City name in English\"),\n  }),\n  async execute({ city }) {\n    const res = await fetch(`https:\u002F\u002Fapi.weather.com\u002F${city}`)\n    const data = await res.json()\n    return `The weather in ${city} is ${data.temp}°C, ${data.condition}`\n  },\n})\n\nconst result = query({\n  prompt: \"北京现在天气怎么样？\",\n  options: {\n    tools: [getWeather],\n  },\n})\n",[1030,1647,1648,1659,1671,1675,1689,1699,1709,1719,1742,1747,1765,1793,1813,1848,1852,1856,1860,1872,1881,1885,1890,1894],{"__ignoreMap":11},[1033,1649,1650,1652,1655,1657],{"class":1035,"line":1036},[1033,1651,1117],{"class":1091},[1033,1653,1654],{"class":1095}," { query, tool } ",[1033,1656,1123],{"class":1091},[1033,1658,1126],{"class":1050},[1033,1660,1661,1663,1666,1668],{"class":1035,"line":1043},[1033,1662,1117],{"class":1091},[1033,1664,1665],{"class":1095}," { z } ",[1033,1667,1123],{"class":1091},[1033,1669,1670],{"class":1050}," \"zod\"\n",[1033,1672,1673],{"class":1035,"line":1057},[1033,1674,1061],{"emptyLinePlaceholder":1060},[1033,1676,1677,1679,1682,1684,1687],{"class":1035,"line":1064},[1033,1678,1135],{"class":1091},[1033,1680,1681],{"class":1138}," getWeather",[1033,1683,1142],{"class":1091},[1033,1685,1686],{"class":1046}," tool",[1033,1688,1148],{"class":1095},[1033,1690,1691,1694,1697],{"class":1035,"line":1070},[1033,1692,1693],{"class":1095},"  name: ",[1033,1695,1696],{"class":1050},"\"get_weather\"",[1033,1698,1159],{"class":1095},[1033,1700,1701,1704,1707],{"class":1035,"line":1167},[1033,1702,1703],{"class":1095},"  description: ",[1033,1705,1706],{"class":1050},"\"Get current weather for a city\"",[1033,1708,1159],{"class":1095},[1033,1710,1711,1714,1717],{"class":1035,"line":1178},[1033,1712,1713],{"class":1095},"  inputSchema: z.",[1033,1715,1716],{"class":1046},"object",[1033,1718,1148],{"class":1095},[1033,1720,1721,1724,1727,1730,1733,1736,1739],{"class":1035,"line":1196},[1033,1722,1723],{"class":1095},"    city: z.",[1033,1725,1726],{"class":1046},"string",[1033,1728,1729],{"class":1095},"().",[1033,1731,1732],{"class":1046},"describe",[1033,1734,1735],{"class":1095},"(",[1033,1737,1738],{"class":1050},"\"City name in English\"",[1033,1740,1741],{"class":1095},"),\n",[1033,1743,1744],{"class":1035,"line":1202},[1033,1745,1746],{"class":1095},"  }),\n",[1033,1748,1749,1752,1755,1758,1762],{"class":1035,"line":1208},[1033,1750,1751],{"class":1091},"  async",[1033,1753,1754],{"class":1046}," execute",[1033,1756,1757],{"class":1095},"({ ",[1033,1759,1761],{"class":1760},"sP4rz","city",[1033,1763,1764],{"class":1095}," }) {\n",[1033,1766,1767,1770,1773,1775,1777,1780,1782,1785,1787,1790],{"class":1035,"line":1213},[1033,1768,1769],{"class":1091},"    const",[1033,1771,1772],{"class":1138}," res",[1033,1774,1142],{"class":1091},[1033,1776,1219],{"class":1091},[1033,1778,1779],{"class":1046}," fetch",[1033,1781,1735],{"class":1095},[1033,1783,1784],{"class":1050},"`https:\u002F\u002Fapi.weather.com\u002F${",[1033,1786,1761],{"class":1095},[1033,1788,1789],{"class":1050},"}`",[1033,1791,1792],{"class":1095},")\n",[1033,1794,1795,1797,1800,1802,1804,1807,1810],{"class":1035,"line":1236},[1033,1796,1769],{"class":1091},[1033,1798,1799],{"class":1138}," data",[1033,1801,1142],{"class":1091},[1033,1803,1219],{"class":1091},[1033,1805,1806],{"class":1095}," res.",[1033,1808,1809],{"class":1046},"json",[1033,1811,1812],{"class":1095},"()\n",[1033,1814,1815,1818,1821,1823,1826,1829,1832,1835,1838,1840,1842,1845],{"class":1035,"line":1254},[1033,1816,1817],{"class":1091},"    return",[1033,1819,1820],{"class":1050}," `The weather in ${",[1033,1822,1761],{"class":1095},[1033,1824,1825],{"class":1050},"} is ${",[1033,1827,1828],{"class":1095},"data",[1033,1830,1831],{"class":1050},".",[1033,1833,1834],{"class":1095},"temp",[1033,1836,1837],{"class":1050},"}°C, ${",[1033,1839,1828],{"class":1095},[1033,1841,1831],{"class":1050},[1033,1843,1844],{"class":1095},"condition",[1033,1846,1847],{"class":1050},"}`\n",[1033,1849,1850],{"class":1035,"line":1265},[1033,1851,1199],{"class":1095},[1033,1853,1854],{"class":1035,"line":1271},[1033,1855,1205],{"class":1095},[1033,1857,1858],{"class":1035,"line":1473},[1033,1859,1061],{"emptyLinePlaceholder":1060},[1033,1861,1862,1864,1866,1868,1870],{"class":1035,"line":1487},[1033,1863,1135],{"class":1091},[1033,1865,1139],{"class":1138},[1033,1867,1142],{"class":1091},[1033,1869,1145],{"class":1046},[1033,1871,1148],{"class":1095},[1033,1873,1874,1876,1879],{"class":1035,"line":1492},[1033,1875,1153],{"class":1095},[1033,1877,1878],{"class":1050},"\"北京现在天气怎么样？\"",[1033,1880,1159],{"class":1095},[1033,1882,1883],{"class":1035,"line":1498},[1033,1884,1164],{"class":1095},[1033,1886,1887],{"class":1035,"line":1504},[1033,1888,1889],{"class":1095},"    tools: [getWeather],\n",[1033,1891,1892],{"class":1035,"line":1510},[1033,1893,1199],{"class":1095},[1033,1895,1896],{"class":1035,"line":1521},[1033,1897,1205],{"class":1095},[897,1899,1900],{},"注意事项：",[905,1902,1903,1909,1915,1921],{},[908,1904,1905,1908],{},[900,1906,1907],{},"输入用 Zod schema","，SDK 会自动转成 JSON Schema",[908,1910,1911,1914],{},[900,1912,1913],{},"execute 返回字符串","，不要返回复杂对象",[908,1916,1917,1920],{},[900,1918,1919],{},"抛出异常会被捕获","并作为错误反馈给模型",[908,1922,1923,1926],{},[900,1924,1925],{},"工具要幂等","，模型可能重试",[892,1928,1929],{"id":1929},"消息流类型",[897,1931,1932,1934],{},[1030,1933,1324],{}," 返回的迭代器会 yield 多种消息：",[937,1936,1937,1950],{},[940,1938,1939],{},[943,1940,1941,1944,1947],{},[946,1942,1943],{},"类型",[946,1945,1946],{},"含义",[946,1948,1949],{},"典型用途",[953,1951,1952,1965,1978,1991,2004,2017],{},[943,1953,1954,1959,1962],{},[958,1955,1956],{},[1030,1957,1958],{},"system",[958,1960,1961],{},"系统信息（初始化、session）",[958,1963,1964],{},"记录 session_id",[943,1966,1967,1972,1975],{},[958,1968,1969],{},[1030,1970,1971],{},"user",[958,1973,1974],{},"用户消息",[958,1976,1977],{},"回显",[943,1979,1980,1985,1988],{},[958,1981,1982],{},[1030,1983,1984],{},"assistant",[958,1986,1987],{},"模型回复",[958,1989,1990],{},"展示文本 \u002F 检测工具调用",[943,1992,1993,1998,2001],{},[958,1994,1995],{},[1030,1996,1997],{},"tool_use",[958,1999,2000],{},"工具调用开始",[958,2002,2003],{},"UI 进度条",[943,2005,2006,2011,2014],{},[958,2007,2008],{},[1030,2009,2010],{},"tool_result",[958,2012,2013],{},"工具执行结果",[958,2015,2016],{},"日志",[943,2018,2019,2024,2027],{},[958,2020,2021],{},[1030,2022,2023],{},"result",[958,2025,2026],{},"最终总结",[958,2028,2029],{},"结束标志、usage 统计",[897,2031,2032],{},"处理示例：",[1024,2034,2036],{"className":1108,"code":2035,"language":1110,"meta":11,"style":11},"for await (const msg of result) {\n  switch (msg.type) {\n    case \"assistant\":\n      process.stdout.write(msg.text)\n      break\n    case \"tool_use\":\n      console.log(`\\n[调用工具] ${msg.name}`)\n      break\n    case \"result\":\n      console.log(`\\n总 tokens: ${msg.usage.total_tokens}`)\n      break\n  }\n}\n",[1030,2037,2038,2055,2063,2073,2084,2089,2098,2128,2132,2141,2172,2176,2180],{"__ignoreMap":11},[1033,2039,2040,2042,2044,2046,2048,2051,2053],{"class":1035,"line":1036},[1033,2041,1216],{"class":1091},[1033,2043,1219],{"class":1091},[1033,2045,1222],{"class":1095},[1033,2047,1135],{"class":1091},[1033,2049,2050],{"class":1138}," msg",[1033,2052,1230],{"class":1091},[1033,2054,1233],{"class":1095},[1033,2056,2057,2060],{"class":1035,"line":1043},[1033,2058,2059],{"class":1091},"  switch",[1033,2061,2062],{"class":1095}," (msg.type) {\n",[1033,2064,2065,2068,2070],{"class":1035,"line":1057},[1033,2066,2067],{"class":1091},"    case",[1033,2069,1248],{"class":1050},[1033,2071,2072],{"class":1095},":\n",[1033,2074,2075,2078,2081],{"class":1035,"line":1064},[1033,2076,2077],{"class":1095},"      process.stdout.",[1033,2079,2080],{"class":1046},"write",[1033,2082,2083],{"class":1095},"(msg.text)\n",[1033,2085,2086],{"class":1035,"line":1070},[1033,2087,2088],{"class":1091},"      break\n",[1033,2090,2091,2093,2096],{"class":1035,"line":1167},[1033,2092,2067],{"class":1091},[1033,2094,2095],{"class":1050}," \"tool_use\"",[1033,2097,2072],{"class":1095},[1033,2099,2100,2103,2105,2107,2110,2113,2116,2119,2121,2124,2126],{"class":1035,"line":1178},[1033,2101,2102],{"class":1095},"      console.",[1033,2104,260],{"class":1046},[1033,2106,1735],{"class":1095},[1033,2108,2109],{"class":1050},"`",[1033,2111,2112],{"class":1138},"\\n",[1033,2114,2115],{"class":1050},"[调用工具] ${",[1033,2117,2118],{"class":1095},"msg",[1033,2120,1831],{"class":1050},[1033,2122,2123],{"class":1095},"name",[1033,2125,1789],{"class":1050},[1033,2127,1792],{"class":1095},[1033,2129,2130],{"class":1035,"line":1196},[1033,2131,2088],{"class":1091},[1033,2133,2134,2136,2139],{"class":1035,"line":1202},[1033,2135,2067],{"class":1091},[1033,2137,2138],{"class":1050}," \"result\"",[1033,2140,2072],{"class":1095},[1033,2142,2143,2145,2147,2149,2151,2153,2156,2158,2160,2163,2165,2168,2170],{"class":1035,"line":1208},[1033,2144,2102],{"class":1095},[1033,2146,260],{"class":1046},[1033,2148,1735],{"class":1095},[1033,2150,2109],{"class":1050},[1033,2152,2112],{"class":1138},[1033,2154,2155],{"class":1050},"总 tokens: ${",[1033,2157,2118],{"class":1095},[1033,2159,1831],{"class":1050},[1033,2161,2162],{"class":1095},"usage",[1033,2164,1831],{"class":1050},[1033,2166,2167],{"class":1095},"total_tokens",[1033,2169,1789],{"class":1050},[1033,2171,1792],{"class":1095},[1033,2173,2174],{"class":1035,"line":1213},[1033,2175,2088],{"class":1091},[1033,2177,2178],{"class":1035,"line":1236},[1033,2179,1268],{"class":1095},[1033,2181,2182],{"class":1035,"line":1254},[1033,2183,1274],{"class":1095},[892,2185,2186],{"id":2186},"会话管理",[897,2188,2189],{},"SDK 支持会话持久化，断点续跑：",[1024,2191,2193],{"className":1108,"code":2192,"language":1110,"meta":11,"style":11},"\u002F\u002F 第一次\nconst session1 = query({ prompt: \"开始分析这个项目\" })\nlet sessionId: string\nfor await (const msg of session1) {\n  if (msg.type === \"system\" && msg.subtype === \"init\") {\n    sessionId = msg.session_id\n  }\n}\n\n\u002F\u002F 几小时后继续\nconst session2 = query({\n  prompt: \"刚才说到哪了？继续\",\n  options: { resume: sessionId },\n})\n",[1030,2194,2195,2200,2220,2233,2250,2275,2285,2289,2293,2297,2302,2315,2324,2329],{"__ignoreMap":11},[1033,2196,2197],{"class":1035,"line":1036},[1033,2198,2199],{"class":1039},"\u002F\u002F 第一次\n",[1033,2201,2202,2204,2207,2209,2211,2214,2217],{"class":1035,"line":1043},[1033,2203,1135],{"class":1091},[1033,2205,2206],{"class":1138}," session1",[1033,2208,1142],{"class":1091},[1033,2210,1145],{"class":1046},[1033,2212,2213],{"class":1095},"({ prompt: ",[1033,2215,2216],{"class":1050},"\"开始分析这个项目\"",[1033,2218,2219],{"class":1095}," })\n",[1033,2221,2222,2225,2228,2230],{"class":1035,"line":1057},[1033,2223,2224],{"class":1091},"let",[1033,2226,2227],{"class":1095}," sessionId",[1033,2229,1348],{"class":1091},[1033,2231,2232],{"class":1138}," string\n",[1033,2234,2235,2237,2239,2241,2243,2245,2247],{"class":1035,"line":1064},[1033,2236,1216],{"class":1091},[1033,2238,1219],{"class":1091},[1033,2240,1222],{"class":1095},[1033,2242,1135],{"class":1091},[1033,2244,2050],{"class":1138},[1033,2246,1230],{"class":1091},[1033,2248,2249],{"class":1095}," session1) {\n",[1033,2251,2252,2254,2257,2259,2262,2265,2268,2270,2273],{"class":1035,"line":1070},[1033,2253,1239],{"class":1091},[1033,2255,2256],{"class":1095}," (msg.type ",[1033,2258,1245],{"class":1091},[1033,2260,2261],{"class":1050}," \"system\"",[1033,2263,2264],{"class":1091}," &&",[1033,2266,2267],{"class":1095}," msg.subtype ",[1033,2269,1245],{"class":1091},[1033,2271,2272],{"class":1050}," \"init\"",[1033,2274,1251],{"class":1095},[1033,2276,2277,2280,2282],{"class":1035,"line":1167},[1033,2278,2279],{"class":1095},"    sessionId ",[1033,2281,1099],{"class":1091},[1033,2283,2284],{"class":1095}," msg.session_id\n",[1033,2286,2287],{"class":1035,"line":1178},[1033,2288,1268],{"class":1095},[1033,2290,2291],{"class":1035,"line":1196},[1033,2292,1274],{"class":1095},[1033,2294,2295],{"class":1035,"line":1202},[1033,2296,1061],{"emptyLinePlaceholder":1060},[1033,2298,2299],{"class":1035,"line":1208},[1033,2300,2301],{"class":1039},"\u002F\u002F 几小时后继续\n",[1033,2303,2304,2306,2309,2311,2313],{"class":1035,"line":1213},[1033,2305,1135],{"class":1091},[1033,2307,2308],{"class":1138}," session2",[1033,2310,1142],{"class":1091},[1033,2312,1145],{"class":1046},[1033,2314,1148],{"class":1095},[1033,2316,2317,2319,2322],{"class":1035,"line":1236},[1033,2318,1153],{"class":1095},[1033,2320,2321],{"class":1050},"\"刚才说到哪了？继续\"",[1033,2323,1159],{"class":1095},[1033,2325,2326],{"class":1035,"line":1254},[1033,2327,2328],{"class":1095},"  options: { resume: sessionId },\n",[1033,2330,2331],{"class":1035,"line":1265},[1033,2332,1205],{"class":1095},[897,2334,2335],{},"这让你可以：",[905,2337,2338,2341,2344],{},[908,2339,2340],{},"构建可中断\u002F恢复的长任务",[908,2342,2343],{},"实现多轮对话的后端接口",[908,2345,2346],{},"支持 Agent 后台跑任务 + 异步查看结果",[892,2348,2349],{"id":2349},"权限与安全",[897,2351,2352],{},"SDK 提供三档权限模式：",[937,2354,2355,2365],{},[940,2356,2357],{},[943,2358,2359,2362],{},[946,2360,2361],{},"模式",[946,2363,2364],{},"行为",[953,2366,2367,2377,2387],{},[943,2368,2369,2374],{},[958,2370,2371],{},[1030,2372,2373],{},"default",[958,2375,2376],{},"危险操作需要用户确认",[943,2378,2379,2384],{},[958,2380,2381],{},[1030,2382,2383],{},"acceptEdits",[958,2385,2386],{},"自动接受文件编辑，其他仍需确认",[943,2388,2389,2394],{},[958,2390,2391],{},[1030,2392,2393],{},"bypassPermissions",[958,2395,2396],{},"全部自动通过（CI \u002F 沙箱场景）",[897,2398,2399],{},"程序化控制权限：",[1024,2401,2403],{"className":1108,"code":2402,"language":1110,"meta":11,"style":11},"options: {\n  canUseTool: async (toolName, input) => {\n    if (toolName === \"Bash\" && input.command.includes(\"rm -rf\")) {\n      return { behavior: \"deny\", message: \"禁止危险命令\" }\n    }\n    return { behavior: \"allow\" }\n  }\n}\n",[1030,2404,2405,2413,2442,2471,2491,2496,2507,2511],{"__ignoreMap":11},[1033,2406,2407,2410],{"class":1035,"line":1036},[1033,2408,2409],{"class":1046},"options",[1033,2411,2412],{"class":1095},": {\n",[1033,2414,2415,2418,2421,2424,2426,2429,2431,2434,2437,2440],{"class":1035,"line":1043},[1033,2416,2417],{"class":1046},"  canUseTool",[1033,2419,2420],{"class":1095},": ",[1033,2422,2423],{"class":1091},"async",[1033,2425,1222],{"class":1095},[1033,2427,2428],{"class":1760},"toolName",[1033,2430,1187],{"class":1095},[1033,2432,2433],{"class":1760},"input",[1033,2435,2436],{"class":1095},") ",[1033,2438,2439],{"class":1091},"=>",[1033,2441,1356],{"class":1095},[1033,2443,2444,2447,2450,2452,2455,2457,2460,2463,2465,2468],{"class":1035,"line":1057},[1033,2445,2446],{"class":1091},"    if",[1033,2448,2449],{"class":1095}," (toolName ",[1033,2451,1245],{"class":1091},[1033,2453,2454],{"class":1050}," \"Bash\"",[1033,2456,2264],{"class":1091},[1033,2458,2459],{"class":1095}," input.command.",[1033,2461,2462],{"class":1046},"includes",[1033,2464,1735],{"class":1095},[1033,2466,2467],{"class":1050},"\"rm -rf\"",[1033,2469,2470],{"class":1095},")) {\n",[1033,2472,2473,2476,2479,2482,2485,2488],{"class":1035,"line":1064},[1033,2474,2475],{"class":1091},"      return",[1033,2477,2478],{"class":1095}," { behavior: ",[1033,2480,2481],{"class":1050},"\"deny\"",[1033,2483,2484],{"class":1095},", message: ",[1033,2486,2487],{"class":1050},"\"禁止危险命令\"",[1033,2489,2490],{"class":1095}," }\n",[1033,2492,2493],{"class":1035,"line":1070},[1033,2494,2495],{"class":1095},"    }\n",[1033,2497,2498,2500,2502,2505],{"class":1035,"line":1167},[1033,2499,1817],{"class":1091},[1033,2501,2478],{"class":1095},[1033,2503,2504],{"class":1050},"\"allow\"",[1033,2506,2490],{"class":1095},[1033,2508,2509],{"class":1035,"line":1178},[1033,2510,1268],{"class":1095},[1033,2512,2513],{"class":1035,"line":1196},[1033,2514,1274],{"class":1095},[897,2516,2517],{},"这是一个实时判断钩子，每次工具调用前被触发。",[892,2519,2521],{"id":2520},"与-mcp-集成","与 MCP 集成",[897,2523,2524],{},"只需在 options 中配置 MCP servers，SDK 会自动启动进程并注入工具：",[1024,2526,2528],{"className":1108,"code":2527,"language":1110,"meta":11,"style":11},"mcpServers: {\n  sqlite: {\n    command: \"npx\",\n    args: [\"-y\", \"@modelcontextprotocol\u002Fserver-sqlite\", \".\u002Fdata.db\"],\n  },\n  custom: {\n    \u002F\u002F 或连接远程 HTTP server\n    url: \"https:\u002F\u002Fmcp.example.com\u002Fsse\",\n    headers: { Authorization: \"Bearer ...\" },\n  },\n}\n",[1030,2529,2530,2537,2544,2555,2577,2581,2588,2593,2605,2623,2627],{"__ignoreMap":11},[1033,2531,2532,2535],{"class":1035,"line":1036},[1033,2533,2534],{"class":1046},"mcpServers",[1033,2536,2412],{"class":1095},[1033,2538,2539,2542],{"class":1035,"line":1043},[1033,2540,2541],{"class":1046},"  sqlite",[1033,2543,2412],{"class":1095},[1033,2545,2546,2549,2551,2553],{"class":1035,"line":1057},[1033,2547,2548],{"class":1046},"    command",[1033,2550,2420],{"class":1095},[1033,2552,1516],{"class":1050},[1033,2554,1159],{"class":1095},[1033,2556,2557,2560,2563,2565,2567,2570,2572,2575],{"class":1035,"line":1064},[1033,2558,2559],{"class":1046},"    args",[1033,2561,2562],{"class":1095},": [",[1033,2564,1527],{"class":1050},[1033,2566,1187],{"class":1095},[1033,2568,2569],{"class":1050},"\"@modelcontextprotocol\u002Fserver-sqlite\"",[1033,2571,1187],{"class":1095},[1033,2573,2574],{"class":1050},"\".\u002Fdata.db\"",[1033,2576,1193],{"class":1095},[1033,2578,2579],{"class":1035,"line":1070},[1033,2580,1199],{"class":1095},[1033,2582,2583,2586],{"class":1035,"line":1167},[1033,2584,2585],{"class":1046},"  custom",[1033,2587,2412],{"class":1095},[1033,2589,2590],{"class":1035,"line":1178},[1033,2591,2592],{"class":1039},"    \u002F\u002F 或连接远程 HTTP server\n",[1033,2594,2595,2598,2600,2603],{"class":1035,"line":1196},[1033,2596,2597],{"class":1046},"    url",[1033,2599,2420],{"class":1095},[1033,2601,2602],{"class":1050},"\"https:\u002F\u002Fmcp.example.com\u002Fsse\"",[1033,2604,1159],{"class":1095},[1033,2606,2607,2610,2613,2616,2618,2621],{"class":1035,"line":1202},[1033,2608,2609],{"class":1046},"    headers",[1033,2611,2612],{"class":1095},": { ",[1033,2614,2615],{"class":1046},"Authorization",[1033,2617,2420],{"class":1095},[1033,2619,2620],{"class":1050},"\"Bearer ...\"",[1033,2622,1546],{"class":1095},[1033,2624,2625],{"class":1035,"line":1208},[1033,2626,1199],{"class":1095},[1033,2628,2629],{"class":1035,"line":1213},[1033,2630,1274],{"class":1095},[897,2632,2633],{},"服务器暴露的所有 tools 会自动出现在 Agent 可用工具列表里，无需手动桥接。",[892,2635,2636],{"id":2636},"典型应用模式",[1306,2638,2640],{"id":2639},"模式-1一次性任务-agent","模式 1：一次性任务 Agent",[1024,2642,2644],{"className":1108,"code":2643,"language":1110,"meta":11,"style":11},"async function runLintAgent(file: string) {\n  const result = query({\n    prompt: `Lint ${file} and fix all issues`,\n    options: { allowedTools: [\"Read\", \"Edit\"], maxTurns: 10 },\n  })\n  for await (const msg of result) { \u002F* log *\u002F }\n}\n",[1030,2645,2646,2668,2681,2696,2716,2721,2744],{"__ignoreMap":11},[1033,2647,2648,2650,2653,2656,2658,2661,2663,2666],{"class":1035,"line":1036},[1033,2649,2423],{"class":1091},[1033,2651,2652],{"class":1091}," function",[1033,2654,2655],{"class":1046}," runLintAgent",[1033,2657,1735],{"class":1095},[1033,2659,2660],{"class":1760},"file",[1033,2662,1348],{"class":1091},[1033,2664,2665],{"class":1138}," string",[1033,2667,1251],{"class":1095},[1033,2669,2670,2673,2675,2677,2679],{"class":1035,"line":1043},[1033,2671,2672],{"class":1091},"  const",[1033,2674,1139],{"class":1138},[1033,2676,1142],{"class":1091},[1033,2678,1145],{"class":1046},[1033,2680,1148],{"class":1095},[1033,2682,2683,2686,2689,2691,2694],{"class":1035,"line":1057},[1033,2684,2685],{"class":1095},"    prompt: ",[1033,2687,2688],{"class":1050},"`Lint ${",[1033,2690,2660],{"class":1095},[1033,2692,2693],{"class":1050},"} and fix all issues`",[1033,2695,1159],{"class":1095},[1033,2697,2698,2701,2703,2705,2708,2711,2714],{"class":1035,"line":1064},[1033,2699,2700],{"class":1095},"    options: { allowedTools: [",[1033,2702,1190],{"class":1050},[1033,2704,1187],{"class":1095},[1033,2706,2707],{"class":1050},"\"Edit\"",[1033,2709,2710],{"class":1095},"], maxTurns: ",[1033,2712,2713],{"class":1138},"10",[1033,2715,1546],{"class":1095},[1033,2717,2718],{"class":1035,"line":1070},[1033,2719,2720],{"class":1095},"  })\n",[1033,2722,2723,2726,2728,2730,2732,2734,2736,2739,2742],{"class":1035,"line":1167},[1033,2724,2725],{"class":1091},"  for",[1033,2727,1219],{"class":1091},[1033,2729,1222],{"class":1095},[1033,2731,1135],{"class":1091},[1033,2733,2050],{"class":1138},[1033,2735,1230],{"class":1091},[1033,2737,2738],{"class":1095}," result) { ",[1033,2740,2741],{"class":1039},"\u002F* log *\u002F",[1033,2743,2490],{"class":1095},[1033,2745,2746],{"class":1035,"line":1178},[1033,2747,1274],{"class":1095},[897,2749,2750],{},"适合 CI、定时任务、批处理。",[1306,2752,2754],{"id":2753},"模式-2交互式聊天","模式 2：交互式聊天",[1024,2756,2758],{"className":1108,"code":2757,"language":1110,"meta":11,"style":11},"const session = query({ prompt: initial, options: { ... } })\n\u002F\u002F 把 session 包装成 WebSocket \u002F SSE 流，传给前端\n",[1030,2759,2760,2780],{"__ignoreMap":11},[1033,2761,2762,2764,2767,2769,2771,2774,2777],{"class":1035,"line":1036},[1033,2763,1135],{"class":1091},[1033,2765,2766],{"class":1138}," session",[1033,2768,1142],{"class":1091},[1033,2770,1145],{"class":1046},[1033,2772,2773],{"class":1095},"({ prompt: initial, options: { ",[1033,2775,2776],{"class":1091},"...",[1033,2778,2779],{"class":1095}," } })\n",[1033,2781,2782],{"class":1035,"line":1043},[1033,2783,2784],{"class":1039},"\u002F\u002F 把 session 包装成 WebSocket \u002F SSE 流，传给前端\n",[1306,2786,2788],{"id":2787},"模式-3后台监听-agent","模式 3：后台监听 Agent",[1024,2790,2792],{"className":1108,"code":2791,"language":1110,"meta":11,"style":11},"for (const event of eventQueue) {\n  await query({\n    prompt: `处理事件 ${event.id}`,\n    options: { resume: agentSessionId },\n  })\n}\n",[1030,2793,2794,2810,2819,2838,2843,2847],{"__ignoreMap":11},[1033,2795,2796,2798,2800,2802,2805,2807],{"class":1035,"line":1036},[1033,2797,1216],{"class":1091},[1033,2799,1222],{"class":1095},[1033,2801,1135],{"class":1091},[1033,2803,2804],{"class":1138}," event",[1033,2806,1230],{"class":1091},[1033,2808,2809],{"class":1095}," eventQueue) {\n",[1033,2811,2812,2815,2817],{"class":1035,"line":1043},[1033,2813,2814],{"class":1091},"  await",[1033,2816,1145],{"class":1046},[1033,2818,1148],{"class":1095},[1033,2820,2821,2823,2826,2829,2831,2834,2836],{"class":1035,"line":1057},[1033,2822,2685],{"class":1095},[1033,2824,2825],{"class":1050},"`处理事件 ${",[1033,2827,2828],{"class":1095},"event",[1033,2830,1831],{"class":1050},[1033,2832,2833],{"class":1095},"id",[1033,2835,1789],{"class":1050},[1033,2837,1159],{"class":1095},[1033,2839,2840],{"class":1035,"line":1064},[1033,2841,2842],{"class":1095},"    options: { resume: agentSessionId },\n",[1033,2844,2845],{"class":1035,"line":1070},[1033,2846,2720],{"class":1095},[1033,2848,2849],{"class":1035,"line":1167},[1033,2850,1274],{"class":1095},[897,2852,2853],{},"一个长生命周期 session，逐条处理事件队列。",[1306,2855,2857],{"id":2856},"模式-4多-agent-协作","模式 4：多 Agent 协作",[1024,2859,2861],{"className":1108,"code":2860,"language":1110,"meta":11,"style":11},"const plan = await runPlanner(prompt)\nconst results = await Promise.all(\n  plan.tasks.map(task => runWorker(task))\n)\nawait runReducer(results)\n",[1030,2862,2863,2880,2902,2924,2928],{"__ignoreMap":11},[1033,2864,2865,2867,2870,2872,2874,2877],{"class":1035,"line":1036},[1033,2866,1135],{"class":1091},[1033,2868,2869],{"class":1138}," plan",[1033,2871,1142],{"class":1091},[1033,2873,1219],{"class":1091},[1033,2875,2876],{"class":1046}," runPlanner",[1033,2878,2879],{"class":1095},"(prompt)\n",[1033,2881,2882,2884,2887,2889,2891,2894,2896,2899],{"class":1035,"line":1043},[1033,2883,1135],{"class":1091},[1033,2885,2886],{"class":1138}," results",[1033,2888,1142],{"class":1091},[1033,2890,1219],{"class":1091},[1033,2892,2893],{"class":1138}," Promise",[1033,2895,1831],{"class":1095},[1033,2897,2898],{"class":1046},"all",[1033,2900,2901],{"class":1095},"(\n",[1033,2903,2904,2907,2910,2912,2915,2918,2921],{"class":1035,"line":1057},[1033,2905,2906],{"class":1095},"  plan.tasks.",[1033,2908,2909],{"class":1046},"map",[1033,2911,1735],{"class":1095},[1033,2913,2914],{"class":1760},"task",[1033,2916,2917],{"class":1091}," =>",[1033,2919,2920],{"class":1046}," runWorker",[1033,2922,2923],{"class":1095},"(task))\n",[1033,2925,2926],{"class":1035,"line":1064},[1033,2927,1792],{"class":1095},[1033,2929,2930,2933,2936],{"class":1035,"line":1070},[1033,2931,2932],{"class":1091},"await",[1033,2934,2935],{"class":1046}," runReducer",[1033,2937,2938],{"class":1095},"(results)\n",[897,2940,2941,2942,2944],{},"用 SDK 构建\"规划 → 分发 → 汇总\"的多 Agent pipeline，每个子 Agent 是独立的 ",[1030,2943,1324],{}," 调用。",[892,2946,2947],{"id":2947},"性能与成本",[937,2949,2950,2960],{},[940,2951,2952],{},[943,2953,2954,2957],{},[946,2955,2956],{},"优化点",[946,2958,2959],{},"做法",[953,2961,2962,2973,2985,2996,3007,3015],{},[943,2963,2964,2967],{},[958,2965,2966],{},"减少 turn 数",[958,2968,2969,2970],{},"明确 prompt，设置 ",[1030,2971,2972],{},"maxTurns",[943,2974,2975,2978],{},[958,2976,2977],{},"减小上下文",[958,2979,2980,2981,2984],{},"用 ",[1030,2982,2983],{},"appendSystemPrompt"," 替代大段历史",[943,2986,2987,2990],{},[958,2988,2989],{},"复用 session",[958,2991,2992,2995],{},[1030,2993,2994],{},"resume"," 续跑，避免重载 context",[943,2997,2998,3001],{},[958,2999,3000],{},"限制工具",[958,3002,3003,3006],{},[1030,3004,3005],{},"allowedTools"," 只开必需的",[943,3008,3009,3012],{},[958,3010,3011],{},"快路径",[958,3013,3014],{},"简单任务用 haiku，复杂用 sonnet\u002Fopus",[943,3016,3017,3020],{},[958,3018,3019],{},"并行子任务",[958,3021,3022],{},"拆 subagents 并发执行",[892,3024,3026],{"id":3025},"与-claude-code-的关系","与 Claude Code 的关系",[937,3028,3029,3042],{},[940,3030,3031],{},[943,3032,3033,3036,3039],{},[946,3034,3035],{},"项",[946,3037,3038],{},"Claude Code",[946,3040,3041],{},"Agent SDK",[953,3043,3044,3055,3066,3083,3094],{},[943,3045,3046,3049,3052],{},[958,3047,3048],{},"定位",[958,3050,3051],{},"终端 IDE 助手",[958,3053,3054],{},"通用构建库",[943,3056,3057,3060,3063],{},[958,3058,3059],{},"UI",[958,3061,3062],{},"命令行 TUI",[958,3064,3065],{},"无（由你提供）",[943,3067,3068,3071,3080],{},[958,3069,3070],{},"配置",[958,3072,3073,3076,3077],{},[1030,3074,3075],{},"settings.json"," + ",[1030,3078,3079],{},".claude\u002F",[958,3081,3082],{},"代码 options",[943,3084,3085,3088,3091],{},[958,3086,3087],{},"工具",[958,3089,3090],{},"预置整套",[958,3092,3093],{},"按需传入",[943,3095,3096,3099,3102],{},[958,3097,3098],{},"权限",[958,3100,3101],{},"交互确认",[958,3103,3104,3107],{},[1030,3105,3106],{},"canUseTool"," 钩子",[897,3109,3110,3111,3114],{},"你可以把 Agent SDK 理解成\"",[900,3112,3113],{},"去掉 Claude Code 的 UI 后的内核","\"。",[892,3116,3117],{"id":3117},"小结",[897,3119,3120],{},"Agent SDK 让\"构建自己的 Claude Code\"变成几行代码的事：",[905,3122,3123,3129,3135,3140,3146],{},[908,3124,3125,3128],{},[900,3126,3127],{},"query() 是入口","，异步迭代器吐消息",[908,3130,3131,3134],{},[900,3132,3133],{},"options 控制一切","：模型、工具、权限、MCP、Hooks",[908,3136,3137,3139],{},[900,3138,1639],{},"用 Zod schema + execute 函数",[908,3141,3142,3145],{},[900,3143,3144],{},"会话 resume"," 支持长任务",[908,3147,3148,3150],{},[900,3149,3106],{}," 是程序化权限关卡",[897,3152,3153,3154,3158],{},"下一章 ",[3155,3156,3157],"a",{"href":17},"Agent Hooks"," 介绍如何通过 Hooks 在关键生命周期注入自定义逻辑。",[3160,3161,3162],"style",{},"html pre.shiki code .sCsY4, html code.shiki .sCsY4{--shiki-light:#6A737D;--shiki-default:#6A737D;--shiki-dark:#6A737D}html pre.shiki code .snPdu, html code.shiki .snPdu{--shiki-light:#6F42C1;--shiki-default:#6F42C1;--shiki-dark:#B392F0}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);}html pre.shiki code .s8jYJ, html code.shiki .s8jYJ{--shiki-light:#D73A49;--shiki-default:#D73A49;--shiki-dark:#F97583}html pre.shiki code .sxrX7, html code.shiki .sxrX7{--shiki-light:#24292E;--shiki-default:#24292E;--shiki-dark:#E1E4E8}html pre.shiki code .sBjJW, html code.shiki .sBjJW{--shiki-light:#005CC5;--shiki-default:#005CC5;--shiki-dark:#79B8FF}html pre.shiki code .sP4rz, html code.shiki .sP4rz{--shiki-light:#E36209;--shiki-default:#E36209;--shiki-dark:#FFAB70}",{"title":11,"searchDepth":1043,"depth":1043,"links":3164},[3165,3166,3167,3168,3169,3172,3173,3174,3175,3176,3177,3178,3184,3185,3186],{"id":894,"depth":1043,"text":895},{"id":934,"depth":1043,"text":935},{"id":1022,"depth":1043,"text":1022},{"id":1105,"depth":1043,"text":1105},{"id":1295,"depth":1043,"text":1295,"children":3170},[3171],{"id":1308,"depth":1057,"text":1309},{"id":1332,"depth":1043,"text":1333},{"id":1639,"depth":1043,"text":1639},{"id":1929,"depth":1043,"text":1929},{"id":2186,"depth":1043,"text":2186},{"id":2349,"depth":1043,"text":2349},{"id":2520,"depth":1043,"text":2521},{"id":2636,"depth":1043,"text":2636,"children":3179},[3180,3181,3182,3183],{"id":2639,"depth":1057,"text":2640},{"id":2753,"depth":1057,"text":2754},{"id":2787,"depth":1057,"text":2788},{"id":2856,"depth":1057,"text":2857},{"id":2947,"depth":1043,"text":2947},{"id":3025,"depth":1043,"text":3026},{"id":3117,"depth":1043,"text":3117},"md",{},{"title":30,"description":31},"ai\u002Fagent\u002Fsdk","fODxDXU4V3_amSSA0SmVD4Og463y5Pe6bG5WPW3M8y0",1775474635724]