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