合并受阻
childish
变更摘要
此 PR 在中英文 FAQ 文档中各新增一条排查条目，针对 CodingPlan 长任务中途偶发 401/403/空响应/connection closed 导致回合中断的问题，提供从额度检查到日志诊断的完整排查路径。
主要改动
- 新增「长任务中途偶发报错 / 回合中断」FAQ 条目：在
site/docs/zh/faq.html和site/docs/en/faq.html中分别添加<h3>标题和对应的排查列表，涵盖四种常见异常（401、403、空响应、connection closed）。 - 额度检查排查步骤：引导用户使用
/status查看 CodingPlan 用量与 5 小时滚动窗口重置时间，或使用/usage查询计划配额，确认是否触发限流。 - 重新同步与会话恢复步骤：建议执行
/login幂等刷新模型列表与 token，以及偶发断连时直接重试或通过/resume恢复上一次会话。
- **日志诊断步骤**：指导用户在问题持续复现时查看 `~/.atomcode/logs/`，并以 `--log-level debug` 启动以打印请求/响应详情，便于区分限流、网络或网关问题。
变更摘要
此 PR 主要针对 CodingPlan 间歇性失败的用户反馈（如 401、403、空响应、connection closed 等），在 FAQ 文档（中英文）中新增了一条排查条目，引导用户按额度检查 → 重新同步 → 重试/恢复 → 日志定位的顺序进行自助排查。
主要改动
- 中文 FAQ 新增排查条目：在
site/docs/zh/faq.html中新增<h3>长任务中途偶发报错 / 回合中断（401、403、空响应、connection closed）</h3>章节，包含/status查额度、/login刷新 token、/resume恢复会话、--log-level debug定位日志四步排查指引。 - 英文 FAQ 新增对应条目：在
site/docs/en/faq.html中新增对应的英文版本<h3>Intermittent errors / interrupted turns in long tasks (401, 403, empty responses, connection closed)</h3>，内容与中文版一致。 - 搜索索引同步更新：
site/docs/search-index.zh.json和site/docs/search-index.en.json各有一处微调（+1 -1），以便新条目能被站点搜索覆盖。
各位维护者好，冒眻提醒评审此 PR。AI 代码审查已通过（无阻塞问题），恳请抽空合入。谢谢！
Friendly reminder to the maintainers to review this PR. The AI code review has passed (no blocking issues). Appreciate your time to merge it. Thank you!
变更摘要
本 PR 为文档改动，针对 CodingPlan 间歇性失败（AtomGit gateway 偶发 connection closed 致回合中断、CodingPlan 调用 llm-api 间歇 401/403/空响应）在 FAQ 中补充排查条目。改动在 site/docs/zh/faq.html 与 site/docs/en/faq.html 的中英文 FAQ 中新增「长任务中途偶发报错 / 回合中断」小节，并同步更新 site/docs/search-index.zh.json 与 site/docs/search-index.en.json 的搜索索引条目，形成「先查额度、再重新同步、偶发重试或恢复会话、最后看日志」的四步排查路径。
主要改动
- 中英文 FAQ 新增排查小节: 在
site/docs/zh/faq.html与site/docs/en/faq.html中新增<h3>标题「长任务中途偶发报错 / 回合中断（401、403、空响应、connection closed）」及对应列表项。 - 明确额度与限流确认方式: 条目首步引导用户运行
/status查看 CodingPlan 用量与重置时间（额度按 5 小时滚动窗口计量），或用/usage查询计划配额以确认是否触发限流。 - 补充重新同步与恢复会话手段: 说明执行
/login可幂等刷新模型列表与token，偶发断连可直接重试或用/resume恢复上一次会话继续。 - 补充日志排查指引: 提示仍复现时查看
~/.atomcode/logs/，启动加--log-level debug打印请求/响应详情，以区分限流、网络或网关侧问题。 - 同步搜索索引: 在
site/docs/search-index.zh.json与site/docs/search-index.en.json中新增对应的id、heading、body索引条目，使新增 FAQ 内容可被搜索命中。
改动内容
在 FAQ(中英文)新增「长任务中途偶发报错 / 回合中断(401、403、空响应、connection closed)」条目,补充排查步骤:
/status查看 CodingPlan 用量与重置时间(额度按 5 小时滚动窗口计量),或/usage查询计划配额,确认是否限流;/login幂等刷新模型列表与 token;/resume恢复会话;~/.atomcode/logs/,启动加--log-level debug定位限流/网络/网关问题。背景
针对用户反馈的 CodingPlan 间歇性失败(#1334: AtomGit gateway 偶发 connection closed 致回合中断; #1300: CodingPlan 调用 llm-api 间歇 401/403/空响应),在 FAQ 中补充文档化的排查路径。
改动文件
site/docs/zh/faq.htmlsite/docs/en/faq.html