@skylandnpm/octopus-proxy 0.1.30 → 0.1.31

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (7) hide show
  1. package/README.md +4 -3
  2. package/dist/{chunk-PYZSSOSD.js → chunk-KDOXN43O.js} +825 -451
  3. package/dist/cli.js +17 -3
  4. package/dist/main.js +1 -1
  5. package/native/auth-linux.c +42 -0
  6. package/native/auth-macos.m +28 -0
  7. package/package.json +3 -1
package/README.md CHANGED
@@ -9,13 +9,14 @@ npm install -g @skylandnpm/octopus-proxy@latest --prefer-online --registry https
9
9
  octopus-proxy help
10
10
  octopus-proxy version
11
11
  octopus-proxy onboard
12
+ octopus-proxy identity
12
13
  ```
13
14
 
14
- `--prefer-online` 会让 npm 在安装时重新校验 registry 中的包元数据，避免本地缓存使 `@latest` 仍指向旧版本，不再需要先运行 `npm view @skylandnpm/octopus-proxy versions`。如果升级后 `octopus-proxy version` 仍显示旧版本，运行 `command -v npm`、`npm prefix -g` 和 `command -v octopus-proxy`，确认 npm 的全局安装目录与实际执行的命令属于同一套 Node.js 环境；使用 NVM 与 Homebrew 时尤其要检查这一点。
15
+ 向导默认安装服务；使用 `--no-install-service` 时，之后运行 `octopus-proxy install`。安装和重装会保留原主机密钥。`--prefer-online` 会让 npm 在安装时重新校验 registry 中的包元数据，避免本地缓存使 `@latest` 仍指向旧版本，不再需要先运行 `npm view @skylandnpm/octopus-proxy versions`。如果升级后 `octopus-proxy version` 仍显示旧版本，运行 `command -v npm`、`npm prefix -g` 和 `command -v octopus-proxy`，确认 npm 的全局安装目录与实际执行的命令属于同一套 Node.js 环境；使用 NVM 与 Homebrew 时尤其要检查这一点。
15
16
 
16
17
  向导默认使用 `https://octopus.wuyehao.com` 作为 Hub 地址；按需可输入其他地址，或用 `--hub-url` 指定。再次运行向导时会读取现有配置，直接回车即可保留各项设置；机器人 Secret 只提示已配置，不在终端显示原值。macOS 上选择编码工具时，向导优先显示已配置或探测到的命令路径，否则给出该工具的 macOS 路径示例；回车后会检查文件可执行性并运行版本命令，失败时要求重新输入。无交互环境可使用 `octopus-proxy onboard --non-interactive`，未提供 `--hub-url` 时也使用该默认地址；完整选项见 `octopus-proxy help`。安装服务后可运行 `octopus-proxy status` 和 `octopus-proxy doctor` 检查状态。
17
18
 
18
- Proxy 始终使用独立的控制与文件 WebSocket；文件读取和上传不会回退到控制通道。两个通道会同时连接并各自重连，Hub 只会把文件命令发送到同一 Proxy 实例的已就绪文件通道。控制与文件连接在 `X-Octopus-Proxy-Instance-Id` 中分别使用 `:control`、`:files` 后缀；Hub 去除后缀再配对实例，因此即使反向代理把 `/ws/proxy-files` 重写为上游 `/ws/proxy`，也能正确识别文件通道。反向代理需转发 WebSocket Upgrade、Authorization、`X-Octopus-Bot-Id` 与 `X-Octopus-Proxy-Instance-Id`。同一套 bot ID 和 Secret 被另一台 Proxy 主机连接后，Hub 会让新实例接管，旧实例会同时关闭两个通道并停止自动重连；若要让旧实例重新接管，必须显式重启其服务。
19
+ Proxy 主动连接 Hub 的 `/ws/proxy-chat`，无需开放入站端口或安装 sshd。Claw 经 `/ws/claw-chat` 建立到 Proxy 的内层 TLS 1.3 会话；Hub 只转发加密字节。首次打开工作区显示主机公钥指纹，点击 Trust 后按 Hub 地址和机器人 ID 固定；之后指纹变化会拒绝连接。每次连接都要输入运行 Proxy 服务账号的主机密码，由主机上的 PAM（Linux）或 Open Directory（macOS）验证。断线或连续 60 分钟没有用户操作后需要重新认证。服务安装时生成主机身份，`octopus-proxy identity` 可在主机上查看指纹。安装主机需提供 OpenSSL 和 C 编译器；Linux 还需 PAM 开发头文件。机器人 Secret 仅用于 Hub 路由，不能单独授权工作区。
19
20
 
20
21
  添加授权项目时，填写项目 ID 后会询问是否继续添加；直接回车即可结束添加并继续保存配置。
21
22
 
@@ -28,7 +29,7 @@ octopus-proxy doctor
28
29
  octopus-proxy restart
29
30
  ```
30
31
 
31
- Claw 打开机器人工作区时会通过 Hub 向 Proxy 发送只读 `runtime.snapshot` 命令。响应包含当前运行状态、Hub 和工具设置、授权项目路径，以及工具可提供的模型信息；机器人 Secret、工具密码和提供商凭据不会返回。工作区的“Proxy 信息”按钮可查看这些内容。
32
+ Claw 完成主机信任和账号认证后，通过端到端会话向 Proxy 发送只读 `runtime.snapshot` 命令。响应包含当前运行状态、Hub 和工具设置、授权项目路径，以及工具可提供的模型信息；机器人 Secret、工具密码和提供商凭据不会返回。工作区的“Proxy 信息”按钮可查看这些内容。
32
33
 
33
34
  Codex 和 ZCode 由 Proxy 按授权项目启动各自的 app-server，默认随 Proxy 自动启动；服务未就绪时也可在 Claw 点击“启动服务”。若命令不可执行或某个项目启动失败，工作区会显示失败项目及原因。修改命令路径或授权项目后，运行 `octopus-proxy restart` 使配置生效。
34
35