down:停这个项目,不动整台机器
down 停的是这个 worktree 清单声明的服务。它不会跨到另一个 checkout,并且只在停止被确认之后归还 port: auto 预留。
正常停止
不带参数时,down 使用最近的清单。它停掉项目服务,并在动作确认这些端口可以释放之后归还 port: auto 预留。--force 直接使用强制信号;它不会跳过运行归属或预留释放的门槛。
oberth down
checkout 已经不在了
--worktree PATH 按 checkout 根路径停止,--identity wt_… 按身份停止。两者都不能和项目名或清单路径同时使用。worktrees --gone 列出 checkout 已经不存在的身份,让你找到已删除 checkout 留下的服务和数据。
oberth worktrees --gone
oberth down --identity wt_0123456789ab
daemon 从未见过的身份返回 not_found;它不会猜一个组。目标已经没有运行或预留时,显式身份仍然是一次成功的空停止。
目标有歧义的时候
两个 checkout 真的可能共用同一个组名,比如不同父目录下的两个同名目录。它们的组已经合并,按组停止会同时命中两边;这时 down 返回 ambiguous,不替调用方挑一个。改用端口或 pid 点名进程。
oberth kill 21730