入门

故障排查

大多数失败都会说明原因。本页把你可能看到的提示，对应到发生了什么、下一步怎么做。

先确认版本

vibe-trading --version
pip install -U vibe-trading-ai

下面好几个问题在 0.1.16 已经修复，先升级再往下查。

失败 · no_progress

如果连续八轮工具调用都没有拿到新的有效结果，智能体就会停下。这是防止原地打转的预算，不是程序崩溃。从 0.1.16 起，停止提示会列出每个没有产出的调用、原因和次数。常见原因：

  • 数据源宕机或被限流。稍后重试，或在提问里指定别的数据源（"用 Yahoo"）。
  • 模型反复猜文件路径。0.1.16 已修复：read_file 现在会说明可读的目录，并能列出目录内容。
  • 长对比任务忘了已经取过的数据，又重新去取。0.1.16 已修复：上下文压缩按模型的真实上下文窗口计算。

同一个失败的调用从第二次失败起会被拒绝执行。换个说法提问，或者开一次新的运行，就会重置。

失败的运行显示 0 个步骤

0.1.16 之前，只有成功完成的运行才保存工具轨迹，所以失败或取消的运行在历史里显示"0 个步骤"。从 0.1.16 起，每次运行都会保留步骤。

答案里出现（略※）

有数字无法和本次会话取到的数据对上，被从答案里删去了，※ 脚注会说明删了几处。先让智能体取数据或跑回测，再问一次。规则见 数字核验。

上下文长度报错

从 0.1.16 起，服务商返回上下文超长错误时，会先压缩再重试，并在本次运行余下的部分沿用报错里给出的上限。如果你用的模型不在内置目录里，请把 VIBE_TRADING_CONTEXT_WINDOW 设为它的真实窗口。TOKEN_THRESHOLD 这一行请删掉，它已不再生效。

美股代码报错

美股代码要带 .US 后缀：写 AAPL.US，不要写 AAPL。报错会直接提示：US equity symbols must include the .US suffix。其他市场各有后缀，见 数据源。

No frontend build found

你是从 PyPI 安装的，PyPI 包只带 API，不带构建好的 Web 界面。请用 Docker，或在源码目录里执行 vibe-trading setup，步骤见 快速开始。

其他设备访问返回 403

没有设置 API_AUTH_KEY 时，敏感接口只响应本机请求。设置这个 key，并在另一台设备的设置页里填入它。

Codex 拒绝所选模型

用 ChatGPT 账号登录时，ChatGPT 账户无法使用 gpt-5.4。0.1.16 默认改为 gpt-6-sol；如果你的 .env 里写的是旧模型，请修改 LANGCHAIN_MODEL_NAME。

反馈问题

在 GitHub 提 issue，附上版本号、服务商和模型、以及停止提示。vibe-trading --trace RUN_ID 可以回放这次运行做了什么。不要贴 API key 或券商凭据。