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