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