Pit Officer

Pit Officer

网站：officer.openpit.dev

Pit Officer 可让你管理交易账户、设置风险限额、连接经纪商，并通过 Web 面板发送订单。OpenPit 风险引擎会在 Officer 通过交易连接发送订单前检查每笔订单。你也可以通过交易软件或 AI Agent 使用 Officer。

运行

如需查看可视化操作指南，请参阅视频指南。

Officer 在你自己的电脑上运行，你可以通过 Web 浏览器使用它。Docker 可让你在 Windows、macOS 和 Linux 上运行同一个现成应用，无需构建应用或安装编程工具。

如果你还没有 Docker，请按照 Docker 安装指南操作。启动 Docker Desktop，并等待其显示正在运行。在 Linux 上，你也可以使用 Docker Engine；请参阅快速入门。

打开终端，也就是输入命令的窗口：在 Windows 上，从开始菜单打开 PowerShell；在 macOS 上打开 Terminal；在 Linux 上打开你的终端应用。复制下面的命令，粘贴到终端中，然后按 Enter。三个系统使用的命令相同：

docker run -d --name pit-officer --restart unless-stopped -p 127.0.0.1:8787:8787 -v pit-officer-data:/data ghcr.io/openpitkit/officer:latest

latest 是 Officer 的最新稳定版本。首次运行时会下载 Officer，这可能需要几分钟。随后它会在后台运行，因此你可以关闭终端。你的设置和记录会保存在电脑上的 pit-officer-data 存储中，停止或重启 Officer 时也会保留。

要检查是否已就绪，请运行：

docker ps --filter name=pit-officer

当 STATUS 列显示 (healthy) 时，在浏览器中打开 http://127.0.0.1:8787 并将其加入书签。如果显示 (health: starting)，请等待几秒后再检查。面板就绪后，你可以配置账户、风险限额和连接。

在这个地址中，127.0.0.1 表示你自己的电脑，8787 是端口，也就是访问面板所用的编号。要使用其他端口，请在运行较长的命令前选择端口：例如，将 -p 127.0.0.1:8787:8787 替换为 -p 127.0.0.1:8788:8787，然后打开 http://127.0.0.1:8788。请保持最后的 8787 不变；这是 Officer 在 Docker 内部使用的编号。

要停止 Officer，请运行 docker stop pit-officer。要重新启动，请运行 docker start pit-officer 并打开书签。首次安装后使用这些命令即可；无需重复运行较长的命令。

要试用尚未发布的更改，请改为运行 edge 构建版本，也就是通过检查的最新开发版本。它会经常变化，可能无法正常工作，因此请为它使用独立的名称、端口和存储，与稳定版安装分开：

docker run -d --name pit-officer-edge --restart unless-stopped -p 127.0.0.1:8788:8787 -v pit-officer-edge-data:/data ghcr.io/openpitkit/officer:edge

然后打开 http://127.0.0.1:8788，并在上述命令中使用 pit-officer-edge 替代 pit-officer。

如需安装帮助、更改现有安装的端口，或排查无法打开的面板，请参阅快速入门。

构建

先决条件：C 工具链（OpenPit Go 绑定通过 cgo 需要它）、Go，以及用于构建仪表板包的 Node 和 npm。工具版本固定在 .github/ci-versions.env 中。

在仓库根目录中，先构建仪表板，再构建二进制文件，这样 Go 才能嵌入编译后的资源：

npm --prefix web ci
npm --prefix web run build
CGO_ENABLED=1 go build -o pit-officer ./cmd/pit-officer

在 Windows 上，在 shell 中设置 CGO_ENABLED=1，使用 go build -o pit-officer.exe ./cmd/pit-officer 进行构建，然后运行 ./pit-officer.exe。

从源代码运行

Pit Officer 是一个包含四个子命令的单二进制文件：serve、mcp、 dashboard、healthcheck。构建完成后，在仓库根目录运行：

./pit-officer serve       # serve the dashboard, REST API, and HTTP MCP
./pit-officer dashboard   # in another terminal, open the running instance
./pit-officer mcp         # alternatively, run a local stdio MCP server

子命令、环境变量、标志和授权模型详见配置参考。REST 和 MCP 集成说明请参阅 API 说明。

本地构建容器

如需使用 docker-compose.yml 中的设置构建并运行本地容器镜像：

. ./.github/ci-versions.env
docker build --build-arg GO_VERSION="$CI_GO" -t pit-officer:local .
docker compose up

可选的 Just 快捷方式

Just 可作为上述手动步骤的快捷替代方案。这些配方还需要 Python 3；完整检查还会用到 golangci-lint 和 Semgrep，详见 开发说明。

just frontend-ci-install  # npm ci in web/ from the committed lockfile
just build                # build the SPA, then the pit-officer binary
just run-serve            # build and serve
just dashboard            # open the running instance in the browser
just run-mcp              # build and run a local stdio MCP server
just docker-build         # build the pit-officer:local container image
just check                # format checks, linters, Semgrep, tests, frontend bundles

如何使用可导入的软件包组合自己的 Officer、基于本地 Pit 检出版本进行构建，以及调试变体，详见 开发说明。

许可证

Apache License 2.0。请参阅 LICENSE。