# Hunter Quant 本机端口与自动启动说明

## 正确地址

- 当前门户：`http://127.0.0.1:8787`
- `http://127.0.0.1:8765`：早期 QuantPilot 本地监控使用过的旧端口，不是当前门户入口，未启动时会返回 `ERR_CONNECTION_REFUSED`。

## Terminal 命令是什么意思

`npm run access:local` 确实是在 macOS 的“终端”中执行，但必须先进入门户项目目录。该命令只能维持当前终端会话；终端、Codex 或电脑重启后，临时进程可能结束。

本次已经改为 macOS LaunchAgent 常驻服务，因此正常情况下不再需要手动执行该命令。

## 已安装的常驻服务

- 服务名：`com.hunter.quant.local-bridge`
- 配置位置：`~/Library/LaunchAgents/com.hunter.quant.local-bridge.plist`
- 监听地址：`127.0.0.1:8787`
- 启动策略：登录自动启动（RunAtLoad）
- 保活策略：异常退出自动重启（KeepAlive）
- 标准输出：`portal/.local-bridge/stdout.log`
- 错误日志：`portal/.local-bridge/stderr.log`

## 2026-08-01 验收

- `launchctl` 状态：`running`
- 进程号：`66647`
- TCP：`127.0.0.1:8787 (LISTEN)`
- 首页：HTTP 200，返回 22,057 字节
- 服务第一次登录启动可能需要约数秒；如果浏览器保留了旧错误页，点击一次“重新加载”。

## 数据运行边界

本机服务只负责让浏览器访问门户。云端 `quantpilot-primary` Durable Object 继续独立执行模拟策略；关闭浏览器不会停止云端账户。电脑关机时，本机 `127.0.0.1` 无法访问，但云端模拟账户仍继续运行；下次登录 macOS 后，本机桥会自动恢复。