orbit-codex-bridge 0.1.0 → 0.1.1

package/README.md

@@ -1,190 +1,95 @@
 # Orbit · 会话随行
 
-面向手机和桌面的原生 Codex 会话工作台。独立第三方预览版，不是 OpenAI 官方产品，也不是远程桌面。
+从手机连接自己的电脑，查看和继续 Codex 桌面里的原会话。
 
-> **实验性热接管已接入 Codex 桌面 IPC。** 仅当桌面 IPC 可用、目标会话已由 Codex 桌面加载且实时快照就绪时才开放；失败时不会切换到独立执行器。
+Orbit 将电脑连接到 [Orbit 工作台](https://orbit.cubesugar.tech)。在网页中选择电脑和会话，即可查看历史、接收实时回复、发送指令、停止任务和处理审批。桌面已加载的会话会自动热接管，沿用原会话 ID 和执行上下文。
 
-## 已验证的能力
+## 安装与连接
 
-| 能力 | 本版状态 |
-| --- | --- |
-| 列出当前 CODEX_HOME 的原生会话 | 已接入；本机验收读取 22 条，包含 2 条归档、1 条子代理记录 |
-| 按项目归属 / 工作目录分组 | 已接入；本机验收 13 个分组，不代表 13 个独立代码仓库 |
-| 搜索、置顶筛选、分页阅读历史 | 已接入；Markdown、命令输出、退出码、MCP 工具记录及文件 diff 可展开，消息和代码可复制；图片本体尚不展示 |
-| 电脑新增的持久化消息同步到网页 | SQLite/WAL 版本检测 + WebSocket 通知，约 1.2 秒轮询，前端防抖 0.8 秒 |
-| 原 ID 接续闲置历史会话 | 实验通路已实现；用真实 Codex 引擎 + 本机确定性模型桩完成两轮同 ID 集成测试 |
-| Orbit 管理执行的流式输出、停止、审批 | 已实现协议通路；单元测试覆盖，未向用户现有真实会话发送测试消息 |
-| 无侵入热接管桌面活动执行 | 已接入内部桌面 IPC；隔离桩测试覆盖，尚未对用户真实会话写入验证；桌面协议不稳定，暂属实验能力 |
-| 选择模型、推理级别与上下文显示 | 模型目录从当前 Codex `model/list` 动态读取，逐会话授权后可更改下一轮参数；桌面模式经 owner 校验走内部 IPC，未对真实桌面会话执行模型切换验收；上下文仅展示执行器提供的最新一轮真实 token 用量和窗口，不用累计量冒充 |
-| 手机外网连接、自建出站中继 | 已实现云端 Relay 和电脑出站 Agent，需自行部署域名/TLS；已通过两台隔离电脑的 HTTP/WS 集成验证，未部署到真实云服务器 |
-| 多用户控制面与设备撤销 | 已实现自助注册/自动登录、添加自己的电脑/生成连接配置、套餐标签/设备额度/到期、永久撤销、审计及后台；单节点 SQLite 预览版 |
-| 支付、组织角色、推送 | 未实现；不应直接作为完整商业 SaaS 上线 |
-
-“全量”限定为当前本地 `CODEX_HOME` 中的数据，不包含其他电脑、其他用户目录或只存在于云端的会话。子代理可查看但不可独立接续。锁状态是保守探测，不等价于任务正在推理。
-
-## 快速启动
-
-环境：Node.js 24+、npm、已安装 Codex 桌面 / CLI，且本机已有原生会话数据库。
+需要 Node.js 24+，并在电脑上安装、运行 Codex 桌面应用。
 
-在本目录运行：
+Windows PowerShell：
 
 ```powershell
-.\start.ps1
+npx.cmd --yes --package=orbit-codex-bridge@latest orbit login
 ```
 
-或：
+macOS / Linux：
 
-```powershell
-npm ci
-npm start
+```sh
+npx --yes --package=orbit-codex-bridge@latest orbit login
 ```
 
-默认地址：<http://127.0.0.1:4318>。默认只监听本机，不自动开防火墙，不安装系统服务，不修改全局 Codex 配置。
-
-### 通过 npm 连接云端电脑（待发布）
+也可以全局安装，之后直接使用 `orbit` 命令：
 
-发布到 npm 后，Node.js 24+ 用户可安装 Orbit 电脑连接器，不必下载整个源码仓库、手写 `.env.local` 或分别打开两个终端：
-
-```powershell
-npm install --global orbit-codex-bridge
+```sh
+npm install --global orbit-codex-bridge@latest
 orbit login
 ```
 
-`orbit login` 会打开限时设备授权页面。登录 Orbit 账号并确认电脑名称后，电脑自动保存专属凭证，同时运行本机桥接和加密云端 Agent。终端会显示手机工作台地址、本机配对二维码和密钥。手机登录同一账号后扫描二维码、选择这台电脑即可自动配对；不必手动粘贴密钥。配对二维码长期有效，只能在自己的手机上使用，不要发布或转发。保持 `orbit login` 窗口运行即可。
-
-- `orbit status` 查看连接状态和本机配置位置。
-- `orbit logout` 撤销云端电脑凭证并删除本机配置。
-- 首版只打包 Orbit 程序，不包含 Codex 会话、模型密钥或账号凭证。
-- 自建 Relay 可通过 `orbit login --server https://你的域名` 指定。
-- 命令行当前以前台方式运行；关闭窗口会停止服务。再次运行 `orbit login` 会复用电脑凭证。
-- 当前包尚未发布到 npm registry；发布并完成云端域名部署后，这组命令才可供普通用户直接安装。
-
-首次访问需要本机配对密钥：
-
-```powershell
-Get-Content .runtime\pairing-key
-```
-
-密钥在第一次启动时生成，只存于本项目 `.runtime`，不是模型 API Key。不要发到群里、截图公开或提交到代码仓库。
-
-启动脚本强制本机模式或显式 `-Lan`，可用 `-Port 4320` 改端口。生产环境自定义绑定请使用 `.env.local` + `npm start`。如果系统执行策略不允许运行脚本，使用 `npm start`，无需降低系统执行策略。
-
-## 手机同 Wi-Fi 体验
+1. 命令会打开电脑授权页面，登录或注册 Orbit 账号，确认添加这台电脑。
+2. 手机打开 [orbit.cubesugar.tech](https://orbit.cubesugar.tech)，登录同一账号。
+3. 扫描终端显示的配对二维码，选择这台电脑，完成首次连接。
+4. 选择原有会话，开始使用。尚未加载的会话可先在 Codex 桌面打开，再点“重新连接”。
 
-1. 在运行服务的终端按 `Ctrl+C` 停止，改为运行 `./start.ps1 -Lan`。
-2. 打开电脑端“设备与连接”，使用显示的局域网地址，不是手机上的 `127.0.0.1`。
-3. 手机访问该地址，输入配对密钥；也可以在电脑页面主动展示配对二维码。
-4. 如果无法访问，确认两台设备在同一可信网络、没有 AP 隔离，以及 Windows 防火墙是否允许此专用网络端口。程序不会自行修改防火墙。
+授权信息保存在电脑本地，下次启动会自动复用。连接器默认在当前用户的后台运行，可以关闭安装终端；断网后自动重连，工作进程异常退出后自动恢复。电脑需要保持开机、联网，Codex 桌面需要保持运行。电脑重启后运行 `orbit start` 恢复连接。
 
-**局域网 HTTP / WS 没有传输加密，仅供可信 Wi-Fi 演示。不要转发此端口到公网。** 局域网功能已做代码覆盖，尚未用实体手机联网验收。浏览器手机视口 390×844 已检查，无水平溢出。
+## 常用命令
 
-二维码携带配对凭据（URL fragment，不进入 HTTP 请求），扫码者可以浏览本机会话。页面只在主动点击后生成，不向第三方二维码服务发送内容。
-
-## 原会话接续与热接管安全边界
-
-- 浏览、搜索和刷新不会启动执行引擎，NativeStore 以 SQLite `readOnly` + `query_only` 打开数据库。
-- 热接管需要逐条明确确认，授权 30 分钟后过期；订阅本身只读，不会授予控制权。桌面权限继承原 Codex 会话，不会扩大权限。
-- 桌面热接管只路由到已发现的原会话 owner，保留原 conversation ID；任务追加、停止和审批均需匹配当前 owner / turn / request。
-- 桌面 IPC 断线、owner 变化或状态补丁版本缺口会撤销控制授权；不会自动重发指令，也不会回退到 cold resume。恢复后需重新订阅和授权。
-- 模型和推理级别仅能从当前执行器的可用模型目录选择；桌面模式只允许在任务空闲且已授权时更改下一轮设置，会校验原 owner、旧设置和确认结果，不改运行中的任务。独立执行模式在当前浏览器授权会话中保存下一轮覆盖参数，服务重启后会丢失。目录不兼容或无法读取时拒绝切换。
-- 桌面任务运行时可以先选模型并将设置排入下一轮；Orbit 等到同一原会话 turn 空闲后，再用 owner 和旧设置复核并应用。排队设置保存在桥接进程内存，Orbit 服务重启、授权失效、owner 变化或桌面不确认时会撤销/丢弃，不写入真实 Codex 设置文件。
-- 上下文进度采用桌面快照的 `latestTokenUsageInfo.last.totalTokens / modelContextWindow`；总历史用量 `total` 不是当前上下文。没有准确用量或窗口时显示“暂无用量”或只显示 token 数，不猜测百分比。
-- 热接管依赖 Codex 桌面内部 IPC 协议，版本升级后可能失效。接入前要求 Codex 桌面运行并已加载目标会话；还没有对真实会话执行写操作的实机验证。
-- 非桌面模式的历史会话接续使用 `thread/resume` 和 `turn/start`，不创建或 fork 新会话，并校验返回的原 ID。桌面热接管直接委托给原 Codex owner。
-- 独立执行模式遇到原客户端持有 writer lock 时默认拒绝续接。**不要手动删除锁文件，不要让多个独立执行器同时写同一会话。**
-- 桌面热接管要求 Codex 已加载目标会话；独立引擎模式则可能需要先从原客户端正常释放会话。
-- 原生历史可读不代表桌面已加载该会话。遇到 `no-client-found` 时，Orbit 保留历史只读、显示逐会话的未连接原因；在 Codex 桌面打开同一条原会话后，点击提示中的“重新连接”或列表刷新按钮可重新订阅。重新连接不发送消息、不改模型、不自动恢复控制授权，仍需再次明确授权。
-- owner 消失或操作返回 `no-client-found` 会使该会话的旧快照、审批、控制授权及排队模型设置失效；不会自动重试写操作，也不会退回独立执行器。桌面 IPC 本身在线时仍可能有个别会话未加载，界面分别显示这两种状态。
-- 独立引擎沿用本机 `CODEX_HOME`，但桌面进程特有的运行时环境不保证被继承；实际中转配置、环境变量和模型可用性仍需逐机验证。
-- 断线不会自动重放写操作；相同会话中的并发发送会被拒绝。请求 ID 去重窗口为 5 分钟，不能替代持久化事务。
-- 扩大环境权限首版只能拒绝；未知宿主工具直接报错，不自动授权。
-- 不提供私有 stdio 注入、进程内存修改、强制抢锁或自动重启桌面。
-
-## 配置
-
-复制 `.env.example` 为 `.env.local`，按需设置：
-
-| 环境变量 | 说明 |
+| 命令 | 用途 |
 | --- | --- |
-| `ORBIT_PORT` / `ORBIT_HOST` | 默认 `4318` / `127.0.0.1` |
-| `ORBIT_CODEX_HOME` | 原生 Codex 数据目录；默认沿用 `CODEX_HOME` 或用户目录 `.codex` |
-| `ORBIT_CODEX_BIN` | Codex 可执行文件；Windows 默认检测桌面安装目录 |
-| `ORBIT_APP_SERVER_URL` | 可选目标 App Server 地址，远程只允许 `wss://`；本机允许 `ws://` |
-| `ORBIT_APP_SERVER_TOKEN_FILE` | 可选目标 App Server Bearer token 文件，凭据不放入 URL |
-| `ORBIT_PUBLIC_URL` | HTTPS 反向代理对外入口，不会启动隧道或公网中继 |
-
-仅配置 App Server URL **不等于接入桌面**。必须让桌面与 Orbit 确实连接同一个兼容执行实例，并验证 `thread/loaded/list`、事件流、审批和 writer lock 归属。目前这个共享部署方案仍待单独验证。
-
-### 自部署 HTTPS 入口（可选）
-
-可使用自己的 Caddy / Nginx，将 HTTPS 入口代理到本机网关并转发 `/socket` WebSocket。设置正确的 `ORBIT_PUBLIC_URL`，代理必须保留对外 `Host`。HTTPS 模式会设置 `Secure` cookie，因此应只通过该 HTTPS 地址配对，不要混用本机 HTTP 登录。
-
-这是一条自部署 HTTPS 入口。不要直接暴露 Node / Codex 端口；TLS 必须由已配置的反向代理实际终止。
-
-### 多用户云中继与管理后台
+| `orbit login` | 首次授权，或复用已有授权启动后台连接器 |
+| `orbit start` | 启动后台连接器 |
+| `orbit status` | 查看后台运行状态、云端连接状态及日志路径 |
+| `orbit stop` | 停止后台连接器，保留授权 |
+| `orbit restart` | 重启后台连接器 |
+| `orbit logout` | 停止连接并撤销这台电脑的授权 |
+| `orbit rebind` | 清理旧绑定，重新打开网页授权这台电脑 |
+| `orbit login --foreground` | 在当前终端运行，显示实时诊断信息 |
+
+自建服务可在首次授权时指定地址：
+
+```sh
+orbit login --server https://your-orbit-domain.com
+```
 
-云端控制面提供**自助注册、多用户账号、添加自己的电脑、套餐/设备额度、每台电脑独立凭证、在线状态、密码重置、账号停用、设备撤销和管理审计**。部署见 [CLOUD-DEPLOY.md](CLOUD-DEPLOY.md)。管理后台为 `/admin`，普通用户用独立账号登录。
+## 更新
 
-发布 npm 包后，用户访问云端首页注册账号；Windows 电脑复制一条命令运行，会检测 Node.js 24+ 并在缺失时尝试通过 winget 安装。随后在网页确认设备授权，CLI 自动配置并启动电脑连接器，手机扫描配对二维码、选择该电脑即可完成配对。macOS/Linux 先安装 Node.js 24+ 后运行对应命令。不用配置 `.env.local`、复制 Token 或开两个终端。npm 包尚未发布，完整部署说明见 [CLOUD-DEPLOY.md](CLOUD-DEPLOY.md)。
+使用 npx 的用户重新执行安装命令即可获取最新版。全局安装的用户运行：
 
-- `ORBIT_RELAY_ADMIN_TOKEN` 只留在服务器环境文件中，用于管理员登录。
-- 每个用户单独创建，每台电脑签发独立 Agent Token；数据库只存 scrypt 密码哈希、设备 Token 的 SHA-256 哈希和审计元数据。
-- 自助注册默认开启，新账号固定为 free 套餐/1 台设备；设置 `ORBIT_RELAY_REGISTRATION_ENABLED=false` 可关闭注册，已有用户仍可登录和管理自己的设备。当前不使用邮箱验证，忘记密码需管理员重置。
-- 浏览器以 HttpOnly/SameSite cookie 登录。HTTP 和 WebSocket 都先验证用户，再验证目标电脑归属。
-- 管理员停用账号、重置密码或撤销设备会断开相应访问；已撤销设备必须重新签发凭证。
-- Relay 只转发会话协议，不保存 Codex 数据库或模型密钥；TLS 加密到 Relay，当前尚无端到端加密。
+```sh
+npm install --global orbit-codex-bridge@latest
+orbit login
+```
 
-当前实现是**单 Relay 节点 + SQLite 的多租户预览版**，还没有邮件验证/自助找回密码、MFA、组织 RBAC、支付账单或跨节点调度。商业上线前仍需安全审计、灾备与数据保留策略。
+连接器会更新后台运行时，复用已有电脑授权。
 
-### 撤销连接 / 轮换密钥
+从早期需要保持终端打开的版本升级时，先在旧终端按 `Ctrl+C` 停止旧连接器，再运行新版命令。
 
-本地模式中退出只撤销当前浏览器会话；更换 `.runtime\pairing-key` 会要求本地设备重新配对。云端用户可在 `/admin` 撤销单台电脑凭证、停用账号和重置密码。云数据库应纳入受保护的服务器备份。
+## 移除与重新绑定
 
-## 验证
+在工作台的电脑列表点击“移除电脑”，确认后立即撤销连接凭证，释放设备名额。需要再次绑定时，在原电脑执行：
 
 ```powershell
-npm run check
-npm test
-npm run test:native
+npx.cmd --yes --package=orbit-codex-bridge@latest orbit rebind
 ```
 
-- 自动化测试覆盖只读查询、分页、Origin / cookie 校验、原 ID、未授权拒绝、桌面 owner / turn 校验、补丁失步撤权、审批、幂等和并发竞态；桌面 IPC 写入均由隔离桩验证。
-- `test:native` 使用本机 Codex 可执行文件，创建隔离的临时 `CODEX_HOME` 和本机模型响应桩，完成首轮、关闭引擎、原 ID 恢复、第二轮；不会调用真实模型提供方，也不改动现有真实会话。临时目录保留用于诊断，路径由测试输出。
-- 实测 Codex：`0.166.0-alpha.6`；本版读取 `state_5.sqlite` 和 `thread_history_1.sqlite`，这些是内部实现而不是稳定公开存储 API。升级 Codex 后需重新做兼容验证。
-- 另已对本机真实 App Server 做 `initialize` / `thread/list` 只读协议测试；没有恢复或发送现有用户会话。
-- 桌面和手机布局实测截图位于 `previews/desktop.png` / `previews/mobile.png`。默认 npm 镜像没有漏洞审计接口，改用 npm 官方 registry 完成 `npm audit --omit=dev`，结果为 0 个已知依赖漏洞；这不等于应用安全审计。
-
-## 结构
-
-```text
-手机 / 桌面网页
-  ├─ HTTP(S)：配对、状态、列表、历史分页
-  └─ WS(S)：变更通知、消息、流式事件、停止、审批
-        │
-   server.mjs：单用户本地网关
-        ├─ lib/store.mjs：原生历史只读适配器
-         ├─ lib/desktop.mjs：桌面 IPC、owner 发现、实时状态与原会话控制
-         └─ lib/rpc.mjs：按需独立 App Server / 可选显式目标端点
-```
+重新登录并确认电脑授权即可。移除或重绑不会删除电脑上的 Codex 项目和原有会话。
+
+## 常见问题
 
-没有把真实会话复制进 Orbit 自建数据库，没有将模型密钥发送到手机端。历史检测采用轮询，而不是宣称已订阅桌面原始 token 流。只有经本桥接接入的执行才消费 App Server 流式事件。
+**Windows 提示禁止运行 `npx.ps1`**
 
-## 商业化前的关键工作
+在 PowerShell 中使用 `npx.cmd`。全局安装时也可使用 `npm.cmd`，无需修改系统脚本执行策略。
 
-1. **共享执行实例适配**：先解决桌面与手机使用同一个引擎，验证跨端消息、停止、审批、重连与单写者约束；这是区别于 HAPI 使用体验的核心，优先级高于计费。
-2. **云端扩展与可靠性**：现有账号、设备凭证、隔离路由和撤销继续补充限额、连接租约、审计保留与多节点调度。
-3. **安全与可靠性**：考虑端到端加密、最小权限、审计脱敏、密钥轮换、速率限制、持久化幂等、多设备控制权、故障恢复和安全评审。当前预览不具备 E2EE。
-4. **兼容与分发**：固定支持版本、协议能力协商、升级回归、桌面 agent 安装 / 更新 / 卸载、签名与跨平台测试。
-5. **产品与合规**：组织管理、套餐支付和推送；核对依赖许可证和模型服务条款，明确独立品牌与第三方关系。当前不打包转售 Codex 可执行文件。
+**电脑显示离线**
 
-## 与 Hapi 的边界和分发选择
+先确认电脑开机并联网，运行 `orbit status` 查看状态。短暂断网会自动恢复；电脑重启后运行 `orbit start`。仍有问题时，按状态命令显示的路径查看 `connector.log`，或使用 `orbit login --foreground` 诊断。
 
-Hapi 的 Web/PWA、Hub/Runner、跨设备会话、完整工具输出、文件浏览、附件、终端、多代理和跨会话 `@` 提及是对照范围；Orbit 当前只针对本机 Codex 原生会话。新增的工具详情依旧只是历史只读呈现，不会代替 Hapi 的完整执行控制或跨端同步。
+**能看历史，但会话尚未连接**
 
-原型阶段可以继续使用 Node + 本地页面，不必先做 EXE。对外分发可选择一个小型用户级安装器托管现有后台代理，并提供自动启动/更新/卸载；不需要改造成 Electron 大窗口。MCP 服务可以作为可选入口，将“列出会话、只读查看、受控发消息”等操作注册成 Codex 可调用的工具，但不能替代持久运行的本机代理、手机界面和安全的公网中继，也不会自然取得桌面应用的会话所有权。跨会话发送必须额外设置逐会话权限、精确目标及审计，不能把引用文本误当授权。
+在 Codex 桌面打开同一条会话，再点击网页中的“重新连接”。桌面热接管依赖 Codex 内部接口，桌面版本更新后可能需要更新 Orbit。
 
-仍未实现：跨会话提及/消息发送、完整附件及图片、终端、独立手机推送、支付和团队权限。桌面热接管依赖未公开 IPC，隔离测试不等于真实桌面写入验收。
+**配对二维码与密钥**
 
-协议参考：
-- <https://developers.openai.com/codex/app-server/>
-- <https://github.com/openai/codex/blob/main/codex-rs/app-server-daemon/README.md>
+只在自己的设备上使用。每台电脑使用独立连接凭证，可在工作台移除电脑，或运行 `orbit logout` 撤销授权。连接中断时，Orbit 不会自动重发已提交的消息和审批。

package/cli.mjs

@@ -9,6 +9,7 @@ import { fileURLToPath } from 'node:url';
 import QRCode from 'qrcode';
 import { createOrbitServer } from './server.mjs';
 import { createRelayAgent } from './relay-agent.mjs';
+import {connectorStatus,installConnectorRuntime,startConnector,stopConnector,superviseConnector} from './lib/connector-service.mjs';
 
 const defaultServerUrl = 'https://orbit.cubesugar.tech';
 const packageDirectory = path.dirname(fileURLToPath(import.meta.url));
@@ -136,42 +137,101 @@ async function authorizeComputer(serverUrl, name) {
   return config;
 }
 
-async function runComputer(config) {
+export async function existingOrbitUrl(port) {
+  const url=`http://127.0.0.1:${port}`;
+  try {
+    const response=await fetch(`${url}/healthz`,{signal:AbortSignal.timeout(1500),cache:'no-store'});
+    if(!response.ok)return null;
+    const health=await response.json();
+    return health.ok===true?url:null;
+  } catch { return null; }
+}
+
+async function printPairing(pairingKey, publicUrl) {
+  const pairingUrl = `${publicUrl}/#pair=${encodeURIComponent(pairingKey)}`;
+  console.log('本机配对二维码和密钥仅供自己的手机使用，请勿公开。');
+  console.log(await QRCode.toString(pairingUrl,{type:'terminal',errorCorrectionLevel:'L',small:true}));
+  console.log(`本机配对密钥：${pairingKey}`);
+}
+
+async function runComputer(config, background = false) {
   process.env.ORBIT_HOST = '127.0.0.1';
   process.env.ORBIT_PORT = String(config.port || 4318);
   process.env.ORBIT_PUBLIC_URL = config.publicUrl;
-  const app = createOrbitServer({dataDir:configDirectory(), publicUrl:config.publicUrl});
+  let app=null;
   let agent;
-  let listening = false;
+  let localUrl=await existingOrbitUrl(config.port || 4318);
+  if(localUrl)console.log(`检测到本机 Orbit 已运行，将复用 ${localUrl} 并连接云端。`);
   try {
-    const info = await app.listen();
-    listening = true;
+    if(!localUrl){
+      app=createOrbitServer({dataDir:configDirectory(),publicUrl:config.publicUrl});
+      const info=await app.listen();
+      localUrl=info.url;
+      console.log(`Orbit 电脑端运行中：${localUrl}`);
+      if (!background) await printPairing(app.pairingKey,config.publicUrl);
+    }
     agent = createRelayAgent({
       relayUrl:config.relayUrl,
-      localUrl:info.url,
+      localUrl,
       deviceId:config.deviceId,
       agentToken:config.agentToken,
       onReady:() => console.log(`电脑“${config.deviceName}”已安全连接 Orbit。`),
+      onState:state => {
+        if (background && process.connected) process.send({type:'connector-state',state:{...state,workerReady:true}},() => {});
+      },
       onError:error => console.error(`Orbit 连接暂时中断：${error.message}`)
     });
     agent.start();
-    console.log(`Orbit 电脑端运行中：${info.url}`);
+    if(!app)console.log(`复用本机 Orbit：${localUrl}`);
     console.log(`手机工作台：${config.publicUrl}`);
-    console.log('保持此窗口运行；按 Ctrl+C 停止电脑端。');
-    const pairingUrl = `${config.publicUrl}/#pair=${encodeURIComponent(app.pairingKey)}`;
-    console.log('本机配对二维码（含长期本机密钥，仅用于自己的手机；不要发布或转发）：');
-    console.log(await QRCode.toString(pairingUrl, {type:'terminal', errorCorrectionLevel:'L', small:true}));
-    console.log(`本机配对密钥：${app.pairingKey}`);
+    if (!background) console.log('前台诊断模式；保持此窗口运行，按 Ctrl+C 停止。');
     await new Promise(resolve => {
-      process.once('SIGINT', resolve);
-      process.once('SIGTERM', resolve);
+      const stop = () => {
+        process.off('SIGINT',stop);process.off('SIGTERM',stop);process.off('message',message);process.off('disconnect',stop);
+        resolve();
+      };
+      const message = packet => { if (packet?.type === 'stop') stop(); };
+      process.once('SIGINT',stop);
+      process.once('SIGTERM',stop);
+      if (background) {process.on('message',message);process.once('disconnect',stop);}
     });
   } finally {
     agent?.stop();
-    if (listening) await app.close();
+    if (app) await app.close();
   }
 }
 
+async function runBackground(config) {
+  console.log('正在启动 Orbit 后台连接器…');
+  const runtime = await installConnectorRuntime(packageDirectory,configDirectory());
+  const service = await startConnector({home:configDirectory(),...runtime});
+  const label = service.status === 'online' ? '已连接云端' : service.status === 'blocked' ? service.reason : '正在自动连接云端';
+  console.log(`电脑“${config.deviceName}”后台运行中 · ${label}`);
+  console.log(`手机工作台：${config.publicUrl}`);
+  console.log('可以关闭此终端。断网自动重连，异常退出自动恢复；电脑休眠期间无法远程使用。');
+  console.log('停止：orbit stop；状态：orbit status；前台诊断：orbit login --foreground');
+  console.log(`诊断日志：${path.join(configDirectory(),'connector.log')}`);
+  try {
+    const key = (await fs.readFile(path.join(configDirectory(),'pairing-key'),'utf8')).trim();
+    if (key) await printPairing(key,config.publicUrl);
+  } catch (error) { if (error.code !== 'ENOENT') throw error; }
+}
+
+async function revokeComputer(config) {
+  const response = await fetch(`${config.publicUrl}/api/cloud/device-auth/revoke`, {
+    method:'POST',
+    headers:{'Authorization':`Bearer ${config.agentToken}`,'Content-Type':'application/json'},
+    body:JSON.stringify({deviceId:config.deviceId}),
+    signal:AbortSignal.timeout(15000)
+  });
+  if (!response.ok && response.status !== 404) {
+    const result = await response.json().catch(() => ({}));
+    throw new Error(result.error || `无法撤销电脑凭证 (${response.status})。请检查网络后重试。`);
+  }
+  await stopConnector(configDirectory());
+  await fs.unlink(configPath());
+}
+
 async function main() {
   const [command = 'login', ...args] = process.argv.slice(2);
   if (command === '--version' || command === '-v') {
@@ -179,48 +239,68 @@ async function main() {
     return;
   }
   if (command === '--help' || command === '-h' || command === 'help') {
-    console.log('Orbit computer connector\n\nUsage:\n  orbit login [--name "My computer"] [--server https://orbit.example.com]\n  orbit status\n  orbit logout');
+    console.log('Orbit computer connector\n\nUsage:\n  orbit login [--name "My computer"] [--server https://orbit.example.com] [--foreground]\n  orbit start\n  orbit stop\n  orbit restart\n  orbit status\n  orbit logout\n  orbit rebind');
     return;
   }
   const namedIndex = args.indexOf('--name');
-  const name = namedIndex >= 0 ? args[namedIndex + 1] : os.hostname();
+  let name = namedIndex >= 0 ? args[namedIndex + 1] : os.hostname();
   const serverIndex = args.indexOf('--server');
-  const serverUrl = normalizedServer(serverIndex >= 0 ? args[serverIndex + 1] : process.env.ORBIT_SERVER_URL);
-  const existing = await loadConfig();
+  let serverUrl = normalizedServer(serverIndex >= 0 ? args[serverIndex + 1] : process.env.ORBIT_SERVER_URL);
+  let existing = await loadConfig();
+  if (command === '__service' || command === '__worker') {
+    if (!existing) throw new Error('电脑凭证不存在，请运行 orbit login。');
+    if (command === '__worker') {
+      if (!process.connected) throw new Error('工作进程只能由后台连接器启动。');
+      await runComputer(existing,true);
+    } else {
+      const version = JSON.parse(await fs.readFile(path.join(packageDirectory,'package.json'),'utf8')).version;
+      await superviseConnector({home:configDirectory(),config:existing,cliPath:fileURLToPath(import.meta.url),version});
+    }
+    return;
+  }
 
   if (command === 'status') {
+    const service = await connectorStatus(configDirectory());
+    const labels = {online:'在线',connecting:'连接中',reconnecting:'断线重连中',blocked:'连接被拒绝',starting:'启动中',restarting:'异常恢复中'};
     console.log(existing
-      ? `电脑：${existing.deviceName}\n工作台：${existing.publicUrl}\n配置文件：${configPath()}`
+      ? `电脑：${existing.deviceName}\n工作台：${existing.publicUrl}\n后台服务：${service ? labels[service.status] || service.status : '未运行'}${service?.reason ? ` · ${service.reason}` : ''}\n配置文件：${configPath()}\n日志文件：${path.join(configDirectory(),'connector.log')}`
       : '此电脑尚未连接 Orbit。运行 orbit login 完成连接。');
     return;
   }
+  if (command === 'stop') {
+    console.log(await stopConnector(configDirectory()) ? 'Orbit 后台连接器已停止，授权已保留。' : 'Orbit 后台连接器未运行。');
+    return;
+  }
   if (command === 'logout') {
     if (!existing) {
       console.log('此电脑尚未连接 Orbit。');
       return;
     }
-    const response = await fetch(`${existing.publicUrl}/api/cloud/device-auth/revoke`, {
-      method:'POST',
-      headers:{'Authorization':`Bearer ${existing.agentToken}`, 'Content-Type':'application/json'},
-      body:JSON.stringify({deviceId:existing.deviceId})
-    });
-    if (!response.ok && response.status !== 404) {
-      const result = await response.json().catch(() => ({}));
-      throw new Error(result.error || `无法撤销电脑凭证 (${response.status})。请检查网络后重试。`);
-    }
-    await fs.unlink(configPath());
+    await revokeComputer(existing);
     console.log('电脑凭证已从服务器撤销，并从本机删除。');
     return;
   }
-  if (command !== 'login') throw new Error(`未知命令：${command}。运行 orbit --help 查看用法。`);
+  if (!['login','start','restart','rebind'].includes(command)) throw new Error(`未知命令：${command}。运行 orbit --help 查看用法。`);
+  if (command === 'rebind' && existing) {
+    if (namedIndex < 0) name = existing.deviceName;
+    if (serverIndex < 0) serverUrl = normalizedServer(existing.publicUrl);
+    await revokeComputer(existing);
+    existing = null;
+    console.log('旧电脑授权已移除，正在重新绑定。');
+  }
+  if (command === 'restart') await stopConnector(configDirectory());
   if (existing) {
-    await runComputer(existing);
+    if (args.includes('--foreground')) {
+      await stopConnector(configDirectory());
+      await runComputer(existing);
+    } else await runBackground(existing);
     return;
   }
   console.log('正在为这台电脑申请 Orbit 连接授权…');
   const config = await authorizeComputer(serverUrl, name);
   console.log(`已保存电脑“${config.deviceName}”的专属凭证到 ${configPath()}。`);
-  await runComputer(config);
+  if (args.includes('--foreground')) await runComputer(config);
+  else await runBackground(config);
 }
 
 export async function runCli() {