[{"data":1,"prerenderedAt":2888},["ShallowReactive",2],{"search-docs":3,"doc-\u002Fai\u002Fmcp\u002Ftools":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":90,"body":888,"description":91,"extension":2883,"meta":2884,"navigation":2333,"path":89,"seo":2885,"stem":2886,"__hash__":2887},"docs\u002Fai\u002Fmcp\u002Ftools.md",{"type":889,"value":890,"toc":2855},"minimark",[891,896,900,963,974,977,981,984,1242,1245,1307,1311,1318,1324,1346,1350,1353,1357,1429,1432,1435,1500,1503,1643,1646,1738,1742,1749,1852,1934,1938,1942,1948,1951,1975,1978,2125,2131,2159,2163,2167,2173,2177,2180,2187,2191,2244,2251,2255,2258,2264,2268,2283,2287,2352,2356,2411,2414,2418,2428,2431,2434,2666,2672,2675,2678,2750,2757,2760,2806,2813,2816,2819,2845,2851],[892,893,895],"h2",{"id":894},"tools-在-mcp-三元组中的位置","Tools 在 MCP 三元组中的位置",[897,898,899],"p",{},"MCP Server 向外暴露三类能力：",[901,902,903,919],"table",{},[904,905,906],"thead",{},[907,908,909,913,916],"tr",{},[910,911,912],"th",{},"能力",[910,914,915],{},"控制权",[910,917,918],{},"用途",[920,921,922,937,950],"tbody",{},[907,923,924,931,934],{},[925,926,927],"td",{},[928,929,930],"strong",{},"Tools",[925,932,933],{},"模型主动调用",[925,935,936],{},"执行动作（读写、计算、修改状态）",[907,938,939,944,947],{},[925,940,941],{},[928,942,943],{},"Resources",[925,945,946],{},"模型按需读取",[925,948,949],{},"提供只读上下文（文件、文档、数据）",[907,951,952,957,960],{},[925,953,954],{},[928,955,956],{},"Prompts",[925,958,959],{},"用户主动选择",[925,961,962],{},"预置提示词模板",[964,965,971],"pre",{"className":966,"code":968,"language":969,"meta":970},[967],"language-text","flowchart LR\n    subgraph MCP[\"MCP Server\"]\n        Tools[\"Tools\u003Cbr\u002F>（动作）\"]\n        Resources[\"Resources\u003Cbr\u002F>（数据）\"]\n        Prompts[\"Prompts\u003Cbr\u002F>（模板）\"]\n    end\n    LLM[\"LLM \u002F Agent\"]\n    User[\"用户\"]\n    LLM -->|\"主动调用\"| Tools\n    LLM -->|\"主动读取\"| Resources\n    User -->|\"选择插入\"| Prompts\n","text","mermaid",[972,973,968],"code",{"__ignoreMap":11},[897,975,976],{},"Tools 是三者中最\"有副作用\"也最强大的一种，本章专注它。",[892,978,980],{"id":979},"tool-的定义结构","Tool 的定义结构",[897,982,983],{},"一个 MCP Tool 本质上是一段带 JSON Schema 的函数声明：",[964,985,989],{"className":986,"code":987,"language":988,"meta":11,"style":11},"language-json shiki shiki-themes github-light github-light github-dark","{\n  \"name\": \"create_issue\",\n  \"description\": \"Create a new issue in the given GitHub repository.\",\n  \"inputSchema\": {\n    \"type\": \"object\",\n    \"properties\": {\n      \"owner\":  { \"type\": \"string\", \"description\": \"Repo owner (user or org)\" },\n      \"repo\":   { \"type\": \"string\", \"description\": \"Repo name\" },\n      \"title\":  { \"type\": \"string\", \"description\": \"Issue title\" },\n      \"body\":   { \"type\": \"string\", \"description\": \"Markdown body\" },\n      \"labels\": { \"type\": \"array\", \"items\": { \"type\": \"string\" } }\n    },\n    \"required\": [\"owner\", \"repo\", \"title\"]\n  }\n}\n","json",[972,990,991,1000,1017,1030,1039,1052,1060,1091,1117,1142,1167,1199,1205,1230,1236],{"__ignoreMap":11},[992,993,996],"span",{"class":994,"line":995},"line",1,[992,997,999],{"class":998},"sxrX7","{\n",[992,1001,1003,1007,1010,1014],{"class":994,"line":1002},2,[992,1004,1006],{"class":1005},"sBjJW","  \"name\"",[992,1008,1009],{"class":998},": ",[992,1011,1013],{"class":1012},"sIIMD","\"create_issue\"",[992,1015,1016],{"class":998},",\n",[992,1018,1020,1023,1025,1028],{"class":994,"line":1019},3,[992,1021,1022],{"class":1005},"  \"description\"",[992,1024,1009],{"class":998},[992,1026,1027],{"class":1012},"\"Create a new issue in the given GitHub repository.\"",[992,1029,1016],{"class":998},[992,1031,1033,1036],{"class":994,"line":1032},4,[992,1034,1035],{"class":1005},"  \"inputSchema\"",[992,1037,1038],{"class":998},": {\n",[992,1040,1042,1045,1047,1050],{"class":994,"line":1041},5,[992,1043,1044],{"class":1005},"    \"type\"",[992,1046,1009],{"class":998},[992,1048,1049],{"class":1012},"\"object\"",[992,1051,1016],{"class":998},[992,1053,1055,1058],{"class":994,"line":1054},6,[992,1056,1057],{"class":1005},"    \"properties\"",[992,1059,1038],{"class":998},[992,1061,1063,1066,1069,1072,1074,1077,1080,1083,1085,1088],{"class":994,"line":1062},7,[992,1064,1065],{"class":1005},"      \"owner\"",[992,1067,1068],{"class":998},":  { ",[992,1070,1071],{"class":1005},"\"type\"",[992,1073,1009],{"class":998},[992,1075,1076],{"class":1012},"\"string\"",[992,1078,1079],{"class":998},", ",[992,1081,1082],{"class":1005},"\"description\"",[992,1084,1009],{"class":998},[992,1086,1087],{"class":1012},"\"Repo owner (user or org)\"",[992,1089,1090],{"class":998}," },\n",[992,1092,1094,1097,1100,1102,1104,1106,1108,1110,1112,1115],{"class":994,"line":1093},8,[992,1095,1096],{"class":1005},"      \"repo\"",[992,1098,1099],{"class":998},":   { ",[992,1101,1071],{"class":1005},[992,1103,1009],{"class":998},[992,1105,1076],{"class":1012},[992,1107,1079],{"class":998},[992,1109,1082],{"class":1005},[992,1111,1009],{"class":998},[992,1113,1114],{"class":1012},"\"Repo name\"",[992,1116,1090],{"class":998},[992,1118,1120,1123,1125,1127,1129,1131,1133,1135,1137,1140],{"class":994,"line":1119},9,[992,1121,1122],{"class":1005},"      \"title\"",[992,1124,1068],{"class":998},[992,1126,1071],{"class":1005},[992,1128,1009],{"class":998},[992,1130,1076],{"class":1012},[992,1132,1079],{"class":998},[992,1134,1082],{"class":1005},[992,1136,1009],{"class":998},[992,1138,1139],{"class":1012},"\"Issue title\"",[992,1141,1090],{"class":998},[992,1143,1145,1148,1150,1152,1154,1156,1158,1160,1162,1165],{"class":994,"line":1144},10,[992,1146,1147],{"class":1005},"      \"body\"",[992,1149,1099],{"class":998},[992,1151,1071],{"class":1005},[992,1153,1009],{"class":998},[992,1155,1076],{"class":1012},[992,1157,1079],{"class":998},[992,1159,1082],{"class":1005},[992,1161,1009],{"class":998},[992,1163,1164],{"class":1012},"\"Markdown body\"",[992,1166,1090],{"class":998},[992,1168,1170,1173,1176,1178,1180,1183,1185,1188,1190,1192,1194,1196],{"class":994,"line":1169},11,[992,1171,1172],{"class":1005},"      \"labels\"",[992,1174,1175],{"class":998},": { ",[992,1177,1071],{"class":1005},[992,1179,1009],{"class":998},[992,1181,1182],{"class":1012},"\"array\"",[992,1184,1079],{"class":998},[992,1186,1187],{"class":1005},"\"items\"",[992,1189,1175],{"class":998},[992,1191,1071],{"class":1005},[992,1193,1009],{"class":998},[992,1195,1076],{"class":1012},[992,1197,1198],{"class":998}," } }\n",[992,1200,1202],{"class":994,"line":1201},12,[992,1203,1204],{"class":998},"    },\n",[992,1206,1208,1211,1214,1217,1219,1222,1224,1227],{"class":994,"line":1207},13,[992,1209,1210],{"class":1005},"    \"required\"",[992,1212,1213],{"class":998},": [",[992,1215,1216],{"class":1012},"\"owner\"",[992,1218,1079],{"class":998},[992,1220,1221],{"class":1012},"\"repo\"",[992,1223,1079],{"class":998},[992,1225,1226],{"class":1012},"\"title\"",[992,1228,1229],{"class":998},"]\n",[992,1231,1233],{"class":994,"line":1232},14,[992,1234,1235],{"class":998},"  }\n",[992,1237,1239],{"class":994,"line":1238},15,[992,1240,1241],{"class":998},"}\n",[897,1243,1244],{},"三大字段：",[901,1246,1247,1260],{},[904,1248,1249],{},[907,1250,1251,1254,1257],{},[910,1252,1253],{},"字段",[910,1255,1256],{},"作用",[910,1258,1259],{},"写好的关键",[920,1261,1262,1275,1288],{},[907,1263,1264,1269,1272],{},[925,1265,1266],{},[972,1267,1268],{},"name",[925,1270,1271],{},"唯一标识",[925,1273,1274],{},"snake_case、动词开头",[907,1276,1277,1282,1285],{},[925,1278,1279],{},[972,1280,1281],{},"description",[925,1283,1284],{},"模型判断用不用的依据",[925,1286,1287],{},"写清\"做什么、什么时候用、副作用\"",[907,1289,1290,1295,1298],{},[925,1291,1292],{},[972,1293,1294],{},"inputSchema",[925,1296,1297],{},"参数契约",[925,1299,1300,1301,1303,1304],{},"加 ",[972,1302,1281],{}," 字段、合理用 ",[972,1305,1306],{},"enum",[892,1308,1310],{"id":1309},"description决定命中率","description：决定命中率",[897,1312,1313,1314,1317],{},"Tool 的 description 是模型调用它的",[928,1315,1316],{},"唯一线索","。好 description 的通用结构：",[964,1319,1322],{"className":1320,"code":1321,"language":969,"meta":11},[967],"\u003C动作> \u003C资源>. \u003C触发场景>. \u003C副作用说明>.\n\nExample: Create a new issue in a GitHub repo. Use when the user\nasks to file, report, or open an issue. This makes a real API\ncall and will be visible to other repo collaborators.\n",[972,1323,1321],{"__ignoreMap":11},[1325,1326,1327,1334,1340],"ul",{},[1328,1329,1330,1333],"li",{},[928,1331,1332],{},"动作+资源","：让模型秒懂功能",[1328,1335,1336,1339],{},[928,1337,1338],{},"触发场景","：列出用户的自然语言触发词",[1328,1341,1342,1345],{},[928,1343,1344],{},"副作用说明","：警示模型\"这是会改变世界的操作\"",[892,1347,1349],{"id":1348},"inputschema契约越严越省心","inputSchema：契约越严越省心",[897,1351,1352],{},"JSON Schema 支持的特性请尽可能用满：",[1354,1355,1356],"h3",{"id":1356},"枚举",[964,1358,1360],{"className":986,"code":1359,"language":988,"meta":11,"style":11},"{\n  \"priority\": {\n    \"type\": \"string\",\n    \"enum\": [\"low\", \"medium\", \"high\", \"urgent\"],\n    \"description\": \"Issue priority level\"\n  }\n}\n",[972,1361,1362,1366,1373,1383,1411,1421,1425],{"__ignoreMap":11},[992,1363,1364],{"class":994,"line":995},[992,1365,999],{"class":998},[992,1367,1368,1371],{"class":994,"line":1002},[992,1369,1370],{"class":1005},"  \"priority\"",[992,1372,1038],{"class":998},[992,1374,1375,1377,1379,1381],{"class":994,"line":1019},[992,1376,1044],{"class":1005},[992,1378,1009],{"class":998},[992,1380,1076],{"class":1012},[992,1382,1016],{"class":998},[992,1384,1385,1388,1390,1393,1395,1398,1400,1403,1405,1408],{"class":994,"line":1032},[992,1386,1387],{"class":1005},"    \"enum\"",[992,1389,1213],{"class":998},[992,1391,1392],{"class":1012},"\"low\"",[992,1394,1079],{"class":998},[992,1396,1397],{"class":1012},"\"medium\"",[992,1399,1079],{"class":998},[992,1401,1402],{"class":1012},"\"high\"",[992,1404,1079],{"class":998},[992,1406,1407],{"class":1012},"\"urgent\"",[992,1409,1410],{"class":998},"],\n",[992,1412,1413,1416,1418],{"class":994,"line":1041},[992,1414,1415],{"class":1005},"    \"description\"",[992,1417,1009],{"class":998},[992,1419,1420],{"class":1012},"\"Issue priority level\"\n",[992,1422,1423],{"class":994,"line":1054},[992,1424,1235],{"class":998},[992,1426,1427],{"class":994,"line":1062},[992,1428,1241],{"class":998},[897,1430,1431],{},"Agent 看到 enum 会严格约束自己，比在 description 里写\"取值必须是 low\u002Fmedium\u002F...\"有效得多。",[1354,1433,1434],{"id":1434},"模式正则",[964,1436,1438],{"className":986,"code":1437,"language":988,"meta":11,"style":11},"{\n  \"email\": {\n    \"type\": \"string\",\n    \"pattern\": \"^[\\\\w.+-]+@[\\\\w-]+\\\\.[\\\\w.-]+$\"\n  }\n}\n",[972,1439,1440,1444,1451,1461,1492,1496],{"__ignoreMap":11},[992,1441,1442],{"class":994,"line":995},[992,1443,999],{"class":998},[992,1445,1446,1449],{"class":994,"line":1002},[992,1447,1448],{"class":1005},"  \"email\"",[992,1450,1038],{"class":998},[992,1452,1453,1455,1457,1459],{"class":994,"line":1019},[992,1454,1044],{"class":1005},[992,1456,1009],{"class":998},[992,1458,1076],{"class":1012},[992,1460,1016],{"class":998},[992,1462,1463,1466,1468,1471,1474,1477,1479,1482,1484,1487,1489],{"class":994,"line":1032},[992,1464,1465],{"class":1005},"    \"pattern\"",[992,1467,1009],{"class":998},[992,1469,1470],{"class":1012},"\"^[",[992,1472,1473],{"class":1005},"\\\\",[992,1475,1476],{"class":1012},"w.+-]+@[",[992,1478,1473],{"class":1005},[992,1480,1481],{"class":1012},"w-]+",[992,1483,1473],{"class":1005},[992,1485,1486],{"class":1012},".[",[992,1488,1473],{"class":1005},[992,1490,1491],{"class":1012},"w.-]+$\"\n",[992,1493,1494],{"class":994,"line":1041},[992,1495,1235],{"class":998},[992,1497,1498],{"class":994,"line":1054},[992,1499,1241],{"class":998},[1354,1501,1502],{"id":1502},"条件与组合",[964,1504,1506],{"className":986,"code":1505,"language":988,"meta":11,"style":11},"{\n  \"type\": \"object\",\n  \"properties\": {\n    \"mode\": { \"type\": \"string\", \"enum\": [\"fast\", \"accurate\"] },\n    \"timeout\": { \"type\": \"integer\" }\n  },\n  \"required\": [\"mode\"],\n  \"if\": { \"properties\": { \"mode\": { \"const\": \"accurate\" } } },\n  \"then\": { \"required\": [\"timeout\"] }\n}\n",[972,1507,1508,1512,1523,1530,1561,1578,1583,1595,1621,1639],{"__ignoreMap":11},[992,1509,1510],{"class":994,"line":995},[992,1511,999],{"class":998},[992,1513,1514,1517,1519,1521],{"class":994,"line":1002},[992,1515,1516],{"class":1005},"  \"type\"",[992,1518,1009],{"class":998},[992,1520,1049],{"class":1012},[992,1522,1016],{"class":998},[992,1524,1525,1528],{"class":994,"line":1019},[992,1526,1527],{"class":1005},"  \"properties\"",[992,1529,1038],{"class":998},[992,1531,1532,1535,1537,1539,1541,1543,1545,1548,1550,1553,1555,1558],{"class":994,"line":1032},[992,1533,1534],{"class":1005},"    \"mode\"",[992,1536,1175],{"class":998},[992,1538,1071],{"class":1005},[992,1540,1009],{"class":998},[992,1542,1076],{"class":1012},[992,1544,1079],{"class":998},[992,1546,1547],{"class":1005},"\"enum\"",[992,1549,1213],{"class":998},[992,1551,1552],{"class":1012},"\"fast\"",[992,1554,1079],{"class":998},[992,1556,1557],{"class":1012},"\"accurate\"",[992,1559,1560],{"class":998},"] },\n",[992,1562,1563,1566,1568,1570,1572,1575],{"class":994,"line":1041},[992,1564,1565],{"class":1005},"    \"timeout\"",[992,1567,1175],{"class":998},[992,1569,1071],{"class":1005},[992,1571,1009],{"class":998},[992,1573,1574],{"class":1012},"\"integer\"",[992,1576,1577],{"class":998}," }\n",[992,1579,1580],{"class":994,"line":1054},[992,1581,1582],{"class":998},"  },\n",[992,1584,1585,1588,1590,1593],{"class":994,"line":1062},[992,1586,1587],{"class":1005},"  \"required\"",[992,1589,1213],{"class":998},[992,1591,1592],{"class":1012},"\"mode\"",[992,1594,1410],{"class":998},[992,1596,1597,1600,1602,1605,1607,1609,1611,1614,1616,1618],{"class":994,"line":1093},[992,1598,1599],{"class":1005},"  \"if\"",[992,1601,1175],{"class":998},[992,1603,1604],{"class":1005},"\"properties\"",[992,1606,1175],{"class":998},[992,1608,1592],{"class":1005},[992,1610,1175],{"class":998},[992,1612,1613],{"class":1005},"\"const\"",[992,1615,1009],{"class":998},[992,1617,1557],{"class":1012},[992,1619,1620],{"class":998}," } } },\n",[992,1622,1623,1626,1628,1631,1633,1636],{"class":994,"line":1119},[992,1624,1625],{"class":1005},"  \"then\"",[992,1627,1175],{"class":998},[992,1629,1630],{"class":1005},"\"required\"",[992,1632,1213],{"class":998},[992,1634,1635],{"class":1012},"\"timeout\"",[992,1637,1638],{"class":998},"] }\n",[992,1640,1641],{"class":994,"line":1144},[992,1642,1241],{"class":998},[1354,1644,1645],{"id":1645},"数组元素约束",[964,1647,1649],{"className":986,"code":1648,"language":988,"meta":11,"style":11},"{\n  \"tags\": {\n    \"type\": \"array\",\n    \"items\": { \"type\": \"string\", \"minLength\": 1 },\n    \"minItems\": 1,\n    \"maxItems\": 10,\n    \"uniqueItems\": true\n  }\n}\n",[972,1650,1651,1655,1662,1672,1697,1708,1720,1730,1734],{"__ignoreMap":11},[992,1652,1653],{"class":994,"line":995},[992,1654,999],{"class":998},[992,1656,1657,1660],{"class":994,"line":1002},[992,1658,1659],{"class":1005},"  \"tags\"",[992,1661,1038],{"class":998},[992,1663,1664,1666,1668,1670],{"class":994,"line":1019},[992,1665,1044],{"class":1005},[992,1667,1009],{"class":998},[992,1669,1182],{"class":1012},[992,1671,1016],{"class":998},[992,1673,1674,1677,1679,1681,1683,1685,1687,1690,1692,1695],{"class":994,"line":1032},[992,1675,1676],{"class":1005},"    \"items\"",[992,1678,1175],{"class":998},[992,1680,1071],{"class":1005},[992,1682,1009],{"class":998},[992,1684,1076],{"class":1012},[992,1686,1079],{"class":998},[992,1688,1689],{"class":1005},"\"minLength\"",[992,1691,1009],{"class":998},[992,1693,1694],{"class":1005},"1",[992,1696,1090],{"class":998},[992,1698,1699,1702,1704,1706],{"class":994,"line":1041},[992,1700,1701],{"class":1005},"    \"minItems\"",[992,1703,1009],{"class":998},[992,1705,1694],{"class":1005},[992,1707,1016],{"class":998},[992,1709,1710,1713,1715,1718],{"class":994,"line":1054},[992,1711,1712],{"class":1005},"    \"maxItems\"",[992,1714,1009],{"class":998},[992,1716,1717],{"class":1005},"10",[992,1719,1016],{"class":998},[992,1721,1722,1725,1727],{"class":994,"line":1062},[992,1723,1724],{"class":1005},"    \"uniqueItems\"",[992,1726,1009],{"class":998},[992,1728,1729],{"class":1005},"true\n",[992,1731,1732],{"class":994,"line":1093},[992,1733,1235],{"class":998},[992,1735,1736],{"class":994,"line":1119},[992,1737,1241],{"class":998},[892,1739,1741],{"id":1740},"tool-annotations","Tool Annotations",[897,1743,1744,1745,1748],{},"MCP 1.0 引入了 ",[972,1746,1747],{},"annotations"," 字段，帮助客户端判断工具的\"性格\"，决定是否需要人工确认：",[964,1750,1752],{"className":986,"code":1751,"language":988,"meta":11,"style":11},"{\n  \"name\": \"delete_file\",\n  \"description\": \"Delete a file on the filesystem\",\n  \"annotations\": {\n    \"title\": \"Delete File\",\n    \"readOnlyHint\": false,\n    \"destructiveHint\": true,\n    \"idempotentHint\": true,\n    \"openWorldHint\": false\n  }\n}\n",[972,1753,1754,1758,1769,1780,1787,1799,1811,1823,1834,1844,1848],{"__ignoreMap":11},[992,1755,1756],{"class":994,"line":995},[992,1757,999],{"class":998},[992,1759,1760,1762,1764,1767],{"class":994,"line":1002},[992,1761,1006],{"class":1005},[992,1763,1009],{"class":998},[992,1765,1766],{"class":1012},"\"delete_file\"",[992,1768,1016],{"class":998},[992,1770,1771,1773,1775,1778],{"class":994,"line":1019},[992,1772,1022],{"class":1005},[992,1774,1009],{"class":998},[992,1776,1777],{"class":1012},"\"Delete a file on the filesystem\"",[992,1779,1016],{"class":998},[992,1781,1782,1785],{"class":994,"line":1032},[992,1783,1784],{"class":1005},"  \"annotations\"",[992,1786,1038],{"class":998},[992,1788,1789,1792,1794,1797],{"class":994,"line":1041},[992,1790,1791],{"class":1005},"    \"title\"",[992,1793,1009],{"class":998},[992,1795,1796],{"class":1012},"\"Delete File\"",[992,1798,1016],{"class":998},[992,1800,1801,1804,1806,1809],{"class":994,"line":1054},[992,1802,1803],{"class":1005},"    \"readOnlyHint\"",[992,1805,1009],{"class":998},[992,1807,1808],{"class":1005},"false",[992,1810,1016],{"class":998},[992,1812,1813,1816,1818,1821],{"class":994,"line":1062},[992,1814,1815],{"class":1005},"    \"destructiveHint\"",[992,1817,1009],{"class":998},[992,1819,1820],{"class":1005},"true",[992,1822,1016],{"class":998},[992,1824,1825,1828,1830,1832],{"class":994,"line":1093},[992,1826,1827],{"class":1005},"    \"idempotentHint\"",[992,1829,1009],{"class":998},[992,1831,1820],{"class":1005},[992,1833,1016],{"class":998},[992,1835,1836,1839,1841],{"class":994,"line":1119},[992,1837,1838],{"class":1005},"    \"openWorldHint\"",[992,1840,1009],{"class":998},[992,1842,1843],{"class":1005},"false\n",[992,1845,1846],{"class":994,"line":1144},[992,1847,1235],{"class":998},[992,1849,1850],{"class":994,"line":1169},[992,1851,1241],{"class":998},[901,1853,1854,1867],{},[904,1855,1856],{},[907,1857,1858,1861,1864],{},[910,1859,1860],{},"Annotation",[910,1862,1863],{},"含义",[910,1865,1866],{},"典型用途",[920,1868,1869,1882,1895,1908,1921],{},[907,1870,1871,1876,1879],{},[925,1872,1873],{},[972,1874,1875],{},"title",[925,1877,1878],{},"面向用户的友好名称",[925,1880,1881],{},"UI 显示",[907,1883,1884,1889,1892],{},[925,1885,1886],{},[972,1887,1888],{},"readOnlyHint",[925,1890,1891],{},"是否只读",[925,1893,1894],{},"只读工具可跳过确认",[907,1896,1897,1902,1905],{},[925,1898,1899],{},[972,1900,1901],{},"destructiveHint",[925,1903,1904],{},"是否可能破坏性",[925,1906,1907],{},"触发人工确认",[907,1909,1910,1915,1918],{},[925,1911,1912],{},[972,1913,1914],{},"idempotentHint",[925,1916,1917],{},"重复调用是否安全",[925,1919,1920],{},"失败重试策略",[907,1922,1923,1928,1931],{},[925,1924,1925],{},[972,1926,1927],{},"openWorldHint",[925,1929,1930],{},"是否与外部世界交互",[925,1932,1933],{},"区分纯计算 vs 联网",[1935,1936,1937],"note",{},"\nannotations 只是 hint（暗示），不是安全边界。真正的权限控制必须在 server 侧强制。\n",[892,1939,1941],{"id":1940},"tool-的执行流","Tool 的执行流",[964,1943,1946],{"className":1944,"code":1945,"language":969,"meta":970},[967],"sequenceDiagram\n    participant U as 用户\n    participant L as LLM\n    participant C as MCP Client\n    participant S as MCP Server\n    participant Ext as 外部系统\n    U->>L: \"给仓库 foo\u002Fbar 开个 bug issue\"\n    L->>C: tools\u002Fcall { name: \"create_issue\", args }\n    C->>S: JSON-RPC 请求\n    S->>S: 校验 Schema + 权限\n    S->>Ext: POST \u002Frepos\u002Ffoo\u002Fbar\u002Fissues\n    Ext-->>S: 201 Created\n    S-->>C: { content: [{ type: \"text\", text: \"Issue #42 created\" }] }\n    C-->>L: 工具返回\n    L-->>U: \"已创建 Issue #42: ...\"\n",[972,1947,1945],{"__ignoreMap":11},[897,1949,1950],{},"关键点：",[1952,1953,1954,1961,1968],"ol",{},[1328,1955,1956,1957,1960],{},"Server 必须",[928,1958,1959],{},"再次校验","输入，不能信任 client 传来的参数",[1328,1962,1963,1964,1967],{},"返回结构是 ",[972,1965,1966],{},"content"," 数组，支持多种类型（text \u002F image \u002F resource 引用）",[1328,1969,1970,1971,1974],{},"异常通过 ",[972,1972,1973],{},"isError: true"," 返回，而不是 JSON-RPC error（让模型能看到错误消息并自我修复）",[892,1976,1977],{"id":1977},"返回内容的类型",[964,1979,1981],{"className":986,"code":1980,"language":988,"meta":11,"style":11},"{\n  \"content\": [\n    { \"type\": \"text\", \"text\": \"处理完成，共生成 3 个文件\" },\n    { \"type\": \"image\", \"data\": \"\u003Cbase64>\", \"mimeType\": \"image\u002Fpng\" },\n    {\n      \"type\": \"resource\",\n      \"resource\": {\n        \"uri\": \"file:\u002F\u002F\u002Ftmp\u002Freport.pdf\",\n        \"mimeType\": \"application\u002Fpdf\"\n      }\n    }\n  ],\n  \"isError\": false\n}\n",[972,1982,1983,1987,1995,2018,2051,2056,2068,2075,2087,2097,2102,2107,2112,2121],{"__ignoreMap":11},[992,1984,1985],{"class":994,"line":995},[992,1986,999],{"class":998},[992,1988,1989,1992],{"class":994,"line":1002},[992,1990,1991],{"class":1005},"  \"content\"",[992,1993,1994],{"class":998},": [\n",[992,1996,1997,2000,2002,2004,2007,2009,2011,2013,2016],{"class":994,"line":1019},[992,1998,1999],{"class":998},"    { ",[992,2001,1071],{"class":1005},[992,2003,1009],{"class":998},[992,2005,2006],{"class":1012},"\"text\"",[992,2008,1079],{"class":998},[992,2010,2006],{"class":1005},[992,2012,1009],{"class":998},[992,2014,2015],{"class":1012},"\"处理完成，共生成 3 个文件\"",[992,2017,1090],{"class":998},[992,2019,2020,2022,2024,2026,2029,2031,2034,2036,2039,2041,2044,2046,2049],{"class":994,"line":1032},[992,2021,1999],{"class":998},[992,2023,1071],{"class":1005},[992,2025,1009],{"class":998},[992,2027,2028],{"class":1012},"\"image\"",[992,2030,1079],{"class":998},[992,2032,2033],{"class":1005},"\"data\"",[992,2035,1009],{"class":998},[992,2037,2038],{"class":1012},"\"\u003Cbase64>\"",[992,2040,1079],{"class":998},[992,2042,2043],{"class":1005},"\"mimeType\"",[992,2045,1009],{"class":998},[992,2047,2048],{"class":1012},"\"image\u002Fpng\"",[992,2050,1090],{"class":998},[992,2052,2053],{"class":994,"line":1041},[992,2054,2055],{"class":998},"    {\n",[992,2057,2058,2061,2063,2066],{"class":994,"line":1054},[992,2059,2060],{"class":1005},"      \"type\"",[992,2062,1009],{"class":998},[992,2064,2065],{"class":1012},"\"resource\"",[992,2067,1016],{"class":998},[992,2069,2070,2073],{"class":994,"line":1062},[992,2071,2072],{"class":1005},"      \"resource\"",[992,2074,1038],{"class":998},[992,2076,2077,2080,2082,2085],{"class":994,"line":1093},[992,2078,2079],{"class":1005},"        \"uri\"",[992,2081,1009],{"class":998},[992,2083,2084],{"class":1012},"\"file:\u002F\u002F\u002Ftmp\u002Freport.pdf\"",[992,2086,1016],{"class":998},[992,2088,2089,2092,2094],{"class":994,"line":1119},[992,2090,2091],{"class":1005},"        \"mimeType\"",[992,2093,1009],{"class":998},[992,2095,2096],{"class":1012},"\"application\u002Fpdf\"\n",[992,2098,2099],{"class":994,"line":1144},[992,2100,2101],{"class":998},"      }\n",[992,2103,2104],{"class":994,"line":1169},[992,2105,2106],{"class":998},"    }\n",[992,2108,2109],{"class":994,"line":1201},[992,2110,2111],{"class":998},"  ],\n",[992,2113,2114,2117,2119],{"class":994,"line":1207},[992,2115,2116],{"class":1005},"  \"isError\"",[992,2118,1009],{"class":998},[992,2120,1843],{"class":1005},[992,2122,2123],{"class":994,"line":1232},[992,2124,1241],{"class":998},[897,2126,2127,2130],{},[928,2128,2129],{},"实践建议","：",[1325,2132,2133,2139,2146,2153],{},[1328,2134,2135,2136,2138],{},"小结构化数据：放在 ",[972,2137,969],{}," 里（JSON 字符串）",[1328,2140,2141,2142,2145],{},"大文件 \u002F 二进制：用 ",[972,2143,2144],{},"resource"," 引用，让 client 按需读取",[1328,2147,2148,2149,2152],{},"图片 \u002F 截图：",[972,2150,2151],{},"image"," 类型",[1328,2154,2155,2156,2158],{},"错误信息：设置 ",[972,2157,1973],{}," 并在 text 里写清楚失败原因",[892,2160,2162],{"id":2161},"设计-tool-的-8-条原则","设计 Tool 的 8 条原则",[1354,2164,2166],{"id":2165},"_1-动词开头单一动作","1. 动词开头，单一动作",[964,2168,2171],{"className":2169,"code":2170,"language":969,"meta":11},[967],"✅ create_issue     search_files    send_email\n❌ issue            file_helper     email_tool\n",[972,2172,2170],{"__ignoreMap":11},[1354,2174,2176],{"id":2175},"_2-粒度适中","2. 粒度适中",[897,2178,2179],{},"太细：每个参数一个工具 → 模型困惑\n太粗：一个工具做 10 件事 → 参数爆炸",[897,2181,2182,2183,2186],{},"经验法则：",[928,2184,2185],{},"一个工具对应一个 HTTP API 或一条 CLI 命令","。",[1354,2188,2190],{"id":2189},"_3-失败要会说话","3. 失败要会说话",[964,2192,2194],{"className":986,"code":2193,"language":988,"meta":11,"style":11},"{\n  \"content\": [{\n    \"type\": \"text\",\n    \"text\": \"创建失败：仓库 foo\u002Fbar 不存在。可用操作：1) 检查仓库名拼写 2) 使用 list_repos 列出可用仓库\"\n  }],\n  \"isError\": true\n}\n",[972,2195,2196,2200,2207,2217,2227,2232,2240],{"__ignoreMap":11},[992,2197,2198],{"class":994,"line":995},[992,2199,999],{"class":998},[992,2201,2202,2204],{"class":994,"line":1002},[992,2203,1991],{"class":1005},[992,2205,2206],{"class":998},": [{\n",[992,2208,2209,2211,2213,2215],{"class":994,"line":1019},[992,2210,1044],{"class":1005},[992,2212,1009],{"class":998},[992,2214,2006],{"class":1012},[992,2216,1016],{"class":998},[992,2218,2219,2222,2224],{"class":994,"line":1032},[992,2220,2221],{"class":1005},"    \"text\"",[992,2223,1009],{"class":998},[992,2225,2226],{"class":1012},"\"创建失败：仓库 foo\u002Fbar 不存在。可用操作：1) 检查仓库名拼写 2) 使用 list_repos 列出可用仓库\"\n",[992,2228,2229],{"class":994,"line":1041},[992,2230,2231],{"class":998},"  }],\n",[992,2233,2234,2236,2238],{"class":994,"line":1054},[992,2235,2116],{"class":1005},[992,2237,1009],{"class":998},[992,2239,1729],{"class":1005},[992,2241,2242],{"class":994,"line":1062},[992,2243,1241],{"class":998},[897,2245,2246,2247,2250],{},"给模型一条",[928,2248,2249],{},"自我修复的路径","，而不是只丢一个 stack trace。",[1354,2252,2254],{"id":2253},"_4-副作用显式化","4. 副作用显式化",[897,2256,2257],{},"在 description 里明确写：",[964,2259,2262],{"className":2260,"code":2261,"language":969,"meta":11},[967],"Side effects: makes a real HTTP POST to GitHub API.\nVisible to repo collaborators. Costs 1 API quota.\n",[972,2263,2261],{"__ignoreMap":11},[1354,2265,2267],{"id":2266},"_5-幂等优先","5. 幂等优先",[897,2269,2270,2271,2274,2275,2278,2279,2282],{},"能设计成幂等的就别做成一次性的。例如 ",[972,2272,2273],{},"upsert_record"," 优于 ",[972,2276,2277],{},"create_record"," + ",[972,2280,2281],{},"update_record"," 两个工具。",[1354,2284,2286],{"id":2285},"_6-参数扁平优先","6. 参数\"扁平优先\"",[964,2288,2290],{"className":986,"code":2289,"language":988,"meta":11,"style":11},"\u002F\u002F ❌ 深嵌套让模型难组装\n{ \"config\": { \"auth\": { \"credentials\": { \"token\": \"...\" } } } }\n\n\u002F\u002F ✅ 扁平\n{ \"token\": \"...\" }\n",[972,2291,2292,2298,2329,2335,2340],{"__ignoreMap":11},[992,2293,2294],{"class":994,"line":995},[992,2295,2297],{"class":2296},"sCsY4","\u002F\u002F ❌ 深嵌套让模型难组装\n",[992,2299,2300,2303,2306,2308,2311,2313,2316,2318,2321,2323,2326],{"class":994,"line":1002},[992,2301,2302],{"class":998},"{ ",[992,2304,2305],{"class":1005},"\"config\"",[992,2307,1175],{"class":998},[992,2309,2310],{"class":1005},"\"auth\"",[992,2312,1175],{"class":998},[992,2314,2315],{"class":1005},"\"credentials\"",[992,2317,1175],{"class":998},[992,2319,2320],{"class":1005},"\"token\"",[992,2322,1009],{"class":998},[992,2324,2325],{"class":1012},"\"...\"",[992,2327,2328],{"class":998}," } } } }\n",[992,2330,2331],{"class":994,"line":1019},[992,2332,2334],{"emptyLinePlaceholder":2333},true,"\n",[992,2336,2337],{"class":994,"line":1032},[992,2338,2339],{"class":2296},"\u002F\u002F ✅ 扁平\n",[992,2341,2342,2344,2346,2348,2350],{"class":994,"line":1041},[992,2343,2302],{"class":998},[992,2345,2320],{"class":1005},[992,2347,1009],{"class":998},[992,2349,2325],{"class":1012},[992,2351,1577],{"class":998},[1354,2353,2355],{"id":2354},"_7-默认值放-schema","7. 默认值放 Schema",[964,2357,2359],{"className":986,"code":2358,"language":988,"meta":11,"style":11},"{\n  \"timeout\": {\n    \"type\": \"integer\",\n    \"default\": 30,\n    \"description\": \"Request timeout in seconds (default 30)\"\n  }\n}\n",[972,2360,2361,2365,2372,2382,2394,2403,2407],{"__ignoreMap":11},[992,2362,2363],{"class":994,"line":995},[992,2364,999],{"class":998},[992,2366,2367,2370],{"class":994,"line":1002},[992,2368,2369],{"class":1005},"  \"timeout\"",[992,2371,1038],{"class":998},[992,2373,2374,2376,2378,2380],{"class":994,"line":1019},[992,2375,1044],{"class":1005},[992,2377,1009],{"class":998},[992,2379,1574],{"class":1012},[992,2381,1016],{"class":998},[992,2383,2384,2387,2389,2392],{"class":994,"line":1032},[992,2385,2386],{"class":1005},"    \"default\"",[992,2388,1009],{"class":998},[992,2390,2391],{"class":1005},"30",[992,2393,1016],{"class":998},[992,2395,2396,2398,2400],{"class":994,"line":1041},[992,2397,1415],{"class":1005},[992,2399,1009],{"class":998},[992,2401,2402],{"class":1012},"\"Request timeout in seconds (default 30)\"\n",[992,2404,2405],{"class":994,"line":1054},[992,2406,1235],{"class":998},[992,2408,2409],{"class":994,"line":1062},[992,2410,1241],{"class":998},[897,2412,2413],{},"避免模型每次都得传所有参数。",[1354,2415,2417],{"id":2416},"_8-避免重名歧义","8. 避免重名歧义",[897,2419,2420,2421,2424,2425,2186],{},"如果同一个会话接入了多个 server，工具名可能冲突。建议用前缀：",[972,2422,2423],{},"github_create_issue"," \u002F ",[972,2426,2427],{},"jira_create_issue",[892,2429,2430],{"id":2430},"权限与安全",[897,2432,2433],{},"Tools 可以改变世界，安全红线必须在 server 侧强制：",[964,2435,2439],{"className":2436,"code":2437,"language":2438,"meta":11,"style":11},"language-python shiki shiki-themes github-light github-light github-dark","@server.tool()\ndef delete_file(path: str):\n    # 1. 路径白名单\n    allowed_root = Path(\"\u002Fworkspace\")\n    target = (allowed_root \u002F path).resolve()\n    if allowed_root not in target.parents:\n        return error(\"路径越界\")\n\n    # 2. 敏感文件保护\n    if target.name in {\".env\", \"credentials.json\"}:\n        return error(\"禁止删除敏感文件\")\n\n    # 3. 需要人工确认的操作\n    if target.stat().st_size > 100 * 1024 * 1024:\n        return error(\"文件过大，请先人工确认\")\n\n    target.unlink()\n    return ok(f\"已删除 {path}\")\n","python",[972,2440,2441,2450,2468,2473,2490,2506,2523,2536,2540,2545,2569,2580,2584,2589,2615,2626,2631,2637],{"__ignoreMap":11},[992,2442,2443,2447],{"class":994,"line":995},[992,2444,2446],{"class":2445},"snPdu","@server.tool",[992,2448,2449],{"class":998},"()\n",[992,2451,2452,2456,2459,2462,2465],{"class":994,"line":1002},[992,2453,2455],{"class":2454},"s8jYJ","def",[992,2457,2458],{"class":2445}," delete_file",[992,2460,2461],{"class":998},"(path: ",[992,2463,2464],{"class":1005},"str",[992,2466,2467],{"class":998},"):\n",[992,2469,2470],{"class":994,"line":1019},[992,2471,2472],{"class":2296},"    # 1. 路径白名单\n",[992,2474,2475,2478,2481,2484,2487],{"class":994,"line":1032},[992,2476,2477],{"class":998},"    allowed_root ",[992,2479,2480],{"class":2454},"=",[992,2482,2483],{"class":998}," Path(",[992,2485,2486],{"class":1012},"\"\u002Fworkspace\"",[992,2488,2489],{"class":998},")\n",[992,2491,2492,2495,2497,2500,2503],{"class":994,"line":1041},[992,2493,2494],{"class":998},"    target ",[992,2496,2480],{"class":2454},[992,2498,2499],{"class":998}," (allowed_root ",[992,2501,2502],{"class":2454},"\u002F",[992,2504,2505],{"class":998}," path).resolve()\n",[992,2507,2508,2511,2514,2517,2520],{"class":994,"line":1054},[992,2509,2510],{"class":2454},"    if",[992,2512,2513],{"class":998}," allowed_root ",[992,2515,2516],{"class":2454},"not",[992,2518,2519],{"class":2454}," in",[992,2521,2522],{"class":998}," target.parents:\n",[992,2524,2525,2528,2531,2534],{"class":994,"line":1062},[992,2526,2527],{"class":2454},"        return",[992,2529,2530],{"class":998}," error(",[992,2532,2533],{"class":1012},"\"路径越界\"",[992,2535,2489],{"class":998},[992,2537,2538],{"class":994,"line":1093},[992,2539,2334],{"emptyLinePlaceholder":2333},[992,2541,2542],{"class":994,"line":1119},[992,2543,2544],{"class":2296},"    # 2. 敏感文件保护\n",[992,2546,2547,2549,2552,2555,2558,2561,2563,2566],{"class":994,"line":1144},[992,2548,2510],{"class":2454},[992,2550,2551],{"class":998}," target.name ",[992,2553,2554],{"class":2454},"in",[992,2556,2557],{"class":998}," {",[992,2559,2560],{"class":1012},"\".env\"",[992,2562,1079],{"class":998},[992,2564,2565],{"class":1012},"\"credentials.json\"",[992,2567,2568],{"class":998},"}:\n",[992,2570,2571,2573,2575,2578],{"class":994,"line":1169},[992,2572,2527],{"class":2454},[992,2574,2530],{"class":998},[992,2576,2577],{"class":1012},"\"禁止删除敏感文件\"",[992,2579,2489],{"class":998},[992,2581,2582],{"class":994,"line":1201},[992,2583,2334],{"emptyLinePlaceholder":2333},[992,2585,2586],{"class":994,"line":1207},[992,2587,2588],{"class":2296},"    # 3. 需要人工确认的操作\n",[992,2590,2591,2593,2596,2599,2602,2605,2608,2610,2612],{"class":994,"line":1232},[992,2592,2510],{"class":2454},[992,2594,2595],{"class":998}," target.stat().st_size ",[992,2597,2598],{"class":2454},">",[992,2600,2601],{"class":1005}," 100",[992,2603,2604],{"class":2454}," *",[992,2606,2607],{"class":1005}," 1024",[992,2609,2604],{"class":2454},[992,2611,2607],{"class":1005},[992,2613,2614],{"class":998},":\n",[992,2616,2617,2619,2621,2624],{"class":994,"line":1238},[992,2618,2527],{"class":2454},[992,2620,2530],{"class":998},[992,2622,2623],{"class":1012},"\"文件过大，请先人工确认\"",[992,2625,2489],{"class":998},[992,2627,2629],{"class":994,"line":2628},16,[992,2630,2334],{"emptyLinePlaceholder":2333},[992,2632,2634],{"class":994,"line":2633},17,[992,2635,2636],{"class":998},"    target.unlink()\n",[992,2638,2640,2643,2646,2649,2652,2655,2658,2661,2664],{"class":994,"line":2639},18,[992,2641,2642],{"class":2454},"    return",[992,2644,2645],{"class":998}," ok(",[992,2647,2648],{"class":2454},"f",[992,2650,2651],{"class":1012},"\"已删除 ",[992,2653,2654],{"class":1005},"{",[992,2656,2657],{"class":998},"path",[992,2659,2660],{"class":1005},"}",[992,2662,2663],{"class":1012},"\"",[992,2665,2489],{"class":998},[897,2667,2668,2671],{},[928,2669,2670],{},"永远不要","依赖模型\"自律\"——模型会被 prompt 注入。所有限制必须是 server 侧的硬规则。",[892,2673,2674],{"id":2674},"动态工具列表",[897,2676,2677],{},"Server 可以根据用户身份、时间、环境动态返回 tools 列表：",[964,2679,2681],{"className":2436,"code":2680,"language":2438,"meta":11,"style":11},"@server.list_tools()\nasync def list_tools(ctx):\n    tools = [base_tools]\n    if ctx.user.is_admin:\n        tools.extend(admin_only_tools)\n    if feature_flag(\"beta\"):\n        tools.append(experimental_tool)\n    return tools\n",[972,2682,2683,2690,2704,2714,2721,2726,2738,2743],{"__ignoreMap":11},[992,2684,2685,2688],{"class":994,"line":995},[992,2686,2687],{"class":2445},"@server.list_tools",[992,2689,2449],{"class":998},[992,2691,2692,2695,2698,2701],{"class":994,"line":1002},[992,2693,2694],{"class":2454},"async",[992,2696,2697],{"class":2454}," def",[992,2699,2700],{"class":2445}," list_tools",[992,2702,2703],{"class":998},"(ctx):\n",[992,2705,2706,2709,2711],{"class":994,"line":1019},[992,2707,2708],{"class":998},"    tools ",[992,2710,2480],{"class":2454},[992,2712,2713],{"class":998}," [base_tools]\n",[992,2715,2716,2718],{"class":994,"line":1032},[992,2717,2510],{"class":2454},[992,2719,2720],{"class":998}," ctx.user.is_admin:\n",[992,2722,2723],{"class":994,"line":1041},[992,2724,2725],{"class":998},"        tools.extend(admin_only_tools)\n",[992,2727,2728,2730,2733,2736],{"class":994,"line":1054},[992,2729,2510],{"class":2454},[992,2731,2732],{"class":998}," feature_flag(",[992,2734,2735],{"class":1012},"\"beta\"",[992,2737,2467],{"class":998},[992,2739,2740],{"class":994,"line":1062},[992,2741,2742],{"class":998},"        tools.append(experimental_tool)\n",[992,2744,2745,2747],{"class":994,"line":1093},[992,2746,2642],{"class":2454},[992,2748,2749],{"class":998}," tools\n",[897,2751,2752,2753,2756],{},"Client 会在 ",[972,2754,2755],{},"tools\u002Flist_changed"," 通知后重新拉取，实现热更新。",[892,2758,2759],{"id":2759},"调试技巧",[901,2761,2762,2772],{},[904,2763,2764],{},[907,2765,2766,2769],{},[910,2767,2768],{},"症状",[910,2770,2771],{},"可能原因",[920,2773,2774,2782,2790,2798],{},[907,2775,2776,2779],{},[925,2777,2778],{},"工具从不被调用",[925,2780,2781],{},"description 太泛 \u002F 与其他工具重复",[907,2783,2784,2787],{},[925,2785,2786],{},"参数错乱",[925,2788,2789],{},"Schema 缺 description 或 enum",[907,2791,2792,2795],{},[925,2793,2794],{},"模型重复调用同一工具",[925,2796,2797],{},"返回内容没有明确\"下一步\"提示",[907,2799,2800,2803],{},[925,2801,2802],{},"模型放弃工具改为纯推理",[925,2804,2805],{},"工具报错信息不清晰",[897,2807,2808,2809,2186],{},"更多排查技巧见 ",[2810,2811,2812],"a",{"href":77},"MCP 调试",[892,2814,2815],{"id":2815},"小结",[897,2817,2818],{},"Tools 是 MCP 里最\"实干\"的能力：",[1325,2820,2821,2827,2833,2839],{},[1328,2822,2823,2826],{},[928,2824,2825],{},"description + Schema 是契约","，写得细=模型用得对",[1328,2828,2829,2832],{},[928,2830,2831],{},"annotations 是暗示","，权限还得 server 硬控",[1328,2834,2835,2838],{},[928,2836,2837],{},"返回要给出下一步","，帮模型自我修复",[1328,2840,2841,2844],{},[928,2842,2843],{},"幂等 + 扁平 + 动词命名"," 是长期友好的设计",[897,2846,2847,2848,2850],{},"下一章 ",[2810,2849,2812],{"href":77}," 将介绍如何定位 Server 在真实 Agent 场景下出现的各类问题。",[2852,2853,2854],"style",{},"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 .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 .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 .s8jYJ, html code.shiki .s8jYJ{--shiki-light:#D73A49;--shiki-default:#D73A49;--shiki-dark:#F97583}",{"title":11,"searchDepth":1002,"depth":1002,"links":2856},[2857,2858,2859,2860,2866,2867,2868,2869,2879,2880,2881,2882],{"id":894,"depth":1002,"text":895},{"id":979,"depth":1002,"text":980},{"id":1309,"depth":1002,"text":1310},{"id":1348,"depth":1002,"text":1349,"children":2861},[2862,2863,2864,2865],{"id":1356,"depth":1019,"text":1356},{"id":1434,"depth":1019,"text":1434},{"id":1502,"depth":1019,"text":1502},{"id":1645,"depth":1019,"text":1645},{"id":1740,"depth":1002,"text":1741},{"id":1940,"depth":1002,"text":1941},{"id":1977,"depth":1002,"text":1977},{"id":2161,"depth":1002,"text":2162,"children":2870},[2871,2872,2873,2874,2875,2876,2877,2878],{"id":2165,"depth":1019,"text":2166},{"id":2175,"depth":1019,"text":2176},{"id":2189,"depth":1019,"text":2190},{"id":2253,"depth":1019,"text":2254},{"id":2266,"depth":1019,"text":2267},{"id":2285,"depth":1019,"text":2286},{"id":2354,"depth":1019,"text":2355},{"id":2416,"depth":1019,"text":2417},{"id":2430,"depth":1002,"text":2430},{"id":2674,"depth":1002,"text":2674},{"id":2759,"depth":1002,"text":2759},{"id":2815,"depth":1002,"text":2815},"md",{},{"title":90,"description":91},"ai\u002Fmcp\u002Ftools","6vsA0isqIkZi0loDOrw4KAB97yZqGAaM1wbRG4NfFbU",1775474636395]