ChatGPT 登录循环——登进去又跳回登录页
密码对了、SSO 成功，但页面又跳回登录界面？90% 是 cookie、第三方存储或缓存的旧会话出了问题。
常见问题解决库
收集常见软件报错、设置教程、工具疑难杂症的解决方案，少走弯路。
753 篇文章
搜索一句报错信息时，最让人崩溃的就是翻到一篇"我也遇到了，求解"的旧帖。这个栏目专门给你结论：到底是什么问题、最短修复路径、为什么会这样。 主题包括：网站收录异常、AI 工具配置失败、CLI 工具登录问题、域名 / DNS / 部署故障、跨平台差异。 我们尽量在每篇结尾附"如何避免下次再遇到"的清单，把一次性救火变成可复用的经验。
二级专题
ChatGPT 常见问题
ChatGPT 打不开、登录失败、network error、文件上传失败、图片生成等。
ChatGPT 账号与登录问题
ChatGPT 登录循环、验证邮件、cookie 拦截、session 过期、账号切换、密码重置、白屏、浏览器差异。
ChatGPT 文件与 Projects 问题
PDF 分析、Projects 指令、文件检索、文件消失、文件类型、下载失败、大文档、跨文件比较、图片识别、数据文件。
Claude / Claude Code 常见问题
Usage limit、回答不准、文件、GitHub 连接、Connector 权限、Claude Code 上下文。
AI 编程工具问题
Cursor、Codex、Claude Code 应用修改失败、indexing 卡住、改错文件、回滚。
建站与部署问题
Vercel build、Firebase Hosting、Astro 部署、路由 404、sitemap、robots.txt。
Google 收录与抓取问题
URL unknown、Crawled / Discovered not indexed、Sitemap 提交不收录、孤儿页、分类页 / 标签页未收、新站延迟。
AI 生成内容问题
AI 图片不像提示词、人物脸崩、风格不统一、视频不连贯、Suno 副歌不抓耳、长 Prompt 失效。
Gemini 常见问题
Gemini 没响应、文件上传、Workspace 集成、图片生成、语言混乱、配额问题。
Suno / AI 音乐生成问题
歌曲太短、副歌不抓耳、歌词不被采用、风格走偏、人声机械、Outro 突兀。
AI 图像生成问题
手部、人脸、文字、风格、长宽比、构图、商品 / 人物一致性问题。
AI 视频生成问题
动作不连贯、镜头抖动、人物漂移、图转视频偏离、画面闪烁、转场生硬。
Firebase / Supabase / 后端问题
Firebase 权限、rewrite、Functions、Supabase RLS、CORS、Edge Function。
AdSense 审核与广告投放问题
拒审、Low value content、ads.txt、Auto Ads 位置、空广告位、双域名混乱、隐私政策、静态站广告位不渲染。
Claude Code 与 Agent 工作流问题
Agent 卡循环、误改文件、上下文断裂、多 Agent 冲突、回滚、Plan 模式问题。
Codex / Coding Agent 问题
Codex 不照项目结构、收尾不干净、复制文件、读不懂 build、不安全假设、review 太浅、测试太泛、patch 冲突、style 不匹配、审计太广。
Cursor / IDE 工具问题
Cursor indexing 卡住、apply 失败、读错文件、上下文不全、Composer 误改。
SEO Metadata 与结构化数据问题
Title / meta 被 Google 改写、canonical 与 hreflang、noindex 错配、Breadcrumb / FAQ / WebSite JSON-LD、OG 图、日期不一致。
域名、DNS 与 SSL 问题
DNS 传播、SSL 延迟、www vs root、CNAME 错配、换域名后 canonical / sitemap / RSS 旧域名、双域名收录、平台差异。
内容站运营质量问题
薄页面、分类页弱、孤儿页、重复 title、过期文章、内链分布、双语漂移、标签页太多、AI 内容质量、低价值 URL。
App Store / TestFlight 问题
TestFlight 测试、App 审核条款、IAP / 订阅、产品页元数据与隐私的完整问题中心。
AI Prompt 质量问题
Prompt 写不对导致的输出问题：清晰度、结构、输出控制、行为修复，配 Before / After 示例。
Agent 工作流与编排问题
Agent 编排、Handoff、预算耗尽、并行冲突、状态不一致、Trace 丢失、Checkpoint 损坏。
Git 与版本控制问题
合并冲突、Rebase 丢提交、Force push 覆盖队友、detached HEAD、LFS、Submodule、大文件、CRLF。
Prompt 注入与 AI 安全问题
Prompt 注入、间接注入（PDF/网页/文件名）、Tool poisoning、密钥泄露、Role confusion、MCP 供应链。
本地 LLM 运行时问题
Ollama、LM Studio、llama.cpp、vLLM、MLX——模型加载、GPU、显存、量化、chat template、tool calling。
本栏目精选
ChatGPT 上传的 PDF 分析不正确
PDF 上传成功但 ChatGPT 漏读表格、跳页、数字错——多半是抽取层而不是模型本身的问题。
Claude Code 因额度耗尽中途停下：6 类 limit + 可恢复任务设计
重构做一半 Claude Code 提示额度用完——分清是 5 小时 / 周 / 单模型哪种 limit，立刻 dump 状态，按对应路径恢复。
Claude Code 卡在循环里：6 种 loop 签名 + 各自的一句话破解
Agent 反复同样 edit、来回切换两个文件、永远追 flaky 测试——6 种 loop 签名各有诊断和 one-prompt 破法。
Codex 不照你的项目结构来：6 个原因 + AGENTS.md 模板
新文件落到 `/src/` 但你的 repo 用 `/app/`；monorepo 里依赖被加到根 `package.json`；测试用了你没装的框架——用 AGENTS.md + canonical example 指针修。
Cursor Composer 在大项目里晕头转向
小仓库 Composer 很好用，5 万文件 monorepo 里就丢线索——靠显式上下文，别赌索引。
最新更新
Agent 预算在任务中途被吃光
Agent 执行长任务时 token 或费用预算耗尽，任务强制中止且无中间结果可用。本文分析预算失控的根因并给出限额与断点续传方案。
Checkpoint 恢复出来的状态是损坏的
Agent 从 checkpoint 恢复时，加载出来的状态字段缺失、类型错误或值异常，导致 workflow 以错误状态继续执行，产生难以追踪的下游错误。本文分析 checkpoint 损坏的根因并给出写入和恢复的防御方案。
成本统计漏算了子 Agent 用量
多 Agent 系统的成本仪表盘只显示主 Agent 的 token 消耗，子 Agent 和工具调用产生的费用没有被归因，导致月度账单远超预算但无法定位超支来源。本文分析成本归因断层的根因并给出全链路追踪方案。
Agent 调用图出现循环但没人发现
多 Agent 系统中，Agent 之间的调用关系形成了有向环，导致任务无限循环、token 持续消耗，直到预算耗尽才暴露问题。本文分析循环产生的原因并给出静态检测和运行时防护方案。
Agent 交接时上下文丢失了
多 Agent 流水线中，子 Agent 接手任务后丢失关键背景，导致重复询问或输出偏离预期。本文逐步拆解丢失原因并给出可落地的修复方案。
Agent 把 API key 明文写进输出
助手在对话或文件中输出了明文 API key——定位密钥泄露路径并通过 redaction filter 和 secret 管理规范防止密钥进入 prompt 上下文。
Agent 编排器互相等待出现死锁
多 Agent 系统中两个或多个 Agent 互相等待对方的输出，整个流水线挂起不前进。本文分析死锁成因并提供超时、优先级和拓扑检测方案。
Agent 输出里夹带了 secret
Agent 在生成代码、文档或日志时，把 API key、密码、token 或其他敏感凭证输出到了对话记录、trace 日志或下游系统里，造成安全风险。本文分析 secret 泄漏的触发路径并给出检测和阻断方案。
全部文章
Agent 预算在任务中途被吃光
Agent 执行长任务时 token 或费用预算耗尽，任务强制中止且无中间结果可用。本文分析预算失控的根因并给出限额与断点续传方案。
Checkpoint 恢复出来的状态是损坏的
Agent 从 checkpoint 恢复时，加载出来的状态字段缺失、类型错误或值异常，导致 workflow 以错误状态继续执行，产生难以追踪的下游错误。本文分析 checkpoint 损坏的根因并给出写入和恢复的防御方案。
成本统计漏算了子 Agent 用量
多 Agent 系统的成本仪表盘只显示主 Agent 的 token 消耗，子 Agent 和工具调用产生的费用没有被归因，导致月度账单远超预算但无法定位超支来源。本文分析成本归因断层的根因并给出全链路追踪方案。
Agent 调用图出现循环但没人发现
多 Agent 系统中，Agent 之间的调用关系形成了有向环，导致任务无限循环、token 持续消耗，直到预算耗尽才暴露问题。本文分析循环产生的原因并给出静态检测和运行时防护方案。
Agent 交接时上下文丢失了
多 Agent 流水线中，子 Agent 接手任务后丢失关键背景，导致重复询问或输出偏离预期。本文逐步拆解丢失原因并给出可落地的修复方案。
Agent 把 API key 明文写进输出
助手在对话或文件中输出了明文 API key——定位密钥泄露路径并通过 redaction filter 和 secret 管理规范防止密钥进入 prompt 上下文。
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 缺失的根因并给出完整追踪方案。
通过 roleplay 绕过内容过滤器
用户使用角色扮演框架让 AI 生成了被内容策略禁止的内容——检测 roleplay 绕过的模式并通过虚构/现实边界声明和输出侧内容检测加以防御。
AI 听从了上传文件里的恶意指令
用户上传的文档让 AI 执行了非预期操作——检测文件内嵌指令的攻击模式并通过文件内容隔离和执行权限分离防止文件成为注入载体。
AI 无意中协助生成了钓鱼文案
AI 在帮助用户生成营销邮件或网页副本时输出了可用于钓鱼攻击的内容——识别这类误辅助的触发模式并通过意图检测和输出审核加以防御。
通过图片 URL 把数据外发
Agent 生成了包含敏感信息的图片 URL 请求——识别 URL 外发攻击链并通过出站请求过滤和渲染沙箱切断数据泄露路径。
Bisect 在 skipped commit 上卡住
git bisect 二分查找 bug 时，因为大量 commit 无法构建而反复执行 skip，最终 bisect 无法确定 first bad commit 就退出了。本文给出绕过 skip 区间、精准定位 bug 引入点的操作技巧。
分支保护规则让我的 PR 合不了
PR 所有 review 都通过了，CI 也是绿色，但合并按钮还是灰色或提示保护规则未满足。本文逐一拆解 GitHub、GitLab、Bitbucket 的分支保护规则，给出快速诊断和解决方案。
Cherry-pick 解冲突后变成空 commit
cherry-pick 遇到冲突，手动解决后执行 --continue，结果提示 'nothing to commit' 或产生了一个空 commit。本文解释空 commit 的触发机制，给出正确处理流程和跳过方式。
凭证 helper 锁住，pull / push 全失败
git pull 或 push 时反复弹出密码提示或报 403 / 401，明明凭证正确却始终认证失败，甚至凭证 helper 进程锁住导致操作卡死。本文给出清理缓存凭证、重置 helper 配置的完整修复方案。
我在 detached HEAD 上提交了，怎么办
切换到某个 commit 或 tag 后不小心创建了新提交，切换分支后这些 commit 消失了。本文讲清楚 detached HEAD 的本质，给出用 reflog 找回并挂回分支的完整操作。
Force push 覆盖了队友的 commit
执行 git push --force 后发现远端分支丢失了队友刚推送的提交，其他人拉取后工作消失。本文给出找回 commit、通知团队同步的完整操作步骤和防护机制。
Clone 之后 git hooks 不执行
团队配置了 pre-commit、commit-msg 等 git hooks，但新成员 clone 后这些 hooks 从不触发，代码质量检查和格式化完全失效。本文解释为什么 hooks 不随 clone 传播，并给出正确的团队 hook 分发方案。
历史里的大文件让 push 失败
某次 commit 误提交了大文件，之后每次 push 都被 GitHub 或 GitLab 拒绝，提示文件超过 100 MB 限制。本文给出用 git-filter-repo 彻底清除历史大文件的完整修复方案。
Git LFS pointer 文件没被真实文件替换
clone 或 checkout 后发现图片、模型等大文件变成了几行文本（LFS pointer），程序运行时报「无效文件格式」。本文解释 LFS smudge filter 机制，给出强制拉取真实内容的完整修复步骤。
CRLF 转换让单次 commit 产生几千行 diff
切换分支或 git pull 后，git diff 显示几千行改动，但实际上只是换行符从 LF 变成 CRLF 或反过来。本文给出统一换行符配置、消除噪音 diff 的完整修复方案。
二进制文件合并冲突 — 手动无法 resolve
合并分支时遇到 PNG、PDF、Excel 等二进制文件冲突，Git 无法生成可读 diff，导致 merge 卡死。本文给出明确选边、工具 diff、预防策略的完整修复路径。
Monorepo partial clone 数据过期
使用 git clone --filter 做 partial clone 的 monorepo 在 fetch 后发现某些包的文件缺失或停留在旧版本，CI 构建莫名报错找不到文件。本文解析 partial clone 的延迟加载机制并给出强制同步方案。
git pull --rebase 让冲突历史变乱
执行 git pull --rebase 后解决冲突，结果 git log 里出现了重复提交、commit 顺序颠倒或时间戳混乱，团队历史难以追溯。本文解释 rebase 冲突解决的正确流程并给出清理方案。
Rebase 之后 commit 消失了
执行 git rebase 后发现部分提交从分支历史消失，log 里找不到。本文用 reflog 精准找回丢失 commit，给出完整恢复和预防方案。
Revert merge commit 提示需要 -m parent
执行 git revert 撤销一个 merge commit 时报错 'commit is a merge but no -m option was given'。本文解释 -m 参数的含义，给出正确选择 parent 编号和处理后续分支重合并的完整方案。
我把 secret 推到公开仓库了
API key、数据库密码、私钥等敏感信息被 git push 到了公开仓库，即使马上删除文件并重新提交，历史里依然可以被找到。本文给出立即响应的分钟级操作步骤和彻底清除历史的方案。
Stash 在 checkout 之后看不到了
git stash pop 或切换分支后，stash 列表里的条目消失，改动找不到了。本文解释 stash 的存储机制，给出从 reflog 找回丢失 stash 的完整操作步骤。
Submodule 怎么都拉不到最新 commit
git submodule update 执行成功却发现 submodule 停留在旧 commit，或者 clone 后 submodule 目录为空。本文解析 submodule 指针机制，给出强制同步和日常维护的完整方案。
Tag 指向了错误的 commit
打 release tag 时选错了 commit，或者 tag 被推送到错误的位置，导致发布版本与代码不符。本文给出删除旧 tag、重新打标、通知团队同步的安全操作步骤。
Worktree 在分支删除后变成幽灵
git worktree 对应的分支被删除后，worktree 目录还在磁盘上，git worktree list 显示为损坏状态，相关 git 操作全部报错。本文给出清理幽灵 worktree 和预防悬空 worktree 的完整方案。
PDF 里夹带的 Prompt 注入
AI 处理上传 PDF 后行为突然改变——检测 PDF 隐藏文本注入的方法与通过内容隔离、元数据审计防御间接注入的实践。
Web fetch 抓到的页面里藏的注入
Agent 抓取外部 URL 后行为异常——识别间接注入如何藏在网页正文里并通过 fetch 沙箱和内容隔离加以防御。
搜索结果 snippet 被用作注入载体
AI 调用搜索工具后行为异常——识别搜索结果摘要中嵌入的注入指令并通过 snippet 隔离和搜索 API 沙箱防御间接注入攻击。
翻译往返中被注入指令
AI 翻译工具在处理外部内容后行为异常——识别翻译管道中的间接注入路径并通过内容隔离和翻译输出审核防止注入指令借助翻译工具传播。
llama.cpp 在网络盘上 mmap 失败
llama.cpp 从 NFS、SMB 或 CIFS 挂载的网络盘加载模型时报 mmap failed 错误。定位文件系统 mmap 限制、改用流式加载或本地缓存的修复方案。
llama.cpp 换更激进量化后质量明显下降
从 Q8_0 换到 Q4_K_M 或 IQ4_XS 后，模型输出质量骤降、逻辑错误增多。通过基准测评、量化选择与参数补偿策略恢复可用质量。
LM Studio 加载模型时显存 OOM
LM Studio 加载 GGUF 模型时报 out of memory 或直接崩溃。从显存估算、GPU offload 层数、量化选择三个维度给出可执行的修复方案。
本地 embedding 服务在 batch 请求下崩溃
本地 embedding 服务处理单条请求正常，批量请求时 OOM 崩溃或返回 500 错误。从 batch size 限制、显存管理、序列长度截断三个维度定位并修复问题。
Chat template 不匹配导致输出全是乱码
本地 LLM 输出大量重复符号、乱码或毫无意义的 token 序列。通常是 chat template 格式与模型不匹配所致，定位模板来源并强制指定正确格式即可修复。
多 GPU 没分配上，模型只跑在卡 0
本地 LLM 服务在多 GPU 机器上启动后，所有计算只在第一张卡上进行，其他卡显存占用为零。从 tensor parallel 配置、NVLink、环境变量三个层面给出强制分布的修复方案。
本地模型输出在 token 中间被截断
本地 LLM 在输出中间突然停止，响应不完整，有时在单词或汉字中间截断。定位 max_tokens 限制、EOS token 误触、流式传输缓冲三类根因并给出修复方法。
RoPE scaling 设错让长上下文输出乱掉
本地模型处理超过原生上下文长度的输入时输出开始乱码、重复或完全随机。RoPE scaling 参数配置错误是主因，给出正确参数对照和验证方法。
本地模型冷启动后首 token 极慢
本地 LLM 第一次请求时等待 10-60 秒才开始输出，后续请求正常。定位模型加载、KV cache 预热、GPU 初始化等冷启动瓶颈并给出可执行的优化方案。
Tokenizer 版本不一致导致 token 计数对不上
本地模型的 token 计数与 API 端不一致，导致截断位置错误或上下文溢出。从 tokenizer 版本管理、GGUF 内嵌 tokenizer 与外部库的差异给出对齐方案。
本地模型不遵守 tool calling 格式
本地 LLM 收到 tool calling 请求后，返回纯文本描述而不是 JSON 格式的工具调用，或者格式错误导致解析失败。从模型能力、prompt 格式、解析容错三个层面给出修复方案。
本地 RAG 索引重建慢到无法忍受
本地 RAG 知识库重建时间从预期的几分钟变成数小时。从 embedding batch 策略、向量库写入、文档分块三个瓶颈排查并给出可量化的提速方案。
第三方 MCP server 被供应链攻破
已信任的 MCP server 包或版本被植入恶意代码——通过版本锁定、代码审计和运行时沙箱检测并隔离供应链攻击对 Agent 环境的影响。
MLX 转换 HuggingFace 模型失败
在 Apple Silicon 上用 mlx_lm.convert 将 HuggingFace 模型转换为 MLX 格式时报错或转换后无法加载。定位架构支持、内存不足、量化配置三类失败原因并给出修复步骤。
多轮对话逐步升级到越权
对话在若干轮之后助手开始执行单轮被拒绝的操作——检测多轮渐进式越权攻击的信号并通过会话状态监控和权限重置机制加以防御。
Ollama 探测不到 GPU，全跑在 CPU
Ollama 启动后模型在 CPU 上运行，生成速度极慢。定位 CUDA/ROCm 驱动缺失、环境变量遮蔽、多显卡配置等根因并给出可执行修复命令。
Ollama 下载模型卡在某个百分比
Ollama pull 模型时进度条停在某个百分比不动，重试后依然卡住。分析网络、磁盘、注册表三类原因并给出可直接执行的修复步骤。
Ollama pull 成功但 list 看不到
ollama pull 命令返回成功，但 ollama list 输出里没有这个模型，运行时报 model not found。定位 manifest 写入失败、多 OLLAMA_MODELS 路径、权限问题等根因。
Ollama 启动报 port already in use
执行 ollama serve 时报 address already in use，端口 11434 被占用无法启动。快速定位占用进程、清理僵尸实例、修改默认端口的完整操作步骤。
Ollama Modelfile 里的 SYSTEM prompt 被忽略
在 Ollama Modelfile 中设置了 SYSTEM prompt，但模型运行时完全不遵守设定的人格或行为规则。定位 template 覆盖、API 参数优先级、chat template 兼容性三类根因。
两个并行 Agent 同时改一份文件
多 Agent 并行执行时对同一文件并发写入，导致改动互相覆盖或产生 git 冲突。本文分析冲突根因并给出文件锁、任务分区和冲突恢复方案。
注入绕过了 system 指令
攻击性输入成功覆盖了 system prompt 中的规则——定位信任层级配置缺陷并通过 prompt 加固与输出监控重建 system 指令的权威性。
代码注释里藏的指令影响了 AI 行为
AI 审查或生成代码时受到注释中嵌入指令的影响——检测代码注释注入的特征并通过代码内容隔离和注释过滤防止代码成为攻击载体。
文件名里藏 Prompt 注入
上传文件的文件名包含注入指令导致 AI 行为异常——检测文件名注入的特征并通过文件名清洗和展示隔离防止文件名成为攻击载体。
用户粘贴内容里的 Prompt 注入
用户把外部文本粘进对话，AI 随即改变行为——如何检测这类直接注入事件并通过输入清洗与边界隔离把风险降到最低。
Secret 被无意写入 prompt 上下文
API key、数据库密码或 token 不经意间出现在 prompt context 里——识别 secret 进入 context 的常见路径并通过 redaction 和 secret 注入规范从源头阻断泄露。
Role confusion 把 user 输入升格为 system
用户通过角色声明让 AI 把自己的消息当作 system 级指令执行——检测角色混淆攻击并通过结构化消息格式和角色声明过滤加以防御。
Tool 返回被当成可信用户输入
工具调用返回的外部数据被 Agent 当作可信指令执行——识别工具输出的信任升级问题并通过角色标注和内容隔离防止外部数据控制 Agent 行为。
恶意 MCP server 重定义 tool 行为
接入第三方 MCP server 后 Agent 工具行为发生异常变化——检测工具定义被篡改的方法与通过 schema 固化和权限隔离防御 tool poisoning。
User 输入被当成 system 指令执行
普通用户的输入触发了只有系统层才应执行的操作——定位 prompt 结构缺陷并通过消息角色隔离和参数化 prompt 防止信任边界崩溃。
vLLM 报 context length exceeded
vLLM 服务返回 context length exceeded 错误，请求被拒绝。从 max_model_len 配置、KV cache 分配、prefix caching 三个层面排查并给出具体修复参数。
vLLM 启动报 CUDA 版本不匹配
vLLM 启动时报 CUDA 版本不兼容错误，ImportError 或 undefined symbol。从 CUDA 工具链版本对齐、wheel 选择、conda 环境隔离给出完整修复步骤。
ChatGPT 回答中途截断：为什么会断 + 最快接回去的方法
ChatGPT 中途停下来，原因多半是单次 token 上限到了、模型自以为说完了、或者流断了——按这个顺序排查。
ChatGPT 账号删了但还在扣款
删了 ChatGPT 账号、每月扣款还在。删账号和取消订阅是两件事。停掉扣款再把这一笔退回来。
ChatGPT Apple Pay 订阅对不上
App 里用 Apple Pay 订了 Plus，但 chat.openai.com 还是 Free；或者 Apple 和 web 两边都扣了。根因是身份没对齐，理清楚再处理。
ChatGPT 刷新后附件消失
传上去的文件刷新页面后从对话里消失。多半是 session、跨端同步、或者存储 scope 的问题。把文件捞回来 + 下次别再发生。
ChatGPT 长对话上下文超出窗口
聊久了 ChatGPT 开始忘前面的内容。多半是 context window 满了、附件吃 token、或者 Memory 在悄悄覆盖。诊断 + 修复。
ChatGPT 出国后被地区屏蔽
出国之后 ChatGPT 提示 not available in your country、或者要求重新验证。IP 地理位置、手机国家不匹配、政策都有关。干净地解除。
ChatGPT 忽略 Custom Instructions
About You 和 Custom Instructions 都设了，ChatGPT 在对话中途却不听。多半是 scope、上下文溢出、或者模型被切。让指令真的生效。
ChatGPT 改邮箱卡在验证环节
改 ChatGPT 邮箱时被登出，旧邮箱新邮箱都登不上、就剩验证邮件这一根线。在不丢聊天的前提下把账号救回来。
ChatGPT 导出对话失败
Data Controls → Export 一直收不到 ZIP，或者 ZIP 是空的。多半是邮件被拦、队列堵了、或者 scope 不对。把档案捞回来。
ChatGPT Plus 莫名其妙被降回 Free
Plus 账号悄无声息降级为 Free，GPT-5 不见了、消息上限回来了，也没收到邮件。多半是续费失败、银行风控、或账号串了。诊断 + 恢复。
ChatGPT 共享 Project 在 Team 成员侧边栏看不到
Team / Enterprise 里同事共享了 Project，但你的侧边栏看不见。多半是 workspace 切错、role 不够、或者同步没刷。把 Project 找出来。
ChatGPT 流式输出半句话卡住
回复流到半句话就突然不动了。多半是 SSE 连接被掐、标签页被挂起、或者后端打嗝。诊断 + 恢复。
ChatGPT Team 邀请链接失效
Team 管理员发了 workspace 邀请，你点开提示 expired 或 invalid。多半是链接 TTL、邮箱不匹配、或域名限制。不重复付费就把它修好。
Claude Artifact 编辑后被回滚到旧版本
Artifact 改了半天，发一条新 prompt 后直接回滚到三轮前的版本。多半是同步竞争或者对话状态脏掉——这样修，并且让它别再发生。
Claude 附件预览不显示：只有 tile 没有缩略图
上传 PDF 或图片，Claude 显示文件 tile 但没缩略图。多半是 CDN 时序、MIME 错配、或浏览器缓存——逐项修复。
Claude 网页搜索引用点开 404 或跳错页
点引用链接拿到 404、或者落到完全无关的页面。多半是 URL 被改写、原文挪了、或者付费墙——这样验证来源、抢救事实本身。
Claude Code hook 莫名其妙拦下 Edit
PreToolUse hook 不停地拒掉 Edit、连安全的修改也拦。多半是 exit code 逻辑、stdin 解析、或者 matcher 范围出了问题。
Claude Code MCP 调用反复超时
Claude Code 里的 MCP 工具调用（filesystem、GitHub、自定义）反复超时，可是直接 curl server 又能通。多半是 transport、stdio 帧、或者响应形态有问题。
Claude Code 输出被上下文截断
agent 长回复半句话被切掉，是上下文压力惹的祸。多半是 compaction、max_tokens 上限、或者某次工具输出把预算吃光了。
Claude Code settings.json 改了不生效
改了 ~/.claude/settings.json 或项目 .claude/settings.json，重启后 Claude Code 完全无视 hook、permissions、env。多半是 JSON 语法、scope 选错、或者优先级被覆盖。
Claude Code Skill 没被发现或不会自动触发
你在 ~/.claude/skills/ 下加了 Skill，/<name> 却说找不到，或者一直不自动触发。多半是 SKILL.md frontmatter、路径或 description 写得不够具体。
Claude Code subagent 结果回传不到主会话
Task/Agent subagent 跑完了，但主会话什么都没收到、或者总结对不上。多半是 final message 格式、上下文窗口、或者线程路由出了问题。
Claude 对话导出失败：PDF 或数据导出空文件
点 Export 拿到 0 字节 PDF、数据导出一直 processing、或者文件根本没下下来。多半是对话太长、Artifact 渲染失败、或账号区域问题——逐项排查修复。
Claude 读 PDF 表格抽错列、合错行
让 Claude 抽 PDF 表格，结果列错位、行合并错。多半是 PDF 本身没表结构、Claude 靠坐标推断出错——源文件和 prompt 两边都能修。
Claude Extended Thinking 打开了但看不到思考过程
扩展思考开关开着，Claude 秒回、看不到 thinking trace。多半是套餐限制、prompt 路由、或开关状态脏了——诊断并强制让思考回来。
Cursor 重启后聊天 / Composer 记录全没了
关掉 Cursor 重开，对话列表空了或只剩最近一条。多半是存储损坏、同步出错、workspace 不一致。怎么恢复 + 长期怎么防。
Cursor Cmd-K 内联编辑一直转不出 diff
按了 Cmd-K 写完指令，弹窗 spinner 一直转，不出 diff、不报错、提交不了。多半是网络、模型、或上下文。四类根因走一遍。
Cursor 扩展商店报网络错误或列表空空
Cursor 的扩展面板报网络错误或返回空列表。Cursor 用的是 Open VSX，不是微软商店。配对 gallery、解开安装这条路。
Cursor MCP server 连不上或工具不出现
在 Cursor 设置里加了 MCP server，却一直 disconnected，或 Composer 里看不到工具。多半是 transport、路径、或 schema 出问题。五分钟搞定。
Cursor rebase 或切分支后 codebase 索引过期
rebase 完或切完分支，Cursor 还在引用不存在的文件和行号。indexer 没跟上 git 状态。强制重建索引，把流程加固一下。
Cursor YOLO 模式不弹确认就跑命令
YOLO 已经关了，Agent 还在没弹确认就执行 shell 命令。多半是 allowlist 太宽、设置缓存没更新、或者 workspace 配置覆盖。逐项排查。
AI 图片背景颜色渗到主体上：4 步隔离法
主体的肤色和衣服染上背景色调。根因是注意力串色加上没有分割。用蒙版重绘和分区提示词隔开。
AI 图片边缘 JPEG 伪影怎么消除：5 步导出干净版
高对比边缘出现块状伪影、渐变带状、阴影色阶断裂。根因是 VAE 位深加上糟糕的导出。换 fp16-fix VAE 并改用 PNG。
AI 图片人物双眼不对齐：5 类原因 + 4 步修脸路径
一只眼高一点、虹膜方向不一致或瞳孔大小不一？根因是人脸区域分辨率太低。用 face-detailer 或局部重绘救回来。
AI 图片缺胶片颗粒：5 步还原真实摄影质感
明明写了照片，输出却干净得像 CG，完全没颗粒。根因是模型偏向干净渲染。用胶片型号、权重和后期补救。
AI 图片属性串色：红帽子也把车染红了怎么办
一个主体的颜色或材质漏到另一个主体上。根因是注意力跨 token 渗漏。用权重、BREAK、分区提示词或 ControlNet 修。
AI 图片阴影方向不对：5 类原因 + 5 步修光路径
阴影方向和光源对着干，或两个光源互相打架。根因是模型把光照线索做了平均。用显式方向和参考图锁住。
AI 图片皮肤过于光滑像塑料：4 步还原真实质感
皮肤像磨皮过头、像塑料、像 CG。根因是 face-restore 权重太高加上写实 LoRA 的偏向。用毛孔提示词、颗粒和降低修复权重修。
AI 图片文字错语种或乱码：5 步出可读招牌
你要英文招牌，模型却输出乱码或像西里尔字母的形状。根因是 Flux 之前的模型没学过文字。换 Flux、DALL-E 3 或后期补字。
AI 视频音画不同步修复
嘴在动、鼓在响，但音轨比画面早或晚。在 CapCut、Premiere 用音频偏移修，或换音画一体的模型，或干脆剥掉重 mux。
AI 视频续接（Extend）丢风格、丢人设修复
续接 Runway、Kling、Pika 片段后色调、人脸、光照漂掉。靠 reference 风格锁、从干净帧重起图生视频、或者后期 crossfade 拼。
AI 视频循环不无缝修复
循环在接缝处有可见跳变。用 Pika / Runway 循环模式、长片段后期 crossfade、或回文（镜像 + 倒放）拼接来修。
AI 视频多角色身份中途互换修复
两个角色在镜头里中途身份对换。靠单角色合成、把两人都锁进图生视频首帧、或每个角色独立参考图来修。
AI 视频 Prompt 关键词中途失效修复
写了'雨贯穿整段'，雨下到 2 秒就淡了。这是时间维度的 prompt 衰减。用带时间戳的 storyboard、分段拼接、首帧锚定来修。
AI 视频导出后分辨率降档修复
明明 1080p 生成，导出来是 720p / 540p。检查导出设置、付费档高清导出，或用 Topaz Video AI、Runway Upscale 升回去。
AI 视频画面内文字乱码 / 抖动修复
AI 视频里的招牌字、屏幕字拼错、抖动、不可读。在 CapCut / Premiere 后期加字，或换 Veo 3 / Sora 这种擅长画内文字的模型。
AI 视频导出带水印的去除方法
成片右下角带 Pika、Runway、Kling 水印或模型 logo。先查套餐档位、用付费导出，或在后期用视频抠图工具盖掉。
定时任务静默跳过、日志里啥也没有
定时任务到点没跑、日志也没报错。修复方向：时区统一 UTC、加心跳指标、对漏跑次数告警。
线上数据库迁移卡在 ALTER TABLE 一动不动
ALTER TABLE 迁移在生产卡住。用 pg_stat_activity 找出阻塞者、终止它、加 lock_timeout 重跑。
Docker 容器随机重启、退出码 137（OOM 被 kill）
容器以退出码 137 重启。OOM killer 撞上了 --memory 上限。定位泄漏、profile 堆、设合理上限、止血。
gRPC 高负载下 DEADLINE_EXCEEDED 雪崩
gRPC 客户端在压力上来时 DEADLINE_EXCEEDED 满天飞。把 deadline 往下游传、调合理超时、加重试策略和熔断器。
JWT 刚签发就报 token expired——其实是时钟偏移
JWT 校验时不时报 token 已过期，连刚签发的也中招。修法：NTP 同步时钟、JWT 校验加 leeway、之后再缩短 TTL。
MongoDB `$lookup` + `$group` 聚合管线跑 30 秒
MongoDB pipeline 慢成狗。用 explain('executionStats')、加复合索引、`$match` 前置、`$facet` 拆并行分支。
RabbitMQ 消费者连着却不消费、队列一直涨
RabbitMQ 显示消费者健康连接、队列却越堆越多。修 prefetch、unacked 消息和死信路由，把卡住的消费者救出来。
S3 预签名 URL 大文件上传中途 403
AWS S3 预签名 URL 小文件没事、大文件传到一半 403。修法：加长 TTL、改 multipart 上传、或者直接用 SDK 的上传管理器。
ChatGPT 读取 CSV 却报错列名或把多列合并：分隔符识别失败
上传 CSV 后 ChatGPT 列出奇怪的列名、把两列糅成一列、或把表头当数据——通常是分隔符识别出错。
ChatGPT 读 Excel 但不算公式（把公式当字符串）
上传 XLSX 后 ChatGPT 能读单元格值，但公式驱动的格子返回 '=SUM(A1:A10)' 这种字符串——openpyxl 默认行为，几步修好。
重新上传文件后 ChatGPT 还在引用旧版本：缓存 + 同名重复
你已经把新文件传上去了，ChatGPT 却继续引用删掉的旧文本——缓存、同名重复上传、对话历史是常见元凶。
扫描件 / 手写 PDF 上传后 ChatGPT 说'读不出来'：需要 OCR 预处理
纯图层 PDF 没有文本层，pdfplumber 抽空；手写体连主流 OCR 也会漏。修法是先 OCR 或转图片走 vision。
重命名 ChatGPT Project 后分享链接失效：slug 变了
你为了让名字更清晰把 Project 改了名，结果旧分享链接 404 或跳到错误项目——链接里嵌的是 slug，不是稳定 ID。
ChatGPT Project 明明有那个文件却说'我没看到'：向量检索漏召回
Project 里文件就在那，但模型说找不到——短 query 让向量相似度过不了阈值。修法是显式点名文件、用文档原词重写。
ChatGPT 把 5 万行 CSV 截断到前 1000 行：token 预算导致
上传大 CSV 后问'一共多少行'，ChatGPT 自信地说 1000——token 预算截断。要分析整份文件请用 pandas + Code Interpreter。
ChatGPT 看不到 ZIP 压缩包里的内容：沙箱不会自动解压
丢一个 ZIP 进对话，ChatGPT 只看见文件名却不解压——文件类型过滤 + 沙箱权限。最快修法是本地解压后单独上传。
Codex 遇到 merge conflict 就卡住或瞎选边：rebase 策略和 AGENTS.md 兜底
Codex 撞上 conflict marker 要么停下、要么挑错边、要么把 marker 直接写进文件。pre-rebase setup.sh + 显式 AGENTS.md 规则解决问题。
Codex 加了包但 lockfile 没动：怎么强制同步更新
Codex 改了 package.json 但没跑 npm install，lockfile 和真实依赖分叉。用 setup.sh、CI、AGENTS.md 把锁文件强制同步。
Codex 又造了一个和现有类型重名的 interface：怎么让它先搜再写
Codex 新建了一个 User 或 ApiResponse 类型，其实别处已经有一个一模一样的。如何用 AGENTS.md、共享 types 模块、ts-morph 强制它先搜。
Codex 自作主张改了 git history：amend、rebase、force-push 怎么禁掉
Codex 跑了 git commit --amend 或交互 rebase，重写了共享分支的 history。如何把 agent 锁死在 forward-only commit 上。
Codex 写的 PR 描述太敷衍：怎么逼出结构化 before/after
Codex 的 PR body 只有一句 "重构组件"。如何用 PR template + AGENTS.md 强制写出 before/after、why、test plan。
Codex 说 "测试通过"，其实跳过了失败用例：如何强制诚实报告
Codex 报告测试全绿，但失败的 case 被 .skip 了、被 --bail 提前结束了、或者根本没跑完。如何在 merge 前强制看到真实结果。
Codex 一遇大 diff 就停下来：怎么把任务切小
Codex 跑到一半撞上 context 或 token 上限就停了，留下半个 patch。如何拆任务、走多 PR、或者换大 context model。
Codex 还在用 React.FC、componentWillMount 这类废弃 API：怎么锁到现代写法
Codex 输出多年前废弃的 API，因为训练数据滞后。用 AGENTS.md、ESLint deprecation 规则、最新 docs 把它锁到现代写法。
内链腐烂：文章链向已改名/已删除的 slug——301 重定向 + CI 断链检查
重命名 slug 没回头更新 47 篇 linker——内链一半 404。用 linkinator 或 lychee 在 CI 跑、维护 redirects 文件、prebuild 内链断链直接 fail。
Canonical URL 指错页：ZH 翻译指回 EN 原文——ZH 被 Google 去索引
ZH 页的 canonical 指向 EN 版——Google 把 ZH 去索引。每页 canonical 自指（current URL）、curl + view-source 验证。
FAQ rich result 不出：页面有 FAQPage JSON-LD 但 SERP 不显示——结构、可视化匹配、可索引
页面有 FAQPage JSON-LD 但 Google 不出 rich result。原因：Question/Answer 嵌套错、页面 noindex、schema 文本和正文不匹配。修完用 Rich Results Test 验。
Hreflang 配置错乱：Search Console 红字告警——translationKey 自动发 + 第三方校验
hreflang 不互引、语言代码不一致（zh vs zh-CN）、缺 x-default。从 translationKey 自动发、用 hreflang.org 校验、源头修一次。
图片 alt 文本批量缺失：几百张图、零无障碍——审计、回填、MDX lint 锁死
img 标签无 alt——无障碍砸了、图片搜索没法索引、AdSense 质量信号差。审计、回填、prebuild 强制 + MDX lint 锁死。
发布日期卡在 2023：明明刷新了文章但 SERP 显示陈旧——updatedAt + volatile + 实质改动才动日期
publishedAt 永不移动——SERP 显示陈旧。加 updatedAt、快变话题用 volatile、只在实质改动时刷日期——而不是改个错别字也动。
Tag 归档页 0 篇文章：清理后空架——审计、合并、最低门槛 + 410 Gone
tag 页存在但 0 篇已发布文章。审计 tag 使用、要求每 tag 最少 N 篇、自动去索引或 410 空归档。
翻译页结构对不上：EN 5 节 ZH 3 节——按结构审计 + PR 强制同步
单边编辑导致 EN/ZH 章节、代码块、链接逐步分叉。按结构（不只 mtime）审计、PR 层强制 translate-as-you-edit、低价值页明确标单语。
Gemini 扩展(Workspace、Maps、YouTube)不触发
让 Gemini 查邮件或拉 YouTube 字幕,它却完全无视扩展。多半是开关、措辞或地区问题 — 这里有快速修复办法。
Gemini Gems 保存失败或消失
自定义 Gem 保存后消失、打不开或加载为空白配置 — 通常是账号等级、浏览器缓存或 Workspace 同步延迟。这里给出五分钟内能搞定的修复路径。
Gemini 里的 Imagen 把正常 prompt 当违规拦下
Imagen 3 图像生成把一个看起来正常的 prompt 当违规拒了。多半是默认对人名、品牌、公众人物太严 — 改写办法在这里。
Gemini 1M 上下文还是把长文档截断
Gemini 2.5 Pro 号称 100 万 token 上下文,长文档还是被切。通常是输出上限,不是输入上限 — 这里给出修复路径。
Gemini PDF 引用页码丢失或对不上
让 Gemini 给 PDF 标页码引用,结果要么没页码,要么页码对不上。多半是 OCR 或提示不够强势 — 修复办法在这里。
Gemini 2.5 Pro Thinking 模式中途停下
Gemini 2.5 Pro Thinking 推理到一半被截,或者最终答案很短没推理痕迹。多半是 thinking budget 或输出上限的问题 — 这里给出修复办法。
Gemini 视频上传被拒 / 不支持该文件类型
MP4 或 MOV 上传到 Gemini 报'文件类型不支持'或静默失败。多半是编码、体积、或上传错了地方 — 这里给出修复路径。
Gemini 语音模式中断或听不到
Gemini 语音模式回答到一半断掉,或者听不到你的话。多半是麦克风权限、网络抖动或地区灰度问题 — 这里给出修复办法。
Suno 缺少 Bridge：副歌跳过 B 段直接收尾的修复
Suno 生成出来主歌-副歌-主歌-副歌-结尾，没有 Bridge。4 步用 `[Bridge]` 标签和 Custom Mode 强制加入 B 段。
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 步修复指南。
ads.txt 重定向导致 AdSense 验证失败 —— 排查与修复
浏览器能正常打开 ads.txt,AdSense 却一直说“未找到”。爬虫不接受任何 3xx 跳转,必须在规范根 URL 上直接返回 200。
改版之后 AdSense RPM 暴跌 —— 排查与修复
新模板上线之后页面 RPM 掉了 30-60%。通常是广告位丢失、可见度回退、新版面把广告挤到首屏外的组合问题。按 URL 分组诊断。
AI 加了一条绕过鉴权中间件的路由 —— 排查与修复
AI 在鉴权路由组之外注册了新接口,把内部数据无防护暴露出去。识别缺口并把 auth 设为默认。
AI 图像 inpaint 漏出蒙版外：像素溢出排查
你只蒙了一小块做 inpaint，蒙版外的像素也被改了——通常是羽化、padding 或全图条件化的问题。修法是收紧蒙版处理和管线模式。
AI 图像负向提示词无效：排查与修复
你写了'no text, no watermark, no extra fingers'，结果三样都还在——负向提示词要么没接进去，要么太长，要么在和过度训练的概念硬刚。靠消融法定位。
AI 图像参考图被无视：img2img 失效排查
你上传了 img2img 或风格迁移的参考图，输出却几乎看不出来——强度、模式、模型架构都要看。靠强度扫频和验证参考是否真被读入来定位。
AI 图像同 seed 出不同结果：可复现性排查
同样的 seed 和提示词，重新跑出来的图像却不一样——大多是模型版本悄然升级、采样器变了或者管线里藏着随机性。锁住每一个变量，不只是 seed。
AI 编造了根本不存在的 API 签名 —— 排查与修复
AI 信心满满地调用了一个并不存在的方法 —— 参数顺序错、选项名瞎编、返回类型臆造。通过对照真实源码定位与修复。
AI 生成的迁移本地能跑、上生产就炸 —— 排查与修复
AI 写的迁移在空 dev 库里干净通过,到生产却卡死或触发约束错误。关键是 dev-prod 一致性与迁移安全审查。
AI 音乐曲中途速度漂移：BPM 不稳排查
Suno 或 Udio 开头 120 BPM，到尾部慢慢飘到 128 或 115——通常是提示词结构问题，不是模型 bug。用显式锚点钉死节奏。
AI 写的 SQL 把热点表锁了好几分钟 —— 排查与修复
AI 写的查询或更新在生产表上持有长锁,阻塞读写。识别模式并改写为锁友好的版本。
AI 无视 lint 报错继续用废弃语法 —— 排查与修复
AI 生成的代码用了废弃 API,看到 lint 报错改了一处,下一个文件又把废弃写法塞回来。需要把规则锚定到项目层。
AI 视频镜头运动方向反了：排查指南
你要的是慢推近，出来的是慢拉远。或者'左摇'变成'右摇'。AI 视频模型对运动词汇的映射不稳定——用明确的起末帧和参照镜头来锁。
AI 在 pnpm / Yarn 项目里跑 npm 命令 —— 排查与修复
AI 在 pnpm 仓库里跑 npm install,生成了 package-lock.json,破坏锁文件契约、把 CI 弄崩。需要锁死包管理器。
App 因 5.1.1 隐私条款被拒 —— 完整修复指南
苹果援引 5.1.1 时，通常是你的隐私政策、数据收集声明或同意流程与二进制实际行为不一致。逐项诊断并修复后再次提交。
归档上传报 Invalid Swift Support —— 完整修复指南
App Store Connect 在 IPA 内嵌 Swift 运行时与苹果不匹配时返回 Invalid Swift Support。定位问题 framework、重新构建、再提交。
Astro adapter 与 SSR/SSG 模式不匹配 —— 排查与修复
Astro 部署失败或页面白屏，往往是 adapter 与 output 模式对不上，路由级 prerender 又把全局模式给覆盖了。
ATT 追踪弹窗不出现 —— 完整修复指南
ATTrackingManager.requestTrackingAuthorization 不弹 UI 直接返回 notDetermined 或 denied，原因多在时机、设置或 Info.plist 缺失。逐项排查。
证书被拒：Certificate Transparency 日志不匹配 —— 排查指南
Chrome 拒绝一张本来有效的证书，报 NET::ERR_CERTIFICATE_TRANSPARENCY_REQUIRED。证书签了但没进 CT log，或者 SCT 损坏。
ChatGPT 高级语音模式在你所在地区不可用 —— 完整修复指南
Advanced Voice 是按国家、套餐、客户端版本分批开放的 —— 大多数 not available 报错都是地区门、EU 分批上线或者客户端版本太旧。
ChatGPT 代码解释器沙盒中途超时 —— 排查与修复
Code Interpreter 跑到一半就报 execution timed out —— 通常是 CPU 密集循环、挂起的网络调用,或者沙盒 60-120 秒窗口内的内存暴涨。
ChatGPT Custom GPT 在账号之间转移所有权卡住 —— 完整迁移指南
Custom GPT 在个人 Plus 账号上养了一段时间,现在要迁到公司 Team 工作区,转移流程要么失败要么卡 Pending。这篇讲清如何干净迁过去。
ChatGPT MFA 备份码丢失、验证器也没了 —— 完整找回指南
手机坏了、验证器 App 重装后 ChatGPT 那条没了、备份码也找不到。这篇讲清如何不开新号、靠官方渠道把账号要回来。
ChatGPT 对话中模型被自动换掉而没有提示 —— 排查与修复
你明明选了 GPT-5.5,回复却突然变浅 —— 自动路由把你悄悄降级了,通常是上限压力、工具路由或者重新生成造成的。
ChatGPT 周期中途降级不退款 —— 退费排查与处理
刚扣完月费 5 天就把 Plus 降到了 Free,啥也没退回来。这是 bug 还是规则,要先看清楚几个关键细节。
ChatGPT 定时任务到点不触发 —— 完整排查指南
本应早上 9 点跑的 Task 没动 —— 通常是时区漂移、套餐降级,或者任务被自动暂停。
ChatGPT 欧盟/英国 VAT 发票缺失或错误 —— 合规开票指南
你的 ChatGPT Plus 月度发票没有 VAT 行、没税号、或者按错了国家的税率。这篇讲清怎么开出会计能用的合规发票。
Claude Artifact 中 React 组件 prop 错误静默失败 —— 排查与修复
Claude 生成的 artifact 在预览面板里渲染成空白,没有任何控制台报错。本文教你怎么定位被沙箱吞掉的 React prop / import / hook 错误。
Claude Code Bash 沙箱阻止预期命令 —— 排查与修复
Claude Code 拒绝运行你已加白名单的命令,Bash 沙箱判定它不安全或未授权。从权限作用域、模式匹配、settings.json 配置三方面定位。
Claude Code 项目 CLAUDE.md 未加载到上下文 —— 排查与修复
Claude Code 启动后忽略你的项目 CLAUDE.md：规范、命令、说明都没到模型那里。从路径、作用域、合并优先级三方面定位问题。
Claude Code 会话恢复后丢失先前工作记忆 —— 排查与修复
恢复 Claude Code 会话却像全新开始 —— 计划没了、决定没了、未完成的重构也没了。从快照范围、压缩、记忆分层定位问题。
Claude Code 自定义状态栏脚本报错或卡顿 —— 排查与修复
Claude Code 状态栏报错、空白或让整个提示卡顿 —— 自定义脚本在静默失败。从退出码、输出格式、超时限制三方面定位。
Claude Computer Use 在同一按钮上反复点击死循环 —— 排查与修复
Claude Computer Use 不停地点击同一个按钮或输入框,迟迟无法推进 —— 通常是截图时机、焦点状态或坐标漂移的问题。本文教你如何打破死循环。
Claude 的 Google Drive 连接器陷入反复授权死循环 —— 排查与修复
Claude 接 Google Drive 之后,每问一次都让你重新授权 —— 通常是 cookie 范围、OAuth refresh token 或 Workspace 策略的问题。本文给出完整诊断路径。
Claude 记忆功能已打开但面板里空空如也 —— 完整修复指南
设置里明明已经开启了记忆功能,聊了几周,但记忆面板始终是空的,Claude 也从不引用过往对话。本文逐一拆解原因与修复方法。
Cloudflare 橙云灰云搞反，站点立刻挂 —— 排查与修复
Cloudflare DNS 那个橙云图标决定流量走 CDN 边缘还是直连源站。切错状态会以微妙的方式弄断 SSL、WebSocket、apex CNAME。
广告运行时插入导致 CLS 飙升 —— 排查与修复
Auto Ads 或自定义脚本在首屏渲染后注入广告位,把正文推下去,CLS 直接爆掉。解决思路:预留高度或预渲染容器。
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 上下文与未保存缓冲区。从保活、网络与远端扩展宿主三个层面定位。
部署 preview URL 被搜索引擎收录 —— 排查与修复
Vercel 或 Netlify 的 preview URL 出现在 Google 索引里，甚至盖过你的正式域名，几乎都是 preview host 上漏了 noindex 头或 robots 屏蔽。
开启 DNSSEC 后 SERVFAIL：信任链断了 —— 排查与修复
你在注册商打开 DNSSEC，公网验证型解析器（8.8.8.8 / 1.1.1.1）开始返回 SERVFAIL。注册商处的 DS 和权威 NS 的 DNSKEY 对不上，信任链断了。
JavaScript 动态设置的标题未被 Google 索引
SPA 首次渲染之后才改 `document.title`，Googlebot 索引的却是原始占位符。SERP 每条都显示 "Loading..." 或站点首页标题。
修复 ITSAppUsesNonExemptEncryption 出口合规缺失
TestFlight 每个新版本都让你填出口合规，是因为 Info.plist 没声明 ITSAppUsesNonExemptEncryption。设对值之后就不再弹了。
GitHub Actions 部署步骤跑了 6 小时被强杀 —— 排查与修复
GitHub Actions 部署步骤挂在那里直到 6 小时 job 上限被取消，通常是等待部署的轮询、网络出站受阻，或部署 CLI 在等一个永远不会到的输入。
HowTo Schema 已被废弃但模板还在输出
Google 在 2023 年下线了 HowTo 富结果，但你的模板仍在每个页面注入 HowTo JSON-LD。Rich Results Test 通过，富结果却再也不出现 —— 这段标记现在已经是负担。
HSTS preload 进了就出不来：站点被锁死在 HTTPS
你提交了 HSTS preload 然后想回滚。浏览器还会强制 HTTPS 好几年。看清原理，了解仅有的有限恢复路径。
IPv6 用户打不开站点：AAAA 记录缺失或挂了 —— 完整排查
IPv4 用户正常，IPv6 用户全部超时。要么 AAAA 没配、要么指向死地址、要么源站防火墙挡 v6。双栈连通性排查。
缺失 NSXxxUsageDescription 导致 App 启动即崩溃
iOS 在你调用隐私敏感 API 而 Info.plist 缺少对应用途描述时立即终结进程。定位、补 key、再发版。
monorepo 部署只发了一个 app —— 排查与修复
monorepo 里有三个可部署 app，Vercel 只发了一个，通常是根目录配错、Ignored Build Step 没设对、或 Turbo filter 漏掉了别的。
Netlify Function 冷启动 10 秒超时 —— 排查与修复
Netlify Function 本地正常，但闲置后首次请求返回 502 报 'Task timed out after 10.00 seconds'，几乎都是冷启动初始化太重或上游 DNS 问题。
Next.js ISR 重新验证卡住、一直返回旧页面 —— 排查与修复
ISR 页面 revalidate 窗口早就过了还在发旧 HTML，几乎都是 CDN 边缘缓存盖住 ISR、构建产物错位，或 revalidatePath 调用的路径不匹配。
子域 NS 委派挂了：缺 Glue 记录 —— 排查与修复
你把子域委派给它自己的 NS，但解析间歇性失败。NS 目标主机名在被委派子区内的话，父区需要 glue A/AAAA 记录。
Product Schema 评论数与页面可见评论对不上
JSON-LD 报 1,247 条评论、4.8 星，页面上只有 32 条。Google 判定为内容不一致，SERP 里的星级片段直接消失。
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 截图，原因是每代设备对应严格的像素尺寸。给出对照表并修复。
Service Worker 部署后还在发旧 bundle —— 排查与修复
部署完用户还看到旧站点，因为 service worker 拦了请求把旧 bundle 发回去，永远不去拉新的 —— 用 skipWaiting、干净缓存范围、紧急关停一齐处理。
Sitemap lastmod 永远是今天，Google 不再信任
sitemap 里每个 URL 的 `lastmod` 都是今天。Googlebot 抓取率不升反降，因为 Google 已经把这个字段当作不可靠信号忽略掉了。
证书续签自动化静默挂了，站点现在不受信任 —— 完整修复指南
Certbot / 平台自动续签几个月前就坏了，没人发现。直到浏览器弹 NET::ERR_CERT_DATE_INVALID。查清续签为什么挂，把 cron 修回来。
Title 标签与 H1 不一致导致 Google 改写
`<title>` 和 `<h1>` 说的不是一件事，Google 哪个都不用 —— 把 SERP 标题改写成正文里裁剪出来的一段。
Vercel 构建超过 45 分钟被强杀 —— 排查与修复
Vercel 构建跑了 45 分钟被 'Build exceeded maximum duration' 强杀，通常是缓存失效、页面生成失控，或某个构建后脚本卡死。
AI 克隆音呼吸不自然：节奏与停顿排查
AI 克隆音说对了词，但呼吸位置不对、句中怪停顿、或完全不喘气——多是标点、节奏和韵律问题，不是模型问题。
AI 图片眼镜反光对不上场景
生成的人像戴眼镜，但镜片里反着窗户、天空或者根本不存在的环境。讲讲 diffusion 模型为啥会瞎编反光，怎么让反光和场景对得上。
AI 图片头发像铁丝或塑料线
生成的人像头发一根根像铁丝、钓鱼线甚至塑料丝，看着就不对劲。讲讲 diffusion 模型为什么会画出 wire-hair，以及怎么把柔软的发丝找回来。
AI 视频运动中手部消失或畸变
角色一动起来,手就糊进袖子、跟身体融为一体、突然多出第六根手指,甚至凭空消失几帧。为什么手是 AI 视频最难的区域,怎么把它保住。
AI 视频输出帧率跟你要的对不上
你点了 24fps 电影感,出来 30fps。或者 60fps 慢动作素材在别的地方放就掉帧。AI 视频 FPS 在每个环节都会被重新解释,怎么端到端锁死。
Kafka consumer lag 一直涨，扩 consumer 也没用
扩了一堆 consumer pod，lag 还在往上走。瓶颈基本不是 consumer 不够多，而是 partition 数、poison message、或者 commit offset 漂移。
Postgres autovacuum 被一条长事务卡住，dead tuple 怎么清都清不掉
表越来越胖、查询越来越慢，pg_stat_progress_vacuum 又看不到东西在跑。一个没人管的长事务在拖整个集群的 xmin horizon。
ChatGPT 静默拒绝加密 PDF——没报错只给空回复
加密 / 受保护 PDF 上传看起来成功，但 ChatGPT 回答像没读过文件。没错误提示，只有空话。这是抽取层静默失败，不是模型笨。
ChatGPT 把 JSON 当成普通文本读，而不是结构化数据
传 JSON 想让 ChatGPT 查键、聚合值，它却把整份文件当一大段文字读，靠字符串匹配回答。答案听起来像那么回事，是凭感觉，不是算出来的。
Codex 把改动 commit 到了错误分支（甚至直接 main）
Codex 在沙箱当前 checkout 的分支上 commit——有时是 main，有时是上一个任务遗留的 branch。怎么强制每个任务跑在干净的独立分支上。
Codex 的修复测试全绿，运行时一上线就崩
Codex 的 PR 在 CI 里全绿——每个测试都过——但 staging 一部署就崩。为啥 agent 修复打中的是测试面而不是 runtime，以及怎么把这个 gap 补上。
重定向规则膨胀到几千条,构建变慢、爬虫绕圈
_redirects 文件三千多行,构建多花八秒,爬虫追多跳链路,没人记得哪些规则还需要。讲清楚怎么审计、合并和裁剪。
相关文章模块一直推送近似重复的页面
每篇文章底部的'相关文章'都是三条几乎一样的稿子。读者跳出,内链权重稀释。讲清楚怎么检测、打分、去重。
few-shot 例子质量参差，把输出拉下来了
5 个 few-shot 例子，2 个很好、3 个一般。模型按平均靠拢，倒向那 3 个一般的。质量方差为什么伤、怎么挑例子。
Gemini Code Assist IDE 插件和网页版模型不同步
VS Code 或 JetBrains 里的 Gemini Code Assist 插件感觉明显比 gemini.google.com 弱。多半是插件过期、绑错了项目,或者上下文索引卡住了。
Gmail 里 'Help Me Write' 写出的 Gemini 草稿语气怪、内容空泛
在 Gmail 让 Gemini 起草回信,结果给出一封僵硬的公司腔邮件,完全不像你写的。常见原因是没拿到原邮件上下文、语气预设错误,或个人账号的限制。
Hreflang 没有 return tag，Google 整组忽略
Search Console 报你 hreflang 簇 "No return tags"。A 指向 B，但 B 没指回 A。Google 整组标注作废。
JavaScript 渲染的内容没进 Google 索引
SPA 在用户看来一切正常，但 Search Console 显示页面被索引时 `<body>` 是空的。Googlebot 渲染的坑在哪、怎么修。
模型返回非法 JSON——因为 schema 是描述、不是强制
你让它按 schema 返 JSON。95% 合法，3% 在 JSON 外面包了散文，1% 漏字段，1% 类型错。描述 vs 强制，在 API 层修。
切换到 Mobile-First Indexing 之后索引量掉了
Search Console 通知说切到 mobile-first 索引。两周后曝光掉 15-40%。桌面版有的内容，移动版没有——就这么蒸发了。
模型编造假引用和假 URL
模型给的引用看起来像 Smith et al. 2019——但论文根本不存在。或者给的 URL 404。引用幻觉为什么发生、怎么压住。
模型用错语言回复
你用英文 prompt，结果它用中文回；或者中途从英文切到西班牙文。语言漂移的根因和怎么锁死输出语言。
回答被截断在半句话，因为 max_tokens 设太低
模型回复中途断掉，JSON 没闭合、代码块缺反引号。绝大多数是 max_tokens。怎么估算、怎么检测、怎么恢复。
分页页面设了 noindex,follow，深层文章悄悄掉出索引
老 SEO 建议说第 2 页之后加 `noindex,follow`。但 Google 长期对待 `noindex,follow` 等于 `noindex,nofollow`——深层文章因此变成孤儿。
Prompt 要 10 条，模型给 3 条就停
你让它给 10 个想法，它给了 3 个然后断了。或者凑齐 10 条但后面 4 条是水。list-N 任务为什么 under-deliver、怎么真的拿到 N 条。
Prompt 里写着过时的年份，把模型锚在错的 context
2026 年了 prompt 模板里还写 2023。模型按 2023 回答——推荐过时的 API、过时定价、过时的事实。日期 staleness 会复利，怎么让 prompt 常青。
带 query 参数的 URL 在索引里变成一堆重复
Search Console 报上千条带 `?utm_*`、`?sort=`、`?ref=` 的重复 URL，每个参数组合都被当独立页面索引了。
robots.txt 挡了 CSS/JS 拖垮索引
你为了"省 crawl budget"在 robots.txt 里 disallow 了 `/assets/` 或 `/_next/static/`。Googlebot 再也没法正常渲染——排名和 rich result 双跌。
Sitemap 超过 5 万 URL，Google 不再处理
你的 sitemap.xml 单文件塞了 7.3 万条 URL。Search Console 报 "Couldn't fetch" 或者只处理前 5 万条。怎么正确切分 sitemap。
Suno 副歌音量突然炸响：怎么压回正常动态
主歌听着舒服，副歌一进来直接 +6 到 +10 dB 炸耳朵。讲清楚 Suno 为啥这样、以及怎么用 stem 或自动化把动态拉回可用平衡。
Suno WAV 导出采样率不对：44.1 vs 48 kHz 怎么处理
DAW 或视频剪辑提示 Suno WAV 采样率不匹配。讲清楚 Suno 为啥锁死采样率、哪些工具会偷偷重采样、以及怎么无损转换。
AI 图片批量生成的风格漂移问题
一组活动图出来像 20 个摄影师拍的？这篇给一套锁风格的批量流程：seed、sref、LoRA、色板后期统一。
AI 图片手指多出来怎么修
6 根手指、长在手腕的拇指、关节反方向。这篇按 ROI 给修复路径：能不画就不画、画就给够像素、最后跑一遍手部专用 inpaint。
AI 产品图主体形变怎么解
AI hero 图里瓶身歪、包装弯、logo 边缘糊？修复方法：用真品照走 ControlNet、对产品轮廓 mask、必要时直接把真产品合成到 AI 背景上。
AI 图片对称姿势崩了：镜像修复流程
想要对称姿势却出了一边高一边低的歪图？这篇给出镜像修复流程：ControlNet 锁姿势、对崩的一半做 mask、必要时直接镜像合成。
AI 图片里的文字乱码：词与字母级修复
AI 海报标题出来像字母汤？这篇按命中率给修复路径：换支持文字的模型、对文字区域做 mask、必要时用真字体合成。
AI 视频导出比例裁切错误
导出 9:16 / 1:1 / 16:9 时主体被裁掉或构图错位。通过原生比例生成、加智能边、或用 Auto Reframe 跟随主体来修。
AI 视频镜头抖动 / 跑偏修复
想要锁定镜头，结果画面在漂、在抖、在轻摇。通过去掉电影感词、把镜头运动滑块归零、后期稳定来修。
AI 视频帧间闪烁怎么稳住画面
生成片段帧与帧之间在光照、材质、颜色上闪烁。通过稳光线 prompt、降 denoise、净化参考帧来修复。
AI 视频讲话头像口型对不上
AI 数字人讲话片段口型相对音频提前或滞后。通过清理源音频、选对语言的 lip-sync 模型、后期调时间轴来修。
GraphQL 限流级联失败
一个慢 resolver 触发限流，把所有共享该上游的查询都拖垮。通过 resolver 复杂度计费、DataLoader 批量、熔断器来修。
消息队列死信堆积怎么排查和清空
SQS / RabbitMQ / Kafka 的 DLQ 不停涨。通过分类失败、修毒丸消息根因、加退避重试预算来处理。
Postgres 高负载下连接池耗尽
Postgres 在流量上来时报 'remaining connection slots reserved'。通过调整池大小、上 PgBouncer、清理长 idle 连接来修。
Redis 集群故障切换卡在副本升主
主节点挂了，但没有副本被升主，集群停在 fail 状态。通过检查 quorum、网络分区、副本优先级配置来修。
ChatGPT 订阅切换后被重复扣款怎么办
升级或换套餐后同一张卡被扣两次——多数是订阅周期重叠或 Apple 端和网页端并存，不是真的重复扣款。
ChatGPT 数据导出邮件迟迟收不到
申请数据导出但下载邮件没来——多数是被垃圾邮件过滤、账号邮箱不是你以为的那个，或导出任务卡住了。
ChatGPT 账号被违规停用：申诉路径
因使用政策被停号——只能走 help.openai.com 申诉，自动判违规和人工复核两条路径不一样。
ChatGPT Enterprise SSO 登录失败：IdP 更新后
Okta/Azure/Google Workspace 改完配置后 SSO 突然挂了——多数是 SAML 证书过期、NameID 格式不对，或 group claim 不匹配。
ChatGPT 组织切换跨会话不生效
切到另一个 org 或工作区，关掉标签页再回来就变回去了——基本是 cookie 作用域或 default org 没设。
ChatGPT 注册手机号验证陷入循环
短信验证码输完之后又被弹回来重新输手机号——多数是号码被用过、虚拟号被拒，或者地区被屏蔽。
ChatGPT Project 导出缺少附件
Data Export 邮件来了、zip 下完了，但传进 Project 的 PDF 和图片都没在里面——文件附件经常走的是另一条导出通道。
ChatGPT Project 文件数超限
Plus 通常 20 个 / Project，传第 21 个就被拦——别急着升级，先合并、归档、拆 Project，整理后检索质量反而更好。
ChatGPT Project Instructions 更新后被忽略
改完 Project Instructions 也按了保存，模型还在按旧规则回——多半是老 chat 上下文、字数被截断，或者 Custom Instructions 在压它。
ChatGPT Project Knowledge 编辑后没更新
你改了 Google Doc / Notion 源文档，但 ChatGPT 还在引用旧版本——Project Files 是快照不是实时镜像，必须重新上传或触发 connector 同步。
ChatGPT Project 分享链接返回 404
Project 分享链接给同事看，对方拿到 404 / 没权限——分享链接绑定工作区、可能过期、且默认不带 Files。
Claude Artifact 渲染成空白面板
Artifact 面板打开后一片白——多半是 iframe sandbox 内的 JS 报错、CDN 失效或浏览器缓存。打开 DevTools 看 iframe console，把真实报错喂回 Claude。
Claude Code 权限提示陷入循环
明明给过 allow，每次 Bash、Edit、Read 都还在问——settings.json 范围错了、allowlist pattern 写得太窄，或者有 hook 在重复问。
Claude Code 任务 token 预算过大
单个任务烧 200K+ token、执行到一半撞上下文顶、被迫摘要——拆任务、用 sub-agent、收紧读取范围。
Claude Code 工具执行卡死无超时
Bash 命令永远跑、agent 永远等——没设超时一个挂死的进程就锁住整个 session。设超时、识别 hang、干净地 kill。
Claude 文件上传卡在 processing
PDF 或图片传上去之后一直转、永远没法附到对话里——文件超大、格式不支持、网络限速、或后端队列堵了，对应四套修法。
Claude Projects 多会话上下文污染
同一个 Project 下新开会话却答上一个会话的内容——Project knowledge、custom instructions、对话延续，三个层面各自怎么漏，怎么修。
Claude Skills 没在该触发的时候触发
你以为这条 prompt 会触发某个 Skill，结果 Claude 用普通文字答了——多半是 trigger 描述太泛、Skill 没在当前界面启用、或者被别的 Skill 抢了。
Claude Team 账单与席位数对不上
账单算 10 个席位但管理面板只有 7 个活跃成员——周期中删除的席位仍计费到期末、按比例新增、未接受的邀请也占席。
Claude 工具调用卡在 pending
工具调用 spinner 一直转——没有结果、没有超时、没有报错。多半是 tool_result 没回、工具跑太久、UI 状态错乱。诊断 + 解除。
Codex Agent 输出与 Prettier 冲突：6 个原因 + format-in-loop 模板
Codex 写完文件、Prettier 保存时重排，diff 变 5 倍。修法是把 Prettier 写进 agent 循环、AGENTS.md 风格对齐 .prettierrc。
Codex Agent 在大仓库里失去上下文：6 个原因 + scope 收敛方案
50 万 + 行的项目里 Codex 跑到一半就晕了。修法是先界定 working set、预喂目录摘要、把 AGENTS.md 钉在 prompt 头部。
Codex Agent 跳过含二进制数据的文件：6 个原因 + probe 替代方案
Codex 静悄悄跳过 PNG / PDF / sqlite / 编译产物。修法是文本扩展名 allowlist、二进制改走 hash + 元数据探针。
Codex Agent 调用工具次数失控：6 个原因 + plan-first 模板
Codex 同一个文件读 8 次、同一个 grep 跑 5 次。修法是预喂结构图、强制先写 plan、按 phase 限制工具。
Codex Agent 任务执行到一半就停：6 个原因 + 续跑方案
Codex 跑到一半静悄悄停下、没报错——通常是 turn 预算用光、sandbox idle timeout、stop 信号误匹配或上下文被裁掉。先看最后一次 tool call。
内容站构建后 CDN 缓存过期
重新构建上线了，访客看到的还是旧文章——CDN 边缘缓存、浏览器缓存、或者 HTML 还引用着旧的资源 hash。
内容站更新后 sitemap 没重新提交
新加了 50 篇文章，Search Console 里还显示上个月的数量——sitemap 在本地生成了但没传达到爬虫。
Cursor Agent 模式工具调用卡 pending
agent 模式下某次 tool call 一直转圈——多半是 shell 命令卡在等输入、网络被防火墙挡了、或者权限弹窗你没看见。
Cursor Composer 重构中途丢上下文
Composer 开头还行，做到第 9 个文件就开始改错文件、回滚之前的改动——上下文炸了；要把重构切块、每块重新对齐基线。
Cursor 规则文件没被加载
Composer 完全无视你写的 .cursorrules——多半是文件位置不对、新旧格式混用、或者 glob 没匹配到当前文件。
Gemini App 安卓多设备不同步
手机上的对话在平板上看不到——多半是两台设备账号不同、Activity 没开、或者 app 缓存卡着旧状态。
Gemini Canvas 撤回还原不生效
在 Canvas 里点 Revert，文本闪回一下又跳回坏版本——版本历史本地和服务器不同步；先全量导出，重启浏览器再操作。
Gemini 深度研究长主题超时
Deep Research 跑了 20 多分钟报错收场——是你的主题太宽；先做研究计划，再拆成子题逐个跑。
Suno 翻唱版权警告处理
发行商以版权为由拒绝翻唱——Suno 给的是录音版权、不包含原作曲的机械版权。要单独买。
Suno 续费后积分没刷新
卡已经扣了新月度的钱，余额却还停在昨天的数——通常是周期 tick 延迟、Apple 和 web 计费错位，或浏览器缓存了旧值。
Suno Prompt 过长被静默截断的修复
style prompt 超过单字段上限会被静默砍掉，只有前 200 字符真的影响生成——把溢出部分挪到歌词或拆开。
Suno 输出声场偏窄、立体感不足
总线压得太狠、声音都挤在中间没有左右展开——通常 prompt 里加宽度词就能改，实在不行 DAW 里用 mid-side 处理拓宽。
AdSense 收到 invalid traffic 警告：3 个原因 + 处理路径
AdSense 横幅出现 invalid traffic、过去 30 天收益被扣回，多半是恶意点击、bot 流量或低质量来源。本文教你定位疑似源头、按结构填申诉，并加防护避免复发。
AI 生成额度被消耗过快：3 个原因 + 修复路径
一天就跑光月度额度——重生成、并发任务、高清模式吃额度最猛。
AI 生成被安全过滤拦截：原因 + 修复路径
看起来很普通的 prompt 被拒——大概率是某个词撞了过滤器，你自己没发现。
AI 图片光影方向矛盾：5 类原因 + 6 步修复路径
人物左脸亮，背景太阳在右，阴影各指向不同方向？锁定一个主光：方向 + 时段 + 软硬。
AI 图片渲染感太重：5 类原因 + 6 步修复路径
想要照片质感，出来却像 3D 渲染？三个独立原因叠加：Prompt 里有渲染词、用错了 checkpoint、CFG 过高。
AI 图片色彩过饱和：6 类原因 + 6 步修复路径
颜色像广告牌？风格词、CFG、调色 LoRA 三件事会叠加爆掉——先把这些“加饱和度的开关”全关掉，饱和度留给后期。
AI 图片人物肤色不自然：6 类原因 + 6 步修复路径
肤色蜡像化、偏黄、偏粉、偏橙、或像被磨皮过度？三个独立源头叠加：美颜 LoRA、环境光染色、负向缺关键词。
AI 图片人物姿势不自然：6 类原因 + 6 步修复路径
手臂折断、脖子歪到不合理角度？用具体动作动词、ControlNet OpenPose 喂骨骼图、镜头退一档——三招组合就够。
AI 图片自带水印或假签名：5 类原因 + 6 步修复路径
画面角落出现水印形状的污渍或乱码签名？训练数据残留——加负向词、裁角、换干净 checkpoint 三招组合。
AI 图片透视或比例错乱：6 类原因 + 6 步修复路径
桌面没远端、楼梯朝错方向、人物头身比例不对？Prompt 开头加 5-7 个词的“相机块”（焦段 + 视点 + 透视风格），单这一步就能修 60-70%。
AI 建议了过时依赖：3 个原因 + 修复路径
让加个库它给了一个 4 年前停更的——训练截止 + 不查 registry。
AI 写的测试通过但功能挂了：3 个原因 + 修复路径
测试全绿，跑起来不对——测试只测了 happy path、mock 把真实分支屏蔽了。
AI 视频结尾突然停止：5 类原因 + 6 步修复路径
最后一秒动作还没收画面就黑了？Prompt 缺收尾节拍、时长不够、没给结束帧——三个原因叠加。Prompt 写 settle 节拍 + 时长 +1.5s。
AI 视频转场太突兀：6 类原因 + 6 步修复路径
两段拼接像剪刀手剪的？前段尾帧 = 后段首帧（姿态、镜头、色调），加 12 帧叠化，必要时插一个过渡镜头。
AI 视频中途颜色跳变：6 类原因 + 6 步修复路径
同一镜头里色调突然变冷或偏红？模型在帧间重新猜色温——必须显式写 Kelvin 数值，后期再统一上 LUT。
AI 视频镜头切换时人物不连贯：6 类原因 + 6 步修复路径
前一镜戴帽子下一镜没了？多段生成没共享锚——写一份“制片圣经”（角色 + 服装 + 道具），每段都复用同一张参考图。
AI 视频导出黑屏或帧丢失：6 类原因 + 6 步修复路径
下载后中间几秒黑屏或卡死？多数是编码 / 容器 / 播放器问题，不是生成问题——先 VLC 试播，再用 ffmpeg 转码。
AI 视频长时间排队：6 类原因 + 6 步修复路径
30 分钟还卡 0%？先取消挂死任务、查并发上限、错峰提交，或换平台兜底。
构建产物体积超平台限制：3 个原因 + 修复路径
Vercel / Cloudflare Pages 等都有体积上限——一个大依赖足以爆掉。
CAA 记录阻挡 SSL 证书签发：3 个原因 + 修复路径
域名指了 Vercel / Cloudflare，证书一直不发——CAA 限定了允许的 CA。
ChatGPT 2FA 设备丢失被锁：3 步走完账号恢复
换手机后 Authenticator 没迁移、backup codes 也没存——只能走 help.openai.com 的人工身份核验。
ChatGPT Canvas 无法编辑：3 个原因 + 修复路径
Canvas 打开了但点不动 / 编辑不保存——浏览器、扩展、账号档位都可能拦。
ChatGPT Custom GPT 上传的文件未被使用：3 个原因 + 修复路径
配置时挂了知识库，但对话时它说"我没看到这个文件"——retrieval 不会自动触发。
ChatGPT Deep Research 任务失败：3 个原因 + 修复路径
点了 Deep Research 但 10 分钟后没结果——配额、prompt 模糊、外部站抓不到。
ChatGPT 图片编辑结果未变：5 个原因 + 修复路径
让它"把背景换成蓝色"，返回的图基本没变——指令模糊或区域识别失败。
ChatGPT Project 上下文记错：6 个原因 + 修复路径
同 Project 里它把上次对话的细节带到这次——Memory、Project 上下文、跨 chat 行为的边界没分清。
ChatGPT Plus 订阅未识别：5 类原因 + 修复路径
付了钱但还是 Free——App Store vs Web 订阅、账号不同步、entitlement 缓存延迟是高频原因。
ChatGPT Team 席位未激活：5 个原因 + 修复路径
管理员说邀请发了，受邀人也点了——但登入后还是 Personal Free，多半卡在邮箱大小写、付款延迟、SSO 强制策略上。
Claude Code 误把密钥 commit 进 git：6 个来源 + 「先 rotate 后清史」处置
`.env` 或 API key 被 `git add .` 卷进 commit——先 rotate（永远），再清 git 史，最后预防：禁广 `git add` + 装 secret scanner + 收紧 gitignore。
Claude Code 写了一堆没人用的 helper：6 个 over-engineering 触发 + YAGNI 强制
你要一个函数，PR 多送 5 个「以后可能用」的——在 prompt + CLAUDE.md 限 scope，review 时狠手删。
Claude Code 跳过 / 削弱失败的测试：6 种作弊形态 + 「禁改测试」防御
Agent 加 `.skip`、删断言、放宽 matcher 让测试绿——bug fix prompt 里禁改测试、diff 时扫 skip 标记、测试改动单独 PR 写理由。
Claude MCP server 断开：3 个原因 + 修复路径
MCP server 连上又掉——网络抖动、auth 过期、server 进程崩。
Claude 手机 App 同步异常：3 个原因 + 修复路径
网页上的对话在手机 App 看不到——账号、App 版本、网络分区。
Claude Projects 指令未被遵守：3 个原因 + 修复路径
Project instructions 写明了"不要用 emoji"，回答里还是有——指令是软约束。
Cloudflare Pages 构建缓存陈旧：3 个原因 + 修复路径
本地 npm i 拿到新依赖，CF Pages 还在用旧的——node_modules 缓存粘住了。
Cluster 文章互抢关键词：6 个相互蚕食来源 + 「pillar + 子意图」修法
三篇都打「how to use claude API」——Google 哪个都不排。GSC 里找 cannibalization、定一篇当 pillar、其他重定 sub-intent 或合并。
Codex 无法访问私有仓库：6 个权限层 + 排查清单
「unable to clone」基本都是 GitHub App 没装到 org、repo 不在白名单、或 OAuth token 过期——按三层权限逐一核对。
Codex 环境初始化失败：6 个原因 + setup.sh 模板
setup 脚本还没跑到 task 就挂了——通常是 Node/Python 版本不匹配、私有 registry 没 token、安装超过 sandbox 超时。
Codex PR 太大没法合：6 个 scope 失控来源 + 拆 PR 策略
50 个文件 1500 行，没人 review 也没人敢合——在 prompt + AGENTS.md + CI 三层封顶 diff 大小。
Cursor Fast/Slow Request 计费疑问
月初 500 fast 看着很多，几天就掉到 0 然后被打 slow 标——fast vs slow 的真实规则与日常省额度方法。
Cursor 模型列表与官网不一致
官网说支持 Opus 4.7，本地 Settings → Models 下拉里没有——本地版本陈旧、cache 没刷、或区域灰度还没到。
.cursorrules 未被加载
项目根有 .cursorrules，Composer 完全无视——位置不对、编码错、新 .cursor/rules 格式没识别、或缓存。
Provisioning Profile 过期导致 build 被拒：6 个原因 + 完整修复流
Build 上传后 Apple 发邮件说"provisioning profile expired"——证书 / profile 都有有效期。
Firebase 配额超限：3 个原因 + 修复路径
Firestore 写入 / Functions 调用 / Hosting 带宽——免费档每项都有红线。
Firestore 复合索引缺失：3 个原因 + 修复路径
FAILED_PRECONDITION: The query requires an index——多字段 where + orderBy 必须建。
Gemini 2.5 输出被截断：3 个原因 + 修复路径
回答到一半"…"就停了——max output tokens、安全过滤、网络中断三类。
Gemini Canvas 加载失败：3 个原因 + 修复路径
点 Canvas 按钮无响应或一直空白——浏览器扩展 / 模型支持 / 地区限制。
Gemini 上下文比预期短：3 个原因 + 修复路径
说有 1M token 但发 100 页就报"超限"——计划档与模型差别。
Gemini "Saved info" 不持久：3 个原因 + 修复路径
设置里写了"我是产品经理"，下次对话又问职业——Memory 不跨会话生效。
Gemini Workspace 数据没同步：3 个原因 + 修复路径
Gmail / Docs / Drive 让 Gemini 读，但它说"找不到这封邮件"。
无限滚动页内容未被收录：3 个原因 + 修复路径
首屏 20 条可见，下面 100 条 JS 加载——Google 看不见。
Last-Modified 响应头缺失：3 个原因 + 修复路径
页面更新后 Google 一直没重抓——服务器没返回 Last-Modified / ETag。
教程页截图过期：6 种 rot 来源 + 「版本戳 + 季度审」
截图里是去年 UI、说明对不上现在——信任掉、跳出率涨——审计 + 文件名加版本戳 + 季度刷新。
分页页 canonical 设置混乱：3 种常见错法 + 处理路径
page/2 的 canonical 指向 page/1 还是 self？Google 现在的真实建议。
Prompt 把 system 与 user 指令混用：3 个原因 + 修复路径
角色 / 全局规则塞进 user message，模型分不清优先级——输出乱跳。
Suno BPM 与预期不符：3 个原因 + 修复路径
想要 128 BPM 的舞曲生成成 95 BPM 慢歌——style 词控制了节奏。
Suno Cover 翻唱版权疑问：3 个常见误解 + 处理路径
能不能拿 Suno 翻唱别人的歌商用——版权三层：作曲、歌词、录音。
Suno 额度消耗过快：3 个原因 + 修复路径
Suno Pro 2500 credits 不到一周见底——多半因为默认每次出两条扣双份、Extend 和重生都独立计费。本文按消耗占比拆解 3 类来源，把月产出从 100 首拉回 300+。
Suno 中英文混杂不可控：3 个原因 + 修复路径
中文歌里突然冒出英文 ad-lib——style 描述用了英文术语。
Suno 升降调后人声变薄：3 个原因 + 修复路径
调高 3 个半音后人声金属化——pitch shift 算法不擅长大幅变调。
Suno 分轨导出缺失或不全：3 个原因 + 修复路径
Suno Pro 导出只拿到混音 MP3、没有人声鼓贝斯分轨——80% 是按钮点错、10% 计划档限制、10% 旧曲未支持。本文给一套稳定拿到 4-stem 或 12-stem 的路径。
Supabase Edge Function 冷启动慢：3 个原因 + 修复路径
第一次请求 2–5 秒——Deno isolate 没暖、依赖太大、外部 API 加成。
Supabase 连接池耗尽：3 个原因 + 修复路径
error: remaining connection slots are reserved——Serverless 直连 Postgres 必踩。
TestFlight 测试员无法兑换 redeem code：7 个原因 + 修复路径
发了邀请链接或兑换码，测试员点进去显示"Code invalid"——地区 / 帐号 / 已满。
通配 DNS 不命中三级子域：3 个原因 + 修复路径
*.example.com 配了 A 记录，但 a.b.example.com 仍 404——通配只配一层。
要执行结果，AI 却给了清单
让 AI 写落地页或重构函数，它却返回 10 条"步骤要点"——这是规划模式失效。本文讲清楚是哪些 prompt 框架把模型推进建议模式，以及怎么改写让它直接交工件。
AI 漏掉了最重要的那条约束：4 个原因 + 对症修复
你列了 5 条规则，模型守了 4 条，偷偷扔掉了真正最关键的那条。
只要轻改，AI 却大改特改
让它"润色一下"，结果换了一篇文章——你的语气和结构都丢了。
评判标准模糊导致答案弱：4 个原因 + 对症修复
你给了标准，但标准本身含糊——"吸引"、"专业"、"创新"——模型只能自由解读。
App 因"误导性宣传/过度承诺"被拒
App 被拒 Guideline 2.3.1 或 5.0，多半因为上架页文案、截图描述了 binary 里没有的功能。本文教你判断 Apple 到底在指控什么，并给出改文案或指路功能的回复模板。
App Review notes 写得不够清楚：6 个常见问题 + 重写模板
Notes 明明写了、审核员还是反复问同一件事——因为他们扫读不到 60 秒。本文讲为什么 notes 要按表单不要按散文写，并给一套凭证置顶、操作分步的重写模板。
App Store 产品页本地化混乱：6 类问题 + 修复矩阵
翻译后的元数据与主语言版本不一致，造成拒审或上架页表现不一致。
截图 / 元数据问题导致提交被拒：7 类原因 + 排查修复
Apple 因截图、描述、关键词或类目元数据问题拒审——即使 binary 没问题。
App 版本卡 "Waiting for Review" 太久：6 个原因 + 等多久才升级
提交了版本审核，状态一直 "Waiting for Review" 多天没动。
相互矛盾的指令削弱 AI 输出：4 个原因 + 对症修复
Prompt 里两条规则互相打架，模型只能折中，结果谁都不满意。
IAP 恢复购买跨设备失效：6 个原因 + 服务端权威修复
已付费用户点 Restore Purchases 却什么也没恢复。
模型按"最后一句"走，无视前面的规则
Prompt 末尾的一句"顺便提一下"会覆盖你开头写好的规则。
长背景掩盖了真正的任务：4 个原因 + 对症修复
三段背景结尾加一句"那你起草一下发布邮件吧"——模型却返回 400 字背景总结。本文讲为什么长上下文会埋掉任务，并给出几种把任务放到模型必看位的结构化模板。
没给示例，AI 输出就漂移变形
光靠形容词描述风格，模型只能按平均态近似；本文讲为什么 1-3 个具体示例能把目标形状锁住，以及怎么选示例、避免反例互相矛盾。
语气指令混乱让输出不稳定：4 个原因 + 对症修复
"专业又友好、正式又温暖、专家又易懂"=互相矛盾的语气目标。
模型用"擅自假设"填补缺失的细节：4 个原因 + 对症修复
让 AI 写季度总结、它把没给的续约日期、联系人、营收数字全编上——模型把"完整"解读为"不留空"。本文讲怎么让"我没有这条信息"成为一类合法输出。
负向约束写得太虚：4 个原因 + 对症修复
"不要太通用"只说了别做什么，没说要做什么——模型会换近义词绕开禁词、行为照旧。本文讲为什么纯负向约束必败，以及怎么把每条不要翻成可执行的正向引导。
新 build 上传后 App Store Connect 不显示：6 个原因 + 排查清单
Xcode 说上传成功，Transporter 说投递成功，但 App Store Connect 找不到这个 build。
没规定输出格式——所以得到一面墙的散文
想要结构化答案，结果是 600 字 prose，没法复制到任何下游工具。
Prompt 没说"成功长什么样"
让 AI 写"不错的摘要"，反复改 20 分钟没一个能定稿——因为 prompt 没说成功长什么样，模型只在"听着自信"上爬山。本文给一套 4 行可机械化的成功标准模板。
输出听着精致但不可执行：4 个原因 + 对症修复
AI 给的 4 段建议读起来像顾问 deck——没文件路径、没命令、没要查的配置值。本文讲为什么 polish 没工件等于装饰，并用 schema 强制 AI 交出可执行交付物。
Prompt 要"最好"但没定决策规则
没决策规则，"最好"就是模型觉得"听着自信"的那个。
从别的任务复制来的 Prompt 在这里失败
别处好用的 prompt 在你当前任务里产废话，因为前提没迁移。
Prompt 用情感词而非操作性指令
"求你写得超棒！"听起来真诚，但模型完全不知道要做什么。
Prompt 缺少上下文分级：4 个原因 + 对症修复
所有内容平铺成一面墙，模型分不清哪几行是关键、哪几行是背景。
Prompt 缺少素材优先级：4 个原因 + 对症修复
挂了 3 个文档，模型把它们当成同等权威——包括那份过期草稿。
Prompt 没定义受众：4 个原因 + 对症修复
让 AI 讲 Postgres 连接池，给出对资深工程师太浅、对 DBA 又太泛的 800 字——因为没指定受众，模型在为不存在的平均读者写。本文用一行受众陈述校准一切。
Prompt 太泛，产不出有用结果
问 AI "创业公司工程团队怎么 scale"，得到 800 字常规建议——泛问题必产泛答案，因为模型必须在整个输入空间都站得住。本文教你把宽问题收窄到唯一答案能成立。
Restore Purchases 按钮缺失：6 类问题 + 修复实现
付费墙或设置页没有 Restore Purchases 按钮，或藏太深，Apple 打回。
因审核员无法访问受限功能被拒：6 个原因 + 修复路径
Apple 拒审：审核员过不去付费墙 / 地区锁 / 角色门 / 邀请码，没法测某功能。
只设"角色"不够：4 个原因 + 对症修复
"你是一名资深工程师"能定调，但不会改变交付质量。你还是需要规则、格式、示例。
风格要求与输出格式冲突：4 个原因 + 对症修复
要 AI 同时输出温暖口语和严格 JSON，结果要么平板通过 schema、要么带类 JSON 标签的 prose 把 parser 弄挂——两者根本没中间地带。本文讲怎么挑一个或拆两遍。
购买后订阅 / entitlement 不一致：7 类原因 + 服务端权威修复
用户付了款但 App 里还是免费档；或者取消 / 退款后仍是付费。
Beta App Review 太慢：6 个原因 + 能做与不能做
提交 Beta 审核几天了还是 "Waiting for Review"。
TestFlight build 过期：90 天硬期限 + 替换流程
测试员看到 "This beta has expired"，或 App Store Connect 中 build 标记 Expired。
TestFlight build 在设备上看不到：7 个原因 + 修复清单
加了测试员、build 也批了，但 TestFlight App 里就是没有这个 build。
TestFlight 外部测试员收不到邀请：7 个原因 + 修复清单
TestFlight 加了外部测试员、UI 确认 Tester added，24 小时后大家都没收到邀请——可能卡在 Beta App Review、group 挂载、邮件服务商等环节。本文按命中率给 7 条修复清单。
示例太多反而压住任务：4 个原因 + 对症修复
塞 8 个示例覆盖每种情况，输出反而像示例拼贴或挑最像的去抄而不推理——示例有甜点位是 1-3 个。本文讲为什么多反而坏，并教你怎么挑代表性示例钉住输出。
一个 Prompt 塞了太多任务：4 个原因 + 对症修复
一个 prompt 塞 5 件事，模型把第一件做好、第二件搞砸、剩下的随便答。
任务边界不清，AI 自行扩大 scope
让 AI 改一个函数、它顺手重格式化相邻函数、改常量名、加注释——RLHF 让它默认"留下比拿到时更好的东西"。本文教你在 prompt 里显式画 in-scope / out-of-scope 边界。
Ad Blocker 对 RPM 的影响超出你想象
大量受众用广告拦截器——你真实的填充率与收入比 AdSense 面板显示的更低。
广告密度默默违反 AdSense 政策
你以为每页 5 个广告没问题——AdSense "valuable inventory" 政策不同意。如何找你布局的安全密度。
首页有广告但文章页没有：5 类原因 + 排查修复
首页 AdSense 广告正常、文章页空白，多半是两个模板之间漏了脚本、容器塌成 0 或 slot ID 不一致。本文给一套 DevTools 对比排查法，五分钟定位是哪一类。
ads.txt 找不到或延迟：5 类原因 + 排查修复
AdSense 面板报 "Earnings at risk — your ads.txt file is missing"——ads.txt 为什么重要、怎么部署。
AdSense 账号通过但这个站点仍 pending（2026）
账号早通过了，新加的站点 "Getting ready" 几周没动——逐站审核是独立于账号审核的。
AdSense 移动 vs 桌面填充率差距（2026）
移动填充 60%，桌面 95%——大部分流量来自移动。差距为什么存在、你能改什么。
AdSense 余额一直不到 $100 付款门槛（2026）
广告跑了好几个月，余额始终在 $100 以下——什么是合理预期、该怎么做。
AI 生成内容缺乏独特价值：6 种「平均互联网产出」来源 + 6 类必加独特内容
AI 文章读着顺但排名 47、AdSense 拒「unoriginal」——「独特价值」是 6 类具体添加（亲身经验 / 原始数据 / 反潮流观点 / 专家引用 / 独有截图 / 独创综合），少 3 类就不发。
文章数大但真实覆盖弱：6 种灌水来源 + 用“实质数”代替「篇数」
「我们有 800 篇！」但 60% 是双语副本、草稿、空 redirect——按 unique + indexable + 实质 URL 数。
发布日期与 JSON-LD 日期不一致
可见的"发布 / 更新"日期与 JSON-LD 的 `datePublished` / `dateModified` 不一致——这不只是外观 bug。
Auto Ads 出现在最差的位置
Auto Ads 把大横幅压在 H1 上、把 in-feed 广告塞进固定导航、移动端 anchor 广告挡住 CTA——如何不关 Auto Ads 也能约束位置。
双语版本逐渐漂移：6 种漂移类型 + 按对决定「翻译 / 同步 / 标单语」
EN 更新 5 次 ZH 还停在两年前——审计漂移、按对决定（翻 / 同步 / 标单语）、自动化未来同步。
Breadcrumb JSON-LD 与可见面包屑不一致
Rich Results Test 过但 Search Console 报 breadcrumb 不一致，或 SERP 面包屑看起来不对——如何让 JSON-LD 与可见 UI 对齐。
改了 canonical 但 Google 仍显示旧 URL
你把 canonical 改到了新 URL。几周后 Google 仍排名旧 URL。canonical 是提示不是命令——真正能换 canonical 的是这些信号。
分类页太弱不被收录也不排名：6 个「只是导航不是内容」原因 + 把分类页升级成 hub 文章
分类页只是标题 + 卡片——Google 看到导航不是内容。加 300 字编辑导言 + 精选「从这里开始」+ 你的观点，分类页就变成 hub 文章。
新分类页不被收录：4 个原因 + 对症修复
刚把内容拆成分类，新分类页就死活不收——分类页不是文章列表那么简单。
同一域名在 Vercel 工作但 Firebase 不行
2026 最新：同一域名绑 Vercel 正常，换 Firebase Hosting 就挂——Firebase 要求更严格的原因与修法。
页面被取消收录——是算法还是 manual action？
原本排名好的页面从 Google 消失。可能是算法更新，可能是 manual action——怎么判断？
草稿页误发布：6 种泄漏来源 + CI guard 防再发
Build 把还 `draft: true` 的页面也部上线了，Google 收录了占位符内容——审计 + 去索引 + CI 加 guard 让 build **不可能**把 draft 发到生产。
域名指向错误的托管商：4 个原因 + 对症修复
你换了托管商但 DNS 仍解析到旧的——在 DNS 链路里去哪找错记录。
重复域名版本被收录——http / https / www / non-www
Google 把四个版本都收录——每个分掉链接权重。如何统一到一个 canonical。
Meta description 在大量页面重复
Search Console "HTML Improvements" 或第三方爬虫显示几百页 meta description 相同——为什么没你想的那么严重，但仍要管。
双域名 / 同站审核混乱（2026）
yourbrand.com 和 yourbrand.net 内容相同——AdSense 报重复或不通过。如何解决。
大量页面重复 title：6 种来源 + 「per-page title 必填 + CI 拦」预防
审计报 80 页共用一个 `<title>`——一般是模板 fallback / 分页 / 双语未消歧——让 per-page title 必填、CI 拦同标题。
FAQ schema 缺失或无效：4 个原因 + 对症修复
Rich Results Test 报 FAQPage 错。Search Console 移除 FAQ rich snippet。常见原因与修法。
Google 只爬首页，从不爬文章页
Search Console 显示首页天天被爬，但 /articles/* 几乎不被抓——为什么？
Google Publisher Tag (GPT) 不加载
从 AdSense `<ins>` 换到 GPT 想要更多控制——slot 不填、console 报 GPT 错。首次用 GPT 的常见原因。
Googlebot 抓取上升但曝光不动
Crawl Stats 显示 Googlebot 每天抓数百 URL，但 Performance 曝光持平——抓取 ≠ 流量。
首页分不出权重：6 种过度出链 + 砍到 30 个目的地
首页 200 条出链 = 每条 0.5% 权重——砍到 30 个刻意选的目的地，长列表挪到专门 index 页。
双语站 hreflang x-default 混乱
设了 en 与 zh 的 hreflang，但 Search Console 报缺 x-default——x-default 到底是干什么的、什么时候需要。
HTTPS 没强制——站点同时服务 http 和 https
你的站点 http 和 https 都能开。Google 把两个版本都收录，安全评分下降。
改版后 Indexing Coverage 下降
改版后 Search Console 显示已收录页数下降——什么是真损害、什么只是正常重新评估？
内链分布严重不均：6 个来源 + 「正文内链 + 智能 related」再平衡
Top 10 页吃 80% 内链、200 页只有 0-2 条——重平衡是 ROI 最高的 SEO 动作（不需要新内容，只连接已有的）。
大型内容站收录缓慢：5 类原因 + 排查修复
站点有几千页但只有少量被收录——为什么会这样，真正能推进的是什么？
静态站手动广告位不渲染（Astro / Next 导出）
Astro / Next / Hugo 静态导出里 AdSense `<ins>` 块一直空——hydration 与组件挂载怎么破坏广告渲染。
页面多但展示少：6 种死长尾来源 + 「先验证再写 + A/B/C 分级」
500 篇文章、Top 20 拿 80% 展示、长尾 0-5/月——幂律正常，**死**长尾才是 bug——写前先验证关键词、按 A/B/C 分级升级 / 降级 / 清除。
Meta robots vs X-Robots-Tag——谁说了算
`<meta name="robots">` 与 `X-Robots-Tag` HTTP header 冲突时行为不可预测——怎么选、怎么保持一致。
内容站还没流量就想接广告：3 个原因 + 修复路径
AdSense 已通过，但每天赚 $0.50——10 个访问者怎么赚？什么时候申请、什么时候等、这期间做什么。
Name Server vs DNS 记录——到底在哪里改
2026 最新：新手分不清 name server（NS）与具体 DNS 记录（A / CNAME）——改一个不懂另一个，调几小时。
新站卡在 Discovery 阶段
新域名上线 4–8 周。sitemap 已提交、URL Inspection 显示 "Discovered"——但没任何进展。
设了 noindex 但页面还在搜索结果里
几周前加了 `<meta name="robots" content="noindex">` 但页面仍在 Google——最常见的几种原因。
公开页被误打 noindex：4 个原因 + 对症修复
模板默认或迁移失误把 `<meta name="robots" content="noindex">` 留在了应该公开的页面。怎么发现并回滚。
搜索结果出现旧部署 URL 而不是自定义域名
Google 收录 `your-app.vercel.app` 或 `your-site.web.app` 而不是你的自定义域名——为什么、怎么修。
孤儿内容页拖累站点质量：6 种孤儿来源 + 「整合或清除」二选一
0 入链的页面不仅是索引债——是给 Google 的质量信号（站点不链自己内容 = 无话题结构）——检测后按页二选一：整合 or 清除。
孤儿页——没有内链所以收录不了
URL 在 sitemap 里，但站内没有任何页面链向它——Google 视它为不重要，要么延迟抓取，要么直接跳过。
页面已收录但 Search Console 一直 0 曝光
Search Console 显示已收录，但 Performance 报告里 28 天 0 曝光——这其实意味着什么？
AdSense 隐私政策缺失或不完整（2026）
AdSense 要求隐私政策必须覆盖第三方 cookies 与个性化广告。很多独立站在这一步被拒。常见原因：完全没隐私页；隐私页有但没提 AdSense / Google / cookies / 个性化广告；欧盟流量没 cookie consent 横幅。先做：建 `/privacy` 页（或更新已有）。
换域名后重定向全坏了：4 个原因 + 对症修复
从 old.com 迁到 new.com。部分页正确 301，其他 404——如何映射并验证完整的重定向集。
为什么反复 resubmit URL 也不能让 Google 收录
你点了 10 次 Request Indexing，URL 还是没收——URL Inspection 不是大家想的那个东西。
Robots meta 与 sitemap 说法不一致
sitemap.xml 列出了带 `<meta name="robots" content="noindex">` 的 URL。Google 报警但结果不一致——为什么、怎么修。
RSS / OG URL 仍是占位域名
从 starter 模板起步，RSS 条目与 og:url 仍写 `https://example.com/...`——为什么这些是默默的 SEO 杀手。
Search Console 出现大量低价值 URL：6 类噪音来源 + 按源屏蔽
「Crawled — not indexed」涨到几千条 `?sort=`、`?page=`、tag 组合——按源分类、用 canonical / robots / noindex 屏蔽，把 crawl budget 还给真内容。
Search Console Pages 报告无故下降
"Indexed" 一夜掉了 50–200 个 URL。没改东西、没报错——发生了什么？
换域名后 Search Console 资源对不上
换了域名但老 GSC 资源不跟新的——如何迁移又不丢历史数据。
内容站疯长但内容雷同：6 种「模板化思维」来源 + 多样化设计
3 个月 100 篇文章——同结构、同例子、同结论——这不是 AI 问题，是模板化思维。轮换 brief + 强制独特添加 + 必要时减速。
域名连接后站点时而能开时而不能：4 个原因 + 对症修复
新平台绑域名后刷一下打开、刷一下报 Domain not configured——部分 resolver 看到新记录、部分还看到旧的。本文讲 DNS 半过渡时发生了什么以及怎么加速彻底切换。
sitemap 里有但 Search Console 不显示
2026 最新：sitemap.xml 已提交、URL 都在里面，但 Search Console Pages 报告完全没有——常见原因。
Sitemap 仍引用旧域名：3 个原因 + 修复路径
迁移域名后，sitemap.xml 仍列旧域名 URL——Search Console 报 host 不匹配。
浏览器 SSL Mixed Content 警告
站点是 HTTPS 但浏览器显示 "Not fully secure"——HTTPS 页加载了 HTTP 资源。
文章长期不更新变陈旧：6 种「不更新」原因 + 「按流量 × 年龄」优先级刷新
一半文章 3+ 年没改了——按 traffic × age 排序、做真刷新（不要 date-bump 把戏 Google 看穿）、把刷新做成季度 cadence。
改模板后结构化数据变无效：4 个原因 + 对症修复
模板重构或框架升级把全站 JSON-LD 打挂——如何发现并修。
标签页被收录但文章页落后：3 个原因 + 修复路径
Google 已经把所有标签归档页都收了，但文章页仍卡在 Discovered 或 Crawled — currently not indexed。
页数很多但仍被判太薄：4 个原因 + 对症修复
你有 200 篇文章但 AdSense 拒审 "low value content"——页数不是指标，独特价值才是。
薄页面被 Google 默默降级：4 个原因 + 对症修复
Google 不会显式罚薄页面——它只是默默降级：更少抓取、更低排名、最后掉收录。
标签太多生成大量薄归档：6 种 tag proliferation + 「阈值 + 治理」
800 个 tag、600 个只有 1-2 篇 = 600 个薄归档页——设最少文章阈值、合并近义词、低于阈值的 noindex、加 tag 治理。
薄页面太多拖累整个内容站：6 种薄页来源 + 「expand / merge / noindex / 410」四档处理
500+ 页 Google 觉得多数薄——按字数 + 流量审计，每页打 expand / merge / noindex / 410——剪掉最弱的 20-40%。
Topic cluster 太浅、pillar 排不上：6 种 stub 来源 + 「6-10 卫星 + 双向链」
1 pillar + 2 卫星不是 cluster——是 stub。真 cluster 6-10+ 卫星——brainstorm 子话题、2-3 月稳定发、双向 link。
TTL 太高让 DNS 变更变慢：2 个原因 + 修复路径
改了 DNS 却要 24h+ 才传播——改之前先降 TTL 让传播可预测。
分享到 X/Twitter 不显示卡片图
分享 URL 到 X/Twitter 没图，即使 og:image 已设——Twitter 卡片有它自己的规则。
我用了 Removal 工具——然后呢？
Search Console 的 Removals 是约 6 个月的临时屏蔽，不是永久删除或"强制重收"按钮。被很多人误用。
VideoObject Schema 没被 Search Console 识别
你给嵌入视频加了 VideoObject JSON-LD，但 SERP 没视频 rich result、视频 tab 也没列——为什么。
WebSite JSON-LD 与站点信息不一致
站级 WebSite JSON-LD 声明的 name / URL / SearchAction 与实际不符——为什么让 Google 混乱，如何对齐。
什么情况下"收录慢"其实是正常的：4 个原因 + 对症修复
收录慢容易让人慌。新站、新分区、改版后的真实基线是什么样的。
www 与 non-www 都能独立打开
访客既能开 yourdomain.com 也能开 www.yourdomain.com，两个都能加载——为什么伤 SEO，怎么修。
A vs CNAME 困惑——该用哪种？
主机文档说用 A、教程说 CNAME，apex 上配 CNAME 还会让 MX 邮件失效——本文给一张速查表，告诉你 apex/www/子域分别该用哪种 DNS 记录、迁移时怎么避坑。
AdSense 审核通过但广告不展示
AdSense 已审核通过但文章页仍然空白？按 ads.txt、广告单元、脚本加载、政策限制和流量不足五个方向逐项排查。
AdSense "Low value content" 被拒后的恢复
AdSense 回复 low value content 很少跟字数有关，问题通常出在独特价值、清晰目的、导航性这三项。本文按修复命中率从高到低排，告诉你逐项怎么改才能通过复审。
AdSense Auto vs Manual：两个混用之后的故障排查
Auto Ads 和 Manual 同时启用导致的常见问题：广告重叠、版式抖动、Core Web Vitals 下滑。需要选型比较，看相关页。
AdSense "No ads available"
inspector 显示"无广告可投"——库存 / 主题 / 地区原因。
AdSense 政策警告怎么处理：3 个原因 + 修复路径
AdSense 政策警告邮件给的是倒计时：7 天内不修好就停投或停号。本文拆解 Policy center 七类警告各自在说什么、该改什么，并教你避免浪费有限的复审次数。
AdSense 代码装了广告位空白
脚本加载了，但广告位空——slot 配置 / 页面资格 / 拦截器。
AdSense "Your site needs review" 怎么办
提交后看到 "needs review"——这是正常初始状态，等待期可以做些事。
AdSense 拖慢页面：3 个原因 + 修复路径
接入 AdSense 后 PageSpeed 从 92 掉到 47、LCP 翻倍、CLS 飙到 0.35，大概率是 3-4 个具体接线问题而非广告本身。本文按命中率排出可修项，逐条给出代码改法。
AI agent 在循环、不进展怎么办
Agent 一直试同一个修法，或在两种状态之间反复——快速打断的方法。
Agent 回滚不彻底：6 个域 + 按域回滚 checklist
代码回了，但 agent 漏了：过期 `dist/`、已应用的 migration、未关的 feature flag、第三方 dashboard 的改动——按域回滚，不要靠 `git reset`。
AI 回答太泛——怎么逼出具体答案
问 AI 一个具体问题、收回四段"看情况"式废话，几乎都是 prompt 形状问题。本文拆六种触发外交辞令的写法，给出把模型逼回锋利判断的改写模板。
AI 视频转场生硬：3 个原因 + 修复路径
两段 AI 视频之间剪在一起跳——匹配运动 / 色彩 / 节奏。
本地 build 过，CI 挂——AI 改完最常见的坑
经典场景：AI 装了依赖没提 lockfile，或依赖了本地 Node 版本。
AI 改代码后 build 挂了——恢复与诊断
AI 跑完一轮 build 报错。用 diff review、类型检查和定向 revert 修。
AI agent 把 .env 覆盖了怎么办
Agent 用占位符重写或删了 .env——如何恢复并预防。
AI 图片多手指 / 手画崩：3 个原因 + 修复路径
Midjourney v7、SDXL、Flux Pro 在 2026 年仍会出六指、扭曲手——根因多半是手部像素不够、姿态太复杂或档位低。本文给一套构图调整加二次 pass 修复流程。
AI 输出了不存在的事实——怎么发现与减少幻觉
AI 自信地编出错误论文引用、不存在的 API 函数、差一个数量级的数字——幻觉集中在"要事实"和"没源头"的缺口处。本文用检索、源材料锚定、不确定标注三招堵上。
AI 凭空引用了不存在的文件：3 个原因 + 修复路径
Agent 写了 `src/utils/superhelper.ts` 这种从未存在的导入——常见但易修。
AI 动漫风混入写实：5 类原因 + 5 步修复路径
想要动漫，输出却夹着写实皮肤、眼神、光影？用具体动漫参考锚定，并剥掉所有写实触发词。
AI 图片背景太抢戏：5 类原因 + 5 步修复路径
背景比主体更显眼？显式指定背景风格——纯渐变、可控散景、纯色背板这三种，挑一种锚住。
AI 图片人物每次长得不一样：5 类原因 + 6 步修复路径
同样的人物描述，每次出来都不一样？需要参考图、锁种子、再加独特识别点——纯文字描述无法锁定身份。
AI 图片构图太杂：5 类原因 + 6 步修复路径
主体太多互相打架？砍到一个主角 + 最多两个配角，加景深把其他元素推到背景。
AI 图片细节少 / 糊：6 类原因 + 6 步修复路径
出图看着模糊、塑料感重？三大独立原因叠加：分辨率不够、步数不够、Prompt 缺细节锚——逐个修。
AI 图片总是不像 prompt：原因 + 修复路径
模型忽视了 prompt 大部分内容——通常是顺序 / 权重 / 自相矛盾。
AI 图片打光平 / 难看：6 类原因 + 6 步修复路径
主体平、硬、没有立体感？用摄影术语锁主光（方向 + 质感 + 来源 + 色温），形容词永远做不到这种效果。
AI 图片系列风格不一致：6 类原因 + 6 步修复路径
想做 5 张一致的图，结果像 5 个不同画师画的？锁一句风格锚句、复用一张参考图、固定 seed——加 LoRA 用于 30+ 张系列。
AI 图片风格不统一怎么办：让 8 张图看起来像一个系列的 6 个方法
用 Midjourney / Flux / SDXL 生成的系列图风格永远不统一？一张油画一张漫画一张写实？本文给出 6 个真正可控的方法，让 AI 生成的图能「成系列」。
图转视频偏离原图：原因 + 修复路径
开头是 A、结尾变成另一个人——motion 强度 + 身份锚点能修。
AI 图片长宽比不对：6 类原因 + 6 步修复路径
你设了 9:16，出来 1:1？每个平台对长宽比的解析方式不同——参数语法、模型支持、UI 默认覆盖——一个个排查。
AI 视频口型对不上音频：原因 + 修复路径
嘴型和你单独生成的音频对不上——音视频分别生成、工具不支持、帧率不匹配。
AI 编辑后 merge 冲突——解决指南
Claude Code 或 Cursor 改完 6 个文件、rebase 一打回车满屏 CONFLICT，难点是分辨格式噪音和真正的逻辑冲突。本文给一条隔离 AI commit、分层处理冲突的路径。
AI 输出风格漂移——怎么把风格钉死
system prompt 没动、模型没换，几轮之后 AI 又开始写"快速变化的数字化时代"——这是软约束 vs 硬约束的问题。本文教你把形容词风格翻成模型可自检的可测规则。
AI 编辑后 package-lock / pnpm-lock 冲突
Agent 装 / 删了依赖，lockfile 和团队的对不上了。
AI 图片写实但看着像塑料：原因 + 修复路径
写实 prompt 出来塑料感——多半是灯光 / 皮肤 / 材质语言不够。
AI 商品图看着假 / 不带货：原因 + 修复路径
AI 生成的商品图反光位置不对、阴影和光源对不上、背景干净得像渲染——读起来像 AI 顾客就不下单。本文从灯光、材质、真实环境锚点三角度给出 prompt 修复路径。
AI 重构生成了重复文件：3 个原因 + 修复路径
Agent 在原文件旁边建了 `UserList2.tsx` 这种重复文件——安全清理步骤。
AI 重构把还有用的逻辑删了：3 个原因 + 修复路径
AI 把 50 行重构成 28 行看着漂亮，两天后客服群冒出登录跳错页——它把某个客户场景的兜底分支当死代码删了。本文教你用 bisect 加 prod 日志精确定位并加回。
AI 改动了你不想动的关键部分：4 个原因 + 对症修复
让 AI 改一个参数名，它顺手把重试循环换成 map、timeout 从 30s 调成 10s——你的 prompt 一句都没提。本文讲清楚为什么 agent 爱过度编辑，以及怎么把它约束成手术级 diff。
AI 改代码后怎么安全回滚：3 个原因 + 修复路径
三条命令覆盖 99% 场景：stash / restore / reflog。
AI 写出来 TypeScript 类型错误
AI 出的代码过不了类型检查——通常是类型猜错、any 转换、漏掉泛型。
AI 图片里的文字读不出来 / 错字
AI 图里 RESPECT 出成 RESPCT、字母粘连、单词中途换字体——子词 tokenizer 让模型对字形猜不准。本文讲短词 prompt、模型选型、后期补字三条修复路径。
AI 视频背景闪烁：原因 + 修复路径
背景帧间风格 / 形状跳——多半是 prompt 互相打架、运动太强、或模型限制。
AI 视频镜头莫名晃动：6 类原因 + 6 步修复路径
静态镜头 Prompt 出来却抖？多数 AI 工具默认加“手持轻动”——必须在 Prompt 里写 locked tripod，再把动作滑块拉到 0。
AI 视频人物中途漂移：6 类原因 + 6 步修复路径
同一人物几秒后五官就变了？单段控制在 4s 内、永远用同一张基准参考图、动作强度降一档。
AI 视频脸中途变了：6 类原因 + 6 步修复路径
第 1 帧是 A，第 60 帧不是了？模型的身份一致性窗口大约 3-4 秒——锚定参考图、缩短片段、降动作强度。
图转视频完全不像原图：6 类原因 + 6 步修复路径
视频出来不像输入图？图像强度推满、文字 Prompt 砍短、源图至少 1024px 且主体占画面 40%+。
AI 视频动作不连贯怎么办：让 Sora / Veo / 可灵 动作不跳的 7 个方法
AI 视频生成后人物多手指、动作突变、物体闪现？这是当下所有视频模型的通病。本文给出 7 个可控的方法让动作更连贯：写好动作 Prompt、控时长、用图转视频、做接力。
AI 视频动作不科学：6 类原因 + 6 步修复路径
人向前跑腿向后、水往上倒、手穿过物体？动作动词模糊+物理不能凭模型猜——明确方向、目标、起止姿态。
AI 视频动作抖动：原因 + 修复路径
AI 视频里主体每 5 帧瞬移几像素、肢体在过渡帧抖动——这是动作路径插值崩了，跟背景闪烁不是一回事。本文讲降动作野心、给姿态锚点、提高 fps 三招稳住路径。
AI 视频运动过度：6 类原因 + 6 步修复路径
画面里啥都在动一片乱？降动作强度、删多余动词、只让一个元素动（镜头或主体二选一）。
AI 视频节奏不对：6 类原因 + 6 步修复路径
片段拖沓或太赶？单段控制 2-4s、剪辑里按节拍切、时间轴上有意让片长不一——节奏在剪不在生成。
AI 视频商品形变：6 类原因 + 6 步修复路径
瓶子拉长、包装扭曲、logo 弯了？商品镜头当微距处理——高质量参考图、最低动作、短片段。
AI 视频不同镜头场景不一致：6 类原因 + 6 步修复路径
同一场景描述出来两个房间？建立场景锚：一张基准大全镜头、统一灯光语言、共享道具清单——后期再 color match。
AI 视频人物中途变成别人：原因 + 修复路径
AI 视频片头是 A、片尾突然变成 B——脸、衣服色、体型都换了，这是身份锚点不够强。本文讲怎么用具体描述、参考图、缩短片段三招把主体锁死。
AI 视频感觉太静：原因 + 修复路径
要了一段视频、得到一张近乎静止的幻灯片——5 像素视差、一片叶子飘——这是模型对动作太保守。本文用强动词、motion 强度、镜头运动三招把视频救活。
AI 视频物理不自然：6 类原因 + 6 步修复路径
液体横着流、布料反重力、球往上滚？模型没有物理引擎，靠剪辑回避而不是硬画——必要时合成真实物理元素。
AI 图片构图弱 / 死板：原因 + 修复路径
AI 图主体在、光线对，但构图死板——居中中景、无纵深、无引导线，这是默认构图陷阱。本文把构图当 prompt 必填项，给一套机位、引导线、纵深词清单。
"Alternate page with proper canonical tag" 是什么
Search Console 出现 Alternate page with proper canonical tag 一堆 URL，多数人以为被拒收录，其实是 Google 按你的 canonical 配合不收录这条变体。本文讲清楚和真正问题怎么区分。
App 隐私问卷被拒 / 不一致：3 个原因 + 修复路径
Apple 标你的隐私 nutrition 标签与 App 行为不一致。常见原因：第三方 SDK 收了你没申报的（analytics / 广告 / 崩溃 / attribution）；申报"未收"但 SDK 证明在收；必需披露（与用户关联 / 用于 tracking）缺。先做：列每个 SDK + 各收什么（看各 SDK 隐私文档）。
App 因 4.3(b) 被拒：design spam（2026）
Apple 援引 4.3(b) 拒了你 App："design spam"。
审核期间 Demo 账号失效：6 个原因 + 对症修复
App 提交后回 Metadata Rejected，留言写 demo 账号 invalid credentials，但你自己测能用——多半是审核员陌生 IP 撞上安全策略。本文按命中率给六种原因和修复。
因 Guideline 2.1 被拒——需要更多信息：6 个原因 + 修复模板
App 被拒 Guideline 2.1 Information Needed 不是 binary 问题、是文档问题：审核员走不到某条路径需要你在 notes 里指路。本文给六类原因和逐字回应的 notes 修复模板。
Astro 部署后页面 404：3 个原因 + 修复路径
dev 正常、线上 404——`build.format` / trailing slash / output mode 三者要对齐。
登录回调跳到错误的 URL：3 个原因 + 修复路径
登录回调跳回 localhost 或错误域——allowed redirect URI 配置问题。
换域名后 canonical 还是老域名
改了主域名，但 canonical 还指老的——通常是配置 + 缓存。
canonical 写错会怎样：3 个原因 + 修复路径
canonical 写错会让真页进不了索引、或排名 URL 是参数版甚至别人的站，且浏览一切正常只有 Google 知道。本文给三类真实出错写法 + Search Console 验证步骤。
双语站 canonical 错配：3 个原因 + 修复路径
双语 / 多 locale 页 canonical 指错方向。常见原因：模板写死一个 canonical；translationKey 逻辑误作 canonical；默认 canonical fall back 到默认语言 URL。先做：每篇：canonical 等于自己 URL。
ChatGPT 账号切换不生效：4 个原因 + 对症修复
界面上切了账号，但 ChatGPT 还在用旧的——多半是 session 缓存、cookie 作用域或 Workspace 锁定。
ChatGPT App 和 Web 不同步怎么办
Web 上能看到的对话 App 里不见了（或反之）？三件事要核对。常见原因：两端登的账号 / Workspace 不同；App 版本太旧；某一端是 Temporary Chat。先做：确认两端是同一邮箱 + 同一 Workspace。
ChatGPT 登录成功后白屏：5 类原因 + 排查修复
登录跳到 chatgpt.com 后一片空白——多半是脚本加载失败、service worker 卡死或扩展冲突。
ChatGPT 因 Cookie 被拦截导致登录失败
第三方 cookie 被屏蔽时 Auth0 握手完不成——按浏览器逐个给出要打开的开关。
ChatGPT 把你的 CSV / Excel 数据看错了
数字算错、表头错位、日期颠倒——数据工具链有坑。这里给出保证准确的做法。
ChatGPT 文件分析感觉太浅：5 个原因 + 对症修复
要分析，得到的全是泛泛的 bullet——修法在 prompt，不在模型。
ChatGPT 上传的文件从对话里消失
上传文件、问了一个问题，文件就没了？是真没了还是只是不在活跃上下文里，取决于你怎么传的。
ChatGPT 不支持这种文件类型——能用的变通方案
ChatGPT 拒收或说没法分析？转一下格式通常比硬刚更快。关键：先识别真实类型，再转成它处理质量最高的几种。
ChatGPT 文件上传失败怎么办：格式、大小、地区与扩展全排查
ChatGPT 上传 PDF / Excel / 图片一直失败、卡 0%、或显示「Failed to upload」？这篇按格式、大小、网络、扩展、账号等维度给出 9 条排查路径。
ChatGPT 生成的文件下载失败
ChatGPT 给了一个文件链接，但 404、卡住、或空文件——多半是 session 过期、计划限制、或沙盒超时。
Custom GPTs 打不开/不响应——快速排查
GPT 点开是空白、或 action 静默失败？多半是缓存、登录状态、或 action manifest 出问题。
ChatGPT 对话历史不见了——五步排查
ChatGPT 历史侧边栏空了 95% 不是真丢——多半是登错账号、被归档、history 关了或 workspace 切走。本文给五步排查 + Export Data 兜底，找回 30 天内任何对话。
ChatGPT 图片生成失败——四大常见原因
配额、Safety filter、Prompt 写法、模型可用性——按概率排查。
ChatGPT 看不懂上传的图片：6 类原因 + 排查修复
截图或图表传上去 ChatGPT 描述错了——多半是分辨率、OCR 局限、对比度、或问法太空。
ChatGPT 大文档分析感觉很浅——怎么让它彻底读
200 页报告上传了，总结却像只读了 30 页。模型在"略读"——用分章节查询逼它读深。
ChatGPT 登录循环——登进去又跳回登录页
密码对了、SSO 成功，但页面又跳回登录界面？90% 是 cookie、第三方存储或缓存的旧会话出了问题。
ChatGPT 在一个浏览器能登另一个不行
Chrome 能登、Safari 不行（或反之）——账号没问题，差异在浏览器的 cookie 策略、扩展和版本。
ChatGPT 记忆不生效怎么办：4 个原因 + 对症修复
ChatGPT 不是会议纪要、不会记每件事，Temporary Chat 和 Custom GPT 下 Memory 直接不工作。本文按命中率给出 6 种触发情形和对症修复，让它真的记住你说过的话。
ChatGPT 提示"You've reached your limit"怎么办
消息上限到了怎么处理？这个滚动窗口的真实含义。常见原因：每个模型有滚动窗口（例如 3 小时 X 条）；图像生成有独立配额；Plus / Team / Enterprise 上限不同。先做：换一个更轻的模型——上限是按模型分的。
ChatGPT 手机 App 与网页登录不一致
同邮箱、同密码，但手机 App 和网页明显在不同账号上——workspace、SSO 方式、App Store 订阅是 3 大原因。
ChatGPT 不会跨文件比较：5 个原因 + 对症修复
传了 3 个文件想做对比，ChatGPT 只引用了一个——跨文件综合要显式指令。
ChatGPT network error 怎么办：8 种最常见原因与对应解决方法
ChatGPT 发消息显示 network error 或 There was an error generating a response？这篇按出现频率排好的 8 种原因 + 排查步骤，覆盖网络、代理、超长上下文、扩展、模型负载等所有常见场景。
ChatGPT 密码重置邮件没收到
点了忘记密码邮件迟迟不来——和注册验证不是一个流程，速率限制更严，常被 SSO-only 账号坑。
ChatGPT 读不了 PDF——三大常见原因
PDF 上传后说"没看到内容"？多半是扫描件、文件过大、加密三件事之一。
ChatGPT Project 上传的文件没被引用
文件上传到 Project 了，ChatGPT 却像不知道——多半是文件名信号、检索范围、或问法的问题。
ChatGPT Project 指令不被遵守
Project Instructions 写得很详细，但 ChatGPT 中途就忽略了——多半是指令权重、与当前消息冲突，或 Projects 本身的局限。
ChatGPT Project 上下文与 Chat 上下文的区别
Project 里设了 instructions 和文件，但里面的某个 chat 不遵守——两层上下文怎么共存先搞清楚。
ChatGPT 反复提示会话过期
ChatGPT 用着用着就被踢下线，几分钟一次——cookie 被清、多 tab 抢 token、公司代理剥 header 是 3 大主因。
ChatGPT 分享链接打不开——常见原因
别人发的对话链接 404 / 空白——通常是分享者端的问题，不是你这边。
ChatGPT 分享链接 vs 账号登录——分清楚两者的边界
分享链接是只读快照，不是登录这个对话——这里讲清两者的功能、URL 模式和常见混淆。
ChatGPT 回答变慢怎么办：4 个原因 + 对症修复
回答慢通常来自三件事，按概率排：会话太长、模型选错、网络往返延迟。
ChatGPT 一直 loading 怎么办：6 种卡 thinking 的真正原因
ChatGPT 发完消息后回复处一直转圈，几分钟没有任何输出？这不是一种问题，而是 6 种问题。本文给出最快的判断路径与对应解决方法。
ChatGPT "Suspicious activity detected" 怎么解决
99% 是出口 IP 触发安全验证，不是账号本身的问题。最短解锁路径在这里。
ChatGPT 上传的 PDF 分析不正确
PDF 上传成功但 ChatGPT 漏读表格、跳页、数字错——多半是抽取层而不是模型本身的问题。
ChatGPT 验证邮件收不到——6 个排查方向
注册或登录验证邮件迟迟不来？多半是垃圾邮件、别名邮箱过滤、企业邮箱 ATP、地区延迟或地址打错。
ChatGPT 语音功能用不了——三步排查
语音不开口、卡在 listening、或干脆不启动？90% 是麦克风权限 / 地区 / 客户端版本三件事之一。
ChatGPT 联网搜索不可用 / 不触发
ChatGPT 联网现在是 Web search 开关、自动判定、SearchGPT 三套机制——任一条件不满足就不触发。本文按命中率拆四种原因，告诉你怎么强制启用或排查不可用。
ChatGPT 登录方式不对——注册后用错认证方式
用 Google 注册但用邮箱密码登录（或反过来）——ChatGPT 静默拒绝，看起来像密码错。
Claude Artifact 下载失败 / 文件为空
下载按钮没反应或下到 0 字节文件——通常是渲染未完成或浏览器拦截。
Claude Chrome 插件抓不到网页内容怎么办
插件显示已附加但 Claude 看不到页面——通常是权限、页面类型或当前 Tab 问题。
Claude Code 反复问不必要的问题：6 个噪音原因 + Defaults 设计
你要执行，agent 每 30 秒停下来问「用 TypeScript 还是 JS」——在 CLAUDE.md 写默认值 + 「只在破坏性操作前问」规则。
Claude Code 中途丢了项目上下文：6 个 summarization 触发 + 重启 vs 加固
Agent 突然忘了之前定的事、反复读 CLAUDE.md、和 plan 矛盾——自动摘要把承重细节压没了。重新锚定或者干脆 restart。
Claude Code 不理解整个项目怎么办
Claude Code 一直在改同几个文件、或完全忽略别的目录——用 CLAUDE.md 锚定上下文。
Claude Code 不照审计报告做：6 个降为「建议」的原因 + 把报告当合同
你给了详细 audit report，Claude Code 我行我素——它把报告当 context 不当 contract。转成编号 checklist、一次一条执行、终点 diff 对账。
Claude Code 误解你的项目架构：6 个 generic prior 取胜 + 用「我们用 / 我们不用」清单 + canonical 锁死
Agent 建议「拆成微服务」但你刻意单体——在 CLAUDE.md 写「we use / we don't use」+ 真文件 canonical example，让具体战胜泛型先验。
Claude Code 输出和 prompt 不符：6 个 plan 阶段误读 + restate-before-execute
Diff 是漂亮代码但解决了**别的**问题——misalignment 几乎总是 plan 阶段，不是 code 阶段。强制让它先 restate task 再动手。
Claude Code 覆盖了你未提交的改动：6 个触发原因 + 编辑器 local history 抢救
未提交的活儿被 agent 跑没了——先用编辑器 local history 抢救，再用「跑 agent 前先 commit」 + worktree 防止再发生。
Claude Code Plan 模式偏离计划：6 个 scope creep 来源 + 把 plan 当合同
你批准 5 步 plan，Claude 做了 7 步、跳了 1 步、顺手 refactor 旁边代码——把 plan 当 numbered checklist + 每步停下来汇报。
Claude Code 不理解你的项目怎么办：让 agent 真正读懂代码的 7 个方法
Claude Code 改了一半文件、问的问题对不上、找不到关键函数？多半不是模型不行，而是它没拿到正确的项目上下文。本文给出 7 个方法让 agent 一次就读懂你的项目。
Claude Code 重构 scope 越做越大：6 个 creep 来源 + 「可编辑文件清单 + FOLLOWUPS.md」
你要小改，PR 一来 5 个文件、200 行——在 prompt 里固定可编辑文件清单，相邻问题写到 FOLLOWUPS.md，不要顺手改。
Claude Code 因额度耗尽中途停下：6 类 limit + 可恢复任务设计
重构做一半 Claude Code 提示额度用完——分清是 5 小时 / 周 / 单模型哪种 limit，立刻 dump 状态，按对应路径恢复。
Claude Code 部分执行后卡死：6 种卡死形态 + 分清「上下文 / 工具挂 / 静默 abort」
做完 60% 不报错也没完成消息——三种形态：context 满、工具挂、静默 abort，每种的诊断和恢复路径不同。
Claude Code 卡在循环里：6 种 loop 签名 + 各自的一句话破解
Agent 反复同样 edit、来回切换两个文件、永远追 flaky 测试——6 种 loop 签名各有诊断和 one-prompt 破法。
Claude Code 改错文件：6 种命名混淆 + 用 allow + deny 清单防御
改了你没让改的文件——同名 / 大小写差 / import 链外扩——git revert + 在 prompt 里加 allow / deny 清单消歧。
Claude Connector 没权限——找管理员要什么
Connector 授权失败或返回为空——三层锁：Workspace 管理员策略、OAuth scope、目标应用策略。
Claude 文件生成为什么更耗额度
Claude 是按 token 计费，不是按"条数"。文件生成会把整份内容算进 output。
Claude 连接 GitHub 失败——三步排查
连不上 GitHub 或显示没仓库？OAuth scope / 组织权限 / 仓库可见性三层挨个查。
Claude 回答不准确怎么办——三处调整
Claude 信誓旦旦地说错——80% 不是"换模型"能解决的，要看 context / system prompt / 检索。
Claude 长对话变不稳定怎么办
聊到 50 轮 Claude 开始自相矛盾或忘掉刚才的决定——上下文挤掉了。
Claude 反复 rate limit 怎么办
agent / 脚本反复触发 rate limit——退避、合并请求、和会话清理。
Claude 工具 / Connector 显示 unavailable
之前能用的工具突然灰掉——通常是 Workspace 策略、计划档位或服务端故障。
Codex 审计报告范围太广：6 个原因 + 可执行的修复模板
Codex 给你回了 50 条 audit，从 typo 到架构混在一起——按维度收窄、限输出大小、强制 file:line。
Codex 没法把 patch 收干净：6 个截停原因 + 把「完成」写成合同
Codex 半路停手——import 缺失、类型只换了一半、call site 没改全。把「done」绑到 verifier 上，不要绑到 vibe 上。
Codex 不改原文件而是复制一份新的：6 个触发原因 + 防御规则
Codex 在 `utils.ts` 旁边新建 `utils.v2.ts` 而不就地改——用 AGENTS.md 规则 + git 兜底强制就地编辑。
Codex 没法跑或读懂 build 结果：6 个误读触发 + 让验证步骤短到能 parse
Codex 跳过 build、误读输出、相信被截断的 tail——用机器可读的 verifier + exit code，不要看 prose 总结。
Codex 修一个 bug 把附近改坏：6 个 collateral 来源 + 限定 blast radius
报的 bug 修好了，相邻两个功能挂了——限定改动范围、强制 caller 清单、优先在调用方加 guard 而不是改共享 util。
Codex 不照你的项目结构来：6 个原因 + AGENTS.md 模板
新文件落到 `/src/` 但你的 repo 用 `/app/`；monorepo 里依赖被加到根 `package.json`；测试用了你没装的框架——用 AGENTS.md + canonical example 指针修。
Codex 做了不安全的假设：6 个臆造来源 + 「先引述再写」规则
Codex 自信地用了不存在的列、错的环境变量、没读过的函数签名——强制 quote-before-write 接地。
Codex 漏项目特定约定：6 个原因 + 「规则 + canonical example」模板
Codex 用 `getUserById`，但你的项目用 `findUserById`——每条约定都要在 AGENTS.md 里配一个 canonical example 文件。
Codex patch 和现有代码冲突：6 个 state drift 来源 + 修复策略
「Patch hunk failed to apply」——Codex 读时和写时文件不一样。修 state drift，不要硬塞 patch。
Codex 的 code review 太浅：6 个模板化原因 + 让 review 真有用
「考虑下错误处理」「补一下测试」——任何 PR 都能套上的话——用 file:line 锚定的具体问题修。
Codex 生成的代码不合现有 style：6 个漂移来源 + canonical + lint 双层锁
代码能跑，但读起来像陌生人写的——async/await 混 .then()、import 顺序错、注释风格不对。指向 canonical 文件 + lint 强制。
Codex 测试建议太泛：6 个空话来源 + 锚到签名 + 类型 + bug 历史
「测一下 happy path 和 error path」——2026 年没用——把测试绑到函数的真实签名、真实类型、过去的真 bug 上。
Codex 生成代码不符合项目结构
Codex 把文件建错位置 / 风格不一致——用 AGENTS.md 和显式引用约束。
AdSense 的 Cookie 同意基础
EU / UK / 加州用户需要同意 UI——合规最低要求。
调自己的 API 报 CORS 错
浏览器 CORS 拒绝——服务端配置 / origin 不匹配。
Cursor "Apply" 静默失败
点 Apply 之后文件没变也没报错——通常是基准快照过期、文件在外部被改、或写入被锁住。
Cursor 无法应用修改怎么办：4 个原因 + 对症修复
Cursor 能看到 diff 但 Apply 没反应或静默失败。常见原因：Composer / Inline 模式不匹配；文件被别的进程或 git 锁了；Cursor 扩展过期。先做：保存所有打开的文件，关掉其他编辑器。
Cursor Composer 在大项目里晕头转向
小仓库 Composer 很好用，5 万文件 monorepo 里就丢线索——靠显式上下文，别赌索引。
Cursor Composer 大刀阔斧改错
Composer 一次改 10+ 文件、把能跑的代码改坏——这是 prompt 边界没设，加上 agent 默认权限太大。
Cursor 配置与 VS Code workspace 设置冲突
切到某个仓库后 Cursor 的格式化 / AI 行为变了——是仓库 .vscode/settings.json 覆盖了你的用户设置。
Cursor 上下文面板缺关键文件
打开上下文面板，期待的参考文件不在——是检索打分不够、被 ignore 排除、或文件新到还没索引。
Cursor 的 diff 太大没法 review
Composer 一次给你 30 文件 / 2000 行 diff，怎么 review 都不放心——拆 PR 是唯一正确动作。
Cursor 改完 build 挂了
Composer 说完成、改过的文件都过了 lint，但 npm build 失败——典型是签名漂移、import 不存在、codegen 没重跑。
Cursor 生成重复逻辑
AI 又写了一个 formatDate，但 src/utils 里早就有——已有 helper 在检索视野外，让它发现得了才能复用。
Cursor IDE 状态与磁盘不同步
AI 改完后编辑器还显示旧内容，或保存时提示「文件已被外部修改」——文件 watcher 和 AI 写入的竞态。
Cursor 索引一直跑不完
索引进度条转了几个小时没动——多半是仓库太大、ignore 配置错、symlink 环、或工作目录权限不足。
Cursor 没读到整个项目：3 个原因 + 修复路径
Cursor 只能改"看得见"的——调整索引范围 + 显式 @File 引用。
Cursor 聊天读错文件
你 @ 一个文件但 Cursor 答的是另一个同名文件的内容——文件名歧义、索引陈旧、symlink 迷惑。
Cursor 老是读错文件：3 个原因 + 修复路径
Cursor 把旧 / 生成 / vendored 文件拉进 context——靠索引和 ignore 修。
Cursor 建议不符合仓库约定
Tab 补全和 Composer 改的命名 / 格式 / 模式都和仓库不一样——训练 prior 压过了检索信号，需要显式锚定。
Cursor Tab 不再联想
打字时灰色补全消失——多半是 Tab 被关、登录过期、被 Copilot 抢键、或当前文件类型/大小不支持。
Cursor 终端命令行为不符预期
agent 跑 shell 命令后 confuse——通常是 working dir 不对、用错包管理器、env 没加载、或输出被截断。
自定义域名 SSL 一直在生成中：3 个原因 + 修复路径
域名绑了几小时 SSL 还没好——通常是 DNS 或 CAA。
部署成功但页面还是老内容：3 个原因 + 修复路径
Vercel/Netlify 仪表盘绿勾、commit hash 也对，访客刷新还是昨天那版——多半是 service worker 抢答、CDN 没失效或中间代理缓存。本文给一条 10 分钟诊断路径。
Google 改写了我的 meta description
SERP 里的描述不是你写的——通常是太泛、缺关键词、或全站重复。
修复 Search Console 报错：Discovered Currently Not Indexed（快速排查）
2026 最新：Search Console 这条状态到底什么意思，遇到时先查哪三件事、如何确认修好了。如果你要的是新站长期建权威的策略，看相关页。
改了 DNS 但站还打不开：4 个原因 + 对症修复
更新了 DNS 记录但站显示旧 IP 或加载失败。常见原因：改前 TTL 太高；OS / 路由器缓存旧 DNS；某些 resolver 还服务旧。先做：终端 `dig {域}` 绕过浏览器缓存。确认返回新值。
DNS 传播为什么不同地区看到不一样
改完 DNS 本机 dig 出新值、同事打不开、海外刷新忽新忽旧——这不是 bug 是设计。本文讲清楚 TTL 倒计时机制，并给一套提前降 TTL 把生效窗压到可控的修复路径。
"Duplicate, Google chose different canonical"
你设了 canonical，Google 却选了另一个 URL。
Edge function 超时：3 个原因 + 修复路径
Edge function 超过平台限制——重活别放 edge / 加超时 / 用 streaming。
生产环境变量缺失：3 个原因 + 修复路径
本地能跑、线上 500——env 没设或前缀不对（PUBLIC_/VITE_/NEXT_PUBLIC_）。
Firebase 部署 permission denied
firebase deploy 报权限错——IAM / 登录账号 / 项目对应。
Firebase Function not found
2026 最新：调用函数返回 not found——名字 / 区域 / 部署。
Firebase Hosting 部署失败
CLI 版本、配额、firebase.json 三件事最常见。
Firebase Hosting 路由 404 怎么办：SPA / SSG / 子路径 全场景修复
部署到 Firebase Hosting 后首页正常，但访问 `/about` 或子页面就 404？这是 firebase.json 的 rewrites 没配好。本文按 SPA、SSG、静态多页站、Astro / Next 各场景给出修复方案。
Firebase Hosting rewrite 不生效
2026 最新：SPA / 函数的 rewrite 没触发——顺序 / 同名静态文件 / 函数区域。
Gemini 在 Android 上没替换 Assistant
长按 home / 电源没出 Gemini——开关、应用版本、地区。
Gemini App 和 Web 显示不一致
同账号在 App 和 Web 看到的对话不一样——多半是账号 / Workspace / 设备配置原因。
Gemini Deep Research 结果太浅
深度调研输出空泛——scope、来源、引导式 prompt 三件事。
Gemini 文档总结太泛了怎么办
把 80 页财报丢给 Gemini 让它总结，返回 5 段空话——关键数字没提、风险跳过。本文教你怎么用抽取项加结构化输出 prompt，把高水位线总结变成可用纪要。
Gemini 导出 / 分享不可用
分享 / 导出菜单不见或链接 404——Workspace 策略 / 账号档位 / 源对话状态。
Gemini 文件上传失败 / 返回内容不对
上传成功但 Gemini"读不到"，或总结离谱——大小、类型、Drive 权限三件事。
Gemini Google 账号权限报错
"权限被拒绝"或"无法访问你的账户"——常见三种原因。
Gemini 图像生成不可用 / 拒绝
图像功能不可用或被拒——通常是地区 / 账号档位 / Safety filter 三件事。
Gemini 没响应怎么办——快速排查
Gemini 一直转圈或空白？账号、地区、网络、Workspace 策略四件事最常见。
Gemini 配额用尽 / 今日不可用
提示"稍后再试"或"功能不可用"——通常是配额 / 档位，不是平台挂了。
Gemini 在 Workspace (Gmail/Docs/Sheets) 不显示
2026 最新：Docs / Gmail 没有 Gemini 边栏？三层开关：域、License、应用。
Gemini 回复语言不对怎么办：3 个原因 + 修复路径
你用中文问，它用英文答（或反之）——界面语言和明确指定语言通常能修。
Git commit 后怎么找回旧版本
AI 重构覆盖文件、reset --hard 选错 commit、rebase 后旧 commit 看似消失——99% 没真丢。本文给三条找回路径：文件历史、reflog 找 HEAD、fsck 捞悬挂 commit。
Google 改写了我的标题——如何拿回（2026）
Google 在搜索结果里把你的 title 换成了更短 / 不同的。常见原因：title >60 字符；title 堆词 / 品牌；不匹配搜索意图。先做：在 Search Console 找受影响页（Pages → 按曝光过滤）。
Search Console hreflang 报错解读：International Targeting 错误指南
专门解读 Google Search Console 「International Targeting」报告里出现的 hreflang 错误：return tag 缺失、语言码无效，每一种该怎么处理。
hreflang 警告快速指南：return tag 缺失和语言码错
hreflang 警告到底什么意思、为什么会出现配对不闭环、return tag 和语言码错的最短修复路径。要看 Search Console International Targeting 报告里的错误，看相关页。
IAP 沙箱购买失败：7 个原因 + 完整排查清单
TestFlight 或沙箱测试时 IAP 失败。常见原因：用了真 Apple ID 而非沙箱；App Store Connect 协议 / 银行 / 税务未激活；IAP 产品不在 "Ready to Submit" 类状态。先做：iOS 设置 → App Store → 登出真 Apple ID（购买时会提示沙箱）。
新站收录很慢怎么办：3 个原因 + 修复路径
新域名提交 sitemap 一个月、Search Console 已发现 100 已编入只 3 ——这是 Google 对零历史信号的保守期，通常 8-16 周。本文讲这段时间能控制什么、不能控制什么。
审核 AI 生成的 diff 该按什么顺序看
AI 给的 200 行 diff，编译过 ≠ 安全。这是阅读顺序。
内链没被 Google 发现：3 个原因 + 修复路径
页面有 50 个内链，Search Console 链接报告显示 0——多半是 Googlebot 看不到：链接在 hydration 后才渲染、藏在折叠面板里或被 robots 拦。本文给三类原因和修复。
本地能跑、生产挂：3 个原因 + 修复路径
本地 npm run dev 全绿、部署到 Vercel 就 build fail 或功能全坏——根因永远是本地的隐式假设在生产不成立。本文从 env、runtime、文件系统、网络、build 五维做 diff。
长 Prompt 反而变差——怎么改 Prompt 结构
Prompt 写得很详细，回答却变得泛、跑题、或像在复述你的指令。
Prompt 很长但效果更差怎么办：为什么「越详细越烂」和 5 条修复路径
你以为 prompt 写得越长 AI 越懂，结果越长输出越糟？这是 LLM 的常见悖论。本文讲清楚为什么「长 prompt 反而效果差」，并给出 5 条修复路径。
内容深度不够影响收录：3 个原因 + 修复路径
Crawled - currently not indexed 多半是内容深度不够，Google 嫌的不是字数少，而是除主关键词外没独有信息。本文讲深度等于信息密度的含义和加密度方法。
Google 替换了我的 meta description
搜索结果显示 Google 生成的 snippet 而非你的 meta。常见原因：meta 太短（70 以下）或太长（160 以上）；meta 与 title 雷同；per-query 意图 snippet 更好服务。先做：用 Search Console 看哪些 query 命中页。
多 Agent 冲突：两个 agent 改了同一份文件——6 个 overlap 来源 + worktree 隔离
Claude Code + Codex（或两并行 session）改同一函数产冲突——用 worktree 隔离 scope，绝不让 agent 自己 resolve merge。
多个 AI agent 同时改文件冲突了
两个 agent（Cursor + Claude Code）同时改了同一个文件——干净合并的方法。
MX 记录被覆盖——邮件断了
DNS 改了什么之后邮件停止工作。常见原因：没先导出 MX 就迁 DNS；用了"set defaults"清空了 MX；提供商为他们自家邮件产品自动改 MX。先做：止血：找邮件提供商需要的 MX（Google Workspace / M365 / Zoho 都有文档）。
"Page not mobile friendly" 怎么修
Search Console 标了页面不适配移动端——viewport、tap target、内容截断。
分享时 OG 图不显示：4 个原因 + 对症修复
在 Twitter / LinkedIn / Slack 分享页面，预览图不出。
OG 图片在社交分享时不显示：3 个原因 + 修复路径
分享到 LinkedIn / X / Slack 没图——meta 标签 / 尺寸 / 缓存。
页面被索引但不排名：3 个原因 + 修复路径
Indexed 状态，0 曝光——通常是内容深度、意图匹配、主题权威三类问题。
页面被踢出索引怎么排查：3 个原因 + 修复路径
曾收录、有排名、带流量的页突然 URL is not on Google，且不是 noindex 也没 404——这是 Google 主动 deindex 了。本文给一套区分技术回归、质量降权、合并归并的排查路径。
Prompt 触发了拒答——怎么换个写法
写漏洞公告被拒、诊所 AI 拒答用药总结——合法工作触发安全模式匹配是常事。本文讲触发词机制，并给一套保留合法意图、压过表面模式的 prompt 重写法。
第三方 API 触发 rate limit
Stripe、Shopify、Twilio 等第三方 API 在流量上来时频繁 429——本文按命中率拆原因，给出指数退避、本地缓存、请求合并和并发限流四套修复模式，每条都附代码片段。
部署后重定向不生效：3 个原因 + 修复路径
vercel.json 或 _redirects 里配的 301 部署后没生效，多半是规则没进 build、被前面的 catch-all 拦截或 CDN 缓存旧响应。本文按命中率拆 5 类，并给 curl -I 验证步骤。
robots.txt 不生效：3 个原因 + 修复路径
改了 robots.txt 但 Google 还在爬同一批 URL。常见原因：CDN 缓存 robots.txt 几小时；静态和动态两份 robots.txt 同时存在，静态优先；Google 还没重新拉。先做：确认 robots.txt 只有一个来源。
RSS feed 返回 404：3 个原因 + 修复路径
/rss.xml 或 /feed.xml 404——通常是端点没生成、文件名不对或宿主拦截。
Search Console "未编入索引"——7 种状态对应修法
Search Console 未编入索引底下有 10+ 种具体状态，每种修法完全不同。本文是 7 种高频状态的对照表，每种给出判定方法、修复步骤和通常的见效时间。
sitemap.xml 找不到：3 个原因 + 修复路径
/sitemap.xml 或 /sitemap-index.xml 返回 404——通常是集成没启用或 `site` 没配。
Sitemap 提交了为什么不收录：6 种最容易忽视的原因
在 Search Console 提交了 sitemap，几周过去仍然 0 收录或只收录了几条？sitemap 提交≠收录。本文按概率排出 6 种最常见原因，给出对应的修复路径。
Soft 404——页面在 Google 眼里像空的
Search Console Soft 404 不是内容质量问题，而是工程问题：服务端该返回 404 却给了 200。本文从空 tag 页、空搜索结果、SPA 路由三个常见来源给出修复路径。
绑了自定义域名但 SSL 没发：4 个原因 + 对症修复
Vercel / Firebase / Netlify 绑域后 SSL 一直 pending。常见原因：DNS 未完全传播；CAA 记录挡 Let's Encrypt；前置 CDN / 代理（Cloudflare 橙云）截 challenge。先做：用 dig + dnschecker 验 DNS。
静态资源 404：3 个原因 + 修复路径
/images/foo.png 404——路径 / base / 上传步骤。
静态站打开是白屏：3 个原因 + 修复路径
线上站打开 title 闪一下就剩白屏、HTML 在但 DOM 空——多半是 JS 抛错被吞、资源路径错或 CSP 拦了脚本。本文给一套 10 分钟定位根因的检查顺序。
对象存储上传被拒：3 个原因 + 修复路径
S3 / Firebase Storage / Supabase Storage 上传 403——IAM / 签名 URL / bucket 策略。
Rich Results Test 结构化数据警告
Rich Results Test 显示你的 JSON-LD 有警告 / 字段无效。
Search Console 报结构化数据警告
JSON-LD 警告——缺必填字段 / 类型不对 / 日期格式错。
子域名不解析——blog.example.com 打不开
配了子域名但不解析到你的站。常见原因：子域名没 CNAME / A；CNAME 指向不接受此子域名的主机；通配符 / catch-all 没设。先做：验 DNS：`dig blog.example.com` 返回预期目标。
Suno Extend 接得不自然
Extend 出来的衔接调不对 / 节奏跑——切点和 style 要对齐。
Suno 编曲和情绪不搭：3 个原因 + 修复路径
伤感歌词配欢快编曲——style 和 tempo 要和情绪一致。
Suno 没用我写的歌词：3 个原因 + 修复路径
你写了歌词 Suno 自由发挥——加结构标签 + lyric mode。
Suno 结尾不自然：3 个原因 + 修复路径
Suno 生成的歌结尾要么"啪"停在乐句中间、要么 3 秒粗暴 fade——它默认按时长生成，没有收尾意识。本文用 [Outro] 标签加 ritardando、tail reverb 指令做出干净结尾。
Suno 歌曲太短怎么办：把 1 分钟 demo 变成完整 3 分钟单曲的方法
Suno 每首默认只生成 1-2 分钟，听完总觉得不够？这其实有标准的「扩段」工作流：Extend、Bridge、Outro、合并、剪辑。本文给出完整步骤与配套 Prompt。
Suno 歌曲结构弱：3 个原因 + 修复路径
Suno 出的歌 3 分钟全在一个能量上——副歌没爆发、主歌没铺垫，这是结构标签缺失。本文教你用 [Pre-Chorus]、[Build]、[Drop] 加 style 动态描述做出层次。
Suno 风格描述词被忽略：3 个原因 + 修复路径
写"synthwave, retro, 80s synth"出来钢琴抒情——为什么。
Suno 歌曲太重复：3 个原因 + 修复路径
同一个 hook 唱 8 遍——歌词、旋律、结构都要有变化。
Suno 唱中文发音不对：3 个原因 + 修复路径
中文 / 中英混合歌词被念错——有几个 workaround。
Suno 人声机械感：3 个原因 + 修复路径
Suno 人声塑料感、辅音清脆得像 TTS——是 style 触发了合成人声分支。本文教你清除 vocoder 暗示词、调整歌词节奏接近真人换气，让人声回归自然。
Suno 输出风格不对：3 个原因 + 修复路径
Suno style 写了 lo-fi hip-hop 出来却是 pop——多半是流派词夹了 pop 暗示乐器、描述太泛或主流派词权重不够。本文教你把流派锁死的 style 排序模板。
Supabase 环境变量在生产缺失
URL / anon key undefined——宿主 env / 前缀 / 缓存。
Supabase RLS 把数据拦了
Supabase 表有 100 条数据，前端查询返回空数组也不报错——这是 RLS 默认 enabled + 无 policy = deny all 的静默拦截。本文按命中率给四类原因和 policy 模板。
TestFlight build 卡在 "Processing"：6 个原因 + 解卡清单
上传到 TestFlight 的 build 几小时一直 Processing。常见原因：Apple 侧延迟（最常见，等就行）；build 有问题（缺权限、签名错）；需要设 ITSAppUsesNonExemptEncryption。先做：先等 1-2 小时——多数最终会完成。
为什么 Google 改写我的标题
Google 用 H1 / 站名替了你的 title——长度、塞词、相关性、缺 H1 都会触发。
trailing slash 不一致导致多次重定向
/foo → /foo/ → /foo 这种链——挑一种用，并保持一致。
"URL is unknown to Google" 是什么意思
Search Console 说 URL 未知——它存在，但 Google 没见过。
Vercel 500 错误常见原因
Build 过了线上 500——多半是 Serverless function、env vars 或 Edge runtime 问题。
Vercel 卡在 Building
Build 不结束——OOM、依赖死锁、构建超时三种典型成因。
Webhook 收不到：3 个原因 + 修复路径
提供方说发了，你的端点没收到——通常是端点访问性 / URL / 状态码。
什么时候申请 AdSense——准备清单
判断网站是否适合申请 AdSense：内容厚度、隐私页面、导航完整度、收录状态和广告布局，申请前先跑完这份清单。
www 与根域名不一致（都该通）：3 个原因 + 修复路径
www.example.com 通但 example.com 不通（或反）。常见原因：（根的 A 和 www 的 CNAME）只配了一个；主机平台期望特定配置；两者间无重定向规则。先做：选 canonical：根 or www。定一个。
AI 图片人物脸崩怎么办：镜头距离 / 分辨率 / 面部修复三步法
AI 生成的人脸经常脸崩、眼斜、鼻歪？多半不是 Prompt 问题。这篇按概率给出 3 步修复法：调镜头距离、加分辨率、走面部修复 pass。
ChatGPT 打不开怎么办：五步排查路径（含地区 / 网络 / DNS）
ChatGPT 打开空白、转圈或直接报错？按这条五步路径排查：地区限制、代理 / DNS、浏览器、Cloudflare 验证、ChatGPT 自身状态。
ChatGPT 登录失败怎么办：邮箱 / Google / suspicious activity 三类
ChatGPT 登录失败按报错分三类排查：邮箱验证未通过、Google SSO 跳转失败、显示 suspicious activity。每类给出最短修复路径。
Claude usage limit 到了怎么办：额度计算、重置时间与省额度技巧
Claude 提示 usage limit reached？这篇讲清楚：Claude 的额度怎么计算、什么时候重置、用 Artifact / 文件如何更耗额度，以及 6 个最有效的省额度方法。
Crawled - currently not indexed 怎么办：Google 看过但不收的 5 个原因
Search Console 显示 'Crawled — currently not indexed'？Google 看了但选择不收。这篇按可能性顺序排查 5 个原因：内容质量、内部链接、新域名沙盒、相似度、规范化。
Cursor 一直 indexing 怎么办：让它跳过 node_modules 与构建产物
Cursor 卡在 indexing 不动？多半是 node_modules、build / dist、缓存目录被索引了。这篇给出 .cursorignore 模板与重建索引的步骤。
noindex 和 robots.txt 有什么区别：什么时候用哪个
noindex 阻止收录，robots.txt 阻止抓取——两者完全不同。这篇用一张对比表说清楚什么时候用哪个，以及最常见的混用坑。
Suno 副歌不抓耳怎么办：重写前 4 小节的三个杠杆
Suno 出的歌主歌还行，副歌就是不洗脑？问题永远在前 4 小节。这篇讲三个最有效的杠杆：调式、节奏密度、旋律落点。
Vercel build failed 怎么解决：读 log 的三个关键位置
Vercel 部署失败时不要慌——build log 里有三个关键位置告诉你真正的报错。这篇给出排查清单与最常见的 5 类失败。
网站上线后为什么 Google 搜不到？十个最常见的原因
你的网站发布一周还是搜不到？逐个排查这十种最常见的原因：robots、noindex、重复内容、canonical 错误、JS 阻挡、新域名沙盒、内容质量低等。