已开启
docs(faq): 补充 CodingPlan 偶发 401/403/断连致回合中断的排查条目 #944
childish创建于 8月8日
docs(faq): 补充 CodingPlan 偶发 401/403/断连致回合中断的排查条目 #944
已开启
共 4 个文件变更+26-0
| @@ -108,6 +108,14 @@ | |||
| 108 | <li>If you're in mainland China hitting an overseas model, verify your egress network. You can run <code>/model</code> to switch to AtomGit's official channel first to prove the whole pipeline works.</li> | 108 | <li>If you're in mainland China hitting an overseas model, verify your egress network. You can run <code>/model</code> to switch to AtomGit's official channel first to prove the whole pipeline works.</li> |
| 109 | </ul> | 109 | </ul> |
| 110 | 110 | ||
| 111 | + <h3>Intermittent errors / interrupted turns in long tasks (401, 403, empty responses, connection closed)</h3> | ||
| 112 | + <ul> | ||
| 113 | + <li>Check your quota first: run <code>/status</code> to see CodingPlan usage and reset time (quota is measured on a rolling 5-hour window), or <code>/usage</code> to query your plan quota and see whether you're being rate-limited;</li> | ||
| 114 | + <li>Re-sync: run <code>/login</code> to idempotently refresh the model list and token — this usually restores subsequent calls;</li> | ||
| 115 | + <li>For one-off disconnects, just retry, or use <code>/resume</code> to pick up the last session;</li> | ||
| 116 | + <li>If it keeps happening, check the logs: <code>~/.atomcode/logs/</code> — launch with <code>--log-level debug</code> to print request/response details and tell rate limiting, network, or gateway issues apart.</li> | ||
| 117 | + </ul> | ||
| 118 | + | ||
| 111 | <h3 id="how-do-i-switch-models">How do I switch models?</h3> | 119 | <h3 id="how-do-i-switch-models">How do I switch models?</h3> |
| 112 | <p>Type <code>/model</code> and pick from the menu. The command switches the current session and saves the choice as the default for sessions opened later; other already-open sessions keep their current model. See <a href="./configuration.html">Configuration</a>.</p> | 120 | <p>Type <code>/model</code> and pick from the menu. The command switches the current session and saves the choice as the default for sessions opened later; other already-open sessions keep their current model. See <a href="./configuration.html">Configuration</a>.</p> |
| 113 | 121 | ||
| @@ -1402,6 +1402,11 @@ | |||
| 1402 | "heading": "Can't reach the model / hangs forever / timeouts", | 1402 | "heading": "Can't reach the model / hangs forever / timeouts", |
| 1403 | "body": "First check that base_url in ~/.atomcode/config.toml is reachable — curl the matching /v1/models endpoint; On corporate networks it's usually a proxy issue — set HTTPS_PROXY and retry; On Windows, v5.0.7 uses the system SChannel certificate store by default, including enterprise roots. If it still fails, check the system certificate, proxy, and overrides such as SSL_CERT_FILE separately; If you're in mainland China hitting an overseas model, verify your egress network. You can run /model to switch to AtomGit's official channel first to prove the whole pipeline works." | 1403 | "body": "First check that base_url in ~/.atomcode/config.toml is reachable — curl the matching /v1/models endpoint; On corporate networks it's usually a proxy issue — set HTTPS_PROXY and retry; On Windows, v5.0.7 uses the system SChannel certificate store by default, including enterprise roots. If it still fails, check the system certificate, proxy, and overrides such as SSL_CERT_FILE separately; If you're in mainland China hitting an overseas model, verify your egress network. You can run /model to switch to AtomGit's official channel first to prove the whole pipeline works." |
| 1404 | }, | 1404 | }, |
| 1405 | + { | ||
| 1406 | + "id": "intermittent-errors-interrupted-turns-in-long-tasks-401-403-", | ||
| 1407 | + "heading": "Intermittent errors / interrupted turns in long tasks (401, 403, empty responses, connection closed)", | ||
| 1408 | + "body": "Check your quota first: run /status to see CodingPlan usage and reset time (quota is measured on a rolling 5-hour window), or /usage to query your plan quota and see whether you're being rate-limited; Re-sync: run /login to idempotently refresh the model list and token — this usually restores subsequent calls; For one-off disconnects, just retry, or use /resume to pick up the last session; If it keeps happening, check the logs: ~/.atomcode/logs/ — launch with --log-level debug to print request/response details and tell rate limiting, network, or gateway issues apart." | ||
| 1409 | + }, | ||
| 1405 | { | 1410 | { |
| 1406 | "id": "how-do-i-switch-models", | 1411 | "id": "how-do-i-switch-models", |
| 1407 | "heading": "How do I switch models?", | 1412 | "heading": "How do I switch models?", |
| @@ -1402,6 +1402,11 @@ | |||
| 1402 | "heading": "连不上模型 / 一直转圈 / 报 timeout", | 1402 | "heading": "连不上模型 / 一直转圈 / 报 timeout", |
| 1403 | "body": "先确认 ~/.atomcode/config.toml 里的 base_url 是否可达， curl 一下对应的 /v1/models 接口； 企业网络里常见是代理问题，设置 HTTPS_PROXY 环境变量后重试； Windows v5.0.7 默认使用系统 SChannel 证书库，可识别企业安装的根证书；若仍失败，请分别检查系统证书、代理和 SSL_CERT_FILE 等覆盖变量。 国内访问境外模型需要确认出口网络；可以先用 /model 切换到 AtomGit 官方通道确认整体链路是通的。" | 1403 | "body": "先确认 ~/.atomcode/config.toml 里的 base_url 是否可达， curl 一下对应的 /v1/models 接口； 企业网络里常见是代理问题，设置 HTTPS_PROXY 环境变量后重试； Windows v5.0.7 默认使用系统 SChannel 证书库，可识别企业安装的根证书；若仍失败，请分别检查系统证书、代理和 SSL_CERT_FILE 等覆盖变量。 国内访问境外模型需要确认出口网络；可以先用 /model 切换到 AtomGit 官方通道确认整体链路是通的。" |
| 1404 | }, | 1404 | }, |
| 1405 | + { | ||
| 1406 | + "id": "长任务中途偶发报错-回合中断401403空响应connection-closed", | ||
| 1407 | + "heading": "长任务中途偶发报错 / 回合中断（401、403、空响应、connection closed）", | ||
| 1408 | + "body": "先看额度：运行 /status 查看 CodingPlan 用量与重置时间（额度按 5 小时滚动窗口计量），或 /usage 查询计划配额，确认是否触发限流； 重新同步：执行 /login 幂等地刷新模型列表与 token，通常能恢复后续调用； 偶发断连可直接重试，或用 /resume 恢复上一次会话继续； 仍复现再看日志： ~/.atomcode/logs/ ，启动时加 --log-level debug 打印请求/响应详情，方便定位是限流、网络还是网关侧问题。" | ||
| 1409 | + }, | ||
| 1405 | { | 1410 | { |
| 1406 | "id": "怎么切换模型", | 1411 | "id": "怎么切换模型", |
| 1407 | "heading": "怎么切换模型？", | 1412 | "heading": "怎么切换模型？", |
| @@ -108,6 +108,14 @@ | |||
| 108 | <li>国内访问境外模型需要确认出口网络；可以先用 <code>/model</code> 切换到 AtomGit 官方通道确认整体链路是通的。</li> | 108 | <li>国内访问境外模型需要确认出口网络；可以先用 <code>/model</code> 切换到 AtomGit 官方通道确认整体链路是通的。</li> |
| 109 | </ul> | 109 | </ul> |
| 110 | 110 | ||
| 111 | + <h3>长任务中途偶发报错 / 回合中断（401、403、空响应、connection closed）</h3> | ||
| 112 | + <ul> | ||
| 113 | + <li>先看额度：运行 <code>/status</code> 查看 CodingPlan 用量与重置时间（额度按 5 小时滚动窗口计量），或 <code>/usage</code> 查询计划配额，确认是否触发限流；</li> | ||
| 114 | + <li>重新同步：执行 <code>/login</code> 幂等地刷新模型列表与 token，通常能恢复后续调用；</li> | ||
| 115 | + <li>偶发断连可直接重试，或用 <code>/resume</code> 恢复上一次会话继续；</li> | ||
| 116 | + <li>仍复现再看日志：<code>~/.atomcode/logs/</code>，启动时加 <code>--log-level debug</code> 打印请求/响应详情，方便定位是限流、网络还是网关侧问题。</li> | ||
| 117 | + </ul> | ||
| 118 | + | ||
| 111 | <h3 id="怎么切换模型">怎么切换模型？</h3> | 119 | <h3 id="怎么切换模型">怎么切换模型？</h3> |
| 112 | <p>直接输入 <code>/model</code> 并从菜单选择。命令会切换当前会话，并把所选项保存为后续新会话的默认值；其他已经打开的会话保持原模型。详见 <a href="./configuration.html">配置文件</a>。</p> | 120 | <p>直接输入 <code>/model</code> 并从菜单选择。命令会切换当前会话，并把所选项保存为后续新会话的默认值；其他已经打开的会话保持原模型。详见 <a href="./configuration.html">配置文件</a>。</p> |
| 113 | 121 | ||