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