town agent start

用法

town agent start [path]
town agent start [path] --foreground
town agent start [path] --host 0.0.0.0

默认行为

不带 --foreground 时，命令会以 daemon 方式在后台启动 agent。

在当前实现中，后台模式并不是“另起一套不同逻辑”，而是通过 daemon 方式去拉起真正的前台运行入口。

目标项目如何决定

启动目标按这个顺序决定：

1. 如果显式传了 path，优先使用它
2. 如果当前目录本身已经是已初始化 agent 项目，直接用当前目录
3. 如果当前目录不是 agent 项目，但终端是交互式环境，则从已登记 agent 中让你选择

这条规则的好处是：

• 脚本调用时行为可预测
• 人工调用时又不至于必须每次都记完整路径

--foreground

town agent start --foreground

适合：

• 调试启动过程
• 临时在当前终端观察日志

不适合：

• 长期后台运行

也不适合把它当成常规生产模式。它更像一个观察和排障工具。

启动前依赖什么

• 项目已初始化
• downcity.json.execution.modelId 合法
• Town 已连接 City
• 绑定的模型在 City AIService 中可解析

如果这些条件不满足，启动通常不会成功。

在这种情况下，与其反复执行 start，不如优先去看：

• town agent status
• Agent 无法启动

相关文档

• 启动和停止 Agent
• Agent 无法启动