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