检查项目

在生成项目目录里,用已安装的 CLI 运行就绪检查。 如果期望检查通过,先准备 .env 并运行 agentseek task frontend

agentseek doctor
输出片段
ok   lifecycle.toml: Lifecycle spec is present.
ok   uv: uv is available.
ok   node: node is available.
ok   npm: npm is available.
ok   frontend/package.json: frontend/package.json is present.
ok   frontend/node_modules: frontend/node_modules is present.
ok   .env: .env is present.
ok   BUB_MODEL: BUB_MODEL is configured.
ok   BUB_API_KEY: BUB_API_KEY or BUB_OPENAI_API_KEY is configured.
ok   gateway cwd: . is present.
ok   frontend cwd: frontend is present.

这些检查来自必需工具、路径和环境变量声明。

.agentseek/lifecycle.toml 片段
[tools]
required = ["uv", "node", "npm"]

[paths]
required = ["frontend/package.json", "frontend/node_modules"]

[env.BUB_API_KEY]
required = true
aliases = ["BUB_OPENAI_API_KEY"]

在自动化里使用 strict 模式,让警告也导致检查失败。

agentseek doctor --strict

应用启动后使用 live 模式。它检查本地服务是否正在监听。

agentseek doctor --live
输出片段
ok   gateway: http://127.0.0.1:8088/agent/health is reachable.
ok   copilotkit: http://127.0.0.1:4000/health is reachable.
ok   frontend: http://127.0.0.1:5173 is reachable.

Live 检查使用项目声明的服务健康检查目标。

.agentseek/lifecycle.toml 片段
[checks.gateway]
type = "http"
target = "http://127.0.0.1:8088/agent/health"
timeout = 2
attempts = 3

下一步