AgentCLIMaintenance

Daemon 状态说明

理解 Agent daemon 的 pid、meta、stale 和恢复方式

Daemon 状态说明

Agent 后台运行时,会有一组 daemon 状态文件。

这些状态文件用于告诉 CLI:

  • 目标 agent 是否在运行
  • 进程 pid 是什么
  • 最近一次启动的元信息是什么

为什么会出现 stale

stale 通常说明:

  • 状态文件还在
  • 但对应进程已经不存在

常见原因:

  • 进程被异常杀死
  • 机器重启
  • 启动过程未完整清理旧状态

这类问题往往不是“配置坏了”,而是“状态脏了”。

你应该怎么处理

标准处理顺序:

town agent status
town agent doctor --fix
town agent start

这个顺序之所以推荐,是因为它先恢复状态一致性,再恢复实际运行。

什么情况下不需要手工处理

如果状态是 runningstopped,一般不需要手动动 daemon 状态文件。

如果你只是怀疑 agent 行为不对,但 status 很健康,那更应该去检查模型、提示词、渠道或 session,而不是盯着 daemon 状态文件。

相关文档