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