故障排查

先收集证据，再改动部署。

确切的服务名、端口、日志路径、运行时命令和修复步骤都取决于具体版本。本指南提供安全的分诊顺序和上报材料；纠正性命令请使用当前官方文档。

安装指南官方文档 ↗

在尝试修复之前先保留失败现场。

在没有备份和回滚方案的情况下，不要删除数据、重置凭据、重跑远程安装脚本或同时改动多个变量。

01 记录范围与时间：受影响用户、项目、任务、主机、首次发生时间、最后正常状态和近期变更。
02 记录版本与拓扑：MonkeyCode 版本与提交、部署方式、操作系统、主机角色、资源、端点，以及不含密钥的配置变更。
03 保留证据：收集相关错误、时间戳、请求 ID、资源指标、磁盘状态、网络结果和已脱敏日志。
04 隔离单个边界：分别测试控制台、环境主机、Git、模型、软件包访问、DNS/TLS 和存储。
05 使用获批的恢复方式：遵循当前文档，只做一处可回退的改动，验证结果并记录。

把事件分配到正确的边界。

这些检查用于判定类别，不是未经文档记录的产品修复命令。

安装器或控制台不可用：重新确认当前官方命令、DNS/TLS、主机资源、磁盘空间、安装器来源、系统时间和已文档化的前置条件。
开发环境无法启动：检查独立的开发主机、容量、存储、网络路径、近期变更的镜像与软件包，以及并发需求。
仓库访问失败：核实 URL、凭据范围、有效期、吊销状态、分支权限、DNS/TLS 和提供商可用性。
模型请求失败：核实确切的模型 ID、端点、凭据、配额、地区、网络路径、超时和提供商状态。
构建或预览失败：在环境中复现命令；检查依赖、端口、磁盘、内存、产物和应用日志。
升级或恢复失败：停止破坏性改动，保留状态，比对受支持的版本，单独测试恢复，并带证据上报。

让 issue 可复现且便于安全共享。

绝不要公开令牌、源码、内部 URL、客户数据、提示词或未脱敏的日志。

摘要：期望结果、实际结果、影响、时间戳与可复现性。
环境：版本、部署模式、操作系统、主机角色与资源、网络形态。
步骤：使用非敏感数据的最简编号复现步骤。
证据：已脱敏的错误、日志、截图、指标与请求 ID。
已尝试的改动：每次只改一处，记录结果与回滚状态。

公开 issue 证据

近期报告说明应该去哪里收集更好的诊断信息。

这些是个别 GitHub 用户报告，不是普遍性数据、已确认的根因、支持承诺，也不能证明所有部署都受影响。问题状态可能在核验日期之后变化。

模型请求: issue #870

有用户报告反复出现模型调用失败，并希望获得更清晰的上下文长度或资源说明。

查看该报告 (开放中) →

环境启动: issue #872

有用户报告自定义镜像反复拉取缓慢，并偶发拉取失败。

查看该报告 (开放中) →

任务恢复: issue #828

有用户报告在若干 API 失败后，任务界面一直停留在执行中状态，并反复出现上下文压缩失败。

查看该报告 (开放中) →

仓库身份: issue #819

有用户报告在国际版托管服务上绑定 GitHub 网站身份时出现 404。

查看该报告 (开放中) →

预览: issue #842

有用户报告 PHP 网站预览不稳定。

查看该报告 (开放中) →

不要照搬 issue 中具有破坏性或需要特权的绕过做法，除非已核实受影响版本、备份、访问授权和当前维护者建议。在对比症状前，先收集你自己的、已脱敏的证据。

公开的 issue 报告

用已脱敏、可复现的报告安全上报。

Issue #870 ↗Issue #872 ↗Issue #828 ↗Issue #819 ↗Issue #842 ↗

容量合理性检查

确认两项已公布的基础设施下限。

满足这些下限并不证明生产容量足够。

组件	CPU	内存	存储
MonkeyCode 控制台	2 cores	4 GB	40 GB
开发环境主机	8 cores	16 GB	100 GB

由 MonkeyCode 项目公布；核验于 2026-08-05。请为并发、构建、镜像缓存、仓库、日志和留存产物预留余量。

常见问题

常见问题解答

MonkeyCode 装不上或控制台不可用，应该检查什么？

重新确认当前官方安装命令、DNS 与 TLS、主机资源、磁盘空间、安装器来源、系统时间和已文档化的前置条件。每次只做一处可回退的改动，纠正性命令请遵循当前文档。

开发环境启动不了，该从哪里查？

检查独立的开发环境主机：容量、存储、网络路径、近期变更的镜像或软件包，以及并发需求。控制台和开发主机是不同角色，失败原因也不同。

模型请求失败，怎么诊断？

核实确切的模型标识、端点、凭据、配额、地区、网络路径、超时和提供商状态。有公开 issue 报告过原因不明的模型调用失败，因此在改动配置前先保存请求 ID 和提供商响应。

仓库访问或 Git 绑定失败，原因是什么？

核实仓库 URL、凭据范围、有效期与吊销状态、分支权限、DNS/TLS 和提供商可用性。有公开 issue 报告在国际版托管服务上绑定 GitHub 身份时出现 404，因此要验证你实际使用的提供商与托管组合。

如何安全地报告 MonkeyCode 问题？

提供已脱敏、可复现的报告：摘要、环境、最简步骤、证据和已尝试的改动。绝不要公开令牌、源码、内部 URL、客户数据、提示词或未脱敏的日志。

证据说明

Issue 是症状证据，不是普遍性数据或官方修复保证。修复命令必须以当前版本文档和维护者指导为准。

MONKEYCODE

先收集证据，再改动部署。

MONKEYCODE 简体中文产品概览私有化部署安全与隐私安装与上线模型说明