[{"data":1,"prerenderedAt":3805},["ShallowReactive",2],{"article-/topics/ai/ai-agent-tool-calling-design-guide":3,"related-ai":597,"content-query-UL505hXr5V":3360},{"_path":4,"_dir":5,"_draft":6,"_partial":6,"_locale":7,"title":8,"description":9,"date":10,"topic":5,"author":11,"tags":12,"image":18,"imageQuery":19,"pexelsPhotoId":20,"pexelsUrl":21,"featured":6,"readingTime":22,"body":23,"_type":591,"_id":592,"_source":593,"_file":594,"_stem":595,"_extension":596},"/topics/ai/ai-agent-tool-calling-design-guide","ai",false,"","AI Agent 工具调用设计：抽象边界、调用协议与失败兜底","讲清 AI Agent 工具调用为什么难、工具接口该怎么设计、参数与权限如何约束、失败如何回退，以及怎样把工具调用做成可审计系统。","2026-04-06","HTMLPAGE 团队",[13,14,15,16,17],"AI Agent","工具调用","Function Calling","权限控制","Agent 设计","/images/topics/ai/ai-agent-tool-calling-design-guide.jpg","workflow architecture tools planning software team",6804084,"https://www.pexels.com/photo/team-discussing-project-at-a-computer-6804084/",14,{"type":24,"children":25,"toc":573},"root",[26,35,41,66,71,77,82,87,174,180,185,190,213,218,224,229,234,247,252,258,263,287,292,297,315,321,326,339,344,362,367,373,378,396,401,407,488,494,501,506,512,517,523,528,533],{"type":27,"tag":28,"props":29,"children":31},"element","h2",{"id":30},"ai-agent-工具调用设计",[32],{"type":33,"value":34},"text","AI Agent 工具调用设计",{"type":27,"tag":36,"props":37,"children":38},"p",{},[39],{"type":33,"value":40},"很多团队把工具调用理解成“给模型多几个函数”。真正上线之后才会发现，难点不在函数数量，而在这四个问题：",{"type":27,"tag":42,"props":43,"children":44},"ul",{},[45,51,56,61],{"type":27,"tag":46,"props":47,"children":48},"li",{},[49],{"type":33,"value":50},"模型什么时候该调用工具。",{"type":27,"tag":46,"props":52,"children":53},{},[54],{"type":33,"value":55},"工具参数怎么限制。",{"type":27,"tag":46,"props":57,"children":58},{},[59],{"type":33,"value":60},"调用失败后怎样回退。",{"type":27,"tag":46,"props":62,"children":63},{},[64],{"type":33,"value":65},"整个过程如何审计与复盘。",{"type":27,"tag":36,"props":67,"children":68},{},[69],{"type":33,"value":70},"如果这些边界不先设计，工具越多，系统越不稳定。",{"type":27,"tag":28,"props":72,"children":74},{"id":73},"_1-工具调用不是能力堆叠而是责任分工",[75],{"type":33,"value":76},"1. 工具调用不是能力堆叠，而是责任分工",{"type":27,"tag":36,"props":78,"children":79},{},[80],{"type":33,"value":81},"模型擅长的是理解意图和组织决策，工具擅长的是执行确定动作。",{"type":27,"tag":36,"props":83,"children":84},{},[85],{"type":33,"value":86},"所以一个好工具，不应该让模型“自由发挥”，而应该让模型在可控边界内完成调用。",{"type":27,"tag":88,"props":89,"children":90},"table",{},[91,115],{"type":27,"tag":92,"props":93,"children":94},"thead",{},[95],{"type":27,"tag":96,"props":97,"children":98},"tr",{},[99,105,110],{"type":27,"tag":100,"props":101,"children":102},"th",{},[103],{"type":33,"value":104},"层级",{"type":27,"tag":100,"props":106,"children":107},{},[108],{"type":33,"value":109},"应做的事",{"type":27,"tag":100,"props":111,"children":112},{},[113],{"type":33,"value":114},"不该做的事",{"type":27,"tag":116,"props":117,"children":118},"tbody",{},[119,138,156],{"type":27,"tag":96,"props":120,"children":121},{},[122,128,133],{"type":27,"tag":123,"props":124,"children":125},"td",{},[126],{"type":33,"value":127},"模型",{"type":27,"tag":123,"props":129,"children":130},{},[131],{"type":33,"value":132},"判断是否需要工具、组织参数",{"type":27,"tag":123,"props":134,"children":135},{},[136],{"type":33,"value":137},"直接拼任意危险指令",{"type":27,"tag":96,"props":139,"children":140},{},[141,146,151],{"type":27,"tag":123,"props":142,"children":143},{},[144],{"type":33,"value":145},"工具协议层",{"type":27,"tag":123,"props":147,"children":148},{},[149],{"type":33,"value":150},"校验参数、鉴权、记录日志",{"type":27,"tag":123,"props":152,"children":153},{},[154],{"type":33,"value":155},"承担模糊推理",{"type":27,"tag":96,"props":157,"children":158},{},[159,164,169],{"type":27,"tag":123,"props":160,"children":161},{},[162],{"type":33,"value":163},"工具执行层",{"type":27,"tag":123,"props":165,"children":166},{},[167],{"type":33,"value":168},"真正读写系统资源",{"type":27,"tag":123,"props":170,"children":171},{},[172],{"type":33,"value":173},"推测用户真实意图",{"type":27,"tag":28,"props":175,"children":177},{"id":176},"_2-工具设计先看最小可调用单元不要先看函数名",[178],{"type":33,"value":179},"2. 工具设计先看“最小可调用单元”，不要先看函数名",{"type":27,"tag":36,"props":181,"children":182},{},[183],{"type":33,"value":184},"真正应该先想清的是：一次调用要完成什么最小动作。",{"type":27,"tag":36,"props":186,"children":187},{},[188],{"type":33,"value":189},"例如“发布文章”这个需求，不要一上来设计成一个大工具包办所有事情。更稳的拆法可能是：",{"type":27,"tag":42,"props":191,"children":192},{},[193,198,203,208],{"type":27,"tag":46,"props":194,"children":195},{},[196],{"type":33,"value":197},"读取草稿元数据。",{"type":27,"tag":46,"props":199,"children":200},{},[201],{"type":33,"value":202},"生成摘要。",{"type":27,"tag":46,"props":204,"children":205},{},[206],{"type":33,"value":207},"校验 frontmatter。",{"type":27,"tag":46,"props":209,"children":210},{},[211],{"type":33,"value":212},"执行发布。",{"type":27,"tag":36,"props":214,"children":215},{},[216],{"type":33,"value":217},"越是高风险动作，越应该拆小，而不是做成一键万能工具。",{"type":27,"tag":28,"props":219,"children":221},{"id":220},"_3-参数模式比自然语言说明更重要",[222],{"type":33,"value":223},"3. 参数模式比自然语言说明更重要",{"type":27,"tag":36,"props":225,"children":226},{},[227],{"type":33,"value":228},"如果你只是写“这个工具可以创建文章”，模型仍然有大量误用空间。",{"type":27,"tag":36,"props":230,"children":231},{},[232],{"type":33,"value":233},"更稳的做法是给工具明确 schema：",{"type":27,"tag":235,"props":236,"children":241},"pre",{"className":237,"code":239,"language":240,"meta":7},[238],"language-json","{\n \"name\": \"publish_article\",\n \"input_schema\": {\n \"type\": \"object\",\n \"properties\": {\n \"slug\": { \"type\": \"string\" },\n \"category\": { \"type\": \"string\" },\n \"confirm\": { \"type\": \"boolean\" }\n },\n \"required\": [\"slug\", \"confirm\"]\n }\n}\n","json",[242],{"type":27,"tag":243,"props":244,"children":245},"code",{"__ignoreMap":7},[246],{"type":33,"value":239},{"type":27,"tag":36,"props":248,"children":249},{},[250],{"type":33,"value":251},"工具 schema 的意义，不只是让模型“更好调用”，更是让你能校验、拒绝和审计。",{"type":27,"tag":28,"props":253,"children":255},{"id":254},"_4-一个常见失败案例把高风险写操作暴露成无确认工具",[256],{"type":33,"value":257},"4. 一个常见失败案例：把高风险写操作暴露成“无确认工具”",{"type":27,"tag":36,"props":259,"children":260},{},[261],{"type":33,"value":262},"典型事故链路是：",{"type":27,"tag":264,"props":265,"children":266},"ol",{},[267,272,277,282],{"type":27,"tag":46,"props":268,"children":269},{},[270],{"type":33,"value":271},"工具允许直接删除、覆盖、发布。",{"type":27,"tag":46,"props":273,"children":274},{},[275],{"type":33,"value":276},"模型根据模糊意图做出激进调用。",{"type":27,"tag":46,"props":278,"children":279},{},[280],{"type":33,"value":281},"没有人类确认，也没有 dry run。",{"type":27,"tag":46,"props":283,"children":284},{},[285],{"type":33,"value":286},"最后线上状态被误改。",{"type":27,"tag":36,"props":288,"children":289},{},[290],{"type":33,"value":291},"根因是把“工具存在”误当成“工具就该自动执行”。",{"type":27,"tag":36,"props":293,"children":294},{},[295],{"type":33,"value":296},"修复方式通常是：",{"type":27,"tag":264,"props":298,"children":299},{},[300,305,310],{"type":27,"tag":46,"props":301,"children":302},{},[303],{"type":33,"value":304},"高风险工具默认只返回预览结果。",{"type":27,"tag":46,"props":306,"children":307},{},[308],{"type":33,"value":309},"真正执行前必须二次确认。",{"type":27,"tag":46,"props":311,"children":312},{},[313],{"type":33,"value":314},"保留回滚点和操作日志。",{"type":27,"tag":28,"props":316,"children":318},{"id":317},"_5-权限与环境隔离决定工具调用是否可上线",[319],{"type":33,"value":320},"5. 权限与环境隔离，决定工具调用是否可上线",{"type":27,"tag":36,"props":322,"children":323},{},[324],{"type":33,"value":325},"工具调用最怕两个混淆：",{"type":27,"tag":42,"props":327,"children":328},{},[329,334],{"type":27,"tag":46,"props":330,"children":331},{},[332],{"type":33,"value":333},"把开发环境和生产环境权限混在一起。",{"type":27,"tag":46,"props":335,"children":336},{},[337],{"type":33,"value":338},"把“可读”和“可写”当成一类能力。",{"type":27,"tag":36,"props":340,"children":341},{},[342],{"type":33,"value":343},"更稳的权限模型通常至少分三层：",{"type":27,"tag":42,"props":345,"children":346},{},[347,352,357],{"type":27,"tag":46,"props":348,"children":349},{},[350],{"type":33,"value":351},"Read only",{"type":27,"tag":46,"props":353,"children":354},{},[355],{"type":33,"value":356},"Propose only",{"type":27,"tag":46,"props":358,"children":359},{},[360],{"type":33,"value":361},"Execute with approval",{"type":27,"tag":36,"props":363,"children":364},{},[365],{"type":33,"value":366},"这样即使模型判断错了，也不会立刻造成不可逆后果。",{"type":27,"tag":28,"props":368,"children":370},{"id":369},"_6-失败兜底要能回答是模型错了还是工具错了",[371],{"type":33,"value":372},"6. 失败兜底要能回答“是模型错了，还是工具错了”",{"type":27,"tag":36,"props":374,"children":375},{},[376],{"type":33,"value":377},"工具调用失败时，至少要分清三种情况：",{"type":27,"tag":42,"props":379,"children":380},{},[381,386,391],{"type":27,"tag":46,"props":382,"children":383},{},[384],{"type":33,"value":385},"模型给了错误参数。",{"type":27,"tag":46,"props":387,"children":388},{},[389],{"type":33,"value":390},"工具内部异常。",{"type":27,"tag":46,"props":392,"children":393},{},[394],{"type":33,"value":395},"权限或资源条件不满足。",{"type":27,"tag":36,"props":397,"children":398},{},[399],{"type":33,"value":400},"如果所有失败都汇总成一个“tool call failed”，你根本没法优化下一版系统。",{"type":27,"tag":28,"props":402,"children":404},{"id":403},"_7-上线前-checklist",[405],{"type":33,"value":406},"7. 上线前 Checklist",{"type":27,"tag":42,"props":408,"children":411},{"className":409},[410],"contains-task-list",[412,425,434,443,452,461,470,479],{"type":27,"tag":46,"props":413,"children":416},{"className":414},[415],"task-list-item",[417,423],{"type":27,"tag":418,"props":419,"children":422},"input",{"disabled":420,"type":421},true,"checkbox",[],{"type":33,"value":424}," 已定义最小可调用单元，而不是一键万能工具。",{"type":27,"tag":46,"props":426,"children":428},{"className":427},[415],[429,432],{"type":27,"tag":418,"props":430,"children":431},{"disabled":420,"type":421},[],{"type":33,"value":433}," 每个工具都有明确 schema 与参数校验。",{"type":27,"tag":46,"props":435,"children":437},{"className":436},[415],[438,441],{"type":27,"tag":418,"props":439,"children":440},{"disabled":420,"type":421},[],{"type":33,"value":442}," 高风险工具默认不可直接执行。",{"type":27,"tag":46,"props":444,"children":446},{"className":445},[415],[447,450],{"type":27,"tag":418,"props":448,"children":449},{"disabled":420,"type":421},[],{"type":33,"value":451}," 开发、测试、生产环境权限已经隔离。",{"type":27,"tag":46,"props":453,"children":455},{"className":454},[415],[456,459],{"type":27,"tag":418,"props":457,"children":458},{"disabled":420,"type":421},[],{"type":33,"value":460}," 工具调用日志能区分模型错误与工具错误。",{"type":27,"tag":46,"props":462,"children":464},{"className":463},[415],[465,468],{"type":27,"tag":418,"props":466,"children":467},{"disabled":420,"type":421},[],{"type":33,"value":469}," 已为关键工具准备 dry run 或预览模式。",{"type":27,"tag":46,"props":471,"children":473},{"className":472},[415],[474,477],{"type":27,"tag":418,"props":475,"children":476},{"disabled":420,"type":421},[],{"type":33,"value":478}," 已定义回滚路径和人工接管流程。",{"type":27,"tag":46,"props":480,"children":482},{"className":481},[415],[483,486],{"type":27,"tag":418,"props":484,"children":485},{"disabled":420,"type":421},[],{"type":33,"value":487}," 新增工具前有注册、审批与废弃策略。",{"type":27,"tag":28,"props":489,"children":491},{"id":490},"faq",[492],{"type":33,"value":493},"FAQ",{"type":27,"tag":495,"props":496,"children":498},"h3",{"id":497},"工具越细越好吗",[499],{"type":33,"value":500},"工具越细越好吗？",{"type":27,"tag":36,"props":502,"children":503},{},[504],{"type":33,"value":505},"不一定。太粗会失控，太细会让调用链过长。关键是围绕最小业务动作设计，而不是机械拆分。",{"type":27,"tag":495,"props":507,"children":509},{"id":508},"function-calling-和-agent-工具调用是同一回事吗",[510],{"type":33,"value":511},"Function Calling 和 Agent 工具调用是同一回事吗？",{"type":27,"tag":36,"props":513,"children":514},{},[515],{"type":33,"value":516},"不是。Function Calling 更像协议能力，Agent 工具调用还包含权限、流程、失败恢复和治理问题。",{"type":27,"tag":495,"props":518,"children":520},{"id":519},"工具调用一定要有人审批吗",[521],{"type":33,"value":522},"工具调用一定要有人审批吗？",{"type":27,"tag":36,"props":524,"children":525},{},[526],{"type":33,"value":527},"不是所有都要，但高风险写操作和外部资源变更，默认应该有人类确认。",{"type":27,"tag":28,"props":529,"children":531},{"id":530},"延伸阅读",[532],{"type":33,"value":530},{"type":27,"tag":42,"props":534,"children":535},{},[536,546,555,564],{"type":27,"tag":46,"props":537,"children":538},{},[539],{"type":27,"tag":540,"props":541,"children":543},"a",{"href":542},"/topics/ai/function-calling-engineering-practice",[544],{"type":33,"value":545},"Function Calling 工程实践：从协议到稳定落地",{"type":27,"tag":46,"props":547,"children":548},{},[549],{"type":27,"tag":540,"props":550,"children":552},{"href":551},"/topics/ai/structured-output-schema",[553],{"type":33,"value":554},"结构化输出与 Schema 控制：让 AI 返回可预测的数据格式",{"type":27,"tag":46,"props":556,"children":557},{},[558],{"type":27,"tag":540,"props":559,"children":561},{"href":560},"/topics/ai/ai-agent-tool-registry-governance",[562],{"type":33,"value":563},"AI Agent 工具注册表治理：工具定义、版本、权限与废弃策略",{"type":27,"tag":46,"props":565,"children":566},{},[567],{"type":27,"tag":540,"props":568,"children":570},{"href":569},"/topics/ai/ai-agent-human-in-the-loop-approval",[571],{"type":33,"value":572},"Human-in-the-Loop 审批流设计：什么时候必须让人接管 Agent",{"title":7,"searchDepth":574,"depth":574,"links":575},3,[576,578,579,580,581,582,583,584,585,590],{"id":30,"depth":577,"text":34},2,{"id":73,"depth":577,"text":76},{"id":176,"depth":577,"text":179},{"id":220,"depth":577,"text":223},{"id":254,"depth":577,"text":257},{"id":317,"depth":577,"text":320},{"id":369,"depth":577,"text":372},{"id":403,"depth":577,"text":406},{"id":490,"depth":577,"text":493,"children":586},[587,588,589],{"id":497,"depth":574,"text":500},{"id":508,"depth":574,"text":511},{"id":519,"depth":574,"text":522},{"id":530,"depth":577,"text":530},"markdown","content:topics:ai:ai-agent-tool-calling-design-guide.md","content","topics/ai/ai-agent-tool-calling-design-guide.md","topics/ai/ai-agent-tool-calling-design-guide","md",[598,1751,2698],{"_path":599,"_dir":5,"_draft":6,"_partial":6,"_locale":7,"title":600,"description":601,"date":602,"topic":5,"author":11,"tags":603,"image":609,"imageAlt":610,"pexelsPhotoId":611,"pexelsUrl":612,"readingTime":613,"body":614,"_type":591,"_id":1748,"_source":593,"_file":1749,"_stem":1750,"_extension":596},"/topics/ai/cursor-keyboard-shortcuts-cheatsheet","Cursor 快捷键速查表（macOS/Windows）：从“会用”到“能提效”的 10 个工作流","把 Cursor 常用快捷键按任务分组（查代码、改代码、多文件、对话、审查与回滚），给出可直接照抄的工作流与最小回归清单，避免“快捷键背了也没变快”。","2026-03-02",[604,605,606,607,608],"Cursor","快捷键","AI IDE","VS Code","开发效率","/images/topics/ai/cursor-keyboard-shortcuts-cheatsheet.jpg","彩色机械键盘与鼠标的工作台面",34563105,"https://www.pexels.com/photo/colorful-mechanical-keyboard-and-mouse-setup-34563105/",12,{"type":24,"children":615,"toc":1722},[616,621,639,644,672,677,713,717,723,728,761,766,789,792,798,803,1021,1030,1033,1039,1045,1064,1072,1093,1098,1104,1119,1150,1155,1168,1174,1193,1211,1219,1224,1230,1235,1256,1264,1270,1275,1298,1303,1309,1322,1328,1346,1364,1370,1381,1399,1405,1416,1422,1427,1470,1473,1479,1487,1540,1543,1549,1555,1560,1565,1588,1606,1611,1636,1639,1645,1651,1656,1662,1667,1673,1678,1681,1687],{"type":27,"tag":36,"props":617,"children":618},{},[619],{"type":33,"value":620},"如果你在搜“Cursor 快捷键”，你大概率不是想背一张表，而是想解决这类问题：",{"type":27,"tag":42,"props":622,"children":623},{},[624,629,634],{"type":27,"tag":46,"props":625,"children":626},{},[627],{"type":33,"value":628},"为什么我用了 AI，还是很慢？（对话来回太多、改动不可控）",{"type":27,"tag":46,"props":630,"children":631},{},[632],{"type":33,"value":633},"为什么它“看起来懂了”，却改错文件/改出回归？（上下文与范围没锁住）",{"type":27,"tag":46,"props":635,"children":636},{},[637],{"type":33,"value":638},"多文件改动怎么做得安全？（验收、回滚、最小回归集）",{"type":27,"tag":36,"props":640,"children":641},{},[642],{"type":33,"value":643},"这篇文章给你两份东西：",{"type":27,"tag":264,"props":645,"children":646},{},[647,660],{"type":27,"tag":46,"props":648,"children":649},{},[650,652,658],{"type":33,"value":651},"一张",{"type":27,"tag":653,"props":654,"children":655},"strong",{},[656],{"type":33,"value":657},"按任务分组",{"type":33,"value":659},"的快捷键表（不是按功能堆在一起）",{"type":27,"tag":46,"props":661,"children":662},{},[663,665,670],{"type":33,"value":664},"一套“从需求到落地”的",{"type":27,"tag":653,"props":666,"children":667},{},[668],{"type":33,"value":669},"最小闭环工作流",{"type":33,"value":671},"（每一步都有快捷键）",{"type":27,"tag":36,"props":673,"children":674},{},[675],{"type":33,"value":676},"想看系统玩法：",{"type":27,"tag":42,"props":678,"children":679},{},[680,691,702],{"type":27,"tag":46,"props":681,"children":682},{},[683,685],{"type":33,"value":684},"入门教程看：",{"type":27,"tag":540,"props":686,"children":688},{"href":687},"/topics/ai/cursor-tutorial",[689],{"type":33,"value":690},"Cursor 使用教程（2026）",{"type":27,"tag":46,"props":692,"children":693},{},[694,696],{"type":33,"value":695},"进阶玩法看：",{"type":27,"tag":540,"props":697,"children":699},{"href":698},"/topics/ai/cursor-editor-guide",[700],{"type":33,"value":701},"Cursor 编辑器深度玩法",{"type":27,"tag":46,"props":703,"children":704},{},[705,707],{"type":33,"value":706},"规则与忽略看：",{"type":27,"tag":540,"props":708,"children":710},{"href":709},"/topics/ai/cursor-rules-cursorrules",[711],{"type":33,"value":712},"Cursor Rules 与 .cursorrules",{"type":27,"tag":714,"props":715,"children":716},"hr",{},[],{"type":27,"tag":28,"props":718,"children":720},{"id":719},"先给结论提效不是按得快而是闭环更短",[721],{"type":33,"value":722},"先给结论：提效不是“按得快”，而是“闭环更短”",{"type":27,"tag":36,"props":724,"children":725},{},[726],{"type":33,"value":727},"你可以把 Cursor 的快捷键理解为 3 条流水线：",{"type":27,"tag":42,"props":729,"children":730},{},[731,741,751],{"type":27,"tag":46,"props":732,"children":733},{},[734,739],{"type":27,"tag":653,"props":735,"children":736},{},[737],{"type":33,"value":738},"改一小段",{"type":33,"value":740},"（内联编辑）：把改动限制在一个函数/一段样式",{"type":27,"tag":46,"props":742,"children":743},{},[744,749],{"type":27,"tag":653,"props":745,"children":746},{},[747],{"type":33,"value":748},"改一组文件",{"type":33,"value":750},"（Composer）：把改动限制在一组明确文件，并要求输出 diff + 验收点",{"type":27,"tag":46,"props":752,"children":753},{},[754,759],{"type":27,"tag":653,"props":755,"children":756},{},[757],{"type":33,"value":758},"聊清楚再动手",{"type":33,"value":760},"（侧边对话）：先对齐目标、范围、验收、回滚",{"type":27,"tag":36,"props":762,"children":763},{},[764],{"type":33,"value":765},"当你觉得“它乱改/改太大”时，往往不是快捷键没记住，而是缺了两件事：",{"type":27,"tag":42,"props":767,"children":768},{},[769,779],{"type":27,"tag":46,"props":770,"children":771},{},[772,774],{"type":33,"value":773},"没有在动手前锁定",{"type":27,"tag":653,"props":775,"children":776},{},[777],{"type":33,"value":778},"范围",{"type":27,"tag":46,"props":780,"children":781},{},[782,784],{"type":33,"value":783},"没有在接受改动前准备",{"type":27,"tag":653,"props":785,"children":786},{},[787],{"type":33,"value":788},"验收/回滚",{"type":27,"tag":714,"props":790,"children":791},{},[],{"type":27,"tag":28,"props":793,"children":795},{"id":794},"快捷键速查表按任务分组",[796],{"type":33,"value":797},"快捷键速查表（按任务分组）",{"type":27,"tag":36,"props":799,"children":800},{},[801],{"type":33,"value":802},"说明：下表按“你正在做什么”组织，而不是按“功能名字”组织。不同版本快捷键可能略有差异，但核心逻辑一致。",{"type":27,"tag":88,"props":804,"children":805},{},[806,832],{"type":27,"tag":92,"props":807,"children":808},{},[809],{"type":27,"tag":96,"props":810,"children":811},{},[812,817,822,827],{"type":27,"tag":100,"props":813,"children":814},{},[815],{"type":33,"value":816},"任务",{"type":27,"tag":100,"props":818,"children":819},{},[820],{"type":33,"value":821},"macOS",{"type":27,"tag":100,"props":823,"children":824},{},[825],{"type":33,"value":826},"Windows",{"type":27,"tag":100,"props":828,"children":829},{},[830],{"type":33,"value":831},"你该在什么时候用",{"type":27,"tag":116,"props":833,"children":834},{},[835,866,897,928,959,990],{"type":27,"tag":96,"props":836,"children":837},{},[838,843,852,861],{"type":27,"tag":123,"props":839,"children":840},{},[841],{"type":33,"value":842},"改一小段（最安全）",{"type":27,"tag":123,"props":844,"children":845},{},[846],{"type":27,"tag":243,"props":847,"children":849},{"className":848},[],[850],{"type":33,"value":851},"Cmd + K",{"type":27,"tag":123,"props":853,"children":854},{},[855],{"type":27,"tag":243,"props":856,"children":858},{"className":857},[],[859],{"type":33,"value":860},"Ctrl + K",{"type":27,"tag":123,"props":862,"children":863},{},[864],{"type":33,"value":865},"只想改一个函数/一段 CSS，不想动别的",{"type":27,"tag":96,"props":867,"children":868},{},[869,874,883,892],{"type":27,"tag":123,"props":870,"children":871},{},[872],{"type":33,"value":873},"打开 AI 对话（先对齐再动手）",{"type":27,"tag":123,"props":875,"children":876},{},[877],{"type":27,"tag":243,"props":878,"children":880},{"className":879},[],[881],{"type":33,"value":882},"Cmd + L",{"type":27,"tag":123,"props":884,"children":885},{},[886],{"type":27,"tag":243,"props":887,"children":889},{"className":888},[],[890],{"type":33,"value":891},"Ctrl + L",{"type":27,"tag":123,"props":893,"children":894},{},[895],{"type":33,"value":896},"需要澄清目标、制定步骤、给验收点",{"type":27,"tag":96,"props":898,"children":899},{},[900,905,914,923],{"type":27,"tag":123,"props":901,"children":902},{},[903],{"type":33,"value":904},"多文件编辑（有组织地改一组文件）",{"type":27,"tag":123,"props":906,"children":907},{},[908],{"type":27,"tag":243,"props":909,"children":911},{"className":910},[],[912],{"type":33,"value":913},"Cmd + I",{"type":27,"tag":123,"props":915,"children":916},{},[917],{"type":27,"tag":243,"props":918,"children":920},{"className":919},[],[921],{"type":33,"value":922},"Ctrl + I",{"type":27,"tag":123,"props":924,"children":925},{},[926],{"type":33,"value":927},"改动涉及多个文件：组件+样式+测试",{"type":27,"tag":96,"props":929,"children":930},{},[931,936,945,954],{"type":27,"tag":123,"props":932,"children":933},{},[934],{"type":33,"value":935},"把选中代码加入对话上下文",{"type":27,"tag":123,"props":937,"children":938},{},[939],{"type":27,"tag":243,"props":940,"children":942},{"className":941},[],[943],{"type":33,"value":944},"Cmd + Shift + L",{"type":27,"tag":123,"props":946,"children":947},{},[948],{"type":27,"tag":243,"props":949,"children":951},{"className":950},[],[952],{"type":33,"value":953},"Ctrl + Shift + L",{"type":27,"tag":123,"props":955,"children":956},{},[957],{"type":33,"value":958},"让 AI 只看你选的片段（降低噪音）",{"type":27,"tag":96,"props":960,"children":961},{},[962,967,976,985],{"type":27,"tag":123,"props":963,"children":964},{},[965],{"type":33,"value":966},"接受当前建议",{"type":27,"tag":123,"props":968,"children":969},{},[970],{"type":27,"tag":243,"props":971,"children":973},{"className":972},[],[974],{"type":33,"value":975},"Cmd + Y",{"type":27,"tag":123,"props":977,"children":978},{},[979],{"type":27,"tag":243,"props":980,"children":982},{"className":981},[],[983],{"type":33,"value":984},"Ctrl + Y",{"type":27,"tag":123,"props":986,"children":987},{},[988],{"type":33,"value":989},"你已经准备好验收/回滚，并确认改动范围",{"type":27,"tag":96,"props":991,"children":992},{},[993,998,1007,1016],{"type":27,"tag":123,"props":994,"children":995},{},[996],{"type":33,"value":997},"拒绝当前建议",{"type":27,"tag":123,"props":999,"children":1000},{},[1001],{"type":27,"tag":243,"props":1002,"children":1004},{"className":1003},[],[1005],{"type":33,"value":1006},"Cmd + N",{"type":27,"tag":123,"props":1008,"children":1009},{},[1010],{"type":27,"tag":243,"props":1011,"children":1013},{"className":1012},[],[1014],{"type":33,"value":1015},"Ctrl + N",{"type":27,"tag":123,"props":1017,"children":1018},{},[1019],{"type":33,"value":1020},"改得太大、改错方向，立刻收手",{"type":27,"tag":1022,"props":1023,"children":1024},"blockquote",{},[1025],{"type":27,"tag":36,"props":1026,"children":1027},{},[1028],{"type":33,"value":1029},"小技巧：把“改一小段”当默认路径。只有当你能清晰写出“会改哪几类文件、怎么验收”时再进入多文件。",{"type":27,"tag":714,"props":1031,"children":1032},{},[],{"type":27,"tag":28,"props":1034,"children":1036},{"id":1035},"_10-个可直接照抄的提效工作流每个都能闭环",[1037],{"type":33,"value":1038},"10 个可直接照抄的提效工作流（每个都能闭环）",{"type":27,"tag":495,"props":1040,"children":1042},{"id":1041},"工作流-1需求计划小步改新手最稳",[1043],{"type":33,"value":1044},"工作流 1：需求→计划→小步改（新手最稳）",{"type":27,"tag":264,"props":1046,"children":1047},{},[1048,1059],{"type":27,"tag":46,"props":1049,"children":1050},{},[1051,1057],{"type":27,"tag":243,"props":1052,"children":1054},{"className":1053},[],[1055],{"type":33,"value":1056},"Cmd/Ctrl + L",{"type":33,"value":1058}," 打开对话",{"type":27,"tag":46,"props":1060,"children":1061},{},[1062],{"type":33,"value":1063},"先发这段（可复制）：",{"type":27,"tag":1022,"props":1065,"children":1066},{},[1067],{"type":27,"tag":36,"props":1068,"children":1069},{},[1070],{"type":33,"value":1071},"目标：……\n范围：只修改以下文件/模块：……\n非目标：……（明确不做）\n验收：……（可测试/可手动检查）\n输出格式：先给计划，再逐步执行；每一步写出 diff 摘要。",{"type":27,"tag":264,"props":1073,"children":1074},{"start":574},[1075,1080],{"type":27,"tag":46,"props":1076,"children":1077},{},[1078],{"type":33,"value":1079},"让 AI 先给“计划（3~6 步）”，你确认后再执行",{"type":27,"tag":46,"props":1081,"children":1082},{},[1083,1085,1091],{"type":33,"value":1084},"任何一步涉及改代码：优先回到编辑区，选中片段用 ",{"type":27,"tag":243,"props":1086,"children":1088},{"className":1087},[],[1089],{"type":33,"value":1090},"Cmd/Ctrl + K",{"type":33,"value":1092}," 小步改",{"type":27,"tag":36,"props":1094,"children":1095},{},[1096],{"type":33,"value":1097},"为什么有效：你把“想法”变成了“可执行约束”，这就是 GEO（面向 AI/模型的可理解结构）。",{"type":27,"tag":495,"props":1099,"children":1101},{"id":1100},"工作流-2只改一个函数高频低风险",[1102],{"type":33,"value":1103},"工作流 2：只改一个函数（高频、低风险）",{"type":27,"tag":42,"props":1105,"children":1106},{},[1107],{"type":27,"tag":46,"props":1108,"children":1109},{},[1110,1112,1117],{"type":33,"value":1111},"选中函数 → ",{"type":27,"tag":243,"props":1113,"children":1115},{"className":1114},[],[1116],{"type":33,"value":1090},{"type":33,"value":1118}," → 输入指令：",{"type":27,"tag":1022,"props":1120,"children":1121},{},[1122,1127],{"type":27,"tag":36,"props":1123,"children":1124},{},[1125],{"type":33,"value":1126},"把这段改成更可读：",{"type":27,"tag":42,"props":1128,"children":1129},{},[1130,1135,1140,1145],{"type":27,"tag":46,"props":1131,"children":1132},{},[1133],{"type":33,"value":1134},"用 async/await",{"type":27,"tag":46,"props":1136,"children":1137},{},[1138],{"type":33,"value":1139},"错误处理不要吞掉",{"type":27,"tag":46,"props":1141,"children":1142},{},[1143],{"type":33,"value":1144},"添加类型（若可推断）",{"type":27,"tag":46,"props":1146,"children":1147},{},[1148],{"type":33,"value":1149},"不要改函数签名",{"type":27,"tag":36,"props":1151,"children":1152},{},[1153],{"type":33,"value":1154},"验收方式（强制）：",{"type":27,"tag":42,"props":1156,"children":1157},{},[1158,1163],{"type":27,"tag":46,"props":1159,"children":1160},{},[1161],{"type":33,"value":1162},"输出前后函数行为一致（输入/输出）",{"type":27,"tag":46,"props":1164,"children":1165},{},[1166],{"type":33,"value":1167},"失败分支有可观测日志（不要悄悄 return null）",{"type":27,"tag":495,"props":1169,"children":1171},{"id":1170},"工作流-3多文件改动先定文件清单",[1172],{"type":33,"value":1173},"工作流 3：多文件改动（先定“文件清单”）",{"type":27,"tag":264,"props":1175,"children":1176},{},[1177,1188],{"type":27,"tag":46,"props":1178,"children":1179},{},[1180,1186],{"type":27,"tag":243,"props":1181,"children":1183},{"className":1182},[],[1184],{"type":33,"value":1185},"Cmd/Ctrl + I",{"type":33,"value":1187}," 进入多文件",{"type":27,"tag":46,"props":1189,"children":1190},{},[1191],{"type":33,"value":1192},"先让 AI 输出：",{"type":27,"tag":42,"props":1194,"children":1195},{},[1196,1201,1206],{"type":27,"tag":46,"props":1197,"children":1198},{},[1199],{"type":33,"value":1200},"预计会改哪些文件（最多 5 个）",{"type":27,"tag":46,"props":1202,"children":1203},{},[1204],{"type":33,"value":1205},"每个文件改什么",{"type":27,"tag":46,"props":1207,"children":1208},{},[1209],{"type":33,"value":1210},"每一步怎么验收",{"type":27,"tag":264,"props":1212,"children":1213},{"start":574},[1214],{"type":27,"tag":46,"props":1215,"children":1216},{},[1217],{"type":33,"value":1218},"你确认文件清单后再开始生成改动",{"type":27,"tag":36,"props":1220,"children":1221},{},[1222],{"type":33,"value":1223},"关键点：多文件最容易翻车的是“它把你没想到的文件也改了”。所以文件清单是第一道闸门。",{"type":27,"tag":495,"props":1225,"children":1227},{"id":1226},"工作流-4把上下文噪音砍掉防跑偏",[1228],{"type":33,"value":1229},"工作流 4：把“上下文噪音”砍掉（防跑偏）",{"type":27,"tag":36,"props":1231,"children":1232},{},[1233],{"type":33,"value":1234},"当你怀疑它在胡说/乱改时：",{"type":27,"tag":42,"props":1236,"children":1237},{},[1238,1251],{"type":27,"tag":46,"props":1239,"children":1240},{},[1241,1243,1249],{"type":33,"value":1242},"只选择关键代码片段 → ",{"type":27,"tag":243,"props":1244,"children":1246},{"className":1245},[],[1247],{"type":33,"value":1248},"Cmd/Ctrl + Shift + L",{"type":33,"value":1250}," 加入对话",{"type":27,"tag":46,"props":1252,"children":1253},{},[1254],{"type":33,"value":1255},"然后在对话里要求：",{"type":27,"tag":1022,"props":1257,"children":1258},{},[1259],{"type":27,"tag":36,"props":1260,"children":1261},{},[1262],{"type":33,"value":1263},"只基于我提供的代码片段回答，不要假设其它文件存在。",{"type":27,"tag":495,"props":1265,"children":1267},{"id":1266},"工作流-5生成变更说明让-code-review-变快",[1268],{"type":33,"value":1269},"工作流 5：生成变更说明（让 code review 变快）",{"type":27,"tag":36,"props":1271,"children":1272},{},[1273],{"type":33,"value":1274},"改完后在对话里让它输出：",{"type":27,"tag":42,"props":1276,"children":1277},{},[1278,1283,1288,1293],{"type":27,"tag":46,"props":1279,"children":1280},{},[1281],{"type":33,"value":1282},"改动摘要（3~7 条）",{"type":27,"tag":46,"props":1284,"children":1285},{},[1286],{"type":33,"value":1287},"风险点（依赖/边界条件）",{"type":27,"tag":46,"props":1289,"children":1290},{},[1291],{"type":33,"value":1292},"回滚方式",{"type":27,"tag":46,"props":1294,"children":1295},{},[1296],{"type":33,"value":1297},"验收步骤",{"type":27,"tag":36,"props":1299,"children":1300},{},[1301],{"type":33,"value":1302},"这套结构能直接贴进 PR 描述。",{"type":27,"tag":495,"props":1304,"children":1306},{"id":1305},"工作流-6写最小回归集不写回归-等事故",[1307],{"type":33,"value":1308},"工作流 6：写“最小回归集”（不写回归 = 等事故）",{"type":27,"tag":36,"props":1310,"children":1311},{},[1312,1314,1320],{"type":33,"value":1313},"每次改动都至少做 10 条最小回归（见下文清单）。你可以把它写在 ",{"type":27,"tag":243,"props":1315,"children":1317},{"className":1316},[],[1318],{"type":33,"value":1319},"README",{"type":33,"value":1321}," 或团队 wiki。",{"type":27,"tag":495,"props":1323,"children":1325},{"id":1324},"工作流-7把接受建议变成最后一步",[1326],{"type":33,"value":1327},"工作流 7：把“接受建议”变成最后一步",{"type":27,"tag":36,"props":1329,"children":1330},{},[1331,1337,1339,1344],{"type":27,"tag":243,"props":1332,"children":1334},{"className":1333},[],[1335],{"type":33,"value":1336},"Cmd/Ctrl + Y",{"type":33,"value":1338}," 应该是",{"type":27,"tag":653,"props":1340,"children":1341},{},[1342],{"type":33,"value":1343},"最后一步",{"type":33,"value":1345},"：",{"type":27,"tag":42,"props":1347,"children":1348},{},[1349,1354,1359],{"type":27,"tag":46,"props":1350,"children":1351},{},[1352],{"type":33,"value":1353},"你已经看过 diff",{"type":27,"tag":46,"props":1355,"children":1356},{},[1357],{"type":33,"value":1358},"你能说清楚“怎么验收”",{"type":27,"tag":46,"props":1360,"children":1361},{},[1362],{"type":33,"value":1363},"你知道“怎么回滚”",{"type":27,"tag":495,"props":1365,"children":1367},{"id":1366},"工作流-8拒绝建议不是失败是风控动作",[1368],{"type":33,"value":1369},"工作流 8：拒绝建议不是失败，是风控动作",{"type":27,"tag":36,"props":1371,"children":1372},{},[1373,1379],{"type":27,"tag":243,"props":1374,"children":1376},{"className":1375},[],[1377],{"type":33,"value":1378},"Cmd/Ctrl + N",{"type":33,"value":1380}," 的使用时机：",{"type":27,"tag":42,"props":1382,"children":1383},{},[1384,1389,1394],{"type":27,"tag":46,"props":1385,"children":1386},{},[1387],{"type":33,"value":1388},"它开始改你没提过的东西（范围漂移）",{"type":27,"tag":46,"props":1390,"children":1391},{},[1392],{"type":33,"value":1393},"它改了 10 个文件但你只想改 1 个",{"type":27,"tag":46,"props":1395,"children":1396},{},[1397],{"type":33,"value":1398},"它为了“更优雅”引入新依赖/新抽象",{"type":27,"tag":495,"props":1400,"children":1402},{"id":1401},"工作流-9重复任务做成模板提示词不是一次性",[1403],{"type":33,"value":1404},"工作流 9：重复任务做成模板（提示词不是一次性）",{"type":27,"tag":36,"props":1406,"children":1407},{},[1408,1410,1414],{"type":33,"value":1409},"把高频任务（比如“写组件+样式+验收”）固化成模板，放进 Rules（见：",{"type":27,"tag":540,"props":1411,"children":1412},{"href":709},[1413],{"type":33,"value":712},{"type":33,"value":1415},"）。",{"type":27,"tag":495,"props":1417,"children":1419},{"id":1418},"工作流-10把快捷键表做成你自己的任务表",[1420],{"type":33,"value":1421},"工作流 10：把“快捷键表”做成你自己的任务表",{"type":27,"tag":36,"props":1423,"children":1424},{},[1425],{"type":33,"value":1426},"你不需要记住所有快捷键，只需要记住：",{"type":27,"tag":42,"props":1428,"children":1429},{},[1430,1440,1450,1460],{"type":27,"tag":46,"props":1431,"children":1432},{},[1433,1435],{"type":33,"value":1434},"小步改：",{"type":27,"tag":243,"props":1436,"children":1438},{"className":1437},[],[1439],{"type":33,"value":1090},{"type":27,"tag":46,"props":1441,"children":1442},{},[1443,1445],{"type":33,"value":1444},"先对齐：",{"type":27,"tag":243,"props":1446,"children":1448},{"className":1447},[],[1449],{"type":33,"value":1056},{"type":27,"tag":46,"props":1451,"children":1452},{},[1453,1455],{"type":33,"value":1454},"多文件：",{"type":27,"tag":243,"props":1456,"children":1458},{"className":1457},[],[1459],{"type":33,"value":1185},{"type":27,"tag":46,"props":1461,"children":1462},{},[1463,1465],{"type":33,"value":1464},"上下文聚焦：",{"type":27,"tag":243,"props":1466,"children":1468},{"className":1467},[],[1469],{"type":33,"value":1248},{"type":27,"tag":714,"props":1471,"children":1472},{},[],{"type":27,"tag":28,"props":1474,"children":1476},{"id":1475},"必交付物-1最小回归任务清单10-条通用",[1477],{"type":33,"value":1478},"必交付物 1：最小回归任务清单（10 条，通用）",{"type":27,"tag":1022,"props":1480,"children":1481},{},[1482],{"type":27,"tag":36,"props":1483,"children":1484},{},[1485],{"type":33,"value":1486},"这份清单的意义：让每次 AI 改动都能“被验证”。否则你只是把不可控变成了更快的不可控。",{"type":27,"tag":264,"props":1488,"children":1489},{},[1490,1495,1500,1505,1510,1515,1520,1525,1530,1535],{"type":27,"tag":46,"props":1491,"children":1492},{},[1493],{"type":33,"value":1494},"关键路径能跑通（手动点击/请求一次）",{"type":27,"tag":46,"props":1496,"children":1497},{},[1498],{"type":33,"value":1499},"错误路径能触发（模拟一次失败输入）",{"type":27,"tag":46,"props":1501,"children":1502},{},[1503],{"type":33,"value":1504},"控制台无新增错误（至少关注 1 次真实操作）",{"type":27,"tag":46,"props":1506,"children":1507},{},[1508],{"type":33,"value":1509},"关键 UI 未错位（移动端/桌面端各看一眼）",{"type":27,"tag":46,"props":1511,"children":1512},{},[1513],{"type":33,"value":1514},"刷新后状态正确（尤其是表单/列表）",{"type":27,"tag":46,"props":1516,"children":1517},{},[1518],{"type":33,"value":1519},"路由跳转没断（从入口到目标页）",{"type":27,"tag":46,"props":1521,"children":1522},{},[1523],{"type":33,"value":1524},"相关接口未改变契约（字段名/类型）",{"type":27,"tag":46,"props":1526,"children":1527},{},[1528],{"type":33,"value":1529},"性能没有明显退化（首屏、交互卡顿）",{"type":27,"tag":46,"props":1531,"children":1532},{},[1533],{"type":33,"value":1534},"回滚方案可执行（知道回滚哪几个文件/commit）",{"type":27,"tag":46,"props":1536,"children":1537},{},[1538],{"type":33,"value":1539},"写下“这次改动解决了什么、风险是什么”（可贴 PR）",{"type":27,"tag":714,"props":1541,"children":1542},{},[],{"type":27,"tag":28,"props":1544,"children":1546},{"id":1545},"必交付物-2失败案例复盘真实会发生",[1547],{"type":33,"value":1548},"必交付物 2：失败案例复盘（真实会发生）",{"type":27,"tag":495,"props":1550,"children":1552},{"id":1551},"现象快捷键用得很熟但交付还是慢",[1553],{"type":33,"value":1554},"现象：快捷键用得很熟，但交付还是慢",{"type":27,"tag":36,"props":1556,"children":1557},{},[1558],{"type":33,"value":1559},"典型原因：你把 Cursor 当成“更聪明的搜索框”，不断对话，直到它给出你想要的答案。",{"type":27,"tag":36,"props":1561,"children":1562},{},[1563],{"type":33,"value":1564},"复现路径：",{"type":27,"tag":42,"props":1566,"children":1567},{},[1568,1573,1578,1583],{"type":27,"tag":46,"props":1569,"children":1570},{},[1571],{"type":33,"value":1572},"你直接说“把页面做得更好看、更高级”",{"type":27,"tag":46,"props":1574,"children":1575},{},[1576],{"type":33,"value":1577},"AI 开始大改样式、抽象组件、甚至引入新依赖",{"type":27,"tag":46,"props":1579,"children":1580},{},[1581],{"type":33,"value":1582},"你为了省事按了“接受建议”",{"type":27,"tag":46,"props":1584,"children":1585},{},[1586],{"type":33,"value":1587},"最后发现：设计没统一、移动端崩、甚至埋了性能问题",{"type":27,"tag":36,"props":1589,"children":1590},{},[1591,1593,1597,1599,1604],{"type":33,"value":1592},"根因：缺少",{"type":27,"tag":653,"props":1594,"children":1595},{},[1596],{"type":33,"value":778},{"type":33,"value":1598},"与",{"type":27,"tag":653,"props":1600,"children":1601},{},[1602],{"type":33,"value":1603},"验收",{"type":33,"value":1605},"。",{"type":27,"tag":36,"props":1607,"children":1608},{},[1609],{"type":33,"value":1610},"修复方式（可照抄）：",{"type":27,"tag":42,"props":1612,"children":1613},{},[1614,1619,1631],{"type":27,"tag":46,"props":1615,"children":1616},{},[1617],{"type":33,"value":1618},"把需求拆成 3 个可验证目标：例如“按钮样式统一”“首屏 CTA 更明显”“移动端间距不挤”",{"type":27,"tag":46,"props":1620,"children":1621},{},[1622,1624,1629],{"type":33,"value":1623},"每个目标只用 ",{"type":27,"tag":243,"props":1625,"children":1627},{"className":1626},[],[1628],{"type":33,"value":1090},{"type":33,"value":1630}," 改一个局部",{"type":27,"tag":46,"props":1632,"children":1633},{},[1634],{"type":33,"value":1635},"每次接受建议前跑一遍“最小回归集”",{"type":27,"tag":714,"props":1637,"children":1638},{},[],{"type":27,"tag":28,"props":1640,"children":1642},{"id":1641},"faq高频问题",[1643],{"type":33,"value":1644},"FAQ（高频问题）",{"type":27,"tag":495,"props":1646,"children":1648},{"id":1647},"q1我应该先记快捷键还是先学工作流",[1649],{"type":33,"value":1650},"Q1：我应该先记快捷键还是先学工作流？",{"type":27,"tag":36,"props":1652,"children":1653},{},[1654],{"type":33,"value":1655},"先学工作流。快捷键只是把工作流的步骤变短。",{"type":27,"tag":495,"props":1657,"children":1659},{"id":1658},"q2为什么我一用多文件就容易翻车",[1660],{"type":33,"value":1661},"Q2：为什么我一用多文件就容易翻车？",{"type":27,"tag":36,"props":1663,"children":1664},{},[1665],{"type":33,"value":1666},"因为多文件意味着范围更大、依赖更多、验收更难。先锁定“文件清单 + 每步验收”，再让它动手。",{"type":27,"tag":495,"props":1668,"children":1670},{"id":1669},"q3有没有万能提示词",[1671],{"type":33,"value":1672},"Q3：有没有“万能提示词”？",{"type":27,"tag":36,"props":1674,"children":1675},{},[1676],{"type":33,"value":1677},"没有，但有“万能结构”：目标、范围、非目标、验收、输出格式。",{"type":27,"tag":714,"props":1679,"children":1680},{},[],{"type":27,"tag":28,"props":1682,"children":1684},{"id":1683},"延伸阅读建议按顺序",[1685],{"type":33,"value":1686},"延伸阅读（建议按顺序）",{"type":27,"tag":42,"props":1688,"children":1689},{},[1690,1697,1704,1711],{"type":27,"tag":46,"props":1691,"children":1692},{},[1693],{"type":27,"tag":540,"props":1694,"children":1695},{"href":687},[1696],{"type":33,"value":690},{"type":27,"tag":46,"props":1698,"children":1699},{},[1700],{"type":27,"tag":540,"props":1701,"children":1702},{"href":698},[1703],{"type":33,"value":701},{"type":27,"tag":46,"props":1705,"children":1706},{},[1707],{"type":27,"tag":540,"props":1708,"children":1709},{"href":709},[1710],{"type":33,"value":712},{"type":27,"tag":46,"props":1712,"children":1713},{},[1714,1716],{"type":33,"value":1715},"如果你更关心“网页制作落地”：看这篇 ",{"type":27,"tag":540,"props":1717,"children":1719},{"href":1718},"/topics/practical-tips/htmlpage-quick-landing-page",[1720],{"type":33,"value":1721},"3 分钟用 HTMLPAGE 做落地页",{"title":7,"searchDepth":574,"depth":574,"links":1723},[1724,1725,1726,1738,1739,1742,1747],{"id":719,"depth":577,"text":722},{"id":794,"depth":577,"text":797},{"id":1035,"depth":577,"text":1038,"children":1727},[1728,1729,1730,1731,1732,1733,1734,1735,1736,1737],{"id":1041,"depth":574,"text":1044},{"id":1100,"depth":574,"text":1103},{"id":1170,"depth":574,"text":1173},{"id":1226,"depth":574,"text":1229},{"id":1266,"depth":574,"text":1269},{"id":1305,"depth":574,"text":1308},{"id":1324,"depth":574,"text":1327},{"id":1366,"depth":574,"text":1369},{"id":1401,"depth":574,"text":1404},{"id":1418,"depth":574,"text":1421},{"id":1475,"depth":577,"text":1478},{"id":1545,"depth":577,"text":1548,"children":1740},[1741],{"id":1551,"depth":574,"text":1554},{"id":1641,"depth":577,"text":1644,"children":1743},[1744,1745,1746],{"id":1647,"depth":574,"text":1650},{"id":1658,"depth":574,"text":1661},{"id":1669,"depth":574,"text":1672},{"id":1683,"depth":577,"text":1686},"content:topics:ai:cursor-keyboard-shortcuts-cheatsheet.md","topics/ai/cursor-keyboard-shortcuts-cheatsheet.md","topics/ai/cursor-keyboard-shortcuts-cheatsheet",{"_path":1752,"_dir":5,"_draft":6,"_partial":6,"_locale":7,"title":1753,"description":1754,"date":1755,"topic":5,"author":11,"tags":1756,"image":1760,"imageAlt":1761,"pexelsPhotoId":1762,"pexelsUrl":1763,"readingTime":1764,"body":1765,"_type":591,"_id":2695,"_source":593,"_file":2696,"_stem":2697,"_extension":596},"/topics/ai/cursor-vs-copilot-vscode-workflow","Cursor vs GitHub Copilot vs VS Code：怎么选、怎么搭配、怎么把风险关在笼子里","用“任务类型×风险×验收成本”的选择矩阵解释 Cursor/Copilot/VS Code 的差异，并给出一套可落地的协作工作流（范围闸门、最小回归集、回滚策略）。","2026-03-01",[604,1757,607,1758,1759],"GitHub Copilot","AI 编程","工作流","/images/topics/ai/cursor-vs-copilot-vscode-workflow.jpg","团队在电脑前进行协作讨论",1181371,"https://www.pexels.com/photo/man-wearing-blue-dress-shirt-1181371/",15,{"type":24,"children":1766,"toc":2673},[1767,1772,1777,1795,1800,1818,1821,1827,1832,1863,1868,1871,1877,1885,2089,2097,2110,2113,2119,2125,2138,2143,2156,2162,2167,2200,2206,2211,2229,2232,2238,2243,2249,2254,2287,2293,2306,2311,2324,2330,2342,2348,2353,2366,2371,2374,2380,2385,2506,2509,2515,2525,2534,2552,2561,2569,2578,2596,2599,2603,2609,2614,2620,2625,2628,2632],{"type":27,"tag":36,"props":1768,"children":1769},{},[1770],{"type":33,"value":1771},"“Cursor 和 Copilot 到底有什么区别？”",{"type":27,"tag":36,"props":1773,"children":1774},{},[1775],{"type":33,"value":1776},"这个问题问得越早越好，因为你一旦把工具选错，后面所有痛苦都不是“提示词不够好”，而是：",{"type":27,"tag":42,"props":1778,"children":1779},{},[1780,1785,1790],{"type":27,"tag":46,"props":1781,"children":1782},{},[1783],{"type":33,"value":1784},"改动不可控（范围漂移、改错文件）",{"type":27,"tag":46,"props":1786,"children":1787},{},[1788],{"type":33,"value":1789},"验收成本爆炸（不知道要测什么）",{"type":27,"tag":46,"props":1791,"children":1792},{},[1793],{"type":33,"value":1794},"团队协作崩盘（没有闸门、没有回滚）",{"type":27,"tag":36,"props":1796,"children":1797},{},[1798],{"type":33,"value":1799},"这篇文章用一张选择矩阵 + 一套可执行工作流，帮你做到两件事：",{"type":27,"tag":264,"props":1801,"children":1802},{},[1803,1808],{"type":27,"tag":46,"props":1804,"children":1805},{},[1806],{"type":33,"value":1807},"知道什么时候用 Cursor、什么时候用 Copilot、什么时候“纯 VS Code 更快”",{"type":27,"tag":46,"props":1809,"children":1810},{},[1811,1813],{"type":33,"value":1812},"就算用 AI，也能把风险关在笼子里：",{"type":27,"tag":653,"props":1814,"children":1815},{},[1816],{"type":33,"value":1817},"可审查、可验证、可回滚",{"type":27,"tag":714,"props":1819,"children":1820},{},[],{"type":27,"tag":28,"props":1822,"children":1824},{"id":1823},"结论先说三者不是互斥而是分工",[1825],{"type":33,"value":1826},"结论先说：三者不是互斥，而是分工",{"type":27,"tag":36,"props":1828,"children":1829},{},[1830],{"type":33,"value":1831},"你可以把它们看成三层能力：",{"type":27,"tag":42,"props":1833,"children":1834},{},[1835,1844,1854],{"type":27,"tag":46,"props":1836,"children":1837},{},[1838,1842],{"type":27,"tag":653,"props":1839,"children":1840},{},[1841],{"type":33,"value":607},{"type":33,"value":1843},"：编辑器与生态（调试、插件、任务、终端、语言服务）",{"type":27,"tag":46,"props":1845,"children":1846},{},[1847,1852],{"type":27,"tag":653,"props":1848,"children":1849},{},[1850],{"type":33,"value":1851},"Copilot",{"type":33,"value":1853},"：代码补全与局部建议（“我正在写这一行/这一段”）",{"type":27,"tag":46,"props":1855,"children":1856},{},[1857,1861],{"type":27,"tag":653,"props":1858,"children":1859},{},[1860],{"type":33,"value":604},{"type":33,"value":1862},"：以项目为单位的 AI 协作（对话、索引、多文件编辑、规则）",{"type":27,"tag":36,"props":1864,"children":1865},{},[1866],{"type":33,"value":1867},"最常见的误区是：把“局部补全能力”当作“能做架构与多文件落地”。",{"type":27,"tag":714,"props":1869,"children":1870},{},[],{"type":27,"tag":28,"props":1872,"children":1874},{"id":1873},"选择矩阵按任务类型选工具不是按偏好",[1875],{"type":33,"value":1876},"选择矩阵：按任务类型选工具（不是按偏好）",{"type":27,"tag":1022,"props":1878,"children":1879},{},[1880],{"type":27,"tag":36,"props":1881,"children":1882},{},[1883],{"type":33,"value":1884},"你只要把自己的任务放进表格，就能得到推荐路径。",{"type":27,"tag":88,"props":1886,"children":1887},{},[1888,1920],{"type":27,"tag":92,"props":1889,"children":1890},{},[1891],{"type":27,"tag":96,"props":1892,"children":1893},{},[1894,1899,1905,1910,1915],{"type":27,"tag":100,"props":1895,"children":1896},{},[1897],{"type":33,"value":1898},"任务类型",{"type":27,"tag":100,"props":1900,"children":1902},{"align":1901},"right",[1903],{"type":33,"value":1904},"风险",{"type":27,"tag":100,"props":1906,"children":1907},{"align":1901},[1908],{"type":33,"value":1909},"验收成本",{"type":27,"tag":100,"props":1911,"children":1912},{},[1913],{"type":33,"value":1914},"更推荐",{"type":27,"tag":100,"props":1916,"children":1917},{},[1918],{"type":33,"value":1919},"为什么",{"type":27,"tag":116,"props":1921,"children":1922},{},[1923,1950,1983,2009,2036,2063],{"type":27,"tag":96,"props":1924,"children":1925},{},[1926,1931,1936,1940,1945],{"type":27,"tag":123,"props":1927,"children":1928},{},[1929],{"type":33,"value":1930},"写一段代码/补一个 if",{"type":27,"tag":123,"props":1932,"children":1933},{"align":1901},[1934],{"type":33,"value":1935},"低",{"type":27,"tag":123,"props":1937,"children":1938},{"align":1901},[1939],{"type":33,"value":1935},{"type":27,"tag":123,"props":1941,"children":1942},{},[1943],{"type":33,"value":1944},"Copilot / Cursor 内联编辑",{"type":27,"tag":123,"props":1946,"children":1947},{},[1948],{"type":33,"value":1949},"局部建议足够，成本最低",{"type":27,"tag":96,"props":1951,"children":1952},{},[1953,1958,1963,1967,1978],{"type":27,"tag":123,"props":1954,"children":1955},{},[1956],{"type":33,"value":1957},"重构一个函数",{"type":27,"tag":123,"props":1959,"children":1960},{"align":1901},[1961],{"type":33,"value":1962},"中",{"type":27,"tag":123,"props":1964,"children":1965},{"align":1901},[1966],{"type":33,"value":1962},{"type":27,"tag":123,"props":1968,"children":1969},{},[1970,1972],{"type":33,"value":1971},"Cursor ",{"type":27,"tag":243,"props":1973,"children":1975},{"className":1974},[],[1976],{"type":33,"value":1977},"内联编辑",{"type":27,"tag":123,"props":1979,"children":1980},{},[1981],{"type":33,"value":1982},"需要解释、需要约束输出",{"type":27,"tag":96,"props":1984,"children":1985},{},[1986,1991,1995,1999,2004],{"type":27,"tag":123,"props":1987,"children":1988},{},[1989],{"type":33,"value":1990},"改一个组件 + 样式",{"type":27,"tag":123,"props":1992,"children":1993},{"align":1901},[1994],{"type":33,"value":1962},{"type":27,"tag":123,"props":1996,"children":1997},{"align":1901},[1998],{"type":33,"value":1962},{"type":27,"tag":123,"props":2000,"children":2001},{},[2002],{"type":33,"value":2003},"Cursor（小范围多文件）",{"type":27,"tag":123,"props":2005,"children":2006},{},[2007],{"type":33,"value":2008},"需要同时改模板与样式",{"type":27,"tag":96,"props":2010,"children":2011},{},[2012,2017,2022,2026,2031],{"type":27,"tag":123,"props":2013,"children":2014},{},[2015],{"type":33,"value":2016},"改 3~5 个文件（组件+api+测试）",{"type":27,"tag":123,"props":2018,"children":2019},{"align":1901},[2020],{"type":33,"value":2021},"高",{"type":27,"tag":123,"props":2023,"children":2024},{"align":1901},[2025],{"type":33,"value":2021},{"type":27,"tag":123,"props":2027,"children":2028},{},[2029],{"type":33,"value":2030},"Cursor Composer + 闸门",{"type":27,"tag":123,"props":2032,"children":2033},{},[2034],{"type":33,"value":2035},"需要计划、验收、回滚",{"type":27,"tag":96,"props":2037,"children":2038},{},[2039,2044,2049,2053,2058],{"type":27,"tag":123,"props":2040,"children":2041},{},[2042],{"type":33,"value":2043},"重写一段架构/引入新依赖",{"type":27,"tag":123,"props":2045,"children":2046},{"align":1901},[2047],{"type":33,"value":2048},"很高",{"type":27,"tag":123,"props":2050,"children":2051},{"align":1901},[2052],{"type":33,"value":2048},{"type":27,"tag":123,"props":2054,"children":2055},{},[2056],{"type":33,"value":2057},"先人脑设计 + VS Code 实现",{"type":27,"tag":123,"props":2059,"children":2060},{},[2061],{"type":33,"value":2062},"AI 易发散，最好先设计再执行",{"type":27,"tag":96,"props":2064,"children":2065},{},[2066,2071,2075,2079,2084],{"type":27,"tag":123,"props":2067,"children":2068},{},[2069],{"type":33,"value":2070},"排查线上问题/性能抖动",{"type":27,"tag":123,"props":2072,"children":2073},{"align":1901},[2074],{"type":33,"value":2021},{"type":27,"tag":123,"props":2076,"children":2077},{"align":1901},[2078],{"type":33,"value":2048},{"type":27,"tag":123,"props":2080,"children":2081},{},[2082],{"type":33,"value":2083},"VS Code + 工具链优先，AI 辅助归纳",{"type":27,"tag":123,"props":2085,"children":2086},{},[2087],{"type":33,"value":2088},"需要证据，不要“猜”",{"type":27,"tag":36,"props":2090,"children":2091},{},[2092],{"type":27,"tag":653,"props":2093,"children":2094},{},[2095],{"type":33,"value":2096},"一句话规则：",{"type":27,"tag":42,"props":2098,"children":2099},{},[2100,2105],{"type":27,"tag":46,"props":2101,"children":2102},{},[2103],{"type":33,"value":2104},"当你的改动可以用“10 条最小回归集”覆盖时，用 Cursor。",{"type":27,"tag":46,"props":2106,"children":2107},{},[2108],{"type":33,"value":2109},"当你的改动无法验证时，先别让 AI 动手。",{"type":27,"tag":714,"props":2111,"children":2112},{},[],{"type":27,"tag":28,"props":2114,"children":2116},{"id":2115},"差异拆解到底差在哪里",[2117],{"type":33,"value":2118},"差异拆解：到底差在哪里？",{"type":27,"tag":495,"props":2120,"children":2122},{"id":2121},"_1-上下文来源补全-vs-项目索引",[2123],{"type":33,"value":2124},"1) 上下文来源：补全 vs 项目索引",{"type":27,"tag":42,"props":2126,"children":2127},{},[2128,2133],{"type":27,"tag":46,"props":2129,"children":2130},{},[2131],{"type":33,"value":2132},"Copilot 更擅长：你正在写的这几行、当前文件的局部上下文",{"type":27,"tag":46,"props":2134,"children":2135},{},[2136],{"type":33,"value":2137},"Cursor 更擅长：项目级索引 + 多文件关联理解",{"type":27,"tag":36,"props":2139,"children":2140},{},[2141],{"type":33,"value":2142},"因此：",{"type":27,"tag":42,"props":2144,"children":2145},{},[2146,2151],{"type":27,"tag":46,"props":2147,"children":2148},{},[2149],{"type":33,"value":2150},"写代码片段：Copilot 速度更快",{"type":27,"tag":46,"props":2152,"children":2153},{},[2154],{"type":33,"value":2155},"改一坨工程：Cursor 更有胜算（但更需要闸门）",{"type":27,"tag":495,"props":2157,"children":2159},{"id":2158},"_2-交互方式你能不能控制范围",[2160],{"type":33,"value":2161},"2) 交互方式：你能不能控制范围",{"type":27,"tag":36,"props":2163,"children":2164},{},[2165],{"type":33,"value":2166},"范围控制的三个层级：",{"type":27,"tag":264,"props":2168,"children":2169},{},[2170,2180,2190],{"type":27,"tag":46,"props":2171,"children":2172},{},[2173,2175],{"type":33,"value":2174},"内联编辑（选中一段）→ ",{"type":27,"tag":653,"props":2176,"children":2177},{},[2178],{"type":33,"value":2179},"最强范围控制",{"type":27,"tag":46,"props":2181,"children":2182},{},[2183,2185],{"type":33,"value":2184},"Composer 多文件（先列文件清单）→ ",{"type":27,"tag":653,"props":2186,"children":2187},{},[2188],{"type":33,"value":2189},"可控但要闸门",{"type":27,"tag":46,"props":2191,"children":2192},{},[2193,2195],{"type":33,"value":2194},"大对话（泛目标）→ ",{"type":27,"tag":653,"props":2196,"children":2197},{},[2198],{"type":33,"value":2199},"最容易跑偏",{"type":27,"tag":495,"props":2201,"children":2203},{"id":2202},"_3-输出形态建议-vs-可审查的变更",[2204],{"type":33,"value":2205},"3) 输出形态：建议 vs 可审查的变更",{"type":27,"tag":36,"props":2207,"children":2208},{},[2209],{"type":33,"value":2210},"最好的 AI 输出不是“给我一段代码”，而是：",{"type":27,"tag":42,"props":2212,"children":2213},{},[2214,2219,2224],{"type":27,"tag":46,"props":2215,"children":2216},{},[2217],{"type":33,"value":2218},"改动摘要（做了什么）",{"type":27,"tag":46,"props":2220,"children":2221},{},[2222],{"type":33,"value":2223},"diff 级别的可审查变更",{"type":27,"tag":46,"props":2225,"children":2226},{},[2227],{"type":33,"value":2228},"验收步骤与回滚方案",{"type":27,"tag":714,"props":2230,"children":2231},{},[],{"type":27,"tag":28,"props":2233,"children":2235},{"id":2234},"一套可落地的团队工作流把风险关住",[2236],{"type":33,"value":2237},"一套可落地的团队工作流（把风险关住）",{"type":27,"tag":36,"props":2239,"children":2240},{},[2241],{"type":33,"value":2242},"下面这套流程，你可以直接写进团队规范：",{"type":27,"tag":495,"props":2244,"children":2246},{"id":2245},"step-1先写任务单geo-友好结构",[2247],{"type":33,"value":2248},"Step 1：先写任务单（GEO 友好结构）",{"type":27,"tag":36,"props":2250,"children":2251},{},[2252],{"type":33,"value":2253},"模板：",{"type":27,"tag":42,"props":2255,"children":2256},{},[2257,2262,2267,2272,2277,2282],{"type":27,"tag":46,"props":2258,"children":2259},{},[2260],{"type":33,"value":2261},"目标：……",{"type":27,"tag":46,"props":2263,"children":2264},{},[2265],{"type":33,"value":2266},"背景：……",{"type":27,"tag":46,"props":2268,"children":2269},{},[2270],{"type":33,"value":2271},"范围：只改这些文件/模块：……",{"type":27,"tag":46,"props":2273,"children":2274},{},[2275],{"type":33,"value":2276},"非目标：不做哪些事情：……",{"type":27,"tag":46,"props":2278,"children":2279},{},[2280],{"type":33,"value":2281},"验收：如何判断完成（可测试/可观察）：……",{"type":27,"tag":46,"props":2283,"children":2284},{},[2285],{"type":33,"value":2286},"回滚：如果失败怎么撤回：……",{"type":27,"tag":495,"props":2288,"children":2290},{"id":2289},"step-2用范围闸门限制-ai",[2291],{"type":33,"value":2292},"Step 2：用“范围闸门”限制 AI",{"type":27,"tag":42,"props":2294,"children":2295},{},[2296,2301],{"type":27,"tag":46,"props":2297,"children":2298},{},[2299],{"type":33,"value":2300},"单文件改动：优先 Cursor 内联编辑",{"type":27,"tag":46,"props":2302,"children":2303},{},[2304],{"type":33,"value":2305},"多文件改动：必须先让 AI 输出“文件清单（≤5）+ 每步验收”",{"type":27,"tag":36,"props":2307,"children":2308},{},[2309],{"type":33,"value":2310},"如果 AI 输出的文件清单超过 5 个：",{"type":27,"tag":42,"props":2312,"children":2313},{},[2314,2319],{"type":27,"tag":46,"props":2315,"children":2316},{},[2317],{"type":33,"value":2318},"不是它太强，是任务太大",{"type":27,"tag":46,"props":2320,"children":2321},{},[2322],{"type":33,"value":2323},"你需要拆任务，而不是继续推进",{"type":27,"tag":495,"props":2325,"children":2327},{"id":2326},"step-3最小回归集10-条",[2328],{"type":33,"value":2329},"Step 3：最小回归集（10 条）",{"type":27,"tag":36,"props":2331,"children":2332},{},[2333,2335,2340],{"type":33,"value":2334},"每次接受改动前必须跑（可参考：",{"type":27,"tag":540,"props":2336,"children":2337},{"href":599},[2338],{"type":33,"value":2339},"Cursor 快捷键速查表",{"type":33,"value":2341}," 里的清单）。",{"type":27,"tag":495,"props":2343,"children":2345},{"id":2344},"step-4回滚策略不用等事故才想",[2346],{"type":33,"value":2347},"Step 4：回滚策略（不用等事故才想）",{"type":27,"tag":36,"props":2349,"children":2350},{},[2351],{"type":33,"value":2352},"回滚最常见的两条路：",{"type":27,"tag":42,"props":2354,"children":2355},{},[2356,2361],{"type":27,"tag":46,"props":2357,"children":2358},{},[2359],{"type":33,"value":2360},"git 回滚 commit",{"type":27,"tag":46,"props":2362,"children":2363},{},[2364],{"type":33,"value":2365},"对关键文件保留前版本（至少能快速恢复）",{"type":27,"tag":36,"props":2367,"children":2368},{},[2369],{"type":33,"value":2370},"你需要做到：任何一轮 AI 改动都能在 5 分钟内撤回。",{"type":27,"tag":714,"props":2372,"children":2373},{},[],{"type":27,"tag":28,"props":2375,"children":2377},{"id":2376},"必交付物对比矩阵可复制",[2378],{"type":33,"value":2379},"必交付物：对比矩阵（可复制）",{"type":27,"tag":36,"props":2381,"children":2382},{},[2383],{"type":33,"value":2384},"下面这张表可以直接贴到你的团队 wiki：",{"type":27,"tag":88,"props":2386,"children":2387},{},[2388,2411],{"type":27,"tag":92,"props":2389,"children":2390},{},[2391],{"type":27,"tag":96,"props":2392,"children":2393},{},[2394,2399,2403,2407],{"type":27,"tag":100,"props":2395,"children":2396},{},[2397],{"type":33,"value":2398},"维度",{"type":27,"tag":100,"props":2400,"children":2401},{},[2402],{"type":33,"value":607},{"type":27,"tag":100,"props":2404,"children":2405},{},[2406],{"type":33,"value":1851},{"type":27,"tag":100,"props":2408,"children":2409},{},[2410],{"type":33,"value":604},{"type":27,"tag":116,"props":2412,"children":2413},{},[2414,2437,2460,2483],{"type":27,"tag":96,"props":2415,"children":2416},{},[2417,2422,2427,2432],{"type":27,"tag":123,"props":2418,"children":2419},{},[2420],{"type":33,"value":2421},"强项",{"type":27,"tag":123,"props":2423,"children":2424},{},[2425],{"type":33,"value":2426},"工具链、调试、生态",{"type":27,"tag":123,"props":2428,"children":2429},{},[2430],{"type":33,"value":2431},"补全与局部建议",{"type":27,"tag":123,"props":2433,"children":2434},{},[2435],{"type":33,"value":2436},"项目上下文、多文件落地",{"type":27,"tag":96,"props":2438,"children":2439},{},[2440,2445,2450,2455],{"type":27,"tag":123,"props":2441,"children":2442},{},[2443],{"type":33,"value":2444},"适合任务",{"type":27,"tag":123,"props":2446,"children":2447},{},[2448],{"type":33,"value":2449},"排查、调试、验证",{"type":27,"tag":123,"props":2451,"children":2452},{},[2453],{"type":33,"value":2454},"写一段、补一段",{"type":27,"tag":123,"props":2456,"children":2457},{},[2458],{"type":33,"value":2459},"改一段、改一组文件",{"type":27,"tag":96,"props":2461,"children":2462},{},[2463,2468,2473,2478],{"type":27,"tag":123,"props":2464,"children":2465},{},[2466],{"type":33,"value":2467},"最大风险",{"type":27,"tag":123,"props":2469,"children":2470},{},[2471],{"type":33,"value":2472},"无",{"type":27,"tag":123,"props":2474,"children":2475},{},[2476],{"type":33,"value":2477},"过度依赖建议",{"type":27,"tag":123,"props":2479,"children":2480},{},[2481],{"type":33,"value":2482},"范围漂移、多文件回归",{"type":27,"tag":96,"props":2484,"children":2485},{},[2486,2491,2496,2501],{"type":27,"tag":123,"props":2487,"children":2488},{},[2489],{"type":33,"value":2490},"必须搭配",{"type":27,"tag":123,"props":2492,"children":2493},{},[2494],{"type":33,"value":2495},"规范与检查",{"type":27,"tag":123,"props":2497,"children":2498},{},[2499],{"type":33,"value":2500},"代码评审",{"type":27,"tag":123,"props":2502,"children":2503},{},[2504],{"type":33,"value":2505},"闸门 + 最小回归集",{"type":27,"tag":714,"props":2507,"children":2508},{},[],{"type":27,"tag":28,"props":2510,"children":2512},{"id":2511},"失败案例多文件看似成功实际埋雷",[2513],{"type":33,"value":2514},"失败案例：多文件“看似成功”，实际埋雷",{"type":27,"tag":36,"props":2516,"children":2517},{},[2518,2523],{"type":27,"tag":653,"props":2519,"children":2520},{},[2521],{"type":33,"value":2522},"现象",{"type":33,"value":2524},"：AI 说“我已经把所有地方都改了”，你也接受了，结果上线后 404 或样式错位。",{"type":27,"tag":36,"props":2526,"children":2527},{},[2528,2533],{"type":27,"tag":653,"props":2529,"children":2530},{},[2531],{"type":33,"value":2532},"复现条件",{"type":33,"value":1345},{"type":27,"tag":42,"props":2535,"children":2536},{},[2537,2542,2547],{"type":27,"tag":46,"props":2538,"children":2539},{},[2540],{"type":33,"value":2541},"你给了一个大目标（例如“把所有按钮统一成主题色”）",{"type":27,"tag":46,"props":2543,"children":2544},{},[2545],{"type":33,"value":2546},"它改了组件、样式、甚至主题配置",{"type":27,"tag":46,"props":2548,"children":2549},{},[2550],{"type":33,"value":2551},"你没有按页面模块走一遍，直接合并",{"type":27,"tag":36,"props":2553,"children":2554},{},[2555,2560],{"type":27,"tag":653,"props":2556,"children":2557},{},[2558],{"type":33,"value":2559},"根因",{"type":33,"value":1345},{"type":27,"tag":42,"props":2562,"children":2563},{},[2564],{"type":27,"tag":46,"props":2565,"children":2566},{},[2567],{"type":33,"value":2568},"改动范围大，但验收仍按“小改动”的方式做（只看一处）",{"type":27,"tag":36,"props":2570,"children":2571},{},[2572,2577],{"type":27,"tag":653,"props":2573,"children":2574},{},[2575],{"type":33,"value":2576},"修复",{"type":33,"value":1345},{"type":27,"tag":42,"props":2579,"children":2580},{},[2581,2586,2591],{"type":27,"tag":46,"props":2582,"children":2583},{},[2584],{"type":33,"value":2585},"强制把任务拆成“模块级目标”：Hero、Feature、Pricing、Form",{"type":27,"tag":46,"props":2587,"children":2588},{},[2589],{"type":33,"value":2590},"每个模块改完就验收一次",{"type":27,"tag":46,"props":2592,"children":2593},{},[2594],{"type":33,"value":2595},"验收通过再进入下一个模块",{"type":27,"tag":714,"props":2597,"children":2598},{},[],{"type":27,"tag":28,"props":2600,"children":2601},{"id":490},[2602],{"type":33,"value":493},{"type":27,"tag":495,"props":2604,"children":2606},{"id":2605},"q1我已经用了-cursor为什么还要用-copilot",[2607],{"type":33,"value":2608},"Q1：我已经用了 Cursor，为什么还要用 Copilot？",{"type":27,"tag":36,"props":2610,"children":2611},{},[2612],{"type":33,"value":2613},"因为“补全”这种高频低风险任务，Copilot 的交互成本更低；Cursor 更适合需要解释与约束的改动。",{"type":27,"tag":495,"props":2615,"children":2617},{"id":2616},"q2什么时候应该完全不用-ai",[2618],{"type":33,"value":2619},"Q2：什么时候应该完全不用 AI？",{"type":27,"tag":36,"props":2621,"children":2622},{},[2623],{"type":33,"value":2624},"当你无法定义验收标准时。比如“更高级”“更好看”这种目标，先做信息结构与设计规则，再让 AI 帮你落地局部。",{"type":27,"tag":714,"props":2626,"children":2627},{},[],{"type":27,"tag":28,"props":2629,"children":2630},{"id":530},[2631],{"type":33,"value":530},{"type":27,"tag":42,"props":2633,"children":2634},{},[2635,2644,2653,2662],{"type":27,"tag":46,"props":2636,"children":2637},{},[2638,2640],{"type":33,"value":2639},"Cursor 入门：",{"type":27,"tag":540,"props":2641,"children":2642},{"href":687},[2643],{"type":33,"value":690},{"type":27,"tag":46,"props":2645,"children":2646},{},[2647,2649],{"type":33,"value":2648},"Cursor 进阶：",{"type":27,"tag":540,"props":2650,"children":2651},{"href":698},[2652],{"type":33,"value":701},{"type":27,"tag":46,"props":2654,"children":2655},{},[2656,2658],{"type":33,"value":2657},"规则配置：",{"type":27,"tag":540,"props":2659,"children":2660},{"href":709},[2661],{"type":33,"value":712},{"type":27,"tag":46,"props":2663,"children":2664},{},[2665,2667],{"type":33,"value":2666},"Copilot 实战：",{"type":27,"tag":540,"props":2668,"children":2670},{"href":2669},"/topics/ai/github-copilot-tips",[2671],{"type":33,"value":2672},"GitHub Copilot 实用技巧",{"title":7,"searchDepth":574,"depth":574,"links":2674},[2675,2676,2677,2682,2688,2689,2690,2694],{"id":1823,"depth":577,"text":1826},{"id":1873,"depth":577,"text":1876},{"id":2115,"depth":577,"text":2118,"children":2678},[2679,2680,2681],{"id":2121,"depth":574,"text":2124},{"id":2158,"depth":574,"text":2161},{"id":2202,"depth":574,"text":2205},{"id":2234,"depth":577,"text":2237,"children":2683},[2684,2685,2686,2687],{"id":2245,"depth":574,"text":2248},{"id":2289,"depth":574,"text":2292},{"id":2326,"depth":574,"text":2329},{"id":2344,"depth":574,"text":2347},{"id":2376,"depth":577,"text":2379},{"id":2511,"depth":577,"text":2514},{"id":490,"depth":577,"text":493,"children":2691},[2692,2693],{"id":2605,"depth":574,"text":2608},{"id":2616,"depth":574,"text":2619},{"id":530,"depth":577,"text":530},"content:topics:ai:cursor-vs-copilot-vscode-workflow.md","topics/ai/cursor-vs-copilot-vscode-workflow.md","topics/ai/cursor-vs-copilot-vscode-workflow",{"_path":2699,"_dir":5,"_draft":6,"_partial":6,"_locale":7,"title":2700,"description":2701,"date":2702,"topic":5,"author":11,"tags":2703,"image":2708,"featured":420,"readingTime":1764,"body":2709,"_type":591,"_id":3357,"_source":593,"_file":3358,"_stem":3359,"_extension":596},"/topics/ai/ai-debugging-troubleshooting-guide","AI 辅助调试与问题排查：让 AI 成为你的调试搭档","深入探讨如何利用 AI 工具提升调试效率，包括错误信息分析、日志解读、性能问题定位、复杂 bug 排查等实战场景，构建 AI 驱动的调试工作流。","2026-01-18",[2704,2705,2706,608,2707],"AI 调试","问题排查","Debug","错误处理","/images/topics/ai/ai-debugging-guide.jpg",{"type":24,"children":2710,"toc":3328},[2711,2717,2723,2728,2733,2738,2744,2750,2755,2763,2791,2799,2822,2828,2838,2847,2855,2863,2896,2904,2934,2947,2955,2960,2968,2976,2987,2993,3001,3012,3020,3029,3035,3041,3046,3055,3061,3066,3075,3081,3087,3096,3102,3111,3117,3128,3134,3140,3149,3155,3164,3170,3176,3184,3190,3199,3207,3215,3218,3224,3229,3248,3260,3263,3269,3274,3283,3288,3291,3297,3302,3320],{"type":27,"tag":28,"props":2712,"children":2714},{"id":2713},"ai-辅助调试与问题排查",[2715],{"type":33,"value":2716},"AI 辅助调试与问题排查",{"type":27,"tag":28,"props":2718,"children":2720},{"id":2719},"引言调试的痛与-ai-的解药",[2721],{"type":33,"value":2722},"引言：调试的痛与 AI 的解药",{"type":27,"tag":36,"props":2724,"children":2725},{},[2726],{"type":33,"value":2727},"调试是每个程序员的日常，也是最消耗时间和精力的工作之一。我们都有过这样的经历：盯着一个莫名其妙的错误信息，翻遍 Stack Overflow，尝试各种方案，几个小时后才发现是一个愚蠢的拼写错误。",{"type":27,"tag":36,"props":2729,"children":2730},{},[2731],{"type":33,"value":2732},"AI 工具的出现，正在改变调试的方式。不是替代你的思考，而是加速你的分析过程——帮你快速理解错误、缩小排查范围、验证假设。",{"type":27,"tag":36,"props":2734,"children":2735},{},[2736],{"type":33,"value":2737},"这篇文章分享我在实际项目中使用 AI 辅助调试的经验和方法论。",{"type":27,"tag":28,"props":2739,"children":2741},{"id":2740},"第一部分建立-ai-调试的思维模型",[2742],{"type":33,"value":2743},"第一部分：建立 AI 调试的思维模型",{"type":27,"tag":495,"props":2745,"children":2747},{"id":2746},"_11-ai-在调试中的角色",[2748],{"type":33,"value":2749},"1.1 AI 在调试中的角色",{"type":27,"tag":36,"props":2751,"children":2752},{},[2753],{"type":33,"value":2754},"把 AI 想象成一个经验丰富但不了解你项目的高级工程师。它：",{"type":27,"tag":36,"props":2756,"children":2757},{},[2758],{"type":27,"tag":653,"props":2759,"children":2760},{},[2761],{"type":33,"value":2762},"擅长的事情：",{"type":27,"tag":42,"props":2764,"children":2765},{},[2766,2771,2776,2781,2786],{"type":27,"tag":46,"props":2767,"children":2768},{},[2769],{"type":33,"value":2770},"解读错误信息的含义",{"type":27,"tag":46,"props":2772,"children":2773},{},[2774],{"type":33,"value":2775},"提供可能的原因列表",{"type":27,"tag":46,"props":2777,"children":2778},{},[2779],{"type":33,"value":2780},"给出排查方向建议",{"type":27,"tag":46,"props":2782,"children":2783},{},[2784],{"type":33,"value":2785},"解释复杂的技术概念",{"type":27,"tag":46,"props":2787,"children":2788},{},[2789],{"type":33,"value":2790},"生成调试代码片段",{"type":27,"tag":36,"props":2792,"children":2793},{},[2794],{"type":27,"tag":653,"props":2795,"children":2796},{},[2797],{"type":33,"value":2798},"不擅长的事情：",{"type":27,"tag":42,"props":2800,"children":2801},{},[2802,2807,2812,2817],{"type":27,"tag":46,"props":2803,"children":2804},{},[2805],{"type":33,"value":2806},"了解你的业务逻辑",{"type":27,"tag":46,"props":2808,"children":2809},{},[2810],{"type":33,"value":2811},"知道你的代码历史",{"type":27,"tag":46,"props":2813,"children":2814},{},[2815],{"type":33,"value":2816},"理解项目特定的约定",{"type":27,"tag":46,"props":2818,"children":2819},{},[2820],{"type":33,"value":2821},"做出架构级判断",{"type":27,"tag":495,"props":2823,"children":2825},{"id":2824},"_12-有效提问的结构",[2826],{"type":33,"value":2827},"1.2 有效提问的结构",{"type":27,"tag":235,"props":2829,"children":2833},{"code":2830,"language":591,"meta":7,"className":2831},"## 高效的调试提问模板\n\n**问题描述**\n[简洁描述遇到的问题]\n\n**错误信息**\n",[2832],"language-markdown",[2834],{"type":27,"tag":243,"props":2835,"children":2836},{"__ignoreMap":7},[2837],{"type":33,"value":2830},{"type":27,"tag":36,"props":2839,"children":2840},{},[2841],{"type":27,"tag":2842,"props":2843,"children":2844},"span",{},[2845],{"type":33,"value":2846},"完整的错误信息，不要截断",{"type":27,"tag":235,"props":2848,"children":2850},{"code":2849},"\n**相关代码**\n```javascript\n[精简但完整的相关代码]\n",[2851],{"type":27,"tag":243,"props":2852,"children":2853},{"__ignoreMap":7},[2854],{"type":33,"value":2849},{"type":27,"tag":36,"props":2856,"children":2857},{},[2858],{"type":27,"tag":653,"props":2859,"children":2860},{},[2861],{"type":33,"value":2862},"环境信息",{"type":27,"tag":42,"props":2864,"children":2865},{},[2866,2876,2886],{"type":27,"tag":46,"props":2867,"children":2868},{},[2869,2871],{"type":33,"value":2870},"运行环境：",{"type":27,"tag":2842,"props":2872,"children":2873},{},[2874],{"type":33,"value":2875},"Node 版本/浏览器版本",{"type":27,"tag":46,"props":2877,"children":2878},{},[2879,2881],{"type":33,"value":2880},"框架版本：",{"type":27,"tag":2842,"props":2882,"children":2883},{},[2884],{"type":33,"value":2885},"相关框架版本",{"type":27,"tag":46,"props":2887,"children":2888},{},[2889,2891],{"type":33,"value":2890},"操作系统：",{"type":27,"tag":2842,"props":2892,"children":2893},{},[2894],{"type":33,"value":2895},"如果相关",{"type":27,"tag":36,"props":2897,"children":2898},{},[2899],{"type":27,"tag":653,"props":2900,"children":2901},{},[2902],{"type":33,"value":2903},"已尝试的方案",{"type":27,"tag":42,"props":2905,"children":2906},{},[2907,2921],{"type":27,"tag":46,"props":2908,"children":2909},{},[2910,2915,2916],{"type":27,"tag":2842,"props":2911,"children":2912},{},[2913],{"type":33,"value":2914},"方案1",{"type":33,"value":1345},{"type":27,"tag":2842,"props":2917,"children":2918},{},[2919],{"type":33,"value":2920},"结果",{"type":27,"tag":46,"props":2922,"children":2923},{},[2924,2929,2930],{"type":27,"tag":2842,"props":2925,"children":2926},{},[2927],{"type":33,"value":2928},"方案2",{"type":33,"value":1345},{"type":27,"tag":2842,"props":2931,"children":2932},{},[2933],{"type":33,"value":2920},{"type":27,"tag":36,"props":2935,"children":2936},{},[2937,2942],{"type":27,"tag":653,"props":2938,"children":2939},{},[2940],{"type":33,"value":2941},"期望的结果",{"type":27,"tag":2842,"props":2943,"children":2944},{},[2945],{"type":33,"value":2946},"描述期望的行为",{"type":27,"tag":235,"props":2948,"children":2950},{"code":2949},"\n### 1.3 分级调试策略\n\n",[2951],{"type":27,"tag":243,"props":2952,"children":2953},{"__ignoreMap":7},[2954],{"type":33,"value":2949},{"type":27,"tag":36,"props":2956,"children":2957},{},[2958],{"type":33,"value":2959},"┌───────────────────────────────────────────────────────────┐\n│ AI 辅助调试决策树 │\n├───────────────────────────────────────────────────────────┤\n│ │\n│ Level 1：简单错误（5分钟内解决） │\n│ ├── 语法错误、拼写错误 │\n│ ├── 方法：直接复制错误信息给 AI │\n│ └── 工具：Copilot Chat / ChatGPT │\n│ │\n│ Level 2：中等复杂度（30分钟内解决） │\n│ ├── 类型错误、逻辑错误、API 使用错误 │\n│ ├── 方法：提供错误信息 + 相关代码 + 上下文 │\n│ └── 工具：Cursor Chat / Claude │\n│ │\n│ Level 3：复杂问题（需要深入分析） │\n│ ├── 竞态条件、内存泄漏、性能问题 │\n│ ├── 方法：详细描述场景 + 提供多个文件 + 讨论 │\n│ └── 工具：Cursor Composer / 专门的 AI 会话 │\n│ │\n│ Level 4：架构级问题 │\n│ ├── 设计缺陷、技术债务 │\n│ ├── 方法：AI 辅助分析 + 人工判断 │\n│ └── 工具：与团队讨论 + AI 作为顾问 │\n│ │\n└───────────────────────────────────────────────────────────┘",{"type":27,"tag":235,"props":2961,"children":2963},{"code":2962},"\n## 第二部分：错误信息分析\n\n### 2.1 前端错误分析\n\n**场景 1：React 错误边界触发**\n\n```typescript\n// 错误信息：\n// Error: Hydration failed because the initial UI does not match \n// what was rendered on the server.\n\n// 提问方式：\n/**\n * 我在 Next.js 14 App Router 项目中遇到这个错误：\n * \n * Error: Hydration failed because the initial UI does not match \n * what was rendered on the server.\n * \n * 相关代码：\n */\nfunction UserStatus() {\n const [isLoggedIn, setIsLoggedIn] = useState(false);\n \n useEffect(() => {\n setIsLoggedIn(localStorage.getItem('token') !== null);\n }, []);\n \n return \u003Cdiv>{isLoggedIn ? '已登录' : '未登录'}\u003C/div>;\n}\n\n// AI 会分析出：\n// 1. 服务端渲染时 localStorage 不可用，默认 false\n// 2. 客户端 hydration 时可能是 true\n// 3. 导致服务端和客户端渲染结果不一致\n\n// AI 建议的解决方案：\nfunction UserStatus() {\n const [isLoggedIn, setIsLoggedIn] = useState\u003Cboolean | null>(null);\n \n useEffect(() => {\n setIsLoggedIn(localStorage.getItem('token') !== null);\n }, []);\n \n // 初始状态显示加载中，避免 hydration 不匹配\n if (isLoggedIn === null) {\n return \u003Cdiv>加载中...\u003C/div>;\n }\n \n return \u003Cdiv>{isLoggedIn ? '已登录' : '未登录'}\u003C/div>;\n}\n",[2964],{"type":27,"tag":243,"props":2965,"children":2966},{"__ignoreMap":7},[2967],{"type":33,"value":2962},{"type":27,"tag":36,"props":2969,"children":2970},{},[2971],{"type":27,"tag":653,"props":2972,"children":2973},{},[2974],{"type":33,"value":2975},"场景 2：Vue 响应式警告",{"type":27,"tag":235,"props":2977,"children":2982},{"code":2978,"language":2979,"meta":7,"className":2980},"// 警告信息：\n// [Vue warn]: Property \"xxx\" was accessed during render but is not \n// defined on instance.\n\n// 提问方式：\n/**\n * Vue 3 项目中出现这个警告：\n * [Vue warn]: Property \"userInfo\" was accessed during render \n * but is not defined on instance.\n * \n * 组件代码：\n */\n\u003Ctemplate>\n \u003Cdiv>{{ userInfo.name }}\u003C/div>\n\u003C/template>\n\n\u003Cscript setup>\nconst { data: userInfo } = await useFetch('/api/user');\n\u003C/script>\n\n// AI 分析：\n// 1. useFetch 是异步的，初始渲染时 userInfo 可能是 undefined\n// 2. 直接访问 userInfo.name 会报错\n\n// AI 建议：\n\u003Ctemplate>\n \u003Cdiv v-if=\"userInfo\">{{ userInfo.name }}\u003C/div>\n \u003Cdiv v-else>加载中...\u003C/div>\n\u003C/template>\n\n\u003Cscript setup>\nconst { data: userInfo, pending } = await useFetch('/api/user');\n\u003C/script>\n","typescript",[2981],"language-typescript",[2983],{"type":27,"tag":243,"props":2984,"children":2985},{"__ignoreMap":7},[2986],{"type":33,"value":2978},{"type":27,"tag":495,"props":2988,"children":2990},{"id":2989},"_22-后端错误分析",[2991],{"type":33,"value":2992},"2.2 后端错误分析",{"type":27,"tag":36,"props":2994,"children":2995},{},[2996],{"type":27,"tag":653,"props":2997,"children":2998},{},[2999],{"type":33,"value":3000},"场景 1：Node.js 内存问题",{"type":27,"tag":235,"props":3002,"children":3007},{"code":3003,"language":3004,"meta":7,"className":3005},"// 错误信息：\n// FATAL ERROR: CALL_AND_RETRY_LAST Allocation failed - \n// JavaScript heap out of memory\n\n// 提问方式（包含上下文）：\n/**\n * Node.js 服务运行几小时后崩溃，错误信息：\n * FATAL ERROR: CALL_AND_RETRY_LAST Allocation failed - \n * JavaScript heap out of memory\n * \n * 服务功能：处理 CSV 文件上传，每次约 100MB\n * \n * 处理代码：\n */\nasync function processCSV(filePath) {\n const content = fs.readFileSync(filePath, 'utf-8');\n const rows = content.split('\\n');\n const results = [];\n \n for (const row of rows) {\n const processed = await processRow(row);\n results.push(processed);\n }\n \n return results;\n}\n\n// AI 分析会指出：\n// 1. 一次性读取整个文件到内存\n// 2. 所有处理结果累积在 results 数组\n// 3. 建议使用流式处理\n\n// AI 提供的优化方案：\nconst { createReadStream } = require('fs');\nconst { createInterface } = require('readline');\n\nasync function processCSVStream(filePath, onRow) {\n const fileStream = createReadStream(filePath);\n const rl = createInterface({\n input: fileStream,\n crlfDelay: Infinity\n });\n \n let count = 0;\n for await (const line of rl) {\n await onRow(line);\n count++;\n \n // 每处理 1000 行，给 GC 机会运行\n if (count % 1000 === 0) {\n await new Promise(r => setImmediate(r));\n }\n }\n}\n","javascript",[3006],"language-javascript",[3008],{"type":27,"tag":243,"props":3009,"children":3010},{"__ignoreMap":7},[3011],{"type":33,"value":3003},{"type":27,"tag":36,"props":3013,"children":3014},{},[3015],{"type":27,"tag":653,"props":3016,"children":3017},{},[3018],{"type":33,"value":3019},"场景 2：数据库连接问题",{"type":27,"tag":235,"props":3021,"children":3024},{"code":3022,"language":2979,"meta":7,"className":3023},"// 错误信息：\n// Error: Connection pool exhausted - \n// max connections (10) already in use\n\n// 提问方式：\n/**\n * PostgreSQL 连接池耗尽错误，高并发时出现：\n * Error: Connection pool exhausted\n * \n * 当前配置：\n * - max connections: 10\n * - 并发请求: 约 100/秒\n * \n * 数据库调用代码：\n */\nasync function getUserData(userId: string) {\n const client = await pool.connect();\n try {\n const user = await client.query('SELECT * FROM users WHERE id = $1', [userId]);\n const orders = await client.query('SELECT * FROM orders WHERE user_id = $1', [userId]);\n const payments = await client.query('SELECT * FROM payments WHERE user_id = $1', [userId]);\n return { user: user.rows[0], orders: orders.rows, payments: payments.rows };\n } finally {\n client.release();\n }\n}\n\n// AI 会分析出多个可能原因并给出综合方案\n",[2981],[3025],{"type":27,"tag":243,"props":3026,"children":3027},{"__ignoreMap":7},[3028],{"type":33,"value":3022},{"type":27,"tag":28,"props":3030,"children":3032},{"id":3031},"第三部分日志分析与问题定位",[3033],{"type":33,"value":3034},"第三部分：日志分析与问题定位",{"type":27,"tag":495,"props":3036,"children":3038},{"id":3037},"_31-结构化日志分析",[3039],{"type":33,"value":3040},"3.1 结构化日志分析",{"type":27,"tag":36,"props":3042,"children":3043},{},[3044],{"type":33,"value":3045},"当面对大量日志时，让 AI 帮你快速定位问题：",{"type":27,"tag":235,"props":3047,"children":3050},{"code":3048,"language":3004,"meta":7,"className":3049},"// 提问示例：\n/**\n * 分析以下日志，找出导致请求失败的原因：\n * \n * 日志片段：\n */\nconst logs = `\n2024-01-15 10:23:45.123 INFO [req-abc123] 收到请求 POST /api/order\n2024-01-15 10:23:45.125 DEBUG [req-abc123] 用户认证通过 userId=u001\n2024-01-15 10:23:45.130 DEBUG [req-abc123] 开始库存检查 productId=p001\n2024-01-15 10:23:45.145 DEBUG [req-abc123] 库存检查通过 available=50\n2024-01-15 10:23:45.150 DEBUG [req-abc123] 开始创建订单\n2024-01-15 10:23:45.200 DEBUG [req-abc123] 数据库连接获取成功\n2024-01-15 10:23:45.250 ERROR [req-abc123] 订单创建失败 error=\"deadlock detected\"\n2024-01-15 10:23:45.251 WARN [req-abc123] 事务回滚\n2024-01-15 10:23:45.255 INFO [req-abc123] 响应 500 耗时 132ms\n`;\n\n// AI 分析结果会包括：\n// 1. 问题定位：数据库死锁\n// 2. 可能原因：并发订单创建导致锁竞争\n// 3. 排查建议：检查事务隔离级别、锁顺序\n",[3006],[3051],{"type":27,"tag":243,"props":3052,"children":3053},{"__ignoreMap":7},[3054],{"type":33,"value":3048},{"type":27,"tag":495,"props":3056,"children":3058},{"id":3057},"_32-创建调试日志",[3059],{"type":33,"value":3060},"3.2 创建调试日志",{"type":27,"tag":36,"props":3062,"children":3063},{},[3064],{"type":33,"value":3065},"让 AI 帮你生成调试用的日志代码：",{"type":27,"tag":235,"props":3067,"children":3070},{"code":3068,"language":2979,"meta":7,"className":3069},"// 请求：\n// \"为这个函数添加详细的调试日志，包括入参、关键步骤、耗时和结果\"\n\n// 原代码：\nasync function processOrder(order: Order): Promise\u003COrderResult> {\n const inventory = await checkInventory(order.items);\n const payment = await processPayment(order.userId, order.total);\n const result = await createOrder(order, payment.transactionId);\n return result;\n}\n\n// AI 生成的带日志版本：\nasync function processOrder(order: Order): Promise\u003COrderResult> {\n const requestId = generateRequestId();\n const startTime = performance.now();\n \n logger.info({\n requestId,\n event: 'order_processing_start',\n orderId: order.id,\n userId: order.userId,\n itemCount: order.items.length,\n total: order.total\n });\n \n try {\n // 库存检查\n const inventoryStart = performance.now();\n const inventory = await checkInventory(order.items);\n logger.debug({\n requestId,\n event: 'inventory_check_complete',\n duration: performance.now() - inventoryStart,\n available: inventory.allAvailable\n });\n \n // 支付处理\n const paymentStart = performance.now();\n const payment = await processPayment(order.userId, order.total);\n logger.debug({\n requestId,\n event: 'payment_complete',\n duration: performance.now() - paymentStart,\n transactionId: payment.transactionId\n });\n \n // 创建订单\n const createStart = performance.now();\n const result = await createOrder(order, payment.transactionId);\n logger.debug({\n requestId,\n event: 'order_created',\n duration: performance.now() - createStart,\n resultOrderId: result.orderId\n });\n \n logger.info({\n requestId,\n event: 'order_processing_complete',\n duration: performance.now() - startTime,\n success: true\n });\n \n return result;\n } catch (error) {\n logger.error({\n requestId,\n event: 'order_processing_failed',\n duration: performance.now() - startTime,\n error: error.message,\n stack: error.stack\n });\n throw error;\n }\n}\n",[2981],[3071],{"type":27,"tag":243,"props":3072,"children":3073},{"__ignoreMap":7},[3074],{"type":33,"value":3068},{"type":27,"tag":28,"props":3076,"children":3078},{"id":3077},"第四部分性能问题排查",[3079],{"type":33,"value":3080},"第四部分：性能问题排查",{"type":27,"tag":495,"props":3082,"children":3084},{"id":3083},"_41-前端性能分析",[3085],{"type":33,"value":3086},"4.1 前端性能分析",{"type":27,"tag":235,"props":3088,"children":3091},{"code":3089,"language":2979,"meta":7,"className":3090},"// 场景：页面加载慢，需要分析原因\n\n// 提问方式：\n/**\n * 页面首屏加载需要 5 秒，以下是 Performance API 数据，\n * 请分析性能瓶颈：\n */\nconst performanceData = {\n // Navigation Timing\n dns: 50, // DNS 查询\n tcp: 100, // TCP 连接\n ttfb: 800, // 首字节时间\n download: 200, // 文档下载\n domParsing: 300, // DOM 解析\n domContentLoaded: 1500,\n load: 5000,\n \n // Resource Timing (主要资源)\n resources: [\n { name: 'main.js', size: '2.5MB', duration: 1200 },\n { name: 'vendor.js', size: '1.8MB', duration: 900 },\n { name: 'styles.css', size: '500KB', duration: 300 },\n { name: 'hero-image.jpg', size: '3MB', duration: 1500 },\n ],\n \n // Long Tasks\n longTasks: [\n { startTime: 1600, duration: 800, name: 'script-evaluation' },\n { startTime: 2500, duration: 400, name: 'layout' }\n ]\n};\n\n// AI 会分析出：\n// 1. JS bundle 过大（4.3MB），需要代码分割\n// 2. 图片未优化（3MB 的 hero 图片）\n// 3. 存在长任务阻塞主线程\n// 并给出具体优化建议\n",[2981],[3092],{"type":27,"tag":243,"props":3093,"children":3094},{"__ignoreMap":7},[3095],{"type":33,"value":3089},{"type":27,"tag":495,"props":3097,"children":3099},{"id":3098},"_42-内存泄漏排查",[3100],{"type":33,"value":3101},"4.2 内存泄漏排查",{"type":27,"tag":235,"props":3103,"children":3106},{"code":3104,"language":2979,"meta":7,"className":3105},"// 场景：应用运行一段时间后变卡\n\n// 提问方式：\n/**\n * React 应用运行一段时间后内存持续增长，以下是 Heap Snapshot 对比：\n * \n * 初始状态：50MB\n * 运行 1 小时后：150MB\n * 运行 2 小时后：280MB\n * \n * Retained objects 增长最快的：\n * - (closure) - 增长 50MB\n * - HTMLDivElement - 增长 30MB\n * - Array - 增长 20MB\n * \n * 可疑代码：\n */\nfunction DataDashboard() {\n const [data, setData] = useState([]);\n const chartRef = useRef(null);\n \n useEffect(() => {\n // 每秒刷新数据\n const interval = setInterval(async () => {\n const newData = await fetchLatestData();\n setData(prev => [...prev, ...newData]); // 数据不断累积\n }, 1000);\n \n // 初始化图表\n const chart = new Chart(chartRef.current, {\n // 配置...\n });\n \n // 没有 cleanup！\n }, []);\n \n return \u003Ccanvas ref={chartRef} />;\n}\n\n// AI 会指出：\n// 1. interval 没有清理\n// 2. Chart 实例没有销毁\n// 3. data 无限增长\n// 并提供修复代码\n",[2981],[3107],{"type":27,"tag":243,"props":3108,"children":3109},{"__ignoreMap":7},[3110],{"type":33,"value":3104},{"type":27,"tag":495,"props":3112,"children":3114},{"id":3113},"_43-数据库查询优化",[3115],{"type":33,"value":3116},"4.3 数据库查询优化",{"type":27,"tag":235,"props":3118,"children":3123},{"code":3119,"language":3120,"meta":7,"className":3121},"-- 场景：查询很慢，让 AI 分析执行计划\n\n-- 提问方式：\n-- 以下查询在数据量大时很慢（orders 表 1000 万行），\n-- 执行计划如下，请分析并优化：\n\nEXPLAIN ANALYZE\nSELECT o.*, u.name, u.email\nFROM orders o\nJOIN users u ON o.user_id = u.id\nWHERE o.status = 'pending'\n AND o.created_at > '2024-01-01'\nORDER BY o.created_at DESC\nLIMIT 20;\n\n-- 执行计划：\n/*\nSort (cost=156847.23..157847.23 rows=400000 width=250)\n Sort Key: o.created_at DESC\n -> Hash Join (cost=1500.00..89847.23 rows=400000 width=250)\n Hash Cond: (o.user_id = u.id)\n -> Seq Scan on orders o (cost=0.00..85000.00 rows=400000)\n Filter: ((status = 'pending') AND (created_at > '2024-01-01'))\n -> Hash (cost=1000.00..1000.00 rows=50000 width=100)\n -> Seq Scan on users u (cost=0.00..1000.00 rows=50000)\nPlanning Time: 0.5 ms\nExecution Time: 3500 ms\n*/\n\n-- AI 会分析出问题并建议：\n-- 1. orders 表全表扫描 - 需要复合索引\n-- 2. 建议创建索引：\nCREATE INDEX idx_orders_status_created ON orders(status, created_at DESC);\n\n-- 3. 如果 status 选择性不高，考虑部分索引：\nCREATE INDEX idx_orders_pending ON orders(created_at DESC) \nWHERE status = 'pending';\n","sql",[3122],"language-sql",[3124],{"type":27,"tag":243,"props":3125,"children":3126},{"__ignoreMap":7},[3127],{"type":33,"value":3119},{"type":27,"tag":28,"props":3129,"children":3131},{"id":3130},"第五部分复杂-bug-排查",[3132],{"type":33,"value":3133},"第五部分：复杂 Bug 排查",{"type":27,"tag":495,"props":3135,"children":3137},{"id":3136},"_51-竞态条件",[3138],{"type":33,"value":3139},"5.1 竞态条件",{"type":27,"tag":235,"props":3141,"children":3144},{"code":3142,"language":2979,"meta":7,"className":3143},"// 场景：偶发的数据不一致问题\n\n// 提问方式：\n/**\n * 用户反馈偶尔看到错误的账户余额，但刷新后正常。\n * 怀疑是竞态条件，以下是相关代码：\n */\nasync function updateBalance(userId: string, amount: number) {\n // 读取当前余额\n const user = await db.users.findOne({ id: userId });\n const newBalance = user.balance + amount;\n \n // 更新余额\n await db.users.update({ id: userId }, { balance: newBalance });\n \n // 记录交易\n await db.transactions.create({\n userId,\n amount,\n balanceAfter: newBalance,\n createdAt: new Date()\n });\n \n return newBalance;\n}\n\n// 并发调用场景：\n// 用户同时发起两笔交易：+100 和 -50\n// 期望结果：原余额 1000 → 1050\n// 实际可能：原余额 1000 → 1100 或 950\n\n// AI 会分析竞态条件并提供解决方案：\nasync function updateBalanceAtomic(userId: string, amount: number) {\n // 方案 1：使用数据库原子操作\n const result = await db.users.findOneAndUpdate(\n { id: userId },\n { $inc: { balance: amount } },\n { returnDocument: 'after' }\n );\n \n await db.transactions.create({\n userId,\n amount,\n balanceAfter: result.balance,\n createdAt: new Date()\n });\n \n return result.balance;\n}\n\n// 方案 2：使用乐观锁\nasync function updateBalanceOptimistic(userId: string, amount: number) {\n const maxRetries = 3;\n \n for (let i = 0; i \u003C maxRetries; i++) {\n const user = await db.users.findOne({ id: userId });\n const newBalance = user.balance + amount;\n \n const updated = await db.users.updateOne(\n { id: userId, version: user.version },\n { balance: newBalance, version: user.version + 1 }\n );\n \n if (updated.modifiedCount === 1) {\n await db.transactions.create({...});\n return newBalance;\n }\n \n // 版本冲突，重试\n await sleep(10 * (i + 1));\n }\n \n throw new Error('Update failed after retries');\n}\n",[2981],[3145],{"type":27,"tag":243,"props":3146,"children":3147},{"__ignoreMap":7},[3148],{"type":33,"value":3142},{"type":27,"tag":495,"props":3150,"children":3152},{"id":3151},"_52-分布式系统问题",[3153],{"type":33,"value":3154},"5.2 分布式系统问题",{"type":27,"tag":235,"props":3156,"children":3159},{"code":3157,"language":2979,"meta":7,"className":3158},"// 场景：微服务间的数据不一致\n\n// 提问方式：\n/**\n * 订单服务和库存服务偶尔出现数据不一致：\n * - 订单显示已创建\n * - 库存未扣减\n * \n * 当前流程：\n */\n// Order Service\nasync function createOrder(orderData) {\n // 1. 调用库存服务扣减库存\n await inventoryService.deduct(orderData.items);\n \n // 2. 创建订单\n const order = await orderRepository.create(orderData);\n \n // 3. 发送订单创建事件\n await eventBus.publish('order.created', order);\n \n return order;\n}\n\n// 问题分析：如果步骤 2 或 3 失败，库存已经扣减但订单未创建\n\n// AI 会建议使用 Saga 模式或事务发件箱模式\n",[2981],[3160],{"type":27,"tag":243,"props":3161,"children":3162},{"__ignoreMap":7},[3163],{"type":33,"value":3157},{"type":27,"tag":28,"props":3165,"children":3167},{"id":3166},"第六部分ai-调试工作流",[3168],{"type":33,"value":3169},"第六部分：AI 调试工作流",{"type":27,"tag":495,"props":3171,"children":3173},{"id":3172},"_61-我的调试流程",[3174],{"type":33,"value":3175},"6.1 我的调试流程",{"type":27,"tag":235,"props":3177,"children":3179},{"code":3178},"┌────────────────────────────────────────────────────────────┐\n│ AI 辅助调试工作流 │\n├────────────────────────────────────────────────────────────┤\n│ │\n│ Step 1: 问题收集 │\n│ ├── 复制完整错误信息 │\n│ ├── 截图相关日志 │\n│ └── 记录复现步骤 │\n│ │\n│ Step 2: 快速分析 │\n│ ├── 将错误信息发给 AI │\n│ ├── 获取可能原因列表 │\n│ └── 评估哪些最可能 │\n│ │\n│ Step 3: 深入调查 │\n│ ├── 根据 AI 建议添加日志/断点 │\n│ ├── 收集更多信息 │\n│ └── 再次询问 AI（带新信息） │\n│ │\n│ Step 4: 验证修复 │\n│ ├── AI 生成修复代码 │\n│ ├── 人工审查确认 │\n│ └── 测试验证 │\n│ │\n│ Step 5: 预防措施 │\n│ ├── AI 建议类似问题的预防方法 │\n│ ├── 添加相关测试用例 │\n│ └── 更新文档/知识库 │\n│ │\n└────────────────────────────────────────────────────────────┘\n",[3180],{"type":27,"tag":243,"props":3181,"children":3182},{"__ignoreMap":7},[3183],{"type":33,"value":3178},{"type":27,"tag":495,"props":3185,"children":3187},{"id":3186},"_62-调试对话模板",[3188],{"type":33,"value":3189},"6.2 调试对话模板",{"type":27,"tag":235,"props":3191,"children":3194},{"code":3192,"language":591,"meta":7,"className":3193},"## 第一轮：问题描述\n\n我遇到了一个问题：[简述问题]\n\n错误信息：\n",[2832],[3195],{"type":27,"tag":243,"props":3196,"children":3197},{"__ignoreMap":7},[3198],{"type":33,"value":3192},{"type":27,"tag":36,"props":3200,"children":3201},{},[3202],{"type":27,"tag":2842,"props":3203,"children":3204},{},[3205],{"type":33,"value":3206},"粘贴完整错误",{"type":27,"tag":235,"props":3208,"children":3210},{"code":3209},"\n相关代码：\n```javascript\n[粘贴代码]\n",[3211],{"type":27,"tag":243,"props":3212,"children":3213},{"__ignoreMap":7},[3214],{"type":33,"value":3209},{"type":27,"tag":714,"props":3216,"children":3217},{},[],{"type":27,"tag":28,"props":3219,"children":3221},{"id":3220},"第二轮补充信息",[3222],{"type":33,"value":3223},"第二轮：补充信息",{"type":27,"tag":36,"props":3225,"children":3226},{},[3227],{"type":33,"value":3228},"根据你的建议，我添加了日志，发现：",{"type":27,"tag":42,"props":3230,"children":3231},{},[3232,3240],{"type":27,"tag":46,"props":3233,"children":3234},{},[3235],{"type":27,"tag":2842,"props":3236,"children":3237},{},[3238],{"type":33,"value":3239},"发现 1",{"type":27,"tag":46,"props":3241,"children":3242},{},[3243],{"type":27,"tag":2842,"props":3244,"children":3245},{},[3246],{"type":33,"value":3247},"发现 2",{"type":27,"tag":36,"props":3249,"children":3250},{},[3251,3253,3258],{"type":33,"value":3252},"这是否说明问题出在 ",{"type":27,"tag":2842,"props":3254,"children":3255},{},[3256],{"type":33,"value":3257},"你的猜测",{"type":33,"value":3259},"？",{"type":27,"tag":714,"props":3261,"children":3262},{},[],{"type":27,"tag":28,"props":3264,"children":3266},{"id":3265},"第三轮确认修复",[3267],{"type":33,"value":3268},"第三轮：确认修复",{"type":27,"tag":36,"props":3270,"children":3271},{},[3272],{"type":33,"value":3273},"我按照你的建议修改了代码：",{"type":27,"tag":235,"props":3275,"children":3278},{"code":3276,"language":3004,"meta":7,"className":3277},"[粘贴修改后的代码]\n",[3006],[3279],{"type":27,"tag":243,"props":3280,"children":3281},{"__ignoreMap":7},[3282],{"type":33,"value":3276},{"type":27,"tag":36,"props":3284,"children":3285},{},[3286],{"type":33,"value":3287},"请确认这个修复是否正确，以及是否有其他潜在问题。",{"type":27,"tag":714,"props":3289,"children":3290},{},[],{"type":27,"tag":28,"props":3292,"children":3294},{"id":3293},"第四轮预防",[3295],{"type":33,"value":3296},"第四轮：预防",{"type":27,"tag":36,"props":3298,"children":3299},{},[3300],{"type":33,"value":3301},"这个问题已解决。请建议：",{"type":27,"tag":264,"props":3303,"children":3304},{},[3305,3310,3315],{"type":27,"tag":46,"props":3306,"children":3307},{},[3308],{"type":33,"value":3309},"如何防止类似问题再次发生？",{"type":27,"tag":46,"props":3311,"children":3312},{},[3313],{"type":33,"value":3314},"应该添加什么测试用例？",{"type":27,"tag":46,"props":3316,"children":3317},{},[3318],{"type":33,"value":3319},"有什么最佳实践可以参考？",{"type":27,"tag":235,"props":3321,"children":3323},{"code":3322},"\n## 结语：AI 是放大器，不是替代品\n\nAI 调试工具能够显著加速问题排查过程，但它不能替代你的思考。最有价值的能力组合是：\n\n- **你的领域知识** + **AI 的广博见识**\n- **你对项目的理解** + **AI 的分析能力**\n- **你的判断力** + **AI 的执行速度**\n\n调试的本质是假设-验证的循环。AI 帮你更快地生成假设、更高效地验证假设，但做出最终判断的还是你。\n\n学会与 AI 高效协作调试，不是依赖 AI 给你答案，而是让 AI 帮你更快地找到自己的答案。\n\n---\n\n## 参考资源\n\n- [Chrome DevTools 官方文档](https://developer.chrome.com/docs/devtools)\n- [Node.js 调试指南](https://nodejs.org/en/docs/guides/debugging-getting-started)\n- [React DevTools 使用指南](https://react.dev/learn/react-developer-tools)\n",[3324],{"type":27,"tag":243,"props":3325,"children":3326},{"__ignoreMap":7},[3327],{"type":33,"value":3322},{"title":7,"searchDepth":574,"depth":574,"links":3329},[3330,3331,3332,3337,3341,3346,3350,3354,3355,3356],{"id":2713,"depth":577,"text":2716},{"id":2719,"depth":577,"text":2722},{"id":2740,"depth":577,"text":2743,"children":3333},[3334,3335,3336],{"id":2746,"depth":574,"text":2749},{"id":2824,"depth":574,"text":2827},{"id":2989,"depth":574,"text":2992},{"id":3031,"depth":577,"text":3034,"children":3338},[3339,3340],{"id":3037,"depth":574,"text":3040},{"id":3057,"depth":574,"text":3060},{"id":3077,"depth":577,"text":3080,"children":3342},[3343,3344,3345],{"id":3083,"depth":574,"text":3086},{"id":3098,"depth":574,"text":3101},{"id":3113,"depth":574,"text":3116},{"id":3130,"depth":577,"text":3133,"children":3347},[3348,3349],{"id":3136,"depth":574,"text":3139},{"id":3151,"depth":574,"text":3154},{"id":3166,"depth":577,"text":3169,"children":3351},[3352,3353],{"id":3172,"depth":574,"text":3175},{"id":3186,"depth":574,"text":3189},{"id":3220,"depth":577,"text":3223},{"id":3265,"depth":577,"text":3268},{"id":3293,"depth":577,"text":3296},"content:topics:ai:ai-debugging-troubleshooting-guide.md","topics/ai/ai-debugging-troubleshooting-guide.md","topics/ai/ai-debugging-troubleshooting-guide",{"_path":4,"_dir":5,"_draft":6,"_partial":6,"_locale":7,"title":8,"description":9,"date":10,"topic":5,"author":11,"tags":3361,"image":18,"imageQuery":19,"pexelsPhotoId":20,"pexelsUrl":21,"featured":6,"readingTime":22,"body":3362,"_type":591,"_id":592,"_source":593,"_file":594,"_stem":595,"_extension":596},[13,14,15,16,17],{"type":24,"children":3363,"toc":3789},[3364,3368,3372,3391,3395,3399,3403,3407,3476,3480,3484,3488,3507,3511,3515,3519,3523,3531,3535,3539,3543,3562,3566,3570,3585,3589,3593,3604,3608,3623,3627,3631,3635,3650,3654,3658,3726,3730,3734,3738,3742,3746,3750,3754,3758],{"type":27,"tag":28,"props":3365,"children":3366},{"id":30},[3367],{"type":33,"value":34},{"type":27,"tag":36,"props":3369,"children":3370},{},[3371],{"type":33,"value":40},{"type":27,"tag":42,"props":3373,"children":3374},{},[3375,3379,3383,3387],{"type":27,"tag":46,"props":3376,"children":3377},{},[3378],{"type":33,"value":50},{"type":27,"tag":46,"props":3380,"children":3381},{},[3382],{"type":33,"value":55},{"type":27,"tag":46,"props":3384,"children":3385},{},[3386],{"type":33,"value":60},{"type":27,"tag":46,"props":3388,"children":3389},{},[3390],{"type":33,"value":65},{"type":27,"tag":36,"props":3392,"children":3393},{},[3394],{"type":33,"value":70},{"type":27,"tag":28,"props":3396,"children":3397},{"id":73},[3398],{"type":33,"value":76},{"type":27,"tag":36,"props":3400,"children":3401},{},[3402],{"type":33,"value":81},{"type":27,"tag":36,"props":3404,"children":3405},{},[3406],{"type":33,"value":86},{"type":27,"tag":88,"props":3408,"children":3409},{},[3410,3428],{"type":27,"tag":92,"props":3411,"children":3412},{},[3413],{"type":27,"tag":96,"props":3414,"children":3415},{},[3416,3420,3424],{"type":27,"tag":100,"props":3417,"children":3418},{},[3419],{"type":33,"value":104},{"type":27,"tag":100,"props":3421,"children":3422},{},[3423],{"type":33,"value":109},{"type":27,"tag":100,"props":3425,"children":3426},{},[3427],{"type":33,"value":114},{"type":27,"tag":116,"props":3429,"children":3430},{},[3431,3446,3461],{"type":27,"tag":96,"props":3432,"children":3433},{},[3434,3438,3442],{"type":27,"tag":123,"props":3435,"children":3436},{},[3437],{"type":33,"value":127},{"type":27,"tag":123,"props":3439,"children":3440},{},[3441],{"type":33,"value":132},{"type":27,"tag":123,"props":3443,"children":3444},{},[3445],{"type":33,"value":137},{"type":27,"tag":96,"props":3447,"children":3448},{},[3449,3453,3457],{"type":27,"tag":123,"props":3450,"children":3451},{},[3452],{"type":33,"value":145},{"type":27,"tag":123,"props":3454,"children":3455},{},[3456],{"type":33,"value":150},{"type":27,"tag":123,"props":3458,"children":3459},{},[3460],{"type":33,"value":155},{"type":27,"tag":96,"props":3462,"children":3463},{},[3464,3468,3472],{"type":27,"tag":123,"props":3465,"children":3466},{},[3467],{"type":33,"value":163},{"type":27,"tag":123,"props":3469,"children":3470},{},[3471],{"type":33,"value":168},{"type":27,"tag":123,"props":3473,"children":3474},{},[3475],{"type":33,"value":173},{"type":27,"tag":28,"props":3477,"children":3478},{"id":176},[3479],{"type":33,"value":179},{"type":27,"tag":36,"props":3481,"children":3482},{},[3483],{"type":33,"value":184},{"type":27,"tag":36,"props":3485,"children":3486},{},[3487],{"type":33,"value":189},{"type":27,"tag":42,"props":3489,"children":3490},{},[3491,3495,3499,3503],{"type":27,"tag":46,"props":3492,"children":3493},{},[3494],{"type":33,"value":197},{"type":27,"tag":46,"props":3496,"children":3497},{},[3498],{"type":33,"value":202},{"type":27,"tag":46,"props":3500,"children":3501},{},[3502],{"type":33,"value":207},{"type":27,"tag":46,"props":3504,"children":3505},{},[3506],{"type":33,"value":212},{"type":27,"tag":36,"props":3508,"children":3509},{},[3510],{"type":33,"value":217},{"type":27,"tag":28,"props":3512,"children":3513},{"id":220},[3514],{"type":33,"value":223},{"type":27,"tag":36,"props":3516,"children":3517},{},[3518],{"type":33,"value":228},{"type":27,"tag":36,"props":3520,"children":3521},{},[3522],{"type":33,"value":233},{"type":27,"tag":235,"props":3524,"children":3526},{"className":3525,"code":239,"language":240,"meta":7},[238],[3527],{"type":27,"tag":243,"props":3528,"children":3529},{"__ignoreMap":7},[3530],{"type":33,"value":239},{"type":27,"tag":36,"props":3532,"children":3533},{},[3534],{"type":33,"value":251},{"type":27,"tag":28,"props":3536,"children":3537},{"id":254},[3538],{"type":33,"value":257},{"type":27,"tag":36,"props":3540,"children":3541},{},[3542],{"type":33,"value":262},{"type":27,"tag":264,"props":3544,"children":3545},{},[3546,3550,3554,3558],{"type":27,"tag":46,"props":3547,"children":3548},{},[3549],{"type":33,"value":271},{"type":27,"tag":46,"props":3551,"children":3552},{},[3553],{"type":33,"value":276},{"type":27,"tag":46,"props":3555,"children":3556},{},[3557],{"type":33,"value":281},{"type":27,"tag":46,"props":3559,"children":3560},{},[3561],{"type":33,"value":286},{"type":27,"tag":36,"props":3563,"children":3564},{},[3565],{"type":33,"value":291},{"type":27,"tag":36,"props":3567,"children":3568},{},[3569],{"type":33,"value":296},{"type":27,"tag":264,"props":3571,"children":3572},{},[3573,3577,3581],{"type":27,"tag":46,"props":3574,"children":3575},{},[3576],{"type":33,"value":304},{"type":27,"tag":46,"props":3578,"children":3579},{},[3580],{"type":33,"value":309},{"type":27,"tag":46,"props":3582,"children":3583},{},[3584],{"type":33,"value":314},{"type":27,"tag":28,"props":3586,"children":3587},{"id":317},[3588],{"type":33,"value":320},{"type":27,"tag":36,"props":3590,"children":3591},{},[3592],{"type":33,"value":325},{"type":27,"tag":42,"props":3594,"children":3595},{},[3596,3600],{"type":27,"tag":46,"props":3597,"children":3598},{},[3599],{"type":33,"value":333},{"type":27,"tag":46,"props":3601,"children":3602},{},[3603],{"type":33,"value":338},{"type":27,"tag":36,"props":3605,"children":3606},{},[3607],{"type":33,"value":343},{"type":27,"tag":42,"props":3609,"children":3610},{},[3611,3615,3619],{"type":27,"tag":46,"props":3612,"children":3613},{},[3614],{"type":33,"value":351},{"type":27,"tag":46,"props":3616,"children":3617},{},[3618],{"type":33,"value":356},{"type":27,"tag":46,"props":3620,"children":3621},{},[3622],{"type":33,"value":361},{"type":27,"tag":36,"props":3624,"children":3625},{},[3626],{"type":33,"value":366},{"type":27,"tag":28,"props":3628,"children":3629},{"id":369},[3630],{"type":33,"value":372},{"type":27,"tag":36,"props":3632,"children":3633},{},[3634],{"type":33,"value":377},{"type":27,"tag":42,"props":3636,"children":3637},{},[3638,3642,3646],{"type":27,"tag":46,"props":3639,"children":3640},{},[3641],{"type":33,"value":385},{"type":27,"tag":46,"props":3643,"children":3644},{},[3645],{"type":33,"value":390},{"type":27,"tag":46,"props":3647,"children":3648},{},[3649],{"type":33,"value":395},{"type":27,"tag":36,"props":3651,"children":3652},{},[3653],{"type":33,"value":400},{"type":27,"tag":28,"props":3655,"children":3656},{"id":403},[3657],{"type":33,"value":406},{"type":27,"tag":42,"props":3659,"children":3661},{"className":3660},[410],[3662,3670,3678,3686,3694,3702,3710,3718],{"type":27,"tag":46,"props":3663,"children":3665},{"className":3664},[415],[3666,3669],{"type":27,"tag":418,"props":3667,"children":3668},{"disabled":420,"type":421},[],{"type":33,"value":424},{"type":27,"tag":46,"props":3671,"children":3673},{"className":3672},[415],[3674,3677],{"type":27,"tag":418,"props":3675,"children":3676},{"disabled":420,"type":421},[],{"type":33,"value":433},{"type":27,"tag":46,"props":3679,"children":3681},{"className":3680},[415],[3682,3685],{"type":27,"tag":418,"props":3683,"children":3684},{"disabled":420,"type":421},[],{"type":33,"value":442},{"type":27,"tag":46,"props":3687,"children":3689},{"className":3688},[415],[3690,3693],{"type":27,"tag":418,"props":3691,"children":3692},{"disabled":420,"type":421},[],{"type":33,"value":451},{"type":27,"tag":46,"props":3695,"children":3697},{"className":3696},[415],[3698,3701],{"type":27,"tag":418,"props":3699,"children":3700},{"disabled":420,"type":421},[],{"type":33,"value":460},{"type":27,"tag":46,"props":3703,"children":3705},{"className":3704},[415],[3706,3709],{"type":27,"tag":418,"props":3707,"children":3708},{"disabled":420,"type":421},[],{"type":33,"value":469},{"type":27,"tag":46,"props":3711,"children":3713},{"className":3712},[415],[3714,3717],{"type":27,"tag":418,"props":3715,"children":3716},{"disabled":420,"type":421},[],{"type":33,"value":478},{"type":27,"tag":46,"props":3719,"children":3721},{"className":3720},[415],[3722,3725],{"type":27,"tag":418,"props":3723,"children":3724},{"disabled":420,"type":421},[],{"type":33,"value":487},{"type":27,"tag":28,"props":3727,"children":3728},{"id":490},[3729],{"type":33,"value":493},{"type":27,"tag":495,"props":3731,"children":3732},{"id":497},[3733],{"type":33,"value":500},{"type":27,"tag":36,"props":3735,"children":3736},{},[3737],{"type":33,"value":505},{"type":27,"tag":495,"props":3739,"children":3740},{"id":508},[3741],{"type":33,"value":511},{"type":27,"tag":36,"props":3743,"children":3744},{},[3745],{"type":33,"value":516},{"type":27,"tag":495,"props":3747,"children":3748},{"id":519},[3749],{"type":33,"value":522},{"type":27,"tag":36,"props":3751,"children":3752},{},[3753],{"type":33,"value":527},{"type":27,"tag":28,"props":3755,"children":3756},{"id":530},[3757],{"type":33,"value":530},{"type":27,"tag":42,"props":3759,"children":3760},{},[3761,3768,3775,3782],{"type":27,"tag":46,"props":3762,"children":3763},{},[3764],{"type":27,"tag":540,"props":3765,"children":3766},{"href":542},[3767],{"type":33,"value":545},{"type":27,"tag":46,"props":3769,"children":3770},{},[3771],{"type":27,"tag":540,"props":3772,"children":3773},{"href":551},[3774],{"type":33,"value":554},{"type":27,"tag":46,"props":3776,"children":3777},{},[3778],{"type":27,"tag":540,"props":3779,"children":3780},{"href":560},[3781],{"type":33,"value":563},{"type":27,"tag":46,"props":3783,"children":3784},{},[3785],{"type":27,"tag":540,"props":3786,"children":3787},{"href":569},[3788],{"type":33,"value":572},{"title":7,"searchDepth":574,"depth":574,"links":3790},[3791,3792,3793,3794,3795,3796,3797,3798,3799,3804],{"id":30,"depth":577,"text":34},{"id":73,"depth":577,"text":76},{"id":176,"depth":577,"text":179},{"id":220,"depth":577,"text":223},{"id":254,"depth":577,"text":257},{"id":317,"depth":577,"text":320},{"id":369,"depth":577,"text":372},{"id":403,"depth":577,"text":406},{"id":490,"depth":577,"text":493,"children":3800},[3801,3802,3803],{"id":497,"depth":574,"text":500},{"id":508,"depth":574,"text":511},{"id":519,"depth":574,"text":522},{"id":530,"depth":577,"text":530},1775441233486]