@skylandnpm/octopus-proxy 0.1.73 → 0.1.75
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.
- package/README.md +35 -3
- package/dist/{chunk-SSY3TLHA.js → chunk-4VKDJVX3.js} +370 -188
- package/dist/{chunk-OTKNRBZ7.js → chunk-TSX64XMW.js} +454 -187
- package/dist/cli.js +37 -12
- package/dist/main.js +2 -2
- package/dist/remote-worker.js +4 -2
- package/native/remote-windows.cs +555 -0
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -2,10 +2,42 @@
|
|
|
2
2
|
|
|
3
3
|
**Embodied Dots** 意为**具身智能体节点**，是连接远程主机与智能体工作空间的节点。Taskhub 和 Claw 的菜单和列表使用复数 Dots，单个节点及其设置使用单数 Dot；接口字段 `botId`、CLI 参数 `--bot-id` 和数据库表 `hub_bots` 保持不变，已有节点和凭据可继续使用。
|
|
4
4
|
|
|
5
|
-
Octopus Proxy
|
|
5
|
+
Octopus Proxy 可运行在 macOS、Linux 和 Windows 主机上，需要 Node.js 22 或更高版本。macOS 和 Linux 支持系统服务；Windows x64 从已登录的本机桌面前台运行。
|
|
6
6
|
|
|
7
7
|
## 安装
|
|
8
8
|
|
|
9
|
+
### 一键检查和安装
|
|
10
|
+
|
|
11
|
+
在仓库根目录运行以下脚本。脚本会复用能正常执行的 Node.js 22（含 npm）、OpenCode 2.0.19 和 Octopus Proxy，缺失或版本不匹配时安装。首次安装 Proxy 使用 npm 的 `@latest`。OpenCode 固定为 `2.0.19`，与[当前适配器的兼容基线](../../docs/opencode-compatibility.md)一致。
|
|
12
|
+
|
|
13
|
+
Linux 或 WSL（x64 / ARM64）
|
|
14
|
+
|
|
15
|
+
```bash
|
|
16
|
+
./scripts/installer/install-octopus-tools.sh
|
|
17
|
+
export PATH="$HOME/.local/share/octopus-tools/npm/bin:$HOME/.local/share/octopus-tools/node/bin:$PATH"
|
|
18
|
+
octopus-proxy onboard --tool opencode
|
|
19
|
+
```
|
|
20
|
+
|
|
21
|
+
脚本以当前用户安装。将上面的 `export` 加入 shell 启动文件可在新终端使用。安装需要 `flock`，自动下载的 Node.js 需要 glibc 及 `curl`、`tar`、`sha256sum`。Alpine 等 musl 发行版可先通过发行版软件源安装 Node.js 22 和 npm，再运行脚本。Proxy 的 `node-pty` 依赖在 Linux 上需要 Python 3、`make` 和 C/C++ 编译器，Debian、Ubuntu 或 WSL 的 Ubuntu 可用 `sudo apt install python3 build-essential` 安装。如果脚本安装了 Proxy，运行 `NPM_CONFIG_PREFIX="$HOME/.local/share/octopus-tools/npm" octopus-proxy update` 可用 CLI 更新这份安装。
|
|
22
|
+
|
|
23
|
+
Windows（x64 / ARM64）
|
|
24
|
+
|
|
25
|
+
```powershell
|
|
26
|
+
powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\scripts\installer\install-octopus-tools.ps1
|
|
27
|
+
```
|
|
28
|
+
|
|
29
|
+
用 Windows 自带的 `powershell.exe` 启动。若系统缺少 PowerShell 7（`pwsh.exe`），脚本会以自身所在目录为基准，优先查找 `PowerShell-7.6.9-win-x64.zip` 或 `PowerShell-7.6.9-win-arm64.zip`，从任意工作目录启动都适用。将对应架构的 ZIP 与脚本一起复制到目标 Windows 主机即可使用本地包。脚本校验 SHA-256 后解压到 `%LOCALAPPDATA%\Octopus\Tools\powershell`，再继续安装其余工具。
|
|
30
|
+
|
|
31
|
+
本地包缺失或无法通过校验时，脚本会在线下载。可将 `OCTOPUS_POWERSHELL_MIRROR` 设为镜像基址，脚本会拼接 `v7.6.9/PowerShell-7.6.9-win-<架构>.zip`。镜像下载或校验失败时回退到官方源。 [PowerShell 7.6.9 官方发行页](https://github.com/PowerShell/PowerShell/releases/tag/v7.6.9)
|
|
32
|
+
|
|
33
|
+
安装完成后新开终端即可读取更新的用户 PATH。如果系统 PATH 中已有其他 Node.js 并优先命中，在当前 PowerShell 执行 `$env:Path = "$env:LOCALAPPDATA\Octopus\Tools\npm;$env:LOCALAPPDATA\Octopus\Tools\node;$env:Path"`。支持 Windows 远控的 Proxy 版本可直接在原生 Windows x64 执行 `octopus-proxy onboard` 和 `octopus-proxy run`，详见[主机安装与配对](../../docs/claw-remote-desktop.md#windows-被控主机)。脚本安装的 npm 版本需要包含此功能。
|
|
34
|
+
|
|
35
|
+
只检查版本时，Linux 追加 `--check`，Windows 追加 `-Check`。Windows 的检查包含 PowerShell 7。任何一项缺失或版本不符时返回退出码 `1`。
|
|
36
|
+
|
|
37
|
+
Node.js 和 npm 默认使用 `https://npmmirror.com/mirrors/node` 和 `https://registry.npmmirror.com`，下载或安装失败时回退到官方源。可通过 `OCTOPUS_NODE_MIRROR` 和 `OCTOPUS_NPM_REGISTRY` 为本次运行指定源。Node.js 压缩包按官方 SHA-256 校验，npm 源设置仅用于本次安装。
|
|
38
|
+
|
|
39
|
+
### 手动安装
|
|
40
|
+
|
|
9
41
|
```sh
|
|
10
42
|
npm install -g @skylandnpm/octopus-proxy@latest --prefer-online --registry https://registry.npmjs.org
|
|
11
43
|
octopus-proxy help
|
|
@@ -14,11 +46,11 @@ octopus-proxy onboard
|
|
|
14
46
|
octopus-proxy identity
|
|
15
47
|
```
|
|
16
48
|
|
|
17
|
-
|
|
49
|
+
在 macOS 和 Linux 上，向导默认安装服务；使用 `--no-install-service` 时，之后可运行 `octopus-proxy install`。在 Windows 上，完成向导后先运行 `octopus-proxy run`，再从另一个终端执行 `octopus-proxy identity`。安装和重装会保留原主机密钥。`--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 时尤其要检查这一点。
|
|
18
50
|
|
|
19
51
|
向导默认使用 `https://octopus.wuyehao.com` 作为 Hub 地址；按需可输入其他地址，或用 `--hub-url` 指定。再次运行向导时会读取现有配置，直接回车即可保留各项设置；Dot Secret 只提示已配置，不在终端显示原值。macOS 上选择编码工具时，向导优先显示已配置或探测到的命令路径，否则给出该工具的 macOS 路径示例；回车后会检查文件可执行性并运行版本命令，失败时要求重新输入。无交互环境可使用 `octopus-proxy onboard --non-interactive`，未提供 `--hub-url` 时也使用该默认地址；完整选项见 `octopus-proxy help`。安装服务后可运行 `octopus-proxy status` 和 `octopus-proxy doctor` 检查状态。
|
|
20
52
|
|
|
21
|
-
Proxy 主动连接 Hub 的 `/ws/proxy-chat`，无需开放入站端口或安装 sshd。Claw 经 `/ws/claw-chat` 建立到 Proxy 的内层 TLS 1.3 会话；Hub 只转发加密字节。首次打开工作区显示主机公钥指纹；核对后点击 Trust，未授权设备还需输入主机终端生成的配对码。Proxy 校验设备签名、配对码及主机密码并持久化设备授权，Claw 在认证成功后按 Hub 地址和 Dot ID 固定指纹；之后指纹变化会拒绝连接。每次连接都要输入运行 Proxy 服务账号的主机密码，由主机上的 PAM（Linux
|
|
53
|
+
Proxy 主动连接 Hub 的 `/ws/proxy-chat`，无需开放入站端口或安装 sshd。Claw 经 `/ws/claw-chat` 建立到 Proxy 的内层 TLS 1.3 会话；Hub 只转发加密字节。首次打开工作区显示主机公钥指纹；核对后点击 Trust，未授权设备还需输入主机终端生成的配对码。Proxy 校验设备签名、配对码及主机密码并持久化设备授权，Claw 在认证成功后按 Hub 地址和 Dot ID 固定指纹；之后指纹变化会拒绝连接。每次连接都要输入运行 Proxy 服务账号的主机密码，由主机上的 PAM（Linux）、Open Directory（macOS）或 Windows 账户认证验证。断线或连续 60 分钟没有用户操作后需要重新认证。服务安装时生成主机身份，`octopus-proxy identity` 显示指纹并生成 3 天内有效、最多可成功配对 10 次的配对码。安装主机需提供 OpenSSL；macOS 和 Linux 还需 C 编译器，Linux 另需 PAM 开发头文件。Windows 使用系统的 .NET Framework 编译辅助程序。Dot Secret 仅用于 Hub 路由，不能单独授权工作区。
|
|
22
54
|
|
|
23
55
|
macOS 12.3 及以上运行 `octopus-proxy onboard` 时，配置保存后、服务启动前会准备截屏辅助程序并申请系统屏幕录制权限；已授权时不会重复弹窗。交互模式和 `--non-interactive` 均执行此步骤，`--no-install-service` 也会申请。请在系统弹窗中允许访问；拒绝、超时或辅助程序编译失败时，向导提示原因与授权路径，并继续初始化。在“系统设置 → 隐私与安全性 → 屏幕录制（或屏幕与系统音频录制）”中应授权弹窗显示的实际程序，可能是 Terminal、iTerm、编辑器或 node，不保证出现 `octopus-desktop-capture`。onboard 和 doctor 会显示辅助程序路径，文件名不等于系统授权名称。终端授权不代表后台服务已授权，需在 Claw 点击截屏，让实际服务申请权限，按实际名称授权后重启 Proxy。Linux 没有通用的截屏授权弹窗，需使用桌面用户的图形会话环境；平台依赖与设置见[桌面快照说明](../../docs/claw-desktop-snapshots.md)。
|
|
24
56
|
|