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