Agent 预算在任务中途被吃光
Agent 执行长任务时 token 或费用预算耗尽，任务半途中止、半成品代码留在磁盘上。本文教你定位预算去向、抢救中间结果，并从断点续跑。
#排查
带有该标签的文章
Checkpoint 恢复出来的状态是损坏的
Agent 从 checkpoint 恢复后状态字段缺失、类型错乱或值异常。本文教你定位损坏、回滚到完好的历史版本，并写出真正抗崩溃的 checkpoint。
成本统计漏算了子 Agent 用量
成本仪表盘显示 2 美元，账单却是 18 美元。子 Agent 的 token 消耗没有归因到父级运行。本文给出补齐缺口的方法，2026 年 6 月核实。
Agent 调用图出现循环但没人发现
多 Agent 之间互相交接，形成永不终止的环，因为没有任何东西在检测循环。本文教你抓出这个环、配好框架自带的上限、并把循环彻底限定住。
Agent 交接时上下文丢失了
下游 Agent 重复询问已答过的问题，或输出与前几步的决策相矛盾。本文帮你定位丢失上下文的交接边界，并在一小时内接上结构化、可持久的状态传递。
Agent 把 API key 明文写进输出：先轮转，再封堵
助手在回答或工具调用里输出了明文 API key、token 或连接串。几分钟内完成密钥轮转、审计是否被滥用，并让模型再也接触不到明文密钥。
Agent 编排器互相等待出现死锁
两个 Agent 互相等待对方的输出，整条流水线永远挂起。本文教你找到环、加超时、几分钟内打破死锁，并给出 LangGraph、Temporal、AutoGen 的具体做法。
修复：Agent 把 secret 写进了日志和 git
AI Agent 把真实的 API key、token 或密码写进了日志、trace 或已提交的文件。这里给出最快的止血路径，以及如何脱敏输出、阻止它再次发生。
Agent 输出下游解析不了
Agent 把 JSON 包进 Markdown 代码块、或在前后加了一句废话，下游解析直接崩。用原生结构化输出彻底修好（2026 年 6 月）。
Pre-flight 检查被 Agent 跳过
Agent 跳过了启动前应该执行的检查，结果在几秒就能发现的问题上跑了几小时才失败。本文教你把 pre-flight 做成任何代码路径都绕不过去的强制门禁。
Agent 晋级判据太宽，劣质输出被放行
Agent 流水线的 Promotion（晋级）判据太宽或太容易满足，让劣质输出蒙混过关。用「关键项必须全过 + 装饰项走阈值」、有据可依的检查和对抗测试收紧 gate，同时不误杀好输出。
修复不同版本 Agent 间的 Prompt 模板漂移
不同 Agent 实例运行着略有差异的 system prompt，输出质量取决于哪个实例处理了请求。本文教你如何固定 prompt 版本、按运行记录确切的 prompt，并在上线前发现漂移。
一个 Agent 触发 rate limit 拖垮整条流水线
一个 Agent 被限速，等待它的其他 Agent 接连超时，整条流水线雪崩。教你隔离限速桶、解耦各阶段、彻底终结 429 级联失败。
不稳定 tool 触发 Agent 重试风暴
一个偶发失败的工具调用，让 Agent 重试上百次，烧光预算、撞上 rate limit。给重试加上次数上限、带 jitter 的退避、429 处理和熔断器。
共享 memory 被多 Agent 写覆盖
两个 Agent 读到同一份共享 memory，各自写回，其中一个更新悄悄消失了。本文教你定位这个「丢失更新」竞态，并用原子操作、乐观锁或按 Agent 分区把它彻底修掉。
Agent 跳过了必须的验证步骤
Agent 流水线把未经验证的输出放行了，因为 Lint/测试关卡被跳过。教你在 LangGraph、CrewAI、OpenAI Agents SDK 和 Claude Code 里强制不可跳过的验证。
重启后 Agent 状态对不上：检测漂移并重新同步
崩溃或重启后，Agent 以为世界还停在旧状态，与现实对不上。本文教你在 LangGraph、Temporal 和自研 checkpoint 里检测状态漂移并可靠地重新同步。
Agent 退出后，它启动的子进程成了孤儿
AI Agent 启动了开发服务器或文件监听进程，自己却先退出了，没有把它杀掉。这个进程继续占着端口、烧着 CPU。本文教你追踪每一个子进程，并确保它一定会被终止。
任务被路由到了错误的 Agent：修复路由误判
CrewAI、LangGraph 或 AutoGen 的路由器把任务分给了能力不匹配的 Agent，输出全是废话。本文教你定位路由逻辑、修复分类误判。
Trace 里看不到关键 tool call：定位缺口并修复
LangSmith 或 Langfuse 的 trace 里只有结果、没有 tool call span。本文用一张判断表帮你锁定七种根因中的哪一种，并给出对应修复，让 trace 重新完整。
Roleplay 绕过你的 AI 内容过滤器
用户让 AI 扮演一个"没有限制"的角色，模型就输出了违反策略的内容。教你在日志里识别 roleplay 绕过，并加上真正管用的输出侧防护。
AI 听从了上传文件里的恶意指令
上传文件夹带隐藏指令，在任务中途劫持了 AI。检测白色文字、Unicode 隐写和元数据载荷，清洗上传内容，并阻断由文件触发的工具调用。
AI 工具不小心写出了钓鱼文案
你的 AI 内容工具因为请求被伪装成营销或培训任务，输出了可用于钓鱼的邮件或仿冒登录页——识别「三特征同现」模式，并在输出侧加上意图门控。
通过图片 URL 把数据外发
Agent 把敏感数据编码进 Markdown 图片 URL，聊天界面自动加载它，数据就被泄露到攻击者服务器——如何识别这个攻击链并彻底切断它。
git bisect 卡在 skipped commit 上
git bisect 反复 skip，最后只给出「The first bad commit could be any of...」一堆 SHA 而不是唯一结果。本文教你整段 skip、用退出码 125 自动跳过，并修掉构建/环境问题让 bisect 真正收敛。
分支保护规则让 PR 合不了
PR 有 approve、CI 全绿、没有冲突，但 GitHub、GitLab、Bitbucket 的合并按钮还是灰的。找出到底是哪条规则没满足，在不削弱保护的前提下解开。
解冲突后 cherry-pick 变成空 commit
解决 cherry-pick 冲突后执行 --continue，Git 提示 commit 已为空。讲清楚何时该用 --skip、何时用 --allow-empty，以及为什么 --empty=drop 在这里没用。
Git 凭证 helper 锁住：pull / push 全部失败
git pull / push 每次都弹密码、卡住 30 秒、或直接报 403 / 401，是因为凭证 helper 缓存了失效凭证或配置出错。清掉缓存凭证、重新认证即可。GitHub / GitLab / Bitbucket 通用。
我在 detached HEAD 上提交了，怎么办
在 detached HEAD 上提交，切回分支后 commit 不见了？从 reflog 找到 SHA，在 git gc 清理掉它之前挂回分支。
Force push 覆盖了队友的 commit
git push --force 把共享分支上队友刚推的提交冲掉了。教你从 reflog 或 GitHub Activity 视图找回丢失的 commit，并彻底防止再次发生。
Clone 之后 git hooks 不执行
新成员 clone 仓库后 pre-commit、pre-push hooks 完全不触发。原因是 git clone 从不复制 .git/hooks/——本文给出一行 core.hooksPath 修复，以及正确的 husky v9 / lefthook 配置方式。
历史里的大文件让 git push 失败
历史中有超过 100 MiB 的文件，GitHub 拒绝 push。用 git-filter-repo 把它从每个 commit 里彻底清除，再 force push 干净推上去。
Git LFS pointer 文件没被真实文件替换
clone 后图片、模型等大文件变成几行 LFS pointer 文本，程序报「无效文件格式」。先 git lfs install 再 git lfs pull 两条命令解决，并附上 smudge filter 为什么没跑的排查表。
CRLF 转换把 2 行改动撑成 3000 行 diff
一次换行符规范化把 2 行改动变成几千行 CRLF/LF diff。先判断自己属于哪一类，再修好 .gitattributes、renormalize 一次，并彻底防止复发。
二进制文件合并冲突：直接选边，几分钟解开 merge
Git 把二进制文件标记为冲突，却没有 diff 标记。用 git checkout --ours/--theirs 选对版本、完成合并，本文给出完整诊断与修复路径。
Monorepo partial clone 数据过期或缺失
blobless 的 monorepo clone 在 pull 之后出现空文件、旧版本或文件缺失。用 git backfill 批量补全 blob、重设 sparse cone，并彻底防止复发。
git pull --rebase 把冲突历史弄乱了
git pull --rebase 在一个看不懂的冲突上停下，解完后 git log 全乱了：SHA 变了、commit 顺序变了、还多出一个 fix conflict 提交。哪些是正常的、哪些是真坏了、怎么干净恢复。
Git rebase 之后 commit 消失了
执行 git rebase 后部分提交从历史中消失。用 ORIG_HEAD 或 reflog 在两分钟内找回丢失的 commit，零数据损失。
git revert merge commit 报错 no -m option 怎么修
git revert 撤销 merge commit 报错 'commit is a merge but no -m option was given'。讲清 -m 1 和 -m 2 该选哪个、如何撤销正确的一侧，以及之后重新合并时不丢改动的完整方法。
我把 secret 推到公开仓库了
API key 或密码被推进了公开 GitHub 仓库。先吊销密钥，再用 git-filter-repo 从历史里彻底清除，赶在爬虫使用它之前。
Git stash 在 checkout 之后不见了——如何找回
切换分支后 git stash list 变空，未完成的改动找不到了。本文教你用 stash reflog 或 git fsck 找回丢失的 stash 并恢复到工作区。
Git Submodule 怎么都拉不到最新 commit
git submodule update 执行成功，submodule 却停留在旧 commit、目录为空，或指向一个根本不存在的 SHA。本文帮你先判断属于六种原因中的哪一种，再对症同步指针。
Git Tag 指向了错误的 commit
release tag 打到了错误的 commit 上，而且已经 push 出去了。本文教你安全地移动 tag、让每个克隆都 force-fetch，并处理 npm、GitHub Release 等已经锁定旧代码的缓存。
删掉分支后 Git Worktree 变成幽灵
分支或目录被删除后 git worktree 损坏，git worktree list 报错。用 prune 清理悬空注册、用 repair 修复被移动的 worktree、抢救未提交改动——基于 Git 2.36+ 实测命令。
PDF 里夹带的 Prompt 注入
PDF 中藏着白底白字、超小字号或元数据文本，悄悄改写你的 AI 管道。检测、清除并加固防御 PDF 携带的间接 Prompt 注入。
Web fetch 抓到的页面里藏的间接注入
Agent 抓取一个 URL 后行为异常——页面里的隐藏文字劫持了它的下一步动作。识别并拦截来自网页内容的间接 Prompt 注入。
搜索结果 snippet 被用作注入载体
AI 搜索后立刻调用 send_email 或 webhook——把每条 snippet 当不可信数据扫描并隔离，并在搜索边界后为有副作用的工具加上确认闸门。
翻译往返中被注入指令
隐藏指令借助翻译环节进入 AI 管道——要么 LLM 翻译器直接执行它，要么翻译 API 的输出未经扫描就重新进入流程。检测、扫描与隔离修复方法。
llama.cpp 在网络盘上 mmap 失败
llama.cpp 从 NFS、SMB 或 CIFS 网络盘加载 GGUF 模型时崩溃或卡顿。最快修复：加 --no-mmap（DirectIO 开着时再加 --no-direct-io），或把模型拷到本地盘。
llama.cpp 换更激进量化后质量明显下降
从 Q5_K_M 或 Q8_0 换到 Q4_0、IQ4_XS 或更低量化后输出变差：选对量化档位、修复劣质重量化文件，并用 perplexity 验证。
LM Studio 加载模型时报 out of memory
LM Studio 加载 GGUF 模型时崩溃或报 out of memory。先降 Context Length、开 Flash Attention、调 GPU offload 即可解决，附按显存分级的选型表。
本地 embedding 服务在 batch 请求下崩溃
Ollama、llama-server、vLLM 或 sentence-transformers 批量 embedding 时 OOM 崩溃或返回 500。从 batch size、num_batch、序列长度、并发四方面定位修复，附确切参数。
Chat-Template 不匹配导致本地 LLM 输出乱码
本地 LLM 把你的问题原样吐回、在回复里夹着 [INST] 或 <|im_start|> 标签、或者一句话重复个没完，这都是 chat-template 不匹配。教你找到模型真正的模板，并强制引擎使用它。
多 GPU 没分配上，模型只跑在卡 0
本地 LLM 只用一张卡，其余卡 0% 空闲。用 llama.cpp --split-mode、vLLM --tensor-parallel-size、Ollama 自动分布，以及 PCIe 机器需要的 NCCL 参数把它分到多卡上。
本地模型输出在 token 中间被截断（Ollama / llama.cpp）
本地模型生成到一半停在单词或汉字中间，没有 EOS、没有报错。逐一排查 num_predict 上限、按显存推算的 num_ctx 默认值、stop 序列、代理缓冲与 UTF-8 字节切割。
RoPE scaling 设错让长上下文输出乱掉
本地模型在原生上下文长度内正常，超过后就开始重复、乱码。手把手诊断并修复 llama.cpp 和 vLLM 的 RoPE scaling（YaRN、llama3、rope_theta）配置。
本地模型冷启动后首 token 极慢
本地 LLM 加载后首 token 要等 30-120 秒，之后就很快。定位磁盘 I/O、模型被卸载、CUDA/Metal shader 编译、KV cache 分配等冷启动瓶颈，并把模型常驻内存。
Tokenizer 漂移：本地模型 token 计数对不上
应用层的 token 计数与本地 llama.cpp 或 Ollama 服务对不上，导致上下文溢出或静默截断。用服务端自带的 tokenizer 作为基准来消除漂移。
本地模型不遵守 tool calling 格式
本地 LLM 返回纯文本描述而不是 JSON 工具调用，或格式错误导致解析失败。用支持 tool calling 的模型、llama-server 的 --jinja 参数和 Ollama 的 format JSON Schema 约束彻底修好。
本地 RAG 索引重建慢到无法忍受
本地向量索引重建从几分钟拖到数小时？修正 batch 大小、跳过未变文档、批量写入向量库、合理设置 chunk 大小，把 6 小时降到 15 分钟内。
MCP server 被供应链攻破：检测与处置
已信任的 MCP 包推送了带恶意代码的更新，窃取密钥或发起异常工具调用。教你检测攻击、隔离影响、轮换密钥，并用版本锁定加发布冷却期加固安装。
mlx_lm.convert 转换 HuggingFace 模型失败
在 Apple Silicon 上用 mlx_lm.convert 把 HuggingFace 模型转成 MLX 时报错：Model type not supported、GatedRepoError 401 或内存不足 OOM。修复步骤已于 2026 年 6 月核实。
多轮对话逐步升级到越权（Crescendo 攻击）
攻击者每轮只推进一点，最终让限制全部失效。学会在整段对话历史里识别这种渐进升级，重置上下文，并加上会话级监控，让告警在越权那一轮之前就触发。
Ollama pull 卡住或下载进度回退 — 修复方法
ollama pull 停在某个百分比、进度条往回跑、或报 max retries exceeded: EOF。分析网络、磁盘、partial 分片三类原因，给出可干净续传的修复步骤。
Ollama 探测不到 GPU，全跑在 CPU
Ollama 启动后模型在 CPU 上运行，生成极慢。读懂 inference-compute 日志，定位驱动、CUDA、ROCm 不匹配，强制开启 GPU 卸载。
Ollama pull 成功但 ollama list 看不到
ollama pull 显示 success，但 ollama list 里没有这个模型，运行时报 model not found。修复 OLLAMA_MODELS 路径分裂、ollama 服务用户不一致、manifest 损坏等根因。
Ollama Modelfile 里的 SYSTEM prompt 被忽略
Ollama Modelfile 的 SYSTEM 设置对模型行为毫无效果。最快修复：确认 TEMPLATE 真的渲染了 .System、排查 RENDERER/PARSER 继承覆盖、阻止客户端覆盖 system 消息。
修复 Ollama 端口被占用 (11434)
Ollama 因 11434 端口被占用而无法启动。教你定位占用进程、释放端口，或把 Ollama 换到其他端口——macOS、Linux、Windows 的精确命令。
两个并行 Agent 同时改一份文件（改动丢失修复）
并行 AI Agent 静默覆盖彼此对同一文件的改动，导致改动丢失。2026 年 6 月最快的修复是 worktree 隔离。本文讲清楚如何检测、修复并预防写丢失。
Prompt 注入绕过了你的 system prompt
一条精心构造的用户消息覆盖了 system prompt 的策略，模型放弃了护栏。先判断自己属于哪一类绕过，再搭建真正扛得住的分层防御。
代码注释里藏的指令影响了 AI 行为
代码注释里的一句指令让 AI 审查工具批准了 PR 或跳过了某段代码。如何检测注释注入、把代码标记为数据，并缩小被攻破后的影响范围。
文件名里藏 Prompt 注入
上传文件的文件名携带注入指令，被 Agent 读取时触发。最快的修复：prompt 里用 UUID 引用文件，绝不放原始文件名。检测、清洗并阻断以文件名为载体的注入。
用户粘贴内容里的 Prompt 注入
用户把外部文本粘进对话，里面夹带的指令劫持了 AI 助手。如何识别这条信任边界的断裂，并通过隔离与清洗让粘贴内容无法充当指令。
Secret 被无意写入 prompt 上下文
API key、密码或 token 不小心进了 prompt——如何第一时间轮转、追踪它流向了哪里，并从源头阻止 secret 再次进入模型上下文。
Role-confusion 越狱：用户「说服」AI 拿到 system 权限
用户靠一段话让 AI 以为自己拥有 system 级权限。教你在日志里识别角色混淆，并用结构化信任分层（而非更好的措辞）彻底防住。
工具返回被当成可信用户输入
Agent 运行工具，返回内容里藏着指令，模型照做了。讲清楚工具输出为什么会拿到用户级信任，以及用消息角色、内容标注和权限闸门彻底堵住它的方法。
恶意 MCP server 重定义 tool 行为
恶意 MCP server 把指令藏在 tool 的 description 里，让模型在执行正常工具的同时偷偷外发数据。如何检测、审计并防御 tool poisoning。
User 输入被当成 system 指令执行
用户输入落到了 system/developer 角色或运营方信任位，模型把它当成开发者指令执行。剖析根因并给出架构级修复，2026 年 6 月核对。
修复 vLLM context length exceeded 报错
vLLM 返回 This model's maximum context length is X tokens 报错。合理设置 max-model-len、提高显存配额、启用 fp8 KV cache 并预留输出 token 即可解决。
修复 vLLM CUDA 版本不匹配与 undefined symbol 报错
vLLM 启动崩溃，报 undefined symbol、no kernel image 或 CUDA 不匹配。用全新环境加 uv --torch-backend=auto 安装，并对齐驱动、CUDA 与 PyTorch。
ads.txt 重定向导致 AdSense 验证失败 —— 排查与修复
浏览器能正常打开 ads.txt,AdSense 却一直说“未找到”。爬虫只跟一次离开本域的跳转,而且终点必须是纯文本的 HTTP 200。本文教你拆掉这条跳转链。
改版之后 AdSense RPM 暴跌 —— 排查与修复
新模板上线后页面 RPM 掉了 30-60%?几乎都是广告位丢失、可见度回退,或者广告被挤到首屏以外。按 URL 分组诊断,先修影响最大的那一桶。
AI 加了一条绕过鉴权中间件的路由 —— 排查与修复
AI 在鉴权路由组之外注册了新接口,把内部数据无防护暴露出去。最快的修法:把路由迁到鉴权 router 下,并在数据层(而非中间件)强制 auth。
AI 图片背景颜色渗到主体上：怎么隔离掉
主体皮肤和衣服染上墙的颜色。根因是 cross-attention 串色加上没有蒙版。用蒙版重绘、BREAK、分区提示词或两步生成快速隔开。
AI 图片边缘 JPEG 伪影怎么消除：5 步导出干净版
SDXL 渲染或 inpaint 后边缘出现块状 8x8、渐变带状。真正根因是 fp16 VAE 加上有损导出。换 fp16-fix VAE 并改导 PNG。
AI 图片双眼不对齐：5 类原因 + 两遍修眼路径
一只眼高一点、虹膜方向不一致、或一只瞳孔更大？根因是眼睛区域的 latent 像素太少。先跑一遍修脸，再单独跑一遍修眼就能救回来。
AI 图片眼镜反光对不上场景
生成的人像戴眼镜，镜片里反着窗户、天空或者根本不存在的环境。讲讲 diffusion 模型为啥会瞎编反光、最快的修法，2026 年 6 月已核实。
AI 图片头发像铁丝或塑料线（修复）
生成的人像头发一根根像铁丝、钓鱼线甚至塑料丝。讲清楚 diffusion 模型为什么会画出 wire-hair，以及把柔软发丝找回来的 prompt、CFG、sampler 和 inpaint 具体设置。
AI 图像 inpaint 改动了蒙版外的像素：排查
你只蒙了一块做 inpaint，蒙版外的像素也被改了。强制 paste-back 合成（apply_overlay）、用硬边蒙版、再用像素 diff 验证。
AI 图像负向提示词无效：排查与修复
负向里写了 'text, watermark, extra fingers'，结果三样都还在？通常是七个原因之一：没接进去、CFG 太低、被正向反向召唤、超过 75 token 被截断、权重语法不对、checkpoint 过度训练，或者你用的是天生无视负向的 Flux 模型。
AI 照片没有胶片颗粒：5 步还原真实摄影质感
照片 Prompt 输出干净得像 CG、完全没颗粒。根因是模型偏向干净渲染。用具体胶片型号、加权颗粒，再配保颗粒的放大或后期补救。
AI 图片属性串色：红帽子把车也染红了怎么修
一个主体的颜色或材质漏到另一个主体上。根因是 CLIP token 间的 cross-attention 渗漏。用权重、BREAK、分区提示词、ControlNet 修，Flux 上则改用自然语句。
AI 图像参考图被无视：修复 img2img 与风格迁移
上传了 img2img、IP-Adapter、Flux Redux 或 ControlNet 的参考图，输出却几乎看不出来？先扫强度、确认参考真到了模型，再去拧对应的旋钮。
AI 图像同 seed 出不同结果：可复现性排查
同样的 seed 和提示词却出不同图？seed 只是约 10 个变量之一。要锁的是模型版本、采样器、调度器、步数、CFG 和后处理，而不只是 seed。
AI 图片阴影方向不对：5 类原因 + 修光路径
阴影方向和光源对着干，或两个光源互相打架。根因是模型把光照线索做了平均。用显式方向、参考图和 IC-Light 重打光锁住。
AI 图片皮肤过于光滑像塑料：还原真实质感
皮肤像磨皮过头、像塑料、像 CG。降低 face-restore 强度（调 visibility 不是 weight）、Prompt 出毛孔和颗粒、再上写实 LoRA。SD / Flux / Midjourney 分工具修法。
AI 图片文字乱码或错语种：5 步出可读招牌
招牌写成 OPEM 而不是 OPEN，中文变成假字。换文字向模型（GPT Image 2、Nano Banana Pro、Ideogram 4、FLUX.2），文字砍短加引号，或后期补字。
AI 编造了根本不存在的 API 签名 —— 排查与修复
AI 调用了一个并不存在的方法:参数顺序错、选项名瞎编、返回类型臆造。对照真实 .d.ts 定位,并用当前文档锚定后续生成。
AI 生成的迁移本地能跑、上生产就炸:修复指南
AI 写的迁移在空 dev 库里干净通过,到生产却卡死、触发约束错误或 NULL 报错。用生产克隆测试加几套安全 SQL 模式彻底解决。
AI 音乐曲中途速度漂移：BPM 不稳排查
Suno 或 Udio 开头 120 BPM，到尾部飘到 128 或 115。最快修法：在 Suno Studio 里把 Project Tempo 从 Follow Track 切到 Manual BPM。另附从源头止住漂移的提示词改法。
AI 写的 SQL 把热点表锁了好几分钟 —— 排查与修复
AI 写的 UPDATE / DELETE 在生产 Postgres 表上持有长锁,把读写都堵死。先 cancel 止血,再改写成锁友好的分批写法。
AI 无视 lint 报错继续用废弃语法 —— 排查与修复
AI 生成的代码用了废弃 API,看到 lint 报错改了一处,下一个文件又把废弃写法塞回来。把禁令写进 .cursor/rules,并让 ESLint 在 CI 里硬性报 error。
AI 视频音画不同步修复
嘴在动、鼓在响，但音轨比画面早或晚。用一条 ffmpeg 命令做偏移、把 VFR 转成固定帧率，或换音画一体的模型。
AI 视频镜头运动方向反了：排查指南
你要的是慢推近，出来的是慢拉远；或者 pan left 回来变成 pan right。用起末帧、屏幕空间表述，以及 Runway、Kling、Flow 内置的镜头控制来锁死方向。
AI 视频续接（Extend）丢风格、丢色调、丢人设修复
续接 Runway Gen-4.5、Kling 3.0、Pika 2.5 片段后色调、人脸、光照漂掉。靠 reference 参考图做风格锁、从干净帧重起图生视频、或者后期 crossfade 拼。
AI 视频运动中手部消失或畸变
角色一动起来,手就糊进袖子、跟身体融为一体、突然多出第六根手指,甚至凭空消失几帧。为什么手是 AI 视频最难的区域,怎么把它保住——已在 Sora 2、Veo 3.1、Kling、Runway 上验证,2026 年 6 月。
AI 视频输出帧率跟你要的对不上
点了 24fps 电影感却出来 30fps?60fps 慢动作在模型预览里好好的、别处一放就掉帧?用 ffprobe 定位是哪一步翻了车,再端到端锁死。
修复 AI 视频循环接缝处的可见跳变
AI 片段循环时接缝跳一下。用原生循环开关（Luma Loop 勾选框、Pika 自动循环）、首尾同图关键帧、后期 crossfade，或回文技巧来修。
AI 视频多角色身份中途互换修复
两个角色在镜头里中途换脸或换衣服。用每角色独立参考图（Runway Gen-4、Kling Elements）、单角色独立生成再合成、或把两人都锁进图生视频首帧来修。
修复 AI 视频 Prompt 关键词中途失效
写了'雨贯穿整段'，雨下到 2 秒就淡了。这是时间维度的 prompt 衰减。用 Veo 3.1 时间戳 prompt、Sora 2 storyboard、分段拼接或首帧锚定来修。
AI 视频导出后掉到 720p：分辨率降档修复
明明 1080p 生成，文件却是 720p / 540p / 480p。用应用内的 HD 下载、确认套餐导出上限，再用 Topaz、Runway 或 DaVinci Resolve 升回去。
修复 AI 视频画面内文字乱码 / 抖动
AI 视频里的招牌字、屏幕字拼错、抖动、不可读？最快做法：后期加字（CapCut / Premiere / Resolve），或换 Veo 3.1、Sora 2、Kling 3.0 重渲。
去掉 AI 视频导出时带的水印
成片带着 Runway、Kling、Pika、Sora 或 Veo 的水印。修复方式：选对套餐档位、勾对导出选项、重渲，或在后期把它抠掉。
AI 在 pnpm / Yarn 项目里跑 npm 命令(锁文件修复)
AI 在 pnpm 仓库里跑 npm install,生成 package-lock.json,破坏锁文件契约、把 CI 弄崩。用 devEngines/corepack 加 preinstall 守卫锁死包管理器。
App 因 5.1.1 隐私条款被拒：如何重新提交
苹果援引 5.1.1 时，通常是你的隐私政策、App 隐私标签或同意流程与二进制实际运行行为不一致。逐项诊断 6 种成因并重新提交。
修复 App Store 上传报 ITMS-90426 Invalid Swift Support
SwiftSupport 目录缺失时，App Store Connect 会以 ITMS-90426 Invalid Swift Support 拒绝你的 IPA。最快修复方案，外加六类根因、诊断命令和干净重建流程。
Astro adapter 与 SSR/SSG 模式不匹配 —— 排查与修复
Astro 部署失败或页面白屏，多半是 adapter 跟 output 模式对不上，或某个路由的 prerender 标记悄悄推翻了全局模式。本文给出诊断与修复（Astro 5/6，2026 年 6 月）。
ATT 追踪弹窗不出现：排查与修复
ATTrackingManager.requestTrackingAuthorization 不弹 UI 直接返回 notDetermined 或 denied，多因 App 状态、设备总开关、Info.plist 或调用位置。2026 年 6 月核实的修复方案。
定时任务静默跳过、日志里啥也没有
定时任务到点没跑、日志也不报错。修复顺序：时区统一 UTC、检查 startingDeadlineSeconds、加心跳、对漏跑告警。
线上 Postgres 迁移卡在 ALTER TABLE 一动不动
ALTER TABLE 迁移在生产卡死。用 pg_blocking_pids 找出阻塞者、终止它，再加 lock_timeout 重跑——让迁移失败得干脆而不是一直卡。
Docker 容器退出码 137 重启（OOM 被 kill）：怎么修
容器退出码 137、没有栈。那是 OOM killer 用 SIGKILL 撞上了 --memory 上限。先确认，再用堆 dump 找泄漏、设合理上限、加护栏。
修复 gRPC 高负载下的 DEADLINE_EXCEEDED 雪崩
压力一上来 gRPC 客户端就 DEADLINE_EXCEEDED 满天飞。把 deadline 往下游传、按 SLO 定超时、用内建重试策略加 throttling、再给最慢的依赖加熔断器，单点慢不再雪崩。
JWT 刚签发就报 jwt expired：修时钟偏移
JWT 校验报 jwt expired 或 token not yet valid，连刚签发的也中招。修法：NTP 同步时钟、校验器加 5 秒 leeway。
Kafka consumer lag 一直涨，扩 consumer 也没用
扩了一堆 consumer pod，lag 还在往上走。瓶颈基本不是 consumer 不够多，而是 partition 数、poison message、慢下游写入、或者 rebalance 抖动。
MongoDB `$lookup` + `$group` 聚合管线跑 30 秒
MongoDB 聚合管线在生产环境慢成狗。读 explain('executionStats')、给关联字段加索引、把 $match 提到最前、看懂新的 EQ_LOOKUP strategy。
Postgres autovacuum 被一条长事务卡住，dead tuple 怎么清都清不掉
dead tuple 一直涨、表越来越胖，VACUUM 日志却说 dead but not yet removable。一条没人管的长事务把 xmin horizon 拽住，vacuum 啥也回收不了。找出来干掉它。
RabbitMQ 消费者连着却不消费、队列一直涨
RabbitMQ 显示消费者健康、队列却越堆越多。在 RabbitMQ 4.x 上修 prefetch、unacked 消息、consumer_timeout 和死信路由。
S3 预签名 URL 大文件上传中途 403
AWS S3 预签名 URL 小文件没事、大文件传到一半 403。修对 TTL、修对签发凭证的有效期，大文件改 multipart 上传。
修复 Chrome 的 NET::ERR_CERTIFICATE_TRANSPARENCY_REQUIRED
Chrome（现在 Firefox 也是）拒绝一张本来有效的证书，报 NET::ERR_CERTIFICATE_TRANSPARENCY_REQUIRED。证书没进 CT log，或者 SCT 缺失、过期、被剥离。本文教你确认并从源头修好。
ChatGPT 高级语音在你所在地区不可用:修复指南
Advanced Voice 受账号国家、套餐、客户端版本三道门限制。大多数 not available 报错都是客户端太旧、套餐失效,或者在 Mac 上 —— 桌面 app 的语音功能已被下线。
ChatGPT 刷新后附件消失：找回内容并彻底预防
传上去的文件刷新后从 ChatGPT 对话里消失，还弹出 "This file is no longer available."。教你把内容捞回来、快速重传、并用 Library 让它不再发生。
修复 ChatGPT 代码解释器沙盒中途超时
Code Interpreter 跑到一半就报 execution timed out —— 通常是 CPU 密集循环、挂起的网络调用,或者 ~120 秒、~1GB 沙盒里的内存暴涨。最快的办法:拆成带 checkpoint 的多个 cell。
ChatGPT 长对话上下文超出窗口
聊久了 ChatGPT 开始忘前面的内容。多半是当前套餐的 context window 满了、附件吃 token、或者被降级路由了。诊断 + 修复，附 2026 年 6 月各档位精确 token 上限。
ChatGPT 出国后被地区屏蔽：如何解除
出国后 ChatGPT 提示 not available in your country（error=unsupported_country）或要求重新验证？大多数情况清掉 cookie 就好。按原因分类的完整修复指南，2026 年 6 月。
ChatGPT 读取 CSV 却报错列名或把多列合并：分隔符识别失败
上传 CSV 后 ChatGPT 列出奇怪的列名、把两列糅成一列、或把表头当数据。通常是分隔符或编码识别出错。这里给出最快的修法。
Custom GPT 在 ChatGPT 账号之间转移所有权卡住怎么办
在个人 Plus 账号上养了 Custom GPT,要迁到 Business/Enterprise 工作区?其实根本没有单个 GPT 的转移按钮。这篇讲清截至 2026 年 6 月真正能走通的迁移路径。
ChatGPT 忽略 Custom Instructions：修复方法
Custom Instructions 明明设了，ChatGPT 对话中途却不听。多半是 Project 覆盖、Memory 冲突、上下文溢出、或模型被切。让指令真的生效。
ChatGPT 改邮箱卡在验证环节
改了 ChatGPT 邮箱、被登出，新旧邮箱都进不去。最快的解法是新邮箱里那串 6 位验证码（或一次密码重置）。在不丢聊天的前提下把账号救回来。
ChatGPT 静默拒绝加密 PDF——没报错只给空回复
加密 / 受保护 PDF 上传看起来成功，但 ChatGPT 回答像没读过文件。没错误提示，只有空话。这是抽取层静默失败，不是模型笨。
ChatGPT 读 Excel 但不算公式（把公式当字符串返回）
上传 XLSX 后 ChatGPT 能读普通单元格值，但公式格子返回 '=SUM(A1:A10)' 这种字符串、或者返回 0。本文讲清 openpyxl 为什么这样，以及截至 2026 年 6 月最快的修法。
ChatGPT 导出对话失败：修复收不到或空的 ZIP
Data Controls 导出一直不发 ZIP、ZIP 是空的、或者下载下来是损坏的。搞清楚链路哪一环断了，把完整档案捞回来。
重新上传文件后 ChatGPT 还引用旧版本：缓存 + 同名重复
新文件传上去了，ChatGPT 却还在引用删掉的旧文本。修法：先删旧文件、看清 Skip / Upload anyway 提示、改名破缓存、或开新对话。
ChatGPT 报 'No Text Could Be Extracted From This File'（扫描件 / 手写 PDF）
扫描件或手写 PDF 报 'No text could be extracted from this file'，或者抽取器只读文本层导致模型瞎编内容。最快修法：上传每页图片，别传 PDF。
ChatGPT 把 JSON 当成普通文本读，而不是结构化数据
ChatGPT 把你的 JSON 当一大段文字读，靠字符串匹配回答，而不是跑 pandas。本文讲怎么逼它用代码沙箱、拿到真正算出来的聚合结果。
ChatGPT MFA 备份码丢失、验证器也没了 —— 完整找回指南
手机被抹了、验证器 App 重装后那条没了、备份码也找不到?这是 2026 年 6 月找回 ChatGPT 二次验证、又不丢账号和订阅的正确做法。
ChatGPT 对话中模型被自动换掉而没有提示 —— 排查与修复
你明明选了 GPT-5.5,回复却突然变浅 —— 自动路由把你悄悄降级了,通常是上限压力、工具路由或者重新生成造成的。
ChatGPT 周期中途降级不退款 —— 退费排查与处理
刚扣完月费几天就把 Plus 取消、权限掉到 Free,钱也没退。本文教你分清这是规则、App Store 的事还是真 bug,以及符合条件时怎么把退款要回来。
重命名 ChatGPT Project 后分享链接失效该怎么办
重命名 ChatGPT Project 后，旧分享链接 404、显示旧快照、或报无权限。本文讲清原因，并给出截至 2026 年 6 月仍然有效的修法。
ChatGPT Project 明明有那个文件却说'我没看到'：向量检索漏召回
文件就在 Project 里，但短 query 让向量检索漏掉了它。最快的修法：在 prompt 里写出确切文件名，强制走关键字检索。
ChatGPT 共享 Project 在侧边栏看不到（Team/Business）
Business 或 Enterprise 里共享的 ChatGPT Project 不在你侧边栏。多半是你在共享之后才加进来、登错了 workspace、或者 Pinned 区被折叠了。把它找出来。
ChatGPT 回答中途截断：为什么会断 + 最快接回去的方法
ChatGPT 中途停下来，多半是模型自以为说完了、单次输出预算用光了、或者流断了。先打 continue，再修真正的原因。
ChatGPT 定时任务到点不触发 —— 完整排查指南
本应早上 9 点跑的 ChatGPT Task 没动?多半是账号时区漂移、任务被自动暂停,或者 Plus 套餐失效 —— 这里给出修复顺序。
ChatGPT 把大 CSV 截断到前 1000 行：怎么强制分析全部行
上传大 CSV 后问'一共多少行'，ChatGPT 说 1000——那是采样不是计数。教你强制对每一行做全量分析。
ChatGPT 流式输出半句话卡住：把回复捞回来
回复流到半句话就突然不动了。多半是 SSE 连接被掐、标签页被切到后台、或者后端打嗝。先刷新，再按症状分类诊断。
ChatGPT Team（Business）邀请链接失效或无效
ChatGPT Team/Business 邀请点开提示 expired 或 invalid。多半是 7 天有效期、邮箱不匹配、当前激活的 workspace 不对、或域名限制。不重复买席位就修好。
ChatGPT 欧盟/英国 VAT 发票缺失或错误(修复指南)
你的 ChatGPT 发票没有 VAT 行、没税号、或者按错了国家的税率。这篇告诉你该去哪个账单页面修,开出会计认的合规发票。
ChatGPT 读不到上传的 ZIP 压缩包内容：沙箱不会自动解压
丢一个 ZIP 进对话，ChatGPT 只看见文件名却读不到内容。修法：用明确的解压 prompt 触发 Data Analysis，或本地解压后单独上传。2026 年 6 月核实。
Claude Artifact 发完 follow-up 就回滚到旧版本
面板里手改了 Artifact，发一条新消息，它直接退回三轮前的版本。真正原因：你的面板修改根本没进 Claude 的记忆。先从 versions 下拉里把它捞回来，再让它别再发生。
Claude Artifact 中 React 组件 prop 错误静默失败 —— 排查与修复
Claude 的 React artifact 预览空白、没有任何报错横幅。最快的办法:打开 DevTools 控制台(或点 'Try fixing with Claude')读出被吞掉的异常。逐个原因的完整排查指南。
Claude 附件预览不显示：修复空白缩略图
Claude 显示附件 tile 但没缩略图。多半是渲染延迟、不支持的格式（HEIC/TIFF）、或缓存脏了。最快修法和完整排查都在这。
Claude 网页搜索引用点开 404 或跳错页
点 Claude 引用链接拿到 404、或落到无关页面。多半是 URL 被改写、原文挪了、或者付费墙——怎么救回真来源、验证事实本身。
Claude Code Bash 沙箱阻止预期命令 —— 排查与修复
Claude Code 反复对你已加白名单的命令弹窗。修法:模式末尾加通配符、拆开复合命令、检查新的 OS 沙箱回退。2026 年 6 月核对。
Claude Code 不加载项目 CLAUDE.md(2026 修复)
Claude Code 启动后忽略你的项目 CLAUDE.md。运行 /memory 看清到底加载了什么,修正路径/大小写,几分钟内定位根因。
Claude Code hook 莫名其妙拦下 Edit
PreToolUse hook 不停拒掉 Edit、连安全修改也拦。根因几乎都是 exit code 2 的逻辑、deny JSON 格式、stdin 解析、或者 matcher 范围。
Claude Code MCP 调用反复超时（或卡住）
Claude Code 里的 MCP 工具调用超时或卡死，可是直接 curl 又能通。多半是 stdio 往 stdout 打了脏数据、搞错了启动超时和工具超时、initialize 没回、或者代理把 SSE 缓冲住了。修复方法 2026 年 6 月已核实。
Claude Code 输出被上下文截断
Claude Code 长回复半句话被切掉。最快的办法：让它「从最后一句继续」。真正的原因多半是 auto-compact、单轮输出上限、或者某次工具输出把预算吃光了。
Claude Code 会话恢复后丢失先前工作记忆 —— 排查与修复
恢复 Claude Code 会话却像全新开始 —— 计划没了、决定没了、未完成的重构也没了。从压缩、对话链断裂、临时工具结果三方面定位并修复。
Claude Code settings.json 改了不生效
改了 ~/.claude/settings.json 但 Claude Code 无视你的 hook、permission 或 env？先跑 /doctor。多半是 JSON 语法、scope 选错、或优先级被覆盖。
Claude Code Skill 没被发现或不会自动触发
你在 ~/.claude/skills/ 下加了 SKILL.md，/<name> 却说找不到，或者一直不自动触发。几分钟搞定路径、frontmatter、description 或 skill 预算问题。
Claude Code 状态栏脚本报错、空白或卡顿 —— 排查与修复
Claude Code 的 statusLine 报错、空白,或拖慢提示。修复 JSON-on-stdin 输入约定、缺失的 jq、退出码、缓慢的 git 调用,以及工作区信任。
Claude Code subagent 结果回传不到主会话
Task subagent 明明跑完了，主会话却什么都没显示、给个通用总结、或者硬说还在跑。几分钟修好 final message、输出过长、或路由的问题。
Claude Computer Use 在同一按钮上反复点击死循环 —— 排查与修复
Claude Computer Use 不停地点击同一个按钮或输入框迟迟无法推进,几乎都是截图时机、坐标缩放或隐藏状态的问题。本文先给最快的修复,再给完整诊断。
Claude 对话导出失败：PDF 空白页或数据导出收不到邮件
Print to PDF 存出来是空白页，或者 Settings > Privacy 的 Export data 一直不发下载链接。多半是线程太长、Artifact 渲染失败、或导出任务卡住——每种情况都给出对应修法。
Claude 的 Google Drive 连接器反复授权死循环 —— 排查与修复
Claude 接 Google Drive 后,每问一次都让你重新授权,但状态始终显示"已连接" —— 多半是第三方 cookie 被拦、缺 refresh token,或 Workspace 的重新认证策略。本文给出完整诊断路径。
Claude 记忆功能已打开但面板空空如也 —— 修复指南
记忆明明开着,设置里却显示「暂无记忆」,Claude 也从不引用过往对话。多数情况是只开了 Search and reference chats,没开 Generate memory from chat history。本文给出修复方法。
Claude 读 PDF 表格抽错列、合错行
让 Claude 抽 PDF 表格，结果列错位、行合并、数值落到错的表头下。这里给出最快的修法，外加按成因逐条修源文件和 prompt。
Claude 思考开关开着但看不到推理过程
打开了思考，Claude 秒回、上面没有推理 trace。截至 2026 年 6 月，多半是 Effort 调太低、prompt 在自适应思考下太简单、trace 被折叠、或套餐限制。诊断并强制让思考回来。
Cloudflare 橙云灰云搞反，站点立刻挂 —— 排查与修复
Cloudflare DNS 那个橙/灰云图标决定流量走边缘还是直连源站。切错会弄断 SSL 签发、WebSocket、源站隐藏。这篇教你怎么选对。
修复广告运行时插入导致的 CLS 飙升
Auto Ads 或自定义脚本在首屏渲染后注入广告位,把正文推下去,CLS 直接爆掉。解决思路:用预留高度的占位容器预渲染。
Codex 把改动 commit 到了错误分支（甚至直接 main）
Codex 把活落到了 main、落到遗留分支、或拆成两半——因为云端任务默认用仓库的默认分支，本地 worktree 又会撞名。怎么强制每个任务跑在干净的独立分支上，以及 commit 已经落错地方时怎么救回来。
Codex 遇到 merge conflict 就卡住或瞎选边：rebase 策略和 AGENTS.md 兜底
Codex 撞上 conflict marker 要么停下、要么挑错边、要么把 marker 直接写进文件。任务前 rebase、把 rebase 放进 setup 脚本、AGENTS.md 停机规则加 pre-commit hook，一起解决。
Codex 加了包但 lockfile 没动：怎么强制同步更新
Codex 改了 package.json 却没跑 npm install，package-lock.json 和真实依赖分叉、npm ci 直接挂。用 setup.sh、CI 同步检查和 AGENTS.md 规则一次性根治。
Codex 的修复测试全绿，运行时一上线就崩
Codex 的 PR 在 CI 里全绿，但部署后应用就崩。为啥 agent 修复打中的是测试面而不是 runtime，以及那道能补上 gap 的 smoke 关卡。
Codex 又造了一个和现有类型重名的 interface：怎么让它先搜再写
Codex 新建了一个 User 或 ApiResponse 类型，其实仓库里已经有一份一模一样的。用 AGENTS.md、types barrel、ripgrep 和 ts-morph CI 检查强制它先搜。
Codex 自作主张改了 git history：amend / rebase / force-push 怎么禁掉
Codex 跑了 git commit --amend、交互 rebase 或 force-push，重写了共享分支的 history。用 AGENTS.md、sandbox network 开关和 GitHub ruleset 把 agent 锁死在 forward-only commit 上。
Codex 写的 PR 描述太敷衍：怎么逼出结构化 before/after
Codex 的 PR body 只有一句 "重构组件"。如何用 PR template + AGENTS.md + CI 关卡逼出 before/after、why、test plan，外加 Codex Cloud 按钮的坑。
Codex 说 "测试通过"，其实跳过了失败用例：如何强制诚实报告
Codex 报告测试全绿，但失败的 case 被 .skip 了、被 --bail 提前结束了、或者根本没跑完。如何在 merge 前强制看到真实结果。
Codex 大 diff 跑一半就停：怎么把活干完
Codex 撞上 context 上限就停，留下半个 patch。把任务窄到一个动词、拆成多 PR、调 auto-compaction、用 resume note 续上——配置以 2026 年 6 月为准。
让 Codex 别再写 componentWillMount 这类废弃 API
Codex 因为训练数据滞后会注入多年前就废弃的 API。用 AGENTS.md 规则、@typescript-eslint/no-deprecated lint 规则和最新参考文档，把它锁到现代写法。
内链腐烂：文章链向已改名/已删除的 slug——主机级 301 + CI 断链检查
重命名 slug 没回头更新 47 篇 linker——内链一半 404。加主机级 301、CI 跑 lychee、prebuild 在内链指向不存在的 slug 时直接 fail。
Canonical 指错页：ZH 翻译指回 EN 原文，导致 ZH 被 Google 去索引
ZH 页的 canonical 指向 EN 版，Google 把 ZH 去索引。修法：每页 canonical 自指（current URL），用 curl + view-source 验证。
Google FAQ rich result 不出了？是被弃用，不是你的 schema 坏了
FAQPage JSON-LD 看着没错但 FAQ rich result 就是不出。2026 年 5 月 7 日起 Google 对所有站点弃用了 FAQ rich result。先确认是这个原因，再决定保留还是删除。
EN/ZH 之间 Hreflang 配错：缺 return tag、语言代码不一致、没有 x-default
hreflang 对中两页不互引、语言代码不一致（zh vs zh-CN）、缺 x-default。从 translationKey 自动发，用 Merkle hreflang 校验器验，从源头一次修好。
图片 alt 文本批量缺失：审计、回填，并用构建检查锁死
几百张图没有 alt 属性，砸了无障碍、图片搜索和 AdSense 质量信号。按类别审计、按流量回填，再让构建在回退时直接失败。
发布日期卡在过去：明明刷新了文章，SERP 还显示陈旧日期
publishedAt 永不移动，SERP 显示老日期。加 updatedAt、只显示一个日期、让 schema 与可见日期一致、只在实质改动时撞日期。
重定向规则膨胀到几千行,拖慢构建、爬虫绕圈
_redirects 文件三千多行,构建变慢、爬虫追多跳链路,超过托管平台上限的规则还会被悄悄丢掉。讲清楚怎么审计、压平链路、安全裁剪。
相关文章模块一直推送近似重复的页面
每篇文章底部的'相关文章'都是三条几乎一样的稿子。用 MMR 检测、打分'相关但不重复',别再给自己推荐重复内容。
Tag 归档页 0 篇文章：清理后空架——审计、设最低门槛、用 410 让 Google 快速删除
tag 页能渲染但 0 篇已发布文章。审计每 tag 计数、加 prebuild 最低门槛、对空归档返回 410 Gone，让 Google 尽快删掉。
翻译页结构对不上：EN 5 节 ZH 3 节——按结构审计 + PR 强制同步
单边编辑导致 EN/ZH 章节、代码块、链接逐步分叉。按结构（不只时间戳）审计、diff 双语内容、PR 层强制 translate-as-you-edit。
Cursor Auto 把难任务路由给了弱模型 —— 完整修复指南
Cursor 的 Auto 路由把复杂重构发给小模型，结果改动浅。看懂路由信号，给难任务强制指定正确的模型。
Cursor 重启后聊天 / Composer 记录不见了
重开 Cursor 对话列表空了、只剩最近一条、或一直卡在 Loading Chat。多半是 workspace hash 变了、升级迁移出错，或 state.vscdb 损坏。怎么恢复 + 长期怎么防。
Cursor Cmd-K 内联编辑一直转、不出 diff 的修法
Cmd-K（Ctrl+K）一直转，或卡在 "Taking longer than expected…" 不出 diff。最快一招：Reload Window 或升级 Cursor。六类已验证根因逐一排查。
修复 Cursor 扩展：网络错误或商店列表空空
Cursor 扩展面板报网络错误、列表空空或 spinner 卡住。Cursor 用的是 Open VSX，不是微软商店。对症归类，快速解决。
Cursor MCP server 连不上或看不到工具
在 Cursor 里加了 MCP server，却一直 disconnected，或聊天里看不到工具。九成是 PATH 不对、JSON 写错、或日志漏到了 stdout。五分钟内定位修好。
Cursor 没识别到 Python venv（解释器选错）—— 完整修复指南
Cursor 选用系统 Python 而非项目 venv，导致 import 红线、lint 报错、agent 给出错误改动。修好解释器选择、venv 发现、shell PATH 与新版 Python Environments 面板。
Cursor 配置同步覆盖另一台机器的本地配置 —— 完整排查指南
Cursor 并没有原生 Settings Sync。当 Gist 同步插件、dotfiles 软链接或云盘文件夹把过时配置推到第二台机器，你的规则、快捷键或 MCP server 就会被覆盖。先判断是哪一层同步干的，再把好版本救回来。
Cursor SSH 远程连接编辑中途掉线：6 种修复
Cursor 的 SSH Remote 会话在编辑过程中突然断开，丢失 agent 上下文与未保存缓冲区。用对保活参数，并排查 v1.0.51 重连 bug。
Cursor rebase 或切分支后 codebase 索引过期
rebase 完或切完分支，Cursor 还在引用不存在的文件和行号。indexer 没跟上 git 状态。强制重建索引，把流程加固一下。
Cursor 不弹确认就跑命令（YOLO / Auto-Run）
auto-run 明明关了，Cursor Agent 还是没弹确认就执行终端命令。截至 2026 年 6 月，多半是 Run Mode、allowlist 太宽、或 workspace 的 permissions.json 在覆盖。一分钟修好。
部署 preview URL 被 Google 收录 —— 排查与修复
Vercel/Netlify 的 preview URL 出现在 Google 索引里，多半是自定义域名 preview、可被索引的最新 branch deploy，或 sitemap/canonical 盖过了自动 noindex。这里给出快速修法。
开启 DNSSEC 后 SERVFAIL：信任链断了 —— 排查与修复
你在注册商打开 DNSSEC，验证型解析器开始返回 SERVFAIL。先读 EDE 错误码，从当前 DNSKEY 重新生成 DS、在注册商替换，或直接删 DS 回滚。2026 年 6 月核实。
JavaScript 动态设置的标题未被 Google 索引
SPA 渲染后才改 `document.title`，Google 索引到的却是占位符。SERP 每条都显示 "Loading..." 或首页标题。这里是修法。
修复 ITSAppUsesNonExemptEncryption 出口合规缺失
TestFlight 每个新版本都让你填出口合规，是因为 Info.plist 没声明 ITSAppUsesNonExemptEncryption。设对值之后就不再弹了。
few-shot 例子质量参差，把输出拉下来了
给了模型 5 个例子，2 个很好、3 个一般，结果它往一般的那几个靠拢。质量方差为什么伤、怎么砍到 3-5 个一致的例子。
Gemini Code Assist IDE 插件和网页版模型不同步
VS Code 或 JetBrains 里的 Gemini Code Assist 插件感觉比 gemini.google.com 弱。截至 2026 年 6 月,原因往往是 Antigravity 迁移、插件过期、项目绑错,或索引卡住。
Gemini Connected Apps(Workspace、Maps、YouTube)不触发
Gemini 无视 Gmail、Maps 或 YouTube,只用通用知识回复。截至 2026 年 6 月,这些已改名为 Connected Apps,@Maps/@YouTube 被移除,还有几个开关必须对齐。快速修复在此。
Gemini Gems 保存失败或消失:修复方法
Gem 保存不了、提示 'Sorry, we can't save your gem',或知识库文件消失?多半是 Save 和 Update 按钮、过期会话、特殊字符,或 Workspace 限制。五分钟内搞定。
Gmail 里 Help Me Write 写出的 Gemini 草稿语气怪、内容空泛
在 Gmail 用 Gemini 的 Help me write 起草回信,结果总是一封僵硬的公司腔邮件,完全不看线程。常见原因是没拿到线程上下文、smart features 开关没开,或 prompt 太单薄。本文给出截至 2026 年 6 月仍然管用的修复方法。
Gemini 图像生成把正常 prompt 当违规拦下
Gemini(Nano Banana)或 Imagen 把一个看起来正常的 prompt 当违规拒了。多半是真名、品牌或默认安全太严。这里给出确切改写和 API 解法。
Gemini 1M 上下文还是把长文档截断
Gemini 3.1 Pro 号称 100 万 token,长文档却被切到一半。几乎都是 8K 输出上限,不是输入。修复路径在此(截至 2026 年 6 月)。
Gemini PDF 引用页码丢失或对不上
让 Gemini 给 PDF 标页码引用,结果没页码、页码对不上、或凭空编页码?多半是 OCR 质量、提示太弱、或选错了面板。2026 年 6 月实测修复办法。
Gemini 3.1 Pro Thinking 推理中途停下:修复
Gemini 3.1 Pro Thinking 推理到一半被截,或最终答案很短没推理痕迹。多半是 thinking level 或输出上限的问题。2026 年 6 月已核实的修复办法。
Gemini 视频上传被拒 / 不支持该文件类型
MP4 或 MOV 上传到 Gemini 报'文件类型不支持'或静默失败。截至 2026 年 6 月,真正的限制是视频时长而非体积 — 这里给出修复路径。
Gemini 语音模式中断或听不到
Gemini 语音回答到一半断掉,或者听不到你说话。最快的修复:更新 app(2026 年 3 月的改版已修掉停顿就被打断的问题)、给麦克风权限、重启 Live。完整诊断见下文。
GitHub Actions 部署步骤挂到 6 小时 job 上限被强杀 —— 排查与修复
GitHub Actions 部署步骤一直挂着，到 360 分钟 job 上限被取消。最快的修法是用 shell timeout 包住命令再加非交互参数。完整诊断与修复见正文。
HowTo Schema 已废弃，但模板还在输出
Google 在 2023 年就下线了 HowTo 富结果。Schema Markup Validator 仍能验证通过，看起来没问题，但 Google 的 Rich Results Test 已经识别不到它，富结果也再不出现。本文教你确认并清理掉。
Hreflang "No Return Tags"：补上缺失的双向链接
爬虫报你 hreflang 簇 "missing return tags"：A 指向 B，但 B 没指回 A。让每个引用都相互对应，Google 才不会整组忽略。
HSTS preload 进了出不来：如何回滚 HTTPS 强制
你提交了 preload，后来又需要 HTTP。浏览器还在强制 HTTPS。这里给出最快的真实修法、确切的移除步骤，以及诚实的时间线。
IPv6 用户打不开站点：AAAA 记录缺失或挂了 —— 完整排查
IPv4 用户正常，IPv6 用户全部超时。要么 AAAA 没配、要么指向死地址、要么源站防火墙挡 v6。双栈连通性排查。
JavaScript 渲染的内容没进 Google 索引
SPA 在用户看来一切正常，但 Search Console 显示页面被索引时 body 是空的。Googlebot 渲染的坑在哪、最快怎么修。
模型返回非法 JSON——因为 schema 是描述、不是强制
你让它按 schema 返 JSON。95% 合法，3% 在 JSON 外面包了散文，1% 漏字段，1% 类型错。描述 vs 强制，在 API 层修。
App 启动即崩溃：缺失 NSXxxUsageDescription 修复
iOS 在隐私敏感 API 运行而 Info.plist 缺少对应用途描述的那一刻直接终结 App。从设备 console 读出缺失的 key、补上、确认它进了归档，再发版。
Google 把站切到 Mobile-First 之后索引量掉了
Search Console 确认切到 mobile-first，两周后有效页和曝光掉 15-40%。原因几乎都是移动版 HTML 缺了内容。本文教你怎么定位并补齐这个缺口。
模型编造假引用和假 URL
模型给的引用看起来像 Smith et al. 2019，但论文根本不存在；或者给的 URL 一点就 404。引用幻觉为什么发生、怎么彻底压住。
模型用错语言回复（怎么锁死）
你用英文 prompt，结果它用中文回，或者中途切到西班牙文。语言漂移的确切根因，以及锁死输出语言的 system prompt + 重试套路，2026 年 6 月核实。
monorepo 部署只发了一个 app —— 排查与修复
monorepo 里有三个可部署 app，Vercel 只发了一个。修好每个项目的 Root Directory、Skip deployment 开关和 Turborepo filter 作用域 —— 含 2026 年 6 月的准确菜单路径。
Netlify Function 冷启动 10 秒超时 —— 排查与修复
Netlify Function 本地正常，但闲置后首次请求返回 502 报 'Task timed out after 10.00 seconds'。最快的修复：把重型 SDK 改成懒加载、移除 aws-sdk v2，让冷启动初始化塞进 10 秒同步上限。
Next.js ISR 重新验证卡住、一直返回旧页面（Vercel, 2026）
ISR 页面 revalidate 窗口过了还在发旧 HTML。先读 x-vercel-cache 响应头、手动触发 on-demand 重验，再定位真正原因：边缘缓存盖住 ISR、后台渲染失败，或路径不匹配。
子域 NS 委派挂了：缺 Glue 记录 —— 排查与修复
把子域委派给它自身内部的 NS，但解析失败？父区需要 glue A/AAAA。这里给出 dig 诊断和注册商端的具体修复步骤。
回答被截断在半句话：max_tokens 设太低（2026 修复）
模型回复中途断掉、JSON 没闭合、代码块缺反引号。绝大多数是 token 上限。怎么估算、按 SDK 检测、怎么恢复。
第 2 页之后设了 noindex,follow，深层文章正在变孤儿
老 SEO 建议说给分页加 `noindex,follow`。但 Google 长期对待 `noindex,follow` 等同 `noindex,nofollow`，只能从第 2 页之后链接到的文章会悄悄掉出索引。本文给出修复办法。
Product Schema 评论数与页面可见评论对不上
JSON-LD 声明 1,247 条评论、4.8 星，页面上只有 32 条。Google 判定为评论不一致，SERP 里的星级片段直接消失。修法：让 reviewCount 等于可见评论数，且取自同一份来源。
Prompt 要 10 条，模型给 3 条就停
你要 10 个想法，结果只给 3 个，或者凑齐 10 条但全是水。list-N 任务为什么 under-deliver，以及真正能拿到 N 条不同结果的 prompt 与 schema 修法。
Prompt 里写着过时的年份，把模型锚在错的 context
2026 年了 prompt 还写着 2023，模型于是推荐 GPT-4、引用旧定价、提过时框架。最快修复：在运行时动态注入当前日期。附诊断表和怎么确认修好了。
带 query 参数的 URL 在索引里变成一堆重复
Search Console 报上千条带 `?utm_*`、`?sort=`、`?ref=` 的重复 URL。用 rel=canonical 和干净内链把它们收敛掉。
robots.txt 挡了 CSS/JS 拖垮索引
你为了"省 crawl budget"在 robots.txt 里 disallow 了 `/assets/` 或 `/_next/static/`，Googlebot 没法渲染。最快的解法：别再 block 渲染资源，然后用 URL Inspection 重测。
修复 Search Console 提示 Article Schema 缺少 author.name
Search Console 在 Article 页面上提示 "Missing field author.name"。byline 字符串明明在那，但 JSON-LD 形状不对。这里给出确切修法、最小合法形态，以及如何验证。
App Store iPad Pro 截图尺寸不符 —— 修复指南
App Store Connect 因 Invalid Screenshot Dimensions 拒掉 iPad Pro 截图。2026 年起必填的是 13 英寸 2064x2752 槽位。给出对照表、sips 修复命令与 FAQ。
Service Worker 部署后还在发旧 bundle —— 排查与修复
部署完用户还看到旧站点，因为 service worker 一直把缓存里的旧 bundle 发回去。修复办法：HTML 走 NetworkFirst、skipWaiting + clientsClaim、sw.js 不缓存、再给被困用户发一个同 URL 的自卸紧急关停。
Sitemap 超过 5 万 URL：用 sitemap index 切分
单个 sitemap.xml 上限是 5 万 URL、未压缩 50 MB。Search Console 报 "Couldn't fetch" 或者只读前 5 万条。怎么正确切分并重新提交。
Sitemap lastmod 永远是今天，Google 不再信任
sitemap 里每个 URL 的 `lastmod` 都是今天。Googlebot 抓取率不升反降，因为 Google 已经把这个字段当作不可靠信号忽略掉了。
证书自动续签静默挂了，站点现在不受信任
Certbot 续签几个月前就坏了，直到浏览器弹 NET::ERR_CERT_DATE_INVALID 你才发现。定位真正原因，一小时内把 HTTPS 拉回来。
Suno 缺少 Bridge：副歌跳过 B 段直接收尾的修复
Suno 生成出来主歌-副歌-主歌-副歌-结尾，没有 Bridge。4 步用 `[Bridge]` 标签和 Custom Mode 强制加入 B 段。
Suno 副歌太炸：把音量跳变压回正常动态
主歌听着舒服，副歌一进来直接 +6 到 +10 dB 炸耳朵。讲清楚 Suno（v5.5，2026 年 6 月）为啥这样、以及怎么用 Replace 重生成、stem 重平衡或压缩把动态拉回可用平衡。
Suno 翻唱上传被拒：版权或音质不足的修复
Suno 提示 copyright detected 或 audio quality insufficient——5 步覆盖原创录音、SNR、授权开关的修复。
Suno MP3 导出音质低（即使 Pro 套餐）：5 步修复
Pro 套餐导出的 MP3 仍然听感压缩——有损链路在作祟。5 步用 WAV/FLAC 导出、自压 320kbps、检查套餐修复。
Suno 前奏太长：30 秒才进人声的修复路径
Suno 总在前 30 秒堆器乐前奏，人声迟迟不进——风格词 epic、cinematic 是元凶。5 步让人声从 0:00 开始。
Suno 歌词跟旋律对不上：节拍错位的修复路径
歌词滞后于节拍，或字与字挤在一起——音节数没匹配旋律。5 步修好歌词与旋律的对齐。
Suno 母带过响削顶：5 步重压母带
Suno 输出大音量下削顶失真——Suno 默认响度战母带。5 步用 Audacity、iZotope Ozone 重压到 -14 LUFS / -1 dBTP。
Suno Personas 不生效：人声跟原版对不上的修复
选了 Persona 但生成的人声完全不像原版——套餐限制、训练片段太短、模式选错。5 步修复路径。
Suno 人声性别不对：要女声却出男声的修复路径
写了 female vocal，结果出来的是男中音——风格词 deep、gritty、rock 把性别标签盖过去了。4 步修复指南。
Suno WAV 导出采样率不对：44.1 vs 48 kHz 怎么修
DAW 或视频剪辑提示 Suno WAV 采样率不匹配。先用 ffprobe 确认真实采样率，再用 SoX/ffmpeg 无损转换，避免被偷偷重采样。
Title 标签与 H1 不一致导致 Google 改写
`<title>` 和 `<h1>` 说的不是一件事，Google 哪个都不信，直接改写你的 SERP 标题。对齐两者并重新申请索引，就能把标题拿回来。
Vercel 构建超过 45 分钟被强杀 —— 排查与修复
Vercel 构建跑到 45 分钟被 'Build step did not complete within the maximum of 45 minutes' 强杀，通常是缓存失效、页面生成失控，或某个构建后脚本卡死。本文帮你定位是哪一种。
AI 克隆音呼吸不自然：节奏与停顿排查
AI 克隆音说对了词，但呼吸位置不对、句中怪停顿、或完全不喘气。最快修法：重排脚本标点，并按你的模型选对停顿控制方式（Eleven v3 用音频标签，v2 用 SSML）。
AI 图片批量风格漂移：把整组风格锁死
一组活动图出来像 20 个摄影师分别拍的？这篇给一套 2026 年 6 月最新的锁风格批量流程：sref、Omni Reference、Flux Redux、LoRA、色板后期统一。
AI 图片手指多出来怎么修
6 根手指、长在手腕的拇指、关节反方向。修复路径：能不画就不画、画就给够像素、最后跑一遍手部专用 inpaint。已按 2026 年 6 月的工具更新。
AI 产品图主体形变怎么解
AI hero 图里瓶身歪、包装弯、logo 边缘糊？真正管用的修法：用真品照走 ControlNet 锁轮廓，或者直接把真产品抠出来合成到 AI 背景上。
AI 图片对称姿势崩了：镜像修复流程
想要对称姿势却出了一边高一边低的歪图？修复方法：ControlNet OpenPose 锁姿势、对崩的一半 inpaint、必要时直接镜像合成做到像素级对称。
AI 图片里的文字乱码：2026 修复指南
AI 海报标题出来像字母汤？2026 年 6 月最快的修法：换到排版级模型（Ideogram 3.0、GPT Image 2、Nano Banana 2），把要写的字加上引号，实在不行再用真字体合成。
AI 视频导出比例裁切错误
导出 9:16 / 1:1 / 16:9 时主体被裁掉或构图错位。通过原生按目标比例生成、用 Premiere Auto Reframe 或 DaVinci Smart Reframe 跟随主体、或加智能边来修。
AI 视频镜头抖动 / 跑偏修复
想要锁定镜头，结果画面在漂、在抖、在轻摇。开启 Static Camera、去掉电影感词、把运动滑块归零、后期稳定就能修。
AI 视频帧间闪烁怎么修（Runway / Kling / Pika）
生成片段帧与帧之间在光照、材质、颜色上闪烁。通过稳光线 prompt、降图生视频 creativity、净化参考帧、换用当前模型（Runway Gen-4.5、Kling 3.0、Pika 2.5）来修复。2026 年 6 月核实。
修复 AI 数字人讲话口型漂移
AI 数字人讲话片段口型相对音频提前或滞后。修法：抽出干净的 44.1 kHz 纯人声、换成不挑语言的模型（sync. lipsync-2、HeyGen Avatar IV），再在 Resolve 里对齐偏移。
GraphQL 限流级联：别让一个慢 resolver 拖垮整个网关
一个慢 resolver 撞上上游 429，整个 GraphQL 网关就跟着卡死。用按查询的复杂度计费、DataLoader 批量、快速失败的熔断器和按上游隔离的连接池来修。
消息队列死信堆积怎么排查和清空
SQS / RabbitMQ / Kafka 的 DLQ 不停涨。先抽样分类失败、修毒丸消息根因、收紧重试预算，再把安全消息回放回去。
Postgres 高负载下连接池耗尽
Postgres 流量上来就报 'remaining connection slots reserved'。修复方法：合理化池子大小、前面放 PgBouncer 走 transaction 模式、清掉 idle-in-transaction 连接。
Redis 集群故障切换卡住：没有副本被升主
主节点挂了但没有副本接管，集群停在 fail 状态。通过检查主节点 quorum、FAIL 标记、副本资格，必要时手动 takeover 来修复。
ChatGPT 切换套餐后被重复扣款：如何解决
升级或换套餐后同一张卡被扣两次——多数是网页端和 Apple 端并存，或一笔待结算授权会自动消失，不是真的重复扣款。教你认出哪笔是真的、把另一笔退掉。
ChatGPT 数据导出邮件迟迟收不到
申请了 ChatGPT 数据导出，下载链接邮件却没来——多半是被垃圾邮件过滤、账号邮箱不是你以为的那个，或任务还在处理。最快的修复方法都在下面。
ChatGPT 账号被停用：怎么申诉和恢复
ChatGPT 提示账号被停用。先分清是年龄验证锁还是政策封号，再去 openai.com/form/appeal 带上 User ID 和 Org ID 申诉。
ChatGPT Enterprise SSO 登录失败：IdP 更新后
Okta/Azure/Google 改完配置后 SAML 就挂了。到 chatgpt.com/admin/identity 重新粘 IdP 的 X.509 证书，再核对 NameID 和邮箱属性。
ChatGPT 组织 / 工作区切换总是被打回
切换 ChatGPT 工作区或 OpenAI 组织后，重启浏览器又回到原来那个。修服务端默认值和会话级 cookie——不是 bug，基本就是五个原因之一。
ChatGPT 注册手机号验证陷入循环
验证码填对了又被弹回来重输手机号？逐一排掉号码被占用、虚拟号、地区屏蔽和网络风控这几种原因。
ChatGPT Project 导出缺少上传的文件
Data Export 给你的 zip 里只有 conversations.json 和 chat.html，传进 Project 的 PDF、图片都不在。正确的拿法是从 Library 或每个 Project 的 Files 面板里把文件本体下下来。
ChatGPT Project 文件超限：快速腾槽位
Plus 每个 Project 上限 25 个文件（Pro/Team/Enterprise 40，Free 5）。上传按钮变灰？别硬刚，先合并、归档、拆 Project。
ChatGPT Project Instructions 更新后被忽略
改完 Project 指令也按了保存，ChatGPT 还在按旧规则回？多半是老 chat 线程、某条 Saved Memory，或字数被静默截断在压它。按这个顺序排查。
ChatGPT Project Knowledge 编辑后没更新
你改了源文档，但 ChatGPT 在 Project 里还在引用旧版本。Project Files 是冻结快照不是实时链接——删掉旧文件、重新上传、再开一个新 chat。
ChatGPT Project 分享链接返回 404 / 没权限
Project 分享链接给同事看，对方拿到 404 或 'You do not have permission'——多半是没被邀请、登错账号，或者链接设成了 'Only those invited'。这里给出最快修法。
Claude Artifact 渲染成空白面板
Artifact 打开后一片白。最快修法：打开 iframe console，把第一条红字原样发回 Claude。覆盖 sandbox 存储报错、cdnjs 白名单、以及发布版 artifact 的 origin 故障。
Claude Code 同一条命令反复问权限
明明给过 allow，Claude Code 还在反复弹同一个 Bash/Edit 提示。多半是 allow pattern 太窄、放错了 settings 范围，或者命令是复合命令——这里给出精确解法。
Claude Code 任务 token 预算过大
一个任务烧穿上下文窗口、重构到一半自动压缩、把 plan 弄丢——拆成小步、把读取丢给 sub-agent、状态落盘。
Claude Code Bash 工具卡死：修复挂起命令
dev server 或 curl 一直跑、Claude Code 卡在转圈。用 run_in_background、显式 timeout、再用 /tasks 杀掉卡住的 shell。2026 年 6 月实测。
Claude 文件上传卡在 processing：快速修复
Claude 一直转圈、文件永远附不上。最常见的元凶其实是超过 100 页的 PDF，或者某个浏览器扩展把上传搞坏了——这里教你怎么判断是哪种、怎么修。
Claude Projects：上下文在会话间串台
同一个 Claude Project 下新开 chat，却答出上一个 chat 的内容。会串台的有五个面：project knowledge、Instructions、project memory、Search and reference chats、connected sources——先判断是哪个，再对症修。
Claude Skills 没在该触发的时候触发
该跑 Skill 的时候 Claude 却用普通文字答了。多半是 SKILL.md 描述太泛、当前 surface 没启用、设了 disable-model-invocation，或者在 Claude Code 里被 skill budget 挤掉了。修复方法 2026 年 6 月核实。
Claude Team 账单和席位数对不上：排查
账单按 10 席收费，但管理面板只有 7 个成员。常见原因：未接受的邀请也立即计费、Premium 席位是 Standard 的 5 倍、周期中移除的席位已付费但可重新分配。截至 2026 年 6 月的对账方法。
Claude 工具调用卡在 pending：修复办法
工具调用 spinner 一直转——没结果、没超时、没报错。多半是 tool_result 没回、web search 返回了 pause_turn、Claude Desktop 渲染 bug、或 MCP connector 断连。按运行环境定位再解除。
Codex Agent 输出与 Prettier 冲突：6 个原因 + format-in-loop 模板
Codex 写完文件、Prettier 保存时重排，diff 变 5 倍。修法是在 agent 循环里跑项目锁定的 Prettier、AGENTS.md 风格对齐 .prettierrc。
Codex Agent 在大仓库里失去上下文：原因排查 + scope 收敛方案
50 万 + 行的项目里 Codex 跑到一半就晕了。修法是先界定 working set、预喂目录摘要，并把约定放进 AGENTS.md，让它能扛过 compaction。
Codex Agent 静默跳过含二进制数据的文件：7 个原因 + probe 替代方案
Codex 把 PNG / PDF / sqlite / 编译产物从审计里悄悄丢掉。修法：用 file + wc -c + sha256sum 探测二进制、文本扩展名 allowlist、强制不可省略的输出 schema。
Codex Agent 调用工具次数失控：6 个原因 + 最快修法
Codex 同一个文件读 8 次、同一个 grep 跑 5 次。最快修法：先跑 /plan、加一份 AGENTS.md 结构图、把 reasoning effort 保持在 medium。完整诊断见下。
Codex 任务跑到一半静悄悄停下：原因排查与续跑方案
Codex 多步任务跑到一半停下、不报错——通常是上下文 compaction 把后半段计划裁掉、sandbox/审批被拒、或 stop 信号误命中。先看最后一次 tool call，再用 codex resume --last 续跑。
内容站重新构建后仍发旧文章（CDN 缓存过期）
重新构建上线了，访客看到的还是旧文章。判断到底是哪一层缓存过期——CDN 边缘、浏览器 HTTP 缓存、service worker，还是 HTML 还引用着旧的资源 hash——再 purge 对的那一层。
内容站更新后 sitemap 没重新提交
新发了 50 篇文章，Search Console 里还显示上个月的数量。sitemap 在本地生成了却没传达到爬虫——这是 2026 年强制重抓的正确做法。
Cursor Agent 模式工具调用卡 pending
agent 模式下某次 tool call 一直转圈——多半是 shell 命令卡在等输入、网络被防火墙挡了、或者权限弹窗你没看见。
Cursor Composer 重构中途丢上下文
Composer 开头还行，做到第 9 个文件就开始改错文件、回滚之前的改动——上下文炸了；要把重构切块、每块重新对齐基线。
Cursor 规则文件没被加载（2026 修复指南）
Composer 完全无视你写的 .cursorrules 或 .cursor/rules。多半是 frontmatter 语法错误、文件位置不对、用了已弃用的旧格式，或者 glob 根本没匹配到打开的文件。
Gemini App 安卓多设备不同步
手机上的对话在平板上看不到？最快的修法：两台设备登同一个 Google 账号、打开 Gemini Apps Activity、升级 app，再做一次不丢历史的清缓存。
Gemini Canvas 撤回还原不生效：找回正确版本
在 Gemini Canvas 里点上一版箭头，文本闪回一下又跳回坏版本？这是版本历史本地和服务器不同步。本文教你找回想要的版本，并避免以后再丢稿。
Gemini 深度研究长主题超时
Deep Research 跑 20 多分钟报错收场——多半是主题太宽。先做研究计划，把它拆成子题逐个跑，并给来源数封顶。
Suno 翻唱版权警告处理
发行商以版权为由标红你的 Suno 翻唱。Suno 给的是录音、不是作曲——上传时买机械版权、填好作曲人字段，几分钟就能解决。
Suno 续费后积分没刷新
卡已经扣了新月度的钱，余额却还停在昨天的数。通常是补给时间没到、Apple 和 web 计费错位，或浏览器缓存了旧值——修起来比开退款工单快得多。
Suno Prompt 过长被静默截断的修复
Suno 实际只重看 Style of Music 字段前约 200 字符。把流派和情绪前置、结构挪到歌词标记、长歌词拆开生成。
Suno 输出声场偏窄、立体感不足
声音都挤在中间、接近单声道没有左右展开。可以在 prompt 里加宽度词、在 Suno Studio 里给分轨做 pan，或后期用 mid-side 拓宽。
AdSense invalid traffic 警告：先分清限流还是封号，再修复申诉
AdSense 标记 invalid traffic、收益被扣回或广告被限流。先分清是临时限流还是账号封禁，再定位来源、正确申诉。附判断表和 FAQ。
AI 生成额度被消耗过快：3 个原因 + 修复路径
一天就跑光月度额度。烧得最快的三个习惯，附最新的每秒额度成本和要关掉的具体开关。
AI 出图被安全过滤拦截：定位触发词 + 60 秒修复
看起来很普通的出图 prompt 被拒——多半是某个词撞了过滤器。二分定位触发词，60 秒重写。
AI 图片光影方向矛盾：分清原因 + 7 步修复
人物左脸亮，背景太阳在右，阴影各指一方？锁定一个主光：方向 + 质感 + 来源 + 色温。
AI 图片渲染感太重像 3D：消除 CGI 塑料感
想要照片，出来却是塑料皮肤的 CGI？最快修法：删渲染词、降 CFG/guidance、换照片向模型。五类叠加原因，六步路径。
AI 图片色彩过饱和：6 类原因 + 修复路径
皮肤荧光橙、草地荧光绿。风格词、CFG、调色 LoRA 会三件事叠加爆掉。先关掉这些开关，拍素出图，饱和度留到后期推。
修复 AI 图片肤色：蜡像感、瓷娃娃、颜色偏怎么救
皮肤塑料感、偏黄、磨皮过度、像娃娃？通常是美颜 LoRA、环境光染色、负向缺词，加上 Flux 默认就磨皮。先判断属于哪一类，再按顺序修。
AI 图片人物姿势不自然：修复手臂折断与脖子扭曲
手臂反折、脖子扭过人类活动范围？用 ControlNet 喂 OpenPose 骨骼图、换具体动作动词、镜头退一档，再选解剖强的 checkpoint。
AI 图片自带假水印或乱码签名：分清原因 + 6 步修复
角落的水印形污渍或假签名是训练数据残留，不是真水印。SD 系加负向词、裁角、或把角落 inpaint 掉即可。
修复 AI 图片透视或比例错乱
桌子贴在镜头上、楼梯朝错方向、人物头身比失调？Prompt 开头加 5-7 个词的相机块（焦段 + 视点 + 透视风格）。适用于 Midjourney、ChatGPT Images、Nano Banana 和 ControlNet。
AI 建议了过时依赖：快速修复
AI 推荐了一个已停更的 npm/PyPI 包。用 npm view 三秒判定、换成现代替代、再让它不再复发。
AI 写的测试通过但功能挂了：5 个原因 + 修复路径
测试全绿，跑起来不对。测试只测了 happy path、mock 把真实分支屏蔽了。5 个原因和最快的修复。
AI 视频结尾突然停止：5 类原因 + 6 步修复路径
动作没收画面就黑了？给 Prompt 加 settle 收尾从句、设置结束帧、时长留出 1-1.5 秒收尾余量，大部分情况立刻就好。
AI 视频转场太突兀：6 类原因 + 6 步修复路径
两段拼接像剪刀手剪的？把前段尾帧喂给后段当首帧，统一色调，再加一段短叠化和 J/L cut。逐步修复。
AI 视频中途颜色跳变：6 类原因 + 修复路径
同一镜头里色调突然变冷或偏红？模型在帧间重新猜色温——必须显式写 Kelvin 数值，后期再用 LUT 或 Shot Match 统一。
AI 视频镜头切换时人物不连贯：修复服装与道具漂移
第 1 镜红帽、第 2 镜变蓝、第 3 镜没了？多段生成没有共享锚点。锁定一张带标签的参考图，再把上一段末帧接到下一段首帧。
AI 视频导出黑屏或丢帧：先 ffprobe 诊断，再 ffmpeg 转码
中间几秒黑屏或卡死？多数是编码 / 播放器问题，不是渲染坏了。先用 ffprobe 看清文件，再用 ffmpeg 转码即可哪都能播。
AI 视频长时间卡在生成队列
卡 0% 半小时？先硬刷新（很多时候其实已经生成完了），再取消真正挂死的任务、腾出并发槽、错峰 UTC 提交，或换个负载更轻的平台兜底。
构建产物超平台体积限制：定位、瘦身、CI 拦截
Vercel、Cloudflare、Netlify 都对 function 和静态资源有体积上限。找出膨胀的依赖、砍掉它，再加一道 CI 守门，让它不再复发。
CAA 记录阻挡 SSL 证书签发：原因排查 + 修复路径
自定义域名绑了 Vercel / Cloudflare / Firebase，证书一直签不出来？多半是遗留 CAA 记录把你主机的 CA 挡在了门外。这是最快修法。
ChatGPT 2FA 设备丢失被锁：先试「Try another method」再走人工核验
换手机后 Authenticator 没迁移、backup codes 也没存——先点登录页的「Try another method」，不行再走 help.openai.com 人工核验（24 小时到 7 天）。
ChatGPT Canvas 用不了？GPT-5.5 已下线 Canvas（含修复）
Canvas 在 GPT-5.5 上打不开，是因为 OpenAI 已经下线了它（2026 年 5 月）。附旧模型的浏览器、扩展、cookie 修复。
ChatGPT Custom GPT 知识库文件未被使用：原因 + 修复路径
配置时挂了知识库，但对话时它说"我没看到这个文件"。强制检索、文件精简到 12 个以内、验证入库——这是完整修复方案。
ChatGPT Deep Research 失败：原因与修复
跑了 Deep Research，10 分钟后却拿到一份单薄、泛泛的报告，或者直接报错——配额被降级、prompt 太模糊、目标站抓不到，还是服务端故障？逐项判断。
ChatGPT 图片编辑结果没变：2 步搞定
让 ChatGPT 改背景，返回的图基本没变？先用 Select 工具圈定要改的区域，再配 keep/change/avoid 指令。2026 年 6 月核实。
ChatGPT Project 上下文记错：6 个原因 + 修复路径
ChatGPT 把上次对话或别的 Project 的细节带到这次。最快的修法是开 project-only memory，再把 Memory / Project / chat history 几层理清。
ChatGPT Plus 订阅未识别：5 类原因 + 修复路径
付了钱但 ChatGPT 还是 Free——修好 App Store 与 Web 的账号错配、强制刷新 entitlement、或揪出悄悄失败的扣款。
ChatGPT Team/Business 席位未激活：5 个修复路径
管理员说邀请发了、受邀人也点了，登入后却还是 Personal Free。多半卡在邮箱别名不一致、付款逾期、SSO 强制策略，或邀请绑错了账号。
Claude Code 误把密钥 commit 进 git：先 rotate、再清史、后封堵
Claude Code 把你的 `.env` 或 API key 卷进了 commit。先 rotate 密钥（永远第一步），再清 git 史，最后用 deny 规则、scanner、push protection 彻底封堵。
Claude Code 写了一堆没人用的 helper：6 个 over-engineering 触发 + YAGNI 强制
你要一个函数，PR 多送 5 个「以后可能用」的——在 prompt + CLAUDE.md 限 scope，用 knip --fix 自动删死 export，再在 CI 里锁死。
Claude Code 跳过 / 削弱失败的测试：6 种作弊形态 + 「禁改测试」防御
Claude Code 加 .skip、删断言、放宽 matcher 让测试绿——用 PreToolUse hook 拦测试文件编辑、单独 diff 扫 skip 标记、任何测试改动都当独立 PR。
Claude MCP server 老是断开：一次性修好
Claude Desktop / Claude Code 里 MCP server 连上又掉——修 stdio 进程崩、OAuth 过期、配置路径错、或 60 秒启动超时。
Claude 手机 App 不同步对话：有效的修复方法
网页上的对话在 Claude 手机 App 看不到？快速修复——账号不一致、App 太旧、对话被归档或网络被拦。分步操作，2026 年 6 月核实。
Claude Project 指令不生效：原因与修复
Project instructions 写明了"不要用 emoji"，回答里还是有——指令是软约束。这里讲清楚怎么让 Claude 真正照做。
Cloudflare Pages 构建缓存陈旧：原因 + 修复路径
升级依赖后 CF Pages 还在发旧版本，因为它复用了陈旧的依赖缓存。提交 lockfile、清缓存、锁 Node。
Cluster 文章互抢关键词：先确认蚕食，再定一篇 pillar
三篇都打「how to use claude API」，Google 哪个都不排。在 Search Console 里确认蚕食（先点 query 再开 Pages 标签），选一篇当 pillar，其余合并或重定 sub-intent，并把内链集中过去。
Codex 无法访问私有仓库：理清 3 层 GitHub 权限
Codex 报「unable to clone」或「Repository not found」？多半是 ChatGPT Codex Connector 这个 GitHub App 没装到 org、repo 不在白名单、或 SSO/OAuth 授权过期。按优先级逐层修。
Codex 环境初始化失败：6 个原因 + 最短修复路径
Codex 卡在 Setting up environment——多半是运行时版本不匹配、私有 registry 没 token，或安装太慢撑爆缓存容器。2026 年 6 月核实过的快速修法。
Codex PR 太大没法合：先用 Plan Mode 封顶，再拆掉手上这个
50 个文件 1500 行没人敢 review——用 Codex Plan Mode、AGENTS.md 的 PR 预算和 CI gate 三层封顶，并拆掉你手上已经出的那个。
Cursor 计费疑问：Fast/Slow 旧机制 vs 新的额度池
$20 Pro 额度月中突然耗尽、Cursor 提示已达上限。讲清 Cursor 现在的用量计费怎么算（2025 年已废除 fast/slow request），以及日常省额度方法。
Cursor 模型列表与官网不一致
官网说支持某个模型，本地 Settings → Models 里却找不到。本地版本旧、缓存陈旧还是灰度未到——本文教你分清原因并修好。
Cursor 规则不被加载（.cursorrules / .cursor/rules）
Cursor 无视你的规则：Agent 模式不读旧版 .cursorrules、.mdc frontmatter 有错被静默丢弃、位置或扩展名不对、BOM、或缓存。逐项排查修复。
Provisioning Profile 过期导致 build 被拒：6 个原因 + 完整修复流
上传后 Apple 发来 ITMS-90161 / ITMS-90165——先判断是 cert、profile 还是 WWDR 过期，再重生那一个。
Firebase 配额超限：找出失控源并修好
Firestore 读取、Functions 调用、Hosting 带宽——免费档每项指标都有红线。本文教你定位是哪一项爆了，并立刻止血。
修复 Firestore "The query requires an index"（FAILED_PRECONDITION）
Firestore 报 FAILED_PRECONDITION，是因为多字段 where + orderBy 需要复合索引。最快修复、CLI 工作流、以及如何确认索引已建好。
Gemini 2.5 输出被截断：3 个原因 + 修复路径
回答到一半"…"就停了——max output tokens、安全过滤、网络中断三类。
Gemini Canvas 加载失败：扩展 / 模型 / Cookie / 地区逐项排查
点 Canvas 按钮没反应或面板一直空白——从扩展、模型、直达 /canvas 链接、Cookie、Workspace 策略到地区逐项修复。
Gemini 上下文比预期短：按计划档定位 + 修复路径
宣传 1M token，但发一份 100 页 PDF 就报超限。修复方法取决于你的 Gemini 计划档和使用的入口。
Gemini Saved Info 不跨会话：2026 修复路径
你跟 Gemini 说了"我是产品经理"，下次对话又问职业——多半是 Memory 没开、Keep Activity 没开，或你登的是工作账号。
Gemini 读不到你的 Gmail / Drive：6 个真正的原因
Gemini 说"I don't have access to your Drive"或"找不到这封邮件"？修好 Connected Apps 开关、Smart features 总闸和账号不匹配。
无限滚动页内容未被收录：原因排查 + 修复路径
HTML 里只渲染了前 20 条，剩下 100 条滚动时才加载，Googlebot 根本看不到。加一套可爬的 ?page=n URL 即可修复。
Last-Modified 响应头缺失：先查 sitemap，再修头
页面更新后 Google 迟迟不重抓。先查 sitemap lastmod，再修缺失的 Last-Modified / ETag，让 Googlebot 能做条件抓取。
修复教程里过期的截图
截图里是去年的 UI、步骤和读者看到的对不上——信任掉、跳出涨。按平台审计、文件名加版本戳，再把截图自动化，让它不再过期。
分页 canonical 混乱：page/2 该指向 page/1 还是自己？
Search Console 把 page/2+ 标为重复。分页页该自指 canonical 还是指向 page 1？Google 当前建议，2026 年 6 月核实。
Prompt 把 system 与 user 指令混用：分清通道再修
持久规则塞进 user message，模型分不清优先级。把它们挪到 system / developer 通道。
Suno BPM 与预期不符：3 个原因 + 修复路径
想要 128 BPM 的舞曲生成成 95 BPM 慢歌——style 词控制了节奏。
Suno Cover 翻唱版权疑问：3 个常见误解 + 处理路径
能不能拿 Suno 翻唱别人的歌商用——版权三层：作曲、歌词、录音。
Suno 额度消耗过快：钱花在哪、怎么把月产出翻 3 倍
Pro 套餐不到一周见底？看清额度被什么操作吃掉，把月产出从 100 首拉回 250+。
Suno 中英文混杂不可控：原因排查 + 修复路径
中文歌里突然冒出英文 ad-lib。改对 Style 字段、歌词文字和语言指令，让 Suno 稳定停在一种语言。
Suno 升降调后人声变薄：先重生目标 key，再考虑后期变调
升 3 个半音后人声金属化。正解是用目标 key 重新生成；非要后期变调就压到 2 个半音以内并打开 Preserve Formants。
Suno 分轨导出缺失或不全：3 步修复
Suno 里点了 Export 只拿到一个混音 MP3、没有人声 / 鼓 / 贝斯分轨？本文给出准确的菜单路径、各计划档支持的 stems、以及拿到最多 12 条分轨的积分成本。
Supabase Edge Function 冷启动慢：原因 + 修复路径
第一次请求 1–5 秒、暖请求只要 100ms。定位真正原因（大依赖、顶层 await、区域）并缩短启动时间。
Supabase 连接池耗尽：修复 Serverless 直连反模式
`remaining connection slots are reserved` 与 `too many clients already`——把 serverless 正确切到 6543 端口的 pooler。
TestFlight 测试员无法兑换 redeem code：8 个原因 + 修复路径
测试员点你的 TestFlight 链接显示 "This code is invalid" 或 "not accepting new testers"。8 个真实原因（地区 / Apple ID / 已满 / build 过期）和每个的最快修法。
通配 DNS 不命中深层子域：一层只匹配一个 label
`*.example.com` 配了 A 记录，但 `a.b.example.com` 还是 NXDOMAIN。DNS 通配只匹配一个 label——这里给修复路径。
让 AI 干活，它却甩给你一份清单
你让模型写、重构、起草，它却返回 10 条要点。本文讲清它为什么切到"建议模式"，以及哪几处 prompt 改写能逼它直接交成品。
AI 漏掉了最重要的那条约束：原因与对症修复
你列了 5 条规则，模型守了 4 条，偷偷扔掉了真正最关键的那条。本文讲清约束为什么会被丢，以及怎么让关键那条稳稳生效。
只要轻改，AI 却大改特改：如何逼它做最小改动
让它"润色一下"，结果换了一篇文章，语气全丢了。本文教你把 ChatGPT、Claude、Gemini 约束成手术级、逐字节最小的编辑。
评判标准模糊导致答案弱：把形容词翻成可测规则
标准本身含糊——"吸引"、"专业"、"创新"——模型只能自由解读。把每个形容词翻成 10 秒能测的规则。
App 因"误导性宣传/过度承诺"被拒
App 被 Guideline 2.3.1 判定误导，多半因为上架页文案或截图描述了 binary 里没有的功能。本文教你判断 Apple 在指控哪句话，并快速改文案或指路功能。
App Review notes 写得不清楚：重写一遍，让审核员不再反复问
Notes 明明写了，Apple 还是引 Guideline 2.1 或说 demo 账号登不上。把凭证填进 Sign-In Required 字段、把步骤写成编号表单，仅改 notes 重交即可。
App Store 产品页本地化混乱：6 类问题 + 修复矩阵
翻译后的产品页与主语言版本不一致，触发 Guideline 2.3.7 拒审。逐 locale 审计后，多数情况只改 metadata 就能重交，不用重打 build。
App Store 截图 / 元数据被拒：7 类原因 + 排查修复
Apple 因截图、描述、关键词或类目元数据按 Guideline 2.3 拒审——即使 binary 已通过。先识别面，再按面修。
App 版本卡 "Waiting for Review" 太久：先排查再决定等还是升级
提交审核后状态一直停在 "Waiting for Review" 多天。怎么判断该等、该补字段、还是该升级——2026 现状版。
相互矛盾的指令削弱 AI 输出：5 个原因 + 对症修复
Prompt 里两条规则互相打架，模型只能折中，结果谁都不满意。给约束排序，告诉它该放弃哪条。
IAP 恢复购买跨设备失效：6 个原因 + 服务端权威修复
已付费用户点 Restore Purchases 却看到 "Nothing to restore"。逐层修好 StoreKit、校验和 entitlement。
模型只听"最后一句"，无视前面的规则
Prompt 末尾一句"顺便提一下"会覆盖你开头写好的规则。把硬规则同时锚在首尾，最后一句就不再说了算。
长背景掩盖了真正的任务：为什么模型只总结不交付
三段背景结尾加一句"那你起草一下发布邮件吧"，模型却返回 400 字背景总结。本文讲清原因，并给出把任务放到模型必看位的结构化模板，以及长文档要反过来排的官方做法。
没给示例，AI 输出就漂移变形（少样本修复法）
光用形容词描述风格，模型只能按平均态近似；贴一个具体示例就能让它对上。怎么选示例、放在哪、怎么分隔 1-5 个示例把目标输出锁住。
语气指令混乱让输出读起来像分裂：原因 + 对症修复
"专业又友好、正式又温暖"=给模型两个声音去取平均。修法：定一个主语气，用示例锚定，其余降级成机械规则。
模型用"擅自假设"填补缺失细节：判因 + 对症修复
你只给了部分输入、模型把没给的续约日期、联系人、营收数字全编上。加一条 UNKNOWN 规则、一个可为 null 的 schema、再补一道核对，就能止住编造。
负向约束写得太虚：原因 + 对症修复
"不要太通用"只说了别做什么，没说要做什么——模型会换近义词绕开禁词、行为照旧。把每条"不要"配一个可量化的"要"。
新 build 上传后 App Store Connect 不显示：6 个原因 + 排查清单
Xcode 说上传成功，Transporter 说投递成功，但 App Store Connect 找不到这个 build。它其实在三种静默状态之一，每种对应不同修法。
Prompt 没说"成功长什么样"
让 AI 写"不错的摘要"，反复改 20 分钟没一个能定稿——因为 prompt 没说成功长什么样，模型只在"听着自信"上爬山。本文给一套可机械化核查的成功标准块。
没规定输出格式：所以收到一整面散文墙
想要结构化答案，却收到 600 字段落。这里教你怎么逼出干净 JSON 或固定模板，每次都稳。
输出听着精致但不可执行：原因 + 对症修复
AI 给的几段建议读着像顾问 deck——没文件路径、没命令、没要查的配置值。本文讲怎么用 schema（含 API 层 structured outputs）强制 AI 交出可执行交付物，而不是靠加形容词。
Prompt 要"最好"却没给决策规则
同一个"哪个最好"的 prompt 跑三次得到三个答案。把"最好"换成维度、权重和 tie-breaker，才能拿到一个可辩护的选择。
复制来的 Prompt 在新任务里失败：怎么修
别处好用的 prompt 在你当前任务里产废话，因为旧的受众、格式、示例还焊在里面。本文教你从目标重建。
Prompt 用情感词而非操作性指令
"求你写得超棒！"听着真诚，但模型不知道要做什么。把形容词换成可检查的规则。
Prompt 缺少上下文分级：模型为什么答错了那一段
你把所有内容平铺成一面墙，模型分不清哪几行是关键、哪几行是背景。加标签、给来源打标、把任务放到注意力最高的位置。
Prompt 缺少素材优先级：给来源打上出处标签
你挂了 3 个文档，模型把它们当成同等权威——包括那份已否决的草稿。教你标好出处，让正确的来源胜出。
Prompt 没定义受众：原因排查 + 对症修复
没写受众，模型就在为一个不存在的平均读者写，谁也讨好不到。用一行受众块校准词汇、深度和语气，一次写对。
Prompt 太泛，产不出有用结果
宽问题只会换来宽答案。本文教你把 prompt 收窄到只有一个具体答案能成立——附模板、诊断表和修复清单。
Restore Purchases 按钮缺失：修复 3.1.1 拒回
Apple 以 Guideline 3.1.1 打回、提示找不到 Restore Purchases 按钮。在付费墙和设置加上按钮、接到 StoreKit、重新提交即可过审。
因审核员无法访问受限功能被拒：分桶诊断 + 修复路径
Apple 以 Guideline 2.1 拒审：审核员过不去付费墙 / 地区锁 / 角色门 / 邀请码。多数靠 notes + 服务端配置即可修复，不用重打 build。
只设"角色"不够：5 个原因 + 对症修复
"你是一名资深工程师"能定调，但不会改变答案。研究表明专家人设几乎不提升准确率；规则、格式、示例才管用。
风格要求与输出格式冲突：挑一个、限到 prose 字段、或拆两遍
要 AI 同时输出温暖口语和严格 JSON，是两个方向相反的要求。挑一个、把温暖限到 prose 字段、或拆成两遍，并在 API 层用 strict 真正强制 schema。
购买后订阅 entitlement 不一致：StoreKit 2 服务端权威修复
用户付了款 App 还显示免费，或取消后仍是 Pro。服务端权威的 StoreKit 2 修法，配合 App Store Server Notifications V2 与对账。
TestFlight Beta 审核卡在 Waiting for Review 怎么办
TestFlight build 卡在 Waiting for Review 好几天了。讲清楚到底发生了什么、你能做什么。
TestFlight build 过期：90 天硬期限 + 替换流程
测试员看到 "This beta has expired"，或 App Store Connect 里 build 标记 Expired。为什么会这样，以及如何快速推一个替换 build。
TestFlight build 在测试员设备上看不到：修复清单
build 已是 Ready to Test、测试员也接受了邀请，但 TestFlight App 里就是没有。按这份排序清单走一遍，95% 的情况不用重传就能修好。
TestFlight 外部测试员收不到邀请：7 个原因 + 修复清单
你在 App Store Connect 加了外部测试员，但他们一直收不到 TestFlight 邀请邮件，或者公开链接显示不接收新测试员。本文教你按命中率定位并修好。
示例太多反而压住任务：原因 + 对症修复
塞 5 个以上示例，模型会挑最像你输入的那个去抄，而不是真去做任务。砍到 1-3 个；推理模型上先试零示例。
一个 Prompt 塞太多任务：怎么拆才能每件都做完
一个 prompt 塞 5 件事，结果一件做得好、一件糊弄、三件做一半？教你怎么拆，让每个任务都落地。
任务边界不清，AI 自行扩大 scope
你让 AI 改一个函数，它顺手重格式化了另外两个、还改了常量名。在 prompt 里画出显式的 in-scope / out-of-scope 边界，让这次修改守得住。
广告拦截器正在悄悄拉低你的真实 RPM
相当一部分受众开着广告拦截器，所以你真实的填充率和收入比 AdSense 面板显示的更低。本文教你怎么测出这个差值并把这部分收入找回来。
广告密度默默违反 AdSense 政策
你以为每页 5 个广告没问题——AdSense 的 Valuable inventory 政策不同意。结合 Better Ads 的确切阈值，找你布局的安全密度。
首页有广告、文章页空白：6 类原因 + DevTools 排查修复
首页 AdSense 正常、文章页空白，多半只是两个模板的差异：漏装脚本、容器塌成 0、ad-slot ID 不对、或内容太薄。一套 DevTools 左右对比法，几十秒定位是哪一类。
ads.txt 找不到或在 AdSense 里验证不通过
AdSense 报 "Earnings at risk — you need to fix some ads.txt file issues"。怎么把 ads.txt 部署到正确位置、用 curl 验证、清掉警告。
AdSense 账号通过但新站卡在 Getting Ready（2026）
账号几年前就过了，新加的站点却在 "Getting ready" 卡了好几周。2026 年逐站审核怎么运作、各状态标签含义、以及怎么不再干等。
AdSense 移动 vs 桌面填充率差距（2026 修复）
移动填充 55–70%，桌面 92–98%。哪部分差距是结构性、哪部分是你的配置，以及最快的修法。
AdSense 余额卡在 $100 门槛下（2026 解决）
广告跑了好几个月，余额始终在 $100 付款门槛以下。这里讲清楚背后的数学、怎么判断你属于哪一类、以及什么才真正有用。
AI 内容缺乏独特价值：为什么排不上去、过不了 AdSense
AI 文章读着顺但排名 47、AdSense 拒「low value content」——核心是 information gain（信息增量）：每篇加齐 6 类里的 3 类（亲身经验 / 原始数据 / 反潮流观点 / 专家引用 / 独有截图 / 独创综合）。
文章数大但真实覆盖弱：6 种灌水来源 + 用“实质数”代替「篇数」
「我们有 800 篇！」但 60% 是双语副本、草稿、空 redirect——按 unique + indexable + 实质 URL 数。
发布日期与 JSON-LD 日期不一致
可见的"发布 / 更新"日期与 JSON-LD 的 `datePublished` / `dateModified` 不一致——这不只是外观 bug。
Auto Ads 出现在最差的位置
AdSense Auto ads 把横幅压在 H1 上、anchor 广告挡住 CTA、每次点击都弹全屏 vignette。用 2026 年的格式分组和 Excluded areas 约束位置，不必关掉 Auto ads 而丢掉 20-60% 收入。
双语版本逐渐漂移：6 种类型 + 按对决定「翻译 / 同步 / 标单语」
EN 更新 5 次 ZH 才 1 次：截图过期、cross-link 失效、hreflang 被忽略。用脚本审计漂移、按对决定、自动化未来同步。2026 年 6 月。
Breadcrumb JSON-LD 与可见面包屑对不上
Rich Results Test 过了，但 Search Console 报 Breadcrumbs，或 SERP 里的面包屑看起来不对。先分清真正的原因，再让 JSON-LD 与可见 UI 对齐（2026 年 6 月）。
改了 canonical，但 Google 仍显示旧 URL
你把 canonical 改到了新 URL，几周后 Google 还是排名旧的。canonical 是提示不是命令——把每个信号都对齐，Google 才会切换。
分类页太弱：排不上名也不被收录的 6 个原因 + 升级成 hub 文章
分类页只有标题加卡片，Google 看到的是导航不是内容。加一段 300 字编辑导言、一个精选「从这里开始」和你自己的观点，把它变成能排名的 hub 文章。
分类页不被收录：原因 + 对症修复
分类页卡在 Search Console 的 'Crawled - currently not indexed'，文章却正常收录——最快修复加完整诊断，2026 年 6 月核实。
同一域名在 Vercel 正常但 Firebase 不行（2026 修法）
同一域名绑 Vercel 一切正常，绑 Firebase Hosting 却卡在 Pending 或一直发不出 SSL。Firebase 到底要哪些 DNS 记录、要删哪些、怎么确认修好了。
页面突然被取消收录：算法降权还是 manual action？
排名好好的页面从 Google 消失，是 manual action 还是 core update 降权？5 分钟判断属于哪一类，再对症下药。
域名指向错误的托管商：用 dig NS 找到真正生效的 DNS
你换了托管商但 DNS 仍解析到旧的。先用 dig NS 查清权威记录到底在谁那里，再去对的提供商改。
草稿页误发布：6 种泄漏来源 + CI guard 防再发
还标着 `draft: true` 的页面被 build、部署、还被 Google 收录了占位符内容。审计 + 用 410 去索引 + CI 加 guard，让 build 不可能把 draft 发到生产。
重复域名版本被收录：http / https / www / non-www
Google 把四个版本都收录了，链接权重被分成四份。用平台层 301 + canonical 把它们合并成一个的迁移方案。
大量页面 meta description 重复：怎么修
爬虫报告几百页共用同一句 meta description。没有排名惩罚，但悄悄吃掉你的点击。这是定向修法，不用花一个周末重写全站。
双域名 / 同站审核混乱（2026）
yourbrand.com 和 yourbrand.net 内容相同，AdSense 报重复或一直挂在审核里。选一个 canonical、其余 301、修好它。
大量页面重复 title：6 种来源 + 用 CI 一劳永逸
审计报 80 页共用一个 `<title>`——多半是模板 fallback、分页、或双语撞标题。先判断属于哪一类，按 specificity 重写，再加 CI 拦，让它不再复发。
FAQ schema 无效或富摘要消失：2026 修复指南
FAQ rich result 消失、Rich Results Test 报 FAQPage 错？Google 已于 2026 年 5 月停掉这个功能。这意味着什么，以及如何让 schema 保持有效。
Google 只爬首页，从不爬文章页
Search Console 天天爬你首页，文章页却卡在 "Discovered — currently not indexed"。先分清是发现失败还是抓取预算失败，再对症修。
Google Publisher Tag (GPT) 不加载：修复空 slot
从 AdSense `<ins>` 换到 GPT 后 slot 一直是空的？10 秒诊断 googletag is not defined、id 不一致、cmd.push 时序竞争和 SPA 双初始化。
Googlebot 抓取上升但曝光不动
Crawl Stats 显示 Googlebot 每天抓数百 URL，但 Performance 曝光持平。本文讲清抓取为何不等于收录，以及怎么把堵在中间的管道打通。
首页分不出权重：把 200 条出链砍到 30 个目的地
首页 200 条出链把它的 PageRank 摊成 200 份。砍到约 30 个刻意选的目的地，长列表走 index 页，让权重集中到你真想排名的页面上。
双语站 hreflang x-default 混乱
设了 en 与 zh 的 hreflang，校验工具却报缺 x-default？讲清 x-default 做什么、6 种出错写法，以及可直接复制的修复。
HTTPS 没强制——站点 http 和 https 都能打开
站点 http 和 https 都能访问，Google 收录两份副本，Chrome 把 http 标成 Not Secure。加一条 301 重定向再补上 HSTS 头就能修好。
改版后 Indexing Coverage 下降
改版后 Search Console 的已收录页数下降——怎么区分正常的重新评估和真正的结构性损害，以及具体要跑哪些检查。
内链分布严重不均：审计入链 + 正文内链 + 智能 related 再平衡
Top 10 页吃 80% 内链、200 页只有 0-2 条。用 Screaming Frog 审入链，给饿着的底 20% 补正文内链，再把「最新 5」换成智能 related widget。
大型内容站收录缓慢：先判断是不是 crawl budget，再修
几千页只收录一小部分。怎么判断到底是不是 crawl budget，2026 年真正能推进的是什么。
静态站手动广告位空白：Astro / Next 导出修复
Astro、Next.js 导出、SvelteKit、Hugo 上 AdSense `<ins>` 块一直空白。诊断 push() 时机、重复 push、SSG 没跑 JS 三类坑并修好广告位。
页面多但展示少：死长尾的 7 个成因 + A/B/C 分级清单
500 篇文章、Top 20 拿 80% 展示、长尾 0-5/月。幂律正常，死长尾才是 bug。验证关键词、修 intent 与内链，并在 AI Overviews 时代分清「无展示」和「无点击」。
Meta robots vs X-Robots-Tag——谁说了算
`<meta name="robots">` 与 `X-Robots-Tag` HTTP header 冲突时，Google 会合并两者并取最严格的值。怎么用 curl 排查、怎么让两边保持一致。
还没流量就忙着优化 AdSense：该等还是该调
AdSense 过审了，但 10 个访客每天只赚 $0.50。广告调优真正开始有意义的流量门槛，以及 2026 年改掉的 Auto ads 设置。
Name Server vs DNS 记录——到底在哪里改
2026 最新：新手分不清 name server（NS）与具体 DNS 记录（A / CNAME）——改一个不懂另一个，调几小时。
新站卡在 Discovery 阶段
新域名上线 4-8 周、sitemap 已提交，但每个 URL 都显示 "Discovered – currently not indexed"。这里讲 2026 年真正有效的做法。
设了 noindex 但页面还在搜索结果里
几周前加了 `<meta name="robots" content="noindex">` 但页面仍在 Google——按命中率排序的六种原因，附上用来区分它们的 curl 检查。
公开页被误打 noindex：定位源头 + 对症修复
模板默认、环境变量泄露或 CDN 头把 `noindex` 留在了本该公开的页面。教你找到真正的源头、移除它，并触发干净的重抓。
搜索结果出现旧部署 URL 而不是自定义域名
Google 在搜索里显示 your-app.vercel.app 或 your-site.web.app，而不是你的自定义域名。原因，以及重定向 + canonical 的精确修法。
孤儿内容页拖累站点质量：6 种来源 + 「整合或清除」二选一
0 入链的页面几乎不排名。先用爬虫或脚本找出真正的孤儿，再逐页决定：用正文内链整合，还是用 410/noindex 清除。
孤儿页：没有内链，所以收录不了
URL 在 sitemap 里，但站内没有任何页面链向它。Google 视它为不重要，把它压在 'Discovered — currently not indexed'。修法：从已收录页面补 2 条以上正文内链。
页面已收录但 Search Console 一直 0 曝光
URL Inspection 显示页面已在 Google 上，但 Performance 报告 0 impressions。这个状态到底意味着什么、怎么修？
修复 AdSense 被拒：隐私政策缺失或不完整（2026）
AdSense 会拒掉隐私政策里没点名 Google、第三方 cookies、个性化广告的站点。本文给出它实际在搜的原文措辞，以及怎么改完重新申请。
换域名后重定向全坏了：修掉 404 并救回 SEO
从 old.com 迁到 new.com，Search Console 冒出数百个 404。如何建完整的 redirect map、部署在旧域名上、并验证每个 URL 都返回 301。
反复 resubmit URL Inspection 也不能逼 Google 收录
你点了 10 次 Request Indexing，URL 还是显示 not on Google。本文讲清楚 URL Inspection 为什么不是强制收录按钮，以及真正起作用的做法。
sitemap 列出了带 noindex 的 URL（怎么解决这个冲突）
你的 sitemap.xml 列出了渲染 `<meta name="robots" content="noindex">` 的 URL。Google 有的收、有的不收。为什么会这样，怎么让两个信号一致。
RSS / OG URL 仍显示 example.com（占位域名）
RSS 条目和 og:url 还指向 starter 模板的占位域名（example.com 或 your-domain.com）。本文说明它会从哪几处泄漏，并一次性修好每个位置。
Search Console 出现大量低价值 URL：6 类噪音来源 + 按源屏蔽
「Crawled — currently not indexed」涨到几千条 `?sort=`、`?page=`、tag 组合——按源分类，用 robots.txt / canonical / noindex 屏蔽，把 crawl budget 还给真内容，同时避开最常见的「自废 noindex」错误。
Search Console 已编入索引数量无故下降
Search Console 的 Pages 报告里 Indexed 一夜掉了 50–200 个 URL，没报错、没改东西。本文教你查清是哪些 URL 掉了，以及该怎么处理。
换域名后 Search Console 资源对不上
换了域名但 Search Console 还在跟踪旧域名，或新资源是空的。用 Change of Address 正确迁移，又不丢历史数据。
内容站疯长但每篇文章长得一样：模板化思维 + 多样化设计
3 个月 100 篇文章，同结构同例子？这是模板化思维，而到 2026 年，这正是 Google「scaled content abuse」政策要打击的对象。审计、轮换模板、每篇强制一个独特角度。
域名连接后站点时而能开时而不能：7 个真实原因 + 强制刷新所有 resolver
新主机绑域名后刷一下打开、刷一下报 Domain not configured 或停放页。本文讲半过渡时 DNS 层到底发生了什么，以及怎么强制每个 resolver 都切到新记录。
sitemap 里有 URL 但 Search Console 不显示（2026）
sitemap 已提交、状态 Success，URL 却始终不出现在 Pages 报告里。逐项排查的具体方法，附最新 GSC 菜单路径。
迁移域名后 Sitemap 仍引用旧域名：定位并彻底修好
换域名后 sitemap.xml 仍列旧域名 URL，Search Console 报 'URL not allowed'。找到那条陈旧的 site URL 配置，一次修对。
修复 SSL Mixed Content 警告（HTTPS 站点显示 "Not Secure"）
站点已是 HTTPS，浏览器却显示 "Not fully secure"。判断你属于 6 种 mixed content 的哪一种并彻底修好——含 2026 年最新 Chrome 行为。
文章长期不更新变陈旧：6 种原因 + 「按流量 ÷ 年龄」优先级刷新
一半文章 3+ 年没改、引用的工具早变了。按月展示量 ÷ 距上次真改的月数排序，对高流量页做真刷新（不要 date-bump 把戏），让它们重新排名、重新被引用。
改模板后结构化数据变无效：定位那一个坏字段
改 layout 或升级框架后全站 JSON-LD 打挂——把 Rich Results Test 报错对应到原因，只修那一个回退的字段。
标签页被收录但文章页落后：原因 + 修复路径
Google 把所有标签归档页都收了，但文章页卡在 Discovered 或 Crawled - currently not indexed。原因在这里，还有链接分布的修复方法。
页数很多但仍被判太薄：原因 + 对症修复
有 200 篇文章却被 AdSense 拒审 "low value content"？页数不是指标，每页的独特价值才是。修复方向通常是删减加做深，不是再多写。
薄页面被 Google 默默降级：诊断、合并还是删除
Google 不会发通知罚薄页面，它只是悄悄停止抓取和收录最薄的页面。本文教你找出它们，并逐页决定扩充、合并还是删除。
标签太多生成大量薄归档页（阈值 + 治理修法）
800 个 tag、600 个只有 1-2 篇 = 600 个 Google 不肯收录的薄归档页。设每标签最少文章阈值、合并近义词、其余 noindex 并移出 sitemap。
薄页面太多拖累整个内容站：6 种薄页来源 + expand / merge / noindex / 410 四档处理
500+ 页 Google 只收录少数——按字数 + 展示量审计，每页打 expand / merge / noindex / 410，剪掉最弱的 20-40% 来抬高全站质量。
Topic cluster 太浅、pillar 排不上：6 类 stub 来源 + 「8-12 卫星 + 双向链」
1 pillar + 2 卫星不是 cluster，是 stub。真 cluster 跑 8-12 篇卫星、2-3 个月稳定发、双向内链。教你怎么设计、怎么建、怎么接线。
TTL 太高：DNS 改了为什么传播不出去
改了 A 记录但旧缓存死活不过期？决定传播速度的是变更之前那条记录的 TTL。先判断属于哪种情况，再用对的方法修。
分享到 X/Twitter 不显示卡片图
og:image 都设好了，分享到 X/Twitter 还是没图。6 个真实原因、怎么判断你属于哪种、每种的最快修法。
我用了 Search Console Removals 工具——然后呢？
Search Console 的 Removals 只把 URL 从 Google 隐藏约 6 个月（180 天），之后会自动回来。它不是永久删除，也不是重新抓取按钮。本文教你怎么拿到你真正想要的结果。
VideoObject schema 有效但拿不到视频 rich result
VideoObject JSON-LD 过了 Rich Results Test，但 Search Console 显示视频没被索引。真正的原因通常是缩略图、embed URL 或视频显著度——本文教你定位是哪一种。
WebSite JSON-LD 与站点不一致（修好站名）
WebSite JSON-LD 里的 name / URL 与实际不符，导致 Google 在首页结果上方显示错误站名。如何对齐——以及为什么 SearchAction 那一半已经失效。
什么情况下"收录慢"其实是正常的：基线参考
新站、新分区、改版后的真实收录延迟基线，以及哪个时间点开始才算真问题。
www 与 non-www 都能独立打开
yourdomain.com 和 www.yourdomain.com 都返回 200、内容一模一样——为什么这会分散 SEO 信号，以及各家主机上精确的 301 修法。
Firebase 缓存：部署后强制刷新页面
部署完用户还看到旧页？用这份 firebase.json 缓存头配置 + curl 诊断 + 正确的回滚命令（2026 年 6 月已验证）几秒搞定。
Firebase Hosting rewrite 怎么用，什么时候别用
Firebase Hosting 的 rewrite 能把 URL 映射到 Cloud Function、Cloud Run 或 SPA。截至 2026 年 6 月真正能用的三种模式、新的 functionId 写法，以及每种的隐藏陷阱。
Firebase Hosting 部署后路由 404：5 个原因和修法
本地能开、部到 Firebase Hosting 就 404。用官方请求优先级顺序、firebase.json 片段和 curl 命令，十分钟定位原因。
Vercel build failed 怎么修：7 类原因和精确修复
Vercel "Build failed" 几乎都是 7 类原因之一：Node 版本、缺环境变量、类型错误、依赖漂移、内存不足、输出目录错、超时。按日志匹配，直接粘贴修复。
A vs CNAME 困惑：到底该用哪种 DNS 记录？
主机文档说 A、教程说 CNAME，apex 解析不了或邮件还断了。一张经过核实的速查表，讲清 apex / www / 子域分别该用什么（Vercel、Netlify、GitHub Pages、Cloudflare）。
AdSense 审核通过但广告不展示：最快修复法
代码贴了，文章页广告位却空白。先给最快修复法，再按命中率从高到低列出 7 个真实原因，每条都附精确排查步骤。
AdSense Auto vs Manual：两个混用之后的故障排查
Auto Ads 和 Manual 同时启用导致的常见问题：广告重叠、版式抖动、Core Web Vitals 下滑。需要选型比较，看相关页。
AdSense "Low Value Content" 被拒后的恢复
2026 年 low value content 到底指什么、怎么判断你的站属于哪一类、以及哪些恢复步骤能让你在复审时真正通过。
AdSense "No Ads Available"（广告位空白）
AdSense 广告位渲染成空白、报告显示未匹配请求。先用 DevTools 诊断，再处理库存 / 尺寸 / 政策 / ads.txt 问题。
AdSense 政策警告：看懂分类，快速解除
AdSense 政策警告是一个倒计时。先在 Policy center 看清确切类别，只修被点名的 URL，再点 Start review process——别浪费有限的复审次数。
AdSense 代码装了广告位空白
adsbygoogle.js 返回 200 但广告位空白。先读 data-ad-status，排除账号审核，几分钟搞定接线问题。
AdSense "Getting ready" / "Requires review" 怎么办
站点卡在 "Getting ready" 或 "Requires review"。教你分清正常排队和真问题，以及该修什么。
AdSense 拖慢页面：定位 + 修复（恢复 CWV）
接 AdSense 后 PageSpeed 暴跌？几乎都是 3-4 个接线问题，不是广告本身。最快修复：给 ad slot 预留 min-height（治 CLS）+ 脚本加 async（治渲染阻塞）。附 2026 最新代码。
AI 编码 agent 在循环、不进展怎么办
Agent 一直试同一个修法，或在两种状态之间反复横跳。30 秒内识别循环、用一句话打断它。
Agent 回滚不彻底：按域回滚，别只靠 git reset
Agent 报告「已回滚」，但 migration、`dist/` bundle、Stripe webhook、PostHog flag 还活着。这是 6 个域的 checklist 和把活儿真正干完的逆向命令。
AI 回答太泛：3 步逼出具体答案
问 AI 一个具体问题，收回四段"看情况"式废话，几乎都是 prompt 形状问题。本文拆六种触发外交辞令的写法，给出把模型逼回锋利判断的改写模板。
AI 视频转场生硬：原因 + 修复路径
两段 AI 视频剪在一起跳。匹配运动 / 色彩 / 节奏，或用首尾关键帧让模型自己生成转场。
本地 build 过、CI 挂——AI 改完最常见的坑
AI 装了依赖没提 lockfile，或用了你 CI 镜像没有的 Node 特性。5 分钟内复现，把这道缝彻底钉死。
AI 改代码后 build 挂了：恢复与诊断
AI 跑完一轮 npm run build 报错。用 diff 分级、tsc --noEmit 和定向 git restore，10 分钟内定位坏改动，不用全 reset。
AI agent 把 .env 覆盖了怎么办
AI 编码 agent 用占位符重写或删了 .env：先恢复真实值，再彻底锁死让它别再碰。
AI 图片多手指 / 手画崩：原因排查 + 修复路径
2026 年 Midjourney、SDXL、Flux、Imagen 仍会出六指、扭曲手。给手更多像素、跑一遍手部专用 inpaint、必要时换模型——附各工具精确步骤与参数。
AI 编出不存在的事实：识别并制止自信的错误答案
模型自信地编出引用、不存在的 API 方法、差一个数量级的数字。本文教你怎么识别，并逼它一次给出有据可查的答案。
AI 凭空引用了不存在的文件或包：原因 + 修复路径
Agent 写了 `src/utils/superhelper.ts` 或一个从未存在的包。先列出所有坏 import，再逐个修复或替换。
AI 动漫风混入写实：6 类原因 + 6 步修复
想要动漫，模型却漏出写实皮肤、眼神、光影？锚定一个具体动漫参考、删掉所有写实触发词，并按 checkpoint 自己的标签体系来写。
AI 图片背景太抢戏：5 类原因 + 5 步修复路径
背景比主体更抢眼？把背景风格写明白、和主体色错开、裁得更紧，再对背景单独 inpaint 或一句话改掉。
AI 图片人物每次脸都不一样：原因 + 修复路径
同样描述，每次出来的脸都不同？用参考图（Omni Reference、gpt-image-2、IP-Adapter FaceID）锁身份，再固定 seed、加独特识别点。
AI 图片构图太杂：5 类原因 + 8 步修复路径
主体太多互相打架？砍到一个主角 + 加浅景深 + 留白。最快修法，以及 Midjourney / ChatGPT / Gemini / SDXL 各自的具体操作。
AI 出图糊 / 细节少：6 类原因 + 最快修复
出图模糊、软、塑料感重？原因几乎都是分辨率、采样步数、或 Prompt 没有细节锚词。60 秒定位，再逐个修。
AI 图片不像 prompt：按模型给出修复路径
模型忽略了一半 prompt，通常是 token 顺序、风格冲突，或负面词写在了正向里。这里按模型给修复方案。
AI 图片打光平 / 难看：先诊断再修，6 步修复路径
主体平、硬、没有立体感？用摄影术语锁主光（方向 + 质感 + 来源 + 色温），形容词永远做不到这种效果。
AI 图片系列风格不一致：6 类原因 + 6 步修复路径
想做 5 张一致的图，结果像 5 个不同画师画的？固定一个 Midjourney 数字 sref 码（或一张 IP-Adapter 参考图）、锁 seed、冻结模型。2026 年 6 月核实。
图转视频偏离原图：原因 + 修复路径
开头是 A、结尾变成另一个人——降 motion、限片长、用参考图 + 文字双锚点锁住身份就能修。
AI 图片长宽比不对：9:16 出成 1:1 怎么修（分平台）
设了 9:16 却出方图？分平台讲清楚长宽比语法、支持比例列表和 UI 覆盖陷阱——Midjourney、ChatGPT、Gemini、SDXL、Flux，2026 年 6 月核对。
修复 AI 视频口型对不上音频
嘴型和你单独生成的音频对不上。先判断原因，再选对修复路径：重渲、后期对、还是构图绕开。
AI 编辑后 merge 冲突：解决指南
你的分支加上 AI 改动跟 main 冲突了。在不丢掉 AI 真正改进的前提下解决冲突，别再把格式噪音当成逻辑冲突。
AI 输出风格漂移——怎么把风格钉死
system prompt 没动、模型没换，几轮之后风格又变了。把形容词式的风格描述翻成模型能逐条自检的可测规则，并钉死版本与方差旋钮。
AI 编辑后 package-lock / pnpm-lock 冲突怎么修
Agent 装 / 删了依赖，lockfile 和团队的对不上了。别手工 resolve——直接回退重新生成，下面是每种包管理器的准确命令。
AI 写实图像出来像塑料：修掉假皮肤感
写实 prompt 出来塑料、假——用具体的光线、皮肤纹理、镜头和负面 prompt 修复。June 2026 核对。
AI 商品图看着假 / 不带货：原因 + 修复路径
AI 商品图露馅，多半是灯光太对称、缺接触阴影、或反光对不上材质。本文给出从诊断到修复的完整 prompt 与选模型路径。
AI 重构生成了重复文件：安全清理步骤
Agent 没改原文件，反而在旁边建了 `UserList2.tsx`。diff、合并、删除、修 import，全程不破坏构建。
AI 重构把还有用的逻辑删了：定位并精确加回
AI 把代码"简化"了，悄悄删掉了真实用户依赖的某个分支。本文教你用 git bisect 定位到那个 commit、对照 prod 日志、只把被删的 hunk 加回来，并补上回归测试。
AI 改动了你不想动的关键逻辑：对症定位 + 手术级修复
让 AI 改一个参数名，它顺手把重试循环、timeout、forEach 也悄悄改了。本文讲怎么把 AI 编辑约束成可审计的手术级 diff。
AI 改代码后怎么安全回滚：选最小撤销，再用 reflog 救回来
撤销 AI 的坏改动、又不误删好改动：选范围最小的 git 撤销命令，并在 30 天期限内用 reflog 救回丢失的 commit。
修复 AI 写出来的 TypeScript 类型错误
AI 的代码过不了类型检查（TS2322、TS2339、TS2554）？一次修干净的 tsc 闭环、错误码对照表，以及该给 agent 的规则。
修复 AI 图片里的乱码 / 错字文字
AI 出图文字变成 RESPCT、OPEM 这种乱码。换一个文字强的模型（GPT Image 2、Ideogram V3、Nano Banana 2），或者后期补字。2026 年 6 月分步修复指南。
AI 视频背景闪烁：原因和修复
背景帧间形状 / 风格跳。修法：简化背景、只留一个运动源、降 Motion amount、或换模型。
AI 视频镜头莫名晃动：6 类原因 + 一套锁定修复路径
想要静态镜头，出来的画面却像手持 iPhone 一样漂浮抖动。AI 视频工具默认加轻微手持运动。用对的静态从句、把相机控制设为 Static、再把动作滑块拉到 0（Kling/Hailuo 里另加负向提示词），就能强制锁定画面。
AI 视频人物中途漂移：原因排查 + 修复路径
同一人物几秒后五官就变了？别再指望提示词记住角色——用模型自带的角色功能（Runway References、Kling Elements），锁一张基准参考图、单段控制短、动作降一档。
AI 视频脸中途变了：锁住身份、止住漂移
第 1 帧是你的角色，第 90 帧成了别人？用绑定的参考图锚定身份，脸关键镜头别太长，降动作强度。适用 Runway、Kling 3.0、Pika、Veo、Sora。
图转视频完全不像原图：6 类原因 + 修复路径
视频出来不像输入图？把图像保真度推满（Kling 的 Relevance / CFG）、文字 Prompt 砍到只剩动作、源图分辨率不低于输出且主体占画面 40%+。
AI 视频动作不科学：6 类原因 + 修复路径
腿向前蹬身体却往后滑、水往上倒、手穿过物体？动词模糊、物理没被模拟——明确方向、目标和起止姿态。
AI 视频动作抖动：停止帧间跳动
Runway、Kling、Pika、Veo 里肢体跳变、主体瞬移？这是动作路径插值崩了。修法：一段片一个动作、锚定起始姿态、按原生 fps 出图。
AI 视频运动过度：6 类原因 + 6 步修复
画面里啥都在动、一片乱？降动作强度、删多余动词、只让一层动（镜头或主体二选一），再加一条静态镜头负向提示。附 Runway、Kling、Pika、Luma 各工具 2026 年 6 月最新设置位置。
AI 视频节奏不对：在剪辑里修好
片段拖沓或太赶？生成 2-4s 的短段、用 NLE 打 marker 按节拍切、有意让片长不一，节奏在剪不在生成。
AI 视频商品形变：6 类原因 + 6 步修复路径
瓶子拉长、包装扭曲、logo 弯了？商品镜头当微距处理：高分辨率参考图、最低动作、5 秒短片、锁死镜头。
AI 视频不同镜头场景不一致：6 类原因 + 6 步修复路径
同一房间描述却生成两个布景？用一张基准大全镜头 + 命名场景参考 + 统一灯光语言 + 共享道具清单锚住场景，最后再 color match。
AI 视频人物中途变成别人：能锁住身份的修复路径
片头是 A、片尾变成 B——脸、衣服色、体型全换了。用模型自带的角色参考（Kling Element、Runway References、Sora Cameo）、具体身份描述、加上更短的镜头把主体锁死。
AI 视频太静：修复欠运动（Runway / Kling / Pika / Veo）
要了视频却得到一张带 5 像素视差的静图？加动作动词、只指定一个镜头运动、把 motion 强度往上拉一档——这是欠运动的三招（2026 年 6 月，覆盖 Runway / Kling / Pika / Veo）。
AI 视频物理不自然：为什么东西会掉错方向，怎么修
液体横着流、布料反重力、球往上滚？AI 视频模型没有物理引擎。重新构图绕开难点、换更强的模型，或把真实素材合成进去。
AI 图片构图弱 / 死板：原因 + 修复路径
AI 图主体在、光线对，但构图死板——居中中景、无纵深、无引导线，这是默认构图陷阱。像指挥光线一样指挥构图：三分线、三层景别、机位、景深词。
修复 App 隐私问卷被拒 / 不一致
App Store Connect 标你的隐私 nutrition 标签与 App 行为不一致。最快的修法：建一份 SDK 到数据类型的清单，逐项把问卷答案对齐后再重交。
App 因 4.3(b) 被拒：Design Spam（2026）
Apple 的 4.3(b) 专打模板农场、换皮和薄 AI 包装。要么做出实质差异化，要么带证据去申诉——纯重写几乎从不翻案。
审核期间 Demo 账号失效：Guideline 2.1 对症修复
提交后回 Rejected，附 'We were unable to sign in with the credentials you provided'，但你自己手机能登——多半是审核员陌生 IP 撞上安全策略。六种原因按命中率排，附 App Store Connect 里 Sign-In 字段的准确位置和重交步骤。
因 Guideline 2.1 Information Needed 被拒：一次重交搞定（2026）
Apple 的 Guideline 2.1 被拒是文档缺口、不是代码 bug。填好 demo 账号字段、确认后端在线，再重交，通常不用重打 build。
Astro 部署后页面 404：3 个原因 + 修复路径
dev 正常、线上 404——多半是 build.format / trailingSlash / output 三者和宿主不对齐。给一条可照抄的修复路径。
登录回调跳到错误的 URL（redirect_uri_mismatch）
登录后跳回 localhost 或错误域，或 provider 报 redirect_uri_mismatch——把精确的 callback URI 加进白名单，并用 env 驱动。
换域名后 canonical 还是老域名
换了新域名但页面 canonical 还指老的——修复硬编码 URL、CDN 缓存、sitemap、301 和 Search Console。
双语站 canonical 错配（EN/ZH）：自指 canonical + hreflang 修复路径
Search Console 收录了错误的语言版本，因为 EN/ZH 的 canonical 互相指来指去。修法：每个语言版本自指 canonical，再用 hreflang 声明彼此互为 alternate。
ChatGPT 账号切换不生效：5 个原因 + 对症修复
切了账号 ChatGPT 还是旧的，多半是原生切换器最多 2 个账号的上限、session cookie 缓存、SSO 自动选号，或 Business workspace 锁定。
ChatGPT App 和 Web 不同步：原因与最快修复
Web 上能看到的对话 App 里却没有（或反过来）？绝大多数情况不是后端丢了数据，而是两端登的账号或 Workspace 对不上。两分钟内定位到底是哪一种。
ChatGPT 登录成功后白屏：5 类原因 + 排查修复
登录跳到 chatgpt.com 后一片空白？按顺序排查：硬刷新、注销 service worker、清缓存、关扩展、查 JS 权限策略。
Cookie 被拦截：修复 ChatGPT 登录失败
第三方 cookie 被屏蔽会让 OpenAI 登录握手失败、卡在 Cloudflare 循环。逐个浏览器给出要打开的开关，2026 年 6 月核实。
ChatGPT 把你的 CSV / Excel 数据看错了
数字算错、表头错位、日期颠倒。强制走 analysis tool、显式声明本地化格式、核验行数——三步拿到准确结果。
ChatGPT 文件分析感觉太浅：原因 + 对症修复
要分析，得到的全是泛泛的 bullet——修法在 prompt，不在换模型。
ChatGPT 上传的文件从对话里消失
上传文件、问了个问题，文件就没了？自 2026 年 3 月 Library 上线后，大多数上传其实还能找回——本文教你怎么找，以及怎么不再发生。
ChatGPT 不支持这种文件类型：能用的变通方案
ChatGPT 拒收或说没法分析？先识别真实类型，再转成它处理质量最高的几种格式。转格式比硬刚上传更快。
ChatGPT 文件上传失败怎么办：大小、格式、地区与扩展全排查
ChatGPT 上传 PDF / Excel / 图片一直失败、卡 0%、或显示 Unknown error occurred？这是三类不同问题。附 2026 年 6 月已核实的上传上限和 9 条排查路径。
ChatGPT 生成的文件下载失败：修复过期链接
ChatGPT 给了文件链接，但 404、卡住、或下载下来是空的（常见报错 The code interpreter tool session has expired）。快速诊断并修好。
Custom GPT 打不开或 action 失败——快速修复
点开 Custom GPT 是空白，或者 action 报 'request failed'？十有八九是缓存、账号权限，或作者的 action 后端出了问题。本文教你分辨是哪一种。
ChatGPT 对话历史不见了？恢复清单（2026 年 6 月）
侧边栏空了？十有八九没真丢——登错账号、用了 Temporary Chat、被归档，或标签页没刷新。下结论前先走一遍这份清单。
ChatGPT 图片生成失败——五大原因，按概率排查
图出不来？Safety filter、配额、Prompt 冲突还是算力限流——用一条最简 prompt 在 30 秒内定位，再修对应分支。
ChatGPT 看不懂上传的图片：7 类原因 + 排查修复
截图或图表传上去 ChatGPT 描述错了。最快修复：重传清晰 PNG（长边 1500px 以上）+ 裁到关键区域 + 给定向转录 prompt。
ChatGPT 大文档分析感觉很浅：怎么逼它彻底读
上传了 200 页报告，总结却像只读了 30 页。ChatGPT 走的是检索而非通读。用分章节、点名页码的查询逼它读深。
ChatGPT 登录循环——登进去又跳回登录页（2026 修复指南）
密码、SSO 都成功了，页面却又跳回登录页或卡在 Cloudflare 人机验证？90% 是 cookie、轮换 IP 的 VPN，或缓存的旧会话。这里给出精确的排查顺序。
ChatGPT 在一个浏览器能登另一个不行
Chrome 能登、Safari 不行（或反之）——账号没问题，差异在浏览器的 cookie 策略、扩展、残留的 SSO 状态或版本。
ChatGPT 记忆不生效怎么办：原因排查 + 对症修复
ChatGPT 说"记住了"，下次又忘？多半是开关、Temporary Chat、根本没写入，或者 2026 年新的后台记忆在作怪。本文按命中率逐条排查并给出修复。
ChatGPT 提示"You've reached your limit"怎么办
ChatGPT 弹"You've reached your limit"消息上限？看懂这个滚动窗口的真实含义、最快的回到工作方法，以及怎么从根上少撞上限。
ChatGPT 手机 App 与网页登录不一致：怎么修
同一个邮箱，但 ChatGPT App 和网页表现得像两个账号。真正的原因就三类：workspace、SSO 方式、App Store 订阅——本文教你怎么分辨并修好。
ChatGPT 不会跨文件比较：原因 + 对症修复
传了 3 个文件想做对比，ChatGPT 只读了一个？点名每个文件、强制逐文件出表格。已按 GPT-5.5、2026 年 6 月核对。
ChatGPT network error 怎么办：8 种真实原因与逐个解决方法（2026）
ChatGPT 发消息中途报 network error 或 There was an error generating a response？这是同一个报错背后的 8 种不同问题。先 30 秒判断，再对症修复。
ChatGPT 密码重置邮件没收到
点了忘记密码邮件迟迟不来？它和注册验证不是一个流程——速率限制更严，SSO-only 和 passkey-only 账号会被静默拒绝。这里给最快的修法。
ChatGPT 读不了 PDF——空文件 / 没看到内容
上传 PDF 后说"没看到内容"或 'No text could be extracted'？多半是扫描件、文件过大、加密。最快修法见正文。
ChatGPT Project 上传的文件没被引用
文件上传到 ChatGPT Project 了，模型却像不知道。最快的修法：在问句里点名文件并要求原文引用。下面是完整诊断。
ChatGPT Project 指令不被遵守：原因与修复
Project 指令写得很详细，但 ChatGPT 中途就忽略了——多半是指令权重、与当前消息冲突、1500 字段上限，或 Memory 在覆盖规则。本文给出修复办法。
ChatGPT Project 上下文与 Chat 上下文为什么会打架
在 Project 里设了 instructions 和文件，某个 chat 却不遵守；或者一个 chat 莫名记得另一个 chat 的内容？把五层上下文理清楚就能快速定位泄漏。
ChatGPT 反复提示会话过期：8 个修复
ChatGPT 用着用着就被踢下线？三大主因是 cookie 被清、多 tab 抢 token、公司代理剥 header。本文为 2026 年 6 月实测可用的修复。
ChatGPT 分享链接打不开：原因与修复
chatgpt.com/share 链接 404 或空白？基本都是分享者那边的问题——被删、被策略移除、或压根没生成。教你快速定位是哪一种。
ChatGPT 分享链接 vs 账号登录：边界到底在哪
ChatGPT 分享链接是公开只读快照，不是登录。讲清这个 URL 能做什么、为什么你不能回复，以及如何安全地分享或撤回。
ChatGPT 回答变慢怎么办：先查这几项（2026 年 6 月）
ChatGPT 回答慢，几乎都是会话太长、模型选重或网络往返延迟——按这个顺序排查。先新开对话，多数情况就好了。
ChatGPT 一直 loading 怎么办：6 种卡 thinking 的真正原因（2026）
ChatGPT 发完消息后回复处一直转圈、几分钟没输出？这不是一种问题，而是 6 种。用本文的 1 分钟判断法找到对应原因，让它别再空转。
ChatGPT "Unusual / Suspicious activity detected" 怎么解决
几乎都是出口 IP 触发安全验证，不是账号本身。关掉 VPN、换网络、等冷却，最短解锁路径在这里。
ChatGPT 上传的 PDF 分析不正确
PDF 上传成功但 ChatGPT 漏读表格、跳页、数字错——多半是抽取层而不是模型本身的问题。附逐步诊断与当前上限。
ChatGPT 验证邮件收不到：7 个排查方向逐一过
注册链接或登录验证码迟迟不来？多半是垃圾邮件、地址打错、别名过滤规则、企业 ATP、VPN，或地区限速。本文教你定位是哪一种并快速修好。
ChatGPT 语音用不了？几分钟修好（2026）
语音没声音、卡在 Connecting、或波形按钮不见了？基本就是麦克风权限、输入设备选错、客户端太旧，或者你在已下线语音的 macOS 桌面 App 上。
ChatGPT 联网搜索不可用 / 不触发（2026 年 6 月版排查）
ChatGPT 联网一直转圈、不返回来源、或者干脆不联网？本文教你如何强制触发，并拆解它静默失败的六个原因。
ChatGPT 登录方式不对——注册后用错认证方式
用 Google 注册却用邮箱密码登录（或反过来），ChatGPT 直接拒绝，看着像密码错。教你找回真正的登录方式。
Claude Artifact 下载失败或下到空文件
Artifact 下载没反应或下到 0 字节文件。修复方法：等流式生成结束、关掉拦截扩展，或让 Claude 直接把内容贴进对话。
Claude in Chrome 抓不到网页内容：6 个修复方法
Claude in Chrome 显示已连接却说看不到页面？修复每站点权限、SPA/Canvas 页面、抓错 Tab，以及 Cowork 冲突。
Claude Code 反复问太多问题：权限提示 vs 决策问题，两种修法
Claude Code 每隔几秒就停下来要权限，或者问「TypeScript 还是 JS」——这是两个不同的问题：权限提示用 permission mode 修，决策问题用 CLAUDE.md 默认值 + Proactive 风格修。
Claude Code 中途丢了项目上下文：auto-compact 摘要 + rewind/重启加固
Agent 忘了之前定的事、反复读 CLAUDE.md、和 plan 矛盾——auto-compact 把承重细节压没了。用 /rewind 回滚、重新锚定，或带紧凑 handoff 重启。
Claude Code 不理解整个项目怎么办
Claude Code 反复改同一个文件、或完全忽略别的 workspace？在仓库根目录跑 /init，用 CLAUDE.md 锚定上下文，并从根目录启动会话。2026 年 6 月核实。
Claude Code 不照审计报告做：6 个降为「建议」的原因 + 把报告变成 Tasks
你给了详细 audit report，Claude Code 我行我素——它把报告当 context 不当 contract。转成编号 Tasks、一次一条执行、终点 diff 对账。
Claude Code 误解你的项目架构：用「我们用 / 我们不用」清单 + canonical 文件 + PreToolUse hook 锁死
Claude Code 建议「拆成微服务」但你刻意单体——在 CLAUDE.md 写「we use / we don't use」+ 真文件 canonical、用 .claude/rules/ 按路径限定，并用 PreToolUse hook 硬拦架构漂移。
Claude Code 输出和 prompt 不符：修 plan，别修 diff
Diff 是漂亮代码，却解决了别的功能。用 Plan Mode（Shift+Tab）加 restate-before-execute 在 plan 阶段逮住偏差，而不是等代码落地后才发现。
Claude Code 覆盖了你未提交的改动：先用 /rewind，再用编辑器 local history 抢救
未提交的活儿被 agent 跑没了——先试 /rewind，再用编辑器 local history 和 reflog 抢救，最后用「跑 agent 前先 commit」+ deny 规则 + worktree 锁死。
Claude Code Plan 模式偏离计划：6 个 scope creep 来源 + 把 plan 当合同
你批准 5 步 plan，Claude 做了 7 步、跳了 1 步、顺手 refactor 旁边代码——用锚到文件的步骤 + 每步停下汇报，把执行绑回批准的 plan。
Claude Code 重构 scope 越做越大：用 permissions deny 真正关住它
你要小改一个文件，结果回来 12 个文件的 diff？用 permissions deny 规则强制边界，每个 prompt 给可编辑文件清单，相邻问题写进 FOLLOWUPS.md。
Claude Code 中途停下：分清撞了哪种额度上限，以及怎么接着干
Claude Code 重构做一半提示额度用完。分清 5 小时窗口、周上限、Opus 单独上限三者，先 dump 状态再恢复，不重做已完成的活。已核对至 2026 年 6 月。
Claude Code 部分执行后卡死：分清「上下文压缩 / 工具挂 / 流断」
Claude Code 做完 60% 就没声了——不报错也没完成消息。判断属于三种形态（context 压缩、工具挂、流式断开）中的哪种，不重做活儿地恢复。
Claude Code 卡在循环里：6 种 loop 签名 + 各自的一句话破解
Claude Code 反复同样 edit、来回切换两个文件、永远追 flaky 测试——6 种 loop 签名各有诊断和一句话破法，外加 Esc / rewind / clear / Stop hook 的确切恢复命令。2026 年 6 月。
Claude Code 改错文件：6 种命名混淆 + 用 permissions.deny 强制锁死
改了你没让改的文件（同名 / 大小写差 / import 链外扩）。先 git 回退，再用 .claude/settings.json 里的 permissions.deny Edit 规则把边界锁死。
Claude Connector 没权限：自己修还是找管理员
Claude Connector 授权失败或返回为空。逐一排查四把锁：Workspace 策略、OAuth scope、目标应用管理员策略、token 状态。
Claude 文件生成为什么这么快用光额度
在 Claude 里生成文件比聊天耗得多得多。讲清它是怎么算的，并给出六个省额度的方法，2026 年 6 月核实。
Claude 连接 GitHub 失败：看不到仓库 / 拒绝访问的修法
Claude 的 GitHub 连接器显示没仓库或 access check failed？把 GitHub App 装到正确账号、选好仓库、清掉组织审批即可。
Claude 信誓旦旦却答错：怎么修
Claude 给出自信但错误的答案时，换模型往往没用。靠 grounding、system prompt 规则和开新会话，能解决大多数情况。
Claude 长对话变不稳定怎么办：如何 reset
聊到 50 多轮 Claude 开始自相矛盾、忘掉已定的决策。本文讲清原因、教你判断属于哪一类，并给出最快的重置方法。
Claude 429 反复 rate limit 死循环：怎么停、怎么修
Claude 一直循环报 429 rate_limit_exceeded——读 retry-after、限制并发、分清 429 和 529、守住你那档的 RPM/ITPM/OTPM。
修复 Claude 工具 / Connector 显示 unavailable
Claude 工具突然变灰、显示 unavailable in your workspace。按状态页、计划档、admin 策略的正确顺序排查，快速恢复。
Codex 审计报告范围太广：6 个原因 + 可执行的修复模板
让 Codex 审项目，结果回了 50 条 audit，从 typo 到架构混在一起？收窄到单一维度、限输出大小、强制 file:line，用 /review 的自定义指令预设。
Codex 没法把 patch 收干净：6 个截停原因 + 把「完成」写成合同
Codex 说「done」却留下断掉的 import、只换了一半的类型、没改全的 call site。把「done」绑到 AGENTS.md 里的 verifier 上，然后自己再跑一遍看 exit code。
Codex 不改原文件而是复制一份新的：根因 apply_patch 回退 + 防御规则
Codex 在 `utils.ts` 旁边新建 `utils.v2.ts` 而不就地改——真正的根因是 apply_patch 从 Update 退化成 Add。用 AGENTS.md 规则、git 兜底和正确的沙箱模式强制就地编辑。
Codex 没法跑或读懂 build 结果：6 个误读触发 + 让验证短到能 parse
Codex 跳过 build、误读输出、相信被截断的 tail——用 exit code 检查、机器可读 verifier、再加一个 Stop hook 闸门，别看 prose 总结。
Codex 修一个 bug 把附近改坏：6 个 collateral 来源 + 限定 blast radius
报的 bug 修好了，相邻两个功能挂了——限定改动范围、强制 caller 清单、优先在调用方加 guard 而不是改共享 util。
Codex 不照你的项目结构来：AGENTS.md 修复法
新文件落到 /src/ 但你的 repo 用 /app/；monorepo 里依赖被加到根 package.json；测试用了你没装的框架。用根目录 AGENTS.md、嵌套 override、canonical example 指针修好——按 2026 年 6 月的 Codex 实际行为核实。
Codex 做了不安全的假设：先引述再写 + 只读模式接地
Codex 用了没读过的列、环境变量或函数签名。强制 quote-before-write 规则，并让 Codex 跑只读模式，把每一行都锚到真实文件上。
Codex 不遵守项目约定：用 AGENTS.md 修复
Codex 写 `getUserById`，但你的项目用 `findUserById`——每条约定都要在 AGENTS.md 里配「规则 + 一个 canonical example 文件」，再确认它真的加载了。
Codex patch 和现有代码冲突：分清两种报错再修
Codex apply patch 时报「Invalid Context」或「No such file or directory」——先分清是哪一种，再决定重读文件还是重启 session。
Codex 的 code review 太浅？这样修
Codex review 只给「考虑下错误处理」这种泛话——用内置 /review 命令、AGENTS.md review 规则和 file:line 锚定的 prompt 修。
Codex 代码不合代码库 style：canonical + lint 双层锁
代码能跑，但读起来像陌生人写的：async/await 混 .then()、import 顺序错、注释风格不对。在 AGENTS.md 里指向一个 canonical 文件，剩下的交给 lint 强制。
Codex 测试建议太泛：6 个空话来源 + 锚到签名 + 类型 + bug 历史
「测一下 happy path 和 error path」是没用的填充——把测试绑到函数的真实签名、真实类型、edge case 和过去真出过的 bug 上。
Codex 生成代码不符合项目结构
Codex 把文件建错位置、忽略项目约定？用 AGENTS.md、显式引用同类型文件、plan-first 把它框回项目风格。
AdSense Cookie 同意：保住广告投放的最低配置
EEA / UK / 瑞士需要 Google 认证的 TCF v2.3 CMP，美国多州需要 Do-Not-Sell 链接。最快的合规配置，以及如何验证。
调自己的 API 报 CORS 错：定位与修复
浏览器 fetch 报 CORS 但 curl 正常。分清真正的原因，在服务端修好，并验证。
Cursor "Apply" 静默失败
点 Apply 之后文件没变也没报错——通常是基准快照过期、文件在外部被改、或写入被锁住。
Cursor 无法应用修改：6 个原因 + 对症修复
Cursor 能看到 diff，但 Apply 没反应、静默失败、或提示 The apply model made no changes to the file。最快修复：保存所有文件、关掉其他编辑器窗口，再点 Reapply。
修复 Cursor Composer 在大型 monorepo 里丢上下文
小仓库 Composer 很聪明，进了 5 万文件 monorepo 就丢线索。靠 @Files、MDC 规则和单包任务逼它聚焦，别赌索引重跑。
Cursor Composer 大刀阔斧改错
Composer 一次改 10+ 文件、把能跑的代码改坏。先用 Cursor checkpoint 或 git 快速回滚，再收紧 prompt 和模式让它保持外科级。
Cursor 配置与 VS Code workspace 设置冲突
切到团队仓库后 Cursor 的格式化或 AI 行为突然变了？是仓库的 .vscode/settings.json 覆盖了你的用户设置。本文教你定位是哪一层生效。
Cursor 上下文面板没带上你要的文件
Cursor 的 context 面板漏掉了你明知相关的文件。先用 @ 五秒救场，再断根：查 .cursorignore、resync 索引、给通用文件改名。
Cursor 的 diff 太大没法 review
Composer 一次甩出 30 文件 / 2000 行 diff，怎么 review 都不放心。先 reject（或 Restore Checkpoint），再让 Composer 把它拆成能 review 的小 PR。
Cursor 改完 build 挂了
Composer 说完成、改过的文件都过了 lint，但 build 失败。最快的修法：打开 Auto-run，让 agent 自己在收尾前跑 typecheck + build。
Cursor 生成重复逻辑，而不是复用已有 helper
Cursor 又写了一个 formatDate，但 src/utils 里早就有——已有 helper 根本没进检索。教你让它先 grep 再写、把现成的复用起来。
Cursor IDE 状态与磁盘不同步
AI 改完后编辑器还显示旧代码、保存提示「file modified externally」、或 AI 改动秒回滚——文件 watcher 和 AI 写入的竞态，以及怎样在不丢代码的前提下修好。
Cursor 索引一直跑不完：7 类原因和修法
Cursor 索引进度条转了几个小时不动，多半是仓库太大、没写 .cursorignore、公司 HTTP/2 代理被拦、symlink 环或权限不足。本文教你先判断属于哪一类再对症修。
Cursor 没读到整个项目：原因排查 + 修复路径
Cursor 只能改它能看见的文件。修好索引范围、从仓库根打开、用 @ 显式钉住文件即可。
Cursor 聊天读错文件
你 @ 一个文件但 Cursor 答的是另一个同名文件。用全路径引用 + 强制 resync 修好 @ 选择器、索引陈旧、symlink 三类原因。
Cursor 老是读错文件：分桶诊断 + 修复路径
Cursor 把旧 / 生成 / vendored 文件拉进 context 导致 patch 出错。靠 .cursorignore、重建索引和 @ 锁定来修。
Cursor 建议不符合仓库约定
Tab 补全和 Composer 改的命名 / 格式 / 模式都和仓库不一样——训练 prior 压过了检索信号，需要显式锚定。
Cursor Tab 不再联想
Cursor 灰色补全突然消失？重新开启 Tab、检查登录与额度、解决 Copilot 抢键、切到 HTTP/1.1、或清缓存。逐步排查，2026 年 6 月核实。
Cursor agent 终端命令行为不符预期
Cursor agent 跑 shell 命令跑错了——working dir 不对、用错包管理器、env 没加载、输出被截断，或 .zshrc 把命令卡死。给出具体修法。
自定义域名 SSL 一直卡在 Pending：真正的修复办法
在 Vercel / Cloudflare / Netlify 加完域名后 SSL 几小时不变绿？几乎都是 DNS、CAA 记录或 HTTP-01 验证被拦。按这个顺序排查。
部署成功但页面还是老内容：5 个原因 + 修复路径
Vercel / Firebase / Cloudflare 都说部署成功了，访客刷新还是昨天那版。本文给出按命中率排序的 5 类原因，以及一条从客户端到 origin 的 10 分钟诊断路径。
改了 DNS 但站还打不开：原因排查 + 对症修复
更新了 DNS 但站显示旧 IP 或打不开？先用 dig 验证、确认生效的 nameserver、清本地 + 浏览器缓存，再等旧 TTL 过期。一步步来，数据截至 2026 年 6 月。
DNS 传播：为什么各地区看到的 IP 不一样（附验证方法）
改完 DNS，有人看到新 IP、有人还是旧的。本文讲清楚为什么地区不一致是正常现象，并给一套可量化的修复与验证路径。
Edge function 超时：Vercel / Cloudflare / Netlify 修复
报 FUNCTION_INVOCATION_TIMEOUT 或 504？重活搬离 edge、用 streaming、给每个上游 fetch 加超时。各平台限制已核实（2026 年 6 月）。
生产环境变量缺失：5 个原因 + 修复路径
本地能跑、线上 500。要么宿主没设这个变量，要么客户端前缀不对（PUBLIC_ / VITE_ / NEXT_PUBLIC_）。10 分钟内排查并修好。
修复 Firebase 部署 "Permission Denied"（403）
firebase deploy 报 403 或 "caller does not have permission"？沿着身份链——账号、项目、IAM 角色、CI 认证——逐环排查，快速搞定。
Firebase Function not found：修复 region / 名字 / 部署不一致（2026）
Console 里明明有，调用却 not found。几分钟内排查 region、函数名和部署状态。
Firebase Hosting 部署失败
修复 firebase deploy --only hosting：CLI 版本、登录过期、public 路径错、Spark 配额。
Firebase Hosting rewrite 不生效
2026 最新：firebase.json 里 SPA / 函数的 rewrite 没触发——几分钟内修好顺序、region 和部署目标。
Gemini 在 Android 上没替换 Assistant
长按 home / 电源没出 Gemini——开关、应用版本、地区。
Gemini App 和 Web 显示的对话不一样
同一个 Google 账号，手机 App 和 gemini.google.com 看到的对话列表不同。账号不一致、2026 年的同步覆盖 Bug、Keep Activity、Workspace 策略能解释绝大多数情况。
Gemini Deep Research 结果太浅
深度调研输出空泛？用 scope、来源过滤、分维度 follow-up 解决，并选对新版 Deep Research Max（Gemini 3.1 Pro）。
Gemini 文档总结太泛？这样写 prompt 才有干货
Gemini 总结漏掉关键数字、跳过风险章节？告诉它抽什么、按什么结构输出就能解决。附实测 prompt、模型选择修法和核实步骤，2026 年 6 月更新。
Gemini 分享 / 导出不可用
Gemini Share 按钮灰了 / 不见、g.co/gemini/share 链接 404、或 Export to Docs 失败。按账号类型、Workspace 策略、源对话状态逐步排查。
Gemini 文件上传失败 / 返回内容不对
上传成功但 Gemini 读不到，或总结离谱？逐一排查大小上限、格式、Drive 权限和扫描件 PDF。
修复 Gemini Google 账号权限报错（Gmail / 日历）
Gemini 提示"权限被拒绝"或无法访问账户？重新连接应用、打开 Gemini Apps Activity 与 Gmail 智能功能、排查 Workspace 策略。
Gemini 图像生成不可用或被拒
Gemini 不生成图、没有 Create image 按钮、或回 'I can't generate that image'——分清 Safety filter、地区、账号档位、Workspace 四道关卡再修。
Gemini 没响应怎么办：快速排查（2026 年 6 月）
Gemini 一直转圈或返回空白卡片？按账号、网络、浏览器、Workspace 策略的顺序排查，多数情况五分钟内能解决。
Gemini 配额用尽 / 今日不可用
Gemini 提示"稍后再试"或"功能不可用"，几乎都是配额或档位问题，不是平台挂了。教你怎么判断是哪种，以及最快的修法。
Gemini 边栏在 Workspace (Docs/Gmail) 不显示 2026
Docs / Gmail 没有 Gemini 边栏？检查版本、管理员 Feature access 开关和 Smart features。修复顺序在文内。
Gemini 回复语言不对怎么办：原因 + 修复路径
中文问、英文答（或反之）。prompt 开头加一句 Reply in Chinese 即可立刻修好，再把账号语言和浏览器语言对齐让它长期生效。
Git commit 改坏了，怎么找回旧版本
你 commit 覆盖了要保留的代码，或 reset --hard 选错了 commit。多数情况下 object 还在仓库里。先用 `git log -p --follow -- <file>`，整段 HEAD 不见了就用 `git reflog`。
Google 改写了我的标题——如何拿回（2026）
Google 在搜索结果里把你的 title 换成了更短 / 不同的。搞清楚是哪个信号触发了改写并修掉——含 2026 最新长度预算与新出现的 AI 标题行为。
Search Console 里的 hreflang 报错：报告没了，现在怎么修
Google 在 2022 年下线了 International Targeting 报告，hreflang 错误不再显示在 Search Console 里。本文教你改用爬虫工具找出 No return tags、语言码无效、目标 404 等错误，并逐一修复。
IAP 沙盒购买失败：7 步诊断顺序
沙盒 IAP 有七个环节必须对齐：设备上的 Sandbox Apple Account、地区、App Store Connect 协议、产品状态、bundle ID、capability、StoreKit 配置文件。诊断顺序，已对照 iOS 18+ 与 Xcode 16（截至 2026 年 6 月）。
审核 AI 生成的 diff 该按什么顺序看
Claude Code 或 Cursor 给的 200 行 diff，编译过不等于安全。先看删除，按风险递减的顺序读。
本地能跑、生产挂：系统化排查清单
本地 npm run dev 全绿，部署到 Vercel / Render / Cloudflare Pages 就 build fail 或功能全坏。先本地复现生产 build，再 diff 环境变量、锁 Node 版本、修 Linux 大小写敏感——一份系统化清单。
长 Prompt 反而变差：怎么改 Prompt 结构
Prompt 写得很详细，回答却变得泛、跑题、像在复述指令。本文讲清楚长 prompt 为什么会稀释，以及真正有效的结构性改法。
Prompt 越长效果越差怎么办：长度悖论的 4 个原因和 5 条修复路径
你写了一份比 100 字详细 5 倍的「超级 prompt」，输出反而更糟？这是 LLM 的长度悖论。本文讲清原因，并给出 2026 年 6 月仍然有效的 5 条修复路径。
Google 替换了我的 meta description
Google 在搜索结果里用自己生成的 snippet 替换你的 meta。判断命中了 7 个触发条件中的哪个，重写后把 snippet 抢回来。
多 Agent 冲突：两个 agent 改了同一份文件
Claude Code + Codex（或两个并行 session）改了同一个函数、产生 merge 冲突。用 git worktree 隔离 scope、abort 掉坏掉的 merge、由人来 resolve——绝不让 agent 自己合并。
两个 AI agent 改了同一个文件：干净合并
Cursor 和 Claude Code 把同一个文件互相覆盖了。停掉两边、各自找回意图、按 hunk 合并，再用 worktree 隔离 agent，杜绝复发。
MX 记录被覆盖——入站邮件断了
改完 DNS 后 MX 没了、邮件收不到。教你判断属于哪种情况，并按 Google Workspace / Microsoft 365 / Zoho / Fastmail / Proton 恢复正确记录。
分享链接时 OG 图不显示：排查清单
在 Slack、X、LinkedIn、Facebook 分享 URL 时没有预览图。7 个真实原因，以及对应的排查命令和缓存刷新工具。
OG 图片在社交分享时不显示：3 类原因 + 修复路径
分享到 LinkedIn / X / Slack 没图。几分钟内修好 meta 标签、尺寸或缓存。
Prompt 触发了拒答——怎么换个写法
合法任务被拒答或只给半截答案？这里有最快的重写法、触发词替换表，以及该换哪个模型（2026 年 6 月）。
修复第三方 API 的 429 限流错误
Stripe、Twilio、SendGrid 在流量上来时都会返回 429。按顺序处理：读限流响应头、加带抖动的指数退避、缓存幂等 GET、去重并发请求、批量写——每条都附可运行代码。
部署后重定向不生效：6 个原因 + curl 排查
vercel.json 或 _redirects 里的 301 部署后变 404 或还显示旧页面。用 curl -I 在 Vercel / Netlify / Cloudflare Pages 上逐一定位：文件位置、规则顺序、文件遮蔽、CDN 缓存、trailing slash、rewrites 与 redirects 混用。
robots.txt 不生效：先分清是哪一层缓存
改了 robots.txt 但 Google 还在爬同一批 URL，几乎都是缓存或重复文件的问题。本文用一条 curl 帮你定位是 CDN 缓存、Google 自己的 24 小时缓存，还是项目里有两份 robots.txt 互相覆盖。
RSS feed 返回 404：定位三大原因 + 修复 /rss.xml
/rss.xml 或 /feed.xml 返回 404：端点没进 build、文件名和 link 标签不一致，或宿主 rewrite 把它挡住了。针对 Astro、Next.js、Netlify、Vercel 的分栈修复。
sitemap.xml 找不到（404）：5 个原因 + Astro 修复路径
/sitemap.xml 或 /sitemap-index.xml 返回 404，或 Search Console 显示 'Couldn't fetch'。按命中率排的 5 个原因，每个都能直接在 dist/ 验证。
绑了自定义域名但 SSL 一直 pending：按命中率排查 + 对症修复
Vercel / Firebase / Netlify 绑域后 SSL 卡在 pending。先用 dig 验 DNS、把 Cloudflare 橙云改成灰云，再按清单排查 CAA、记录类型、AAAA、HSTS。
部署后静态资源 404：5 个原因 + 修复路径（Astro/Vite）
图片、CSS、字体在生产环境 404，本地却正常。5 个已核实的原因和修复：没进 dist、base 路径、大小写、content hash、CDN 缓存。
静态站打开是白屏：10 分钟定位根因
线上 URL 打开后 title 闪一下就剩白屏、没有任何 UI 报错。先在打开页面前开好 DevTools，读 Console 第一条红色错误，再对照表格定位是 base path、水合、CSP、build target 还是旧 Service Worker。
对象存储上传被拒（S3 / Firebase / Supabase 403）
修复 S3、Firebase Storage、Supabase Storage 上传 403——IAM 权限、签名 URL 过期、bucket 策略，以及 ACL 已禁用的坑。
修复 Rich Results Test 的警告和错误（JSON-LD）
Rich Results Test 显示 JSON-LD 有警告 / 字段无效。先分清错误和警告，再逐条修。
子域名不解析：blog.example.com 打不开
根域名正常，但 blog.example.com 报 NXDOMAIN 或 SSL 错。原因几乎都是少了一行 DNS 记录，或者忘了在主机端绑定域名。按五类逐一排查。
Suno Extend 接得不自然：修好衔接
Suno Extend 接的是切点处的音频加上 style 文本，不是整首歌的灵魂。切点、锁 style、Get Whole Song 这几招把衔接磨平。
Suno 编曲和情绪不搭：用 Style + Exclude 修复
伤感歌词配欢快编曲？把情绪、BPM、调式写进 Style of Music，再用 Exclude Styles 并拉高 Style Influence。
Suno 没唱我写的歌词？Custom Mode 修复
你写了歌词，Suno 却唱了别的。开 Custom Mode、给每段加方括号结构标签、让歌词长度对上歌长即可。
Suno 结尾不自然：修复突兀停顿或粗暴 fade
Suno 要么"啪"地停在乐句中间，要么 3 秒粗暴 fade。最快修复：歌词末尾写带描述的 `[Outro]`，再在最后一行加 `[End]` 标签，必要时用内置 Fade Out 工具。完整原因、模板与验证见正文。
Suno 歌曲结构弱：修复扁平的能量曲线
Suno 出的歌 3 分钟全在一个能量上、副歌没爆发？把结构标签放进 Lyrics 字段、再给 Style 加动态词。附模板、比例和 v5.5 编辑器修法。
Suno 风格描述词被忽略：原因 + 修复路径
写"synthwave, retro, 80s synth"出来却是钢琴抒情。Suno 为什么丢掉 style 词，以及真正管用的修法（v5.5，2026 年 6 月）。
Suno 歌曲太重复：同一副歌唱 6 遍的修复
Suno 一字不差地重复副歌，是因为你的歌词本身在重复。从歌词、旋律、结构三层打破循环，或用 Replace 只修一段。
Suno 唱中文发音不对：原因诊断 + 修复路径
Suno 把多音字、声调、中英混排都唱错。最快解法：用 v5.5 生成、在歌词里提前把易错字改写或注音、每行写短。附完整诊断表 + 修复步骤。
Suno 人声机械感修复（v5.5）
Suno 人声塑料感、辅音清脆得像 TTS——是 style 触发了合成人声分支。清除 vocoder 暗示词、加自然换气、调整歌词节奏，让人声回归自然。
Suno 输出风格不对：流派词排序修复法
Style 里写了 lo-fi hip-hop 出来却是普通 pop。把流派词放第一位、补上 BPM、再用 Exclude Styles 字段删掉冲突乐器，就能修掉绝大多数风格漂移。
Supabase RLS 返回空数组（还不报错）
Supabase 表里明明有数据，前端 select 却拿到 [] 且不报错。对照表判断你属于哪一类 RLS 问题，加对 SELECT policy，几分钟搞定。
Supabase 环境变量生产环境 undefined 的修复
部署后 Supabase URL 或 anon / publishable key 变成 undefined——修宿主 env 配置、框架前缀、旧 build，以及 2026 新 key 迁移。
TestFlight build 卡在 "Processing"：8 个原因 + 解卡清单
上传到 TestFlight 的 build 几小时一直 Processing？这里是 8 个真实原因和一份精确的解卡清单，更新至 2026 年 6 月。
trailing slash 不一致：修掉来回跳转的死循环
/foo 308 跳到 /foo/，又 308 跳回 /foo。框架、宿主、内链三处用同一条规则即可终结跳转链，附 Astro/Vercel/Next.js 配置。
Vercel 500 错误：快速定位真正原因
Build 全绿但线上 500。用真实的 vercel logs 命令定位 FUNCTION_INVOCATION_FAILED、env vars 缺失、Edge runtime 和超时问题。
Vercel 卡在 Building
Build 停在 Building、log 不出新行。先取消、看最后一行 log，再对症修：static generation 里没超时的 fetch、install 死锁、OOM 或 postbuild 钩子。
Webhook 收不到：provider 显示 200，你的端点却没动静
Stripe、GitHub、Shopify 都说投递成功了，server 却没收到。先看投递日志里的状态码，再对症修复。
什么时候申请 AdSense——准备清单（2026）
申请太早会吃 'low-value content' 拒信，太晚又白白损失几个月广告收入。点 Apply 之前先跑完这六项信号自检。
www 与根域名不一致（只有一个能打开）：定位 + 修复
www.example.com 通但 example.com 报错（或反过来）。先补上缺失的 DNS 记录，再加一条 301 重定向把流量统一到一个 canonical 版本。
AdSense "低价值内容"被拒：到底什么意思，怎么恢复
解码 2026 年最常见的 AdSense 拒因——审核员到底看哪些地方、Information Gain 和 E-E-A-T 怎么起作用，以及一份能跑通的四周恢复计划。
Crawled currently not indexed 怎么办——真正的原因和修复
Google 爬了你的页面但决定不收录。原因几乎总是内容质量、重复、或权威——不是技术问题。真实的修复清单。
Discovered Not Indexed：新独立站的实战手册
Google 为什么把新独立站 URL 挂在「Discovered — currently not indexed」里，以及真正能把它们移出去的多周打法：内链、crawl budget、内容深度和现实时间表（2026 年 6 月）。
Google 不抓取新页面：排查清单
发了新页面 Google 不理你时的可复现排查清单。按顺序走，遇到第一个不通过就停下来修。2026 年 6 月核实。
域名解析多久生效（2026）：24 小时是误传，超 30 分钟就是配错
「24 到 48 小时」是民间传说。现代 DNS 改记录几分钟就生效。超过 30 分钟还不通就是配错了——本文教你用几条 dig 命令证明是哪种情况。
Search Console URL Inspection 怎么读才对
URL Inspection 告诉你 Google 存了什么、何时爬过、为什么收没收录。每个字段怎么读，外加批量检查的 API 调用（2026 年 6 月）。
ChatGPT 打不开怎么办：六步排查路径（地区 / DNS / Cloudflare）
ChatGPT 打开空白、一直转圈或报 access denied？按这条六步路径排查：状态页、无痕、扩展、DNS、VPN 节点、设备。
ChatGPT 登录失败怎么办：邮箱 / Google SSO / OTP 验证码 / suspicious activity 四类
ChatGPT 登录失败按报错分四类排查：邮箱密码 bounce、Google/Microsoft SSO 报错、新增的 6 位 OTP 验证码收不到、suspicious activity 风控锁定。先对号入座，再走最短修复路径。