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