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