[{"data":1,"prerenderedAt":2783},["ShallowReactive",2],{"search-docs":3,"doc-\u002Fai\u002Fmcp\u002Fdebugging":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":78,"body":888,"description":79,"extension":2778,"meta":2779,"navigation":1232,"path":77,"seo":2780,"stem":2781,"__hash__":2782},"docs\u002Fai\u002Fmcp\u002Fdebugging.md",{"type":889,"value":890,"toc":2745},"minimark",[891,895,899,910,913,917,922,925,972,975,979,991,994,1034,1037,1122,1125,1129,1136,1155,1158,1174,1179,1183,1186,1193,1255,1258,1262,1335,1339,1342,1363,1366,1369,1416,1419,1500,1504,1511,1515,1518,1564,1570,1576,1580,1583,1681,1688,1692,1695,1698,1732,1735,1782,1785,1789,1792,1795,1835,1838,1891,1894,1898,1901,1904,1924,1972,1975,1978,2125,2132,2167,2171,2174,2304,2307,2311,2314,2390,2393,2396,2485,2489,2492,2514,2517,2630,2633,2636,2700,2703,2706,2738,2741],[892,893,894],"h2",{"id":894},"调试的三个层次",[896,897,898],"p",{},"MCP 出问题时，首先判断症结在哪一层：",[900,901,907],"pre",{"className":902,"code":904,"language":905,"meta":906},[903],"language-text","flowchart TD\n    Issue[\"出现问题\"]\n    Issue --> L1{\"Server 能\u003Cbr\u002F>独立跑吗?\"}\n    L1 -->|不能| Lvl1[\"① Server 本身问题\u003Cbr\u002F>语法 \u002F 依赖 \u002F 启动\"]\n    L1 -->|能| L2{\"Client 能\u003Cbr\u002F>成功握手吗?\"}\n    L2 -->|不能| Lvl2[\"② 协议 \u002F 传输问题\u003Cbr\u002F>stdio \u002F HTTP \u002F 版本\"]\n    L2 -->|能| L3{\"模型调用时\u003Cbr\u002F>行为正常吗?\"}\n    L3 -->|不正常| Lvl3[\"③ 模型决策问题\u003Cbr\u002F>description \u002F schema\"]\n    L3 -->|正常| Done[\"✅ 正常\"]\n","text","mermaid",[908,909,904],"code",{"__ignoreMap":11},[896,911,912],{},"自上而下排除，比乱试有效得多。",[892,914,916],{"id":915},"层级一server-本身","层级一：Server 本身",[918,919,921],"h3",{"id":920},"脱离-mcp-client-单独运行","脱离 MCP Client 单独运行",[896,923,924],{},"最快的冒烟测试：直接用 stdio 喂 JSON-RPC。",[900,926,930],{"className":927,"code":928,"language":929,"meta":11,"style":11},"language-bash shiki shiki-themes github-light github-light github-dark","# 以 Python MCP Server 为例\necho '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"initialize\",\"params\":{\"protocolVersion\":\"2024-11-05\",\"capabilities\":{},\"clientInfo\":{\"name\":\"test\",\"version\":\"0.0.1\"}}}' \\\n  | python -m my_server\n","bash",[908,931,932,941,955],{"__ignoreMap":11},[933,934,937],"span",{"class":935,"line":936},"line",1,[933,938,940],{"class":939},"sCsY4","# 以 Python MCP Server 为例\n",[933,942,944,948,952],{"class":935,"line":943},2,[933,945,947],{"class":946},"sBjJW","echo",[933,949,951],{"class":950},"sIIMD"," '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"initialize\",\"params\":{\"protocolVersion\":\"2024-11-05\",\"capabilities\":{},\"clientInfo\":{\"name\":\"test\",\"version\":\"0.0.1\"}}}'",[933,953,954],{"class":946}," \\\n",[933,956,958,962,966,969],{"class":935,"line":957},3,[933,959,961],{"class":960},"s8jYJ","  |",[933,963,965],{"class":964},"snPdu"," python",[933,967,968],{"class":946}," -m",[933,970,971],{"class":950}," my_server\n",[896,973,974],{},"如果这一步都 hang 住或报错，问题在 server 启动逻辑上，跟 MCP 协议无关。",[918,976,978],{"id":977},"看标准错误不要看标准输出","看标准错误，不要看标准输出",[896,980,981,982,986,987,990],{},"MCP 的 stdio 传输占用 ",[983,984,985],"strong",{},"stdout","，所有调试日志必须走 ",[983,988,989],{},"stderr","。",[896,992,993],{},"❌ 错误做法：",[900,995,999],{"className":996,"code":997,"language":998,"meta":11,"style":11},"language-python shiki shiki-themes github-light github-light github-dark","print(f\"received request: {req}\")  # 污染了协议流\n","python",[908,1000,1001],{"__ignoreMap":11},[933,1002,1003,1006,1010,1013,1016,1019,1022,1025,1028,1031],{"class":935,"line":936},[933,1004,1005],{"class":946},"print",[933,1007,1009],{"class":1008},"sxrX7","(",[933,1011,1012],{"class":960},"f",[933,1014,1015],{"class":950},"\"received request: ",[933,1017,1018],{"class":946},"{",[933,1020,1021],{"class":1008},"req",[933,1023,1024],{"class":946},"}",[933,1026,1027],{"class":950},"\"",[933,1029,1030],{"class":1008},")  ",[933,1032,1033],{"class":939},"# 污染了协议流\n",[896,1035,1036],{},"✅ 正确做法：",[900,1038,1040],{"className":996,"code":1039,"language":998,"meta":11,"style":11},"import sys\nprint(f\"received request: {req}\", file=sys.stderr)\n# 或\nimport logging\nlogging.basicConfig(stream=sys.stderr, level=logging.DEBUG)\n",[908,1041,1042,1050,1081,1086,1094],{"__ignoreMap":11},[933,1043,1044,1047],{"class":935,"line":936},[933,1045,1046],{"class":960},"import",[933,1048,1049],{"class":1008}," sys\n",[933,1051,1052,1054,1056,1058,1060,1062,1064,1066,1068,1071,1075,1078],{"class":935,"line":943},[933,1053,1005],{"class":946},[933,1055,1009],{"class":1008},[933,1057,1012],{"class":960},[933,1059,1015],{"class":950},[933,1061,1018],{"class":946},[933,1063,1021],{"class":1008},[933,1065,1024],{"class":946},[933,1067,1027],{"class":950},[933,1069,1070],{"class":1008},", ",[933,1072,1074],{"class":1073},"sP4rz","file",[933,1076,1077],{"class":960},"=",[933,1079,1080],{"class":1008},"sys.stderr)\n",[933,1082,1083],{"class":935,"line":957},[933,1084,1085],{"class":939},"# 或\n",[933,1087,1089,1091],{"class":935,"line":1088},4,[933,1090,1046],{"class":960},[933,1092,1093],{"class":1008}," logging\n",[933,1095,1097,1100,1103,1105,1108,1111,1113,1116,1119],{"class":935,"line":1096},5,[933,1098,1099],{"class":1008},"logging.basicConfig(",[933,1101,1102],{"class":1073},"stream",[933,1104,1077],{"class":960},[933,1106,1107],{"class":1008},"sys.stderr, ",[933,1109,1110],{"class":1073},"level",[933,1112,1077],{"class":960},[933,1114,1115],{"class":1008},"logging.",[933,1117,1118],{"class":946},"DEBUG",[933,1120,1121],{"class":1008},")\n",[896,1123,1124],{},"凡是\"client 说收到的响应不是合法 JSON\"——90% 是你往 stdout 打了日志。",[918,1126,1128],{"id":1127},"用-inspector-可视化","用 Inspector 可视化",[896,1130,1131,1132,1135],{},"官方提供了 ",[908,1133,1134],{},"@modelcontextprotocol\u002Finspector","，带 Web UI：",[900,1137,1139],{"className":927,"code":1138,"language":929,"meta":11,"style":11},"npx @modelcontextprotocol\u002Finspector python -m my_server\n",[908,1140,1141],{"__ignoreMap":11},[933,1142,1143,1146,1149,1151,1153],{"class":935,"line":936},[933,1144,1145],{"class":964},"npx",[933,1147,1148],{"class":950}," @modelcontextprotocol\u002Finspector",[933,1150,965],{"class":950},[933,1152,968],{"class":946},[933,1154,971],{"class":950},[896,1156,1157],{},"它会：",[1159,1160,1161,1165,1168,1171],"ol",{},[1162,1163,1164],"li",{},"启动你的 server",[1162,1166,1167],{},"建立 MCP 连接",[1162,1169,1170],{},"打开本地页面，可视化展示 tools \u002F resources \u002F prompts",[1162,1172,1173],{},"让你手动调用工具，查看原始请求和响应",[896,1175,1176],{},[983,1177,1178],{},"调试期间永远开着它。",[892,1180,1182],{"id":1181},"层级二协议与传输","层级二：协议与传输",[918,1184,1185],{"id":1185},"协议版本不匹配",[896,1187,1188,1189,1192],{},"Client 握手时会告知 ",[908,1190,1191],{},"protocolVersion","，server 必须响应一个自己支持的版本：",[900,1194,1198],{"className":1195,"code":1196,"language":1197,"meta":11,"style":11},"language-json shiki shiki-themes github-light github-light github-dark","\u002F\u002F client 请求\n{ \"protocolVersion\": \"2024-11-05\", ... }\n\n\u002F\u002F server 响应\n{ \"protocolVersion\": \"2024-11-05\", ... }\n","json",[908,1199,1200,1205,1228,1234,1239],{"__ignoreMap":11},[933,1201,1202],{"class":935,"line":936},[933,1203,1204],{"class":939},"\u002F\u002F client 请求\n",[933,1206,1207,1210,1213,1216,1219,1221,1225],{"class":935,"line":943},[933,1208,1209],{"class":1008},"{ ",[933,1211,1212],{"class":946},"\"protocolVersion\"",[933,1214,1215],{"class":1008},": ",[933,1217,1218],{"class":950},"\"2024-11-05\"",[933,1220,1070],{"class":1008},[933,1222,1224],{"class":1223},"sPrNH","...",[933,1226,1227],{"class":1008}," }\n",[933,1229,1230],{"class":935,"line":957},[933,1231,1233],{"emptyLinePlaceholder":1232},true,"\n",[933,1235,1236],{"class":935,"line":1088},[933,1237,1238],{"class":939},"\u002F\u002F server 响应\n",[933,1240,1241,1243,1245,1247,1249,1251,1253],{"class":935,"line":1096},[933,1242,1209],{"class":1008},[933,1244,1212],{"class":946},[933,1246,1215],{"class":1008},[933,1248,1218],{"class":950},[933,1250,1070],{"class":1008},[933,1252,1224],{"class":1223},[933,1254,1227],{"class":1008},[896,1256,1257],{},"如果 server 回了个别的版本号，client 可能直接断开。检查依赖 SDK 版本是否与 client 匹配。",[918,1259,1261],{"id":1260},"stdio-传输最容易踩的坑","stdio 传输最容易踩的坑",[1263,1264,1265,1278],"table",{},[1266,1267,1268],"thead",{},[1269,1270,1271,1275],"tr",{},[1272,1273,1274],"th",{},"坑",[1272,1276,1277],{},"解决办法",[1279,1280,1281,1290,1305,1316,1327],"tbody",{},[1269,1282,1283,1287],{},[1284,1285,1286],"td",{},"server 进程被 SIGPIPE 干掉",[1284,1288,1289],{},"捕获 BrokenPipeError",[1269,1291,1292,1295],{},[1284,1293,1294],{},"缓冲区没 flush",[1284,1296,1297,1298,1301,1302],{},"Python: ",[908,1299,1300],{},"sys.stdout.flush()","；Node: ",[908,1303,1304],{},"process.stdout.write(..., 'utf-8')",[1269,1306,1307,1310],{},[1284,1308,1309],{},"编码问题",[1284,1311,1312,1313],{},"强制 UTF-8: ",[908,1314,1315],{},"PYTHONIOENCODING=utf-8",[1269,1317,1318,1324],{},[1284,1319,1320,1321],{},"Windows 换行符 ",[908,1322,1323],{},"\\r\\n",[1284,1325,1326],{},"打开 stdout 为 binary 模式",[1269,1328,1329,1332],{},[1284,1330,1331],{},"启动时长太久",[1284,1333,1334],{},"Client 默认超时 ~60s，别在 init 阶段做大量初始化",[918,1336,1338],{"id":1337},"http-sse-传输","HTTP \u002F SSE 传输",[896,1340,1341],{},"当 server 切到 HTTP 时，排查重点变成：",[1343,1344,1345,1348,1351,1357],"ul",{},[1162,1346,1347],{},"CORS 头是否允许 client 来源",[1162,1349,1350],{},"SSE 连接是否被代理（nginx \u002F cloudflare）断开",[1162,1352,1353,1356],{},[908,1354,1355],{},"Accept: text\u002Fevent-stream"," header 是否存在",[1162,1358,1359,1362],{},[908,1360,1361],{},"keep-alive"," 间隔是否过长导致中间件超时",[918,1364,1365],{"id":1365},"抓包大法",[896,1367,1368],{},"把 client 和 server 中间加一个透明代理记录所有消息：",[900,1370,1372],{"className":927,"code":1371,"language":929,"meta":11,"style":11},"# 用 pipeview 看 stdio 双向数据\npv -cN req \u003C \u002Fdev\u002Fstdin | python -m my_server | pv -cN resp\n",[908,1373,1374,1379],{"__ignoreMap":11},[933,1375,1376],{"class":935,"line":936},[933,1377,1378],{"class":939},"# 用 pipeview 看 stdio 双向数据\n",[933,1380,1381,1384,1387,1390,1393,1396,1399,1401,1403,1406,1408,1411,1413],{"class":935,"line":943},[933,1382,1383],{"class":964},"pv",[933,1385,1386],{"class":946}," -cN",[933,1388,1389],{"class":950}," req",[933,1391,1392],{"class":960}," \u003C",[933,1394,1395],{"class":950}," \u002Fdev\u002Fstdin",[933,1397,1398],{"class":960}," |",[933,1400,965],{"class":964},[933,1402,968],{"class":946},[933,1404,1405],{"class":950}," my_server",[933,1407,1398],{"class":960},[933,1409,1410],{"class":964}," pv",[933,1412,1386],{"class":946},[933,1414,1415],{"class":950}," resp\n",[896,1417,1418],{},"或者在 server 侧写个\"全记录\"中间件：",[900,1420,1422],{"className":996,"code":1421,"language":998,"meta":11,"style":11},"async def log_middleware(request, call_next):\n    sys.stderr.write(f\"\u003C\u003C\u003C {json.dumps(request)}\\n\")\n    resp = await call_next(request)\n    sys.stderr.write(f\">>> {json.dumps(resp)}\\n\")\n    return resp\n",[908,1423,1424,1438,1460,1473,1493],{"__ignoreMap":11},[933,1425,1426,1429,1432,1435],{"class":935,"line":936},[933,1427,1428],{"class":960},"async",[933,1430,1431],{"class":960}," def",[933,1433,1434],{"class":964}," log_middleware",[933,1436,1437],{"class":1008},"(request, call_next):\n",[933,1439,1440,1443,1445,1448,1450,1453,1456,1458],{"class":935,"line":943},[933,1441,1442],{"class":1008},"    sys.stderr.write(",[933,1444,1012],{"class":960},[933,1446,1447],{"class":950},"\"\u003C\u003C\u003C ",[933,1449,1018],{"class":946},[933,1451,1452],{"class":1008},"json.dumps(request)",[933,1454,1455],{"class":946},"}\\n",[933,1457,1027],{"class":950},[933,1459,1121],{"class":1008},[933,1461,1462,1465,1467,1470],{"class":935,"line":957},[933,1463,1464],{"class":1008},"    resp ",[933,1466,1077],{"class":960},[933,1468,1469],{"class":960}," await",[933,1471,1472],{"class":1008}," call_next(request)\n",[933,1474,1475,1477,1479,1482,1484,1487,1489,1491],{"class":935,"line":1088},[933,1476,1442],{"class":1008},[933,1478,1012],{"class":960},[933,1480,1481],{"class":950},"\">>> ",[933,1483,1018],{"class":946},[933,1485,1486],{"class":1008},"json.dumps(resp)",[933,1488,1455],{"class":946},[933,1490,1027],{"class":950},[933,1492,1121],{"class":1008},[933,1494,1495,1498],{"class":935,"line":1096},[933,1496,1497],{"class":960},"    return",[933,1499,1415],{"class":1008},[892,1501,1503],{"id":1502},"层级三模型决策","层级三：模型决策",[896,1505,1506,1507,1510],{},"握手正常、工具可手动调通，但模型实际使用时行为诡异——这是",[983,1508,1509],{},"最常见也最难调","的一类问题。",[918,1512,1514],{"id":1513},"症状-1工具从不被调用","症状 1：工具从不被调用",[896,1516,1517],{},"可能原因：",[1263,1519,1520,1530],{},[1266,1521,1522],{},[1269,1523,1524,1527],{},[1272,1525,1526],{},"原因",[1272,1528,1529],{},"验证方法",[1279,1531,1532,1540,1548,1556],{},[1269,1533,1534,1537],{},[1284,1535,1536],{},"description 太泛",[1284,1538,1539],{},"手动在提示里写\"请调用 xxx_tool\"，看能否强制触发",[1269,1541,1542,1545],{},[1284,1543,1544],{},"与其他工具重名\u002F重叠",[1284,1546,1547],{},"暂时禁用同类工具，再看能否触发",[1269,1549,1550,1553],{},[1284,1551,1552],{},"Schema required 过多",[1284,1554,1555],{},"减少必填字段",[1269,1557,1558,1561],{},[1284,1559,1560],{},"工具被安全策略静默过滤",[1284,1562,1563],{},"检查 client 侧允许列表",[896,1565,1566,1569],{},[983,1567,1568],{},"调试技巧","：给 description 加一句醒目的触发词：",[900,1571,1574],{"className":1572,"code":1573,"language":905,"meta":11},[903],"Use when the user asks to \"commit\", \"submit code\", \"save changes\",\n\"提交代码\", or \"保存修改\".\n",[908,1575,1573],{"__ignoreMap":11},[918,1577,1579],{"id":1578},"症状-2参数总是错","症状 2：参数总是错",[896,1581,1582],{},"检查 Schema 质量：",[900,1584,1586],{"className":1195,"code":1585,"language":1197,"meta":11,"style":11},"\u002F\u002F ❌ 模型无从判断\n{ \"type\": \"string\" }\n\n\u002F\u002F ✅ 给足上下文\n{\n  \"type\": \"string\",\n  \"description\": \"Absolute path to the file, starting with \u002F\",\n  \"pattern\": \"^\u002F.+\",\n  \"examples\": [\"\u002Ftmp\u002Fdata.csv\"]\n}\n",[908,1587,1588,1593,1607,1611,1616,1621,1634,1647,1660,1675],{"__ignoreMap":11},[933,1589,1590],{"class":935,"line":936},[933,1591,1592],{"class":939},"\u002F\u002F ❌ 模型无从判断\n",[933,1594,1595,1597,1600,1602,1605],{"class":935,"line":943},[933,1596,1209],{"class":1008},[933,1598,1599],{"class":946},"\"type\"",[933,1601,1215],{"class":1008},[933,1603,1604],{"class":950},"\"string\"",[933,1606,1227],{"class":1008},[933,1608,1609],{"class":935,"line":957},[933,1610,1233],{"emptyLinePlaceholder":1232},[933,1612,1613],{"class":935,"line":1088},[933,1614,1615],{"class":939},"\u002F\u002F ✅ 给足上下文\n",[933,1617,1618],{"class":935,"line":1096},[933,1619,1620],{"class":1008},"{\n",[933,1622,1624,1627,1629,1631],{"class":935,"line":1623},6,[933,1625,1626],{"class":946},"  \"type\"",[933,1628,1215],{"class":1008},[933,1630,1604],{"class":950},[933,1632,1633],{"class":1008},",\n",[933,1635,1637,1640,1642,1645],{"class":935,"line":1636},7,[933,1638,1639],{"class":946},"  \"description\"",[933,1641,1215],{"class":1008},[933,1643,1644],{"class":950},"\"Absolute path to the file, starting with \u002F\"",[933,1646,1633],{"class":1008},[933,1648,1650,1653,1655,1658],{"class":935,"line":1649},8,[933,1651,1652],{"class":946},"  \"pattern\"",[933,1654,1215],{"class":1008},[933,1656,1657],{"class":950},"\"^\u002F.+\"",[933,1659,1633],{"class":1008},[933,1661,1663,1666,1669,1672],{"class":935,"line":1662},9,[933,1664,1665],{"class":946},"  \"examples\"",[933,1667,1668],{"class":1008},": [",[933,1670,1671],{"class":950},"\"\u002Ftmp\u002Fdata.csv\"",[933,1673,1674],{"class":1008},"]\n",[933,1676,1678],{"class":935,"line":1677},10,[933,1679,1680],{"class":1008},"}\n",[896,1682,1683,1684,1687],{},"在 description 里加",[983,1685,1686],{},"正负例","比只写类型有效得多。",[918,1689,1691],{"id":1690},"症状-3重复调用同一工具","症状 3：重复调用同一工具",[896,1693,1694],{},"模型陷入循环通常因为工具返回没有\"结束信号\"。",[896,1696,1697],{},"❌ 反例：",[900,1699,1701],{"className":1195,"code":1700,"language":1197,"meta":11,"style":11},"{ \"content\": [{ \"type\": \"text\", \"text\": \"done\" }] }\n",[908,1702,1703],{"__ignoreMap":11},[933,1704,1705,1707,1710,1713,1715,1717,1720,1722,1724,1726,1729],{"class":935,"line":936},[933,1706,1209],{"class":1008},[933,1708,1709],{"class":946},"\"content\"",[933,1711,1712],{"class":1008},": [{ ",[933,1714,1599],{"class":946},[933,1716,1215],{"class":1008},[933,1718,1719],{"class":950},"\"text\"",[933,1721,1070],{"class":1008},[933,1723,1719],{"class":946},[933,1725,1215],{"class":1008},[933,1727,1728],{"class":950},"\"done\"",[933,1730,1731],{"class":1008}," }] }\n",[896,1733,1734],{},"✅ 正例：",[900,1736,1738],{"className":1195,"code":1737,"language":1197,"meta":11,"style":11},"{\n  \"content\": [{\n    \"type\": \"text\",\n    \"text\": \"Issue #42 created successfully at https:\u002F\u002Fgithub.com\u002Ffoo\u002Fbar\u002Fissues\u002F42. Next step: the task is complete, no further action needed.\"\n  }]\n}\n",[908,1739,1740,1744,1752,1763,1773,1778],{"__ignoreMap":11},[933,1741,1742],{"class":935,"line":936},[933,1743,1620],{"class":1008},[933,1745,1746,1749],{"class":935,"line":943},[933,1747,1748],{"class":946},"  \"content\"",[933,1750,1751],{"class":1008},": [{\n",[933,1753,1754,1757,1759,1761],{"class":935,"line":957},[933,1755,1756],{"class":946},"    \"type\"",[933,1758,1215],{"class":1008},[933,1760,1719],{"class":950},[933,1762,1633],{"class":1008},[933,1764,1765,1768,1770],{"class":935,"line":1088},[933,1766,1767],{"class":946},"    \"text\"",[933,1769,1215],{"class":1008},[933,1771,1772],{"class":950},"\"Issue #42 created successfully at https:\u002F\u002Fgithub.com\u002Ffoo\u002Fbar\u002Fissues\u002F42. Next step: the task is complete, no further action needed.\"\n",[933,1774,1775],{"class":935,"line":1096},[933,1776,1777],{"class":1008},"  }]\n",[933,1779,1780],{"class":935,"line":1623},[933,1781,1680],{"class":1008},[896,1783,1784],{},"明确告诉模型\"结束了\"，或者\"下一步该做什么\"。",[918,1786,1788],{"id":1787},"症状-4调用后直接放弃","症状 4：调用后直接放弃",[896,1790,1791],{},"模型调一次失败就不再尝试——通常因为报错信息太模糊：",[896,1793,1794],{},"❌：",[900,1796,1798],{"className":1195,"code":1797,"language":1197,"meta":11,"style":11},"{ \"isError\": true, \"content\": [{ \"type\": \"text\", \"text\": \"Error: 400\" }] }\n",[908,1799,1800],{"__ignoreMap":11},[933,1801,1802,1804,1807,1809,1812,1814,1816,1818,1820,1822,1824,1826,1828,1830,1833],{"class":935,"line":936},[933,1803,1209],{"class":1008},[933,1805,1806],{"class":946},"\"isError\"",[933,1808,1215],{"class":1008},[933,1810,1811],{"class":946},"true",[933,1813,1070],{"class":1008},[933,1815,1709],{"class":946},[933,1817,1712],{"class":1008},[933,1819,1599],{"class":946},[933,1821,1215],{"class":1008},[933,1823,1719],{"class":950},[933,1825,1070],{"class":1008},[933,1827,1719],{"class":946},[933,1829,1215],{"class":1008},[933,1831,1832],{"class":950},"\"Error: 400\"",[933,1834,1731],{"class":1008},[896,1836,1837],{},"✅：",[900,1839,1841],{"className":1195,"code":1840,"language":1197,"meta":11,"style":11},"{\n  \"isError\": true,\n  \"content\": [{\n    \"type\": \"text\",\n    \"text\": \"参数 title 为空。请提供非空的 issue 标题后重试。\"\n  }]\n}\n",[908,1842,1843,1847,1858,1864,1874,1883,1887],{"__ignoreMap":11},[933,1844,1845],{"class":935,"line":936},[933,1846,1620],{"class":1008},[933,1848,1849,1852,1854,1856],{"class":935,"line":943},[933,1850,1851],{"class":946},"  \"isError\"",[933,1853,1215],{"class":1008},[933,1855,1811],{"class":946},[933,1857,1633],{"class":1008},[933,1859,1860,1862],{"class":935,"line":957},[933,1861,1748],{"class":946},[933,1863,1751],{"class":1008},[933,1865,1866,1868,1870,1872],{"class":935,"line":1088},[933,1867,1756],{"class":946},[933,1869,1215],{"class":1008},[933,1871,1719],{"class":950},[933,1873,1633],{"class":1008},[933,1875,1876,1878,1880],{"class":935,"line":1096},[933,1877,1767],{"class":946},[933,1879,1215],{"class":1008},[933,1881,1882],{"class":950},"\"参数 title 为空。请提供非空的 issue 标题后重试。\"\n",[933,1884,1885],{"class":935,"line":1623},[933,1886,1777],{"class":1008},[933,1888,1889],{"class":935,"line":1636},[933,1890,1680],{"class":1008},[896,1892,1893],{},"好错误信息 = 一句话说清\"错在哪 + 怎么改\"。",[918,1895,1897],{"id":1896},"症状-5调用成功但模型总结错","症状 5：调用成功但模型总结错",[896,1899,1900],{},"模型把工具返回的 JSON\"幻觉化\"——返回数据过大或结构嵌套过深时常见。",[896,1902,1903],{},"解决：",[1159,1905,1906,1912,1918],{},[1162,1907,1908,1911],{},[983,1909,1910],{},"精简返回","：只返回模型真正需要的字段",[1162,1913,1914,1917],{},[983,1915,1916],{},"扁平化","：避免 3 层以上嵌套",[1162,1919,1920,1923],{},[983,1921,1922],{},"加 summary 字段","：前置一段自然语言总结",[900,1925,1927],{"className":1195,"code":1926,"language":1197,"meta":11,"style":11},"{\n  \"content\": [{\n    \"type\": \"text\",\n    \"text\": \"共找到 3 个 issue。标题分别是: A、B、C。详细数据见下:\\n\\n{...json...}\"\n  }]\n}\n",[908,1928,1929,1933,1939,1949,1964,1968],{"__ignoreMap":11},[933,1930,1931],{"class":935,"line":936},[933,1932,1620],{"class":1008},[933,1934,1935,1937],{"class":935,"line":943},[933,1936,1748],{"class":946},[933,1938,1751],{"class":1008},[933,1940,1941,1943,1945,1947],{"class":935,"line":957},[933,1942,1756],{"class":946},[933,1944,1215],{"class":1008},[933,1946,1719],{"class":950},[933,1948,1633],{"class":1008},[933,1950,1951,1953,1955,1958,1961],{"class":935,"line":1088},[933,1952,1767],{"class":946},[933,1954,1215],{"class":1008},[933,1956,1957],{"class":950},"\"共找到 3 个 issue。标题分别是: A、B、C。详细数据见下:",[933,1959,1960],{"class":946},"\\n\\n",[933,1962,1963],{"class":950},"{...json...}\"\n",[933,1965,1966],{"class":935,"line":1096},[933,1967,1777],{"class":1008},[933,1969,1970],{"class":935,"line":1623},[933,1971,1680],{"class":1008},[892,1973,1974],{"id":1974},"日志与追踪",[918,1976,1977],{"id":1977},"结构化日志",[900,1979,1981],{"className":996,"code":1980,"language":998,"meta":11,"style":11},"import json, sys, time\n\ndef log(event, **kwargs):\n    entry = { \"t\": time.time(), \"event\": event, **kwargs }\n    sys.stderr.write(json.dumps(entry) + \"\\n\")\n\nlog(\"tool_call\", name=\"create_issue\", args=args)\nlog(\"tool_result\", name=\"create_issue\", ok=True, duration_ms=123)\n",[908,1982,1983,1990,1994,2011,2038,2056,2060,2088],{"__ignoreMap":11},[933,1984,1985,1987],{"class":935,"line":936},[933,1986,1046],{"class":960},[933,1988,1989],{"class":1008}," json, sys, time\n",[933,1991,1992],{"class":935,"line":943},[933,1993,1233],{"emptyLinePlaceholder":1232},[933,1995,1996,1999,2002,2005,2008],{"class":935,"line":957},[933,1997,1998],{"class":960},"def",[933,2000,2001],{"class":964}," log",[933,2003,2004],{"class":1008},"(event, ",[933,2006,2007],{"class":960},"**",[933,2009,2010],{"class":1008},"kwargs):\n",[933,2012,2013,2016,2018,2021,2024,2027,2030,2033,2035],{"class":935,"line":1088},[933,2014,2015],{"class":1008},"    entry ",[933,2017,1077],{"class":960},[933,2019,2020],{"class":1008}," { ",[933,2022,2023],{"class":950},"\"t\"",[933,2025,2026],{"class":1008},": time.time(), ",[933,2028,2029],{"class":950},"\"event\"",[933,2031,2032],{"class":1008},": event, ",[933,2034,2007],{"class":960},[933,2036,2037],{"class":1008},"kwargs }\n",[933,2039,2040,2043,2046,2049,2052,2054],{"class":935,"line":1096},[933,2041,2042],{"class":1008},"    sys.stderr.write(json.dumps(entry) ",[933,2044,2045],{"class":960},"+",[933,2047,2048],{"class":950}," \"",[933,2050,2051],{"class":946},"\\n",[933,2053,1027],{"class":950},[933,2055,1121],{"class":1008},[933,2057,2058],{"class":935,"line":1623},[933,2059,1233],{"emptyLinePlaceholder":1232},[933,2061,2062,2065,2068,2070,2073,2075,2078,2080,2083,2085],{"class":935,"line":1636},[933,2063,2064],{"class":1008},"log(",[933,2066,2067],{"class":950},"\"tool_call\"",[933,2069,1070],{"class":1008},[933,2071,2072],{"class":1073},"name",[933,2074,1077],{"class":960},[933,2076,2077],{"class":950},"\"create_issue\"",[933,2079,1070],{"class":1008},[933,2081,2082],{"class":1073},"args",[933,2084,1077],{"class":960},[933,2086,2087],{"class":1008},"args)\n",[933,2089,2090,2092,2095,2097,2099,2101,2103,2105,2108,2110,2113,2115,2118,2120,2123],{"class":935,"line":1649},[933,2091,2064],{"class":1008},[933,2093,2094],{"class":950},"\"tool_result\"",[933,2096,1070],{"class":1008},[933,2098,2072],{"class":1073},[933,2100,1077],{"class":960},[933,2102,2077],{"class":950},[933,2104,1070],{"class":1008},[933,2106,2107],{"class":1073},"ok",[933,2109,1077],{"class":960},[933,2111,2112],{"class":946},"True",[933,2114,1070],{"class":1008},[933,2116,2117],{"class":1073},"duration_ms",[933,2119,1077],{"class":960},[933,2121,2122],{"class":946},"123",[933,2124,1121],{"class":1008},[896,2126,2127,2128,2131],{},"配合 ",[908,2129,2130],{},"jq"," 过滤：",[900,2133,2135],{"className":927,"code":2134,"language":929,"meta":11,"style":11},"python -m my_server 2> server.log\ncat server.log | jq 'select(.event==\"tool_call\")'\n",[908,2136,2137,2151],{"__ignoreMap":11},[933,2138,2139,2141,2143,2145,2148],{"class":935,"line":936},[933,2140,998],{"class":964},[933,2142,968],{"class":946},[933,2144,1405],{"class":950},[933,2146,2147],{"class":960}," 2>",[933,2149,2150],{"class":950}," server.log\n",[933,2152,2153,2156,2159,2161,2164],{"class":935,"line":943},[933,2154,2155],{"class":964},"cat",[933,2157,2158],{"class":950}," server.log",[933,2160,1398],{"class":960},[933,2162,2163],{"class":964}," jq",[933,2165,2166],{"class":950}," 'select(.event==\"tool_call\")'\n",[918,2168,2170],{"id":2169},"调用链-id","调用链 ID",[896,2172,2173],{},"给每个 tool call 分配一个 trace_id，方便对应请求\u002F响应\u002F错误：",[900,2175,2177],{"className":996,"code":2176,"language":998,"meta":11,"style":11},"import uuid\ntrace = str(uuid.uuid4())[:8]\nlog(\"call_start\", trace=trace, tool=name)\ntry:\n    ...\n    log(\"call_ok\", trace=trace)\nexcept Exception as e:\n    log(\"call_error\", trace=trace, error=str(e))\n    raise\n",[908,2178,2179,2186,2204,2229,2237,2242,2259,2273,2299],{"__ignoreMap":11},[933,2180,2181,2183],{"class":935,"line":936},[933,2182,1046],{"class":960},[933,2184,2185],{"class":1008}," uuid\n",[933,2187,2188,2191,2193,2196,2199,2202],{"class":935,"line":943},[933,2189,2190],{"class":1008},"trace ",[933,2192,1077],{"class":960},[933,2194,2195],{"class":946}," str",[933,2197,2198],{"class":1008},"(uuid.uuid4())[:",[933,2200,2201],{"class":946},"8",[933,2203,1674],{"class":1008},[933,2205,2206,2208,2211,2213,2216,2218,2221,2224,2226],{"class":935,"line":957},[933,2207,2064],{"class":1008},[933,2209,2210],{"class":950},"\"call_start\"",[933,2212,1070],{"class":1008},[933,2214,2215],{"class":1073},"trace",[933,2217,1077],{"class":960},[933,2219,2220],{"class":1008},"trace, ",[933,2222,2223],{"class":1073},"tool",[933,2225,1077],{"class":960},[933,2227,2228],{"class":1008},"name)\n",[933,2230,2231,2234],{"class":935,"line":1088},[933,2232,2233],{"class":960},"try",[933,2235,2236],{"class":1008},":\n",[933,2238,2239],{"class":935,"line":1096},[933,2240,2241],{"class":946},"    ...\n",[933,2243,2244,2247,2250,2252,2254,2256],{"class":935,"line":1623},[933,2245,2246],{"class":1008},"    log(",[933,2248,2249],{"class":950},"\"call_ok\"",[933,2251,1070],{"class":1008},[933,2253,2215],{"class":1073},[933,2255,1077],{"class":960},[933,2257,2258],{"class":1008},"trace)\n",[933,2260,2261,2264,2267,2270],{"class":935,"line":1636},[933,2262,2263],{"class":960},"except",[933,2265,2266],{"class":946}," Exception",[933,2268,2269],{"class":960}," as",[933,2271,2272],{"class":1008}," e:\n",[933,2274,2275,2277,2280,2282,2284,2286,2288,2291,2293,2296],{"class":935,"line":1649},[933,2276,2246],{"class":1008},[933,2278,2279],{"class":950},"\"call_error\"",[933,2281,1070],{"class":1008},[933,2283,2215],{"class":1073},[933,2285,1077],{"class":960},[933,2287,2220],{"class":1008},[933,2289,2290],{"class":1073},"error",[933,2292,1077],{"class":960},[933,2294,2295],{"class":946},"str",[933,2297,2298],{"class":1008},"(e))\n",[933,2300,2301],{"class":935,"line":1662},[933,2302,2303],{"class":960},"    raise\n",[892,2305,2306],{"id":2306},"测试策略",[918,2308,2310],{"id":2309},"单元测试-tool-函数","单元测试 Tool 函数",[896,2312,2313],{},"把 MCP 解绑，直接测业务逻辑：",[900,2315,2317],{"className":996,"code":2316,"language":998,"meta":11,"style":11},"def test_create_issue_validates_owner():\n    result = create_issue_impl(owner=\"\", repo=\"bar\", title=\"x\")\n    assert result.is_error\n    assert \"owner\" in result.text\n",[908,2318,2319,2329,2369,2377],{"__ignoreMap":11},[933,2320,2321,2323,2326],{"class":935,"line":936},[933,2322,1998],{"class":960},[933,2324,2325],{"class":964}," test_create_issue_validates_owner",[933,2327,2328],{"class":1008},"():\n",[933,2330,2331,2334,2336,2339,2342,2344,2347,2349,2352,2354,2357,2359,2362,2364,2367],{"class":935,"line":943},[933,2332,2333],{"class":1008},"    result ",[933,2335,1077],{"class":960},[933,2337,2338],{"class":1008}," create_issue_impl(",[933,2340,2341],{"class":1073},"owner",[933,2343,1077],{"class":960},[933,2345,2346],{"class":950},"\"\"",[933,2348,1070],{"class":1008},[933,2350,2351],{"class":1073},"repo",[933,2353,1077],{"class":960},[933,2355,2356],{"class":950},"\"bar\"",[933,2358,1070],{"class":1008},[933,2360,2361],{"class":1073},"title",[933,2363,1077],{"class":960},[933,2365,2366],{"class":950},"\"x\"",[933,2368,1121],{"class":1008},[933,2370,2371,2374],{"class":935,"line":957},[933,2372,2373],{"class":960},"    assert",[933,2375,2376],{"class":1008}," result.is_error\n",[933,2378,2379,2381,2384,2387],{"class":935,"line":1088},[933,2380,2373],{"class":960},[933,2382,2383],{"class":950}," \"owner\"",[933,2385,2386],{"class":960}," in",[933,2388,2389],{"class":1008}," result.text\n",[918,2391,2392],{"id":2392},"契约测试",[896,2394,2395],{},"用 JSON Schema 验证器确保 server 声明的 inputSchema 真的能反映代码实际接受的参数：",[900,2397,2399],{"className":996,"code":2398,"language":998,"meta":11,"style":11},"from jsonschema import validate\n\ndef test_schema_matches_impl():\n    sample = {\"owner\": \"foo\", \"repo\": \"bar\", \"title\": \"hi\"}\n    validate(sample, create_issue_tool.inputSchema)  # 不抛异常\n    assert create_issue_impl(**sample).ok\n",[908,2400,2401,2414,2418,2427,2466,2474],{"__ignoreMap":11},[933,2402,2403,2406,2409,2411],{"class":935,"line":936},[933,2404,2405],{"class":960},"from",[933,2407,2408],{"class":1008}," jsonschema ",[933,2410,1046],{"class":960},[933,2412,2413],{"class":1008}," validate\n",[933,2415,2416],{"class":935,"line":943},[933,2417,1233],{"emptyLinePlaceholder":1232},[933,2419,2420,2422,2425],{"class":935,"line":957},[933,2421,1998],{"class":960},[933,2423,2424],{"class":964}," test_schema_matches_impl",[933,2426,2328],{"class":1008},[933,2428,2429,2432,2434,2437,2440,2442,2445,2447,2450,2452,2454,2456,2459,2461,2464],{"class":935,"line":1088},[933,2430,2431],{"class":1008},"    sample ",[933,2433,1077],{"class":960},[933,2435,2436],{"class":1008}," {",[933,2438,2439],{"class":950},"\"owner\"",[933,2441,1215],{"class":1008},[933,2443,2444],{"class":950},"\"foo\"",[933,2446,1070],{"class":1008},[933,2448,2449],{"class":950},"\"repo\"",[933,2451,1215],{"class":1008},[933,2453,2356],{"class":950},[933,2455,1070],{"class":1008},[933,2457,2458],{"class":950},"\"title\"",[933,2460,1215],{"class":1008},[933,2462,2463],{"class":950},"\"hi\"",[933,2465,1680],{"class":1008},[933,2467,2468,2471],{"class":935,"line":1096},[933,2469,2470],{"class":1008},"    validate(sample, create_issue_tool.inputSchema)  ",[933,2472,2473],{"class":939},"# 不抛异常\n",[933,2475,2476,2478,2480,2482],{"class":935,"line":1623},[933,2477,2373],{"class":960},[933,2479,2338],{"class":1008},[933,2481,2007],{"class":960},[933,2483,2484],{"class":1008},"sample).ok\n",[918,2486,2488],{"id":2487},"端到端用-inspector-脚本化","端到端：用 Inspector 脚本化",[896,2490,2491],{},"Inspector 支持命令行模式批量跑 case：",[900,2493,2495],{"className":927,"code":2494,"language":929,"meta":11,"style":11},"mcp-inspector run tests\u002Fcases.yaml --server \"python -m my_server\"\n",[908,2496,2497],{"__ignoreMap":11},[933,2498,2499,2502,2505,2508,2511],{"class":935,"line":936},[933,2500,2501],{"class":964},"mcp-inspector",[933,2503,2504],{"class":950}," run",[933,2506,2507],{"class":950}," tests\u002Fcases.yaml",[933,2509,2510],{"class":946}," --server",[933,2512,2513],{"class":950}," \"python -m my_server\"\n",[892,2515,2516],{"id":2516},"常见错误速查表",[1263,2518,2519,2531],{},[1266,2520,2521],{},[1269,2522,2523,2526,2528],{},[1272,2524,2525],{},"错误消息",[1272,2527,1526],{},[1272,2529,2530],{},"对策",[1279,2532,2533,2546,2562,2574,2587,2600,2613],{},[1269,2534,2535,2540,2543],{},[1284,2536,2537],{},[908,2538,2539],{},"JSON parse error at position 0",[1284,2541,2542],{},"stdout 混入非 JSON 日志",[1284,2544,2545],{},"日志改到 stderr",[1269,2547,2548,2553,2556],{},[1284,2549,2550],{},[908,2551,2552],{},"method not found: tools\u002Flist",[1284,2554,2555],{},"Server 未注册 tools capability",[1284,2557,2558,2559],{},"检查 ",[908,2560,2561],{},"capabilities.tools = {}",[1269,2563,2564,2569,2571],{},[1284,2565,2566],{},[908,2567,2568],{},"version mismatch",[1284,2570,1185],{},[1284,2572,2573],{},"升级 SDK",[1269,2575,2576,2581,2584],{},[1284,2577,2578],{},[908,2579,2580],{},"connection closed",[1284,2582,2583],{},"Server 崩溃 \u002F 异常退出",[1284,2585,2586],{},"看 stderr 堆栈",[1269,2588,2589,2594,2597],{},[1284,2590,2591],{},[908,2592,2593],{},"request timeout",[1284,2595,2596],{},"工具执行超过默认超时",[1284,2598,2599],{},"异步化或拆分任务",[1269,2601,2602,2607,2610],{},[1284,2603,2604],{},[908,2605,2606],{},"schema validation failed",[1284,2608,2609],{},"参数不符合 inputSchema",[1284,2611,2612],{},"检查必填字段和类型",[1269,2614,2615,2620,2623],{},[1284,2616,2617],{},[908,2618,2619],{},"tool not found",[1284,2621,2622],{},"tool 列表缓存未刷新",[1284,2624,2625,2626,2629],{},"发送 ",[908,2627,2628],{},"tools\u002Flist_changed"," 通知",[892,2631,2632],{"id":2632},"检查清单",[896,2634,2635],{},"上线前过一遍：",[1343,2637,2640,2649,2655,2661,2670,2676,2682,2688,2694],{"className":2638},[2639],"contains-task-list",[1162,2641,2644,2648],{"className":2642},[2643],"task-list-item",[2645,2646],"input",{"disabled":1232,"type":2647},"checkbox"," 所有日志走 stderr",[1162,2650,2652,2654],{"className":2651},[2643],[2645,2653],{"disabled":1232,"type":2647}," 所有工具有 description + 参数 description",[1162,2656,2658,2660],{"className":2657},[2643],[2645,2659],{"disabled":1232,"type":2647}," 必填字段最小化",[1162,2662,2664,2666,2667],{"className":2663},[2643],[2645,2665],{"disabled":1232,"type":2647}," 敏感操作加 ",[908,2668,2669],{},"destructiveHint",[1162,2671,2673,2675],{"className":2672},[2643],[2645,2674],{"disabled":1232,"type":2647}," 错误返回都有\"怎么修\"的提示",[1162,2677,2679,2681],{"className":2678},[2643],[2645,2680],{"disabled":1232,"type":2647}," Server 启动时间 \u003C 5s",[1162,2683,2685,2687],{"className":2684},[2643],[2645,2686],{"disabled":1232,"type":2647}," 针对每个工具写了至少 3 个测试用例",[1162,2689,2691,2693],{"className":2690},[2643],[2645,2692],{"disabled":1232,"type":2647}," 用 Inspector 手动走过一遍",[1162,2695,2697,2699],{"className":2696},[2643],[2645,2698],{"disabled":1232,"type":2647}," 在真实 Agent 上跑过端到端场景",[892,2701,2702],{"id":2702},"小结",[896,2704,2705],{},"MCP 调试的心法：",[1159,2707,2708,2714,2720,2726,2732],{},[1162,2709,2710,2713],{},[983,2711,2712],{},"分层排查","：Server → 协议 → 模型",[1162,2715,2716,2719],{},[983,2717,2718],{},"Log to stderr","，永远不要污染 stdout",[1162,2721,2722,2725],{},[983,2723,2724],{},"Inspector 常开","，可视化快人十倍",[1162,2727,2728,2731],{},[983,2729,2730],{},"错误要会说话","，给模型修复路径",[1162,2733,2734,2737],{},[983,2735,2736],{},"测试到 Tool 粒度","，别只靠端到端",[896,2739,2740],{},"好 Server = 好的错误处理 + 好的 description + 好的日志。三者缺一不可。",[2742,2743,2744],"style",{},"html pre.shiki code .sCsY4, html code.shiki .sCsY4{--shiki-light:#6A737D;--shiki-default:#6A737D;--shiki-dark:#6A737D}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 pre.shiki code .s8jYJ, html code.shiki .s8jYJ{--shiki-light:#D73A49;--shiki-default:#D73A49;--shiki-dark:#F97583}html pre.shiki code .snPdu, html code.shiki .snPdu{--shiki-light:#6F42C1;--shiki-default:#6F42C1;--shiki-dark:#B392F0}html .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 .sxrX7, html code.shiki .sxrX7{--shiki-light:#24292E;--shiki-default:#24292E;--shiki-dark:#E1E4E8}html pre.shiki code .sP4rz, html code.shiki .sP4rz{--shiki-light:#E36209;--shiki-default:#E36209;--shiki-dark:#FFAB70}html pre.shiki code .sPrNH, html code.shiki .sPrNH{--shiki-light:#B31D28;--shiki-light-font-style:italic;--shiki-default:#B31D28;--shiki-default-font-style:italic;--shiki-dark:#FDAEB7;--shiki-dark-font-style:italic}",{"title":11,"searchDepth":943,"depth":943,"links":2746},[2747,2748,2753,2759,2766,2770,2775,2776,2777],{"id":894,"depth":943,"text":894},{"id":915,"depth":943,"text":916,"children":2749},[2750,2751,2752],{"id":920,"depth":957,"text":921},{"id":977,"depth":957,"text":978},{"id":1127,"depth":957,"text":1128},{"id":1181,"depth":943,"text":1182,"children":2754},[2755,2756,2757,2758],{"id":1185,"depth":957,"text":1185},{"id":1260,"depth":957,"text":1261},{"id":1337,"depth":957,"text":1338},{"id":1365,"depth":957,"text":1365},{"id":1502,"depth":943,"text":1503,"children":2760},[2761,2762,2763,2764,2765],{"id":1513,"depth":957,"text":1514},{"id":1578,"depth":957,"text":1579},{"id":1690,"depth":957,"text":1691},{"id":1787,"depth":957,"text":1788},{"id":1896,"depth":957,"text":1897},{"id":1974,"depth":943,"text":1974,"children":2767},[2768,2769],{"id":1977,"depth":957,"text":1977},{"id":2169,"depth":957,"text":2170},{"id":2306,"depth":943,"text":2306,"children":2771},[2772,2773,2774],{"id":2309,"depth":957,"text":2310},{"id":2392,"depth":957,"text":2392},{"id":2487,"depth":957,"text":2488},{"id":2516,"depth":943,"text":2516},{"id":2632,"depth":943,"text":2632},{"id":2702,"depth":943,"text":2702},"md",{},{"title":78,"description":79},"ai\u002Fmcp\u002Fdebugging","5Y857Hp--L8ETA20xlX7YnMIc8H_oDapgkGu3E4Cp2I",1775474636476]