Agent 预算在任务中途被吃光
Agent 执行长任务时 token 或费用预算耗尽，任务强制中止且无中间结果可用。本文分析预算失控的根因并给出限额与断点续传方案。
#AI 编程
带有该标签的文章
Checkpoint 恢复出来的状态是损坏的
Agent 从 checkpoint 恢复时，加载出来的状态字段缺失、类型错误或值异常，导致 workflow 以错误状态继续执行，产生难以追踪的下游错误。本文分析 checkpoint 损坏的根因并给出写入和恢复的防御方案。
成本统计漏算了子 Agent 用量
多 Agent 系统的成本仪表盘只显示主 Agent 的 token 消耗，子 Agent 和工具调用产生的费用没有被归因，导致月度账单远超预算但无法定位超支来源。本文分析成本归因断层的根因并给出全链路追踪方案。
Agent 调用图出现循环但没人发现
多 Agent 系统中，Agent 之间的调用关系形成了有向环，导致任务无限循环、token 持续消耗，直到预算耗尽才暴露问题。本文分析循环产生的原因并给出静态检测和运行时防护方案。
Agent 交接时上下文丢失了
多 Agent 流水线中，子 Agent 接手任务后丢失关键背景，导致重复询问或输出偏离预期。本文逐步拆解丢失原因并给出可落地的修复方案。
Agent 编排器互相等待出现死锁
多 Agent 系统中两个或多个 Agent 互相等待对方的输出，整个流水线挂起不前进。本文分析死锁成因并提供超时、优先级和拓扑检测方案。
Agent 输出里夹带了 secret
Agent 在生成代码、文档或日志时，把 API key、密码、token 或其他敏感凭证输出到了对话记录、trace 日志或下游系统里，造成安全风险。本文分析 secret 泄漏的触发路径并给出检测和阻断方案。
Agent 输出下游解析不了
Agent 生成的输出格式不稳定，下游系统在解析 JSON、代码块或结构化字段时频繁失败。本文分析格式漂移根因并给出强制结构化输出方案。
Pre-flight 检查被 Agent 跳过
Agent 在任务启动前应该执行的环境检查、权限验证或依赖确认被跳过，导致任务在执行中途因为可预见的前提条件未满足而失败，浪费了已经消耗的 token 和时间。本文分析跳过根因并给出强制 pre-flight 方案。
Promotion 判据太宽，劣质输出被放行
Agent 流水线的晋级（Promotion）判断逻辑标准过于宽松，让不完整、格式错误或语义错误的输出通过了质量关卡，流入下游系统或生产环境。本文分析判据失效的根因并给出量化指标和分层校验方案。
不同版本的 Prompt 模板互相打架
多 Agent 系统或多环境部署中，不同版本的 prompt 模板并存，同一个任务在生产环境和暂存环境使用了不同的指令，导致输出格式或行为不一致，难以复现和调试。本文分析模板漂移根因并给出版本化管理方案。
一个 Agent 触发 rate limit 拖垮整链
多 Agent 系统中某一个 Agent 的爆发性请求触发 API rate limit，导致共用同一 API key 的其他 Agent 全部被限速，整条流水线雪崩。本文分析级联失败的传导路径并给出隔离和限速方案。
不稳定 tool 触发 Agent 重试风暴
一个偶发失败的工具调用触发 Agent 框架的自动重试机制，指数退避叠加并行 Agent，导致 API 用量和成本在分钟内暴涨。本文分析重试风暴的放大机制并给出熔断和限速方案。
共享 memory 被多 Agent 写覆盖
多个 Agent 并发读写同一块共享 memory（如 Redis key、共享字典、消息历史），后写入的 Agent 覆盖了之前 Agent 的重要更新，导致状态不一致或数据丢失。本文分析写竞争根因并给出乐观锁和分区隔离方案。
Agent 跳过了必须的验证步骤
Agent 在生成输出后绕过了格式校验、安全检查或业务规则验证，导致错误输出进入下游系统。本文分析跳过验证的触发条件并给出强制验证方案。
重启后 Agent 状态对不上
Agent 重启或恢复后，内存中的状态与持久化存储的状态出现偏差，导致重复执行、跳过步骤或使用过期数据。本文拆解状态漂移根因并给出持久化与校验方案。
Agent 启动的子进程退出后成了孤儿
Agent 在执行工具调用或代码运行时启动了子进程，任务结束或 Agent 崩溃后子进程没有被终止，在系统后台持续消耗资源或持有文件锁。本文分析孤儿进程的产生原因并给出清理和预防方案。
任务被路由到了错误的 Agent
编排器把任务分发给能力不匹配的 Agent，导致输出质量差、工具调用失败或任务被无限转发。本文分析路由失效根因并给出能力声明和路由测试方案。
Trace 里看不到关键 tool call
在 LangSmith、Langfuse 或框架自带的 Trace 视图里，某次关键的工具调用没有出现在记录里，导致无法排查 Agent 行为或审计操作。本文分析 trace 缺失的根因并给出完整追踪方案。
两个并行 Agent 同时改一份文件
多 Agent 并行执行时对同一文件并发写入，导致改动互相覆盖或产生 git 冲突。本文分析冲突根因并给出文件锁、任务分区和冲突恢复方案。
AI 生成更新日志——从 commits 到人愿意读的 release note
把 git log 变成读者真会读的 release note，而不是一堆 commit message 的堆叠。
AI 协作数据库迁移——可回滚、有回填、能测
AI 在迁移上最常错的三件事：可回滚、回填策略、大表上的 NOT NULL。
AI 写事故复盘——出稿不冲淡教训
用 AI 快速出复盘初稿，但不把那些让复盘有用的难听话洗掉。
AI 解 merge 冲突——什么时候能信自动合
AI 能安全解多数 merge 冲突，关键在于知道哪些不能信。
AI on-call 排障——从被叫醒到修好不慌
凌晨 3 点被叫醒怎么用 AI——分流、列假设、冷静协议、修完沉淀成 runbook。
AI 写 PR 描述——从 diff 到能审
把 git diff 变成 reviewer 真愿意打开看的 PR 描述，prompt 不会编出根本不存在的 test plan。
Aider 上手——终端里的 AI 编程，不靠浏览器
pip 装一下，对着 repo 跑起来，diff-看-收 的循环就在 shell 里——不开 IDE、不开浏览器、不绑工具。
Claude Code MCP——给 Claude Code 接上真工具
MCP 是什么、怎么用 claude mcp add 加 server、三种 transport、以及第一天值得装的几个 server。
Cursor Rules——让 .cursorrules 真正派上用场
Rules 的结构、什么时候用 .cursor/rules/*.mdc、什么时候用老的 .cursorrules，以及怎么写模型真会照办的规则。
Windsurf 上手——30 分钟跑通 AI 编程闭环
Codeium AI 优先 IDE 走一遍：装、登、配，让 Cascade agent 第一次任务别打架就跑出小 diff。
Cursor Cmd-K 内联编辑一直转不出 diff
按了 Cmd-K 写完指令，弹窗 spinner 一直转，不出 diff、不报错、提交不了。多半是网络、模型、或上下文。四类根因走一遍。
AI 加了一条绕过鉴权中间件的路由 —— 排查与修复
AI 在鉴权路由组之外注册了新接口,把内部数据无防护暴露出去。识别缺口并把 auth 设为默认。
AI 编造了根本不存在的 API 签名 —— 排查与修复
AI 信心满满地调用了一个并不存在的方法 —— 参数顺序错、选项名瞎编、返回类型臆造。通过对照真实源码定位与修复。
AI 生成的迁移本地能跑、上生产就炸 —— 排查与修复
AI 写的迁移在空 dev 库里干净通过,到生产却卡死或触发约束错误。关键是 dev-prod 一致性与迁移安全审查。
AI 写的 SQL 把热点表锁了好几分钟 —— 排查与修复
AI 写的查询或更新在生产表上持有长锁,阻塞读写。识别模式并改写为锁友好的版本。
AI 无视 lint 报错继续用废弃语法 —— 排查与修复
AI 生成的代码用了废弃 API,看到 lint 报错改了一处,下一个文件又把废弃写法塞回来。需要把规则锚定到项目层。
AI 在 pnpm / Yarn 项目里跑 npm 命令 —— 排查与修复
AI 在 pnpm 仓库里跑 npm install,生成了 package-lock.json,破坏锁文件契约、把 CI 弄崩。需要锁死包管理器。
Cursor Auto 模型为难任务挑了弱模型 —— 完整修复指南
Cursor 的 Auto 路由把复杂重构发给小模型，结果改动浅、还自信宣称完成。从路由信号到提示卫生，逐项调优。
Cursor 没识别到 Python venv（解释器选错）—— 完整修复指南
Cursor 选用系统 Python 而非项目 venv，导致 import 红线、lint 报错、agent 给出错误改动。逐层排查解释器选择、venv 发现与 shell PATH。
Cursor Settings Sync 覆盖另一台机器的本地配置 —— 完整修复指南
Cursor Settings Sync 把过时配置推到第二台机器，覆盖本地规则、快捷键或 MCP 配置。从冲突方向、后写覆盖、选择性同步三方面定位。
Cursor SSH 远程连接编辑中途掉线 —— 排查与修复
Cursor 的 SSH Remote 会话在编辑过程中突然断开，丢失 agent 上下文与未保存缓冲区。从保活、网络与远端扩展宿主三个层面定位。
Codex 把改动 commit 到了错误分支（甚至直接 main）
Codex 在沙箱当前 checkout 的分支上 commit——有时是 main，有时是上一个任务遗留的 branch。怎么强制每个任务跑在干净的独立分支上。
Codex 的修复测试全绿，运行时一上线就崩
Codex 的 PR 在 CI 里全绿——每个测试都过——但 staging 一部署就崩。为啥 agent 修复打中的是测试面而不是 runtime，以及怎么把这个 gap 补上。
Codex 全部快捷键详解：终端、桌面版、输入编辑、任务控制
Codex 键盘快捷键完整参考：终端 TUI、桌面版、输入编辑、会话控制、模式切换、后台任务与常见失效原因。每个快捷键都带中文和英文说明。
Codex 全部 Skills 与 /skills 详解：内置技能、自定义技能、插件技能
Codex skills 完整指南：什么是 skill、如何用 /skills 查看和调用、SKILL.md 怎么写、内置技能与插件技能怎么区分，并附中英双语说明。
AI 建议了过时依赖：3 个原因 + 修复路径
让加个库它给了一个 4 年前停更的——训练截止 + 不查 registry。
AI 写的测试通过但功能挂了：3 个原因 + 修复路径
测试全绿，跑起来不对——测试只测了 happy path、mock 把真实分支屏蔽了。
Agent vs 自动补全——什么时候用哪个
决策矩阵把任务形状映射到工具：一行 / 几行胶水用补全（亚秒级），跨文件改 / 读测试 / 跑命令用 agent。延迟、范围、可控性三轴判断。
AI AdSense Readiness 审计教程
AI 对照四大拒审桶预审：内容稀薄、About / Contact / Privacy 弱、爬虫导航坏、政策边缘内容。输出阻塞 / 风险 / 可选分流，避免白白等 30 天冷却。
AI Agent 做代码审查的工作流
在 PR 发给同事之前，用 Claude Code / Codex / Cursor Agent 先做一遍 review。
AI 架构 Review 工作流
强制 steelman → 攻击序列，每份设计文档抓出 3-5 个真问题——用 Claude Opus 或 GPT-5.5 reasoning 当 devil's advocate，避免几周后才发现要重构。
怎么用 AI 审计一个 Astro 内容站（不用逐文件读）
可复用 AI 审计工作流——抓 Astro 内容站的坏 slug、缺翻译、死内链、draft 泄漏、配置漂移。
用 AI 审计 Astro 站点
针对 Astro 的审计 prompt——sitemap / hreflang / output / RSS。
用 AI 审计 React Native 项目
RN 真正会坏的地方：重渲染、导航栈堆屏、原生模块新架构兼容、列表虚拟化、图片、iOS / Android 差异——AI 审计给出带文件路径的热点清单，profile 那一小时才不浪费。
用 AI 在 Google 发现前找失效链接
30 分钟月度流程：lychee / linkinator 确定性扫 URL，AI 按根因（404 / 重定向链 / 拼写 / 死外链）聚类并出按 cluster 修复方案——比等 Search Console 提示快好几周。
怎么用 AI 审计 Category 页（最容易被忽视的 SEO 面）
Category 页是被低估的 SEO 面——这套 AI 工作流抓重复 intro、内链弱、缺描述、分页坏。
AI 代码库导览工作流——新仓库快速上手
用 Claude Code、Cursor、ChatGPT 给自己做一份陌生代码库的导览。
AI 编程上下文管理——喂什么、删什么
AI 编程的质量本质上是上下文问题。这是怎么喂对、不喂错的方法。
用 AI 规划 Pillar + Cluster 内容策略
用 AI 识别 pillar、cluster 话题、内容缺口。
AI 调试工作流——从 stack trace 到修复
把 trace、触发输入、期望和实际一次贴齐，让 AI 先按概率列 3 个原因 + 各自诊断检查，再回报结果要修复——避免 AI 直接乱猜 20 次。修完顺手写回归测试。
AI 依赖升级工作流：CHANGELOG 映射 + 防漂移修复
用 Claude Code 或 Cursor 升级依赖，避免微妙的隐藏破坏。
用 AI 做 Firebase 部署前检查
部署前飞行前检查——firebase.json / rewrites / function region。
用 AI 建内容站：从信息架构到上线 SEO 的 playbook
三段流程：先用 AI 规划 pillar / cluster 信息架构，再 AI 起稿 + 人工重度编辑，最后装 meta / 标签 / 内链 / sitemap 那层结构胶。stack 无关，例子偏静态站。
AI 检查你的 hreflang 配置（双语 / 多 locale）
用 AI 审计 hreflang——slug 不匹配、缺对、错代码。
用 AI 批量生成 Meta Description（小心）
10 条一批喂 AI 出 145 字符 meta，30% 抽查挡住幻觉，一个 PR 上线——之前 meta 单薄的页面被重新索引后 CTR 通常提 10-20%。
AI 迁移 Prompt 工作流——框架 / 语言迁移
大迁移（Vue 2→3、React class→hooks、JS→TS、Pages Router → App Router）的结构化 prompt 流程。
AI 在 monorepo 里的工作流——不被上下文淹没
AI 在 monorepo 里要么好用要么炸。这是让它工作起来的配置。
AI 提交前 review 工作流
每次 commit 前用 AI Agent 做 60 秒 review。把蠢错抓在外泄之前。
AI 重构工作流：四前提 + 先 plan 后改 + 回滚纪律
AI 重构能用的四前提（有测试、scope 小、把 AI 当初级工程师、先 plan 后 diff），跨模块改名 / 抽 helper / 替 deprecated API 的可控做法，以及静默崩了能干净回滚的节奏。
AI 编码回滚工作流：让每次改动都可逆的 git 纪律
AI 跑前先 commit、AI 输出审 diff 再 commit、长任务每 3-5 步 commit、可能要的改动用 stash——四步纪律让 AI 在 12 个文件里改错时也能干净回滚。
怎么用 AI 分流 Search Console 问题
每周 30 分钟 AI 工作流分流 Search Console：索引覆盖、CWV、移动可用性、人工操作。
怎么用 AI 生成贴合你技术栈的技术 SEO 清单
别用通用 80 点 SEO 清单。用 AI 在 20 分钟内为你的栈（Astro / Next / Hugo / WordPress）生成定制版。
AI 从 spec 到代码的工作流
把一份文字 spec 变成上线代码，不掉进"半成品功能"陷阱。
怎么用 AI 检测薄内容（赶在 Google 之前）
3 趟 AI 工作流——给每页打薄内容分、浮出最差的、给一份"扩 / 合 / noindex / 删"的方案。
AI 写单测的工作流——能信得过的测试
AI 写的测试经常"通过但啥也没测"。下面这套流程给你真覆盖率。
App 项目审计 Prompt 工作流
30 分钟 AI 审计三轮聚焦——安全（CORS / env / auth）、性能（N+1 / 缺 rate limit）、UX（可访问性挡板）——抓到大约 60-80% 上线前明显坑，出分级修复清单。
Bug Audit Prompt 工作流
20 分钟扫描代替 3 小时正式审查：让 AI 按类别（吞错、竞态、隐式 fallback、null 边界）找可疑点，带测试和优先级——不是泛泛的 review this code。
ChatGPT 编程工作流——能在真实代码库里活下来的流程
ChatGPT 不是 Claude Code，但用对了照样能在真实项目里跑通。这里是方法。
Claude Code 新手指南：安装、第一次重构、常见误区
Claude Code 是什么、怎么装、怎么完成第一次重构：安装步骤、Prompt 模板和新手最容易踩的坑。
Claude Code 的项目 prompt 怎么写
CLAUDE.md 不只是 readme，它是 agent 的记忆。
用 Claude Code 跑一次完整 SEO 审计
可复用的 Claude Code Prompt + 工作流，给你的内容站跑真实 SEO 审计。
Codex 新手指南：云端沙盒任务怎么用、怎么避坑（2026）
Codex 做什么、怎么在云端沙盒里跑任务、什么时候用它：安装步骤、扔给它过会儿回来看的工作流、新手最常踩的坑。
用 Codex 做 Code Review
把 Codex 当 pre-review——人类看之前先抓一遍。
用 Codex 审查 Sitemap
用 Codex 抽查 sitemap 正确性、新鲜度、覆盖度。
能跑出好代码的编程 prompt 结构
四块结构：目标（具体可衡量）、约束（要动 / 不许动的文件、要镜像的模式）、验收（一条可跑测试）、交接规则——少一块 AI 就用假设填空，往往是错的。
Cursor 新手指南——20 分钟跑通
安装 + 首次索引 + 4 次真实编辑（每个 AI 面板各一次：Tab / Inline / Composer / Chat），一小时后你就知道什么任务该按哪个键、什么是甜蜜区什么是失败模式。
Cursor 索引——又快又有用
调优循环：忽略什么、什么时候重 index、怎么用 @File / @Folder / @Symbol 精确钉住——治“Cursor 引一些不存在的文件”、“漏掉明明存在的”、“索引慢 / 坏”。
怎么把项目报告喂给编程 agent
把 30 页审计压成 1 页 brief（标题 / 范围 / Top 3 / 总数）、按严重度 chunk、agent 执行后跑核验循环——避免 “做了一些重构” 这种含糊产出。
Gemini 写代码——哪些场景赢 ChatGPT，哪些不
Gemini 的编程能力上得很快。讲清它真的能赢 ChatGPT 的几个场景，以及该切去 Claude / ChatGPT 的时机。
AI agent 的 git commit 实践
提交信息、提交边界，以及绝不能让 AI commit 的东西。
高效审 AI diff 的方法
200 行 diff，编译过 ≠ 安全——按高级工程师的顺序读。
多 agent 编程工作流
Cursor + Claude Code + Codex 一起用——不冲突。
防止 AI 改不该改的：repo 级 guardrail 实战
CLAUDE.md / AGENTS.md 列禁区路径、.cursorignore 让 agent 读不到、CODEOWNERS + 分支保护强制 review、pre-commit hook + secret 扫描——四层护栏比礼貌指令稳。
SEO 审计 Prompt 工作流
用 AI 审你站点的 SEO 基础——title / description / 结构化数据 / 内链。
可访问性审计 Prompt：WCAG 前端评审模板
12 个 Prompt 让 AI 以键盘 + 屏阅双重视角走查页面——语义、焦点、ARIA 控件、对比度、modal 栈、live region、WCAG 映射。
API 契约评审 Prompt：REST / GraphQL 模板
15 个 Prompt 在上线前压一压 REST / GraphQL 契约——命名、状态码、错误模型、breaking change、分页、N+1、字段级鉴权。
Bug 审计 Prompt：上线前抓暗 bug
13 个上线前可直接复制的代码审计 Prompt，分别针对竞态、null 解引用、off-by-one、内存泄漏、SQL 注入等 bug 家族——给独立开发者和 on-call 工程师准备。
Claude Code 执行 Prompt：规划、实现、验证
12 个 Prompt 让 Claude Code（或 Codex）真正完成工程任务——范围明确的特性、外科手术式修复、迁移、重构、TDD、性能、调试、代码审查。
代码审查 Prompt：超越 "LGTM"
13 个 Prompt 用 AI 做能挖出真问题的代码审查——bug、安全、性能、可读性、测试。
数据库 Schema 评审 Prompt：安全迁移模板
12 个 Prompt 站在未来迁移者视角扫 schema——范式、索引、FK cascade、可空、软删除、JSON 列、迁移安全、ORM diff。
上线检查 Prompt：上线前与上线后清单
12 个 Prompt 做预检——env 变量、DNS、缓存、可观测性、回滚演练、上线后监控、安全头、状态页对外沟通。
性能优化 Prompt：13 个真正能拿到提速的模板
13 个 Prompt 把性能优化做成真能动指标的事：先测量定瓶颈、LCP / CLS / N+1 / TTFB / 包体积 / 缓存逐个修、Web Vitals 前后对比、外加微优化检测。
React 组件重构 Prompt：干净组件模板
13 个 Prompt 重构 React 组件——抽 hook、提升状态、server / client 拆分、正确 memo、消灭 prop drilling。
README 生成 Prompt：60 秒到 Hello World
12 个 Prompt 写让新读者 60 秒从 git clone 到 install 成功的 README——骨架、quickstart、排错块、示例、API 速查、审计。
重构 Prompt：18 个让 AI 重构更安全的模板
18 个可直接复制的 Prompt，规划、执行、验证 AI 重构——模块抽取、重命名、async 迁移、god 函数拆分，不弄崩行为。
安全审计 Prompt：独立开发者也能跑的 AppSec 检查
12 个 AI 安全审计 Prompt：认证、授权、密钥、依赖、文件上传、CORS、PII 日志、威胁建模——不雇渗透也能跑完上线前 80% 的安全检查。
SEO 审计 Prompt：内容站可直接用
12 个 SEO 审计 Prompt：metadata、内链、hreflang、薄内容、canonical、结构化数据、关键词重叠、Core Web Vitals——每条带可量化阈值和修复动作。
测试生成 Prompt（集成 / E2E / 快照）：13 个模板
13 个 Prompt 用于集成测试、E2E、快照、契约测试——单元测试 Prompt 请看 unit-test 那篇。能抓真 bug 的测试，不是为了撑覆盖率的噪声。
TypeScript 报错诊断 Prompt：晦涩报错模板
14 个 Prompt 帮你快速诊断 TypeScript 报错——泛型、条件类型、类型收窄、模块解析、声明文件。
AI agent 在循环、不进展怎么办
Agent 一直试同一个修法，或在两种状态之间反复——快速打断的方法。
本地 build 过，CI 挂——AI 改完最常见的坑
经典场景：AI 装了依赖没提 lockfile，或依赖了本地 Node 版本。
AI 改代码后 build 挂了——恢复与诊断
AI 跑完一轮 build 报错。用 diff review、类型检查和定向 revert 修。
AI agent 把 .env 覆盖了怎么办
Agent 用占位符重写或删了 .env——如何恢复并预防。
AI 凭空引用了不存在的文件：3 个原因 + 修复路径
Agent 写了 `src/utils/superhelper.ts` 这种从未存在的导入——常见但易修。
AI 编辑后 merge 冲突——解决指南
Claude Code 或 Cursor 改完 6 个文件、rebase 一打回车满屏 CONFLICT，难点是分辨格式噪音和真正的逻辑冲突。本文给一条隔离 AI commit、分层处理冲突的路径。
AI 编辑后 package-lock / pnpm-lock 冲突
Agent 装 / 删了依赖，lockfile 和团队的对不上了。
AI 重构生成了重复文件：3 个原因 + 修复路径
Agent 在原文件旁边建了 `UserList2.tsx` 这种重复文件——安全清理步骤。
AI 重构把还有用的逻辑删了：3 个原因 + 修复路径
AI 把 50 行重构成 28 行看着漂亮，两天后客服群冒出登录跳错页——它把某个客户场景的兜底分支当死代码删了。本文教你用 bisect 加 prod 日志精确定位并加回。
AI 改代码后怎么安全回滚：3 个原因 + 修复路径
三条命令覆盖 99% 场景：stash / restore / reflog。
AI 写出来 TypeScript 类型错误
AI 出的代码过不了类型检查——通常是类型猜错、any 转换、漏掉泛型。
Claude Code 不理解你的项目怎么办：让 agent 真正读懂代码的 7 个方法
Claude Code 改了一半文件、问的问题对不上、找不到关键函数？多半不是模型不行，而是它没拿到正确的项目上下文。本文给出 7 个方法让 agent 一次就读懂你的项目。
Codex 生成代码不符合项目结构
Codex 把文件建错位置 / 风格不一致——用 AGENTS.md 和显式引用约束。
Cursor 无法应用修改怎么办：4 个原因 + 对症修复
Cursor 能看到 diff 但 Apply 没反应或静默失败。常见原因：Composer / Inline 模式不匹配；文件被别的进程或 git 锁了；Cursor 扩展过期。先做：保存所有打开的文件，关掉其他编辑器。
Cursor 没读到整个项目：3 个原因 + 修复路径
Cursor 只能改"看得见"的——调整索引范围 + 显式 @File 引用。
Cursor 老是读错文件：3 个原因 + 修复路径
Cursor 把旧 / 生成 / vendored 文件拉进 context——靠索引和 ignore 修。
Git commit 后怎么找回旧版本
AI 重构覆盖文件、reset --hard 选错 commit、rebase 后旧 commit 看似消失——99% 没真丢。本文给三条找回路径：文件历史、reflog 找 HEAD、fsck 捞悬挂 commit。
审核 AI 生成的 diff 该按什么顺序看
AI 给的 200 行 diff，编译过 ≠ 安全。这是阅读顺序。
多个 AI agent 同时改文件冲突了
两个 agent（Cursor + Claude Code）同时改了同一个文件——干净合并的方法。
Claude Code vs Cursor：什么任务用哪个
Claude Code 是命令行 agent，Cursor 是编辑器内副驾驶。任务类型、调试链路、回滚成本不同——这篇给一张选择表。
Cursor 新手怎么开始：30 分钟跑通完整工作流（2026）
Cursor 第一次安装到独立完成第一个修改，30 分钟跑通完整工作流：Composer 与 Inline 的区别、Codebase 索引、@Files 注入、Apply 与回滚。
Cursor 一直 indexing 怎么办：让它跳过 node_modules 与构建产物
Cursor 卡在 indexing 不动？多半是 node_modules、build / dist、缓存目录被索引了。这篇给出 .cursorignore 模板与重建索引的步骤。
Codex 和 Claude Code 有什么区别？哪个更适合你？
OpenAI Codex 和 Anthropic Claude Code 都是命令行 / 编辑器中的 AI 编程代理。本文对比两者的定位、能力、生态与适用场景。
Claude Code 是什么？Anthropic 官方终端 AI 详解
Claude Code 是 Anthropic 出的命令行 AI 工具。本文讲清它能做什么、跟 ChatGPT / Cursor 有啥不同，以及前 10 分钟怎么上手。