安装 oberth

安装只做三件事：解析最新发布、校验对应平台的压缩包、把二进制放进 PATH。它不碰你的项目，也不启动 daemon。

一行命令，macOS 与 Linux

install · macOS 或 Linux

curl -fsSL https://raw.githubusercontent.com/SheathedSharp/option-berth/main/install.sh | sh

脚本读取 uname，挑出对应的 darwin/linux 与 amd64/arm64 压缩包，核对同名 .sha256，然后安装。不需要管理员权限。

二进制：~/.local/bin/oberth 与 ~/.local/bin/jev-attention。
许可证与构建清单：~/.local/share/option-berth。
PATH：在一份已有的 shell 启动文件里加一行，从不新建文件。
运行状态：~/.option-berth，安装脚本既不创建也不修改它。

用 --version v1.0.0 固定版本，用 --dir "$HOME/tools/bin" 换目录，或用 --no-modify-path 不动你的 shell 文件。官方主机慢或不可达时，脚本会探测镜像；换源后仍须报告同一个 SHA256，安装才继续。

Windows

install · Windows PowerShell

irm https://raw.githubusercontent.com/SheathedSharp/option-berth/main/install.ps1 | iex

二进制落在 %LOCALAPPDATA%\option-berth\bin，只改当前用户的 PATH。用 -Version 固定版本，用 -NoModifyPath 不动 PATH。替换文件前，安装脚本会先停掉正在运行的 oberth daemon；它不会替你停项目服务。

其他安装方式

安装渠道
渠道	命令	适合什么
go install	`go install github.com/sheathedsharp/option-berth/engine/cmd/oberth@latest`	Go 1.25+，装进 `GOPATH/bin`；有模块代理即可。
Homebrew	`brew install sheathedsharp/tap/oberth`	自托管 tap 提供的引擎 CLI；还没有进 homebrew-core。
发布包	下载、核对 `SHA256SUMS`、放进 PATH	不想运行脚本时。
Linux 包	`.deb` 或 `.rpm`	交给发行版管理；细节在安装契约里。

确认构建

最初两条命令

oberth version --json
oberth doctor

version --json 返回你实际装上的二进制之 version、commit、built 和 platform。doctor 检查清单、daemon、CLI 路径、日志目录，以及当前进程能不能看见监听。看不见就报告“看不见”并给出下一步，不会写成“没有东西在监听”。

平台边界

完整服务场景只在 macOS 与 Linux 上验证。Windows 有原生构建、冒烟测试和一次 arm64 交叉构建；这不等于完整生命周期在 Windows 上也验证过。引擎没有图形界面：macOS 客户端是独立产品，coding agent skill 也是。

升级与卸载

重新运行对应平台的安装命令即可升级；升级后执行一次 oberth daemon stop，下一次调用就起新构建。macOS 与 Linux 用 uninstall.sh 卸载，Windows 用 uninstall.ps1。卸载脚本会先停 daemon，并默认保留 ~/.option-berth；传 --purge-state 才会一并删除。确切参数与各平台路径见安装与卸载。

编辑本页