元数据
| id | herdr-1 | 收录 | 2026-09-19 |
|---|---|---|---|
| 问题域 | 编码代理与终端 | 主题分组 | Agent 工具·运行与配置 |
| 适用工具 | herdr | ||
症状
输入 `herdr server start` 不启动 server,只打印 server 子命令列表(help 文本);`herdr status` 显示 `server: not running`;`~/.config/herdr/` 下没有 `herdr.sock`。
原因
v0.8.2 命令面里**不存在 `server start` 子命令**。正确启动面有两个:
- `herdr`(TUI 完整客户端)——正常使用路径,自动拉起后台 server;
- `herdr server`(headless)——前台运行 server,脚本化时用 `nohup herdr server &` 放后台;
- 停止面 = `herdr server stop`(经 API socket);确认面 = `herdr status`(server: running / not running)。
解法
1. 交互使用:直接 `herdr` 开 TUI(server 自动拉起),无需显式 start。
2. 脚本化:`nohup herdr server > /tmp/herdr-server.log 2>&1 &`,然后 `herdr status` 确认 running。
3. 停止:`herdr server stop`;再次 `herdr status` 确认 not running。
4. 写面确认:`~/.config/herdr/` 下应出现 `.plugins.lock`、`herdr-client.sock`、`herdr.sock`、`herdr-server.log`。
验证证据
本站实测记录(2026-08-29)
- 2026-08-28:`herdr` 完整客户端启动 12s 验证创建 `~/.config/herdr/`(.plugins.lock、herdr-client.log、herdr-server.log、session.json)+ `~/.local/state/herdr/agent-detection/`(19 个 agent 清单 toml,只读情报文件);工作区(cwd)零写入。
来源与证据
素材来源:本站实测沉淀(2026-08-28)
验证证据:site docs#1;local repro log 2026-08-29;local repro log